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. |
getShippingLabel
|
GET |
|
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. |
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. |
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.
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 < |
Sì |
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:
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) |
Sì |
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) |
Sì |
sortOrder |
Ordina in modo crescente (ASC ) o decrescente (DESC ) in base alla data di creazione dell'ordine. Tipo: enum ( |
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 < |
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:
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 |
Sì |
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 |
Sì |
sellingParty
|
ID della parte venditrice o del fornitore. Tipo: |
Sì |
shipFromParty
|
Codice del magazzino del fornitore. Tipo: PartyIdentification |
Sì |
labelFormat
|
Formato dell'etichetta. enumerazione (LabelFormat) |
Sì |
labelData
|
Fornisce i dettagli dei pacchi presenti in questa spedizione. Tipo: matrice < |
Sì |
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:
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 < |
Sì |
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 |
Sì |
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:
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 EDIFACT | Codice motivo EDIFACT | Descrizione operativa | Equivalenza con l'UI di Vendor Central |
---|---|---|---|
404 | 117 | La spedizione è in ritardo per via di un incidente su larga scala. | DELAYED |
301 | 000 | La spedizione è stata consegnata al cliente. | DELIVERED |
101 | 000 | La spedizione è partita dal centro logistico. | DEPARTED\_FROM\_FC |
201 | 000 | La spedizione è arrivata presso una struttura del corriere. | IN\_TRANSIT |
409 | 000 | Il corriere ha perso la spedizione. | LOST |
302 | 000 | La spedizione è in consegna. | OUT\_FOR\_DELIVERY |
407 | 000 | Il destinatario ha rifiutato di accettare la spedizione. | REJECTED |
416 | 000 | La spedizione non è recapitabile e verrà distrutta. | UNDELIVERABLE |
Codice di stato X12 | Codice motivo X12 | Descrizione operativa | Equivalenza con l'UI di Vendor Central |
---|---|---|---|
DE | AF | La spedizione è in ritardo per via di un incidente su larga scala. | DELAYED |
D1 | NS | La spedizione è stata consegnata al cliente. | DELIVERED |
XB | NS | La spedizione è partita dal centro logistico. | DEPARTED\_FROM\_FC |
O1 | NS | La spedizione è arrivata presso una struttura del corriere. | IN\_TRANSIT |
CA | PL | Il corriere ha perso la spedizione. | LOST |
OD | NS | La spedizione è in consegna. | OUT\_FOR\_DELIVERY |
A7 | AM | Il destinatario ha rifiutato di accettare la spedizione. | REJECTED |
AP | BG | La 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 < |
Sì |
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 |
Sì |
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:
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) |
Sì |
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) |
Sì |
sortOrder |
Ordina in modo ASC o DESC in base alla data della distinta di imballaggio. Tipo: enum ( |
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 < |
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:
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 |
Sì |
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: |
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:
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) |
Sì |
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) |
Sì |
sortOrder |
Ordina in modo crescente (ASC) o decrescente (DESC) in base alla data di creazione dell'ordine. Tipo: enum ( |
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 < |
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:
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 |
Sì |
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 |
Sì |
content |
La fattura del cliente con codifica Base64. Tipo: stringa |
Sì |
Esempio di risposta:
{
"payload": {
"purchaseOrderNumber": "PO98676856",
"content": "base 64 encoded string"
}
}
Updated 23 days ago