Konfiguration der Schnittstelle (ebay)

Anlegen des Marktplatz-Accounts

Zuerst muss in der Warenwirtschaft ein Marktplatz-Account angelegt werden. Für jeden eBay-Händler-Account muss in e-vendo ein entsprechender Marktplatz-Account angelegt werden.

Die Accountverwaltung findet sich unter

• System
• Konfiguration
• Marktplätze
• ❯Accountverwaltung

Ein Klick auf den Button "Neu" führt durch den Prozess, bei dem folgende Daten abgefragt werden:

• Filiale: Hier wird festgelegt, aus welcher Filiale heraus der Marktplatz betrieben werden soll.
• Marktplatz: Wählen Sie nun den entsprechenden Marktplatz aus, für den Ihr Händler-Account registriert ist.
• Accountname: Nun kann dem Account noch ein Name zugewiesen werden. Dieser ist frei wählbar.

Reiter Artikel

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.

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.

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:

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.

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.

☑

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.

Reiter Belegvorgaben

☑

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.

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.

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.

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

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

Hier lassen sich die von eBay zur Verfügung gestellten Versandarten einsehen und festlegen. Anhand der hier ausgewählten Versandregionen wird festgelegt, welche Regionen bei der Erstellung von ❯Versandprofilen und beim ❯Listing von Artikeln zur Verfügung stehen.

Allerdings müssen die von eBay vorgegebenen Versandarten mit denen aus e-vendo verknüpft werden, damit die Automatisierung der Prozesse im System ordnungsgemäß funktioniert. Dazu muss das kleine Dreieck links neben dem Namen der Versandart geklickt werden, um die weiteren Informationen anzuzeigen. Anschließend führt ein Klick auf "e-vendo Versandart" zum Auswahldialog für die e-vendo-Versandarten. Hier wird die gewünschte Versandart gewählt und der Dialog bestätigt. Im Beispiel im Bild wurde die eBay-Versandart "DHL Paket" mit der e-vendo-Versandart "DHL" verknüpft.

Reiter Zahlungsarten

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

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

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.

☑

Auftragsimport

Diese Checkbox aktiviert den automatisierten Auftragsimport von eBay-Aufträgen.

☑

Versandstatus

Wird diese Option aktiviert, werden nach dem ❯Trackingnummernimport die Trackingnummern und der Versandstatus der eBay-Aufträge an eBay gesendet.

Um 19:00 Uhr werden automatisch die Versandstatus aller eBay-Aufträge übermittelt, denen noch keine Trackingnummer zugewiesen wurde und die noch nicht übertragen wurden. Wird eine Trackingnummer durch den Trackingnummernimport nachgetragen, wird diese an eBay übermittelt.

☑

Lagerbestandsabgleich

Beim Lagerbestandsabgleich werden Lagerbewegungen innerhalb e-vendo (etwa durch Verkäufe im Onlineshop oder an der Kasse) an eBay übertragen. Lagerbewegungen werden hierfür im System gesammelt und als Stapel zu eBay gesendet, um die maximale Anzahl der täglichen Anfragen an die eBay-Systeme nicht zu überschreiten. Ein Stapel beinhaltet dabei bis zu zehn Änderungen.

---

Zusätzlich gibt es eine weitere Möglichkeit, Lagerbestandsänderungen zu sammeln und zeitlich gestaffelt (z.B. alle 60 Minuten) an eBay zu übertragen. Die zeitliche Staffelung kann mit dem e-vendo Support abgestimmt werden.

Dazu sind zwei Einstellungen nötig:

• In den ❯Globalen Systemvorgaben muss die Option "Lagerbestand halbautomatisch oder automatisch im Hintergrund an die Marktplätze senden" aktiviert sein.
• In der ❯Arbeitsplatzkonfiguration muss die Option "Lagerbestand (halb)automatisch an Marktplatz übertragen" aktiviert sein.

Wurden diese Optionen aktiviert, erscheint in der Statusleiste von e-vendo die Anzeige "Alert aktiv", welche darauf hinweist, dass Lagerbestandsänderungen periodisch übertragen werden.

Die aktuelle Liste der zu sendenden Artikel wird ebenfalls in den ❯Globalen Systemvorgaben durch Klick auf den Button zu sendende Artikel anzeigen dargestellt.

Die automatische oder halbautomatische Lagerbestandsänderung sollte nur auf einem Arbeitsplatz aktiv sein, auf welchem wenig Datenbankverkehr (also bspw. die Fakturierung von Belegen) stattfindet.

☑

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

Der Kategoriebaum ist sehr umfangreich. Dadurch kann es einige Minuten dauern, bis dieser heruntergeladen und in die Datenbank geschrieben wurde.

eBay-Userstatus

Hiermit werden einige Einstellungen aus dem eBay-Profil heruntergeladen und als XML angezeigt.

Diese Option kann genutzt werden, um nachzuschauen, wie der Status des Beendens/Pausierens von GTC-Listings im Falle eines Lagerbestands von 0 ist. Das entsprechende Tag heißt OutOfStockControlPreference.

---

Hat das Tag den Wert true, werden GTC-Listings, sofern Sie einen Lagerbestand von 0 erreichen, nur pausiert und nicht beendet.

Hat das Tag den Wert false, werden GTC-Listings beendet, sofern Ihr Lagerbestand auf 0 fällt.

eBay-Time

Stellt eine Anfrage an den eBay-Server, um dessen Zeit abzufragen. Dies kann wichtig sein, wenn es Hinweise darauf gibt, dass die Systeme nicht mehr synchron zueinander operieren. Im Normalfall ist dieser Button für Nutzer unerheblich.

eBay-Nutzungsstatistik

Diese Funktion fragt einige Daten zur Nutzung der eBay-API ab und stellt diese als XML dar. eBay erlaubt aktuell täglich 5000 Zugriffe auf die Schnittstelle. Um zu sehen, wieviele Sie aktuell verbraucht haben, sollten Sie sich dieses Tag anschauen: DailyUsage.

eBay-Userstatus anpassen

Mit dieser Funktion lässt sich das bei "eBay-Userstatus" angesprochene Tag OutOfStockControlPreference auf den Wert true setzen, damit GTC-Listings, deren Lagerbestände den Wert 0 erreicht haben, nicht beendet, sondern pausiert werden.

Reiter Zugangsdaten

e-vendo für die Kommunikation mit eBay authorisieren

Leitet den Prozess zur Verknüpfung des eBay-Hgändler-Accounts mit e-vendo ein.

Autorisierungstoken importieren

Hiermit kann ein Autorisierungstoken importiert werden, sofern schon einer generiert wurde.

Autorisierungstokenstatus

Fragt den aktuellen Status des Tokens ab. Besteht bspw. die Befürchtung, dass der Token seine Gültigkeit verloren hat, 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.

Autorisierungstoken löschen

Hiermit wird der Token gelöscht.