amazon 出品サービス xml ガイド · 1. xml 概要 xml とは? xml (extensible markup...

61
Amazon 出品サービス XML ガイド 注記 当ドキュメントには、Amazon.co.jp サイト上で XML を使用する場合の一般的な情報を記 述しています。Amazon.co.jp サイト上での機能や特長により、XML の使用方法が異なる場 合もあります。 - 商品カテゴリーにより、Amazon.co.jp サイトでは有効でない XML ヘルプの記述もあり ます。商品カテゴリー固有の XSD ファイルは、そのカテゴリーが Amazon.co.jp サイ ト上で有効な場合に限り利用可能です。

Upload: others

Post on 22-May-2020

13 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon出品サービス

XML ガイド

注記

当ドキュメントには、Amazon.co.jp サイト上で XML を使用する場合の一般的な情報を記

述しています。Amazon.co.jp サイト上での機能や特長により、XML の使用方法が異なる場

合もあります。

- 商品カテゴリーにより、Amazon.co.jp サイトでは有効でない XML ヘルプの記述もあり

ます。商品カテゴリー固有の XSD ファイルは、そのカテゴリーが Amazon.co.jp サイ

ト上で有効な場合に限り利用可能です。

Page 2: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

目次

1. XML 概要 .......................................................................................................................................1

XML とは? ...................................................................................................................................... 1

XMLを使う理由 ............................................................................................................................... 1

必要条件 ............................................................................................................................................................ 1

Amazon マーケットプレイス Webサービスを使った XML統合 ....................................................................... 2

XMLを使ったカタログ情報の送信 .......................................................................................................... 2

XMLを使った注文処理 ...................................................................................................................... 3

2. Core スキーマを使った XML フィードの作成 .........................................................................................3

Core スキーマ ................................................................................................................................... 3

Core スキーマのリファレンス図 ............................................................................................................................... 4

Envelope スキーマ ............................................................................................................................ 4

説明 .................................................................................................................................................................... 4

ディクショナリ ......................................................................................................................................................... 4

XSD ..................................................................................................................................................................... 5

Header スキーマ ............................................................................................................................... 6

説明 .................................................................................................................................................................... 6

ディクショナリ ......................................................................................................................................................... 6

XSD ..................................................................................................................................................................... 6

Base スキーマ ................................................................................................................................... 7

説明 .................................................................................................................................................................... 7

ディクショナリ ......................................................................................................................................................... 7

XSD ..................................................................................................................................................................... 8

3. XML を使った出品管理 .................................................................................................................. 13

カタログ (商品) スキーマ ................................................................................................................... 13

商品登録 – 商品フィードスキーマ ....................................................................................................... 13

説明 .................................................................................................................................................................. 13

ディクショナリ ....................................................................................................................................................... 13

XSD ................................................................................................................................................................... 15

例 ...................................................................................................................................................................... 18

在庫数の更新 – 在庫フィードスキーマ ................................................................................................. 19

説明 .................................................................................................................................................................. 19

ディクショナリ ....................................................................................................................................................... 19

XSD ................................................................................................................................................................... 20

例 ...................................................................................................................................................................... 20

フルフィルメント by Amazon (FBA)* ................................................................................................... 21

例:商品を「Amazon からの出荷(AFN)」に変更 ................................................................................................ 21

例:商品を「出品者からの出荷(MFN)」に変更 ................................................................................................. 21

価格の登録 – 価格フィードスキーマ .................................................................................................... 21

説明 .................................................................................................................................................................. 22

Page 3: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

ディクショナリ ....................................................................................................................................................... 22

XSD ................................................................................................................................................................... 22

例 ...................................................................................................................................................................... 23

商品画像の送信 – 画像フィードスキーマ .............................................................................................. 23

説明 .................................................................................................................................................................. 23

ディクショナリ ....................................................................................................................................................... 24

XSD ................................................................................................................................................................... 24

例 ...................................................................................................................................................................... 25

商品関連性の登録 - 関連性フィードスキーマ (カテゴリーにより使用可能) .................................................. 25

説明 .................................................................................................................................................................. 25

ディクショナリ ....................................................................................................................................................... 26

XSD ................................................................................................................................................................... 27

例 (バリエーション) ............................................................................................................................................. 27

例 (アクセサリ) .................................................................................................................................................. 28

配送料の上書き – 配送料上書きフィードスキーマ (オプション) .................................................................. 28

説明 .................................................................................................................................................................. 28

ディクショナリ ....................................................................................................................................................... 29

XSD ................................................................................................................................................................... 29

例 (米国) ......................................................................................................................................................... 29

処理結果の確認 - 処理レポート ....................................................................................................... 30

説明 .................................................................................................................................................................. 30

ディクショナリ ....................................................................................................................................................... 30

XSD ................................................................................................................................................................... 30

例 ...................................................................................................................................................................... 31

4. XML を使った注文管理 .................................................................................................................. 33

注文・フルフィルメントスキーマ ............................................................................................................. 33

注文詳細の取得 – 注文レポート ....................................................................................................... 33

説明 .................................................................................................................................................................. 33

ディクショナリ ....................................................................................................................................................... 33

XSD ................................................................................................................................................................... 35

例 ...................................................................................................................................................................... 39

注文の受領確認 – 注文確認 ........................................................................................................... 40

説明 .................................................................................................................................................................. 41

ディクショナリ ....................................................................................................................................................... 41

XSD ................................................................................................................................................................... 42

例 ...................................................................................................................................................................... 42

出荷および出荷の確認 (支払い) - 注文フルフィルメント ......................................................................... 43

説明 .................................................................................................................................................................. 43

ディクショナリ ....................................................................................................................................................... 43

XSD ................................................................................................................................................................... 44

例 ...................................................................................................................................................................... 44

返金または注文の一部キャンセル - 注文修正または部分キャンセル ........................................................... 45

説明 .................................................................................................................................................................. 45

Page 4: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

ディクショナリ ....................................................................................................................................................... 45

XSD ................................................................................................................................................................... 46

例 ...................................................................................................................................................................... 46

支払い内容の取得 – 決済レポート..................................................................................................... 47

説明 .................................................................................................................................................................. 48

ディクショナリ ....................................................................................................................................................... 48

XSD ................................................................................................................................................................... 49

例 ...................................................................................................................................................................... 51

Amazonの注文管理プロセス ............................................................................................................ 56

5. XML フィードの妥当性確認 ............................................................................................................ 57

6. カテゴリー固有の XSD ..................................................................................................................... 57

Page 5: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

1

1. XML概要

XML とは?

XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML は、

シンプルで人間が認識可能なタグを用いてデータをマークアップする標準的な記述方法を定義したものです。データ

はテキスト文字列として XML ドキュメントに埋め込まれ、そのデータを説明するテキストのマークアップで囲まれ

ます。XML のデータとマークアップの基本的な単位をエレメントと呼びます。XML の仕様では、マークアップが従

うべき以下のような記述方法を定義しています。

タグによるエレメントの区切り方

タグの説明

エレメントに指定可能な名前

属性の定義位置

その他

XML ドキュメント上のマークアップは、HTML (Hypertext Markup Language)ドキュメント上のマークアップと似て

いますが、大きな違いがいくつかあります。最も大きな違いは、XML はメタマークアップ言語であるという点です。

すなわち、XML には万人が共通で使用できる定型のタグやエレメントはありません。

XML の X は「Extensible」を表し、XML 言語が様々な異なるニーズに対応できるよう、拡張・適応可能であること

を意味します。XML では、ビジネス上の特定のフィールドやタイプに合わせて、開発者が適切なエレメントを指定

することができます。例えば、化学者は分子や原子に関連するエレメントを、不動産業者はアパートや家賃に関する

エレメントを、音楽家は四分音符や歌詞に関するエレメントを定義できます。

XML は、HTML および SGML (Standard Generalized Markup Language)の改良を目指す人々の支援を受け、World

Wide Web Consortium (W3C)にて策定されました。

注意:本ドキュメントは XML のチュートリアルまたは XML を理解するためのものではあり

ません。XML の詳細については、W3C XML Tutorial を参照してください。

XML を使う理由

XML を使うことにより、出品者のシステムを Amazon のシステムと統合させることができます。出品者のシステム

と Amazon のシステムは、所定の API (Application Programming Interfaces)を利用して情報の受け渡しができ、出品

者のシステムから Amazon のシステムにデータを送信し、Amazon のシステムからデータを取得することができま

す。特に大容量のデータを扱う際、データの受け渡しに XML を使うと便利です。XML による統合を行い、テストが

完了した後は、マニュアルの作業はほぼ必要ありません。

必要条件

XML による統合に着手する前に、必要条件を満たしているかを確認してください。また、XSD (XML Schema

Document)に基づき XML フィードを作成するための開発リソースがあることも確認してください。

Page 6: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

2

Amazon マーケットプレイス Webサービスを使った XML統合

Amazon の出品者は、Amazon のシステムと出品者の POS システムや物流システムを統合したアプリケーションの

開発において、Amazon マーケットプレイス Web サービス(Amazon MWS)を利用できます。Amazon MWS 開発者

ガイドや API リファレンス、Amazon MWS に関するよくある質問、クライアントライブラリ、登録手続き情報等、

Amazon MWS の詳細については、各国の MWS ポータルサイトを参照してください。

CA – http://developer.amazonservices.ca DE – http://developer.amazonservices.de FR – http://developer.amazonservices.fr JP – http://developer.amazonservices.jp UK – http://developer.amazonservices.co.uk US – http://developer.amazonservices.com

XML を使ったカタログ情報の送信

Amazon.co.jp サイトで商品を登録・管理するには、最高 6種類のフィードを利用します。

商品フィード - カタログ上の商品に関する説明情報を設定します。出品者が管理する一意の ID (SKU)と

Amazon が管理する一意の ID (ASIN:Amazon Standard Identification Number)との関連付けを行います。新

規商品を出品する際には、まず初めにこのフィードを送信します。

在庫フィード – Amazon に出品している商品の現在の在庫状況を設定します。取り寄せ中の商品が発送可

能になる日付や、注文を処理し出荷するまでに必要な時間などを含みます。

価格フィード – 出品している商品の現在の価格を設定します。通常(標準)販売価格または暫定(セー

ル)価格のどちらかを設定します。

画像フィード – 出品者のサーバー上の URL を指定します。Amazon はその URL にアクセスして画像を取

得し、商品と関連付けます。

関連性フィード(一部のカテゴリーのみ使用可能) - カタログ上の他の商品との関連性を定義します。関

連性には以下の 2種類があります。

バリエーション(最も一般的に設定される関連性) - 顧客がサイズや色の異なる商品のバリエーショ

ンを選択できるようにします。

アクセサリ – 親商品と関連したアクセサリ商品を商品詳細ページに表示し、顧客が組み合わせで選択

できるようにします。例えばポータブルラジオに、電池や外部スピーカーをアクセサリとして登録しま

す。

配送料上書きフィード(設定により使用可能) - 出品アカウントレベルの出荷設定情報を、個別の SKU レ

ベルの出荷設定情報で上書きできます。この設定は、カヤックなどの重量またはサイズがかさむ商品で有用

です。

Page 7: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

3

XML を使った注文処理

Amazon.co.jp サイトで顧客が商品を注文すると、その注文数が出品者の在庫数から差し引かれます。注文は入力さ

れてから 90分間、取引確認のため保留されます。この期間に顧客の支払い方法を認証し、顧客に注文確認メールを

送信します。またこの期間に、顧客は Amazon アカウントを使って注文を変更・キャンセルすることができます。

支払い方法が認証されなかった場合、または顧客が注文をキャンセルした場合、その商品の注文数は出品者の在庫数

に戻されます。また同時に、顧客には注文キャンセル確認メールが送信されます。

1. 注文受領:保留期間が過ぎると、注文レポートが生成されます。

注意:初期設定では、注文レポートは XML フォーマットではありません。XML フォーマット

を使用するには、担当のアカウントマネージャーまたはテクニカルサポートにお問い合せくだ

さい。

2. 注文の受領確認 : 注文確認フィードにより、必要に応じて出品者独自の注文 ID と注文商品 ID を、

Amazon 独自の注文 ID と注文商品 ID と関連付けることができます。またこの注文確認フィードを使い、注

文全体をキャンセルすることもできます。

3. 注文を発送して出荷通知を送信:注文された商品を梱包、出荷し、出荷通知を Amazon に送信します。こ

れは非常に重要なステップです。これにより、Amazon が支払い処理を行い(その結果、出品者への支払い

が行われます)、購入者に出荷を通知するメールを送信します。受注後 30日以内に出荷通知が Amazon に

送信されない場合、注文は自動的にキャンセルされ、出品者に対する支払いは行なわれません。

4. 注文の修正:必要に応じて、注文に対する返金および返品処理を行います。

5. 支払:出荷通知を送信した後、Amazon は購入者との支払い取引を完了し、出品者のアカウントに計上しま

す。さらに決済期間中の支払い処理に関する決済レポートが生成されます。出品者の銀行口座への振り込み

の詳細については、以下のヘルプページを参照してください。

https://sellercentral.amazon.com/gp/help/18841

https://sellercentral-europe.amazon.com/gp/help/18841

https://sellercentral.amazon.co.jp/gp/help/18841

https://sellercentral.amazon.ca/gp/help/18841

2. Core スキーマを使った XML フィードの作成

Core スキーマ

Amazon で使用する XML フィードを開発する際には、セラーセントラルのヘルプよりスキーマファイルまたは XSD

(XML Schema Definitions)ファイルを取得してください。スキーマファイルは、Amazon に送信されるフィードおよ

び Amazon で生成されるレポートのフォーマットをまとめたものです。この章では、出品者と Amazon でやり取り

される全てのデータに関するエレメントの定義と XSD について説明します。

各フィードには Amazon の Core スキーマとフィードタイプごとのスキーマが必要です。各スキーマにはそれぞれ個

別の目的があります。

Page 8: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

4

注意:

ヘルプページ上の XSD サンプルは最新でない場合があります。最新バージョンの

XSD を取得するには、該当する XSD リンクを参照してください。

データフィードでは、文字コードは UNICODE を、符号化方式は UTF-8 を指定して

ください。英語のアルファベットは UTF-8 でも ASCII でも同様に符号化されますが

、英語以外の発音記号付き文字(例: ü)の場合、コードが異なります。このよう

な文字を使用する場合、必要に応じて ASCII から UTF-8 への変換を行ってください

Core スキーマのリファレンス図

Envelope スキーマ

説明

Envelope は、メッセージレベルのプロトコルデータとそれ以外のデータをラップするために使用します。Envelope

は、ヘッダと特定のデータオブジェクトを含む一つ以上のメッセージで構成されています。Envelope に複数のメッ

セージを含めることが可能ですが、1つの Envelope 内のメッセージは全て、Message Type エレメントで指定する

同一のタイプでなければなりません。

ディクショナリ

エレメント名 説明

EffectiveDate 在庫フィードが有効になる日付

MessageID Envelope 内のメッセージを特定する個別の ID で、Envelope 内で一意な番号。処理レポート中のエ

ラーや警告の突き合わせに使用する。

MessageType Envelope 内のメッセージのタイプ。Envelope 内のすべてのメッセージは同一タイプでなければなら

ない。

OperationType 該当するデータに行うべき操作のタイプ(Update、 Delete、または PartialUpdate)のいずれかを

指定する。オプションのエレメント。商品関連のフィード(商品、在庫、価格など)の場合のみ有

効で、それ以外のフィードの場合は無視される。

Page 9: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

5

Update を指定した場合、指定したすべての情報が上書きされ、指定されていない情報は

すべて消去される。

Delete を指定した場合、全ての情報が削除される。 商品フィードのみ有効:PartialUpdate を指定した場合、指定したすべての情報は上書きされるが、指

定しない情報は変わらない。注意:operation type は商品フィードの場合のみ有効です。

operation type を商品フィード以外のフィード(在庫フィード、価格フィードなど)で使

用した場合、想定しないデータの損失が発生する可能性があります。

単に現存するすべてのデータを新しいデータに入れ替える際は、OperationType ではなく、

PurgeAndReplace を使用すること。PurgeAndReplace エレメントを使用した場合、OperationType

は無視され、アップロードしたデータにより、指定していない SKU も含めてすべて上書きされる。

PurgeAndReplace 「true」を設定した場合、指定したデータにより現存の商品データは完全に上書きされる。ただし商

品関連フィードの場合のみ有効。(当フラグに「true」を設定した場合、OperationType は無視され

る。)

初めて PurgeAndReplace を使用する際は、テクニカルサポートに「セーフティネット」機能の解除

を依頼してください。この「セーフティネット」機能は、PurgeAndReplace により誤って出品情報

を削除することを防ぐためのものです。

注意:空データによる PurgeAndReplace フィードを実行した場合、出品情報は全てキャンセルされ

ます。この場合、商品情報は空のため Amazon.co.jp サイトの全ての出品情報はなくなり、出品用ア

カウントからも削除されます。

PurgeAndReplace を日常的に使用、または単に商品情報を変更するために使用することは避けてく

ださい。再作成された商品データにより元の販売履歴が削除され、Amazon.co.jp サイト上の検索結

果や表示に影響を与えることがあります。商品情報を削除する場合は、PurgeAndReplace ではな

く、商品削除(OperationType 「Delete」)を使用してください。

XSD

https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/amzn-envelope.xsd

<?xml version="1.0" encoding="UTF-8"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xsd:include schemaLocation="amzn-base.xsd"/> <xsd:include schemaLocation="amzn-header.xsd"/> <xsd:include schemaLocation="FulfillmentCenter.xsd"/> <xsd:include schemaLocation="Inventory.xsd"/> <xsd:include schemaLocation="OrderAcknowledgment.xsd"/> <xsd:include schemaLocation="OrderAdjustment.xsd"/> <xsd:include schemaLocation="OrderFulfillment.xsd"/> <xsd:include schemaLocation="OrderReport.xsd"/> <xsd:include schemaLocation="Override.xsd"/> <xsd:include schemaLocation="Price.xsd"/> <xsd:include schemaLocation="ProcessingReport.xsd"/> <xsd:include schemaLocation="Product.xsd"/> <xsd:include schemaLocation="ProductImage.xsd"/> <xsd:include schemaLocation="Relationship.xsd"/> <xsd:include schemaLocation="SettlementReport.xsd"/> <xsd:element name="AmazonEnvelope" /> <xsd:complexType> <xsd:sequence> <xsd:element ref="Header"/> <xsd:element name="MessageType"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="FulfillmentCenter"/> <xsd:enumeration value="Inventory"/> <xsd:enumeration value="OrderAcknowledgment"/> <xsd:enumeration value="OrderAdjustment"/> <xsd:enumeration value="OrderFulfillment"/> <xsd:enumeration value="OrderReport"/> <xsd:enumeration value="Override"/> <xsd:enumeration value="Price"/>

Page 10: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

6

<xsd:enumeration value="ProcessingReport"/> <xsd:enumeration value="Product"/> <xsd:enumeration value="ProductImage"/> <xsd:enumeration value="Relationship"/> <xsd:enumeration value="SettlementReport"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="PurgeAndReplace" type="xsd:boolean" minOccurs="0"/> <xsd:element name="EffectiveDate" type="xsd:dateTime" minOccurs="0"/> <xsd:element name="Message" maxOccurs="unbounded" /> <xsd:complexType> <xsd:sequence> <xsd:element name="MessageID" type="IDNumber"/> <xsd:element name="OperationType" minOccurs="0"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Update"/> <xsd:enumeration value="Delete"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:choice> <xsd:element ref="FulfillmentCenter"/> <xsd:element ref="Inventory"/> <xsd:element ref="OrderAcknowledgment"/> <xsd:element ref="OrderAdjustment"/> <xsd:element ref="OrderFulfillment"/> <xsd:element ref="OrderReport"/> <xsd:element ref="Override"/> <xsd:element ref="Price"/> <xsd:element ref="ProcessingReport"/> <xsd:element ref="Product"/> <xsd:element ref="ProductImage"/> <xsd:element ref="Relationship"/> <xsd:element ref="SettlementReport"/> </xsd:choice> </xsd:sequence> </xsd:complexType> </xsd:sequence> </xsd:complexType> </xs:schema>

Header スキーマ

説明

Header スキーマは、Envelope のフィードまたはメッセージに関する普遍データを指定するために使用されます。

ディクショナリ

エレメント名 説明

DocumentVersion 使用中のドキュメントのバージョン (Amazon ではバージョン 1.01のみサポート)

MerchantIdentifier 出品用アカウント作成時に Amazon より割り当てられる出品者用識別コード

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/amzn-header.xsd <?xml version="1.0" encoding="UTF-8"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xsd:include schemaLocation="amzn-base.xsd"/> <xsd:element name="Header"> <xsd:complexType>

Page 11: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

7

<xsd:sequence> <xsd:element name="DocumentVersion"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:pattern value="\d{1,2}\.\d{1,2}"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="MerchantIdentifier" type="String"/> </xsd:sequence> </xsd:complexType> </xsd:element> </xs:schema>

Base スキーマ

説明

Base XSD は、全データフィードにおいて普遍的に使用されるエレメントやデータタイプを指定するために使用され

ます。第一の目的は、将来的に XSD 定義に変更が生じた場合でも、全データフィード間に統一性を持たせることで

す。その他の XSD は全て、Base XSD エレメントおよびデータタイプを参照します。

注意:

CountryCode エレメントは、2文字の ISO 3166 国コードです。国コードの一覧は次

のサイトで確認できます。http://www.iso.org/iso/en/prods-

services/iso3166ma/02iso-3166-code-lists/list-en1.html

Name エレメントは、最高 50 文字まで入力可能な単一フィールドです。出品者のシ

ステム要件により、単一の当フィールドを姓と名に分けてください。

ディクショナリ

エレメント名 説明

AddressFieldOne 住所の 1行目

AddressFieldTwo 住所の 2行目

AddressFieldThree 住所の 3行目

AmazonOrderID Amazon で付与する注文の一意識別子

AmazonOrderItemCode Amazon で付与する注文商品の一意識別子

City 住所の都市名

CountryCode 住所の国別コード。ISO 3166 による標準 2桁国コード。

County 住所の郡名、米国住所のみ適応

FulfillmentCenterID 出品者が設定する、フルフィルメントセンターの一意識別子

FulfillmentMethod 購入者が指定した配送方法

FulfillmentServiceLevel 購入者が指定したフルフィルメントサービスの種類

MerchantOrderID 出品者が設定する注文の一意識別子

MerchantOrderItemID 出品者が設定する注文商品の一意識別子

MerchantPromotionID 出品者が設定するプロモーションの識別子、一意でなくてもよい

Page 12: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

8

PhoneNumber 住所の電話番号(該当する場合)

PostalCode 住所の郵便番号

ProductTaxCode 商品に適用すべき Amazon 標準の税コード

PromotionClaimCode 該当する注文に適用されるプロモーションを有効にするコード(購入者が入力)

SKU 出品者が設定する商品の一意識別子

StandardProductID 商品の標準かつ一意識別子で、タイプ(ISBN、UPC、または EAN)および各タイプ別フ

ォーマットに適合する値から構成される。

StateOrRegion 住所の県名

XSD

https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/amzn-base.xsd <?xml version="1.0" encoding="UTF-8"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xsd:annotation> <xsd:documentation> ################################################## # Address element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="Address" /> <xsd:complexType> <xsd:sequence> <xsd:element name="Name" type="String"/> <xsd:element name="AddressFieldOne" type="AddressLine"/> <xsd:element name="AddressFieldTwo" type="AddressLine" minOccurs="0"/> <xsd:element name="AddressFieldThree" type="AddressLine" minOccurs="0"/> <xsd:element name="City" type="String"/> <xsd:element name="County" type="String" minOccurs="0"/> <xsd:element name="StateOrRegion" type="String" minOccurs="0"/> <xsd:element name="PostalCode" type="String" minOccurs="0"/> <xsd:element name="CountryCode"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:minLength value="2"/> <xsd:maxLength value="2"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="PhoneNumber" type="String" minOccurs="0"/> </xsd:sequence> </xsd:complexType> <xsd:simpleType name="AddressLine"> <xsd:restriction base="xsd:normalizedString"> <xsd:maxLength value="60"/> </xsd:restriction> </xsd:simpleType> <xsd:annotation> <xsd:documentation> ################################################## # Amazon fees type ################################################## </xsd:documentation> </xsd:annotation> <xsd:complexType name="AmazonFees"> <xsd:sequence> <xsd:element name="Fee" maxOccurs="unbounded" /> <xsd:complexType> <xsd:sequence> <xsd:element name="Type"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Commission"/> </xsd:restriction>

Page 13: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

9

</xsd:simpleType> </xsd:element> <xsd:element name="Amount" type="CurrencyAmount"/> </xsd:sequence> </xsd:complexType> </xsd:sequence> </xsd:complexType> <xsd:annotation> <xsd:documentation> ################################################## # Buyer price type ################################################## </xsd:documentation> </xsd:annotation> <xsd:complexType name="BuyerPrice"> <xsd:sequence> <xsd:element name="Component" maxOccurs="unbounded" /> <xsd:complexType> <xsd:sequence> <xsd:element name="Type"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Principal"/> <xsd:enumeration value="Shipping"/> <xsd:enumeration value="Tax"/> <xsd:enumeration value="ShippingTax"/> <xsd:enumeration value="RestockingFee"/> <xsd:enumeration value="RestockingFeeTax"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="Amount" type="CurrencyAmount"/> </xsd:sequence> </xsd:complexType> </xsd:sequence> </xsd:complexType> <xsd:annotation> <xsd:documentation> ################################################## # Currency amount type ################################################## </xsd:documentation> </xsd:annotation> <xsd:complexType name="CurrencyAmount"> <xsd:simpleContent> <xsd:extension base="BaseCurrencyAmount"> <xsd:attribute name="currency" type="BaseCurrencyCode" use="required"/> </xsd:extension> </xsd:simpleContent> </xsd:complexType> <xsd:simpleType name="BaseCurrencyCode"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="USD"/> <xsd:enumeration value="GBP"/> <xsd:enumeration value="EUR"/> <xsd:enumeration value="JPY"/> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="BaseCurrencyAmount"> <xsd:restriction base="xsd:decimal"> <xsd:totalDigits value="20"/> <xsd:fractionDigits value="2" fixed="true"/> </xsd:restriction> </xsd:simpleType> <xsd:annotation> <xsd:documentation> ################################################## # Fulfillment center ID element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="FulfillmentCenterID" type="String"/> <xsd:annotation> <xsd:documentation> ################################################## # Fulfillment method element ################################################## </xsd:documentation> </xsd:annotation>

Page 14: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

10

<xsd:element name="FulfillmentMethod"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Ship"/> <xsd:enumeration value="InStorePickup"/> <xsd:enumeration value="MerchantDelivery"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:annotation> <xsd:documentation> ################################################## # Fulfillment service level element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="FulfillmentServiceLevel"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Standard"/> <xsd:enumeration value="Expedited"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:annotation> <xsd:documentation> ################################################## # ID Number type ################################################## </xsd:documentation> </xsd:annotation> <xsd:simpleType name="IDNumber"> <xsd:restriction base="xsd:positiveInteger"> <xsd:pattern value="\d{1,20}"/> </xsd:restriction> </xsd:simpleType> <xsd:annotation> <xsd:documentation> ################################################## # Long string type ################################################## </xsd:documentation> </xsd:annotation> <xsd:simpleType name="LongString"> <xsd:restriction base="xsd:normalizedString"> <xsd:maxLength value="500"/> </xsd:restriction> </xsd:simpleType> <xsd:annotation> <xsd:documentation> ################################################## # Merchant order ID element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="MerchantOrderID" type="String"/> <xsd:annotation> <xsd:documentation> ################################################## # Merchant order item ID element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="MerchantOrderItemID" type="String"/> <xsd:annotation> <xsd:documentation> ################################################## # Merchant promotion ID element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="MerchantPromotionID" type="String"/> <xsd:annotation> <xsd:documentation> ################################################## # Order ID element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="AmazonOrderID">

Page 15: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

11

<xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:pattern value="\d{3}-\d{7}-\d{7}"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:annotation> <xsd:documentation> ################################################## # Order item code element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="AmazonOrderItemCode"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:pattern value="\d{14}"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:annotation> <xsd:documentation> ################################################## # Standard Product ID element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="StandardProductID"> <xsd:complexType> <xsd:sequence> <xsd:element name="Type"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="ISBN"/> <xsd:enumeration value="UPC"/> <xsd:enumeration value="EAN"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="Value"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:minLength value="10"/> <xsd:maxLength value="13"/> </xsd:restriction> </xsd:simpleType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> <xsd:annotation> <xsd:documentation> ################################################## # Product tax code element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="ProductTaxCode" type="String"/> <xsd:annotation> <xsd:documentation> ################################################## # Promotion application type ################################################## </xsd:documentation> </xsd:annotation> <xsd:simpleType name="PromotionApplicationType"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Principal"/> <xsd:enumeration value="Shipping"/> </xsd:restriction> </xsd:simpleType> <xsd:annotation> <xsd:documentation> ################################################## # Promotion claim code ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="PromotionClaimCode"> <xsd:simpleType>

Page 16: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

12

<xsd:restriction base="xsd:string"> <xsd:minLength value="6"/> <xsd:maxLength value="12"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:annotation> <xsd:documentation> ################################################## # Promotion data type ################################################## </xsd:documentation> </xsd:annotation> <xsd:complexType name="PromotionDataType"> <xsd:sequence> <xsd:element ref="PromotionClaimCode"/> <xsd:element ref="MerchantPromotionID"/> <xsd:element name="Component" maxOccurs="unbounded" /> <xsd:complexType> <xsd:sequence> <xsd:element name="Type" type="PromotionApplicationType"/> <xsd:element name="Amount" type="CurrencyAmount"/> </xsd:sequence> </xsd:complexType> </xsd:sequence> </xsd:complexType> <xsd:annotation> <xsd:documentation> ################################################## # SKU element ################################################## </xsd:documentation> </xsd:annotation> <xsd:element name="SKU"> <xsd:simpleType> <xsd:restriction base="xsd:normalizedString"> <xsd:maxLength value="40"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:annotation> <xsd:documentation> ################################################## # String type ################################################## </xsd:documentation> </xsd:annotation> <xsd:simpleType name="String"> <xsd:restriction base="xsd:normalizedString"> <xsd:maxLength value="50"/> </xsd:restriction> </xsd:simpleType> </xs:schema>

Page 17: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

13

3. XML を使った出品管理

カタログ (商品) スキーマ

Amazon で使用する XML フィードを開発する際には、セラーセントラルのヘルプよりスキーマファイル(XSD)を取

得してください。スキーマファイルは、Amazon に送信されるフィードおよび Amazon で生成されるレポートのフ

ォーマットをまとめたものです。この章では、商品関連のフィードおよびレポートの定義と XSD について説明しま

す。

商品登録 – 商品フィードスキーマ

出品者 商品フィード Amazon

説明

商品フィード には、カタログ上の商品の説明が含まれます。この情報を元に Amazon は商品レコードを作成し、

ASIN (Amazon Standard Item Number)という一意識別子を商品ごとに割り当てます。Amazon に商品を出品する際、

まず初めに商品フィードを作成します。これにより、出品者固有の一意識別子(SKU)と Amazon 固有の一意識別子

(ASIN)との関連付けが行われます。

注意:

商品フィードは Amazon に商品を出品する際に初めに行うステップです。これ以降の各種フ

ィードは、商品フィードが成功した後に行ってください。

米国のみ

「Industrial」または「Scientific」カテゴリーに出品する場合(ただし事前に承認された米

国出品者のみ可能)、商品フィードスキーマではなく、アイテムフィードスキーマを使用

してください。

http://g-ecx.images-Amazon/images/G/01/rainier/help/xsd/release_1_9/Item.xsd

ディクショナリ

エレメント名 説明

SKU 商品を識別するために使用する識別子。各商品は個別の SKU を持ち、SKU は一意であるこ

Page 18: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

14

と。

StandardProductID 商品を特定する識別子で、タイプ(ISBN、UPC、または EAN)および各タイプ別フォーマ

ットに適合する値から構成される。Base XSD 上で StandardProductID のタイプを指定した

場合、必須のフィールド。

ProductTaxCode 商品に適用すべき Amazon 標準の税コード。商品フィード時に初めて指定され、その商品が

注文されると注文レポートに引き継がれる。

ヨーロッパ、日本では使用しない。

LaunchDate Amazon サイト上の検索結果や、ブラウズに商品が初めて表示される日付を制御

ReleaseDate 商品の販売開始日

Condition 商品のコンディション(コンディションタイプは Base XSD から取得)

Rebate Base XSD 上の RebateType で定義。

ヨーロッパ、日本では使用しない。

ItemPackageQuantity 一つのパッケージに含まれる同一商品の数。例えば靴下 10セットを販売する場合、10を設

定する。

NumberOfItems 個別に販売していない商品をセットで販売する場合、販売単位に含まれる商品の数。例えば

靴下 10セットを販売し、各セットには 3足の靴下が入っている場合、30を設定する。

DescriptionData Amazon 上に商品を登録するのに必要な情報で、以下の項目に分かれる。

Title - 商品名

Brand - 商品のブランド

Designer - 商品のデザイナー

Description - 商品の詳細説明

BulletPoint - 商品の概要

ItemDimensions - 商品の寸法

PackageDimensions - 商品パッケージ(外装箱)の寸法

PackageWeight - パッケージの重量

ShippingWeight – 梱包後の商品重量

MerchantCatalogNumber - 出品者の商品カタログ番号(SKU と異なる場合のみ)

MSRP - 製造者の希望小売価格

MaxOrderQuantity - 購入者が注文可能な商品数の上限

SerialNumberRequired - 商品にシリアル番号が必要かどうかの指定

Prop65 - 商品にカリフォルニアの prop65 制限適用が必要かどうかの指定。 カナダ、ヨ

ーロッパ、日本では使用しない。

LegalDisclaimer - 商品の免責事項

Manufacturer - 商品の製造者またはメーカー

MfrPartNumber - 製造者またはメーカーから付与される品番

SearchTerms -購入者が検索で使用すると想定される検索用語

PlatinumKeywords - カスタムブラウズストラクチャで商品とノードを紐付けるキーワー

RecommendedBrowseNode - 商品の表示を分類するための値(例:Shoes > Men’s

Shoes > Soccer Shoes)。 カナダ、ヨーロッパ、日本では必須項目だが、米国で

は使用しない。Amazon のブラウズツリーガイド(BTG)の詳細については、セラーセントラ

ル上のヘルプページを参照。

Memorabilia - 商品が記念品の場合使用

Autographed - 商品が著名人のサイン入りの場合使用

UsedFor - 商品の使用目的(Amazon ブラウズストラクチャー上の商品表示に影響あ

り)。 カナダ、ヨーロッパ、日本では使用しない。

ItemType - Amazon ブラウズストラクチャー上の商品の適切な位置を指定する定義済みの

OtherItemAttributes - Amazon ブラウズストラクチャー上の商品をさらに分類分けする場

合に使用

TargetAudience - Amazon ブラウズストラクチャー上の商品をさらに分類分けする場合に

使用

SubjectContent - 商品を特定の販売アイディアやコンセプトに関連付ける場合に使用

Page 19: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

15

IsGiftWrapAvailable - 商品がギフトラッピング対応可能であるかを指定

IsGiftMessageAvailable - 商品がギフトメッセージ対応可能であるかを指定

IsDiscontinuedByManufacturer - 製造者が商品の製造を停止している場合に指定

MaxAggregateShipQuantity - 同一パッケージで出荷可能な同一商品の上限数

ProductData バリエーションなどのカテゴリー固有の情報を設定するセクション。以下の XSD のうち一

つ以上の項目を指定する(ただし一つの商品に対しては一つのカテゴリーのみ指定可能)。 AutoAccessory Beauty CameraPhoto CE Clothing FoodAndBeverages Gourmet Health Home HomeImprovement Jewelry

Lighting Miscellaneous MusicalInstruments Office PetSupplies SoftwareVideoGames Sports TiresAndWheels Tools ToysBaby Wireless

商品カテゴリーによっては、Amazon サイト上の出品者に有効でないものもあるのでご注意

ください。商品カテゴリー固有の XSD ファイルは、そのカテゴリーが Amazon サイト上で

有効な場合に限り利用可能です。

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Product.xsd <?xml version="1.0" ?>

<! Revision="$Revision: #12 $" >

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amznbase.xsd" />

<xsd:include schemaLocation="ProductClothing.xsd" />

<xsd:include schemaLocation="Miscellaneous.xsd" />

<xsd:include schemaLocation="CameraPhoto.xsd" />

<xsd:include schemaLocation="Home.xsd" />

<xsd:include schemaLocation="Sports.xsd" />

<xsd:include schemaLocation="HomeImprovement.xsd" />

<xsd:include schemaLocation="Tools.xsd" />

<xsd:include schemaLocation="FoodAndBeverages.xsd" />

<xsd:include schemaLocation="Gourmet.xsd" />

<xsd:include schemaLocation="Jewelry.xsd" />

<xsd:include schemaLocation="Health.xsd" />

<xsd:include schemaLocation="CE.xsd" />

<xsd:include schemaLocation="SWVG.xsd" />

<xsd:include schemaLocation="Wireless.xsd" />

<xsd:include schemaLocation="Beauty.xsd" />

<xsd:include schemaLocation="Office.xsd" />

<xsd:include schemaLocation="MusicalInstruments.xsd" />

<xsd:include schemaLocation="AutoAccessory.xsd" />

<xsd:include schemaLocation="PetSupplies.xsd" />

<xsd:include schemaLocation="ToysBaby.xsd" />

<xsd:include schemaLocation="TiresAndWheels.xsd" />

<! Please read the corresponding documentation that contains the recommended values for UsedFor, ItemType,

OtherItemAttributes, TargetAudience, and SubjectContent.

>

<xsd:element name="Product">

<xsd:complexType>

Page 20: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

16

<xsd:sequence>

<xsd:element ref="SKU" />

<xsd:element ref="StandardProductID" minOccurs="0" />

<xsd:element ref="ProductTaxCode" minOccurs="0" />

<xsd:element name="LaunchDate" type="xsd:dateTime" minOccurs="0" />

<xsd:element name="DiscontinueDate" type="xsd:dateTime" minOccurs="0" />

<xsd:element name="ReleaseDate" type="xsd:dateTime" minOccurs="0" />

<xsd:element name="Condition" type="ConditionInfo" minOccurs="0" />

<xsd:element name="Rebate" type="RebateType" minOccurs="0" maxOccurs="2" />

<xsd:element name="ItemPackageQuantity" type="xsd:positiveInteger" minOccurs="0">

<xsd:annotation>

<xsd:documentation>Use this field to indicate the number of units included in the item you are offering for

sale, such that each unit is packaged for individual sale.</xsd:documentation>

</xsd:annotation>

</xsd:element>

<xsd:element name="NumberOfItems" type="xsd:positiveInteger" minOccurs="0">

<xsd:annotation>

<xsd:documentation>Use this field to indicate the number of discrete items included in the item you are

offering for sale, such that each item is not packaged for individual sale. For example, if you are selling a

case of 10 packages of socks, and each package contains 3 pairs of socks, the case would have

ItemPackageQuantity = 10 and NumberOfItems = 30.</xsd:documentation>

</xsd:annotation>

</xsd:element>

<xsd:element name="DescriptionData" minOccurs="0">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="Title" type="LongStringNotNull" />

<xsd:element name="Brand" type="StringNotNull" minOccurs="0" />

<xsd:element name="Designer" type="StringNotNull" minOccurs="0" />

<xsd:element name="Description" minOccurs="0">

<xsd:simpleType>

<xsd:restriction base="xsd:normalizedString">

<xsd:maxLength value="2000" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="BulletPoint" type="LongStringNotNull" minOccurs="0" maxOccurs="5" />

<xsd:element name="ItemDimensions" type="Dimensions" minOccurs="0" />

<xsd:element name="PackageDimensions" type="SpatialDimensions" minOccurs="0" />

<xsd:element name="PackageWeight" type="PositiveWeightDimension" minOccurs="0" />

<xsd:element name="ShippingWeight" type="PositiveWeightDimension" minOccurs="0" />

<xsd:element name="MerchantCatalogNumber" type="FortyStringNotNull" minOccurs="0" />

<xsd:element name="MSRP" type="CurrencyAmount" minOccurs="0" />

<xsd:element name="MaxOrderQuantity" type="xsd:positiveInteger" minOccurs="0" />

<xsd:element name="SerialNumberRequired" type="xsd:boolean" minOccurs="0" />

<xsd:element name="Prop65" type="xsd:boolean" minOccurs="0" />

<xsd:element name="CPSIAWarning" minOccurs="0" maxOccurs="4">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="choking_hazard_balloon" />

<xsd:enumeration value="choking_hazard_contains_a_marble" />

<xsd:enumeration value="choking_hazard_contains_small_ball" />

<xsd:enumeration value="choking_hazard_is_a_marble" />

<xsd:enumeration value="choking_hazard_is_a_small_ball" />

<xsd:enumeration value="choking_hazard_small_parts" />

<xsd:enumeration value="no_warning_applicable" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="CPSIAWarningDescription" type="TwoFiftyStringNotNull" minOccurs="0" />

<xsd:element name="LegalDisclaimer" minOccurs="0">

<xsd:simpleType>

<xsd:restriction base="xsd:normalizedString">

<xsd:maxLength value="1000" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="Manufacturer" type="StringNotNull" minOccurs="0" />

<xsd:element name="MfrPartNumber" type="FortyStringNotNull" minOccurs="0" />

<xsd:element name="SearchTerms" type="StringNotNull" minOccurs="0" maxOccurs="5" />

<xsd:element name="PlatinumKeywords" type="StringNotNull" minOccurs="0" maxOccurs="20" />

<xsd:element name="Memorabilia" type="xsd:boolean" minOccurs="0" />

<xsd:element name="Autographed" type="xsd:boolean" minOccurs="0" />

<xsd:element name="UsedFor" type="StringNotNull" minOccurs="0" maxOccurs="5" />

<xsd:element name="ItemType" type="LongStringNotNull" minOccurs="0" />

<xsd:element name="OtherItemAttributes" type="LongStringNotNull" minOccurs="0" maxOccurs="5" />

<xsd:element name="TargetAudience" type="StringNotNull" minOccurs="0" maxOccurs="3" />

<xsd:element name="SubjectContent" type="StringNotNull" minOccurs="0" maxOccurs="5" />

<xsd:element name="IsGiftWrapAvailable" type="xsd:boolean" minOccurs="0" />

<xsd:element name="IsGiftMessageAvailable" type="xsd:boolean" minOccurs="0" />

<xsd:element name="PromotionKeywords" type="StringNotNull" minOccurs="0" maxOccurs="10" />

Page 21: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

17

<xsd:element name="IsDiscontinuedByManufacturer" type="xsd:boolean" minOccurs="0" />

<xsd:element ref="DeliveryChannel" minOccurs="0" maxOccurs="2" />

<xsd:element name="MaxAggregateShipQuantity" type="xsd:positiveInteger" minOccurs="0" />

<! RecommendedBrowseNode and FEDAS_ID are for use by European merchants only.

>

<xsd:element name="RecommendedBrowseNode" type="xsd:positiveInteger" minOccurs="0" maxOccurs="2" />

<xsd:element name="FEDAS_ID" minOccurs="0">

<! Please do not include periods or delimiters.

>

<xsd:simpleType>

<xsd:restriction base="xsd:normalizedString">

<xsd:length value="6" fixed="true" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="DiscoveryData" minOccurs="0">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="Priority" minOccurs="0">

<xsd:simpleType>

<xsd:restriction base="xsd:positiveInteger">

<xsd:minInclusive value="1" />

<xsd:maxInclusive value="10" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="BrowseExclusion" type="xsd:boolean" minOccurs="0" />

<xsd:element name="RecommendationExclusion" type="xsd:boolean" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="ProductData" minOccurs="0">

<xsd:complexType>

<xsd:choice>

<xsd:element ref="Clothing" />

<xsd:element ref="Miscellaneous" />

<xsd:element ref="CameraPhoto" />

<xsd:element ref="Home" />

<xsd:element ref="Sports" />

<xsd:element ref="HomeImprovement" />

<xsd:element ref="Tools" />

<xsd:element ref="FoodAndBeverages" />

<xsd:element ref="Gourmet" />

<xsd:element ref="Jewelry" />

<xsd:element ref="Health" />

<xsd:element ref="CE" />

<xsd:element ref="SoftwareVideoGames" />

<xsd:element ref="Wireless" />

<xsd:element ref="Beauty" />

<xsd:element ref="Office" />

<xsd:element ref="MusicalInstruments" />

<xsd:element ref="AutoAccessory" />

<xsd:element ref="PetSupplies" />

<xsd:element ref="ToysBaby" />

<xsd:element ref="TiresAndWheels" />

</xsd:choice>

</xsd:complexType>

</xsd:element>

<xsd:element name="RegisteredParameter" minOccurs="0">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="PrivateLabel" />

<xsd:enumeration value="Specialized" />

<xsd:enumeration value="NonConsumer" />

<xsd:enumeration value="PreConfigured" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<!

##################################################

# Dimensions types

##################################################

>

<xsd:complexType name="Dimensions">

<xsd:sequence>

Page 22: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

18

<xsd:element name="Length" type="LengthDimension" minOccurs="0" />

<xsd:element name="Width" type="LengthDimension" minOccurs="0" />

<xsd:element name="Height" type="LengthDimension" minOccurs="0" />

<xsd:element name="Weight" type="WeightDimension" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

<xsd:complexType name="SpatialDimensions">

<xsd:sequence>

<xsd:element name="Length" type="LengthDimension" minOccurs="0" />

<xsd:element name="Width" type="LengthDimension" minOccurs="0" />

<xsd:element name="Height" type="LengthDimension" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:schema>

注意:

この例は、カナダ、ヨーロッパと日本の出品用アカウントでのみ使用可能な

RecommendedBrowseNode 情報を含んだものです。Amazon.com(米国)アカウントにおい

て当例を適用したい場合は、RecommendedBrowseNode の 2つのインスタンスを除外して

ください。

<?xml version="1.0" ?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>M_SELLER_354577</MerchantIdentifier>

</Header>

<MessageType>Product</MessageType>

<PurgeAndReplace>true</PurgeAndReplace>

<Message>

<MessageID>1</MessageID>

<OperationType>Update</OperationType>

<Product>

<SKU>1Z-500ABR-FLAT</SKU>

<ProductTaxCode>A_GEN_TAX</ProductTaxCode>

<LaunchDate>2005-07-26T00:00:01</LaunchDate>

<DescriptionData>

<Title>Lyric 500 tc Queen Flat Sheet, Ivory</Title>

<Brand>Peacock Alley</Brand>

<Description>Lyric sheeting by Peacock Alley is the epitome of simple and classic elegance. The flat sheets

and pillowcases feature a double row of hemstitching. The fitted sheets fit mattresses up to 21 inches deep.

The sheets are shown at left with tone on tone monogramming, please call for monogramming details and prices.

Please note, gift wrapping and overnight shipping are not available for this style.</Description>

<BulletPoint>made in Italy</BulletPoint>

<BulletPoint>500 thread count</BulletPoint>

<BulletPoint>plain weave (percale)</BulletPoint>

<BulletPoint>100% Egyptian cotton</BulletPoint>

<Manufacturer>Peacock Alley</Manufacturer>

<SearchTerms>bedding</SearchTerms>

<SearchTerms>Sheets</SearchTerms>

<ItemType>flat-sheets</ItemType>

<IsGiftWrapAvailable>false</IsGiftWrapAvailable>

<IsGiftMessageAvailable>false</IsGiftMessageAvailable>

<RecommendedBrowseNode>60583031</RecommendedBrowseNode>

<RecommendedBrowseNode>60576021</RecommendedBrowseNode>

</DescriptionData>

<ProductData>

<Home>

<Parentage>variation-parent</Parentage>

<VariationData>

<VariationTheme>Size-Color</VariationTheme>

</VariationData>

<Material>cotton</Material>

<ThreadCount>500</ThreadCount>

</Home>

</ProductData>

</Product>

</Message>

Page 23: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

19

<Message>

</AmazonEnvelope>

在庫数の更新 – 在庫フィードスキーマ

出品者 在庫フィード Amazon

説明

在庫フィードを使って、出品者は商品の在庫数(在庫レベル)を更新できます。

商品を Amazon のみに出品している場合、現在の在庫数を送信してください。販売チャネルを使用している場合、

出品者のシステムを設定して、販売可能在庫数が指定数より下回った場合には 0を送信するようにしてください。在

庫数が 0より大きい場合「ショッピングカートに入れる」ボタンが有効になり、注文が入るたびに在庫数から差し引

かれます。在庫数が 0になった場合、補充在庫数を送信するまでその商品は Amazon 上で販売できなくなります。

また在庫フィードは、商品ごとの出荷までのリードタイムを示すためにも使います。値を指定しなかった場合、リー

ドタイムはデフォルトの 2営業日になります。

ディクショナリ

エレメント名 説明

SKU 商品を識別するために使用。各商品は個別の SKU を持ち、SKU は一意であること。

FulfillmentCenterID 出品者独自で定義するフルフィルメントセンターの識別子

Available 商品が販売可能かどうかを指定(true = 販売可能、 false = 販売不可能)

注意:Quantity エレメントの代わりに使用され、米国の出品用アカウントのみ使用可能です。カナダ、ヨーロッパおよび日本の出品用アカウントでは、Quantity エレメントを使用してください。

Quantity 商品が販売可能かどうかを指定(正の数値 = 販売可能、 0 = 販売不可能)。 商品に対す

る Quantity を送信すると、現在の在庫数がフィードした数字で上書きされる。

注意:米国の出品用アカウントの場合、Available エレメントの代わりに使用可能です。カナダ、ヨーロッパおよび日本の出品用アカウントの場合、Quantity エレメントに数値を指定します。 「フルフィルメント by Amazon (FBA)」プログラムも利用している場合、「フルフィルメント by Amazon」マークの付いた商品に対して数値を指定すると、フルフィルメントステータスが「Fulfilled by Merchant」に変更されます。

RestockDate 在庫がない商品が再入荷する日付

FulfillmentLatency 注文されてから出荷するまでにかかる日数(1から 30までの整数)

SwitchFulfillmentTo 商品の出荷方法を MFN(出品者からの出荷)から AFN(Amazon からの出荷)に変更、ま

たはその逆に変更する場合のみ使用。

注意:AFN を指定できるのは、フルフィルメント by Amazon プログラムに登録している出品者のみです。

Page 24: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

20

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Inventory.xsd

<?xml version="1.0" ?>

<!- Revision="$Revision: #3 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="Inventory">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="SKU" />

<xsd:element ref="FulfillmentCenterID" minOccurs="0" />

<xsd:choice>

<xsd:element name="Available" type="xsd:boolean" />

<xsd:element name="Quantity" type="xsd:nonNegativeInteger" />

<xsd:element name="Lookup">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="FulfillmentNetwork" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:choice>

<xsd:element name="RestockDate" type="xsd:date" minOccurs="0" />

<xsd:element name="FulfillmentLatency" type="xsd:positiveInteger" minOccurs="0" />

<xsd:element name="SwitchFulfillmentTo" minOccurs="0">

<!-

Use this element if you are switching the

fulfillment method for your item.

If you are switching from AFN to MFN, use "MFN"

If you are switching from MFN to AFN, use "AFN"

-->

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="MFN" />

<xsd:enumeration value="AFN" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

例 <?xml version="1.0" encoding="utf-8" ?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>M_SELLER_354577</MerchantIdentifier>

</Header>

<MessageType>Inventory</MessageType>

<Message>

<MessageID>1</MessageID>

<OperationType>Update</OperationType>

<Inventory>

<SKU>ASUSVNA1</SKU>

<Quantity>8</Quantity>

<FulfillmentLatency>1</FulfillmentLatency>

</Inventory>

</Message>

<Message>

<MessageID>2</MessageID>

<OperationType>Update</OperationType>

<Inventory>

<SKU>ASUS8VM</SKU>

<Quantity>6</Quantity>

<FulfillmentLatency>1</FulfillmentLatency>

</Inventory>

</Message>

</AmazonEnvelope>

Page 25: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

21

フルフィルメント by Amazon (FBA)*

「フルフィルメント by Amazon (FBA)」プログラムをご利用の場合、在庫フィードを使って、商品の出荷方法を

MFN(出品者からの出荷)から AFN(Amazon からの出荷)に変更、またはその逆に変更できます。その場合、

FulfillmentCenterID を当該地域の FBA フルフィルメントセンターに置き換えます。

*カナダの出品者は FBA を利用できません。

例:商品を「Amazon からの出荷(AFN)」に変更 <?xml version="1.0" encoding="UTF-8"?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/amzn-envelope.xsd <DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>M_tokenhere_12345</MerchantIdentifier>

https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/amzn-envelope.xsd

MessageID <Message>

MessageID <OperationType>Update</OperationType>

<Inventory>

<SKU>2000578900007</SKU>

<FulfillmentCenterID>AMAZON_NA</FulfillmentCenterID>

<Lookup>FulfillmentNetwork</Lookup>

<SwitchFulfillmentTo>AFN</SwitchFulfillmentTo>

</Inventory>

</Message>

</AmazonEnvelope>

例:商品を「出品者からの出荷(MFN)」に変更 <?xml version="1.0" encoding="UTF-8"?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/amzn-envelope.xsd <DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>M_tokenhere_12345</MerchantIdentifier>

https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/amzn-envelope.xsd

MessageID <Message>

MessageID <OperationType>Update</OperationType>

<Inventory>

<SKU>12345</SKU>

<FulfillmentCenterID>DEFAULT</FulfillmentCenterID>

Quantity <SwitchFulfillmentTo>MFN</SwitchFulfillmentTo>

</Inventory>

</Message>

</AmazonEnvelope>

価格の登録 – 価格フィードスキーマ

出品者 価格フィード Amazon

Page 26: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

22

説明

価格フィードにより、商品の現在の販売価格とセール価格(該当する場合)を設定します。セール価格の設定はオプ

ションですが、指定する場合は開始日と終了日を必ず指定してください。

ディクショナリ

エレメント名 説明

SKU 商品を識別するために使用。各商品は個別の SKU を持ち、SKU は一意であるこ

と。

StandardPrice 商品の販売価格(セール価格ではない)

MAP 最低広告価格。製造メーカーの指定がある場合のみ使用。販売価格およびセール価

格(該当する場合)とも MAP より大きい値であること。

カナダ、ヨーロッパ、日本の出品用アカウントでは使用しない。

注意:MAP(非表示価格)の使用は、売上にマイナスの影響を与えることがあります。

Sale セールの日付と価格に関する情報で、以下の項目に分かれる。

StartDate –セール開始日

EndDate – セール終了日

SalePrice – セール価格

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Price.xsd <?xml version="1.0" ?>

<!- Revision="$Revision: #3 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="Price">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="SKU" />

<xsd:element name="StandardPrice" type="OverrideCurrencyAmount" />

<xsd:element name="MAP" type="OverrideCurrencyAmount" minOccurs="0" />

<xsd:element name="DepositAmount" type="CurrencyAmountWithDefault" minOccurs="0" />

<xsd:element name="Sale" minOccurs="0">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="StartDate" type="xsd:dateTime" />

<xsd:element name="EndDate" type="xsd:dateTime" />

<xsd:element name="SalePrice" type="OverrideCurrencyAmount" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="Previous" type="DatedPrice" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:simpleType name="BaseCurrencyCodeWithDefault">

<xsd:restriction base="xsd:string">

<xsd:enumeration value="USD" />

<xsd:enumeration value="GBP" />

<xsd:enumeration value="EUR" />

<xsd:enumeration value="JPY" />

<xsd:enumeration value="CAD" />

<xsd:enumeration value="DEFAULT" />

</xsd:restriction>

</xsd:simpleType>

<xsd:complexType name="CurrencyAmountWithDefault">

<xsd:simpleContent>

<xsd:extension base="BaseCurrencyAmount">

<xsd:attribute name="currency" type="BaseCurrencyCodeWithDefault" use="required" />

Page 27: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

23

</xsd:extension>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="OverrideCurrencyAmount">

<xsd:simpleContent>

<xsd:extension base="CurrencyAmountWithDefault">

<xsd:attribute name="zero" type="xsd:boolean" use="optional" />

</xsd:extension>

</xsd:simpleContent>

</xsd:complexType>

</xsd:schema>

注意:米国の Amazon Web サイト以外の場合、USD 通貨コードを自国の通貨コードに置き

換えてください。

2番目の例では、セール価格を設定する場合を示します。

<?xml version="1.0" encoding="utf-8" ?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>M_SELLER_354577</MerchantIdentifier>

</Header>

<MessageType>Price</MessageType>

<Message>

<MessageID>1</MessageID>

<Price>

<SKU>ASUSVNA1</SKU>

<StandardPrice currency="USD">10.99</StandardPrice>

</Price>

</Message>

<Message>

<MessageID>2</MessageID>

<Price>

<SKU>ASUSVNA1669</SKU>

<StandardPrice currency="USD">204.99</StandardPrice>

Sale <StartDate>2008-10-01T00:00:00Z</StartDate>

<EndDate>2009-01-31T00:00:00Z</EndDate>

<SalePrice currency="USD">28.38</SalePrice>

</Sale>

</Price>

</Message>

</AmazonEnvelope>

商品画像の送信 – 画像フィードスキーマ

出品者 画像フィード Amazon

説明

画像フィードを使って、 商品の様々な画像をアップロードします。Amazon サイトでは、商品ごとに複数の画像が

表示できます。商品ごとに高解像度の画像を複数掲載することにより、顧客が購入を検討するための十分な情報を提

供することができます。

商品画像には以下の 3種類があります。

Page 28: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

24

メイン画像 – Amazon サイト上の商品メインページに表示される画像

その他の画像 – 商品を別の角度から撮影した画像などで、メイン画像の下に表示され、クリック可能

見本画像 – 商品の色違いや素材違いなど、商品のバリエーションによる違いを示す画像

注意:画像フィードを処理中、Amazon が画像を取得できるよう、パスワード認証不要な

Web サーバー上に画像を置いてください。各画像は、http://mystore.com/images/1234.jpg

のように完全な URL で指定してください。Amazon はセキュア URL(https)で指定された画像

にはアクセスできません。必ず http で始まる URL を指定してください。

画像の必要条件

フォーマット – 図や絵ではなく写真であること

カラーモデル – RGB(CMYK は不可)

背景 – 白または透明、枠なし、テキストの混在なし、ブランドロゴなし

最少サイズ - 幅または高さ 110ピクセル

推奨サイズ - 500 x 500 ピクセル(幅または高さのうち、短い方が 110ピクセル以上、長い方が 2,100ピ

クセル以下であること)

ファイルタイプ – JPEG (.jpg)または GIF (.gif)

解像度 – 72ピクセル/インチ

アニメーション – 不可

注意:上記の条件を満たさない画像は、却下されるか、または Amazon サイト上で正しく表

示されない場合があります。

ディクショナリ

エレメント名 説明

SKU 商品を識別するために使用。各商品は個別の SKU を持ち、SKU は一意であること。

ImageType 画像の種類(Main、Alternate、Swatch)

Main – 商品のメイン画像

Alternate (PT) – 商品のその他の画像

Swatch – 色違いまたは素材の違い(注意:Swatch 画像は 25 x 25ピクセルに縮小さ

れます。色の違いや素材の違いを示すもので、商品全体を表示するものではありませ

ん。)

ImageLocation 画像の参照先を完全な URLで指定。(例:http://mystore.com/images/1234.jpg)

Amazon はセキュア URL (https)で指定された画像にはアクセスできないので、http で

始まる URL を指定すること。

XSD https://images-na.ssl-images-amazon.com/imagesG/01/rainier/help/xsd/release_1_9/ProductImage.xsd

<?xml version="1.0" ?>

<!- Revision="$Revision: #5 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="ProductImage">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="SKU" />

<xsd:element name="ImageType">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

Page 29: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

25

<xsd:enumeration value="Main" />

<xsd:enumeration value="Swatch" />

<xsd:enumeration value="PT1" />

<xsd:enumeration value="PT2" />

<xsd:enumeration value="PT3" />

<xsd:enumeration value="PT4" />

<xsd:enumeration value="PT5" />

<xsd:enumeration value="PT6" />

<xsd:enumeration value="PT7" />

<xsd:enumeration value="PT8" />

<xsd:enumeration value="Search" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="ImageLocation" type="xsd:anyURI" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

例 <?xml version="1.0" encoding="utf-8" ?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>M_SELLER_354577</MerchantIdentifier>

</Header>

<MessageType>ProductImage</MessageType>

<Message>

<MessageID>1</MessageID>

<OperationType>Update</OperationType>

<ProductImage>

<SKU>ASUSVNA1</SKU>

<ImageType>Main</ImageType>

<ImageLocation>http://www.abc.com/images/ASUSVNA1.gif</ImageLocation>

</ProductImage>

</Message>

<Message>

<MessageID>2</MessageID>

<OperationType>Update</OperationType>

<ProductImage>

<SKU>ASUSVNA1987/4G</SKU>

<ImageType>Main</ImageType>

<ImageLocation>http://www.abc.com/images/ASUSVNA1987.jpg</ImageLocation>

</ProductImage>

</Message>

</AmazonEnvelope>

商品関連性の登録 - 関連性フィードスキーマ (カテゴリーにより使用可能)

出品者 関連性フィード Amazon

説明

関連性フィードにより、カタログ上の商品どうしの関連性をオプションで設定できます。関連性には以下の 2種類が

あります。

1. バリエーション – 最も一般的に設定される関連性です。これにより、顧客が商品のバリエーション リスト

から選択できるようになります。例えばシャツの場合、各種サイズと色が選択できます。一般的には、メイ

ンの商品(親 SKU)がシャツの種類になります。メインの商品は、サイズ、色、価格、数の情報を持たず、

購入対象ではありません。バリエーション(子 SKU)は異なるサイズや色のシャツの組み合わせで、購入

Page 30: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

26

対象です。(以下の図を参照)

新しく親子関係を作成するために関連性フィードを行う前に、その SKU の商品情報をアップロードします。

まず、Parentage エレメントを用いて親(「parent」)となる商品(SKU)を指定し、VariationTheme エレ

メントで子となる商品(SKU)のバリエーションのテーマ(例:サイズ、サイズと色)を指定します 。同様

に、Parentage エレメントを用いてそれぞれの子 SKU を指定し、親 SKU と同様の VariationTheme を指定

します。

バリエーションのテーマ、およびその属性(例:バリエーションテーマ「サイズと色」に対するサイズと

色)は、商品フィードで指定してください。関連性フィードでは、親商品と子商品の関連性を指定するだけ

です。

注意:各カテゴリーには、それぞれ固有のバリエーションの要件があります。カテゴリー固

有のバリエーションによる関連性の設定方法については、商品 XSD を参照してください。

2. アクセサリ – ある商品を他の商品のアクセサリとして設定します。例えば、エレクトロニクスの商品であ

るポータブルラジオに、電池や外部スピーカーをアクセサリとして登録できます。同様に、手袋を帽子のア

クセサリとして登録できます。

親 子

ディクショナリ

エレメント名 説明

ParentSKU バリエーションのある商品が関連付けられている親の SKU

Relation 子 SKU と関連性の種類を示し、以下の項目に分かれる。

Page 31: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

27

SKU – 個別の商品を識別するために使用、親 SKU のバリエーション(子)

Type – 関連性の種類で、バリエーション(variation)またはアクセサリ(accessory)を指

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Relationship.xsd

<!- Revision="$Revision: #1 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="Relationship">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="ParentSKU" type="SKUType" />

<xsd:element name="Relation" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="SKU" />

<xsd:element name="Type">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="Variation" />

<xsd:enumeration value="DisplaySet" />

<xsd:enumeration value="Collection" />

<xsd:enumeration value="Accessory" />

<xsd:enumeration value="Customized" />

<xsd:enumeration value="Part" />

<xsd:enumeration value="Complements" />

<xsd:enumeration value="Piece" />

<xsd:enumeration value="Necessary" />

<xsd:enumeration value="ReplacementPart" />

<xsd:enumeration value="Similar" />

<xsd:enumeration value="Episode" />

<xsd:enumeration value="Season" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

例 (バリエーション) <?xml version="1.0" encoding="utf-8" ?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>M_SELLER_354577</MerchantIdentifier>

</Header>

<MessageType>Relationship</MessageType>

<Message>

<MessageID>1</MessageID>

<OperationType>Update</OperationType>

<Relationship>

<ParentSKU>5555_5556</ParentSKU>

<Relation>

<SKU>555540352</SKU>

<Type>Variation</Type>

</Relation>

<Relation>

<SKU>555685952</SKU>

<Type>Variation</Type>

</Relation>

<Relation>

<SKU>555690352</SKU>

<Type>Variation</Type>

</Relation>

Page 32: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

28

<Relation>

<SKU>555690552</SKU>

<Type>Variation</Type>

</Relation>

<Relation>

<SKU>555690752</SKU>

<Type>Variation</Type>

</Relation>

<Relation>

<SKU>555690952</SKU>

<Type>Variation</Type>

</Relation>

</Relationship>

</Message>

</AmazonEnvelope>

例 (アクセサリ) <?xml version="1.0" encoding="utf-8" ?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>M_SELLER_354577</MerchantIdentifier>

</Header>

<MessageType>Relationship</MessageType>

<Message>

<MessageID>1</MessageID>

<OperationType>Update</OperationType>

<Relationship>

<ParentSKU>ASUSVNA1</ParentSKU>

<Relation>

<SKU>ASUSVNA198714G</SKU>

<Type>Accessory</Type>

</Relation>

</Relationship>

</Message>

<Message>

<MessageID>2</MessageID>

<OperationType>Update</OperationType>

<Relationship>

<ParentSKU>FUJI32XD </ParentSKU>

<Relation>

<SKU>ALPSCARD0024</SKU>

<Type>Accessory</Type>

</Relation>

</Relationship>

</Message>

</AmazonEnvelope>

配送料の上書き – 配送料上書きフィードスキーマ (オプション)

出品者 配送料上書きフィード Amazon

説明

配送料上書きフィードにより、個別の商品(SKU)に対して、出品アカウントレベルの出荷設定に例外を設定できます。

例えばカヤックや自動車用バンパーのように、重量やサイズが大きな商品や変わった形の商品に適用します。出荷設

定を上書きする方法には以下の 3種類があります。

Exclusive – ある SKU に対して、現在の出品アカウントレベルの配送料を新しい配送料で置き換える

Additive – ある SKU に対して、現在の出品アカウントレベルの配送料に追加料金を加算する

Restrictive – ある SKU に対して、配送地域や配送オプションを制限する

Page 33: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

29

ディクショナリ

エレメント名 説明

SKU 商品を識別するために使用。各商品は個別の SKU を持ち、SKU は一意であること。

ShippingOverride 配送料上書き情報で、以下の項目に分かれる。

ShipOption – 配送地域および配送オプション

IsShippingRestricted – 配送オプションを使用して SKU の配送可能または不可地域

を明示する。「true」を設定すると、指定した配送オプションを使った特定の地域へ配

送することができない。

Type – SKU に適用される配送料上書きの種類(Additive または Exclusive)

ShipAmount – 追加する、または置き換える配送料

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Override.xsd

<?xml version="1.0" ?>

- <!- Revision="$Revision: #2 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="Override">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="SKU" />

<xsd:element name="ShippingOverride" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="ShipOption" />

<xsd:choice>

<xsd:element name="IsShippingRestricted" type="xsd:boolean" />

<xsd:sequence>

<xsd:element name="Type">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="Additive" />

<xsd:enumeration value="Exclusive" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="ShipAmount" type="CurrencyAmount" />

</xsd:sequence>

</xsd:choice>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

例 (米国) <AmazonEnvelope xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">

<Header>

<DocumentVersion>1.02</DocumentVersion>

<MerchantIdentifier>M_SELLER_354577</MerchantIdentifier>

</Header>

<MessageType>Override</MessageType>

<Message>

<MessageID>1</MessageID>

<OperationType>Update</OperationType>

<Override>

<SKU>487-6</SKU>

<ShippingOverride>

<ShipOption>Std Alaska Hawaii PO Box</ShipOption>

<IsShippingRestricted>true</IsShippingRestricted>

</ShippingOverride>

</Override>

</Message>

Page 34: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

30

<Message>

<MessageID>2</MessageID>

<OperationType>Update</OperationType>

<Override>

<SKU>487-5</SKU>

<ShippingOverride>

<ShipOption>Exp Alaska Hawaii PO Box</ShipOption>

<IsShippingRestricted>false</IsShippingRestricted>

<Type>Additive</Type>

<ShipAmouunt currency="USD">20.00</ShipAmouunt>

</ShippingOverride>

</Override>

</Message>

</AmazonEnvelope>

処理結果の確認 - 処理レポート

説明

処理レポートを使って、アップロードに成功したドキュメントの処理ステータスを検索できます。レポートには、処

理が完了したドキュメントに関するエラーメッセージや警告メッセージと共に、各メッセージへの対応方法が表示さ

れます。

ディクショナリ

エレメント名 説明

DocumentTransactionID 出品者がステータスを読み込み中のドキュメントを特定する個別の番号。アップロード時に

確認の一部として提供される。

StatusCode アップロードが成功したか失敗したかを示す。ステータスが「Processing」でない場合、処

理は正常に終了していないことを示し、レスポンスに FeedReport エレメントが含まれる。

エラーまたは警告のみがレポートされる。

Processing Summary 処理情報を示し、以下の項目に分かれる。

MessagesProcessed – ステータス(success、error、warning)に関わらず、処理されたメ

ッセージの総数

MessagesSuccessful – 処理が完了したメッセージ総数

MessagesWithError - エラーになり処理が完了しなかったメッセージ総数

MessagesWithWarning - 処理は完了したが問題が発生した可能性を示す警告を受けたメ

ッセージ総数

Result エラーおよび警告情報で、以下の項目に分かれる。

MessageID - エラーまたは警告メッセージを識別する一意の番号.

ResultCode – 指定したメッセージが「エラー」か「警告」かを示す。成功した場合はレ

ポートされない。

ResultMessageCode - エラーまたは警告を識別するコードで、ResultDescription を取得

する際に使用

ResultDescription – エラーまたは警告の内容を示す

AdditionalInfo Container – エラーや警告を調査する上で役立つ補足情報で、以下の項目

を含む。

SKU FulfillmentCenterID AmazonOrderID AmazonOrderItemCode

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/ProcessingReport.xsd

Page 35: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

31

<?xml version="1.0" ?>

<!- Revision="$Revision: #2 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="ProcessingReport">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="DocumentTransactionID" type="IDNumber" />

<xsd:element name="StatusCode">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="Complete" />

<xsd:enumeration value="Processing" />

<xsd:enumeration value="Rejected" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="ProcessingSummary" minOccurs="0">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="MessagesProcessed" type="xsd:nonNegativeInteger" />

<xsd:element name="MessagesSuccessful" type="xsd:nonNegativeInteger" />

<xsd:element name="MessagesWithError" type="xsd:nonNegativeInteger" />

<xsd:element name="MessagesWithWarning" type="xsd:nonNegativeInteger" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="Result" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="MessageID">

<xsd:simpleType>

<xsd:restriction base="xsd:nonNegativeInteger">

<xsd:pattern value="\d{1,20}" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="ResultCode">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="Error" />

<xsd:enumeration value="Warning" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="ResultMessageCode" type="IDNumber" />

<xsd:element name="ResultDescription" type="xsd:string" />

<xsd:element name="AdditionalInfo" minOccurs="0">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="SKU" minOccurs="0" />

<xsd:element ref="FulfillmentCenterID" minOccurs="0" />

<xsd:element ref="AmazonOrderID" minOccurs="0" />

<xsd:element ref="AmazonOrderItemCode" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

例 <?xml version="1.0" encoding="UTF-8" ?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

<Header>

<DocumentVersion>1.02</DocumentVersion>

<MerchantIdentifier>M_SELLER_354577</MerchantIdentifier>

</Header>

<MessageType>ProcessingReport</MessageType>

<Message>

<MessageID>1</MessageID>

Page 36: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

32

<ProcessingReport>

<DocumentTransactionID>2243419999</DocumentTransactionID>

<StatusCode>Complete</StatusCode>

<ProcessingSummary>

<MessagesProcessed>15</MessagesProcessed>

<MessagesSuccessful>12</MessagesSuccessful>

<MessagesWithError>3</MessagesWithError>

<MessagesWithWarning>0</MessagesWithWarning>

</ProcessingSummary>

<StatusCode>Complete</StatusCode>

<ProcessingSummary>

<MessagesProcessed>15</MessagesProcessed>

<MessagesSuccessful>12</MessagesSuccessful>

<MessagesWithError>3</MessagesWithError>

<MessagesWithWarning>0</MessagesWithWarning>

</ProcessingSummary>

<Result>

<MessageID>4</MessageID>

<ResultCode>Error</ResultCode>

<ResultMessageCode>8123</ResultMessageCode>

<ResultDescription>The item with SKU 1288 cannot be modified because it matches a deleted item. For more

information, please refer to http://sellercentral.amazon.com/gp/help.</ResultDescription>

<AdditionalInfo>

<SKU>1288</SKU>

</AdditionalInfo>

</Result>

<Result>

<MessageID>5</MessageID>

<ResultCode>Error</ResultCode>

<ResultMessageCode>8123</ResultMessageCode>

<ResultDescription>The item with SKU 1265 cannot be modified because it matches a deleted item. For more

information, please refer to http://sellercentral.amazon.com/gp/help.</ResultDescription>

<AdditionalInfo>

<SKU>1265</SKU>

</AdditionalInfo>

</Result>

<Result>

<MessageID>7</MessageID>

<ResultCode>Error</ResultCode>

<ResultMessageCode>8123</ResultMessageCode>

<ResultDescription>The item with SKU 1266 cannot be modified because it matches a deleted item. For more

information, please refer to http://sellercentral.amazon.com/gp/help.</ResultDescription>

<AdditionalInfo>

<SKU>1266SKU>

</AdditionalInfo>

</Result>

</ProcessingReport>

</Message>

</AmazonEnvelope>

Page 37: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

33

4. XML を使った注文管理

注文・フルフィルメントスキーマ

Amazon で使用する XML フィードを開発する際には、セラーセントラルのヘルプよりスキーマファイル(XSD)を取

得してください。スキーマファイルは、Amazon に送信されるフィードおよび Amazon で生成されるレポートのフ

ォーマットをまとめたものです。この章では、注文関連のフィードおよびレポートの定義と XSD について説明しま

す。

注文詳細の取得 – 注文レポート

出品者 Amazon注文レポート

説明

注文レポートを取得すると、前回注文レポートを生成後に新しく受注した注文のリストが取得できます。注文レポー

トには、注文を処理する上で必要な全ての情報が含まれます。出品用アカウント作成時に、注文レポートの生成頻度

(毎日、毎時など)を定義します。注文レポートは最高で 15分に 1回の頻度で生成可能です。

注意:初期設定では、注文レポートは XML フォーマットではありません。注文レポートを

XML フォーマットで生成するには、セラーセントラルの画面下部の「テクニカルサポートへ

の問い合せ」リンクからお問い合せいただき、アカウントに対する XML フォーマット作成

オプションの設定を依頼してください。

ディクショナリ

エレメント名 説明

AmazonOrderID 注文を識別する Amazon 独自の識別子。この番号で、一回の注文で発注した商品の個数にか

かわらず、注文全体を特定する。

AmazonSessionID 同一購買セッション中の個々の注文を束ねるために発行する Amazon 独自の識別子

(Amazon の内部で使用)

OrderDate 発注日

OrderPostedDate 購入者のクレジットカードへの課金、および注文処理が完了した日付

BillingData

FulfillmentData 注文のフルフィルメント情報。以下の情報を含む。

FulfillmentMethod (配送方法)

FulfillmentServiceLevel(配送サービスレベル)

Address コンテナ

Page 38: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

34

Name(名前)

AddressFieldOne(住所 1)

AddressFieldTwo(住所 2)

City(都市)

StateOrRegion(県)

PostalCode(郵便番号)

CountryCode(国番号)

カナダの出品者は FBA を利用できません。

AmazonOrderItemCode 注文内の商品を特定する、Amazon 独自の一意識別子

SKU 出品者が管理する商品ごとの一意識別子

Title 商品の概要説明

Quantity 購入された商品の数量

ProductTaxCode 商品に適用すべき Amazon 標準の税コード。商品フィード時に初めて指定され、その商品が

注文されると注文レポートに引き継がれる。

ItemPrice タイプごとに商品に対して購入者が支払った金額。合計金額は単価ではなく購入数分の合

計。以下の項目を含む。

Principal(商品代金)

Shipping(配送料)

Tax(税金)

ShippingTax(配送料に対する税金)

ItemFees 該当する商品に対して出品者が Amazon に支払った手数料の金額。以下の項目を含む。

Commission(手数料)

TaxJurisdictions 税金の管轄地域情報。以下の項目を含む。

TaxLocationCode(課税ロケーションコード)

City(都市)

County(郡)

State(州)

米国の出品用アカウントのみ使用可能

TaxableAmounts 税金の管轄地域ごとの課税対象と認められる金額。出品者の集金設定と連動する商品課税規

定に基づいて計算された課税額。以下の項目を含む。

District(地域)

City(都市)

County(郡)

State(州)

米国の出品用アカウントのみ使用可能

NonTaxableAmounts 税金の管轄地域ごとの非課税対象と認められる金額。出品者の集金設定と連動する商品課税

規定に基づいて計算された非課税額。以下の項目を含む。

District(地域)

City(都市)

County(郡)

State(州)

米国の出品用アカウントのみ使用可能

ZeroRatedAmounts 税率 0%地域に紐付く税金の管轄地域ごとの金額。以下の項目を含む。

District(地域)

Page 39: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

35

City(都市)

County(郡)

State(州)

米国の出品用アカウントのみ使用可能

TaxCollectedAmounts 税金の管轄地域ごとの、回収された税金の金額。以下の項目を含む。

District(地域)

City(都市)

County(郡)

State(州)

米国の出品用アカウントのみ使用可能

TaxRates 税金の管轄地域ごとの、地域、都市、郡、州などの税率。以下の項目を含む。

District(地域)

City(都市)

County(郡)

State(州)

米国の出品用アカウントのみ使用可能

PromotionClaimCode プロモーション特典を得るために会計時に購入者が入力したコード

MerchantPromotionID 出品者がプロモーションを追跡するための ID

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/OrderReport.xsd

<?xml version="1.0" ?>

<!- "$Revision: #10 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="OrderReport">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="AmazonOrderID" />

<xsd:element name="AmazonSessionID">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:pattern value="\d{3}-\d{7}-\d{7}" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="OrderDate" type="xsd:dateTime" />

<xsd:element name="OrderPostedDate" type="xsd:dateTime" />

<xsd:element name="TransactionDate" type="xsd:dateTime" minOccurs="0" />

<xsd:element name="TaxCalculationDate" type="xsd:dateTime" minOccurs="0" />

<xsd:element name="CustomerOrderInfo" minOccurs="0" maxOccurs="10">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="Type" type="StringNotNull" />

<xsd:element name="Value" type="StringNotNull" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="BillingData">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="BuyerEmailAddress">

<xsd:simpleType>

<xsd:restriction base="xsd:normalizedString">

<xsd:pattern value="[^@]+@[^@\.]+(\.[^@\.]+)+" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="BuyerName" type="String" />

Page 40: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

36

<xsd:element name="BuyerPhoneNumber" type="String" />

<xsd:element name="CreditCard" minOccurs="0">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="Issuer">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="Visa" />

<xsd:enumeration value="MasterCard" />

<xsd:enumeration value="AmericanExpress" />

<xsd:enumeration value="Discover" />

<xsd:enumeration value="DinersClub" />

<xsd:enumeration value="JCB" />

<xsd:enumeration value="PrivateLabel" />

<xsd:enumeration value="BankDebit" />

<xsd:enumeration value="CarteBlanche" />

<xsd:enumeration value="CarteBancaire" />

<xsd:enumeration value="PaymentByInvoice" />

<xsd:enumeration value="Laser" />

<xsd:enumeration value="Switch" />

<xsd:enumeration value="SVS" />

<xsd:enumeration value="BordersECG" />

<xsd:enumeration value="Other" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="Tail">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:pattern value="\d{4}" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="ExpirationDate" type="xsd:gYearMonth" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element ref="Address" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="FulfillmentData">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="FulfillmentMethod" />

<xsd:element ref="FulfillmentServiceLevel" minOccurs="0" />

<xsd:element ref="FulfillmentCenterID" minOccurs="0" />

<xsd:element ref="Address" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="OtherAddresses" minOccurs="0">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="Address" type="TaxAddressType" maxOccurs="5" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="Item" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="AmazonOrderItemCode" />

<xsd:element ref="SKU" />

<xsd:element name="Title" type="LongString" />

<xsd:element name="CustomizationInfo" type="CustomizationInfoType" minOccurs="0" maxOccurs="unbounded" />

<xsd:element name="Quantity" type="xsd:positiveInteger" />

<xsd:element ref="ProductTaxCode" minOccurs="0" />

<xsd:element name="DeliveryStartDate" type="xsd:dateTime" minOccurs="0" />

<xsd:element name="DeliveryEndDate" type="xsd:dateTime" minOccurs="0" />

<xsd:element name="DeliveryTimeZone" type="StringNotNull" minOccurs="0" />

<xsd:element name="DeliveryInstructions" type="LongStringNotNull" minOccurs="0" />

<xsd:element name="ItemPrice" type="BuyerPrice" />

<xsd:element name="ItemFees" type="AmazonFees" />

<xsd:element name="ItemTaxData" type="TaxData" minOccurs="0" />

<xsd:element name="ShippingTaxData" type="TaxData" minOccurs="0" />

<xsd:element name="GiftWrapTaxData" type="TaxData" minOccurs="0" />

<xsd:element name="Promotion" minOccurs="0" maxOccurs="unbounded" type="TaxablePromotionType" />

<xsd:element name="GiftWrapLevel" type="StringNotNull" minOccurs="0" />

<xsd:element name="GiftMessageText" minOccurs="0">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

Page 41: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

37

<xsd:maxLength value="500" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<!-

##################################################

# Tax data type

##################################################

-->

<xsd:complexType name="TaxData">

<xsd:sequence>

<xsd:element ref="ProductTaxCode" minOccurs="0" />

<xsd:element name="FinancialAmounts" type="FinancialAmountsType" minOccurs="0" />

<xsd:element name="TaxJurisdictions" type="TaxJurisdictionType" />

<xsd:element name="TaxableAmounts" type="TaxDataSubtype" minOccurs="0" />

<xsd:element name="NonTaxableAmounts" type="TaxDataSubtype" minOccurs="0" />

<xsd:element name="ZeroRatedAmounts" type="TaxDataSubtype" minOccurs="0" />

<xsd:element name="TaxCollectedAmounts" type="TaxDataSubtype" />

<xsd:element name="TaxRates">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="District" type="TaxRate" minOccurs="0" />

<xsd:element name="City" type="TaxRate" minOccurs="0" />

<xsd:element name="County" type="TaxRate" minOccurs="0" />

<xsd:element name="State" type="TaxRate" minOccurs="0" />

<xsd:element name="Country" type="TaxRate" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

<!-

##################################################

# Tax jurisdiction type

##################################################

-->

<xsd:complexType name="TaxJurisdictionType">

<xsd:sequence>

<xsd:element name="TaxLocationCode" type="String" minOccurs="0" />

<xsd:element name="City" type="String" minOccurs="0" />

<xsd:element name="County" type="String" minOccurs="0" />

<xsd:element name="State" type="String" minOccurs="0" />

<xsd:element name="Country" minOccurs="0">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:minLength value="2" />

<xsd:maxLength value="2" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

<!-

##################################################

# Tax address type

##################################################

-->

<xsd:complexType name="TaxAddressType">

<xsd:sequence>

<xsd:element name="AddressRole">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="ShipFrom" />

<xsd:enumeration value="BillTo" />

<xsd:enumeration value="SellerPrimary" />

<xsd:enumeration value="BuyerPrimary" />

<xsd:enumeration value="Middleman" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="City" type="String" />

<xsd:element name="County" type="String" minOccurs="0" />

Page 42: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

38

<xsd:element name="StateOrRegion" type="String" minOccurs="0" />

<xsd:element name="PostalCode" type="String" minOccurs="0" />

<xsd:element name="PostalCodeExtension" type="String" minOccurs="0" />

<xsd:element name="CountryCode">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:minLength value="2" />

<xsd:maxLength value="2" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

<!-

##################################################

# Tax data sub type

##################################################

-->

<xsd:complexType name="TaxDataSubtype">

<xsd:sequence>

<xsd:element name="District" type="CurrencyAmount" minOccurs="0" />

<xsd:element name="DistrictDetails" type="TaxDetailsType" minOccurs="0" />

<xsd:element name="City" type="CurrencyAmount" minOccurs="0" />

<xsd:element name="CityDetails" type="TaxDetailsType" minOccurs="0" />

<xsd:element name="County" type="CurrencyAmount" minOccurs="0" />

<xsd:element name="CountyDetails" type="TaxDetailsType" minOccurs="0" />

<xsd:element name="State" type="CurrencyAmount" minOccurs="0" />

<xsd:element name="StateDetails" type="TaxDetailsType" minOccurs="0" />

<xsd:element name="Country" type="CurrencyAmount" minOccurs="0" />

<xsd:element name="CountryDetails" type="TaxDetailsType" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

<!-

##################################################

# Tax details type

##################################################

-->

<xsd:complexType name="TaxDetailsType">

<xsd:sequence>

<xsd:element name="ReportName" type="StringNotNull" />

<xsd:element name="AuthorityType" type="StringNotNull" />

<xsd:element name="AuthorityName" type="StringNotNull" />

<xsd:element name="TaxableBasis" type="CurrencyAmount" />

<xsd:element name="NonTaxableBasis" type="CurrencyAmount" />

<xsd:element name="TaxDirection" type="StringNotNull" />

<xsd:element name="ExemptReasonCode" type="StringNotNull" minOccurs="0" />

<xsd:element name="BuyerExemptionCertificate" type="StringNotNull" minOccurs="0" />

<xsd:element name="SellerRegistration" type="StringNotNull" minOccurs="0" />

<xsd:element name="BuyerRegistration" type="StringNotNull" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

<!-

##################################################

# Tax rate type

##################################################

-->

<xsd:simpleType name="TaxRate">

<xsd:restriction base="xsd:decimal">

<xsd:totalDigits value="5" />

<xsd:fractionDigits value="4" fixed="true" />

</xsd:restriction>

</xsd:simpleType>

<!-

##################################################

# Financial Amounts Type

##################################################

-->

<xsd:complexType name="FinancialAmountsType">

<xsd:sequence>

<xsd:element name="DisplayPrice" type="FinancialAmountType" />

<xsd:element name="TaxAdjustedSellingPrice" type="CurrencyAmount" />

<xsd:element name="ExtendedAmount" type="FinancialAmountType" />

</xsd:sequence>

</xsd:complexType>

<!-

##################################################

# Financial Amount Type

##################################################

Page 43: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

39

-->

<xsd:complexType name="FinancialAmountType">

<xsd:sequence>

<xsd:element name="Amount" type="CurrencyAmount" />

<xsd:element name="IsTaxInclusive" type="xsd:boolean" />

</xsd:sequence>

</xsd:complexType>

<!-

##################################################

# Taxable Promotion Type

##################################################

-->

<xsd:complexType name="TaxablePromotionType">

<xsd:sequence>

<xsd:element ref="PromotionClaimCode" />

<xsd:element ref="MerchantPromotionID" />

<xsd:element name="Component" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="Type" type="PromotionApplicationType" />

<xsd:element name="Amount" type="CurrencyAmount" />

<xsd:element name="TaxData" type="TaxData" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:schema>

例 <?xml version="1.0" encoding="UTF-8" ?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>M_IDENTIFIER</MerchantIdentifier>

</Header>

<MessageType>OrderReport</MessageType>

<Message>

<MessageID>1</MessageID>

<OrderReport>

<AmazonOrderID>104-2391705-5555555</AmazonOrderID>

<AmazonSessionID>104-2391705-5555555</AmazonSessionID>

<OrderDate>2008-12-30T08:23:23-08:00</OrderDate>

<OrderPostedDate>2008-12-30T08:23:23-08:00</OrderPostedDate>

<BillingData>

<BuyerEmailAddress>[email protected]</BuyerEmailAddress>

<BuyerName>ABC Limited</BuyerName>

<BuyerPhoneNumber>407-9999999</BuyerPhoneNumber>

</BillingData>

<FulfillmentData>

<FulfillmentMethod>Ship</FulfillmentMethod>

<FulfillmentServiceLevel>Standard</FulfillmentServiceLevel>

<Address>

<Name>John Doe</Name>

<AddressFieldOne>John Doe</AddressFieldOne>

<AddressFieldTwo>4270 Cedar Ave</AddressFieldTwo>

<City>SUMNER PARK</City>

<StateOrRegion>FL</StateOrRegion>

<PostalCode>32091</PostalCode>

<CountryCode>US</CountryCode>

<PhoneNumber>407-9999999</PhoneNumber>

</Address>

</FulfillmentData>

<Item>

<AmazonOrderItemCode>55995643055555</AmazonOrderItemCode>

<SKU>414070</SKU>

<Title>Nike Women's Air Pegasus+ 25 ESC Running Shoe (Anthracite/ Grey/ Neutral Grey/ Mandarin) 9</Title>

<Quantity>1</Quantity>

<ProductTaxCode>A_GEN_TAX</ProductTaxCode>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">63.99</Amount>

</Component>

<Component>

Page 44: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

40

<Type>Shipping</Type>

<Amount currency="USD">0.00</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">0.00</Amount>

</Component>

<Component>

<Type>ShippingTax</Type>

<Amount currency="USD">0.00</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">-9.60</Amount>

</Fee>

</ItemFees>

<ItemTaxData>

<TaxJurisdictions>

<TaxLocationCode>100951788</TaxLocationCode>

<City>SUMNER</City>

<County>BROWARD</County>

<State>FL</State>

</TaxJurisdictions>

<TaxableAmounts>

<District currency="USD">0.00</District>

<City currency="USD">0.00</City>

<County currency="USD">0.00</County>

<State currency="USD">0.00</State>

</TaxableAmounts>

<NonTaxableAmounts>

<District currency="USD">0.00</District>

<City currency="USD">0.00</City>

<County currency="USD">63.99</County>

<State currency="USD">63.99</State>

</NonTaxableAmounts>

<ZeroRatedAmounts>

<District currency="USD">63.99</District>

<City currency="USD">63.99</City>

<County currency="USD">0.00</County>

<State currency="USD">0.00</State>

</ZeroRatedAmounts>

<TaxCollectedAmounts>

<District currency="USD">0.00</District>

<City currency="USD">0.00</City>

<County currency="USD">0.00</County>

<State currency="USD">0.00</State>

</TaxCollectedAmounts>

<TaxRates>

<District>0.0000</District>

<City>0.0000</City>

<County>0.0000</County>

<State>0.0000</State>

</TaxRates>

</ItemTaxData>

<Promotion>

<PromotionClaimCode>_SITE_WIDE_</PromotionClaimCode>

<MerchantPromotionID>FREESHIPPINGOVER25</MerchantPromotionID>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.00</Amount>

</Component>

<Component>

<Type>Shipping</Type>

<Amount currency="USD">0.00</Amount>

</Component>

</Promotion>

</Item>

</OrderReport>

</Message>

</AmazonEnvelope>

注文の受領確認 – 注文確認

Page 45: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

41

出品者 注文確認フィード Amazon

説明

注文確認フィードでは、注文情報のダウンロードを行った際の結果の成否を確認できます。また注文確認フィードに

より、出品者固有の注文 ID と注文商品 ID を付加し、必要に応じて以降のフィードにてその注文を参照することがで

きます。

またこの注文確認フィードを用いて、以下のような状況における注文全体のキャンセルが可能です。

顧客から注文キャンセルの依頼があり、まだ出荷していない場合

一種類だけの商品の注文を受けたが、その商品がダメージのため出荷できない場合

注文を出品者のシステムにアップロードできない場合

注文をキャンセルするには、StatusCode に「Failure」を指定します。

注意:

注文金額全体を返金する場合でなければ、1つでも商品を出荷した後には、StatusCode に「

Failure」を指定した注文確認リクエストは実行しないでください (次の「OrderFulfillment」

の項を参照してください)。

ディクショナリ

エレメント名 説明

AmazonOrderID 注文を識別する Amazon 独自の識別子。この番号で、一回の注文で発注した商品の個数にか

かわらず、注文全体を特定する。

MerchantOrderID 出品者が任意で与える注文 ID。AmazonOrderID と関連付けされ、以降の注文関連フィード

では AmazonOrderID の代わりに使用可能。まず初めに注文確認フィードで設定される。定

義については Base XSD を参照。

StatusCode 注文情報のダウンロードを行った際の結果の成否を確認できる。StatusCode は「Success」

または「Failure」のいずれか。StatusCode が「Failure」の場合、その注文を出品者のシス

テムに取り込む際に問題が発生し、その注文を処理できないことを出品者から Amazon へ連

絡するために利用。

StatusCode が「Failure」が送信した場合、注文は自動的にキャンセルされ、顧客は料金を

請求されない。

AmazonOrderItemCode 注文商品を特定する Amazon 独自の一意識別子。MerchantOrderItemID も指定されている場

合、この AmazonOrderItemCode と関連付けされ、以降のフィードでは

MerchantOrderItemID を使用してその商品を参照することが可能。定義については Base

XSD を参照。

MerchantOrderItemID 出品者が任意で与える、注文に含まれる個別の商品ごとの ID。MerchantOrderItemID が

AmazonOrderItemCode と共に指定されている場合、この 2つの ID は関連付けされ、以降の

フィードでは、MerchantOrderItemID を使用してその商品を参照することが可能。定義につ

いては Base XSD を参照。

CancelReason StatusCode が「Failure」の場合のみ有効。選択肢の一覧については Base XSD を参照。

Page 46: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

42

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/OrderFulfillment.xsd

<?xml version="1.0" ?>

<!- Revision="$Revision: #7 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="OrderAcknowledgement">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="AmazonOrderID" />

<xsd:element ref="MerchantOrderID" minOccurs="0" />

<xsd:element name="StatusCode">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="Success" />

<xsd:enumeration value="Failure" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="Item" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="AmazonOrderItemCode" />

<xsd:element ref="MerchantOrderItemID" minOccurs="0" />

<xsd:element name="CancelReason" minOccurs="0">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="NoInventory" />

<xsd:enumeration value="ShippingAddressUndeliverable" />

<xsd:enumeration value="CustomerExchange" />

<xsd:enumeration value="BuyerCanceled" />

<xsd:enumeration value="GeneralAdjustment" />

<xsd:enumeration value="CarrierCreditDecision" />

<xsd:enumeration value="RiskAssessmentInformationNotValid" />

<xsd:enumeration value="CarrierCoverageFailure" />

<xsd:enumeration value="CustomerReturn" />

<xsd:enumeration value="MerchandiseNotReceived" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

例 <?xml version="1.0"?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier> M_IDENTIFIER</MerchantIdentifier>

</Header>

<MessageType>OrderAcknowledgment</MessageType>

<Message>

<MessageID>1</MessageID>

<OrderAcknowledgment>

<AmazonOrderID>050-1234567-1234567</AmazonOrderID>

<MerchantOrderID>1234567</MerchantOrderID>

<StatusCode>Success</StatusCode>

<Item>

<AmazonOrderItemCode>12345678901234</AmazonOrderItemCode>

<MerchantOrderItemID>1234567</MerchantOrderItemID>

</Item>

</OrderAcknowledgment>

</Message>

</AmazonEnvelope>

Page 47: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

43

出荷および出荷の確認 (支払い) - 注文フルフィルメント

出品者 注文フルフィルメントフィード Amazon

説明

注文フルフィルメントフィードにより、出品者システムの配送情報を元に Amazon のシステムを更新します。これ

により、顧客の Amazon アカウントに出荷情報が反映され、顧客は出荷ステータスを確認できるようになります。

注文商品を発送したら、配送情報と共に出荷通知を Amazon に送信してください。追跡可能な配送方法を用いて出

荷した場合、フィードにはトラッキング番号も含めてください。Amazon が提供する標準配送業者コード

(CarrierCode)以外にも配送業者をフリーのテキスト欄に入力できるので、標準以外の配送業者も指定可能です。

このフィードは非常に重要なステップになります。これにより、Amazon が顧客に請求処理を行い、出品者アカウン

トへの支払い処理を行い、購入者に出荷を通知するメールを送信します。受注後 30日以内に出荷通知が Amazon に

送信されない場合は、注文は自動的にキャンセルされ、出品者に対する支払いは行われません。

注文確認フィードにおいて出品者固有の ID を関連付けしている場合、Amazon 固有の注文 ID と注文商品 ID ではな

く、その出品者固有の ID(MerchantOrderID と MerchantOrderItemID)が使用できます。

ディクショナリ

エレメント名 説明

AmazonOrderID 注文を識別する Amazon 独自の識別子。この番号で、一回の注文で発注した商品の

個数にかかわらず、注文全体を特定する。

MerchantOrderID 出品者が任意で与える注文 ID。まず初めに注文確認フィードで設定される。

AmazonOrderID と関連付けされ、以降の注文関連フィードでは AmazonOrderID の

代わりに使用可能。定義については Base XSD を参照。

MerchantFulfillmentID 出品者が内部で使用するフルフィルメント用の識別子。Amazon が商品の追跡に使

うことはない。

FulfillmentDate 商品の出荷日または出荷作業を行った日(注文で指定された配送方法による)

FulfillmentData 注文フルフィルメント情報。以下の情報を含む。

CarrierCode – 配送業者コード

CarrierName – 配送業者名

ShippingMethod – 配送方法

ShipperTrackingNumber – 出荷した商品のトラッキング番号

注意:使用した配送業者が Base XSD 上の CarrierCode のリストにない場合、CarrierCode の代わりに CarrierName を指定できます。

Item 商品ごとの注文フルフィルメント情報。以下の項目を含む。

AmazonOrderItemCode – 注文商品ごとの Amazon 固有の ID

MerchantOrderItemID – 注文商品ごとの出品者固有の ID(オプション)。一度注

文確認フィードで関連付けを行うと、以降の注文処理で使用可能。

MerchantFulfillmentItemID – 出品者が内部で使用する、出荷単位内の商品用の識

Page 48: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

44

別子。Amazon が商品の追跡に使うことはない。

Quantity – 複数個の商品が注文され、数回に分けて出荷された場合の各出荷時の

個数

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/OrderFulfillment.xsd

<?xml version="1.0" ?>

<!- Revision="$Revision: #2 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="OrderFulfillment">

<xsd:complexType>

<xsd:sequence>

<xsd:choice>

<xsd:element ref="AmazonOrderID" />

<xsd:element ref="MerchantOrderID" />

</xsd:choice>

<xsd:element name="MerchantFulfillmentID" type="IDNumber" minOccurs="0" />

<xsd:element name="FulfillmentDate" type="xsd:dateTime" />

<xsd:element name="FulfillmentData" minOccurs="0">

<xsd:complexType>

<xsd:sequence>

<xsd:choice>

<xsd:element ref="CarrierCode" />

<xsd:element name="CarrierName" type="String" />

</xsd:choice>

<xsd:element name="ShippingMethod" type="String" minOccurs="0" />

<xsd:element name="ShipperTrackingNumber" type="String" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="Item" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:choice>

<xsd:element ref="AmazonOrderItemCode" />

<xsd:element ref="MerchantOrderItemID" />

</xsd:choice>

<xsd:element name="MerchantFulfillmentItemID" type="IDNumber" minOccurs="0" />

<xsd:element name="Quantity" type="xsd:positiveInteger" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

例 <?xml version="1.0" encoding="UTF-8"?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>My Store</MerchantIdentifier>

</Header>

<MessageType>OrderFulfillment</MessageType>

<Message>

<MessageID>1</MessageID>

<OrderFulfillment>

<MerchantOrderID>1234567</MerchantOrderID>

<MerchantFulfillmentID>1234567</MerchantFulfillmentID>

<FulfillmentDate>2002-05-01T15:36:33-08:00</FulfillmentDate>

<FulfillmentData>

<CarrierCode>UPS</CarrierCode>

<ShippingMethod>Second Day</ShippingMethod>

<ShipperTrackingNumber>1234567890</ShipperTrackingNumber>

</FulfillmentData>

<Item>

<MerchantOrderItemID>1234567</MerchantOrderItemID>

<MerchantFulfillmentItemID>1234567</MerchantFulfillmentItemID>

<Quantity>2</Quantity>

Page 49: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

45

</Item>

</OrderFulfillment>

</Message>

</AmazonEnvelope>

返金または注文の一部キャンセル - 注文修正または部分キャンセル

出品者 注文修正フィード Amazon

説明

注文修正フィードにより、注文の修正や返金を行います。その際、「顧客からの返品」等の修正理由と、修正金額を

料金の構成要素(商品代金、配送料、税金など)ごとに入力する必要があります。注意:ただし購入者のクレジット

カードには、合計金額に対して一度しか課金されません。注文修正フィードにより購入者に追加の課金(例えば返品

手数料など)が発生した場合、その正味金額を購入者に課金する必要があります。

さらにこの注文修正フィードを使い、出荷できない商品を返品手数料なしで個別にキャンセルすることもできます。

この機能を使うためには、修正理由で「在庫不足」または「購入者によるキャンセル」を選択し、キャンセル数量

を入力してください。

注意:注文全体をキャンセルする場合、注文修正フィードではなく注文確認フィードを使用

してください。

ディクショナリ

エレメント名 説明

AmazonOrderID 注文を識別する Amazon 独自の識別子。この番号で、一回の注文で発注した商品の個

数にかかわらず、注文全体を特定する。

MerchantOrderID 出品者が任意で与える注文 ID。まず初めに注文確認フィードで設定される。AmazonOrderID

と関連付けされ、以降の注文関連フィードでは AmazonOrderID の代わりに使用可能。

定義については Base XSD を参照。

AdjustedItem 注文修正情報。以下の情報を含む。

AmazonOrderItemCode – 注文商品ごとの Amazon 固有の ID

MerchantOrderItemID – 注文商品ごとの出品者固有の ID(オプション)。一度注文確

認フィードで関連付けを行うと、以降の注文処理で使用可能。

MerchantAdjustmentItemID – 注文修正を行う際、出品者がオプションで設定する一

意識別子(Amazon では使用しない)

AdjustmentReason – 返金/注文修正の理由

ItemPriceAdjustments – 購入者に返金する金額をタイプ別に表示。タイプの定義に

ついては Base XSD を参照。合計金額は単価ではなく数量の合計分。金額が正数の場

合購入者に返金され、金額が負数の場合(例えば返品手数料など)購入者に課金され

る。

PromotionAdjustments – プロモーションの一環として購入者に返金される金額をタ

イプ別に表示。タイプの定義については Base XSD を参照。合計金額は単価ではなく

数量の合計分。金額が正数の場合購入者に返金され、金額が負数の場合購入者に課金

される。

QuantityCancelled キャンセルされた商品の数。一部キャンセル時のみ有効。

Page 50: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

46

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/OrderAdjustment.xsd

<?xml version="1.0" ?>

<!- Revision="$Revision: #11 $"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="OrderAdjustment">

<xsd:complexType>

<xsd:sequence>

<xsd:choice>

<xsd:element ref="AmazonOrderID" />

<xsd:element ref="MerchantOrderID" />

</xsd:choice>

<xsd:element name="AdjustedItem" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:choice>

<xsd:element ref="AmazonOrderItemCode" />

<xsd:element ref="MerchantOrderItemID" />

</xsd:choice>

<xsd:element name="MerchantAdjustmentItemID" type="StringNotNull" minOccurs="0" />

<xsd:element name="AdjustmentReason">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="NoInventory" />

<xsd:enumeration value="CustomerReturn" />

<xsd:enumeration value="GeneralAdjustment" />

<xsd:enumeration value="CouldNotShip" />

<xsd:enumeration value="DifferentItem" />

<xsd:enumeration value="Abandoned" />

<xsd:enumeration value="CustomerCancel" />

<xsd:enumeration value="PriceError" />

<xsd:enumeration value="ProductOutofStock" />

<xsd:enumeration value="CustomerAddressIncorrect" />

<xsd:enumeration value="Exchange" />

<xsd:enumeration value="Other" />

<xsd:enumeration value="CarrierCreditDecision" />

<xsd:enumeration value="RiskAssessmentInformationNotValid" />

<xsd:enumeration value="CarrierCoverageFailure" />

<xsd:enumeration value="TransactionRecord" />

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:element name="ItemPriceAdjustments" type="BuyerPrice" />

<xsd:element name="PromotionAdjustments" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="PromotionClaimCode" minOccurs="0" />

<xsd:element ref="MerchantPromotionID" minOccurs="0" />

<xsd:element name="Component" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="Type" type="PromotionApplicationType" />

<xsd:element name="Amount" type="CurrencyAmount" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="DirectPaymentAdjustments" type="DirectPaymentType" minOccurs="0" />

<xsd:element name="QuantityCancelled" type="xsd:positiveInteger" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

例 <?xml version="1.0" encoding="UTF-8"?>

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-

Page 51: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

47

envelope.xsd">

<Header>

<DocumentVersion>1.01</DocumentVersion>

<MerchantIdentifier>My Store</MerchantIdentifier>

</Header>

<MessageType>OrderAdjustment</MessageType>

<Message>

<MessageID>1</MessageID>

<OrderAdjustment>

<MerchantOrderID>1234567</MerchantOrderID>

<AdjustedItem>

<MerchantOrderItemID>1234567</MerchantOrderItemID>

<MerchantAdjustmentItemID>12345</MerchantAdjustmentItemID>

<AdjustmentReason>CustomerReturn</AdjustmentReason>

<ItemPriceAdjustments>

<Component>

<Type>Principal</Type>

<Amount currency="USD">10.00</Amount>

</Component>

<Component>

<Type>Shipping</Type>

<Amount currency="USD">3.49</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">1.29</Amount>

</Component>

<Component>

<Type>Shipping Tax</Type>

<Amount currency="USD">0.24</Amount>

</Component>

</ItemPriceAdjustments>

</AdjustedItem>

</OrderAdjustment>

</Message>

<Message>

<MessageID>2</MessageID>

<OrderAdjustment>

<MerchantOrderID>2345678</MerchantOrderID>

<AdjustedItem>

<MerchantOrderItemID>2345678</MerchantOrderItemID>

<MerchantAdjustmentItemID>23456</MerchantAdjustmentItemID>

<AdjustmentReason>CustomerReturn</AdjustmentReason>

<ItemPriceAdjustments>

<Component>

<Type>Principal</Type>

<Amount currency="USD">10.00</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">1.29</Amount>

</Component>

</ItemPriceAdjustments>

<PromotionAdjustments>

<PromotionClaimCode>ABC123</PromotionClaimCode>

<MerchantPromotionID>12345678</MerchantPromotionID>

<Component>

<Type>Principal</Type>

<Amount currency="USD">-1.00</Amount>

</Component>

</PromotionAdjustments>

</AdjustedItem>

</OrderAdjustment>

</Message>

</AmazonEnvelope>

支払い内容の取得 – 決済レポート

出品者 Amazon決済レポート

Page 52: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

48

説明

決済レポートは、決済期間中の全ての支払い処理に関する情報を提供します。決済期間には出品者と合意した期間が

設定されています。決済レポートには、決済期間中の全ての注文と修正が含まれており、出品者の銀行口座への振り

込みの詳細も表示されます。

注意:出品者の銀行口座への振り込みは、日本では通常、決済レポート生成後 6-10 営業日

かかります。

ディクショナリ

エレメント名 説明

SettlementData 各種決済情報。以下の内容を含む。

AmazonSettlementID – 決済を特定する Amazon 独自の識別子

TotalAmount – 出品者の銀行口座への入金額

StartDate – 決済期間の開始日

EndDate – 決済期間の終了日

DepositDate – 入金日付

AmazonOrderID 注文を識別する Amazon 固有の一意の ID で、注文に含まれる商品の数に関わらず注文

全体を識別する。

MerchantOrderID 出品者が任意で与える注文 ID。まず初めに注文確認フィードで設定される。

AmazonOrderID と関連付けされ、以降の注文関連フィードでは AmazonOrderID の代

わりに使用可能。定義については Base XSD を参照。

ShipmentID

ShipmentFees

MarketplaceName 注文された Web サイト名(Amazon.co.jp など)

Fulfillment 注文フルフィルメント情報。以下のような項目を含む。

MerchantFulfillmentID – 出品者固有の出荷ごとに一意の ID(Amazon は使用しな

い)

PostedDate – 出品者支払い用アカウントに通知した日付

Item コンテナ

AmazonOrderItemCode – 注文商品ごとの Amazon 固有の ID

MerchantOrderItemID – 注文商品ごとの出品者固有の ID(オプション)。一度注文確

認フィードで関連付けを行うと、以降の注文処理で使用可能。

SKU – 出品者が商品ごとに採番する一意の ID

Quantity – 購入数量 ItemPrice ItemFees Promotion MerchantPromotionID – 出品者がプロモーションを追跡するための ID

Type – プロモーションの種類

Amount – 支払い先出品用アカウントに課金、またはそこから引き落とされる金額

DirectPayment OrderFee

Adjustment コンテナ

AmazonOrderItemCode – 注文商品ごとの Amazon 固有の ID

MerchantOrderItemID – 注文商品ごとの出品者固有の ID(オプション)。一度注文確

認フィードで関連付けを行うと、以降の注文処理で使用可能。

SKU – 出品者が商品ごとに採番する一意の ID

ItemPriceAdjustments – 購入者に返金する金額をタイプ別に表示。タイプの定義に

Page 53: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

49

ついては Base XSD を参照。合計金額は単価ではなく数量の合計分。金額が正数の場

合購入者に返金され、金額が負数の場合(例えば返品手数料など)購入者に課金され

る。

ItemFeeAdjustments PromotionAdjustment MerchantPromotionID – 出品者がプロモーションを追跡するための ID

Type – プロモーションの種類

Amount – 支払い先出品用アカウントに課金またはそこから引き落とされる金額DirectPayment OrderFeeAdjustment

OtherFee コンテナ

AmazonOrderItemCode – 注文商品ごとの Amazon 固有の ID

MerchantOrderItemID – 注文商品ごとの出品者固有の ID(オプション)。一度注文確

認フィードで関連付けを行うと、以降の注文処理で使用可能。

MarketplaceName – 注文された Web サイト名(Amazon.co.jp など)

MerchantFulfillmentID – 出品者固有の出荷ごとに一意の ID(Amazon は使用しな

い)

PostedDate – 出品者支払い用アカウントに通知した日付

Amount – 出品者支払い用アカウントに課金またはそこから引き落とされる金額 ReasonDescription

OtherTransaction コンテナ

AmazonOrderItemCode – 注文商品ごとの Amazon 固有の ID

MerchantOrderItemID – 注文商品ごとの出品者固有の ID(オプション)。一度注文確

認フィードで関連付けを行うと、以降の注文処理で使用可能。

MarketplaceName – 注文された Web サイト名(Amazon.co.jp など)

MerchantFulfillmentID – 出品者固有の出荷ごとに一意の ID(Amazon は使用しな

い) TransactionType TransactionID

PostedDate – 出品者支払い用アカウントに通知した日付

Amount – 出品者支払い用アカウントに課金またはそこから引き落とされる金額 ReasonDescription Fees

MiscEvent コンテナ

PostedDate – 出品者支払い用アカウントに通知した日付

Amount – 出品者支払い用アカウントに課金またはそこから引き落とされる金額

XSD https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/SettlementReport.xsd <?xml version="1.0" ?>

<!- Revision="$Revision: #9 $"

-->

<!- Settlement Report Version="3.1"

-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

<xsd:include schemaLocation="amzn-base.xsd" />

<xsd:element name="SettlementReport">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="SettlementData">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="AmazonSettlementID" type="IDNumber" />

<xsd:element name="TotalAmount" type="CurrencyAmount" />

<xsd:element name="StartDate" type="xsd:dateTime" />

<xsd:element name="EndDate" type="xsd:dateTime" />

<xsd:element name="DepositDate" type="xsd:dateTime" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="Order" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

Page 54: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

50

<xsd:element ref="AmazonOrderID" />

<xsd:element ref="MerchantOrderID" minOccurs="0" />

<xsd:element name="ShipmentID" minOccurs="0" />

<xsd:element name="ShipmentFees" type="AmazonFees" minOccurs="0" maxOccurs="unbounded" />

<xsd:element ref="MarketplaceName" />

<xsd:element name="Fulfillment">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="MerchantFulfillmentID" minOccurs="0" />

<xsd:element name="PostedDate" type="xsd:dateTime" />

<xsd:element name="Item" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="AmazonOrderItemCode" />

<xsd:element ref="MerchantOrderItemID" minOccurs="0" />

<xsd:element ref="SKU" />

<xsd:element name="Quantity" type="xsd:positiveInteger" />

<xsd:element name="ItemPrice" type="BuyerPrice" />

<xsd:element name="ItemFees" type="AmazonFees" minOccurs="0" />

<xsd:element name="Promotion" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="MerchantPromotionID" />

<xsd:element name="Type" type="StringNotNull" />

<xsd:element name="Amount" type="CurrencyAmount" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="DirectPayment" type="DirectPaymentType" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="OrderFee" type="AmazonFees" minOccurs="0" maxOccurs="unbounded" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="Adjustment" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="AmazonOrderID" />

<xsd:element ref="MerchantOrderID" minOccurs="0" />

<xsd:element name="AdjustmentID" type="StringNotNull" minOccurs="0" />

<xsd:element ref="MarketplaceName" />

<xsd:element name="Fulfillment">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="MerchantFulfillmentID" minOccurs="0" />

<xsd:element name="PostedDate" type="xsd:dateTime" />

<xsd:element name="AdjustedItem" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="AmazonOrderItemCode" />

<xsd:element ref="MerchantOrderItemID" minOccurs="0" />

<xsd:element name="MerchantAdjustmentItemID" type="StringNotNull" minOccurs="0" />

<xsd:element ref="SKU" />

<xsd:element name="ItemPriceAdjustments" type="BuyerPrice" />

<xsd:element name="ItemFeeAdjustments" type="AmazonFees" minOccurs="0" />

<xsd:element name="PromotionAdjustment" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="MerchantPromotionID" />

<xsd:element name="Type" type="StringNotNull" />

<xsd:element name="Amount" type="CurrencyAmount" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="DirectPayment" type="DirectPaymentType" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="OrderFeeAdjustment" type="AmazonFees" minOccurs="0" maxOccurs="unbounded" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="OtherFee" minOccurs="0" maxOccurs="unbounded">

Page 55: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

51

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="AmazonOrderID" minOccurs="0" />

<xsd:element ref="MerchantOrderID" minOccurs="0" />

<xsd:element ref="MarketplaceName" />

<xsd:element ref="MerchantFulfillmentID" minOccurs="0" />

<xsd:element name="PostedDate" type="xsd:dateTime" />

<xsd:element name="Amount" type="CurrencyAmount" />

<xsd:element name="ReasonDescription" type="StringNotNull" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="OtherTransaction" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="AmazonOrderID" minOccurs="0" />

<xsd:element ref="MerchantOrderID" minOccurs="0" />

<xsd:element ref="MarketplaceName" minOccurs="0" />

<xsd:element ref="MerchantFulfillmentID" minOccurs="0" />

<xsd:element name="TransactionType" type="StringNotNull" />

<xsd:element name="TransactionID" type="StringNotNull" minOccurs="0" />

<xsd:element name="PostedDate" type="xsd:dateTime" />

<xsd:element name="Amount" type="CurrencyAmount" />

<xsd:element name="ReasonDescription" type="StringNotNull" minOccurs="0" />

<xsd:element name="Fees" type="AmazonFees" minOccurs="0" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="MiscEvent" minOccurs="0" maxOccurs="unbounded">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="PostedDate" type="xsd:dateTime" />

<xsd:element name="Amount" type="CurrencyAmount" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

例 <?xml version="1.0" encoding="UTF-8"?>

<SettlementReport>

<SettlementData>

<AmazonSettlementID>5024267331</AmazonSettlementID>

<TotalAmount currency="USD">-58.73</TotalAmount>

<StartDate>2008-11-28T14:47:05+00:00</StartDate>

<EndDate>2008-12-26T14:45:14+00:00</EndDate>

<DepositDate>2008-12-28T14:45:14+00:00</DepositDate>

</SettlementData>

<Order>

<AmazonOrderID>105-6982537-6258888</AmazonOrderID>

<ShipmentID>DqWG0</ShipmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19084441555</MerchantFulfillmentID>

<PostedDate>2008-12-15T19:33:04+00:00</PostedDate>

<Item>

<AmazonOrderItemCode>13350774331938</AmazonOrderItemCode>

<SKU>U1409</SKU>

<Quantity>1</Quantity>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">0.02</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">-0.01</Amount>

</Fee>

</ItemFees>

Page 56: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

52

</Item>

</Fulfillment>

</Order>

<Order>

<AmazonOrderID>102-4226580-9099444</AmazonOrderID>

<ShipmentID>DtVS</ShipmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19089363182</MerchantFulfillmentID>

<PostedDate>2008-12-15T21:43:08+00:00</PostedDate>

<Item>

<AmazonOrderItemCode>00806662376130</AmazonOrderItemCode>

<SKU>U1409</SKU>

<Quantity>1</Quantity>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">0.02</Amount>

</Component>

<Component>

<Type>Shipping</Type>

<Amount currency="USD">0.01</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">-0.01</Amount>

</Fee>

</ItemFees>

</Item>

</Fulfillment>

</Order>

<Order>

<AmazonOrderID>002-6239589-9267444</AmazonOrderID>

<ShipmentID>Dx9K03plR</ShipmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19083904842</MerchantFulfillmentID>

<PostedDate>2008-12-15T22:31:38+00:00</PostedDate>

<Item>

<AmazonOrderItemCode>31454552568346</AmazonOrderItemCode>

<SKU>U1409</SKU>

<Quantity>1</Quantity>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">0.02</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">-0.01</Amount>

</Fee>

</ItemFees>

</Item>

<Item>

<AmazonOrderItemCode>66480775952306</AmazonOrderItemCode>

<SKU>U1410</SKU>

<Quantity>1</Quantity>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">0.02</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

Page 57: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

53

<Type>Commission</Type>

<Amount currency="USD">-0.01</Amount>

</Fee>

</ItemFees>

</Item>

<Item>

<AmazonOrderItemCode>34282312709418</AmazonOrderItemCode>

<SKU>U1411</SKU>

<Quantity>1</Quantity>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">0.02</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">-0.01</Amount>

</Fee>

</ItemFees>

</Item>

</Fulfillment>

</Order>

<Order>

<AmazonOrderID>105-6517412-1452222</AmazonOrderID>

<ShipmentID>DBwP0npwR</ShipmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19085579472</MerchantFulfillmentID>

<PostedDate>2008-12-18T14:34:54+00:00</PostedDate>

<Item>

<AmazonOrderItemCode>65536901305826</AmazonOrderItemCode>

<SKU>U1409</SKU>

<Quantity>1</Quantity>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">0.02</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">-0.01</Amount>

</Fee>

</ItemFees>

</Item>

</Fulfillment>

</Order>

<Order>

<AmazonOrderID>002-8437726-3624222</AmazonOrderID>

<ShipmentID>DHww0qpvR</ShipmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19085714592</MerchantFulfillmentID>

<PostedDate>2008-12-18T14:34:54+00:00</PostedDate>

<Item>

<AmazonOrderItemCode>28647667911362</AmazonOrderItemCode>

<SKU>U1409</SKU>

<Quantity>1</Quantity>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.15</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">-0.01</Amount>

</Fee>

</ItemFees>

Page 58: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

54

</Item>

</Fulfillment>

</Order>

<Order>

<AmazonOrderID>002-8325573-8322666</AmazonOrderID>

<ShipmentID>DB9r0gp1R</ShipmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19083705712</MerchantFulfillmentID>

<PostedDate>2008-12-18T14:34:54+00:00</PostedDate>

<Item>

<AmazonOrderItemCode>06849903846282</AmazonOrderItemCode>

<SKU>U1409</SKU>

<Quantity>1</Quantity>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">0.02</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">-0.01</Amount>

</Fee>

</ItemFees>

</Item>

</Fulfillment>

</Order>

<Order>

<AmazonOrderID>103-6428709-2012222</AmazonOrderID>

<ShipmentID>Dv9Y04ptR</ShipmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19083802582</MerchantFulfillmentID>

<PostedDate>2008-12-18T14:34:54+00:00</PostedDate>

<Item>

<AmazonOrderItemCode>62939279608258</AmazonOrderItemCode>

<SKU>U1409</SKU>

<Quantity>3</Quantity>

<ItemPrice>

<Component>

<Type>Principal</Type>

<Amount currency="USD">0.45</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">0.06</Amount>

</Component>

</ItemPrice>

<ItemFees>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">-0.03</Amount>

</Fee>

</ItemFees>

</Item>

</Fulfillment>

</Order>

<Adjustment>

<AmazonOrderID>002-6239589-9267444</AmazonOrderID>

<AdjustmentID>0WT7-KYP1-GB7H-A0ZA-8Y7W</AdjustmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19083904842</MerchantFulfillmentID>

<PostedDate>2008-12-19T15:06:37+00:00</PostedDate>

<AdjustedItem>

<AmazonOrderItemCode>34282312709418</AmazonOrderItemCode>

<SKU>U1411</SKU>

<ItemPriceAdjustments>

<Component>

<Type>Principal</Type>

<Amount currency="USD">-0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">-0.02</Amount>

Page 59: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

55

</Component>

</ItemPriceAdjustments>

<ItemFeeAdjustments>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">0.01</Amount>

</Fee>

</ItemFeeAdjustments>

</AdjustedItem>

</Fulfillment>

</Adjustment>

<Adjustment>

<AmazonOrderID>105-6982537-6258666</AmazonOrderID>

<AdjustmentID>04XM-3VWM-6DD9-SZQB-GZXG</AdjustmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19084441572</MerchantFulfillmentID>

<PostedDate>2008-12-19T15:06:34+00:00</PostedDate>

<AdjustedItem>

<AmazonOrderItemCode>13350774331938</AmazonOrderItemCode>

<SKU>U1409</SKU>

<ItemPriceAdjustments>

<Component>

<Type>Principal</Type>

<Amount currency="USD">-0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">-0.02</Amount>

</Component>

</ItemPriceAdjustments>

<ItemFeeAdjustments>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">0.01</Amount>

</Fee>

</ItemFeeAdjustments>

</AdjustedItem>

</Fulfillment>

</Adjustment>

<Adjustment>

<AmazonOrderID>102-4226580-9099444</AmazonOrderID>

<AdjustmentID>0PZG-3CA0-XDE6-9Y2X-HQD6</AdjustmentID>

<MarketplaceName>Amazon.com</MarketplaceName>

<Fulfillment>

<MerchantFulfillmentID>MFNMFN19089363182</MerchantFulfillmentID>

<PostedDate>2008-12-19T15:06:56+00:00</PostedDate>

<AdjustedItem>

<AmazonOrderItemCode>00806662376130</AmazonOrderItemCode>

<SKU>U1409</SKU>

<ItemPriceAdjustments>

<Component>

<Type>Principal</Type>

<Amount currency="USD">-0.15</Amount>

</Component>

<Component>

<Type>Tax</Type>

<Amount currency="USD">-0.02</Amount>

</Component>

<Component>

<Type>Shipping</Type>

<Amount currency="USD">-0.01</Amount>

</Component>

</ItemPriceAdjustments>

<ItemFeeAdjustments>

<Fee>

<Type>Commission</Type>

<Amount currency="USD">0.01</Amount>

</Fee>

</ItemFeeAdjustments>

</AdjustedItem>

</Fulfillment>

</Adjustment>

<OtherTransaction>

<TransactionType>Subscription Fee</TransactionType>

<PostedDate>2008-12-21T14:50:45+00:00</PostedDate>

<Amount currency="USD">-59.99</Amount>

</OtherTransaction>

</SettlementReport>

Page 60: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

56

Amazonの注文管理プロセス

Amazon サイトでの商品登録に加えて、注文管理は XML による開発において重要なプロセスです。以下に一般的な

注文管理プロセスの流れを示します。

Amazon.co.jpサイトにて顧客が注文

9 0分間の保留期間後、注文確認可

出品者が注文に対する出荷処理

出品者が出荷確認

Amazonが顧客のクレジットカードに課金

Amazonが出品者に売上支払い

顧客に注文確認メール送信

出品者に注文メール送信

顧客に出荷通知メール送信

顧客が商品を注文すると、即座に注文確認メールが顧客に送信されます。しかし注文情報は、その後最低 90分間は

出品者に通知されません。この 90分間に、顧客は出品者に知らせることなく注文を変更・キャンセルすることが可

能です。

90分後に顧客の支払い方法認証も含めて注文に問題がない場合、注文メールが出品者に送信されます。この時点で

顧客が注文全体または注文の一部をキャンセルする場合は、顧客は出品者に依頼しなければなりません。

注文管理プロセスの次のステップは、注文に対する出荷処理です。出品者は十分な在庫を持ち、注文に対して迅速に

出荷処理を行わなければなりません。しかし稀に、注文された商品の在庫がないため注文をキャンセルしなければ

ならない場合、出品者はマイナスの注文確認を送信します。マイナスの注文確認では、注文をキャンセルした理由

(「在庫不足」など)を指定します。また顧客には課金されないので返金する必要はありません。

注文の一部でも出荷できる場合は、それらを出荷し、注文フルフィルメントフィードにて出荷の確認を行います。複

数商品が含まれた注文のうち一つの商品だけを出荷し出荷確認する場合、顧客にはその一商品分だけでなく注文全体

の金額が課金されます。このような場合は、注文全体に対して出荷確認し、出荷できなかった商品については返金処

理を行います。購入者には必ず、注文のうち一部の商品をキャンセルした理由を通知してください。

Page 61: Amazon 出品サービス XML ガイド · 1. XML 概要 XML とは? XML (Extensible Markup Language)とは、構造的なドキュメントを記述するためのマークアップ言語です。XML

Amazon 出品サービス XML ガイド

Copyright (c) 2010 Amazon Services International Inc. or its corporate affiliates. All rights reserved. This document is confidential, and may not be

copied or distributed, in whole or in part, without the express written consent of Amazon.

57

5. XML フィードの妥当性確認

XML フィードは、処理の前に XSD と比較して妥当性の確認が行われます。妥当でないと判断された場合、処理レポ

ートに「parsing error」と表示されます。したがって、Amazon にデータを送信する前に XML の妥当性確認を行う

ことは重要です。

妥当性確認には、サードパーティ製の XML 妥当性確認(デバッグ)用ツールが利用できます。「XML Validator」で

インターネットを検索すると、それらのツールを見つけることができます。

6. カテゴリー固有の XSD

カテゴリー XSD

カー&バイク用品 https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/AutoAccessory.xsd

コスメ https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Beauty.xsd

服&ファッション小物

/シューズ&バッグ http://g-ec2.images-amazon.com/images/G/01/rainier/help/xsd/ProductClothing.xsd

エレクトロニクス https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/CE.xsd

食品&飲料 https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/FoodAndBeverages.xsd

ヘルス&ビューティー https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Health.xsd

ジュエリー&時計 https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Jewelry.xsd

楽器 https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/MusicalInstruments.xsd

スポーツ&アウトドア https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Sports.xsd

DIY・工具 https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/HomeImprovement.xsd

おもちゃ&ホビー/ベ

ビー&マタニティ https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/ToysBaby.xsd

Lighting https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Lighting.xsd

ペット用品 https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/PetSupplies.xsd

Tires & Wheels https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/TiresAndWheels.xsd

Tools https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Tools.xsd

Wireless https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Wireless.xsd

Camera https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/CameraPhoto.xsd

Gourmet https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Gourmet.xsd