Hub per sviluppatoriStato dell'APISupporto

Guida ai casi d'uso dell'API Spedizione con gestione logistica diretta del fornitore v1

Come aiutare i fornitori del programma Gestione logistica diretta a utilizzare l'API Spedizione per gestire le operazioni di gestione logistica diretta.

Versione API: v1

Cos'è l'API Spedizione di gestione logistica diretta?

I fornitori possono utilizzare l'API Spedizione di gestione logistica diretta per scambiare documenti relativi alle spedizioni con Amazon. I fornitori possono richiedere e ricevere etichette di spedizione, inviare conferme di spedizione, ottenere distinte di imballaggio e recuperare fatture dei clienti.

Ricorda che le fatture dei clienti sono specifiche per la regione indiana.

Sono disponibili le seguenti operazioni:

Operazione Metodo HTTP Path Descrizione
submitShippingLabelRequest POST /vendor/directFulfillment/shipping/v1/shippingLabels Invia richieste di etichette di spedizione singole o multiple.
getShippingLabels GET /vendor/directFulfillment/shipping/v1/shippingLabels Ottieni un elenco di etichette di spedizione in base a un criterio di filtro.

Note: This is a restricted operation and therefore requires a Restricted Data Token (RDT) for authorization. For more information, refer to the Tokens API Use Case Guide.
Note: Shipping labels will expire 90 days after creation through a submit shipping label request, hence shipping labels older than 90 days should not be requested.

getShippingLabel GET

/vendor/directFulfillment/shipping/v1/shippingLabels/{purchaseOrderNumber}

Ottieni un'etichetta di spedizione in base al numero di ordine d'acquisto.
Nota: le etichette di spedizione scadranno 90 giorni dopo la creazione tramite l'invio di una richiesta di etichetta di spedizione. Pertanto, non devono essere richieste etichette di spedizione più vecchie di 90 giorni.
submitShipmentConfirmations POST /vendor/directFulfillment/shipping/v1/shipmentConfirmations Invia conferme di spedizione singole o multiple ad Amazon.
submitShipmentStatusUpdates POST /vendor/directFulfillment/shipping/v1/shipmentStatusUpdates Invia un aggiornamento dello stato della spedizione. Solo per i corrieri del fornitore.
getPackingSlips GET /vendor/directFulfillment/shipping/v1/packingSlips Ottieni un elenco di distinte di imballaggio in base all'intervallo di date di creazione.

Note: This is a restricted operation and therefore requires a Restricted Data Token (RDT) for authorization. For more information, refer to the Tokens API Use Case Guide.
Note: Data retrieval can only go back six months, meaning that createdBefore cannot be more than six months in the past.

getPackingSlip GET /vendor/directFulfillment/shipping/v1/packingSlips/{purchaseOrderNumber} Ottieni la distinta di imballaggio per un ordine specifico in base al numero di ordine d'acquisto.
Nota: il recupero dei dati può arrivare solo a sei mesi prima, il che significa che createdBefore non può essere più di sei mesi nel passato.
getCustomerInvoices GET /vendor/directFulfillment/shipping/v1/customerInvoices Ottieni un elenco delle fatture dei clienti in base a un criterio di filtro.

Note: This is a restricted operation and therefore requires a Restricted Data Token (RDT) for authorization. For more information, refer to the Tokens API Use Case Guide.
Note: Data retrieval can only go back six months, meaning that createdBefore cannot be more than six months in the past.

getCustomerInvoice GET /vendor/directFulfillment/shipping/v1/customerInvoices/{purchaseOrderNumber} Ottieni una fattura del cliente in base al numero di ordine d'acquisto.
Nota: il recupero dei dati può arrivare solo a sei mesi prima, il che significa che createdBefore non può essere più di sei mesi nel passato.

submitShippingLabelRequest

L'operazione submitShippingLabelRequest consente ai fornitori di richiedere ad Amazon le informazioni relative all'etichetta di spedizione per ogni ordine d'acquisto. Puoi inviare più richieste di etichetta di spedizione in blocco con una singola chiamata API aderendo allo schema. Quando Amazon crea le etichette di spedizione, diventeranno disponibili per il download tramite l'operazione getShippingLabel.

Verifica delle richieste di etichetta di spedizione inviate correttamente

Vendors can verify the status of their shipping label requests using the Direct Fulfillment Transaction Status API. Allow the system up to 15 min to show the status after submission. If the transaction status is not updated after 30 minutes, open a Contact Us case in Vendor Central.

