Guida ai casi d'uso dell'API Stato delle transazioni della gestione logistica diretta del fornitore v1
Help vendors in the direct fulfillment (DF) program use the Transaction Status API to manage their direct fulfillment operations.
Versione API: v1
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/v1/transactions/{transactionId} | Restituisce lo stato della transazione indicato dal transactionId specificato. |
Ottieni lo stato della transazione
I fornitori possono utilizzare l'operazione getTransactionStatus
per verificare lo stato di una transazione POST. Quando viene inviata una richiesta ad Amazon utilizzando determinate operazioni POST nelle API per fornitori, come submitAcknowledgement
o submitShipmentConfirmations
, una risposta andata a buon fine contiene un ID transazione che identifica in modo univoco tale transazione. Amazon elaborerà la transazione in modo asincrono e la risposta finale sarà disponibile tramite l'operazione getTransactionStatus
.
Refer to the corresponding integration workflow diagram in the other sections of this guide to understand when to call the getTransactionStatus
operation to get the transaction status.
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 |
Per il momento, lo stato della transazione supporta solo i codici di stato Processing
e Failure
. Se lo stato della transazione è Processing
e non viene aggiornato in Failure
dopo 30 minuti, significa che la transazione è stata elaborata correttamente nei nostri sistemi. Lo stato Success
sarà supportato in futuro.
Richiesta getTransactionStatus
Per restituire lo stato della transazione, chiama l'operazione getTransactionStatus
e passa il seguente parametro:
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/v1/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. enumerazione (Status) |
Sì |
errors |
Codice e messaggio di errore per la transazione non andata a buon fine. Disponibile solo quando lo stato della transazione è "Failure". Tipo: |
No |
Esempio di risposta:
{
"transactionId": "20190918190535-eef8cad8-418e-456f-ac72-789e2ee6813c",
"status": "Failure",
"errors": [
{
"code": "INVALID_ORDER_ID",
"message": "Invalid order ID."
}
]
}
Updated 5 months ago