Guida ai casi d'uso dell'API Stato delle transazioni della gestione logistica diretta del fornitore v2021-23-28
Accesso programmatico allo stato della transazione di un fornitore con adempimento diretto (DF).
Versione API: 2021-12-28
Cos'è l'API Stato delle transazioni di gestione logistica diretta?
I fornitori possono utilizzare questa API per verificare lo stato delle transazioni POST.
È inclusa la seguente operazione:
Operazione | Metodo HTTP | Path | Descrizione |
---|---|---|---|
getTransactionStatus | GET | /vendor/directFulfillment/transactions/2021-12-28/transactions/{transactionId} | Restituisce lo stato della transazione indicato dal transactionId specificato. |
Ottieni lo stato della transazione
Vendors can use the getTransactionStatus
operation to check the status of a POST transaction. When a request is posted to Amazon using certain POST operations in the vendor APIs, such as submitAcknowledgement
or submitShipmentConfirmations
, for example, a successful response contains a transaction ID that uniquely identifies the transaction. Amazon will process the transaction asynchronously, and the final response will be available via the getTransactionStatus
operation.
Amazon offre lo stato di elaborazione finale per le transazioni POST come submitAcknowledgement
e submitShipmentConfirmations
tramite questa API. Consigliamo caldamente ai fornitori di verificare lo stato utilizzando questa API per assicurarsi che le transazioni siano state elaborate correttamente. Nel caso in cui si sia verificato un errore, riceverai i dettagli dell'errore per poter correggere e inviare nuovamente la transazione.
Stato transazione | Definizione |
---|---|
Processing | Amazon ha ricevuto la transazione API e la sta elaborando. L'elaborazione non è ancora completa. Verifica i termini di ogni operazione API per conoscere il tempo previsto per il completamento dell'elaborazione. |
Success | L'elaborazione della transazione API da parte di Amazon è andata a buon fine. |
Failure | La transazione API non è andata a buon fine durante l'elaborazione. I dettagli dell'errore saranno forniti nel corpo della risposta di getTransactionStatus . |
Lo stato della transazione è supportato per le seguenti API Gestione logistica diretta:
Descrizione | Sezione API | Operazione |
---|---|---|
Riconosci l'ordine | Ordini con gestione logistica diretta | submitAcknowledgement |
Invia conferme di spedizione | Spedizione con gestione logistica diretta | submitShipmentConfirmations |
Richiesta di etichetta di spedizione | Spedizione con gestione logistica diretta | submitShippingLabelRequest |
Aggiornamenti dello stato della spedizione | Spedizione con gestione logistica diretta | submitShipmentStatusUpdates |
Aggiornamento dell'inventario | Inventario di gestione logistica diretta | submitInventoryUpdate |
Fattura | Pagamenti di gestione logistica diretta | submitInvoice |
If the transaction status is Processing
and not updated to Failure
or Success
after 15 minutes, then the transaction has not successfully completed. The Success
status will appear if the transaction is successful and an error code will be provided for Failure
.
You cannot use this API for invoice messages as they are not supported and the status will be always be Processing
. For any payment related queries, go to Vendor Central, select Contact Us, and select the relevant queue if the status is not updated in the vendor central portal within a day. Please ensure the data submitted is correctly formatted before opening the case.
For shipping label requests, if the transaction is failed with a terminal error reason code such as Internal server error
, go to Vendor Central and select Contact Us to get the cause investigated. This generally happens due to operational constraints. For data related failures, you can correct the data and resubmit the payload to get the order fulfilled.
Richiesta getTransactionStatus
To return the transaction status, call the getTransactionStatus
operation and pass the following parameter:
Parametro del percorso:
Nome | Descrizione | Obbligatorio |
---|---|---|
transactionId |
Restituito in precedenza nella risposta alla richiesta POST di una transazione specifica. Tipo: stringa |
Sì |
Esempio di richiesta:
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/transactions/2021-12-28/transactions/20190904190535-eef8cad8-418e-4ed3-ac72-789e2ee6214a
Risposta getTransactionStatus
Una risposta con esito positivo include quanto segue:
Nome | Descrizione | Obbligatorio |
---|---|---|
transactionId |
L'identificatore univoco inviato nel campo transactionId in risposta alla richiesta post di una transazione specifica. Tipo: stringa |
Sì |
status |
Lo stato attuale di elaborazione della transazione. enum ( Status ) |
Sì |
errors |
Codice e messaggio di errore per la transazione non andata a buon fine. Disponibile solo quando lo stato della transazione è "Failure". Type: ErrorList |
No |
Esempio di risposta:
{
"transactionId": "20190918190535-eef8cad8-418e-456f-ac72-789e2ee6813c",
"status": "Failure",
"errors": [
{
"code": "INVALID_ORDER_ID",
"message": "Invalid order ID.",
"details": "Please verify that the order ID is correct."
}
]
}
Elenco degli errori
The following table contains a list of all possible error codes for each message type. You should configure these error codes in your system and design a failure handling mechanism. Each error code has a message that explains the error and details that suggest how to resolve the error before retrying the transaction.
Codice | Messaggio | Details | Message Type |
---|---|---|---|
INVALID_ORDER_ID | ID dell'ordine non valido. | Verifica che l'ID dell'ordine sia corretto. | Riconoscimento |
ACK_ALREADY_PROCESSED | Order confirmation already received for {orderId } | Non sono necessarie ulteriori azioni. | Riconoscimento |
INTERNAL_SERVER_ERROR | Errore interno Per favore riprova. | Riconoscimento | |
SHIP_METHOD_NOT_SUPPORTED | {ship_method } non supportato da questo canale | Si prega di richiedere l'etichetta per {ship_method }, utilizzando la configurazione esistente. | ShipLabel |
SHIP_METHOD_CHANGED | Il metodo di spedizione per questo ordine d'acquisto è cambiato da {old_ship_method } a {ship_method }. | Si prega di richiedere l'etichetta per {ship_method }, utilizzando la configurazione esistente. | ShipLabel |
INVALID_DIMENSION_UNIT | Richiesta rifiutata: ID dell'ordine {shipmentId } ha unità di misura non valide per la dimensione dei pacchi. | Assicurati che le dimensioni del pacco siano IN o CM | ShipLabel |
INVALID_PACKAGE_ID | Totale {count } Non valido o duplicato VendorPackageIds . | Please fix the Invalid or Duplicate VendorPackageIds and try again. | ShipLabel |
INVALID_ORDER_ID_WAREHOUSE_COMBINATION | Etichetta di spedizione rifiutata: ID dell'ordine {shipmentId } non appartiene al magazzino {warehouseCode }. | Si prega di inviare un ID d'ordine e un codice di magazzino validi | ShipLabel |
INVALID_ORDER_STATUS | Richiesta rifiutata: ordine {shipmentId } è stato annullato. | L'ordine non può essere spedito perché è in stato annullato, non provare a stampare nuovamente le etichette. Se ritieni che lo stato dell'ordine sia errato, contattaci. | ShipLabel |
INVALID_WAREHOUSE_CODE | Etichetta di spedizione rifiutata: codice di magazzino non valido {warehouseCode }. | Assicurati di inviare un codice di magazzino valido | ShipLabel |
SHIPMENT_NOT_MUTABLE | Richiesta rifiutata: dimensioni del pacco per il numero dell'ordine {shipmentId } non può essere aggiornato con lo stato attuale. | Non sono necessarie ulteriori azioni. | ShipLabel |
NO_ITEMS_PRESENT | Richiesta rifiutata: ID dell'ordine {shipmentId } contiene articoli non assegnati a nessun pacchetto. | Assicurati che tutti gli articoli siano mappati ai pacchi. | ShipLabel |
PACKAGE_DIMENSION_NOT_VALID | Richiesta rifiutata: ID dell'ordine {shipmentId } ha una dimensione non valida per i pacchi. | Aggiungi dimensioni valide per i tuoi pacchi. | ShipLabel |
PACKAGE_WEIGHT_NOT_VALID | Richiesta rifiutata: ID dell'ordine {shipmentId } ha un peso non valido per il/i pacco/i. | Aggiungi un peso valido per i tuoi pacchi. | ShipLabel |
NO_SHIP_METHOD_ASSIGNABLE | Richiesta rifiutata: al momento nessun metodo di spedizione può essere assegnato al numero dell'ordine {shipmentId }. | Impossibile assegnare il metodo di spedizione. Verifica che le dimensioni e il peso del pacco siano accurati e stampa l'etichetta più vicino alla data di spedizione prevista. | ShipLabel |
INCONSISTENT_SHIP_METHODS | Richiesta rifiutata: diversi metodi di spedizione assegnati a diversi pacchi. | Prova a spedire tutti gli articoli in un'unica scatola, se non è possibile contattaci. | ShipLabel |
INTERNAL_NON_RETRYABLE_FAILURE | Richiesta rifiutata: abbiamo riscontrato un problema durante l'elaborazione della tua richiesta. | Contattaci. | ShipLabel |
INTERNAL_RETRYABLE_FAILURE | Richiesta rifiutata: abbiamo riscontrato un problema durante l'elaborazione della tua richiesta. | Riprova tra qualche minuto. Per favore riprova. E se il problema persiste, contattaci. | ShipLabel |
EMPTY_PACKAGES | Avviso ASN! ID dell'ordine {shipmentId } ha pacchetti vuoti. | Per le spedizioni future, assicurati che il tuo ordine contenga dei pacchi. | Spedizione |
EMPTY_ITEMS | Avviso ASN! ID dell'ordine {shipmentId } ha articoli vuoti. | Per le spedizioni future, assicurati di aggiungere articoli al tuo ASN. | Spedizione |
INTERNAL_FAILURE | Errore interno Per favore riprova. | Errore interno Per favore riprova. | Spedizione |
NO_SHIP_METHOD | ASN rifiutato! No shipmethod trovato per i pacchetti {packageIds }. | Aggiungi il tuo shipmethod e riprova. | Spedizione |
SHIPMENT_UNSHIPPABLE | ASN rifiutato: ID dell'ordine {shipmentId } non ha un identificativo di tracciamento o non ha elaborato i documenti necessari (come l'etichetta e il p-slip). | Assicurati che tutti i documenti prerequisiti (come l'etichetta e il p-slip) siano elaborati e che sia fornito un numero di tracciamento valido. | Spedizione |
SHIPMENT_IMMUTABLE | ASN rifiutato! Lo stato della spedizione non consente l'aggiornamento della spedizione. | Non sono necessarie ulteriori azioni. | Spedizione |
NOT_ALL_ITEMS_PRESENT | ASN rifiutato: ID dell'ordine {shipmentId } ha spedito una quantità in pacchi che non corrisponde alla quantità dell'ordine e ad alcuni articoli potrebbe non essere assegnato un pacco. | Si prega di aggiungere gli articoli ai pacchi con la quantità di spedizione corretta. Per gli articoli - {fnSku }, la quantità prevista è {expectedQuantity } ma la quantità fornita è {providedQuantity }. | Spedizione |
NO_ITEMS_PRESENT | ASN rifiutato: ID dell'ordine {shipmentId } contiene articoli non assegnati a nessun pacchetto. | Aggiungi articoli ai pacchetti. | Spedizione |
DIMENSION_OR_WEIGHT_NOT_VALID | ASN rifiutato: ID dell'ordine {shipmentId } ha pacchi con peso negativo o pari a zero. | ASN rifiutato: ID dell'ordine {shipmentId } ha pacchi con peso negativo o pari a zero. | Spedizione |
SHIP_METHOD_UNASSIGNABLE | ASN rifiutato: ID dell'ordine {shipmentId } ha un metodo di spedizione che non può essere elaborato per i pacchi. | Impossibile elaborare il metodo di spedizione. Controlla le dimensioni, il peso e il metodo di spedizione del pacco. | Spedizione |
INVALID_MESSAGE_PAYLOAD | Campo di immissione non valido {fieldName }. | Spedizione | |
VOC_NO_CARRIER_DETAILS | ASN rifiutato! Per OrderID: {shipmentId }, i dettagli del corriere non sono presenti per il pacco {packageId }. | Aggiungi il corriere o il codice SCACcode e riprova. | Spedizione |
WEIGHT_NOT_PRESENT_FOR_PACKAGE | ASN rifiutato! Per ordine {shipmentId }. Nessun peso del pacchetto presente per la confezione {packageId }. | Aggiungi peso e riprova. | Spedizione |
INVALID_TRACKING_ID | ASN rifiutato: ID di tracciamento non valido per il pacco {packageId }. | Varia in base al corriere e per i fornitori di etichette Amazon Ship, il corriere deve corrispondere a quello sull'etichetta di spedizione | Spedizione |
INVALID_WAREHOUSE_CODE | ASN rifiutato: codice di magazzino non valido {warehouseCode }. | Verifica che il codice del magazzino sia corretto. | Spedizione |
ASN_ALREADY_PROCESSED | ASN già ricevuto per {shipmentId }. | Non è necessaria alcuna azione, l'ASN è già stato elaborato. | Spedizione |
INVALID_ORDER_ID_WAREHOUSE | ASN rifiutato: OrderID {orderId } non appartiene al magazzino {warehouseCode }. | Verifica che il codice del magazzino e il numero dell'ordine siano corretti. | Spedizione |
INTERNAL_SERVER_ERROR | Errore interno Per favore riprova. | Errore interno Per favore riprova. | Spedizione |
Updated 23 days ago