Inhaltsverzeichnis

Features der Schnittstelle
Anbindung
Sonderfälle / Sonstige Informationen

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.

Anbindung

eBay Entwicklerkonto einrichten

Zunächst musst du auf das eBay-Developerkonto gehen und dich in das entsprechende Konto für den Importer einloggen
Im Developerkonto musst du auf "Application Keys" klicken und danach neben der App-ID auf "User Tokens" für das Produktivsystem
Danach musst du auf das Aufklappmenü "Get a Token from eBay via Your Application" klicken
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.

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

Abonnieren von Benachrichtigungen über die Löschung/Schließung eines eBay-Marktplatzkontos

Um Drittanbieter beim Löschen von Kundendaten zu unterstützen, hat eBay ein Push-Benachrichtigungssystem eingerichtet, das alle Anwendungen des eBay-Entwicklerprogramms benachrichtigt, wenn ein eBay-Nutzer die Löschung seiner persönlichen Daten und die Schließung seines Kontos beantragt hat. Alle aktiven Anwendungen des eBay-Entwicklerprogramms müssen sich für die Benachrichtigung über die Löschung bzw. Schließung eines eBay-Marktplatzkontos anmelden.

So gehst du vor

Melde dich bei deinem Entwicklerkonto an
Gehe auf die Seite Anwendungsschlüssel
Klicke auf den Link Benachrichtigungen, der sich neben Ihrer App-ID befindet. Du gelangst auf die Seite Alerts und Benachrichtigungen, die unten angezeigt wird
Wähle das Optionsfeld Marketplace Account Deletion unter dem Abschnitt Event Notification Delivery Method
Die E-Mail-Adresse ist erforderlich, wird aber nur verwendet, um die Entwickler zu benachrichtigen, wenn die angegebene Benachrichtigungs-Endpunkt-URL nicht erreichbar ist bzw. Benachrichtigungen nicht ordnungsgemäß bestätigt werden. Sobald du eine E-Mail-Adresse eingegeben hast, klicke auf die nebenstehende Schaltfläche Speichern
Anschließend lege die URL des Benachrichtigungsendpunkts für den Empfang von Benachrichtigungen fest. Kopiere die Verifizierungs-URL von Xentral und füge sie ein
Kopiere diesen Wert aus Xentral und füge ihn in das Feld für das Verifizierungs-Token ein
Sobald du die URL des Benachrichtigungs-Endpunkts und den Wert des Verifizierungs-Tokens festgelegt hast, klicke auf die nebenstehende Schaltfläche Speichern
Nachdem du erfolgreich Benachrichtigungen über die Löschung/Schließung eines eBay-Marktplatzkontos abonniert hast, kannst du eine Testbenachrichtigung an diese URL senden, indem du auf die Schaltfläche Testbenachrichtigung senden klickst. Sobald die Endpunkt-URL die Testbenachrichtigung erfolgreich empfangen hast, ist deine Einrichtung abgeschlossen und deine Anwendung sollte ab sofort Benachrichtigungen über die Löschung oder Schließung von eBay-Konten erhalten

Einstellungen in der Schnittstelle vornehmen

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

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
Aktiviere die Checkbox für den Auftragsimport über alternative API und speichere
Klicke auf REST Token anfordern

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

eBay fordert dich auf, zu bestätigen, dass diese Authentifizierung in Ordnung geht. Bitte mit "I, agree" bestätigen.
eBay leitet dich zurück nach xentral und die neue App-ID ist eingetragen
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.

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:

Leere das Feld "Token" und speichere die Einstellungen
Klicke auf Verbindung prüfen
Es wird oben eine Meldung mit einem Link angezeigt. Klicke auf diese und folge dem Prozess
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:

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