Anleitung: Zugangsdaten eBay (Shopware 5)
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".
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.
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".
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 ausversehen 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 nachließ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 hinerlegt). 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 Bestellimoprt das erste Mal nutzen, wird dieses Feld nicht angezeigt.