フルフィルメント出荷API v2020-07-01ユースケースガイド

フルフィルメント納品APIの使用方法

APIバージョン:v2020-07-01

フルフィルメント出荷APIについて

フルフィルメント出荷向けSelling Partner API(フルフィルメント出荷API)を使用すると、出品者がAmazonのフルフィルメントネットワーク内の在庫を使用してFBAマルチチャネルサービスの注文商品を出荷するためのアプリケーションを作成できます。発生する見込みのフルフィルメント注文、そして既存のフルフィルメント注文について情報を取得することもできます。

前提条件

チュートリアルを完了するには、次のものが必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。

  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。

  3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

チュートリアル:配達済み荷物の配達証明を取得

配送されたマルチチャネルフルフィルメントアウトバウンド貨物の写真または署名を取得する方法をご覧ください。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでの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いいえ
returnItemsAmazonが返品を受け付けた商品の配列。返品が承認されなかった場合は、空を返します。タイプ: 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(次のトークン)パラメーターで示されたフルフィルメント注文のリストを取得する方法について説明します。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。

  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。

  3. アプリケーションのアプリ登録ページでの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

createFulfillmentOrderオペレーションで送信されたフルフィルメント注文識別子。

タイプ:文字列

はい
marketplaceId

フルフィルメント注文を行うマーケットプレイスの識別子。

タイプ:文字列

はい
displayableOrderId

createFulfillmentOrderオペレーションで送信されたフルフィルメント注文識別子。納品書などの受取人向けドキュメントに注文識別子として記載されます。

タイプ:文字列

はい
displayableOrderDate

createFulfillmentOrderオペレーションで送信された日時。納品書などの受取人向けドキュメントに注文日として記載されます。

タイプ:Timestamp

はい
displayableOrderComment

createFulfillmentOrderオペレーションで送信されたテキストブロック。納品書などの受取人向けドキュメントに記載されます。

タイプ:文字列

はい
shippingSpeedCategory

フルフィルメント注文で使用した配送方法。

タイプ:ShippingSpeedCategory

はい
deliveryWindow

お届け日時指定のフルフィルメント注文を配送する時間範囲。

タイプ:DeliveryWindow

いいえ
destinationAddress

createFulfillmentOrderオペレーションで送信された配送先住所。

タイプ:Address

はい
fulfillmentAction

フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。

タイプ:FulfillmentAction

いいえ
fulfillmentPolicy

FulfillmentPolicyの値。createFulfillmentOrderオペレーションを送信したときに指定した値です。

タイプ:FulfillmentPolicy

いいえ
codSettings

代金引換注文に関連する代金引換 (COD) 料金。

タイプ:CODSettings

いいえ
receivedDate

Amazonフルフィルメントセンターがフルフィルメント注文を受領した日時。

タイプ:Timestamp

はい
fulfillmentOrderStatus

フルフィルメント注文の現在のステータス。

タイプ:FulfillmentOrderStatus

はい
statusUpdatedDate

The date and time that the status of the fulfillment order last changed, in ISO 8601 date-time format.

タイプ:Timestamp

はい
notificationEmails

出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

タイプ:NotificationEmailList

いいえ
featureConstraints

注文に適用する機能のリストとそのフルフィルメントポリシー。

タイプ:< FeatureSettings >配列

いいえ

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

名前説明
errors

操作中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

チュートリアル:配送追跡情報の取得

このチュートリアルでは、FBAマルチチャネルサービスの注文商品の出荷において、パッケージの配送追跡情報を取得する方法について説明します。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

ステップ1. パッケージの追跡詳細情報の取得

以下のパラメーターを渡して、getPackageTrackingDetailsオペレーションを呼び出します。

パラメーター説明必須
packageNumber

getFulfillmentOrderオペレーションによって返されたパッケージ識別子。

