Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS ドキュメント

アウトバウンドのデータタイプ

AmazonマーケットプレイスWebサービス(Amazon MWS)フルフィルメント出荷APIセクションのリクエストパラメーターおよびレスポンス要素では、以下のデータタイプが使用されます。

データタイプ 説明
Address お届け先住所情報。
CODSettings 代金引換の出荷注文にかかる代金引換手数料。代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。
CreateFulfillmentOrderItem 出荷注文を作成するための商品情報。
Currency 通貨のタイプと金額。
DeliveryWindow お届け日時指定便の出荷注文が配達される時間の範囲。
Fee 手数料のタイプと金額。
FulfillmentOrder ステータスを含む出荷注文の一般情報。
FulfillmentOrderItem 出荷注文の商品情報。
FulfillmentPreview 配送スピードに基づく配送と手数料の情報を含む、出荷注文予測の情報。
FulfillmentPreviewItem 出荷注文予測に含まれる出荷の商品情報。
FulfillmentPreviewShipment 出荷注文予測に含まれる出荷の配送および商品情報。
FulfillmentShipment 出荷注文に含まれる出荷の配送および商品情報。
FulfillmentShipmentItem 出荷注文に含まれる出荷の商品情報。
FulfillmentShipmentPackage 出荷注文に含まれる出荷の梱包情報。
GetFulfillmentPreviewItem 出荷注文予測の商品情報。
ScheduledDeliveryInfo お届け日時指定便の配送情報。
TrackingAddress 荷物の追跡に使用する住所情報。
TrackingEvent 荷物の受け取りの追跡に使用する情報。
UnfulfillablePreviewItem 出荷注文予測に含まれる出荷不可能な商品の情報。
UpdateFulfillmentOrderItem 出荷注文を更新する際に使用する商品情報。
Weight 重量の単位と数値。

住所

お届け先住所情報。

オペレーション

Addressデータタイプは、以下のオペレーションのリクエストパラメーター、またはレスポンス要素で使用されます。

データタイプの内容

以下の表は、Addressデータタイプの要素を示しています。

名前 説明 必須
Name 受取人名。 はい 最大:50文字

タイプ:xs:string

Line1 受取人の住所番地情報。 はい 最大:60文字

タイプ:xs:string

Line2 追加の住所番地情報(必要に応じて)。 いいえ 最大:60文字

タイプ:xs:string

Line3 追加の住所番地情報(必要に応じて)。 いいえ 最大:60文字

タイプ:xs:string

DistrictOrCounty 受取人の地域または郡。 いいえ 最大:150文字

タイプ:xs:string

City 受取人の市町村。 日本(JP)以外は必須。日本(JP)では使用しない。 最大:50文字

タイプ:xs:string

StateOrProvinceCode 受取人の都道府県。 はい 最大:150文字

タイプ:xs:string

CountryCode 受取人の国コード(2桁)。 はい ISO 3166-1 alpha-2フォーマット国コード。

タイプ:xs:string

PostalCode 郵便番号(アメリカ合衆国への出荷時に必要)。 いいえ 最大:20文字

タイプ:xs:string

PhoneNumber 受取人の電話番号。 いいえ 最大:20文字

タイプ:xs:string

CODSettings

代金引換の出荷注文にかかる代金引換手数料。代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。

オペレーション

CODSettingsデータタイプは、以下のオペレーションのリクエストパラメーター、またはレスポンス要素で使用されます。

データタイプの内容

以下の表は、CODSettingsデータタイプの要素を示しています。

名前 説明 必須
IsCODRequired 代金引換の出荷注文かどうかを示す。 いいえ IsCODRequired値:
  • true - 支払い方法が代金引換
  • false - 支払い方法が代金引換以外
注: IsCODRequiredの有効値がtrueとなるのは、日本(JP)と中国(CN)のみ。CreateFulfillmentOrderの呼び出しにIsCODRequired=trueを指定した場合、日本(JP)と中国(CN)以外のマーケットプレイスではエラーが返されます。
注: IsCODRequired=trueを指定した場合は、PerUnitPriceも指定してください。PerUnitPriceについて詳しくは、CreateFulfillmentOrderItemを参照。

