Leitfaden: Konto einrichten
Dieser Leitfaden beschreibt die einmalige Inbetriebnahme eines eBay-Kontos in e-vendo. Er ist beim Start einmal je Konto abzuarbeiten; im Tagesgeschäft wird er nicht mehr gebraucht.
Wer bereits ein eingerichtetes Konto hat und wissen möchte, wie ein Artikel zu eBay kommt, findet das im ►Leitfaden: Artikel listen.
Voraussetzungen
Bevor in e-vendo irgendetwas eingerichtet werden kann, müssen einige Dinge außerhalb der Warenwirtschaft geklärt sein.
Auf Seiten von eBay
Grundlage ist die Registrierung bei eBay und ein Konto, das zum Verkaufen freigeschaltet ist. Das ist keine Aufgabe von e-vendo: Das Konto wird bei eBay angelegt, und dort werden auch Identität, Bankverbindung und Auszahlungsweg hinterlegt. Ohne ein verkaufsbereites Konto endet jeder Versuch, ein Angebot einzustellen, mit einer Fehlermeldung von eBay.
Das Modul ist durchgängig auf den gewerblichen Verkauf ausgelegt: Es überträgt mit jedem Angebot den Umsatzsteuersatz des Artikels, liefert die nach der Produktsicherheitsverordnung verlangten Angaben zu Hersteller und EU-Verantwortlichem mit und arbeitet mit Rahmenbedingungen und eBay-Shopkategorien. Das sind Funktionen, die eBay für gewerbliche Verkäufer vorsieht.
eBay kann die Zahl der Angebote und das Verkaufsvolumen eines Kontos begrenzen, gerade bei neuen Verkäufern. Sind die Limits ausgeschöpft, lehnt eBay weitere Angebote ab – in e-vendo äußert sich das als Fehler beim Listen. Die aktuellen Limits stehen im eBay-Konto.
Rahmenbedingungen für Zahlung, Versand und Rücknahme werden bei eBay angelegt, nicht in e-vendo. Sollen sie genutzt werden, müssen sie im Konto vorhanden sein – e-vendo kann sie nur auswählen.
Die Einsortierung von Angeboten in eigene Shopkategorien setzt einen eBay-Shop voraus. Ohne Shop bleibt diese Funktion des Moduls ungenutzt; alles Übrige funktioniert davon unabhängig.
Die eBay-Sandbox ist ein eigenständiges Testsystem. Konten aus dem Live-System funktionieren dort nicht.
Welche Bedingungen eBay an ein Verkäuferkonto und an den gewerblichen Verkauf stellt, legt eBay fest und ändert sie von Zeit zu Zeit. Maßgeblich sind die Angaben im eBay-Verkäuferportal, nicht dieses Wiki.
Auf Seiten von e-vendo
Die eBay-Schnittstelle ist ein eigenes Modul. Für das Öffnen wird das ►Recht eBay benötigt, für den Reiter Konfiguration zusätzlich das Recht eBay_Konfig. Wer die Einrichtung vornimmt, braucht beide.
Diese Voraussetzung wird leicht übersehen: eBay erlaubt kein Hochladen von Bildern, sondern nur das Verlinken. Die Artikelbilder werden deshalb aus dem e-vendo-Shop heraus bereitgestellt; von dort kommt auch das Layout der Angebotsbeschreibung. Ohne erreichbaren Shop bleiben die Angebote ohne Bilder. Für die eBay-Templates ist mindestens die Shop-Template-Version 7.6.10.0 nötig.
Ein Artikel braucht mindestens einen Preis in der vorgesehenen Preisliste, einen Bestand im vorgesehenen Lagerort und Bilder. Für viele Kategorien verlangt eBay zusätzlich eine gültige EAN sowie Angaben zum Hersteller – fehlen sie, lehnt eBay das Angebot ab oder verlangt Nacharbeit.
Es lohnt sich, die Einrichtung zuerst in der Sandbox durchzuspielen und dort einen Testartikel zu listen. Fehler in der Konfiguration fallen so auf, bevor sie im Produktivsystem Gebühren verursachen oder fehlerhafte Angebote erzeugen.
Die drei Schritte im Überblick
| Schritt | Was passiert | Wo |
|---|---|---|
| 1 | Marktplatz-Account anlegen – der Platz, an dem e-vendo die Einstellungen zu diesem eBay-Konto ablegt | System → Konfiguration → Marktplätze |
| 2 | e-vendo bei eBay autorisieren – zweimal, siehe unten | eBay-Modul, Reiter Konfiguration → Zugangsdaten |
| 3 | Grundkonfiguration – Lagerort, Preise, Versand, Zahlarten und Belegvorgaben | eBay-Modul, Reiter Konfiguration |
Schritt 1 und 2 sind hier beschrieben. Schritt 3 steht im ►Leitfaden: Grundkonfiguration.
Alle drei Schritte sind je Marktplatz-Account durchzuführen. Wer zwei eBay-Händlerkonten hat und mit jedem in zwei Ländern handelt, richtet vier Marktplatz-Accounts ein – jeden mit eigener Autorisierung und eigener Konfiguration.
Schritt 1: Marktplatz-Account in e-vendo anlegen
Unter System → Konfiguration → Marktplätze findet sich das Optionsmenü ►Accountverwaltung. Dieses Menü beinhaltet eine Übersicht über die angelegten Marktplatz-Zugänge.
Filiale wählen. Mit einem Klick auf beginnt die Anlage. Im ersten Schritt wird die zu verwendende Filiale ausgewählt.
Die Wahl der Filiale ist lediglich für die Buchhaltung relevant. Welche Lagerorte für die Bestände herangezogen werden, wird später in der ►Konfiguration festgelegt.
Marktplatz wählen. In diesem Fall ebay mit der ID 6.
Auch wenn in dieser Liste www.ebay.de steht, gilt der Eintrag ebenso für ausländische eBay-Marktplätze. Auf welchem Marktplatz tatsächlich gehandelt wird, entscheidet sich in Schritt 2.
Bezeichnung festlegen.
Wird nur ein eBay-Konto auf einem Marktplatz verwendet, genügt ein generischer Name wie "ebay". Bei mehreren Konten oder mehreren Ländern lohnt es sich, Konto und Land im Namen zu kodieren – danach wird später im Modul umgeschaltet.
Modul starten und Account wählen. Das eBay-Modul befindet sich unter Spezial 3.
Sind mehrere Marktplatz-Accounts eingerichtet, erscheint beim Start dieser Dialog. Einstellungen, Listings und Aufträge werden je Account getrennt geführt. Bei nur einem Account entfällt der Schritt.
Der gewählte Account wird oben rechts angezeigt. Ein Klick auf "Account:" oder den Namen wechselt zu einem anderen Account.
Schritt 2: e-vendo bei eBay autorisieren
Wozu überhaupt ein Token?
e-vendo handelt bei eBay im Namen des Händlers: Es stellt Angebote ein, ändert Preise und holt Aufträge ab. Damit das möglich ist, ohne dass e-vendo das eBay-Passwort kennt und speichert, erteilt der Händler einmalig eine Erlaubnis. eBay stellt daraufhin einen Schlüssel aus – das Token. e-vendo legt es beim Marktplatz-Account ab und schickt es bei jedem Aufruf mit.
Drei Eigenschaften sind praktisch wichtig:
Ein Token gilt für das eBay-Konto, mit dem es erzeugt wurde. Ein zweites Händlerkonto braucht eine eigene Autorisierung.
Ein Token hat eine begrenzte Gültigkeit. Läuft es ab, bricht die Kommunikation mit eBay ab und die Autorisierung ist zu wiederholen.
Der Händler kann die Erlaubnis jederzeit entziehen – in e-vendo oder im eBay-Konto. Danach arbeitet die Schnittstelle nicht mehr.
Warum zwei Autorisierungen?
eBay betreibt zwei Generationen von Schnittstellen nebeneinander, und jede hat ihr eigenes Autorisierungsverfahren. e-vendo nutzt beide, deshalb gibt es im Reiter Zugangsdaten die zwei Unterreiter Authentifizierung 1 und Authentifizierung 2:
| Authentifizierung 1 | Authentifizierung 2 | |
|---|---|---|
| eBay-Schnittstelle | die ältere Handelsschnittstelle | die neueren Schnittstellen |
| wird gebraucht für | Angebote einstellen, ändern, beenden und erneut einstellen, Aufträge importieren, Versand- und Zahlstatus senden | Rahmenbedingungen, Artikelmerkmale der Produktkategorien, eBay-Shopkategorien |
| was gespeichert wird | ein Autorisierungstoken | Refresh-Token, Access-Token und ein Signaturschlüsselpaar |
Beide Verfahren müssen eingerichtet sein. Fehlt Authentifizierung 1, lässt sich kein Angebot einstellen. Fehlt Authentifizierung 2, bleiben die Auswahlfelder der Rahmenbedingungen leer, die Artikelmerkmale einer Kategorie lassen sich nicht abrufen und die Shopkategorien nicht laden. eBay stellt seine Schnittstellen zudem schrittweise um – einzelne Funktionen der älteren Schnittstelle sind bereits abgekündigt und laufen nur noch über die neuere.
Vorbereitung in beiden Unterreitern
Vor der Autorisierung sind in jedem der beiden Unterreiter zwei Angaben zu machen:
- ebay-Marktplatz – der Marktplatz, auf dem gehandelt wird.
- Testbetrieb (Sandbox mit SiteID=0 verwenden) – angehakt für das Testsystem, leer für den Produktivbetrieb.
Authentifizierung 1 einrichten
Im Unterreiter Authentifizierung 1 auf klicken. Es erscheint ein Hinweisfenster, das den Ablauf ankündigt; dieses mit bestätigen.
e-vendo öffnet ein eigenes Fenster mit der Anmeldeseite von eBay. Dort mit den Zugangsdaten des eBay-Händlerkontos anmelden.
eBay fragt anschließend, ob der Anwendung e-vendo der Zugriff auf das Händlerkonto gewährt wird. Diese Abfrage bestätigen.
Im oberen Bereich des Fensters führt ein Hinweistext durch den Ablauf und meldet den Erfolg. Die Schaltfläche wird erst bedienbar, wenn eBay die Autorisierung bestätigt hat.
Das Fenster mit schließen. e-vendo holt daraufhin das Token ab und meldet, dass es ermittelt werden konnte.
Die Konfiguration mit sichern. Ohne diesen Schritt ist das Token nach dem Schließen des Moduls wieder weg.
Bleibt die Schaltfläche OK inaktiv oder wird das Fenster abgebrochen, lässt sich das Token nachträglich über zur laufenden Anmeldung abholen. Führt auch das nicht zum Ziel, wird der Vorgang komplett wiederholt.
Die übrigen Schaltflächen dieses Unterreiters werden nur im Ausnahmefall gebraucht:
- Authorisierungstokenstatus
Fragt bei eBay ab, ob das gespeicherte Token noch gültig ist. Der erste Griff, wenn die Schnittstelle unerwartet nicht mehr arbeitet.
- Authorisierungstoken importieren
Trägt ein anderweitig erzeugtes Token von Hand ein.
- Authorisierungstoken löschen
Entfernt das Token. Danach ist keine Kommunikation mehr möglich, bis neu autorisiert wurde.
- Token anzeigen (Augensymbol)
Macht das gespeicherte Token sichtbar. Das Feld ist im Normalbetrieb leer – das heißt nicht, dass kein Token vorhanden ist.
Authentifizierung 2 einrichten
In den Unterreiter Authentifizierung 2 wechseln und dort Marktplatz und Testbetrieb genauso einstellen wie in Authentifizierung 1.
Auf klicken. Es öffnet sich erneut ein Fenster mit der Anmeldeseite von eBay.
Anmelden und den Zugriff bestätigen. Der Hinweistext im Fenster führt durch den Ablauf: erst die Aufforderung zur Anmeldung, dann die Bestätigung des erfolgreichen Anmeldevorgangs, zuletzt die Meldung, dass der Autorisierungscode empfangen wurde. Erst dann wird bedienbar.
Nach dem Schließen erzeugt e-vendo zusätzlich das Signaturschlüsselpaar, das eBay für einen Teil der neueren Aufrufe verlangt. Anschließend meldet e-vendo den Erfolg.
Die Konfiguration mit sichern.
Im Bereich Schnittstellendaten lässt sich anschließend ablesen, was gespeichert wurde:
Der langlebige Schlüssel, aus dem e-vendo bei Bedarf neue Zugriffs-Token erzeugt. Der Ablaufzeitpunkt ist der wichtigste Wert auf dieser Seite: Danach ist die Autorisierung zu wiederholen.
Der kurzlebige Schlüssel für den einzelnen Aufruf. Er wird selbsttätig erneuert; die Anzeige dient der Kontrolle.
Angaben zum Signaturschlüssel, mit dem e-vendo bestimmte Aufrufe unterschreibt.
Das Schlüsselpaar der Signatur. Über die Augensymbole sichtbar zu machen – im Normalbetrieb nicht nötig.
- Access Token manuell erneuern
Holt sofort einen frischen Zugriffs-Token. Nur zur Fehlersuche gedacht; im laufenden Betrieb erneuert e-vendo selbst.
Wenn die Verbindung nicht mehr funktioniert
Prüfen, welche Funktionen betroffen sind. Lassen sich keine Angebote mehr einstellen, betrifft es Authentifizierung 1. Bleiben nur die Rahmenbedingungen leer oder fehlen die Artikelmerkmale einer Kategorie, betrifft es Authentifizierung 2.
Bei Authentifizierung 1 den abfragen. Bei Authentifizierung 2 den Ablaufzeitpunkt des Refreshtokens prüfen.
Ist das Token abgelaufen oder ungültig, die jeweilige Autorisierung erneut durchführen – die Schritte sind dieselben wie bei der Ersteinrichtung – und die Konfiguration speichern.
Bleibt es dabei, hilft das ►Action-Log weiter: Dort steht der vollständige Austausch mit eBay samt der Fehlermeldung.
Schritt 3: weiter zur Grundkonfiguration
Steht die Verbindung, folgen die inhaltlichen Vorgaben – aus welchem Lager die Bestände kommen, welcher Preis gilt, welche Versandarten und Zahlarten angeboten werden und wie importierte Aufträge behandelt werden.
Weiter: GrundkonfigurationLeitfaden: Grundkonfiguration
Leitfaden für die Grundeinstellungen nach der Autorisierung: Vorgaben holen, Artikel, Versand, Zahlarten, Rahmenbedingungen und Belegvorgaben.
idealo
Mit der Schnittstelle zu idealo lassen sich die dort gelisteten verwalten und die dort erstellten (und mittels idealo Direktkauf gezahlten) Belege importieren.