ベンダー小売調達API v1ユースケースガイド
Webサービスの統合によってベンダーが小売ビジネスをプログラムで管理できるようにする方法
小売ベンダー向けのSelling Partner APIは、ベンダーがWebサービスの統合を通じて小売ビジネスをプログラムで管理するのに役立ちます。Amazonとの統合を自動化することで、ベンダーは規模に応じてパフォーマンスを改善・維持し、Amazonとのビジネスを成長させることができます。
Vendors in the direct fulfillment program should refer to the Vendor Direct Fulfillment APIs v1 Use Case Guide to learn about APIs specific to direct fulfillment.
ベンダーはこのAPIを使用して、アプリケーションの構築、運用効率の向上、労力とエラーの削減、パフォーマンスの改善が可能です。
For authentication and authorization information, refer to Authorizing Selling Partner API applications.
ベンダー小売調達 API を使用して実行できるビジネスプロセス
You can use the Vendor Orders API to manage purchase orders, the Vendor Shipments API to send shipment confirmations, the Vendor Invoices API to submit invoices, and the Vendor Transaction Status API to determine the status of your order acknowledgements and shipment confirmations.
ビジネスプロセス | ユースケース | オペレーション |
発注書管理 | ||
発注書の変更またはキャンセルを受け取る |
getPurchaseOrders Returns a list of purchase orders created or changed during the time frame that you specify. |
|
発注書のステータスを確認する |
getPurchaseOrdersStatus Returns purchase order statuses based on the filters that you specify. |
|
注文確認を送信 |
submitAcknowledgement Submits acknowledgements for one or more purchase orders. |
|
注文確認の取引状況を確認 |
getTransaction Returns the status of the transaction that you specify. |
|
出荷 | ||
出荷リクエストを送信します |
SubmitShipments Submits one or more shipment request for vendor Orders. |
|
出荷状況または出荷/輸送ラベルを取得 |
GetShipmentDetails Returns the Details about Shipment, Carrier Details, status of the shipment, container details and other details related to shipment based on the filter parameters value that you specify. |
|
事前出荷通知 (ASN) /出荷確認の送信または更新 |
SubmitShipmentConfirmations Submits one or more shipment confirmations for vendor orders. |
|
出荷確認の取引状況を確認 |
getTransaction Returns the status of the transaction that you specify. |
|
配送ラベルを取得 |
GetShipmentLabels Returns small parcel shipment labels based on the filters that you specify. |
|
請求書とクレジットノート | ||
仕入先請求書の提出 |
submitInvoices Submit new invoices to Amazon. |
Vendor Orders APIとは?
You can use the Vendor Orders API (Orders API) to receive purchase orders and to send order acknowledgements to accept or reject order fulfillment.
ベンダー注文 API には次のオペレーションが含まれます。
オペレーション | HTTPメソッド | Path | 説明 |
---|---|---|---|
getPurchaseOrders |
GET | /vendor/orders/v1/purchaseOrders |
指定された期間に作成または変更された発注書のリストを返します。データ検索が可能な期間は最初のPOST呼び出しの実行日から最大6か月間です。 |
getPurchaseOrder |
GET | /vendor/orders/v1/purchaseOrders /{purchaseOrderNumber} |
に基づいて発注書 (PO) を返品します purchaseOrderNumber 指定する値。データの取得は、最初の POST 呼び出しが行われた日から最大 6 か月間可能です。 |
submitAcknowledgement |
POST | /vendor/orders/v1/acknowledgements |
1 つ以上の発注書の確認(受理または拒否)を行います。 |
getPurchaseOrdersStatus |
GET | /vendor/orders/v1/purchaseOrdersStatus |
指定されたフィルターに基づいて発注書のステータスを返します。データ検索が可能な期間は最初のPOST呼び出しの実行日から最大6か月間です。 |
You can use the getPurchaseOrders
operation to access orders created or changed during a specified time period (within a rolling window of the last six months, after June 2020). To optimize response time, we recommend that you limit the time range to no more than seven days.
You can use the getPurchaseOrder
operation to get detailed order information for a specific order. You can then use the submitAcknowledgement
operation to accept or reject the order.
After you accept or reject your orders, you can use the getPurchaseOrdersStatus
operation to return the acknowledgement status of one or more purchase orders.
注
注文書の詳細をすべて返送するには、
getPurchaseOrders
操作、または以下を含む発注書番号のみを返すincludeDetails
フィルター。このパラメーターのデフォルト値は true なので、このクエリパラメーターを含めないと、発注書の詳細がすべて返されます。を使用する場合includeDetails=false
応答には、発注書番号のリストと各発注書の現在の状態のみが含まれます。
以下の図は、Vendor Orders APIを使用する際のワークフローを示したものです。
getPurchaseOrders
getPurchaseOrders
The getPurchaseOrders
operation returns either a list of order references (purchase order numbers and status) or complete order details, for all orders that meet the criteria specified in the request. If you are returning only order references, they can be used later with the getPurchaseOrder
operation to get order details for a specific order.
ベンダーはこのAPIを使用して、フルフィルメントの対象となる発注書を取得する必要があります。Amazonは、ベンダーが営業時間中、少なくとも1時間に1回、注文を確認することを推奨しています。取引量によっては、さらに頻繁に確認した方がよい場合もあります。1 回のAPI呼び出しで最大100件の注文を取得できます。100件を超える注文がある場合は、nextToken
を使用すれば、 次の注文集合を取得できます。
注文の変更とキャンセル
注文の変更やキャンセルは、getPurchaseOrders
オペレーションで確認できます。
注文変更:要件の変化によりAmazonが注文作成後に注文データを変更することがあります。ベンダーはgetPurchaseOrders
APIを使用することで、更新された注文を取得できます。Amazonが発注書を変更した場合、その注文には、更新時のタイムスタンプを示すpurchaseOrderChangedDate
フィールドが表示されます。このフィールドがない注文は、作成後に変更されていません。
注
Amazonは、お客様が承認した後に発注書を変更することもできます。
ベンダーは、changedAfter
とchangedBefore
のクエリパラメーターを使用して、特定の日付範囲に変更された注文の一覧を取得できます。この方法では、指定された日付範囲にAmazonが変更した注文が返されます。ベンダーは更新後の発注書に基づいて出荷する必要があります。ベンダーはisPOChanged=true
を使用して、変更された発注書すべてを取得することもできます。
Amazonでは、日付範囲を変更して別のAPI呼び出しを1日に数回実行して、1日の変更された注文を取得することを推奨しています。たとえば、1 日に 4 回、発注書の取得オペレーションを呼び出して、過去 6 時間以内に変更された注文を取得できます。
以下は、注文変更の原因となる可能性のある変更のリストです。このような変更を行うには、変更した注文を取り消して、正しい発注書を出荷する必要があります。
- 出荷または配送期間の変更
- 数量変更、品目のキャンセル、品目の原価変更など、PO品目の更新
- POへの新しい品目の追加
- POがキャンセルされた/キャンセルされていない
- POタイプの変更
- POの配送先 (フルフィルメントセンター) の変更
- POの貨物情報の変更
商品のキャンセル: フィルターと合わせてベンダー注文 API を使用することもできます poItemState=Cancelled
キャンセルされた商品が 1 つ以上ある注文を返品する場合。これにより、注文書の作成後にAmazonによって1つ以上の商品がキャンセルされた注文がすべて返されます。これにより、キャンセルされた商品 (注文数量がゼロ) の注文のみを受け取り、キャンセルされた商品を発送しないようにすることができます。
注
商品のキャンセルは注文変更とみなされるため、変更された注文のリストとともにこれらの注文を返品することもできます。
発注書の州とベンダーコード: 発注書スキーマには、現在の発注書の状態と状態更新時刻が含まれます。フィルターを使用できます。 purchaseOrderState
現在の状態に基づいて注文をフィルタリングします。
たとえば、purchaseOrderState=New
を使用すると、まだ確認や出荷が行われていない発注書をすべて取得できます。
ベンダーは、orderingVendorCode
フィルターに認可ベンダーコードの1つを指定することで、特定のベンダーコードに対する発注書を取得することもできます。このフィルターは、指定されたベンダーコードに対する発注書のみを返します。
For details about all the available filters, refer to the Vendor Orders API Reference.
以下の図は、発注書を取得する場合の統合ワークフローです。
getPurchaseOrder
getPurchaseOrder
The getPurchaseOrder
operation uses the purchase order number to return information you specify about the purchase order. The response includes complete purchase order information, including line item details, quantity, and cost.
この操作を使用して、から返された特定の注文の詳細を取得します。 getPurchaseOrders
オペレーション。
次の図は、特定の発注書を取得する場合の統合ワークフローを示しています。
ビジネスの要件
-
重量ベースの注文
重量制で販売されている商品を含む注文の場合、
unitOfMeasure
フィールド (アンダー)listPrice
そしてnetCost
) は実際の重量の測定単位を反映しています。重量の測定単位には以下が含まれます。POUNDS
、OUNCES
、GRAMS
、およびKILOGRAMS
。 -
出荷ウィンドウまたは配送ウィンドウの使用方法
For vendor paid freights, the delivery window information should be used. Dates are represented in date time interval format in accordance with ISO 8601. The format is the start and end date separated by double hyphen (--). The start date field represents the earliest date that Amazon expects the freight to be delivered to the Amazon fulfillment center listed on the purchase order. The end date field represents the latest date that Amazon expects the freight to be delivered to the Amazon fulfillment center listed on the purchase order.
Use the ship window information for Amazon-paid freights. The date is represented in date/time interval format according to ISO 8601. The format is start and end date separated by double hyphen (--). The start date field represents the earliest date that Amazon expects to pick up the freight. The end date represents the latest date that Amazon expects to pick up the freight. If the same date is listed in the start date and end date fields, then read that date as the date that Amazon expects to pick up the freight.
-
品目を入荷待ちにすることはできるか
isBackOrderAllowed
フィールドの値を確認する必要があります。値がtrueの場合は、その注文を入荷待ちとして処理できます。falseの場合、入荷待ちにはできません。 -
ディールコード
ディールコードは、注文の
dealCode
フィールドに示されるプロモーションコードです。このフィールドには、プロモーションコード、特別割引、価格に関するあらゆる情報が表示されます。 -
入荷待ちキャンセルポリシー
バックオーダーポリシーは、Amazon のビジネス担当者が決定します。詳細についてはベンダーマネージャーと話し合ってください。
注
バックオーダーのキャンセル日は、注文時に送信できない場合があります。バックオーダーポリシーは、アカウントレベルで設定する必要があります。
-
API を使用して注文を変更する
現時点では、API を使用して注文に変更を送信することはできません。注文確定後の変更は、ベンダーセントラルを通じて手動で行います。
国固有のビジネス要件
機能 | インド | ヨーロッパ | 北米 |
---|---|---|---|
正味原価 | 条件しだい。正味原価または定価のいずれか。 | 条件しだい。正味原価または定価のいずれか。 | 条件しだい。正味原価または定価のいずれか。 |
定価 | 条件しだい。正味原価または定価のいずれか。 | 条件しだい。正味原価または定価のいずれか。 | 条件しだい。正味原価または定価のいずれか。 |
入荷待ち | 該当なし | サポート対象 | サポート対象 |
買い手 | 購入するAmazon事業体の住所 | その買い手に割り当てられているID | 該当なし |
売り手 | ベンダーに割り当てられたAmazonベンダーコード | ベンダーに割り当てられたAmazonベンダーコード | ベンダーに割り当てられたAmazonベンダーコード |
出荷先 | 出荷先事業体の住所 | 出荷先に割り当てられたID | 該当なし |
課金先 | 課金先エンティティの住所 | 課金先エンティティの住所 | 該当なし |
submitAcknowledgement
submitAcknowledgement
You can use the submitAcknowledgement
operation to accept or reject a purchase order for fulfillment. Amazon expects a complete acknowledgement, including all purchase order line items for the purchase order. If you do not provide all line items for the purchase order in the acknowledgement, Amazon will implicitly reject the missing line items.
Amazonでは、できるだけ早く、遅くとも24時間以内に確認書を提出することを期待しています。確認書は、実際の出荷数量と日付を正確に把握したものでなければなりません。
数量、価格、出荷日、または配送日の変更については、確認書送信の48時間以内に更新してください。ベンダーは、確認書全体の更新を送信することも、特定の品目のみの更新を送信することもできます。Amazonは常に、更新内容をその品目に関する以前の確認に置き換わるものとして扱います。48時間経過後は、出荷日または配送日の更新のみを受け付けます。
特定の品目の最初の確認コードが rejected
、アップデートでこれをどちらにも変更することはできません accepted
または backordered
。
注文確認書の正常送信の検証
You can verify the status of the original or updated version of the order acknowledgement using Vendor Central or using the Transaction Status API. If the original or updated version doesn't appear after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.
以下の図は、注文確認時の統合ワークフローを示しています。
ビジネスの要件
-
発注書に記載されていた当初の数量をベンダーが注文確認時に増やすことはできますか。
いいえ、注文書で送信された数量よりも多い数量を送信することはできません。
-
各発注書に対して注文確認書の送信が必要ですか。
Yes, in order to update the status of an order in the Amazon system correctly, Amazon requires PO confirmation using the API or Vendor Central. If you are unable to meet our order acknowledgement requirements using the API, you must confirm your purchase orders using Vendor Central. Contact your Amazon business representative if you do not have a Vendor Central account.
-
注文確認書には、対応するPOのすべての品目を記載する必要がありますか。
はい。Amazonが注文のステータスを正しく更新するために必要です。
-
品目が入荷待ちの場合、注文確認書に数量を入力する必要はありますか?
はい。Amazonのシステムで品目のステータスを正しく更新するために必要です。
-
注文に無効な品目や廃止された品目が含まれていた場合、注文確認ではそれらをどのように報告すればよいですか。
注文に無効な品目番号が付けられて到着した商品を処理または出荷しないでください。確認書に無効な品目番号を返送し、次のとおり伝えてください
invalid
。以下の確認コードは次のことを示しています。rejected
アイテムが古くなっているため:拒否:Amazonの解釈では、このコードで指定された数量は、この注文書の一部としてAmazonに配送されないとされています。適切な拒否理由を以下のように送信してください。
obsolete
謝辞に。これは、その商品が古くなっているため、もう注文すべきではないことを示しています。Amazonの命名法は「ハードリジェクト」です。つまり、この商品は再注文しないでください。同じプロジェクトでこのコードが 2 回連続で受信された場合 (48 時間以上の間隔を空けて)、その商品は再注文されません。
注
Amazon expects an acknowledgement even if all the line items on the purchase order were invalid and did not produce an order or invoice. If a corresponding acknowledgement cannot be sent for a purchase order, Amazon requires manual notification of invalid items. You can notify your buying team through the Vendor Central Contact Us link.
-
確認書には、その注文トランザクションで受け取った商品コードと同じ商品コードを記載する必要がありますか。
確認書には、発注書に記載されていたものとまったく同じ商品コードを記載する必要があります。
-
確認書に価格を記載する必要はありますか。
はい、ベンダーは確認書に単位原価(unit cost price)を記載する必要があります。この価格は、後日請求する単位原価と一致していなければなりません。書籍ベンダーは、定価と割引率を提示する必要があります。
-
確認書に発注書の価格をそのまま記載して返すことはできますか。
いいえ。発注書の価格に関係なく、確認書には原価を記載する必要があります。確認書に記載される原価は、請求書に記載される原価と一致していなければなりません。この2つの価格はAmazonの決済システムで比較され、一致していないと支払いが遅延することがあります。
-
最初の確認書の送信後に価格や在庫状況が変化した場合、Amazon.comではどのような対応が求められますか。
最初の確認書の送信後にAmazonの注文に変更が生じた場合は、手動で通知してください。通知先、通知するタイミング、通知方法については、Amazon.com の貴社担当営業にお問い合わせください。
-
入荷待ち品目の価格データを入力する必要はありますか?
はい、これはAmazonが注文のステータスを正しく更新するために必要です。価格を省略すると、承認が却下されます。
-
入荷待ちが可能かどうかは、どうすればわかりますか。
の値を読む必要があります
isBackOrderAllowed
発注書のフィールド。値が true の場合は、バックオーダーが許可されていることを示します。値が false の場合、バックオーダーは許可されません。 -
ステータスにかかわらず、すべての明細について確認コードを記入する必要がありますか?
はい。注文のステータスを正しく更新するためには必須です。確認コードを省略すると、確認は拒否されます。
-
分割出荷に関するAmazonのポリシーを教えてください。注文確認書を送信する際には、分割出荷をどのように報告すればよいですか。
発注書で取り寄せ注文が許可されている場合、部分出荷が許可されます (次の場合)。
isBackOrderAllowed
ですtrue
)。Amazon では、このコードを使用して確認ループを 1 回指定することを推奨しています。accepted
対応する日付と、コードを使った確認ループがもう1つ付いていますbackordered
および対応する日付。Accepted:すぐに出荷できる品目。
Backordered:すぐには出荷できない残りの数量。この残りの数量(注文数量から確認済み数量を差し引いた数量) は、後日配送されます(入荷待ち)。
-
listPrice
セグメントを使用するのはどのような場合ですか。listPrice
セグメントが必要なのはベンダーが定価で書籍を販売する場合だけです。
国固有のビジネス要件
機能 | インド | ヨーロッパ | 北米 |
---|---|---|---|
出荷予定日 | 条件しだい。輸送条件やベンダーとの現在の取引契約によって異なる。 | オプション | オプション |
配送予定日 | 条件しだい。輸送条件やベンダーとの現在の取引契約によって異なる。 | オプション | オプション |
定価 | 書籍ベンダーのみ必要 | サポート対象 | 書籍ベンダーのみ必要 |
発注書ステータスの取得
The getPurchaseOrdersStatus
operation returns the status for the list of purchase orders that meet the criteria specified in the request. You can use this operation to get the acknowledgement status of the items in purchase orders available to you for fulfillment. This operation returns the history for ordered quantity and acknowledgements of an item. You can view details of all the acknowledgements processed for an item in a purchase order. We have provided a wide range of query parameters to filter the list of POs as per your requirement.
1 回のAPI 呼び出しで最大100件の注文を取得できます。100件を超える注文がある場合は、nextToken
を使用すれば次の注文集合を取得できます。
異なるクエリパラーメータを指定したgetPurchaseOrdersStatus
オペレーションの使用例をいくつか示します。
-
特定の日付範囲に該当する未処理の全発注書のステータスを取得する場合は、PO作成日(
createdBefore
およびcreatedAfter
)またはPO更新日(updatedBefore
およびupdatedAfter
)を指定してpurchaseOrderStatus=OPEN
を使用します。 -
使用できます
getPurchaseOrdersStatus
PoS のステータスをフィルタリングする操作。たとえば、itemConfirmationStatus=REJECTED
、レスポンスでは、1 つまたは複数の商品のステータスが「拒否」になっている注文がすべて返されます。 -
purchaseOrderNumber
クエリパラメーターでPO番号を指定すれば、特定のPOのステータスを確認できます。 -
orderingVendorCode
でベンダーコードを指定し、purchaseOrderStatus=OPEN
を含めれば、特定のベンダーコードに対する未処理POすべてのステータスを取得できます。 -
一定期間に作成されたPOのうち、特定のAmazon FCに配送する必要があるすべてのPOのステータスを確認する場合は、
shipToPartyId
でフルフィルメントセンター(FC)を指定し、createdBefore
とcreatedAfter
で期間を指定します。
発注書と確認のユースケース
購入注文の品目が無効です
注文書で無効な製品コードを受け取った場合は、確認コード付きの商品を拒否する必要があります。 Rejected
そして rejectionReason
なので InvalidProductIdentifier
:
購入注文
{
"order": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "New",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
購入注文確認
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 10
},
"rejectionReason": "InvalidProductIdentifier"
}
]
}
]
}
]
}
購入注文状況
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "CLOSED",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-17T19:17:34.304Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"orderedQuantityDetails": [
{
"updatedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
},
"acknowledgementStatus": {
"confirmationStatus": "REJECTED",
"acceptedQuantity": {
"amount": 0,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"acknowledgementStatusDetails": [
{
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"amount": 0,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
}
}
]
}
]
}
}
購入注文の廃止された品目
注文書で古くなった商品を受け取った場合は、確認コードを付けてその商品を拒否する必要があります Rejected
そして rejectionReason
なので ObsoleteProduct
。
購入注文
{
"order": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "New",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
購入注文確認
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266356",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123438",
"vendorProductIdentifier": "028877454079",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "IN",
"amount": "100.20"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 10
},
"rejectionReason": " ObsoleteProduct"
}
]
}
]
}
]
}
品目の一部の数量を確認し、残りの数量をバックオーダーします
アマゾンは10個の商品を注文しました。ベンダーは納品を分割する予定であるため、 Accepted
商品の数量は 6 個で、A BackOrdered
商品の数量が4の場合、最初の出荷では6ユニット、2回目の出荷では4ユニットが発送されます。
購入注文 — (購入注文のインポート)
{
"order": {
"purchaseOrderNumber": " L8266357",
"purchaseOrderState": "Acknowledged",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderChangedDate": "2019-07-18T16:05:00Z",
"purchaseOrderStateChangedDate": "2019-07-17T10:00:34.304Z",
"purchaseOrderType": "RegularOrder",
"importDetails": {
"importContainers": "2-20'HC,1-45',1-45'HC",
"internationalCommercialTerms": "FreeOnBoard",
"methodOfPayment": "PrepaidBySeller",
"portOfDelivery": "USA",
"shippingInstructions": "PREFERENCE IS PALLET-LOAD, BUT IF CONTAINERS ARE FLOOR-LOADED"
},
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "XYZ1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "XYZ1"
},
"billToParty": {
"partyId": "XYZ1",
"taxInfo": {
"taxRegistrationNumber": "12AAXYZ4259Z123",
"taxRegistrationType": "VAT"
}
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Eaches"
},
"isBackOrderAllowed": true,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
購入注文確認
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Accepted",
"acknowledgedQuantity": {
"amount": 6
},
"scheduledShipDate": "2019-07-17T19:17:34.304Z"
},
{
"acknowledgementCode": "Backordered",
"acknowledgedQuantity": {
"amount": 4
},
"scheduledShipDate": "2019-07-25T19:17:34.304Z"
}
]
}
]
}
]
}
注文の最初の部分の出荷後、ベンダーは入荷待ち品目のscheduledShipDate
を使用して、2番目の出荷に関するより正確な日付をAmazonに提供します。ベンダーは必ず、個々の品目の合計注文数量を記載した完全な更新情報を送信する必要があるのでご注意ください。完全な更新によって数量を明確に把握できます。
購入注文状況
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "OPEN",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-18T16:05:00Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "XYZ1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"orderedQuantityDetails": [
{
"updatedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
"acknowledgementStatus": {
"confirmationStatus": "ACCEPTED",
"acceptedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"acknowledgementStatusDetails": [
{
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"rejectedQuantity": {
"amount": 0,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
}
}
]
}
]
}
}
最初に受理された数量をキャンセルするための複数の確認
これは、最初に受け付けた注文の一部または全部を出荷できないことがわかり、それらの商品は出荷されないことをAmazonに通知したい場合に使用できます。
購入注文
{
"order": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "New",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
購入注文確認
最初、ベンダーは数量を受理しました。
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Accepted",
"acknowledgedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"scheduledShipDate": "2019-07-17T19:17:34.304Z"
}
]
}
]
}
]
}
その後、ベンダーは受理した数量を出荷できなくなり、別の購入注文確認リクエストを通じてすべてまたは一部のキャンセルを送信します。
すべてキャンセル
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"rejectionReason": "TemporarilyUnavailable"
}
]
}
]
}
]
}
一部キャンセル
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T20:10:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Accepted",
"acknowledgedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"scheduledShipDate": "2019-07-17T19:17:34.304Z"
},
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 7,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"rejectionReason": "TemporarilyUnavailable"
}
]
}
]
}
]
}
後続の一部キャンセル後の購入注文状況
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "OPEN",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-17T19:17:34.304Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"orderedQuantityDetails": [
{
"updatedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
},
"acknowledgementStatus": {
"confirmationStatus": "PARTIALLY_ACCEPTED",
"acceptedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 7,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"acknowledgementStatusDetails": [
{
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 0,
"unitOfMeasure": "Cases",
"unitSize": 5
}
},
{
"acknowledgementDate": "2019-07-17T20:10:34.304Z",
"acceptedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 7,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
}
}
]
}
]
}
}
ベンダー出荷APIとは何ですか?
You can use the Vendor Shipments API (Shipments API) to exchange shipment related documents with Amazon.
出荷APIには以下のオペレーションが含まれています。
オペレーション | HTTPメソッド | Path | 説明 |
---|---|---|---|
SubmitShipmentConfirmations
|
POST | /vendor/shipping/v1/shipmentConfirmations |
Amazonに1つまたは複数の出荷確認書を送信してください。 |
GetShipmentDetails
|
GET | /vendor/shipping/v1/shipments |
Amazonに送信された輸送リクエストの配送詳細を取得します。データ取得は、出荷リクエストが作成された日から最長6ヶ月間可能です。 |
SubmitShipments
|
POST | /vendor/shipping/v1/shipments |
Amazonに1つまたは複数の輸送リクエストを送信してください。 |
SubmitShipmentConfirmations
SubmitShipmentConfirmations
You can use the SubmitShipmentConfirmations
operation to submit shipment confirmations to Amazon. With your shipment confirmation we can efficiently receive and process your shipments. It contains information about the items being shipped, including purchase order number, ship date, estimated delivery date, lot number, expiration date, and the Serial Shipping Container Code (SSCC).
有効かつタイムリーな出荷確認書を受け取ることで、お客様が当社に送る貨物を正確に予測できます。出荷確認を送信することには、次のようなメリットがあります。
-
Amazonは、配送業者とより効果的に連携して、貨物の追跡と受け取りを行うことができます。これにより、人件費を効果的に計画し、貨物の迅速かつ効率的な受け取りが可能になります。つまり、POへの請求をより迅速に行えるようになります。
-
Amazonは入荷在庫を追跡し、自動注文を作成して、商品が在庫切れにならないようにすることができます。
-
輸送中の商品の可視性が向上し、商品の在庫状況(期間別の配送)をより正確に最終顧客に反映できるようになりました。
-
AmazonのPOキャンセルポリシーにより、未処理のPO出荷をキャンセルできます。ただし、出荷確認が正確であるPOは、輸送中の状況を社内システムに通知します。これにより、POの不必要なキャンセル、チャージバック、配送拒否を回避できます。
有効な出荷確認書がない場合、次のような結果になる可能性があります。
- 入荷物の可視性が不十分。
- 実際の出荷と発注書との照合エラー。
- 不一致を解決するための手動調査。
- 請求書発行用の配達証明(POD)を提出する必要があります。
出荷確認書 - 交換
出荷確認書に shipmentConfirmationType
の Replace
更新版を送信することで、以前に送信した出荷確認書を修正できます。2 回目の出荷確認コールでは、1 回目の出荷確認データが完全に上書きされます。
主な利点は、初回提出後に誤った出荷確認を更新することで、予約の正確性を高められることです。
どのように機能しますか?
以前に送信した出荷確認書を置き換えるには、2つ目の出荷確認を送信できます。は shipmentIdentifier
そして sellingParty.partyId
出荷確認書の以前のバージョンを正常に上書きするには、両方の送信で同一である必要があります。
出荷確認の範囲-交換
-
すべての出荷確認値は、以下を除いて編集できます。
shipmentIdentifier
そしてsellingParty.partyId
出荷確認を正常に行うには、同じ状態のままでなければなりません-交換してください。 -
パレット、カートン、出荷数量を増やすことはできませんが、減らすことはできます。増やす場合は、2番目の出荷通知を新しい
shipmentIdentifier
で送信する必要があります。追加分を同じ貨物で配送する場合は、同じBOL番号を使用できます。 -
A shipment confirmation submitted using the API can only be edited by submitting another shipment confirmation using the API. A shipment confirmation created in Vendor Central cannot be edited using the API.
-
出荷確認書の交換は、最初の出荷確認から7日以内で、出荷品がまだAmazonフルフィルメントセンターに届いていない場合にのみ可能です。
正常に提出された出荷確認書の検証
You can verify the status of your original or replaced shipment confirmations via Vendor Central > Orders > Shipments or by using the Transaction Status API. It can take the system up to 30 min to show the original/replaced version after submission. If Vendor Central is not showing the correct values for the replaced shipment confirmation, open a Contact Us case in Vendor Central.
次の図は、出荷確認書を提出するときの統合ワークフローを示しています。
ビジネスの要件
-
ベンダーが重量制で販売される商品を発送する場合、ベンダーは以下を提供する必要があります
totalWeight
フィールド。ザ・totalWeight
フィールドには、ベンダーが出荷する商品の重量と重量の測定単位が含まれます。重量の測定単位には以下が含まれます。POUNDS
、OUNCES
、GRAMS
、およびKILOGRAMS
。 -
トラック積載輸送1件あたりの出荷確認書の数は、100に制限されています。つまり、POレベルまたはカートンレベルで個別の出荷確認書を送信できるのは、そのトラック積載(TL)/パレット(LTL)輸送について、個々の出荷確認書の総数が100 件以下である場合に限られます。TL/LTLの出荷全体について、POとカートンのすべての詳細を含む1つの出荷確認書を送信することをおすすめします。
-
Amazonは、Amazonフルフィルメントセンターで商品を受け取る前に、出荷通知書を受け取らなければなりません。出荷通知書が届かなかったり遅れたりすると、払い戻し(チャージバック)の対象となります。
-
個口配送の場合、すべてのパッケージ/カートンに出荷確認書が求められます。
-
Amazonでは以下のものを求めており、これらはコンプライアンスを追跡するために測定されます。
- パレット配送の場合、Amazonフルフィルメントセンターで配送スロットをリクエストする前に出荷確認を送信する必要があります。これは、Amazonシステムで有効な出荷確認が見つかった場合にのみ予約が行われるためです。例外については、現地の出荷確認書を参照してください。 ヘルプ 利用可能なオプションを理解するためのページです。小包の場合は、商品を発送する前に出荷確認書を提出する必要があります。出荷通知を見逃したり遅れたりすると、チャージバックが発生します。
- 出荷確認は、1つのベンダーからの1回の納品、および1つのトラックのみを対象とする必要があります。複数のトラックでの発送、複数のAmazonフルフィルメントセンターへの配送、複数のベンダーアカウントからの発送、または複数日に到着する納品には、複数の出荷確認が必要です。
- 同じ仕入先アカウントからの複数の小口貨物をまとめて大量出荷にし、複数の出荷確認が必要な場合は、以下の例のように包括的な BOL オプションを使用できます。
出荷確認 1
"billOfLadingNumber": "BOL1"
"shipmentIdentifier": "SHIPMENT CONFIRMATION_ID1"
出荷確認 2
"billOfLadingNumber": "BOL1"
"shipmentIdentifier": "SHIPMENT CONFIRMATION_ID2"
国固有のビジネス要件
機能 | ビジネス定義 | インド | ヨーロッパ | 北米 |
---|---|---|---|---|
船荷証券番号/配送見積もり |
BOL number is the unique number assigned by the vendor. The BOL present in the shipment confirmation ideally matches the paper BOL provided with the shipment, but that is not required. Refer to Additional field explanations for more information. The BOL reference is used for appointment booking and shipment label creation.
配送見積書番号は、貨物の参照番号としてBOLに代わるものです。 |
条件付き |
すべての出荷確認書に必須です。 | FTLまたはLTL配送には必須です。 |
配送業者の出荷参照番号(PRO#) | PRO番号(PRO番号)は、配送業者が割り当てる固有の番号です。この番号は、配送される出荷物の識別と追跡に使用されます。 | すべての出荷確認書に必須です。 | オプション | すべての出荷確認書に必須です。 |
出荷日 | 出荷物がベンダーの倉庫を出る日付。 |
すべての出荷確認書に必須です。 |
すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 |
お届け予定日 |
出荷品がAmazonのフルフィルメントセンターに到着する予定の日付。これは、発送元と配送先の間の平均輸送時間に基づく推定である必要があります。正確な予約時間はAmazonが提供しますが、出荷の作成時にはわからない可能性があります。 |
すべての出荷確認書に必須です。 |
すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 |
カートン数 | 出荷に含まれるカートンの数。外側のカートンなしでパレットに積み重ねられた商品は、1商品 = 1カートンとしてカウントされます。カートンの数は、出荷レベルでは必須です。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 |
パレット数 | 出荷に含まれるパレットの数。純粋な個口出荷の場合、値0が示されている必要があり、このセグメントでは、パレットでFCに届くすべてのボリュームが、最低数の1を示している必要があります。この情報は、出荷レベルでは必須です。 | パレット配送のすべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 | FTLおよびLTL配送には必須です。 |
スキャックコード(SCAC) | 配送業者を識別するコード。スキャックコード(SCAC)は、配送業者を識別するために使用される固有の2~4文字のコードです。運送業者のSCACコードは、NMFTA(全国自動車輸送協会)によって割り当てられ、管理されます。 | オプション | オプション | すべての出荷確認書に必須です。 |
発送場所(発送先) | 商品の発送先のパーティID/倉庫コード。APIスキーマのフィールド名は「ShipToParty」です。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 |
サプライヤーID | Amazonに商品を発送するサプライヤーのサプライヤーID。APIスキーマのフィールド名は「sellingParty」です。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 | オプション |
発送元 | 製品の出荷元の住所(郵便番号)と国番号。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 |
Amazon参照番号(WePay出荷のみ)。 | ルーティング手順に記載されているAmazonリファレンスナンバー (GetShipmentDetails 応答) はWePay配送の場合です。 |
出荷確認書でのみ必須です (WePay出荷の場合)。 |
出荷確認書でのみ必須です (WePay出荷の場合)。 |
コレクト出荷には必須です。 |
購入注文番号 | Amazon購入注文番号。サプライヤーが指定された価格で商品を発送することに対する書面による承認。サプライヤーが承諾すると、法的拘束力のある契約となります。 | ヘッダーまたは品目レベルでは必須です。 | ヘッダーまたは品目レベルでは必須です。 | ヘッダーまたは品目レベルでは必須です。 |
連続出荷梱包コード(SSCC) | パレット/カートンを定義するために、固有の18桁の連続出荷梱包コード(SSCC)を含める必要があります。 | 梱包ユニット内のすべての出荷確認書に推奨されます。 | 梱包ユニット内のすべての出荷確認書に必須です。 | 梱包ユニット内のすべての出荷確認書に必須です。 |
品目識別 | 商品のベンダーSKU。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 |
ロット番号 | バッチ番号またはロット番号は、エレメントストリングが適用される取引品目のトレーサビリティに関連するとメーカーが考える情報に品目を関連付けるものです。データは、取引品目自体を参照する場合もあれば、含まれている品目を参照する場合もあります。 | 生鮮品目には必須です。 | 生鮮品目には必須です。 | 生鮮品目には必須です。 |
有効期限 | 製品の消費期限または使用期限を決定する日付。その意味は、取引品目のコンテキストに基づいて決定されます。 | 生鮮品目には必須です。 | 生鮮品目には必須です。 | 有効期限か、製造日および賞味期限のいずれかが必要です。 |
製造日 | 製造日、梱包日、組立日はメーカーが決定します。その意味は、取引品目のコンテキストに基づいて決定されます。 | オプション | オプション | 有効期限か、製造日および賞味期限のいずれかが必要です。 |
数量 | 特定の品目について発送されたユニット数。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 | すべての出荷確認書に必須です。 |
その他のフィールドの説明
船荷証券番号
船荷証券番号 (BOL #)は、Amazonでの予約に必要な参照番号です。この番号は、Amazonから有効な出荷確認を求められたときに提供する必要があります。これは、物理的な出荷に付随する書類のデフォルトの参照番号です。出荷確認書に記載されている BOL 番号は、出荷書類に記載されている BOL 番号と一致している必要があります。
BOL #を定義するときは、それがすべての貨物で一意であることを確認してください。BOL #を物理的な BOL の基準にすることもできますが、別の番号を選択した場合は以下のようになります。
- 最低 8 桁を使用してください。
- Amazonベンダーコードをプレフィックスとして使用(例:ABCD193939393)。
- 日付や時刻は使用しないでください。
出荷の識別
このフィールドは、この出荷確認を表す一意のIDです (一意性はベンダーのコンテキスト内で定義されます)。入力に失敗した Shipment Identification
その結果、出荷確認が却下されます。送信した ID が過去 365 日間使用されていないことを確認してください。
出荷日
このフィールドには、ベンダーの所在地からの貨物の出発日が表示されます。ベンダーは、貨物がAmazon FCに到着する前に、出荷確認書を送付する必要があります。
お届け予定日
これは、経験に基づいた、Amazonフルフィルメントセンターへの配送予定日の概算です。ベンダーは、配送業者の平均輸送時間に基づいてこれを決定する必要があります。この情報は、Amazonが、配送業者からお届け予定日を受け取っていない場合に出荷計画を立てるうえで役立ちます。
この段階では予定日が不明な場合がありますが、この日付は出荷ごとに指定する必要があります。
連続出荷梱包コード(SSCC)
Amazonでは、ライセンスプレートまたはLP Receiveと呼ばれる高度に自動化された方法で領収書を処理します。このプロセスでは、出荷確認メッセージにカートンの内容の詳細を入力する必要があります。この受領プロセスでは、受領した商品のカートンまたはパレットの外側にあるシリアル出荷コンテナコード (SSCC) バーコードをスキャンするため、カートンまたはパレット内の各商品をスキャンする必要がなくなります。このプロセスには、効率の向上、受入精度の向上、支払いの正確性の向上、支払いサイクルタイムの短縮など、多くの大きな利点があります。
AmazonはGS1-128ソリューションに厳密に従わないことを決定したため、技術的なソリューションを選択できます。Amazon ライセンスプレートの要件に準拠するには、SSCC はパレットまたはカートンを定義する一意の 18 桁のコードでなければなりません。また、365 日以内に繰り返し使用することはできず、カートンラベルと出荷確認メッセージの両方にバーコードが含まれている必要があります。さらに、物理ラベルのバーコードは、出荷確認書の SSCC と 100% 一致する必要があります。GS1-128 の導入を希望するベンダーは、次の項目を追加するよう求められます。 00
出荷確認書に記載されている SSCC の開始時。
For more information about generating an SSCC and the requirements for the physical shipment, refer to Vendor Central. To locate the Vendor Manual with labelling requirements, select Shipping, then License Plate label and receiving requirements.
有効期限
有効期限は、製品の消費または使用の期限を決定する日付です。取引品目のコンテキストに基づいて決定されます(たとえば、食品の場合はその日付以降に製品を使用することによる直接的な健康リスクの可能性を示し、医薬品の場合はその日付以降に製品が効かなくなったことによる間接的な健康リスクの可能性を示します)。これは多くの場合「使用期限」または「最大耐久性期限」と呼ばれます。
製造日
これは、商品が梱包または製造された日付です。このフィールドは、品目が生鮮品、または賞味期限が定められている場合に入力する必要があります。
ロット番号
バッチ番号またはロット番号は、品目自体または品目に含まれる原料のトレーサビリティに関連すると製造業者が考える情報に品目を関連付けます。番号は、製造ロット、作業シフト、機械、時間、または社内製造コードを示すことができます。
出荷通知における有効期限/製造日/ロット番号の使用
これらのフィールドは、生鮮品にのみ必須です。つまり、次のような商品にのみ必須です。 is expiration dated product
属性は Yes
新品目設定 (NIS) フォームで。
出荷確認書で有効期限、製造日、またはロット番号を定義する場合:
-
有効期限、製造日、ロット番号は品目単位で送信する必要があります。
-
ケース/パレットには複数の品目(ASIN)を入れることができ、それぞれに個別の有効期限、製造日、ロット番号があります。
-
1つの品目(ASIN)について、同じケース/パレット内に複数の有効期限、製造日、ロット番号を設定することはできません。
ベンダーは、出荷確認書に有効期限と製造日をYYYYMMDD形式で入力する必要があります。
出荷通知のユースケース
有効期限とロット番号が記載された小包標準ケース
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "TruckLoad",
"shipmentStructure": "LooseStandardCase",
"transportationDetails": {
"carrierScac": "UPSN",
"billOfLadingNumber": "02440000"
},
"amazonReferenceNumber": "ARN_Number",
"shipmentConfirmationDate": "2019-07-29T21:56:18.575Z",
"shippedDate": "2019-07-29T21:56:18.575Z",
"estimatedDeliveryDate": "2019-07-29T21:56:18.575Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"cartonCount": 2
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"amazonProductIdentifier": "AB1234233",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"amount": 50,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": " 001",
"trackingNumber": "UPS TRACKING NUMBER",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698889"
}
],
"cartonSequenceNumber": " 002",
"trackingNumber": "UPS TRACKING NUMBER",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
}
]
}
]
}
小規模 LooseAssortmentCase
有効期限とロット番号が記載された小包
LooseAssortmentCase
有効期限とロット番号が記載された小包{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "TruckLoad",
"shipmentStructure": "LooseAssortmentCase",
"transportationDetails": {
"carrierScac": "UPSN",
"billOfLadingNumber": "02440000"
},
"amazonReferenceNumber": "ARN_Number",
"shipmentConfirmationDate": "2019-07-29T21:56:18.575Z",
"shippedDate": "2019-07-29T21:56:18.575Z",
"estimatedDeliveryDate": "2019-07-29T21:56:18.575Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"cartonCount": 2
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"amazonProductIdentifier": "AB1234233",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"amount": 50,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
},
{
"itemSequenceNumber": "002",
"amazonProductIdentifier": "AB1234235",
"vendorProductIdentifier": "VN24343370",
"shippedQuantity": {
"amount": 50,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": " 001",
"trackingNumber": "UPS TRACKING NUMBER",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 1
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
]
}
]
}
]
}
複数の品目があるパレット付きトラック積載
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "TruckLoad",
"shipmentStructure": "PalletizedAssortmentCase",
"transportationDetails": {
"transportationMode": "Road",
"billOfLadingNumber": "02440000"
},
"shipmentConfirmationDate": "2019-08-07T19:56:45.632Z",
"shippedDate": "2019-08-07T19:56:45.632Z",
"estimatedDeliveryDate": "2019-08-07T19:56:45.632Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "VENDORWAREHOUSECODE"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "250"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"palletCount": 2
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
},
{
"itemSequenceNumber": "002",
"vendorProductIdentifier": "9782700001000",
"shippedQuantity": {
"amount": 400,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": "001",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAAAA",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACC",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698999"
}
],
"cartonSequenceNumber": "002",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698669"
}
],
"cartonSequenceNumber": "003",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666697799"
}
],
"cartonSequenceNumber": "004",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
}
],
"pallets": [
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098745"
}
],
"tier": 1,
"block": 2,
"dimensions": {
"length": "1.2",
"width": "0.8",
"height": "1",
"unitOfMeasure": "In"
},
"weight": {
"unitOfMeasure": "Kg",
"value": "55"
},
"cartonReferenceDetails": {
"cartonCount": 2,
"cartonReferenceNumbers": [
"001",
"002"
]
}
},
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098700"
}
],
"tier": 1,
"block": 2,
"dimensions": {
"length": "1.2",
"width": "0.8",
"height": "1",
"unitOfMeasure": "In"
},
"weight": {
"unitOfMeasure": "Kg",
"value": "55"
},
"cartonReferenceDetails": {
"cartonCount": 2,
"cartonReferenceNumbers": [
"003",
"004"
]
}
}
]
}
]
}
パレット付きの標準ケースではトラック積載出荷よりも少ない
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "LessThanTruckLoad",
"shipmentStructure": "PalletizedStandardCase",
"transportationDetails": {
"transportationMode": "Road",
"billOfLadingNumber": "02440000"
},
"shipmentConfirmationDate": "2019-08-07T19:56:45.632Z",
"shippedDate": "2019-08-07T19:56:45.632Z",
"estimatedDeliveryDate": "2019-08-07T19:56:45.632Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "VENDORWAREHOUSECODE"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"palletCount": 1
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAAAA",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "299.00"
},
"handlingCode": "Oversized"
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": "001",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666699999"
}
],
"cartonSequenceNumber": "002",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666696666"
}
],
"cartonSequenceNumber": "003",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666697777"
}
],
"cartonSequenceNumber": "004",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
}
],
"pallets": [
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098745"
}
],
"tier": 2,
"block": 2,
"dimensions": {
"length": "1.2",
"width": "0.8",
"height": "1",
"unitOfMeasure": "In"
},
"weight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"cartonReferenceDetails": {
"cartonCount": 4,
"cartonReferenceNumbers": [
"001",
"002",
"003",
"004"
]
}
}
]
}
]
}
単一ASINパレットの出荷量がトラック積載量より少ない
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "5013088794",
"shipmentConfirmationType": "Original",
"shipmentType": "LessThanTruckLoad",
"shipmentStructure": "PalletOfItems",
"transportationDetails": {
"carrierShipmentReferenceNumber": "1021396377",
"billOfLadingNumber": "501308879400010001",
"transportationMode": "Road"
},
"shipmentConfirmationDate": "2023-04-21T22:31:43Z",
"shippedDate": "2023-04-21T22:31:43Z",
"estimatedDeliveryDate": "2023-04-21T22:31:43Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "181.656"
},
"palletCount": 3,
"grossShipmentWeight": {
"unitOfMeasure": "Lb",
"value": "3315.744"
}
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"amount": 315,
"unitOfMeasure": "Cases",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2024-11-29T21:56:18.575Z"
}
}
}
],
"pallets": [
{
"tier": 10,
"palletIdentifiers": [
{
"containerIdentificationNumber": "108195730651297459",
"containerIdentificationType": "SSCC"
}
],
"weight": {
"unitOfMeasure": "Lb",
"value": "828.936"
},
"block": 15,
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 105,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
],
"dimensions": {
"unitOfMeasure": "In",
"length": "44.375",
"width": "39.750",
"height": "40.500"
}
},
{
"tier": 10,
"palletIdentifiers": [
{
"containerIdentificationNumber": "108195730651297589",
"containerIdentificationType": "SSCC"
}
],
"weight": {
"unitOfMeasure": "Lb",
"value": "828.936"
},
"block": 15,
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 105,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
],
"dimensions": {
"unitOfMeasure": "In",
"length": "44.375",
"width": "39.750",
"height": "40.500"
}
},
{
"tier": 10,
"palletIdentifiers": [
{
"containerIdentificationNumber": "108195730651297595",
"containerIdentificationType": "SSCC"
}
],
"weight": {
"unitOfMeasure": "Lb",
"value": "828.936"
},
"block": 15,
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 105,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
],
"dimensions": {
"unitOfMeasure": "In",
"length": "44.375",
"width": "39.750",
"height": "40.500"
}
}
]
}
]
}
SubmitShipments
SubmitShipments
重要
SubmitShipments
北米と EU のマーケットプレイスでのみご利用いただけます。
The SubmitShipments
operation is designed for Collect or WePay vendors to submit requests for the pickup of their shipments by Amazon. With this operation they can also update or cancel submitted requests. You can consolidate multiple orders that are ready to be shipped and request transportation through a single shipment request, thus saving time and lowering costs. When submitting a shipment request, the requested pickup date must be a minimum of two business days after the current date.
注
ザの
SubmitShipments
オペレーションでは、非標準パレットの出荷リクエストの送信はサポートされていません。
納品の作成または更新
いつ transactionType
発送リクエストの場合 New
新しいリクエストを作成したり、以前に送信した出荷リクエストを更新したりできます。既存の出荷リクエストの更新は、ベンダー納品番号に基づいて行われます。指定されたベンダー出荷IDの出荷が既に存在する場合、更新操作が行われ、そうでない場合は新しい出荷が作成されます。
アップデートの出荷範囲:
- 出荷リクエストの値は、以下を除いてすべて編集可能です。
vendorShipmentIdentifier
、buyerReferenceNumber
、およびsellingParty.partyId
正常に更新するには同じままでなければなりません。配送業者が割り当てられる前に、出荷リクエストの他のすべてのフィールドを柔軟に変更できます。 - 出荷リクエストの集荷希望日は、運送業者が割り当てられた後にのみ変更できます。
発送をキャンセル
での出荷リクエスト transactionType
なので Cancel
以前に送信した出荷リクエストをキャンセルできます。以前に送信した出荷リクエストをキャンセルするには、以下を提供する必要があります。 vendorShipmentIdentifier
、 buyerReferenceNumber
、 sellingParty.partyId
、 shipFromParty.partyId
、 shipToParty.partyId
そして transactionType
なので Cancel
。
出荷キャンセルの範囲:
- 配送依頼のキャンセルは、運送業者が割り当てられ、ルーティングがスケジュールされる前でも後でも可能です。
出荷リクエストが正常に送信されたことの確認
You use Vendor Central or the Vendor Transaction Status API to verify the status of your shipment request. If the status of the posted request doesn't appear after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.
注
The Transaction Status API only supports
Processing
andFailure
status values for submitted Cancel Shipment requests.
次の図は、出荷リクエストを送信する際の統合ワークフローを示しています。
ビジネスの要件
- 出荷リクエストは、対応するPOが完全に確認された後にのみ送信してください。POがまだ確認されていない場合、出荷リクエストは処理されません。
- ザの
requestedPickUp
出荷リクエストでは、現在の日付から最低2営業日後である必要があります。 - 出荷リクエストの値は、以下を除いてすべて編集可能です。
vendorShipmentIdentifier
、buyerReferenceNumber
、およびsellingParty.partyId
正常に更新するには同じままでなければなりません。配送業者が割り当てられる前に、出荷リクエストの他のすべてのフィールドを柔軟に変更できます。 - 配送依頼で希望集荷日を変更できるのは、運送業者が割り当てられた後のみです。
- 配送依頼のキャンセルは、運送業者が割り当てられ、ルーティングがスケジュールされる前でも後でも可能です。
その他のフィールドの説明
仕入先出荷識別子
このフィールドは、この輸送リクエストを表す一意のID(一意性はベンダーのコンテキスト内で定義されます)です。の提供に失敗した vendorShipmentIdentifier
その結果、輸送リクエストは拒否されます。送信したIDが過去365日間使用されていないことを確認してください。
お受け取り希望日
このフィールドとも呼ばれています Freight Ready Date
、ベンダーの所在地からの最も早い出荷集荷日を指定するために使用されます。商品の集荷準備が整ったら、輸送リクエストを送信するように求められます。
出荷例リクエストを送信
出荷リクエストの作成または更新
{
"shipments": [
{
"vendorShipmentIdentifier": "00050003",
"transactionType": "New",
"transactionDate": "2019-08-07T19:56:45.632",
"shipmentFreightTerm": "Collect",
"sellingParty": {
"partyId": "PQRSS"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "999US"
},
"shipToParty": {
"partyId": "ABCDF"
},
"shipmentMeasurements": {
"totalCartonCount": 30,
"totalPalletStackable": 30,
"totalPalletNonStackable": 30,
"shipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
}
},
"collectFreightPickupDetails": {
"requestedPickUp": "2019-08-07T19:56:45.632"
},
"purchaseOrders": [
{
"purchaseOrderNumber": "1BBBAAAA"
},
{
"purchaseOrderNumber": "1BBBACCC"
}
]
}
]
}
出荷リクエストをキャンセル
{
"shipments": [
{
"vendorShipmentIdentifier": "00050003",
"buyerReferenceNumber": "1234567",
"transactionType": "Cancel",
"transactionDate": "2019-08-07T19:56:45.632",
"shipmentFreightTerm": "Collect",
"sellingParty": {
"partyId": "PQRSS"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "999US"
},
"shipToParty": {
"partyId": "ABCDF"
}
}
]
}
GetShipmentDetails
GetShipmentDetails
重要
GetShipmentDetails
北米および EU マーケットプレイスでの WePay およびコレクト注文のみを対象としています。
You can use the GetShipmentDetails
operation to retrieve scheduled pickup and carrier assignment information. You must use SubmitShipments
or a routing request before shipment details are available. GetShipmentDetails
only returns a response after carrier assignment, which occurs either on the same day as the scheduled pickup or one day prior to the pickup date.
返信で返される詳細情報は、配送プロセスを効率的に実行し、注文が梱包され、指定された集荷日に運送業者が商品を受け取る準備ができていることを確認するのに役立ちます。出荷ライフサイクル中はいつでも、この操作を使用して貨物の状況と詳細を確認できます。この操作は主に WePay ベンダーが使用します。
次の図は、Vendor Get 出荷統合ワークフローを示しています。
ビジネスの要件
-
The
GetShipmentDetails
operation only provides a response if shipment creation is successful. The response contains the Amazon Reference Number (ARN) and other shipment details. The carrier assignment details are available only after the carrier assignment for the shipment. Carrier assignment occurs on the same day as the scheduled pickup or one day prior to the pickup date. -
The
GetShipmentDetails
operation will not provide details for shipments submitted through Vendor Central.
GetShipmentDetails
が必須
GetShipmentDetails
が必須To return a list of shipments, call the GetShipmentDetails
operation and pass the following parameters:
クエリーパラメーター:
名前 | 説明 | 必須 |
---|---|---|
limit |
返されるレコード数への制限。 タイプ:整数 |
いいえ |
sortOrder |
リストを納品作成日の昇順または降順でソートします。 タイプ:文字列 Type: enum (
|
いいえ |
nextToken |
配送ラベル数が指定された結果サイズの制限を超える場合、ページ割りに使用します。トークン値は前のAPI呼び出しで返されます。 タイプ:文字列 |
いいえ |
createdAfter |
Shipments created after this time will be included in the result. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
createdBefore |
Shipments created before this time will be included in the result. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
shipmentConfirmedBefore |
Use to provide the date to retrieve Shipment Details of all shipments confirmed before this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
shipmentConfirmedAfter |
Use to provide the date to retrieve Shipment Details of all shipments confirmed after this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
packageLabelCreatedBefore |
Use to provide the date to fetch Shipment Details of all shipments for which package labels were created before this date. This field must be in ISO 8601 date/time format.
タイプ:文字列 (ブール値) |
いいえ |
packageLabelCreatedAfter |
Use to provide the date to retrieve Shipment Details of all shipments for which package labels were created after this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
shippedBefore |
Use to provide the date to retrieve Shipment Details of all shipments for which shipped date is before this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
shippedAfter |
Use to provide the date to retrieve Shipment Details of all shipments for which the shipped date is after this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
estimatedDeliveryBefore |
Use to provide the date to retrieve Shipment Details of all shipments for which estimated delivery date is before this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
estimatedDeliveryAfter |
Use to provide the date to retrieve Shipment Details of all shipments with estimated delivery date after this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
shipmentDeliveryBefore |
Use to provide the date to retrieve Shipment Details of all shipments with shipment delivery date before this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
shipmentDeliveryAfter |
Use to provide the date to retrieve Shipment Details of all shipments for which shipment delivery date is after this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
requestedPickUpBefore |
Use to provide the date to retrieve Shipment Details of all shipments for which requested pickup date is before this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
requestedPickUpAfter |
Use to provide the date to retrieve Shipment Details of all shipments for which requested pickup date is after this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
scheduledPickUpBefore |
Use to provide the date to retrieve Shipment Details of all shipments for which scheduled pickup date is before this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
scheduledPickUpAfter |
Use to provide the date to retrieve Shipment Details of all shipments for which scheduled pickup date is after this date. This field must be in ISO 8601 date/time format.
データ型:文字列(日時) |
いいえ |
currentShipmentStatus |
現在の配送状況を渡すと、配送の詳細が表示されます。 タイプ:文字列 |
いいえ |
vendorShipmentIdentifier |
ベンダー納品番号を渡して出荷詳細を取得します。 タイプ:文字列 |
いいえ |
buyerReferenceNumber |
購入者照会番号を渡すと、配送の詳細が表示されます。 タイプ:文字列 |
いいえ |
buyerWarehouseCode |
購入者の倉庫コードに基づいて配送詳細を取得します。この値は、次の値と同じでなければなりません。 shipToParty.partyId 発送中。 タイプ:文字列 |
いいえ |
sellerWarehouseCode |
ベンダーの倉庫コードに基づいて配送詳細を取得します。この値は、次の値と同じでなければなりません。 sellingParty.partyId 発送中。 タイプ:文字列 |
いいえ |
リクエストの例:
GET https://sellingpartnerapi-na.amazon.com/vendor/shipping/v1/shipments?vendorShipmentIdentifier=00050003
GetShipmentDetails
の値:
GetShipmentDetails
の値:レスポンスの例:
{
"payload": {
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"shipments": [
{
"vendorShipmentIdentifier": "00050003",
"buyerReferenceNumber": "1234567",
"currentShipmentStatus": "CarrierAssigned",
"currentshipmentStatusDate": "2019-08-09T19:56:45.632",
"shipmentStatusDetails": [
{
"shipmentStatus": "CarrierAssigned",
"shipmentStatusDate": "2019-08-09T19:56:45.632"
},
{
"shipmentStatus": "TransportationRequested",
"shipmentStatusDate": "2019-07-07T19:56:45.632"
},
{
"shipmentStatus": "Created",
"shipmentStatusDate": "2019-07-06T19:56:45.632"
}
],
"shipmentCreateDate": "2019-07-06T19:56:45.632",
"shipmentFreightTerm": "Collect",
"sellingParty": {
"partyId": "998US"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCD12"
},
"shipToParty": {
"partyId": "999US"
},
"shipmentMeasurements": {
"totalCartonCount": 30,
"totalPalletStackable": 30,
"totalPalletNonStackable": 30,
"shipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
}
},
"collectFreightPickupDetails": {
"requestedPickUp": "2019-08-10T19:56:45.632",
"scheduledPickUp": "2019-08-10T19:56:45.632",
"carrierAssignmentDate": "2019-08-09T19:56:45.632",
},
"purchaseOrders": [
{
"purchaseOrderNumber": "1BBBAAAA"
}
],
"transportationDetails": {
"shipMode": "LessThanTruckLoad",
"transportationMode": "Road",
"shippedDate": "2019-08-07T19:56:45.632",
"estimatedDeliveryDate": "2019-08-07T19:56:45.632",
"shipmentDeliveryDate": "2019-08-07T19:56:45.632",
"carrierDetails": {
"name": "UPS",
"phone": "1234567890",
"email": "abc@xyz.com",
"code": "string",
"shipmentReferenceNumber": "TRACK001"
},
"billOfLadingNumber": "string"
}
}
]
}
}
GetShipmentLabels
GetShipmentLabels
You can use the GetShipmentLabels
operation to obtain shipping labels from Amazon exclusively for small parcel shipments on behalf of Collect/WePay vendors. This operation helps vendors retrieve shipping labels for confirmed orders that require shipment from the vendor's warehouse to Amazon's warehouse. Vendors can retrieve labels through a single API call or multiple API calls. Labels are generated once the shipment request is finalized and a carrier is assigned. Vendors have the option to filter Amazon-generated labels based on various parameters, such as buyer reference numbers (also known as Amazon reference numbers), seller warehouse codes, and other values.
次の図は、仕入先出荷ラベル取得統合ワークフローを示しています。
ビジネスの要件
- に電話してください
GetShipmentLabels
配送業者が割り当てられた後のみ。 - If
GetShipmentLabels
does not return a label or returnsResource Not Found
, verify that a carrier has been assigned. Alternatively, you can callGetShipmentDetails
to confirm whether the carrier has been assigned. - 配送業者が割り当てられても操作してもラベルが返されない場合は、ベンダーセントラルポータルで「お問い合わせ」ケースを開いてください。
- 一度配送に使用したラベルは再利用できません。
国固有のビジネス要件
この API 操作は NA リージョンでのみ使用できます。
クエリーリクエスト
To return a list of shipment labels, call the GetShipmentLabels
operation and pass the following parameters:
名前 | 説明 | 必須 |
---|---|---|
limit |
返されるレコード数への制限。 タイプ:整数 |
いいえ |
sortOrder |
リストを出荷ラベルの作成日で昇順または降順にソートします。 タイプ:文字列 Type: enum (
|
いいえ |
nextToken |
注文数が指定された結果サイズの制限を超える場合、ページ割りに使用します。トークン値は前のAPI呼び出しで返されます。 タイプ:文字列 |
いいえ |
labelCreatedAfter |
この時間以降に作成された出荷ラベルが結果に含まれます。このフィールドは ISO 8601 日付/時刻形式である必要があります。 データ型:文字列(日時) |
いいえ |
labelCreatedBefore |
この時間より前に作成された出荷ラベルが結果に含まれます。このフィールドは ISO 8601 日付/時刻形式である必要があります。 データ型:文字列(日時) |
いいえ |
buyerReferenceNumber |
購入者照会番号を渡して出荷ラベルを入手してください。 タイプ:文字列 |
いいえ |
vendorShipmentIdentifier |
ベンダー納品番号を渡して出荷ラベルを取得します。 タイプ:文字列 |
いいえ |
sellerWarehouseCode |
ベンダーの倉庫コードに基づいて配送ラベルを入手してください。この値は、と同じである必要があります。 sellingParty.partyId 発送中。 タイプ:文字列 |
いいえ |
リクエストの例
GET /vendor/shipping/v1/transportLabels?vendorShipmentIdentifier=7822
出荷ラベルの返答を取得
{
"payload": {
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"transportLabels": [
{
"labelCreateDateTime": "2024-10-23T17:10:35Z",
"shipmentInformation": {
"vendorDetails": {
"sellingParty": {
"partyId": "WAD47"
},
"vendorShipmentIdentifier": "7822"
},
"buyerReferenceNumber": "14511336331",
"shipToParty": {
"partyId": "LAX9"
},
"shipFromParty": {
"partyId": "0-55767831",
"address": {
"name": "Wheeler Bros., Inc. HQ",
"addressLine1": "384 Drum Ave",
"addressLine2": "Suite 123",
"addressLine3": "DOOR 1",
"city": "Somerset",
"stateOrRegion": "PA",
"postalCode": "15501",
"countryCode": "US"
}
},
"masterTrackingId": "1ZR873R70319165935",
"totalLabelCount": 1,
"shipMode": "SmallParcel"
},
"labelData": [
{
"labelSequenceNumber": 1,
"labelFormat": "PDF",
"carrierCode": "UPSN",
"trackingId": "1ZR873R70319165935",
"label": "Base 64 encoded string goes here."
}
]
}
]
}
}
仕入先請求書 API とは何ですか?
You can use the Vendor Invoices API, to exchange payment related documents with Amazon. With the Submit Invoices operation, you can send vendor invoices to Amazon for confirmed and shipped orders.
以下のオペレーションが含まれています。
オペレーション | HTTPメソッド | Path | 説明 |
---|---|---|---|
submitInvoices | POST | /vendor/payments/v1/invoices | 1 つ以上のベンダー請求書をAmazonに提出 |
注
ザの
submitInvoices
オペレーションはヨーロッパでのクレジットノートの提出に使用できます。
請求書を提出
You can use the submitInvoices
operation to request payment from Amazon for items shipped. You can use this operation to submit multiple invoices in a single API call.
品目の支払いを請求するためには、その品目が確認されAmazonに出荷されていなければなりません。そうでない場合、請求書は拒否されます。
正しい情報が記載された請求書は、Amazonが人的介入なしで処理します。つまり、ベンダーはより迅速に支払いを受けることができます。
Invoices with incorrect information will be rejected in Amazon's payee system, so sending correct information is important. Refer to the business requirements section to learn how to create invoices with correct information.
請求書送信の並列テスト
You need to complete parallel testing with our payments system before you can start using the submitInvoices
operation for payment processing.
API を使用して請求書を送信し始めると、並行テストフェーズが開始されます。並行テストフェーズでは、出荷されたすべての注文についてベンダーセントラルと API の請求書を送信します。少なくとも 5 ~ 10 個の請求書ファイルの内容が検証されるまで、並行テストを行う必要があります。並行テストはプロダクションPOとインボイスを対象に実施されます。
並行テストが完了したとき、または請求書の内容に不一致がある場合は、Amazon買掛金(AP)チームから連絡があります。
並行テストが完了したというメールを受け取ったら、ベンダーセントラルの請求書を送信する必要はもうありません。API を使用して請求書を送信できます。
正常に提出された請求書の検証
The Transaction Status API shows the status of the semantic validations for submitted invoices, but not the actual status of invoice processing. You can verify the actual status of the original or updated version of the invoices via Vendor Central > Payments > Invoices. For more information on how to use the Transaction Status API, refer to the business use case documentation for Transaction Status. If the original or updated version with the correct values for the updated invoice isn't present after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.
次の図は、確認済みで発送済みの注文品の請求書を提出する場合の統合ワークフローを示しています。
ビジネスの要件
-
重量に基づいて価格を設定する商品については、次の情報を入力する必要があります
totalWeight
フィールド。ザ・totalWeight
フィールドには、請求対象商品の総重量が含まれます。さらに、netCostUnitOfMeasure
フィールドには、重量で価格を設定する商品の測定単位が反映されている必要があります。測定単位の値には次のものが含まれます。POUNDS
、OUNCES
、GRAMS
、およびKILOGRAMS
。 -
請求書番号は、一意でなければならず、決して再使用しないでください(1年経過した後であっても)。
-
API から送信された請求書が不正確なデータによって失敗しても、ベンダーセントラルの請求書には正しいデータが含まれている場合は、同じデータを使用して API を使用して正しいデータで請求書を更新する必要があります Invoice ID。
-
請求書のデータ(ベンダーセントラルと API の両方)に誤りがある場合、その請求書はキャンセルされ、新しい請求書を新しい請求書とともに送信する必要があります Invoice ID。
-
total amount = 0
が0の請求書を送信しないでください。送信すると請求書が失敗します。 -
Amazon requires the full address details in the address segments for tax compliance reasons. This is especially important for bill to party. For this segment the Amazon Payee system requires an exact match. For the list of addresses, refer to SP-API Bill to Party Addresses.
-
請求書で送信される支払い条件は、Amazonの購入者と合意した支払い条件と一致している必要があります。
-
品目製品IDは、該当する購入注文でベンダーに送信された注文品目製品IDと一致する必要があります。
-
請求書の 合計金額 は、品目、手数料、割引の合計と一致している必要があります。
-
各明細レベルの 税額の合計は、ヘッダーレベルの税額の合計と等しくなければなりません。
-
請求書の合計数量は、すべての品目の数量の合計と一致する必要があります。
-
異なる手数料と割引はそれぞれ、ヘッダーレベルで箇条書きにする必要があります(運送料、パッケージ手数料、小口注文手数料など)。
警告
送金先住所は、Amazonに登録されている住所と一致する必要があります。住所が一致しない場合、請求書は発行されません。
国固有のビジネス要件
機能 | インド | ヨーロッパ | 北米 |
---|---|---|---|
請求書タイプ | 請求書タイプ CreditNote はサポートされていません。請求書タイプは常に Invoice 。 |
請求書タイプ Invoice そして CreditNote サポートされています。ベンダーは、それに応じて請求書タイプを送信する必要があります。 |
請求書タイプ CreditNote はサポートされていません。請求書タイプは常に Invoice 。 |
クレジットノートリファレンス | 使用しません。 | 請求書の種類が次の場合、ベンダーは品目レベルでこれらの照会番号を送信する必要があります CreditNote 。 |
使用しません。 |
日付 | でなければなりません now またはそれ以前。 |
でなければなりません now またはそれ以前。 |
でなければなりません now またはそれ以前。 |
HSN番号 | 税法に準拠した請求書には、統一命名システム(HSN)コードが必須です。最大長は 8 文字です。 | 使用しません。 | 使用しません。 |
明細レベルとヘッダーレベルの税金タイプ | 税金タイプには以下が許可されています。
税務情報が提供されない場合、請求書は拒否されます。 |
送付する税金タイプ。 | 使用しません。 |
税務登録番号 | 15 桁の GST ID を入力する必要があります。 | VAT番号 | VAT番号 |
明細レベルおよびヘッダーレベルの税金詳細 | 商品に複数の税金が適用される場合、「税金の詳細」セクションをその商品に適切な税金タイプで複数回送信する必要があります。 請求書の合計金額も同様です。 |
商品に複数の税金が適用される場合、「税金の詳細」セクションをその商品に適切な税金タイプで複数回送信する必要があります。 請求書の合計金額も同様です。 という追加の税タイプもあります |
商品に複数の税金が適用される場合、「税金の詳細」セクションをその商品に適切な税金タイプで複数回送信する必要があります。 請求書の合計金額も同様です。 |
送金先 | Amazonに商品を供給し、支払いを受けるパーティー。サプライヤーとも呼ばれます。 | 出荷した品目(請求書の場合)または返品された商品(クレジットノートの場合)の支払いを受けるパーティー(ベンダー)の税金と住所の詳細。これは 必須です。 | 出荷した品目の支払いを受けるパーティー(ベンダー)の税金と住所の詳細。これは 必須です。 |
発送元 | 発送元住所の詳細、および州ISOコード。 GST IDは税務登録番号で送信しなければなりません。発送元が必須です。値は Amazon のシステムの値と一致する必要があります。 |
商品の出荷元のベンダーコードまたは倉庫コードおよび住所。 | 商品の出荷元のベンダーコードまたは倉庫コードおよび住所。 |
出荷先 | 発送先住所の詳細と州ISOコード。発送先が必須です。 値はAmazonのシステムの値と一致する必要があります。 |
商品の出荷先のAmazon IDまたは倉庫コードおよび住所。 | 商品の出荷先のAmazon IDまたは倉庫コードおよび住所。 |
課金先 | 課金先が必須です。課金先は発送先と同じである可能性があります。その場合、ベンダーは両方のセグメントで同じ情報を送信する必要があります。 | Tax and Address details of the party (Amazon) who will be billed for the shipped items (in case of an Invoice) or the returned items (in case of a credit note). For a complete list of Amazon bill to party addresses and JSON code examples, refer to SP-API bill to party addresses.
このフィールドは 必須です。 |
発送された商品の請求先(Amazon)の税金と住所の詳細。 このフィールドは 必須です。 |
Amazon商品IDと外部商品ID | これらの値のうち少なくとも1つは必須です。IDは注文で受信するものと同じでなければなりません。 | これらの値のうち少なくとも1つは必須です。IDは注文で受信するものと同じでなければなりません。 | これらの値のうち少なくとも1つは必須です。IDは注文で受信するものと同じでなければなりません。 |
正味原価 | このフィールドは 必須です。 | このフィールドは 必須です。 | このフィールドは 必須です。 |
購入注文番号 | 1つの請求書には、1つの注文の情報のみを記載することができます。そのため、1つの請求書に含まれるすべての品目についてPO番号を同じにする必要があります。 必須です。 |
1 つの請求書に複数の注文の情報を含めることができます。PO番号は、品目ごとに送信する必要があります。このフィールドは 必須 請求書タイプが Invoice 請求書タイプが次の場合は使用されません CreditNote 。 |
1通の請求書に複数の注文の情報を記載できます。PO番号は明細ごとに適宜送信する必要があります。 必須です。 |
その他の詳細 | 使用しません。 | このフィールドは、販売者が特別な目的で追加情報を提出する必要がある場合に使用されます。たとえば、ポーランドの分割支払い請求書の場合、販売者は詳細を送信する必要があります。」mechanizm podzielonej płatności 「のタイプ SUR そして languageCode 」PL 」。 |
使用しません。 |
参照番号 | インド政府が各請求書に対して生成する一意の請求書参照番号。このフィールドはインドでの請求書にのみ必須です。 | 使用しません。 | 使用しません。 |
請求先住所
When submitting an invoice, bill to party address details must be complete and formatted correctly, or the API call will fail. If you do not know the Amazon Tax ID for a bill to location, refer to the Vendor Central help pages.
For a complete list of Amazon bill to party addresses and JSON code examples, refer to SP-API bill to party addresses. You can also find this list, including Amazon's tax IDs, on the EDI Resources help page in your Vendor Central account.
クレジットノート
You can use the Vendor Invoices API to send credit notes to Amazon. A credit note lists the products, quantities, and agreed prices for products or services that you provided to Amazon, but Amazon returned or did not receive. A credit note can be issued in the case of damaged goods or errors in price when allowances or rebates are agreed on beforehand between Amazon and the vendor.
Amazonがサポートしているクレジットノート
買掛金(AP)クレジットノート | 売掛金(AR)クレジットノート |
---|---|
PPVクレジット
請求されたが受領されていない商品のクレジット、または重複した支払いのクレジット。 |
返品
商品の破損、誤って出荷された商品、過剰在庫などが原因でベンダーに返品された商品のクレジット。 |
PPVクレジット
より高い/低いコストで請求された品目のクレジット。 |
COOP (例:価格保護、損害賠償金)
製品の販売または価格保護契約のためにベンダーがAmazonに支払ったCOOPクレジット。 |
注
クレジットノートはすべての地域でサポートされているわけではありません。
submitInvoices
クラス
submitInvoices
クラス複数の品目が記載された請求書(税抜き)
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "I5599913",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"address": {
"name": "VENDORNAME",
"addressLine1": "PO BOX 1234",
"city": "SAN RAFAEL",
"stateOrRegion": "CA",
"postalOrZipCode": "60693",
"countryCode": "US"
}
},
"shipToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON.COM",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"city": "LEWISBERRY",
"stateOrRegion": "PA",
"postalOrZipCode": "17339",
"countryCode": "US"
}
},
"billToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON.COM",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"addressLine3": "string",
"city": "LEWISBERRY",
"stateOrRegion": "PA",
"postalOrZipCode": "17339",
"countryCode": "US"
}
},
"paymentTerms": {
"type": "Basic",
"discountPercent": "2.00",
"discountDueDays": 30,
"netDueDays": 31
},
"invoiceTotal": {
"currencyCode": "USD",
"amount": "1295"
},
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "040YP0U",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "USD",
"amount": "140"
},
"purchaseOrderNumber": "S8672793"
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "0264CBS",
"invoicedQuantity": {
"amount": 5,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "USD",
"amount": "125"
},
"purchaseOrderNumber": "S8672793"
},
{
"itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436",
"vendorProductIdentifier": "040YP0K",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "130"
},
"purchaseOrderNumber": "S8672793"
}
]
}
]
}
1つの品目に対する単一の税額が記載された請求書
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "5002841638",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"address": {
"name": "VENDORNAME",
"addressLine1": "PO BOX 1234",
"city": "TORONTO",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONCA",
"address": {
"name": "AMAZON CANADA",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"city": "MISSISSAUGA",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
}
},
"billToParty": {
"partyId": "AMAZONCA",
"address": {
"name": "AMAZON CANADA",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"addressLine3": "string",
"city": "MISSISSAUGA",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"type": "Basic",
"netDueDays": 31
},
"invoiceTotal": {
"currencyCode": "CAD",
"amount": "1950"
},
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "97.5"
},
"taxableAmount": {
"currencyCode": "CAD",
"amount": "1950"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "1012380100000",
"invoicedQuantity": {
"amount": 4,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "1.00"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "1000570100000",
"invoicedQuantity": {
"amount": 30,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "50.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "2.50"
}
}
]
},
{
"itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436",
"vendorProductIdentifier": "0543900100000",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "90"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "4.50"
}
}
]
},
{
"itemSequenceNumber": 4,
"amazonProductIdentifier": "ABC123437",
"vendorProductIdentifier": "1000570200000",
"invoicedQuantity": {
"amount": 5,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "1.00"
}
}
]
}
]
}
]
}
1つの品目に対する複数の税額が記載された請求書
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "8900000001234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ123",
"address": {
"name": "XYZ INDIA PRIVATE LIMITED",
"addressLine1": "4TH FLOOR",
"city": "GURUGRAM",
"stateOrRegion": "HR",
"postalOrZipCode": "122002",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ123",
"address": {
"name": "XYZ RETAIL PVT LTD",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"postalOrZipCode": "700016",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Arrjaw Industrial & Warehouse Park",
"addressLine2": "Near Coal India Complex",
"city": "Hooghly",
"stateOrRegion": "WB",
"postalOrZipCode": "712310",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"type": "Basic",
"netDueDays": 30
},
"invoiceTotal": {
"currencyCode": "INR",
"amount": "258262.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809000-0000",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.90",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.91",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
}
]
}
]
}
]
}
ヘッダーレベルと明細レベルの割引/手数料が記載された請求書(税込)
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "0136981234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ12345",
"address": {
"name": "XYZ INDIA PRIVATE LIMITED",
"addressLine1": "4TH FLOOR",
"city": "GURUGRAM",
"stateOrRegion": "HR",
"postalOrZipCode": "122002",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORVATID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ12345",
"address": {
"name": "XYZ RETAIL PVT LTD",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"postalOrZipCode": "700016",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Arrjaw Industrial & Warehouse Park",
"addressLine2": "Near Coal India Complex",
"city": "Hooghly",
"stateOrRegion": "WB",
"postalOrZipCode": "712310",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONVATID"
}
]
},
"paymentTerms": {
"type": "Basic",
"discountPercent": "5",
"discountDueDays": 15,
"netDueDays": 30
},
"invoiceTotal": {
"currencyCode": "INR",
"amount": "259678.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "1200.00"
},
"taxDetails": [
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"amount": "string"
}
},
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"amount": "string"
}
}
]
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809281-5100",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.93",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "600.00"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "600.00"
}
}
]
}
]
}
]
}
EUクレジットノート(税込)
{
"invoices": [
{
"invoiceType": "CreditNote",
"id": "BasicCredit",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON EU SARL, UK BRANCH",
"addressLine1": "1 PRINCIPAL PLACE WORSHIP STREET",
"city": "LONDON",
"postalOrZipCode": "EC2A 2FA",
"countryCode": "GB"
}
},
"billToParty": {
"partyId": "VendorCode",
"address": {
"name": "Vendor Name",
"addressLine1": "Vendor Address",
"city": "Vendor City",
"stateOrRegion": "Vendor State",
"postalOrZipCode": "Vendor ZIP Code",
"countryCode": "Vendor Country"
}
},
"invoiceTotal": {
"currencyCode": "GBP",
"amount": "100"
},
"taxDetails": [
{
"taxType": "VAT",
"taxRate": "10",
"taxAmount": {
"currencyCode": "GBP",
"amount": "10.00"
},
"taxableAmount": {
"currencyCode": "GBP",
"amount": "100.00"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "TESTSKU",
"invoicedQuantity": {
"amount": 1,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "GBP",
"amount": "100"
},
"creditNoteDetails": {
"referenceInvoiceNumber": "test-basic-ref",
"debitNoteNumber": "debit-ref",
"returnsReferenceNumber": "return-ref",
"goodsReturnDate": "2019-07-24T21:17:59.821Z",
"rmaId": "rma-ref",
"consignorsReferenceNumber": "VRET-ref"
}
}
]
}
]
}
Vendor Transaction Status APIとは何ですか?
You can use the Vendor Transaction Status API to check the transaction status of your POST transactions.
以下のオペレーションが含まれています。
.オペレーション | HTTPメソッド | Path | 説明 | |
---|---|---|---|---|
getTransaction | GET | /vendor/transactions/v1/transactionStatus/{transactionId} | POSTトランザクションリクエストのステータスを取得します。 | 指定されたpurchaseOrderNumber 値に基づいて発注書(PO)を返します。最初のPOST呼び出しの実行日から4か月以内のデータに関してトランザクションのステータスを調べることができます。 |
トランザクションステータスを取得
You can use the Vendor Transaction Status API to check the status of a POST transaction. When a transaction such as an Order Acknowledgement or Shipment Confirmation is posted to Amazon using an API, the response includes a transaction identifier that uniquely identifies the transaction. Amazon will process the transaction asynchronously and the final response will be available via the getTransaction
operation. Refer to the corresponding integration workflow diagrams in the individual API sections (for example, Vendor Orders and Vendor Shipments) to understand when to call this API to get the transaction status.
Amazonは、このAPIを介して、注文確認や出荷確認などのPOST APIトランザクションの最終処理ステータスを提供します。ベンダーは、この API を使用してステータスをチェックし、トランザクションが正常に処理されたことを確認することを強くお勧めします。エラーが発生した場合、応答にはエラー情報が含まれます。その後、トランザクションを修正して再送信できます。
トランザクションステータス | 定義 |
---|---|
処理中 | APIトランザクションはAmazonによって受信され、処理中です。処理はまだ完了していません。各APIオペレーションのSLAをチェックして、処理が完了するまでの予想時間を確認してください。 |
成功 | This status is supported only for Submit Shipment Confirmations and Submit Shipment in NA and EU only. Success is not supported for the submitAcknowledgement and submitInvoices operations. |
失敗 | APIトランザクションは処理中に失敗しました。エラーの詳細は、トランザクションステータスレスポンスの本文に記載されます。 |
注
トランザクションステータスは、次の API 操作でサポートされています。
トランザクションステータスは以下のみをサポートします Processing
そして Failure
ステータス値。トランザクションステータスがの場合 Processing
、更新されていません Failure
15 分後、トランザクションがシステムで正常に処理されたことを示します。
A transaction is generally considered to be successfully delivered on our end when the status is Processing
. If for any reason, Vendor Central status is not updated within 30 minutes of sending the message, open a support case using Vendor Central by providing the transaction ID returned in the POST call. Ensure data submitted is in the correct format before opening the case.
You can't use this API for Invoice
messages as they are not supported and status will be always Processing
. For any payment related queries, first check in Vendor Central, and then create a Contact Us case in Vendor Central and select the relevant queue.
トランザクションステータスのユースケース
トランザクションは処理中です
{
"payload": {
"transactionStatus": {
"transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477",
"status": "Processing"
}
}
}
トランザクションは正常に処理されました
トランザクションは、ポスト後15分間処理中の状態になっています。
{
"payload": {
"transactionStatus": {
"transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477",
"status": "Processing"
}
}
}
Amazonでのトランザクションが失敗しました
{
"payload": {
"transactionStatus": {
"transactionId": "20190908091302-6ca0ac50-d06e-45f5-a1e2-eb448eadac50",
"status": "Failure",
"errors": [
{
"code": "INVALID_ORDER_ID",
"message": "Invalid order ID."
}
]
}
}
}
Updated 23 days ago