タイプ:xs:boolean

CODCharge 代金引換の注文で、購入者から回収される代金引換の手数料。 いいえ デフォルト:ゼロ
注: CODChargeは日本(JP)と中国(CN)のみで有効。

タイプ: Currency

CODChargeTax 代金引換の注文で、購入者から回収される代金引換の手数料にかかる税金。 いいえ デフォルト:ゼロ
注: CODChargeTaxは日本(JP)と中国(CN)のみで有効。

タイプ: Currency

ShippingCharge 代金引換の注文で、購入者から回収される代金引換の配送料。 いいえ デフォルト:ゼロ
注: ShippingChargeは日本(JP)と中国(CN)のみで有効。

タイプ: Currency

ShippingChargeTax 代金引換の注文で、購入者から回収される代金引換の配送料の税金。 いいえ デフォルト:ゼロ
注: ShippingChargeTaxは日本(JP)と中国(CN)のみで有効。

タイプ: Currency

CreateFulfillmentOrderItem

出荷注文の商品情報。CreateFulfillmentOrderオペレーションにより送信されます。

オペレーション

CreateFulfillmentOrderItemデータタイプは、以下のオペレーションのリクエストパラメーターで使用されます。

データタイプの内容

以下の表は、CreateFulfillmentOrderItemデータタイプの要素を示しています。

名前 説明 必須
SellerSKU 商品の出品者SKU。 はい 最大:50文字

タイプ:xs:string

SellerFulfillmentOrderItemId 出荷注文の商品を追跡するために作成した出荷注文の商品識別番号。この値は、同一のSellerSKUを持つ複数のフルフィルメント商品を区別するために使用することもできます。たとえば、同じSellerSKUを共有するが異なるGiftMessageの値を持つ出荷注文のうち、2つの商品に異なるSellerFulfillmentOrderItemIdの値を割り当てることがあります。 はい 最大:50文字

タイプ:xs:string

Quantity 商品の数量。 はい タイプ:xs:int
GiftMessage ギフトメッセージ(適用される場合)。 いいえ 最大:512文字

タイプ:xs:string

DisplayableComment 納品書など受取人が確認できる文書に表示される商品固有のテキスト。 いいえ 最大:250文字

タイプ:xs:string

FulfillmentNetworkSKU 商品のAmazonフルフィルメントネットワークSKU。 いいえ タイプ:xs:string
PerUnitDeclaredValue 出品者が設定した商品の価格。 いいえ

欧州の出品者の場合:お届け先の国がEUのFBA海外発送対象国である26か国に含まれていない場合のみ必須。詳しくは、セラーセントラルヘルプページのFBA海外発送を参照してください。

欧州外の出品者の場合:お届け先の国が、出荷注文の送信国と異なる場合のみ必須。

デフォルト:ゼロ

タイプ: Currency

PerUnitPrice この商品の受取人から回収される代金引換注文の代金。

タイプ: Currency

注: 代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。
いいえ デフォルト:ゼロ

タイプ: Currency

PerUnitTax 受取人から回収される代金引換注文の商品代金の税金。

タイプ: Currency

注: 代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。
いいえ デフォルト:ゼロ

タイプ: Currency

Currency

通貨のタイプと金額。

オペレーション

Currencyデータタイプは、以下のオペレーションのリクエストパラメーター、またはレスポンス要素で使用されます。

データタイプの内容

以下の表は、Currencyデータタイプの要素を示しています。

名前 説明 必須
CurrencyCode 3桁の通貨コード。 はい ISO 4217フォーマット

タイプ:xs:string

Value 金額。 はい タイプ:xs:string

DeliveryWindow

お届け日時指定便の出荷注文が配達される時間の範囲。

オペレーション

DeliveryWindowデータタイプは、以下のオペレーションのリクエストパラメーター、またはレスポンス要素で使用されます。

データタイプの内容

以下の表は、DeliveryWindowデータタイプの要素を示しています。

名前 説明 必須
StartDateTime お届け日時指定便で指定可能な期間の開始日と開始時刻。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

