Amazon konfigurieren
Rufen Sie Ihre Amazon-SP-API-Anmeldedaten ab, um Order Invoicer zu verbinden
Voraussetzungen
Stellen Sie vor dem Beginn sicher, dass:
- Sie über ein aktives Amazon Seller Central-Konto verfügen
- Sie am Programm der Amazon Selling Partner API (SP-API) teilnehmen
- Sie eine SP-API-Entwickleranwendung erstellt haben (oder darauf Zugriff haben)
Die Selling Partner API ist professionellen Verkäufern vorbehalten. Wenn Sie ein Einzelverkäufer sind, müssen Sie zunächst auf ein professionelles Konto umstellen, um die Integration nutzen zu können.
Ihre SP-API-Anmeldedaten abrufen
Order Invoicer benötigt drei Informationen, um sich mit Amazon zu verbinden:
- Ein Refresh-Token
- Eine Client-ID (LWA-Anwendungs-ID)
- Ein Client Secret (LWA-Anwendungs-Secret)
Als Amazon-Entwickler registrieren
Falls Sie dies noch nicht getan haben:
- Melden Sie sich bei Seller Central an
- Gehen Sie zu Apps & Services > Develop Apps
- Folgen Sie dem Registrierungsprozess für das SP-API-Entwicklerprogramm
- Warten Sie auf die Genehmigung durch Amazon (dies kann mehrere Tage dauern)
Eine LWA-Anwendung (Login with Amazon) erstellen
- Klicken Sie in der Amazon-Entwicklerkonsole auf Add new app client
- Geben Sie Ihrer Anwendung einen Namen (z. B.
Order Invoicer) - Wählen Sie die erforderlichen Rollen aus:
- ✅ Product Listing
- ✅ Pricing
- ✅ Inventory and Order Management
- Speichern Sie die Anwendung
- Notieren Sie sich die angezeigte Client-ID (LWA Client ID) und das Client Secret (LWA Client Secret)
Das Client Secret ist vertraulich. Geben Sie es nicht weiter und veröffentlichen Sie es nicht auf öffentlichen Plattformen.
Die Anwendung autorisieren und ein Refresh-Token generieren
- Klicken Sie in Ihrer Entwicklerkonsole neben Ihrer Anwendung auf Authorize
- Melden Sie sich mit dem Seller-Central-Konto an, das Sie verbinden möchten
- Akzeptieren Sie die angeforderten Berechtigungen
- Amazon gibt ein Refresh-Token zurück (eine Zeichenfolge, die mit
Atzr|...beginnt) - Kopieren Sie dieses Refresh-Token sofort
Das Refresh-Token wird nur einmal angezeigt. Wenn Sie es verlieren, müssen Sie den Autorisierungsprozess erneut durchlaufen.
Das Refresh-Token ist langfristig gültig. Order Invoicer verwendet es, um bei Bedarf automatisch neue Access-Tokens zu erhalten.
Ihre Anmeldedaten in Order Invoicer eingeben
Geben Sie im Amazon-Verbindungsformular in Order Invoicer Folgendes ein:
- Refresh Token: das im vorherigen Schritt erhaltene Token
- Client ID: die LWA Client ID Ihrer Anwendung
- Client Secret: das LWA Client Secret Ihrer Anwendung
Der Connector validiert Ihre Anmeldedaten automatisch, indem er die SP-API abfragt.
Fehlerbehebung
Fehler „Ungültige Anmeldedaten“
- Überprüfen Sie, ob das Refresh-Token vollständig kopiert wurde (es ist in der Regel sehr lang)
- Überprüfen Sie, ob die Client ID und das Client Secret zur selben Anwendung gehören
- Stellen Sie sicher, dass sich am Anfang oder Ende der Zeichenfolgen keine Leerzeichen befinden
Fehler „Zugriff verweigert“ oder „Fehlende Berechtigungen“
- Überprüfen Sie, ob Ihre Anwendung über die erforderlichen Rollen verfügt (insbesondere die Auftragsverwaltung)
- Wenn Sie die Rollen geändert haben, müssen Sie die Autorisierung erneut ausführen, um ein neues Refresh-Token zu generieren
Fehler „Token abgelaufen“
- Refresh-Tokens können über Seller Central widerrufen werden; überprüfen Sie, ob sie noch aktiv sind
- Falls widerrufen, führen Sie den Autorisierungsprozess erneut aus, um ein neues Refresh-Token zu erhalten
API-Referenz
Weitere Details zur Amazon SP-API finden Sie unter:
Support
Wenn Sie auf Schwierigkeiten stoßen:
- Sehen Sie sich den Abschnitt zur Fehlerbehebung oben an
- Konsultieren Sie die offizielle Amazon-SP-API-Dokumentation
- Kontaktieren Sie unseren Support:
contact@orderinvoicer.com