Definition

Das Nuclet

verbindet Nuclos Handel mit der Amazon Selling Partner API (SP-API).

Es übernimmt zwei zentrale Aufgaben:

1. Bestellimport — Amazon-Bestellungen werden als normale Handel-Aufträge angelegt.
2. Versandmeldung — Beim Versand eines Lieferscheins wird die Sendung an Amazon zurückgemeldet.

Das Nuclet ersetzt keine Handel-Funktionen. Aufträge

, Lieferscheine, Artikel und Kunden kommen aus dem Handelsnuclet — das Amazon-Nuclet dockt nur an.

Abhängigkeit: Nuclet Handel muss installiert und aktiv sein.

Voraussetzungen

Amazon

• SP-API-Anwendung im Seller Central Entwicklerportal

• Client ID, Client Secret, Refresh Token (LWA)

• Berechtigungen für Orders API (Lesen + Versandbestätigung)

• Marketplace-ID (z. B. Deutschland: A1PA6795UKMFR9)

• Nuclet Handel (Auftrag, Lieferschein, Artikel, Kunde)

Überblick

Ablauf im Tagesgeschäft

1. Job importiert neue Amazon-Bestellungen → Handel-Aufträge erscheinen in Nuclos.
2. Auftrag wird wie gewohnt bearbeitet (Kommissionierung, Lieferschein).
3. Sendungsnummer am Lieferschein eintragen.
4. Lieferschein auf Versendet setzen → Versand wird automatisch an Amazon gemeldet.

Integration

Die Integration erfolgt nach dem Nuclet-Import (siehe Nuclet Import).
Das Amazon-Nuclet wird zusätzlich zum Handelsnuclet importiert — nicht in Handel hinein, sondern als eigenes Nuclet mit Abhängigkeit zu Handel.

Nach dem Import Server neu starten oder im Client Regeln aktualisieren.

Test und Produktivbetrieb

Testreihenfolge (Sandbox)

Businessobjekte

Integration

4.1 Nuclet-Import

Amazon-SP-API-Nuclet-Paket auswählen und importieren

AmazonArtikelZuordnung (Pflicht)

Stammdaten

-Tabelle für die Zuordnung von Amazon-Seller-SKUs zu Handel-Artikeln.

Einrichtung:

1. Maske und Berechtigungen konfigurieren
2. Schema generieren
3. Für jeden verkauften Artikel eine Zeile anlegen: Seller-SKU → Handel-Artikel

Wichtig: Ohne Zuordnung legt der Import für unbekannte SKUs automatisch neue Artikel mit dem Präfix AMZ- an. Für den Produktivbetrieb sollten alle relevanten SKUs vorab zugeordnet werden.

Amazon Versandmeldung (optional)

Dient der Nachverfolgung und dem Batch-Job Amazon Versandmeldungen senden. Die Hauptauslösung für Versandmeldungen ist der Lieferschein-Status Versendet.

Anpassungen am Handelsnuclet

Das Amazon-Nuclet nutzt bestehende Handel-Objekte:

Sendungsnummer am Lieferschein

Für die Versandmeldung an Amazon wird eine Sendungsnummer benötigt.

• Feld sendungsnummer am Lieferschein prüfen (ggf. anlegen)
• In die Lieferschein-Maske aufnehmen
• Schema generieren

Versandregel am Lieferschein

Beim Statuswechsel des Lieferscheins auf Versendet wird automatisch die Regel AmazonVersandBeiLieferscheinVersendet ausgeführt.

Im Designer unter Statusmodell Lieferschein prüfen, ob die Regel am Übergang → Versendet zugewiesen ist.

Jobs

Alle Jobs finden Sie unter Administration → Jobsteuerung.

Amazon Verbindung testen

Prüft Client-ID, Secret, Refresh Token und die Erreichbarkeit des Amazon-Endpoints.

Empfehlung: Nach jeder Parameter-Änderung einmal ausführen. Erfolg = HTTP-Status 200 im Job-Protokoll.

Amazon Aufträge importieren

• Holt neue Bestellungen von Amazon
• Legt Handel-Aufträge an mit:
  • Auftragsnummerkunde = Amazon-Bestellnummer
  • Bezeichnung = Amazon {Bestellnummer}
• Bereits importierte Bestellungen werden übersprungen (Erkennung über Auftragsnummerkunde)

Optional: Cron-Ausdruck setzen (z. B. alle 15–30 Minuten) für automatischen Import.

Amazon Versandmeldungen senden

Verarbeitet offene Einträge in Amazon Versandmeldung (gemeldet = false).
Einträge ohne Sendungsnummer werden übersprungen.

Berechtigungen

Die Rolle Amazon-Administrator sollte den Benutzern zugewiesen werden, die Import und Versandmeldung betreuen.

Test und Produktivbetrieb

Testreihenfolge

Schritt	Aktion	Erwartetes Ergebnis
1	Job Amazon Verbindung testen	HTTP 200, Marketplace-Antwort im Protokoll
2	AmazonArtikelZuordnung pflegen	Alle relevanten SKUs

gemappt

zugeordnet
3	Job Amazon Aufträge importieren	Handel-Aufträge mit Bezeichnung Amazon …
4	Lieferschein anlegen, Sendungsnummer eintragen	Tracking

vorhanden

-Nummer am Lieferschein
5	Lieferschein → Versendet	In der Sandbox: Versandmeldung schlägt fehl

(API nicht verfügbar)

— das ist erwartet
6	Produktions-Endpoint

setzen

und Credentials eintragen

Versandmeldung funktioniert mit echter Sendungsnummer

Sandbox vs. Produktion

Wie erkenne ich einen Amazon-Auftrag?

Ein Auftrag gilt als Amazon-Auftrag, wenn beides zutrifft:

• Die Bezeichnung beginnt mit Amazon
• Die Auftragsnummerkunde enthält die Amazon-Bestellnummer

Eine beliebig gesetzte Auftragsnummerkunde allein reicht nicht aus.

Häufige Fragen und Probleme

Hinweise

• Das Nuclet arbeitet mit einem Seller-Account pro Nuclos-Instanz (über die Nuclet-Parameter). Mehrere Seller-Accounts erfordern eine projektspezifische Erweiterung.
• Der Import legt keine Kundenadressen aus Amazon an — Bestellungen laufen über den konfigurierten Sammelkunden.
• Für den Produktionsbetrieb muss die Amazon-Anwendung im Seller Central freigeschaltet und der Seller autorisiert sein.
• Nach Nuclet-Updates: Regeln aktualisieren oder Server neu starten.