> For the complete documentation index, see [llms.txt](https://coolbax.gitbook.io/coolbax-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md).

# Zugangsdaten eBay

In dieser Schritt-für-Schritt Anleitung erfahren Sie, wie Sie an die Zugangsdaten für den eBay Marktplatz Bestellimport gelangen.

## Anmeldung / Registrierung 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:&#x20;

{% embed url="<https://developer.ebay.com/signin?return_to=/my/keys>" %}
Anmeldung oder Registrierung im eBay Developer Account
{% endembed %}

Füllen Sie das Formular unter den Tap "Register" komplett aus.

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="warning" %}
**Beachten Sie:** Nach der Registrierung kann es einige Tage dauern, bis Ihr Account freigeschalten wird und Sie ihre Zugangsdaten erstellen können!
{% endhint %}

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

Nachdem Sie die Freigabe Ihrer Zugangsdaten für den eBay Developer Account erhalten haben, können Sie mit der Erstellung der Zugangsdaten beginnen.

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

Geben Sie anschließend Ihren zu erstellenden Zugangsdaten einen beliebigen Namen (z. B. Ihren Shopnamen) und klicken Sie bei „Production“ auf „Create a keyset“.

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FM4YKtJ37Buc6FAsgJkzb%2Febay-zugangsdaten-28_big.jpg?alt=media&amp;token=176a750f-3a0a-494b-b53f-7b2217ffc259" alt="" width="383"><figcaption></figcaption></figure>

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%2FPqAKVdseK5u5xK9TOSET%2Febay-zugangsdaten-29_big.jpg?alt=media&amp;token=226df1d6-23bc-449c-99da-83207e9f5739" alt="" width="450"><figcaption></figcaption></figure>

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

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

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

<div><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FyNAT7jFJepK4K9nMkRMQ%2Febay-zugangsdaten-4_big.jpg?alt=media&amp;token=fe1b618f-d926-44b8-961b-f0c86758e091" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FqrupMObr1i8aZst1nMTK%2Febay-zugangsdaten-31_big.jpg?alt=media&amp;token=cf7f3fca-ab35-43d2-b67d-535020d8386a" alt=""><figcaption></figcaption></figure></div>

| 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                            | In der Konfiguration des Plugins finden Sie in der Spalte "Marketplace account deletion notification endpoint" die URL welche hier hinterlegt werden muss. |
| Verification token                                                            | Der Verification Token darf 32 - 80 Zeichen besitzen und wird, mit Aktivierung des Plugins, per Zufall generiert. Es sind KEINE Sonderzeichen erlaubt.     |

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F9yZnGkdezl0LaAMPMYjG%2Febay-zugangsdaten-30_big.jpg?alt=media&amp;token=6075ec22-f2dc-4c78-88f3-9f97219df1ad" 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".

## Auth´n´Auth Token & oAuth2 Token einrichten

