Dokumentation
Entwickler-HubAPI-StatusUnterstützung

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:

VorgangHTTP-MethodePathBeschreibung
getTransactionStatusGET/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.

TransaktionsstatusDefinition
ProcessingDie 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.
SuccessDie API-Transaktion wurde erfolgreich von Amazon verarbeitet.
FailureDie API-Transaktion ist während der Verarbeitung fehlgeschlagen. Die Fehlerdetails werden im Antworttext getTransactionStatuszur Verfügung gestellt.

Der Transaktionsstatus wird für die folgenden Direktversand-APIs unterstützt:

BeschreibungAPI-AbschnittVorgang
Bestellung bestätigenBestellungen mit DirektversandsubmitAcknowledgement
Versandbestätigungen übermittelnDirektversandsubmitShipmentConfirmations
Versandetikett anfordernDirektversandsubmitShippingLabelRequest
Aktualisierungen des VersandstatusDirektversandsubmitShipmentStatusUpdates
Aktualisierung des LagerbestandsDirektversand-LagerbestandsubmitInventoryUpdate
RechnungDirektversand-ZahlungensubmitInvoice

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: ErrorList

Nein

Beispiel für eine Antwort:

{ "transactionId": "20190918190535-eef8cad8-418e-456f-ac72-789e2ee6813c", "status": "Failure", "errors": [ { "code": "INVALID_ORDER_ID", "message": "Invalid order ID." } ] }

Hat Ihnen diese Seite weitergeholfen?