Hub per sviluppatoriStato dell'APISupporto

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:

OperazioneMetodo HTTPPathDescrizione
getTransactionStatusGET/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 transazioneDefinizione
ProcessingAmazon 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.
SuccessL'elaborazione della transazione API da parte di Amazon è andata a buon fine.
FailureLa 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:

DescrizioneSezione APIOperazione
Riconosci l'ordineOrdini con gestione logistica direttasubmitAcknowledgement
Invia conferme di spedizioneSpedizione con gestione logistica direttasubmitShipmentConfirmations
Richiesta di etichetta di spedizioneSpedizione con gestione logistica direttasubmitShippingLabelRequest
Aggiornamenti dello stato della spedizioneSpedizione con gestione logistica direttasubmitShipmentStatusUpdates
Aggiornamento dell'inventarioInventario di gestione logistica direttasubmitInventoryUpdate
FatturaPagamenti di gestione logistica direttasubmitInvoice

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

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

status Lo stato attuale di elaborazione della transazione.

enum ( Status )

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.

CodiceMessaggioDetailsMessage Type
INVALID_ORDER_IDID dell'ordine non valido.Verifica che l'ID dell'ordine sia corretto.Riconoscimento
ACK_ALREADY_PROCESSEDOrder confirmation already received for {orderId}Non sono necessarie ulteriori azioni.Riconoscimento
INTERNAL_SERVER_ERRORErrore interno Per favore riprova.Riconoscimento
SHIP_METHOD_NOT_SUPPORTED{ship_method} non supportato da questo canaleSi prega di richiedere l'etichetta per {ship_method}, utilizzando la configurazione esistente.ShipLabel
SHIP_METHOD_CHANGEDIl 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_UNITRichiesta 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 CMShipLabel
INVALID_PACKAGE_IDTotale {count} Non valido o duplicato VendorPackageIds.Please fix the Invalid or Duplicate VendorPackageIds and try again.ShipLabel
INVALID_ORDER_ID_WAREHOUSE_COMBINATIONEtichetta 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 validiShipLabel
INVALID_ORDER_STATUSRichiesta 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_CODEEtichetta di spedizione rifiutata: codice di magazzino non valido {warehouseCode}.Assicurati di inviare un codice di magazzino validoShipLabel
SHIPMENT_NOT_MUTABLERichiesta 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_PRESENTRichiesta 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_VALIDRichiesta rifiutata: ID dell'ordine {shipmentId} ha una dimensione non valida per i pacchi.Aggiungi dimensioni valide per i tuoi pacchi.ShipLabel
PACKAGE_WEIGHT_NOT_VALIDRichiesta 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_ASSIGNABLERichiesta 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_METHODSRichiesta 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_FAILURERichiesta rifiutata: abbiamo riscontrato un problema durante l'elaborazione della tua richiesta.Contattaci.ShipLabel
INTERNAL_RETRYABLE_FAILURERichiesta 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_PACKAGESAvviso ASN! ID dell'ordine {shipmentId} ha pacchetti vuoti.Per le spedizioni future, assicurati che il tuo ordine contenga dei pacchi.Spedizione
EMPTY_ITEMSAvviso ASN! ID dell'ordine {shipmentId} ha articoli vuoti.Per le spedizioni future, assicurati di aggiungere articoli al tuo ASN.Spedizione
INTERNAL_FAILUREErrore interno Per favore riprova.Errore interno Per favore riprova.Spedizione
NO_SHIP_METHODASN rifiutato! No shipmethod trovato per i pacchetti {packageIds}.Aggiungi il tuo shipmethod e riprova.Spedizione
SHIPMENT_UNSHIPPABLEASN 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_IMMUTABLEASN rifiutato! Lo stato della spedizione non consente l'aggiornamento della spedizione.Non sono necessarie ulteriori azioni.Spedizione
NOT_ALL_ITEMS_PRESENTASN 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_PRESENTASN rifiutato: ID dell'ordine {shipmentId} contiene articoli non assegnati a nessun pacchetto.Aggiungi articoli ai pacchetti.Spedizione
DIMENSION_OR_WEIGHT_NOT_VALIDASN 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_UNASSIGNABLEASN 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_PAYLOADCampo di immissione non valido {fieldName}.Spedizione
VOC_NO_CARRIER_DETAILSASN 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_PACKAGEASN rifiutato! Per ordine {shipmentId}. Nessun peso del pacchetto presente per la confezione {packageId}.Aggiungi peso e riprova.Spedizione
INVALID_TRACKING_IDASN 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 spedizioneSpedizione
INVALID_WAREHOUSE_CODEASN rifiutato: codice di magazzino non valido {warehouseCode}.Verifica che il codice del magazzino sia corretto.Spedizione
ASN_ALREADY_PROCESSEDASN già ricevuto per {shipmentId}.Non è necessaria alcuna azione, l'ASN è già stato elaborato.Spedizione
INVALID_ORDER_ID_WAREHOUSEASN rifiutato: OrderID {orderId} non appartiene al magazzino {warehouseCode}.Verifica che il codice del magazzino e il numero dell'ordine siano corretti.Spedizione
INTERNAL_SERVER_ERRORErrore interno Per favore riprova.Errore interno Per favore riprova.Spedizione

Questa pagina ti è stata utile?