Flusso di lavoro di integrazione dell'API per le richieste di etichetta di spedizione

Il seguente diagramma illustra il flusso di lavoro per l'invio di richieste di etichetta di spedizione.

The Direct Fulfillment integration workflow for submitting shipping label requests.

Requisiti aziendali

Amazon deve ricevere una richiesta di etichetta di spedizione dopo che il fornitore ha accettato e confermato l'ordine d'acquisto tramite l'API Conferma dell'ordine.

Se utilizzi le etichette di spedizione di Amazon, l'invio di informazioni in merito agli articoli o al pacco nella richiesta è facoltativo.

Requisiti aziendali specifici per paese

Non esistono requisiti specifici per paese.

Richiesta submitShippingLabelRequest

Per richiedere etichette di spedizione, chiama l'operazione submitShippingLabelRequest e passa il seguente parametro:

Parametro del corpo:

Nome

Descrizione

Obbligatorio
shippingLabelRequests Richiede una o più etichette di spedizione.

Tipo: matrice < ShippingLabelRequest >

Esempio di richiesta:

POST "https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shippingLabels" { "shippingLabelRequests": [ { "purchaseOrderNumber": "2JK3S9VC", "sellingParty": { "partyId": "999US" }, "shipFromParty": { "partyId": "ABCD" }, "containers": [ { "containerType": "carton", "containerIdentifier": "123", "trackingNumber": "XXXX", "dimensions": { "length": "12", "width": "12", "height": "12", "unitOfMeasure": "IN" }, "weight": { "unitOfMeasure": "KG", "value": "10" }, "packedItems": [ { "itemSequenceNumber": 1, "buyerProductIdentifier": "B07DFVDRAB", "packedQuantity": { "amount": 1, "unitOfMeasure": "Each" } } ] } ] } ] }

Risposta submitShippingLabelRequest

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

getShippingLabels

The getShippingLabels operation returns shipping labels for all orders which meet the filter criteria specified in the request. You must have already requested shipping labels using the submitShippingLabelRequest operation before you use this API to get shipping labels available to you for fulfillment. Amazon recommends that vendors check for shipping labels at least once per hour during business hours. Depending on your business volume, you can choose to check more frequently. You can get up to 100 shipping labels in one API call. If there are more than 100 shipping labels you can use the nextToken value to get the next set of shipping labels.

📘

Autorizzazione con token di dati con restrizioni

Si tratta di un'operazione soggetta a restrizioni, la cui autorizzazione richiede un token di dati con restrizioni. Per maggiori informazioni, consulta Guida ai casi d'uso dell'API Token.

Il seguente diagramma illustra il flusso di lavoro di integrazione per il recupero di etichette di spedizione:

The Direct Fulfillment integration workflow when retrieving shipping labels.

Richiesta getShippingLabels

Per recuperare un elenco di etichette di spedizione, chiama l'operazione getShippingLabels e passa il seguente parametro:

Parametri di query:

Nome Descrizione Obbligatorio
shipFromPartyId L'ID del magazzino del fornitore da cui saranno gestiti gli ordini. Se non specificato, il risultato contiene ordini per tutti i magazzini.

Tipo: stringa

No
limit Il limite al numero di record restituiti.

Minimo: 1

Massimo: 100

Tipo: intero

No
createdAfter Le etichette di spedizione diventate disponibili dopo questa data e ora saranno incluse nel risultato. Deve essere nel formato data/ora ISO-8601.

Tipo: stringa (data-ora)

createdBefore Le etichette di spedizione diventate disponibili prima di questa data e ora saranno incluse nel risultato. Deve essere nel formato data/ora ISO-8601.

Tipo: stringa (data-ora)

sortOrder Ordina in modo crescente (ASC) o decrescente (DESC) in base alla data di creazione dell'ordine.

Tipo: enum (SortOrder)

No
nextToken Utilizzato per l'impaginazione quando ci sono più etichette di spedizione rispetto al limite di dimensione dei risultati specificato. Il valore del token è restituito nella chiamata API precedente.

Tipo: stringa

No

Esempio di richiesta:

GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shippingLabels?limit=2&createdAfter=2020-02-15T14:00:00-08:00&createdBefore=2020-02-20T00:00:00-08:00&sortOrder=DESC

Risposta getShippingLabels

