Konfiguration der Schnittstelle (ebay)

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche

Vorlage:Sidebox-ebay


Templ info-blk.png
Die Initialeinrichtung der ebay-Schnittstelle wird im Kapitel Prozesse beschrieben.


Reiter Artikel

Ebay config-artikel.png


Text für die Beschreibung aus..
Hier lässt sich wählen, welcher Inhalt für die Artikelbeschreibung auf eBay verwendet werden soll.
Zur Auswahl stehen Lang- und Dimensionstext sowie der HTML-Text.
Adresse zum Berechnen der Preise 🔍
Die hier gewählte und hinterlegte Adresse dient ausschließlich dazu, um die im Kundenstamm hinterlegte VK-Gruppe für eBay zu nutzen. Wird also eine Adresse gewählt, der die VK-Gruppe 3 zugewiesen wurde, wird bei der Erstellung und Aktualisierung von ebay-Listings automatisch der VK3 genutzt.
Durch einen Klick auf den Button mit der Lupe öffnet sich eine Adressensuche. Es empfiehlt sich also, eine Dummy-Adresse für eBay festzulegen. Wird hier keine Adresse definiert, wird für eBay-Listings automatisch die VK-Gruppe 1 genutzt, sofern der Preis nicht manuell im Listing geändert wird.
Lagerbestand
Im linken Bereich wird festgelegt, aus welchem Lagerort der Lagerbestand für ebay-Listings herangezogen wird. Buchungen von eBay-Aufträgen finden ebenfalls auf den gewählten Lagerort statt.
aus folgendem Lagerort
Wird diese Option gewählt, muss anschließend im rechten Bereich der Button "Lagerort" 🔍 geklickt werden, um den gewünschten Lagerort festzulegen.
aus dem Lagerort der Filiale
Wird die Option gewählt, muss im nächsten Schritt der Button "Filiale" 🔍 genutzt werden, um die gewünschte Filiale auszuwählen. Bei dieser Option werden die Bestände alle dieser Filiale zugewiesenen Lagerorte zusammengerechnet, um den Bestand zu ermitteln.
Bestandsreserve in %
Die Bestandsreserve sorgt dafür, dass nicht der komplette Lagerbestand an eBay übertragen wird. Sie gilt dabei als Prozentwert des zum Zeitpunkt der Bestandsaktualisierung (zu eBay) vorhandenen Lagerbestandes.
Templ bsp-blk.png
Von einem Artikel sind 10 Stück auf Lager und es wurde eine Bestandsreserve von 10% gewählt. Somit wird an eBay ein Bestand von 9 übermittelt. Bei der nächsten Bestandsaktualisierung sind noch 5 Stück auf Lager. Die Bestandsreserve ist nun 0,5 Stück; hierbei wird aufgerundet, wodurch nun nurnoch 4 Stück zu eBay übertragen werden.

Währung

Hier wird die in eBay verwendete Währung festgelegt.

Sprache

Dieser Button erlaubt die Wahl der genutzten Sprache. Dadurch ist es möglich, im Artikelstamm Artikelbeschreibungen festzulegen (etwa, indem in e-vendo eine Sprache "eBay" angelegt wird), die speziell für eBay aufbereitet werden.

Produktkategorien

