ベンダー出品者出荷支払いAPI v1ユースケースガイド
How to help vendors in the direct fulfillment (DF) program use the Payments API to manage their direct fulfillment operations.
APIバージョン:v1
出品者出荷支払いAPIとは
ベンダーは、出品者出荷支払いAPIを使用して、支払い関連書類をAmazonと交換できます。submitInvoice
オペレーションを使用して、確認済みおよび出荷済みの注文についてベンダー請求書をAmazonに送信できます。
支払いAPIには、以下のオペレーションが含まれています。
オペレーション | HTTPメソッド | Path | 説明 |
---|---|---|---|
submitInvoice | POST | /vendor/directFulfillment/payments/v1/invoices | ベンダーの出品者出荷注文の請求書を1つ以上送信します。 |
submitInvoice
ベンダーはsubmitInvoice
オペレーションを使用してベンダー請求書を送信することで、出荷した商品に対する支払いをAmazonに請求できます。このAPIでは、1回のAPI呼び出しで複数の請求書を送信できます。
Items should be invoiced only after they are confirmed and shipped to Amazon. Otherwise, the invoice will be rejected. An invoice with correct information will be processed by Amazon without any human interaction, which means that the vendor receives payment more quickly. Invoices with incorrect information will be rejected in Amazon's payee system, so sending correct information is very important. Refer to the business requirements section to learn how to create invoices with correct information.
請求書送信の並列テスト
After you complete the API invoice integration, our Accounts Payable (AP) department requires you to send one successful API invoice in production before considering you as live. If there are any issues with your initial production invoice, our AP team will contact you. After the API invoice is integrated into production, you must send invoices via API only. If you want to return to using just the Vendor Central option, contact us to update your account. Before finalizing your API invoice integration, submit all invoices with a "Non-submitted" status in your account under the Payments tab in the Direct Fulfillment invoices section. Existing invoices with the "Non-submitted" status might be rejected and not paid if sent via API.
正常に送信された請求書の検証
The Transaction Status API doesn't show the actual status of invoice processing, it only shows the status of the semantic validations of the submitted invoices. Vendors can verify the actual status of the original/updated version of the invoices via Vendor Central > Payments > Direct Fulfillment Invoices. For more information on how to use the Transaction Status API, refer to the business use case documentation for Transaction Status. Allow the system to take up to 15 minutes to show the original/updated version after submission. If Vendor Central is not showing the correct values for the updated invoice, open a Contact Us case in Vendor Central.
次の図は、出品者出荷が確認され、出荷された注文の請求書を送信するまでの統合ワークフローを示しています。
ビジネスの要件
Invoice numbers
must be unique, and they should never be reused (even after one year).
APIを使用して送信した請求書がデータの誤りにより送信されなかったが、紙の請求書には正しいデータが記載されている場合、ベンダーは同じInvoice ID
を使用して、APIを通じて正しいデータで請求書を更新する必要があります。
If an invoice has incorrect data (both paper and API) then the invoice is canceled and a new invoice should be sent with a new Invoice ID
.
total amount
が0の請求書を送信しないでください。送信すると請求書が失敗します。
Amazonでは、税務コンプライアンス上の理由により、住所のセグメントに完全な住所情報が必要です。これは特にbill to party
の場合に重要です。Amazon Payeeシステムでは、このセグメントが完全に一致している必要があります。Amazon の請求先住所とJSONコードの例の完全なリストについては、SP-API請求先住所を参照してください。請求先のAmazon税金IDがわからない場合は、Vendor Centralに移動し、サポートページで、お問い合わせボタンを選択してケースを作成します。
請求書に記載して送信するPayment terms
は、Amazonの購入者と合意した支払い条件と一致している必要があります。
Item product identifier
は、該当する発注書でベンダーに送信された注文商品の商品コードと一致する必要があります。
The invoice total amount
should be equal to the total sum of the items, charges, and allowances.
明細レベルのtax amount
合計は、ヘッダーレベルの税金合計額と一致している必要があります。
請求書のtotal quantity
は、すべての商品の数量合計と一致している必要があります。
Every different charge and allowance
must be itemized on the header level (for example, freight charge, package charge, small ordering charge).
国固有のビジネス要件
API経由での出品者出荷の請求書は、インドではサポートされていません。
機能 | インド | ヨーロッパ | 北米 |
---|---|---|---|
Invoice Type |
サポートなし | 請求書タイプは常に「Invoice」とします。 | 請求書タイプは常に「Invoice」とします。 |
Date |
サポートなし | 「now」またはそれ以前にする必要があります。 | 「now」またはそれ以前にする必要があります。 |
HSN Number |
サポートなし | 使用しません。 | 使用しません。 |
Tax Type at line and header level |
サポートなし | 送付する税金タイプ。 | 使用しません。 |
Tax Registration Number |
サポートなし | VAT番号 | VAT番号 |
Tax Details at line and header level |
サポートなし |
商品に複数の税金が適用される場合、「税金の詳細」セクションをその商品に適切な税金タイプで複数回送信する必要があります。 請求書の合計金額も同様です。 また、「Domestic VAT」という追加の税金タイプもあり、その税額を現地通貨で送信できます。Domestic VATを処理するには、税金タイプ「VAT」と同じTaxRateを使用する必要があります。 |
商品に複数の税金が適用される場合、「税金の詳細」セクションをその商品に適切な税金タイプで複数回送信する必要があります。 請求書の合計金額も同様です。 |
Remit To Party |
サポートなし | 発送された商品の支払いを受け取る当事者(ベンダー)の税金と住所の詳細。これは必須です。 | 発送された商品の支払いを受け取る当事者(ベンダー)の税金と住所の詳細。これは必須です。 |
Ship From Party |
サポートなし | 商品の出荷元のベンダーコードまたは倉庫コードおよび住所。 | 商品の出荷元のベンダーコードまたは倉庫コードおよび住所。 |
Ship To Party |
サポートなし | 商品の出荷先のAmazon IDまたは倉庫コードおよび住所。 | 商品の出荷先のAmazon IDまたは倉庫コードおよび住所。 |
Bill To Party |
サポートなし |
発送された商品の請求先(Amazon)の税金と住所の詳細。 このフィールドは必須です。 |
発送された商品の請求先(Amazon)の税金と住所の詳細。 このフィールドは必須です。 |
Amazon Product Identifier and External Product Identifier |
サポートなし | これらの値のうち少なくとも1つは必須です。IDは注文で受信するものと同じでなければなりません。 | これらの値のうち少なくとも1つは必須です。IDは注文で受信するものと同じでなければなりません。 |
Net Cost |
サポートなし | このフィールドは必須です。 | このフィールドは必須です。 |
Purchase Order Number |
サポートなし |
1通の請求書に複数の注文の情報を記載できます。PO番号は明細ごとに適宜送信する必要があります。 必須。 |
1通の請求書に複数の注文の情報を記載できます。PO番号は明細ごとに適宜送信する必要があります。 必須。 |
Additional Details |
サポートなし | このフィールドは、出品者側がその他の特記事項を送信する必要がある場合に使用します。たとえば、ポーランドの分割払い請求書の場合、出品者側は特記事項として、タイプ「SUR」で「LanguageCode」が「PL」の「mechanizm podzielonej płatności」を記載して送信する必要があります。 | 使用しません。 |
referenceNumber |
サポートなし | 使用しません。 | 使用しません。 |
submitInvoiceリクエスト
1通以上の請求書を送信するには、submitInvoice
オペレーションを呼び出し、次のパラメーターを渡します。
ボディのパラメーター:
名前 | 説明 | 必須 |
---|---|---|
invoices |
submitInvoice オペレーションのリクエストスキーマ。 タイプ:< |
はい |
リクエストの例
POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/payments/v1/invoices
{
"invoiceNumber": "0092590411",
"invoiceDate": "2020-03-13T11:16:24Z",
"remitToParty": {
"partyId": "YourVendorCode",
"address": {
"name": "Jane Doe",
"addressLine1": "123 Any Street",
"addressLine2": "123 Any Street",
"addressLine3": "123 Any Street",
"city": "Any Town",
"county": "Schwabing",
"district": "München",
"stateOrRegion": "Bayern",
"postalCode": "DEPostCode",
"countryCode": "DE"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "DE123456789"
}
]
},
"shipFromParty": {
"partyId": "ABCD"
},
"billToParty": {
"partyId": "5450534005838",
"address": {
"name": "John Doe",
"addressLine1": "100 Main Street",
"city": "Anytown",
"county": "Schwabing",
"district": "München",
"stateOrRegion": "Bayern",
"postalCode": "80807",
"countryCode": "DE"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "DE814584193",
"taxRegistrationAddress": {
"name": "John Doe",
"addressLine1": "100 Main Street",
"city": "Anytown",
"postalCode": "80807",
"countryCode": "DE"
},
"taxRegistrationMessage": "txmessage"
}
]
},
"shipToCountryCode": "DE",
"paymentTermsCode": "Basic",
"invoiceTotal": {
"currencyCode": "EUR",
"amount": "1428.00"
},
"taxTotals": [
{
"taxType": "CGST",
"taxRate": "0.19",
"taxAmount": {
"currencyCode": "EUR",
"amount": "228.00"
},
"taxableAmount": {
"currencyCode": "EUR",
"amount": "1200.00"
}
}
],
"items": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "B00IVLAABC",
"invoicedQuantity": {
"amount": 1,
"unitOfMeasure": "Each"
},
"netCost": {
"currencyCode": "EUR",
"amount": "1200.00"
},
"purchaseOrderNumber": "D3rC3KTxG",
"vendorOrderNumber": "0092590411",
"hsnCode": "76.06.92.99.00",
"taxDetails": [
{
"taxType": "CGST",
"taxRate": "0.19",
"taxAmount": {
"currencyCode": "EUR",
"amount": "228.00"
},
"taxableAmount": {
"currencyCode": "EUR",
"amount": "1200.00"
}
}
]
}
]
}
submitInvoiceレスポンス
成功レスポンスには、以下が含まれます。
名前 | 説明 | 必須 |
---|---|---|
transactionId |
このトランザクションを識別するためのGUID 。この値をトランザクションステータスAPIで使用して、このトランザクションのステータスを返すことができます。 タイプ:文字列 |
いいえ |
レスポンスの例
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Updated 23 days ago