請求書の作成とアップロード
VCSへの登録がある場合とない場合で請求書を作成してアップロードする方法をご覧ください。
VCS に登録すると、請求書を作成してアップロードする方法が 2 つあります。
- アマゾンに許可する 請求書を自動的に作成してアップロードする。
- 使用 独自の請求書を作成するためのAmazon税額計算データそして、SP-API を使用して手動でアップロードします。
VCSを使用したくない場合は、独自の税務データを使用して請求書を作成し、SP-APIまたはセラーセントラルを使用して手動でアップロードできます。この方法の使用方法については、「」を参照してください。 請求書を手動でアップロード。
ヒント
購入者を混乱させる可能性があるため、請求書には出品者送金情報を提供しないでください。Amazon は購入者からの支払いを直接回収し、その金額を出品者に支払います。
請求書のコンプライアンス要件と請求書の訂正については、以下を参照してください。 VCS 請求書の遵守と修正。
Amazonに請求書の作成を許可する
このオプションは、VAT計算サービス (VCS) に登録し、以下を選択したすべての出品者が利用できます。 I want Amazon to generate invoices on my behalf オプションを選択すると、Amazon VAT 計算レポートにアクセスできます。このレポートには、請求書番号、請求書リンク、購入者VAT、出荷元/出荷先情報など、VCS 注文に関する有用な情報が含まれています。注文は出荷から3日後にこのレポートに表示されます。次の表の情報を使用して、販売パートナーAPI (SP-API) を使用してVCSレポートをリクエストしてください。
API | レポートAPI |
---|---|
Operation | createReport |
ReportType | SC_VAT_TAX_REPORT |
VCSプログラムは、以下のレポートの内容に影響します。
注文レポート
VAT額を含めてください
リクエストしたレポートを注文する 後 VCS に登録すると以下のように表示されます。
ItemTax
(XML レポートの場合) およびitem_tax
(フラットファイルレポート内)。Amazon が計算した VAT 額が含まれます。ItemPrice
(XML レポートの場合) およびitem_price
(フラットファイルレポート内)。VAT 込みの価格が含まれます。
VAT抜きの金額は、商品価格から商品税を差し引いた金額です。
注
商品税がゼロの場合、取引には0%のVATが請求されました。このような状況が発生する可能性はいくつかあります。例としては、国際取引や B2B EU クロスボーダー取引などがあります。詳細については、「」を参照してください。 VCS の計算方法論。
VATの詳細を含める
注文レポートにVCS関連の属性を出力することを選択できます。
VCS関連の属性を注文レポートに出力するには、次の手順に従います。
-
セラーセントラルの「注文レポートを追加または削除する」列に移動します。
-
を追加 VAT details コラム。
この手順を完了すると、注文レポートに次の列が追加されます。 Item price VAT exclusive、 Shipping price VAT exclusive、および Gift wrap price VAT exclusive。
FBA注文レポート
リクエストしたFBA注文レポート 後 VCS に登録すると以下のように表示されます。
ItemTax
(XML レポートの場合) およびitem_tax
(フラットファイルレポート内)。Amazon が計算した VAT 額が含まれます。ItemPrice
(XML レポート内) およびitem_price
(フラットファイルレポート内)VAT 抜きの金額 (VAT 込みの金額から変更) が含まれます。
VAT込みの金額は、商品価格に商品税を加えたものです。
Amazon の税額計算データを使用して請求書を作成する
このオプションのみ使用できます セリングパートナー API (SP-API) を使用する また、請求書の作成には Amazon から提供された税データを使用する必要があります。
ステップ1. VAT請求書データレポート(VIDR)からすべての注文の税額計算データを抽出する
VIDRは、トランザクションレベルでの税額計算の詳細が記載されたレポートで、VCSに登録した出品者のみが利用できます。このレポートには、出品者出荷かAmazonから出荷(FBA)かを問わず、各出荷について正確なVAT請求書を作成するために必要な情報がすべて出力されます。注文は、出荷後すぐにこのレポートに出力されます。
を使用してください createReport
での操作 GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT
または GET_XML_VAT_INVOICE_DATA_REPORT
レポートタイプ (reportType
)。
reportOptions
+ pendingInvoices
- all
.
-
pendingInvoices
: ブール値。「いいえ」の場合ReportOption
パラメータが指定され、デフォルトはReportOption=PendingInvoices
。例:"reportOptions": {"ReportOption=pendingInvoices": "true"}
- いつ
true
レポートには、請求書とクレジットノートが保留になっている出荷のみが含まれます。このレポートには、請求書がすでに正常にアップロードされた出荷は含まれていません。これには、過去 90 日以内に行われた注文の出荷が含まれます。 - いつ
false
(または、保留中の請求書が ReportOptions に含まれていない場合)、レポートの内容は次の値によって異なります。all
。
これらのレポートには、注文日が過去90日で、請求書の期限が迫っている出荷済み注文の出荷詳細が含まれます(請求書のステータスが「すべての出荷」)。
InvoicePending
またはCreditNotePending
)。このオプションのレポートには、請求書がすでに正常にアップロードされた出荷は含まれません。このオプションの目的は、出品者が独自のビジネスロジックを適用しなくても、すべての項目を繰り返し確認して請求書を作成できるようにすることです。 - いつ
-
all
: ブール値。デフォルトはです。例:"reportOptions": {"ReportOption=All": "true"}
- いつ
true
レポートには、指定した日付範囲内に行われた注文の出荷が含まれます。これには、考えられるすべての請求書ステータスの出荷が含まれます。以下を指定する必要があります。startDate
そしてendDate
のパラメーターcreateReport
オペレーション。ザ・dataStartTime
そしてdataEndTime
値は、指定された期間の有効な最初と最後の日に対応していなければなりませんreportPeriod
。たとえば、いつreportPeriod=WEEK
、dataStartTime
日曜日でなくてはいけないしdataEndTime
土曜日に違いない。最大許容日付範囲は 30 日です。 - いつ
false
、またはall
には含まれていませんreportOptions
、レポートの内容は次の値によって異なりますpendingInvoices
。デフォルト値は"pendingInvoices" : "true"
。
これらのレポートには、可能なすべての出荷が含まれます
InvoiceStatus
値。これには以下が含まれます。- での発送
InvoiceStatus=InvoiceCreatedByAmazon
。この取引についてはAmazonが請求書を発行するので、出品者は請求書をアップロードする必要はありません。 - との取引
InvoiceStatus=NoTaxCalculated
。Amazonはこの取引の税額計算を行っていません。これは、たとえば、出品者がセラーセントラルで有効なVAT番号を提供していない国から商品が発送された場合などに発生します。
- いつ
いつ行うかを決めることができます これらのレポートをスケジュールする。24 時間の SLA を満たすには、12 時間ごとにスケジュールを作成できます。これにより、貨物が発送されてから最大12時間遅れることが保証されます。
請求書は、貨物が発送された後、各注文ではなく、出荷ごとに提出する必要があります。出荷には以下のいずれかのステータスがあります。
請求書ステータス | 説明 | Action required |
---|---|---|
InvoicePending | 出荷が発送されました。 | 出品者は出荷の請求書をアップロードする必要があります。 |
InvoiceProcessing | 出品者が請求書をアップロードし、Amazonが処理中です。 | この時点では、出品者のアクションは必要ありません。Amazonが請求書を処理します。 |
InvoiceUploaded | 出品者が請求書をアップロードし、Amazonが処理を完了しました。エラーは検出されませんでした。 | 出品者のアクションは必要ありません。請求書は正常にアップロードされ、顧客が「注文履歴」ページで閲覧できるようになりました。顧客はいつでも請求書をダウンロードできます。 |
InvoiceRejected | 出品者が請求書をアップロードし、Amazonが処理を完了しました。アップロード中にエラーが検出されました。 | 出品者は、この出荷の請求書を再度アップロードする必要があります。 |
CreditNotePending | 返金の場合、購入者に返金されています。返品の場合、商品はFBA注文についてはAmazonフルフィルメントセンターで受領済み、出品者出荷の注文については出品者によって承認済みです。 | このトランザクションのクレジットノートが必要になりました。 |
CreditNoteProcessing | 出品者が請求書をアップロードし、Amazonが処理中です。 | この時点では、出品者のアクションは必要ありません。Amazonがクレジットノートを処理します。 |
CreditNoteUploaded | 出品者がクレジットノートをアップロードし、Amazonが処理を完了しました。エラーは検出されませんでした。 | 出品者のアクションは必要ありません。クレジットノートが正常にアップロードされ、顧客が「購入履歴」ページで閲覧できるようになりました。 |
CreditNoteRejected | 出品者がクレジットノートをアップロードし、Amazonが処理を完了しました。アップロード中にエラーが検出されました。 | 出品者は、このトランザクションのクレジットノートを再度アップロードする必要があります。 |
CreditNoteCreatedByAmazon | Amazonはこの取引のクレジットノートを作成しました。 | 出品者のアクションは必要ありません。 |
NoTaxCalculated | Amazon はこのトランザクションの税金を計算できませんでした。これは通常、出品者が貨物の発送元の国のVAT番号をアップロードしていない場合に発生します。 | AmazonはVATを計算しないため、出品者はこの取引の請求書をアップロードする必要があります。出品者はセラーセントラルまたはSP-APIを使用して請求書をアップロードできます。 |
InvoiceCreatedByAmazon | Amazonがこのトランザクションの請求書を作成しました。 | 出品者のアクションは必要ありません。 |
VIDR列
次の表では、VIDRの各列について説明します。
フィールド名 | 定義 | 例 |
---|---|---|
order-id | Amazon固有の注文識別子。出荷確認と注文後の処理に使用されます。 | 736-3563777-5518068 |
order-item-id | Amazon固有の注文商品識別子。出荷確認と注文後の処理に使用されます。 | 583563777345 |
shipping-id | この出荷の出荷ID。 | 409302382 |
fulfilled-by | この注文の配送経路/発送元。 | MFN or FBA |
order-date | 注文が行われた日付。 | 17/05/2018 |
marketplace-id | 注文が行われたマーケットプレイス。 | DE, FR, IT, ES |
recipient-name | 受取人の氏名。 | Mary Major |
buyer-name | 購入者の氏名。 | Diego Ramirez |
ship-service-level | 商品の注文時に購入者が支払ったフルフィルメントサービスのレベル。たとえば、標準配送やお急ぎ便などです。 | Standard |
ship-address-1 | 出荷先住所の最初の行。 | 123 Any Street |
ship-address-2 | 出荷先住所の2行目。 | Apt. 12 |
ship-address-3 | 出荷先住所の3行目。 | c/o Example Corp. |
ship-city | 出荷先住所の市区町村。 | Any City |
ship-state | 出荷先住所の都道府県。 | Any State |
ship-postal-code | 出荷先住所の郵便番号。 | SL1 1QP |
ship-country | 国際標準の2文字の国コード(ISO 3166準拠)。 | DE |
ship-phone-number | 出荷先住所の電話番号。 | 999999999 |
shipment-date | この出荷の発送日。 | 20/05/2018 |
billing-name | 請求先の氏名。 | Márcia Oliveira |
bill-address-1 | 請求先住所の最初の行。 | 100 Main Street |
bill-address-2 | 請求先住所の2行目。 | Apt. 12 |
bill-address-3 | 請求先住所の3行目。 | c/o AnyCompany |
bill-city | 請求先住所の市区町村。 | Any City |
bill-state | 請求先住所の都道府県。 | Any State |
bill-postal-code | 請求先住所の郵便番号。 | U7D 294 |
bill-country | 国際標準の2文字の国コード(ISO 3166準拠)。 | DE |
bill-phone-number | 請求先住所の電話番号。 | 44234343 |
ship-from-city | 出荷元住所の市区町村。 | Any City |
ship-from-state | 出荷元住所の都道府県。 | Any State |
ship-from-country | 出荷元住所の国。 | DE |
ship-from-postal-code | 出荷元住所の郵便番号。 | 10178 |
sku | 在庫管理ユニット。出品者が定義する、商品の固有識別子。 | sku123 |
product-name | 商品の名前。 | DJI CP.PT.03342 Spark - Battery Charging Hub |
quantity-purchased | 購入数量。 | 1 |
currency | トランザクションで使用された通貨。 | EUR |
asin | 商品のASIN。 | AY39345YE8K |
item-vat-incl-amount | VAT込みの商品価格。 | 120.00 |
item-vat-amount | 商品価格のVAT税額。 | 20.00 |
item-vat-excl-amount | VAT抜きの商品価格。 | 100.00 |
item-vat-rate | 商品価格のVAT税率。 | 0.20 |
gift-wrap-vat-incl-amount | ギフト包装のVAT込み総額。 | 12.00 |
gift-wrap-vat-amount | ギフト包装のVAT総額。 | 2.00 |
gift-wrap-vat-excl-amount | ギフト包装のVAT抜き総額。 | 10.00 |
gift-wrap-vat-rate | ギフト価格の合計VAT税率。 | 0.20 |
shipping-vat-incl-amount | VAT込みの配送料。 | 6.00 |
shipping-vat-amount | 配送料のVAT税額。 | 1.00 |
shipping-vat-excl-amount | VAT抜きの配送価格。 | 5.00 |
shipping-vat-rate | 配送料のVAT税率。 | 0.20 |
item-promo-vat-incl-amount | 商品プロモーションのVAT込み総額。 | -0.12 |
item-promo-vat-amount | 商品プロモーションのVAT総額。 | -0.02 |
item-promo-vat-excl-amount | 商品プロモーションのVAT抜き総額。 | -0.10 |
item-promo-vat-rate | 商品プロモーションの合計VAT税率。 | 0.20 |
item-promotion-id | 商品プロモーション用のプロモーション ID。Amazon によって生成される英数字の値。 | 136643052:AKY54VWVKS3JCY6T |
shipping-promo-vat-incl-amount | 配送プロモーションのVAT込み総額。 | -0.12 |
shipping-promo-vat-amount | 配送プロモーションのVAT総額。 | -0.02 |
shipping-promo-vat-excl-amount | 配送プロモーションのVAT抜き総額。 | -0.10 |
shipping-promo-vat-rate | 配送プロモーションの合計VAT税率。 | 0.20 |
shipping-promotion-id | 配送プロモーションのプロモーション ID。Amazon によって生成される英数字の値。 | 3943834723:BWJRJERIUDKERU |
gift-promo-vat-incl-amount | ギフト包装プロモーションのVAT込み総額。 | -0.20 |
gift-promo-vat-amount | ギフト包装プロモーションのVAT総額。 | -0.12 |
gift-promo-vat-excl-amount | ギフト包装プロモーションのVAT抜き総額。 | -0.02 |
gift-promo-vat-rate | ギフト包装プロモーションの合計VAT税率。 | 0.10 |
gift-promotion-id | ギフト包装プロモーションのプロモーションID。 | 385934052:BWJRJDJSDS3JCY6T |
transaction-id | 出荷の場合、これは配送IDです。返品の場合、これは配送IDとは異なる固有のトランザクションIDです。 | 409302382 (発送用); AMZN1: CROW: A0F6KWAFSV6YMALMHE4VJW (返品または返金用) |
transaction-type | トランザクションのタイプ。 | 発送、返品、または返金 |
is-amazon-invoiced | Amazonがこのトランザクションの請求書を作成するかどうかを示します。出品者がVCSを使用して請求書の作成をAmazonに許可するオプションを選択するか、またはAmazon World Importsが出品者から購入する場合はTrueです。これらのトランザクションについては、出品者は請求書を作成しないでください。Amazonが請求書を作成し、出品者に提供します。 | TRUEまたはFALSE |
invoice-status | 請求書のステータス。 | を参照してください ステップ 1 請求書ステータスの詳細について。 |
invoice-status-description | 請求書ステータスの説明。 | を参照してください ステップ 1 請求書ステータスの詳細について。 |
is-business-order | AmazonビジネスウェブサイトまたはB2Cウェブサイトからの注文であるかどうか。 | TRUEまたはFALSE |
purchase-order-number | PO番号(顧客から提供されている場合)。 | AB45-234934 (can be any string) |
seller-vat-number | VAT計算で使用された出品者のVAT番号。 | DE111111111 |
buyer-vat-number | VAT計算で使用された購入者のVAT番号。 | DE22222222、または顧客がAmazonにVAT番号を登録していない場合は空白。 |
buyer-company-name | 購入者の会社名。 | とある会社 |
price-designation | 法人向け価格か標準価格かを示します。 | Business Price or Standard Price |
invoice-number | 出品者が指定した請求書番号。PendingInvoices ビューでは、請求書がアップロードされていないため、この列は空白です。All ビューでは、列に、出品者がアップロードした請求書番号が表示されます。 | XXXX |
legacy-customer-order-item-id | この注文商品IDは、FBAレポートやMFNレポートに出力されているものと同じです。VIDRの個々のラインアイテムをFBAまたはMFNレポートと照合したい場合は、この列を使用します。 | 82840304120340 |
buyer-tax-registration-type | 顧客の課税タイプ(顧客が税務登録番号を持っている場合)。 | VAT、ビジネス登録、市民IDスペインとイタリアのマーケットプレイスでは、企業は事業者登録番号 (BusinessReg) を、個人は納税者番号 (CitizenID) を持つことができます。 |
is-buyer-physically-present | True は、顧客が税番号が提供された国に物理的に拠点を置いている場合です。 buyer-vat-number コラム。 | TRUEまたはFALSE |
is-seller-physically-present | 出品者が VAT 番号が提供された国に拠点を置いている場合は True seller-vat-number コラム。 | TRUEまたはFALSE |
buyer-e-invoice-account-id | 顧客の電子請求書アカウントID。顧客が電子請求書アカウントID(必要に応じてSistema di Interscambio(SdI)に請求書を送信するために使用)を指定した場合は、この情報が入力されています。この列は、2019年イタリアの電子請求書発行法の施行を受け、出品者がSdlに請求書をアップロードできるようにするために特別に追加されたものです。 | XXXXXXXX |
recommended-invoice-format | 税務当局に提出する推奨請求書形式値がPDFの場合は、PDF形式の請求書をAmazonにアップロードし、実際の請求書のコピーと同じPDFを使用する必要があります。推奨形式がXMLの場合、Amazonは顧客はIT分野のB2B顧客であり、出品者は物理的にIT分野での経験があると判断したため、出品者はイタリアの電子請求書法に従ってSistema di Interscambio (SDi) にXML請求書をアップロードする必要があります。SDi で入手可能な XML 請求書は、請求書の真のコピーとみなされます。ただし、PDF 形式の請求書を Amazon にアップロードする必要もあります。PDF には、請求書が重複していることを示す追加のテキストまたはウォーターマークが含まれている必要があります。顧客は SDi から元の請求書を取得できます。この列の値にかかわらず、出品者は必ず「請求書アップロード」フィードタイプを使用してPDF形式の請求書をAmazonにアップロードする必要があることに注意してください。 | PDF または XML。 |
Citation-en | この列には、引用テキストが英語で出力されます。 | 出品者には、請求書の引用テキストを使用することをお勧めします。請求書の言語に応じて、出品者は、引用に使用する言語を選択することもできます。 |
Citation-de | この列には、引用テキストがドイツ語で出力されます。 | 出品者には、請求書の引用テキストを使用することをお勧めします。請求書の言語に応じて、出品者は、引用に使用する言語を選択することもできます。 |
Citation-es | この列には、引用テキストがスペイン語で出力されます。 | 出品者には、請求書の引用テキストを使用することをお勧めします。請求書の言語に応じて、出品者は、引用に使用する言語を選択することもできます。 |
Citation-fr | この列には、引用テキストがフランス語で出力されます。 | 出品者には、請求書の引用テキストを使用することをお勧めします。請求書の言語に応じて、出品者は、引用に使用する言語を選択することもできます。 |
Citation-it | この列には、引用テキストがイタリア語で出力されます。 | 出品者には、請求書の引用テキストを使用することをお勧めします。請求書の言語に応じて、出品者は、引用に使用する言語を選択することもできます。 |
Is-invoice-corrected | このトランザクションが、以前に修正された請求書を参照しているかどうかを示します。このトランザクションが以前のトランザクションの修正である場合はTrueです。 | TRUEまたはFALSE |
original-vat-invoice-number | 請求書の修正が必要な元の貨物の請求書番号。 | 元の請求書番号。 |
invoice-correction-details | 請求書の変更内容を示す請求書の修正詳細。請求書修正トランザクションにのみ適用されます。 | 元のVAT請求書の請求先住所を修正した後に新しい請求書が発行されるか、元のVAT請求書の請求先住所を修正するクレジットノートが発行されます。 |
ステップ 2:VIDR レポートのデータから独自の請求書を作成する
VIDRレポートをダウンロードし、その情報を使用してVAT請求書を作成します。
ステップ 3:フィード API を使用して Amazon に請求書をアップロードします。
createFeed
オペレーションを呼び出して、UPLOAD_VAT_INVOICE
およびfeedType
となっているか検証します。
ヒント
お住まいの国のマーケットプレイス ID を取得するには、以下を参照してください。 マーケットプレイス ID。
にとって feedOptions
PDF 請求書では、キーと値のペアでメタデータを指定する必要があります。次のいずれか OrderId
または ShippingId
請求書をアップロードする場合は必須です (ShippingId
が好ましい)。
OrderId
: 請求書が提出されている注文の識別子。ShippingId
: 請求書が提出されている貨物の識別子。
含める場合 OrderId
そして ShippingId
、Amazon は注文 ID を無視し、配送 ID が記載された請求書をアップロードします。どちらも指定されない場合、エラーが発生する可能性があります。エラーに関するヘルプについては、を参照してください。 エラーハンドリング。
以下 feedOptions
です 必須:
TotalAmount
。請求書の合計金額。これは、商品、ギフト包装、配送料の VAT 込み価格から、すべてのプロモーションの VAT を差し引いたものです。指定された合計金額が、この出荷のAmazonの合計金額と一致しない場合 (小数点以下2桁まで)、請求書のアップロードは拒否されます。VIDR で提供される税額計算に厳密に従うことをお勧めします。TotalVATAmount
。請求書に記載されている VAT の合計金額。これは、商品、ギフト包装、配送料の VAT から、すべてのプロモーションの VAT を差し引いたものです。VAT額が、この配送についてAmazonが計算したVAT額と一致しない場合 (小数点以下2桁まで)、請求書のアップロードは拒否されます。VIDR で提供される税額計算に厳密に従うことをお勧めします。InvoiceNumber
。請求書に使用されている請求書番号。この請求書番号は顧客と共有されます。出品者は、請求書に同じ請求書番号が記載されていることを確認する必要があります。
以下 feedOptions
です オプショナル:
-
DocumentType
。指定できる値:Invoice
。請求書をアップロードする場合に使用します。CreditNote
。返金または返品のためにクレジットノートをアップロードする場合に使用します。
デフォルト値はInvoice
。
-
TransactionId
はDocumentType=CreditNote
の値になりました。
注意
キーや値の前後に引用符を付けないでください。Amazon では次の文字のみ受け付けています。カンマ (
,
)、フォワードスラッシュ (/
)、バックスラッシュ (\
)、スペース ()、ダッシュ ()-
)、アンダースコア (_
)、セミコロン (;
)、コロン (:
)、ハッシュ (#
), 0-9, A-Z, A-Z, A-Z。Amazonは余分なスペースをトリミングします。
請求フィードのスロットリング制限 (UPLOAD_VAT_INVOICE
) は 3 秒ごとに 1 件の請求書をアップロードします。
例
請求書のアップロード:
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}
クレジットノート (CN-123-ABC
はクレジットノート番号):
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}
フィードオプションを作成する Java コード:
Map<String, String> feedOptions = new HashMap<>(); // building parameter map
feedOptions.put("metadata:OrderId", "XXX-XXXXXXX-XXXXXXX");
feedOptions.put("metadata:TotalAmount", String.format(TOTALAMMOUNT));
feedOptions.put("metadata:TotalVATAmount", String.format(TOTALVATAMMOUNT));
feedOptions.put("metadata:InvoiceNumber", INVOICE_NUMBER);
String options = feedOptions.entrySet().stream()
.map(e -> String.format("%s=%s", e.getKey(), e.getValue()))
.collect(Collectors.joining(";"));
File pdfD = new File("<PATH TO PDF>");
byte[] pdfDocument = FileUtils.readFileToByteArray(pdfD); // read pdf document to byte array
String contentMD5 = Base64.encodeBase64String(pdfDocument); // building hash code
InputStream contentStream = new ByteArrayInputStream(pdfDocument); // inputstream of
SubmitFeedResponse response = submitFeed(contentStream, contentMD5, "_UPLOAD_VAT_INVOICE_", options, ContentType.OctetStream);
public SubmitFeedResponse submitFeed(InputStream, String contentMD5, String feedType, String feedOptions, ContentType contentType)
{
SubmitFeedRequest request = new SubmitFeedRequest();
request.setContentMD5(contentMD5);
request.setFeedContent(inputStream);
request.setFeedOptions(feedOptions);
request.setFeedType(feedType);
request.setMarketplaceIdList(new IdList(Arrays.asList(getMarketPlaces());
request.setMerchant(configuration.getAmazon().getSellerId());
request.setMWSAuthToken(configuration.getAmazon().getMwsAuthToken());
request.setContentType(contentType);
return getMarketplaceWebServiceClient().submitFeed(request);
}
請求書を手動でアップロード
選択したすべての出品者 じゃない VCSに登録するには、APIまたはセラーセントラルを使用して独自の請求書をAmazonにアップロードするというデフォルトのオプションがあります。このセクションでは、API の使用について説明します。
請求書を手動でアップロードするには、独自の税データを使用して請求書を作成する必要があります。あなたは じゃない VIDR レポートにアクセスできます。
createFeed
オペレーションを呼び出して、UPLOAD_VAT_INVOICE
およびfeedType
となっているか検証します。
ヒント
お住まいの国のマーケットプレイス ID を取得するには、以下を参照してください。 マーケットプレイス ID。
にとって feedOptions
PDF 請求書では、キーと値のペアでメタデータを指定する必要があります。次のいずれか OrderId
または ShippingId
請求書をアップロードする場合は必須です (ShippingId
が好ましい)。
OrderId
: 請求書が提出されている注文の識別子。ShippingId
: 請求書が提出されている貨物の識別子。
含める場合 OrderId
そして ShippingId
、Amazon は注文 ID を無視し、配送 ID が記載された請求書をアップロードします。どちらも指定されない場合、エラーが発生する可能性があります。エラーに関するヘルプについては、を参照してください。 エラーハンドリング。
以下 feedOptions
です 必須:
InvoiceNumber
。請求書に使用されている請求書番号。この請求書番号は顧客と共有されます。出品者は、請求書に同じ請求書番号が記載されていることを確認する必要があります。DocumentType
。指定できる値:Invoice
。請求書をアップロードする場合に使用します。CreditNote
。返金または返品のためにクレジットノートをアップロードする場合に使用します。
デフォルト値はInvoice
。
ヒント
手動アップロードでは、同じ注文 ID に対して複数の請求書をアップロードできます。ただし、請求書番号は一意である必要があります。最新の請求書のみが有効とみなされます。
以下 feedOptions
です オプショナル:
TotalAmount
。請求書の合計金額。これは、商品、ギフト包装、配送料の VAT 込み価格から、すべてのプロモーションの VAT を差し引いたものです。指定された合計金額が、この出荷のAmazonの合計金額と一致しない場合 (小数点以下2桁まで)、請求書のアップロードは拒否されます。VIDR で提供される税額計算に厳密に従うことをお勧めします。TotalVATAmount
。請求書に記載されている VAT の合計金額。これは、商品、ギフト包装、配送料の VAT から、すべてのプロモーションの VAT を差し引いたものです。VAT額が、この配送についてAmazonが計算したVAT額と一致しない場合 (小数点以下2桁まで)、請求書のアップロードは拒否されます。VIDR で提供される税額計算に厳密に従うことをお勧めします。TransactionId
はDocumentType=CreditNote
の値になりました。
注意
キーや値の前後に引用符を付けないでください。Amazon では次の文字のみ受け付けています。カンマ (
,
)、フォワードスラッシュ (/
)、バックスラッシュ (\
)、スペース ()、ダッシュ ()-
)、アンダースコア (_
)、セミコロン (;
)、コロン (:
)、ハッシュ (#
), 0-9, A-Z, A-Z, A-Z。Amazonは余分なスペースをトリミングします。
請求フィードのスロットリング制限 (UPLOAD_VAT_INVOICE
) は 3 秒ごとに 1 件の請求書をアップロードします。
例
請求書のアップロード:
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}
クレジットノート (CN-123-ABC
はクレジットノート番号):
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}
次のサンプルコードを使用してPDFファイルを添付できます。この例はJavaですが、他のプログラミング言語についてモデルとして使用できます。
Map<String, String> feedOptions = new HashMap<>(); // building parameter map
feedOptions.put("metadata:OrderId", "XXX-XXXXXXX-XXXXXXX");
feedOptions.put("metadata:TotalAmount", String.format(TOTALAMMOUNT));
feedOptions.put("metadata:TotalVATAmount", String.format(TOTALVATAMMOUNT));
feedOptions.put("metadata:InvoiceNumber", INVOICE_NUMBER);
String options = feedOptions.entrySet().stream()
.map(e -\> String.format("%s=%s", e.getKey(), e.getValue()))
.collect(Collectors.joining(";"));
File pdfD = new File("\<PATH TO PDF\>");
byte\[\] pdfDocument = FileUtils.readFileToByteArray(pdfD); // read pdf document to byte array
String contentMD5 = Base64.encodeBase64String(pdfDocument); // building hash code
InputStream contentStream = new ByteArrayInputStream(pdfDocument); // inputstream of
SubmitFeedResponse response = submitFeed(contentStream, contentMD5, "\_UPLOAD_VAT_INVOICE\_", options, ContentType.OctetStream);
public SubmitFeedResponse submitFeed(InputStream, String contentMD5, String feedType, String feedOptions, ContentType contentType)
{
SubmitFeedRequest request = new SubmitFeedRequest();
request.setContentMD5(contentMD5);
request.setFeedContent(inputStream);
request.setFeedOptions(feedOptions);
request.setFeedType(feedType);
request.setMarketplaceIdList(new IdList(Arrays.asList(getMarketPlaces());
request.setMerchant(configuration.getAmazon().getSellerId());
request.setMWSAuthToken(configuration.getAmazon().getMwsAuthToken());
request.setContentType(contentType);
return getMarketplaceWebServiceClient().submitFeed(request);
}
Updated 28 days ago