Connect/eBay

Voraussetzungen

Für die OAuth2-Anmeldung bei eBay muss die Microsoft Edge WebView2 Runtime auf dem System installiert sein.

Die Runtime wird verwendet, um das eBay-Anmeldefenster innerhalb von mention®Connect anzuzeigen.
Ohne installierte WebView2 Runtime kann die Authentifizierung nicht durchgeführt werden.

• Microsoft Edge WebView2 Runtime
• Download: https://developer.microsoft.com/microsoft-edge/webview2/

eBay-Profil, Rahmenbedingungen, Lizenz

Nach erfolgreichen Anlegen eines Profils bei eBay und Hinterlegung von Rahmenbedingungen
(mein eBay → Mitgliedskonto → Rahmenbedingungen für Ihre Angebote),
hinterlegen Sie die Connect-Lizenzdatei im Hauptordner von mention®Connect,
sofern nicht bereits im Vorfeld geschehen, und lassen diese einlesen.
Näheres dazu hier.

Erstellen der Schnittstelle und Setzen der allgemeinen Einstellungen

Klicken Sie hierfür auf den Button mit dem Plus-Zeichen. Nun ist es notwendig, die Schnittstelle mit Ihren Daten einzurichten.

Zwingend erforderliche Angaben:

Einstellung	Beschreibung
Mandant	Legen Sie hier fest, welchen Mandanten die eBay-Schnittstelle nutzen soll.
Lager (für Artikel)	Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die die eBay-Schnittstelle zugreifen soll.
mention Benutzer	Legen Sie hier den Benutzer fest, mit dem sich die eBay-Schnittstelle bei der mention®Warenwirtschaft anmelden soll.
VK-Preis	Hier legen Sie den primären VK-Preis fest, der für den Artikelupload verwendet werden soll.

eBay

Wählen Sie aus, in welchem Modus Sie die Schnittstelle betreiben möchten (Sandbox oder Live). Die API-URL wird automatisch anhand der Auswahl gesetzt und ist nicht manuell änderbar.

Modus	API-URL
Sandbox	https://sandbox.ebay.com
Live	https://api.ebay.com

Hinweis: Beim Wechsel des Modus wird der bestehende OAuth-Token zurückgesetzt.

Soap-Token

Falls Sie noch über keinen Token verfügen, folgen Sie dafür bitte dieser Anleitung. Der eBay-Soap-Token ist der Zugangsschlüssel zu eBay für die SOAP-Schnittstelle. Bitte kopieren Sie ihn und fügen ihn hier ein. Achten Sie bitte darauf, keine Zeilenumbrüche oder andere nicht zum Token gehörende Zeichen einzutragen. Andernfalls wird der Token ungültig. Bitte betätigen Sie anschließend den Button Test und warten das Ergebnis ab.

eBay REST Authorisation (OAuth2)

Zusätzlich zum Soap-Token ist die OAuth2-Authentifizierung für die REST-Schnittstelle erforderlich. Klicken Sie auf den Button "Login", um den Authentifizierungsprozess zu starten. Es öffnet sich ein Browser-Fenster, in dem Sie sich bei eBay anmelden und die erforderlichen Berechtigungen erteilen.

Nach erfolgreicher Authentifizierung wird der Status angezeigt.

Status	Beschreibung
Grün	Token gültig: die REST-Autorisierung ist aktiv.
Orange	Token läuft in Kürze ab: bitte erneuern Sie die Autorisierung.
Rot	Autorisierung erforderlich: bitte führen Sie den Login erneut durch.

Zusätzlich werden das Ablaufdatum des Refresh-Tokens sowie etwaige Warnungen angezeigt. Bei einem ungültigen oder bald ablaufenden Token erscheint ein entsprechender Hinweis.

eBay Business Policies Opt-in

Für die Nutzung der eBay REST-API ist das Opt-in für die eBay Business Policies (Verkäuferrichtlinien) erforderlich. Der Status wird im Bereich eBay Business Policies Opt-in angezeigt.

Einstellung	Beschreibung
Opt-in-Status	Zeigt an, ob Sie den Business Policies bereits zugestimmt haben.
Opt-in / Opt-out	Über die Buttons können Sie die Zustimmung erteilen oder zurücknehmen. Bei Sandbox-Accounts ist kein Opt-in erforderlich.

Übertragungsintervalle

Das Upload-Intervall betrifft Artikelaktualisierungen und Bestände. Das Intervall Bestellungen/Paketnummern bezieht sich auf den Download von Bestellungen und das Übertragen von Sendungsdaten und Verkäufer-Feedback. Sollen für einen bestimmten Zeitraum keine Übertragungen erfolgen, kann eine entsprechende Pause hinterlegt werden. Falls Sie dsxml-Accounts für die Warenwirtschafts-Option Online-Daten pro Account nutzen, wählen Sie hier den Account, den Sie für eBay nutzen, aus.

