Tedarikçi Doğrudan Gönderim Ödemeleri API'si v1 Kullanım Senaryosu Rehberi
How to help vendors in the direct fulfillment (DF) program use the Payments API to manage their direct fulfillment operations.
API Sürümü: v1
Doğrudan Gönderim Ödemeleri API'si nedir?
Tedarikçiler, Amazon ile ödemeyle ilgili belgeleri paylaşmak için Doğrudan Gönderim Ödemeleri API'sini kullanabilir. submitInvoice
işlemi, tedarikçilerin onaylanan ve gönderilen siparişler için Amazon'a satıcı faturaları göndermesine olanak tanır.
Aşağıdaki işlemler, Ödemeler API'sine dahildir:
İşlem | HTTP Yöntemi | Path | Açıklama |
---|---|---|---|
submitInvoice | POST | /vendor/directFulfillment/payments/v1/invoices | Tedarikçinin doğrudan gönderim siparişleri için bir veya daha fazla fatura gönderir. |
submitInvoice
submitInvoice
işlemi, tedarikçilerin Amazon'dan gönderilen ürünler için ödeme talep etmek üzere satıcı faturaları göndermesine olanak tanır. Satıcılar bu API'yi kullanarak tek bir API çağrısında birden fazla fatura gönderebilir.
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.
Fatura gönderiminin paralel testleri
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.
Başarıyla gönderilen faturaların doğrulanması
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.
Aşağıdaki şemada, onaylanan ve gönderilen doğrudan gönderim siparişlerinin faturalarını göndermeyi sağlayan entegrasyon iş akışı gösterilmektedir:
İşletme gereksinimleri
Invoice numbers
must be unique, and they should never be reused (even after one year).
API kullanılarak gönderilen bir fatura yanlış veriler nedeniyle geçersiz olmuşsa ancak kağıt faturada doğru veriler varsa tedarikçi aynı Invoice ID
öğesini kullanarak API aracılığıyla faturayı doğru verilerle güncellemelidir.
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" olan bir fatura, faturanın geçersiz olmasına neden olacağından gönderilmemelidir.
Amazon, vergi uyumluluğu nedeniyle adres segmentlerinde tam adres ayrıntılarını ister. Bu gereklilik, özellikle bill to party
için önemlidir. Bu segmentte Amazon Alacaklı sistemi için tam bir eşleşme gerekir. Amazon faturalandırılacak taraf adreslerinin tam listesi ve JSON kodu örnekleri için SP-API faturalandırılacak taraf adresleri bölümünü inceleyin. Faturalandırılacak taraf konumu için Amazon Vergi Kimliğini bilmiyorsanız Vendor Central'a gidin ve Destek sayfasından destek kaydı oluşturmak için Bize Ulaşın düğmesini seçin.
Faturada gönderilen Payment terms
, Amazon alıcısıyla üzerinde anlaşılan ödeme koşullarıyla eşleşmelidir.
Item product identifier
, eşleşen satın alma siparişinde satıcıya gönderilen sipariş ürünü tanımlayıcısıyla eşleşmelidir..
The invoice total amount
should be equal to the total sum of the items, charges, and allowances.
Her satır düzeyi için tax amount
toplamı, başlık seviyesindeki vergi tutarı toplamına eşit olmalıdır.
total quantity
faturası, tüm ürünlerin miktarlarının toplamıyla eşleşmelidir.
Every different charge and allowance
must be itemized on the header level (for example, freight charge, package charge, small ordering charge).
Ülkeye özel işletme gereksinimleri
Doğrudan Gönderim Faturaları Hindistan'da API aracılığıyla desteklenmemektedir.
İşlevsellik | Hindistan | Avrupa | Kuzey Amerika |
---|---|---|---|
Invoice Type |
Desteklenmiyor | Fatura türü her zaman "Fatura" olmalıdır. | Fatura türü her zaman "Fatura" olmalıdır. |
Date |
Desteklenmiyor | "Şimdi" ya da daha önce olmalı. | "Şimdi" ya da daha önce olmalı. |
HSN Number |
Desteklenmiyor | Kullanılmıyor | Kullanılmıyor |
Tax Type at line and header level |
Desteklenmiyor | Gönderilecek vergi türü. | Kullanılmıyor |
Tax Registration Number |
Desteklenmiyor | KDV Numarası | KDV Numarası |
Tax Details at line and header level |
Desteklenmiyor |
Bir ürüne birden fazla vergi uygulanabilirse "Vergi ayrıntıları" bölümü ilgili ürün için uygun vergi türüyle birlikte birden fazla kez gönderilmelidir. Aynısı faturanın toplam tutarı için de geçerlidir. Vergi tutarını yerel para biriminde göndermek için kullanılabilecek "DomesticVAT" adında ek bir vergi türü de vardır. Yurt içi KDV'yi işlemek için "KDV" vergi türünde kullanılan Vergi Oranının aynısını kullanmanız gerekir. |
Bir ürüne birden fazla vergi uygulanabilirse "Vergi ayrıntıları" bölümü ilgili ürün için uygun vergi türüyle birlikte birden fazla kez gönderilmelidir. Aynısı faturanın toplam tutarı için de geçerlidir. |
Remit To Party |
Desteklenmiyor | Gönderilen ürünler için ödeme alacak olan tarafın (satıcı) vergi ve adres bilgileri. Bu zorunludur. | Gönderilen ürünler için ödeme alacak olan tarafın (satıcı) vergi ve adres bilgileri. Bu zorunludur. |
Ship From Party |
Desteklenmiyor | Satıcı kodu veya depo kodu ve ürünlerin gönderileceği tarafın adresi. | Satıcı kodu veya depo kodu ve ürünlerin gönderileceği tarafın adresi. |
Ship To Party |
Desteklenmiyor | Ürünlerin gönderileceği tarafın Amazon kimliği veya depo kodu ve adresi. | Ürünlerin gönderileceği tarafın Amazon kimliği veya depo kodu ve adresi. |
Bill To Party |
Desteklenmiyor |
Gönderilen ürünler için faturalandırılacak tarafın (Amazon) vergi ve adres bilgileri. Bu alan zorunludur. |
Gönderilen ürünler için faturalandırılacak tarafın (Amazon) vergi ve adres bilgileri. Bu alan zorunludur. |
Amazon Product Identifier and External Product Identifier |
Desteklenmiyor | Bu değerlerden en az biri zorunludur. Tanımlayıcı, siparişte alınanla aynı olmalıdır. | Bu değerlerden en az biri zorunludur. Tanımlayıcı, siparişte alınanla aynı olmalıdır. |
Net Cost |
Desteklenmiyor | Bu alan zorunludur. | Bu alan zorunludur. |
Purchase Order Number |
Desteklenmiyor |
Faturada birden fazla siparişle ilgili bilgiler bulunabilir. PO numarası farklı satır öğeleri için uygun şekilde gönderilmelidir. Zorunlu. |
Faturada birden fazla siparişle ilgili bilgiler bulunabilir. PO numarası farklı satır öğeleri için uygun şekilde gönderilmelidir. Zorunlu. |
Additional Details |
Desteklenmiyor | Bu alan, satıcı tarafın özel amaçlar için ek ayrıntılar göndermesi gerektiğinde kullanılır. Örneğin, Lehçe bölünmüş ödeme faturaları söz konusu olduğunda, satıcı taraf "SUR" tipi ve "PL" dil kodu ile "mechanizm podzielonej płatności" detayını göndermelidir. | Kullanılmıyor |
referenceNumber |
Desteklenmiyor | Kullanılmıyor | Kullanılmıyor |
submitInvoice isteği
Bir veya daha fazla fatura göndermek için submitInvoice
işlemini çağırın ve aşağıdaki parametreyi iletin:
Gövde parametresi:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
invoices |
submitInvoice işlemi için istek şeması. Tür: < |
Evet |
İstek örneği
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 yanıtı
Başarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
transactionId |
Bu işlemi tanımlamak için GUID . Bu değer, bu işlemin durumunu döndürmek için İşlem Durumu API'si ile kullanılabilir. Tür: dize |
Hayır |
Yanıt örneği
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Updated 23 days ago