EndDateTime お届け日時指定便で指定可能な期間の終了日と終了時刻。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

Fee

手数料のタイプと金額。

オペレーション

Feeデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、Feeデータタイプの要素を示しています。

名前 説明 必須
Name 手数料のタイプ。 はい Name値:
  • FBAPerUnitFulfillmentFee - 出荷注文のユニット単位の見積もり。
  • FBAPerOrderFulfillmentFee - 注文単位の見積もり。
  • FBATransportationFee - 配送料の見積もり。
  • FBAFulfillmentCODFee - 代金引換手数料の見積もり。この手数料は代金引換の出荷注文見積もりにのみ適用。
    注: 代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。

タイプ:xs:string

Amount 手数料の金額。 はい タイプ: Currency

FulfillmentOrder

ステータスを含む出荷注文の一般情報。

オペレーション

FulfillmentOrderデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、FulfillmentOrderデータタイプの要素を示しています。

名前 説明 必須
SellerFulfillmentOrderId CreateFulfillmentOrderオペレーションを使用して作成、送信した出荷注文番号。 はい タイプ:xs:string
MarketplaceId 注文が行われたマーケットプレイス。 はい MarketplaceId値:Amazon MWSエンドポイントとMarketplaceId値を参照。

タイプ:xs:string

DisplayableOrderId 出品者がCreateFulfillmentOrderオペレーション送信時に指定した出荷注文番号。納品書など受取人が確認する文書に出荷注文番号として表示されます。 はい タイプ:xs:string
DisplayableOrderDateTime 出品者がCreateFulfillmentOrderオペレーション送信時に指定した日付。納品書など受取人が確認する文書に注文日として表示されます。 はい タイプ:xs:dateTime
DisplayableOrderComment 出品者がCreateFulfillmentOrderオペレーション送信時に指定したテキスト。納品書など受取人が確認する文書に表示されます。 はい タイプ:xs:string
ShippingSpeedCategory CreateFulfillmentOrderオペレーション送信時に選択した配送スピード。 はい ShippingSpeedCategory値:
  • Standard - 通常配送
  • Expedited - お急ぎ便
  • Priority - 優先配送 (USのみ)
  • ScheduledDelivery - お届け日時指定便。お届け日時指定便は、日本(JP)のみでご利用いただけます。詳しくは、お届け日時指定を参照してください。
注: 利用できる配送スピードは、マーケットプレイスによって異なります。利用できる配送スピードとFBA手数料は、該当マーケットプレイスのAmazonセラーセントラルWebサイトで確認してください。

タイプ:xs:string

DeliveryWindow お届け日時指定便の出荷注文が配達される時間の範囲。 いいえ タイプ: DeliveryWindow
DestinationAddress CreateFulfillmentOrderオペレーション送信時に指定したお届け先住所。 はい タイプ: Address
FulfillmentAction 注文を直ちに出荷するのか、それとも保留して後で出荷するのかを示します。GetFulfillmentOrderのみが返します。 いいえ FulfillmentAction値:
  • Ship - 注文された商品を直ちに出荷。
  • Hold - 注文された商品を後で出荷。

タイプ:xs:string

FulfillmentPolicy 出品者がCreateFulfillmentOrderオペレーション送信時に選択したFulfillmentPolicy値。 いいえ FulfillmentPolicy値:
  • FillOrKill - 出荷注文の出荷の一部がPendingステータスになる(すなわち在庫のピッキングプロセスが開始する)前に、その注文商品の一部が出荷不可になった場合、注文全体が出荷不可とみなされる。しかし、出荷注文の出荷の一部がPendingステータスになった後に、その注文の商品の一部が出荷不可になった場合、Amazonはその注文の出荷を極力キャンセルする。出荷ステータスの定義については、FulfillmentShipmentデータタイプを参照。
  • FillAll - 出荷注文の出荷可能な商品がすべて出荷された状態。すべての商品がAmazonによって出荷されるか、出品者によりキャンセルされるまで、注文は処理中になる。
  • FillAllAvailable - 出荷注文の出荷可能な商品がすべて出荷された状態。注文に含まれる出荷不可能なすべての商品はAmazonによってキャンセルされている。

