1. Overview
Definition: Connect your Rakuten store with OMS for automatic order sync and unified management.
Benefits: Auto-sync orders, process in OMS, set automatic shipping rules.
2. Authorization Steps
2.1 Enable Required APIs
Important: Some Rakuten APIs must be enabled before use. Check if following APIs are in "利用中" (In Use) status.
(1) Login to Rakuten Backend > Web API Management
(2) Click "利用機能編輯" to enable API permissions
(3) Enable Order API (RakutenPay_Order) - check all boxes
Note: After selecting APIs, scroll to bottom and click "確認" to save. Then on the next page, scroll to bottom and click "登録" to actually enable.
2.2 Copy Authorization Codes
Go to WEB SERVICE > WEB Interface to get serviceSecret and licenseKey
Note: licenseKey requires clicking "認証ライセンスキー確認・変更" button to view.
2.3 Fill Authorization Info in OMS
Path: OMS > System Settings > Platform Authorization > Rakuten > Add Authorization
- Store name: Custom field
- Store code: Custom field
- License_Key: From Rakuten backend
- Service_Secret: From Rakuten backend
2.4 Product Mapping (Required)
Path: OMS > System Settings > Product Mapping > New
- OMS syncs Rakuten's "商品管理番号" (Product Management Number)
- Ensure OMS has created corresponding product SKUs
- Quantity = conversion coefficient (NOT inventory quantity)
3. Common Issues
Q: What field does OMS sync as platform SKU?
A: 商品管理番号 (Product Management Number).
Q: "Platform SKU is empty" error?
A: For pending orders (not reviewed/cancelled) in Rakuten "awaiting shipment" status, system will re-sync.
Q: Cancelled orders in Rakuten won't auto-cancel in OMS?
A: Correct, Rakuten doesn't sync cancelled orders.
← Back to Main Tutorial