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 注文のお届け先住所。
BuyerCustomizedInfo Amazon Custom プログラムからのカスタム注文の購入者情報。
BuyerTaxInfo 購入者に関する税金情報。
InvoiceData 請求書情報(中国でのみ使用可能)。
Money 通貨のタイプと金額。
Order 注文情報。
OrderItem 注文商品情報。
PaymentExecutionDetailItem 支払い方法が代金引換決済の注文に対する、支払い方法の内訳。
PaymentMethodDetails 注文の支払い方法のリスト。
PointsGranted 商品注文時に付与したAmazonポイントの数値と金額。(日本(JP)でのみ有効です)。
ProductInfo 商品に関する情報。 このデータタイプは米国、英国、ドイツ、および日本のマーケットプレイスでのみ利用できます。
TaxClassification 税金の種類と識別子。
TaxCollection 源泉徴収される税に関する情報。

Address

注文のお届け先住所。

オペレーション

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

データタイプの内容

以下の表は、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

BuyerCustomizedInfo

Amazon Custom プログラムからのカスタム注文の購入者情報。

オペレーション

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

データタイプの内容

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

名前 説明 必須
CustomizedURL Amazon Custom のデータを含むZIPファイルの格納場所。 必須 タイプ:xs:string

BuyerTaxInfo

購入者に関する税金情報。

オペレーション

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

データタイプの内容

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

名前 説明 必須
CompanyLegalName 会社の正式名称。 任意 タイプ:xs:string
TaxingRegion 課税している国または地域。 任意 タイプ:xs:string
TaxClassifications 税金分類のリスト。 任意 タイプ:TaxClassification のリスト。

最低1つのTaxClassification レスポンス要素を含みます。

InvoiceData

請求書情報(中国でのみ使用可能)。

オペレーション

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

データタイプの内容

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

名前 説明
InvoiceRequirement 請求書の必須情報。

InvoiceRequirement 値:

  • Individual - 購入者が注文した各商品に対し、別々の請求書を依頼した場合。
  • Consolidated - 購入者が注文の全商品に対し、請求書を一件のみ依頼した場合。
  • MustNotSend - 購入者が請求書を依頼しなかった場合。

任意

タイプ:xs:string

BuyerSelectedInvoiceCategory 購入者が注文時に選択した請求書カテゴリー情報。

任意

タイプ:xs:string

InvoiceTitle 購入者が指定した請求書のタイトル。

任意

タイプ:xs:string

InvoiceInformation 請求書情報。

InvoiceInformation値:

  • NotApplicable - 購入者が請求書を依頼しなかった場合。
  • BuyerSelectedInvoiceCategory - Amazonでは、請求書にある請求書カテゴリーに、このオペレーションによって返された BuyerSelectedInvoiceCategory 値を使用することをすすめています。
  • ProductTitle - Amazonでは、請求書にある請求書カテゴリーに商品名を使用することをすすめています。

任意

タイプ:xs:string

Money

通貨のタイプと金額。

オペレーション

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

データタイプの内容

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

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

タイプ:xs:string

Amount 金額。

タイプ:xs:string

Order

注文情報。

オペレーション

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

データタイプの内容

以下の表は、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 値:

  • COD - 代金引換決済。 中国(CN)と日本(JP)のみ有効。
  • CVS - コンビニ決済。日本(JP)のみ有効。
  • Other - COD、CVS以外の支払い方法。
注: Order/PaymentMethodCODの注文で、複数の支払い方法で支払いが行われている場合、それぞれの支払い方法は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 値:

  • Expedited
  • FreeEconomy(日本は非対応)
  • NextDay
  • SameDay
  • SecondDay
  • Scheduled
  • Standard

任意

タイプ:xs:string

ShippedByAmazonTFM 注文がAmazon Transportation for Merchants (Amazon TFM Amazon輸送サービス)によって出荷されたことを示します。
注: Amazon TFM は、中国(CN)のみで有効です。

任意

タイプ: boolean

TFMShipmentStatus Amazon TFM を利用した注文のステータス。 ShippedByAmazonTFM Trueの場合にのみ返されます。 納品情報を作成していない場合は、ShippedByAmazonTFM =Trueの場合でもTFMShipmentStatusは返されません。

TFMShipmentStatus値:

  • PendingPickUp
  • LabelCanceled
  • PickedUp
  • AtDestinationFC
  • Delivered
  • RejectedByBuyer
  • Undeliverable
  • ReturnedToSeller
注: 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値:

  • StandardOrder - 現在在庫がある商品が含まれている注文。
  • Preorder - まだ発売されていない商品が含まれている注文。
  • SourcingOnDemandOrder - 取り寄せ注文。
注: 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日付フォーマット。

任意。ステータスがPendingAvailabilityPendingCanceledではないMFN注文でのみ返されます。

タイプ:xs:dateTime

LatestDeliveryDate お届け予定日(お届け期間の終了日)。 ISO 8601日付フォーマット。

任意。ステータスがPendingAvailabilityPendingCanceledではないMFN注文でのみ返されます。

タイプ:xs:dateTime

IsBusinessOrder Amazon Business の注文かどうかを示します。 Amazon Business の注文は、購入者がAmazon Businessに登録しているビジネス購入者かつ 出品者がAmazon Businessに登録している出品者である注文です。 Amazon Business出品プログラムの詳細について、Amazon Business のウェブサイトを参照ください。

IsBusinessOrder 値:

  • true - Amazon Business の注文である。
  • false - Amazon Business の注文ではない。

任意

タイプ: boolean

PurchaseOrderNumber 購入者が注文確定時に入力した発注番号(PO)。