Zuordungen

Die Zuordungen der Zahl- und Versandarten sind erst nach einer erfolgreichen Bestellung möglich.

Behandlung Bestand

Einstellung	Beschreibung
Best. Online verwenden	Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.
Best. zzgl. Bestellte	Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.
Bestand abzgl. in Nachbearbeitung	Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.
Bestand abzgl. Dsxml in Nachbearbeitung	Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung in der DSXML-Schnittstelle vom Bestand abgezogen.
Sperrbest abziehen	Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.
Vorbestellte abziehen	Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.
Änderungsdatum Lager deaktiviert	Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.
Bestände von Gruppenmitgliedern abschneiden	Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.

Neue Kunden

Einstellung	Beschreibung
Kennz. Online n. Kunden (Kennzeichen Online neue Kunden)	Wenn diese Einstellung aktiv ist, wird beim Anlegen eines Ansprechpartners das Online Feld aktiviert.
Behandlung Name	Wenn Standard Behandlung aktiviert ist, werden Vorname und Nachname zusammen in Name2 gespeichert. Wenn Privat Person: Vorname = Name1, Nachname = Name2 ausgewählt ist, wird der Vorname in das Feld Name1 gespeichert und das Feld Name2 mit dem Nachnamen befüllt.
KD Kennz. Endkunde	Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im Kundenstamm als Endkunde gekennzeichnet.
Druckoptionen speichern	Aktiviert die folgenden Druckoptionen.
Druckoptionen Email	Wenn aktiv, wird im Kundenstamm unter Druckoptionen E-Mail auf aktiv gesetzt.
Druckoptionen nicht drucken	Bei aktiv wird im Kundenstamm unter Druckoptionen nicht drucken aktiviert.
Druckoptionen Transportweg
Druckoptionen Format
Druckoptionen Dateiname
Weitere SA: Nur Lieferschein	Wenn aktiv, wird im Kundenstamm unter Weitere die Einstellung SA: Nur Lieferschein auf aktiv gesetzt.

Vorlage Kundennummer

Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen Datensatz folgende Werte als Standard bei der Neuanlage verwendet:

• Versicherung (Weitere)
• Endkunde (Weitere)
• SA: nur Lieferschein (Weitere)
• Versandart (Weitere)
• Währung (Weitere)
• Transportweg (Weitere)
• Kennwort (Weitere)
• Adresse (Weitere)
• VK-Preis akzeptieren (Weitere)
• Format (Weitere)
• Mahnung (Weitere)
• Zahlart (Weitere)
• Frachtfrei (Weitere)
• Frachtfrei ab Wert (Weitere)
• Werkstatt (Weitere)
• Mindestfrachtkosten (Weitere)
• nicht Drucken (Druckoptionen)
• E-Mail (Druckoptionen)
• LFS, Leih-/Teststellung (Weitere)
• Proforma-Rechnung (Weitere)
• Keine Automatik (Weitere)
• Liefersperre (Weitere)
• Preis (Weitere)
• Keine Staffelpreise (Weitere)
• Kalkulation (Weitere)
• Konditionen (Weitere)
• Rabatt (Weitere)
• Limit (Weitere)
• Limit intern (Weitere)
• Gültigkeit von Limit (Weitere)
• Gültigkeit von Limit intern (Weitere)
• Rückscheck/RLS (Weitere)
• Factor-Nr. (Weitere)
• Gilt für Anschriften (Weitere)
• Rabatt drucken (Weitere)
• Sprachschlüssel (Weitere)
• Neue Nummer (Stammdaten)
• Gebiet (Stammdaten)
• Kennzeichen (Stammdaten)
• Keine Werbung (Stammdaten)
• Keine Fax-Werbung (Stammdaten)
• Keine E-Mail-Werbung (Stammdaten)
• Keine Post-Werbung (Stammdaten)
• Seriennummer extra drucken (Stammdaten)
• Belegdruck mit Seriennummern (Stammdaten)
• Warenausgangsetiketten nicht drucken (Stammdaten)
• Nicht Aktiv (Stammdaten)
• Techniker (Stammdaten)
• Außendienst (Stammdaten)

Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen geprüft.

