Zum Inhalt

Amazon-Benachrichtigungs-API

Amazon-Benachrichtigungs-API ist die API-Seite, über die Push-Benachrichtigungen von Amazon in Business Central ankommen, etwa zu neuen oder stornierten Aufträgen. Sie hat keine Oberfläche: Aufgerufen wird sie von einer Weiterleitung, die Amazons Benachrichtigungen an Ihr Business Central übergibt.

Push-Benachrichtigungen sind eine Ergänzung. Ohne sie holt der Auftragsimport Aufträge und Stornierungen zu festen Zeiten ab; dafür ist nichts weiter einzurichten.

Einrichtung

Push-Benachrichtigungen richtet der ALTENBRAND-Support für Ihr Unternehmen ein. Der Connector selbst legt bei Amazon weder Ziele (Destinations) noch Abonnements (Subscriptions) an und ruft Amazons Notifications API nicht auf: Ein Ziel gehört bei Amazon der ganzen Anwendung und damit allen Kunden, nicht einem einzelnen Mandanten.

Ihr Teil: Hinterlegen Sie in den Amazon-Einstellungen den Benachrichtigungs-API-Schlüssel, den Sie mit dem Support vereinbart haben. Jede Benachrichtigung muss ihn mitbringen. Der Schlüssel gilt für alle Unternehmen der Umgebung.

Aufruf

https://api.businesscentral.dynamics.com/v2.0/<Mandant>/<Umgebung>/api/altenbrand/amazoncloud/v1.0/companies(<Unternehmens-ID>)/amazonNotifications

Angenommen wird nur POST. Ändern und Löschen lehnt die Seite ab.

Felder

Feld Beschreibung
notificationType Typ der Benachrichtigung, z. B. ORDER_CHANGE. Eingetragen wird der Typ, der in der Nutzlast steht.
notificationPayload Die Benachrichtigung von Amazon als JSON-Text.
apiKey Der Benachrichtigungs-API-Schlüssel. Er wird geprüft, aber nicht gespeichert.
id Kennung des Eintrags im Benachrichtigungsprotokoll (nur lesen).
status Ergebnis der Verarbeitung: Processed, Failed oder Ignored, wenn die Benachrichtigung vom Connector nichts verlangt, etwa weil dieselbe Benachrichtigung schon einmal angekommen ist (nur lesen).
processedAt Zeitpunkt der Verarbeitung (nur lesen).

Die Antwort auf den POST gibt apiKey und notificationPayload leer zurück. Einen Fehlertext enthält sie nicht: Er kann den Käufer nennen und steht nur im Amazon-Benachrichtigungsprotokoll in Business Central. Der Weiterleitung genügt status Failed.

Verarbeitung

  1. Zuerst prüft die Seite den Schlüssel. Fehlt er, ist in Business Central keiner hinterlegt oder stimmt er nicht, endet der Aufruf mit einem Fehler: Nichts wird verarbeitet, nichts gespeichert, und Amazon wird nicht aufgerufen.
  2. Dann prüft sie, ob die Benachrichtigung schon einmal angekommen ist: Amazon kann dieselbe Benachrichtigung mehr als einmal zustellen. Steht ihre Benachrichtigungs-ID schon im Amazon-Benachrichtigungsprotokoll, verarbeitet die Seite sie nicht noch einmal; der neue Eintrag erhält den Status Ignoriert mit dem Grund, dass Amazon sie erneut zugestellt hat.
  3. Danach verarbeitet sie die Benachrichtigung in einem eigenen Fehlerbereich. Scheitert die Verarbeitung, wird zurückgenommen, was sie begonnen hat.
  4. Zuletzt schreibt sie einen Eintrag in das Amazon-Benachrichtigungsprotokoll: Typ, Benachrichtigungs-ID, je nach Typ Amazon-Auftrags-ID, SKU und ASIN und das Ergebnis – Verarbeitet, Fehlgeschlagen mit dem Grund des Fehlers oder Ignoriert mit dem Grund, wenn die Benachrichtigung nichts verlangte. Die Nutzlast behält nur ein fehlgeschlagener Eintrag, damit er sich mit Erneut verarbeiten erneut verarbeiten lässt.
