フルフィルメント出荷API v2020-07-01ユースケースガイド
フルフィルメント納品APIの使用方法
APIバージョン:v2020-07-01
フルフィルメント出荷APIについて
フルフィルメント出荷向けSelling Partner API(フルフィルメント出荷API)を使用すると、出品者がAmazonのフルフィルメントネットワーク内の在庫を使用してFBAマルチチャネルサービスの注文商品を出荷するためのアプリケーションを作成できます。発生する見込みのフルフィルメント注文、そして既存のフルフィルメント注文について情報を取得することもできます。
前提条件
チュートリアルを完了するには、次のものが必要です。
-
呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
-
開発者プロフィールへのAmazonから発送ロールの割り当て。
-
アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
チュートリアル:配達済み荷物の配達証明を取得
配送されたマルチチャネルフルフィルメントアウトバウンド貨物の写真または署名を取得する方法をご覧ください。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
配達証明を取得
以下のパラメーターを渡して、getFulfillmentOrder
オペレーションを呼び出します。
パスのパラメーター
名前 | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | 出荷注文の作成時に出品者が商品に割り当てた識別子。最大長:40 タイプ: 文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
レスポンス
名前 | 説明 | 必須 |
---|---|---|
fulfillmentOrder | 出荷注文に関する一般的な情報 (ステータスを含む)。タイプ: FulfillmentOrder | はい |
fulfillmentOrderItems | 出荷注文商品情報の配列。タイプ: FulfillmentOrderItemList | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。タイプ: FulfillmentShipmentList | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品が承認されなかった場合は、空を返します。タイプ: ReturnItemList | はい |
returnAuthorizations | 返品承認情報の配列。タイプ: ReturnAuthorizationList | はい |
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"marketplaceId": "ATVPDKIKX0DER",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2024-05-21T14:48:15Z",
"displayableOrderComment": "Thank you for your order",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "Jane Smith",
"addressLine1": "123 Any Street",
"city": "Any Town",
"stateOrRegion": "NC"
"countryCode": "US",
"postalCode": "28277"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2024-05-21T14:50:45Z",
"fulfillmentOrderStatus": "CompletePartialled",
"statusUpdatedDate": "2024-05-22T03:44:35Z",
"notificationEmails": [
"email@email.com"
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
}
]
},
"fulfillmentOrderItems": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1",
"fulfillmentNetworkSku": "X002ZKH36D",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "0",
"estimatedShipDate": "2024-05-22T06:59:59Z",
"estimatedArrivalDate": "2024-05-26T06:59:59Z",
"perUnitDeclaredValue": {
"currencyCode": "USD",
"value": "35.00"
}
},
],
"fulfillmentShipments": [
{
"amazonShipmentId": "T7mfkbDX5",
"fulfillmentCenterId": "TUL2",
"fulfillmentShipmentStatus": "SHIPPED",
"shippingDate": "2024-05-22T03:39:19Z",
"estimatedArrivalDate": "2024-05-26T06:59:59Z",
"fulfillmentShipmentItem": [
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": "1",
"packageNumber": "1681854637"
}
],
"fulfillmentShipmentPackage": [
{
"packageNumber": "1681854637",
"carrierCode": "AMZL",
"trackingNumber": "TBA123456789012",
"estimatedArrivalDate": "2024-05-26T06:59:59Z",
"deliveryInformation": {
"deliveryDocumentList": [
{
"documentType" : "DELIVERY_IMAGE",
"url" : "https://some-image-url.com"
}
],
"dropOffLocation": {
"type" : "FRONT_DOOR"
}
}
}
],
"returnItems": [],
"returnAuthorizations": []
}
}
チュートリアル:フルフィルメント注文のリストの取得
このチュートリアルでは、特定の日時以降のフルフィルメント注文、またはnextToken(次のトークン)パラメーターで示されたフルフィルメント注文のリストを取得する方法について説明します。
前提条件
このチュートリアルを完了するには、以下が必要です。
-
呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
-
開発者プロフィールへのAmazonから発送ロールの割り当て。
-
アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. すべてのフルフィルメント注文のリストの取得
以下のパラメーターを渡して、listAllFulfillmentOrders
オペレーションを呼び出します。
パラメーター | 説明 | 必須 |
---|---|---|
queryStartDate | 最終更新日時が指定した日時以降のフルフィルメント注文を選択するために使用する日付。更新とは、新たなフルフィルメント注文の作成を含め、フルフィルメント注文のステータスが変更された場合として定義されます。 データ型:文字列(日時) | いいえ |
nextToken | 前のリクエストへのレスポンスで返された文字列トークン。次の結果のセットを取得するために必要です(ページ割り)。 タイプ:文字列 | いいえ |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders?queryStartDate=2020-01-01T19:46:45Z"
レスポンス
成功時のレスポンスには 200 のコードが付けられます。
レスポンスの例
{
"payload": {
"fulfillmentOrders": [
{
"sellerFulfillmentOrderId": "902-6018020-0202003",
"displayableOrderId": "mws-test-query-20100713023203751",
"displayableOrderDate": "2020-01-09T19:46:45Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "AnyCompany",
"addressLine1": "123 Any Street",
"addressLine2": "Suite 123",
"city": "Any Town",
"stateOrRegion": "MI",
"countryCode": "US",
"postalCode": "48084"
},
"fulfillmentPolicy": "FillOrKill",
"receivedDate": "2020-01-21T21:07:13Z",
"fulfillmentOrderStatus": "RECEIVED",
"statusUpdatedDate": "2020-01-21T21:07:30Z",
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
},
{
"featureName": "BLOCK_AMZL",
"featureFulfillmentPolicy": "NotRequired"
}
]
},
{
"sellerFulfillmentOrderId": "601-2020200-12345678",
"displayableOrderId": "TestOrder-FBAOutbound",
"displayableOrderDate": "2020-01-09T19:46:45Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "AnyCompany",
"addressLine1": "123 Any Street",
"addressLine2": "Suite 123",
"addressLine3": "Lane1",
"city": "Any Town",
"stateOrRegion": "MI",
"countryCode": "US",
"postalCode": "48084"
},
"fulfillmentPolicy": "FillOrKill",
"receivedDate": "2020-01-23T19:56:41Z",
"fulfillmentOrderStatus": "COMPLETE",
"statusUpdatedDate": "2020-01-24T15:28:27Z",
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
},
{
"featureName": "BLOCK_AMZL",
"featureFulfillmentPolicy": "Required"
}
]
}
]
}
}
名前 | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId |
タイプ:文字列 | はい |
marketplaceId | フルフィルメント注文を行うマーケットプレイスの識別子。 タイプ:文字列 | はい |
displayableOrderId |
タイプ:文字列 | はい |
displayableOrderDate |
タイプ: | はい |
displayableOrderComment |
タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文で使用した配送方法。 | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress |
タイプ: | はい |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換 (COD) 料金。 タイプ: | いいえ |
receivedDate | Amazonフルフィルメントセンターがフルフィルメント注文を受領した日時。 タイプ: | はい |
fulfillmentOrderStatus | フルフィルメント注文の現在のステータス。 | はい |
statusUpdatedDate | The date and time that the status of the fulfillment order last changed, in ISO 8601 date-time format. タイプ: | はい |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors | 操作中に1つ以上の予期しないエラーが発生しました。 タイプ: |
チュートリアル:配送追跡情報の取得
このチュートリアルでは、FBAマルチチャネルサービスの注文商品の出荷において、パッケージの配送追跡情報を取得する方法について説明します。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. パッケージの追跡詳細情報の取得
以下のパラメーターを渡して、getPackageTrackingDetails
オペレーションを呼び出します。
パラメーター | 説明 | 必須 |
---|---|---|
packageNumber |
タイプ:整数(int32) | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/tracking?packageNumber=1987644423"
レスポンスの例
{
"payload": {
"packageNumber": 1987644423,
"trackingNumber": "TBA123456789012",
"carrierCode": "AMZN_US",
"carrierPhoneNumber": "1111111111",
"carrierURL": "https://www.swiship.com/track?id=TBA123456789012",
"shipDate": "2022-11-13T03:18:38Z",
"estimatedArrivalDate": "2022-11-15T03:18:38Z",
"shipToAddress": {
"city": "Troy",
"state": "MI",
"country": "US"
},
"currentStatus": "DELIVERED",
"signedForBy": "Richard Roe",
"additionalLocationInfo": "FRONT_DOOR",
"trackingEvents": [
{
"eventDate": "2022-11-13T03:18:37Z",
"eventAddress": {
"city": "Buffalo",
"state": "NY",
"country": "US"
},
"eventCode": "EVENT_101",
"eventDescription": "Carrier notified to pick up package."
},
{
"eventDate": "2022-11-13T03:18:38Z",
"eventAddress": {
"city": "Buffalo",
"state": "NY",
"country": "US"
},
"eventCode": "EVENT_102",
"eventDescription": "Shipment picked up from seller's facility."
},
{
"eventDate": "2022-11-13T17:27:49Z",
"eventAddress": {
"city": "Boise",
"state": "ID",
"country": "US"
},
"eventCode": "EVENT_302",
"eventDescription": "Out for delivery."
},
{
"eventDate": "2022-11-15T03:18:38Z",
"eventAddress": {
"city": "Troy",
"state": "MI",
"country": "US"
},
"eventCode": "EVENT_301",
"eventDescription": "Delivered."
}
]
}
}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。もし、 PackageNumber
存在しない場合、404 応答で不適格エラーが表示されます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:フルフィルメント注文のキャンセル
このチュートリアルでは、特定のマーケットプレイスで指定された注文識別子を持つフルフィルメント注文の出荷作業を停止するよう、Amazonにリクエストを送信する方法について説明します。cancelFulfillmentOrder
オペレーションは、「Received」または「Planning」ステータスの注文に対してのみ呼び出すことができます。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. フルフィルメント注文のキャンセル
以下のパラメーターを渡して、cancelFulfillmentOrder
オペレーションを呼び出します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
PUT "https://sellingpartnerapi-na.amazon.com /fba/outbound/2020-07-01/fulfillmentOrders/TestOrder-7/cancel"
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。もし、 sellerFulfillmentOrderId
存在しない場合、404 応答で不適格エラーが表示されます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:機能のリストの取得
このチュートリアルでは、指定したマーケットプレイスにおけるFBAマルチチャネルサービスの注文商品で利用可能な機能のリスト、および呼び出し先の出品者が各機能に登録されているかどうかを取得する方法について説明します。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. 機能のリストの取得
以下のパラメーターを渡して、getFeatures
オペレーションを呼び出します。
パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | 機能のリストを返すマーケットプレイス。 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/features?MarketplaceId=ATVPDKIKX0DER"
レスポンス
成功時のレスポンスには 200 のコードが付けられます。
レスポンスの例
{
"features": [
{
"featureName": "BLANK_BOX",
"featureDescription": "Enables Shipment in non-Amazon branded boxes",
"sellerEligible": true
},
{
"featureName": "BLOCK_AMAZON ",
"featureDescription": "Blocks using Amazon Logistics as carrier",
"sellerEligible": true
}
]
}
パラメーター | 説明 | 必須 |
---|---|---|
featureName | 機能名。 タイプ:文字列 | はい |
featureDescription | 機能の説明。 タイプ:文字列 | はい |
sellerEligible | trueの場合、出品者がこの機能を使用できることを示します。 タイプ:ブール値 | いいえ |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:BLANK_BOX機能を使用できる在庫の取得
このチュートリアルでは、BLANK_BOX機能を使用できる在庫商品のリストを取得する方法について説明します。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. 機能を使用できる在庫商品のリストの取得
以下のパラメーターを渡して、getFeatureInventory
オペレーションを呼び出します。
パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | 指定した機能の対象となる在庫のリストを返すマーケットプレイス。 タイプ:文字列 | はい |
featureName | 対象となる在庫のリストを返す機能の名前。 タイプ:文字列 | はい |
nextToken | 前のリクエストへのレスポンスで返された文字列トークンを、次のレスポンスページを返すために使用します。値 タイプ:文字列 | いいえ |
queryStartDate | 最長90日前(またはそれ以降)に最終更新された在庫を選択するために使用される日付。更新とは、機能が有効になっている在庫状況におけるすべての変更と定義されます。これは yyy-MM-ddthh: mm: ss.sssz 形式である必要があります (例:2020-04-04T 16:20:23.000 Z)。 データ型:文字列(日時) | いいえ |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/features/inventory/BLANK_BOX?marketplaceId=ATVPDKIKX0DER"
レスポンス
成功時のレスポンスには 200 のコードが付けられます。
レスポンスの例
{
"payload": {
"marketplaceId": "ATVPDKIKX0DER",
"featureName": "BLANK_BOX",
"featureSkus": [
{
"sellerSku": "TEST_SKU_BLKAM",
"fnSku": "X00TEST9UZ",
"asin": "B08DTESTNM",
"skuCount": "4",
"overlappingSkus": []
},
{
"sellerSku": "TEST_SKU_BLKAM2",
"fnSku": "X00TESTTS5",
"asin": "B0TESTXXQM",
"skuCount": "2",
"overlappingSkus": []
}
]
}
}
パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | リクエストするマーケットプレイス。 タイプ:文字列 | はい |
featureName | 機能の名前。 タイプ:文字列 | はい |
nextToken | 存在していて空でない場合は、次のリクエストでこの文字列トークンを渡して、次のレスポンスページを返します。 タイプ:文字列 | いいえ |
featureSkus | この機能の対象となるSKUの配列と利用可能な数量。 タイプ:< | いいえ |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:特定のSKUのBLANK_BOX機能を使用できる在庫の取得
このチュートリアルでは、指定したsellerSKU
を持ち、機能を使用できる出品者SKUの合計数を取得する方法について説明します。
不適格な
sellerSKU
sellerSKU
で機能を使用できない場合、レスポンスには空のskuInfo
オブジェクトが含まれます。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. 機能を使用できる出品者SKUの数の取得
以下のパラメーターを渡して、getFeatureSKU
オペレーションを呼び出します。
パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | カウントを返すマーケットプレイス。 タイプ:文字列 | はい |
featureName | 機能の名前。 タイプ:文字列 | はい |
sellerSku | 特定のマーケットプレイスの商品を識別するために使用されます。 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/features/inventory/BLANK_BOX/TEST_SKU_BLKAM?marketplaceId=ATVPDKIKX0DER"
レスポンスの例
{
"payload": {
"marketplaceId": "ATVPDKIKX0DER",
"featureName": "BLANK_BOX",
"isEligible": true,
"ineligibleReasons": [],
"sellerSku": "TEST_SKU_BLKAM",
"fnSku": "X0TEST9UZ",
"asin": "B0TESTQ6NM",
"skuCount": "4"
}
}
パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | リクエストするマーケットプレイス。 タイプ:文字列 | はい |
| 機能の名前。 タイプ:文字列 | はい |
isEligible | trueの場合、リクエストした機能を出品者 タイプ:ブール値 | はい |
ineligibleReasons | 出品者SKUで機能を使用できない1つ以上の理由を示すリスト。 指定できる値:
タイプ:<文字列>配列 | いいえ |
skuInfo |
タイプ: | いいえ |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:お届け日時と配送時間帯を指定した日本向け注文の作成
このチュートリアルでは、日本での注文作成プロセスと、お届け日時指定配送オプションについて概説します。この配送オプションは、日本のマーケットプレイスでの注文でのみ使用できます。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. お届け日時指定のフルフィルメントプレビューの取得
ShippingSpeedCategories
= ScheduledDelivery
およびIncludeDeliveryWindows
= true
の値を指定してgetFulfillmentPreview
オペレーションを呼び出します。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
address | フルフィルメント注文プレビューの配送先住所。 タイプ: | はい |
items | フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。 | はい |
shippingSpeedCategories | フルフィルメント注文プレビューの作成に使用する配送方法のリスト。 指定できる値:
注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。 | いいえ |
includeCODFulfillmentPreview | 代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。 指定できる値:
タイプ:ブール値 | いいえ |
includeDeliveryWindows | お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。ScheduledDeliveryInfoレスポンスオブジェクトは、 タイプ:ブール値 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
リクエストの例
POST "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview"
{
"marketplaceId": "A1VC38T7YXB528",
"address": {
"name": "Mary Major",
"addressLine1": "1-8-1 Shimomeguro",
"addressLine2": "Meguro-ku",
"city": "Tokyo",
"countryCode": "JP",
"postalCode": "153-0064"
},
"items": [
{
"sellerSku": "SellerSKU12",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": 2
}
],
"shippingSpeedCategories": [
"ScheduledDelivery"
],
"IncludeDeliveryWindows": "true"
}
レスポンス
呼び出しが成功した場合、レスポンスのコードは200となり、getFulfillmentPreview
オペレーションのレスポンススキーマに従ってレスポンスが生成されます。
{
"payload": {
"fulfillmentPreviews": [
{
"shippingSpeedCategory": "ScheduledDelivery",
"isFulfillable": true,
"isCODCapable": false,
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "0.441"
},
"estimatedFees": [
{
"name": "FBAPerOrderFulfillmentFee",
"amount": {
"currencyCode": "YEN",
"value": "0.0"
}
},
{
"name": "FBATransportationFee",
"amount": {
"currencyCode": "YEN",
"value": "0.0"
}
},
{
"name": "FBAPerUnitFulfillmentFee",
"amount": {
"currencyCode": "YEN",
"value": "9.82"
}
}
],
"fulfillmentPreviewShipments": [
{
"earliestShipDate": "2022-12-11T08:00:00Z",
"latestShipDate": "2022-12-12T07:59:59Z",
"earliestArrivalDate": "2022-12-13T08:00:00Z",
"latestArrivalDate": "2022-12-14T07:59:59Z",
"fulfillmentPreviewItems": [
{
"sellerSku": "SellerSKU12",
"quantity": 2,
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "0.441"
},
"shippingWeightCalculationMethod": "Dimensional"
}
]
}
],
"scheduledDeliveryinfo": {
"deliveryTimeZone": "UTC",
"deliveryWindows": [
{
"endDate": "2022-12-15T10:48:11Z",
"startDate": "2022-12-15T06:48:11Z"
},
{
"endDate": "2022-12-16T14:48:11Z",
"startDate": "2022-12-16T10:48:11Z"
}
]
},
"unfulfillablePreviewItems": [],
"marketplaceId": "A1VC38T7YXB528"
}
]
}
}
名前 | 説明 |
---|---|
FulfillmentPreviews | フルフィルメントプレビュー情報の配列。 |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors | 操作中に1つ以上の予期しないエラーが発生しました。 タイプ: |
ステップ2. フルフィルメント注文の作成
getFulfillmentPreview
レスポンスから取得した配送時間帯と、ShippingSpeedCategory
= ScheduledDelivery
を指定して、createFulfillmentOrder
オペレーションを呼び出します。createFulfillmentOrder
オペレーションでその他の時間帯を使用すると、サービスによってエラーが返され、getFulfillmentPreview
オペレーションを再実行しなければならなくなります。
注
配送方法のサービスレベル契約は、マーケットプレイスによって異なります。出品者は以下を参照してください。 セラーセントラル 配送方法のサービスレベル契約およびマルチチャネルフルフィルメント手数料用。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
sellerFulfillmentOrderId | フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。 最大長:40 タイプ:文字列 | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。 この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。 最大長:40 タイプ:文字列 | はい |
displayableOrderDate | フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。 タイプ: | はい |
displayableOrderComment | 出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。 最大長:250 タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文の配送方法。 ShippingSpeedCategory | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress | フルフィルメント注文の配送先住所。 タイプ: | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: | いいえ |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換手数料。 タイプ: | いいえ |
shipFromCountryCode | フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。 タイプ:文字列 | いいえ |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
Items | フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。 | はい |
リクエストの例
POST "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "ScheduledDelivery",
"deliveryWindow": {
"endDate": "2022-12-15T10:48:11Z",
"startDate": "2022-12-15T06:48:11Z"
},
"fulfillmentAction": "Ship",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "1-8-1 Shimomeguro",
"addressLine2": "Meguro-ku",
"city": "Tokyo",
"countryCode": "JP",
"postalCode": "153-0064"
},
"items": [
{
"sellerSku": "SellerSKU12",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": 1
}
]
}
レスポンス
成功時のレスポンスには 200 のコードが含まれ、次のオブジェクトが含まれます。
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
ステップ3. フルフィルメント注文を取得して注文の詳細を検証
createFulfillmentOrder
オペレーションの呼び出しに成功したら、getFulfillmentOrder
オペレーションを呼び出して、fulfillmentAction= Ship
およびfulfillmentOrderStatus= Received
となっているか検証します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"marketplaceId": "A1VC38T7YXB528",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "ScheduledDelivery",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "1-8-1 Shimomeguro",
"addressLine2": "Meguro-ku",
"city": "Tokyo",
"countryCode": "JP",
"postalCode": "153-0064"
},
"deliveryWindow": {
"endDate": "2022-12-15T10:48:11Z",
"startDate": "2022-12-15T06:48:11Z"
}
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2022-09-21T14:50:45Z",
"fulfillmentOrderStatus": "Received",
"statusUpdatedDate": "2022-09-22T03:44:35Z"
},
"fulfillmentOrderItems": [
{
"sellerSku": "SellerSKU12",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1"
}
],
"fulfillmentShipments": [],
"returnItems": [],
"returnAuthorizations": []
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
| フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors | 操作中に1つ以上の予期しないエラーが発生しました。 タイプ: |
チュートリアル:インド向けMCF注文の作成
このチュートリアルでは、インドのMCF注文作成プロセスの概要を説明します。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. フルフィルメントプレビューの取得
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
address | フルフィルメント注文プレビューの配送先住所。 タイプ: | はい |
items | フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。 | はい |
shippingSpeedCategories | フルフィルメント注文プレビューの作成に使用する配送方法のリスト。 指定できる値:
注意: 配送方法のサービスレベル契約はマーケットプレイスによって異なります。インドでサポートされている配送方法は、標準配送方法のみです。出品者は以下を参照してください。 セラーセントラルのウェブサイト マーケットプレイスで、配送方法、サービスレベル契約、およびフルフィルメント手数料について問い合わせています。 | いいえ |
includeCODFulfillmentPreview | 代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。 指定できる値:
タイプ:ブール値 | いいえ |
includeDeliveryWindows | お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。ScheduledDeliveryInfoレスポンスオブジェクトは、 タイプ:ブール値 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview"
{
"marketplaceId": "A21TJRUUN4KGV",
"address":
{
"name": "Saanvi Sarkar",
"addressLine1": "FLAT#20012, Tower#20, Prestige Ferns Residency, Haralur Road",
"city": "Bengaluru",
"stateOrRegion": "KA",
"countryCode": "IN",
"postalCode": "560021",
"phone": "9986365404"
},
"items": [
{
"sellerSku": "mohamf devogst8 B06XSK3XL6",
"sellerFulfillmentOrderItemId": "OrderItemID1",
"quantity": 1
}
],
"shippingSpeedCategories": [
"Standard"
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NOTREQUIRED"
}
]
}
レスポンス
呼び出しが成功した場合、レスポンスのコードは200となり、getFulfillmentPreview
オペレーションのレスポンススキーマに従ってレスポンスが生成されます。
{
"payload": {
"fulfillmentPreviews": [
{
"shippingSpeedCategory": "Standard",
"isFulfillable": false,
"isCODCapable": false,
"fulfillmentPreviewShipments": [
{
"earliestShipDate": "2023-12-09T10:42:10Z",
"latestShipDate": "2023-12-09T10:42:10Z",
"earliestArrivalDate": "2023-12-11T10:42:10Z",
"latestArrivalDate": "2023-12-13T10:42:10Z",
"fulfillmentPreviewItems": [
{
"sellerSku": "mohamf devogst8 B06XSK3XL6",
"quantity": 1,
"sellerFulfillmentOrderItemId": "OrderItemID1",
"estimatedShippingWeight": {
"unit": "KILOGRAMS",
"value": "0.350"
},
"shippingWeightCalculationMethod": "Package"
}
]
}
],
"marketplaceId": "A21TJRUUN4KGV",
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
}
]
}
]
}
}
名前 | 説明 |
---|---|
FulfillmentPreviews | フルフィルメントプレビュー情報の配列。 |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors | 操作中に1つ以上の予期しないエラーが発生しました。 タイプ: |
ステップ2. フルフィルメント注文の作成
createFulfillmentOrder
オペレーションを呼び出して、注文に必要な機能制約を指定してFBAマルチチャネルサービス注文を作成します。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
sellerFulfillmentOrderId | フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。 最大長:40 タイプ:文字列 | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。 この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。 最大長:40 タイプ:文字列 | はい |
displayableOrderDate | フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。 タイプ: | はい |
displayableOrderComment | 出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。 最大長:250
タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文の配送方法。 ShippingSpeedCategory | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress | フルフィルメント注文の配送先住所。 タイプ: | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: | いいえ |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換手数料。 タイプ: | いいえ |
shipFromCountryCode | フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。 タイプ:文字列 | いいえ |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
items | フルフィルメントオーダープレビューに含める商品のリスト (数量を含む)。品目数は最大100個、1回の注文につき最大250ユニットです。 | はい |
paymentInformation | フルフィルメントオーダーの支払い情報。 | はい |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "createOrder1703154732",
"displayableOrderId": "TestOrder-FBAOutbound20",
"displayableOrderDate": "2023-11-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"fulfillmentAction": "Ship",
"destinationAddress": {
"name": "Anshul R",
"addressLine1": "FLAT#1234, Tower#201, Prestige Residency, Haralur Road",
"city": "Bengaluru",
"stateOrRegion": "KA",
"countryCode": "IN",
"postalCode": "560102",
"phone": "9168071234"
},
"notificationEmails": [
"lokshws@amazon.com"
],
"items": [
{
"sellerSku": "mohamf devogst8 B06XSK3XL6",
"sellerFulfillmentOrderItemId": "OrderItemID1",
"quantity": 1,
"perUnitDeclaredValue": {
"currencyCode": "INR",
"value": "2.00"
}
}
],
"paymentInformation": [
{
"paymentTransactionId": "TestPaymenttransaction",
"paymentMode": "Other",
"paymentDate": "2023-11-14T16:25:56Z"
}
]
}
レスポンス
成功時のレスポンスには 200 のコードが含まれ、次のオブジェクトが含まれます。
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
ステップ 2b。代金引換オプションを使用してフルフィルメント注文を作成する
に電話してください createFullfillmentOrder
代金引換 (COD) オプション付きの MCF 注文を作成する操作。IN マーケットプレイスでの代金引換注文の場合、IN マーケットプレイスでの金銭的価値はありません。 codSettings
(codCharge
、 codChargeTax
、 shippingCharge
、 shippingChargeTax
) を設定する必要があります。注文に含まれるすべての料金は、以下のように表す必要があります。 perUnitDeclaredValue
。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文の対象となるマーケットプレイス。 タイプ: ひも | いいえ |
sellerFulfillmentOrderId | 出品者がフルフィルメントオーダーを追跡するために作成するフルフィルメントオーダーID。は sellerFulfillmentOrderId 出品者が作成するフルフィルメントオーダーごとに一意である必要があります。出品者のシステムですでに固有の注文IDが作成されている場合は、この値を使用するとよいでしょう。最大長: 40 タイプ: ひも | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。displayableOrderId の値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にsellerFulfillmentOrderId を使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。 | はい |
displayableOrderDate | フルフィルメントオーダーの日付と時刻。出荷時の梱包伝票など、受取人向けの資料に注文日として表示されます。 タイプ: Timestamp | はい |
displayableOrderComment | 出荷時の梱包伝票など、受取人向けの資料に表示される注文固有のテキスト。 最大長: 250 タイプ: ひも | はい |
shippingSpeedCategory | フルフィルメントオーダーの配送方法。 タイプ: ShippingSpeedCategory | はい |
deliveryWindow | お届け予定配送フルフィルメント注文を配送する時間帯。 タイプ: DeliveryWindow | いいえ |
destinationAddress | フルフィルメントオーダーの配送先住所。 タイプ: Address | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: DeliveryPreferences | いいえ |
fulfillmentAction | フルフィルメントオーダーを今すぐ出荷するか、注文を保留にするかを指定します。 タイプ: FulfillmentAction | いいえ |
fulfillmentPolicy | フルフィルメントポリシー。 タイプ: FulfillmentPolicy | いいえ |
codSettings | 代金引換注文に関連する代金引換手数料。 注意: のみ isCodRequired 設定する必要があります。 codCharge 、 codChargeTax 、 shippingCharge 、および shippingChargeTax IN マーケットプレイスには設定しないでください。タイプ: CODSettings | はい |
shipFromCountryCode | フルフィルメントオーダーの配送元の国の2文字の国コード。ISO 3166-1 アルファ-2 形式である必要があります。これは国境を越えた配送に必要です。 タイプ: ひも | いいえ |
notificationEmails | Amazonが出品者に代わって受取人に出荷完了通知を送信するために使用する、出品者が提供するEメールアドレスのリスト。 タイプ: NotificationEmailList | いいえ |
featureConstraints | 注文に適用される機能とそのフルフィルメントポリシーのリスト。 タイプ: < FeatureSettings > アレイ | いいえ |
items | フルフィルメントオーダープレビューに含める商品のリスト (数量を含む)。品目数は最大100個、1回の注文につき最大250ユニットです。 タイプ: CreateFulfillmentOrderItemList | はい |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "createOrder1703154732",
"displayableOrderId": "TestOrder-FBAOutbound20",
"displayableOrderDate": "2023-11-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"fulfillmentAction": "Ship",
"destinationAddress": {
"name": "Anshul R",
"addressLine1": "FLAT#1234, Tower#201, Prestige Residency, Haralur Road",
"city": "Bengaluru",
"stateOrRegion": "KA",
"countryCode": "IN",
"postalCode": "560102",
"phone": "9168071234"
},
`"codSettings": {
"isCodRequired": true
},`
"notificationEmails": [
"lokshws@amazon.com"
],
"items": [
{
"sellerSku": "mohamf devogst8 B06XSK3XL6",
"sellerFulfillmentOrderItemId": "OrderItemID1",
"quantity": 1,
"perUnitDeclaredValue": {
"currencyCode": "INR",
"value": "2.00"
}
}
]
}
レスポンス
成功時のレスポンスには200のコードが含まれ、空です。
不成功の場合、コードが 2xx ではなく、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors | 中に 1 つまたは複数の予期しないエラーが発生しました createFulfillmentOrder オペレーション。タイプ: ErrorList |
ステップ3. フルフィルメント注文を取得して注文の詳細を検証
createFulfillmentOrder
オペレーションの呼び出しに成功したら、getFulfillmentOrder
オペレーションを呼び出して、fulfillmentAction= Ship
およびfulfillmentOrderStatus= Received
となっているか検証します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "createOrder1703154732",
"marketplaceId": "A2XZLSVIQ0F4JT",
"displayableOrderId": "TestOrder-FBAOutbound20",
"displayableOrderDate": "2023-11-09T19:46:45Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "Anshul R",
"addressLine1": "FLAT#1234, Tower#201, Prestige Residency, Haralur Road",
"city": "Bengaluru",
"stateOrRegion": "KA",
"countryCode": "IN",
"postalCode": "560102",
"phone": "9168071234"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillOrKill",
"receivedDate": "2023-12-21T10:32:12Z",
"fulfillmentOrderStatus": "Planning",
"statusUpdatedDate": "2023-12-21T10:32:20Z",
"notificationEmails": [
"lokshws@amazon.com"
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
}
]
},
"fulfillmentOrderItems": [
{
"sellerSku": "mohamf devogst8 B06XSK3XL6",
"sellerFulfillmentOrderItemId": "OrderItemID1",
"quantity": "1",
"fulfillmentNetworkSku": "X0014EAZ4D",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "0",
"estimatedShipDate": "2023-12-22T18:29:59Z",
"estimatedArrivalDate": "2023-12-26T18:29:59Z",
"perUnitDeclaredValue": {
"currencyCode": "INR",
"value": "2.00"
}
}
],
"fulfillmentShipments": [],
"returnItems": [],
"returnAuthorizations": [],
"paymentInformation": [
{
"paymentTransactionId": "TestPaymenttransaction",
"paymentMode": "Other",
"paymentDate": "2023-11-15T00:25:56Z"
}
]
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
| フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors | 操作中に1つ以上の予期しないエラーが発生しました。 タイプ: |
チュートリアル:一部出荷された注文の追跡
このチュートリアルでは、在庫が少ない商品について、一部出荷された注文を追跡する手順を説明します。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. フルフィルメントプレビューの取得
2つの商品を指定してgetFulfillmentPreview
オペレーションを呼び出し、それらの商品が指定した配送オプション(標準、お急ぎ便、プライオリティ)で出荷できることを確認します。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
address | フルフィルメント注文プレビューの配送先住所。 タイプ: | はい |
items | フルフィルメントオーダープレビュー内の商品の識別情報と数量情報。最大100品目、1回の注文につき最大250ユニット。 | はい |
shippingSpeedCategories | フルフィルメント注文プレビューの作成に使用する配送方法のリスト。 指定できる値:
注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。 | いいえ |
includeCODFulfillmentPreview | (代金引換 (COD)) 用の出荷注文プレビューを返品するかどうかを指定します。 指定できる値:
インドでの注文にのみ適用されます。 タイプ:ブール値 | いいえ |
includeDeliveryWindows | お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。 タイプ:ブール値 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview"
{
"marketplaceId": "ATVPDKIKX0DER",
"address": {
"name": "Mary Major",
"addressLine1": "Stockton Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"items": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": 1
},
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": 1
}
],
"shippingSpeedCategories": [
"Standard"
]
}
レスポンス
呼び出しが成功した場合、レスポンスのコードは200となり、getFulfillmentPreview
オペレーションのレスポンススキーマに従ってレスポンスが生成されます。
{
"payload": {
"fulfillmentPreviews": [
{
"estimatedFees": [
{
"amount": {
"currencyCode": "USD",
"value": "2"
},
"name": "FBAPerOrderFulfillmentFee"
},
{
"amount": {
"currencyCode": "USD",
"value": "2"
},
"name": "FBATransportationFee"
},
{
"amount": {
"currencyCode": "USD",
"value": "8"
},
"name": "FBAPerUnitFulfillmentFee"
}
],
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "12.377249768019787"
},
"featureConstraints": [
{
"featureFulfillmentPolicy": "NotRequired",
"featureName": "BLANK_BOX"
},
{
"featureFulfillmentPolicy": "NotRequired",
"featureName": "BLOCK_AMZL"
}
],
"fulfillmentPreviewShipments": [
{
"earliestArrivalDate": "2023-04-15T00:16:14Z",
"earliestShipDate": "2023-04-13T00:16:14Z",
"fulfillmentPreviewItems": [
{
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "6.394347942660858"
},
"quantity": 1,
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"sellerSku": "LT110WHTAM",
"shippingWeightCalculationMethod": "PACKAGE"
}
],
"latestArrivalDate": "2023-04-16T00:16:14Z",
"latestShipDate": "2023-04-14T00:16:14Z",
"shippingNotes": []
},
{
"earliestArrivalDate": "2023-04-15T00:16:14Z",
"earliestShipDate": "2023-04-13T00:16:14Z",
"fulfillmentPreviewItems": [
{
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "7.521162362321674"
},
"quantity": 1,
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"sellerSku": "LT205BLKAM",
"shippingWeightCalculationMethod": "PACKAGE"
}
],
"latestArrivalDate": "2023-04-16T00:16:14Z",
"latestShipDate": "2023-04-14T00:16:14Z",
"shippingNotes": []
}
],
"isCodCapable": false,
"isFulfillable": true,
"marketplaceId": "ATVPDKIKX0DER",
"scheduledDeliveryinfo": {},
"shippingSpeedCategory": "Standard",
"unfulfillablePreviewItems": []
}
]
}
}
名前 | 説明 |
---|---|
fulfillmentPreviews | フルフィルメントプレビュー情報の配列。 |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。もし、 PackageNumber
存在しない場合、404 応答で不適格エラーが表示されます。
名前 | 説明 |
---|---|
errors |
タイプ: |
ステップ2. FBAマルチチャネルサービス注文の作成
に電話してください createFulfillmentOrder
一意の注文 ID と少なくとも 2 つの品目、または数量がより大きい品目が 1 つある操作 1
同じ配送オプションの場合。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
sellerFulfillmentOrderId | 出品者がフルフィルメントオーダーを追跡するために作成するフルフィルメントオーダーID。は
最大長:40 タイプ:文字列 | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。DisplayableOrderId の値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にSellerFulfillmentOrderId を使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。 最大長:40 タイプ:文字列 | いいえ |
displayableOrderDate | フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。 タイプ: | はい |
displayableOrderComment | 出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。 最大長:250 タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文の配送方法。 | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress | フルフィルメント注文の配送先住所。 タイプ: | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: | いいえ |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換手数料。 タイプ: | いいえ |
shipFromCountryCode | フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。 タイプ:文字列 | いいえ |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
Items | フルフィルメントオーダープレビューに含める商品のリスト (数量を含む)。品目数は最大100個、1回の注文につき最大250ユニットです。 | はい |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"fulfillmentAction": "Ship",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "Stockton Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"items": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": 1
},
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": 1
}
]
}
レスポンス
成功時のレスポンスには 200 のコードが含まれ、次のオブジェクトが含まれます。
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
ステップ3. 注文詳細の検証
getFulfillmentOrder
オペレーションを呼び出して、fulfillmentAction = Ship
およびfulfillmentOrderStatus = Received
となっているか検証します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045 "
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"marketplaceId": "ATVPDKIKX0DER",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-09-21T14:48:15Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Any Town",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2022-09-21T14:50:45Z",
"fulfillmentOrderStatus": "Received",
"statusUpdatedDate": "2022-09-22T03:44:35Z",
"notificationEmails": [
"marymajor@email.com"
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
}
]
},
"fulfillmentOrderItems": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1",
"fulfillmentNetworkSku": "X002ZKH36D",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "1",
"estimatedShipDate": "2022-09-22T06:59:59Z",
"estimatedArrivalDate": "2022-09-26T06:59:59Z",
"perUnitDeclaredValue": {
"currencyCode": "USD",
"value": "0.00"
}
},
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": "1",
"giftMessage": "",
"fulfillmentNetworkSku": "X002ZKYQ4Z",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "0",
"estimatedShipDate": "",
"estimatedArrivalDate": "",
"perUnitDeclaredValue": {
"currencyCode": "USD",
"value": "1995.00"
}
}
],
"fulfillmentShipments": [],
"returnItems": [],
"returnAuthorizations": []
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
fulfillmentOrderItems | フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
ステップ4. 注文ステータスの変更
注文のステータスは以下から変更されます Planning
に Processing
に Complete
1 つまたは複数の商品の在庫が要求どおりに不足している場合 createFulfillmentOrder
オペレーション。ステータス変更の最新情報を入手するには、購読して聞いてください FULFILLMENT_ORDER_STATUS
通知。
ステップ 5:フルフィルメントオーダーを取得して、最新の注文詳細を確認してください。
注文の出荷ステータスがShipped
になると、Complete
の注文ステータス通知がトリガーされます。この通知がトリガーされたら、getFulfillmentOrder
オペレーションを呼び出して、最新の注文詳細を確認します。以下のパラメーターを渡してgetFulfillmentOrder
オペレーションを呼び出します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"marketplaceId": "ATVPDKIKX0DER",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-09-21T14:48:15Z",
"displayableOrderComment": "Thank you for your order",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "Stockton Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2022-09-21T14:50:45Z",
"fulfillmentOrderStatus": "CompletePartialled",
"statusUpdatedDate": "2022-09-22T03:44:35Z",
"notificationEmails": [
"email@email.com"
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
}
]
},
"fulfillmentOrderItems": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1",
"fulfillmentNetworkSku": "X002ZKH36D",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "1",
"estimatedShipDate": "2022-09-22T06:59:59Z",
"estimatedArrivalDate": "2022-09-26T06:59:59Z",
"perUnitDeclaredValue": {
"currencyCode": "USD",
"value": "0.00"
}
},
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": "1",
"giftMessage": "",
"fulfillmentNetworkSku": "X002ZKYQ4Z",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "0",
"estimatedShipDate": "",
"estimatedArrivalDate": "",
"perUnitDeclaredValue": {
"currencyCode": "USD",
"value": "1995.00"
}
}
],
"fulfillmentShipments": [
{
"amazonShipmentId": "T7mfkbDX5",
"fulfillmentCenterId": "TUL2",
"fulfillmentShipmentStatus": "SHIPPED",
"shippingDate": "2022-09-22T03:39:19Z",
"estimatedArrivalDate": "2022-09-26T06:59:59Z",
"fulfillmentShipmentItem": [
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": "1",
"packageNumber": "1681854637"
}
],
"fulfillmentShipmentPackage": [
{
"packageNumber": "1681854637",
"carrierCode": "Amazon Logistics",
"trackingNumber": "TBA303037991486",
"estimatedArrivalDate": "2022-09-26T03:00:00Z"
}
]
}
],
"returnItems": [],
"returnAuthorizations": []
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
fulfillmentOrderItems | フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
ステップ6. 注文ステータスおよび商品数量の検証
fulfillmentShipmentStatus = Shipped
およびfulfillmentOrderStatus = CompletePartialled
となっているか検証します。unfulfillableQuantity !=0
の商品があれば、その注文は一部のみ出荷された状態となっています。
ステップ7. パッケージ番号の取得
から注文のパッケージ番号をコピーしてください getFulfillmentOrder
からの応答 ステップ 5。その注文のAmazon出荷数に基づいて、複数のパッケージ番号が付けられている場合があります。
ステップ8. 追跡詳細情報の取得
getPackageTrackingDetails
オペレーションを、ステップ7のパッケージ番号を使用して呼び出し、パッケージのすべての追跡詳細情報を取得します。
パラメーター | 説明 | 必須 |
---|---|---|
packageNumber |
タイプ:整数(int32) | はい |
リクエストの例
GET “https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/tracking?packageNumber=1681854637”
レスポンス
成功時のレスポンスには 200 のコードが付けられます。
レスポンスの例
{
"payload": {
"packageNumber": 1681854637,
"trackingNumber": "TBA303037991486",
"carrierCode": "Amazon",
"carrierURL": "https://www.swiship.com/track?id=TBA303037991486",
"shipDate": "2022-09-22T03:57:50Z",
"estimatedArrivalDate": "2022-09-26T03:00:00Z",
"shipToAddress": {
"city": "Alexandria",
"state": "VA",
"country": "US"
},
"currentStatus": "DELIVERED",
"additionalLocationInfo": "FRONT_DOOR/PORCH",
"trackingEvents": [
{
"eventDate": "2022-09-25T16:55:51Z",
"eventAddress": {
"city": "Alexandria",
"country": "US"
},
"eventCode": "EVENT_301",
"eventDescription": "Package delivered near the front door or porch."
},
{
"eventDate": "2022-09-25T14:29:43Z",
"eventAddress": {
"city": "Waldorf",
"country": "US"
},
"eventCode": "EVENT_302",
"eventDescription": "Package is out for delivery."
},
{
"eventDate": "2022-09-25T01:00:54Z",
"eventAddress": {
"city": "Sparrows Point",
"state": "Maryland",
"country": "US"
},
"eventCode": "EVENT_201",
"eventDescription": "Package arrived at an Amazon facility."
},
{
"eventDate": "2022-09-24T20:50:45Z",
"eventAddress": {
"city": "Trenton",
"state": "NJ",
"country": "US"
},
"eventCode": "EVENT_202",
"eventDescription": "Package left an Amazon facility."
},
{
"eventDate": "2022-09-24T08:35:48Z",
"eventAddress": {
"city": "Trenton",
"state": "NJ",
"country": "US"
},
"eventCode": "EVENT_201",
"eventDescription": "Package arrived at an Amazon facility."
},
{
"eventDate": "2022-09-23T06:54:31Z",
"eventAddress": {
"city": "Liberty",
"state": "Missouri",
"country": "US"
},
"eventCode": "EVENT_202",
"eventDescription": "Package left an Amazon facility."
},
{
"eventDate": "2022-09-22T23:15:03Z",
"eventAddress": {
"city": "Liberty",
"state": "Missouri",
"country": "US"
},
"eventCode": "EVENT_201",
"eventDescription": "Package arrived at an Amazon facility."
},
{
"eventDate": "2022-09-22T03:57:50Z",
"eventCode": "EVENT_101",
"eventDescription": "Carrier picked up the package."
}
]
}
}
名前 | 説明 | 必須 |
---|---|---|
packageNumber | パッケージ識別子。 タイプ:整数(int32) | はい |
trackingNumber | パッケージの追跡番号。 タイプ:文字列 | いいえ |
customerTrackingLink | 購入者がパッケージを追跡できるswiship.comのリンク。 タイプ:文字列 | いいえ |
carrierCode | 配送業者の名前。 タイプ:文字列 | いいえ |
carrierPhoneNumber | 配送業者の電話番号。 タイプ:文字列 | いいえ |
carrierURL | 配送業者のウェブサイトのURL。 タイプ:文字列 | いいえ |
shipDate | パッケージの出荷日。 タイプ: | いいえ |
estimatedArrivalDate | 到着予定日。 タイプ: | いいえ |
shipToAddress | パッケージの配送先市区町村。 タイプ: | いいえ |
currentStatus | パッケージの現在の配送ステータス。 タイプ: | いいえ |
currentStatusDescription |
タイプ:文字列 | いいえ |
signedForBy | パッケージに署名した人の名前。 タイプ:文字列 | いいえ |
additionalLocationInfo | 場所に関する追加情報。 | いいえ |
trackingEvents | 追跡イベント情報の配列。 | いいえ |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。もし、 PackageNumber
存在しない場合、404 応答で不適格エラーが表示されます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:保留ステータスの注文の作成および出荷済みへの移行
このチュートリアルでは、注文のフルフィルメントステータスをどのようにHOLD
からSHIP
に移行できるかについて説明します。HOLD
ステータスの注文は、ステータスがSHIP
に更新されるまで次のフルフィルメントアクションに進みません。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. フルフィルメントプレビューの取得
注文に対してgetFulfillmentPreview
オペレーションを呼び出し、SKUが、リクエストした配送オプション(標準、お急ぎ便、プライオリティ)で出荷できることを確認します。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
address | フルフィルメント注文プレビューの配送先住所。 タイプ: | はい |
items | フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。 | はい |
shippingSpeedCategories | フルフィルメント注文プレビューの作成に使用する配送方法のリスト。 指定できる値:
注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。 | いいえ |
includeCODFulfillmentPreview | 代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。 指定できる値: true - 代金引換の注文と代金引換以外の注文の両方を含む、すべてのフルフィルメント注文のプレビューを返します。false - 代金引換以外のフルフィルメント注文のみのプレビューを返します。日本の注文にのみ適用されます。タイプ:ブール値 | いいえ |
includeDeliveryWindows | お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。 タイプ:ブール値 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview"
{
"marketplaceId": "ATVPDKIKX0DER",
"address": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Anytown",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"items": [
{
"sellerSku": "LT205BTBLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": 2
}
],
"shippingSpeedCategories": [
"Standard"
]
}
名前 | 説明 |
---|---|
fulfillmentPreviews | フルフィルメントプレビュー情報の配列。 |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。404 レスポンスには、不適格エラーがあればそれが表示されます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
ステップ2. 保留ステータスのフルフィルメント注文の作成
リクエストにfulfillmentAction=Hold
の商品を1つ以上指定して、createFulfillmentOrder
オペレーションを呼び出します。これにより、注文のステータスがHold
に維持され、このステータスの間はその注文に対して次のフルフィルメントアクションが実行されません。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
sellerFulfillmentOrderId | フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。 最大長:40 タイプ:文字列 | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。 最大長:40 タイプ:文字列 | はい |
displayableOrderDate | フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。 タイプ: | はい |
displayableOrderComment | 出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。 最大長:250 タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文の配送方法。 | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress | フルフィルメント注文の配送先住所。 タイプ: | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: | いいえ |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換手数料。 タイプ: | いいえ |
shipFromCountryCode | フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。 タイプ:文字列 | いいえ |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
Items | フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。 | はい |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"fulfillmentAction": "Hold",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"items": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": 1
},
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": 1
}
]
}
レスポンス
成功時のレスポンスには 200 のコードが含まれ、次のオブジェクトが含まれます。
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
ステップ3. 注文フルフィルメントアクションを「出荷」に更新
updateFulfillmentOrder
オペレーションを呼び出して注文を更新し(リクエスト本文にfulfillmentAction = Ship
を指定)、Hold
からShip
に移行します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 タイプ:文字列 | はい |
リクエストの例
PUT "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
{
"fulfillmentAction": "Ship"
}
レスポンス
成功時のレスポンスには 200 のコードが付けられます。
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
ステップ4. フルフィルメント注文を取得して変更を検証
注文が正常に更新されたら、getFulfillmentOrder
オペレーションを呼び出して、fulfillmentAction
がShip
に更新されているか検証します。注文がShip
アクションに移行されると、注文に対して次のフルフィルメントステップの実行が開始されます。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"marketplaceId": "ATVPDKIKX0DER",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-09-21T14:48:15Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2022-09-21T14:50:45Z",
"fulfillmentOrderStatus": "Received",
"statusUpdatedDate": "2022-09-22T03:44:35Z",
"notificationEmails": [
"email@email.com"
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
}
]
},
"fulfillmentOrderItems": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1"
},
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": "1"
}
],
"fulfillmentShipments": [],
"returnItems": [],
"returnAuthorizations": []
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
fulfillmentOrderItems | フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
チュートリアル:商品のシリアル番号を使用した注文の追跡
一部の商品では、具体的にどの商品が特定の購入者に販売されたかを把握することが必要な場合があります。商品を追跡するための一意のシリアル番号が設定されていれば、フルフィルメントセンターは、出荷および返品される商品に対してシリアル番号をスキャンして記録するステップを追加することができます。
商品が出荷された後、getFulfillmentOrder
オペレーションを呼び出すと、レスポンスにシリアル番号が返されるので、出品者はこの番号を記録しておくことができます。
前提条件
- 出品者は、生成されるシリアル番号の正規表現をAmazonと共有する必要があります。
- 出品者は、Amazonに在庫を納品するときに、生成された一意のシリアル番号をすべての商品に貼付する必要があります。
- 購入者がAmazonラベル貼付サービスを使用している場合、ASINの登録に加えて、商品に関連付けられているFNSKUも同じプロセスを使用して登録する必要があります。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. シリアル番号が割り振られた商品のフルフィルメント注文の作成
createFulfillmentOrder
オペレーションを呼び出して、Amazonへの納品時にシリアル番号が有効になる商品を含むFBAマルチチャネルサービス注文を作成します。
この種類の注文では、createFulfillmentOrder
リクエストで専用の属性は必要ありません。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
sellerFulfillmentOrderId | フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。 最大長:40 タイプ:文字列 | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。 この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。 | はい |
displayableOrderDate | フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。 タイプ: | はい |
displayableOrderComment | 出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。 最大長:250 タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文の配送方法。 | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress | フルフィルメント注文の配送先住所。 タイプ: | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: | いいえ |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換 (COD) 料金。 タイプ: | いいえ |
shipFromCountryCode | フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。 タイプ:文字列 | いいえ |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
アイテム | フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。 | はい |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"fulfillmentAction": "Ship",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"items": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": 1
}
]
}
レスポンス
成功時のレスポンスには 200 のコードが含まれ、次のオブジェクトが含まれます。
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
ステップ2. フルフィルメント注文を取得して注文詳細を検証
注文が正常に作成されたら、getFulfillmentOrder
オペレーションを呼び出して、注文でfulfillmentAction = Ship
およびfulfillmentOrderStatus = Received
となっているか検証します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"marketplaceId": "ATVPDKIKX0DER",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2022-09-21T14:50:45Z",
"fulfillmentOrderStatus": "Received",
"statusUpdatedDate": "2022-09-22T03:44:35Z",
"notificationEmails": [
"email@email.com"
],
"fulfillmentOrderItems": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1"
}
],
"fulfillmentShipments": [],
"returnItems": [],
"returnAuthorizations": []
}
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
fulfillmentOrderItems | フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
ステップ3. フルフィルメント注文を取得してステータスの変更を追跡
注文のステータスが、Planning
からProcessing
、Complete
へと変更されます。FULFILLMENT_ORDER_STATUS
通知に登録して通知を待ち受け、これらのステータスの変更を確認します。
注文が出荷されるときに、商品のシリアル番号がスキャンされ、共有されている正規表現と一致するか検証されます。getFulfillmentOrder
オペレーションをsellerFulfillmentOrderId
を指定して呼び出し、最新の注文詳細を確認して、そのシリアル番号の商品が出荷されたかどうか確認します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045 "
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"marketplaceId": "ATVPDKIKX0DER",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-09-21T14:48:15Z",
"displayableOrderComment": "TestOrder1",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Any Town",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2022-09-21T14:50:45Z",
"fulfillmentOrderStatus": "Complete",
"statusUpdatedDate": "2022-09-22T03:44:35Z",
"notificationEmails": [
"email@email.com"
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
}
]
},
"fulfillmentOrderItems": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1",
"fulfillmentNetworkSku": "X002ZKH36D",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "0",
"estimatedShipDate": "2022-09-22T06:59:59Z",
"estimatedArrivalDate": "2022-09-26T06:59:59Z",
"perUnitDeclaredValue": {
"currencyCode": "USD",
"value": "100.00"
}
}
],
"fulfillmentShipments": [
{
"amazonShipmentId": "T7mfkbDX5",
"fulfillmentCenterId": "TUL2",
"fulfillmentShipmentStatus": "SHIPPED",
"shippingDate": "2022-09-22T03:39:19Z",
"estimatedArrivalDate": "2022-09-26T06:59:59Z",
"fulfillmentShipmentItem": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1",
"packageNumber": "1681854637",
"serialNumber": "355313088062664"
}
],
"fulfillmentShipmentPackage": [
{
"packageNumber": "1681854637",
"carrierCode": "Amazon Logistics",
"trackingNumber": "TBA303037991486",
"estimatedArrivalDate": "2022-09-26T03:00:00Z"
}
]
}
],
"returnItems": [],
"returnAuthorizations": []
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
fulfillmentOrderItems | フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
ステップ4. 注文ステータスおよび商品数量の検証
fulfillmentShipmentStatus=Shipped
となっているか、およびserialNumber
(fulfillmentShipmentItem
内)が、納品プロセスで生成された番号と同じであるかを検証します。
チュートリアル:クロスボーダーフルフィルメントの注文の作成
このチュートリアルでは、2つの異なる国で事業を運営して商品を販売する出品者が、国境を越えて注文を出荷する方法の概要を説明します。このオペレーションは、本、ビデオ、メディア、ディスク商品にのみ適用されます。
この例では、出品者はカナダ(CA)の倉庫から米国の住所に対して注文を出荷します。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. クロスボーダーの配送を行うフルフィルメント注文の作成
米国の配送先住所とshipFromCountryCode=CA
を指定して、注文を作成します。この場合、リクエストでのmarketplaceId
の指定はスキップすることができ、商品はCAマーケットプレイスでピッキングされます。また、申告額が0よりも大きい商品に対しては、perUnitDeclaredValue
を含めます。createFulfillmentOrder
オペレーションを呼び出して、以下の必要な本文パラメーターを渡します。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 | いいえ |
sellerFulfillmentOrderId | フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。 最大長:40 タイプ:文字列 | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。 最大長:40 タイプ:文字列 | はい |
displayableOrderDate | フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。 タイプ: | はい |
displayableOrderComment | 出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。 最大長:250 タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文の配送方法。 | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress | フルフィルメント注文の配送先住所。 タイプ: | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: | いいえ |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換 (COD) 料金。 タイプ: | いいえ |
shipFromCountryCode | フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。 タイプ:文字列 | いいえ |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
Items | フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。 | はい |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"fulfillmentAction": "Ship",
"shipFromCountryCode": "CA",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "Stockton Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"items": [
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": 1,
"perUnitDeclaredValue": {
"currencyCode": "USD",
"value": "0.10"
}
}
]
}
レスポンス
成功時のレスポンスには 200 のコードが含まれ、次のオブジェクトが含まれます。
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:BLANK_BOXおよびBLOCK_AMZL機能をリクエストした注文の作成
FBAマルチチャネルサービスでは、注文作成時のリクエストに2種類の機能を指定することができます。
-
空白の箱:Amazonのロゴ/ラベルが付いていない箱を出品者が選択できるようにします。
-
AMZLをブロック:出品者がAmazonのロジスティクスを拒否し、代わりに別の配送業者のサービスを利用して出荷できるようにします。
注文作成プロセスでリクエストを行った後、注文のフルフィルメントステップでこの設定を更新することはできません。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. 特定の機能制約におけるフルフィルメントのプレビューの取得
特定の配送オプションと機能制約を使用して、注文商品に対してgetFulfillmentPreview
オペレーションを呼び出し、該当するマーケットプレイスおよび住所における注文の出荷でその機能を利用できることを確認します。
getFulfillmentPreview
オペレーションを呼び出して、以下の本文パラメーターを渡します。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
address | フルフィルメント注文プレビューの配送先住所。 タイプ: | はい |
items | フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。 | はい |
shippingSpeedCategories | フルフィルメント注文プレビューの作成に使用する配送方法のリスト。 指定できる値:
注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。 | いいえ |
includeCODFulfillmentPreview | 代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。 指定できる値:
タイプ:ブール値 | いいえ |
includeDeliveryWindows | お届け日時指定配送で利用できる配送時間帯を含む タイプ:ブール値 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview"
{
"marketplaceId": "ATVPDKIKX0DER",
"address": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"items": [
{
"sellerSku": "LT205BTBLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": 2
}
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "Required"
},
{
"featureName": "BLOCK_AMZL",
"featureFulfillmentPolicy": "Required"
}
],
"shippingSpeedCategories": [
"Standard"
]
}
レスポンス
呼び出しが成功した場合、レスポンスのコードは200となり、getFulfillmentPreview
オペレーションのレスポンススキーマに従ってレスポンスが生成されます。
レスポンスの例
{
"payload": {
"fulfillmentPreviews": [
{
"shippingSpeedCategory": "Standard",
"isFulfillable": true,
"isCODCapable": false,
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "0.441"
},
"estimatedFees": [
{
"name": "FBAPerOrderFulfillmentFee",
"amount": {
"currencyCode": "USD",
"value": "0.0"
}
},
{
"name": "FBATransportationFee",
"amount": {
"currencyCode": "USD",
"value": "0.0"
}
},
{
"name": "FBAPerUnitFulfillmentFee",
"amount": {
"currencyCode": "USD",
"value": "10.31"
}
}
],
"fulfillmentPreviewShipments": [
{
"earliestShipDate": "2022-12-13T08:00:00Z",
"latestShipDate": "2022-12-14T07:59:59Z",
"earliestArrivalDate": "2022-12-15T08:00:00Z",
"latestArrivalDate": "2022-12-16T07:59:59Z",
"fulfillmentPreviewItems": [
{
"sellerSku": "LT205BTBLKAM",
"quantity": 2,
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "0.379"
},
"shippingWeightCalculationMethod": "Dimensional"
}
]
}
],
"unfulfillablePreviewItems": [],
"marketplaceId": "ATVPDKIKX0DER"
}
]
}
}
名前 | 説明 |
---|---|
FulfillmentPreviews | フルフィルメントプレビュー情報の配列。 |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。404 レスポンスには、不適格エラーがあればそれが表示されます。
名前 | 説明 | 必須 |
---|---|---|
errors | getFulfillmentPreviewオペレーションの実行中に1つ以上の予期しないエラーが発生しました。 タイプ: | はい |
ステップ2. 機能制約を指定してフルフィルメント注文を作成
createFulfillmentOrder
オペレーションを呼び出して、注文に必要な機能制約を指定してFBAマルチチャネルサービス注文を作成します。
機能制約:
機能制約は、セラーセントラルポータルで有効にすることができます。有効にした制約はデフォルト値として使用されますが、注文リクエストに指定した値が優先されます。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
sellerFulfillmentOrderId | フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。 最大長:40 タイプ:文字列 | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。「DisplayableOrderId」の値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値に 最大長:40 タイプ:文字列 | はい |
displayableOrderDate | フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。 タイプ: | はい |
displayableOrderComment | 出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。 最大長:250 タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文の配送方法。タイプ: | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress | フルフィルメント注文の配送先住所。タイプ: | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: | いいえ |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換手数料。 タイプ: | いいえ |
shipFromCountryCode | フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。 タイプ:文字列 | いいえ |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
Items | フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。 | はい |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Priority",
"fulfillmentAction": "Ship",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"items": [
{
"sellerSku": "LT205BTBLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": 1
}
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "Required"
},
{
"featureName": "BLOCK_AMZL",
"featureFulfillmentPolicy": "Required"
}
]
}
レスポンス
成功時のレスポンスには 200 のコードが含まれ、次のオブジェクトが含まれます。
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
ステップ3. フルフィルメント注文を取得して注文の詳細を検証
注文が正常に作成されたら、getFulfillmentOrder
オペレーションを呼び出して、注文詳細のレスポンスでfulfillmentAction = Ship
およびfulfillmentOrderStatus = Received
となっているか、そしてfeatureConstraints
が返されているかを検証します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"marketplaceId": "ATVPDKIKX0DER",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Priority",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "123 Any Street",
"city": "Alexandria",
"stateOrRegion": "VA",
"countryCode": "US",
"postalCode": "22308"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2022-09-21T14:50:45Z",
"fulfillmentOrderStatus": "Received",
"statusUpdatedDate": "2022-09-22T03:44:35Z",
"notificationEmails": [
"email@email.com"
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "Required"
},
{
"featureName": "BLOCK_AMZL",
"featureFulfillmentPolicy": "Required"
}
]
},
"fulfillmentOrderItems": [
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1",
"perUnitDeclaredValue": {
"currencyCode": "USD",
"value": "0.00"
}
}
],
"fulfillmentShipments": [],
"returnItems": [],
"returnAuthorizations": []
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
fulfillmentOrderItems | フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
チュートリアル:すべての配送スピードの詳細プレビューの表示
リクエストに配送スピードについて指定せずにgetFulfillmentPreview
オペレーションを呼び出すと、レスポンスにすべての配送スピードの詳細プレビューが表示されます。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. すべての配送スピードのフルフィルメントプレビューの取得
リクエストでshippingCategories
属性の指定を省略すると、すべての配送スピードについて注文の詳細プレビューを取得できます。
getFulfillmentPreview
オペレーションを呼び出して、以下の本文パラメーターを渡します。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
address | フルフィルメント注文プレビューの配送先住所。 タイプ: | はい |
items | フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。 | はい |
shippingSpeedCategories | フルフィルメント注文プレビューの作成に使用する配送方法のリスト。 指定できる値:
注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。 | いいえ |
includeCODFulfillmentPreview | 代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。 指定できる値:
タイプ:ブール値 | いいえ |
includeDeliveryWindows | お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。ScheduledDeliveryInfoレスポンスオブジェクトは、 タイプ:ブール値 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview"
{
"marketplaceId": "ATVPDKIKX0DER",
"address": {
"name": "Amazon",
"addressLine1": "123 Any Street",
"addressLine2": "Building2010",
"addressLine3": "Lane1",
"stateOrRegion": "MI",
"countryCode": "US",
"country": "US",
"city": "Troy",
"postalCode": "48084",
"phone": "480-441-2465"
},
"items": [
{
"quantity": 5,
"sellerFulfillmentOrderItemId": "04740712772466",
"sellerSku": "LT205BLKAM"
}
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
},
{
"featureName": "BLOCK_AMZL",
"featureFulfillmentPolicy": "Required"
}
]
}
レスポンスの例
呼び出しが成功した場合、レスポンスのコードは200となり、getFulfillmentPreview
オペレーションのレスポンススキーマに従ってレスポンスが生成されます。
{
"payload": {
"fulfillmentPreviews": [
{
"estimatedFees": [
{
"amount": {
"currencyCode": "USD",
"value": "10"
},
"name": "FBAPerUnitFulfillmentFee"
}
],
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "37.55115842140852"
},
"featureConstraints": [
{
"featureFulfillmentPolicy": "NotRequired",
"featureName": "BLANK_BOX"
},
{
"featureFulfillmentPolicy": "Required",
"featureName": "BLOCK_AMZL"
}
],
"fulfillmentPreviewShipments": [
{
"earliestArrivalDate": "2022-12-11T20:35:15Z",
"earliestShipDate": "2022-12-09T20:35:15Z",
"fulfillmentPreviewItems": [
{
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "13.44454399298887"
},
"quantity": 5,
"sellerFulfillmentOrderItemId": "04740712772466",
"sellerSku": "LT205BLKAM",
"shippingWeightCalculationMethod": "Package"
}
],
"latestArrivalDate": "2022-12-12T20:35:15Z",
"latestShipDate": "2022-12-10T20:35:15Z",
"shippingNotes": []
}
],
"isCodCapable": false,
"isFulfillable": true,
"marketplaceId": "ATVPDKIKX0DER",
"orderUnfulfillableReasons": [],
"shippingSpeedCategory": "Standard",
"unfulfillablePreviewItems": []
},
{
"estimatedFees": [
{
"amount": {
"currencyCode": "USD",
"value": "25"
},
"name": "FBAPerUnitFulfillmentFee"
}
],
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "13.005463669980378"
},
"featureConstraints": [
{
"featureFulfillmentPolicy": "NotRequired",
"featureName": "BLANK_BOX"
},
{
"featureFulfillmentPolicy": "Required",
"featureName": "BLOCK_AMZL"
}
],
"fulfillmentPreviewShipments": [
{
"earliestArrivalDate": "2022-12-09T20:35:15Z",
"earliestShipDate": "2022-12-08T20:35:15Z",
"fulfillmentPreviewItems": [
{
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "6.396357461045615"
},
"quantity": 5,
"sellerFulfillmentOrderItemId": "04740712772466",
"sellerSku": "LT205BLKAM",
"shippingWeightCalculationMethod": "Package"
}
],
"latestArrivalDate": "2022-12-10T20:35:15Z",
"latestShipDate": "2022-12-09T20:35:15Z",
"shippingNotes": []
}
],
"isCodCapable": false,
"isFulfillable": true,
"marketplaceId": "ATVPDKIKX0DER",
"orderUnfulfillableReasons": [],
"shippingSpeedCategory": "Expedited",
"unfulfillablePreviewItems": []
},
{
"estimatedFees": [
{
"amount": {
"currencyCode": "USD",
"value": "10"
},
"name": "FBAPerUnitFulfillmentFee"
}
],
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "37.09772884213881"
},
"featureConstraints": [
{
"featureFulfillmentPolicy": "NotRequired",
"featureName": "BLANK_BOX"
},
{
"featureFulfillmentPolicy": "Required",
"featureName": "BLOCK_AMZL"
}
],
"fulfillmentPreviewShipments": [
{
"earliestArrivalDate": "2022-12-08T20:35:15Z",
"earliestShipDate": "2022-12-07T20:35:15Z",
"fulfillmentPreviewItems": [
{
"estimatedShippingWeight": {
"unit": "POUNDS",
"value": "28.261562502894723"
},
"quantity": 5,
"sellerFulfillmentOrderItemId": "04740712772466",
"sellerSku": "LT205BLKAM",
"shippingWeightCalculationMethod": "Package"
}
],
"latestArrivalDate": "2022-12-09T20:35:15Z",
"latestShipDate": "2022-12-08T20:35:15Z",
"shippingNotes": []
}
],
"isCodCapable": false,
"isFulfillable": true,
"marketplaceId": "ATVPDKIKX0DER",
"orderUnfulfillableReasons": [],
"shippingSpeedCategory": "Priority",
"unfulfillablePreviewItems": []
}
]
}
}
名前 | 説明 |
---|---|
FulfillmentPreviews | フルフィルメントプレビュー情報の配列。 |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。404 レスポンスには、不適格エラーがあればそれが表示されます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
チュートリアル:通知APIを使用した注文通知の表示
出品者は、FULFILLMENT_ORDER_STATUS
通知に登録することで、注文で発生するすべての変更を把握することができます。
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. 通知の作成と登録
ステップ2. 注文ステータス通知の待ち受け
出品者は、Fulfillment_Order_Status
通知を通して、注文ステータスの変更について最新の情報を受け取ることができます。
出荷準備が整ったら、レスポンスのFulfillmentShipmentPackages
配列を確認して、注文のパッケージ詳細を取得します。
レスポンスの例
{
"NotificationVersion": "1.0",
"NotificationType": "FULFILLMENT_ORDER_STATUS",
"PayloadVersion": "1.0",
"EventTime": "2020-07-13T19:42:04.284Z",
"Payload": {
"FulfillmentOrderStatusNotification": {
"SellerId": "A3TH9S8BH6GOGM",
"EventType": "Order",
"StatusUpdatedDateTime": "2020-07-13T19:42:04.284Z",
"SellerFulfillmentOrderId": "amazonbooks.KLA1.202203072322.6911",
"FulfillmentOrderStatus": "Complete",
"FulfillmentShipment": {
"FulfillmentShipmentStatus": "Shipped",
"AmazonShipmentId": "ASID49535",
"EstimatedArrivalDateTime": "2020-07-13T19:42:04.284Z",
"FulfillmentShipmentPackages": [
{
"PackageNumber": 1,
"CarrierCode": "2-930434",
"TrackingNumber": "1Z84456456573405"
},
{
"PackageNumber": 2,
"CarrierCode": "1-930434",
"TrackingNumber": "1Z84456456573405"
},
{
"PackageNumber": 3,
"CarrierCode": "3-930434",
"TrackingNumber": "1Z885647654573405"
}
]
},
"FulfillmentReturnItem": {
"ReceivedDateTime": "2020-07-13T19:42:04.284Z",
"ReturnedQuantity": 12,
"SellerSKU": "SELLERSKU9345"
}
}
},
"NotificationMetadata": {
"ApplicationId": "app-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
"SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
"PublishTime": "2020-07-13T19:42:04.284Z",
"NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
EventType | 通知に注文、出荷、または返品情報が含まれているかどうかを示します。 EventTypeの値:
タイプ:文字列 | はい |
SellerId | 出品者の識別子。 タイプ:文字列 | いいえ |
StatusUpdatedDateTime | ステータスが最後に更新された日付と時刻。で ISO 8601 フォーマット。 タイプ:文字列 | はい |
SellerFulfillmentOrderId |
タイプ:文字列 | はい |
FulfillmentOrderStatus | フルフィルメント注文の現在のステータス。
タイプ:文字列 | はい |
FulfillmentShipment | フルフィルメント注文の出荷に関する配送および商品情報。 | いいえ |
FulfillmentReturnItem | Amazonフルフィルメントセンターに返品された商品に関する情報。 | いいえ |
チュートリアル:FBAマルチチャネルサービス注文の返品の作成
FBAマルチチャネルサービス注文の返品は、返品理由コードの取得、いずれかのコードを使用した返品の送信、実際の商品の返品という3つのステップで構成されます。現在、FBAマルチチャネルサービスでは、共有される返品ラベルはプリペイドではないため、最終顧客が送料を支払う必要があります。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ1. 特定の商品の返品理由コードのリストの取得
以下のパラメーターを渡して、listReturnReasonCodes
オペレーションを呼び出します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerSKU | 返品理由コードが必要な出品者SKU。 タイプ:文字列 | はい |
marketplaceId | 出品者が返品理由コードを希望するマーケットプレイス。 タイプ:文字列 | いいえ |
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。サービスはこの値を使用して、出品者が返品理由コードを希望するマーケットプレイスを判断します。 タイプ:文字列 | いいえ |
language |
タイプ:文字列 | はい |
リクエストの例
GET https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/returnReasonCodes?sellerSku=LT205BLKAM&marketplaceId=ATVPDKIKX0DER&sellerFulfillmentOrderId=CONSUMER-2022921-1450456&language=EN
レスポンス
成功時のレスポンスには 200 のコードが付けられます。
レスポンスの例
{
"payload": {
"ReasonCodeDetailsList": [
{
"ReturnReasonCode": "CR-SWITCHEROO",
"Description": "Different from what was ordered",
"TranslatedDescription": "Product does not meet customer expectations"
},
{
"ReturnReasonCode": "CR-DAMAGED_BY_CARRIER",
"Description": "Damaged during shipping"
},
{
"ReturnReasonCode": "CR-UNAUTHORIZED_PURCHASE",
"Description": "Unauthorized purchase"
},
{
"ReturnReasonCode": "CR-UNWANTED_ITEM",
"Description": "No longer needed/wanted",
"TranslatedDescription": "Unwanted item"
},
{
"ReturnReasonCode": "CR-MISSED_ESTIMATED_DELIVERY",
"Description": "Missed estimated delivery date"
},
{
"ReturnReasonCode": "CR-FOUND_BETTER_PRICE",
"Description": "Better price available",
"TranslatedDescription": "I found better prices elsewhere"
},
{
"ReturnReasonCode": "CR-MISSING_PARTS",
"Description": "Missing parts or accessories"
},
{
"ReturnReasonCode": "CR-EXTRA_ITEM",
"Description": "Arrived in addition to what was ordered",
"TranslatedDescription": "Extra item included in shipment"
},
{
"ReturnReasonCode": "CR-ORDERED_WRONG_ITEM",
"Description": "Accidental order"
},
{
"ReturnReasonCode": "AMZ-PG-BAD-DESC",
"Description": "Different from website description"
},
{
"ReturnReasonCode": "CR-DAMAGED_BY_FC",
"Description": "Damaged due to inappropriate packaging",
"TranslatedDescription": "Product damaged or defective prior to shipping"
},
{
"ReturnReasonCode": "CR-DEFECTIVE",
"Description": "Defective/Does not work properly",
"TranslatedDescription": "Item is defective"
}
]
}
}
名前 | 説明 | 必須 |
---|---|---|
returnReasonCode | 有効な返品理由を示すコード。 タイプ:文字列 | はい |
description | 人間が読める返品理由コードの説明。 タイプ:文字列 | はい |
translatedDescription | 説明の翻訳。 タイプ:文字列 | いいえ |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ:ErrorList |
ステップ2. 注文のフルフィルメント返品の作成
上記ステップで取得したいずれかの理由を使用して、createFulfillmentReturn
オペレーションを呼び出し、返品リクエストを送信して、Amazonに商品を返品するために必要な返品用ラベルを取得します。
プリペイドラベルではありません
このラベルは前払いではありません。配送業者が支払う必要があります。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文を作成したときに出品者が割り当てた識別子。出品者は、自身のレコードを使用して、購入者の返品リクエストに基づき適切な タイプ:文字列 | はい |
本文パラメーター | 説明 | 必須 |
---|---|---|
sellerReturnItemId | 出品者が返品商品に割り当てた識別子。 タイプ:文字列 | はい |
sellerFulfillmentOrderItemId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 タイプ:文字列 | はい |
amazonShipmentId | 返品商品に関連する出荷の識別子。 タイプ:文字列 | はい |
returnReasonCode | 返品商品に出品者が割り当てた返品理由コード。 タイプ:文字列 | はい |
returnComment | 返品商品に関するオプションのコメント。 タイプ:文字列 | いいえ |
リクエストの例
PUT "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/fc5d0aaf64e6d9d517fa7572c0/return"
{
"items": [
{
"sellerReturnItemId": "Itm1",
"sellerFulfillmentOrderItemId": "fc5d0aaf64e6d9d517fa7572c0",
"amazonShipmentId": "Uvwxq86C7",
"returnReasonCode": "CR-ORDERED_WRONG_ITEM",
"returnComment": "Accidental order"
}
]
}
レスポンス
呼び出しが成功した場合、レスポンスのコードは200となり、createFulfillmentReturn
オペレーションのレスポンススキーマに従ってレスポンスが生成されます。
レスポンスの例
{
"payload": {
"returnItems": [
{
"sellerReturnItemId": "Itm1",
"sellerFulfillmentOrderItemId": "fc5d0aaf64e6d9d517fa7572c0",
"amazonShipmentId": "Uvwxq86C7",
"returnComment": "Accidental order",
"amazonReturnReasonCode": "CR-ORDERED_WRONG_ITEM",
"status": "New",
"statusChangedDate": "2022-10-26T03:48:29Z",
"returnAuthorizationId": "RMA26PCEUDROQE18"
}
],
"invalidReturnItems": [],
"returnAuthorizations": [
{
"returnAuthorizationId": "RMA26PCEUDROQE18",
"fulfillmentCenterId": "LEX2",
"returnToAddress": {
"name": "Returns Department",
"addressLine1": "123 Any Street",
"districtOrCounty": "US",
"city": "Lexington",
"stateOrRegion": "KY",
"countryCode": "US",
"postalCode": "40511"
},
"amazonRmaId": "DBKKwqJ0RRMA",
"rmaPageURL": "https://www.amazon.com/spr/returns/label/rmaID/DBKKwqJ0RRMA"
}
]
}
}
名前 | 説明 | 必須 |
---|---|---|
ReturnItemList | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ:< | はい |
InvalidReturnItemList | 無効な返品商品の情報の配列。 タイプ:< | はい |
ReturnAuthorizationList | 返品承認情報の配列。 タイプ:< | はい |
名前 | 説明 |
---|---|
errors | 操作中に1つ以上の予期しないエラーが発生しました。 タイプ: |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。404 レスポンスには、不適格エラーがあればそれが表示されます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
ステップ3. 返品する商品の返送
上記のレスポンスに含まれるrmaPageURL
で、印刷してパッケージに貼付する必要がある返品用ラベルが提供されます。送料は、返品する購入者が支払う必要があります。
ステップ4. フルフィルメント注文を取得して注文の返品を検証
Amazonの倉庫でパッケージが受領されると、注文内でその商品が返品済みとマークされます。getFulfillmentOrder
オペレーションを呼び出して、元の注文に対して返品承認が入力されているか検証します。returnItems
およびreturnAuthorizations
には、createFulfillmentReturn
のレスポンスと同じ詳細情報、および返品された商品のステータス/状態が含まれています。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-1450456"
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-1450456",
"marketplaceId": "ATVPDKIKX0DER",
"displayableOrderId": "Test Order1",
"displayableOrderDate": "2022-10-31T15:15:20Z",
"displayableOrderComment": "We have received your Order.",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "Nikki Wolf",
"addressLine1": "123 Any Street",
"city": "Charlotte",
"stateOrRegion": "NC",
"countryCode": "US",
"postalCode": "28277"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2022-10-31T13:24:13Z",
"fulfillmentOrderStatus": "Complete",
"statusUpdatedDate": "2022-11-07T15:14:04Z",
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "Required"
},
{
"featureName": "BLOCK_AMZL",
"featureFulfillmentPolicy": "Required"
}
]
},
"fulfillmentOrderItems": [
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "fc5d0aaf64e6d9d517fa7572c0",
"quantity": "1",
"fulfillmentNetworkSku": "X002ZKYQ4Z",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "0",
"estimatedShipDate": "2022-11-01T06:59:59Z",
"estimatedArrivalDate": "2022-11-05T06:59:59Z",
"perUnitDeclaredValue": {
"currencyCode": "USD",
"value": "1995.00"
}
}
],
"fulfillmentShipments": [
{
"amazonShipmentId": "Uvwxq86C7",
"fulfillmentCenterId": "GYR1",
"fulfillmentShipmentStatus": "SHIPPED",
"shippingDate": "2022-10-31T21:16:36Z",
"estimatedArrivalDate": "2022-11-05T06:59:59Z",
"fulfillmentShipmentItem": [
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "16653",
"quantity": "1",
"packageNumber": "1725289037"
}
],
"fulfillmentShipmentPackage": [
{
"packageNumber": "UA-123456789",
"carrierCode": "UPS",
"trackingNumber": "1Z62Y7Y8425779999",
"estimatedArrivalDate": "2022-11-05T03:00:00Z"
}
]
}
],
"returnItems": [
{
"amazonShipmentId": "Uvwxq86C7",
"sellerFulfillmentOrderItemId": "fc5d0aaf64e6d9d517fa7572c0",
"sellerReturnItemId": "SRII1",
"returnComment": "recomment",
"amazonReturnReasonCode": "CR-ORDERED_WRONG_ITEM",
"status": "New",
"statusChangedDate": "2022-11-07T23:14:01Z",
"returnAuthorizationId": "RMA26PCEUDROQE18"
}
],
"returnAuthorizations": [
{
"returnAuthorizationId": "RMA26PCEUDROQE18",
"fulfillmentCenterId": "LAS2",
"returnToAddress": {
"name": "Returns Department",
"addressLine1": "100 Main Street",
"addressLine2": "Ste 111",
"districtOrCounty": "US",
"city": "Las Vegas",
"stateOrRegion": "NV",
"countryCode": "US",
"postalCode": "89193"
},
"amazonRmaId": "D2dJ2rJ6RRMA",
"rmaPageURL": "https://www.amazon.com/spr/returns/label/rmaID/D2dJ2rJ6RRMA"
}
]
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
fulfillmentOrderItems | フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
チュートリアル:ダイナミックデリバリーオファーの取得
このチュートリアルでは、米国の郵便番号または米国のIPアドレスを使用して購入可能な商品の動的配送オファーを取得する方法の概要を説明します。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ 1:ダイナミックデリバリーオファーを利用する
に電話してください deliveryOffers
指定した商品と位置情報について、標準的なクリックから配信までのスピードで動的な配信オファーを取得する操作。
ボディのパラメーター | 説明 | 必須 |
---|---|---|
product | デリバリーオファーの商品詳細。 | はい |
terms | デリバリーオファーの条件。 | はい |
リクエストの例
POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/deliveryOffers"
{
"product": {
"productIdentifier": {
"merchantSku": "TestSku"
},
"amount": {
"unitOfMeasure": "Eaches",
"value": "2"
}
},
"terms": {
"origin": {
"countryCode": "US"
},
"destination": {
"deliveryAddress": {
"countryCode": "US",
"postalCode": "94560",
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"districtOrCounty": "",
"stateOrRegion": "CA"
},
"ipAddress": ""
}
}
}
レスポンス
成功時のレスポンスには 200 のコードが付けられます。
レスポンスの例
{
"payload": {
"deliveryOffers": [
{
"dateRange": {
"earliest": "2024-06-07T02:59:00Z",
"latest": "2024-06-07T02:59:00Z"
},
"expiresAt": "2024-06-04T01:32:16Z",
"policy": {
"messaging": {
"locale": "en-US",
"text": "Fastest Delivery Thursday, Jun 6"
}
}
}
]
}
}
デリバリーオファーがない場合は、 deliveryOffers
レスポンスでは空です。
{
"payload": {
"deliveryOffers": []
}
}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:配送設定を指定して日本の注文を作成する
このチュートリアルでは、日本での注文作成プロセスと配送設定の概要を説明します。この機能は日本のマーケットプレイスの注文でのみ使用できます。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ 1:配送設定を指定してフルフィルメントオーダーを作成します。
createFulfillmentOrder
オペレーションを呼び出して、注文に必要な機能制約を指定してFBAマルチチャネルサービス注文を作成します。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
sellerFulfillmentOrderId | フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。 最大長:40 タイプ:文字列 | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。 この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。 最大長:40 タイプ:文字列 | はい |
displayableOrderDate | フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。 タイプ: | はい |
displayableOrderComment | 出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。 最大長:250 タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文の配送方法。 ShippingSpeedCategory | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress | フルフィルメント注文の配送先住所。 タイプ: | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: | いいえ |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換 (COD) 料金。 タイプ: | いいえ |
shipFromCountryCode | フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。 タイプ:文字列 | いいえ |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
Items | フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。 | はい |
リクエストの例
POST "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"fulfillmentAction": "Ship",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "1-8-1 Shimomeguro",
"addressLine2": "Meguro-ku",
"city": "Tokyo",
"countryCode": "JP",
"postalCode": "153-0064"
},
"deliveryPreferences": {
"deliveryInstructions": "Beware of dogs",
"dropOffLocation": {
"type": "FRONT_DOOR"
}
},
"items": [
{
"sellerSku": "SellerSKU12",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": 1
}
]
}
レスポンス
成功時のレスポンスには 200 のコードが含まれ、次のオブジェクトが含まれます。
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:配送設定に近隣地域の情報を入力して日本の注文を作成する
このチュートリアルでは、配送先住所に受取人がいない場合に指定の隣人に配達優先を設定する日本での注文作成プロセスの概要を説明します。この機能は日本のマーケットプレイスでの注文でのみ利用できます。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ 1:配送設定を指定してフルフィルメントオーダーを作成します。
createFulfillmentOrder
オペレーションを呼び出して、注文に必要な機能制約を指定してFBAマルチチャネルサービス注文を作成します。
本文パラメーター | 説明 | 必須 |
---|---|---|
marketplaceId | フルフィルメント注文を行うマーケットプレイス。 タイプ:文字列 | いいえ |
sellerFulfillmentOrderId | フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。 最大長:40 タイプ:文字列 | はい |
displayableOrderId | 出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。 この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。 最大長:40 タイプ:文字列 | はい |
displayableOrderDate | フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。 タイプ: | はい |
displayableOrderComment | 出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。 最大長:250 タイプ:文字列 | はい |
shippingSpeedCategory | フルフィルメント注文の配送方法。 ShippingSpeedCategory | はい |
deliveryWindow | お届け日時指定のフルフィルメント注文を配送する時間範囲。 タイプ: | いいえ |
destinationAddress | フルフィルメント注文の配送先住所。 タイプ: | はい |
deliveryPreferences | 配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。 タイプ: | いいえ |
fulfillmentAction | フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。 | いいえ |
fulfillmentPolicy |
| いいえ |
codSettings | 代金引換注文に関連する代金引換 (COD) 料金。 タイプ: | いいえ |
shipFromCountryCode | フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。 タイプ:文字列 | いいえ |
notificationEmails | 出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。 | いいえ |
featureConstraints | 注文に適用する機能のリストとそのフルフィルメントポリシー。 タイプ:< | いいえ |
Items | フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。 | はい |
リクエストの例
POST "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders"
{
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2022-01-09T19:46:45.809Z",
"displayableOrderComment": "TestOrder",
"shippingSpeedCategory": "Standard",
"fulfillmentAction": "Ship",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "1-8-1 Shimomeguro",
"addressLine2": "Meguro-ku",
"city": "Tokyo",
"countryCode": "JP",
"postalCode": "153-0064"
},
"deliveryPreferences": {
"deliveryInstructions": "Beware of dogs",
"dropOffLocation": {
"type": "FALLBACK_NEIGHBOR_DELIVERY",
"attributes": {
"neighborName": "Liam Lowe",
"houseNumber": "1-8-2 Shimomeguro"
}
}
},
"items": [
{
"sellerSku": "SellerSKU12",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": 1
}
]
}
レスポンス
成功時のレスポンスには 200 のコードが含まれ、次のオブジェクトが含まれます。
レスポンスの例
{}
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 |
---|---|
errors |
タイプ: |
チュートリアル:日本に配送された荷物のロッカー (宅配ボックス) 情報を取得する
このチュートリアルでは、マルチチャネルフルフィルメント注文のアウトバウンド出荷で日本のロッカー (宅配ボックス) に配送された荷物のロッカー情報を取得する方法を説明します。
ザの getFulfillmentOrder
API が常に戻るとは限らない lockerDetails
、配送状況と配送場所によって異なります。
を使う getPackageTrackingDetails
配送状況を確認し、荷物がロッカー (宅配ボックス) に配送されたかどうかを確認する API。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- 開発者プロフィールへのAmazonから発送ロールの割り当て。
- アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。
ステップ 1:フルフィルメントオーダーを入手して、最新の注文詳細とロッカーの詳細を確認してください (ある場合)。
以下のパラメーターを渡して、getFulfillmentOrder
オペレーションを呼び出します。
パラメーター | 説明 | 必須 |
---|---|---|
sellerFulfillmentOrderId | フルフィルメント注文作成時に出品者が商品に割り当てた識別子。 最大長:40 タイプ:文字列 | はい |
リクエストの例
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
レスポンス
成功した応答には、ペイロードを含む200のコードがあります。
レスポンスの例
{
"payload": {
"fulfillmentOrder": {
"sellerFulfillmentOrderId": "CONSUMER-2022921-145045",
"marketplaceId": "ATVPDKIKX0DER",
"displayableOrderId": "CONSUMER-2022921-145045",
"displayableOrderDate": "2024-05-21T14:48:15Z",
"displayableOrderComment": "Thank you for your order",
"shippingSpeedCategory": "Standard",
"destinationAddress": {
"name": "Mary Major",
"addressLine1": "1-8-1 Shimomeguro",
"addressLine2": "Meguro-ku",
"city": "Tokyo",
"countryCode": "JP",
"postalCode": "153-0064"
},
"fulfillmentAction": "Ship",
"fulfillmentPolicy": "FillAllAvailable",
"receivedDate": "2024-05-21T14:50:45Z",
"fulfillmentOrderStatus": "CompletePartialled",
"statusUpdatedDate": "2024-05-22T03:44:35Z",
"notificationEmails": [
"email@email.com"
],
"featureConstraints": [
{
"featureName": "BLANK_BOX",
"featureFulfillmentPolicy": "NotRequired"
}
]
},
"fulfillmentOrderItems": [
{
"sellerSku": "LT110WHTAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0",
"quantity": "1",
"fulfillmentNetworkSku": "X002ZKH36D",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "1",
"estimatedShipDate": "2024-05-22T06:59:59Z",
"estimatedArrivalDate": "2024-05-26T06:59:59Z",
"perUnitDeclaredValue": {
"currencyCode": "YEN",
"value": "0.00"
}
},
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": "1",
"giftMessage": "",
"fulfillmentNetworkSku": "X002ZKYQ4Z",
"orderItemDisposition": "Sellable",
"cancelledQuantity": "0",
"unfulfillableQuantity": "0",
"estimatedShipDate": "",
"estimatedArrivalDate": "",
"perUnitDeclaredValue": {
"currencyCode": "YEN",
"value": "15.00"
}
}
],
"fulfillmentShipments": [
{
"amazonShipmentId": "T7mfkbDX5",
"fulfillmentCenterId": "TUL2",
"fulfillmentShipmentStatus": "SHIPPED",
"shippingDate": "2024-05-22T03:39:19Z",
"estimatedArrivalDate": "2024-05-26T06:59:59Z",
"fulfillmentShipmentItem": [
{
"sellerSku": "LT205BLKAM",
"sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1",
"quantity": "1",
"packageNumber": 1681854637
}
],
"fulfillmentShipmentPackage": [
{
"packageNumber": 1681854637,
"carrierCode": "AMZL",
"trackingNumber": "TBA123456789012",
"estimatedArrivalDate": "2024-05-26T06:59:59Z",
"lockerDetails": {
"lockerNumber": "A-42",
"lockerAccessCode" : "7380"
}
}
]
}
],
"returnItems": [],
"returnAuthorizations": []
}
}
本文パラメーター | 説明 | 必須 |
---|---|---|
fulfillmentOrder | フルフィルメント注文についての一般的な情報(ステータスを含む)。 タイプ: | はい |
fulfillmentOrderItems | フルフィルメント注文商品情報の配列。 | はい |
fulfillmentShipments | フルフィルメント出荷情報の配列。 | いいえ |
returnItems | Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。 タイプ: | はい |
returnAuthorizations | 返品承認情報の配列。 | はい |
失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。
名前 | 説明 | 必須 |
---|---|---|
errors |
タイプ: | はい |
Updated 28 days ago