--- lang: ja-jp breaks: true --- # `SP-API` ベンダーリテールAPI に関する調査 2023-05-12 ## Vendor Retail Procurement APIs v1 Use Case Guide > https://developer-docs.amazon.com/sp-api/docs/vendor-retail-procurement-apis-v1-use-case-guide Webサービス連携により、ベンダーが小売業の業務をプログラムで管理できるようにする方法。 :::warning 【注意】 ダイレクトフルフィルメントプログラムのベンダーは、ダイレクトフルフィルメントに特化したAPIについて学ぶために、「ベンダー向けダイレクトフルフィルメントAPI使用例ガイド」を参照してください。 > Vendor Direct Fulfillment APIs v1 Use Case Guide > https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-apis-use-case-guide ::: :::info 認証・認可については、「Selling Partner API Developer Guide」をご参照ください。 > What is the Selling Partner API > https://developer-docs.amazon.com/sp-api/docs/what-is-the-selling-partner-api ::: ### Vendor Orders API（Orders API）を使用すると、ベンダーは注文書を受け取り、注文の履行を承認または拒否するために注文確認を送信することができます。 https://developer-docs.amazon.com/sp-api/docs/vendor-retail-procurement-apis-v1-use-case-guide#what-is-the-vendor-orders-api * getPurchaseOrders * 指定した期間内に作成または変更された発注書のリストを返します。データの検索は、最初のPOSTコールが行われた日から最大6ヶ月間可能です。 * getPurchaseOrder * 指定した purchaseOrderNumber の値に基づいて、発注書（PO）を返します。データの検索は、最初のPOST呼び出しが行われた日から最大6ヶ月間可能です。 * submitAcknowledgement * 1つまたは複数の発注書を承認（受理または拒否）する。 * getPurchaseOrdersStatus * 指定したフィルターに基づき、発注書のステータスを返します。データの検索は、最初のPOST呼び出しが行われた日から最大6カ月間可能です。 getPurchaseOrders オペレーションを使用すると、指定した期間（2020 年 6 月以降の直近 6 ヶ月のローリングウィンドウ内）に作成または変更された注文にアクセスできます。応答時間を最適化するために、時間範囲を 7 日以内に制限することをお勧めします。また、getPurchaseOrder オペレーションを使用して、特定の注文の詳細な注文情報を取得することができます。その後、submitAcknowledgement オペレーションを使用して、注文を承認（承認または拒否）することができます。注文を承認した後、getPurchaseOrdersStatusオペレーションを使用して、1つまたは複数の注文の承認ステータスを返すことができます。 :::warning 注：getPurchaseOrders操作に "includeDetails "フィルタを指定して呼び出すと、発注書の完全な詳細または発注書番号のみを返すことができます。このパラメータのデフォルト値はtrueなので、このクエリパラメータを含めない場合は、購入注文の完全な詳細が返されます。includeDetails=false」の場合、応答には、発注書番号のリストと各発注書の現在の状態のみが含まれます。 ::: ### ベンダーは、Vendor Shipments API（Shipments API）を使用して、Amazonと出荷関連情報をやり取りすることができます。 https://developer-docs.amazon.com/sp-api/docs/vendor-retail-procurement-apis-v1-use-case-guide#what-is-the-vendor-shipments-api SubmitShipmentConfirmationsオペレーションは、ベンダーが確定した注文の事前出荷通知を送信することができます。 * SubmitShipmentConfirmations * Amazonに1つ以上の事前出荷通知を送信する。 #### リクエストフィールドに関する追加情報 * Bill of Lading (BOL#)（船荷証券（BOL#）？） * Shipment Identification（出荷の識別） * Shipped Date（出荷日） * Estimated Delivery Date（お届け予定日） * Serial Shipment Container Code (SSCC)（カートン追跡番号） * Expiration Date（賞味期限） * Manufacturing Date（製造年月日） * 商品が包装された日、または製造された日です。このフィールドは、商品が生鮮品である場合、または賞味期限が定められている場合に提供されるべきものです。 * Lot Number（ロット番号） * バッチ番号またはロット番号は、要素文字列が適用される貿易品目のトレーサビリティに関連すると製造者が考える情報とともに、品目を関連付ける。データは、取引品目自体または含まれる品目を指す場合がある。番号は、例えば、製造ロット番号、シフト番号、機械番号、時間、または内部製造コードであることがある。 * Usage of Expiration Date / Manufacturing Date / Lot Numbers in the shipment confirmation（賞味期限/製造年月日/ロット番号） * これらの項目は、生鮮品、すなわちNIS（新商品セットアップ）フォームで「賞味期限切れ商品」属性が「Yes」である商品に対してのみ必須となります。 * 出荷確認で有効期限/製造日/ロット番号を定義する際には、以下の点に注意してください： * 有効期限／製造日／ロット番号は、品目単位で送信する必要があります。 * ケースやパレットには複数のアイテム（ASIN）があり、それぞれに個別の有効期限／製造日／ロット番号が設定されていることがあります。 * 1つの商品（ASIN）が、同じケース/パレット内で複数の有効期限/製造日/ロット番号を持つことはできません。 * ベンダーは、出荷確認書に有効期限と製造年月日をYYYYMMDD形式で記載することが要求されます。 ### Vendor Payments APIを使用すると、ベンダーはAmazonと支払いに関する情報を交換することができます。 https://developer-docs.amazon.com/sp-api/docs/vendor-retail-procurement-apis-v1-use-case-guide#what-is-the-vendor-payments-api Submit Invoices APIを使用すると、ベンダーは、確定し出荷された注文に対してAmazonにベンダーインボイスを送信することができます。 * submitInvoices * 1つまたは複数のベンダーの請求書をAmazonに提出する。 :::warning 注：submitInvoices オペレーションは、ヨーロッパでクレジットノートを提出するために使用することができます。 ::: submitInvoicesオペレーションを使用すると、ベンダーはベンダー請求書を提出し、Amazonから発送した商品の支払いを要求することができます。この API を使用すると、ベンダーは 1 回の API 呼び出しで複数の請求書を提出することができます。 商品の請求は、商品が確認され、Amazonに出荷された後でなければなりません。そうでない場合は、請求書は拒否されます。 正しい情報が記載された請求書は、人の手を介さずにAmazonによって処理されるため、ベンダーはより迅速に支払いを受けることができます。 不正確な情報を含む請求書は、Amazonのペイジーシステムで拒否されるため、正しい情報を送信することが重要です。正しい情報の請求書を作成する方法については、ビジネス要件のセクションを参照してください。 ### Vendor Transaction Status APIとは、ベンダーがPOSTトランザクションのトランザクションステータスを確認するために使用するAPIです https://developer-docs.amazon.com/sp-api/docs/vendor-retail-procurement-apis-v1-use-case-guide#what-is-the-vendor-transaction-status-api * getTransaction * トランザクション後のリクエストのステータスを取得する。 ベンダーは、この API を使用して POST トランザクションのステータスを確認することができます。注文確認や出荷確認などのトランザクションがAPIを使用してAmazonに投稿されると、そのレスポンスにはトランザクションを一意に識別するトランザクション識別子が含まれます。Amazonはトランザクションを非同期で処理し、最終的なレスポンスはgetTransaction操作で利用可能になります。このAPIを呼び出してトランザクションの状態を取得するタイミングについては、各APIセクション（例：Vendor Orders、Vendor Shipmentsなど）にある対応する統合ワークフロー図を参照してください。 Amazonは、このAPIを通じて、注文確認や出荷確認などのPOST APIトランザクションの最終処理ステータスを提供します。ベンダーは、トランザクションが正常に処理されたことを確認するために、この API を使用してステータスを確認することを強くお勧めします。エラーが発生した場合、レスポンスにエラー情報が含まれます。その後、トランザクションを修正し、再送信することができます。 ## Vendor Orders API v1 reference > https://developer-docs.amazon.com/sp-api/docs/vendor-orders-api-v1-reference ベンダー注文データへのプログラムによるアクセス方法 ## Vendor Shipments API v1 reference > https://developer-docs.amazon.com/sp-api/docs/vendor-shipments-api-v1-reference ベンダーのリテール出荷データへのプログラムによるアクセス方法 ## Vendor Invoices API v1 reference > https://developer-docs.amazon.com/sp-api/docs/vendor-invoices-api-v1-reference ベンダー支払データへのプログラムによるアクセス方法 ## Vendor Transaction Status API v1 reference > https://developer-docs.amazon.com/sp-api/docs/vendor-transaction-status-api-v1-reference ベンダーの特定の非同期POSTトランザクションのステータス情報にプログラムでアクセスすることができます。 ## Vendor Retail Procurement FAQ SP-API Vendor Retail Procurement APIに関するよくある質問 > https://developer-docs.amazon.com/sp-api/docs/sp-api-vendor-retail-procurement-faq ###### tags: `Amazon Selling Partner API` `SP-API` `ベンダーリテールAPI` `Vendor Retail Procurement API`