# Zugangsdaten eBay

## Anmeldung im eBay Developer Account <a href="#anmeldung" id="anmeldung"></a>

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.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FkMh3SsMAiIoTQnVjCqCC%2FSW5-eBayZugangsdaten-01.jpg?alt=media&#x26;token=d6c914b0-60fc-465b-b29b-711e0981dfc5" alt="" width="375"><figcaption></figcaption></figure>

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

{% hint style="info" %}
**INFO:** Speichern Sie sich die Zugangsdaten zu diesem Account ab, da der Schlüssel (Token) ca. alle 1 ½ Jahre aktuallisiert werden muss.
{% endhint %}

<div><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FCpADQh1MC1Ju4F7dtMGE%2FSW5-eBayZugangsdaten-02.jpg?alt=media&#x26;token=000fe9d7-67c4-4145-ad6a-9cffe9d31716" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FIpVDK7lOgbsaH0Woadmx%2FSW5-eBayZugangsdaten-03.jpg?alt=media&#x26;token=65bf3b80-f709-492f-92d0-584a78c2f2fc" alt=""><figcaption></figcaption></figure></div>

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.

{% hint style="info" %}
**INFO:** Nach der Registrierung kann es einige Tage dauern, bis Ihr Account freigeschalten wird und Sie ihre Zugangsdaten erstellen können!
{% endhint %}

## Application-Key-Set erstellen <a href="#application-key-set" id="application-key-set"></a>

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F7FUBYtleyKwyQ2gvW6aC%2Fhilfe-ebay-anmeldung4%20(1).jpg?alt=media&#x26;token=173c3f46-bee4-4d16-82f1-68ea1c4bc095" alt=""><figcaption></figcaption></figure>

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

{% hint style="warning" %}
**Wichtig:** Nutzen Sie bitte NICHT die "Sandbox". Diese wird nicht von unserem Plugin unterstützt
{% endhint %}

![eBay](https://www.coolbax.de/media/image/e4/ab/13/hilfe-ebay-anmeldung2.jpg)

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2Fu3hIdtkzCZ1eQb3rdHk4%2FSW5-eBayZugangsdaten-06.jpg?alt=media&#x26;token=c3a406ac-44e8-44ae-9f54-b210900341ad" alt=""><figcaption></figcaption></figure>

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

## Alerts & Notifikations <a href="#alertnotifikations" id="alertnotifikations"></a>

{% hint style="info" %}
**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".
{% endhint %}

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FCquY59M4dczWew8Kr63q%2FSW5-eBayZugangsdaten-07.jpg?alt=media&#x26;token=6acbf9e5-fe28-4164-a4e6-3c31f1d14b3e" alt=""><figcaption></figcaption></figure>

| 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                            | <p>Tragen Sie bitte folgende URL in dieses Feld ein und ändern "mein-shop.de" mit Ihrer Domain.<br><br><strong><https://mein-shop.de/backend/ConnectorEbayApi/ebayDeletion></strong><br></p><p><mark style="color:orange;"><strong>WICHTIG:</strong> 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!</mark></p> |
| Verification token                                                            | Der Verification Token ist frei wählbar und muss zwischen 32 - 80 Zeichen lang sein. KEINE Sonderzeichen.                                                                                                                                                                                                                                                                                                                                                                                                    |

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FDWpMhEqoookx7ofMrsq2%2FSW5-eBayZugangsdaten-08.jpg?alt=media&#x26;token=1da4d35a-543c-46d2-9cbb-78bc297f33eb" alt="" width="375"><figcaption></figcaption></figure>

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 <a href="#appdevcertid" id="appdevcertid"></a>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FaHw31UX4UhxA6figgBq3%2FSW5-eBayZugangsdaten-09.jpg?alt=media&#x26;token=cc9f0164-8847-4e31-b5de-b91d42690e75" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F9lIKzj39RpzDJDR30mnk%2FSW5-eBayZugangsdaten-10.jpg?alt=media&#x26;token=bdba32bb-5b08-4602-9ed5-7cf403dda20e" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F8VRBxJqqhSLI0vFR8qsU%2FSW5-eBayZugangsdaten-11.jpg?alt=media&#x26;token=bce19802-8541-4b07-9761-4a2b3c0e94db" alt="" width="375"><figcaption></figcaption></figure>

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 <a href="#auth" id="auth"></a>

{% hint style="info" %}
**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.
{% endhint %}

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FPC53XVbE4K3ml4s96Cw6%2FSW5-eBayZugangsdaten-12.jpg?alt=media&#x26;token=831655b8-d363-4c31-9cf8-62f4560926ee" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2Fe3lM1YMZtsy6BPKpjLaV%2FSW5-eBayZugangsdaten-13.jpg?alt=media&#x26;token=2b8be62c-c2e4-4fff-a976-64d9732ba82f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FOEWzw9KTLlc78n8jp12M%2FSW5-eBayZugangsdaten-14.jpg?alt=media&#x26;token=21a693a9-faaa-4417-9beb-98de930a1458" alt="" width="300"><figcaption></figcaption></figure>

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.

<div><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FgqPRrlI7uLxN2P8QUdi7%2FSW5-eBayZugangsdaten-15.jpg?alt=media&#x26;token=9b692cbb-037d-410d-8859-49e2ede1446b" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FJI3Q10wspujhwAme9ZoY%2FSW5-eBayZugangsdaten-16.jpg?alt=media&#x26;token=ed54776b-c1f3-4eb2-9273-a1b34173a13a" alt=""><figcaption></figcaption></figure></div>

&#x20;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.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FYM2I4SJbEhb45uX1im26%2FSW5-eBayZugangsdaten-17.jpg?alt=media&#x26;token=2d7ee65a-285e-4d79-a7d2-094f2eaee874" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FVI5TSQza6JGt04hDDLCX%2FSW5-eBayZugangsdaten-18.jpg?alt=media&#x26;token=39e8fcb8-1c28-4476-903c-1377e769a3bb" alt="" width="375"><figcaption></figcaption></figure>

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.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FtbQOWwp6CZTV6Sk3KPSS%2FSW5-eBayZugangsdaten-19.jpg?alt=media&#x26;token=9ca3189a-1041-4a9b-ad80-cb98a9184094" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FFgEZMp0DBxuW6Z98zr6f%2FSW5-eBayZugangsdaten-20.jpg?alt=media&#x26;token=3276ffc6-8b40-4f03-94b3-823874b40c74" alt="" width="375"><figcaption></figcaption></figure>

Ü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 <a href="#oauth2" id="oauth2"></a>

{% hint style="info" %}
**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)"
{% endhint %}

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FjUAyMxd616kUZi49FE1K%2FSW5-eBayZugangsdaten-21.jpg?alt=media&#x26;token=a5451b80-613a-4b1c-9166-d03d10278670" alt="" width="375"><figcaption></figcaption></figure>

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

