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:
Vorgang | HTTP-Methode | Path | Beschreibung |
---|---|---|---|
getTransactionStatus | GET | /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.
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 |
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.
Kode | Nachricht | Details | Message Type |
---|---|---|---|
INVALID_ORDER_ID | Ungültige Bestellnummer. | Bitte überprüfen Sie, ob die Bestellnummer korrekt ist. | Anerkennung |
ACK_ALREADY_PROCESSED | Order confirmation already received for {orderId } | Es sind keine weiteren Maßnahmen erforderlich. | Anerkennung |
INTERNAL_SERVER_ERROR | Interner Fehler. Bitte versuchen Sie es erneut. | Anerkennung | |
SHIP_METHOD_NOT_SUPPORTED | {ship_method } wird von diesem Kanal nicht unterstützt | Bitte besorgen Sie sich ein Etikett für {ship_method }, unter Verwendung Ihres vorhandenen Setups. | ShipLabel |
SHIP_METHOD_CHANGED | Die 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_UNIT | Anfrage 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 sind | ShipLabel |
INVALID_PACKAGE_ID | Insgesamt {count } Ungültig oder doppelt VendorPackageIds . | Please fix the Invalid or Duplicate VendorPackageIds and try again. | ShipLabel |
INVALID_ORDER_ID_WAREHOUSE_COMBINATION | Versandetikett abgelehnt: Bestellnummer {shipmentId } gehört nicht zum Lagerhaus {warehouseCode }. | Bitte senden Sie eine gültige Bestellnummer und einen Lagercode | ShipLabel |
INVALID_ORDER_STATUS | Anfrage 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_CODE | ShippingLabel Rejected: Ungültiger Lagercode {warehouseCode }. | Bitte stellen Sie sicher, dass Sie einen gültigen Lagercode senden | ShipLabel |
SHIPMENT_NOT_MUTABLE | Anfrage 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_PRESENT | Anfrage 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_VALID | Anfrage 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_VALID | Anfrage 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_ASSIGNABLE | Anfrage 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_METHODS | Anfrage 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_FAILURE | Anfrage abgelehnt: Bei der Bearbeitung Ihrer Anfrage ist ein Problem aufgetreten. | Bitte nehmen Sie Kontakt mit uns auf. | ShipLabel |
INTERNAL_RETRYABLE_FAILURE | Anfrage 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_PACKAGES | ASN-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_ITEMS | ASN-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_FAILURE | Interner Fehler. Bitte versuchen Sie es erneut. | Interner Fehler. Bitte versuchen Sie es erneut. | Versand |
NO_SHIP_METHOD | ASN abgelehnt! Nein shipmethod für Paket (e) gefunden {packageIds }. | Bitte füge deine hinzu shipmethod und versuche es erneut. | Versand |
SHIPMENT_UNSHIPPABLE | ASN 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_IMMUTABLE | ASN abgelehnt! Der Versandstatus erlaubt es nicht, die Sendung zu aktualisieren. | Es sind keine weiteren Maßnahmen erforderlich. | Versand |
NOT_ALL_ITEMS_PRESENT | ASN 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_PRESENT | ASN abgelehnt: Bestellnummer {shipmentId } hat Artikel, die keinem Paket (en) zugewiesen sind. | Bitte fügen Sie Artikel zu Paketen hinzu. | Versand |
DIMENSION_OR_WEIGHT_NOT_VALID | ASN 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_UNASSIGNABLE | ASN 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_PAYLOAD | Ungültiges Eingabefeld {fieldName }. | Versand | |
VOC_NO_CARRIER_DETAILS | ASN 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_PACKAGE | ASN 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_ID | ASN 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 übereinstimmen | Versand |
INVALID_WAREHOUSE_CODE | ASN abgelehnt: Ungültiger Lagercode {warehouseCode }. | Bitte überprüfen Sie, ob der Lagercode korrekt ist. | Versand |
ASN_ALREADY_PROCESSED | ASN wurde bereits erhalten für {shipmentId }. | Keine Aktion erforderlich, ASN wurde bereits verarbeitet. | Versand |
INVALID_ORDER_ID_WAREHOUSE | ASN abgelehnt: OrderID {orderId } gehört nicht zum Lagerhaus {warehouseCode }. | Bitte überprüfen Sie, ob der Lagercode und die Bestellnummer korrekt sind. | Versand |
INTERNAL_SERVER_ERROR | Interner Fehler. Bitte versuchen Sie es erneut. | Interner Fehler. Bitte versuchen Sie es erneut. | Versand |
Updated 23 days ago