APIs für die Beschaffung im Einzelhandel durch Anbieter v1: Leitfaden für Anwendungsfälle
Hier erfahren Sie, wie Sie Anbietern helfen können, ihre Einzelhandelsgeschäfte programmgesteuert durch Webservice-Integration zu verwalten.
Die Verkaufspartner-APIs für Einzelhandelsanbieter helfen Anbietern dabei, ihre Geschäftsabläufe im Einzelhandel programmgesteuert durch Webservice-Integration zu verwalten. Die automatisierte Integration mit Amazon kann Anbietern helfen, ihre Leistung zu verbessern und aufrechtzuerhalten und ihr Geschäft mit Amazon auszubauen.
Anbieter im Direktversandprogramm sollten im Anwendungsfallleitfaden für APIs v1 für den direkten Versand durch Anbieter nachschlagen, um mehr über APIs zu erfahren, die speziell für den direkten Versand bestimmt sind.
Anbieter können diese APIs verwenden, um Anwendungen zu erstellen, um die betriebliche Effizienz zu steigern, Aufwand und Fehler zu reduzieren und die Leistung zu verbessern.
Informationen zur Authentifizierung und Autorisierung finden Sie unter Autorisierung von API-Anwendungen für Vertriebspartner.
Geschäftsprozesse, die Sie mithilfe der Vendor Retail Procurement APIs erfüllen können
Sie können das verwenden API für Lieferantenbestellungen um Bestellungen zu verwalten, API für Lieferungen durch Lieferanten um Versandbestätigungen zu versenden, API für Lieferantenrechnungen um Rechnungen einzureichen, und API für den Transaktionsstatus des Anbieters um den Status Ihrer Auftragsbestätigungen und Versandbestätigungen zu ermitteln.
Geschäftsprozess | Anwendungsfall | Vorgang |
Verwaltung von Bestellungen | ||
Änderungen oder Stornierungen von Bestellungen erhalten | getPurchaseOrders Gibt eine Liste von Bestellungen zurück, die während des von Ihnen angegebenen Zeitraums erstellt oder geändert wurden. |
|
Überprüfen Sie den Status der Bestellung | getPurchaseOrdersStatus Gibt den Bestellstatus auf der Grundlage der von Ihnen angegebenen Filter zurück. |
|
Bestätigung der Bestellung einreichen | submitAcknowledgement Sendet Bestätigungen für eine oder mehrere Bestellungen ein. |
|
Überprüfen Sie den Transaktionsstatus der Auftragsbestätigung | getTransaction Gibt den Status der Transaktion zurück, die Sie angeben. |
|
Sendungen | ||
Sendet Versandanfragen | SubmitShipments Sendet eine oder mehrere Versandanfragen für Lieferantenbestellungen. |
|
Sendungsstatus oder Sendungs-/Transportetiketten abrufen | GetShipmentDetails Gibt die Versanddetails, Angaben zum Transporteur, den Status der Sendung, die Containerdetails und andere Details zur Lieferung auf der Grundlage des von Ihnen angegebenen Filterparameterwerts zurück. |
|
Versandvorabbenachrichtigungen (ASN) /Versandbestätigungen einreichen oder aktualisieren | SubmitShipmentConfirmations Sendet eine oder mehrere Versandbestätigungen für Lieferantenbestellungen ein. |
|
Überprüfen Sie den Transaktionsstatus der Versandbestätigung | getTransaction Gibt den Status der Transaktion zurück, die Sie angeben. |
|
Versandetiketten erhalten | GetShipmentLabels Gibt kleine Paketversandetiketten auf der Grundlage der von Ihnen angegebenen Filter zurück. |
|
Rechnungen und Gutschriften | ||
Lieferantenrechnungen einreichen | submitInvoices Reichen Sie neue Rechnungen an Amazon ein. |
Was ist die API für Anbieterbestellungen?
Sie können das verwenden API für Lieferantenbestellungen (Orders API), um Bestellungen entgegenzunehmen und Auftragsbestätigungen zu senden, um die Auftragserfüllung anzunehmen oder abzulehnen.
Die API für Lieferantenbestellungen umfasst die folgenden Operationen:
Vorgang | HTTP-Methode | Path | Beschreibung |
---|---|---|---|
getPurchaseOrders |
GET | /vendor/orders/v1/purchaseOrders |
Gibt eine Liste der Bestellungen zurück, die während des von Ihnen angegebenen Zeitraums erstellt oder geändert wurden. Der Datenabruf ist für einen Zeitraum von maximal sechs Monaten ab dem Datum des ursprünglichen POST-Aufrufs möglich. |
getPurchaseOrder |
GET | /vendor/orders/v1/purchaseOrders /{purchaseOrderNumber} |
Gibt eine Bestellung (PO) zurück, die auf dem purchaseOrderNumber Wert, den Sie angeben. Der Datenabruf ist für einen Zeitraum von maximal sechs Monaten ab dem Datum möglich, an dem der ursprüngliche POST-Anruf getätigt wurde. |
submitAcknowledgement |
POST | /vendor/orders/v1/acknowledgements |
Bestätigt (akzeptiert oder lehnt ab) eine oder mehrere Bestellungen. |
getPurchaseOrdersStatus |
GET | /vendor/orders/v1/purchaseOrdersStatus |
Gibt den Status von Bestellungen auf der Grundlage der von Ihnen angegebenen Filter zurück. Der Datenabruf ist für einen Zeitraum von maximal sechs Monaten ab dem Datum des ursprünglichen POST-Aufrufs möglich. |
Sie können das verwenden getPurchaseOrders
Vorgang für den Zugriff auf Bestellungen, die in einem bestimmten Zeitraum erstellt oder geändert wurden (innerhalb eines fortlaufenden Zeitfensters der letzten sechs Monate, nach Juni 2020). Um die Reaktionszeit zu optimieren, empfehlen wir, den Zeitraum auf maximal sieben Tage zu beschränken.
Sie können das verwenden getPurchaseOrder
Vorgang, um detaillierte Bestellinformationen für eine bestimmte Bestellung abzurufen. Sie können dann das verwenden submitAcknowledgement
Vorgang zur Annahme oder Ablehnung der Bestellung.
Nachdem Sie Ihre Bestellungen akzeptiert oder abgelehnt haben, können Sie den getPurchaseOrdersStatus
Vorgang, um den Bestätigungsstatus einer oder mehrerer Bestellungen zurückzugeben.
Hinweis
Sie können die vollständigen Bestelldetails zurückgeben, indem Sie die
getPurchaseOrders
Bedienung, oder geben Sie nur die Bestellnummern zurück mit demincludeDetails
filtern. Der Standardwert für diesen Parameter ist true. Wenn Sie diesen Abfrageparameter also nicht angeben, geben Sie die vollständigen Details der Bestellungen zurück. Wenn Sie verwendenincludeDetails=false
, die Antwort enthält nur eine Liste mit Bestellnummern und den aktuellen Status jeder Bestellung.
Das folgende Diagramm zeigt den Workflow mit der API für Anbieterbestellungen.
getPurchaseOrders
getPurchaseOrders
Das getPurchaseOrders
Operation gibt entweder eine Liste mit Bestellreferenzen (Bestellnummern und Status) oder vollständige Bestelldetails für alle Bestellungen zurück, die die in der Anfrage angegebenen Kriterien erfüllen. Wenn Sie nur Bestellungsreferenzen zurückgeben, können diese später zusammen mit dem getPurchaseOrder
Vorgang zum Abrufen von Bestelldetails für eine bestimmte Bestellung.
Sie sollten diese API verwenden, um Bestellungen abzurufen, die zum Versand bereitstehen. Amazon empfiehlt Anbietern, während der Geschäftszeiten mindestens einmal pro Stunde auf Bestellungen 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 Bestellungen in einem API-Aufruf abrufen. Wenn es mehr als 100 Bestellungen gibt, können Sie nextToken
verwenden, um den nächsten Satz von Bestellungen abzurufen.
Bestelländerungen und Stornierung
Sie können Bestelländerungen und Stornierungen mit dem Vorgang getPurchaseOrders
abrufen.
Bestelländerungen: Manchmal ändert Amazon die Bestelldaten nach der Erstellung der Bestellung aufgrund einer Änderung der Anforderungen. Anbieter können die getPurchaseOrders
-API verwenden, um aktualisierte Bestellungen zu erhalten. Wenn Amazon eine Bestellung ändert, hat die Bestellung das Feld purchaseOrderChangedDate
, das der Zeitstempel ist, an dem Amazon die Bestellung aktualisiert hat. Wenn dieses Feld nicht existiert, wurde die Bestellung nach der Erstellung nie geändert.
Hinweis
Amazon kann die Bestellung auch ändern, nachdem Sie sie bestätigt haben.
Anbieter können eine Liste der Bestellungen abrufen, die innerhalb eines bestimmten Zeitraums geändert wurden, indem sie die Abfrageparameter changedAfter
und changedBefore
verwenden . Dadurch werden die Bestellungen zurückgegeben, die innerhalb des angegebenen Zeitraums von Amazon geändert wurden, und die Anbieter müssen die aktualisierte Bestellung versenden. Alternativ können Anbieter mit isPOChanged=true
filtern, um alle geänderten Bestellungen zu erhalten.
Amazon empfiehlt, mehrmals täglich einen separaten API-Aufruf mit dem geänderten Datumsbereich auszuführen, um die geänderten Bestellungen für einen Tag abzurufen. Beispielsweise können Sie viermal täglich den Vorgang „Bestellungen abrufen“ aufrufen, um Bestellungen abzurufen, die in den letzten sechs Stunden geändert wurden.
Im Folgenden finden Sie eine Liste von Änderungen, die zu Bestelländerungen beitragen können. Für diese Änderungen müssen Sie die geänderte Bestellung abrufen und die richtige Bestellung versenden:
- Änderung des Versand- oder Lieferfensters
- Aktualisierungen von Bestellartikeln wie Mengenänderung, Artikelstornierung, Änderung der Artikelkosten
- Neuer Artikel in Bestellung hinzugefügt
- PO storniert/storniert
- Typ der Bestellung geändert
- PO-Lieferziel (Versandzentrum) ändern
- Frachtinformationen der Bestellung wurden geändert
Stornierung des Artikels: Sie können auch die API für Lieferantenbestellungen mit dem Filter verwenden poItemState=Cancelled
, um Bestellungen mit einem oder mehreren stornierten Artikeln zurückzugeben. Dadurch werden alle Bestellungen zurückgegeben, für die nach der Erstellung der Bestellung ein oder mehrere Artikel von Amazon storniert wurden. Auf diese Weise erhalten Sie nur die Bestellungen, für die Artikel storniert wurden (die bestellte Menge ist Null), und Sie können sicherstellen, dass Sie die stornierten Artikel nicht versenden.
Hinweis
Die Stornierung eines Artikels gilt als Änderung der Bestellung. Daher senden Sie diese Bestellungen auch mit der Liste der geänderten Bestellungen zurück.
Status der Bestellung und Lieferantencode: Das Bestellschema beinhaltet den aktuellen Status der Bestellung und die Uhrzeit der Statusaktualisierung. Sie können den Filter verwenden purchaseOrderState
um Bestellungen basierend auf dem aktuellen Status zu filtern.
So können Anbieter beispielsweise mit purchaseOrderState=New
alle Bestellungen abrufen, die noch nicht bestätigt oder versendet wurden.
Anbieter können auch Bestellungen für einen bestimmten Händlercode erhalten, indem sie einen der autorisierten Händlercodes im Filter orderingVendorCode
angeben. Dieser Filter gibt nur Bestellungen zurück, die für den im Filter angegebenen Händlercode eingegangen sind.
Einzelheiten zu allen verfügbaren Filtern finden Sie in der API-Referenz für Anbieterbestellungen.
Das folgende Diagramm zeigt den Integrations-Workflow beim Abrufen von Bestellungen:
getPurchaseOrder
getPurchaseOrder
Das getPurchaseOrder
Der Vorgang verwendet die Bestellnummer, um Informationen zurückzugeben, die Sie zur Bestellung angegeben haben. Die Antwort enthält vollständige Bestellinformationen, einschließlich Einzelartikeldetails, Menge und Kosten.
Verwenden Sie diesen Vorgang, um die Details bestimmter Bestellungen abzurufen, die von getPurchaseOrders
Betrieb.
Das folgende Diagramm zeigt den Integrationsworkflow beim Abrufen einer bestimmten Bestellung:
Geschäftsanforderungen
-
Bestellung nach Gewicht
Für Bestellungen, die Artikel enthalten, die nach Gewicht verkauft werden,
unitOfMeasure
Feld (unterlistPrice
undnetCost
) gibt die tatsächliche Maßeinheit für das Gewicht wieder. Die Gewichtseinheit der Messwerte beinhaltetPOUNDS
,OUNCES
,GRAMS
, undKILOGRAMS
. -
Nutzung des Versandfensters oder des Lieferfensters
Für vom Verkäufer bezahlte Frachten sollten die Informationen zum Lieferfenster verwendet werden. Datumsangaben werden im Datums- und Zeitintervallformat dargestellt gemäß ISO 8601. Das Format besteht aus Start- und Enddatum, getrennt durch einen doppelten Bindestrich (--). Das Feld für das Startdatum steht für das früheste Datum, an dem Amazon mit der Lieferung der Fracht an das auf der Bestellung angegebene Amazon-Versandzentrum rechnet. Das Enddatumsfeld steht für das späteste Datum, an dem Amazon erwartet, dass die Fracht an das auf der Bestellung angegebene Amazon-Versandzentrum geliefert wird.
Verwenden Sie die Informationen im Schiffsfenster für Frachten, die von Amazon bezahlt wurden. Das Datum wird im Datums-/Zeitintervallformat wie folgt dargestellt ISO 8601. Das Format besteht aus Start- und Enddatum, getrennt durch einen doppelten Bindestrich (--). Das Feld für das Startdatum steht für das früheste Datum, an dem Amazon die Fracht voraussichtlich abholt. Das Enddatum steht für das späteste Datum, an dem Amazon die Fracht voraussichtlich abholt. Wenn in den Feldern Startdatum und Enddatum dasselbe Datum angegeben ist, lesen Sie dieses Datum als das Datum, an dem Amazon die Fracht voraussichtlich abholen wird.
-
Sind Nachbestellungen für einen Einzelposten zulässig?
Sie müssen den Wert im Feld
isBackOrderAllowed
ablesen. Wenn der Wert "true" ist, kann die Bestellung als Nachbestellung bearbeitet werden. Wenn der Wert "false" ist, sind Nachbestellungen nicht zulässig. -
Dealcodes
Dealcodes sind Aktionscodes, die im Feld
dealCode
der Bestellung angegeben sind. Alle Informationen zu Aktionscodes, Sonderrabatten oder Preisen werden in diesem Feld angezeigt. -
Richtlinie für die Stornierung von Nachbestellungen
Ihr Amazon-Geschäftsvertreter legt die Backorder-Richtlinien fest. Besprechen Sie die Einzelheiten mit Ihrem Lieferantenmanager.
Hinweis
Stornierungstermine für Rückstände können in der Bestellung nicht angegeben werden. Sie müssen die Richtlinien für Lieferrückstände auf Kontoebene einrichten.
-
Verwenden Sie die API, um eine Bestellung zu ändern
Das Einreichen einer Änderung an einer Bestellung über die API ist derzeit nicht möglich. Nachdem eine Bestellung aufgegeben wurde, ist die Änderung ein manueller Vorgang über Vendor Central.
Länderspezifische Geschäftsanforderungen
Funktionalität | Indien | Europa | Nordamerika |
---|---|---|---|
Nettokosten | Bedingt. Entweder Nettokosten oder Listenpreis. | Bedingt. Entweder Nettokosten oder Listenpreis. | Bedingt. Entweder Nettokosten oder Listenpreis. |
Listenpreis | Bedingt. Entweder Nettokosten oder Listenpreis. | Bedingt. Entweder Nettokosten oder Listenpreis. | Bedingt. Entweder Nettokosten oder Listenpreis. |
Nachbestellung | Nicht zutreffend | Unterstützt | Unterstützt |
Käufer | Die Adresse der Amazon Buying Entity | Die zugewiesene Party-ID für den Käufer | Nicht zutreffend |
Verkäufer | Der Amazon-Händlercode, der dem Anbieter zugewiesen wurde | Der Amazon-Händlercode, der dem Anbieter zugewiesen wurde | Der Amazon-Händlercode, der dem Anbieter zugewiesen wurde |
Empfänger | Die Adresse des Empfängers | Die zugewiesene Party-ID für den Empfänger | Nicht zutreffend |
Rechnungsempfänger-Partei | Die Rechnungsempfängeradresse | Die Rechnungsempfängeradresse | Nicht zutreffend |
submitAcknowledgement
submitAcknowledgement
Sie können das verwenden submitAcknowledgement
Vorgang zur Annahme oder Ablehnung einer Bestellung zur Erfüllung. Amazon erwartet eine vollständige Bestätigung, die alle Artikel der Bestellung in der Bestellung enthält. Wenn Sie in der Bestätigung nicht alle Einzelposten der Bestellung angeben, lehnt Amazon die fehlenden Einzelposten implizit ab.
Amazon erwartet, dass Sie die Bestätigung so schnell wie möglich, spätestens innerhalb von 24 Stunden, einreichen. Die Bestätigung sollte einen genauen Überblick über die tatsächlichen Versandmengen und -daten geben.
Bei jeder Änderung der Menge, des Preises, der Versand- oder Liefertermine erwartet Amazon, dass die vom Verkäufer eingereichte Bestätigung innerhalb von 48 Stunden aktualisiert wird. Der Verkäufer kann eine vollständige Aktualisierung der Bestätigung einreichen oder nur einen bestimmten Artikel aktualisieren. Amazon behandelt die Aktualisierung immer als Ersatz für die früheren Bestätigungen für den Einzelartikel. Nach 48 Stunden erwarten wir lediglich Aktualisierungen der Versand- oder Liefertermine.
Wenn der erste Bestätigungscode für eine bestimmte Zeile lautete rejected
, das darfst du mit deinem Update auf auch nicht ändern accepted
oder backordered
.
Überprüfung der erfolgreich eingereichten Auftragsbestätigungen
Sie können den Status der ursprünglichen oder aktualisierten Version der Auftragsbestätigung überprüfen, indem Sie Vendor Central oder mit dem API für den Transaktionsstatus. Wenn die ursprüngliche oder aktualisierte Version nach 30 Minuten nicht angezeigt wird, reichen Sie eine Support-Anfrage in Vendor Central ein, indem Sie zu Vendor Central > Support > Contact Us > API Integration.
Das folgende Diagramm zeigt den Integrations-Workflow bei der Bestätigung von Bestellungen.
Geschäftsanforderungen
-
Kann ein Anbieter bei der Bestätigung einer Bestellung die ursprünglich in der Bestellung angegebene Menge erhöhen?
Nein, Sie können in der Bestätigung keine höhere Menge als die in der Bestellung angegebene Menge senden.
-
Ist es erforderlich, für jede Bestellung eine Auftragsbestätigung zu senden?
Ja, um den Status einer Bestellung im Amazon-System korrekt zu aktualisieren, benötigt Amazon eine Bestellbestätigung über die API oder Vendor Central. Wenn Sie unsere Anforderungen an die Auftragsbestätigung mithilfe der API nicht erfüllen können, müssen Sie Ihre Bestellungen mit folgenden Methoden bestätigen Vendor Central. Wenden Sie sich an Ihren Amazon-Vertreter, wenn Sie keinen haben Vendor Central Konto.
-
Ist es erforderlich, jeden Artikel der Bestellposition in der entsprechenden Auftragsbestätigung anzugeben?
Ja, damit Amazon den Bestellstatus korrekt aktualisieren kann.
-
Wenn ein Einzelposten nachbestellt wird, muss die Menge in der Bestellbestätigung angegeben werden?
Ja, damit das Amazon-System den Status des Einzelartikels korrekt aktualisieren kann.
-
Wie sollten ungültige oder veraltete Artikel in einer Bestellung anhand der Auftragsbestätigung gemeldet werden?
Verarbeiten oder versenden Sie keinen Artikel, der mit einer ungültigen Artikelnummer in der Bestellung eingetroffen ist. Geben Sie die ungültige Artikelnummer auf der Bestätigung zurück und bestätigen Sie sie als
invalid
. Die folgenden Bestätigungscodes bedeutenrejected
weil der Artikel veraltet ist:Abgelehnt: Amazon interpretiert, dass die mit diesem Code angegebene Menge nicht als Teil dieser Bestellung an Amazon geliefert wird. Sie sollten den entsprechenden Ablehnungsgrund als senden
obsolete
in der Bestätigung. Dies bedeutet, dass der Artikel nicht mehr bestellt werden sollte, da der Artikel veraltet ist. Die Amazon-Nomenklatur dafür lautet „harte Ablehnung“, was bedeutet, dass dieser Artikel nicht erneut bestellt werden sollte. Wenn dieser Code zweimal hintereinander für dasselbe Projekt eingeht (getrennt durch einen Zeitabstand von mindestens 48 Stunden), wird der Artikel nicht nachbestellt.
Hinweis
Amazon erwartet eine Bestätigung, auch wenn alle Einzelposten der Bestellung ungültig waren und keine Bestellung oder Rechnung ausgestellt wurde. Wenn für eine Bestellung keine entsprechende Bestätigung gesendet werden kann, verlangt Amazon eine manuelle Benachrichtigung über ungültige Artikel. Sie können Ihr Einkaufsteam über das Vendor Central Contact Us Verknüpfung.
-
Muss ich dieselbe Produktkennzeichnung in der Bestätigung zurücksenden, die ich bei der Bestellung erhalten habe?
Bestätigungen müssen exakt dieselbe Produktkennzeichnung enthalten, die in der Bestellung angegeben wurde.
-
Ist es erforderlich, den Preis in der Bestätigung anzugeben?
Ja, Anbieter müssen den Stückpreis in der Bestätigung angeben. Der Selbstkostenpreis sollte dem Einzelpreis entsprechen, der in Rechnung gestellt wird. Buchhändler müssen einen Listenpreis und einen Rabattmultiplikator angeben.
-
Kann der Preis in der Bestellung einfach auf der Bestätigung angegeben werden?
Nein. Unabhängig vom auf der Bestellung angegebenen Preis verlangt Amazon den Selbstkostenpreis in der Bestätigung. Der auf der Bestätigung angegebene Selbstkostenpreis muss mit dem in der Rechnung angegebenen Selbstkostenpreis übereinstimmen. Die Zahlungssysteme von Amazon vergleichen die beiden und können die Zahlung verzögern, wenn sie nicht übereinstimmen.
-
Was verlangt Amazon.com, wenn sich der Preis und/oder die Verfügbarkeit ändern, nachdem die erste Bestätigung übermittelt wurde?
Informieren Sie manuell über alle Änderungen an Amazon-Bestellungen, nachdem die erste Bestätigung übermittelt wurde. Ihr Ansprechpartner bei Amazon.com kann Sie darüber informieren, wann, wie und wen Sie benachrichtigen müssen.
-
Ist es erforderlich, Preisdaten für nachbestellte Artikel anzugeben?
Ja, dies ist erforderlich, damit Amazon den Status der Bestellung korrekt aktualisieren kann. Wenn der Preis weggelassen wird, wird die Bestätigung abgelehnt.
-
Woher weiß ich, ob Nachbestellungen erlaubt sind oder nicht?
Sie müssen den Wert in der
isBackOrderAllowed
Feld in der Bestellung. Der Wert true gibt an, dass Nachbestellungen zulässig sind. Der Wert false gibt an, dass Lieferrückstände nicht zulässig sind. -
Ist es erforderlich, für alle Einzelposten unabhängig vom Status einen Bestätigungscode anzugeben?
Ja, es ist erforderlich, damit wir den Status der Bestellung korrekt aktualisieren können. Wenn der Bestätigungscode weggelassen wird, wird die Bestätigung abgelehnt.
-
Wie lauten die Richtlinien von Amazon in Bezug auf Teillieferungen? Wie müssen Teillieferungen gemeldet werden, wenn eine Bestellbestätigung eingereicht wird?
Teillieferungen sind zulässig, wenn die Bestellung Nachbestellungen zulässt (wenn
isBackOrderAllowed
isttrue
). Amazon empfiehlt, dass Sie mithilfe des Codes eine Bestätigungsschleife angebenaccepted
mit dem entsprechenden Datum und einer weiteren Bestätigungsschleife unter Verwendung des Codesbackordered
und das entsprechende Datum.Akzeptiert: Für Artikel, die sofort versendet werden können.
Nachbestellt: Für die verbleibende Menge, die nicht sofort erfüllt werden kann. Die Restmenge (bestellte Menge abzüglich aller bestätigten Mengen) wird später geliefert (nachbestellt).
-
Wann sollte ich das Segment
listPrice
verwenden?Das Segment
listPrice
ist nur erforderlich, wenn ein Anbieter Bücher mit einem Listenpreis verkauft.
Länderspezifische Geschäftsanforderungen
Funktionalität | Indien | Europa | Nordamerika |
---|---|---|---|
Geplantes Versanddatum | Bedingt. Hängt von den Frachtbedingungen und der aktuellen Geschäftsvereinbarung mit dem Anbieter ab. | Optional | Optional |
Geplanter Liefertermin | Bedingt. Hängt von den Frachtbedingungen und der aktuellen Geschäftsvereinbarung mit dem Anbieter ab. | Optional | Optional |
Listenpreis | Wird nur für Buchhändler benötigt | Unterstützt | Wird nur für Buchhändler benötigt |
Status von Bestellungen abrufen
Das getPurchaseOrdersStatus
operation gibt den Status für die Liste der Bestellungen zurück, die die in der Anfrage angegebenen Kriterien erfüllen. Sie können diesen Vorgang verwenden, um den Bestätigungsstatus der Artikel in Bestellungen abzurufen, die Ihnen zur Erfüllung zur Verfügung stehen. Dieser Vorgang gibt die Historie für die bestellte Menge und die Bestätigungen eines Artikels zurück. Sie können Details aller Bestätigungen einsehen, die für einen Artikel in einer Bestellung bearbeitet wurden. Wir haben eine Vielzahl von Abfrageparametern bereitgestellt, um die Liste der Bestellungen gemäß Ihren Anforderungen zu filtern.
Sie können bis zu 100 Bestellungen in einem API-Aufruf abrufen. Wenn es mehr als 100 Bestellungen gibt, können Sie nextToken
verwenden, um den nächsten Satz an Bestellungen zu erhalten.
Hier finden Sie ein paar Beispiele dafür, wie Sie den Vorgang getPurchaseOrdersStatus
mit verschiedenen Abfrageparametern verwenden können:
-
Sie können den Status aller offenen Bestellungen innerhalb eines bestimmten Zeitraums abrufen, indem Sie entweder das Erstellungsdatum der Bestellung (
createdBefore
undcreatedAfter
) oder das Aktualisierungsdatum der Bestellung (updatedBefore
undupdatedAfter
) zusammen mitpurchaseOrderStatus=OPEN
verwenden. -
Sie können das verwenden
getPurchaseOrdersStatus
Operation zum Filtern des Status von PoS. Zum Beispiel, wennitemConfirmationStatus=REJECTED
, die Antwort gibt alle Bestellungen zurück, die den Status eines oder mehrerer Artikel als abgelehnt haben. -
Sie können den Status einer bestimmten Bestellung überprüfen, indem Sie die Bestellnummer im Abfrageparameter
purchaseOrderNumber
angeben. -
Sie können den Status aller offenen Bestellungen abrufen, die für einen bestimmten Händlercode ausgelöst wurden, indem Sie den Wert des Händlercodes in
orderingVendorCode
angeben undpurchaseOrderStatus=OPEN
einschließen. -
Sie können den Status aller Bestellungen, die in einem bestimmten Zeitraum erstellt wurden und an ein bestimmtes Amazon-Logistikzentrum versendet werden müssen, abrufen, indem Sie den Code des Versandzentrums in
shipToPartyId
und den Zeitraum increatedBefore
undcreatedAfter
angeben.
Anwendungsfälle für Bestellungen und Bestätigungen
Ungültiger Einzelposten in der Bestellung
Wenn Sie in der Bestellung eine ungültige Produktkennzeichnung erhalten, sollten Sie den Artikel mit einem Bestätigungscode ablehnen Rejected
und die rejectionReason
als InvalidProductIdentifier
:
Bestellung
{
"order": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "New",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
Bestätigung der Bestellung
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 10
},
"rejectionReason": "InvalidProductIdentifier"
}
]
}
]
}
]
}
Status der Bestellung
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "CLOSED",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-17T19:17:34.304Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"orderedQuantityDetails": [
{
"updatedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
},
"acknowledgementStatus": {
"confirmationStatus": "REJECTED",
"acceptedQuantity": {
"amount": 0,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"acknowledgementStatusDetails": [
{
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"amount": 0,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
}
}
]
}
]
}
}
Veralteter Einzelposten in der Bestellung
Wenn Sie in der Bestellung ein veraltetes Produkt erhalten, sollten Sie den Artikel mit einem Bestätigungscode ablehnen Rejected
und die rejectionReason
als ObsoleteProduct
.
Bestellung
{
"order": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "New",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
Bestätigung der Bestellung
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266356",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123438",
"vendorProductIdentifier": "028877454079",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "IN",
"amount": "100.20"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 10
},
"rejectionReason": " ObsoleteProduct"
}
]
}
]
}
]
}
Teilmenge des Artikels bestätigen und den Rest der Menge nachbestellen
Amazon hat 10 Artikelmengen bestellt. Der Verkäufer plant, die Sendungen aufzuteilen und sendet daher eine Accepted
Stückzahl von sechs und eins BackOrdered
Bei einer Artikelmenge von vier Stück werden sechs Einheiten in der ersten Lieferung und vier Einheiten in der zweiten Lieferung versendet.
Bestellung — (Bestellung importieren)
{
"order": {
"purchaseOrderNumber": " L8266357",
"purchaseOrderState": "Acknowledged",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderChangedDate": "2019-07-18T16:05:00Z",
"purchaseOrderStateChangedDate": "2019-07-17T10:00:34.304Z",
"purchaseOrderType": "RegularOrder",
"importDetails": {
"importContainers": "2-20'HC,1-45',1-45'HC",
"internationalCommercialTerms": "FreeOnBoard",
"methodOfPayment": "PrepaidBySeller",
"portOfDelivery": "USA",
"shippingInstructions": "PREFERENCE IS PALLET-LOAD, BUT IF CONTAINERS ARE FLOOR-LOADED"
},
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "XYZ1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "XYZ1"
},
"billToParty": {
"partyId": "XYZ1",
"taxInfo": {
"taxRegistrationNumber": "12AAXYZ4259Z123",
"taxRegistrationType": "VAT"
}
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Eaches"
},
"isBackOrderAllowed": true,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
Bestätigung der Bestellung
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Accepted",
"acknowledgedQuantity": {
"amount": 6
},
"scheduledShipDate": "2019-07-17T19:17:34.304Z"
},
{
"acknowledgementCode": "Backordered",
"acknowledgedQuantity": {
"amount": 4
},
"scheduledShipDate": "2019-07-25T19:17:34.304Z"
}
]
}
]
}
]
}
Nach dem Versand des ersten Teils der Bestellung teilt der Anbieter Amazon ein genaueres Datum für die zweite Sendung mit, indem er scheduledShipDate
für die nachbestellten Artikel verwendet. Beachten Sie, dass Anbieter stets vollständige Aktualisierungen mit der gesamten bestellten Menge für einzelne Posten senden sollten. Vollständige Aktualisierungen bieten einen eindeutigen Überblick über die Mengen.
Status der Bestellung
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "OPEN",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-18T16:05:00Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "XYZ1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"orderedQuantityDetails": [
{
"updatedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
"acknowledgementStatus": {
"confirmationStatus": "ACCEPTED",
"acceptedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"acknowledgementStatusDetails": [
{
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"rejectedQuantity": {
"amount": 0,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
}
}
]
}
]
}
}
Mehrfache Bestätigungen zur Stornierung ursprünglich angenommener Mengen
Sie können dies verwenden, wenn Sie feststellen, dass Sie einige oder alle Einheiten einer Bestellung, die ursprünglich akzeptiert wurden, nicht versenden können und Sie Amazon darüber informieren möchten, dass diese Einheiten nicht versendet werden.
Bestellung
{
"order": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "New",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
Bestätigung der Bestellung
Der Verkäufer hat die Menge ursprünglich akzeptiert.
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Accepted",
"acknowledgedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"scheduledShipDate": "2019-07-17T19:17:34.304Z"
}
]
}
]
}
]
}
Später ist der Anbieter nicht in der Lage, die akzeptierte Menge zu versenden und sendet entweder eine vollständige oder eine teilweise Stornierung in Form einer weiteren Anfrage zur Bestätigung der Bestellung.
Vollständige Stornierung
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"rejectionReason": "TemporarilyUnavailable"
}
]
}
]
}
]
}
Teilweise Stornierung
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T20:10:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Accepted",
"acknowledgedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"scheduledShipDate": "2019-07-17T19:17:34.304Z"
},
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 7,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"rejectionReason": "TemporarilyUnavailable"
}
]
}
]
}
]
}
Status der Bestellung nach nachfolgender teilweiser Stornierung
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "OPEN",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-17T19:17:34.304Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"orderedQuantityDetails": [
{
"updatedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
},
"acknowledgementStatus": {
"confirmationStatus": "PARTIALLY_ACCEPTED",
"acceptedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 7,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"acknowledgementStatusDetails": [
{
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 0,
"unitOfMeasure": "Cases",
"unitSize": 5
}
},
{
"acknowledgementDate": "2019-07-17T20:10:34.304Z",
"acceptedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 7,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
}
}
]
}
]
}
}
Was ist die Versand-API für Anbieter?
Sie können das verwenden API für Lieferungen durch Lieferanten (Versand-API), um sendungsbezogene Dokumente mit Amazon auszutauschen.
Die folgenden Vorgänge sind in der Versand-API enthalten:
Vorgang | HTTP-Methode | Path | Beschreibung |
---|---|---|---|
SubmitShipmentConfirmations
|
POST | /vendor/shipping/v1/shipmentConfirmations |
Senden Sie eine oder mehrere Versandbestätigungen an Amazon. |
GetShipmentDetails
|
GET | /vendor/shipping/v1/shipments |
Rufen Sie die Versanddetails für die Transportanfrage ab, die an Amazon gesendet wurde. Der Datenabruf ist für einen Zeitraum von maximal sechs Monaten ab dem Datum der Erstellung der Versandanfrage möglich. |
SubmitShipments
|
POST | /vendor/shipping/v1/shipments |
Senden Sie eine oder mehrere Transportanfragen an Amazon. |
SubmitShipmentConfirmations
SubmitShipmentConfirmations
Sie können das verwenden SubmitShipmentConfirmations
Vorgang zum Einreichen von Versandbestätigungen an Amazon. Mit Ihrer Versandbestätigung können wir Ihre Sendungen effizient entgegennehmen und bearbeiten. Sie enthält Informationen zu den versendeten Artikeln, einschließlich Bestellnummer, Versanddatum, voraussichtliches Lieferdatum, Chargennummer, Verfallsdatum und den Serial Shipping Container Code (SSCC).
Wenn wir eine gültige und fristgerechte Versandbestätigung erhalten, können wir die Sendungen, die Sie uns senden, korrekt vorhersehen. Das Einreichen von Versandbestätigungen bietet unter anderem folgende Vorteile:
-
Amazon kann effektiver mit Transporteuren zusammenarbeiten, um Ihre Sendungen zu verfolgen und zu empfangen. Auf diese Weise können wir unsere Personalressourcen effektiv planen und einen schnelleren und effizienteren Empfang Ihrer Sendung sicherstellen, sodass Sie Ihre Bestellungen schneller fakturieren können.
-
Amazon kann den Wareneingang verfolgen und automatisierte Bestellungen erstellen, um sicherzustellen, dass Artikel nicht ausverkauft sind.
-
Bessere Sichtbarkeit der Produkte während des Transports, was es uns ermöglicht, die Verfügbarkeit der Artikel (Lieferung nach Zeitraum) für Endkunden genauer abzubilden.
-
Mit den Stornierungsrichtlinien von Amazon können ausstehende PO-Sendungen storniert werden. Bestellungen mit genauer Versandbestätigung informieren unsere internen Systeme jedoch über den Status während des Transports. Dies kann dazu beitragen, unnötige Stornierungen von Bestellungen, Rückbuchungen und Frachtverweigerungen zu vermeiden.
Das Fehlen gültiger Versandbestätigungen kann zu folgenden Situationen führen:
- Unzureichende Sichtbarkeit für eingehende Sendungen
- Fehler beim Abgleich der physischen Lieferungen mit Bestellungen.
- Manuelle Follow-ups zur Behebung von Unstimmigkeiten.
- Die Notwendigkeit, einen Liefernachweis (POD) für die Rechnungsstellung vorzulegen.
Versandbestätigung – Ersetzen
Wenn eine Versandbestätigung einen shipmentConfirmationType
von Replace
, Sie können zuvor übermittelte Versandbestätigungen korrigieren, indem Sie eine aktualisierte Version senden. Beim zweiten Anruf zur Versandbestätigung werden die ersten Versandbestätigungsdaten vollständig überschrieben.
Der Hauptvorteil besteht darin, die Buchungsgenauigkeit zu verbessern, indem fehlerhafte Versandbestätigungen nach der ersten Einreichung aktualisiert werden.
Wie funktioniert das?
Um eine zuvor eingereichte Versandbestätigung zu ersetzen, kann eine zweite Versandbestätigung gesendet werden. Die shipmentIdentifier
und sellingParty.partyId
müssen für beide Übertragungen identisch sein, damit wir die vorherige Version der Versandbestätigung erfolgreich überschreiben können.
Umfang der Versandbestätigung — Ersetzen
-
Alle Werte für die Versandbestätigung können bearbeitet werden, mit Ausnahme der
shipmentIdentifier
undsellingParty.partyId
, die für eine erfolgreiche Versandbestätigung identisch bleiben müssen — austauschen. -
Palette, Karton und Versandmenge können nicht erhöht, sondern nur reduziert werden. Um das Volumen zu erhöhen, müssen Sie eine zweite Versandbestätigung mit einer neuen
shipmentIdentifier
versenden. Sie können dieselbe BOL-Referenz verwenden, wenn die zusätzlichen Einheiten zusammen mit derselben Sendung geliefert werden sollen. -
Eine mit der API übermittelte Versandbestätigung kann nur bearbeitet werden, indem eine weitere Versandbestätigung über die API eingereicht wird. Eine Versandbestätigung, erstellt in Vendor Central kann nicht mit der API bearbeitet werden.
-
Das Ersetzen einer Versandbestätigung ist nur innerhalb von 7 Tagen nach der ersten Versandbestätigung möglich und auch dann nur, wenn die Sendung das Amazon-Versandzentrum noch nicht erreicht hat.
Überprüfung der erfolgreich eingereichten Versandbestätigungen
Sie können den Status Ihrer ursprünglichen oder ersetzten Versandbestätigungen überprüfen über Vendor Central > Bestellungen > Lieferungen oder mithilfe der Transaktionsstatus-API. Es kann bis zu 30 Minuten dauern, bis das System nach der Einreichung die originale/ersetzte Version anzeigt. Wenn Vendor Central zeigt nicht die richtigen Werte für die ersetzte Versandbestätigung an, öffnen Sie eine Contact Us Fall in Vendor Central.
Das folgende Diagramm zeigt den Integrationsablauf beim Einreichen von Versandbestätigungen.
Geschäftsanforderungen
-
Wenn ein Verkäufer Artikel versendet, die nach Gewicht verkauft werden, muss er die
totalWeight
Feld. DastotalWeight
Das Feld enthält das Gewicht der Artikel, die der Verkäufer versendet, und die Maßeinheit für das Gewicht. Die Gewichtseinheit der Maßwerte beinhaltetPOUNDS
,OUNCES
,GRAMS
, undKILOGRAMS
. -
Es gibt ein Limit von 100 Versandbestätigungen für jede LKW-Ladungssendung. Das bedeutet, dass Sie nur dann separate Versandbestätigungen auf Bestell- oder Kartonebene versenden können, wenn die Gesamtzahl der einzelnen Versandbestätigungen für diese LKW-Ladung (TL)/weniger als LKW-Ladung (LTL) höchstens 100 beträgt. Wir empfehlen, dass Sie eine einzige Versandbestätigung für die gesamte TL/LTL-Sendung senden, einschließlich aller PO- und Kartondetails.
-
Amazon muss die Versandbestätigung erhalten, bevor das Produkt im Amazon-Versandzentrum empfangen wird. Eine fehlende oder verspätete Versandbestätigung führt zu Rückbuchungen.
-
Für kleine Paketsendungen ist für jedes Paket/jeden Karton eine Versandbestätigung erforderlich.
-
Folgendes wird von Amazon verlangt und wird gemessen, um die Einhaltung der Vorschriften nachzuverfolgen:
- Bei Lieferungen auf Paletten müssen Sie eine Versandbestätigung senden, bevor Sie einen Liefertermin im Amazon-Versandzentrum anfragen, da Termine nur vergeben werden, wenn eine gültige Versandbestätigung in den Amazon-Systemen gefunden wurde. Ausnahmen finden Sie in der lokalen Versandbestätigung Hilfe Seiten, um die verfügbaren Optionen zu verstehen. Bei Paketen muss die Versandbestätigung eingereicht werden, bevor Artikel versendet werden. Eine fehlende oder verspätete Versandbestätigung führt zu Rückbuchungen.
- Eine Versandbestätigung muss für eine Lieferung, von einem Lieferanten und nur für einen LKW ausgestellt sein. Für Sendungen in mehreren LKWs, an mehrere Amazon-Versandzentren, von mehreren Lieferantenkonten oder mit Ankunft an mehreren Tagen sind mehrere Versandbestätigungen erforderlich.
- Wenn mehrere kleinere Lieferungen für dasselbe Lieferantenkonto in einer größeren Sendung zusammengefasst werden und mehrere Versandbestätigungen erforderlich sind, können Sie die Umbrella-BOL-Option verwenden, wie im folgenden Beispiel gezeigt:
Versandbestätigung 1
"billOfLadingNumber": "BOL1"
"shipmentIdentifier": "SHIPMENT CONFIRMATION_ID1"
Versandbestätigung 2
"billOfLadingNumber": "BOL1"
"shipmentIdentifier": "SHIPMENT CONFIRMATION_ID2"
Länderspezifische Geschäftsanforderungen
Funktionalität | Unternehmensdefinition | Indien | Europa | Nordamerika |
---|---|---|---|---|
Frachtbriefnummer/Lieferangebot |
Die BOL-Nummer ist die vom Lieferanten zugewiesene eindeutige Nummer. Die in der Versandbestätigung angegebene Stückliste entspricht im Idealfall der der Sendung beiliegenden Papier-BOL-Nummer, aber das ist nicht erforderlich. Beziehen Sie sich auf Zusätzliche Erläuterungen zu den Feldern für weitere Informationen. Die BOL-Referenz wird für die Terminbuchung und die Erstellung von Versandetiketten verwendet. Die Lieferangebotsnummer ist eine Alternative zu einer BOL als Referenznummer für eine Sendung. |
Nicht zwingend |
Obligatorisch für alle Versandbestätigungen | Obligatorisch für FTL- oder LTL-Sendungen. |
Referenznummer der Sendung des Transporteurs (PRO#) | Die PRO-Nummer (Pro-Nummer) ist eine eindeutige Nummer, die vom Transporteur vergeben wird. Sie wird verwendet, um die Sendung zu identifizieren und zu verfolgen, die ausgeliefert wird. | Obligatorisch für alle Versandbestätigungen | Optional | Obligatorisch für alle Versandbestätigungen |
Versanddatum | Datum, an dem die Sendung das Lager des Verkäufers verlässt. |
Obligatorisch für alle Versandbestätigungen |
Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen |
Voraussichtliches Lieferdatum |
Datum, an dem die Sendung voraussichtlich das Amazon-Versandzentrum erreichen wird. Dies muss eine Schätzung sein, die auf der durchschnittlichen Transitzeit zwischen dem Versandort und dem Bestimmungsort basiert. Die genaue Uhrzeit wird von Amazon angegeben und ist bei der Erstellung der Sendung möglicherweise nicht bekannt. |
Obligatorisch für alle Versandbestätigungen |
Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen |
Anzahl Kartons | Anzahl der in der Sendung enthaltenen Kartons. Einheiten, die ohne den Umkarton auf der Palette gestapelt sind, werden als 1 Einheit = 1 Karton gezählt. Die Anzahl der Kartons ist auf Sendungsebene erforderlich. | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen |
Anzahl der Paletten | Anzahl der in der Sendung vorhandenen Paletten. Bei reinen Paketsendungen muss der Wert 0 angegeben werden. Für alle Volumen, die das Versandzentrum auf einer Palette erreichen, muss in diesem Segment mindestens 1 angegeben werden. Die Informationen sind auf Sendungsebene erforderlich. | Obligatorisch für alle Versandbestätigungen für palettierte Lieferungen | Obligatorisch für alle Versandbestätigungen | Obligatorisch für FTL- und LTL-Sendungen. |
Alpha-Code des Standard-Transportdienstes (SCAC) | Code, der den Transportdienst für die Sendung identifiziert. Der Standard Carrier Alpha Code (SCAC) ist ein eindeutiger Code mit zwei bis vier Buchstaben, der zur Identifizierung eines Transportdienstes verwendet wird. Die SCAC-Codes der Transportdienstd werden von der NMFTA (National Motor Freight Association) vergeben und verwaltet. | Optional | Optional | Obligatorisch für alle Versandbestätigungen |
Versandadresse (Lieferadresse) | Party-ID/Lagercode des Standorts, an den die Produkte versendet werden. Der Name des API-Schemafelds lautet "ShipToParty". | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen |
Identifizierung des Lieferanten | Lieferantenidentifikation des Lieferanten, der die Waren an Amazon versendet. Der Name des API-Schemafelds lautet "SellingParty". | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen | Optional |
Versand von | Adresse (PLZ) und Länderreferenz des Standorts, von dem aus die Produkte physisch versendet werden. | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen |
Amazon-Referenznummer (nur für WePay-Sendungen). | Amazon-Referenznummer, wie sie in den Routing-Anweisungen erhalten wurde (GetShipmentDetails Antwort) für eine WePay-Sendung. |
Nur für Versandbestätigungen verpflichtend (für WePay-Sendungen). |
Nur für Versandbestätigungen verpflichtend (für WePay-Sendungen). |
Obligatorisch für Abholsendungen. |
Nummer der Bestellung | Die Amazon-Bestellnummer. Schriftliche Genehmigung für einen Lieferanten, Produkte zu einem bestimmten Preis zu versenden. Sobald der Lieferant ihn akzeptiert, wird dies zu einem rechtsverbindlichen Vertrag. | Obligatorisch auf Kopf- oder Einzelpostenebene. | Obligatorisch auf Kopf- oder Einzelpostenebene. | Obligatorisch auf Kopf- oder Einzelpostenebene. |
Serieller Versandcontainercode (SSCC) | Eindeutiger 18-stelliger Serial Shipment Container Code (SSCC), der zur Definition einer Palette/eines Kartons enthalten sein muss. | Empfohlen für alle Versandbestätigungen innerhalb der Verpackungseinheit. | Obligatorisch für alle Versandbestätigungen innerhalb der Verpackungseinheit. | Obligatorisch für alle Versandbestätigungen innerhalb der Verpackungseinheit. |
Identifizierung des Artikels | Anbieter-SKU des Produkts. | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen |
Chargennummer | Die Chargen- oder Chargennummer verknüpft einen Artikel mit Informationen, die der Hersteller für die Rückverfolgbarkeit des Handelsartikels, auf den die Elementzeichenfolge angewendet wird, als relevant erachtet. Die Daten können sich auf den Handelsartikel selbst oder auf darin enthaltene Artikel beziehen. | Obligatorisch für verderbliche Artikel. | Obligatorisch für verderbliche Artikel. | Obligatorisch für verderbliche Artikel. |
Verfallsdatum | Das Datum, das die Verbrauchs- oder Verwendungsgrenze eines Produkts festlegt. Seine Bedeutung wird auf der Grundlage des Kontextes des Handelsartikels bestimmt. | Obligatorisch für verderbliche Artikel. | Obligatorisch für verderbliche Artikel. | Entweder Verfallsdatum oder Herstellerdatum und Haltbarkeit sind erforderlich. |
Herstellungsdatum | Das vom Hersteller festgelegte Produktions-, Verpackungs- oder Montagedatum. Seine Bedeutung wird anhand des Kontextes des Handelsartikels bestimmt. | Optional | Optional | Entweder Verfallsdatum oder Herstellerdatum und Haltbarkeit sind erforderlich. |
Menge | Anzahl der Einheiten, die für einen bestimmten Artikel versendet wurden. | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen | Obligatorisch für alle Versandbestätigungen |
Zusätzliche Felderklärungen
Frachtbriefnummer
Die Frachtbriefnummer (BOL#) ist die Referenznummer, die für die Terminbuchung bei Amazon benötigt wird. Diese Referenz muss angegeben werden, wenn Amazon eine gültige Versandbestätigung verlangt. Dies ist die Standardreferenznummer für das Dokument, das der physischen Sendung beiliegt. Die Stücklistennummer in der Versandbestätigung sollte mit der in den Versanddokumenten angegebenen Stücklistennummer übereinstimmen.
Wenn Sie die BOL-Nummer definieren, stellen Sie sicher, dass sie für jede Lieferung eindeutig ist. Ihre BOL-Nr. kann die physische BOL-Referenz sein, aber wenn Sie sich für eine andere Nummer entscheiden:
- Verwenden Sie mindestens acht Ziffern.
- Verwenden Sie den Amazon-Händlercode als Präfix (z. B.: ABCD193939393).
- Verwenden Sie kein Datum oder keine Uhrzeit.
Sendungsnummer
Dieses Feld ist eine eindeutige ID (Eindeutigkeit wird im Kontext des Lieferanten definiert), die diese Versandbestätigung darstellt. Versäumnis, eine bereitzustellen Shipment Identification
führt dazu, dass die Versandbestätigung abgelehnt wird. Stellen Sie sicher, dass die gesendete ID in den letzten 365 Tagen nicht verwendet wurde.
Versanddatum
Dieses Feld gibt das Datum an, an dem die Sendung vom Standort des Verkäufers abgeschickt wurde. Die Anbieter werden gebeten, die Versandbestätigungen zu senden, bevor die Fracht bei Amazon FC eintrifft.
Voraussichtliches Lieferdatum
Dies ist eine auf Erfahrungswerten basierende grobe Schätzung, wann eine Sendung voraussichtlich an das Amazon-Logistikzentrum geliefert wird. Anbieter müssen dies anhand der durchschnittlichen Transportzeit des Transportdienstes ermitteln. Diese Informationen helfen uns bei der Planung der Lieferung, falls wir vom Transportdienst kein voraussichtliches Lieferdatum erhalten.
Dieses Datum muss für jede Sendung angegeben werden, auch wenn derzeit möglicherweise kein Termin bekannt ist.
Seriennummerncode des Versandcontainers (SSCC)
Amazon verarbeitet Belege mithilfe eines hochautomatisierten Verfahrens, das als License Plate oder LP Receive bezeichnet wird. Für diesen Vorgang müssen Sie in Ihren Versandbestätigungsnachrichten Angaben zum Kartoninhalt machen. Bei diesem erforderlichen Empfangsvorgang wird ein SSCC-Barcode (Serial Shipment Container Code) auf der Außenseite eines Kartons oder einer Palette mit eingegangenen Artikeln gescannt, sodass nicht jeder Artikel innerhalb des Kartons oder der Palette gescannt werden muss. Dieses Verfahren bietet eine Reihe bedeutender Vorteile, darunter eine höhere Effizienz, eine verbesserte Empfangsgenauigkeit, eine genauere Zahlung und eine schnellere Zahlungszykluszeit.
Sie können eine technische Lösung wählen, da Amazon beschlossen hat, die GS1-128-Lösung nicht strikt zu befolgen. Um den Anforderungen des Amazon-Nummernschilds zu entsprechen, muss ein SSCC-Code ein eindeutiger 18-stelliger Code sein, der eine Palette oder einen Karton definiert. Er kann nicht innerhalb von 365 Tagen wiederholt werden und muss sowohl auf dem Kartonetikett als auch in der Versandbestätigungsnachricht einen Barcode enthalten. Darüber hinaus muss der Barcode auf dem physischen Etikett zu 100% mit dem SSCC in der Versandbestätigung übereinstimmen. Anbieter, die GS1-128 implementieren möchten, werden gebeten, einen hinzuzufügen 00
zu Beginn ihres SSCC in der Versandbestätigung.
Weitere Informationen zur Generierung eines SSCC und zu den Anforderungen für die physische Lieferung finden Sie unter Vendor Central. Um das Anbieterhandbuch mit den Kennzeichnungsanforderungen zu finden, wählen Sie Versand, dann Kennzeichenschild und Empfangsanforderungen.
Verfallsdatum
Das Verfallsdatum ist das Datum, das die Verbrauchs- oder Verwendungsgrenze eines Produkts bestimmt. Es wird auf der Grundlage des Kontextes des Handelsartikels bestimmt (z. B. weist dies bei Lebensmitteln auf die Möglichkeit eines direkten Gesundheitsrisikos hin, wenn das Produkt nach dem Datum verwendet wird, bei pharmazeutischen Produkten auf die Möglichkeit eines indirekten Gesundheitsrisikos, das sich aus der Unwirksamkeit des Produkts nach Ablauf des Datums ergibt). Es wird oft als "Mindesthaltbarkeitsdatum" oder "Haltbarkeitsdatum" bezeichnet.
Herstellungsdatum
Dies ist das Datum, an dem die Waren verpackt oder hergestellt wurden. Dieses Feld sollte ausgefüllt werden, wenn ein Artikel verderblich ist oder eine bestimmte Haltbarkeit hat.
Chargennummer
Die Chargen- oder Chargennummer ordnet einem Artikel Informationen zu, die der Hersteller für die Rückverfolgbarkeit des Artikels selbst oder der darin enthaltenen Inhaltsstoffe als relevant erachtet. Die Nummer kann eine Produktionscharge, eine Arbeitsschicht, eine Maschine, eine Uhrzeit oder einen internen Produktionscode angeben.
Verwendung von Verfallsdatum/Herstellungsdatum/Chargennummern in der Versandbestätigung
Diese Felder sind nur für verderbliche Artikel Pflichtfelder, d. h. für Artikel, bei denen is expiration dated product
Attribut ist Yes
auf dem Formular für die Einrichtung neuer Artikel (NIS).
Wenn Sie die Ablaufdaten, Herstellungsdaten oder Chargennummern in der Versandbestätigung definieren, gehen Sie wie folgt vor:
-
Verfallsdaten/Herstellungsdaten/Chargennummern müssen auf Artikelebene gesendet werden.
-
Ein Karton/eine Palette kann mehrere Artikel (ASINs) enthalten, von denen jeder ein(e) individuelle(s) Verfallsdatum/Herstellungsdatum/Chargennummer hat.
-
Ein Artikel (ASIN) sollte nicht mehrere Verfallsdaten/Herstellungsdaten/Chargennummern innerhalb desselben Kartons/derselben Palette haben.
Anbieter müssen das Verfallsdatum und das Herstellungsdatum in der Versandbestätigung im Format JJJJMMTT angeben.
Anwendungsfälle für die Versandbestätigung
Kleines Paket in Standardverpackung mit Mindesthaltbarkeitsdatum und Chargennummer
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "TruckLoad",
"shipmentStructure": "LooseStandardCase",
"transportationDetails": {
"carrierScac": "UPSN",
"billOfLadingNumber": "02440000"
},
"amazonReferenceNumber": "ARN_Number",
"shipmentConfirmationDate": "2019-07-29T21:56:18.575Z",
"shippedDate": "2019-07-29T21:56:18.575Z",
"estimatedDeliveryDate": "2019-07-29T21:56:18.575Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"cartonCount": 2
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"amazonProductIdentifier": "AB1234233",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"amount": 50,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": " 001",
"trackingNumber": "UPS TRACKING NUMBER",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698889"
}
],
"cartonSequenceNumber": " 002",
"trackingNumber": "UPS TRACKING NUMBER",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
}
]
}
]
}
Klein LooseAssortmentCase
Paket mit Mindesthaltbarkeitsdatum und Chargennummern
LooseAssortmentCase
Paket mit Mindesthaltbarkeitsdatum und Chargennummern{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "TruckLoad",
"shipmentStructure": "LooseAssortmentCase",
"transportationDetails": {
"carrierScac": "UPSN",
"billOfLadingNumber": "02440000"
},
"amazonReferenceNumber": "ARN_Number",
"shipmentConfirmationDate": "2019-07-29T21:56:18.575Z",
"shippedDate": "2019-07-29T21:56:18.575Z",
"estimatedDeliveryDate": "2019-07-29T21:56:18.575Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"cartonCount": 2
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"amazonProductIdentifier": "AB1234233",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"amount": 50,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
},
{
"itemSequenceNumber": "002",
"amazonProductIdentifier": "AB1234235",
"vendorProductIdentifier": "VN24343370",
"shippedQuantity": {
"amount": 50,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": " 001",
"trackingNumber": "UPS TRACKING NUMBER",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 1
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
]
}
]
}
]
}
Palettierte LKW-Ladung mit mehreren Artikeln
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "TruckLoad",
"shipmentStructure": "PalletizedAssortmentCase",
"transportationDetails": {
"transportationMode": "Road",
"billOfLadingNumber": "02440000"
},
"shipmentConfirmationDate": "2019-08-07T19:56:45.632Z",
"shippedDate": "2019-08-07T19:56:45.632Z",
"estimatedDeliveryDate": "2019-08-07T19:56:45.632Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "VENDORWAREHOUSECODE"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "250"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"palletCount": 2
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
},
{
"itemSequenceNumber": "002",
"vendorProductIdentifier": "9782700001000",
"shippedQuantity": {
"amount": 400,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": "001",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAAAA",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACC",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698999"
}
],
"cartonSequenceNumber": "002",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698669"
}
],
"cartonSequenceNumber": "003",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666697799"
}
],
"cartonSequenceNumber": "004",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
}
],
"pallets": [
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098745"
}
],
"tier": 1,
"block": 2,
"dimensions": {
"length": "1.2",
"width": "0.8",
"height": "1",
"unitOfMeasure": "In"
},
"weight": {
"unitOfMeasure": "Kg",
"value": "55"
},
"cartonReferenceDetails": {
"cartonCount": 2,
"cartonReferenceNumbers": [
"001",
"002"
]
}
},
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098700"
}
],
"tier": 1,
"block": 2,
"dimensions": {
"length": "1.2",
"width": "0.8",
"height": "1",
"unitOfMeasure": "In"
},
"weight": {
"unitOfMeasure": "Kg",
"value": "55"
},
"cartonReferenceDetails": {
"cartonCount": 2,
"cartonReferenceNumbers": [
"003",
"004"
]
}
}
]
}
]
}
Versand von weniger als einer LKW-Ladung mit palettierten Standardkisten
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "LessThanTruckLoad",
"shipmentStructure": "PalletizedStandardCase",
"transportationDetails": {
"transportationMode": "Road",
"billOfLadingNumber": "02440000"
},
"shipmentConfirmationDate": "2019-08-07T19:56:45.632Z",
"shippedDate": "2019-08-07T19:56:45.632Z",
"estimatedDeliveryDate": "2019-08-07T19:56:45.632Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "VENDORWAREHOUSECODE"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"palletCount": 1
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAAAA",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "299.00"
},
"handlingCode": "Oversized"
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": "001",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666699999"
}
],
"cartonSequenceNumber": "002",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666696666"
}
],
"cartonSequenceNumber": "003",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666697777"
}
],
"cartonSequenceNumber": "004",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
}
],
"pallets": [
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098745"
}
],
"tier": 2,
"block": 2,
"dimensions": {
"length": "1.2",
"width": "0.8",
"height": "1",
"unitOfMeasure": "In"
},
"weight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"cartonReferenceDetails": {
"cartonCount": 4,
"cartonReferenceNumbers": [
"001",
"002",
"003",
"004"
]
}
}
]
}
]
}
Versand einzelner ASIN-Paletten mit weniger als LKW-Ladung
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "5013088794",
"shipmentConfirmationType": "Original",
"shipmentType": "LessThanTruckLoad",
"shipmentStructure": "PalletOfItems",
"transportationDetails": {
"carrierShipmentReferenceNumber": "1021396377",
"billOfLadingNumber": "501308879400010001",
"transportationMode": "Road"
},
"shipmentConfirmationDate": "2023-04-21T22:31:43Z",
"shippedDate": "2023-04-21T22:31:43Z",
"estimatedDeliveryDate": "2023-04-21T22:31:43Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "181.656"
},
"palletCount": 3,
"grossShipmentWeight": {
"unitOfMeasure": "Lb",
"value": "3315.744"
}
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"amount": 315,
"unitOfMeasure": "Cases",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2024-11-29T21:56:18.575Z"
}
}
}
],
"pallets": [
{
"tier": 10,
"palletIdentifiers": [
{
"containerIdentificationNumber": "108195730651297459",
"containerIdentificationType": "SSCC"
}
],
"weight": {
"unitOfMeasure": "Lb",
"value": "828.936"
},
"block": 15,
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 105,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
],
"dimensions": {
"unitOfMeasure": "In",
"length": "44.375",
"width": "39.750",
"height": "40.500"
}
},
{
"tier": 10,
"palletIdentifiers": [
{
"containerIdentificationNumber": "108195730651297589",
"containerIdentificationType": "SSCC"
}
],
"weight": {
"unitOfMeasure": "Lb",
"value": "828.936"
},
"block": 15,
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 105,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
],
"dimensions": {
"unitOfMeasure": "In",
"length": "44.375",
"width": "39.750",
"height": "40.500"
}
},
{
"tier": 10,
"palletIdentifiers": [
{
"containerIdentificationNumber": "108195730651297595",
"containerIdentificationType": "SSCC"
}
],
"weight": {
"unitOfMeasure": "Lb",
"value": "828.936"
},
"block": 15,
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 105,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
],
"dimensions": {
"unitOfMeasure": "In",
"length": "44.375",
"width": "39.750",
"height": "40.500"
}
}
]
}
]
}
SubmitShipments
SubmitShipments
Wichtig
SubmitShipments
ist nur auf nordamerikanischen und europäischen Marktplätzen verfügbar.
Das SubmitShipments
Dieser Vorgang ist so konzipiert, dass Collect- oder WePay-Anbieter Anfragen zur Abholung ihrer Sendungen durch Amazon stellen. Mit diesem Vorgang können sie auch eingereichte Anfragen aktualisieren oder stornieren. Sie können mehrere Bestellungen, die für den Versand bereit sind, konsolidieren und den Transport über eine einzige Versandanfrage anfordern. So sparen Sie Zeit und senken die Kosten. Wenn Sie eine Versandanfrage stellen, muss das angeforderte Abholdatum mindestens zwei Arbeitstage nach dem aktuellen Datum liegen.
Hinweis
Das
SubmitShipments
Der Vorgang unterstützt nicht das Einreichen von Versandanfragen für Paletten, die nicht dem Standard entsprechen.
Sendung erstellen oder aktualisieren
Wann der transactionType
für eine Versandanfrage ist New
, können Sie eine neue Anfrage erstellen oder eine zuvor eingereichte Versandanfrage aktualisieren. Aktualisierungen einer bestehenden Versandanfrage werden auf der Grundlage der Lieferanten-Sendungsnummer vorgenommen. Wenn bereits eine Sendung mit der angegebenen Lieferanten-Sendungsnummer existiert, erfolgt ein Aktualisierungsvorgang; andernfalls wird eine neue Sendung erstellt.
Umfang der Update-Lieferung:
- Alle Werte für Versandanfragen können bearbeitet werden, außer
vendorShipmentIdentifier
,buyerReferenceNumber
, undsellingParty.partyId
die für ein erfolgreiches Update identisch bleiben muss. Sie haben die Flexibilität, alle anderen Felder in der Versandanfrage zu ändern, bevor der Transporteur zugewiesen wird. - Das in der Versandanfrage angeforderte Abholdatum kann erst geändert werden, nachdem der Transporteur zugewiesen wurde.
Versand stornieren
Eine Versandanfrage mit transactionType
als Cancel
ermöglicht es Ihnen, eine zuvor eingereichte Versandanfrage zu stornieren. Um eine zuvor übermittelte Versandanfrage zu stornieren, müssen Sie Folgendes angeben vendorShipmentIdentifier
, buyerReferenceNumber
, sellingParty.partyId
, shipFromParty.partyId
, shipToParty.partyId
und transactionType
als Cancel
.
Umfang der Stornierung der Lieferung:
- Das Stornieren einer Versandanfrage ist sowohl vor als auch nach der Zuweisung eines Transporteurs und der Planung der Weiterleitung möglich.
Überprüfung erfolgreich eingereichter Versandanfragen
Du benutzt Vendor Central oder die API für den Transaktionsstatus des Anbieters um den Status Ihrer Versandanfrage zu überprüfen. Wenn der Status der geposteten Anfrage nach 30 Minuten nicht angezeigt wird, reichen Sie eine Support-Anfrage in Vendor Central ein, indem Sie zu Vendor Central > Support > Contact Us > API Integration.
Hinweis
Die Transaction Status API unterstützt nur
Processing
undFailure
Statuswerte für eingereicht Versand stornieren Anfragen.
Das folgende Diagramm zeigt den Integrationsworkflow beim Einreichen von Versandanfragen.
Geschäftsanforderungen
- Die Versandanfrage sollte erst eingereicht werden, wenn die entsprechende Bestellung vollständig bestätigt ist. Wenn die Bestellung noch nicht bestätigt wurde, kann die Versandanfrage nicht bearbeitet werden.
- Das
requestedPickUp
in der Versandanfrage muss mindestens zwei Arbeitstage nach dem aktuellen Datum liegen. - Alle Werte für Versandanfragen können bearbeitet werden, außer
vendorShipmentIdentifier
,buyerReferenceNumber
, undsellingParty.partyId
, die für ein erfolgreiches Update identisch bleiben muss. Sie haben die Flexibilität, alle anderen Felder in der Versandanfrage zu ändern, bevor der Transporteur zugewiesen wird. - Sie können das angeforderte Abholdatum in der Versandanfrage erst ändern, nachdem ein Transporteur zugewiesen wurde.
- Das Stornieren einer Versandanfrage ist sowohl vor als auch nach der Zuweisung eines Transporteurs und der Planung der Weiterleitung möglich.
Zusätzliche Felderklärungen
Sendungsnummer des Lieferanten
Dieses Feld ist eine eindeutige ID (Eindeutigkeit wird im Kontext des Lieferanten definiert), die diese Transportanfrage darstellt. Versäumnis, eine anzugeben vendorShipmentIdentifier
führt dazu, dass die Transportanfrage abgelehnt wird. Stellen Sie sicher, dass die gesendete ID in den letzten 365 Tagen nicht verwendet wurde.
Gewünschtes Abholdatum
Dieses Feld wird auch genannt Freight Ready Date
, wird verwendet, um das früheste Abholdatum der Sendung am Standort des Verkäufers anzugeben. Sie werden gebeten, die Transportanfrage zu senden, wenn die Artikel zur Abholung bereit sind.
Anfragen zu Versandbeispielen einreichen
Versandanfrage erstellen oder aktualisieren
{
"shipments": [
{
"vendorShipmentIdentifier": "00050003",
"transactionType": "New",
"transactionDate": "2019-08-07T19:56:45.632",
"shipmentFreightTerm": "Collect",
"sellingParty": {
"partyId": "PQRSS"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "999US"
},
"shipToParty": {
"partyId": "ABCDF"
},
"shipmentMeasurements": {
"totalCartonCount": 30,
"totalPalletStackable": 30,
"totalPalletNonStackable": 30,
"shipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
}
},
"collectFreightPickupDetails": {
"requestedPickUp": "2019-08-07T19:56:45.632"
},
"purchaseOrders": [
{
"purchaseOrderNumber": "1BBBAAAA"
},
{
"purchaseOrderNumber": "1BBBACCC"
}
]
}
]
}
Versandanfrage stornieren
{
"shipments": [
{
"vendorShipmentIdentifier": "00050003",
"buyerReferenceNumber": "1234567",
"transactionType": "Cancel",
"transactionDate": "2019-08-07T19:56:45.632",
"shipmentFreightTerm": "Collect",
"sellingParty": {
"partyId": "PQRSS"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "999US"
},
"shipToParty": {
"partyId": "ABCDF"
}
}
]
}
GetShipmentDetails
GetShipmentDetails
Wichtig
GetShipmentDetails
ist nur für WePay- und Collect-Bestellungen auf nordamerikanischen und europäischen Marktplätzen.
Sie können das verwenden GetShipmentDetails
Vorgang zum Abrufen der Informationen zur geplanten Abholung und zur Zuweisung des Spediteurs. Sie müssen verwenden SubmitShipments
oder eine Routing-Anfrage, bevor die Versanddetails verfügbar sind. GetShipmentDetails
gibt nur nach der Zuweisung des Transporteurs eine Antwort zurück, die entweder am selben Tag wie die geplante Abholung oder einen Tag vor dem Abholdatum erfolgt.
Die in der Antwort zurückgegebenen Informationen helfen Ihnen dabei, Ihren Versandvorgang effizient abzuwickeln und sicherzustellen, dass die Bestellung verpackt ist und am angegebenen Abholdatum vom Transporteur abgeholt werden kann. Sie können diesen Vorgang jederzeit während des Versandzyklus verwenden, um den Versandstatus und die Versanddetails einzusehen. Dieser Vorgang wird hauptsächlich von WePay-Anbietern verwendet.
Das folgende Diagramm zeigt den Workflow zur Integration von Lieferungen durch Vendor Get.
Geschäftsanforderungen
-
Das
GetShipmentDetails
Die Operation liefert nur eine Antwort, wenn die Sendungserstellung erfolgreich ist. Die Antwort enthält die Amazon-Referenznummer (ARN) und andere Versanddetails. Die Einzelheiten zur Zuweisung des Transporteurs sind erst nach der Zuweisung des Transporteurs für die Sendung verfügbar. Die Zuweisung des Transporteurs erfolgt am selben Tag wie die geplante Abholung oder einen Tag vor dem Abholdatum. -
Das
GetShipmentDetails
Der Vorgang liefert keine Informationen zu Sendungen, die über folgende Adresse eingereicht wurden Vendor Central.
GetShipmentDetails
erforderlich
GetShipmentDetails
erforderlichUm eine Kundenrechnung zurückzugeben, rufen Sie den Vorgang GetShipmentDetails
auf und übergeben Sie den folgenden Parameter:
Abfrageparameter:
Name | Beschreibung | Erforderlich |
---|---|---|
limit |
Das Limit für die Anzahl der zurückgegebenen Datensätze. Typ: int |
Nein |
sortOrder |
Sortieren Sie die Liste nach dem Erstellungsdatum der Sendung in aufsteigender oder absteigender Reihenfolge. Typ: Zeichenfolge Typ: Enumeration ( |
Nein |
nextToken |
Wird für die Paginierung verwendet, wenn mehr Versandetiketten als die angegebene Ergebnisgrößenbeschränkung vorliegen. Der Tokenwert wird im vorherigen API-Aufruf zurückgegeben. Typ: Zeichenfolge |
Nein |
createdAfter |
Lieferungen, die nach diesem Zeitpunkt erstellt wurden, werden im Ergebnis berücksichtigt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
createdBefore |
Lieferungen, die vor diesem Zeitpunkt erstellt wurden, werden in das Ergebnis aufgenommen. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
shipmentConfirmedBefore |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Lieferungen abgerufen werden, die vor diesem Datum bestätigt wurden. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
shipmentConfirmedAfter |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Lieferungen abgerufen werden, die nach diesem Datum bestätigt wurden. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
packageLabelCreatedBefore |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Sendungen abgerufen werden, für die vor diesem Datum Paketaufkleber erstellt wurden. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: string (Boolean) |
Nein |
packageLabelCreatedAfter |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Sendungen abgerufen werden, für die nach diesem Datum Paketaufkleber erstellt wurden. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
shippedBefore |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Lieferungen abgerufen werden, deren Versanddatum vor diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
shippedAfter |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Lieferungen abgerufen werden, für die das Versanddatum nach diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
estimatedDeliveryBefore |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Lieferungen abgerufen werden, deren voraussichtlicher Liefertermin vor diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
estimatedDeliveryAfter |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Lieferungen abgerufen werden sollen, deren voraussichtliches Lieferdatum nach diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
shipmentDeliveryBefore |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Lieferungen abgerufen werden sollen, deren Lieferdatum vor diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
shipmentDeliveryAfter |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Lieferungen abgerufen werden, für die das Lieferdatum nach diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
requestedPickUpBefore |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Sendungen abgerufen werden, für die das angeforderte Abholdatum vor diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
requestedPickUpAfter |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Sendungen abgerufen werden, für die das angeforderte Abholdatum nach diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
scheduledPickUpBefore |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Sendungen abgerufen werden, für die das geplante Abholdatum vor diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
scheduledPickUpAfter |
Wird verwendet, um das Datum anzugeben, an dem die Versanddetails aller Sendungen abgerufen werden, für die das geplante Abholdatum nach diesem Datum liegt. Dieses Feld muss in ISO 8601 Datums-/Uhrzeitformat. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
currentShipmentStatus |
Rufen Sie die Versanddetails ab, indem Sie den aktuellen Versandstatus angeben. Typ: Zeichenfolge |
Nein |
vendorShipmentIdentifier |
Rufen Sie die Versanddetails ab, indem Sie die Sendungsnummer des Anbieters angeben. Typ: Zeichenfolge |
Nein |
buyerReferenceNumber |
Rufen Sie die Versanddetails ab, indem Sie die Referenznummer des Käufers angeben. Typ: Zeichenfolge |
Nein |
buyerWarehouseCode |
Rufen Sie die Versanddetails auf der Grundlage des Lagercodes des Käufers ab. Dieser Wert sollte dem entsprechen shipToParty.partyId in der Lieferung. Typ: Zeichenfolge |
Nein |
sellerWarehouseCode |
Rufen Sie die Versanddetails auf der Grundlage des Lagercodes des Anbieters ab. Dieser Wert sollte dem entsprechen sellingParty.partyId in der Lieferung. Typ: Zeichenfolge |
Nein |
Beispiel für eine Anfrage:
GET https://sellingpartnerapi-na.amazon.com/vendor/shipping/v1/shipments?vendorShipmentIdentifier=00050003
GetShipmentDetails
Werte:
GetShipmentDetails
Werte:Beispiel für eine Antwort:
{
"payload": {
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"shipments": [
{
"vendorShipmentIdentifier": "00050003",
"buyerReferenceNumber": "1234567",
"currentShipmentStatus": "CarrierAssigned",
"currentshipmentStatusDate": "2019-08-09T19:56:45.632",
"shipmentStatusDetails": [
{
"shipmentStatus": "CarrierAssigned",
"shipmentStatusDate": "2019-08-09T19:56:45.632"
},
{
"shipmentStatus": "TransportationRequested",
"shipmentStatusDate": "2019-07-07T19:56:45.632"
},
{
"shipmentStatus": "Created",
"shipmentStatusDate": "2019-07-06T19:56:45.632"
}
],
"shipmentCreateDate": "2019-07-06T19:56:45.632",
"shipmentFreightTerm": "Collect",
"sellingParty": {
"partyId": "998US"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCD12"
},
"shipToParty": {
"partyId": "999US"
},
"shipmentMeasurements": {
"totalCartonCount": 30,
"totalPalletStackable": 30,
"totalPalletNonStackable": 30,
"shipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
}
},
"collectFreightPickupDetails": {
"requestedPickUp": "2019-08-10T19:56:45.632",
"scheduledPickUp": "2019-08-10T19:56:45.632",
"carrierAssignmentDate": "2019-08-09T19:56:45.632",
},
"purchaseOrders": [
{
"purchaseOrderNumber": "1BBBAAAA"
}
],
"transportationDetails": {
"shipMode": "LessThanTruckLoad",
"transportationMode": "Road",
"shippedDate": "2019-08-07T19:56:45.632",
"estimatedDeliveryDate": "2019-08-07T19:56:45.632",
"shipmentDeliveryDate": "2019-08-07T19:56:45.632",
"carrierDetails": {
"name": "UPS",
"phone": "1234567890",
"email": "abc@xyz.com",
"code": "string",
"shipmentReferenceNumber": "TRACK001"
},
"billOfLadingNumber": "string"
}
}
]
}
}
GetShipmentLabels
GetShipmentLabels
Sie können das verwenden GetShipmentLabels
Betrieb zur Beschaffung von Versandetiketten von Amazon ausschließlich für kleine Paketsendungen im Namen von Collect/WePay-Anbietern. Dieser Vorgang hilft Anbietern dabei, Versandetiketten für bestätigte Bestellungen abzurufen, für die ein Versand vom Lager des Verkäufers zum Lager von Amazon erforderlich ist. Anbieter können Etiketten über einen einzelnen API-Aufruf oder mehrere API-Aufrufe abrufen. Etiketten werden generiert, sobald die Versandanfrage abgeschlossen und ein Spediteur zugewiesen wurde. Anbieter haben die Möglichkeit, von Amazon generierte Etiketten anhand verschiedener Parameter zu filtern, z. B. anhand von Käuferreferenznummern (auch als Amazon-Referenznummern bezeichnet), Lagercodes des Verkäufers und anderen Werten.
Das folgende Diagramm zeigt den Arbeitsablauf zur Integration von Versandetiketten durch Lieferanten.
Geschäftsanforderungen
- Rufen Sie den
GetShipmentLabels
erst nachdem ein Spediteur zugewiesen wurde. - Wenn
GetShipmentLabels
gibt kein Etikett zurück oder kehrt zurückResource Not Found
, überprüfen Sie, ob ein Transporteur zugewiesen wurde. Alternativ können Sie anrufenGetShipmentDetails
um zu bestätigen, ob der Transporteur zugewiesen wurde. - Wenn ein Transporteur zugewiesen wurde und der Vorgang immer noch kein Etikett zurückgibt, öffnen Sie im Vendor Central-Portal einen Fall mit der Aufschrift „Kontaktieren Sie uns“.
- Sobald ein Etikett für den Versand verwendet wurde, kann es niemals wiederverwendet werden.
Länderspezifische Geschäftsanforderungen
Dieser API-Vorgang ist nur in der Region NA verfügbar.
Anfrage abfragen
Um eine Liste der Versandetiketten abzurufen, rufen Sie den Vorgang GetShipmentLabels
auf und übergeben Sie die folgenden Parameter:
Name | Beschreibung | Erforderlich |
---|---|---|
limit |
Das Limit für die Anzahl der zurückgegebenen Datensätze. Typ: int |
Nein |
sortOrder |
Sortieren Sie die Liste nach dem Erstellungsdatum des Versandetiketts in aufsteigender oder absteigender Reihenfolge. Typ: Zeichenfolge Typ: Enumeration ( |
Nein |
nextToken |
Wird für die Paginierung verwendet, wenn mehr Bestellungen als die angegebene Ergebnisgrößenbeschränkung vorliegen. Der Tokenwert wird im vorherigen API-Aufruf zurückgegeben. Typ: Zeichenfolge |
Nein |
labelCreatedAfter |
Versandetiketten, die nach diesem Zeitpunkt erstellt wurden, werden in das Ergebnis aufgenommen. Dieses Feld muss das Datums-/Uhrzeitformat nach ISO 8601 haben. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
labelCreatedBefore |
Versandetiketten, die vor diesem Zeitpunkt erstellt wurden, werden in das Ergebnis aufgenommen. Dieses Feld muss das Datums-/Uhrzeitformat nach ISO 8601 haben. Typ: Zeichenfolge (Datum-Uhrzeit) |
Nein |
buyerReferenceNumber |
Holen Sie sich Versandetiketten, indem Sie die Käuferreferenznummer angeben. Typ: Zeichenfolge |
Nein |
vendorShipmentIdentifier |
Holen Sie sich Versandetiketten, indem Sie die Liefernummer des Anbieters angeben. Typ: Zeichenfolge |
Nein |
sellerWarehouseCode |
Holen Sie sich Versandetiketten, die auf dem Lagercode des Lieferanten basieren. Dieser Wert sollte dem entsprechen sellingParty.partyId in der Lieferung. Typ: Zeichenfolge |
Nein |
Beispiel anfordern
GET /vendor/shipping/v1/transportLabels?vendorShipmentIdentifier=7822
Antwort von GetShipmentLabels
{
"payload": {
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"transportLabels": [
{
"labelCreateDateTime": "2024-10-23T17:10:35Z",
"shipmentInformation": {
"vendorDetails": {
"sellingParty": {
"partyId": "WAD47"
},
"vendorShipmentIdentifier": "7822"
},
"buyerReferenceNumber": "14511336331",
"shipToParty": {
"partyId": "LAX9"
},
"shipFromParty": {
"partyId": "0-55767831",
"address": {
"name": "Wheeler Bros., Inc. HQ",
"addressLine1": "384 Drum Ave",
"addressLine2": "Suite 123",
"addressLine3": "DOOR 1",
"city": "Somerset",
"stateOrRegion": "PA",
"postalCode": "15501",
"countryCode": "US"
}
},
"masterTrackingId": "1ZR873R70319165935",
"totalLabelCount": 1,
"shipMode": "SmallParcel"
},
"labelData": [
{
"labelSequenceNumber": 1,
"labelFormat": "PDF",
"carrierCode": "UPSN",
"trackingId": "1ZR873R70319165935",
"label": "Base 64 encoded string goes here."
}
]
}
]
}
}
Was ist die API für Lieferantenrechnungen?
Sie können das verwenden API für Lieferantenrechnungen, um zahlungsbezogene Dokumente mit Amazon auszutauschen. Mit dem Vorgang Rechnungen einreichen können Sie Lieferantenrechnungen für bestätigte und versendete Bestellungen an Amazon senden.
Die folgenden Vorgänge sind enthalten:
Vorgang | HTTP-Methode | Path | Beschreibung |
---|---|---|---|
submitInvoices | POST | /vendor/payments/v1/invoices | Sendet eine oder mehrere Anbieterrechnungen an Amazon |
Hinweis
Das
submitInvoices
Operation kann verwendet werden, um Gutschriften in Europa einzureichen.
Rechnungen einreichen
Sie können das verwenden submitInvoices
Vorgang, um die Zahlung von Amazon für versendete Artikel anzufordern. Sie können diesen Vorgang verwenden, um mehrere Rechnungen in einem einzigen API-Aufruf einzureichen.
Artikel sollten erst in Rechnung gestellt werden, nachdem sie bestätigt und an Amazon versendet wurden. Andernfalls wird die Rechnung abgelehnt.
Eine Rechnung mit korrekten Informationen wird von Amazon ohne menschliches Eingreifen bearbeitet, was bedeutet, dass der Anbieter die Zahlung schneller erhält.
Rechnungen mit falschen Informationen werden im Zahlungsempfängersystem von Amazon abgelehnt, daher ist es wichtig, korrekte Informationen zu senden. Schlagen Sie unter Geschäftsanforderungen nach, um zu erfahren, wie man Rechnungen mit korrekten Informationen erstellt.
Paralleles Testen der Rechnungseinreichung
Sie müssen parallele Tests mit unserem Zahlungssystem durchführen, bevor Sie mit der Nutzung des submitInvoices
Betrieb für die Zahlungsabwicklung.
Wenn Sie beginnen, Rechnungen über die API zu versenden, beginnt die parallele Testphase. Während der parallelen Testphase senden Sie Vendor Central- und API-Rechnungen für alle versendeten Bestellungen. Sie müssen parallel testen, bis der Inhalt von mindestens fünf bis zehn Rechnungsdateien validiert ist. Parallele Tests werden mit Produktionsaufträgen und Rechnungen durchgeführt.
Das Team von Amazon Accounts Payable (AP) wird sich mit Ihnen in Verbindung setzen, wenn die parallelen Tests abgeschlossen sind oder wenn Ihre Rechnungen inhaltliche Abweichungen aufweisen.
Wenn Sie eine E-Mail mit dem Hinweis erhalten, dass die parallelen Tests abgeschlossen sind, müssen Sie keine Rechnungen von Vender Central mehr senden. Sie können die API verwenden, um Rechnungen zu senden.
Überprüfung erfolgreich eingereichter Rechnungen
Das API für den Transaktionsstatus zeigt den Status der semantischen Validierungen für eingereichte Rechnungen, aber nicht den tatsächlichen Status der Rechnungsverarbeitung. Sie können den aktuellen Status der ursprünglichen oder aktualisierten Version der Rechnungen überprüfen über Vendor Central > Zahlungen > Rechnungen. Für weitere Informationen zur Verwendung der API für den Transaktionsstatus, Informationen zum Transaktionsstatus finden Sie in der Dokumentation zum Geschäftsanwendungsfall. Wenn die ursprüngliche oder aktualisierte Version mit den richtigen Werten für die aktualisierte Rechnung nach 30 Minuten nicht verfügbar ist, reichen Sie eine Support-Anfrage in Vendor Central ein, indem Sie zu Vendor Central > Support > Contact Us > API Integration.
Das folgende Diagramm zeigt den Integrations-Workflow beim Einreichen einer Rechnung für eine bestätigte und versendete Bestellung.
Geschäftsanforderungen
-
Für Artikel, deren Preis nach Gewicht berechnet wird, müssen Sie Folgendes angeben
totalWeight
Feld. DastotalWeight
Das Feld enthält das Gesamtgewicht des Artikels, der in Rechnung gestellt wird. Zusätzlich gibt esnetCostUnitOfMeasure
Das Feld muss die Maßeinheit für die Artikel angeben, deren Preis Sie nach Gewicht angeben. Die Werte der Maßeinheit umfassenPOUNDS
,OUNCES
,GRAMS
, undKILOGRAMS
. -
Rechnungsnummern müssen eindeutig sein und sollten niemals wiederverwendet werden (auch nicht nach einem Jahr).
-
Wenn eine per API gesendete Rechnung aufgrund falscher Daten fehlschlägt, eine Vendor Central-Rechnung jedoch die richtigen Daten enthält, sollten Sie die Rechnung über die API mit den richtigen Daten aktualisieren, indem Sie dieselben verwenden Invoice ID.
-
Wenn eine Rechnung falsche Daten enthält (sowohl Vendor Central als auch API), wird die Rechnung storniert und eine neue Rechnung sollte mit einer neuen gesendet werden Invoice ID.
-
Eine Rechnung mit einem
total amount = 0
von 0 sollte nicht gesendet werden, da sonst die Rechnung fehlschlagen würde. -
Amazon benötigt aus steuerrechtlichen Gründen die vollständigen Adressdetails in den Adresssegmenten. Dies ist besonders wichtig für bill to party. Für dieses Segment benötigt das Amazon Payee-System eine exakte Übereinstimmung. Die Liste der Adressen finden Sie unter SP-API-Rechnungsadressen an Parteien.
-
Wenn mit der Rechnung Zahlungsbedingungen eingesendet werden, sollten sie den mit dem Amazon-Käufer vereinbarten Zahlungsbedingungen entsprechen.
-
Die Produktkennzeichnung des Artikels muss mit der Produktkennzeichnung des Bestellartikels übereinstimmen, die in der entsprechenden Bestellung an den Anbieter gesendet wurde.
-
Der Gesamtbetrag der Rechnung sollte der Gesamtsumme der Artikel, Gebühren und Zulagen entsprechen.
-
Die Summe des Steuerbetrags der Einzelzeilen muss der Summe des Steuerbetrags auf Kopfzeilenebene entsprechen.
-
Die Gesamtmenge der Rechnung sollte der Gesamtmenge aller Artikel entsprechen.
-
Alle abweichenden Gebühren und Zulagen müssen auf der Kopfzeilenebene einzeln aufgeführt werden (z. B. Frachtgebühr, Paketgebühr, Kleinbestellgebühr usw.)
Warnung
Eine Überweisungsadresse muss mit der Adresse übereinstimmen, die Amazon hinterlegt hat. Wenn die Adresse nicht übereinstimmt, schlägt die Rechnung fehl.
Länderspezifische Geschäftsanforderungen
Funktionalität | Indien | Europa | Nordamerika |
---|---|---|---|
Art der Rechnung | Art der Rechnung CreditNote wird nicht unterstützt. Der Rechnungstyp sollte immer lauten Invoice . |
Arten von Rechnungen Invoice und CreditNote werden unterstützt. Anbieter müssen den Rechnungstyp entsprechend senden. |
Art der Rechnung CreditNote wird nicht unterstützt. Der Rechnungstyp sollte immer lauten Invoice . |
Gutschriften-Referenzen | Nicht verwendet | Anbieter müssen diese Referenzen auf Artikelebene senden, wenn der Rechnungstyp CreditNote . |
Nicht verwendet |
Datum | Muss sein now oder vorher. |
Muss sein now oder vorher. |
Muss sein now oder vorher. |
HSN-Nummer | Der Code des Harmonisierten Nomenklatursystems (HSN) ist für steuerkonforme Rechnungen obligatorisch. Die zulässige Höchstlänge beträgt acht Zeichen. | Nicht verwendet | Nicht verwendet |
Steuerart auf Zeilen- und Kopfebene | Folgendes ist für die Steuerart zulässig:
Wenn keine Steuerinformationen angegeben werden, wird die Rechnung abgelehnt. |
Steuerart, die gesendet werden soll. | Nicht verwendet |
Steuernummer | Eine 15-stellige GST-ID muss angegeben werden. | USt-ID-Nr. | USt-ID-Nr. |
Steuerdetails auf Zeilen- und Kopfzeilenebene | Wenn für einen Artikel mehrere Steuern anfallen, muss der Abschnitt Steuerdetails mehrmals mit der entsprechenden Steuerart für diesen Artikel gesendet werden. Das Gleiche gilt für den Gesamtbetrag der Rechnung. |
Wenn für einen Artikel mehrere Steuern anfallen, muss der Abschnitt Steuerdetails mehrmals mit der entsprechenden Steuerart für diesen Artikel gesendet werden. Das Gleiche gilt für den Gesamtbetrag der Rechnung. Es gibt auch eine zusätzliche Steuerart namens |
Wenn für einen Artikel mehrere Steuern anfallen, muss der Abschnitt Steuerdetails mehrmals mit der entsprechenden Steuerart für diesen Artikel gesendet werden. Das Gleiche gilt für den Gesamtbetrag der Rechnung. |
An die Partei überweisen | Die Partei, die Waren an Amazon liefert und die Zahlung erhält. Wird auch Lieferant genannt. | Steuer- und Adressdaten der Partei (Anbieter), die die Zahlung für die versendeten Artikel (im Falle einer Rechnung) oder die zurückgesandten Artikel (im Falle einer Gutschrift) erhalten wird. Das ist erforderlich. | Steuer- und Adressdaten der Partei (Anbieter), die die Zahlung für die versendeten Artikel erhalten wird. Das ist erforderlich. |
Absenderpartei | Angaben zur Absenderadresse zusammen mit dem ISO-Code des Bundesstaates. Die GST-ID muss in der Steuernummer angegeben werden. Absenderpartei ist erforderlich. Die Werte sollten mit den Werten in den Systemen von Amazon übereinstimmen. |
Händlercode oder Lagercode und Adresse der Stelle, von der die Artikel versendet werden. | Händlercode oder Lagercode und Adresse der Stelle, von der die Artikel versendet werden. |
Empfänger | Angaben zur Lieferadresse zusammen mit dem ISO-Code des Bundesstaates. Empfängerpartei ist erforderlich. Die Werte sollten mit den Werten in den Systemen von Amazon übereinstimmen. |
Amazon-ID oder Lagercode und Adresse der Stelle, an die die Artikel versendet werden. | Amazon-ID oder Lagercode und Adresse der Stelle, an die die Artikel versendet werden. |
Rechnungsempfänger-Partei | Rechnungsempfängerpartei ist erforderlich. Könnte der Empfängerpartei entsprechen. In diesem Fall muss der Anbieter in beiden Segmenten dieselben Informationen senden. | Steuer- und Adressdaten der Partei (Amazon), der die versendeten Artikel (im Falle einer Rechnung) oder die zurückgesendeten Artikel (im Falle einer Gutschrift) in Rechnung gestellt werden. Eine vollständige Liste der Rechnungsadressen von Amazon an Dritte sowie Beispiele für JSON-Codes finden Sie unter SP-API für Rechnungsempfängeradressen. Dieses Feld ist erforderlich. |
Steuer- und Adressdaten der Stelle (Amazon), der die versendeten Artikel in Rechnung gestellt werden. Dieses Feld ist erforderlich. |
Amazon-Produktkennzeichnung und externe Produktkennzeichnung | Mindestens einer dieser Werte ist erforderlich. Die Kennzeichnung muss mit der identisch sein, die in der Bestellung angegebenen wurde. | Mindestens einer dieser Werte ist erforderlich. Die Kennzeichnung muss mit der in der Bestellung identisch sein. | Mindestens einer dieser Werte ist erforderlich. Die Kennzeichnung muss mit der in der Bestellung identisch sein. |
Nettokosten | Dieses Feld ist erforderlich. | Dieses Feld ist erforderlich. | Dieses Feld ist erforderlich. |
Nummer der Bestellung | Eine Rechnung kann Informationen für nur eine Bestellung enthalten. Daher sollte die Bestellnummer für alle Einzelposten in einer Rechnung identisch sein. Erforderlich. |
Eine Rechnung kann Informationen für mehrere Bestellungen enthalten. Die Bestellnummer sollte für verschiedene Einzelartikel entsprechend gesendet werden. Dieses Feld ist erforderlich wenn der Rechnungstyp ist Invoice und wird nicht verwendet, wenn der Rechnungstyp lautet CreditNote . |
Eine Rechnung kann Informationen für mehrere Bestellungen enthalten. Die Bestellnummer sollte für verschiedene Einzelposten entsprechend gesendet werden. Erforderlich. |
Zusätzliche Angaben | Nicht verwendet | Dieses Feld wird verwendet, wenn der Verkäufer zusätzliche Informationen für besondere Zwecke angeben muss. Beispielsweise muss der Verkäufer bei polnischen Rechnungen mit geteilter Zahlung die Details angeben“mechanizm podzielonej płatności „vom Typ SUR und languageCode “PL “. |
Nicht verwendet |
Referenznummer | Eine eindeutige Rechnungsreferenznummer, die von der indischen Regierung für jede Rechnung generiert wird. Dieses Feld ist nur für Rechnungen in Indien verpflichtend. | Nicht verwendet | Nicht verwendet |
Rechnungsempfängeradressen
Wenn Sie eine Rechnung einreichen, müssen die Adressdaten der Rechnung an die Partei vollständig und korrekt formatiert sein. Andernfalls schlägt der API-Aufruf fehl. Wenn Sie die Amazon-Steuernummer für eine Rechnung an den Standort nicht kennen, lesen Sie die Vendor Central Hilfeseiten.
Eine vollständige Liste der Rechnungsadressen und JSON-Codebeispiele von Amazon finden Sie unter SP-API-Rechnung an Partyadressen. Sie finden diese Liste, einschließlich der Steuernummern von Amazon, auch auf der Hilfeseite zu EDI-Ressourcen in Ihrem Vendor Central-Konto.
Gutschrift
Sie können das verwenden API für Lieferantenrechnungen um Gutschriften an Amazon zu senden. In einer Gutschrift sind die Produkte, Mengen und vereinbarten Preise für Produkte oder Dienstleistungen aufgeführt, die Sie Amazon bereitgestellt haben, die Amazon jedoch zurückgegeben oder nicht erhalten hat. Bei beschädigten Waren oder Preisfehlern kann eine Gutschrift ausgestellt werden, wenn zuvor zwischen Amazon und dem Verkäufer Preisnachlässe oder Rabatte vereinbart wurden.
Von Amazon unterstützte Gutschriften
GUTSCHRIFTEN FÜR Kreditoren | GUTSCHRIFTEN FÜR Debitoren |
---|---|
PPV-Kredit
Gutschrift für Artikel, die in Rechnung gestellt, aber nicht erhalten wurden, oder Gutschrift für doppelte Zahlungen. |
Retouren
Gutschrift für Artikel, die an den Verkäufer zurückgesendet wurden, z. B. aufgrund beschädigter Waren, falsch versendeter Waren und Überbestände. |
PPV-Kredit
Gutschrift für Artikel, die zu höheren/niedrigeren Kosten in Rechnung gestellt wurden. |
COOP (zum Beispiel Preisschutz, Schadenersatz)
COOP-Gutschriften, die der Anbieter an Amazon für den Verkauf seines Produkts oder für eine Preisschutzvereinbarung gezahlt hat. |
Hinweis
Gutschriften werden nicht an allen Standorten unterstützt.
submitInvoices
Klasse
submitInvoices
KlasseRechnung mit mehreren Artikeln ohne Steuern
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "I5599913",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"address": {
"name": "VENDORNAME",
"addressLine1": "PO BOX 1234",
"city": "SAN RAFAEL",
"stateOrRegion": "CA",
"postalOrZipCode": "60693",
"countryCode": "US"
}
},
"shipToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON.COM",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"city": "LEWISBERRY",
"stateOrRegion": "PA",
"postalOrZipCode": "17339",
"countryCode": "US"
}
},
"billToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON.COM",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"addressLine3": "string",
"city": "LEWISBERRY",
"stateOrRegion": "PA",
"postalOrZipCode": "17339",
"countryCode": "US"
}
},
"paymentTerms": {
"type": "Basic",
"discountPercent": "2.00",
"discountDueDays": 30,
"netDueDays": 31
},
"invoiceTotal": {
"currencyCode": "USD",
"amount": "1295"
},
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "040YP0U",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "USD",
"amount": "140"
},
"purchaseOrderNumber": "S8672793"
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "0264CBS",
"invoicedQuantity": {
"amount": 5,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "USD",
"amount": "125"
},
"purchaseOrderNumber": "S8672793"
},
{
"itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436",
"vendorProductIdentifier": "040YP0K",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "130"
},
"purchaseOrderNumber": "S8672793"
}
]
}
]
}
Rechnung mit Einzelsteuer für einen Artikel
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "5002841638",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"address": {
"name": "VENDORNAME",
"addressLine1": "PO BOX 1234",
"city": "TORONTO",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONCA",
"address": {
"name": "AMAZON CANADA",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"city": "MISSISSAUGA",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
}
},
"billToParty": {
"partyId": "AMAZONCA",
"address": {
"name": "AMAZON CANADA",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"addressLine3": "string",
"city": "MISSISSAUGA",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"type": "Basic",
"netDueDays": 31
},
"invoiceTotal": {
"currencyCode": "CAD",
"amount": "1950"
},
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "97.5"
},
"taxableAmount": {
"currencyCode": "CAD",
"amount": "1950"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "1012380100000",
"invoicedQuantity": {
"amount": 4,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "1.00"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "1000570100000",
"invoicedQuantity": {
"amount": 30,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "50.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "2.50"
}
}
]
},
{
"itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436",
"vendorProductIdentifier": "0543900100000",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "90"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "4.50"
}
}
]
},
{
"itemSequenceNumber": 4,
"amazonProductIdentifier": "ABC123437",
"vendorProductIdentifier": "1000570200000",
"invoicedQuantity": {
"amount": 5,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "1.00"
}
}
]
}
]
}
]
}
Rechnung mit mehreren Steuern auf einen Artikel
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "8900000001234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ123",
"address": {
"name": "XYZ INDIA PRIVATE LIMITED",
"addressLine1": "4TH FLOOR",
"city": "GURUGRAM",
"stateOrRegion": "HR",
"postalOrZipCode": "122002",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ123",
"address": {
"name": "XYZ RETAIL PVT LTD",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"postalOrZipCode": "700016",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Arrjaw Industrial & Warehouse Park",
"addressLine2": "Near Coal India Complex",
"city": "Hooghly",
"stateOrRegion": "WB",
"postalOrZipCode": "712310",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"type": "Basic",
"netDueDays": 30
},
"invoiceTotal": {
"currencyCode": "INR",
"amount": "258262.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809000-0000",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.90",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.91",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
}
]
}
]
}
]
}
Rechnung mit Angaben zu Zulagen/Gebühren und Steuern auf Kopfebene und Positionsebene
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "0136981234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ12345",
"address": {
"name": "XYZ INDIA PRIVATE LIMITED",
"addressLine1": "4TH FLOOR",
"city": "GURUGRAM",
"stateOrRegion": "HR",
"postalOrZipCode": "122002",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORVATID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ12345",
"address": {
"name": "XYZ RETAIL PVT LTD",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"postalOrZipCode": "700016",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Arrjaw Industrial & Warehouse Park",
"addressLine2": "Near Coal India Complex",
"city": "Hooghly",
"stateOrRegion": "WB",
"postalOrZipCode": "712310",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONVATID"
}
]
},
"paymentTerms": {
"type": "Basic",
"discountPercent": "5",
"discountDueDays": 15,
"netDueDays": 30
},
"invoiceTotal": {
"currencyCode": "INR",
"amount": "259678.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "1200.00"
},
"taxDetails": [
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"amount": "string"
}
},
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"amount": "string"
}
}
]
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809281-5100",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.93",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "600.00"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "600.00"
}
}
]
}
]
}
]
}
EU-Gutschrift mit Steuern
{
"invoices": [
{
"invoiceType": "CreditNote",
"id": "BasicCredit",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON EU SARL, UK BRANCH",
"addressLine1": "1 PRINCIPAL PLACE WORSHIP STREET",
"city": "LONDON",
"postalOrZipCode": "EC2A 2FA",
"countryCode": "GB"
}
},
"billToParty": {
"partyId": "VendorCode",
"address": {
"name": "Vendor Name",
"addressLine1": "Vendor Address",
"city": "Vendor City",
"stateOrRegion": "Vendor State",
"postalOrZipCode": "Vendor ZIP Code",
"countryCode": "Vendor Country"
}
},
"invoiceTotal": {
"currencyCode": "GBP",
"amount": "100"
},
"taxDetails": [
{
"taxType": "VAT",
"taxRate": "10",
"taxAmount": {
"currencyCode": "GBP",
"amount": "10.00"
},
"taxableAmount": {
"currencyCode": "GBP",
"amount": "100.00"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "TESTSKU",
"invoicedQuantity": {
"amount": 1,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "GBP",
"amount": "100"
},
"creditNoteDetails": {
"referenceInvoiceNumber": "test-basic-ref",
"debitNoteNumber": "debit-ref",
"returnsReferenceNumber": "return-ref",
"goodsReturnDate": "2019-07-24T21:17:59.821Z",
"rmaId": "rma-ref",
"consignorsReferenceNumber": "VRET-ref"
}
}
]
}
]
}
Was ist die API für den Anbietertransaktionsstatus?
Sie können das verwenden API für den Transaktionsstatus des Anbieters um den Transaktionsstatus Ihrer POST-Transaktionen zu überprüfen.
Die folgenden Vorgänge sind enthalten:
.Vorgang | HTTP-Methode | Path | Beschreibung | |
---|---|---|---|---|
getTransaction | GET | /vendor/transactions/v1/transactionStatus/{transactionId} | Ruft den Status einer Anfrage nach einer Transaktion ab. | Gibt eine Bestellung zurück, basierend auf dem Wert purchaseOrderNumber , den Sie angeben. Der Status von Transaktionen kann bis zu vier Monate nach dem Datum des ursprünglichen POST-Aufrufs auf Daten überprüft werden |
Transaktionsstatus abrufen
Anbieter können diese API verwenden, um den Status einer POST-Transaktion zu überprüfen. Wenn eine Transaktion wie eine Bestellbestätigung oder eine Versandbestätigung über eine API an Amazon gesendet wird, enthält die Antwort eine Transaktions-ID, die die Transaktion eindeutig identifiziert. Amazon verarbeitet die Transaktion asynchron und die endgültige Antwort ist über den Vorgang getTransaction
verfügbar. In den entsprechenden Integrations-Workflow-Diagrammen in den einzelnen API-Abschnitten (z. B. Anbieterbestellungen und Anbieterlieferungen) können Sie nachlesen, wann Sie diese API aufrufen müssen, um den Transaktionsstatus abzurufen.
Amazon bietet den endgültigen Bearbeitungsstatus für POST-API-Transaktionen wie Auftragsbestätigung und Versandbestätigung über diese API an. Wir empfehlen Anbietern dringend, den Status mithilfe dieser API zu überprüfen, um sicherzustellen, dass ihre Transaktionen erfolgreich verarbeitet wurden. Tritt ein Fehler auf, enthält die Antwort Fehlerinformationen. Sie können die Transaktion dann korrigieren und erneut einreichen.
Transaktionsstatus | Definition |
---|---|
In Bearbeitung | Die API-Transaktion wurde von Amazon empfangen und wird bearbeitet. Die Verarbeitung ist noch nicht abgeschlossen. Überprüfen Sie die SLA für jeden API-Vorgang auf die erwartete Zeit bis zum Abschluss der Verarbeitung. |
Erfolg | Dieser Status wird nur für „Versandbestätigungen senden“ und „Sendung senden“ nur in NA und der EU unterstützt. Erfolg wird nicht unterstützt für submitAcknowledgement und submitInvoices Operationen. |
Fehler | Die API-Transaktion ist während der Verarbeitung fehlgeschlagen. Die Fehlerdetails werden im Antworttext zum Transaktionsstatus bereitgestellt. |
Hinweis
Der Transaktionsstatus wird für die folgenden API-Operationen unterstützt:
Der Transaktionsstatus unterstützt nur die Processing
und Failure
Status-Werte. Wenn der Transaktionsstatus lautet Processing
, und nicht aktualisiert auf Failure
nach 15 Minuten, das bedeutet, dass die Transaktion in unseren Systemen erfolgreich verarbeitet wurde.
Eine Transaktion gilt in der Regel als erfolgreich auf unserer Seite abgeschlossen, wenn der Status Processing
. Wenn aus irgendeinem Grund Vendor Central Der Status wird nicht innerhalb von 30 Minuten nach dem Senden der Nachricht aktualisiert. Öffnen Sie eine Support-Anfrage mit Vendor Central durch Angabe der Transaktions-ID, die im POST-Aufruf zurückgegeben wurde. Stellen Sie sicher, dass die übermittelten Daten das richtige Format haben, bevor Sie den Fall öffnen.
Sie können diese API nicht verwenden für Invoice
Nachrichten, da sie nicht unterstützt werden und der Status immer angezeigt wird Processing
. Checken Sie bei Fragen zur Zahlung zuerst ein Vendor Central, und erstellen Sie dann eine Contact Us Fall in Vendor Central und wählen Sie die entsprechende Warteschlange aus.
Anwendungsfälle für den Transaktionsstatus
Die Transaktion befindet sich in Bearbeitung
{
"payload": {
"transactionStatus": {
"transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477",
"status": "Processing"
}
}
}
Die Transaktion wurde erfolgreich verarbeitet
Die Transaktion befindet sich nach der Veröffentlichung 15 Minuten lang im Bearbeitungsstatus.
{
"payload": {
"transactionStatus": {
"transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477",
"status": "Processing"
}
}
}
Die Transaktion ist bei Amazon fehlgeschlagen
{
"payload": {
"transactionStatus": {
"transactionId": "20190908091302-6ca0ac50-d06e-45f5-a1e2-eb448eadac50",
"status": "Failure",
"errors": [
{
"code": "INVALID_ORDER_ID",
"message": "Invalid order ID."
}
]
}
}
}
Updated 23 days ago