품고 가이드
home
품고나우 가이드
home
🛫

라쿠텐 연동 가이드

Rakuten 판매처를 품고와 연동하면 Rakuten 주문을 품고로 불러와 출고할 수 있습니다.
연동을 시작하려면 먼저 Rakuten에서 API KEY를 발급한 뒤, 발급된 정보를 품고 판매처 연동 설정에 입력해주시면 Rakuten 연동이 시작됩니다.
시작하기 전에 아래 정보를 준비해 주세요.
•
Rakuten RMS 로그인 계정
•
판매 상품 URL의 샵 ID
◦
Rakuten 판매 상품 페이지 URL에서 https://www.rakuten.co.jp/ 뒤에 표시되는 값을 확인해주세요.
◦
예시) 상품 URL이 https://www.rakuten.co.jp/myshop/… 일 경우, 샵 ID는 myshop입니다.
⚠️
Rakuten에서 발급한 License Key의 유효기간은 90일입니다.
만료되면 주문 연동이 중단될 수 있으므로, 만료 전 새로운 키를 발급하여 품고에 다시 등록해주세요.

1️⃣ Rakuten API KEY 발급받기

⚠️
serviceSecret Key와 License Key는 외부에 노출되지 않도록 안전하게 관리해 주세요.
품고와 Rakuten을 연동하려면 Rakuten RMS에서 WEB API 이용 신청을 완료한 후, 주문 연동에 필요한 API KEY를 발급해야 합니다.
발급 과정에서 아래 정보가 생성됩니다.
•
serviceSecret Key
•
License Key
발급된 정보는 이후 2️⃣ 품고에 연동 정보 입력하기 단계에서 사용합니다.

발급 순서

1.
Rakuten RMS에 로그인 후, 왼쪽 메뉴에서 [店舗様向け情報・サービス → WEB APIサービス → 申込、利用規約確認] 으로 진입합니다.
2.
약관을 확인하신 후 WEB API 서비스 이용 신청을 완료해주세요.
3.
이용 신청이 완료되면 [利用設定 → アプリ登録] 메뉴로 진입한 후, [利用機能編集] 버튼을 클릭해주세요.
4.
앱 관리를 위한 앱 이름과 개요를 작성합니다.
⚠️
이미 등록된 앱이 있는 경우, 기존 앱의 이름과 개요를 수정해 주세요.
입력 예시)
•
앱 이름: 품고 물류 연동
•
개요: 품고를 통한 Rakuten 주문 수집 및 출고 정보 연동
위 내용은 예시이므로, 실제 사용 목적에 맞게 앱 이름과 개요를 작성해 주세요.
5.
「ロボットによる操作ではありません」 확인란을 선택한 후, [確認する] 버튼을 클릭해 주세요. 보안 확인이 완료되면 앱이 등록됩니다.
6.
좌측의 [利用設定 → アプリ一覧] 메뉴에서 등록한 앱을 선택하여 앱 상세 정보 화면으로 이동합니다. 화면 하단의 [利用機能編集] 버튼을 클릭해주세요.
7.
이용 가능 편집 화면에서 ‘利用機能編集’ 화면에서 ‘LicenseManagementAPI(ライセンス管理API)’의 ‘利用する’를 체크해 주세요.
8.
이용 가능 편집 화면에서 楽天ペイ受注API(RakutenPay_OrderAPI) 항목으로 이동 후 오른쪽의 [全て選択]을 클릭하여 모든 기능을 선택한 후 등록해 주세요.
⚠️
Rakuten 주문 조회와 출고 정보 연동에 필요한 권한이므로, RakutenPay_OrderAPI 항목은 전체 선택해주세요.
9.
등록이 완료되면 앱 상세 정보 화면의 利用情報 영역에서 다음 정보를 확인할 수 있습니다.
•
serviceSecret
•
ライセンスキー(License Key)
•
License Key 유효기간
⚠️
License Key 전체값 확인 방법
앱 상세 화면에서는 License Key가 일부만 표시됩니다.
전체값을 확인하려면 오른쪽의 [ライセンスキーの変更] 버튼을 클릭한 후, 「ロボットによる操作ではありません」 항목을 선택하고 [確認する] 버튼을 클릭해주세요.

