Zum Hauptinhalt gehen
Anmelden

eBay - Alternative Schnittstelle

  • Aktualisiert

Inhaltsverzeichnis

Da bei einzelnen Kunden keine Aufträge über die eBay Schnittstelle importiert werden konnten, haben wir die Schnittstelle zum Abholen der Aufträge in unserem eBay Modul auf die neue Rest-API umgestellt, um die Probleme mit der alten Schnittstelle nachhaltig lösen zu können.

Um diese neue Schnittstelle benutzen zu können benötigst du eine Einstellung im Developer-Konto von eBay und in der xentral Schnittstelle.

Features der Schnittstelle

In großen Teilen entspricht der Umfang der Anbindung über die neue eBay API der alten Anbindung. Informationen dazu findest du hier.

Eine Ausnahme bildet die Funktion bereits versendete Aufträge aus eBay zu importieren. Dies kann über diese Schnittstelle nicht abgebildet werden. Auch mit Nicht-Aktivierung dieses Hakens werden keine verschickten Bestellungen importiert.

mceclip0.png

Anbindung

eBay Entwicklerkonto einrichten

  1. Zunächst musst du auf das eBay-Developerkonto gehen und dich in das entsprechende Konto für den Importer einloggen
  2. Im Developerkonto musst du auf "Application Keys" klicken und danach neben der App-ID auf "User Tokens" für das Produktivsystem
  3. Danach musst du auf das Aufklappmenü "Get a Token from eBay via Your Application" klicken
  4. Im letzten Schritt ist es notwendig, dass du eine URL angibst, an welche dann eBay den neuen Authentifizierungstoken für die xentral-Installation schicken kann. Hierfür musst du die URL der xentral-Installation kopieren (z.B. https://<meinxentral>.xentral.biz/index.php?module=onlineshops&action=edit&id=1) und alles nach dem Fragezeichen mit "module=ebay&action=rest&cmd=getToken" ersetzen.

Am Ende sieht die URL dann z.B. so aus: 

https://<meinxentral>/index.php?module=ebay&action=rest&cmd=getToken

Diese URL musst du danach in das Feld "Your auth accepted URL" eintragen.

mceclip0.png

Abschließend bestätigst du die Einstellung mit "Save".

Einstellungen in der Schnittstelle vornehmen

Damit in xentral diese neue Schnittstelle auch verwendet wird, musst du folgende Schritte ausführen:

  1. Gehe auf Administration → Shop Schnittstelle (bis Version 21.1: Administration → Einstellungen → Online-Shops / Marktplätze) und editiere den entsprechenden eBay Importer über das Stift Symbol
  2. Aktiviere die Checkbox für den Auftragsimport über alternative API und speichere
    blobid0.png
  3. Klicke auf REST Token anfordern

mceclip1.png

Eine Weiterleitung zu eBay erfolgt und du musst dich mit deinem Verkäuferkonto einloggen.

  1. eBay fordert dich auf, zu bestätigen, dass diese Authentifizierung in Ordnung geht. Bitte mit "I, agree" bestätigen.
  2. eBay leitet dich zurück nach xentral und die neue App-ID ist eingetragen
  3. Stelle abschließend bitte sicher, dass der Haken "Auftragsimport über alternative API" aktiviert ist und schließe die Einrichtung mit Speichern ab

Nun kann der Importer mit der neuen Rest-API umgehen. Zum Testen kannst du einfach auf Aufträge abholen bzw. Verbindung prüfen klicken.

Typische Fehlermeldungen / Probleme

Sollten Probleme auftreten, dann erstelle bitte ein Ticket in ZenDesk mit dem Betreff ebay_update .

Problem: Doppelter Import

Lösung:

Bei der alten API wurde eine andere eBay Bestellnummer importiert - diese hat sich nun mit Änderung der API geändert. Da wir aber auf Basis der eBay Bestellnummer abgleichen, ob eine Bestellung bereits importiert worden ist, kann es hier vorkommen, dass bereits importiertierte Bestellungen erneut importiert werden. Daher sollten die Aufträge in der Übergangszeit über die Zwischentabelle importiert werden. Informationen dazu findest du hier.

Achtung: Bei der Umstellung musst du unbedingt aufpassen, dass Bestellungen nicht doppelt importiert werden.mceclip0.png

Problem: Authentifizierungsfehler

Lösung: Falls bei "Verbindung prüfen" ein Authentifizierungsfehler kommt, verhindert dies der Token der alten Schnittstelle.

Bitte führe folgende Schritt aus:

  1. Leere das Feld "Token" und speichere die Einstellungen
  2. Klicke auf Verbindung prüfen
  3. Es wird oben eine Meldung mit einem Link angezeigt. Klicke auf diese und folge dem Prozess
  4. Jetzt sollte es funktionieren

Problem: Änderung des Passworts für das Verkäuferkonto

Lösung: Sobald das Passwort des eBay Kontos geändert wird, ist auch die oben beschriebene Authentifizierung invalide und du musst diese erneut ausführen:

  1. Gehe auf Administration → Shop Schnittstelle (bis Version 21.1: Administration → Einstellungen → Online-Shops / Marktplätze) und editiere den entsprechenden eBay Importer
  2. Klicke auf REST Token anfordern. Damit wirst du zu eBay geleitet und musst dich in deinem Verkäuferkonto einloggen
  3. eBay fordert dich auf, zu bestätigen, dass diese Authentifizierung in Ordnung geht. Bitte mit "I, agree" bestätigen

  4. eBay leitet zurück in xentral und die neue App-ID ist eingetragen

Problem: Fehlermeldung bei Anforderung des Rest-Token / keine Weiterleitung von eBay nach xentral

Lösung: Wenn in den eBay Importer-Einstellungen das Feld "Token" einen Wert enthält, der mit "Session: ..." beginnt, musst du den Inhalt des Felds löschen. Danach speicherst du und klickst erneut auf Verbindung prüfen. Im Anschluss folgst du wieder der Anleitung für das alte Token und schließst den Vorgang ab. Sobald die Schaltfläche Verbindung prüfen einen "Success" zurückgibt, startest du erneut mit der neuen Mechanik.

Problem: Es werden keine Aufträge abgeholt

Lösung: Grundsätzlich solltest du vorgehen wie bei der alten eBay Anbindung, bis zum Schritt mit der Schaltfläche Verbindung prüfen und der Eingabe der Zugangsdaten bei eBay. Sobald der Token der “alten Anbindung” eingetragen ist, musst du auf die Schaltfläche REST Token anfragen gehen. Es folgst eine weitere Weiterleitung zu eBay, bei der du dich nochmal anmelden und auf die Schaltfläche “I agree” klickst. Anschließend sollte die Abholung der Aufträge funktionieren.

Sonderfälle / Sonstige Informationen

Telefonnummern von Kunden

Mit der neuen API gibt eBay die Telefonnummern der Kunden nur noch so zurück, wie sie der Kunde eingetragen hat z.B. (+49176..., 0176... oder 48327...)

Das internationale Format der alten API wird nicht mehr angewendet.

Zahlungsweise

Über die REST API wird die Zahlungsweise als “EBAY” übergeben und nicht wie vorher als “ebay”. Dadurch greift das bestehende Mapping nicht und müsste noch manuell für jeden Importer angepasst/hinzugefügt werden.

Rabatte

Falls es auf Bestellungen nur eine Art von Rabatt gibt (z.B. Mengenrabatt, Sonderaktion, Promotion Code, etc) wird dieser Rabatt mit der Standardmechanik des Importers übergeben. Das heißt es ist kein dedizierter Rabattartikel im Importer nötig damit die Position korrekt im Auftrag landet. 

Falls es mehrere Rabattarten gibt werden die Rabatte nach Art zusammengefasst und als einzelne Positionen übergeben. Damit diese Mechanik funktioniert ist es zwingend erforderlich einen Rabattartikel im Importer anzugeben.

Es bietet sich eigentlich in jedem Fall an einen Rabattartikel zu hinterlegen, auch im Hinblick auf die gesonderte Besteuerung im Vereinigten Königreich.