Hub per sviluppatoriStato dell'APISupporto

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:

OperazioneMetodo HTTPPathDescrizione
submitInvoicePOST/vendor/directFulfillment/payments/v1/invoicesInvia 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:

The Direct Fulfillment integration workflow for submitting invoices for direct fulfillment confirmed and shipped orders.

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: < InvoiceDetail > array

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" }

Questa pagina ti è stata utile?