タイプ:整数(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

getPackageTrackingDetailsオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

チュートリアル:フルフィルメント注文のキャンセル

このチュートリアルでは、特定のマーケットプレイスで指定された注文識別子を持つフルフィルメント注文の出荷作業を停止するよう、Amazonにリクエストを送信する方法について説明します。cancelFulfillmentOrderオペレーションは、「Received」または「Planning」ステータスの注文に対してのみ呼び出すことができます。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

ステップ1. フルフィルメント注文のキャンセル

以下のパラメーターを渡して、cancelFulfillmentOrderオペレーションを呼び出します。

パラメーター説明必須
sellerFulfillmentOrderId

フルフィルメント注文作成時に出品者が商品に割り当てた識別子。

最大長:40

タイプ:文字列

はい

リクエストの例

PUT "https://sellingpartnerapi-na.amazon.com /fba/outbound/2020-07-01/fulfillmentOrders/TestOrder-7/cancel"

レスポンスの例

{}

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。もし、 sellerFulfillmentOrderId 存在しない場合、404 応答で不適格エラーが表示されます。

名前説明
errors

cancelFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

チュートリアル:機能のリストの取得

このチュートリアルでは、指定したマーケットプレイスにおけるFBAマルチチャネルサービスの注文商品で利用可能な機能のリスト、および呼び出し先の出品者が各機能に登録されているかどうかを取得する方法について説明します。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでの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

getFeaturesオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

チュートリアル:BLANK_BOX機能を使用できる在庫の取得

このチュートリアルでは、BLANK_BOX機能を使用できる在庫商品のリストを取得する方法について説明します。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

ステップ1. 機能を使用できる在庫商品のリストの取得

以下のパラメーターを渡して、getFeatureInventoryオペレーションを呼び出します。

パラメーター説明必須
marketplaceId

指定した機能の対象となる在庫のリストを返すマーケットプレイス。

タイプ:文字列

はい
featureName

対象となる在庫のリストを返す機能の名前。

タイプ:文字列

はい
nextToken

前のリクエストへのレスポンスで返された文字列トークンを、次のレスポンスページを返すために使用します。値nullを指定すると、最初のページが返されます。

タイプ:文字列

いいえ
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の配列と利用可能な数量。

タイプ:< FeatureSku >配列

いいえ

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

名前説明
errors

getFeatureInventoryオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

チュートリアル:特定のSKUのBLANK_BOX機能を使用できる在庫の取得

このチュートリアルでは、指定したsellerSKUを持ち、機能を使用できる出品者SKUの合計数を取得する方法について説明します。

📘

不適格なsellerSKU

sellerSKUで機能を使用できない場合、レスポンスには空のskuInfoオブジェクトが含まれます。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

ステップ1. 機能を使用できる出品者SKUの数の取得

以下のパラメーターを渡して、getFeatureSKUオペレーションを呼び出します。

パラメーター説明必須
marketplaceId

カウントを返すマーケットプレイス。

タイプ:文字列

はい
featureName

機能の名前。

タイプ:文字列

はい
sellerSku

特定のマーケットプレイスの商品を識別するために使用されます。SellerSKUは、送信するすべてのオペレーションに組み込まれている出品者のSellerIdで修飾されます。

タイプ:文字列

はい

リクエストの例

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

リクエストするマーケットプレイス。

タイプ:文字列

はい

featureName

機能の名前。

タイプ:文字列

はい
isEligible

trueの場合、リクエストした機能を出品者SKUで使用できます。

タイプ:ブール値

はい
ineligibleReasons

出品者SKUで機能を使用できない1つ以上の理由を示すリスト。

指定できる値:

  • MERCHANT_NOT_ENROLLED - 出品者がこの機能に登録されていません。

  • SKU_NOT_ELIGIBLE - SKUが、この機能をサポートする倉庫にありません。
  • INVALID_SKU - 指定されたSKUに問題があります。

タイプ:<文字列>配列

いいえ
skuInfo

SKUについての情報。利用可能な数量、識別子、同じ在庫プールを共有する重複したSKUsのリストなどの情報が含まれます。

タイプ:FeatureSku

いいえ

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

名前説明
errors

getFeatureInventoryオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

チュートリアル:お届け日時と配送時間帯を指定した日本向け注文の作成

このチュートリアルでは、日本での注文作成プロセスと、お届け日時指定配送オプションについて概説します。この配送オプションは、日本のマーケットプレイスでの注文でのみ使用できます。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

ステップ1. お届け日時指定のフルフィルメントプレビューの取得

ShippingSpeedCategories = ScheduledDeliveryおよびIncludeDeliveryWindows = trueの値を指定してgetFulfillmentPreviewオペレーションを呼び出します。

本文パラメーター説明必須
marketplaceId

フルフィルメント注文を行うマーケットプレイス。

タイプ:文字列

いいえ
address

フルフィルメント注文プレビューの配送先住所。

タイプ:Address

はい
items

フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。

タイプ:GetFulfillmentPreviewItemList

はい
shippingSpeedCategories

フルフィルメント注文プレビューの作成に使用する配送方法のリスト。

指定できる値:

  • Standard - 標準の配送方法。
  • Expedited - お急ぎ便の配送方法。
  • Priority - プライオリティ(優先扱い)の配送方法。
  • ScheduledDelivery - お届け日時指定の配送方法(日本のみ)

注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。

いいえ
includeCODFulfillmentPreview

代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。

指定できる値:

true - 代金引換の注文と代金引換以外の注文の両方を含む、すべてのフルフィルメント注文のプレビューを返します。

false - 代金引換以外のフルフィルメント注文のみのプレビューを返します。日本の注文にのみ適用されます。

タイプ:ブール値

いいえ
includeDeliveryWindows

お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。ScheduledDeliveryInfoレスポンスオブジェクトは、ShippingSpeedCategories = ScheduledDeliveryが指定されたフルフィルメント注文プレビューでのみ返すことができます。日本の注文にのみ適用されます。

タイプ:ブール値

いいえ
featureConstraints

注文に適用する機能のリストとそのフルフィルメントポリシー。

タイプ:< FeatureSettings >配列

いいえ

リクエストの例

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

フルフィルメントプレビュー情報の配列。

タイプ:FulfillmentPreviewList

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

名前説明
errors

操作中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

ステップ2. フルフィルメント注文の作成

getFulfillmentPreviewレスポンスから取得した配送時間帯と、ShippingSpeedCategory = ScheduledDeliveryを指定して、createFulfillmentOrderオペレーションを呼び出します。createFulfillmentOrderオペレーションでその他の時間帯を使用すると、サービスによってエラーが返され、getFulfillmentPreviewオペレーションを再実行しなければならなくなります。

📘

配送方法のサービスレベル契約は、マーケットプレイスによって異なります。出品者は以下を参照してください。 セラーセントラル 配送方法のサービスレベル契約およびマルチチャネルフルフィルメント手数料用。

本文パラメーター説明必須
marketplaceId

フルフィルメント注文を行うマーケットプレイス。

タイプ:文字列

いいえ
sellerFulfillmentOrderId

フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。sellerFulfillmentOrderIdは出品者が作成する各フルフィルメント注文で一意であることが必要です。出品者のシステムですでに一意の注文識別子が作成されている場合は、それらの値を使用することができます。

最大長:40

タイプ:文字列

はい
displayableOrderId

出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。DisplayableOrderIdの値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にSellerFulfillmentOrderIdを使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。

この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。

最大長:40

タイプ:文字列

はい
displayableOrderDate

フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。

タイプ:Timestamp

はい
displayableOrderComment

出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。

最大長:250

タイプ:文字列

はい
shippingSpeedCategory

フルフィルメント注文の配送方法。

タイプ:

ShippingSpeedCategory
はい
deliveryWindow

お届け日時指定のフルフィルメント注文を配送する時間範囲。

タイプ: DeliveryWindow

いいえ
destinationAddress

フルフィルメント注文の配送先住所。

タイプ: Address

はい
deliveryPreferences

配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。

タイプ: DeliveryPreferences

いいえ
fulfillmentAction

フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。

タイプ:FulfillmentAction

いいえ
fulfillmentPolicy

FulfillmentPolicyの値(createFulfillmentOrderオペレーションを送信したときに指定した値)。

タイプ:FulfillmentPolicy

いいえ
codSettings

代金引換注文に関連する代金引換手数料。

タイプ:CODSettings

いいえ
shipFromCountryCode

フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。

タイプ:文字列

いいえ
notificationEmails

出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

タイプ:NotificationEmailList

いいえ
featureConstraints

注文に適用する機能のリストとそのフルフィルメントポリシー。

タイプ:< FeatureSettings >配列

いいえ
Items

フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。

タイプ:CreateFulfillmentOrderItemList

はい

リクエストの例

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

createFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

ステップ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

フルフィルメント注文についての一般的な情報(ステータスを含む)。

タイプ:FulfillmentOrder

はい

fulfillmentOrderItems

フルフィルメント注文商品情報の配列。

タイプ:FulfillmentOrderItemList

はい
fulfillmentShipments

フルフィルメント出荷情報の配列。

タイプ:FulfillmentShipmentList

いいえ
returnItems

Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

タイプ:ReturnItemList

はい
returnAuthorizations

返品承認情報の配列。

タイプ:ReturnAuthorizationList

はい

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

名前説明
errors

操作中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

チュートリアル:インド向けMCF注文の作成

このチュートリアルでは、インドのMCF注文作成プロセスの概要を説明します。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

ステップ1. フルフィルメントプレビューの取得

本文パラメーター説明必須
marketplaceId

フルフィルメント注文を行うマーケットプレイス。

タイプ:文字列

いいえ
address

フルフィルメント注文プレビューの配送先住所。

タイプ:Address

はい
items

フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。

タイプ:GetFulfillmentPreviewItemList

はい
shippingSpeedCategories

フルフィルメント注文プレビューの作成に使用する配送方法のリスト。

指定できる値:

  • Standard - 標準の配送方法。

注意: 配送方法のサービスレベル契約はマーケットプレイスによって異なります。インドでサポートされている配送方法は、標準配送方法のみです。出品者は以下を参照してください。 セラーセントラルのウェブサイト マーケットプレイスで、配送方法、サービスレベル契約、およびフルフィルメント手数料について問い合わせています。

いいえ
includeCODFulfillmentPreview

代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。

指定できる値:

true - 代金引換の注文と代金引換以外の注文の両方を含む、すべてのフルフィルメント注文のプレビューを返します。

false - 代金引換以外のフルフィルメント注文のみのプレビューを返します。日本の注文にのみ適用されます。

タイプ:ブール値

いいえ
includeDeliveryWindows

お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。ScheduledDeliveryInfoレスポンスオブジェクトは、ShippingSpeedCategories = ScheduledDeliveryが指定されたフルフィルメント注文プレビューでのみ返すことができます。日本の注文にのみ適用されます。

タイプ:ブール値

いいえ
featureConstraints

注文に適用する機能のリストとそのフルフィルメントポリシー。

タイプ:< FeatureSettings >配列

いいえ

リクエストの例

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

フルフィルメントプレビュー情報の配列。

タイプ:FulfillmentPreviewList

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

名前説明
errors

操作中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

ステップ2. フルフィルメント注文の作成

createFulfillmentOrderオペレーションを呼び出して、注文に必要な機能制約を指定してFBAマルチチャネルサービス注文を作成します。

本文パラメーター説明必須
marketplaceId

フルフィルメント注文を行うマーケットプレイス。

タイプ:文字列

いいえ
sellerFulfillmentOrderId

フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。sellerFulfillmentOrderIdは出品者が作成する各フルフィルメント注文で一意であることが必要です。出品者のシステムですでに一意の注文識別子が作成されている場合は、それらの値を使用することができます。

最大長:40

タイプ:文字列

はい
displayableOrderId

出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。DisplayableOrderIdの値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にSellerFulfillmentOrderIdを使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。

この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。

最大長:40

タイプ:文字列

はい
displayableOrderDate

フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。

タイプ:Timestamp

はい
displayableOrderComment

出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。

最大長:250

タイプ:文字列

はい
shippingSpeedCategory

フルフィルメント注文の配送方法。

タイプ:

ShippingSpeedCategory
はい
deliveryWindow

お届け日時指定のフルフィルメント注文を配送する時間範囲。

タイプ: DeliveryWindow

いいえ
destinationAddress

フルフィルメント注文の配送先住所。

タイプ: Address

はい
deliveryPreferences

配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。

タイプ: DeliveryPreferences

いいえ
fulfillmentAction

フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。

タイプ:FulfillmentAction

いいえ
fulfillmentPolicy

FulfillmentPolicyの値(createFulfillmentOrderオペレーションを送信したときに指定した値)。

タイプ:FulfillmentPolicy

いいえ
codSettings

代金引換注文に関連する代金引換手数料。

タイプ:CODSettings

いいえ
shipFromCountryCode

フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。

タイプ:文字列

いいえ
notificationEmails

出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

タイプ:NotificationEmailList

いいえ
featureConstraints

注文に適用する機能のリストとそのフルフィルメントポリシー。

タイプ:< FeatureSettings >配列

いいえ
items

フルフィルメントオーダープレビューに含める商品のリスト (数量を含む)。品目数は最大100個、1回の注文につき最大250ユニットです。

タイプ:CreateFulfillmentOrderItemList

はい
paymentInformation

フルフィルメントオーダーの支払い情報。

タイプ: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

createFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

ステップ 2b。代金引換オプションを使用してフルフィルメント注文を作成する

に電話してください createFullfillmentOrder 代金引換 (COD) オプション付きの MCF 注文を作成する操作。IN マーケットプレイスでの代金引換注文の場合、IN マーケットプレイスでの金銭的価値はありません。 codSettings (codChargecodChargeTaxshippingChargeshippingChargeTax) を設定する必要があります。注文に含まれるすべての料金は、以下のように表す必要があります。 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 設定する必要があります。 codChargecodChargeTaxshippingCharge、および shippingChargeTax IN マーケットプレイスには設定しないでください。
タイプ: CODSettings
はい
shipFromCountryCodeフルフィルメントオーダーの配送元の国の2文字の国コード。ISO 3166-1 アルファ-2 形式である必要があります。これは国境を越えた配送に必要です。
タイプ: ひも
いいえ
notificationEmailsAmazonが出品者に代わって受取人に出荷完了通知を送信するために使用する、出品者が提供する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

フルフィルメント注文についての一般的な情報(ステータスを含む)。

タイプ:FulfillmentOrder

はい

fulfillmentOrderItems

フルフィルメント注文商品情報の配列。

タイプ:FulfillmentOrderItemList

はい
fulfillmentShipments

フルフィルメント出荷情報の配列。

タイプ:FulfillmentShipmentList

いいえ
returnItems

Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

タイプ:ReturnItemList

はい
returnAuthorizations

返品承認情報の配列。

タイプ:ReturnAuthorizationList

はい

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

名前説明
errors

操作中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

チュートリアル:一部出荷された注文の追跡

このチュートリアルでは、在庫が少ない商品について、一部出荷された注文を追跡する手順を説明します。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

ステップ1. フルフィルメントプレビューの取得

2つの商品を指定してgetFulfillmentPreviewオペレーションを呼び出し、それらの商品が指定した配送オプション(標準、お急ぎ便、プライオリティ)で出荷できることを確認します。

本文パラメーター説明必須
marketplaceId

フルフィルメント注文を行うマーケットプレイス。

タイプ:文字列

いいえ
address

フルフィルメント注文プレビューの配送先住所。

タイプ:Address

はい
items

フルフィルメントオーダープレビュー内の商品の識別情報と数量情報。最大100品目、1回の注文につき最大250ユニット。

タイプ:GetFulfillmentPreviewItemList

はい
shippingSpeedCategories

フルフィルメント注文プレビューの作成に使用する配送方法のリスト。

指定できる値:

  • Standard - 標準の配送方法。
  • Expedited - お急ぎ便の配送方法。
  • Priority - プライオリティ(優先扱い)の配送方法。
  • ScheduledDelivery - お届け日時指定の配送方法(日本のみ)

注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。

いいえ
includeCODFulfillmentPreview

(代金引換 (COD)) 用の出荷注文プレビューを返品するかどうかを指定します。

指定できる値:

  • true - 代金引換の注文と代金引換以外の注文の両方を含む、すべてのフルフィルメント注文のプレビューを返します。
  • false - 代金引換以外のフルフィルメント注文のみのプレビューを返します。

インドでの注文にのみ適用されます。

タイプ:ブール値

いいえ
includeDeliveryWindows

お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。ScheduledDeliveryInfoレスポンスオブジェクトは、ShippingSpeedCategories = ScheduledDeliveryが指定されたフルフィルメント注文プレビューでのみ返すことができます。日本の注文にのみ適用されます。

タイプ:ブール値

いいえ
featureConstraints

注文に適用する機能のリストとそのフルフィルメントポリシー。

タイプ:< FeatureSettings >配列

いいえ

リクエストの例

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

フルフィルメントプレビュー情報の配列。

タイプ:FulfillmentPreviewList

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。もし、 PackageNumber 存在しない場合、404 応答で不適格エラーが表示されます。

名前説明
errors

getFulfillmentPreviewオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

ステップ2. FBAマルチチャネルサービス注文の作成

に電話してください createFulfillmentOrder 一意の注文 ID と少なくとも 2 つの品目、または数量がより大きい品目が 1 つある操作 1 同じ配送オプションの場合。

本文パラメーター説明必須
marketplaceId

フルフィルメント注文を行うマーケットプレイス。

タイプ:文字列

いいえ
sellerFulfillmentOrderId出品者がフルフィルメントオーダーを追跡するために作成するフルフィルメントオーダーID。は

sellerFulfillmentOrderId 出品者が作成するフルフィルメントオーダーごとに一意である必要があります。出品者のシステムですでに固有の注文IDが作成されている場合は、この値を使用するとよいでしょう。

最大長:40

タイプ:文字列

はい
displayableOrderId出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。DisplayableOrderIdの値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にSellerFulfillmentOrderIdを使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。

最大長:40

タイプ:文字列

いいえ
displayableOrderDate

フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。

タイプ: Timestamp

はい
displayableOrderComment

出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。

最大長:250

タイプ:文字列

はい
shippingSpeedCategory

フルフィルメント注文の配送方法。

タイプ:ShippingSpeedCategory

はい
deliveryWindow

お届け日時指定のフルフィルメント注文を配送する時間範囲。

タイプ:DeliveryWindow

いいえ
destinationAddress

フルフィルメント注文の配送先住所。

タイプ: Address

はい
deliveryPreferences

配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。

タイプ: DeliveryPreferences

いいえ
fulfillmentAction

フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。

タイプ:FulfillmentAction

いいえ
fulfillmentPolicy

FulfillmentPolicyの値。createFulfillmentOrderオペレーションを送信したときに指定した値です。

タイプ:FulfillmentPolicy

いいえ
codSettings

代金引換注文に関連する代金引換手数料。

タイプ:CODSettings

いいえ
shipFromCountryCode

フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。

タイプ:文字列

いいえ
notificationEmails

出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

タイプ:NotificationEmailList

いいえ
featureConstraints

注文に適用する機能のリストとそのフルフィルメントポリシー。

タイプ:< FeatureSettings >

いいえ
Items

フルフィルメントオーダープレビューに含める商品のリスト (数量を含む)。品目数は最大100個、1回の注文につき最大250ユニットです。

タイプ:CreateFulfillmentOrderItemList

はい

リクエストの例

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

createFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

ステップ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

フルフィルメント注文についての一般的な情報(ステータスを含む)。

タイプ:FulfillmentOrder

はい
fulfillmentOrderItems

フルフィルメント注文商品情報の配列。

タイプ:FulfillmentOrderItemList

はい
fulfillmentShipments

フルフィルメント出荷情報の配列。

タイプ:FulfillmentShipmentList

いいえ
returnItems

Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

タイプ:ReturnItemList

はい
returnAuthorizations

返品承認情報の配列。

タイプ:ReturnAuthorizationList

はい

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

名前説明必須
errors

getFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

はい

ステップ4. 注文ステータスの変更

注文のステータスは以下から変更されます PlanningProcessingComplete1 つまたは複数の商品の在庫が要求どおりに不足している場合 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

フルフィルメント注文についての一般的な情報(ステータスを含む)。

タイプ:FulfillmentOrder

はい
fulfillmentOrderItems

フルフィルメント注文商品情報の配列。

タイプ:FulfillmentOrderItemList

はい
fulfillmentShipments

フルフィルメント出荷情報の配列。

タイプ:FulfillmentShipmentList

いいえ
returnItems

Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

タイプ:ReturnItemList

はい
returnAuthorizations

返品承認情報の配列。

タイプ:ReturnAuthorizationList

はい

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

名前説明必須
errors

getFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

はい

ステップ6. 注文ステータスおよび商品数量の検証

fulfillmentShipmentStatus = ShippedおよびfulfillmentOrderStatus = CompletePartialledとなっているか検証します。unfulfillableQuantity !=0の商品があれば、その注文は一部のみ出荷された状態となっています。

ステップ7. パッケージ番号の取得

から注文のパッケージ番号をコピーしてください getFulfillmentOrder からの応答 ステップ 5。その注文のAmazon出荷数に基づいて、複数のパッケージ番号が付けられている場合があります。

ステップ8. 追跡詳細情報の取得

getPackageTrackingDetailsオペレーションを、ステップ7のパッケージ番号を使用して呼び出し、パッケージのすべての追跡詳細情報を取得します。

パラメーター説明必須
packageNumber

getFulfillmentOrderオペレーションによって返された、暗号化されていないパッケージ識別子。

タイプ:整数(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

パッケージの出荷日。

タイプ:Timestamp

いいえ
estimatedArrivalDate

到着予定日。

タイプ:Timestamp

いいえ
shipToAddress

パッケージの配送先市区町村。

タイプ:TrackingAddress

いいえ
currentStatus

パッケージの現在の配送ステータス。

タイプ:CurrentStatus

いいえ
currentStatusDescription

CurrentStatusの値に対応する説明。

タイプ:文字列

いいえ
signedForBy

パッケージに署名した人の名前。

タイプ:文字列

いいえ
additionalLocationInfo

場所に関する追加情報。

タイプ:AdditionalLocationInfo

いいえ
trackingEvents

追跡イベント情報の配列。

タイプ:TrackingEventList

いいえ

失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。もし、 PackageNumber 存在しない場合、404 応答で不適格エラーが表示されます。

名前説明
errors

getPackageTrackingDetailsオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

タイプ:ErrorList

チュートリアル:保留ステータスの注文の作成および出荷済みへの移行

このチュートリアルでは、注文のフルフィルメントステータスをどのようにHOLDからSHIPに移行できるかについて説明します。HOLDステータスの注文は、ステータスがSHIPに更新されるまで次のフルフィルメントアクションに進みません。

前提条件

このチュートリアルを完了するには、以下が必要です。

  1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
  2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
  3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

ステップ1. フルフィルメントプレビューの取得

注文に対してgetFulfillmentPreviewオペレーションを呼び出し、SKUが、リクエストした配送オプション(標準、お急ぎ便、プライオリティ)で出荷できることを確認します。

本文パラメーター説明必須
marketplaceId

フルフィルメント注文を行うマーケットプレイス。

タイプ:文字列

いいえ
address

フルフィルメント注文プレビューの配送先住所。

タイプ:Address

はい
items

フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。

タイプ:GetFulfillmentPreviewItemList

はい
shippingSpeedCategories

フルフィルメント注文プレビューの作成に使用する配送方法のリスト。

指定できる値:

  • Standard - 標準の配送方法
  • Expedited - お急ぎ便の配送方法
  • Priority - プライオリティ(優先扱い)の配送方法。
  • ScheduledDelivery - お届け日時指定の配送方法(日本のみ)

注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。

いいえ
includeCODFulfillmentPreview

代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。

指定できる値:

  • true - 代金引換の注文と代金引換以外の注文の両方を含む、すべてのフルフィルメント注文のプレビューを返します。
  • false - 代金引換以外のフルフィルメント注文のみのプレビューを返します。日本の注文にのみ適用されます。

  • タイプ:ブール値

    いいえ
    includeDeliveryWindows

    お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。ScheduledDeliveryInfoレスポンスオブジェクトは、ShippingSpeedCategories = ScheduledDeliveryが指定されたフルフィルメント注文プレビューでのみ返すことができます。日本の注文にのみ適用されます。

    タイプ:ブール値

    いいえ
    featureConstraints

    注文に適用する機能のリストとそのフルフィルメントポリシー。

    タイプ:< FeatureSettings >配列

    いいえ

    リクエストの例

    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

    フルフィルメントプレビュー情報の配列。

    タイプ:FulfillmentPreviewList

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。404 レスポンスには、不適格エラーがあればそれが表示されます。

    名前説明必須
    errors

    getFulfillmentPreviewオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    ステップ2. 保留ステータスのフルフィルメント注文の作成

    リクエストにfulfillmentAction=Holdの商品を1つ以上指定して、createFulfillmentOrderオペレーションを呼び出します。これにより、注文のステータスがHoldに維持され、このステータスの間はその注文に対して次のフルフィルメントアクションが実行されません。

    本文パラメーター説明必須
    marketplaceId

    フルフィルメント注文を行うマーケットプレイス。

    タイプ:文字列

    いいえ
    sellerFulfillmentOrderId

    フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。sellerFulfillmentOrderIdは出品者が作成する各フルフィルメント注文で一意であることが必要です。出品者のシステムですでに一意の注文識別子が作成されている場合は、それらの値を使用することができます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderId

    出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。DisplayableOrderIdの値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にSellerFulfillmentOrderIdを使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderDate

    フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。

    タイプ: Timestamp

    はい
    displayableOrderComment

    出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。

    最大長:250

    タイプ:文字列

    はい
    shippingSpeedCategory

    フルフィルメント注文の配送方法。

    タイプ:ShippingSpeedCategory

    はい
    deliveryWindow

    お届け日時指定のフルフィルメント注文を配送する時間範囲。

    タイプ:DeliveryWindow

    いいえ
    destinationAddress

    フルフィルメント注文の配送先住所。

    タイプ:Address

    はい
    deliveryPreferences

    配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。

    タイプ: DeliveryPreferences

    いいえ
    fulfillmentAction

    フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。

    タイプ:FulfillmentAction

    いいえ
    fulfillmentPolicy

    createFulfillmentOrderオペレーションを送信したときに指定した「FulfillmentPolicy」の値。

    タイプ:FulfillmentPolicy

    いいえ
    codSettings

    代金引換注文に関連する代金引換手数料。

    タイプ:CODSettings

    いいえ
    shipFromCountryCode

    フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。

    タイプ:文字列

    いいえ
    notificationEmails

    出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

    タイプ:NotificationEmailList

    いいえ
    featureConstraints

    注文に適用する機能のリストとそのフルフィルメントポリシー。

    タイプ:< FeatureSettings >配列

    いいえ
    Items

    フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。

    タイプ: CreateFulfillmentOrderItemList

    はい

    リクエストの例

    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

    createFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    ステップ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

    UpdateFulfillmentOrderResponseオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    ステップ4. フルフィルメント注文を取得して変更を検証

    注文が正常に更新されたら、getFulfillmentOrderオペレーションを呼び出して、fulfillmentActionShipに更新されているか検証します。注文が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

    フルフィルメント注文についての一般的な情報(ステータスを含む)。

    タイプ:FulfillmentOrder

    はい
    fulfillmentOrderItems

    フルフィルメント注文商品情報の配列。

    タイプ:FulfillmentOrderItemList

    はい
    fulfillmentShipments

    フルフィルメント出荷情報の配列。

    タイプ:FulfillmentShipmentList

    いいえ
    returnItems

    Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

    タイプ:ReturnItemList

    はい
    returnAuthorizations

    返品承認情報の配列。

    タイプ:ReturnAuthorizationList

    はい

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

    名前説明必須
    errors

    getFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    チュートリアル:商品のシリアル番号を使用した注文の追跡

    一部の商品では、具体的にどの商品が特定の購入者に販売されたかを把握することが必要な場合があります。商品を追跡するための一意のシリアル番号が設定されていれば、フルフィルメントセンターは、出荷および返品される商品に対してシリアル番号をスキャンして記録するステップを追加することができます。

    商品が出荷された後、getFulfillmentOrderオペレーションを呼び出すと、レスポンスにシリアル番号が返されるので、出品者はこの番号を記録しておくことができます。

    前提条件

    1. 出品者は、生成されるシリアル番号の正規表現をAmazonと共有する必要があります。
    2. 出品者は、Amazonに在庫を納品するときに、生成された一意のシリアル番号をすべての商品に貼付する必要があります。
    3. 購入者がAmazonラベル貼付サービスを使用している場合、ASINの登録に加えて、商品に関連付けられているFNSKUも同じプロセスを使用して登録する必要があります。
    4. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    5. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    6. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

    ステップ1. シリアル番号が割り振られた商品のフルフィルメント注文の作成

    createFulfillmentOrderオペレーションを呼び出して、Amazonへの納品時にシリアル番号が有効になる商品を含むFBAマルチチャネルサービス注文を作成します。
    この種類の注文では、createFulfillmentOrderリクエストで専用の属性は必要ありません。

    本文パラメーター説明必須
    marketplaceId

    フルフィルメント注文を行うマーケットプレイス。

    タイプ:文字列

    いいえ
    sellerFulfillmentOrderId

    フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。sellerFulfillmentOrderIdは出品者が作成する各フルフィルメント注文で一意であることが必要です。出品者のシステムですでに一意の注文識別子が作成されている場合は、それらの値を使用することができます。

    最大長: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の値(createFulfillmentOrderオペレーションを送信したときに指定した値)。

    タイプ:FulfillmentPolicy

    いいえ
    codSettings

    代金引換注文に関連する代金引換 (COD) 料金。

    タイプ:CODSettings

    いいえ
    shipFromCountryCode

    フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。

    タイプ:文字列

    いいえ
    notificationEmails

    出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

    タイプ:NotificationEmailList

    いいえ
    featureConstraints

    注文に適用する機能のリストとそのフルフィルメントポリシー。

    タイプ:< FeatureSettings >配列

    いいえ
    アイテム

    フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。

    タイプ:CreateFulfillmentOrderItemList

    はい

    リクエストの例

    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

    createFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    ステップ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

    フルフィルメント注文についての一般的な情報(ステータスを含む)。

    タイプ:FulfillmentOrder

    はい
    fulfillmentOrderItems

    フルフィルメント注文商品情報の配列。

    タイプ:FulfillmentOrderItemList

    はい
    fulfillmentShipments

    フルフィルメント出荷情報の配列。

    タイプ:FulfillmentShipmentList

    いいえ
    returnItems

    Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

    タイプ:ReturnItemList

    はい
    returnAuthorizations

    返品承認情報の配列。

    タイプ:ReturnAuthorizationList

    はい

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

    名前説明必須
    errors

    getFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    ステップ3. フルフィルメント注文を取得してステータスの変更を追跡

    注文のステータスが、PlanningからProcessingCompleteへと変更されます。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

    フルフィルメント注文についての一般的な情報(ステータスを含む)。

    タイプ:FulfillmentOrder

    はい
    fulfillmentOrderItems

    フルフィルメント注文商品情報の配列。

    タイプ:FulfillmentOrderItemList

    はい
    fulfillmentShipments

    フルフィルメント出荷情報の配列。

    タイプ:FulfillmentShipmentList

    いいえ
    returnItems

    Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

    タイプ:ReturnItemList

    はい
    returnAuthorizations

    返品承認情報の配列。

    タイプ:ReturnAuthorizationList

    はい

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

    名前説明必須
    errors

    getFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    ステップ4. 注文ステータスおよび商品数量の検証

    fulfillmentShipmentStatus=Shippedとなっているか、およびserialNumberfulfillmentShipmentItem内)が、納品プロセスで生成された番号と同じであるかを検証します。

    チュートリアル:クロスボーダーフルフィルメントの注文の作成

    このチュートリアルでは、2つの異なる国で事業を運営して商品を販売する出品者が、国境を越えて注文を出荷する方法の概要を説明します。このオペレーションは、本、ビデオ、メディア、ディスク商品にのみ適用されます。

    この例では、出品者はカナダ(CA)の倉庫から米国の住所に対して注文を出荷します。

    前提条件

    このチュートリアルを完了するには、以下が必要です。

    1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

    ステップ1. クロスボーダーの配送を行うフルフィルメント注文の作成

    米国の配送先住所とshipFromCountryCode=CAを指定して、注文を作成します。この場合、リクエストでのmarketplaceIdの指定はスキップすることができ、商品はCAマーケットプレイスでピッキングされます。また、申告額が0よりも大きい商品に対しては、perUnitDeclaredValueを含めます。createFulfillmentOrderオペレーションを呼び出して、以下の必要な本文パラメーターを渡します。

    本文パラメーター説明必須
    marketplaceIdフルフィルメント注文を行うマーケットプレイス。いいえ
    sellerFulfillmentOrderId

    フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。sellerFulfillmentOrderIdは出品者が作成する各フルフィルメント注文で一意であることが必要です。出品者のシステムですでに一意の注文識別子が作成されている場合は、それらの値を使用することができます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderId

    出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。DisplayableOrderIdの値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にSellerFulfillmentOrderIdを使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderDate

    フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。

    タイプ:Timestamp

    はい
    displayableOrderComment

    出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。

    最大長:250

    タイプ:文字列

    はい
    shippingSpeedCategory

    フルフィルメント注文の配送方法。

    タイプ:ShippingSpeedCategory

    はい
    deliveryWindow

    お届け日時指定のフルフィルメント注文を配送する時間範囲。

    タイプ:DeliveryWindow

    いいえ
    destinationAddress

    フルフィルメント注文の配送先住所。

    タイプ:Address

    はい
    deliveryPreferences

    配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。

    タイプ: DeliveryPreferences

    いいえ
    fulfillmentAction

    フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。

    タイプ:FulfillmentAction

    いいえ
    fulfillmentPolicy

    FulfillmentPolicyの値(createFulfillmentOrderオペレーションを送信したときに指定した値)。

    タイプ:FulfillmentPolicy

    いいえ
    codSettings

    代金引換注文に関連する代金引換 (COD) 料金。

    タイプ:CODSettings

    いいえ
    shipFromCountryCode

    フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。

    タイプ:文字列

    いいえ
    notificationEmails

    出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

    タイプ:NotificationEmailList

    いいえ
    featureConstraints

    注文に適用する機能のリストとそのフルフィルメントポリシー。

    タイプ:< FeatureSettings >配列

    いいえ
    Items

    フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。

    タイプ:CreateFulfillmentOrderItemList

    はい

    リクエストの例

    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

    createFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    チュートリアル:BLANK_BOXおよびBLOCK_AMZL機能をリクエストした注文の作成

    FBAマルチチャネルサービスでは、注文作成時のリクエストに2種類の機能を指定することができます。

    • 空白の箱:Amazonのロゴ/ラベルが付いていない箱を出品者が選択できるようにします。

    • AMZLをブロック:出品者がAmazonのロジスティクスを拒否し、代わりに別の配送業者のサービスを利用して出荷できるようにします。

    注文作成プロセスでリクエストを行った後、注文のフルフィルメントステップでこの設定を更新することはできません。

    前提条件

    このチュートリアルを完了するには、以下が必要です。

    1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

    ステップ1. 特定の機能制約におけるフルフィルメントのプレビューの取得

    特定の配送オプションと機能制約を使用して、注文商品に対してgetFulfillmentPreviewオペレーションを呼び出し、該当するマーケットプレイスおよび住所における注文の出荷でその機能を利用できることを確認します。

    getFulfillmentPreviewオペレーションを呼び出して、以下の本文パラメーターを渡します。

    本文パラメーター説明必須
    marketplaceId

    フルフィルメント注文を行うマーケットプレイス。

    タイプ:文字列

    いいえ
    address

    フルフィルメント注文プレビューの配送先住所。

    タイプ:Address

    はい
    items

    フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。

    タイプ:GetFulfillmentPreviewItemList

    はい
    shippingSpeedCategories

    フルフィルメント注文プレビューの作成に使用する配送方法のリスト。

    指定できる値:

    • Standard - 標準の配送方法。
    • Expedited - お急ぎ便の配送方法。
    • Priority - プライオリティ(優先扱い)の配送方法。
    • ScheduledDelivery - お届け日時指定の配送方法(日本のみ)

    注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。

    いいえ
    includeCODFulfillmentPreview

    代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。

    指定できる値:

    • true - 代金引換の注文と代金引換以外の注文の両方を含む、すべてのフルフィルメント注文のプレビューを返します。
    • false - 代金引換以外のフルフィルメント注文のみのプレビューを返します。日本の注文にのみ適用されます。

    タイプ:ブール値

    いいえ
    includeDeliveryWindows

    お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。ScheduledDeliveryInfoレスポンスオブジェクトは、ShippingSpeedCategories = ScheduledDeliveryが指定されたフルフィルメント注文プレビューでのみ返すことができます。日本の注文にのみ適用されます。

    タイプ:ブール値

    いいえ
    featureConstraints

    注文に適用する機能のリストとそのフルフィルメントポリシー。

    タイプ:< FeatureSettings >配列

    いいえ

    リクエストの例

    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

    フルフィルメントプレビュー情報の配列。

    タイプ:FulfillmentPreviewList

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。404 レスポンスには、不適格エラーがあればそれが表示されます。

    名前説明必須
    errors

    getFulfillmentPreviewオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    ステップ2. 機能制約を指定してフルフィルメント注文を作成

    createFulfillmentOrderオペレーションを呼び出して、注文に必要な機能制約を指定してFBAマルチチャネルサービス注文を作成します。

    📘

    機能制約:

    機能制約は、セラーセントラルポータルで有効にすることができます。有効にした制約はデフォルト値として使用されますが、注文リクエストに指定した値が優先されます。

    本文パラメーター説明必須
    marketplaceId

    フルフィルメント注文を行うマーケットプレイス。

    タイプ:文字列

    いいえ
    sellerFulfillmentOrderId

    フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。sellerFulfillmentOrderIdは出品者が作成する各フルフィルメント注文で一意であることが必要です。出品者のシステムですでに一意の注文識別子が作成されている場合は、それらの値を使用することができます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderId

    出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。「DisplayableOrderId」の値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にSellerFulfillmentOrderIdを使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderDate

    フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。

    タイプ:Timestamp

    はい
    displayableOrderComment

    出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。

    最大長:250

    タイプ:文字列

    はい
    shippingSpeedCategory

    フルフィルメント注文の配送方法。タイプ:ShippingSpeedCategory

    はい
    deliveryWindow

    お届け日時指定のフルフィルメント注文を配送する時間範囲。

    タイプ:DeliveryWindow

    いいえ
    destinationAddress

    フルフィルメント注文の配送先住所。タイプ:Address

    はい
    deliveryPreferences

    配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。

    タイプ: DeliveryPreferences

    いいえ
    fulfillmentAction

    フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。

    タイプ:FulfillmentAction

    いいえ
    fulfillmentPolicy

    FulfillmentPolicyの値(createFulfillmentOrderオペレーションを送信したときに指定した値)。

    タイプ:FulfillmentPolicy

    いいえ
    codSettings

    代金引換注文に関連する代金引換手数料。

    タイプ:CODSettings

    いいえ
    shipFromCountryCode

    フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。

    タイプ:文字列

    いいえ
    notificationEmails

    出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

    タイプ:NotificationEmailList

    いいえ
    featureConstraints

    注文に適用する機能のリストとそのフルフィルメントポリシー。

    タイプ:< FeatureSettings >配列

    いいえ
    Items

    フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。

    タイプ:CreateFulfillmentOrderItemList

    はい

    リクエストの例

    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

    createFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    ステップ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

    フルフィルメント注文についての一般的な情報(ステータスを含む)。

    タイプ:FulfillmentOrder

    はい
    fulfillmentOrderItems

    フルフィルメント注文商品情報の配列。

    タイプ:FulfillmentOrderItemList

    はい
    fulfillmentShipments

    フルフィルメント出荷情報の配列。

    タイプ:FulfillmentShipmentList

    いいえ
    returnItems

    Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

    タイプ:ReturnItemList

    はい
    returnAuthorizations

    返品承認情報の配列。

    タイプ:ReturnAuthorizationList

    はい

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

    名前説明必須
    errors

    getFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    チュートリアル:すべての配送スピードの詳細プレビューの表示

    リクエストに配送スピードについて指定せずにgetFulfillmentPreviewオペレーションを呼び出すと、レスポンスにすべての配送スピードの詳細プレビューが表示されます。

    前提条件

    このチュートリアルを完了するには、以下が必要です。

    1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

    ステップ1. すべての配送スピードのフルフィルメントプレビューの取得

    リクエストでshippingCategories属性の指定を省略すると、すべての配送スピードについて注文の詳細プレビューを取得できます。

    getFulfillmentPreviewオペレーションを呼び出して、以下の本文パラメーターを渡します。

    本文パラメーター説明必須
    marketplaceId

    フルフィルメント注文を行うマーケットプレイス。

    タイプ:文字列

    いいえ
    address

    フルフィルメント注文プレビューの配送先住所。

    タイプ:Address

    はい
    items

    フルフィルメント注文プレビュー内の商品を識別する情報と数量の情報。

    タイプ:GetFulfillmentPreviewItemList

    はい
    shippingSpeedCategories

    フルフィルメント注文プレビューの作成に使用する配送方法のリスト。

    指定できる値:

    • Standard - 標準の配送方法。
    • Expedited - お急ぎ便の配送方法。
    • Priority - プライオリティ(優先扱い)の配送方法。
    • ScheduledDelivery - お届け日時指定の配送方法(日本のみ)。

    注:配送方法のサービスレベルアグリーメントは、マーケットプレイスごとに異なります。出品者は、配送方法のサービスレベルアグリーメントおよびFBA手数料について、各マーケットプレイスのセラーセントラルウェブサイトを確認する必要があります。

    いいえ
    includeCODFulfillmentPreview

    代金引換 (COD) 用の出荷注文プレビューを返品するかどうかを指定します。

    指定できる値:

    • true - 代金引換の注文と代金引換以外の注文の両方を含む、すべてのフルフィルメント注文のプレビューを返します。
    • false - 代金引換以外のフルフィルメント注文のみのプレビューを返します。日本の注文にのみ適用されます。

    タイプ:ブール値

    いいえ
    includeDeliveryWindows

    お届け日時指定配送で利用できる配送時間帯を含むScheduledDeliveryInfoレスポンスオブジェクトを返すかどうかを指定します。ScheduledDeliveryInfoレスポンスオブジェクトは、ShippingSpeedCategories = ScheduledDeliveryが指定されたフルフィルメント注文プレビューでのみ返すことができます。日本の注文にのみ適用されます。

    タイプ:ブール値

    いいえ
    featureConstraints

    注文に適用する機能のリストとそのフルフィルメントポリシー。

    タイプ:< FeatureSettings >

    いいえ

    リクエストの例

    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

    フルフィルメントプレビュー情報の配列。

    タイプ:FulfillmentPreviewList

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。404 レスポンスには、不適格エラーがあればそれが表示されます。

    名前説明必須
    errors

    getFulfillmentPreviewオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    チュートリアル:通知APIを使用した注文通知の表示

    出品者は、FULFILLMENT_ORDER_STATUS通知に登録することで、注文で発生するすべての変更を把握することができます。

    このチュートリアルを完了するには、以下が必要です。

    1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

    ステップ1. 通知の作成と登録

    通知APIを参照して登録を作成および管理します。

    ステップ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の値:

    • Order - この通知には、フルフィルメント注文についての情報が含まれています。
    • 出荷-この通知には、フルフィルメント出荷に関する情報が含まれています。詳細については、「」を参照してください。 FulfillmentShipment オブジェクト。
    • Return - この通知には、フルフィルメント返品についての情報が含まれています。

    タイプ:文字列

    はい
    SellerId

    出品者の識別子。

    タイプ:文字列

    いいえ
    StatusUpdatedDateTime

    ステータスが最後に更新された日付と時刻。で ISO 8601 フォーマット。

    タイプ:文字列

    はい
    SellerFulfillmentOrderId

    CreateFulfillmentOrderオペレーションを使用して作成および送信したフルフィルメント注文識別子。

    タイプ:文字列

    はい
    FulfillmentOrderStatus

    フルフィルメント注文の現在のステータス。

    FulfillmentOrderStatusの値:

    • Received - フルフィルメント注文が受領および検証されました。検証では、配送先住所が有効であるかや、Amazonのレコードが出品者に注文を出荷するだけの十分な販売可能(破損していない)在庫があることを示しているかなどが判断されます。出品者は、ステータスがReceivedのフルフィルメント注文をキャンセルできます。
    • Invalid - フルフィルメント注文が受領されましたが、検証に失敗しました。検証に失敗する理由としては、配送先住所が無効である、Amazonのレコードが出品者に注文を出荷するだけの十分な販売可能在庫がないことをしめしているなどが考えられます。検証に失敗した場合、フルフィルメント注文は無効であり、注文に含まれる商品は出荷されません。
    • Planning - フルフィルメント注文がAmazonのフルフィルメントネットワークに送信されて、出荷の計画が開始されましたが、出荷されるユニットは在庫からまだピッキングされていません。出品者は、ステータスがPlanningのフルフィルメント注文をキャンセルできます。
    • Processing - フルフィルメント注文の少なくとも1件の出荷について、在庫からユニットをピッキングするプロセスが開始されました。出品者は、ステータスがProcessingのフルフィルメント注文をキャンセルすることはできません。
    • Cancelled - フルフィルメント注文が出品者によってキャンセルされました。
    • Complete - フルフィルメント注文に含まれる商品のすべての数量が出荷されました。
    • CompletePartialled - フルフィルメント注文に含まれる商品の一部の数量が出荷されました。残りの数量は、キャンセルされたか、または販売不可です。
    • Unfulfillable - Amazonフルフィルメントセンターの従業員が、商品の在庫がないこと、または販売可能な(破損していない)状態の在庫がないことを確認したため、フルフィルメント注文に含まれる商品をまったく出荷できませんでした。

    タイプ:文字列

    はい
    FulfillmentShipment

    フルフィルメント注文の出荷に関する配送および商品情報。

    タイプ:FulfillmentShipment

    いいえ
    FulfillmentReturnItem

    Amazonフルフィルメントセンターに返品された商品に関する情報。

    タイプ:FulfillmentReturnItem

    いいえ

    チュートリアル:FBAマルチチャネルサービス注文の返品の作成

    FBAマルチチャネルサービス注文の返品は、返品理由コードの取得、いずれかのコードを使用した返品の送信、実際の商品の返品という3つのステップで構成されます。現在、FBAマルチチャネルサービスでは、共有される返品ラベルはプリペイドではないため、最終顧客が送料を支払う必要があります。

    前提条件

    このチュートリアルを完了するには、以下が必要です。

    1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

    ステップ1. 特定の商品の返品理由コードのリストの取得

    以下のパラメーターを渡して、listReturnReasonCodesオペレーションを呼び出します。

    パラメーター説明必須
    sellerSKU

    返品理由コードが必要な出品者SKU。

    タイプ:文字列

    はい
    marketplaceId

    出品者が返品理由コードを希望するマーケットプレイス。

    タイプ:文字列

    いいえ
    sellerFulfillmentOrderId

    フルフィルメント注文作成時に出品者が商品に割り当てた識別子。サービスはこの値を使用して、出品者が返品理由コードを希望するマーケットプレイスを判断します。

    タイプ:文字列

    いいえ
    language

    TranslatedDescriptionプロパティ(ReasonCodeDetailsレスポンスオブジェクト)の翻訳の翻訳先言語。

    タイプ:文字列

    はい

    リクエストの例

    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

    説明の翻訳。Languageリクエストパラメーターに指定された言語に翻訳されます。

    タイプ:文字列

    いいえ

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

    名前説明
    errors

    listReturnReasonCodesオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    ステップ2. 注文のフルフィルメント返品の作成

    上記ステップで取得したいずれかの理由を使用して、createFulfillmentReturnオペレーションを呼び出し、返品リクエストを送信して、Amazonに商品を返品するために必要な返品用ラベルを取得します。

    📘

    プリペイドラベルではありません

    このラベルは前払いではありません。配送業者が支払う必要があります。

    パラメーター説明必須
    sellerFulfillmentOrderId

    フルフィルメント注文を作成したときに出品者が割り当てた識別子。出品者は、自身のレコードを使用して、購入者の返品リクエストに基づき適切な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が返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

    タイプ:< ReturnItem >配列

    はい
    InvalidReturnItemList

    無効な返品商品の情報の配列。

    タイプ:< InvalidReturnItem >配列

    はい
    ReturnAuthorizationList

    返品承認情報の配列。

    タイプ:< ReturnAuthorization >配列

    はい
    名前説明
    errors

    操作中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。404 レスポンスには、不適格エラーがあればそれが表示されます。

    名前説明必須
    errors

    createFulfillmentReturnオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    ステップ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

    フルフィルメント注文についての一般的な情報(ステータスを含む)。

    タイプ:FulfillmentOrder

    はい
    fulfillmentOrderItems

    フルフィルメント注文商品情報の配列。

    タイプ:FulfillmentOrderItemList

    はい
    fulfillmentShipments

    フルフィルメント出荷情報の配列。

    タイプ:FulfillmentShipmentList

    いいえ
    returnItems

    Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

    タイプ:ReturnItemList

    はい
    returnAuthorizations

    返品承認情報の配列。

    タイプ:ReturnAuthorizationList

    はい

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

    名前説明必須
    errors

    getFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    チュートリアル:ダイナミックデリバリーオファーの取得

    このチュートリアルでは、米国の郵便番号または米国のIPアドレスを使用して購入可能な商品の動的配送オファーを取得する方法の概要を説明します。

    前提条件

    このチュートリアルを完了するには、以下が必要です。

    1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

    ステップ 1:ダイナミックデリバリーオファーを利用する

    に電話してください deliveryOffers 指定した商品と位置情報について、標準的なクリックから配信までのスピードで動的な配信オファーを取得する操作。

    ボディのパラメーター説明必須
    product

    デリバリーオファーの商品詳細。

    タイプ:getDeliveryOffersProduct

    はい
    terms

    デリバリーオファーの条件。

    タイプ:getDeliveryOffersTerms

    はい

    リクエストの例

    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

    deliveryOffersオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    チュートリアル:配送設定を指定して日本の注文を作成する

    このチュートリアルでは、日本での注文作成プロセスと配送設定の概要を説明します。この機能は日本のマーケットプレイスの注文でのみ使用できます。

    前提条件

    このチュートリアルを完了するには、以下が必要です。

    1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

    ステップ 1:配送設定を指定してフルフィルメントオーダーを作成します。

    createFulfillmentOrderオペレーションを呼び出して、注文に必要な機能制約を指定してFBAマルチチャネルサービス注文を作成します。

    本文パラメーター説明必須
    marketplaceId

    フルフィルメント注文を行うマーケットプレイス。

    タイプ:文字列

    いいえ
    sellerFulfillmentOrderId

    フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。sellerFulfillmentOrderIdは出品者が作成する各フルフィルメント注文で一意であることが必要です。出品者のシステムですでに一意の注文識別子が作成されている場合は、それらの値を使用することができます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderId

    出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。DisplayableOrderIdの値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にSellerFulfillmentOrderIdを使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。

    この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderDate

    フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。

    タイプ:Timestamp

    はい
    displayableOrderComment

    出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。

    最大長:250

    タイプ:文字列

    はい
    shippingSpeedCategory

    フルフィルメント注文の配送方法。

    タイプ:

    ShippingSpeedCategory
    はい
    deliveryWindow

    お届け日時指定のフルフィルメント注文を配送する時間範囲。

    タイプ: DeliveryWindow

    いいえ
    destinationAddress

    フルフィルメント注文の配送先住所。

    タイプ: Address

    はい
    deliveryPreferences

    配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。

    タイプ: DeliveryPreferences

    いいえ
    fulfillmentAction

    フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。

    タイプ:FulfillmentAction

    いいえ
    fulfillmentPolicy

    FulfillmentPolicyの値(createFulfillmentOrderオペレーションを送信したときに指定した値)。

    タイプ:FulfillmentPolicy

    いいえ
    codSettings

    代金引換注文に関連する代金引換 (COD) 料金。

    タイプ:CODSettings

    いいえ
    shipFromCountryCode

    フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。

    タイプ:文字列

    いいえ
    notificationEmails

    出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

    タイプ:NotificationEmailList

    いいえ
    featureConstraints

    注文に適用する機能のリストとそのフルフィルメントポリシー。

    タイプ:< FeatureSettings >配列

    いいえ
    Items

    フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。

    タイプ:CreateFulfillmentOrderItemList

    はい

    リクエストの例

    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

    createFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    チュートリアル:配送設定に近隣地域の情報を入力して日本の注文を作成する

    このチュートリアルでは、配送先住所に受取人がいない場合に指定の隣人に配達優先を設定する日本での注文作成プロセスの概要を説明します。この機能は日本のマーケットプレイスでの注文でのみ利用できます。

    前提条件

    このチュートリアルを完了するには、以下が必要です。

    1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    3. アプリケーションのアプリ登録ページでのAmazonから発送ロールの選択。

    ステップ 1:配送設定を指定してフルフィルメントオーダーを作成します。

    createFulfillmentOrderオペレーションを呼び出して、注文に必要な機能制約を指定してFBAマルチチャネルサービス注文を作成します。

    本文パラメーター説明必須
    marketplaceId

    フルフィルメント注文を行うマーケットプレイス。

    タイプ:文字列

    いいえ
    sellerFulfillmentOrderId

    フルフィルメント注文を追跡するために出品者が作成するフルフィルメント注文識別子。sellerFulfillmentOrderIdは出品者が作成する各フルフィルメント注文で一意であることが必要です。出品者のシステムですでに一意の注文識別子が作成されている場合は、それらの値を使用することができます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderId

    出品者が作成するフルフィルメント注文識別子。この値は、出荷納品書などの、受取人向けドキュメントに注文識別子として記載されます。DisplayableOrderIdの値は、出品者が受取人に対して提示する注文識別子と同じものであることが必要です。出品者は、この値にSellerFulfillmentOrderIdを使用することも、受取人に対して別の注文識別子を参照してもらいたい場合は別の値を指定することもできます。

    この値は、1~40文字の英数字またはISO 8859-1準拠の文字列であることが必要です。連続して2つの空白文字を含めることはできません。先頭および末尾の空白文字は削除されます。

    最大長:40

    タイプ:文字列

    はい
    displayableOrderDate

    フルフィルメント注文の日時。出荷納品書などの受取人向けドキュメントに注文日として記載されます。

    タイプ:Timestamp

    はい
    displayableOrderComment

    出荷納品書などの受取人向けドキュメントに記載される、注文固有のテキスト。

    最大長:250

    タイプ:文字列

    はい
    shippingSpeedCategory

    フルフィルメント注文の配送方法。

    タイプ:

    ShippingSpeedCategory
    はい
    deliveryWindow

    お届け日時指定のフルフィルメント注文を配送する時間範囲。

    タイプ: DeliveryWindow

    いいえ
    destinationAddress

    フルフィルメント注文の配送先住所。

    タイプ: Address

    はい
    deliveryPreferences

    配送先住所に適用される配送設定。これらの設定は可能な限り適用され、最善の努力が必要です。対象となる注文の場合、デフォルトでは荷物を玄関先に置いておくことが優先されます。この機能は現在JPマーケットプレイスでのみサポートされており、他のマーケットプレイスには適用されません。

    タイプ: DeliveryPreferences

    いいえ
    fulfillmentAction

    フルフィルメント注文を今すぐ出荷するか、注文を保留するかを指定します。

    タイプ:FulfillmentAction

    いいえ
    fulfillmentPolicy

    FulfillmentPolicyの値(createFulfillmentOrderオペレーションを送信したときに指定した値)。

    タイプ:FulfillmentPolicy

    いいえ
    codSettings

    代金引換注文に関連する代金引換 (COD) 料金。

    タイプ:CODSettings

    いいえ
    shipFromCountryCode

    フルフィルメント注文の出荷元の国を表す2文字の国コード。ISO 3166-1 alpha-2形式であることが必要です。国境を越えた配送では必須です。

    タイプ:文字列

    いいえ
    notificationEmails

    出品者が提供するメールアドレスのリスト。Amazonが出荷完了通知を出品者に代わって受取人に送信する際に使用します。

    タイプ:NotificationEmailList

    いいえ
    featureConstraints

    注文に適用する機能のリストとそのフルフィルメントポリシー。

    タイプ:< FeatureSettings >配列

    いいえ
    Items

    フルフィルメント注文のプレビューに含める商品のリスト(数量を含む)。

    タイプ:CreateFulfillmentOrderItemList

    はい

    リクエストの例

    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

    createFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    チュートリアル:日本に配送された荷物のロッカー (宅配ボックス) 情報を取得する

    このチュートリアルでは、マルチチャネルフルフィルメント注文のアウトバウンド出荷で日本のロッカー (宅配ボックス) に配送された荷物のロッカー情報を取得する方法を説明します。

    ザの getFulfillmentOrder API が常に戻るとは限らない lockerDetails、配送状況と配送場所によって異なります。

    を使う getPackageTrackingDetails 配送状況を確認し、荷物がロッカー (宅配ボックス) に配送されたかどうかを確認する API。

    前提条件

    このチュートリアルを完了するには、以下が必要です。

    1. 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
    2. 開発者プロフィールへのAmazonから発送ロールの割り当て。
    3. アプリケーションのアプリ登録ページでの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

    フルフィルメント注文についての一般的な情報(ステータスを含む)。

    タイプ:FulfillmentOrder

    はい
    fulfillmentOrderItems

    フルフィルメント注文商品情報の配列。

    タイプ:FulfillmentOrderItemList

    はい
    fulfillmentShipments

    フルフィルメント出荷情報の配列。

    タイプ:FulfillmentShipmentList

    いいえ
    returnItems

    Amazonが返品を受け付けた商品の配列。返品を受け付けた商品がない場合は、空の配列が返されます。

    タイプ:ReturnItemList

    はい
    returnAuthorizations

    返品承認情報の配列。

    タイプ:ReturnAuthorizationList

    はい

    失敗したレスポンスには、2xx 以外のコードが含まれ、次のオブジェクトが含まれます。

    名前説明必須
    errors

    getFulfillmentOrderオペレーションの実行中に1つ以上の予期しないエラーが発生しました。

    タイプ:ErrorList

    はい

    このページは役に立ちましたか?