Dieser Button erlaubt das Betrachten von ebays Browse Node, also des kompletten Kategoriebaumes der Plattform.
Templ info-blk.png
Der Kategoriebaum von ebay ist sehr groß. Daher kann es bei der Wahl einer Kategorie bis zu einer Minute dauern, bis sämtliche Unterkategorien geladen und angezeigt werden.
Shop-URL (CSS, Vorschaubilder)
Hier muss die URL Ihres e-vendo-Shops eingetragen werden, damit das eBay-CSS (für die Gestaltung der Listingbeschreibung) sowie die Artikelbilder ordnungsgemäß zu eBay übertragen werden können.
Die Syntax ist bspw. https://www.e-vendo.de
Shop-Parameter
Dieses Feld muss den internen Namen des Shops beinhalten. Dieser kann nachgeschlagen werden, indem das Shop-Management aufgerufen wird. Oben rechts stehen dann einige Informationen, u.a. auch der Shop-Parameter.
Für unseren Demo-Shop sieht das so aus:
Ebay config-parameter.png
Der Shop-Parameter ist hier demo.
Artikel als Sperrgut gekennzeichnet: folgende Versandart
An dieser Stelle können spezielle Versandarten für den Versand von Sperrgut für den In- und Auslandsversand festgelegt werden.
Vorgaben für den Import der Artikel aus eBay-Marktplatz
An dieser Stelle werden die Profile und das Template für den Import von bestehenden Listings in e-vendo definiert. Somit werden importierten Listings die hier festgelegten Eigenschaften zugewiesen.
Wird ein Listing in e-vendo importiert, werden ihm die hier festgelegten Profile und das Template zugewiesen, sofern festgelegt.
Templ info-blk.png
Um ein bereits definiertes Template oder Profil zu entfernen, muss zuerst der Button für die Suchabfrage 🔍 geklickt und anschließend der Button "Abbrechen" gewählt werden.
Weitere Informationen zu Profilen und Templates sind hier zu finden.
Kategorie: Artikelmerkmale vor der Übertragung aktualisieren
Wenn diese Checkbox aktiviert ist, werden die Eigenschaften der Listing-Kategorien vor dem Senden zu eBay neu eingelesen bzw. aktualisiert.
  • Sind eBay-Kategorieeigenschaften mit e-vendo-Daten (bspw. Artikeleigenschaften, Herstellernummern etc.) verknüpft, werden diese neu eingelesen. Wird bei einer solchen Verknüpfung kein Eintrag gefunden, wird das von eBay geforderte "nicht zutreffend" gesetzt.
  • Wurden in die eBay-Klasseneigenschaften manuell Daten eingetragen (Spalte "Eigenschaftswert"), so werden diese nicht überschrieben, sondern bleiben erhalten.
  • Werden Felder in den eBay-Klasseneigenschaften freigelassen (es wurden also weder Eigenschaftswerte eingetragen noch Artikeleigenschaften verknüpft), werden diese nicht aktualisiert.
Templ info-blk.png
Diese Funktionalität ist nur dann nutzbar, wenn dem Artikel eine Eigenschaftsklasse zugewiesen wurde.
bei Listungen von einzelnen Variantenartikeln den Titel um die Variantenbezeichnung ergänzen
Wird diese Checkbox aktiviert, wird beim Listing von Variantenartikeln die Bezeichnung aus der Kurzbezeichnung und den Variantenbezeichnungen zusammengesetzt.
Syntax: [Kurzbezeichnung] [Variantenbezeichnung 1]/[Variantenbezeichnung n]
Ergebnis: Fahrrad 26"/blau

Eing.-Verlinkung

Hinter diesem Button befinden sich die bisher vorgenommenen Verknüpfungen von Artikeleigenschaften (e-vendo) mit den zugehörigen Kategorieeigenschaften (eBay), die bei der Aufbereitung von Artikeln zugewiesen werden können. Verknüpfungen lassen sich hier nur löschen. Das Erstellen einer Verknüpfung findet in der Konfiguration des Listings statt.


Listinggruppen Rückgabeprofile Versandprofile Zahlartprofile Template
Hinter diesen Buttons befinden sich Optionen für die Anlage und Verwaltung von Profilen für einzelne Bereiche, dies es ermöglichen, einem Listing ein Optionenprofil zuzweisen, statt jede Option manuell setzen zu müssen.
Sie werden ausführlich im Bereich Profile, Gruppen & Templates behandelt, welches durch einen Klick auf diese Box aufgerufen wird.


Reiter Belegvorgaben

Ebay config-beleg.png