デフォルト:FillOrKill

タイプ:xs:string

ReceivedDateTime 出荷注文がAmazonフルフィルメントセンターで受信された日付。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

FulfillmentOrderStatus 出荷注文の現在のステータス。 はい FulfillmentOrderStatus値:
  • RECEIVED - 出荷注文がAmazonマーケットプレイスWebサービス(Amazon MWS)によって受領され、検証された状態。検証では、配送先住所が有効であり、Amazonの記録上、出品者が注文を処理するのに必要な出荷可能(損傷を受けていない)在庫があることを確認します。出品者はステータスがRECEIVEDの出荷注文をキャンセルできます。
  • INVALID - 出荷注文がAmazonマーケットプレイスWebサービス(Amazon MWS)によって受領されたが、検証できなかった状態。その理由として、配送先住所が無効であるか、Amazonの記録上、出品者が注文を処理するのに必要な出荷可能在庫を持っていないことが考えられます。その場合、出荷注文は無効となり、注文の商品は出荷されません。
  • PLANNING - 出荷プラン作成のため出荷注文がAmazonフルフィルメントネットワークに送られたが、まだどの出荷のユニットも在庫からピックアップされていない状態。出品者はステータスがPLANNINGの出荷注文をキャンセルできます。
  • PROCESSING - 出荷注文の少なくとも1出荷分において在庫からユニットをピックアップするプロセスが開始された状態。出品者はステータスがPROCESSINGの出荷注文をキャンセルすることはできません。
  • CANCELLED - 出荷注文が出品者によってキャンセルされた状態。
  • COMPLETE - 出荷注文の全商品の全数量が出荷された状態。
  • COMPLETE_PARTIALLED - 出荷注文の一部商品が出荷済みで、残りはキャンセルされているか出荷不可の状態。
  • UNFULFILLABLE - Amazonフルフィルメントセンターにその商品の在庫がないか、または販売可能な(損傷を受けていない)コンディションの在庫がないため、出荷注文のどの商品も出荷できない状態。

タイプ:xs:string

StatusUpdatedDateTime 出荷注文のステータスの最終更新日。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

NotificationEmailList 出品者がCreateFulfillmentOrderオペレーション送信時に指定したNotificationEmailList値。 いいえ タイプ:xs:string
CODSettings 代金引換の注文にかかる代金引換手数料。 いいえ CODSettingsが返されるのは、代金引換注文の場合のみ。代金引換の注文は、日本(JP)と中国(CN)のみ対応。

タイプ: CODSettings

FulfillmentOrderItem

出荷注文の商品情報。

オペレーション

FulfillmentOrderItemデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、FulfillmentOrderItemデータタイプの要素を示しています。

名前 説明 必須
SellerSKU 商品の出品者SKU。 はい タイプ:xs:string
SellerFulfillmentOrderItemId CreateFulfillmentOrderオペレーションを使用して作成、送信した出荷注文番号。 はい タイプ:xs:string
Quantity 商品の数量。 はい タイプ:xs:int
GiftMessage ギフトメッセージ(適用される場合)。 いいえ タイプ:xs:string
DisplayableComment 納品書など受取人が確認できる文書に表示される商品固有のテキスト。 いいえ タイプ:xs:string
FulfillmentNetworkSKU 商品のAmazonフルフィルメントネットワークSKU。 いいえ タイプ:xs:string
CancelledQuantity 出品者によってキャンセルされた商品の数量。 はい タイプ:xs:int
UnfulfillableQuantity 出荷不可能な商品の数量。 はい タイプ:xs:int
EstimatedShipDateTime その数量分の商品がフルフィルメントセンターから出荷される予定日時。この値は時間の経過とともに変化する。その商品、数量を含む出荷がキャンセルされた場合、EstimatedShipDateTimeは返されない。 いいえ 日時: ISO 8601日時フォーマット

タイプ:xs:dateTime

EstimatedArrivalDateTime その数量分の商品の配送予定日時。この値は時間の経過とともに変化する。その商品、数量を含む出荷がキャンセルされた場合、EstimatedArrivalDateTimeは返されない。 いいえ ISO 8601日時フォーマット

