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 \1 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

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

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.

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

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

...

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 aktualisert 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.

Profile aktualisieren

Um diese unter Profile auswählen zu können, ist es zunächst erforderlich, diese hier zu

           importieren bzw. zu aktualsieren, 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 aktualsieren, sofern neue Bedingungen hinzugefügt
           wurden.

Artikel-Zustand

Importieren Sie hier die verfügbaren Artikel-Zustzä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

• 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

• 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

• 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

• 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