automatisch Lieferschein anlegen und entsprechend der Einstellungen reservieren
Durch diese Einstellung werden beim Auftragsimport zusätzlich zum Auftrag auch der Lieferschein angelegt und die Artikel reserviert. Ob der Auftrag manuell oder via Automatismus importiert wurde, ist dabei irrelevant.
eMail-Adresse für den automatischen Rechnungsversand in der Adresse speichern
Wird dieses Option aktiviert, wird die von ebay übermittelte eMail-Adresse im Kundenstamm im Reiter "Faktura (Deb.)" eingetragen.
nach dem Import automatisch eine Auftragsbestätigungsmail versenden
Diese Einstellung sorgt dafür, dass - wenn aktiv - nach dem Auftragsimport eine Bestätigungs-eMail an den Kunden versendet wird.
eMail-Adresse für Paypal-Zahlungen
An dieser Stelle muss die bei Paypal hinterlegte eMail-Adresse eingetragen werden.
durchschnittliche Bearbeitungszeit
Hier wird die Zeit in Tagen eingetragen, welche Sie durchschnittlich vom Auftragseingang bis zum Versand benötigen.

Default Versandart

Beim Import von eBay-Aufträgen steht nicht immer direkt die gewünschte Versandart zur Verfügung; etwa, weil der Kunde den Auftrag bereits ausgelöst, aber noch keine Zahlart definiert hat.
Mit dieser Option lässt sich eine Versandart für solche ausstehenden Belege wählen. Diese wird später vom System angepasst, sofern neue Daten verfügbar sind.

Default Zahlart

Auch die gewünschte Zahlart steht nicht immer sofort zur Verfügung. Mit dieser Option lässt sich eine Zahlart für solche ausstehenden Belege wählen. Auch diese wird später vom System angepasst, sofern neue Daten verfügbar sind.
Templ info-blk.png
Es empfiehlt sich, sowohl eine Zahl- als auch eine Versandart für solche Fälle zu erstellen, welche dem Nutzer anzeigt, dass die entsprechenden Zahlungs- oder Versandinformationen noch nicht vorliegen. Diese kann bspw. "ausstehend" heißen und sollte ausschließlich dazu da sein, damit das ebay-Modul beim Auftragsimport diese selbst entsprechenden Belegen zuweisen kann.
die eBay-Gebühren in den Einkaufspreis zur Ertragskalkulation im Auftrag übernehmen
Bei Aktivierung dieser Option werden von ebay übermittelte Gebühren in die Ertragskalkulation des importierten Beleges aufgenommen. Bitte beachten Sie, dass wir keinen Einfluss darauf haben, wann welche Gebühren übertragen werden.
ebay Nachrichtenkommunikation aktivieren
Das Setzen dieses Hakens ermöglicht es, die eBay-Kundenkommunikation über das e-vendo-eMailsystem abzuwickeln. Eingehende Nachrichten von Kunden werden dann im Posteingang erfasst und können dort beantwortet werden.
Templ att-blk.png
Es werden nur Nachrichten mit einem Auftrags- oder Listing-Bezug importiert. Foreneinträge, ebay-Werbenachrichten, Nachrichten von Bietern etc. werden nicht heruntergeladen und müssen weiterhin in der ebay-Nachrichtenzentrale bearbeitet werden.
eBay Mitgliedsnamen in folgendes benutzerdefiniertes Feld speichern
Die Einstellung erlaubt es, den eBay-Nutzernamen in ein zu definierendes Feld zu schreiben. Hier stehen die Datenbankfelder FIELD1 bis FIELD10 zur Verfügung.
Diese Felder sind in der Adressenverwaltung im benutzerdefinierten Reiter zu finden und lassen sich in der ERP-Konfiguration definieren.
Damit der Name auch im entsprechenden Feld angezeigt wird, muss dieses in der Konfiguration aktiviert werden und einen Namen zugewiesen bekommen.
Diese Artikelnummer verwenden, wenn Artikel nicht in den Stammdaten vorhanden ist
Wird bei einem Auftragsimport ein von eBay übermittelter Artikel nicht in der e-vendo-Datenbank gefunden, wird im Auftrag stattdessen der hier festgelegte Artikel eingefügt. Der Beleg wird dabei gesperrt.
Anschließend ist es in der Auftragsverwaltung des eBay-Moduls möglich, den Artikel im Beleg zu ändern.
eBay-Aufträge ignorieren, wenn Auftragsdatum älter als...
Diese Option sorgt dafür, dass Aufträge, die vor dem eingestellten Datum angelegt wurden, nicht in e-vendo importiert werden.
Templ info-blk.png
Der Hintergrund dieser Option ist, dass Aufträge, die vor der Verwendung der eBay-Schnittstelle abgearbeitet wurden, unter bestimmten Umständen wieder importiert werden könnten. Dies tritt bspw. auf, wenn der Auftrag selbst zwar abgeschlossen ist, der Kunde aber eine Aufforderung zur Abgabe einer Verkäuferbewertung erhält. eBay ändert hier den Auftragsstatus, sodass dieser wieder importiert wird, da e-vendo den Auftrag nicht kennt. Die Nutzung der Ignorieren-Funktion unterbindet den Import.
eBayPLUS-Versandart durch die im Listing verwendete Versandart ersetzen
Wird für eBayPLUS eine separate Versandart verwendet, lässt sicxh diese hier hinterlegen. Wird ein Auftrag mit dem eBayPLUS-Merkmal importiert, wird dessen übermittelte Versandart mit der hier definierten ersetzt.


