Allgemeine Herausforderungen und bewährte Verfahren
In diesem Abschnitt beleuchten wir einige der häufigsten Herausforderungen, mit denen Entwickler bei der Erstellung von Connector-Integrationen für Multi-Channel-Versand konfrontiert sind, und erläutern einige der bewährten Verfahren, die Ihnen bei der Bewältigung dieser Herausforderungen helfen können.
Updates zum Bestellstatus erhalten
Häufige Herausforderung: Entwickler haben manchmal Schwierigkeiten, Benachrichtigungen für alle Aktualisierungen des Bestellstatus zu lesen.
Empfohlene Vorgehensweisen: Verwenden Sie eine der beiden folgenden Methoden, um Aktualisierungen des Bestellstatus abzurufen:
1. Rufen Sie die API auf: Rufen Sie regelmäßig die getOrder-API auf, um den Bestellstatus zu aktualisieren, bis der Terminalstatus [Abgeschlossen, Teilweise abgeschlossen, Storniert, Nicht verkaufbar] für die Bestellung erreicht ist. Details zur Sendungsverfolgung werden in der Antwort veröffentlicht, wenn sie verfügbar sind. Dies kann im Status "In Bearbeitung", "Abgeschlossen" und "Teilweise abgeschlossen" sein.
2. Benachrichtigungen abonnieren: Indem Sie Benachrichtigungen abonnieren und auf das Ereignis FULFILLMENT_ORDER_STATUS achten. Jedes Mal, wenn sich der Bestellstatus ändert oder eine Nummer zur Sendungsverfolgung generiert wird, wird eine Benachrichtigung ausgegeben, die aus einer SQS-Warteschlange gelesen werden muss.
API-Aufrufe sind ein Abruf-Mechanismus und Entwickler sind sich der Häufigkeit von API-Aufrufen möglicherweise nicht bewusst. Es wird empfohlen, Benachrichtigungen zu lesen und die getOrder-API für vollständige Bestelldetails erst aufzurufen, nachdem die Bestellung abgeschlossen ist.
Wenn Sie diesem Ansatz folgen, profitieren Sie von folgenden Vorteilen:
• Reduzieren der Bandbreite, die für den häufigen Aufruf von APIs erforderlich ist.
• Frühzeitige Kenntnis von Details zur Sendungsverfolgung.
• Erhalt von Benachrichtigungen in Echtzeit, da API-Aufrufe zu Verzögerungen führen können.
• Erhalt von Benachrichtigungen über Aktualisierungen der Nummer zur Sendungsverfolgung, falls vorhanden.
Empfohlene Vorgehensweisen: Verwenden Sie eine der beiden folgenden Methoden, um Aktualisierungen des Bestellstatus abzurufen:
1. Rufen Sie die API auf: Rufen Sie regelmäßig die getOrder-API auf, um den Bestellstatus zu aktualisieren, bis der Terminalstatus [Abgeschlossen, Teilweise abgeschlossen, Storniert, Nicht verkaufbar] für die Bestellung erreicht ist. Details zur Sendungsverfolgung werden in der Antwort veröffentlicht, wenn sie verfügbar sind. Dies kann im Status "In Bearbeitung", "Abgeschlossen" und "Teilweise abgeschlossen" sein.
2. Benachrichtigungen abonnieren: Indem Sie Benachrichtigungen abonnieren und auf das Ereignis FULFILLMENT_ORDER_STATUS achten. Jedes Mal, wenn sich der Bestellstatus ändert oder eine Nummer zur Sendungsverfolgung generiert wird, wird eine Benachrichtigung ausgegeben, die aus einer SQS-Warteschlange gelesen werden muss.
API-Aufrufe sind ein Abruf-Mechanismus und Entwickler sind sich der Häufigkeit von API-Aufrufen möglicherweise nicht bewusst. Es wird empfohlen, Benachrichtigungen zu lesen und die getOrder-API für vollständige Bestelldetails erst aufzurufen, nachdem die Bestellung abgeschlossen ist.
Wenn Sie diesem Ansatz folgen, profitieren Sie von folgenden Vorteilen:
• Reduzieren der Bandbreite, die für den häufigen Aufruf von APIs erforderlich ist.
• Frühzeitige Kenntnis von Details zur Sendungsverfolgung.
• Erhalt von Benachrichtigungen in Echtzeit, da API-Aufrufe zu Verzögerungen führen können.
• Erhalt von Benachrichtigungen über Aktualisierungen der Nummer zur Sendungsverfolgung, falls vorhanden.
Lagerbestand synchronisieren
Häufige Herausforderung: Entwickler haben den Lagerbestandswert in der Lagerbestandsmeldung falsch verstanden oder wissen nicht, wie der Lagerbestand richtig synchronisiert wird, was zu Überverkäufen und Fehlbeständen oder überschüssigem Lagerbestand führen kann.
Empfohlene Vorgehensweisen: Wir empfehlen, den Benachrichtigungstyp FBA_INVENTORY_AVAILABILITY_CHANGES zu abonnieren, der eine Echtzeitsynchronisierung mit dem Amazon-Lagerbestand ermöglicht und alle Lagerbestandsänderungen widerspiegelt. Um zu vermeiden, dass Benachrichtigungen verpasst werden, sollten Entwickler die getInventorySummaries-API einmal täglich aufrufen, um einen vollständigen Überblick über die Lagerbestandsbestände zu erhalten.
Das mehrmalige Aufrufen der GetInventorySummaries-API am Tag kann zu veralteten Daten zwischen API-Aufrufen führen und wird nicht empfohlen.
Für Entwickler, die nur API verwenden, empfehlen wir:
• Verwaltung Ihrer eigenen, internen Lagerbestandsaufzeichnungen, basierend auf aufgegebenen und stornierten Bestellungen. Dann können Sie diesen Datensatz während der Lagerbestandssynchronisierung überschreiben, die ein- oder zweimal täglich durchgeführt werden kann.
• Verwenden Sie einige Einstellungen für den Sicherheitsbestand, damit es nicht zu Überverkäufen zwischen den einzelnen Jobs zur Lagerbestandssynchronisierung kommt.
Wenn Sie nur an IN-HAND-Lagerbestand interessiert sind (der sich in den Amazon-Logistikzentren befindet), sollten Entwickler in der Antwort nach inventorySummaries.Fulfillable suchen.
Für Entwickler, die daran interessiert sind, die Artikel zu berücksichtigen, die IN-TRANSIT/INBOUND sind, addieren Sie: [inventoryDetails.Fulfillable + inventoryDetails.inboundWorkingQuantity+inventoryDetails.inboundShippedQuantity+inventoryDetails.inboundReceivingQuantity].
Hinweis: INTRANSIT/INBOUND Lagerbestand hat möglicherweise ein längeres voraussichtliches Ankunftsdatum als Lagerbestand IN-HAND.
Empfohlene Vorgehensweisen: Wir empfehlen, den Benachrichtigungstyp FBA_INVENTORY_AVAILABILITY_CHANGES zu abonnieren, der eine Echtzeitsynchronisierung mit dem Amazon-Lagerbestand ermöglicht und alle Lagerbestandsänderungen widerspiegelt. Um zu vermeiden, dass Benachrichtigungen verpasst werden, sollten Entwickler die getInventorySummaries-API einmal täglich aufrufen, um einen vollständigen Überblick über die Lagerbestandsbestände zu erhalten.
Das mehrmalige Aufrufen der GetInventorySummaries-API am Tag kann zu veralteten Daten zwischen API-Aufrufen führen und wird nicht empfohlen.
Für Entwickler, die nur API verwenden, empfehlen wir:
• Verwaltung Ihrer eigenen, internen Lagerbestandsaufzeichnungen, basierend auf aufgegebenen und stornierten Bestellungen. Dann können Sie diesen Datensatz während der Lagerbestandssynchronisierung überschreiben, die ein- oder zweimal täglich durchgeführt werden kann.
• Verwenden Sie einige Einstellungen für den Sicherheitsbestand, damit es nicht zu Überverkäufen zwischen den einzelnen Jobs zur Lagerbestandssynchronisierung kommt.
Wenn Sie nur an IN-HAND-Lagerbestand interessiert sind (der sich in den Amazon-Logistikzentren befindet), sollten Entwickler in der Antwort nach inventorySummaries.Fulfillable suchen.
Für Entwickler, die daran interessiert sind, die Artikel zu berücksichtigen, die IN-TRANSIT/INBOUND sind, addieren Sie: [inventoryDetails.Fulfillable + inventoryDetails.inboundWorkingQuantity+inventoryDetails.inboundShippedQuantity+inventoryDetails.inboundReceivingQuantity].
Hinweis: INTRANSIT/INBOUND Lagerbestand hat möglicherweise ein längeres voraussichtliches Ankunftsdatum als Lagerbestand IN-HAND.
Zugriff auf frühe Informationen zur Sendungsverfolgung
Häufige Herausforderung: Nummern zur Sendungsverfolgung sind jetzt verfügbar, ohne dass die Bestellung den Status Versand abgeschlossen hat.
Empfohlene Vorgehensweisen: Entwickler, die die GetOrder-API aufrufen, sollten nicht davon ausgehen, dass Details zur Sendungsverfolgung nur verfügbar sind, wenn sich die Bestellung im Status Abgeschlossen oder Teilweise abgeschlossen befindet. Die Details zur Sendungsverfolgung sind jetzt verfügbar, wenn sich die Bestellung in der Bearbeitungsphase befindet.
Für Entwickler, die Bestellbenachrichtigungen abrufen, wird explizit eine Benachrichtigung mit Informationen zur frühen Sendungsverfolgung ausgegeben. Der Bestellstatus lautet In Bearbeitung und enthält den Transportdienst, die Paketnummer und die Sendungsverfolgungsnummer.
Oft markieren Entwickler, die die GetOrder-API aufrufen, ihre Bestellung als Versendet, nachdem sie die Informationen zur Sendungsverfolgung abgerufen haben. Es kann jedoch immer vorkommen, dass die Details zur Sendungsverfolgung aktualisiert werden, wenn Re-SLAMs (Änderungen) in einem Logistikzentrum vorgenommen werden. Wenn Sie die Bestellungen als Versendet markieren, werden Sie nicht über Aktualisierungen informiert und es werden ungültige Details zur Sendungsverfolgung angezeigt.
Lesen Sie unbedingt die FULFILLMENT_ORDER_STATUS-Benachrichtigungen, in denen ein Ereignis für frühzeitige Details zur Sendungsverfolgung und auch für etwaige Aktualisierungen der Details zur Sendungsverfolgung gesendet wird. Dieser Ansatz stellt sicher, dass Verkäufer immer die richtigen Details zur Sendungsverfolgung für Bestellungen haben.
Empfohlene Vorgehensweisen: Entwickler, die die GetOrder-API aufrufen, sollten nicht davon ausgehen, dass Details zur Sendungsverfolgung nur verfügbar sind, wenn sich die Bestellung im Status Abgeschlossen oder Teilweise abgeschlossen befindet. Die Details zur Sendungsverfolgung sind jetzt verfügbar, wenn sich die Bestellung in der Bearbeitungsphase befindet.
Für Entwickler, die Bestellbenachrichtigungen abrufen, wird explizit eine Benachrichtigung mit Informationen zur frühen Sendungsverfolgung ausgegeben. Der Bestellstatus lautet In Bearbeitung und enthält den Transportdienst, die Paketnummer und die Sendungsverfolgungsnummer.
Oft markieren Entwickler, die die GetOrder-API aufrufen, ihre Bestellung als Versendet, nachdem sie die Informationen zur Sendungsverfolgung abgerufen haben. Es kann jedoch immer vorkommen, dass die Details zur Sendungsverfolgung aktualisiert werden, wenn Re-SLAMs (Änderungen) in einem Logistikzentrum vorgenommen werden. Wenn Sie die Bestellungen als Versendet markieren, werden Sie nicht über Aktualisierungen informiert und es werden ungültige Details zur Sendungsverfolgung angezeigt.
Lesen Sie unbedingt die FULFILLMENT_ORDER_STATUS-Benachrichtigungen, in denen ein Ereignis für frühzeitige Details zur Sendungsverfolgung und auch für etwaige Aktualisierungen der Details zur Sendungsverfolgung gesendet wird. Dieser Ansatz stellt sicher, dass Verkäufer immer die richtigen Details zur Sendungsverfolgung für Bestellungen haben.
Verwenden Sie die Funktionen "Unbeschrifteter Karton" und "Amazon Logistics blockieren"
Häufige Herausforderung: Entwickler wissen nicht, wie sie die Funktionen "Unbeschrifteter Karton" und "Amazon Logistics blockieren" konfigurieren sollen.
Empfohlene Vorgehensweisen: Multi-Channel-Versand liefert die meisten Bestellungen in unbeschrifteten Verpackungen innerhalb der US-Region aus. Einige Verkäufer verlangen jedoch möglicherweise, dass alle Bestellungen in unbeschrifteten Kartons geliefert werden.
Kartons ohne Markenbezeichnung (unbeschrifteter Karton oder BB (Blank Box)):
1. Verwenden Sie eine Markierung auf SKU-Ebene, um Verpackungen ohne Markenbezeichnung als SKUs in unbeschrifteten Kartons als BB zu kennzeichnen. Sie können Ihre Produkte, für die unbeschriftete Kartons möglich sind, anzeigen, indem Sie die getFeatureInventory-API aufrufen.
2. Achten Sie bei SKUs mit BB darauf, sowohl markenlose Verpackungen (unbeschriftete Kartons oder BB) als auch den regulären Lagerbestand nachzuverfolgen.
3. Stellen Sie den Schalter auf Vertriebskanal-Ebene ein und stellen Sie sicher, dass für die erforderlichen Vertriebskanäle immer der BB-Lagerbestand angezeigt wird. Erstellen Sie BB-Bestellungen und leiten Sie den BB-Lagerbestand an diese Vertriebskanäle weiter.
4. Rufen Sie auf der Ebene, auf der Bestellungen bearbeitet werden, die Operationen PREVIEW Order und CREATE Order mit der Funktionseinschränkung Blank_Box=Required auf, um sicherzustellen, dass Artikel nur in unbeschrifteten Kartons geliefert werden.
Amazon Logistics blockieren (AMZL oder BAMZL blockieren):
Seller Central und das Lieferketten-Portal bieten jeweils die Einstellung "AMZL blockieren" auf Marketplace-Site-Ebene eines Verkäuferkontos, die für alle Bestellungen aktiviert werden kann und mit einem Aufpreis von 5 % verbunden ist. Entwickler, die "AMZL blockieren" für bestimmte Bestellungen benötigen, können die folgenden Konfigurationsschritte verwenden:
1. Stellen Sie den Schalter auf Vertriebskanal-Ebene ein, um sicherzustellen, dass die Bestellungen der erforderlichen Vertriebskanäle nicht von Amazon Logistics geliefert werden. Erstellen Sie BAMZL-Bestellungen für diese Kanäle.
2. Rufen Sie auf der Ebene zur Bearbeitung der Bestellung die Operationen PREVIEW Order und CREATE Order mit der Funktionseinschränkung Block_AMZL=Required auf, um sicherzustellen, dass ein anderer Transportdienst als Amazon Logistics die Artikel versendet.
Empfohlene Vorgehensweisen: Multi-Channel-Versand liefert die meisten Bestellungen in unbeschrifteten Verpackungen innerhalb der US-Region aus. Einige Verkäufer verlangen jedoch möglicherweise, dass alle Bestellungen in unbeschrifteten Kartons geliefert werden.
Kartons ohne Markenbezeichnung (unbeschrifteter Karton oder BB (Blank Box)):
1. Verwenden Sie eine Markierung auf SKU-Ebene, um Verpackungen ohne Markenbezeichnung als SKUs in unbeschrifteten Kartons als BB zu kennzeichnen. Sie können Ihre Produkte, für die unbeschriftete Kartons möglich sind, anzeigen, indem Sie die getFeatureInventory-API aufrufen.
2. Achten Sie bei SKUs mit BB darauf, sowohl markenlose Verpackungen (unbeschriftete Kartons oder BB) als auch den regulären Lagerbestand nachzuverfolgen.
3. Stellen Sie den Schalter auf Vertriebskanal-Ebene ein und stellen Sie sicher, dass für die erforderlichen Vertriebskanäle immer der BB-Lagerbestand angezeigt wird. Erstellen Sie BB-Bestellungen und leiten Sie den BB-Lagerbestand an diese Vertriebskanäle weiter.
4. Rufen Sie auf der Ebene, auf der Bestellungen bearbeitet werden, die Operationen PREVIEW Order und CREATE Order mit der Funktionseinschränkung Blank_Box=Required auf, um sicherzustellen, dass Artikel nur in unbeschrifteten Kartons geliefert werden.
Amazon Logistics blockieren (AMZL oder BAMZL blockieren):
Seller Central und das Lieferketten-Portal bieten jeweils die Einstellung "AMZL blockieren" auf Marketplace-Site-Ebene eines Verkäuferkontos, die für alle Bestellungen aktiviert werden kann und mit einem Aufpreis von 5 % verbunden ist. Entwickler, die "AMZL blockieren" für bestimmte Bestellungen benötigen, können die folgenden Konfigurationsschritte verwenden:
1. Stellen Sie den Schalter auf Vertriebskanal-Ebene ein, um sicherzustellen, dass die Bestellungen der erforderlichen Vertriebskanäle nicht von Amazon Logistics geliefert werden. Erstellen Sie BAMZL-Bestellungen für diese Kanäle.
2. Rufen Sie auf der Ebene zur Bearbeitung der Bestellung die Operationen PREVIEW Order und CREATE Order mit der Funktionseinschränkung Block_AMZL=Required auf, um sicherzustellen, dass ein anderer Transportdienst als Amazon Logistics die Artikel versendet.
Testen des Autorisierungsablaufs in einer öffentlichen App
Häufige Herausforderung: Entwickler wissen nicht, wie sie ihren Ablauf bei der Verkäuferauthentifizierung testen können, ohne die App in Seller Central zu veröffentlichen oder aufzulisten.
Empfohlene Vorgehensweisen: Entwickler können den Authentifizierungsablauf eines Testverkäuferkontos validieren, ohne die App veröffentlichen zu müssen. Testen Sie Ihren Authentifizierungsablauf, indem Sie zur Genehmigungs-URL in Seller Central "version=beta“" sowohl für den Seller Central-Authentifizierungsablauf als auch für den Store-Authentifizierungsablauf hinzufügen. Hinweis: Im Betamodus können nicht mehr als 25 Verkäufer die App autorisieren, da dies nur zu Validierungszwecken vorgesehen ist.
Beispiel:
https://sellercentral.amazon.com/apps/authorize/consent?application_id=appidexample&state=stateexample&version=beta
Empfohlene Vorgehensweisen: Entwickler können den Authentifizierungsablauf eines Testverkäuferkontos validieren, ohne die App veröffentlichen zu müssen. Testen Sie Ihren Authentifizierungsablauf, indem Sie zur Genehmigungs-URL in Seller Central "version=beta“" sowohl für den Seller Central-Authentifizierungsablauf als auch für den Store-Authentifizierungsablauf hinzufügen. Hinweis: Im Betamodus können nicht mehr als 25 Verkäufer die App autorisieren, da dies nur zu Validierungszwecken vorgesehen ist.
Beispiel:
https://sellercentral.amazon.com/apps/authorize/consent?application_id=appidexample&state=stateexample&version=beta
Extrahieren wichtiger Berichte für Entwickler mit Multi-Channel-Versand
Häufige Herausforderung: Entwickler sind sich der Berichte, die mit unserer Berichte-API extrahiert werden können, nicht bewusst.
Empfohlene Vorgehensweisen: Verwenden Sie die folgenden Anrufinformationen, um die wichtigsten Berichte für Entwickler mit Multi-Channel-Versand zu extrahieren.
Wichtige Berichte für Entwickler mit Multi-Channel-Versand:
• Produktlisting-Berichte: Um die Produktangebotsdaten eines Verkäuferkontos abzurufen.
GET_FLAT_FILE_OPEN_LISTINGS_DATA and GET_MERCHANT_LISTINGS_ALL_DATA
• Lagerbestandsberichte: Um die Lagerbestandsbewegungen in den Amazon-Logistikzentren im Auge zu behalten.
GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA and GET_LEDGER_SUMMARY_VIEW_DATA
• Bestell-/Verkaufsberichte: Um die Bestell- und Versanddaten von Sendungen, die von Amazon versendet wurden, abzurufen.
GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL, GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL, and GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL
Empfohlene Vorgehensweisen: Verwenden Sie die folgenden Anrufinformationen, um die wichtigsten Berichte für Entwickler mit Multi-Channel-Versand zu extrahieren.
Wichtige Berichte für Entwickler mit Multi-Channel-Versand:
• Produktlisting-Berichte: Um die Produktangebotsdaten eines Verkäuferkontos abzurufen.
GET_FLAT_FILE_OPEN_LISTINGS_DATA and GET_MERCHANT_LISTINGS_ALL_DATA
• Lagerbestandsberichte: Um die Lagerbestandsbewegungen in den Amazon-Logistikzentren im Auge zu behalten.
GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA and GET_LEDGER_SUMMARY_VIEW_DATA
• Bestell-/Verkaufsberichte: Um die Bestell- und Versanddaten von Sendungen, die von Amazon versendet wurden, abzurufen.
GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL, GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL, and GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL
Verwaltung der Anmeldeinformationen für den Sandbox-Zugriff
Häufige Herausforderung: Entwickler möchten unterschiedliche App-Anmeldeinformationen für die dynamische Sandbox-Umgebung und die Produktionsumgebung verwalten.
Sowohl für private als auch für öffentliche Apps gibt es die Möglichkeit, den Zugriff auf die dynamische Sandbox-Umgebung zu beschränken. Jede für die Produktion freigegebene App hat Zugriff auf Produktions- und Sandbox-Endpoints, und es gibt keine Möglichkeit, den Zugriff einzuschränken.
Empfohlene Vorgehensweisen: Um das Problem zu lösen, können Entwickler verschiedene private Apps im Entwurfsstatus für die Sandbox- und Produktionsumgebung erstellen und Produkte nur in der Produktion auflisten, wenn sie beabsichtigen, zwei separate Sätze von Client-Anmeldeinformationen zu behalten.
Sowohl für private als auch für öffentliche Apps gibt es die Möglichkeit, den Zugriff auf die dynamische Sandbox-Umgebung zu beschränken. Jede für die Produktion freigegebene App hat Zugriff auf Produktions- und Sandbox-Endpoints, und es gibt keine Möglichkeit, den Zugriff einzuschränken.
Empfohlene Vorgehensweisen: Um das Problem zu lösen, können Entwickler verschiedene private Apps im Entwurfsstatus für die Sandbox- und Produktionsumgebung erstellen und Produkte nur in der Produktion auflisten, wenn sie beabsichtigen, zwei separate Sätze von Client-Anmeldeinformationen zu behalten.
