> For the complete documentation index, see [llms.txt](https://csv4you-1.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://csv4you-1.gitbook.io/guide/schnittstellen/marketplace/ebay.md).

# eBay

***

## Konto verknüpfen

![Verbindung mit eBay herstellen](https://data.csv4you.com/media/image/guide/meinkonto/grundeinstellungen/meinkonto-grundeinstellungen-ebay-verbinden.png)

Die Einrichtung der eBay-Verbindung ist notwendig, um Daten zwischen eBay und CSV4YOU austauschen zu können. Dabei wird eine sichere OAUTH-Verbindung erstellt, welche bei Erfolg einen gültigen TOKEN zurück gibt.

***

## Kategorie und Artikelmerkmale

#### eBay Kategorie zuweisen

![Kategorie Übersicht](https://data.csv4you.com/media/image/guide/ebay/ebay-kategorie-uebersicht.png) ![eBay-Kategorie zuweisen](https://data.csv4you.com/media/image/guide/ebay/ebay-kategorie-ebaykategorie.png) ![eBay-Kategorie wurde bereits zugeweisen](https://data.csv4you.com/media/image/guide/ebay/ebay-kategorie-ebaykategorie-vorhanden.png)

Sie müssen zuerst den internen Kategorien eine eBay-Kategorie zuordnen. Wenn Sie keine internen Kategorien benutzen, können Sie diese auch dem Produkt selbst zuweisen.

{% hint style="info" %}
Wir empfehlen die eBay-Kategorie-ID zuerst einer [internen Kategorie](/guide/seiten/datenpool/categories.md) zuzuweisen. Nur mit einer hinterlegten eBay-Kategorie können Sie Artikelmerkmale zuweisen. Wenn Sie einen Shop auf eBay betreiben, müssen die passenden Shopkategorien auch auf diesen Seite hinterlegt werden.
{% endhint %}

#### Artikelmerkmale zuweisen

![Kategorie Übersicht mit eBay-Kategorie-ID](https://data.csv4you.com/media/image/guide/ebay/ebay-kategorie-artikelmerkmale-uebersicht.png) ![Artikelmerkmale zuweisen](https://data.csv4you.com/media/image/guide/ebay/ebay-kategorie-artikelmerkmale-eintragen.png)

Sie müssen zuerst den internen Kategorien Artikelmerkmale zuordnen. Wenn Sie keine internen Kategorien benutzen, können Sie diese auch dem Produkt selbst zuweisen.

{% hint style="danger" %}
Rote Artikelmerkmale sind Pflichtfelder!!
{% endhint %}

{% hint style="info" %}
Wir empfehlen die Artikelmerkmale zuerst den internen Kategorie zuzuweisen. Eine Zuweisung bei den Artikel ist nur bei speziellen Merkmalen nötig, welche zum Beispiel nicht in den Produktdaten vorkommen.

Sollten Sie mit dem CSV-Manager und Variantenartikel arbeiten, benötigen die Parents eigenständige Artikelmerkmale.
{% endhint %}

#### Artikelmerkmale Im- und Exportieren

![eBay Artikelmerkmale exportieren](https://data.csv4you.com/media/image/guide/ebay/ebay-kategorie-artikelmerkmale-exportieren.png) ![eBay Artikelmerkmale importieren](https://data.csv4you.com/media/image/guide/ebay/ebay-kategorie-artikelmerkmale-importieren.png)

Sie finden den Menüpunkt 'Import/Export' auf der Seite der Artikelmerkmale. Dort können Sie die Artikelmerkmale exportieren, in einem Texteditor oder ähnlichem bearbeiten und danach wieder importieren.

**Auswahlmöglichkeiten für den Export**

* **passenden Kategorien**\
  Es werden alle interne Kategorien mit exportiert, welche der selben eBay Kategorie zugeordnet sind.
* **passende Produkte**\
  Es werden alle Produkte mit exportiert, welche der selben eBay Kategorie zugeordnet sind.
* **Download als ZIP-Archiv**\
  Export als ZIP-Datei

**Wichtiger Hinweis zum Aufbau der Ex-/Importdatei**

Sie können jederzeit manuell Einträge beim Bearbeiten der Exportdatei hinzufügen. Wichtig sind dabei die ersten beiden Spalten.

* **itemno**\
  Hier steht die interne Kategorie-ID oder die ID/SKU des Artikels
* **typeof**\
  'category' oder 'product', abhängig von der Art des Eintrages

***

## aktuelle eBay-Listings abrufen

![Einlesen unter 'Listings->eBay'](https://data.csv4you.com/media/image/guide/ebay/ebay-zuruecklesen-listings.png) ![Einlesen unter 'Mein Konto->Grundeinstellungen->eBay'](https://data.csv4you.com/media/image/guide/ebay/ebay-zuruecklesen-meinkonto.png)

Um immer einen aktuellen Stand Ihrer Listings zu haben, müssen diese Daten in unser System zurückgelesen werden. Diese Daten dienen nur zum Vergleichen. Es werden immer die eBay-Listings-ID sowie Preis und Bestand benötigt. Sie können das Zurücklesen manuell durchführen oder mit einem Cronjob erledigen lassen.

Ein Zurücklesen auf der Seite `Listings->eBay`mit dem Button `Daten von eBay einlesen` schreibt nur die Daten für die gerade benutzte Datenquelle. Es werden trotzdem im Hintergrund ALLE Listings von eBay zurückgegeben.

Das Zurücklesen auf der Seite `Mein Konto->Grundeinstellungen->eBay` unter der Auswahl `Cronjob: Daten von eBay einlesen`, schreibt die Daten für ALLE Datenquellen. Sie müssen also nicht für jede Datenquelle das Zurücklesen durchführen. Dieses ist aber nur möglich, wenn Sie einen Cronjob hierfür eingerichtet haben.

{% hint style="info" %}
Ein Abgleich erfolgt immer mit der SKU(Bestandseinheit) bei eBay und der ausgewählten Artikelnummer im CSV4YOU.

Sollten Sie Listings direkt bei eBay oder mit anderen Systemen gelöscht haben, empfehlen wir die vorhandenen Zuweisungen in unserem System zu entfernen. Es werden KEINE Daten bei eBay geändert. Danach können Sie erneut zurücklesen.
{% endhint %}

#### Möglichkeiten des Zurücklesens

* **Inventoryfile**\
  Es werden alle aktiven Listings in einer Datei von eBay zur Verfügung gestellt. Die Erstellung dieser Datei auf den eBay-Servern kann unter Umständen etwas länger dauern. Es kann bei der Erstellung zu Abbrüchen auf Seiten von eBay kommen, welche uns nicht mitgeteilt werden. Das Einlesen wird dann nicht ausgeführt. Eine Unterscheidung der Listings auf unterschiedliche Marktplätze erfolgt nicht, da diese Datei keine Informationen dazu beinhaltet.
* **Sofort - Sofortiges Einlesen**\
  Schnelle Abarbeitung, je nach Anzahl der Listings, da eBay die Daten sofort zurück gibt.
* **Sofort(nur Vorbereitete) - Sofortiges Einlesen nur der vorbereiteten Produkte**\
  Wenn Sie Produkte neu an eBay übertragen haben, können Sie diese damit zurücklesen. Diese Auswahl steht Ihnen nur unter `Listings->eBay` zur Verfügung.

***

## Produkte an eBay übermitteln - Export

Dieser Abschnitt betrifft spezielle Einstellungen für eBay im Bereich [Sonstiges](/guide/seiten/export/interface.md#sonstiges) des Exportprofiles.

{% hint style="danger" %}
Einzelartikel ohne Bestand können im eBay nicht neu angelegt werden.
{% endhint %}

#### eBay-Marktplatz auswählen

![eBay-Marktplatz auswählen](https://data.csv4you.com/media/image/guide/ebay/exportprofil/ebay-exportprofil-einstellungen.png)

Sie müssen zuerst einen eBay-Marktplatz auswählen, in den Sie Ihre Produkte einstellen möchten. Weitere Einstellmöglichkeiten erscheinen nach dem Speichern des Marktplatzes.

#### Einstellungen vornehmen

![eBay-Marktplatz auswählen](https://data.csv4you.com/media/image/guide/ebay/exportprofil/ebay-exportprofil-einstellungen-2.png)

* **eBay Land**\
  Auswahl des eBay-Marktplatzes, wo Sie Ihre Produkte einstellen möchten
* **Format/Dauer der Listings**\
  Auswahl des Angebotformates und deren Laufzeit
* **Art des Listings**\
  Wollen Sie Listings neu anlegen, Updaten oder Beenden?
* **Was möchten Sie zu eBay übertragen?**\
  Auswahl der zu übertragenden Produktinformationen
* **Übertragungsart**
  * **Single**\
    Produkte werden einzeln übertragen und sofort von eBay verarbeitet. Dadurch kann der Export länger dauern. Empfehlung nur bis 1000 Produkte
  * **Multi**\
    alle Produktdaten werden gesammelt und am Ende in einem Schritt an eBay übermittelt
* **Rahmenbedingungen für Zahlungen, Rücksendungen, Versand**\
  Für eBay sind sogenannte Rahmenbedingungen erforderlich. Diese müssen Sie direkt in Ihrem eBay-Konto anlegen. Im Anschluss daran können die jeweiligen Optionen mit einem Klick auf die Lupe ausgewählt werden.\
  Als Standard wir immer der Name der Bedingung übernommen. Sollten Sie Ihre Rahmebedingung öfters umbenennen, können Sie auch die ID der Rahmenbedingung eintragen.

{% hint style="info" %}
[Preiskalkulation](/guide/seiten/export/pricecalculation.md) und [Produkttemplate](/guide/seiten/export/templates.md), wenn benötigt, sollten auf der Seite [Grundeinstellungen](/guide/seiten/export/interface.md#grundeinstellungen) bereits ausgewählt sein. eBay-Kategoriezuordnung und Zuweisung der passenden Artikelmerkmale haben Sie auch bereits durchgeführt.
{% endhint %}

{% hint style="danger" %}
Sie müssen in Ihrem eBay-Konto die Option [Nicht mehr vorrätig](https://www.ebay.de/help/selling/listings/creating-managing-listings/multiquantity-listings-listings-variations?id=4150\&st=3\&pos=1\&query=Mehrfach-Angebote%20und%20Angebote%20mit%20Varianten\&intent=multiple\&lucenceai=lucenceai\&docId=HELP1059#section5) aktivieren. Artikel mit einem NULL-Bestand können sonst bei eBay nicht aktualisert werden.
{% endhint %}

***

## Preiskalkulation

Eine Übersicht der Einstellungen finden Sie [hier](/guide/seiten/export/pricecalculation.md).

***

## Produkttemplate

Eine Übersicht zur Arbeit mit Produkttemplates finden Sie [hier](/guide/seiten/export/templates.md).

***

## Statusbericht des letzten Exportes

**Auszug oft vorkommender Statusmeldungen**

* **Eingabedaten für Tag < BrandMPN > sind ungültig oder fehlen. Bitte lesen Sie die API-Dokumentation.**\
  Es fehlen beim Produkt anscheinend die Eigenschaften Marke und/oder Herstellerartikelnummer.
* **Die von Ihnen angegebenen Versandbedingungen sind ungültig.**\
  Wählen Sie unter Rahmenbedingungen einen vorhandenen Eintrag beim Bereich Versand aus. Benutzen Sie dazu die Lupe.

***

## Produkte für den Export sperren

![Produkte für Marktplätze sperren/freischalten](https://data.csv4you.com/media/image/guide/ebay/product/ebay-product-sperren.png) ![Ansicht gesperrte Artikel](https://data.csv4you.com/media/image/guide/ebay/product/ebay-product-sperren-2.png)

Sie können im Abschnitt `eBay` der Einstellungen des Produktes angeben, ob ein Produkt auf bestimmten Marktplätzen gesperrt werden soll. Diese Produkte werden dann bei der Übertragung zu eBay nicht übermittelt.

***

## Fehlermeldungen

* **\[1002] Missing access token**\
  In einigen Fällen wird der bei uns hinterlegte Verbindungstoken nicht mehr akzeptiert oder ist abgelaufen. Erneuern Sie Ihre [eBay-Verbindung](/guide/mein-konto/settings.md#ebay).