タイプ:xs:dateTime

PerUnitDeclaredValue 出品者が設定した商品の価格。 いいえ デフォルト:ゼロ

タイプ: Currency

PerUnitPrice この商品の受取人から回収される代金引換注文の代金。
注: 代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。
いいえ デフォルト:ゼロ

タイプ: Currency

PerUnitTax 受取人から回収される代金引換注文の商品代金の税金。
注: 代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。
いいえ デフォルト:ゼロ

タイプ: Currency

FulfillmentPreview

配送スピードに基づく配送と手数料の情報を含む、出荷注文予測の情報。

オペレーション

FulfillmentPreviewデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、FulfillmentPreviewデータタイプの要素を示しています。

名前 説明 必須
ShippingSpeedCategory 出荷注文の配送スピード。 はい ShippingSpeedCategory値:
  • Standard - 通常配送
  • Expedited - お急ぎ便
  • Priority - 優先配送 (USのみ)
  • ScheduledDelivery - お届け日時指定便。お届け日時指定便は、日本(JP)のみでご利用いただけます。詳しくは、お届け日時指定を参照してください。
注: 利用できる配送スピードは、マーケットプレイスによって異なります。利用できる配送スピードとFBA手数料は、該当マーケットプレイスのAmazonセラーセントラルWebサイトで確認してください。

タイプ:xs:string

IsFulfillable 出荷注文予測が出荷可能かどうかを示す。 はい IsFulfillable値:
  • true - 出荷可能
  • false - 出荷不可能

タイプ:xs:boolean

IsCODCapable 出荷注文予測が代金引換かどうかを示す。 はい IsCODCapable値:
  • true- 出荷注文の見積もりが代金引換。
  • false - 出荷注文の見積もりが代金引換以外。
注: 代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。

タイプ:xs:boolean

MarketplaceId 注文が行われたマーケットプレイス。 はい MarketplaceId値:Amazon MWSエンドポイントとMarketplaceId値を参照。

タイプ:xs:string

EstimatedShippingWeight この出荷注文予測の配送重量の見積もり。 いいえ タイプ: Weight
EstimatedFees この出荷注文予測のFBA手数料の見積もり(必要に応じて)。 いいえ タイプ:リスト - Fee
FulfillmentPreviewShipments 出荷注文予測の出荷可能な配送リスト。 いいえ タイプ:リスト - FulfillmentPreviewShipment
UnfulfillablePreviewItems 出荷注文予測の出荷不可能な商品のリスト。 いいえ タイプ:リスト - UnfulfillablePreviewItem
OrderUnfulfillableReasons 出荷注文予測に関連するエラーコードで、注文が出荷できない理由を示す。 いいえ エラーコード例:

DeliverySLAUnavailable

InvalidDestinationAddress

タイプ:タイプ:xs:string

ScheduledDeliveryInfo お届け日時指定便の配送情報。 いいえ タイプ: ScheduledDeliveryInfo

FulfillmentPreviewItem

出荷注文予測に含まれる出荷の商品情報。

オペレーション

FulfillmentPreviewItemデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、FulfillmentPreviewItemデータタイプの要素を示しています。

名前 説明 必須
SellerSKU 商品の出品者SKU。 はい タイプ:xs:string
SellerFulfillmentOrderItemId GetFulfillmentPreviewオペレーションの呼び出しで作成した出荷注文の商品識別番号。 はい タイプ:xs:string
Quantity 商品の数量。 はい タイプ:xs:int
EstimatedShippingWeight 出荷に含まれるSellerSKUで識別される商品の1個あたりの予測出荷重量。   タイプ: Weight
ShippingWeightCalculationMethod EstimatedShippingWeightを計算するのに使われる手法。   ShippingWeightCalculationMethod値:
  • Package - 商品の実際の重量に基づく。
  • Dimensional - 商品が占める3次元スペースに基づく。

タイプ:xs:string

FulfillmentPreviewShipment

出荷注文予測に含まれる出荷の配送および商品情報。

オペレーション

FulfillmentPreviewShipmentデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、FulfillmentPreviewShipmentデータタイプの要素を示しています。

名前 説明 必須
EarliestShipDate フルフィルメントセンターからの最早出荷予定日。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

LatestShipDate フルフィルメントセンターからの最遅出荷予定日。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

EarliestArrivalDate 配送先への最早配送予定日。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

LatestArrivalDate 配送先への最遅配送予定日。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

FulfillmentPreviewItems 出荷商品に関する情報。 はい タイプ:リスト - FulfillmentPreviewItem

FulfillmentShipment

出荷注文に含まれる出荷の配送および商品情報。

オペレーション

FulfillmentShipmentデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、FulfillmentShipmentデータタイプの要素を示しています。

名前 説明 必須
AmazonShipmentId Amazonによって割り当てられた納品番号。 はい タイプ:xs:string
FulfillmentCenterId 商品が出荷されるAmazonフルフィルメントセンターのID。 はい タイプ:xs:string
FulfillmentShipmentStatus 出荷の現在のステータス。 はい FulfillmentShipmentStatus値:
  • PENDING - 在庫のピッキングプロセスが開始された状態。
  • SHIPPED - フルフィルメントセンターからすべてのパッケージの出荷が完了している状態。
  • CANCELLED_BY_FULFILLER - Amazonフルフィルメントセンターからの出荷が予定どおりに行われていない状態。フルフィルメントセンター内の予定された場所に在庫がなかった場合が考えられます。出荷注文がキャンセルされると、Amazonは直ちに新規のフルフィルメント出荷を作成し、注文の出荷プロセスをもう一度行います。
  • CANCELLED_BY_SELLER - CancelFulfillmentOrderリクエストを使用して出荷がキャンセルされた状態。

タイプ:xs:string

ShippingDateTime ShippingDateTimeの意味合いは、現在の出荷ステータスにより異なる。FulfillmentShipmentStatusの現在の値が以下の場合、
  • Pending -ShippingDateTimeは、Amazonフルフィルメントセンターから出荷される予定日時を示す。
  • Shipped -ShippingDateTimeは、Amazonフルフィルメントセンターから実際に出荷された日時を示す。
出荷に複数のパッケージが含まれている場合、ShippingDateTimeはすべてのパッケージに適用されます。FulfillmentShipmentStatusの値がCancelledByFulfillerまたはCancelledBySellerの場合、ShippingDateTimeは返されません。
いいえ ISO 8601日時フォーマット

タイプ:xs:dateTime

EstimatedArrivalDateTime 出荷の配送予定日時。この値は時間の経過とともに変化します。出荷に複数のパッケージが含まれている場合、EstimatedArrivalDateTimeはすべてのパッケージに適用されます。出荷がキャンセルされた場合、EstimatedArrivalDateTimeは返されません。 いいえ ISO 8601日時フォーマット

タイプ:xs:dateTime

FulfillmentShipmentItem 出荷商品に関する情報。 はい タイプ:リスト - FulfillmentShipmentItem
FulfillmentShipmentPackage 出荷の中のパッケージの情報。 いいえ タイプ:リスト - FulfillmentShipmentPackage

FulfillmentShipmentItem

出荷注文に含まれる出荷の商品情報。

オペレーション

FulfillmentShipmentItemデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、FulfillmentShipmentItemデータタイプの要素を示しています。

名前 説明 必須
SellerSKU 商品の出品者SKU。 いいえ タイプ:xs:string
SellerFulfillmentOrderItemId CreateFulfillmentOrderオペレーションを使用して作成、送信した出荷注文番号。 はい タイプ:xs:string
Quantity 商品の数量。 はい タイプ:xs:int
PackageNumber 商品の数量を含むパッケージの識別番号。 いいえ タイプ:xs:int

FulfillmentShipmentPackage

出荷注文に含まれる出荷の梱包情報。

オペレーション

FulfillmentShipmentPackageデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、FulfillmentShipmentPackageデータタイプの要素を示しています。

