Guida al flusso di lavoro relativo all'evasione diretta del fornitore
Integra e utilizza le API che supportano il Direct Fulfillment Program.
Amazon fornisce ai fornitori diverse API per il programma aziendale Direct Fulfillment. Questa guida riassume i passaggi che puoi intraprendere per l'integrazione con queste API Selling Partner (SP-API).
Panoramica sull'integrazione di Direct Fulfillment
Integrating with the Direct Fulfillment APIs starts with the vendor pulling the orders for fulfillment using the Vendor Direct Fulfillment Orders API v1, then sending an acknowledgement for the order.
After the order is packed and ready to be shipped, the vendor uses the createShippingLabels
operation to print a shipping label, and ships the order. After the order is shipped, a shipment confirmation is sent from the vendor to Amazon.
To release payment for the shipped items, the vendor sends the invoice using the submitInvoice
operation.
Versioni API
Terminologia
- Fornitore: Fornisce l'inventario venduto da Amazon sul sito di vendita al dettaglio di Amazon.
- Adempimento diretto: Un fornitore di Direct Fulfillment spedisce gli ordini ai clienti per conto di Amazon. Dopo che un cliente ha effettuato un acquisto da Amazon sul sito di vendita al dettaglio di Amazon, il fornitore Direct Fulfillment spedisce l'ordine direttamente al cliente.
- Ordine di acquisto: Un documento commerciale rilasciato da Amazon a un venditore/fornitore, che autorizza l'acquisto di beni o servizi.
- Riconoscimento dell'ordine: Quando un fornitore accetta o rifiuta un ordine di acquisto inviato da Amazon per l'evasione.
- Etichetta di spedizione: Un'etichetta fornita da Amazon che i fornitori utilizzano per spedire gli ordini direttamente ai clienti. L'etichetta contiene l'indirizzo di spedizione del cliente, i dettagli dell'ordine ed eventuali istruzioni speciali di gestione fornite da Amazon.
- Conferma della spedizione: La conferma della spedizione consente ad Amazon di tracciare in modo efficiente le spedizioni dei fornitori e informare i clienti. Aiuta a collaborare in modo più efficace con i corrieri nel monitoraggio delle spedizioni dei fornitori. Contiene informazioni sugli articoli spediti, tra cui il numero dell'ordine di acquisto, la data di spedizione, la data di consegna stimata e il numero di tracciamento.
- Fattura: Un documento di fatturazione che i fornitori forniscono ad Amazon per i prodotti che forniscono. Per ogni ordine di acquisto evaso dai fornitori con la spedizione di prodotti ai clienti, generano e inviano fatture ad Amazon. La fattura in genere include informazioni quali il numero dell'ordine di acquisto, i dettagli dell'articolo, i prezzi, le tasse e l'importo totale dovuto.
Prerequisiti
To complete the following tutorials, you must:
- Register yourself as a developer with the Direct-to-Consumer Shipping role
- Registra la tua candidatura
- Autorizza la tua applicazione SP-API
- Testa la tua applicazione con endpoint sandbox
Nota
Direct Fulfillment APIs support dynamic sandbox. Refer to the Vendor Direct Fulfillment Dynamic Sandbox guide and demo video for more details.
Tutorial: recupera l'elenco degli ordini di Direct Fulfillment per evadere e confermare gli ordini
Fase 1. Recupera l'elenco degli ordini Direct Fulfillment da evadere
Call the getOrders
operation to retrieve a list of new Direct Fulfillment purchase orders yet to be fulfilled. Use the parameters createdBefore
and createdAfter
to get the orders created within last 24 hours. The order status should be NEW
to fetch un-acknowledged items.
Esempio di codice
Fase 2. Riconosci l'ordine
Using the submitAcknowledgement
operation, acknowledge the orders. The purchase order can be accepted or rejected. Vendors should submit accurate acknowledgements as fast as possible, within at most 24 hours.
Esempio di codice
È necessario inviare una conferma completa, includendo tutte le voci dell'ordine di acquisto nell'ordine di acquisto. Le conferme parziali non sono accettate.
Fase 3 Verifica lo stato della transazione di conferma dell'ordine
Using the getTransactionStatus
operation, check the transaction status of the submitAcknowledgment
operation.
Esempio di codice
Dopo aver confermato l'ordine, attendi che il sistema mostri lo stato fino a 15 minuti.
Tutorial 2: Genera l'etichetta di spedizione e invia le conferme
Fase 1. Ottieni l'etichetta di spedizione
Get the shipping label for the order by using the createShippingLabel
operation. This is a synchronous operation that creates and then returns the shipping labels for a purchase order.
Esempio di codice
Puoi generare una o più etichette di spedizione per ogni ordine di acquisto. Non sono supportati più ordini di acquisto in un'unica richiesta.
Fase 2. Conferma la spedizione
Use the shipmentConfirmations
operation to confirm the shipment of a Direct Fulfillment order with the shipping information. Shipment confirmations allow Amazon to collaborate more effectively with carriers in tracking shipments.
Esempio di codice
Fase 3 Controlla lo stato della transazione di conferma della spedizione
Use the getTransactionStatus
operation to check the transaction status of the submitShipmentConfirmations operation.
Dopo aver inviato la conferma della spedizione, consenti al sistema di impiegare fino a 10 minuti per visualizzare lo stato.
For more information about these APIs, refer to the Vendor Direct Fulfillment Shipping API Use Case Guide.
Tutorial 3. Richiedi pagamenti da Amazon
Fase 1. Inviare le fatture
Using the submitInvoice
operation, the vendor sends the invoice to Direct Fulfillment to get payment released for the shipped items.
Importante
Gli articoli devono essere fatturati solo dopo essere stati confermati e spediti. In caso contrario, la fattura verrà rifiutata, nel qual caso il venditore deve esaminare il motivo del rifiuto e inviare una nuova fattura.
Fase 2. Verifica lo stato della transazione della fattura
Using the getTransactionStatus
operation, check the transaction status of the submitInvoice
operation. The Transaction Status API shows the status of the semantic validations of the submitted invoices; it doesn't show the actual status of invoice processing.
Dopo aver inviato la fattura ad Amazon, attendi 15 minuti per l'aggiornamento dello stato.
Nota
As a supplement to this guide, the SP-API Direct Fulfillment Sample Application provides complete end-to-end code and instructions to build and run the given sample codes using AWS services.
Updated 23 days ago