API連携の仕様(楽天)

受注取込

楽天RMS上での注文情報は、以下のステータスに応じて自動でSCシステムに取り込まれます。

※ [注文確認待ち] [楽天処理中] のステータスにおいて入金が未完了の場合

• 受注データは「入金待ち」ステータスで取り込まれます。
• 楽天側で 入金完了となると、SC側のステータスも  [入金済み]  に更新されます。
• 上記更新により、自動的にSCシステム上で 出荷待ち となります。
  　

1. 対象となる受注ステータス

   • 注文確認待ち
   • 楽天処理中
   • 発送待ち
     

2. 取込対象外の受注
   

   以下の受注はAPI取込の対象外です。CSVでの手動取込をお願いします。
   
   ① 頒布会注文
   
   ② 予約注文

ソーシャルギフト注文の取込

楽天のソーシャルギフト注文は、送付先住所が未入力の場合、連携対象外となります。
受け取る方が送付先住所を入力すると、通常の受注と同じようにSCシステムへ取り込まれます。

詳しくは「ソーシャルギフト注文の取り扱い(楽天)」をご確認ください。  

自動処理されない機能

以下の処理はAPIでは連携されておらず、楽天RMS上での手動操作が必要です。

• サンクスメール（注文確認メールなど）の送信
• ステータス変更処理

在庫連携の利用条件

在庫連携機能をご利用いただけるのは、楽天SKUプロジェクトが適用された店舗のみです。
SKU未適用の店舗では、在庫連携機能は使用できません。

API連携設定の「SKU適用店舗」をOFFにすると、在庫連携のトグルは非表示になります。在庫連携をご利用の場合は、楽天SKUプロジェクトの適用後に「SKU適用店舗」をONにしてください。

適用済みかどうかの確認方法は「楽天SKUプロジェクト適用後店舗か確認する方法はありますか？」をご確認ください。

ライセンスキーの更新について

楽天市場のWEB APIサービスでは、定期的にライセンスキーの更新が必要です。

• ライセンスキーの有効期限は90日 です。
• 有効期限が近付くと、楽天から「【楽天市場】licenseKeyの有効期限のお知らせ」メールが送付されます。こちらをご参照の上、システム画面にて操作を行ってください。

※ライセンスキーの有効期限が過ぎると、API連携が 解除 されます。
　必ず期限内にライセンスキーの更新を行ってください。

UnAuthorised エラーについて

以下のようなエラーメッセージが表示された場合、APIの認証に失敗していることを示します。

楽天:在庫数の変更v2 APIエラー:{ "errors": [ { "code": "GA0001", "message": "Un-Authorised" } ] }

本エラーが発生した場合は、以下をご確認ください。

• • [serviceSecret] または [licenseKey] が正しく設定されているか
  • RMS上で以下のAPI利用設定が有効になっているか
    • 楽天ペイ受注API
    • 在庫API
    • 商品API
  • licenseKeyの有効期限が切れていないか