.png&blockId=78c9ff9a-717f-4cfb-9b99-87bbb83a5b89)
API 연동이란?
스마트십 시스템이 쇼핑몰의 주문을 가져오고, 주문 확인 및 발송 처리를 원격으로 하기 위해서는 API 연결이 필요합니다. 본 문서는 Rakuten 서비스에 대한 API 연결 설정 방법을 설명합니다.
스마트십이 쇼핑몰의 API를 사용할 때에는 판매자의 접근 권한을 필요로 합니다. 접속 시에 판매자의 로그인 인증 정보를 스마트십이 직접 저장할 수는 없기에, ‘API 키’라는 별도로 인증된 정보를 입력해야 합니다. API 키는 쇼핑몰별로 ‘파트너 키’, ‘비밀 키’ 등의 이름으로 불리기도 합니다.
준비사항
Rakuten 서비스에 대한 API 연결 설정을 위해서는 다음의 정보가 필요합니다.
•
샵 ID : Rakuten 판매자 ID
•
serviceSecreat Key : Rakuten에서 발급(아래 가이드 참고)
•
License Key : Rakuten에서 발급(아래 가이드 참고)
스마트십에 Rakuten API 설정하기
1. Rakuten API KEY 발급받기
Rakuten 서비스에서는 다음과 같은 단계에 따라 API 키를 조회/발급할 수 있습니다.
1.
Rakuten 에 로그인 후, 왼쪽 店舗様向け情報・サービス > WEB APIサービス > 申込、利用規約確認 메뉴로 진입합니다.
신청 이용 약관 확인 페이지에서 약관을 확인하시고, 이용 신청을 진행해주세요.
2.
이용 신청이 끝나면, Web API 메뉴로 진입하신 후, [利用機能編集] 버튼을 눌러주세요.
3.
楽天ペイ受注API(RakutenPay_OrderAPI) 항목에 [全て選択] 버튼을 눌러 모두 선택하신 뒤 등록 해주세요.
4.
등록이 완료되면 serviceSecret 키와 lisenseKey를 확인하실 수 있습니다. lisenseKey는 끝의 4자리만 확인할 수 있습니다.
발급받은 API KEY는 90일간의 유효기간이 있으며, 만료가 되면 같은 절차를 통해서 새로 발급 해주셔야 합니다.
5.
lisenseKey 전체보기를 위해서는 ‘ライセンスキーの確認・変更’을 눌러 진행해주세요.
체크박스에 체크하고 [確認する] 버튼을 눌러주세요.
6.
lisenseKey 전체를 확인할 수 있습니다.
2. 스마트십에 Rakuten API KEY 등록하기
경로 : 주문 > 쇼핑몰 연동 > 쇼핑몰 API 설정
다음과 같은 단계에 따라 API 연동 설정을 할 수 있습니다.
1.
쇼핑몰 API 설정 페이지에 진입하신 후, 우측 상단의 [+신규등록]을 선택해주세요.
2.
“Rakuten”을 선택한 후, 하단의 "쇼핑몰 연동 등록"으로 스크롤을 이동해주세요.
3.
API 연동 설정에 필요한 정보들을 입력하고 등록해주세요.
•
쇼핑몰 샵 ID: Rakuten ID를 기재합니다.
•
샵 이름: Rakuten 샵 링크 주소를 기재합니다. https://www.rakuten.ne.jp/ 뒤에 판매자님 샵 ID를 입력해주세요.
예시) https://www.rakuten.ne.jp/abcd14231499
잘못된 값을 입력 하거나 공란인 경우 URL 확인이 불가하므로, 판매자님의 Rakuten 샵 링크를 확인 후 입력해주세요.
•
서비스 Secreat Key : 1. Rakuten에서 API KEY 발급받기 에서 발급받은 serviceSecreat Key를 입력합니다.
•
License Key : 1. Rakuten에서 API KEY 발급받기 에서 발급받은 License Key를 입력합니다.
•
API 연결 설정 옵션도 선택해주세요. 자세한 내용은 아래에서 확인하실 수 있습니다.
API 연결 설정 옵션
API 연결 설정 시에 주문 및 상품 연동 동작의 세부 사항을 조절할 수 있는 옵션이 있습니다.
•
자동 주문 연동
•
자동 주문 확인
•
자동 풀필먼트 출하지시
•
API 설정 정보 확인
API 연결 정보를 추가한 후에는 정상적인 통신이 가능한지 확인합니다.
•
[연결 테스트하기] 버튼을 클릭하여 정상 연결 여부를 확인합니다.
Rakuten 주문 연동 가능 상태값
Rakuten 에서 발생한 신규 주문 중 “発送待ち” (발송대기)상태의 주문을 가져옵니다.
Rakuten 판매 상품에 스마트십 SKU 연결하기
1. SKU 프로젝트 이행 후
1) 옵션 유무 관련
재고 동기화 및 풀필먼트 서비스를 이용하시려는 경우, Rakuten 판매 상품에 스마트십 SKU를 연결해주세요.
경로 : RMS > 商品編集(상품관리) > 商品一覧・登録(상품 목록・등록)
1.
Rakuten 상품 등록 화면에서 상품별 코드를 입력합니다.
•
옵션이 없는 단일 상품일 경우는 “商品番号(상품번호)”를 입력합니다.
•
옵션이 있는 선택 상품일 경우에는 옵션 별로 Rakuten 판매 상품의 “システム連携用SKU番号(시스템 연계용SKU번호)”를 입력합니다.
경로 : 스마트십 > 상품 및 재고 > SKU 관리
2.
스마트십 SKU 정보 중 “판매자 정의 코드”에 옵션 유무에 따라 코드를 입력합니다.
•
옵션이 없는 경우 “상품 정보” 탭에서 1.의 “商品番号”와 동일한 입력 값을 넣어주세요.
•
옵션이 있는 경우 “상품 옵션 관리” 탭에서 1.의 “システム連携用SKU番号”와 동일한 입력 값을 넣어주세요.
3.
위의 작업이 끝났으면 이후 주문이 연동되는 시점부터 풀필먼트 주문으로 생성이 되고, 출고 시점에 재고 수량이 동기화됩니다.
2. SKU 프로젝트 이행 전
1) 옵션 유무 관련
재고 동기화 및 풀필먼트 서비스를 이용하시려는 경우, Rakuten 판매 상품에 스마트십 SKU를 연결해주세요.
경로 : RMS > 商品基本情報(상품기본정보)
1.
Rakuten 상품 등록 화면에서 상품별 코드를 입력합니다.
•
옵션이 없는 단일 상품일 경우는 “商品番号(상품번호)”를 입력합니다.
•
옵션이 있는 선택 상품일 경우에는 옵션 별로 Rakuten 판매 상품의 “장바구니코드”를 입력합니다.
경로 : 스마트십 > 상품 및 재고 > SKU 관리
1.
스마트십 SKU 관리메뉴로 이동하세요.
2.
스마트십 SKU에 1. 판매사이트에 판매자정의코드 설정하기 에서 입력한 값과 동일한 상품을 입력합니다.
•
옵션이 없는 단일 상품인 경우
◦
단일 상품 유형의 SKU를 등록하고, ‘판매자 정의 코드’를 입력해주세요.
•
옵션이 있는 멀티상품의 경우
◦
‘옵션관리’ 탭에서 ‘판매자 정의 코드’ 를 입력해주세요.
대량의 상품을 등록 및 매핑하려는 경우, 엑셀로 업로드하시면서 함께 ‘SKU 판매자 관리 코드’를 입력해주시면 편리합니다.
3.
위의 작업이 끝났으면 이후 주문이 연동되는 시점부터 풀필먼트 주문으로 생성이 되고, 출고 시점에 재고 수량이 동기화됩니다.
2) 상품명 이용하여 매핑
Rakuten 판매 상품 이름과 상품코드를 기준으로 스마트십 SKU와 매핑할 수 있습니다.
상품명을 이용하여 매핑하시는 경우 1. 옵션 유무 관련의 판매자 관리코드는 입력하지 않도록 해주세요.
스마트십에서 아래와 같이 Rakuten의 상품명과 스마트십의 SKU를 연결할 수 있습니다.
이 때 입력하시는 상품명/옵션값은 띄어쓰기 대소문자를 비롯하여 텍스트를 동일하게 입력해주세요.
경로 : 스마트십 > 상품 및 재고 > SKU 관리