Definition
Das Nuclet verbindet Nuclos Handel mit der Amazon Selling Partner API (SP-API).
Es übernimmt zwei zentrale Aufgaben:
- Bestellimport — Amazon-Bestellungen werden als normale Handel-Aufträge angelegt.
- 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
| Funktion | Auslöser | Ergebnis |
|---|---|---|
Bestellimport | Job „Amazon Aufträge importieren“ | neuer Auftrag mit Positionen |
Zuordnung SKU- | Stammdaten | Seller-SKU → Handel-Artikel |
Versandmeldung | Lieferschein → Status Versendet |
|
Versandmeldung (Batch) | Job „Amazon Versandmeldungen senden“ | Offene |
Verbindungstest
| Job „Amazon Verbindung testen“ | Job „Amazon Verbindung testen“ |
Ablauf im Tagesgeschäft
- Job importiert neue Amazon-Bestellungen → Handel-Aufträge erscheinen in Nuclos.
- Auftrag wird wie gewohnt bearbeitet (Kommissionierung, Lieferschein).
- Sendungsnummer am Lieferschein eintragen.
- 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.
| Schritt | Beschreibung |
|---|---|
1 | Nuclet Amazon SP-API importieren (Handel muss bereits vorhanden sein) |
2 | Server neu starten bzw. Regeln aktualisieren |
3 | Nuclet-Parameter eintragen (siehe unten) |
4 | Sammelkunden in Handel anlegen und in |
5 | Businessobjekt AmazonArtikelZuordnung konfigurieren und Schema generieren |
6 | SKU-Zuordnungen pflegen (Seller-SKU → Handel-Artikel) |
7 | Feld Sendungsnummer am Lieferschein prüfen und ggf. in die Maske aufnehmen |
8 | Versandregel am Lieferschein-Statusmodell prüfen (Übergang → Versendet) |
9 | Rolle Amazon-Administrator den zuständigen Benutzern zuweisen |
10 | Job Amazon Verbindung testen ausführen |
11 | Job Amazon Aufträge importieren testen |
12 | Optional: Cron-Jobs für automatischen Import einrichten |
Test und Produktivbetrieb
Testreihenfolge (Sandbox)
| Schritt | Aktion | Erwartetes Ergebnis |
|---|---|---|
1 | Job Amazon Verbindung testen | HTTP 200, Marketplace-Antwort |
2 |
| SKUs gemappt |
3 | Job Amazon Aufträge importieren | Handel-Aufträge mit Bezeichnung |
4 | Lieferschein anlegen, Sendungsnummer eintragen | Tracking vorhanden |
5 | Lieferschein → Versendet | In Sandbox: Versandmeldung schlägt fehl (API nicht verfügbar) — erwartet |
6 | Produktions-Endpoint setzen | Versandmeldung funktioniert mit echter Sendungsnummer |