mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-25 06:00:28 +01:00
1 line
23 KiB
Plaintext
1 line
23 KiB
Plaintext
<strong><span style="font-size:28px;">Ebay Schnittstelle - Installation & Einrichtung</span></strong><br /> <h1>Übersicht</h1><br />Um Ebay in Xentral integrieren zu können, sind mehrere Schritte nötig. Xentral bindet externe Shops, auch wenn diese extra APIs anbieten immer über einen Xentral Shop-Importer an. Das ist die genormte Schnittstelle für Xentral. In dieser Schnittstelle wird dann auf die echte API vom Shop zugegriffen. Aber die Kommunikation mit Xentral geschieht immer über den Importer.<br /><br /> <div class="video-box youtube-video"><span class="wiki-text"><iframe allowfullscreen="" frameborder="0" src="https://www.youtube.com/embed/49PICIq3XP8"></iframe><br /> </span><h1><span class="wiki-text">Anbindung an Ebay herstellen</span></h1><br /><span class="wiki-text">Nachfolgend sehen Sie die wesentlichen Schritte für die Anbindung:<br /> </span><ul><li><span class="wiki-text">Erstellen Sie einen Entwickleraccount bei Ebay (<a href="https://developer.ebay.com/api-docs/static/creating-edp-account.html">https://developer.ebay.com/api-docs/static/creating-edp-account.html</a> )</span></li><li><span class="wiki-text">Entnehmen Sie dem Account die folgenden Schlüsselsets und tragen Sie diese in den Ebay-Importer ein:</span></li></ul><span class="wiki-text"> <img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=1" /><br /> </span><ul><li><span class="wiki-text">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:</span></li></ul><span class="wiki-text"> </span><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=2" /></span><ul><li>Bitte tragen Sie den runame in die Schnittstelle von Xentral ein.</li><li>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 <span class="highlight" rel="Ebay">Ebay</span> anmelden und die nachfolgenden Meldungen bestätigen.</li><li>Sobald alles bestätigt wurde, drücken Sie den "Verbindung prüfen"-Button erneut. Nun sollte der "userTokenShop" in folgendes Feld gezogen werden:</li></ul><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=3801" style="width: 1828px; height: 781px;" /><br /><br /><br /><span class="wiki-text">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:</span><ul><li>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</li><li>beim Abholen über den Demomodus wird maximal ein Auftrag abgeholt und die Abholzeit wird nicht geändert</li><li>der maximale Zeitraum für das Abholen von Aufträgen ist <span class="highlight" rel="eBay">eBay</span>seitig 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</li></ul><h1><span class="wiki-text">Ebay Einstellung</span></h1><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=4" /><br /> </span><ul><li>Protokollierung im Logfile: Erstellt Einträge im Logfile. Dadurch kann im Falle eines Fehlers im Nachhinein die Ursache leichter gefunden werden.</li><li>Mehrfachanzeige von abgeholten Aufträgen blockieren: (Einrichtungsmodus) verhindert, dass derselbe Auftrag zweimal importiert wird.</li><li>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 <span class="highlight" rel="eBay">eBay</span> Handel betrieben wurde.</li><li><span class="highlight" rel="eBay">eBay</span> Name des Käufers in Auftrag übernehmen: <span class="highlight" rel="eBay">eBay</span> Name des Käufers in Auftrag übernehmen.</li><li>Rahmenbedingungen verwenden: Rahmenbedingungen verwenden.</li><li>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.</li><li><strong>Unbezahlte Bestellungen</strong> abholen: Unbezahlte Bestellungen abholen. Sollte nicht ohne den entsprechenden Cronjob <strong>'shopimporter_checkorder'</strong> verwendet werden.</li><li>Listing ohne Bestand automatisch beenden: Listing ohne Bestand automatisch beenden.</li></ul><h1><br /><span class="wiki-text">eBay Token erneuern</span></h1><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=5" /><br /><br />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:</span><ol><li>löschen Sie den vorhandenen <span class="highlight" rel="eBay">eBay</span> Token raus</li><li>speichern Sie die geänderten Einstellungen</li><li>klicken Sie auf „Verbindung prüfen“</li><li>in dem Dialog der sich in einem extra Fenster öffnet (ggf. PopUp Blocker deaktivieren) verbinden Sie bitte erneut <span class="highlight" rel="eBay">eBay</span> mit Xentral.</li></ol><span class="wiki-text"><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=3803" style="width: 1113px; height: 190px;" /></span><h1><br /><span class="wiki-text">Call Limit der API von eBay</span></h1><span class="wiki-text">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 <strong>bis zu 1.500.000 Calls pro Tag</strong>. 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. <strong>Die Fallnummer die als Referenz dient lautet 190319-000002</strong>.<br /> </span><h1><span class="wiki-text">Ebay App</span></h1><br /><span class="wiki-text">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.</span><br /> <h2><span class="wiki-text">Auktionsübersicht</span></h2><span class="wiki-text">Ü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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=7" /><br /><br /><br />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.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=8" /><br /> </span><h2><span class="wiki-text">Templates</span></h2><br /><span class="wiki-text">Für die Verwendung von Vorlagen wird in der App ein neues Template angelegt (Administration </span>→<span class="wiki-text"> AppStore </span>→<span class="wiki-text"> Ebay).<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=3805" style="width: 1829px; height: 328px;" /><br />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.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=10" /><br /><br /><br /><span style="font-size:16px;"><strong>Templates mit IF-Verzweigung</strong></span><br /><br />Templates können auch </span><strong>{IF}-Verzweigungen</strong> enthalten, um festzulegen, dass ein Inhalt nur dargestellt werden soll, wenn eine bestimmte Bedingung erfüllt ist.<br /><br /><span class="wiki-text">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.<br /><br />Das Template wird unten um eine entsprechende IF-Verzweigung ergänzt.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=2759" style="width: 1200px; height: 514px;" /><br /><br /><br />Im Artikel ist hier kein Hersteller und kein Kurztext gepflegt.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=2761" style="width: 800px; height: 718px;" /><br /><br /><br /><br />Da die beiden {IF}-Bedingungen nicht zutreffen, wird das Template daher den {ELSE}-Fall ziehen und den definierten Text anzeigen.<br /><br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=2760" style="width: 600px; height: 272px;" /><br /><br /><strong><span style="color:#e74c3c;">Wichtig: </span>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.</strong><br /> </span><h2><span class="wiki-text">Rahmenbedinungen</span></h2><span class="wiki-text">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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=11" /><br /> </span><h2><br /><span class="wiki-text">Zuordnungen</span></h2><br /><span class="wiki-text">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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=12" /><br /><br />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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=13" /><br /><br />Nachdem die Zuordnungen zufriedenstellend eingestellt worden sind kann über den Button "Artikel automatisch zuordnen" die Zuordnung in den Fremdnummern eingetragen werden. <strong>Erst dann ist die Zuordnung funktional</strong>. <img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=14" /><br /> </span><h2><span class="wiki-text">Versand</span></h2><br /><span class="wiki-text">Ü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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=15" /><br /><br /><br />Nach dem Herunterladen der verfügbaren Versanddienstleister kann über das Editiericon eine Zuordnung durchgeführt werden.<br /><br /><strong>Wichtig für die Rückmeldung von Trackingdaten</strong>: 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.<br /> </span><h1><span class="wiki-text">Ebay-Einstellungen im Artikel</span></h1><br /><span class="wiki-text">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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=16" /><br /><br /><br />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.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=17" /><br /><br />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:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=18" /><br /><br />Nach einem Klick auf die korrekte Kategorie werden die kategoriespezifischen Parameter geladen:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=19" /><br /><br />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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=20" /><br /><br />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.<br /><strong>Hinweis</strong>: Zusätzliche Optionen wie Galleriebilder Plus, oder Privatlisting lassen zusätzliche Kosten entstehen.<br /><br />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.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=21" /><br /><br />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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=22" /></span><h2><span class="wiki-text">Fremdnummern im Artikel</span></h2><br /><span class="wiki-text">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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=23" /><br /><br /><br />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.</span><h1><span class="wiki-text">Verwendung</span></h1><h2><span class="wiki-text">Artikelkategorie angeben</span></h2><br /><span class="wiki-text">Artikelkategorie Suche: es können direkt Kategorie IDs eingeben werden. Über diese werden die Kategorien dann gesucht. (Zahl eingeben in die Suche)<br /><br /><img height="111" src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=24" width="1226" /><br /> </span><h2><span class="wiki-text">Ebay Nickname</span></h2><br /><span class="wiki-text">Der Ebay Nickname wird in das Feld "interne Bezeichnung" gespeichert und wird in der "Shopimport Zwischentabelle" in der Bemerkung angezeigt.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_ebay&fileid=25" /></span><h2><br /> </h2><h1><span class="wiki-text">Go-Live Praxistipp</span></h1><br /><span class="wiki-text">Beim Shopimport von Ebay abgeholt wird nach dem letzten Änderungsdatum eines fertiggestellten Auftrags (einer fertiggestellten Ebay Bestellung). Der Status, den Xentral abholt ist <strong>"completed"</strong>.<br />→ Ebay hat folgende Informationen vorliegen: „Hat der Kunde die Transaktion abgeschlossen oder nicht".<br /><br />Deshalb ist eine Abholung nach Status so wie bei anderen Shopschnittstellen bei Ebay nicht möglich. Stattdessen werden alle Aufträge/Bestellungen abgeholt, die <strong>"completed"</strong> als Status haben.<br /><br />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.<br />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 <strong>"heute"</strong> eingestellt sein.<br /><br />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. </span><span class="wiki-text"> </span></div> |