<div><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F5AIx4ZqaXxvhdZAvm8hY%2FSW5-eBayZugangsdaten-22.jpg?alt=media&#x26;token=8738a136-d368-49ec-8481-179d55037fd1" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FZ5pCWajsFs59ZtOHCQCf%2FSW5-eBayZugangsdaten-23.jpg?alt=media&#x26;token=1a09c0cb-4be0-4b1a-b39f-24fad89d8d76" alt=""><figcaption></figcaption></figure></div>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F5w6q1NcDdMwfgCIEcSPa%2FSW5-eBayZugangsdaten-24.jpg?alt=media&#x26;token=3fa084ba-0226-42f4-9b38-4d9667f7f786" alt="" width="375"><figcaption></figcaption></figure>

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.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FJ1siy2Qbr5EojkgoeXbd%2FSW5-eBayZugangsdaten-25.jpg?alt=media&#x26;token=34850315-0986-4ae7-955b-b27abbdc3f13" alt="" width="375"><figcaption></figcaption></figure>

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.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FF3Gl0YmjuJANfoXHl4XZ%2FSW5-eBayZugangsdaten-26.jpg?alt=media&#x26;token=d5c88145-4281-42f9-8782-6a4e4ef230df" alt="" width="375"><figcaption></figcaption></figure>

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"

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FCx7bx5UIo7H7xYxNxIj6%2FSW5-eBayZugangsdaten-27.jpg?alt=media&#x26;token=dc5c66e9-4713-482c-a42b-b8ce19219b92" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
**INFO:** Sollten Sie sich bereits in Ihrem eBay Account eingeloggt haben, wird dieser Schritt übersprungen.
{% endhint %}

<div><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FpyjXeXaKyE5KX19GgHZb%2FSW5-eBayZugangsdaten-28.jpg?alt=media&#x26;token=460e3091-651e-40af-8699-6d6e14bc92ad" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FK1IvdD8ElF1aAyLaknZI%2FSW5-eBayZugangsdaten-29.jpg?alt=media&#x26;token=f7f27154-b9a7-422f-85aa-4565e714a7f5" alt=""><figcaption></figcaption></figure></div>

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:

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FKJrSIoTzUEORjuzZP4r6%2FSW5-eBayZugangsdaten-30.jpg?alt=media&#x26;token=63718878-dc6f-41fa-bda9-ec0be2b1aea9" alt="" width="375"><figcaption></figcaption></figure>

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

Abschließend sollten Sie folgende Erfolgsmeldung ausgegeben bekommen:

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FiflfZw9nqbGWOpQYnocI%2FSW5-eBayZugangsdaten-31.jpg?alt=media&#x26;token=4d55ef89-7817-4e50-b9f3-5b843c2f185f" alt="" width="410"><figcaption></figcaption></figure>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FiUC4Xfwhp6rR8ZhD8nbB%2FSW5-eBayZugangsdaten-32.jpg?alt=media&#x26;token=d5b5c6ed-45d2-44c2-9343-ba0ad23b780c" alt="" width="375"><figcaption></figcaption></figure>

**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!

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FSTulfB4FnvNPduXbFjiP%2FSW5-eBayZugangsdaten-33.jpg?alt=media&#x26;token=6de143db-83d8-49fc-a539-5373899f5c93" alt="" width="375"><figcaption></figcaption></figure>

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.