Reiter Versand

Subreiter Default Versandregionen

Ebay config-versandregionen.png


In diesem Bereich lassen sich die Versandregionen festlegen, in welche Sie Ihre Produkte versenden möchten. Diese Liste wird von eBay zur Verfügung gestellt. Anhand der hier ausgewählten Versandregionen wird festgelegt, welche Regionen bei der Erstellung von Versandprofilen und beim Listing von Artikeln zur Verfügung stehen.

Sollen einzelne Länder und/oder Regionen spezifisch ausgeschlossen werden, können Sie diese im Reiter Ausschlussoptionen für den Versand definieren.


Subreiter Default Versandarten

Ebay config-versandarten.png


Hier lassen sich die von eBay zur Verfügung gestellten Versandarten für die gewählten Versandregionen einsehen.

Die gewünschten ebay-Versandarten müssen für die Benutzung nicht nur aktiviert werden (indem der Haken gesetzt wird), sondern es muss ebenfalls eine e-vendo-Versandart zugewiesen werden. Dazu wird die ebay-Versandart mittels Klick auf das Dreieck ausgeklappt. Anschließend kann der blau gefärbte Text e-vendo Versandart geklickt werden, um in die Versandartenauswahl zu gelangen und eine e-vendo-Versandart mit der ebay-Versandart zu verknüpfen. Wurde der Auswahldialog bestätigt und die Konfiguration gespeichert, ist die Verkünpfung aktiv.


Reiter Zahlungsarten

Ebay config-zahlungsarten.png


Hier werden die von eBay gelieferten Zahlungsarten dargestellt und können via Setzen des Hakens aktiviert werden, sodass diese für Listings und Zahlartprofile verfügbar sind.

Die eigentliche Verknüpfung gestaltet sich wie schon bei den Versandarten: Mittels Klick auf Zahlart e-vendo erscheint der Auswahldialog der e-vendo-Zahlarten. Hier kann die Zahlart gewählt werden, welche der entsprechenden eBay-Zahlart zugewiesen werden soll.


Reiter Vorgaben und Automatisierung

Ebay config-auto.png


An dieser Stelle werden die verschiedenen Möglichkeiten zur Automatisierung einzelner Prozesse der Schnittstelle dargestellt.

Templ att-blk.png
Damit die Automatismen in Betrieb genommen werden können, müssen auf unseren Servern entsprechende Vorbereitungen durchgeführt werden. Bitte kontaktieren Sie uns, wenn Sie die Automatismen nutzen möchten.