Einstellung	Beschreibung
Kd.-Name1 prüfen Anzahl Zeichen	Anzahl der Stellen, die im Feld Name1 überprüft werden sollen.
Kd.-Name2 prüfen Anzahl Zeichen	Anzahl der Stellen, die im Feld Name2 überprüft werden sollen.
Kd.-Name3 prüfen Anzahl Zeichen	Anzahl der Stellen, die im Feld Name3 überprüft werden sollen.
Kd.-Straße prüfen Anzahl Zeichen	Anzahl der Stellen, die im Feld Straße überprüft werden sollen.
Kd.-PLZ prüfen Anzahl Zeichen	Anzahl der Stellen, die im Feld PLZ überprüft werden sollen.
Kd.-Ort prüfen Anzahl Zeichen	Anzahl der Stellen, die im Feld Ort überprüft werden sollen.
Kundensuche über Mailadresse	Wenn aktiv, wird zunächst versucht, den Kunden anhand seiner Mailadresse in der Warenwirtschaft zu finden, und bei Erfolg zuzuordnen.

Belegdaten

Einstellung	Beschreibung
Bezug1 Beleg	Text, der im Beleg unter Bezugnahme eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.
Hinweis Beleg	Text, der im Beleg unter Hinweise eingesetzt wird.
Sperrkennzeichen	Hier kann man ein Sperrkennzeichen für Belege zuweisen.
Kennz. Direktlieferung (Kennzeichen Direktlieferung)	Falls aktiv, wird in mention das Feld Direktlieferung aktiviert.
Kennz. Automatik (Kennzeichen Automatik)	Falls aktiv, wird in mention das Feld Automatik auf aktiv gesetzt.
TransaktionsID Bezahlsystem	Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.
eBay Benutzername	Legen Sie hier das Belegfeld fest, in das der eBay-Name des Käufers geschrieben wird.
Debitoren nicht berücksichtigen	Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.
Extended Order ID	Hier kann das Belegfeld ausgewählt werden, in das die Extended Order ID geschrieben wird.
Haken 'Teillieferung zulässig' berücksichtigen	(noch nicht dokumentiert)
Datum/Uhrzeit	Legt fest, in welches Belegfeld Kaufdatum und -uhrzeit geschrieben werden soll.
Externe Referenz 1 bis 3	Sie können die Zahlungsreferenz und/oder Auftragsnummer einem der drei Referenzfelder zuweisen.

eBay-Einstellungen

Profile

Wählen Sie hier bitte die in Ihrem eBay-Konto eingestellten Rahmenbedingungen aus. Voraussetzung dafür ist, dass Sie diese hier aktualisiert haben.

Versand-/Bezahlart und Rückgabe

Aktualisierung und Import

Hinweise:

• Vor dem Aktualisieren der Kategorie-Spezifikationen bitte einmalig den Button Test (siehe eBay) betätigen. Es wird dabei ein spezielles Token abgerufen, das Sie zum Abruf der Daten berechtigt.
• Für REST-basierte Funktionen (Business Policies, Opt-in) muss zuvor die eBay REST Authorisation (Login-Button im Bereich eBay) durchgeführt werden.

Einstellung	Beschreibung
Profile aktualisieren	Um diese unter Profile auswählen zu können, ist es zunächst erforderlich, diese hier zu importieren bzw. zu aktualisieren, sofern neue hinzugefügt wurden.
eBay Kategorien aktualisieren	Per Klick werden die eBay-Kategorien aktualisiert.
Angebote importieren	Sofern Sie vor Nutzung der eBay-Schnittstelle bereits Angebote gelistet haben, können Sie diese hier importieren. Voraussetzung ist, dass die SKU Ihrer Angebote mit mention Artikelnummern übereinstimmen.
Versand- /Bezahlarten / Rückgabebedingungen	Um diese unter Versand-/Bezahlart und Rückgabe auswählen zu können, ist es zunächst erforderlich, diese hier zu importieren bzw. zu aktualisieren, sofern neue Bedingungen hinzugefügt wurden.
Artikel-Zustand	Importieren Sie hier die verfügbaren Artikel-Zustände.
Kategorie-Spezifikationen	Mittels dieses Buttons werden sowohl Kategorien als auch deren Spezifikationen heruntergeladen. Der Vorgang kann mehrere Minuten in Anspruch nehmen, es werden über 2GB an Daten übertragen.

Zu exportierende Bilder

Wählen Sie hier aus, welche Artikelbilder Sie aus der Warenwirtschaft übertragen möchten.

Bestellungen

Wählen Sie hier das Datum der jüngsten abzurufenden Bestellung aus.

Artikel bearbeiten (EbayEditItem)

Der Dialog Artikel bearbeiten erlaubt die Konfiguration einzelner eBay-Artikel. Die Einstellungen im unteren Bereich können je nach ausgewählter eBay-Kategorie variieren (Pflicht-, Optional- oder Empfohlen-Felder).

