Dokumentation
Entwickler-HubAPI-StatusUnterstützung

Transaktions-Status-API v1 für den Direktversand durch den Anbieter v2021-23-28: Leitfaden für Anwendungsfälle

Programmatischer Zugriff auf den Transaktionsstatus eines Direct-Fulfillment-Anbieters (DF).

API-Version: 2021-12-28

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/2021-12-28/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.

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

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.

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/2021-12-28/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.", "details": "Please verify that the order ID is correct." } ] }

Liste der Fehler

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.

KodeNachrichtDetailsMessage Type
INVALID_ORDER_IDUngültige Bestellnummer.Bitte überprüfen Sie, ob die Bestellnummer korrekt ist.Anerkennung
ACK_ALREADY_PROCESSEDOrder confirmation already received for {orderId}Es sind keine weiteren Maßnahmen erforderlich.Anerkennung
INTERNAL_SERVER_ERRORInterner Fehler. Bitte versuchen Sie es erneut.Anerkennung
SHIP_METHOD_NOT_SUPPORTED{ship_method} wird von diesem Kanal nicht unterstütztBitte besorgen Sie sich ein Etikett für {ship_method}, unter Verwendung Ihres vorhandenen Setups.ShipLabel
SHIP_METHOD_CHANGEDDie Versandmethode für diese Bestellung hat sich geändert von {old_ship_method} zu {ship_method}.Bitte holen Sie sich das Etikett für {ship_method}, unter Verwendung Ihres vorhandenen Setups.ShipLabel
INVALID_DIMENSION_UNITAnfrage abgelehnt: Bestellnummer {shipmentId} hat ungültige Maßeinheiten für die Dimension des Pakets.Bitte stellen Sie sicher, dass die Paketmaße IN oder CM sindShipLabel
INVALID_PACKAGE_IDInsgesamt {count} Ungültig oder doppelt VendorPackageIds.Please fix the Invalid or Duplicate VendorPackageIds and try again.ShipLabel
INVALID_ORDER_ID_WAREHOUSE_COMBINATIONVersandetikett abgelehnt: Bestellnummer {shipmentId} gehört nicht zum Lagerhaus {warehouseCode}.Bitte senden Sie eine gültige Bestellnummer und einen LagercodeShipLabel
INVALID_ORDER_STATUSAnfrage abgelehnt: Bestellung {shipmentId} wurde abgesagt.Die Bestellung kann nicht versendet werden, da sie sich im Status Storniert befindet. Bitte versuchen Sie nicht erneut, die Etiketten zu drucken. Wenn Sie der Meinung sind, dass dieser Bestellstatus falsch ist, kontaktieren Sie uns bitte.ShipLabel
INVALID_WAREHOUSE_CODEShippingLabel Rejected: Ungültiger Lagercode {warehouseCode}.Bitte stellen Sie sicher, dass Sie einen gültigen Lagercode sendenShipLabel
SHIPMENT_NOT_MUTABLEAnfrage abgelehnt: Paketmaße für die Bestellnummer {shipmentId} kann nicht mit dem aktuellen Status aktualisiert werden.Es sind keine weiteren Maßnahmen erforderlich.ShipLabel
NO_ITEMS_PRESENTAnfrage abgelehnt: Bestellnummer {shipmentId} hat Artikel, die keinem Paket (en) zugewiesen sind.Bitte stellen Sie sicher, dass alle Artikel den Paketen zugeordnet sind.ShipLabel
PACKAGE_DIMENSION_NOT_VALIDAnfrage abgelehnt: Bestellnummer {shipmentId} hat eine ungültige Dimension für das/die Paket (e).Bitte fügen Sie gültige Abmessungen für Ihr Paket (e) hinzu.ShipLabel
PACKAGE_WEIGHT_NOT_VALIDAnfrage abgelehnt: Bestellnummer {shipmentId} hat ein ungültiges Gewicht für das/die Paket (e).Bitte geben Sie ein gültiges Gewicht für Ihr Paket (e) an.ShipLabel
NO_SHIP_METHOD_ASSIGNABLEAnfrage abgelehnt: Derzeit kann der Bestellnummer keine Versandart zugewiesen werden {shipmentId}.Die Versandart konnte nicht zugewiesen werden. Bitte überprüfen Sie, ob die Abmessungen und das Gewicht Ihres Pakets korrekt sind, und drucken Sie das Etikett aus, das näher am voraussichtlichen Versanddatum liegt.ShipLabel
INCONSISTENT_SHIP_METHODSAnfrage abgelehnt: Verschiedene Versandarten sind verschiedenen Paketen zugewiesen.Bitte versuchen Sie, alle Artikel in einer einzigen Box zu versenden. Wenn dies nicht möglich ist, kontaktieren Sie uns bitte.ShipLabel
INTERNAL_NON_RETRYABLE_FAILUREAnfrage abgelehnt: Bei der Bearbeitung Ihrer Anfrage ist ein Problem aufgetreten.Bitte nehmen Sie Kontakt mit uns auf.ShipLabel
INTERNAL_RETRYABLE_FAILUREAnfrage abgelehnt: Bei der Bearbeitung Ihrer Anfrage ist ein Problem aufgetreten.Bitte versuchen Sie es in ein paar Minuten erneut. Bitte versuchen Sie es erneut. Und wenn das Problem weiterhin besteht, kontaktieren Sie uns bitte.ShipLabel
EMPTY_PACKAGESASN-Warnung! Nummer der Bestellung {shipmentId} hat leere Pakete.Stellen Sie für zukünftige Lieferungen sicher, dass Ihre Bestellung ein oder mehrere Pakete enthält.Versand
EMPTY_ITEMSASN-Warnung! Nummer der Bestellung {shipmentId} hat leere Artikel.Für zukünftige Lieferungen stellen Sie bitte sicher, dass Sie Artikel zu Ihrer ASN hinzufügen.Versand
INTERNAL_FAILUREInterner Fehler. Bitte versuchen Sie es erneut.Interner Fehler. Bitte versuchen Sie es erneut.Versand
NO_SHIP_METHODASN abgelehnt! Nein shipmethod für Paket (e) gefunden {packageIds}.Bitte füge deine hinzu shipmethod und versuche es erneut.Versand
SHIPMENT_UNSHIPPABLEASN abgelehnt: Bestellnummer {shipmentId} hat keine Tracking-ID oder die erforderlichen Dokumente (wie das Etikett und der P-Slip) wurden nicht verarbeitet.Bitte stellen Sie sicher, dass alle erforderlichen Dokumente (wie das Etikett und der P-Slip) bearbeitet wurden und eine gültige Tracking-ID bereitgestellt wird.Versand
SHIPMENT_IMMUTABLEASN abgelehnt! Der Versandstatus erlaubt es nicht, die Sendung zu aktualisieren.Es sind keine weiteren Maßnahmen erforderlich.Versand
NOT_ALL_ITEMS_PRESENTASN abgelehnt: Bestellnummer {shipmentId} hat eine Menge in Paketen versendet, die nicht der Bestellmenge entspricht, und einigen Artikeln ist möglicherweise kein Paket zugewiesen.Bitte fügen Sie Artikel zu Paketen mit der richtigen Versandmenge hinzu. Für Artikel - {fnSku}, die erwartete Menge ist {expectedQuantity} aber die angegebene Menge ist {providedQuantity}.Versand
NO_ITEMS_PRESENTASN abgelehnt: Bestellnummer {shipmentId} hat Artikel, die keinem Paket (en) zugewiesen sind.Bitte fügen Sie Artikel zu Paketen hinzu.Versand
DIMENSION_OR_WEIGHT_NOT_VALIDASN abgelehnt: Bestellnummer {shipmentId} hat ein oder mehrere Pakete mit einem negativen Gewicht oder einem Gewicht von Null.ASN abgelehnt: Bestellnummer {shipmentId} hat ein oder mehrere Pakete mit einem negativen Gewicht oder einem Gewicht von Null.Versand
SHIP_METHOD_UNASSIGNABLEASN abgelehnt: Bestellnummer {shipmentId} hat eine Versandmethode, die für das/die Paket (e) nicht verarbeitet werden kann.Die Versandmethode kann nicht verarbeitet werden. Bitte überprüfen Sie die Abmessungen, das Gewicht und die Versandart Ihres Pakets.Versand
INVALID_MESSAGE_PAYLOADUngültiges Eingabefeld {fieldName}.Versand
VOC_NO_CARRIER_DETAILSASN abgelehnt! Für OrderID: {shipmentId}, Angaben zum Spediteur sind für das Paket nicht vorhanden {packageId}.Bitte fügen Sie den Transporteur oder den SCAC-Code hinzu und versuchen Sie es erneut.Versand
WEIGHT_NOT_PRESENT_FOR_PACKAGEASN abgelehnt! Zur Bestellung {shipmentId}. Für das Paket ist kein Paketgewicht vorhanden {packageId}.Bitte fügen Sie Gewicht hinzu und versuchen Sie es erneut.Versand
INVALID_TRACKING_IDASN abgelehnt: Ungültige Tracking-ID für Paket {packageId}.Variiert je nach Transporteur und bei Anbietern von Amazon-Versandetiketten muss der Transporteur mit dem auf dem Versandetikett übereinstimmenVersand
INVALID_WAREHOUSE_CODEASN abgelehnt: Ungültiger Lagercode {warehouseCode}.Bitte überprüfen Sie, ob der Lagercode korrekt ist.Versand
ASN_ALREADY_PROCESSEDASN wurde bereits erhalten für {shipmentId}.Keine Aktion erforderlich, ASN wurde bereits verarbeitet.Versand
INVALID_ORDER_ID_WAREHOUSEASN abgelehnt: OrderID {orderId} gehört nicht zum Lagerhaus {warehouseCode}.Bitte überprüfen Sie, ob der Lagercode und die Bestellnummer korrekt sind.Versand
INTERNAL_SERVER_ERRORInterner Fehler. Bitte versuchen Sie es erneut.Interner Fehler. Bitte versuchen Sie es erneut.Versand

Hat Ihnen diese Seite weitergeholfen?