Benachrichtigung Verarbeitung
ORDER_CHANGE Status Unshipped: Import eines selbst versendeten Auftrags. Shipped: Import eines FBA-Auftrags. Canceled: Stornierung über die Auftragsstornierungen des Hubs. Es gelten dieselben Regeln wie beim Auftragsimport.
FEED_PROCESSING_FINISHED Auswertung des Feeds im Amazon-Feed-Tracker.
LISTINGS_ITEM_STATUS_CHANGE Angebotsstatus des Amazon-Artikels mit dieser SKU, nur auf dem Marktplatz der Benachrichtigung (siehe unten).
ANY_OFFER_CHANGED, B2B_ANY_OFFER_CHANGED Markt- und BuyBox-Daten; der niedrigste Preis anderer Verkäufer geht als Wettbewerbspreis an den Hub (siehe Preise und Angebote).
REPORT_PROCESSING_FINISHED nur ein Protokolleintrag (Verarbeitet)
andere Typen, etwa Bestandsänderungen werden nicht verarbeitet: Ignoriert mit dem Grund, dass der Connector Benachrichtigungen dieses Typs nicht verarbeitet

Angebotsstatusänderungen

Eine Benachrichtigung LISTINGS_ITEM_STATUS_CHANGE nennt Verkäufer, Marktplatz, SKU, ASIN und die Liste der Status, die Amazon dem Angebot gerade gibt. Der Connector macht daraus einen Status: BUYABLE, wenn es an beliebiger Stelle steht, sonst den ersten Eintrag; eine fehlende oder leere Liste zählt als NOT_PUBLISHED – das Angebot ist da, aber weder kaufbar noch auffindbar. Diesen Status übernimmt er nach denselben Regeln wie Angebotsstatus aktualisieren auf der Amazon-Artikelkarte:

Status bei Amazon Angebotsstatus
BUYABLE oder DISCOVERABLE Aktiv
SUPPRESSED Unterdrückt
INCOMPLETE Unvollständig
DELETED oder BLOCKED Gesperrt
NOT_PUBLISHED und unbekannte Status Inaktiv

Ein mit Angebot schließen geschlossenes Angebot bleibt Geschlossen, außer Amazon meldet es als kaufbar (BUYABLE): Dann hat das Schließen nicht gegriffen, und es wird Aktiv. Wartet eine Änderung von Angebot schließen oder Angebot reaktivieren noch auf ihren Feed, bleibt der Status, bis der Feed verarbeitet ist. Geändert wird nur der Amazon-Artikel mit dieser SKU auf dem Marktplatz der Benachrichtigung – dieselbe SKU in anderen Ländern und in anderen Verkaufskanälen bleibt, wie sie ist. Hat der Amazon-Artikel keine eigene SKU, findet ihn der Connector über die Artikelnummer. Die ASIN der Benachrichtigung übernimmt er in den Amazon-Artikel; wartende Einträge des Artikels in der Amazon-ASIN-Suchwarteschlange stehen danach auf Ignoriert.

Übersprungen werden Benachrichtigungen eines anderen Verkäufers (die Seller ID ist nicht die Händler-ID in den Amazon-Einstellungen), Benachrichtigungen für einen Marktplatz, für den es keine Marktplatzteilnahme gibt (siehe Amazon-Marktplatzteilnahmen), und Benachrichtigungen ohne SKU. Sie ändern nichts; im Protokoll stehen sie als Ignoriert mit dem Grund in Fehlermeldung.

Tipps

Benachrichtigungen ergänzen den Auftragsimport

Lassen Sie den Job ORDERS auch mit Push-Benachrichtigungen weiterlaufen. Einen Auftrag, den der Hub bereits kennt, ruft der Connector bei einer Benachrichtigung nicht erneut bei Amazon ab.

Schlüssel ändern

Ändern Sie den Benachrichtigungs-API-Schlüssel nur zusammen mit dem ALTENBRAND-Support. Bis die Weiterleitung den neuen Schlüssel verwendet, lehnt die Seite jede Benachrichtigung ab.