Direktversand durch den Anbieter API v2021-12-28: Leitfaden für Anwendungsfälle
Erfahren Sie, wie Sie die Vendor Direct Fulfillment (DF) Shipping API verwenden.
Benutze das API für direkten Versand um sendungsbezogene Dokumente mit Amazon auszutauschen.
Tutorials
Die Tutorials in diesem Abschnitt beschreiben, wie Sie:
- Anfragen zu Versandetiketten einreichen
- Holen Sie sich ein oder mehrere Versandetiketten
- Erstellen Versandetiketten und Etiketten für Behälter
- Einreichen Versandbestätigungen und Aktualisierungen des Versandstatus
- Besorgen Sie sich einen oder mehrere Packzettel
- Holen Sie sich eine oder mehrere Kundenrechnungen (Nur Indien)
Anfragen zu Versandetiketten einreichen
Der Vorgang submitShippingLabelRequest
ermöglicht Anbietern, für jede Bestellung Versandetiketteninformationen von Amazon anzufordern. Sie können mehrere Anfragen für Versandetiketten gleichzeitig in einem API-Aufruf senden, indem Sie das Schema einhalten. Wenn Versandetiketten von Amazon erstellt werden, können sie über den Vorgang getShippingLabel
heruntergeladen werden.
Hinweis
Das
submitShippingLabelRequest
Der Vorgang ist nur für Anbieter verfügbar, die Amazon-Versanddienstleister nutzen.
Anfragen zur Einreichung von Versandetiketten überprüfen
Sie können den Status Ihrer Versandetikettenanfragen mit dem API für DF-Transaktionen des Anbieters. Warten Sie nach der Einreichung bis zu 15 Minuten, bis das System den Status anzeigt. Wenn der Transaktionsstatus nach 30 Minuten nicht aktualisiert wird, öffnen Sie eine Kontaktiere uns Fall in Vendor Central.
Das folgende Diagramm zeigt den Workflow für das Einreichen von Versandetikettenanfragen.
Geschäftsanforderungen
-
Die Bestellung muss erfolgreich über API, EDI oder Vendor Central bestätigt werden, bevor Sie das Versandetikett anfordern. Anfragen nach Versandetiketten für unbestätigte oder stornierte Bestellungen werden abgelehnt.
-
Wenn Sie Amazon-eigene Versandetiketten verwenden, ist das Senden von Artikelinformationen oder Paketinformationen in der Anfrage optional.
submitShippingLabelRequest
erforderlich
submitShippingLabelRequest
erforderlichUm Versandetiketten anzufordern, rufen Sie den Vorgang submitShippingLabelRequest
auf und übergeben Sie den folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
shippingLabelRequests | Fordern Sie ein oder mehrere Versandetiketten an. Typ: < ShippingLabelRequest > Reihe | Ja |
Beispiel anfordern
POST "https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shippingLabels"
{
"shippingLabelRequests": [
{
"purchaseOrderNumber": "2JK3S9VC",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"containers": [
{
"containerType": "carton",
"containerIdentifier": "123",
"trackingNumber": "XXXX",
"dimensions": {
"length": "12",
"width": "12",
"height": "12",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 1,
"buyerProductIdentifier": "B07DFVDRAB",
"packedQuantity": {
"amount": 1,
"unitOfMeasure": "Each"
}
}
]
}
]
}
]
}
submitShippingLabelRequest
erforderlich
submitShippingLabelRequest
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
transactionId | GUID zur Identifizierung dieser Transaktion. Dieser Wert kann mit dem verwendet werden API für DF-Transaktionen des Anbieters um den Status dieser Transaktion zurückzugeben.<br.>Typ: Zeichenfolge | Nein |
Beispiel für eine Antwort
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Versandetikett abrufen
Der Vorgang nextToken">getShippingLabels
gibt Versandetiketten für alle Bestellungen zurück, die die in der Anfrage angegebenen Filterkriterien erfüllen. Sie müssen bereits Versandetiketten mit dem Vorgang submitShippingLabelRequest
angefordert haben, bevor Sie diese API verwenden können, um Versandetiketten für den Versand zu erhalten. Amazon empfiehlt Anbietern, während der Geschäftszeiten mindestens einmal pro Stunde auf Versandetiketten zu überprüfen. Abhängig von Ihrem Geschäftsvolumen können Sie sich dafür entscheiden, häufiger zu prüfen. Sie können bis zu 100 Versandetiketten in einem API-Aufruf abrufen. Wenn es mehr als 100 Versandetiketten gibt, können Sie den nextToken-Wert verwenden, um den nächsten Satz von Versandetiketten abzurufen.
Versandetiketten laufen 90 Tage nach ihrem Erstellungsdatum ab (der submitShippingLabelRequest
Datum).
Hinweis
Dies ist ein eingeschränkter Vorgang und erfordert daher ein Restricted Data Token (RDT) für die Autorisierung. Weitere Informationen finden Sie im Leitfaden zu Token-API-Anwendungsfällen.
Das folgende Diagramm zeigt den Integrations-Workflow beim Abrufen von Versandetiketten:
getShippingLabels
erforderlich
getShippingLabels
erforderlichUm eine Liste der Versandetiketten abzurufen, rufen Sie den Vorgang getShippingLabels
auf und übergeben Sie die folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
shipFromPartyId | Der Verkäufer warehouseId zur Auftragserfüllung. Wenn nicht angegeben, enthält die Antwort Bestellungen für alle Lager.Typ: Zeichenfolge | Nein |
limit | Das Limit für die Anzahl der zurückgegebenen Datensätze. Typ: Integer | Nein |
createdAfter | Versandetiketten, die nach diesem Datum und dieser Uhrzeit verfügbar wurden, werden in der Antwort enthalten sein. Muss drin sein ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) | Ja |
createdBefore | Versandetiketten, die vor diesem Datum und dieser Uhrzeit verfügbar waren, werden in das Ergebnis aufgenommen. Muss drin sein ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) | Ja |
sortOrder | Aufsteigend sortieren (ASC ) oder absteigend (DESC ) nach dem Erstellungsdatum der Bestellung.Typ: enum ( SortOrder ) | Nein |
nextToken | Wird für die Seitennummerierung verwendet, wenn mehr Versandetiketten als die angegebene Größenbeschränkung für das Ergebnis vorhanden sind. Der Token-Wert wird im vorherigen API-Aufruf zurückgegeben. Typ: Zeichenfolge | Nein |
Beispiel anfordern
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shippingLabels?limit=2&createdAfter=2020-02-15T14:00:00-08:00&createdBefore=2020-02-20T00:00:00-08:00&sortOrder=DESC
getShippingLabels
erforderlich
getShippingLabels
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
pagination | Wenn mehr als 100 Versandetiketten zurückgegeben werden, wird nextToken in der Antwort für die Paginierung zurückgegeben. | Nein |
shippingLabels | Liste der Schiffsetiketten. Typ: < ShippingLabel > Reihe | Nein |
Beispiel für eine Antwort
{
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"shippingLabels": [
{
"purchaseOrderNumber": "2JK3S9VC",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"labelFormat": "PNG",
"labelData": [
{
"packageIdentifier": "PKG001",
"trackingNumber": "1Z6A34Y60369738804",
"shipMethod": "UPS_GR_RES",
"shipMethodName": "UPS Ground Residential",
"content": "Base 64 encoded string goes here "
}
]
}, {
"purchaseOrderNumber": "2JK3S9VD",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"labelFormat": "PNG",
"labelData": [
{
"packageIdentifier": "PKG002",
"trackingNumber": "1Z6A34Y60369738805",
"shipMethod": "UPS_GR_RES",
"shipMethodName": "UPS Ground Residential",
"content": "Base 64 encoded string goes here "
}
]
}
]
}
Versandetikett abrufen
Der Vorgang getShippingLabel
gibt Informationen über das Versandetikett zurück, das Sie mithilfe der Bestellnummer spezifizieren. Die Antwort enthält vollständige Versandetiketteninformationen für die Bestellung, einschließlich Etikettentyp, Bestelldetails und Versandmethode.
Versandetiketten laufen 90 Tage nach ihrem Erstellungsdatum ab (der submitShippingLabelRequest
Datum).
Hinweis
Dies ist ein eingeschränkter Vorgang und erfordert daher ein Restricted Data Token (RDT) für die Autorisierung. Weitere Informationen finden Sie im Leitfaden zu Token-API-Anwendungsfällen.
Sie können diese API auch verwenden, um Details für jedes Versandetikett abzurufen (im Zeitraum von 7 Tagen ab einem fortlaufenden Zeitfenster der letzten 6 Monate, nachdem der Anbieter die API live geschaltet hat).
Das folgende Diagramm zeigt den Integrations-Workflow zum Abrufen eines bestimmten Versandetiketts:
Geschäftsanforderungen
- Welche Art von Etiketten stehen zum Herunterladen zur Verfügung?
Die unterstützten Etikettenformate sind ZPL und PNG. Der Etiketteninhalt wird im Base-64-Zeichenkettenformat bereitgestellt, sodass Sie die Zeichenfolge in das gewünschte Etikettenformat konvertieren können. Die Wahl des Etikettenformats liegt beim Verkäufer, der dies im Rahmen des Einführungsprozesses in das Direktversandprogramm festlegt.
- Bis wann muss ich das Versandetikett anfordern?
Fordern Sie Ihre Versandetiketten nur an dem Tag an, an dem die Bestellungen versendet werden.
getShippingLabel
erforderlich
getShippingLabel
erforderlichUm ein Versandetikett anzufordern, rufen Sie den Vorgang getShippingLabel
auf und übergeben Sie den folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
purchaseOrderNumber | Die Bestellnummer, für die Sie das Versandetikett zurücksenden möchten. Es sollte die gleiche purchaseOrderNumber sein, wie die, die in der Bestellung angegeben ist. | Ja |
Beispiel anfordern
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/2JK3S9VC
getShippingLabel
erforderlich
getShippingLabel
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
purchaseOrderNumber | Die Bestellnummer für diese Bestellung. Typ: Zeichenfolge | Ja |
sellingParty | Die Kennung des Verkäufers oder Verkäufers. Typ: PartyIdentification | Ja |
shipFromParty | Der Lagercode des Lieferanten. Typ: PartyIdentification | Ja |
labelFormat | Das Format des Labels. Aufzählung ( LabelFormat ) | Ja |
labelData | Enthält die Details der Pakete in dieser Sendung. Typ: < LabelData > Reihe | Ja |
Beispiel für eine Antwort
{
"purchaseOrderNumber": "2JK3S9VC",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"labelFormat": "PNG",
"labelData": [
{
"packageIdentifier": "PKG001",
"trackingNumber": "1Z6A34Y60369738804",
"shipMethod": "UPS_GR_RES",
"shipMethodName": "UPS Ground Residential",
"content": "Base 64 encoded string goes here"
}
]
}
Versandetiketten erstellen
Das createShippingLabels
Operation erstellt Versandetiketten für eine Bestellung und gibt die Beschriftungen zurück. Dies ist ein synchroner Vorgang und erfordert keinen Aufruf von API für DF-Transaktionen des Anbieters.
Hinweis
Dies ist ein eingeschränkter Vorgang und erfordert daher ein Restricted Data Token (RDT) für die Autorisierung. Weitere Informationen finden Sie im Leitfaden zu Token-API-Anwendungsfällen.
Das folgende Diagramm zeigt den Arbeitsablauf für die Erstellung von Versandetiketten mithilfe der createShippingLabels
Betrieb.
Geschäftsanforderungen
Sie können Versandetiketten für eine Bestellung pro Anfrage zurücksenden. Mehrere Bestellungen in einer einzigen Anfrage werden nicht unterstützt.
createShippingLabels
erforderlich
createShippingLabels
erforderlichUm Versandetiketten synchron zu erstellen, rufen Sie den createShippingLabels
operieren und den folgenden Pfadparameter übergeben:
Name | Beschreibung | Erforderlich |
---|---|---|
purchaseOrderNumber | Die Bestellnummer für die gewünschten Versandetiketten. Typ: Zeichenfolge | Ja |
Sie können die folgenden Körperparameter einbeziehen:
Name | Beschreibung | Erforderlich |
---|---|---|
sellingParty | Die ID des Verkäufers oder Verkäufers. Typ: PartyIdentification | Ja |
shipFromParty | Lagercode des Lieferanten. Typ: PartyIdentification | Ja |
containers | Eine Liste der Pakete in dieser Lieferung. Typ: < Container > Reihe | Nein |
Beispiel anfordern
POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/
shipping/2021-12-28/shippingLabels/XhvBghry
{
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
}
}
createShippingLabels
erforderlich
createShippingLabels
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
purchaseOrderNumber | Die Bestellnummer für diese Bestellung. Typ: Zeichenfolge | Ja |
sellingParty | Die Kennung des Verkäufers oder Verkäufers. Typ: PartyIdentification | Ja |
shipFromParty | Der Lagercode des Lieferanten. Typ: PartyIdentification | Ja |
labelFormat | Das Format des Labels. Aufzählung ( LabelFormat ) | Ja |
labelData | Enthält die Details der Pakete in dieser Sendung. Typ: < LabelData > Reihe | Ja |
Beispiel für eine Antwort
{
"purchaseOrderNumber": "XhvBghry",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"labelFormat": "PNG",
"labelData": [
{
"packageIdentifier": "1",
"trackingNumber": "1Z69664F0310685739",
"shipMethod": "UPS_GR_RES_SIG",
"shipMethodName": "UPS Ground Residential",
"content": "Base 64 encoded string goes here"
}
]
}
Beispiel für eine Antwort (Fehler)
{
"errors": [
{
"code": "InvalidInput",
"message": "[MISMATCHED_ITEM]: Request Rejected: Order quantity does not match the shipped quantity. All items in the order must be provided. Ensure you add the correct quantity of shipped items to packages. For items - ${fnSku}, the expected quantity is ${expectedQuantity}, but the provided quantity is ${providedQuantity}.",
"details": ""
}
]
}
Liste möglicher Fehlerantwortdetails
Die folgende Tabelle enthält eine Liste aller möglichen Fehlerantwortdetails. Enthalten sind alle empfohlenen Schritte zur Behebung des Fehlers, bevor Sie die Anfrage erneut versuchen. Sie sollten in Ihrer Anwendung einen Mechanismus zur Fehlerbehandlung entwickeln, um diese potenziellen Fehler zu antizipieren und zu behandeln.
Es ist möglich, dass im Laufe der Zeit weitere Fehlerantworten hinzugefügt werden. Daher sollte Ihre Anwendung auch darauf vorbereitet sein, Fehler, die nicht in dieser Liste enthalten sind, ordnungsgemäß zu behandeln.
Werte in Klammern, denen ein vorangestellt ist \$
die in der Nachrichtenspalte erscheinen (zum Beispiel \${fnSku}
) werden in der Fehlerantwort durch tatsächliche Werte ersetzt.
Kode | Nachricht | Details |
---|---|---|
InvalidInput | [MISMATCHED_ITEM]: Anfrage abgelehnt: Die Bestellmenge entspricht nicht der gesendeten Menge. Alle Artikel in der Bestellung müssen bereitgestellt werden. Stellen Sie sicher, dass Sie den Paketen die richtige Menge der versendeten Artikel hinzufügen. Für Artikel - ${fnSku}, die erwartete Menge ist ${expectedQuantity}, aber die angegebene Menge ist ${providedQuantity}. | Keine |
InvalidInput | [NO_ITEMS_PRESENT]: Anfrage abgelehnt: Bestellnummer ${shipmentId} hat Artikel, die keinem Paket (en) zugewiesen sind. Bitte stellen Sie sicher, dass alle Artikel dem/den Paket (en) zugeordnet sind. | Keine |
InvalidInput | [PACKAGE_DIMENSION_NOT_VALID]: Anfrage abgelehnt: Bestellnummer ${shipmentId} hat eine ungültige Dimension für das/die Paket (e). Bitte geben Sie gültige Abmessungen für Ihr (e) Paket (e) an. | Keine |
InvalidInput | [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. | Keine |
InvalidInput | [PIECE_NUMBER_ONE_NOT_PROVISED]: Die Container-Sequenznummer '1' ist nicht für mindestens einen Artikel angegeben. Prüfen Sie, ob die Sequenznummer des Containers fehlt | Keine |
InvalidInput | [INCONSISTENT_PIECE_NUMBER_QUANTITY]: Die Container-Sequenznummer von mindestens einem Artikel ist entweder nicht konsistent oder nicht mit der Artikelmenge kompatibel. Stellen Sie sicher, dass die Sequenznummer des Containers korrekt ist und die Menge jedes Artikels mit der Artikelsequenznummer übereinstimmt | Keine |
InvalidInput | [INVALID_VENDOR_CODE]: Ungültiger Lieferantencode ${vendorCode}. Stellen Sie sicher, dass der Händlercode für die Bestellung korrekt ist | Keine |
InvalidInput | [INVALID_ORDER_ID_WAREHOUSE_COMBINATION]: Versandetikett abgelehnt: Bestellnummer ${shipmentId} gehört nicht zum Warehouse ${warehouseCode}. Bitte überprüfen Sie, ob der Lagercode und die Bestellnummer korrekt sind | Keine |
InvalidInput | [INCORRECT_VENDOR_GROUP_ID]: Ungültige Lieferantengruppen-ID ${vendorGroupId}. Stellen Sie sicher, dass die Lieferantengruppen-ID für die Bestellung korrekt ist | Keine |
InvalidInput | [DUPLICATE_VENDOR_PACKAGE_ID]: Doppelte Herstellerpaket-IDs. Bitte korrigieren Sie die doppelten Container-Identifikatoren und versuchen Sie es erneut | Keine |
InvalidInput | [EMPTY_VENDOR_PACKAGE_ID]: Ungültige VendorPackageIds. Bitte korrigieren Sie die ungültigen Container-Identifikatoren und versuchen Sie es erneut | Keine |
InvalidInput | [SCHIFFSMETHODE_NICHT_UNTERSTÜTZT]: ${ship_method} wird nicht unterstützt. Verwenden Sie Ihr vorhandenes Setup, um das Label für $ zu generieren{ship_method} | Keine |
InvalidInput | [SHIP_METHOD_CHANGED]: Die Versandmethode für diese Bestellung hat sich von $ geändert{old_ship_method} zu ${ship_method}. Verwenden Sie Ihr vorhandenes Setup, um das Label für $ zu generieren{ship_method} | Keine |
InvalidInput | [INCONSISTENT_SHIP_METHODS]: Anfrage abgelehnt: Verschiedene Versandarten werden verschiedenen Paketen zugewiesen. Versuchen Sie, alle Artikel in einem einzigen Karton zu versenden. Wenn das nicht möglich ist, kontaktieren Sie uns bitte. | Keine |
ConflictError | [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. | Keine |
ConflictError | [ORDER_SHIPPED_WITH_VENDOR_LABEL]: Sie haben die Bestellung bereits mit einem anderen Transporteur als Amazon Transportation versendet, daher können Sie das Etikett für diese Bestellung nicht drucken. Es sind keine Maßnahmen erforderlich. Sie haben die versendete Bestellung bereits bestätigt. | Keine |
InternalFailure | Es ist ein interner Fehler aufgetreten. Bitte versuchen Sie es erneut. | Keine |
Versandbestätigungen übermitteln
Mit dem Vorgang submitShipmentConfirmations
können Anbieter Versandbestätigungen an Amazon senden. Ihre Versandbestätigung ermöglicht uns, Ihre Sendungen effizient zu verfolgen und unsere Kunden zu informieren. Sie enthält Informationen über die Artikel im Versand, einschließlich Bestellnummer, Versanddatum, voraussichtlichem Lieferdatum und Sendungsverfolgungsnummer.
Versandbestätigungen ermöglichen uns, effektiver mit Spediteuren zusammenzuarbeiten, um Ihre Sendungen zu verfolgen.
Das Fehlen gültiger Versandbestätigungen kann Folgendes verursachen:
-
Unzureichende Transparenz der Sendungen.
-
Fehler beim Abgleich der physischen Lieferungen mit Bestellungen.
-
Manuelle Follow-ups zur Behebung von Unstimmigkeiten.
Überprüfung der erfolgreich eingereichten Versandbestätigungen
Anbieter können den Status ihrer Versandbestätigungen überprüfen über Vendor Central > Bestellungen > Bestellungen mit direkter Erfüllung oder mit dem API für DF-Transaktionen des Anbieters. Lassen Sie das System nach dem Absenden bis zu 10 Minuten Zeit, um den Status zu ermitteln. Wenn Vendor Central nicht die richtigen Werte für die Versandbestätigung anzeigt, öffnen Sie eine Kontaktiere uns Fall in Vendor Central. Informationen zum Erstellen von Versandbestätigungen finden Sie im Abschnitt Geschäftsanforderungen.
Das folgende Diagramm zeigt den Integrations-Workflow für das Einreichen von Versandbestätigungen:
Geschäftsanforderungen
-
Verwenden Sie diese API, um den Versand einer Bestellung innerhalb von vier Stunden nach Versand der Bestellung aus Ihrem Lager zu bestätigen.
-
Setzen Sie bei Sendungen mit "Floor Denial" den Feldwert
shipmentStatus
aufFLOOR_DENIAL
. -
Alle Einzelposten der Bestellung sollten in der Versandbestätigung enthalten sein. Eine teilweise Versandabwicklung ist nicht zulässig. Anbieter sollten die Bestellung als "Floor Denial" ablehnen, wenn einer der Einzelposten nicht zum Versand zur Verfügung steht.
-
Die
itemSequenceNumber
für einen Artikel sollte die gleiche sein, die in der Bestellnachricht eingegangen ist. -
In der Versandbestätigung muss entweder
buyerProductIdentifier
odervendorProductIdentifier
gesendet werden . Sie müssen den gleichen Wert senden, den Sie in der Bestellung erhalten haben. -
Für VOCs senden
scacCode
ist verpflichtend. -
Wenn das Versandetikett von Amazon bereitgestellt wird, ist der Containerbereich optional, da Amazon Zugriff auf die Paketinformationen hat. Der Abschnitt "Artikel" muss eingereicht werden.
-
Für den Container in einer Versandbestätigung muss eine Versandmethode angegeben sein.
submitShipmentConfirmations
erforderlich
submitShipmentConfirmations
erforderlichUm Versandbestätigungen einzureichen, rufen Sie den Vorgang submitShipmentConfirmations
auf und übergeben Sie den folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
shipmentConfirmations | Liste der bestätigten Lieferungen. Typ: < ShipmentConfirmation > Reihe | Ja |
Beispiel anfordern
POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shipmentConfirmations
{
"shipmentConfirmations": [
{
"purchaseOrderNumber": "PO00050003",
"shipmentDetails": {
"shippedDate": "2019-08-07T19:56:45.632Z",
"shipmentStatus": "SHIPPED",
"isPriorityShipment": true,
"estimatedDeliveryDate": "2019-08-07T19:56:45.632Z"
},
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"partyId": "VENDORWAREHOUSECODE"
},
"items": [
{
"itemSequenceNumber": 1,
"buyerProductIdentifier": "ASIN001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
},
{
"itemSequenceNumber": 2,
"buyerProductIdentifier": "ASIN002",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
},
{
"itemSequenceNumber": 3,
"buyerProductIdentifier": "ASIN003",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
},
{
"itemSequenceNumber": 4,
"buyerProductIdentifier": "ASIN004",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
],
"containers": [
{
"containerType": "carton",
"containerIdentifier": "123",
"trackingNumber": "TRACK001",
"scacCode": "SCAC001",
"carrier": "ABCD001",
"shipMethod": "UPS",
"dimensions": {
"length": "10",
"width": "10",
"height": "10",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 1,
"buyerProductIdentifier": "ASIN001",
"packedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
]
},
{
"containerType": "carton",
"containerIdentifier": "234",
"trackingNumber": "TRACK002",
"scacCode": "SCAC001",
"carrier": "ABCD001",
"shipMethod": "UPS",
"dimensions": {
"length": "10",
"width": "10",
"height": "10",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 2,
"buyerProductIdentifier": "ASIN002",
"packedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
]
},
{
"containerType": "carton",
"containerIdentifier": "ABCD",
"trackingNumber": "TRACK003",
"scacCode": "SCAC001",
"carrier": "ABCD001",
"shipMethod": "UPS",
"dimensions": {
"length": "10",
"width": "10",
"height": "10",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 3,
"buyerProductIdentifier": "ASIN003",
"packedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
]
},
{
"containerType": "carton",
"containerIdentifier": "id12",
"trackingNumber": "TRACK004",
"scacCode": "SCAC001",
"carrier": "ABCD001",
"shipMethod": "UPS",
"dimensions": {
"length": "10",
"width": "10",
"height": "10",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 4,
"buyerProductIdentifier": "ASIN004",
"packedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
]
}
]
}
]
}
submitShipmentConfirmations
erforderlich
submitShipmentConfirmations
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
transactionId | GUID zur Identifizierung dieser Transaktion. Dieser Wert kann mit dem verwendet werden API für DF-Transaktionen des Anbieters um den Status dieser Transaktion zurückzugeben. Typ: Zeichenfolge | Ja |
Beispiel für eine Antwort
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Aktualisierungen des Versandstatus übermitteln
Vorsicht
Nur Anbieter eigener Transporteure (VOC) können Sendungsstatus-Updates verwenden. Dies bedeutet, dass Anbieter für den Transport von Sendungen an Kunden ihren eigenen Transporteur und nicht Amazon-Transporteure verwenden. VOC-Anbieter tragen letztendlich die Transportkosten und die Verantwortung für die Lieferung von Sendungen an Kunden.
Der Vorgang submitShipmentStatusUpdates
ermöglicht Anbietern, den Transportstatus für Sendungen zu aktualisieren, die sich auf dem Weg zum Endkunden befinden. VOC-Anbieter sind verpflichtet, den Versandstatus (allgemein bekannt als Scans) während der Transportphase zu aktualisieren.
Diese Informationen werden dann auf der Seite mit ihren Bestellungen an Amazon-Kunden weitergeleitet, wodurch die Transparenz des Bestellverfolgungs- und Lieferprozesses verbessert wird.
Wenn der Versandstatus nicht aktualisiert wird, kann dies zu schlechten operativen KPIs, wie z. B. einer niedrigen Scanrate, und schließlich zur Blockierung des Lagers führen.
Überprüfung der erfolgreich eingereichten Versandstatusaktualisierungen
Anbieter können den Status ihrer Sendungsstatusaktualisierungen in überprüfen Vendor Central > Bestellungen > Bestellungen mit direkter Erfüllung oder mit dem API für DF-Transaktionen des Anbieters. Lassen Sie das System nach der Einreichung bis zu 10 Minuten Zeit, um den Status zu ermitteln. Wenn Vendor Central nicht die richtigen Werte für die Versandbestätigung anzeigt, öffnen Sie eine Kontaktiere uns Fall in Vendor Central. Informationen zum Erstellen von Versandbestätigungen finden Sie im Abschnitt Geschäftsanforderungen.
Das folgende Diagramm zeigt den Integrations-Workflow für das Einreichen von Versandstatusaktualisierungen:
Geschäftsanforderungen
-
Verwenden Sie diese API nur, wenn Sie Ihren eigenen Spediteur verwenden (Sie sind ein VOC-Anbieter), um die Sendung zum Kunden zu transportieren.
-
Verwenden Sie diese API, um den Status einer Sendung zu aktualisieren, nachdem die Sendung bestätigt wurde (über die API oder Vendor Central).
-
Das
trackingNumber
im Versandstatus muss die API mit dem übereinstimmentrackingNumber
in der Versandbestätigung angegeben. Wenn sie nicht übereinstimmt, schlägt die Aktualisierung des Versandstatus fehl. -
Eins
submitShipmentStatusUpdates
Der Anruf sollte einem physischen Paket entsprechen. Sie können den Versandstatus mehrerer Pakete in einem API-Aufruf aktualisieren, indem Sie sie als Reihe von Sendungsstatusaktualisierungen stapeln. -
Eine Bestellung mit Direktversand kann dazu führen, dass mehrere physische Pakete an den Kunden geliefert werden. Daher sind mehrere Aktualisierungen des Versandstatus erforderlich, um den vollständigen Versandstatus der gesamten Bestellung wiederzugeben.
-
Anbieter sollten den Versandstatus nach Möglichkeit gemäß den Richtlinien für den Versandstatus von Amazon senden.
-
Für Bestellungen mit planmäßiger Lieferung sollten Anbieter das Array
shipmentSchedule
senden, das die geschätzte Lieferzeit und das Lieferfenster angibt.
Zusätzliche Felder
statusCode
und reasonCode
sind Standardcodes, die in EDI-Standards (z. B. ISA X12 und EDIFACT) verwendet werden, um ein bestimmtes Statusereignis und den Grund für das Statusereignis anzugeben. Wir erwarten eine bestimmte Kombination von statusCode
und reasonCode
die ein Ereignis innerhalb der Versandphase zum Endkunden bestimmen.
Dies sind die Status- und Ursachencodes, die wir unterstützen, und ihre Entsprechung zur aktuellen Version von Vendor Central:
EDIFACT-Statuscode | EDIFACT-Ursachencode | Operative Beschreibung | Vendor Central UI equivalency |
---|---|---|---|
404 | 117 | Der Versand verzögert sich aufgrund eines großen Unfalls | DELAYED |
301 | 000 | Sendung an Kunden geliefert | DELIVERED |
101 | 000 | Die Sendung hat das Versandzentrum verlassen | DEPARTED_FROM_FC |
201 | 000 | Die Sendung kam bei einer Speditionseinrichtung an | IN_TRANSIT |
409 | 000 | Der Spediteur hat die Sendung verloren | LOST |
302 | 000 | Die Sendung wird ausgeliefert | OUT_FOR_DELIVERY |
407 | 000 | Der Empfänger hat die Annahme der Sendung verweigert | REJECTED |
416 | 000 | Die Sendung ist nicht zustellbar und wird vernichtet | UNDELIVERABLE |
X12-Statuscode | X12-Ursachencode | Operative Beschreibung | Vendor Central UI equivalency |
---|---|---|---|
DE | AF | Der Versand verzögert sich aufgrund eines großen Unfalls | DELAYED |
D1 | NS | Sendung an Kunden geliefert | DELIVERED |
XB | NS | Die Sendung hat das Versandzentrum verlassen | DEPARTED_FROM_FC |
O1 | NS | Die Sendung kam bei einer Speditionseinrichtung an | IN_TRANSIT |
CA | PL | Der Spediteur hat die Sendung verloren | LOST |
OD | NS | Die Sendung wird ausgeliefert | OUT_FOR_DELIVERY |
A7 | AM | Der Empfänger hat die Annahme der Sendung verweigert | REJECTED |
AP | BG | Die Sendung ist nicht zustellbar und wird vernichtet | UNDELIVERABLE |
submitShipmentStatusUpdates
erforderlich
submitShipmentStatusUpdates
erforderlichUm Aktualisierungen des Versandstatus einzureichen, rufen Sie den Vorgang submitShipmentStatusUpdates
auf und übergeben Sie den folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
shipmentStatusUpdates | Liste der bestätigten Lieferungen. Typ: < ShipmentStatusUpdate > Reihe | Ja |
Beispiel anfordern
POST https://sellingpartnerapi-na.amazon.com/ /vendor/directFulfillment/shipping/2021-12-28/shipmentStatusUpdates
{
"shipmentStatusUpdates": [
{
"purchaseOrderNumber": "DX00050015",
"sellingParty":
{
"partyId": "999US"
},
"shipFromParty":
{
"partyId": "ABCD"
},
"statusUpdateDetails":
{
"trackingNumber": "TRACK005",
"statusDateTime": "2020-08-07T19:56:45Z",
"statusCode": "D1",
"reasonCode": "NS",
"statusLocationAddress":
{
"name": "ABC",
"addressLine1": "1st street",
"city": "Seattle",
"countryCode": "US",
"postalCode": "124",
"stateOrRegion": "CA"
}
}
}
]
}
submitShipmentStatusUpdates
erforderlich
submitShipmentStatusUpdates
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
transactionId | GUID zur Identifizierung dieser Transaktion. Dieser Wert kann mit dem verwendet werden API für DF-Transaktionen des Anbieters um den Status dieser Transaktion zurückzugeben. Typ: Zeichenfolge | Ja |
Beispiel für eine Antwort
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Holen Sie sich Packzettel
Der Vorgang getPackingSlips
gibt eine Liste der Packzettel für die Bestellungen zurück, die die angegebenen Kriterien erfüllen. Wenn Sie einen Packzettel für eine bestimmte Bestellung benötigen, verwenden Sie stattdessen den Vorgang getPackingSlip
.
Hinweis
Dies ist ein eingeschränkter Vorgang und erfordert daher ein Restricted Data Token (RDT) für die Autorisierung. Weitere Informationen finden Sie im Leitfaden zu Token-API-Anwendungsfällen.
Sie sollten diese API verwenden, um Packzettel für die Bestellungen zu erhalten, die Ihnen zur Erfüllung zur Verfügung stehen. Amazon empfiehlt Anbietern, während der Geschäftszeiten mindestens einmal pro Stunde nach Bestellungen zu suchen. Abhängig von Ihrem Geschäftsvolumen können Sie wählen, ob Sie häufiger nachschauen möchten. In einem API-Aufruf können Sie bis zu 100 Packzettel abrufen. Wenn es mehr als 100 Packzettel gibt, können Sie den verwenden nextToken
Wert als Parameter in Ihrer nächsten Anfrage, um den nächsten Satz von Packzetteln zu erhalten.
Das folgende Diagramm zeigt den Integrations-Workflow beim Abrufen von Packzetteln:
getPackingSlips
erforderlich
getPackingSlips
erforderlichUm Packzettel abzurufen, rufen Sie den Vorgang getPackingSlips
auf und übergeben Sie die folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
shipFromPartyId | Der Verkäufer warehouseId von dem aus die Bestellung ausgeführt wird. Wenn nicht angegeben, enthält das Ergebnis Bestellungen für alle Lager.Typ: Zeichenfolge | Nein |
limit | Das Limit für die Anzahl der zurückgegebenen Datensätze. Typ: Integer | Nein |
createdAfter | Packzettel, die nach diesem Datum und dieser Uhrzeit verfügbar wurden, werden in das Ergebnis aufgenommen. Muss drin sein ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) | Ja |
createdBefore | Packzettel, die vor diesem Datum und dieser Uhrzeit verfügbar waren, werden in das Ergebnis aufgenommen. Muss drin sein ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) | Ja |
sortOrder | Aufsteigend sortieren (ASC ) oder absteigend (DESC ) nach dem Erstellungsdatum des Packzettels.Typ: enum ( SortOrder ) | Nein |
nextToken | Wird für die Paginierung verwendet, wenn mehr Bestellungen als die angegebene Größenbeschränkung für Ergebnisse vorliegen. Der Token-Wert wird im vorherigen API-Aufruf zurückgegeben. Typ: Zeichenfolge | Nein |
Beispiel anfordern
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/packingSlips?createdBefore=2020-06-12T12:00:00-08:00&createdAfter=2020-06-12T00:00:00-08:00&limit=2&sortOrder=DESC
getPackingSlips
erforderlich
getPackingSlips
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
pagination | Wenn mehr als 100 Bestellungen zurückgegeben werden, wird nextToken in der Antwort für die Paginierung zurückgegeben. | Nein |
packingSlips | Enthält Details für die Packzettel. Typ: < PackingSlip > Reihe | Nein |
Beispiel für eine Antwort
{
"pagination": {
"nextToken": "NEBxNEBxNEBxNR=="
},
"packingSlips": [
{
"purchaseOrderNumber": "UvgABdBjQ",
"content": "base64 encoded string",
"contentType": "application/pdf"
},
{
"purchaseOrderNumber": "VvgCDdBjR",
"content": "base64 encoded string",
"contentType": "application/pdf"
}
]
}
Holen Sie sich einen Packzettel
Das getPackingSlip
operation gibt den Packzettel für die von Ihnen angegebene Bestellnummer zurück. Die Antwort enthält eine Base64-kodierte Zeichenfolge des Packzettels. Der Inhaltstyp wird immer „Anwendung/PDF“ sein.
Hinweis
Dies ist ein eingeschränkter Vorgang und erfordert daher ein Restricted Data Token (RDT) für die Autorisierung. Weitere Informationen finden Sie im Leitfaden zu Token-API-Anwendungsfällen.
Das folgende Diagramm zeigt den Integrations-Workflow beim Abrufen eines Packzettels:
Geschäftsanforderungen
- Sind Packzettel für alle Bestellungen erforderlich?
Ein Packzettel ist nur erforderlich, wenn es sich um eine Business-to-Business (B2B) -Bestellung oder eine Geschenkbestellung handelt. Wenn der Wert des isPslipRequired
Das Feld ist wahr, für die Bestellung ist ein Packzettel erforderlich.
getPackingSlip
erforderlich
getPackingSlip
erforderlichUm einen Packzettel zurückzugeben, rufen Sie den VorganggetPackingSlip
auf und übergeben Sie den folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
purchaseOrderNumber | Das purchaseOrderNumber für den Packzettel, den du willst.Typ: Zeichenfolge | Ja |
Beispiel anfordern
GET https://sellingpartnerapi-na.amazon.com /vendor/directFulfillment/shipping/2021-12-28/packingSlips/UkP3YkKDr
getPackingSlip
erforderlich
getPackingSlip
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
purchaseOrderNumber | Bestellnummer der Lieferung. Typ: Zeichenfolge | Ja |
content | Eine Base64-kodierte Zeichenfolge des Packzettel-PDFs. Typ: Zeichenfolge | Ja |
contentType | Das Format der Datei (z. B. PDF, JPEG). Typ: enum ( ContentType ) | Nein |
Beispiel für eine Antwort
{
"purchaseOrderNumber": "UvgABdBjQ",
"content": "base64 encoded string",
"contentType": "application/pdf"
}
Kundenrechnungen abrufen (nur Indien)
Das getCustomerInvoices
operation gibt Kundenrechnungen für alle Bestellungen zurück, die die von Ihnen angegebenen Filterkriterien erfüllen.
Wichtig
Das
getCustomerInvoices
Der Betrieb ist auf dem indischen Markt obligatorisch. Es ist für keine andere Marketplace-Site verfügbar.
Amazon empfiehlt Anbietern, während der Geschäftszeiten mindestens einmal pro Stunde nach Kundenrechnungen zu suchen. Abhängig von Ihrem Geschäftsvolumen können Sie wählen, ob Sie häufiger nachschauen möchten. Sie können bis zu 100 Kundenrechnungen in einem API-Aufruf erhalten. Wenn es mehr als 100 Kundenrechnungen gibt, können Sie die verwenden nextToken
Wert als Parameter in der nächsten Anfrage, um den nächsten Satz von Kundenrechnungen abzurufen.
Hinweis
Dies ist ein eingeschränkter Vorgang und erfordert daher ein Restricted Data Token (RDT) für die Autorisierung. Weitere Informationen finden Sie im Leitfaden zu Token-API-Anwendungsfällen.
Das folgende Diagramm zeigt den Integrations-Workflow beim Abrufen von Kundenrechnungen:
getCustomerInvoices
erforderlich
getCustomerInvoices
erforderlichUm Kundenrechnungen zurückzugeben, rufen Sie den Vorgang getCustomerInvoices
auf und übergeben Sie die folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
shipFromPartyId | Der Verkäufer warehouseId von dem aus die Bestellung ausgeführt wird. Wenn nicht angegeben, enthält das Ergebnis Bestellungen für alle Lager.Typ: Zeichenfolge | Nein |
limit | Das Limit für die Anzahl der zurückgegebenen Datensätze. Typ: Integer | Nein |
createdAfter | Bestellungen, die nach diesem Datum und dieser Uhrzeit verfügbar wurden, werden in das Ergebnis aufgenommen. Muss drin sein ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) | Ja |
createdBefore | Bestellungen, die vor diesem Datum und dieser Uhrzeit verfügbar wurden, werden in das Ergebnis aufgenommen. Muss drin sein ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) | Ja |
sortOrder | Aufsteigend sortieren (ASC ) oder absteigend (DESC ) nach dem Erstellungsdatum der Bestellung.Typ: enum ( SortOrder ) | Nein |
nextToken | Wird für die Seitennummerierung verwendet, wenn mehr Versandetiketten als die angegebene Größenbeschränkung für das Ergebnis vorhanden sind. Der Token-Wert wird im vorherigen API-Aufruf zurückgegeben. Typ: Zeichenfolge | Nein |
Beispiel anfordern
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/customerInvoices?limit=2&createdAfter=2020-02-15T14:00:00-08:00&createdBefore=2020-02-20T00:00:00-08:00&sortOrder=DESC
getCustomerInvoices
erforderlich
getCustomerInvoices
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
pagination | Wenn mehr als 100 Kundenrechnungen zurückgegeben werden, nextToken wird in der Antwort für die Paginierung zurückgegeben.Typ: Paginierung | Nein |
customerInvoices | Liste der Kundenrechnungen. Typ: < CustomerInvoice > Reihe | Nein |
Beispiel für eine Antwort
{
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"customerInvoices": [
{
"purchaseOrderNumber": "PO98676856",
"content": "base 64 content goes here"
}
]
}
Holen Sie sich eine Kundenrechnung (nur Indien)
Der Vorgang getCustomerInvoice
gibt Informationen über die Kundenrechnung zurück, die Sie anhand der Bestellnummer angeben. Die Antwort enthält vollständige Kundenrechnungsinformationen für diese Bestellung.
Hinweis
Dies ist ein eingeschränkter Vorgang und erfordert daher ein Restricted Data Token (RDT) für die Autorisierung. Weitere Informationen finden Sie im Leitfaden zu Token-API-Anwendungsfällen.
Sie können diese API auch verwenden, um Details für jede Kundenrechnung abzurufen (im Zeitraum von 7 Tagen ab einem fortlaufenden Zeitfenster der letzten 6 Monate, nachdem der Anbieter in der API aktiviert wurde).
Das folgende Diagramm zeigt den Integrations-Workflow für das Abrufen einer Kundenrechnung:
Geschäftsanforderungen
Welche Kundenrechnungen stehen zum Herunterladen zur Verfügung?
Die Kundenrechnung ist eine PDF-Datei, die im binary64-Zeichenfolgenformat codiert ist. Für alle Bestellungen in der Region IN sollte eine Kundenrechnung erstellt werden, die zusammen mit der Sendung gesendet werden muss.
getCustomerInvoice
erforderlich
getCustomerInvoice
erforderlichUm eine Kundenrechnung zurückzugeben, rufen Sie den Vorgang getCustomerInvoice
auf und übergeben Sie den folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
purchaseOrderNumber | Bestellnummer der Sendung, für die die Rechnung zurückgesendet werden soll. Typ: Zeichenfolge | Ja |
Beispiel anfordern
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/2JK3S9VC
getCustomerInvoice
erforderlich
getCustomerInvoice
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
purchaseOrderNumber | Die Bestellnummer für diese Bestellung. Typ: Zeichenfolge | Ja |
content | Die Base64-kodierte Kundenrechnung. Typ: Zeichenfolge | Ja |
Beispiel für eine Antwort
{
"purchaseOrderNumber": "PO98676856",
"content": "base 64 encoded string"
}
Erstellen Sie ein Containeretikett
Benutze das createContainerLabel
Vorgang, um für jede palettierte Ladung ein Palettenetikett von Amazon anzufordern und zu erhalten. Die Antwort umfasst ein druckbares 4X6-Palettenetikett, das den Etikettentyp und die Paletten-ID enthält.
Geschäftsanforderungen
Das createContainerLabel
Die Operation unterstützt nicht mehrere Palettenetikettenanfragen in einem API-Aufruf. Wenn Sie Palettenetiketten für mehrere Paletten abrufen möchten, müssen Sie mehrere senden createContainerLabel
Anfragen parallel.
createContainerLabel
erforderlich
createContainerLabel
erforderlichUm ein Versandetikett anzufordern, rufen Sie den Vorgang createContainerLabel
auf und übergeben Sie den folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
sellingParty | Die ID des Verkäufers oder Verkäufers. Geben Sie ein: PartyIdentification | Ja |
shipFromParty | Der Lagercode des Lieferanten. Typ: PartyIdentification | Ja |
vendorContainerId | Die eindeutige Kennung des Anbieters für den Container. Typ: VendorContainerId | Ja |
carrierId | Der Träger des Behälteretiketts (Paletten). Typ: CarrierId | Ja |
packages | Ein Array von Paketobjekten, das Versandpakete einem Container zuordnet. Typ: Packages | Ja |
Beispiel anfordern
POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/containerLabel
{
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"vendorContainerId": "000011189212211212",
"carrierId": "SWA",
"packages": [
{
"packageTrackingNumber": "TBA134335066000"
},
{
"packageTrackingNumber": "TBA214335089000"
},
{
"packageTrackingNumber": "TBA311235066000"
}
]
}
createContainerLabel
erforderlich
createContainerLabel
erforderlichEine erfolgreiche Antwort umfasst Folgendes:
Name | Beschreibung | Erforderlich |
---|---|---|
containerTrackingNumber | Die Tracking-ID des Containers (Paletten) des Spediteurs. Typ: Zeichenfolge | Ja |
content | Der Inhalt der Containerbeschriftung ist in eine Base64-Zeichenfolge codiert. Typ: Zeichenfolge | Ja |
format | Das Format des Containeretiketts. Typ: ContainerLabelFormat | Ja |
Beispiel für eine Antwort
{
"containerLabel": {
"containerTrackingNumber": "TBA134335066000",
"content": "Base64 encoded string",
"format": "PNG"
}
}
Updated 12 days ago