꼭 확인해 주세요 ☺️

✅ License Key의 유효기간은 90일입니다.
✅ 만료 전 Rakuten RMS에서 새로운 License Key를 발급해주세요.
✅ License Key가 만료되면 품고와 Rakuten 간 주문 연동이 정상적으로 진행되지 않을 수 있습니다.
✅ License Key를 갱신한 경우, 품고의 판매처 연동 설정에도 새로운 License Key를 입력해주세요.

2️⃣ VISE에 연동 정보 입력하기

판매 채널 등록하기

1.
VISE에서 [B2C 설정 → 판매 채널]로 이동해 주세요.
2.
화면 오른쪽의 [등록]을 눌러 주세요.
3.
라쿠텐 주문을 운영할 브랜드를 선택해 주세요.
4.
판매 플랫폼에서 [라쿠텐]을 선택해 주세요.
5.
계정 정보 항목은 모두 빈칸으로 두고 [등록]을 눌러 주세요.

판매 채널 연동 설정하기

1.
판매 채널 목록에서 등록한 라쿠텐 채널을 조회해 주세요.
2.
목록의 판매 플랫폼명 [라쿠텐]을 눌러 판매 채널 상세 화면으로 이동해 주세요.
3.
화면 상단의 [연동 설정]을 눌러 주세요.
4.
‘라쿠텐을 연동하시겠습니까?’ 안내를 확인한 뒤 [확인]을 눌러 주세요.
5.
‘라쿠텐 연동 설정’ 화면에서 기본 정보 입력 → 연동 키 발급 → 연동 키 입력 → 연동 확인 순서로 진행할 수 있습니다.

계정 정보 입력하기

1.
[아이디]에 Rakuten RMS 로그인 ID를 입력해 주세요.
2.
[판매 채널 URL]에 판매 상품 URL의 뒷부분인 샵 ID를 입력해 주세요.
예를 들어 URL이 https://www.rakuten.co.jp/myshop이라면 myshop을 입력해 주세요.
3.
입력을 마치면 활성화되는 [다음]을 눌러 주세요.
4.
연동 키 발급 안내를 확인하고, 준비한 키를 입력하는 단계로 이동해 주세요.

API 키 입력 및 검증하기

1.
Service Secret(시크릿 키)과 License Key(라이선스 키)를 입력해 주세요.
2.
[키 검증하기]을 눌러 주세요.
3.
‘키 검증 완료’ 메시지가 표시되는지 확인해 주세요.
4.
활성화된 [다음]을 눌러 주세요.
💡
키 검증에 실패했나요?
최초 검증에는 시간이 걸릴 수 있습니다. ‘검증 실패’로 표시된다면 5~10분 후 다시 검증해 주세요.
다시 검증한 뒤에도 실패한다면 품고 담당자에게 문의해 주세요.

테스트 주문 확인하기

🚨
테스트 주문 조회는 선택 사항이에요
테스트 주문을 조회하지 않아도 라쿠텐 연동을 완료할 수 있어요. 주문 조회를 건너뛰려면 [연동 완료]를 눌러 주세요.
1.
주문 내역을 확인할 날짜를 선택해 주세요.
2.
[주문 조회]를 눌러 선택한 날짜에 발생한 라쿠텐 주문을 확인해 주세요.
3.
조회된 주문 정보를 확인한 뒤 [다음]을 눌러 주세요.
4.
조회할 주문이 없다면 주문 조회 없이 [다음]을 눌러 주세요. 연동이 완료되면 이후 발생하는 신규 주문이 품고로 자동 수집됩니다.