Anbindung an Ebay herstellen

Nachfolgend sehen Sie die wesentlichen Schritte für die Anbindung:
 

• Erstellen Sie einen Entwickleraccount bei Ebay (https://developer.ebay.com/api-docs/static/creating-edp-account.html )
• Entnehmen Sie dem Account die folgenden Schlüsselsets und tragen Sie diese in den Ebay-Importer ein:

 

• Zusätzlich zu den Schlüsselsets müssen Sie nun noch den "runame" (Ebay Redirect URL name) suchen. Hierzu klicken Sie auf "User Tokens" und gelangen im Anschluss auf folgenden Seite:

 

• Bitte tragen Sie den runame in die Schnittstelle von Xentral ein.
• Im Anschluss einmal auf Verbindung prüfen klicken. Nun wird Ihnen eine Link in einer rot hinterlegten Meldung angezeigt, die Sie in einem neuen Tab aufrufen. Hier müssen Sie sich bei Ebay anmelden und die nachfolgenden Meldungen bestätigen.
• Sobald alles bestätigt wurde, drücken Sie den "Verbindung prüfen"-Button erneut. Nun sollte der "userTokenShop" in folgendes Feld gezogen werden:

Im Anschluss können Sie über den Button "Aufräge abholen" je nach Import Modus die ersten Aufträge abholen. Bei der Auftragsabholung sind folgende Punkte zu beachten:

• 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 Demomodus wird maximal ein Auftrag abgeholt und die Abholzeit wird nicht geändert
• der maximale Zeitraum für das Abholen von Aufträgen ist eBayseitig 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 eine "Sackgasse" gerät und keine neueren Aufträge abholen kann selbst wenn diese vorhanden sind. In einem solchen Fall muss das Abholdatum manuell geändert werden

Ebay Einstellung

 

• Protokollierung im Logfile: Erstellt Einträge im Logfile. Dadurch kann im Falle eines Fehlers im Nachhinein die Ursache leichter gefunden werden.
• Mehrfachanzeige von abgeholten Aufträgen blockieren: (Einrichtungsmodus) verhindert, dass derselbe Auftrag zweimal importiert wird.
• Verschickte Bestellungen übergehen: Beim Auftragsimport solche Bestellungen ignorieren die bereits verschickt Verhindert, dass bereits verschickte Bestellungen nochmals importiert und doppelt verschickt werden, wenn der Importer eingesetzt wird, nachdem bereits zuvor auf eBay Handel betrieben wurde.
• eBay Name des Käufers in Auftrag übernehmen: eBay Name des Käufers in Auftrag übernehmen.
• Rahmenbedingungen verwenden: Rahmenbedingungen verwenden.
• Warnungen ausgeben: Warnungen zu Auktionen ausgeben oder verschlucken. Warnungen sind Meldungen die eine Auktionserstellung nicht verhindern, aber auf einen Umstand hinweisen, der angepasst werden sollte.
• Unbezahlte Bestellungen abholen: Unbezahlte Bestellungen abholen. Sollte nicht ohne den entsprechenden Cronjob 'shopimporter_checkorder' verwendet werden.
• Listing ohne Bestand automatisch beenden: Listing ohne Bestand automatisch beenden.

eBay Token erneuern

Aus Sicherheitsgründen ist der eBay Token immer nur 18 Monate gültig und sollte daher rechtzeitig vor Ablauf verlängert werden. Am besten Sie legen sich einen Termin kurz vor Ablauf des Token an.Bitte gehen Sie wie folgt vor:

1. löschen Sie den vorhandenen eBay Token raus
2. speichern Sie die geänderten Einstellungen
3. klicken Sie auf „Verbindung prüfen“
4. in dem Dialog der sich in einem extra Fenster öffnet (ggf. PopUp Blocker deaktivieren) verbinden Sie bitte erneut eBay mit Xentral.

Call Limit der API von eBay

Bei eBay ist das tägliche Limit bei 5.000 Calls pro Tag. Sollten Sie mehr benötigen empfehlen wir Ihnen dieses Limit über den eBay Support anheben zu lassen. Damit verifizieren Sie die Anwendung bei eBay und erhalten bis zu 1.500.000 Calls pro Tag. Dies ist gerade für größerer Verkäufer wichtig. Damit die Zertifizierung bei eBay ohne Probleme und schneller durchläuft verweisen Sie bitte auf folgenden Muster Fall bei eBay. Die Fallnummer die als Referenz dient lautet 190319-000002.
 

Ebay App

Die eBay App befindet sich im App Store und wird zusammen mit dem eBay Importer zur Verfügung gestellt. Sie ist unter Umständen für die Verwendung des Importers zwingend erforderlich, beinhaltet aber auf jeden Fall nützliche Features für die Verwendung des Importers.
 

Auktionsübersicht

Über die App ist es möglich alle gegenwärtig laufenden Listings auf einen Blick einzusehen. Über die Schaltfläche 'Anzeige herunterladen' werden die aktiven Listings heruntergeladen bzw. in der Anzeige aktualisiert falls sie bereits vorhanden sind.




Für alle Listings für die ein verknüpfter Artikel erkannt wird, gibt es die Option die Stapelverarbeitung zu nutzen. Dabei können alle ausgewählten Listings mit einem Knopfdruck aktualisiert, bzw. neu eingestellt werden.



 

Templates

Für die Verwendung von Vorlagen wird in der App ein neues Template angelegt (Administration → AppStore → Ebay).


Hier wird der HTML Code des Templates eingetragen. Mögliche Wildcardfelder die bei der Übertragung mit den entsprechenden Werten aus den Artikeldaten ersetzt werden stehen am unteren Fensterrand. XX am Ende eines Wildcardfeldes kann für die Initialisierung verwendet werden. Beispielsweise kann das Länderkürzel (z.B. FR) statt XX eingesetzt werden, dadurch wird das entsprechende Wildcardfeld auf französisch übersetzt (Voraussetzung hierfür ist, dass der französische Wert hinterlegt ist). Alternativ kann das XX stehen bleiben, dann wird automatisch die Sprache genutzt die im Ebay Listing eingestellt ist.





Templates mit IF-Verzweigung

Templates können auch {IF}-Verzweigungen enthalten, um festzulegen, dass ein Inhalt nur dargestellt werden soll, wenn eine bestimmte Bedingung erfüllt ist.

In folgendem Beispiel soll der Hersteller eines Artikels angegeben werden. Ist im Artikel kein Hersteller gepflegt, sollen stattdessen die Informationen aus dem Kurztext gezeigt werden. Ist auch hier nichts gepflegt, soll der Satz "Leider gibt es zu diesem Artikel keine weiteren Informationen" angezeigt werden.

Das Template wird unten um eine entsprechende IF-Verzweigung ergänzt.




Im Artikel ist hier kein Hersteller und kein Kurztext gepflegt.





Da die beiden {IF}-Bedingungen nicht zutreffen, wird das Template daher den {ELSE}-Fall ziehen und den definierten Text anzeigen.




Wichtig: Seit März 2018 werden Artikelbeschreibungen, die keine HTTPS-Inhalte beinhalten, von eBay automatisch hinter einem Button versteckt der zur kompletten Artikelbeschreibung führt. Sollte dieses Verhalten auftreten muss das Template entsprechend angepasst werden.
 

Rahmenbedinungen

eBay empfiehlt für die Verwendung von Listings Rahmenbedingungen. Die Rahmenbedingungen, sowie die Verwendung dieser, können in den Kontoeinstellungen von eBay eingestellt werden. Rahmenbedinungen dienen dazu Versand-, Zahlung- und Rückgabedaten zu vereinheitlichen und vereinfachen, da diese nicht mehr separat für jeden Artikel eingestellt werden müssen sondern im Artikel aus einer Gruppe von Optionen ausgewählt werden können. Für die Verwendung in Xentral muss zunächst in den Importereinstellungen die Checkbox für die Verwendung der Rahmenbedingungen aktiviert werden. Anschließend können im zweiten Tab der App die Rahmenbedingungen heruntergeladen werden. Sobald die Rahmenbedingungen heruntergeladen wurden können ihre Namen geändert werden um in den Artikeleinstellungen sprechendere Bezeichnung zur Verfügung zu haben. Eine Änderung des tatsächlichen Inhalts der Rahmenbedingung muss derzeit noch direkt in eBay erfolgen.


 

Zuordnungen

Falls vor der Verwendung des eBay Importers bereits Handel auf eBay getrieben wurde ist möglich auf die bereits bestehenden Listings zurückzugreifen um so bestehende Produktbewertungen weiter verwenden zu können. Hierzu können im dritten Tab der eBay App die noch mit dem Konto verknüpften Listings heruntergeladen werden.



Bei Artikeln die mit SKU übertragen werden wird ein automatisches Mapping über die EAN versucht. Sollten korrekte Zuordnungen gefunden werden, werden diese angezeigt. Sollte die automatische Zuordnung nicht korrekt, oder keine gefunden worden sein, kann über das Editiericon die Zuordnungen händisch geändert bzw. ignoriert werden.



Nachdem die Zuordnungen zufriedenstellend eingestellt worden sind kann über den Button "Artikel automatisch zuordnen" die Zuordnung in den Fremdnummern eingetragen werden. Erst dann ist die Zuordnung funktional.
 

Versand

Über das vierte Tab der eBay App können Versanddienstleister den einzelnen Versandarten zugeordnet werden. Falls keine Rahmenbedingungen benutzt werden ist es zwingend notwendig hier Verknüpfungen für die zu benutzenden Versandarten vorzunehmen, da sonst nur die Versandart "Selbstabholung" zur Verfügung steht.




Nach dem Herunterladen der verfügbaren Versanddienstleister kann über das Editiericon eine Zuordnung durchgeführt werden.

Wichtig für die Rückmeldung von Trackingdaten: Für die Rückmeldung wird zunächst versucht über die eingestellte Versandart an eBay zu melden. Sollte die Versandart aber keinem bekannten Carrier entsprechen schlägt der Versand fehl. In solchem Fall ist es notwendig die Versandarten entsprechend anzupassen. Ferner kann es sein, dass die von eBay übermittelten Carriern nicht der angegebenen Beschreibung entsprechen. Das äußert sich dadurch dass der Carrier nicht der Beschreibung entspricht. Beispielswesie würde DHL als Carrier angegeben, aber DPD in der Beschreibung erwähnt. In einem solchen Fall muss der Carrier überschrieben werden damit die Rückmeldung korrekt funktioniert.
 

Ebay-Einstellungen im Artikel

Wenn der Artikel mit Ebay verknüpft ist, bekommen Sie unter Stammdaten → Artikel → Artikel auswählen → Details → Online Shop Optionen ein Zahnrad- Button für die Ebay-Einstellungen angezeigt.




Die Primärkategorie wird benötigt um den Artikel in die jeweilige eBay Kategorie einzuteilen. Um den Artikel das erste mal über eine Auktion einzustellen muss die Primärkategorie ausgewählt werden.




Beim Öffnen der Suche werden Kategorievorschläge anzeigt die aus der Standardkategoriebezeichnung von Xentral generiert wurden. Sollte keine passende Kategorie angezeigt werden, so ist eine manuelle Suche möglich:



Nach einem Klick auf die korrekte Kategorie werden die kategoriespezifischen Parameter geladen:



Die Kategoriespezifischen Parameter setzen sich zusammen aus den meistgewählten Eigenschaften der anderen Artikel dieser Kategorie. Wo verfügbar werden zusätzliche Informationen angezeigt.Zahlungsweise sowie Versand werden in den Einstellungen des Importers festgelegt. Dort können Zahlungsweisen und Versandarten die nicht erwünscht sind abgewählt werden.



Die Templates zeigen die aktiven Vorlagen die in der eBay App erstellt wurden. Sollte kein Template gewählt werden, wird nur der Standard Online-Shop Text des Artikels als Artikelbeschreibung übertragen. Sollte ein Template das ein Artikel verwendet gelöscht oder deaktiviert werden wird der Artikel auf "Kein Template" geändert und es wird nur der Online-Shop Text übertragen. Sollte das Template nur inaktiv gesetzt worden sein und reaktiviert werden, wird dem Artikel das Template wieder zugeordnet.
Hinweis: Zusätzliche Optionen wie Galleriebilder Plus, oder Privatlisting lassen zusätzliche Kosten entstehen.

Für das einstellen eines Artikels ist mindestens ein Bild notwendig. Die Bilder die für das Listing zur Auswahl gestellt werden setzen sich aus den Dateien des jeweiligen Artikels die als "Standard Artikelbilder", bzw. "Shopbild" (sowie ab 18.3 "Bild", "Druckbild", "Gruppenbild" und "Etikettenbild") hinterlegt sind zusammen.Es können bis zu zwölf Bilder eingestellt werden, 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 zuzüglich einer Pufferzeit von 30 Tagen.




Sollte ein Bild die erforderlichen Parameter nicht erfüllen, wird eine Hinweismeldung zum Bild ausgegeben. In einem solchen Fall schlägt der Artikelexport fehl wenn das Bild für die Übertragung ausgewählt wurde.

Fremdnummern im Artikel

Relist/Revise: Wenn ein Artikel erfolgreich eingestellt wurde, wird seine eindeutige Identifikationsnummer in den Fremdnummern des Artikels eingetragen. Über diese Nummer ist eine eindeutige Zuordnung des Artikels möglich.




Für Kunden die bereits Artikel in ihren Shops haben ist es möglich über die eBay App alte Listings herunterzuladen und mit den Artikeln im System zu verknüpfen. Dadurch können Bewertungen von bestehenden Listings übernommen werden.

Verwendung

Artikelkategorie angeben

Artikelkategorie Suche: es können direkt Kategorie IDs eingeben werden. Über diese werden die Kategorien dann gesucht. (Zahl eingeben in die Suche)


 

Ebay Nickname

Der Ebay Nickname wird in das Feld "interne Bezeichnung" gespeichert und wird in der "Shopimport Zwischentabelle" in der Bemerkung angezeigt.

 

Go-Live Praxistipp

Beim Shopimport von Ebay abgeholt wird nach dem letzten Änderungsdatum eines fertiggestellten Auftrags (einer fertiggestellten Ebay Bestellung). Der Status, den Xentral abholt ist "completed".
→ Ebay hat folgende Informationen vorliegen: „Hat der Kunde die Transaktion abgeschlossen oder nicht".

Deshalb ist eine Abholung nach Status so wie bei anderen Shopschnittstellen bei Ebay nicht möglich. Stattdessen werden alle Aufträge/Bestellungen abgeholt, die "completed" als Status haben.

Beim Go-Live für den Wechsel auf Xentral muss am Tag der Umstellung daher ein "Schnitt" zwischen den alten und den neuen Bestellungen getätigt werden.
Folgendes hat sich in der Praxis meist bewährt: Keinen zu langen Zeitraum abholen, sondern ggf. genau ab dieser Woche/diesem Tag per Mausklick in die Shop-Zwischentabelle die Aufträge abholen. Wenn ein Ebay-Auftrag aktualisiert wird, kommt er mit dem Aktualsisierungsdatum herein, daher wird auch ein heute aktualisierter Auftrag heute mit abgeholt, das Abholdatum sollte entsprechend auf "heute" eingestellt sein.

Hier sind in der Zwischentabelle beim Shopimport jeweils die Überschneidungen wegzubuchen und nicht die Tabelle "löschen", denn die Tabelle ist dann ausschlaggebend ob alte Aufträge noch hereinkommen.