Allgemeine Einstellungen

Einstellung	Beschreibung
Benennung	In mention hinterlegte Artikelbenennung (schreibgeschützt).
Benennung eBay	Abweichende Benennung für eBay, falls gewünscht.
Ebay Kategorie	Auswahl der eBay-Kategorie (zuvor unter Aktualisierung und Import aktualisieren). Hinweis: Zuvor gab es zwei Kategoriefelder (Ebay Kategorie 1 und 2) – jetzt nur noch eine.
Shop-Kategorien	Entfernt. Shop-Kategorien werden nicht mehr im Artikeleditor verwaltet.
Zustand / Erweit. Zustand	Artikelzustand (z. B. Neu, Gebraucht).
ProduktID	EAN/GTIN des Artikels.
ebay Katalogdaten verwenden	Aktiviert die Verwendung von eBay-Katalogdaten.
Template	Auswahl des eBay-Artikeltemplates.
Einstelldauer	Laufzeit des Angebots (z. B. 30 Tage, Gilt bis Widerruf).
XML	Direkte Eingabe von eBay-XML für erweiterte Konfiguration.
Bestand (kein Akt.) / Preis (kein Akt.)	Legt fest, ob Bestand bzw. Preis nach der Erstübertragung nicht mehr aktualisiert werden sollen.

Profile

Einstellung	Beschreibung
Verkäuferprofile (Zahlart, Versand, Rückgabe)	Die Profilauswahl erfolgt dynamisch auf Basis der bei eBay hinterlegten Business Policies. Anders als zuvor gibt es keine festen drei Felder mehr, sondern eine dynamische Liste aller verfügbaren Profile.

Spezifikationen / Aspekte

Einstellung	Beschreibung
Spezifikationen	Kategoriespezifische Artikelmerkmale (Aspekte) – Werte variieren je nach Kategorie.
Aspekte: Freitext erzwingen	Erzwingt die Eingabe von Freitext bei Artikelspezifikationen, auch wenn eBay eine Auswahlliste vorgibt.
Aspekte: Prüfung deaktivieren	Reduziert die clientseitige Validierung der Aspekte auf Pflichtfelder. Bei Aktivierung werden nur noch erforderliche Spezifikationen auf Vollständigkeit geprüft; weitergehende Prüfungen (Wertebereiche, Formatvorgaben) werden übersprungen.

Aktionen

Aktion	Beschreibung
Artikel öffnen (vfps)	Öffnet den zugehörigen Artikelstammdatensatz in mention.
Über eBay suchen	Durchsucht den eBay-Produktkatalog und ruft die zugehörige eBay-Produkt-ID (EPID) für den aktuellen Artikel ab.
Von eBay herunterladen (Spezifikationen)	Lädt die kategoriespezifischen Spezifikationen (Aspekte) für die ausgewählte eBay-Kategorie herunter.
Download eBay Site-Einstellungen	Wenn aktiviert, werden beim Aktualisieren der Einstelldauer auch die aktuellen eBay-Siteeinstellungen heruntergeladen.
ProduktID / Für Kategorie abfragen	Fragt die benötigten Produkt-IDs für die gewählte Kategorie ab.
Reaktivieren	Reaktiviert ein beendetes Angebot (wahlweise mit angepasstem Preis).

Template Variablen

mention-Feld	Tabellen-Feld	Variable
Stammdaten-Nummer	ARANUMMER	ArtikelNr
Stammdaten-Benennung	ARBEN	Title
Stammdaten-Beschreibung	ARERWBEN	Description
Katalog-Beschreibung	ARKATERW	arkaterw
eBay2-2.Titelzeile	arebsubt	SubTitle
Preise-Preis mit Währung	--	PriceCurrency
Preise-Preis ohne Währung	--	Price
Stammdaten-Hersteller-Nr.	ARHERSTNR	arherstnr
ebay1-Artikelzustand	arebitmco	arebitmco
Stammdaten-EAN-Code	areancode	aeeancode
Weitere Daten-Bermerkung1	ARBEMERK1	Mention_free_1
Stammdaten-Geschäftsbereich (Bezeichnung)	ARGESBER	argesber
Stammdaten-Geschäftsbereich (Nummer)	--	argesbernr
Katalog-Bezeichnung	ARKATBEN	arkatben
Weitere Daten-Kennzeichen	aralkenn	aralkenn
Weitere Daten-Letzte Änderung	updtime	updtime
Katalog-Abbildung1 bis Abbildung10	arkatbild1 bis arkatbild10	Image1 bis Image10
Allgemeine Daten-Kurzbeschreibung	aronlshort	aronlshort
eBay Artikelnummer	-	eBayNr