Automatisierung
Auftragsimport
Diese Checkbox aktiviert den automatisierten Auftragsimport von eBay-Aufträgen.
Der Import findet zu ungeraden Stunden statt (also 13:00, 15:00 etc.).
Versandstatus
Wird diese Option aktiviert, werden die Trackingnummern und der Versandstatus der eBay-Aufträge an eBay gesendet.
Um 20:00 Uhr täglich werden automatisch die Versandstatus aller eBay-Aufträge übermittelt, deren Lieferschein gebucht wurde.
  • Ist der verknüpften e-vendo-Versandart ein Versandsystem (bspw. DHL Easylog, DPD DELISprint) zugewiesen, wird ebenfalls die Trackingnummer übergeben.
  • Ist der verknüpften e-vendo-Versandart ein Versandsystem zugewiesen und der Lieferschein enthält keine Trackingnummer, wird der Versandstatus erst übertragen, sofern die Buchung des Lieferscheines mindestens 24 Stunden vorher erfolgte.
Wird eine Trackingnummer durch den Trackingnummernimport nachgetragen, wird diese an eBay übermittelt.
Lagerbestandsabgleich
Beim Lagerbestandsabgleich werden Lagerbestandsänderungen innerhalb e-vendo (etwa durch Verkäufe im Onlineshop oder an der Kasse) automatisch an ebay gesendet.
Für den Lagerbestandsabgleich stehen ein halb- sowie ein vollautomatischer Modus zur Verfügung.


halbautomatischer Lagerbestandsabgleich

Wird der halbautomatische Modus genutzt, werden diejenigen Artikel, bei denen Lagerbestandsänderungen aufgetreten sind, in eine separate Tabelle eingetragen.
Zu jeder vollen Stunde überprüft e-vendo diese Tabelle und sendet die aktuellen Bestände an die Marktplätze.
Wurde der aktuelle Lagerbestand an eBay oder amazon übertragen, wird ein entsprechender Eintrag (ein sog. Zeitstempel, engl. stamp) in der Tabelle vorgenommen. Hat ein Artikel für beide Marktplätze (sofern beide genutzt werden) einen Zeitstempel, wird er aus der Liste entfernt.

Die Tabelle mit den zu übertragenden Bestandsaktualisierungen ist in den ERP-Systemvorgaben im Reiter Lagerbewegung/Faktura duch Klick auf den Button zu sendende Artikel anzeigen einsehbar.

Um diese Automatik zu aktivieren, muss im selben Konfigurationsbereich die Option "Lagerbestand halbautomatisch oder automatisch im Hintergrund an die Marktplätze senden" aktiviert werden.
Es handelt sich dabei um eine globale Systemeinstellung, sodass es ausreichend ist, wenn ein Benutzer diese Option setzt.


vollautomatischer Lagerbestandsabgleich

Die vollautomatische Bestandsaktualisierung an eBay und amazon ist ebenfalls möglich. Bei dieser wird nach jeder Lagerbestandsänderung überprüft, ob der Artikel, dessen Bestand sich geändert hat, auf eBay oder amazon gelistet ist. Ist dies der Fall, wird sofort der neue Lagerbestand an die Plattformen gesendet.

Um den vollautomatischen Modus zu aktivieren, müssen zwei Checkboxen aktiviert werden:

  • die Option "Lagerbestand halbautomatisch oder automatisch im Hintergrund an die Marktplätze senden" in den ERP-Systemvorgaben im Reiter Lagerbewegung/Faktura, sowie
  • die Option "Lagerbestand (halb)automatisch an Marktplatz übertragen" in der Arbeitsplatzkonfiguration im Reiter Standort, Lager, Kassenzuordnung.

Wurden beide Optionen aktiviert, erscheint in der Statusleiste von e-vendo die Meldung "Alert aktiv":  Ebay alert-aktiv.png

Templ att-blk.png
Die automatische Lagerbestandsänderung sollte nur auf einem Arbeitsplatz aktiv sein, auf welchem wenig Datenbankverkehr (also bspw. die Fakturierung von Belegen) stattfindet. Die Automatik greift für das gesamte System.
Bei einem mittelhohen oder hohen Aufkommen an Warenein- und -ausgängen empfehlen wir diese Option nicht, da bei jeder Buchung geprüft wird, ob die enthaltenen Artikel auf eBay oder amazon gelistet werden. Dies zieht u.U. eine beachtliche Verlangsamung des Buchungsprozesses nach sich.