任意。購入者が注文確定時にPOを入力した注文に対してのみ返されます。

タイプ:xs:string

IsPrime マケプレプライムの注文かどうかを示します。

IsPrime 値:

  • true - マケプレプライムの注文である。
  • false - マケプレプライムの注文ではない。

任意

タイプ: boolean

IsPremiumOrder 注文がお急ぎ便関連プログラムが適用された注文かどうかを示します。 お急ぎ便関連プログラムが適用された注文についての詳細は、各マーケットプレイスのセラーセントラルのヘルプの「お急ぎ便関連プログラム」を参照ください。

IsPremiumOrder 値:

  • true - Premium Shipping の注文である。
  • false - Premium Shipping の注文ではない。

任意

タイプ: boolean

PromiseResponseDueDate 出品者が出荷予定日を購入者に通知しなければならない期限日を示します。

任意。取り寄せ注文でのみ返却されます。

タイプ:xs:dateTime

IsEstimatedShipDateSet 注文に対して出荷予定日が設定されている場合に true が返却されます。

任意。取り寄せ注文でのみ返却されます。

タイプ:xs:boolean

OrderItem

注文商品情報。

オペレーション

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

データタイプの内容

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

名前 説明    
ASIN 商品のAmazon標準識別番号(ASIN)。

タイプ:xs:string

   
OrderItemId Amazonが定義した注文商品ID。

タイプ:xs:string

   
SellerSKU 商品の出品者SKU。

任意

タイプ:xs:string

   
BuyerCustomizedInfo Amazon Custom プログラムのカスタム注文の購入者情報。

任意

タイプ:BuyerCustomizedInfo

   
Title 商品名。

任意

タイプ:xs:string

   
QuantityOrdered 注文されている商品の数。

タイプ:xs:int

   
QuantityShipped 出荷した商品の数。

任意

タイプ:xs:int

   
PointsGranted 商品注文時に付与した Amazon ポイントの数値と金額。 ( 日本 (JP) でのみ有効です )

PointsGranted は日本 (JP) でのみ返却されるレスポンス要素です。

任意。

商品注文時に Amazon ポイントが付与された時のみ返却します。日本での Amazon ポイントプログラムに関する詳細はセラーセントラルヘルプページ(JP) を参照ください。

タイプ:PointsGranted

   
ProductInfo 商品に関する情報。

任意。

タイプ: ProductInfo
   
ItemPrice 注文商品の販売価格。 注文商品は商品と数量です。 つまり、ItemPriceの値は、商品の販売価格を注文数量で乗算した値です。 ItemPriceにはShippingPriceGiftWrapPriceが含まれません。 注文商品の詳細については、注文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値:

  • New
  • Used
  • Collectible
  • Refurbished
  • Preorder
  • Club

任意

タイプ:xs:string

   
ConditionSubtypeId 商品のサブコンディション

ConditionSubtypeId値:

  • New
  • Mint
  • Very Good
  • Good
  • Acceptable
  • Poor
  • Club
  • OEM
  • Warranty
  • Refurbished Warranty
  • Refurbished
  • Open Box
  • Any
  • Other

任意

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

  • BusinessPrice - Amazon Business の注文に対してのみ適用される法人価格。

任意。Returned only for order items from orders with IsBusinessOrder = trueの注文の商品に対してのみ返却します。

タイプ:xs:string

   

PaymentExecutionDetailItem

支払い方法が代金引換決済の注文に対する、支払い方法の内訳。

オペレーション

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

データタイプの内容

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

名前 説明
Payment 兄弟要素であるPaymentMethodレスポンス要素で示された支払い方法で支払われた金額。

タイプ: Money

PaymentMethod COD注文の支払い方法の内訳

PaymentMethod 値:

  • COD - 代金引換決済。 中国(CN)と日本(JP)のみで有効。
  • GC - ギフトカード。 中国(CN)と日本(JP)のみで有効。
  • PointsAccount - Amazonポイント日本(JP)のみ有効。

タイプ:xs:string

PaymentMethodDetails

注文の支払い方法のリスト。

オペレーション

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

データタイプの内容

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

名前 説明 必須
PaymentMethodDetail 注文の支払い方法。例えば、 CashOnDeliveryInvoiceStandard 任意 タイプ:xs:string

PointsGranted

商品注文時に付与したAmazonポイントの数値と金額。(日本(JP)でのみ有効です)。

Operations

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

Datatype content

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

Name Description
PointsNumber 商品注文時に付与したAmazonポイントの数値。

タイプ:xs:int

PointsMonetaryValue 付与した Amazon ポイントの金額。

タイプ:Money

ProductInfo

商品に関する情報。 このデータタイプは米国、英国、ドイツ、および日本のマーケットプレイスでのみ利用できます。

オペレーション

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

データタイプの内容

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

名前 説明 必須
NumberOfItems ASINに含まれる商品の個数 任意 タイプ:xs:int

TaxClassification

税金の種類と識別子。

オペレーション

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

データタイプの内容

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

名前 説明 必須
Name 税金のタイプ。 必須 タイプ:xs:string
Value 購入者の税金の識別子。 必須 タイプ:xs:string

TaxCollection

源泉徴収される税に関する情報。

オペレーション

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

データタイプの内容

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

名前 説明 必須
Model 商品に適用される徴税モデル。 必須 Model 値:MarketplaceFacilitator - 税金は 出品者に代わりAmazonによって徴収され、税務当局へ納められます。

タイプ:xs:string

ResponsibleParty 税を源泉徴収して税務当局へ収めることを義務付けられている当事者。 必須 ResponsibleParty 値:Amazon Services, Inc.

タイプ:xs:string