Zugangsdaten eBay

Anmeldung im eBay Developer Account

Um eine Verbindung zu eBay aufbauen zu können, müssen Sie ein eBay Developer Account erstellen. Diesen erhalten Sie unter folgender Seite: https://developer.ebay.com/join/

Nachfolgend sehen Sie Anmeldeformular von eBay.

Füllen Sie nun das Formular aus und klicken danach auf "Join".

INFO: Speichern Sie sich die Zugangsdaten zu diesem Account ab, da der Schlüssel (Token) ca. alle 1 ½ Jahre aktuallisiert werden muss.

Nachdem Sie das Formular ausgefüllt haben, bekommen Sie eine Mail mit einem Bestätigungslink. Bestätigen Sie Ihre Registrierung mit dem Klick auf dem Link.

INFO: Nach der Registrierung kann es einige Tage dauern, bis Ihr Account freigeschalten wird und Sie ihre Zugangsdaten erstellen können!

Application-Key-Set erstellen

Geben Sie nun, wie auf dem Bild zu sehen, Ihren jetzt zu erstellenden Zugangsdaten einen beliebigen Namen (z.B. Ihren Shopnamen), in diesem Beispiel Coolbax und klicken bei "Production" auf "Create a keyset".

Wichtig: Nutzen Sie bitte NICHT die "Sandbox". Diese wird nicht von unserem Plugin unterstützt

eBay

Nachdem Klick sehen Sie ein neues Fenster. Füllen Sie das Formular aus und klicken auf "Continue to Create Keys"

Klicken Sie anschließend auf:"marketplace deletion/account closure notification"

Alerts & Notifikations

INFO: Für Kunden die bereits Ihre Zugangsdaten haben und die "Alerts & Notifikations" hinzufügen möchten, gehen bitte zur Navigation im rechten oberen Bildschirmrand und klicken auf: "Hi (Application Titel) > Application access keys.Klicken Sie anschließend in der Spalte "APP ID" auf "Notifikations".

Feldname	Bedeutung
Exempted from Marketplace Account Deletion	Aktiv schalten, wenn Sie NUR den Lagerabgleich oder Artikelexport für eBay verwenden.
Email to notify if marketplace account deletion notification endpoint is down	Tragen Sie hier ihre E-Mail Adresse ein.
Marketplace account deletion notification endpoint	Tragen Sie bitte folgende URL in dieses Feld ein und ändern "mein-shop.de" mit Ihrer Domain. https://mein-shop.de/backend/ConnectorEbayApi/ebayDeletion WICHTIG: Achten Sie bei der Vergabe der Domain darauf, dass die gleiche Domain wie in Ihren Shopware Grundeinstellungen verwendet wird. (Grundeinstellungen > Shopeinstellungen). Wichtig ist, ob Sie die Domain mit oder ohne "www" angegeben haben!
Verification token	Der Verification Token ist frei wählbar und muss zwischen 32 - 80 Zeichen lang sein. KEINE Sonderzeichen.

Bitte denken Sie daran, dass der "Verification token" auch im Plugin hinterlegt und gespeichert werden muss!

Sie können anschließend im eBay Developer Account einen Test durchführen um zu überprüfen, ob Ihre eingebenden Daten korrekt sind.Klicken Sie hierzu auf den Button "Send Test Notification".

App ID, Dev ID und Cert ID erstellen

Um nun zu Ihren API Zugangsdaten zu gelangen, gehen Sie wie folgt vor:

Gehen Sie zum rechten oberen Bilschirmrand und nutzen dort den Navigationspunkt "Hi (Application Titel)" > Application access keys.

Schon haben Sie Ihre Daten für das Plugin (Hier aus Sicherheitsgründen verschwommen dargestellt).

Kopieren Sie nun die App ID, Dev ID und Cert ID und fügen Sie diese in den entsprechenden Feldern ein.

Auth´n´Auth Token - User Token generieren/erneuern

INFO: Nach ca. 1½ Jahren verfällt der Auth´n´Auth Token und muss erneuert werden. Zur Erneuerung des Tokens gilt der gleiche nachfolgende Ablauf.

Um zu Ihrem User Token zu gelangen, klicken sie einfach auf den, wie auf dem Bild markierten Link "User Token".

Nutzen Sie anschließend den blauen Button mit der Aufschrift "Sign in to Production".

Es folgt ein weiteres Formular, welches einmalig komplett ausgefüllt werden muss. Achten Sie darauf, dass Sie alle Pflichtfelder (gekennzeichnet mit einem *) ausfüllen. Klicken Sie danach auf "Sign into eBay to get a Token". Dieser wird aktiv, wenn alle Pflichtfelder ausgefüllt sind.

