Transaktions-Status-API v1 für den Direktversand durch den Anbieter: Leitfaden für Anwendungsfälle
Help vendors in the direct fulfillment (DF) program use the Transaction Status API to manage their direct fulfillment operations.
API-Version: v1
Was ist die Direktversand-Transaktionsstatus-API?
Anbieter können diese API verwenden, um den Transaktionsstatus ihrer POST-Transaktionen zu überprüfen.
Der folgende Vorgang ist enthalten:
Vorgang | HTTP-Methode | Path | Beschreibung |
---|---|---|---|
getTransactionStatus | GET | /vendor/directFulfillment/transactions/v1/transactions/{transactionId} | Gibt den Status der Transaktion zurück, die durch die angegebene transactionId gekennzeichnet ist. |
Transaktionsstatus abrufen
Anbieter können den Vorgang getTransactionStatus
zur Überprüfung des Status einer POST-Transaktion nutzen. Wenn eine Anfrage mithilfe bestimmter POST-Vorgänge in den Anbieter-APIs an Amazon gesendet wird, z. B. submitAcknowledgement
oder submitShipmentConfirmations
, enthält eine erfolgreiche Antwort eine Transaktions-ID, die die Transaktion eindeutig identifiziert. Amazon verarbeitet die Transaktion asynchron und die endgültige Antwort steht über den Vorgang getTransactionStatus
zur Verfügung.
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 bietet den endgültigen Bearbeitungsstatus für POST-Transaktionen wie submitAcknowledgement
und submitShipmentConfirmations
über diese API an. Wir empfehlen Anbietern dringend, den Status mithilfe dieser API zu überprüfen, um sicherzustellen, dass die Transaktionen erfolgreich verarbeitet wurden. Wenn ein Fehler aufgetreten ist, erhalten Sie die Fehlerdetails, damit Sie die Transaktion korrigieren und erneut einreichen können.
Transaktionsstatus | Definition |
---|---|
Processing | Die API-Transaktion, die von Amazon empfangen wurde, wird bearbeitet. Die Bearbeitung ist noch nicht abgeschlossen. Überprüfen Sie die SLA für jeden API-Vorgang auf die erwartete Zeit bis zum Abschluss der Verarbeitung. |
Success | Die API-Transaktion wurde erfolgreich von Amazon verarbeitet. |
Failure | Die API-Transaktion ist während der Verarbeitung fehlgeschlagen. Die Fehlerdetails werden im Antworttext getTransactionStatus zur Verfügung gestellt. |
Der Transaktionsstatus wird für die folgenden Direktversand-APIs unterstützt:
Beschreibung | API-Abschnitt | Vorgang |
---|---|---|
Bestellung bestätigen | Bestellungen mit Direktversand | submitAcknowledgement |
Versandbestätigungen übermitteln | Direktversand | submitShipmentConfirmations |
Versandetikett anfordern | Direktversand | submitShippingLabelRequest |
Aktualisierungen des Versandstatus | Direktversand | submitShipmentStatusUpdates |
Aktualisierung des Lagerbestands | Direktversand-Lagerbestand | submitInventoryUpdate |
Rechnung | Direktversand-Zahlungen | submitInvoice |
Der Transaktionsstatus unterstützt vorerst nur die Statuscodes Processing
und Failure
. Wenn der Transaktionsstatus Processing
lautet und nach 30 Minuten nicht auf Failure
aktualisiert wurde, bedeutet dies, dass die Transaktion in unseren Systemen erfolgreich verarbeitet wurde. Der Status Success
wird in Zukunft unterstützt.
getTransactionStatus-Anfrage
Um den Transaktionsstatus zurückzugeben, rufen Sie den Vorgang getTransactionStatus
auf und übergeben Sie den folgenden Parameter:
Pfadparameter:
Name | Beschreibung | Erforderlich |
---|---|---|
transactionId |
Wurde zuvor in der Antwort auf die POST-Anfrage einer bestimmten Transaktion zurückgegeben. Typ: Zeichenfolge |
Ja |
Beispiel für eine Anfrage:
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/transactions/v1/transactions/20190904190535-eef8cad8-418e-4ed3-ac72-789e2ee6214a
getTransactionStatus-Antwort
Eine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
transactionId |
Die eindeutige ID, die im Feld transactionId als Antwort auf die Post-Anfrage einer bestimmten Transaktion gesendet wurde. Typ: Zeichenfolge |
Ja |
status |
Aktueller Bearbeitungsstatus der Transaktion. Enumeration ( Status ) |
Ja |
errors |
Fehlercode und -meldung für die fehlgeschlagene Transaktion. Nur verfügbar, wenn der Transaktionsstatus "Fehlgeschlagen" lautet. Typ: |
Nein |
Beispiel für eine Antwort:
{
"transactionId": "20190918190535-eef8cad8-418e-456f-ac72-789e2ee6813c",
"status": "Failure",
"errors": [
{
"code": "INVALID_ORDER_ID",
"message": "Invalid order ID."
}
]
}
Updated 5 months ago