名前 説明 必須
PackageNumber 出荷パッケージの識別番号。 はい タイプ:xs:int
CarrierCode 荷物を届ける配送業者を識別。 はい タイプ:xs:string
TrackingNumber お問い合わせ番号(適用する場合)は、荷物の追跡と配送情報を入手するのに使用。 いいえ タイプ:xs:string
EstimatedArrivalDateTime パッケージの配送予定日時。 いいえ ISO 8601日時フォーマット

タイプ:xs:dateTime

GetFulfillmentPreviewItem

出荷注文予測の商品情報。

オペレーション

GetFulfillmentPreviewItemデータタイプは、以下のオペレーションのリクエストパラメーターで使用されます。

データタイプの内容

以下の表は、GetFulfillmentPreviewItemデータタイプの要素を示しています。

名前 説明 必須
SellerSKU 商品の出品者SKU。 はい 最大:50文字

タイプ:xs:string

SellerFulfillmentOrderItemId 出荷予測で商品を追跡するために作成した出荷注文の商品識別番号。 はい 最大:50文字

SellerFulfillmentOrderItemIdの値は、リクエストごとに一意である必要があります。

タイプ:xs:string

Quantity 商品の数量。 はい タイプ:xs:int

ScheduledDeliveryInfo

お届け日時指定便の配送情報。

オペレーション

ScheduledDeliveryInfoデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、ScheduledDeliveryInfoデータタイプの要素を示しています。

名前 説明 必須
DeliveryTimeZone 出荷注文予測に含まれるお届け先住所のタイムゾーン。 はい IANAタイムゾーンの名称。例:Asia/Tokyo。

タイプ:xs:string

DeliveryWindows お届け日時指定便に指定可能な時間のリスト。 はい タイプ:リスト - DeliveryWindow

TrackingAddress

荷物の追跡に使用する住所情報。

オペレーション

TrackingAddressデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、TrackingAddressデータタイプの要素を示しています。

名前 説明 必須
City 市町村。 はい 最大:150文字

タイプ:xs:string

State 都道府県。 はい 最大:150文字

タイプ:xs:string

Country 国。 はい 最大:6文字

タイプ:xs:string

TrackingEvent

配送における各段階の情報。

オペレーション

TrackingEventデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、TrackingEventデータタイプの要素を示しています。

名前 説明 必須
EventDate 配送中の各イベントの発生日時。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

EventAddress 配送中の各イベントが発生した場所(市町村) はい タイプ: TrackingAddress
EventCode 配送中の各イベントのイベントコード。 はい EventCode値:
  • EVENT_101 - 配送業者に集荷を依頼。
  • EVENT_102 - 出品者がいる場所から荷物が集荷される。
  • EVENT_201 - 到着スキャン。
  • EVENT_202 - 発送スキャン。
  • EVENT_203 - お届け先の国に到着。
  • EVENT_204 - 通関手続きを開始。
  • EVENT_205 - 通関手続きを完了。
  • EVENT_206 - 集荷場所へ輸送中。
  • EVENT_301 - 配達済み。
  • EVENT_302 - 配達中。
  • EVENT_304 - 配達を試行。
  • EVENT_306 - 購入者が配送日を指定。
  • EVENT_307 - 配送日をスケジュール済み。
  • EVENT_308 - 集荷可能。
  • EVENT_309 - 出品者に返送。
  • EVENT_401 - 配送業者預かり - 住所が間違っている。
  • EVENT_402 - 通関手続きの遅延。
  • EVENT_403 - 購入者が引っ越している。
  • EVENT_404 - 他の要因により配送が遅延。
  • EVENT_405 - 荷物が破損。
  • EVENT_406 - 配送業者預かり。
  • EVENT_407 - 購入者が受領拒否。
  • EVENT_408 - 出品者へ返送中。
  • EVENT_409 - 配送業者による紛失。
  • EVENT_411 - 伝票受領済み - 荷物は未受領。
  • EVENT_412 - 荷物を受領済み - 伝票は未受領。
  • EVENT_413 - 配送業者預かり - 通関手続きの手数料により購入者が受領拒否。
  • EVENT_414 - 配送業者の仕分けミス。
  • EVENT_415 - 前の配送業者から受領。
  • EVENT_416 - 配達不可。
  • EVENT_417 - 荷物の仕分けミス。
  • EVENT_418 - 荷物の遅延。
  • EVENT_419 - 住所を訂正 - 配送を再スケジュール。