Im nun folgenden Anmeldefenster müssen Sie sich in Ihrem NORMALEN eBay Account (nicht zum eBay Developer Account) anmelden. Nachdem Sie Ihre E-Mail Adresse bzw. Username eingegeben haben, klicken Sie bitte auf "Continue". Anschließend müssen Sie nur noch ihr Passwort eingeben und auf "Sign in" klicken.

Anschließend klicken Sie auf den blauen "Agree" Button.

Nun sehen Sie einen riesigen Key, genannt User Token (in unserem Fall wieder aus Sicherheitsgründen verschwommen dargestellt). Bitte beachten Sie, das dieser nur einmalig angezeigt wird. Sollten Sie das Fenster ausersehen schließen, müssen Sie den Vorgang wiederholen.

Diesen kompletten Key (User Token) in das Plugin eintragen. Es empfielt sich, ihn zu kopieren um Fehler zu vermeiden und Zeit zu sparen.

Überprüfen Sie anschließend mit einem Klick auf den blauen Button "Verbindung zur alten API überprüfen", ob die Daten richtig eingetragen sind. Sollte alles korrekt sein, werden die Zugangsdaten zum Auth´n´Auth Token ausgeblendet und rote Feld "Auth´n´Auth Token - Der Token ist abgelaufen oder ungültig" sollte nun grün und mit dem Hinweis des Ablaufdatums erscheinen.

oAuth2 Token - User Token generieren

INFO: Um zur nachfolgenden Seite zu gelangen gehen Sie ins Menü am oberen rechten Bildschirmrand und klicken auf: "Hi (Application Titel)" > Application access keys. Nutezen Sie anschließend den Link "User Token" in der Spalte "APP ID (Client ID)"

Um nun den oAuth2 Token zu generieren gehen Sie bitte auf "Get a Token from eBay via Your Application".

Klicken Sie anschließend auf den Link "+ Add eBay Redirect URL".

Sie erhalten nun den "RuName" welchen Sie in die Plugin Einstellungen eintragen müssen. Speichern Sie anschließend die Einstellungen ab

Kopieren Sie sich anschließend die URL welche in der Spalte "Url für ebay RuName" hinterlegt ist und wechseln Sie wieder in den eBay Developer Account.

Gehen Sie nun zum Anfang der Seite und klicken auf den Link "enable OAuth" (im Bild grün hinterlegt). Hiermit aktivieren Sie die OAuth Schnittstelle.

Fügen Sie in den Federn "Your auth accepted URL" und "Your auth declined URL" die kopierte URL ein. Speichern Sie die Einstellungen ab, indem Sie auf den Button "Save" klicken.

Gehen Sie nun wieder in Ihr Shopware Backend zu den Einstellungen des Plugins und betätigen den Button "oAuth2 Token generieren"

Anschließend geht in einem neuen Tap folgende Seite auf:

INFO: Sollten Sie sich bereits in Ihrem eBay Account eingeloggt haben, wird dieser Schritt übersprungen.

Im nun folgenden Anmeldefenster müssen Sie sich in Ihrem NORMALEN eBay Account (nicht zum eBay Developer Account) anmelden. Nachdem Sie Ihre E-Mail Adresse bzw. Username eingegeben haben, klicken Sie bitte auf "Continue". Anschließend müssen Sie nur noch ihr Passwort eingeben und auf "Sign in" klicken.

Anschließend kommen Sie auf folgende Seite:

Klicken Sie hier auf den blauen Button "I agree".

Abschließend sollten Sie folgende Erfolgsmeldung ausgegeben bekommen:

Mit dem erneuten Aufruf der Eistellungen erhalten Sie die Info, wann der oAuth2 Token ablaufen ist und wieder erneuert werden muss.

HINWEIS: Sollten Sie bereits den Bestellimport verwendet und nun das erste Mal einen oAuth2 Token generiert haben, müssen Sie anschließend noch auf den Button "Zuordnung der Versanddaten aktualisieren" klicken!

Dieses Feld wird nur einmalig angezeigt, wenn Sie bereits den eBay Bestellimport besitzen und zuvor keinen oAuth2 Token generiert haben. Klicken Sie auf den Button "Zuordnung der Versanddaten aktualisieren" um sicherzustellen, dass der Versandabgleich von Bestellungen, welche bereits im System vorhanden sind funktioniert!

Sollten Sie den Bestellimport das erste Mal nutzen, wird dieses Feld nicht angezeigt.