Guida ai casi d'uso dell'API Pagamenti con gestione logistica diretta del fornitore v1
How to help vendors in the direct fulfillment (DF) program use the Payments API to manage their direct fulfillment operations.
Versione API: v1
Cos'è l'API Pagamenti di gestione logistica diretta?
I fornitori possono utilizzare l'API Pagamenti di gestione logistica diretta per scambiare documenti relativi ai pagamenti con Amazon. L'operazione submitInvoice
consente ai fornitori di inviare fatture ad Amazon per gli ordini confermati e spediti.
Nell'API Pagamenti sono incluse le seguenti operazioni:
Operazione | Metodo HTTP | Path | Descrizione |
---|---|---|---|
submitInvoice | POST | /vendor/directFulfillment/payments/v1/invoices | Invia una o più fatture per gli ordini di gestione logistica diretta di un fornitore. |
submitInvoice
The submitInvoice
operation allows vendors to submit vendor invoices to request payment from Amazon for items shipped. Using this API, vendors can submit multiple invoices in a single API call.
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.
Test parallelo dell'invio di fatture
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.
Verifica delle fatture inviate correttamente
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.
Il seguente diagramma illustra il flusso di lavoro di integrazione per l'invio di fatture degli ordini confermati e spediti di gestione logistica diretta:
Requisiti aziendali
Invoice numbers
must be unique, and they should never be reused (even after one year).
Se l'invio di una fattura tramite API non è riuscito a causa di dati errati, ma la fattura cartacea presenta i dati corretti, il fornitore deve aggiornarla tramite l'API con i dati corretti utilizzando lo stesso Invoice ID
.
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
.
Non devono essere inviate fatture con total amount
= 0, poiché tali fatture non andrebbero a buon fine.
Amazon requires the full address details in the address segments for tax compliance reasons. This is especially important for the bill to party
. For this segment the Amazon Payee system requires an exact match. For a complete list of Amazon bill to party addresses and JSON code examples, refer to SP-API bill to party addresses. If you do not know the Amazon Tax ID for a bill to location, go to Vendor Central and from the Support page, select the Contact Us button to create a case.
I Payment terms
inviati in una fattura devono corrispondere ai termini di pagamento concordati con l'acquirente Amazon.
Il Item product identifier
dell'articolo deve corrispondere all'identificativo del prodotto dell'articolo dell'ordine inviato al fornitore nell'ordine d’acquisto corrispondente.
The invoice total amount
should be equal to the total sum of the items, charges, and allowances.
Il totale di tax amount
di ogni voce deve essere pari all'importo totale dell'imposta a livello di intestazione.
La total quantity
della fattura deve essere pari alla somma delle quantità di tutti gli articoli.
Every different charge and allowance
must be itemized on the header level (for example, freight charge, package charge, small ordering charge).
Requisiti aziendali specifici per paese
Le fatture di Gestione logistica diretta tramite API non sono supportate in India.
Funzionalità | India | Europa | Nord America |
---|---|---|---|
Invoice Type |
Non supportato | Il tipo di fattura deve essere sempre "Invoice". | Il tipo di fattura deve essere sempre "Invoice". |
Date |
Non supportato | Deve essere "now" o precedente. | Deve essere "now" o precedente. |
HSN Number |
Non supportato | Non in uso | Non in uso |
Tax Type at line and header level |
Non supportato | Tipo di imposta da inviare. | Non in uso |
Tax Registration Number |
Non supportato | Numero di partita IVA | Numero di partita IVA |
Tax Details at line and header level |
Non supportato |
Se a un articolo possono essere applicate più imposte, la sezione Dettagli fiscali deve essere inviata più volte con il tipo di imposta appropriato per tale articolo. Lo stesso vale per l'importo totale della fattura. Esiste anche un tipo di imposta aggiuntivo chiamato "DomesticVAT", che può essere utilizzato per inviare l'importo dell'imposta nella valuta locale. Per elaborare l'IVA nazionale devi utilizzare la stessa aliquota utilizzata per il tipo di imposta "VAT". |
Se a un articolo possono essere applicate più imposte, la sezione Dettagli fiscali deve essere inviata più volte con il tipo di imposta appropriato per tale articolo. Lo stesso vale per l'importo totale della fattura. |
Remit To Party |
Non supportato | Dati fiscali e indirizzo della parte (fornitore) che riceverà il pagamento per gli articoli spediti. È obbligatorio. | Dati fiscali e indirizzo della parte (fornitore) che riceverà il pagamento per gli articoli spediti. È obbligatorio. |
Ship From Party |
Non supportato | Codice fornitore o codice del magazzino e indirizzo della parte che spedisce gli articoli. | Codice fornitore o codice del magazzino e indirizzo della parte che spedisce gli articoli. |
Ship To Party |
Non supportato | ID Amazon o codice del magazzino e indirizzo della parte a cui saranno spediti gli articoli. | ID Amazon o codice del magazzino e indirizzo della parte a cui saranno spediti gli articoli. |
Bill To Party |
Non supportato |
Dati fiscali e indirizzo della parte (Amazon) a cui sarà intestata la fattura per gli articoli spediti. Questo campo è obbligatorio. |
Dati fiscali e indirizzo della parte (Amazon) a cui sarà intestata la fattura per gli articoli spediti. Questo campo è obbligatorio. |
Amazon Product Identifier and External Product Identifier |
Non supportato | Almeno uno di questi valori è obbligatorio. L'identificativo deve essere lo stesso ricevuto nell'ordine. | Almeno uno di questi valori è obbligatorio. L'identificativo deve essere lo stesso ricevuto nell'ordine. |
Net Cost |
Non supportato | Questo campo è obbligatorio. | Questo campo è obbligatorio. |
Purchase Order Number |
Non supportato |
Una fattura può contenere informazioni relative a più ordini. Il numero dell'ordine d'acquisto deve essere inviato correttamente in base alle diverse voci. Obbligatorio. |
Una fattura può contenere informazioni relative a più ordini. Il numero dell'ordine d'acquisto deve essere inviato correttamente in base alle diverse voci. Obbligatorio. |
Additional Details |
Non supportato | Questo campo viene utilizzato quando la parte venditrice deve inviare dettagli aggiuntivi per scopi speciali. Per esempio, nel caso delle fatture di split payment polacche, la parte venditrice deve inviare il dettaglio "mechanizm podzielonej płatności" del tipo "SUR" e con languageCode "PL". | Non in uso |
referenceNumber |
Non supportato | Non in uso | Non in uso |
Richiesta submitInvoice
To submit one or more invoices, call the submitInvoice
operation and pass the following parameter:
Parametro del corpo:
Nome | Descrizione | Obbligatorio |
---|---|---|
invoices |
Lo schema della richiesta per l'operazione submitInvoice . Type: <
|
Sì |
Esempio di richiesta
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"
}
}
]
}
]
}
Risposta submitInvoice
Una risposta con esito positivo include quanto segue:
Nome | Descrizione | Obbligatorio |
---|---|---|
transactionId |
GUID per identificare questa transazione. Questo valore può essere utilizzato nell'API Stato delle transazioni per restituire lo stato di questa transazione. Tipo: stringa |
No |
Esempio di risposta
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Updated 23 days ago