### 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%2FF0iYG57hMpP04AqjGJTa%2Febay-zugangsdaten-6_big.jpg?alt=media&amp;token=8405dfe2-8a81-4905-85f0-f577daf58478" 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%2Fr4R8W3aTF6czqMJg1VbH%2Febay-zugangsdaten-7_big.jpg?alt=media&amp;token=466c5248-9891-42ae-8c22-cd950b932e4e" 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%2FzSrBKnZAXZkhnGwqqUQF%2Febay-zugangsdaten-32_big.jpg?alt=media&amp;token=b97639c0-b99d-4fee-a5e8-d2f8e242200f" 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>

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FlspLJE6bPnAxGvzBJW4W%2Febay-zugangsdaten-8_big.jpg?alt=media&amp;token=61c10b5e-fd52-4bc1-9b92-7f0720f2a914" 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%2F2yJhlsJjvhTh5DhPhC63%2Febay-zugangsdaten-9_big.jpg?alt=media&amp;token=b0a8288e-5a17-4ce5-8c4d-7cbdcf59259c" alt="" width="375"><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%2FyA0YxI3CtVmNFCQqW2t3%2Febay-zugangsdaten-10_big.jpg?alt=media&amp;token=53995853-2831-4bf9-9700-ae1a358f8beb" alt="" width="450"><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%2FlATWcZ8by4dsEsot5Bgk%2Febay-zugangsdaten-11_big.jpg?alt=media&amp;token=31936bd6-71fa-4008-b2e8-2deb0c94869b" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FzPGNzSKdqrZEwrsVdx7g%2Febay-zugangsdaten-12_big.jpg?alt=media&amp;token=28d18ee2-4122-44fd-9c26-2a3146bff93e" 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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FBtWpnZOITLC7xz3mlkpS%2Febay-zugangsdaten-14_big.jpg?alt=media&amp;token=915122e6-7692-40d8-8b68-594a65eb4d45" 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%2FDAMGbmUOlZCGydAOmXJs%2Febay-zugangsdaten-15_big.jpg?alt=media&amp;token=dbfa0a13-ad27-4a6a-9d7d-347b0c50d1e1" 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 ausversehen 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%2FTo4umynq0UdGyPMZLUCH%2Febay-zugangsdaten-33_big.jpg?alt=media&amp;token=9c24aa44-f69e-45c6-aaa1-a8d2a145f277" 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%2Fu5lJTLK7kVF75mBUYtSD%2Febay-zugangsdaten-34_big.jpg?alt=media&amp;token=921eee6a-a9aa-4411-b4da-400be54abcdd" alt="" width="375"><figcaption></figcaption></figure>

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

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

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F6XFqj2uOxOAtbnUaxn86%2Febay-zugangsdaten-18_big.jpg?alt=media&amp;token=cd78804d-36bf-49f7-a5c0-e66b2de99d20" 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%2F9IQwHFzUizQaJGHGNwIP%2Febay-zugangsdaten-19_big.jpg?alt=media&amp;token=37144761-1168-4d54-8706-55cb93b54c08" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FAFZpQmPP84Wg9hM3Tw4S%2Febay-zugangsdaten-35_big.jpg?alt=media&amp;token=7697e6cb-e41f-4b56-b4c3-be77c475ff9f" alt=""><figcaption></figcaption></figure></div>

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%2F4R3sllkq3UNhIb59niXW%2Febay-zugangsdaten-36_big.jpg?alt=media&amp;token=ca508da5-68cb-4efa-9e45-015d3c311e0d" 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%2FfZaR5C6QWcYhVjeaNgGu%2Febay-zugangsdaten-40_big.jpg?alt=media&amp;token=fb882532-42df-4545-b13d-0c1c4f2331a4" 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%2F9iZXD0v47sWQSK3iCSDh%2Febay-zugangsdaten-22_big.jpg?alt=media&amp;token=4d6bb002-3002-4505-9fd1-54d40233c64c" 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%2FMgUjRqUIALV4ztutfysO%2Febay-zugangsdaten-37_big.jpg?alt=media&amp;token=d3b4c533-d0df-4f25-a666-58e220ccb6ca" alt="" width="375"><figcaption></figcaption></figure>

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

<div><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FW6jKyYvHgIZhIyzXWIhN%2Febay-zugangsdaten-11_big.jpg?alt=media&amp;token=7f3b89dc-4417-4973-aa4d-239ca87ba6a3" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FPgLawJdMn2EiU9YE5A6W%2Febay-zugangsdaten-12_big.jpg?alt=media&amp;token=43415896-05f9-413f-8d1e-4662aa9cb10d" 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%2F8yclChGBx9I2k6XOvq57%2Febay-zugangsdaten-24_big.jpg?alt=media&amp;token=74d76194-64c4-4311-b10e-edecc69bc68c" 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%2F6wt9NDTcNGdgxRYmb97m%2Fimage.jpg?alt=media&amp;token=10eb116e-d0fd-435f-bfbb-b91cf013ff79" alt=""><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%2FH5J1dfhFplm2mOfNZTrN%2Febay-zugangsdaten-39_big.jpg?alt=media&amp;token=559c83f2-1fdc-476d-be51-5f4e52249cb8" alt="" width="375"><figcaption></figcaption></figure>