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マーケットプレイスWebサービス(Amazon MWS) 注文APIセクションのレスポンス要素では、以下のデータタイプが使用されます。
データタイプ | 説明 |
---|---|
Address | 注文のお届け先住所。 |
BuyerCustomizedInfo | Amazon Custom プログラムからのカスタム注文の購入者情報。 |
BuyerTaxInfo | 購入者に関する税金情報。 |
InvoiceData | 請求書情報(中国でのみ使用可能)。 |
Money | 通貨のタイプと金額。 |
Order | 注文情報。 |
OrderItem | 注文商品情報。 |
PaymentExecutionDetailItem | 支払い方法が代金引換決済の注文に対する、支払い方法の内訳。 |
PaymentMethodDetails | 注文の支払い方法のリスト。 |
PointsGranted | 商品注文時に付与したAmazonポイントの数値と金額。(日本(JP)でのみ有効です)。 |
ProductInfo | 商品に関する情報。 このデータタイプは米国、英国、ドイツ、および日本のマーケットプレイスでのみ利用できます。 |
TaxClassification | 税金の種類と識別子。 |
TaxCollection | 源泉徴収される税に関する情報。 |
注文のお届け先住所。
以下の表は、Address データタイプの要素を示しています。
名前 | 説明 |
---|---|
Name | 名前。 タイプ:xs:string |
AddressLine1 | 番地。 タイプ:xs:string |
AddressLine2 | 追加の住所番地情報(必要に応じて) タイプ:xs:string |
AddressLine3 | 追加の住所番地情報(必要に応じて) タイプ:xs:string |
City | 市。 タイプ:xs:string |
County | 国。 タイプ:xs:string |
District | 地区。 タイプ:xs:string |
StateOrRegion | 州または地域。 タイプ:xs:string |
PostalCode | 郵便番号。 タイプ:xs:string |
CountryCode | 国コード(2桁)。 ISO 3166-1-alpha 2フォーマット。 タイプ:xs:string |
Phone | 電話番号。 タイプ:xs:string |
AddressType | 住所が業務用(Commercial)か住居(Residential)かを示します。 この要素は米国のマーケットプレイスでのみ利用できます。 任意 AddressType値: Commercial, Residentialタイプ:xs:string |
Amazon Custom プログラムからのカスタム注文の購入者情報。
以下の表は、 BuyerCustomizedInfo データタイプの要素を示しています。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
CustomizedURL | Amazon Custom のデータを含むZIPファイルの格納場所。 | 必須 | タイプ:xs:string |
購入者に関する税金情報。
以下の表は、BuyerTaxInfo データタイプの要素を示しています。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
CompanyLegalName | 会社の正式名称。 | 任意 | タイプ:xs:string |
TaxingRegion | 課税している国または地域。 | 任意 | タイプ:xs:string |
TaxClassifications | 税金分類のリスト。 | 任意 | タイプ:TaxClassification のリスト。 最低1つのTaxClassification レスポンス要素を含みます。 |
請求書情報(中国でのみ使用可能)。
以下の表は、InvoiceData データタイプの要素を示しています。
名前 | 説明 |
---|---|
InvoiceRequirement | 請求書の必須情報。 InvoiceRequirement 値:
任意 タイプ:xs:string |
BuyerSelectedInvoiceCategory | 購入者が注文時に選択した請求書カテゴリー情報。 任意 タイプ:xs:string |
InvoiceTitle | 購入者が指定した請求書のタイトル。 任意 タイプ:xs:string |
InvoiceInformation | 請求書情報。 InvoiceInformation値:
任意 タイプ:xs:string |
通貨のタイプと金額。
以下の表は、Money データタイプの要素を示しています。
名前 | 説明 |
---|---|
CurrencyCode | 3桁の通貨コード。 ISO 4217フォーマット。 タイプ:xs:string |
Amount | 金額。 タイプ:xs:string |
注文情報。
以下の表は、Order データタイプの要素を示しています。
名前 | 説明 |
---|---|
AmazonOrderId | Amazonが定義した3-7-7フォーマットの注文IDです。 タイプ:xs:string |
SellerOrderId | セラーが定義した注文ID。 任意 タイプ:xs:string |
PurchaseDate | 注文が作成された日付。 タイプ:xs:dateTime |
LastUpdateDate | 注文が最後に更新された日付。 注: LastUpdateDate
は、2009-04-01より前に最終更新された注文に対し正しくない日付が返されます。
タイプ:xs:dateTime |
OrderStatus | 現在の注文ステータス タイプ:xs:string |
FulfillmentChannel | 注文の出荷方法: Amazonが出荷(AFN)、または、出品者が出荷(MFN)。 任意 タイプ:xs:string |
SalesChannel | 注文の最初の商品の販売チャネル。 任意 タイプ:xs:string |
OrderChannel | 注文の最初の商品の注文経路。 任意 タイプ:xs:string |
ShipServiceLevel | 注文の配送サービスレベル。 任意 タイプ:xs:string |
ShippingAddress | 注文のお届け先住所。 任意 タイプ: Address |
OrderTotal | 注文の合計金額。 任意 タイプ: Money |
NumberOfItemsShipped | 出荷した商品の数。 任意 タイプ:xs:int |
NumberOfItemsUnshipped | 未出荷の商品の数。 任意 タイプ:xs:int |
PaymentExecutionDetail | 代金引換決済(COD)の注文のときの支払い方法の情報。
代金引換決済の注文はPaymentMethod =CODの注文です。
1つ以上のPaymentExecutionDetailItemレスポンス要素が含まれます。
注: 代金引換決済の注文で、全額を代金引換で支払う場合、1つのPaymentExecutionDetailItemレスポンス要素を返却します。 このとき、PaymentExecutionDetailItem/PaymentMethodの値として、CODのみを返却します。代金引換の注文で、複数の支払方法を組み合わせて支払われた場合、複数のPaymentExecutionDetailItemレスポンス要素が返却されます。
任意。代金引換注文のみに返されます。 中国(CN)と日本(JP)のみで有効です。 タイプ: PaymentExecutionDetailItemのリスト |
PaymentMethod | 注文の支払い方法 PaymentMethod 値:
注: Order/PaymentMethodがCODの注文で、複数の支払い方法で支払いが行われている場合、それぞれの支払い方法はPaymentExecutionDetailItemレスポンス要素に返却されます。
PaymentExecutionDetailItem
で返却されるCODの各支払い方法の内訳が必要な場合以外は、支払い方法の詳細はPaymentMethodDetailsレスポンス要素の利用を推奨します。
任意 タイプ:xs:string |
PaymentMethodDetails | 注文の支払い方法のリスト
任意 タイプ: PaymentMethodDetails |
IsReplacementOrder | この注文が交換注文かどうかを示します。
任意 タイプ: boolean |
ReplacedOrderId | 交換対象となった注文のAmazonOrderId
任意。IsReplacementOrder = trueの場合のみ返されます。 タイプ: boolean |
MarketplaceId | 注文がなされたマーケットプレイスの匿名ID。 タイプ:xs:string |
BuyerEmail | 購入者の匿名Eメールアドレス。 任意。Amazonが出荷(AFN)のギフト注文の場合は返されません。 タイプ:xs:string |
BuyerName | 購入者の名前 任意 タイプ:xs:string |
BuyerCountry | 購入者の国名 任意。ブラジルのマーケットプレイスでのみ使用。 タイプ:xs:string |
BuyerTaxInfo | 購入者の税の情報 任意 タイプ: BuyerTaxInfo |
ShipmentServiceLevelCategory | 注文の配送サービスレベル。 ShipmentServiceLevelCategory 値:
任意 タイプ:xs:string |
ShippedByAmazonTFM | 注文がAmazon Transportation for Merchants (Amazon TFM Amazon輸送サービス)によって出荷されたことを示します。
注: Amazon TFM は、中国(CN)のみで有効です。
任意 タイプ: boolean |
TFMShipmentStatus | Amazon TFM を利用した注文のステータス。 ShippedByAmazonTFM
がTrueの場合にのみ返されます。
納品情報を作成していない場合は、ShippedByAmazonTFM
=Trueの場合でもTFMShipmentStatusは返されません。
TFMShipmentStatus値:
注: Amazon TFM は、中国(CN)のみで有効です。
任意 タイプ:xs:string |
CbaDisplayableShippingLabel | Checkout by Amazon(CBA)に対応した4種類の配送設定のうち、出品者がカスタマイズした配送サービス。
詳細については、該当マーケットプレイスのAmazonペイメントヘルプの「Setting Up Flexible
Shipping Options」トピックを参照してください。
注: CBAは、アメリカ合衆国(US)、イギリス(UK)、ドイツ(DE)のみで有効です。
任意 タイプ:xs:string |
OrderType | 注文のタイプ。 OrderType値:
注: PreorderおよびSourcingOnDemandOrderは、日本(JP)のみで使用できるOrderType値です。
タイプ:xs:string |
EarliestShipDate | お届け予定日に到着するための出荷日(出荷期間の開始日)。 ISO 8601日付フォーマット。 任意。出品者出荷(MFN)注文でのみ返されます。 注: EarliestShipDateは、2013年2月1日より前に行われた注文に対しては返されない場合があります。
タイプ:xs:dateTime |
LatestShipDate | お届け予定日に到着するための出荷日(出荷期間の終了日)。 ISO 8601日付フォーマット。 任意。MFNおよびAmazonフルフィルメントネットワーク(AFN)注文で返されます。 注: LatestShipDate
は、2013年2月1日より前に行われた注文に対しては返されない場合があります。
タイプ:xs:dateTime |
EarliestDeliveryDate | お届け予定日(お届け期間の開始日)。 ISO 8601日付フォーマット。
任意。ステータスがPendingAvailability、Pending、CanceledではないMFN注文でのみ返されます。 タイプ:xs:dateTime |
LatestDeliveryDate | お届け予定日(お届け期間の終了日)。 ISO 8601日付フォーマット。
任意。ステータスがPendingAvailability、Pending、CanceledではないMFN注文でのみ返されます。 タイプ:xs:dateTime |
IsBusinessOrder | Amazon Business の注文かどうかを示します。 Amazon Business の注文は、購入者がAmazon
Businessに登録しているビジネス購入者かつ 出品者がAmazon
Businessに登録している出品者である注文です。 Amazon
Business出品プログラムの詳細について、Amazon Business のウェブサイトを参照ください。 IsBusinessOrder 値:
任意 タイプ: boolean |
PurchaseOrderNumber | 購入者が注文確定時に入力した発注番号(PO)。 任意。購入者が注文確定時にPOを入力した注文に対してのみ返されます。 タイプ:xs:string |
IsPrime | マケプレプライムの注文かどうかを示します。 IsPrime 値:
任意 タイプ: boolean |
IsPremiumOrder | 注文がお急ぎ便関連プログラムが適用された注文かどうかを示します。
お急ぎ便関連プログラムが適用された注文についての詳細は、各マーケットプレイスのセラーセントラルのヘルプの「お急ぎ便関連プログラム」を参照ください。
IsPremiumOrder 値:
任意 タイプ: boolean |
PromiseResponseDueDate | 出品者が出荷予定日を購入者に通知しなければならない期限日を示します。 任意。取り寄せ注文でのみ返却されます。 タイプ:xs:dateTime |
IsEstimatedShipDateSet | 注文に対して出荷予定日が設定されている場合に true が返却されます。 任意。取り寄せ注文でのみ返却されます。 タイプ:xs:boolean |
注文商品情報。
以下の表は、OrderItem データタイプの要素を示しています。
名前 | 説明 | ||
---|---|---|---|
ASIN | 商品のAmazon標準識別番号(ASIN)。 タイプ:xs:string |
||
OrderItemId | Amazonが定義した注文商品ID。 タイプ:xs:string |
||
SellerSKU | 商品の出品者SKU。 任意 タイプ:xs:string |
||
BuyerCustomizedInfo | Amazon Custom プログラムのカスタム注文の購入者情報。 任意 |
||
Title | 商品名。 任意 タイプ:xs:string |
||
QuantityOrdered | 注文されている商品の数。 タイプ:xs:int |
||
QuantityShipped | 出荷した商品の数。 任意 タイプ:xs:int |
||
PointsGranted | 商品注文時に付与した Amazon ポイントの数値と金額。 ( 日本 (JP) でのみ有効です )
PointsGranted は日本 (JP) でのみ返却されるレスポンス要素です。 任意。 商品注文時に Amazon ポイントが付与された時のみ返却します。日本での Amazon ポイントプログラムに関する詳細はセラーセントラルヘルプページ(JP) を参照ください。 タイプ:PointsGranted |
||
ProductInfo |
商品に関する情報。
任意。 タイプ: ProductInfo |
||
ItemPrice | 注文商品の販売価格。 注文商品は商品と数量です。
つまり、ItemPriceの値は、商品の販売価格を注文数量で乗算した値です。
ItemPriceにはShippingPriceとGiftWrapPriceが含まれません。
注文商品の詳細については、注文APIセクションについて知っておくべきことを参照してください。 任意 タイプ: Money |
||
ShippingPrice | 商品の配送料。 任意 タイプ: Money |
||
GiftWrapPrice | 商品のギフト包装料。 任意 タイプ: Money |
||
TaxCollection | 徴収される税金に関する情報。 任意 タイプ: TaxCollection |
||
ItemTax | 商品価格に対する税金。 任意 タイプ: Money |
||
ShippingTax | 配送料に対する税金。 任意 タイプ: Money |
||
GiftWrapTax | ギフト包装料に対する税金。 任意 タイプ: Money |
||
ShippingDiscount | 配送料に対する値引き。 任意 タイプ: Money |
||
PromotionDiscount | 出品商品に対するすべてのプロモーション値引きの合計額。 任意 タイプ: Money |
||
PromotionIds | PromotionId 要素のリスト。 任意 タイプ: タイプのリスト: xs:string |
||
CODFee | COD(代金引換決済)サービスにかかる手数料。
注: CODFeeは日本(JP)でのみ有効なレスポンス要素です。
任意 タイプ: Money |
||
CODFeeDiscount | COD(代金引換決済)手数料に対する値引き。
注: CODFeeDiscountは日本(JP)でのみ有効なレスポンス要素です。
任意 タイプ: Money |
||
IsGift | 商品がギフトの場合に true が返されます。 任意 タイプ:xs:boolean |
||
GiftMessageText | 購入者が指定したギフトメッセージ 任意 タイプ:xs:string |
||
GiftWrapLevel | 購入者が指定したギフト包装レベル 任意 タイプ:xs:string |
||
InvoiceData | 請求書情報(中国でのみ使用可能)。
注: InvoiceDataは、中国(CN)のみで有効なレスポンス要素です。
任意 タイプ: InvoiceData |
||
ConditionNote | 出品者によって説明された商品のコンディション。 任意 タイプ:xs:string |
||
ConditionId | 商品のコンディション ConditionId値:
任意 タイプ:xs:string |
||
ConditionSubtypeId | 商品のサブコンディション ConditionSubtypeId値:
任意 タイプ:xs:string |
||
ScheduledDeliveryStartDate | お届け先のタイムゾーンでのお届け日時指定の開始日時。 ISO 8601日付フォーマット。
注: お届け日時指定は日本(JP)でのみ有効です。
任意。 お届け日時指定の注文のみに返されます。 タイプ:xs:string |
||
ScheduledDeliveryEndDate | お届け先のタイムゾーンでのお届け日時指定の最終日時。 ISO 8601日付フォーマット。
注: お届け日時指定は日本(JP)でのみ有効です。
任意。 お届け日時指定の注文のみに返されます。 タイプ:xs:string |
||
IsTransparency | 透明性コードが必要な場合にTrueが返されます。 | No | タイプ:xs:boolean |
PriceDesignation | 販売価格が Amazon Business の注文に対してのみ適用される法人価格かどうかを示します。FAmazon
Business出品プログラムの詳細については、Amazon Business のウェブサイトを参照ください。
PriceDesignation 値:
任意。Returned only for order items from orders with IsBusinessOrder = trueの注文の商品に対してのみ返却します。 タイプ:xs:string |
支払い方法が代金引換決済の注文に対する、支払い方法の内訳。
以下の表は、PaymentExecutionDetailItemデータタイプの要素を示しています。
名前 | 説明 |
---|---|
Payment | 兄弟要素であるPaymentMethodレスポンス要素で示された支払い方法で支払われた金額。
タイプ: Money |
PaymentMethod | COD注文の支払い方法の内訳 PaymentMethod 値:
タイプ:xs:string |
注文の支払い方法のリスト。
以下の表は、 PaymentMethodDetailsデータタイプの要素を示しています。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
PaymentMethodDetail | 注文の支払い方法。例えば、 CashOnDelivery、 Invoice、Standard。 | 任意 | タイプ:xs:string |
商品注文時に付与したAmazonポイントの数値と金額。(日本(JP)でのみ有効です)。
以下の表はPointsGrantedデータタイプの要素を示しています。
Name | Description |
---|---|
PointsNumber | 商品注文時に付与したAmazonポイントの数値。 タイプ:xs:int |
PointsMonetaryValue | 付与した Amazon ポイントの金額。 タイプ:Money |
商品に関する情報。 このデータタイプは米国、英国、ドイツ、および日本のマーケットプレイスでのみ利用できます。
以下の表は、ProductInfoデータタイプの要素を示しています。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
NumberOfItems | ASINに含まれる商品の個数 | 任意 | タイプ:xs:int |
税金の種類と識別子。
以下の表は、 TaxClassification データタイプの要素を示しています。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
Name | 税金のタイプ。 | 必須 | タイプ:xs:string |
Value | 購入者の税金の識別子。 | 必須 | タイプ:xs:string |
源泉徴収される税に関する情報。
以下の表は、 TaxCollection データタイプの要素を示しています。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
Model | 商品に適用される徴税モデル。 | 必須 | Model
値:MarketplaceFacilitator - 税金は
出品者に代わりAmazonによって徴収され、税務当局へ納められます。 タイプ:xs:string |
ResponsibleParty | 税を源泉徴収して税務当局へ収めることを義務付けられている当事者。 | 必須 | ResponsibleParty 値:Amazon
Services, Inc. タイプ:xs:string |