Una risposta con esito positivo include quanto segue:

Nome Descrizione Obbligatorio
pagination Se vengono restituite più di 100 etichette di spedizione, nella risposta per l'impaginazione viene restituito nextToken.

Tipo: stringa

No
shippingLabels Elenco delle etichette di spedizione.

Tipo: matrice < ShippingLabel >

No

Esempio di risposta:

{ "pagination": { "nextToken": "MDAwMDAwMDAwMQ==" }, "shippingLabels": [ { "purchaseOrderNumber": "2JK3S9VC", "sellingParty": { "partyId": "999US" }, "shipFromParty": { "partyId": "ABCD" }, "labelFormat": "PNG", "labelData": [ { "packageIdentifier": "PKG001", "trackingNumber": "1Z6A34Y60369738804", "shipMethod": "UPS_GR_RES", "shipMethodName": "UPS Ground Residential", "content": "Base 64 encoded string goes here " } ] }, { "purchaseOrderNumber": "2JK3S9VD", "sellingParty": { "partyId": "999US" }, "shipFromParty": { "partyId": "ABCD" }, "labelFormat": "PNG", "labelData": [ { "packageIdentifier": "PKG002", "trackingNumber": "1Z6A34Y60369738805", "shipMethod": "UPS_GR_RES", "shipMethodName": "UPS Ground Residential", "content": "Base 64 encoded string goes here " } ] } ] }

Ottieni etichetta di spedizione

L'operazione getShippingLabel restituisce informazioni sull'etichetta di spedizione specificata utilizzando il numero di ordine d'acquisto. La risposta include informazioni complete sull'etichetta di spedizione per l'ordine d'acquisto, compresi il tipo di etichetta, i dettagli dell'ordine d'acquisto e il metodo di spedizione.

You can also use this API to get details for any shipping label (in the time range of seven days from a rolling window of the last six months, after the vendor went live on API).

Il seguente diagramma illustra il flusso di lavoro di integrazione per il recupero di un'etichetta di spedizione specifica:

The Direct Fulfillment integration workflow for retrieving a specific shipping label.

Entro quando deve essere richiesta l'etichetta di spedizione?

Le etichette ZPL e PNG devono essere richieste solo per il giorno in cui è prevista la spedizione degli ordini.

Requisiti aziendali specifici per paese

Non ci sono requisiti specifici per paese per le risposte relative all'etichetta di spedizione.

Richiesta getShippingLabel

Per richiedere un'etichetta di spedizione, chiama l'operazione getShippingLabel e passa il seguente parametro:

Parametro del percorso:

Nome Descrizione Obbligatorio
purchaseOrderNumber Il numero dell'ordine d'acquisto per il quale vuoi restituire l'etichetta di spedizione. Deve essere lo stesso purchaseOrderNumber ricevuto nell'ordine.

Tipo: stringa

Esempio di richiesta:

GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shippingLabels/2JK3S9VC

Risposta getShippingLabel

Una risposta con esito positivo include quanto segue:

Nome Descrizione Obbligatorio
purchaseOrderNumber Questo campo conterrà il numero dell'ordine d'acquisto relativo a quest'ordine.

Tipo: stringa

sellingParty ID della parte venditrice o del fornitore.

Tipo: PartyIdentification

shipFromParty Codice del magazzino del fornitore.

Tipo: PartyIdentification

labelFormat Formato dell'etichetta.

enumerazione (LabelFormat)

labelData Fornisce i dettagli dei pacchi presenti in questa spedizione.

Tipo: matrice < LabelData >

Esempio di risposta:

{ "purchaseOrderNumber": "2JK3S9VC", "sellingParty": { "partyId": "999US" }, "shipFromParty": { "partyId": "ABCD" }, "labelFormat": "PNG", "labelData": [ { "packageIdentifier": "PKG001", "trackingNumber": "1Z6A34Y60369738804", "shipMethod": "UPS_GR_RES", "shipMethodName": "UPS Ground Residential", "content": "Base 64 encoded string goes here" } ] }

submitShipmentConfirmations

L'operazione submitShipmentConfirmations consente ai fornitori di inviare conferme di spedizione ad Amazon, consentendo così di effettuare il monitoraggio delle spedizioni e informare i clienti in modo efficiente. La conferma contiene informazioni in merito agli articoli spediti, compresi il numero di ordine d'acquisto, la data di spedizione, la data di consegna prevista e il numero di spedizione.

