Note
This article describes the previous connection (legacy). You set up the current integration under Settings > Integrations, see article eBay: Overview. How to switch and what changes is described in the article Updating the shop importer.
Du kannst deinen eBay-Shop mit Xentral verbinden und dann deine Aufträge importieren und in Xentral weiter verarbeiten. Dieser Artikel bietet dir Hilfestellung bei der Einrichtung deiner eBay-Shopschnittstelle und hilft dir, die verfügbaren Einstellungen zu verstehen. Weiterhin findest du hier Beschreibungen und Erklärungen verschiedener Anwendungsfälle.
Zusätzlich zur eBay-Shopschnittstelle bietet Xentral auch die eBay App, die du im App Center findest.
Die eBay App bietet viele verschiedene Features - von einer Übersicht aller Auktionen über Einstellungen zu Rahmenbedingungen bis hin zu Lagerinformationen. Die App kann für die Nutzung der eBay-Shopschnittstelle erforderlich sein. Mindestens bietet sie dir zusätzliche Features. Mehr Informationen zur eBay App und deren Vorteile findest du hier.
Hier erfährst du, wie du deinen eBay-Shop an Xentral anbinden kannst. Dazu müssen verschiedene Schritte ausgeführt werden:
-
Navigiere zur Seite des eBay developers program (https://developer.ebay.com/) und melde dich mit dem entsprechenden Developer-Konto an.
-
Klicke im Developer-Konto auf Application Keys und danach auf User Tokens neben der App-ID für das Produktivsystem .
-
Scrolle bis zum Bereich Get a Token from eBay via Your Application.
-
Gib eine URL an, an welche eBay den neuen Authentifizierungstoken senden kann. Kopiere dazu die URL der Xentral-Installation und ersetze alles nach dem Fragezeichen mit module=ebay&action=rest&cmd=getToken.
Beispiel:
https://<myxentral>/index.php?module=ebay&action=rest&cmd=getToken -
Gib die URL in das Feld Your auth accepted URL ein. Stelle sicher, dass du hier die korrekte URL eingibst, da sonst Xentral keine Token, die für die Verbindung erforderlich sind, empfangen wird.
-
Klicke auf Speichern.
Suche in deinem Developer-Konto nach folgenden Keysets:
Zusätzlich zu den Keysets musst du noch den RuName (eBay Redirect URL-Namen) suchen. Klicke dazu auf User Tokens. Den RuName findest du im Bereich Get a Token from eBay via Your Application.
Zur Verbindungsherstellung musst du die Keysets und den RuNamen in Xentral eingeben. Dieser Prozess ist im nächsten Abschnitt beschrieben.
Die Grundeinstellungen deiner eBay-Shopschnittstelle nimmst du wie folgt vor:
-
Navigiere zu Administration > Shop Schnittstelle > Klicke auf +NEU, um deine eBay-Shopschnittstelle einzurichten.
-
Setze ein Häkchen bei Auftragsimport über alternative API. Diese Option zu aktivieren ist extrem wichtig, da ohne sie keine Synchronisierung der Lagerzahlen zwischen Xentral und eBay stattfinden kann.
-
Gib App ID, Dev ID, Cert ID und den RuName, den du aus deinem eBay Developer-Konto abgerufen hast, in die entsprechenden Felder im Abschnitt Einstellungen für Shop oder Marktplatz > Systemeinstellungen ein.
-
Gib die entsprechenden Informationen in die Felder Währung, Site, siteID und Zeitzone ein.
-
Klicke im Bereich Aktion auf REST Token anfordern. Du wirst zu eBay weitergeleitet.
-
Melde dich mit deinem Verkäufer-Konto an.
-
eBay bittet dich, die Authentifizierung zu bestätigen. Klicke auf Ich stimme zu. Du wirst zu Xentral weitergeleitet.
-
Klicke auf Speichern. Die Verbindung über die REST API ist nun aktiviert.
-
Klicke im Bereich Aktion auf Verbindung überprüfen, um die Verbindung zu überprüfen.
Wurde die Verbindung erfolgreich hergestellt, wird die Gültigkeit des Token in einer grauen Infobox über dem Unterreiter Schnittstelle angezeigt. Den Token selbst findest du im Feld Token.
Caution
Hat der Token eine Gültigkeit von mehr als 6-7 Stunden oder wird dir ein Fehler bei der Authentifizierung angezeigt, wurde der Token nicht korrekt übertragen. Wiederhole in diesem Fall die Schritte 5 bis 9.
Du kannst zusätzlich auch das Feld Token prüfen, um herauszufinden, ob der Token gültig ist. Der Token muss mit einem v anfangen. Beginnt er mit einem A, ist der Token nicht korrekt.
Stelle sicher, dass du den Token rechtzeitig vor Ablauf erneuerst.
Important
Änderst du das Passwort deines eBay-Kontos, musst du die Authentifizierung erneut durchlaufen, da die bestehende Authentifizierung dadurch ungültig wird.
Dies ist das wichtigste Formular zum Einrichten deiner Shopschnittstelle.
Nachfolgend findest du die wichtigsten Felder und Schaltflächen beschrieben:
Bereich Einstellungen:
-
Bezeichnung: Bei Erstellung der Schnittstelle wird automatisch eine Bezeichnung angelegt. Du kannst jedoch auch eine eigene Bezeichnung wählen. Die Bezeichnung wird z.B. im Artikel oder Importmenü angezeigt.
-
Aktiv: Setze hier ein Häkchen, um die Schnittstelle zu aktivieren. Du kannst das Häkchen auch wieder entfernen, um die Schnittstelle zu deaktivieren.
-
Projekt: Möchtest du deinen eBay-Shop einem Projekt zuweisen, kannst du hier das passende Projekt auswählen. Im Projekt kannst du z.B. Logistikeinstellungen vornehmen.
-
Abholmodus: Du kannst ab einem bestimmten Datum Aufträge von eBay abholen .
-
Datum von: Das erste Datum, ab dem Aufträge abgeholt werden. Das Feld aktualisiert sich automatisch, sobald die Funktion Aufträge abholen genutzt wird.
-
Import-Modus: Wähle den Import-Modus, der auf den Import angewendet wird. Du kannst aus den folgenden Optionen wählen:
-
Demo (zum Testen): Der Auftragsstatus im Shop wird nicht umgestellt. Es werden keine Artikel oder Lagerzahlen übertragen .
-
Manuell (mit Importzentrale): Aufträge werden nur abgeholt, wenn du auf Aufträge abholen klickst.
-
Automatisch (per Prozessstarter): Die Aufträge werden über den Prozessstarter in regelmäßigen Abständen automatisch vom Shop abgeholt. Weitere Informationen zu Prozessstartern und deren Einstellungen findest du hier.
-
-
Nur 1 Auftrag pro Anfrage: Es wird nur 1 Auftrag pro Anfrage vom Shop übertragen .
-
Aufträge in Zwischentabelle: Setze hier ein Häkchen, falls du Aufträge nicht direkt anlegen möchtest, sondern sie zuerst in einer Zwischentabelle speichern möchtest, in der du die Aufträge überprüfen kannst. In der Zwischentabelle kannst du wählen, welche Aufträge angelegt und welche später importiert werden sollen.
-
Protokollierung im Logfile: Wähle ob ein Logfile erstellt werden soll. Die Nutzung eines Logfiles erleichtert es im Problemfall Fehler zu identifizieren.
-
Einrichtungsmodus: Setze hier ein Häkchen, um nur einen neuen Auftrag abzuholen. Bereits abgeholte Aufträge werden ignoriert (im Gegensatz zum Demo-Modus) .
-
Verschickte Bestellungen übergehen: Setze hier ein Häkchen, um bereits verschickte Bestellungen beim Import zu ignorieren. Dadurch verringert sich das Risiko, dass ein Auftrag doppelt verschickt wird.
-
Sandbox benutzen: Setze hier ein Häkchen, um die Sandbox zu nutzen. Die Sandbox ist eine Testumgebung, die dir erlaubt Funktionen ohne Auswirkungen auf deine Produktionsumgebung (Live-Umgebung) zu testen.
-
Auftragsimport über alternative API: Hier muss immer ein Häkchen gesetzt sein, um die Synchronisierung der Lagerzahlen zu gewährleisten. Durch diese Option wird die Nutzung der REST API aktiviert.
-
eBay Name des Käufers in Auftrag übernehmen: Setze hier ein Häkchen, um den eBay-Namen des Kaufers in den Auftrag zu übernehmen.
-
Rahmenbedingungen verwenden: Setze hier ein Häkchen, um Rahmenbedingungen zu verwenden. Rahmenbedingungen werden in der eBay App definiert. Weitere Informationen zu Rahmenbedingungen findest du hier.
-
Warnungen ausgeben: Setze hier ein Häkchen, um Warnungen zu Auktionen auszugeben. Warnungen sind Meldungen, die eine Auktionserstellung nicht verhindern, aber auf einen Umstand hinweisen, der überprüft und/ oder angepasst werden sollte
-
Listing ohne Bestand automatisch beenden: Setze hier ein Häkchen, um Listings ohne Bestand automatisch zu beenden.
-
Beendete Listings bei neuem Bestand automatisch reaktivieren: Setze hier ein Häkchen, um wegen fehlendem Bestand beendete Listings automatisch wiedereinzustellen, sobald neuer Bestand vorliegt.
Bereich Aktion:
-
Verbindung prüfen: Klicke hier, um die Verbindung zwischen Xentral und eBay zu überprüfen. Dabei wird auch der Token überprüft und die Gültigkeit des Token in einer grauen Infobox über dem Unterreiter angezeigt.
-
Aufträge abholen: Klicke hier, um Aufträge aus deinem eBay-Shop abzuholen.
-
Shopimport Zwischentabelle: Klicke hier, um die Zwischentabelle mit deinen Aufträgen zu öffnen.
Vorraussetzung, um die Zwischentabelle nutzen zu können: Wähle Manuell (mit Importzentrale) im Import-Modus Dropdown-Menü und setze ein Häkchen bei Aufträge in Zwischentabelle.
In der linken Spalte der Zwischentabelle kannst du für jeden Auftrag aus den folgenden Optionen wählen:
Import
Der Auftrag wird direkt importiert.
Müll
Der Auftrag wird in den Müll verschoben und kann nicht mehr importiert werden.
Später
Der Auftrag kann zu einem späteren Zeitpunkt importiert werden.
-
Zur eBay App: Du wirst zur eBay App weitergeleitet. Weitere Informationen zur eBay App findest du in diesem Artikel.
-
REST Token anfordern: Fordere einen neuen REST Token an. Du wirst zur Authentifizierung zu eBay weitergeleitet.
Informationen zu den Unterreitern Einstellungen, Zahlweisen, Versandarten und Sprache-/Lieferland findest du im Artikel Online-Shops.
Die Funktionalitäten der Unterreiter Subshop und Gruppenmapping sind für eBay nicht verfügbar.
Die Funktionalitäten des Unterreiters Freifelder sind für eBay nicht verfügbar. Es sind jedoch Freifelder für die Artikelbeschreibung verfügbar, die du über Templates in der eBay App definieren kannst.
Important
Stelle sicher, dass bei Auftragsimport über alternative API in der eBay-Schnittstelle ein Häkchen gesetzt ist. Dies ermöglicht die Synchronisierung der Lagerzahlen zwischen Xentral und eBay. Ist hier kein Häkchen gesetzt, wird der Lagerbestand nicht synchronisiert.
Wie du die Lagerzahlen synchronisieren kannst, erfährst du hier.
Tipps für den Import von Aufträgen:
-
Ein zu früh gewählter Abholzeitpunkt bei einer sehr großen Menge an Aufträgen kann dazu führen, dass der Abholvorgang scheitert, da das Skript die serverseitige Timeoutgrenze erreicht und abgebrochen wird. In der Praxis kann sich das dadurch äußern, dass nach mehrminütiger Suche kein Auftrag zurückgemeldet wird .
-
Beim Abholen über den Demo-Modus wird maximal ein Auftrag abgeholt und die Abholzeit wird nicht geändert .
-
Der maximale Zeitraum für das Abholen von Aufträgen ist auf Seite von eBay auf 30 Tage begrenzt. Als Konsequenz daraus kann ein zu früh gesetztes Abholdatum, oder ein längerer Zeitraum ohne Bestellungen dazu führen, dass der Importer in ein Bottleneck gerät und keine neueren Aufträge abholen kann selbst wenn diese vorhanden sind. In einem solchen Fall musst du das Abholdatum manuell ändern .
Das Importieren von Aufträgen aus Online Shops wird in diesem Artikel beschrieben.
Note
Die Telefonnummer eines Endkunden muss unbedingt im Shopauftrag eingetragen bzw. vom Endkunden angegeben sein, wenn die Lieferung eine Exportlieferung, d.h. eine Lieferung ins (Nicht)-EU-Ausland ist. Die Nummer wird beim Auftragsimport von eBay nach Xentral mit übertragen und ist dann in Xentral eindeutig einsehbar.
Stammdaten > Artikel > Artikel auswählen > Reiter Details > Unterreiter Online-Shop Optionen
Ist ein Artikel mit eBay verknüpft, findest du das -Symbol in der Spalte Menü. Klicke darauf, um das Formular Ebay Einstellungen zu öffnen.
Die Primärkategorie wird benötigt, um den Artikel in die jeweilige eBay Kategorie einzuteilen. Listest du den Artikel zum ersten Mal, wählst du eine Primärkategorie, indem du auf Suchen klickst.
Es werden Kategorievorschläge angezeigt, die auf den Standardkategorien in Xentral basieren. Falls keine Vorschläge gefunden werden oder die angezeigten Kategorien nicht zutreffen, kannst du die Suche im Bereich Manuelle Kategoriesuche nutzen, um nach einer passenden Kategorie zu suchen. Du kannst sowohl nach der Beschreibung als auch nach der Kategorien-ID suchen.
Nach Auswahl der korrekten Kategorie, werden die kategoriespezifischen Parameter angezeigt. Die kategoriespezifischen Parameter enthalten die am häufigsten ausgewählten Eigenschaften anderer Artikel in dieser Kategorie. Eigenschaften sind z.B. Größe, Modell-Reihe, Farbe, Volumen, etc. Es können auch weitere Informationen angezeigt werden.
Überprüfe bei eBay die maximale Anzahl an Zeichen, die pro Feld erlaubt sind. Gibst du mehr Zeichen als erlaubt ein, wird bei eBay keine Fehlermeldung angezeigt. Für dieses Listing wird jedoch keine Synchronisierung der Lagerzahlen durchgeführt.
Informationen zu Zahlung, Versand und Rückgabe werden in den Einstellungen der eBay-Schnittstelle festgelegt. Hier kannst du Zahlweisen und Versandarten deaktivieren, die du nicht nutzt.
Das Dropdown-Menü Template zeigt alle aktiven Templates an.
Du kannst Templates in der eBay App anlegen. Wählst du kein Template, wird der Standardtext für den Onlineshop des Artikels als Artikelbeschreibung übertragen. Wird ein Template deaktiviert oder gelöscht, welches von einem Artikel verwendet wurde, wechselt die Anzeige im Template-Menü zu Kein Template und es wird der Standardtext verwendet. Hast du ein Template deaktiviert und aktivierst es erneut, so wird das Template wieder dem Artikel zugewiesen.
Note
Zusätzliche Optionen wie Galeriebilder Plus oder Privatlisting lassen zusätzliche Kosten entstehen.
Um einen Artikel zu listen, ist mindestens ein Bild notwendig. Die Bilder, die für das Listing zur Auswahl gestellt werden, setzen sich aus den Dateien des jeweiligen Artikels zusammen. Du kannst bis zu zwölf Bilder einstellen, danach entstehen zusätzliche Kosten. Die Bilder werden dabei zu eBays eigenem Picture Hosting Service hochgeladen und dort so lange vorgehalten, solange die Auktion dauert. Zusätzlich gibt es eine Pufferzeit von 30 Tagen.
Sollte ein Bild die erforderlichen Parameter nicht erfüllen, erscheint ein Hinweis und der Artikelexport schlägt fehl.
Über die eBay Listing ID bzw. die SKU ist eine eindeutige Zuordnung von Artikeln möglich.
Um Lagerartikel von eBay in Xentral korrekt zu mappen, muss entweder die eBay Listing ID mit der Artikelnummer in Xentral übereinstimmen oder du musst diese als Fremdnummer im Artikel hinterlegen. Navigiere dafür zu Stammdaten > Artikel > Artikel auswählen > Reiter Fremdnummern und legst die Nummer mit der Bezeichnung eBayListing an.
Die ebay Listing ID findest du in der eBay App oder in der URL des auf eBay gelisteten Artikels.
Wenn du mehrere Varianten eines Artikels hast, so muss du zu jedem Variantenartikel in Xentral die passende Bestandeinheit (SKU) als Fremdnummer eintragen. Im Parentartikel (dieser hat keine SKU) trägst du weiterhin die eBay Listing ID ein. Wenn die SKU der Artikelnummer in Xentral entspricht, musst du nichts weiter eintragen. Es ist wichtig, dass du in jedem Variantenartikel die Shopverknüpfung zu eBay gesetzt hast.
Beachte bei eBay, dass du immer die korrekte Bezeichnung beim Eintragen von Fremdnummern verwendest. Diese ist für eBay Bestandseinheiten SKU oder Bestandseinheit. Für die eBay Artikelnummer ist es eBayListing.
Nachdem du die Nummern korrekt eingetragen hast, kannst du in der eBay App über die Schaltfläche Automatisch zuordnen die Artikel mappen.
Damit Artikel automatisch eBay Listings zugeordnet werden können und die richtigen Artikel in Aufträgen verknüpft werden, ist eine Zuordnung der Artikel zum entsprechenden Listing notwendig. Diese Zuordnung nimmst du in der eBay App vor.
Die Zuordnung kannst du entweder manuell im jeweiligen Listing oder automatisch vornehmen. Damit die automatische Zuordnung funktioniert, muss eine der folgenden Bedingungen erfüllt sein:
-
Im Xentral Artikel hast du eine Fremdnummer gepflegt, deren Wert mit der eBay Listing ID (eBay Artikelnummer) identisch ist (die Fremdnummer muss die Bezeichnung eBayListing haben)
-
Im eBay Listing hast du die SKU/ Bestandseinheit gepflegt und idealerweise ist diese identisch mit der Artikelnummer eines Artikels in Xentral. Ist die eBay Bestandseinheit nicht gleich der Xentral Artikelnummer, so musst du diese als Fremdnummer im entsprechenden Artikel pflegen. Die Fremdnummer muss die Bezeichnung SKU, oder Bestandseinheit haben)
Weitere Informationen findest du im folgenden Artikel: Fremdnummern in Xentral: Zuordnung externer Artikelnummern aus Shops und Marktplätzen.
Die Bedingungen sind in absteigender Priorität angeordnet. Das bedeutet, wenn ein Artikel die eBay Listing ID als Fremdnummer hinterlegt hat, dann wird dieser Artikel als Treffer herangezogen, auch wenn ein anderer Artikel die passende Artikelnummer zur Bestandseinheit des Listings hätte.
Für Varianten gibt es eine Sonderregelung. Im ersten Schritt musst du den Hauptartikel des Staging Listings (des Listings wie es in Xentral existiert) einem Artikel zuweisen. Diese Zuordnung kann manuell oder automatisiert (nach den oberen Regeln) erfolgen.
Wenn du den Hauptartikel des Staging Listings einem Xentral Artikel zugewiesen hast, dann kannst du die einzelnen Varianten zuordnen, wenn eine der folgenden Bedingungen zutrifft:
-
Im eBay Listing ist die Bestandseinheit bei der Variante gepflegt und identisch mit der Artikelnummer eines Artikels in Xentral
-
Im eBay Listing ist die Bestandseinheit gepflegt und identisch mit einer Fremdnummer eines Artikels in Xentral (die Fremdnummer muss die Bezeichnung SKU, oder Bestandseinheit haben)
-
Wenn der Hauptartikel des Staging Listings ein Matrixartikel ist und die Matrixeigenschaften und Optionen identisch mit denen in eBay sind
Die Bedingungen sind wieder in absteigender Priorität angeordnet. Für die Bedingungen 1. und 2. spielt es keine Rolle, ob der Hauptartikel des Staging Listings auch ein Hauptartikel des gefundenen Xentral Artikels ist.
Wenn ein Listing keine Zuordnung hat, dann wird dafür (theoretisch) ein Bestand von 0 übertragen. Da das Listing aber keine Artikel hat, wird nie ein Lagersync angestoßen. Bei einem Listing mit Varianten, bei dem einzelne Varianten keine Zuordnung haben, wird für die fehlenden Varianten keine Bestandsübertragung veranlasst.
Caution
Stelle sicher, dass du bei der Nutzung von Pseudo-Lagerzahlen keine negativen Lagerbestände überträgst, da diese nicht von eBay akzeptiert werden.
Aus Sicherheitsgründen ist der eBay Token nur 7 Stunden gültig und sollte daher rechtzeitig vor Ablauf verlängert werden. Am besten legst du dir einen Erinnerungstermin kurz vor Ablauf des Tokens an. Gehe wie folgt vor:
-
Lösche den vorhandenen eBay Token .
-
Speichere die geänderten Einstellungen .
-
Klicke auf Verbindung prüfen .
-
In dem sich öffnenden Dialog (ggf. musst du den PopUp Blocker deaktivieren), verbindest du erneut eBay mit Xentral.
-
Klicke im Bereich Aktion auf REST Token anfordern. Du wirst zu eBay weitergeleitet.
Note
Der Token darf ausschließlich im Bereich Aktion angefordert werden. Sollte oben ein Link zur Erneuerung des Token auftauchen, ignoriere ihn bitte.
-
Melde dich mit deinem Verkäufer-Konto an.
-
eBay bittet dich, die Authentifizierung zu bestätigen. Klicke auf Ich stimme zu. Du wirst zu Xentral weitergeleitet.
-
Klicke auf Speichern. Die Verbindung über die REST API ist nun aktiviert.
-
Klicke im Bereich Aktion auf Verbindung überprüfen, um die Verbindung zu überprüfen.
Solltest du immer noch Probleme mit deinem Token haben, könnte es ein Problem mit der Authentifizierungs-URL in deinem eBay Developer-Konto geben. Stelle sicher, dass das Feld Your auth accepted URL folgendermaßen gefüllt ist:
https://<meinxentral>/index.php?module=ebay&action=rest&cmd=getToken, wobei <meinxentral> mit der URL deiner Xentral-Instanz ersetzt wird.
Bei eBay ist das tägliche Limit bei 5.000 Calls pro Tag. Solltest du mehr benötigen, empfehlen wir dir dieses Limit über den eBay Support anheben zu lassen. Damit verifizierst du die Anwendung bei eBay und erhältst bis zu 1.500.000 Calls pro Tag. Dies ist gerade für größere Verkäufer wichtig. Damit die Zertifizierung bei eBay einfacher und schneller abläuft, verweise bitte auf folgenden Musterfall bei eBay: 190319-000002.
Seit dem Brexit gibt es für dich immer noch die Möglichkeit, steuerfrei Waren über eBay aus dem Vereinigte Königreich zu bestellen. Allerdings muss die Goods and Services Tax, eine mit der Mehrwertsteuer vergleichbare Steuer, auf deinen Belegen ausgewiesen werden. Mit der Version 21.1 bietet dir Xentral Support für eben diese eBay UK Goods and Services Tax über das neue Feld Sales Tax Artikel.
-
Lege dafür einen entsprechenden Artikel über Stammdaten > Artikel mit einer eindeutigen Bezeichnung an:
-
Füge den Artikel in der eBay-Schnittstelle im Feld Sales Tax Artikel ein.
Alle Bestellungen, bei welchen eine Goods and Services Tax vorliegt, werden von Xentral erkannt und verknüpft. Abschließend erscheint diese Steuer wie ein Artikel als extra Positionszeile auf deinem Beleg.
Der eBay Nickname wird beim Auftragsimport in das Feld Interne Bezeichnung gespeichert und wird in der Zwischentabelle in der Spalte Bemerkung angezeigt.
Es ist wichtig, dass du in den Einstellungen des eBay-Kontos die "Nicht mehr vorrätig"-Option aktiviert hast.
Auf diese Weise bleibt das Angebot aktiv, wenn der Lagerbestand bei eBay null erreicht. Es wird allerdings in den Suchergebnissen ausgeblendet, bis die Stückzahl erhöht wird.
Wenn du in eBay Artikel neu bzw. relistest, sind diese im ersten Moment Xentral noch nicht bekannt. Die Zuordnung der Artikel findet in der eBay App statt. Öffne den Reiter Einstellungen und öffne dann den Unterreiter Zuordnungen.
Klicke zuerst auf Artikelliste aktualisieren und anschließend auf Artikel automatisch zuzuordnen.
Nur relevant, falls du noch die API nutzt, die vor Einführung der REST API genutzt wurde. Falls du die Verbindung über die REST API nutzen möchtest, lese bitte die in diesem Abschnitt enthaltenen Informationen zur Fehlerbehebung.
==== Doppelter Import
Xentral nutzt die eBay-Auftragsnummer, um zu prüfen, ob ein Auftrag bereits importiert wurde. Die eBay-Auftragsnummern, die über die alte API importiert wurden, sind andere als die, die über die REST API importiert werden. Dadurch kann es vorkommen, dass bereits vor der Umstellung auf REST API importierte Bestellungen erneut importiert werden.
Wir empfehlen daher, die Aufträge in der Übergangszeit über die Zwischentabelle zu importieren.
==== Telefonnummer-Formate
Mit der REST API gibt eBay die Telefonnummern der Kunden nur in dem Format aus, in dem der Kunde sie eingetragen hat, z.B. (+49176… oder 0176…). Das internationale Format der alten API wird nicht mehr angewendet.
==== Zahlungsweisen
Die REST API überträgt die Zahlungsweise als EBAY. Die alte API hat die Zahlungsweise als ebay übertragen. Dadurch greift das bestehende Mapping nicht. Du musst daher die Zahlungsweise für deine Schnittstelle(n) manuell anpassen oder hinzufügen.
==== Rabatte
Falls auf Bestellungen nur eine Rabattart vorhanden ist, z.B. Mengenrabatt, Sonderaktion oder Promotion Code, wird dieser Rabatt mit der Standardmechanik der Schnittstelle übergeben. Das heißt es ist kein dedizierter Rabattartikel erforderlich, damit die Position korrekt im Auftrag erfasst wird.
Sind mehrere Rabattarten vorhanden, werden diese nach Art zusammengefasst und als einzelne Positionen übergeben. Damit diese Mechanik funktioniert, musst du einen Rabattartikel in der eBay-Schnittstelle erfassen.
Wir empfehlen jedoch in jedem Fall, einen Rabattartikel anzulegen, auch im Hinblick auf die gesonderte Besteuerung im Vereinigten Königreich.
Der Auftragsimport bei eBay basiert auf dem letzten Änderungsdatum eines abgeschlossenen Auftrags (Status: completed). eBay hat die Informationen vorliegen, ob der Kunde den Auftrag abgeschlossen hat oder nicht.
Deshalb ist eine Abholung nach Status so wie bei anderen Shopschnittstellen bei eBay nicht möglich. Stattdessen werden alle Aufträge abgeholt, die den Status completed haben.
Beim Go-Live mit Xentral musst du am Tag des Wechsels zwischen alten und neuen Aufträgen unterscheiden. Das Folgende hat sich in der Praxis bewährt: Hole keine zu langen Zeiträume ab. Hole nur Aufträge aus der jeweiligen Woche oder Tag über die Zwischentabelle ab.
In der Zwischentabelle beim Shopimport musst du jeweils die Überschneidungen wegbuchen und nicht die Tabelle löschen. Die Tabelle ist verantwortlich dafür, dass alte Aufträge noch hereinkommen.
Um externe Entwickler bei der Löschung von Kundendaten zu unterstützen, hat eBay ein Push-Benachrichtigungssystem eingerichtet, dass alle Anwendungen im eBay Developers Program benachrichtigt, wenn ein eBay-Nutzer die Löschung seiner persönlichen Daten und die Schließung seines Kontos beantragt. Alle aktiven Anwendungen im eBay Developers Program sind verpflichtet Benachrichtigungen über die Löschung oder Schließung eines eBay-Marktplatzkontos zu abonnieren.
Um die Benachrichtigungen einzurichten, benötigst du die folgenden Informationen aus Xentral:
Der Verifizierung Token und die Benachrichtigungs Url werden automatisch erzeugt.
Zu befolgende Schritte
-
Melde dich in deinem eBay-Entwicklerkonto an.
-
Navigiere zur Seite Application Keys.
-
Klicke auf den Notifications-Link neben der App ID. Die Seite Alerts and Notifications wird angezeigt.
-
Wähle im Bereich Event Notification Delivery Method das Optionsfeld Marketplace Account Deletion.
-
Gib eine E-Mail-Adresse an. Diese E-Mail-Adresse wird nur genutzt, um Entwickler zu warnen, wenn die angegebene Benachrichtigungsendpunkt-URL nicht erreichbar ist oder Benachrichtigungen nicht korrekt angenommen werden. Klicke auf Speichern.
-
Lege die Benachrichtigungsendpunkt-URL fest, die Benachrichtigungen erhalten soll. Kopiere die Bestätigungs-URL aus Xentral und füge sie hier ein.
Note
Die Benachrichtigungs-URL muss von eBay aus zugänglich sein, das heißt:
-
ein SSL-Zertifikat ist erforderlich
-
On-premise-Kunden müssen darauf achten, dass diese URL im Internet öffentlich aufrufbar ist
-
eine Authentifizierungslogik muss für diese URL akzeptiert werden, z. B. https-Authentifizierung
-
-
Der Token zur Verifizierung wird automatisch erzeugt. Kopiere den Wert aus Xentral und füge ihn in das Feld Verification Token ein.
-
Sobald die Benachrichtigungsendpunkt-URL und der Wert des Verifikations-Token eingetragen sind, klicke auf Speichern.
-
Nachdem du die Benachrichtigungen zur Löschung/ Schließung eines eBay-Marktplatzkontos abonniert hast, kannst du eine Test-Benachrichtigung senden, indem du auf Send Test Notification klickst. Sobald die Endpunkt-URL die Test-Benachrichtigung erfolgreich empfangen hat, ist die Einrichtung abgeschlossen. Deine Anwendung sollte ab sofort Benachrichtigungen zur Löschung/ Schließung eines eBay-Marktplatzkontos empfangen.