タイプ:xs:string

UnfulfillablePreviewItem

出荷注文予測に含まれる出荷不可能な商品の情報。

オペレーション

UnfulfillablePreviewItemデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、UnfulfillablePreviewItemデータタイプの要素を示しています。

名前 説明 必須
SellerSKU 商品の出品者SKU。 はい 最大:50文字

タイプ:xs:string

SellerFulfillmentOrderItemId GetFulfillmentPreviewオペレーションの呼び出しで作成した出荷注文の商品識別番号。 はい 最大:50文字

タイプ:xs:string

Quantity 商品の数量。 はい タイプ:xs:int
ItemUnfulfillableReasons 出荷注文予測に関連するエラーコードで、商品が出荷できない理由を示す。 いいえ エラーコード例:
  • InventoryUnavailable
  • NoDeliveryOption

タイプ:xs:string

UpdateFulfillmentOrderItem

出荷注文を更新する際に使用する商品情報。

オペレーション

UpdateFulfillmentOrderItemデータタイプは、以下のオペレーションのリクエストパラメーターで使用されます。

データタイプの内容

以下の表は、UpdateFulfillmentOrderItemデータタイプの要素を示しています。

名前 説明 必須
SellerFulfillmentOrderItemId 更新する出荷注文の商品を示します。CreateFulfillmentOrderオペレーションの前回の呼び出し時に作成されました。 はい 最大:50文字

タイプ:xs:string

Quantity 商品の数量。 はい この注文商品に指定する数量は、出荷注文が最初に作成されたときの数量と同等、またはそれ以下で、ゼロより大きい数量になります。

タイプ:xs:int

GiftMessage ギフトメッセージ(適用される場合)。 いいえ 最大:512文字

デフォルト:CreateFulfillmentOrderまたはUpdateFulfillmentOrderオペレーションの前回の呼び出し時に値を指定した場合は、その値がデフォルトとなります。指定しなかった場合のデフォルトはNull。

タイプ:xs:string

DisplayableComment 納品書など受取人が確認できる文書に表示される商品固有のテキスト。 いいえ 最大:250文字

デフォルト:CreateFulfillmentOrderまたはUpdateFulfillmentOrderオペレーションの前回の呼び出し時に値を指定した場合は、その値がデフォルトとなります。指定しなかった場合のデフォルトはNull。

タイプ:xs:string

PerUnitDeclaredValue 出品者が設定した商品の価格。 いいえ デフォルト:CreateFulfillmentOrderまたはUpdateFulfillmentOrderオペレーションの前回の呼び出し時に値を指定した場合は、その値がデフォルトとなります。指定しなかった場合のデフォルトはゼロ。

タイプ: Currency

PerUnitPrice この商品の受取人から回収される代金引換注文の代金。
注: 代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。
いいえ デフォルト:CreateFulfillmentOrderまたはUpdateFulfillmentOrderオペレーションの前回の呼び出し時に値を指定した場合は、その値がデフォルトとなります。指定しなかった場合のデフォルトはゼロ。

タイプ: Currency

PerUnitTax 受取人から回収される代金引換注文の商品代金の税金。
注: 代金引換の出荷注文は、中国(CN)と日本(JP)のみで利用可能。
いいえ デフォルト:CreateFulfillmentOrderまたはUpdateFulfillmentOrderオペレーションの前回の呼び出し時に値を指定した場合は、その値がデフォルトとなります。指定しなかった場合のデフォルトはゼロ。

タイプ: Currency

Weight

重量の単位と数値。

オペレーション

Weightデータタイプは、次のオペレーションのレスポンス要素で使用されます。

データタイプの内容

以下の表は、Weightデータタイプの要素を示しています。

名前 説明 必須
Unit 重さの単位を示す。 はい Unit値:
  • KG - キログラム
  • LB - ポンド

タイプ:xs:string

Value 商品の重量を表す数値。 はい タイプ:xs:string