Le conferme di spedizione ci consentono di collaborare in modo più efficace con i corrieri per il monitoraggio delle tue spedizioni.

La mancanza di una conferma di spedizione valida può comportare:

  • Visibilità insufficiente sulle spedizioni.

  • Errori nella riconciliazione delle spedizioni fisiche con gli ordini d'acquisto.

  • Follow-up manuali per risolvere le discrepanze.

Verifica delle conferme di spedizione inviate correttamente

Vendors can verify the status of their shipment confirmations via Vendor Central > Orders > Direct Fulfillment Orders or using the Direct Fulfillment Transaction Status API. Allow the system up to 10 min to determine the status after submission. If Vendor Central is not showing the correct values for the shipment confirmation, open a Contact Us case in Vendor Central. Refer to the Business Requirements section for information about creating shipment confirmations.

Il seguente diagramma illustra il flusso di lavoro di integrazione per l'invio di conferme di spedizione:

The Direct Fulfillment integration workflow for submitting shipment confirmations.

Requisiti aziendali

Devi utilizzare quest'API per confermare la spedizione di un ordine entro 4 ore dalla spedizione dell'ordine dal magazzino.

Per le spedizioni "floor denied", imposta il valore del campo shipmentStatus su FLOOR_DENIAL.

Tutte le voci dell'ordine d'acquisto devono essere presenti nella conferma di spedizione. La gestione logistica parziale dell'ordine non è consentita. I fornitori devono rifiutare l'ordine come "floor denial" se non è possibile gestire uno qualsiasi degli articoli.

Il itemSequenceNumber di un articolo deve corrispondere a quello ricevuto nel messaggio dell'ordine.

Per inviare la conferma di spedizione sono obbligatori buyerProductIdentifier o vendorProductIdentifier. È necessario inviare lo stesso valore ricevuto nell'ordine d'acquisto.

Per i corrieri del fornitore, è obbligatorio inviare scacCode.

Se l'etichetta di spedizione è fornita da Amazon, la sezione container è facoltativa in quanto Amazon ha accesso alle informazioni sul pacco. La selezione degli articoli è obbligatoria per l'invio.

Il container in una conferma di spedizione deve avere un shipMethod specificato.

Requisiti aziendali specifici per paese

Nessuno

Richiesta submitShipmentConfirmations

Per inviare conferme di spedizione, chiama l'operazione submitShipmentConfirmations e passa il seguente parametro:

Parametro del corpo:

Nome Descrizione Obbligatorio
shipmentConfirmations Elenco delle spedizioni confermate

Tipo: matrice < ShipmentConfirmation >

Esempio di richiesta:

POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shipmentConfirmations
{ "shipmentConfirmations": [ { "purchaseOrderNumber": "PO00050003", "shipmentDetails": { "shippedDate": "2019-08-07T19:56:45.632Z", "shipmentStatus": "SHIPPED", "isPriorityShipment": true, "estimatedDeliveryDate": "2019-08-07T19:56:45.632Z" }, "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "partyId": "VENDORWAREHOUSECODE" }, "items": [ { "itemSequenceNumber": 1, "buyerProductIdentifier": "ASIN001", "vendorProductIdentifier": "9782700001659", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Each" } }, { "itemSequenceNumber": 2, "buyerProductIdentifier": "ASIN002", "vendorProductIdentifier": "9782700001659", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Each" } }, { "itemSequenceNumber": 3, "buyerProductIdentifier": "ASIN003", "vendorProductIdentifier": "9782700001659", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Each" } }, { "itemSequenceNumber": 4, "buyerProductIdentifier": "ASIN004", "vendorProductIdentifier": "9782700001659", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Each" } } ], "containers": [ { "containerType": "carton", "containerIdentifier": "123", "trackingNumber": "TRACK001", "scacCode": "SCAC001", "carrier": "ABCD001", "shipMethod": "UPS", "dimensions": { "length": "10", "width": "10", "height": "10", "unitOfMeasure": "IN" }, "weight": { "unitOfMeasure": "KG", "value": "10" }, "packedItems": [ { "itemSequenceNumber": 1, "buyerProductIdentifier": "ASIN001", "packedQuantity": { "amount": 100, "unitOfMeasure": "Each" } } ] }, { "containerType": "carton", "containerIdentifier": "234", "trackingNumber": "TRACK002", "scacCode": "SCAC001", "carrier": "ABCD001", "shipMethod": "UPS", "dimensions": { "length": "10", "width": "10", "height": "10", "unitOfMeasure": "IN" }, "weight": { "unitOfMeasure": "KG", "value": "10" }, "packedItems": [ { "itemSequenceNumber": 2, "buyerProductIdentifier": "ASIN002", "packedQuantity": { "amount": 100, "unitOfMeasure": "Each" } } ] }, { "containerType": "carton", "containerIdentifier": "ABCD", "trackingNumber": "TRACK003", "scacCode": "SCAC001", "carrier": "ABCD001", "shipMethod": "UPS", "dimensions": { "length": "10", "width": "10", "height": "10", "unitOfMeasure": "IN" }, "weight": { "unitOfMeasure": "KG", "value": "10" }, "packedItems": [ { "itemSequenceNumber": 3, "buyerProductIdentifier": "ASIN003", "packedQuantity": { "amount": 100, "unitOfMeasure": "Each" } } ] }, { "containerType": "carton", "containerIdentifier": "id12", "trackingNumber": "TRACK004", "scacCode": "SCAC001", "carrier": "ABCD001", "shipMethod": "UPS", "dimensions": { "length": "10", "width": "10", "height": "10", "unitOfMeasure": "IN" }, "weight": { "unitOfMeasure": "KG", "value": "10" }, "packedItems": [ { "itemSequenceNumber": 4, "buyerProductIdentifier": "ASIN004", "packedQuantity": { "amount": 100, "unitOfMeasure": "Each" } } ] } ] } ] }

Risposta submitShipmentConfirmations

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

Esempio di risposta:

{ "transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605" }

submitShipmentStatusUpdates

⚠️

Importante

Gli aggiornamenti dello stato della spedizione devono essere utilizzati solo dai fornitori VOC (Vendor Own Carrier), ovvero i fornitori che utilizzano il proprio corriere per la consegna della spedizione e non usufruiscono dei corrieri Amazon. I fornitori si faranno carico dei costi di trasporto e della responsabilità di consegnare la spedizione ai clienti.

L'operazione submitShipmentStatusUpdates consente ai fornitori di aggiornare lo stato del trasporto per le spedizioni in transito verso il cliente finale. I fornitori che utilizzano il proprio corriere sono tenuti ad aggiornare lo stato della spedizione durante la fase di trasporto. Tali aggiornamenti sono noti come scansioni.

Queste informazioni saranno quindi inoltrate ai clienti Amazon nella pagina "I tuoi ordini" e miglioreranno così la visibilità sul monitoraggio dell'ordine e sul processo di consegna.

Il mancato aggiornamento dello stato di spedizione può comportare indicatori KPI negativi, come un basso tasso di scansioni, e portare alla sospensione del magazzino.

Verifica degli aggiornamenti dello stato di spedizione inviati correttamente

Vendors can verify the status of their shipment status updates via Vendor Central > Orders > Direct Fulfillment Orders or by using the Direct Fulfillment Transaction Status API. Allow the system up to 10 min to determine the status after submission. If Vendor Central is not showing the correct values for the shipment confirmation, open a Contact Us case in Vendor Central. Refer to the Business Requirements section for information about creating shipment confirmations.

Il seguente diagramma illustra il flusso di lavoro di integrazione per l'invio di aggiornamenti dello stato di spedizione:

The Direct Fulfillment integration workflow for submitting shipment status updates.

Requisiti aziendali

Dovresti utilizzare questa API solo se sei un fornitore VOC (Vendor Own Carrier), ovvero utilizzi il tuo corriere per trasportare la spedizione al cliente.

Devi utilizzare questa API solo per aggiornare lo stato di una spedizione dopo la conferma della stessa tramite l'API Conferma della spedizione o Vendor Central.

Il trackingNumber nell'API Stato della spedizione deve corrispondere al 100% al trackingNumber fornito nella conferma di spedizione, altrimenti l'aggiornamento dello stato di spedizione non andrà a buon fine.

Una chiamata API Stato della spedizione deve corrispondere a un pacco fisico. Puoi aggiornare lo stato di spedizione per diversi pacchi in una chiamata API raggruppandole in una matrice di aggiornamenti dello stato di spedizione.

Un ordine di gestione logistica diretta può risultare nella consegna di diversi pacchi al cliente. Pertanto, sono necessari diversi aggiornamenti dello stato di spedizione per riflettere lo stato di spedizione complessivo dell'ordine.

I fornitori devono inviare lo stato di spedizione quando possibile seguendo le linee guida di Amazon sullo stato di spedizione.

Per gli ordini con consegna programmata, i fornitori devono inviare la matrice shipmentSchedule che specifica la data di consegna prevista e la finestra di consegna.

Requisiti aziendali specifici per paese

Nessuno

Spiegazione dei campi aggiuntivi

statusCode and reasonCode

Questi campi sono codici standard utilizzati negli standard EDI, come ISA X12 ed EDIFACT, per fornire un evento di stato specifico e il motivo di tale evento. Ci aspettiamo una combinazione specifica di statusCode e reasonCode che determini un evento nella fase di trasporto della spedizione al cliente finale.

Questi sono gli stati e i codici motivo supportati e l'equivalenza con Vendor Central attuale:

Codice stato EDIFACTCodice motivo EDIFACTDescrizione operativaEquivalenza con l'UI di Vendor Central
404117La spedizione è in ritardo per via di un incidente su larga scala.DELAYED
301000La spedizione è stata consegnata al cliente.DELIVERED
101000La spedizione è partita dal centro logistico.DEPARTED\_FROM\_FC
201000La spedizione è arrivata presso una struttura del corriere.IN\_TRANSIT
409000Il corriere ha perso la spedizione.LOST
302000La spedizione è in consegna.OUT\_FOR\_DELIVERY
407000Il destinatario ha rifiutato di accettare la spedizione.REJECTED
416000La spedizione non è recapitabile e verrà distrutta.UNDELIVERABLE
Codice di stato X12Codice motivo X12Descrizione operativaEquivalenza con l'UI di Vendor Central
DEAFLa spedizione è in ritardo per via di un incidente su larga scala.DELAYED
D1NSLa spedizione è stata consegnata al cliente.DELIVERED
XBNSLa spedizione è partita dal centro logistico.DEPARTED\_FROM\_FC
O1NSLa spedizione è arrivata presso una struttura del corriere.IN\_TRANSIT
CAPLIl corriere ha perso la spedizione.LOST
ODNSLa spedizione è in consegna.OUT\_FOR\_DELIVERY
A7AMIl destinatario ha rifiutato di accettare la spedizione.REJECTED
APBGLa spedizione non è recapitabile e verrà distrutta.UNDELIVERABLE

Richiesta submitShipmentStatusUpdates

Per inviare aggiornamenti dello stato di spedizione, chiama l'operazione submitShipmentStatusUpdates e passa il seguente parametro:

Parametro del corpo:

Nome Descrizione Obbligatorio
shipmentStatusUpdates Elenco delle spedizioni confermate.

Tipo: matrice < ShipmentStatusUpdate >

Esempio di richiesta:

POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shipmentStatusUpdates { "shipmentStatusUpdates": [ { "purchaseOrderNumber": "DX00050015", "sellingParty": { "partyId": "999US" }, "shipFromParty": { "partyId": "ABCD" }, "statusUpdateDetails": { "trackingNumber": "TRACK005", "statusCode": "D1", "reasonCode": "NS", "statusDateTime": "2020-08-07T19:56:45Z", "statusLocationAddress": { "city": "Any Town", "postalCode": "98101", "stateOrRegion": "Washington", "countryCode": "US" } } } ] }

Risposta submitShipmentStatusUpdates

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

Esempio di risposta:

{ "transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605" }

getPackingSlips

L'operazione getPackingSlips restituisce una lista di distinte di imballaggio per gli ordini che rispettano i criteri specificati. Se hai bisogno di una distinte di imballaggio per un ordine specifico, usa l'operazione getPackingSlip.

📘

Autorizzazione con token di dati con restrizioni

Si tratta di un'operazione soggetta a restrizioni, la cui autorizzazione richiede un token di dati con restrizioni. Per maggiori informazioni, consulta Guida ai casi d'uso dell'API Token.

Devi utilizzare questa API per ottenere le distinte di imballaggio per gli ordini d'acquisto disponibili per la gestione logistica. Amazon consiglia ai fornitori di verificare la presenza di ordini almeno una volta all'ora durante l'orario lavorativo. A seconda del volume d'affari, puoi scegliere di controllare più frequentemente. Puoi ricevere fino a 100 distinte di imballaggio con una chiamata API. Se sono presenti più di 100 distinte, puoi utilizzare il valore nextToken come parametro nella prossima richiesta per ottenere il set successivo.

Il seguente diagramma illustra il flusso di lavoro di integrazione per il recupero di distinte di imballaggio:

The Direct Fulfillment integration workflow when retrieving packing slips.

Richiesta getPackingSlips

Per recuperare le distinte di imballaggio, chiama l'operazione getPackingSlips e passa i seguenti parametri:

Parametri di query:

Nome Descrizione Obbligatorio
shipFromPartyId Il warehouseId del fornitore per la gestione logistica dell'ordine. Se non viene specificato, il risultato conterrà ordini per tutti i magazzini.

Tipo: stringa

No
limit Il limite al numero di record restituiti.

Minimo: 1

Massimo: 100

Tipo: intero

No
createdAfter Le distinte di imballaggio diventate disponibili dopo questa data e ora saranno incluse nel risultato. Deve essere nel formato data/ora ISO-8601.

Tipo: stringa (data-ora)

createdBefore Le distinte di imballaggio diventate disponibili prima di questa data e ora saranno incluse nel risultato. Deve essere nel formato data/ora ISO-8601.

Tipo: stringa (data-ora)

sortOrder Ordina in modo ASC o DESC in base alla data della distinta di imballaggio.

Tipo: enum (SortOrder)

No
nextToken Utilizzato per l'impaginazione quando ci sono più distinte di imballaggio rispetto al limite di dimensione dei risultati specificato. Il valore del token è restituito nella chiamata API precedente.

Tipo: stringa

No

Esempio di richiesta:

GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/packingSlips?createdBefore=2020-06-12T12:00:00-08:00&createdAfter=2020-06-12T00:00:00-08:00&limit=2&sortOrder=DESC

Risposta getPackingSlips

Una risposta con esito positivo include quanto segue:

Nome Descrizione Obbligatorio
pagination Se vengono restituiti più di 100 ordini, nella risposta per l'impaginazione viene restituito nextToken.

Tipo: stringa

No
packingSlips Include i dettagli delle distinte di imballaggio.

Tipo: matrice < PackingSlip >

No

Esempio di risposta:

{ "payload": { "pagination": { "nextToken": "NEBxNEBxNEBxNR==" }, "packingSlips": [ { "purchaseOrderNumber": "UvgABdBjQ", "content": "base64 encoded string", "contentType": "application/pdf" }, { "purchaseOrderNumber": "VvgCDdBjR", "content": "base64 encoded string", "contentType": "application/pdf" } ] } }

getPackingSlip

L'operazione getPackingSlip restituisce informazioni sulla distinta di imballaggio specificata utilizzando il numero di ordine d'acquisto. La risposta include una stringa con codifica in base64 della distinta di imballaggio. Il tipo di contenuto sarà sempre "application/pdf".

Il seguente diagramma illustra il flusso di lavoro di integrazione per il recupero di una distinta di imballaggio:

The Direct Fulfillment integration workflow when retrieving a packing slip.

Richiesta getPackingSlip

Per recuperare una distinta di imballaggio, chiama l'operazione getPackingSlip e passa il seguente parametro:

Parametro del percorso:

Nome Descrizione Obbligatorio
purchaseOrderNumber Il purchaseOrderNumber per la distinta di imballaggio che desideri.

Tipo: stringa

Esempio di richiesta:

GET https://sellingpartnerapi-na.amazon.com /vendor/directFulfillment/shipping/v1/packingSlips/UkP3YkKDr

Risposta getPackingSlip

Una risposta con esito positivo include quanto segue:

Nome Descrizione Obbligatorio
purchaseOrderNumber Numero dell'ordine d'acquisto della spedizione relativa alla distinta di imballaggio.

Tipo: stringa

No
packingSlip

Informazioni sulla distinta di imballaggio.

Tipo: PackingSlip

No

Esempio di risposta:

{ "payload": { "purchaseOrderNumber": "UvgABdBjQ", "content": "base64 encoded string", "contentType": "application/pdf" } }

Ottieni le fatture dei clienti

The getCustomerInvoices operation returns customer invoices for all purchase orders which meet the filter criteria you specify. The use of this API is mandatory only in the India region and not required in any other region. Amazon recommends that vendors check for customer invoices at least once per hour during business hours. Depending on your business volume, you can choose to check more frequently. You can get up to 100 customer invoices in one API call. If there are more than 100 customer invoices you can use the nextToken value as a parameter in the next request to get the next set of customer invoices.

📘

Autorizzazione con token di dati con restrizioni

Si tratta di un'operazione soggetta a restrizioni, la cui autorizzazione richiede un token di dati con restrizioni. Per maggiori informazioni, consulta Guida ai casi d'uso dell'API Token.

Il seguente diagramma illustra il flusso di lavoro di integrazione per il recupero di fatture dei clienti:

The Direct Fulfillment integration workflow when retrieving customer invoices.

Richiesta getCustomerInvoices

Per recuperare le fatture dei clienti, chiama l'operazione getCustomerInvoices e passa i seguenti parametri:

Parametri di query:

Nome Descrizione Obbligatorio
shipFromPartyId Il warehouseId del fornitore per la gestione logistica dell'ordine. Se non specificato, il risultato conterrà ordini per tutti i magazzini.

Tipo: stringa

No
limit Il limite al numero di record restituiti.

Minimo: 1

Massimo: 10

Tipo: intero

No
createdAfter Gli ordini diventati disponibili dopo questa data e ora saranno inclusi nel risultato. Deve essere nel formato data/ora ISO-8601.

Tipo: stringa (data-ora)

createdBefore Gli ordini diventati disponibili prima di questa data e ora saranno inclusi nel risultato. Deve essere nel formato data/ora ISO-8601.

Tipo: stringa (data-ora)

sortOrder Ordina in modo crescente (ASC) o decrescente (DESC) in base alla data di creazione dell'ordine.

Tipo: enum (SortOrder)

No
nextToken Utilizzato per l'impaginazione quando ci sono più ordini rispetto al limite di dimensione dei risultati specificato. Il valore del token è restituito nella chiamata API precedente.

Tipo: stringa

No

Esempio di richiesta:

GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/customerInvoices?limit=2&createdAfter=2020-02-15T14:00:00-08:00&createdBefore=2020-02-20T00:00:00-08:00&sortOrder=DESC

Risposta getCustomerInvoices

Una risposta con esito positivo include quanto segue:

Nome Descrizione Obbligatorio
pagination Se vengono restituite più di 100 fatture dei clienti, nella risposta per l'impaginazione viene restituito nextToken.

Tipo: stringa

No
customerInvoices Elenco delle fatture dei clienti.

Tipo: matrice < CustomerInvoice >

No

Esempio di risposta:

{ "pagination": { "nextToken": "MDAwMDAwMDAwMQ==" }, "customerInvoices": [ { "purchaseOrderNumber": "PO98676856", "content": "base 64 content goes here" } ] }

Ottieni la fattura del cliente

L'operazione getCustomerInvoice restituisce informazioni sulla fattura del cliente specificata utilizzando il numero di ordine d'acquisto. La risposta include informazioni complete sulla fattura del cliente per tale ordine d'acquisto.

Puoi utilizzare questa API anche per ottenere dettagli per qualsiasi fattura del cliente che risale a un intervallo di tempo di 7 giorni in una finestra temporale pari agli ultimi 6 mesi, dopo che il fornitore ha iniziato a utilizzare l'API.

Il seguente diagramma illustra il flusso di lavoro di integrazione per il recupero di una fattura del cliente:

The Direct Fulfillment integration workflow for retrieving a customer invoice.

Requisiti aziendali specifici per paese

L'utilizzo dell'API per le fatture dei clienti è richiesto solo nella regione indiana.

Richiesta getCustomerInvoice

Per recuperare una fattura del cliente, chiama l'operazione getCustomerInvoice e passa il seguente parametro:

Parametro del percorso:

Nome Descrizione Obbligatorio
purchaseOrderNumber Numero dell'ordine d'acquisto della spedizione per cui restituire la fattura.

Tipo: stringa

Esempio di richiesta:

GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shippingLabels/2JK3S9VC

Risposta getCustomerInvoice

Una risposta con esito positivo include quanto segue:

Nome Descrizione Obbligatorio
purchaseOrderNumber Il numero di ordine d'acquisto per questo ordine.

Tipo: stringa

content La fattura del cliente con codifica Base64.

Tipo: stringa

Esempio di risposta:

{ "payload": { "purchaseOrderNumber": "PO98676856", "content": "base 64 encoded string" } }

Questa pagina ti è stata utile?