Token erneuern – Authentifizierung / Autorisierung auffrischen

Warum muss das Token erneuert werden?

Die Kommunikation zwischen einem Marktplatz und der microtech Cloud wird über ein Token hergestellt. Tokens sind nur für einen begrenzten Zeitraum gültig und müssen nach Ablauf erneuert werden.

Gültigkeitsdauer

Je nach Plattform ist ein Token zwischen einem Jahr und 18 Monaten gültig. Die genaue Dauer kann sich von Plattform zu Plattform und von Nutzerkonto zu Nutzerkonto unterscheiden.

Wie erkenne ich ein abgelaufenes Token?

Wenn das Token ungültig geworden ist, stehen essentielle Funktionen wie der Vorgangsabruf oder der Abruf von Amazon-SFP-Versandlabels nicht mehr vollumfänglich zur Verfügung.

Typische Fehlermeldung:

{
    "error": {
        "title": "ServerError",
        "message": "An error occurred while refreshing token.",
        "status": 400
    }
}

Außerdem erscheint in microtech ERP ein Hinweisdialog, wenn die Autorisierung in Kürze abläuft:

So erneuern Sie das Token (Beispiel: Amazon)

Das Vorgehen ist für alle Marktplatz-Plattformen mit OAuth-Authentifizierung identisch. Die nachfolgenden Schritte sind exemplarisch für Amazon beschrieben.

Mehrere Marktplatz-Konten im Browser

Wenn Sie mehrere Marktplatz-Plattformen verwenden, melden Sie sich im Browser vom jeweiligen Marktplatz-Konto ab und leeren Sie die Cookies, bevor Sie den OAuth-Flow starten. Andernfalls kann es zu ungewollten Vermischungen der Anmeldungen kommen.

Schritt 1: Aktiv-Kennzeichen deaktivieren

Wechseln Sie in der Software in den Bereich E-COMMERCE → STAMMDATEN → PLATTFORMEN, öffnen Sie Ihre Amazon-Plattform zum ÄNDERN und wechseln Sie auf das Register ZUGANGSDATEN.

Deaktivieren Sie das AKTIV-Kennzeichen und wählen Sie SPEICHERN & SCHLIEßEN.

Schritt 2: Plattform erneut öffnen und über OAuth anmelden

Das Aktiv-Kennzeichen muss weiterhin deaktiviert sein.

Öffnen Sie den Plattform-Datensatz erneut zum ÄNDERN und wechseln Sie auf das Register ZUGANGSDATEN. Drücken Sie die Schaltfläche ANMELDEN — das Amazon Seller Central öffnet sich im Browser.

Schritt 3: Zugriff im Seller Central bestätigen

Melden Sie sich mit Ihrem Verkäuferkonto im Seller Central an und bestätigen Sie, dass die microtech-Schnittstelle auf Ihr Konto zugreifen darf. Dadurch wird ein neues Token ausgestellt.

Nach der Bestätigung öffnet sich eine microtech-Seite, die den Erfolg der Verbindung meldet.

Schritt 4: Aktiv-Kennzeichen wieder aktivieren

Öffnen Sie den Plattform-Datensatz erneut, aktivieren Sie das AKTIV-Kennzeichen und wählen Sie SPEICHERN & SCHLIEßEN.

Schritt 5: Funktionen überprüfen

Prüfen Sie, ob die Plattform-Funktionen wieder korrekt arbeiten — z. B. ob Amazon SFP-Versandlabels und der Vorgangsabruf wieder fehlerfrei laufen.

Sollten weiterhin Probleme auftreten, erstellen Sie bitte ein Ticket im microtech Serviceportal: portal.microtech.de/support/tickets