Action-Log: nur Fehler protokollieren
Wird diese Option aktiviert, werden im Action Log nur Fehler protokolliert, nicht aber die erfolgreiche Kommunikation mit den eBay-Servern.
Action-Log: zusätzlich zu den Fehlern auch Warnungen anzeigen
Bei Aktivierung dieser Option werden im Action Log auch Warnungen protokolliert. Warnungen sind Meldungen der eBay-Systeme, die bspw. die Erstellung eines Listings nicht unmöglich machen, aber bei denen eBay Nacharbeiten wünscht.

eBay-Vorgaben aktualisieren

Bietet die Möglichkeit, die verschiedenen eBay-Vorgaben zu aktualisieren. Dazu zählen die folgenden:
  • Versandarten und Länderzuordnungen
  • Zahlungsarten
  • Versandprofile
  • der Kategoriebaum
  • Service-URLs
  • der eBay-Store
Templ info-blk.png
Der Kategoriebaum ist sehr umfangreich. Dadurch kann es einige Minuten dauern, bis dieser heruntergeladen und in die Datenbank geschrieben wurde.

eBay-Userstatus eBay-Time eBay-Nutzungsstatistik

Diese Funktionen sind hauptsächlich für den Support des Moduls sinnvoll.

eBay-Userstatus anpassen

Mit dieser Funktion lässt sich in den eBay-Nutzeroptionen das Tag OutOfStockControlPreference auf den Wert true setzen. Dies hat zur Folge, dass GTC-Listings, deren Lagerbestände den Wert 0 erreicht haben, nicht beendet, sondern pausiert werden.


Reiter Zugangsdaten

Ebay config-zugangsdaten.png


Testbetrieb
Hiermit lässt sich festlegen, ob die Arbeit mit dem Modul in eBays Sandbox oder im Produktivsystem stattfindet.
Wird die Sandbox aktiviert, ändert sich die eine Zeile tiefer angezeigte SiteID auf 0.


Templ info-blk.png
Die Initialeinrichtung der Schnittstelle wird im Kapitel Prozesse beschrieben.

e-vendo für die Kommunikation mit eBay autorisieren

Leitet den Prozess zur Verknüpfung des eBay-Händler-Accounts mit e-vendo ein:
  • Nachdem in e-vendo Benutzername und Passwort (des eBay-Accounts) eingegeben wurde, öffnet sich ein Browser-Fenster, in welchem eine eBay-Seite geöffnet wird.
  • Diese verlangt nochmals die Autorisierung des Nutzers mit denselben Daten.
  • Anschließend gelangt der Nutzer zu einer Seite, in welcher er bestätigen muss, dass e-vendo in seinem Namen auf eBay agieren darf.
  • Wird dies bestätigt, erscheint die Erfolgsmeldung von eBay und der Browser geschlossen werden.
  • In e-vendo kann die Frage, ob die Autorisierung mit eBay erfolgreich war, mit Ja beantwortet werden.
  • e-vendo lädt nun den Autorisierungstoken herunter und bittet den Nutzer, die Konfiguration zu speichern.

Autorisierungstoken importieren

Hiermit kann ein Autorisierungstoken re-importiert werden, sofern bereits ein generiert, dieser aber aus e-vendo gelöscht wurde.

Autorisierungstokenstatus

Fragt den aktuellen Status des Tokens ab. Besteht bspw. die Befürchtung, dass der Token seine Gültigkeit verloren hat oder korrumpiert wurde, kann hiermit überprüft werden, ob dies der Fall ist.
Der Autorisierungstoken hat im Normalfall eine Lebenszeit von drei Jahren.

Autorisierungstoken anzeigen (Augensymbol)

Zeigt den Autorisierungstoken an. Das Feld ist im Normalfall leer - was nicht bedeutet, dass der Token nicht vorhanden ist.
Sofern die Kommunikation mit eBay funktioniert, ist auch ein Token vorhanden.

Autorisierungstoken löschen

Hiermit wird der Token gelöscht.