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
- Beantragen Sie die Rollen in Ihrem Entwicklerprofil und 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) - Aktivieren Sie unter Unterstützte Geschäftsentitäten alle vier Partner:
- Fracht
- Verkäufer
- Versand
- Lieferanten
- Aktivieren Sie unter Rollen jede angezeigte Rolle:
- Fracht und Versand: Amazon-Logistik
- Verkäufer und Lieferanten: Finanzen und Buchhaltung, Bestands- und Auftragsverfolgung, Versand durch Amazon
- Wählen Sie bei der Frage zum Restricted Data Token (RDT) Ja, ich werde den Zugriff auf PII an die Anwendung eines anderen Entwicklers delegieren, und aktivieren Sie:
- Professionelle Dienstleistungen
- Unterstützung für Verkaufspartner
- Direktversand an Kunden
- Steuerüberweisung
- Steuerrechnungsstellung
- Lassen Sie OAuth-Anmelde-URI und OAuth-Weiterleitungs-URI leer. Die Schaltfläche Authorize verwendet diese Adressen nicht.
- 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.
Ohne Direktversand an Kunden und Steuerrechnungsstellung übermittelt Amazon weder Name noch Adresse noch USt-IdNr. des Käufers: Die Rechnungen gehen ohne diese Angaben heraus. Wenn Sie diese Felder nachträglich ändern, klicken Sie erneut auf Authorize und fügen Sie das neue Refresh-Token ein.
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.
Auszahlungen
Amazon-Auszahlungen werden täglich aus Ihren Abrechnungsberichten synchronisiert. Sie finden sie im Menü Auszahlungen Ihres Amazon-Connectors, mit den Bestellungen, Erstattungen und Gebühren jeder Auszahlung.
Marktplätze
Ein Amazon-Verkäuferkonto verkauft auf mehreren Marktplätzen (Amazon.fr, Amazon.de …). Jede Bestellung, Erstattung und Auszahlung zeigt den Marktplatz, aus dem sie stammt.
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 die Rollen der Anwendung, insbesondere Bestands- und Auftragsverfolgung, Finanzen und Buchhaltung und im Abschnitt RDT Direktversand an Kunden sowie Steuerrechnungsstellung
- Wenn Sie die Rollen geändert haben, klicken Sie erneut auf Authorize und fügen Sie das neue Refresh-Token ein
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