# eBay Bestellimport

## Installation <a href="#installation" id="installation"></a>

{% hint style="info" %}
Wichtig: Bitte beachten Sie, dass für die Verwendung dieses Plugin folgendes Plugin einmalig installiert und aktiviert sein muss:  "[Externe Bestellverwaltung](https://store.shopware.com/de/cbax642317535409/externe-bestellverwaltung-gpsr.html)".
{% endhint %}

Sie können das Plugin über den Shopware Community Store erwerben. Das Plugin wird wie ein ganz gewöhnliches Plugin installiert.&#x20;

{% embed url="<http://store.shopware.com/cbax386127106101/ebay-bestellimport-erweiterung.html>" %}
Plugin über den Shopware Community Store erwerben
{% endembed %}

Nach der Installation des Plugins öffnet sich die Konfigurationsmaske des Plugins.

## Die Einstellungen des Plugins <a href="#plugin_einstellungen" id="plugin_einstellungen"></a>

Nach der erfolgreichen Installation des Plugins klicken Sie auf den Button "Einstellungen aufrufen" um die Einstellungen des Marktplatzes festzulegen.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FQGUOfckarQgrvLtf8xrf%2FSW5-eBayBestellimport-01.jpg?alt=media&#x26;token=e4a4db10-a297-4976-85a9-eaa10fe22824" alt="" width="375"><figcaption></figcaption></figure>

| Feldname               | Bedeutung                                                         |
| ---------------------- | ----------------------------------------------------------------- |
| Einstellungen aufrufen | Über diesen Button rufen Sie die detaillierten Einstellungen auf. |

### Zugangsdaten <a href="#plugin_einstellungen_detail" id="plugin_einstellungen_detail"></a>

Ihre Zugangsdaten erhalten Sie durch Klick auf folgenden Link. Nach der Anmeldung können Sie Ihre Zugangsdaten erstellen und im Plugin eintragen. Wenn Sie Probleme haben helfen wir Ihnen gerne weiter.

{% embed url="<https://developer.ebay.com/join/>" %}
Zu den Zugangsdaten
{% endembed %}

{% embed url="<https://coolbax.gitbook.io/coolbax-docs/shopware-5-plugins/marktplatze/ebay-bestellimport/zugangsdaten-ebay>" %}
Schritt-für-Schritt Anleitung
{% endembed %}

### Allgemeine Einstellungen <a href="#allgemein" id="allgemein"></a>

Wir empfehlen die Einstellungen auf dem Screenshot zu übernehmen. Natürlich können Sie auch andere verwenden.

<div><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FySujQRATuYVdfYzpgvQW%2FSW5-eBayBestellimport-02.jpg?alt=media&#x26;token=29e7b1a7-c265-46ff-bbfa-bd79710c93c0" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FYGs3ZIFp6wyBkK0MftNf%2FSW5-eBayBestellimport-03.jpg?alt=media&#x26;token=542f993a-2bbd-4147-afe1-61296bb17e5c" alt=""><figcaption></figcaption></figure></div>

| Alerts & Notifications |                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Verification-Token     | Verification-Token zur Benachrichtigung über Löschungen von eBay, 32-80 alphanumerische Zeichen, keine Sonderzeichen. Hinweis: Vergessen Sie nicht Ihre Shop-URL im eBay Developer zu hinterlegen. Für das URL-Schema siehe die [Hilfeseite Zugangsdaten](https://coolbax.gitbook.io/coolbax-docs/shopware-5-plugins/marktplatze/ebay-bestellimport/zugangsdaten-ebay) unter dem Abschnitt "Alerts & Notifikations" |

| Zugangsdaten |                                                          |
| ------------ | -------------------------------------------------------- |
| DEV-ID       | DEV-ID zur API von eBay                                  |
| APP-ID       | APP-ID zur API von eBay                                  |
| CERT-ID      | CERT-ID zur API von eBay                                 |
| User-Token   | User-Token zur API von eBay                              |
| Marktplatz   | Der eBay Marktplatz auf dem die Artikel gelistet werden. |

| Import                                  |                                                                                                              |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Nur Bestellungen mit dem Status abholen | Nicht Versendet (empfohlen)                                                                                  |
| Letzter automatischer Import            | Wann wurde der letzte automatische Import durchgeführt                                                       |
| Bestellstatus nach Import               | Welchen Bestellstatus sollen die Bestellungen nach dem Import haben                                          |
| Zahlstatus nach Import                  | Welchen Zahlstatus sollen die Bestellungen nach dem Import haben                                             |
| Bestellstatus eBay Plus                 | Welchen Bestellstatus sollen die Bestellungen haben, wenn sich eBay Plus Artikel in der Bestellung befinden. |

{% hint style="success" %}
**TIPP:** Wir empfehlen die Einstellung bei - Zahlungsstatus nach Import - auf "Komplett bezahlt" zu setzen, wenn eBay die Zahlungsabwicklung übernimmt. Barzahlungen werden automatisch auf "Offen" gesetzt.\
\
Nutzen Sie noch die alten Zahlungsmetoden, setzen Sie bitte den Zahlungsstatus auf "Offen", da PayPal Bestellungen automatisch auf "Komplett bezahlt" gesetzt werden.
{% endhint %}

| Zuordnung Allgemein |                                                                                                                                                                                                                             |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Subshop             | Welchem Shop sollen die Bestellungen zugeordnet werden                                                                                                                                                                      |
| Steuersatz          | Welchen Steuersatz sollen die Bestellungen bekommen                                                                                                                                                                         |
| Kundengruppe        | Welcher Kundengruppe sollen die Bestellungen zugewiesen werden? Am Besten Sie nehmen eine neue Kundengruppe z.B.: eBay, dann können Sie auch eigene Preise pflegen und die Bestellungen in der Statistik getrennt auswerten |

| Zuordnung Versandarten                                                                                                                                   |                                                                              |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Standard Versandart                                                                                                                                      | Welcher Versandart sollen die Bestellungen standartmäßig zugewiesen werden.  |
| Standard Versand Dienstleister:                                                                                                                          | Über welchen Versand Dienstleister werden die Waren standartmäßig versendet? |
| Nachfolgend können Sie von den Standardeinstellungen abweichen, wenn Sie länderabhängig unterschiedliche Versandarten oder Versand Dienstleister nutzen. |                                                                              |

{% hint style="success" %}
**TIPP:** Einzelne Abweichungen können nochmals in der Bestellung eingestellt werden.
{% endhint %}

| Feedback                   |                                                                                                                                                                                                   |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bewertungen für den Käufer | Hier können zeilengetrennt Bewertungen hinzugefügt werden, die beim Melden des Versandstatus an eBay mit hochgeladen werden. Bei mehreren Einträgen wird immer eine Bewertung per Zufall gewählt. |

| Zuordnung Zahlungsarten |                       |
| ----------------------- | --------------------- |
| Zahlungsart             | Zuordnung Zahlungsart |

{% hint style="warning" %}
**Wichtig:** Es können nur Bestellungen importiert werden, wo der Kunde die Kaufabwicklung abgeschlossen hat.
{% endhint %}

## Lagerbestand im Shop abgleichen <a href="#lagerabgleich" id="lagerabgleich"></a>

Um den Lagerbestand im Shop abzugleichen, müssen die Artikelnummern aus dem Shop auch auf eBay (in eBay als Bestandseinheit bezeichnet) hinterlegt werden. Wenn die Artikelnummern nicht identisch sind, dann werden die Bestellungen zwar importiert, aber kein Lagerbestand abgeglichen.

## Einstellungen im eBay Account für eBay Plus <a href="#einstellungen_ebayplus" id="einstellungen_ebayplus"></a>

Kunden, welche eBay Plus verwenden möchten, müssen in Ihrem eBay Account alle Versandservice für eBay Plus deaktivieren:

Gehen Sie hierzu in Ihrem eBay Account auf: Mein eBay > Zusammenfassung > eBay Konto > Versandeinstellungen (unter Verkaufen)

<div><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FBPNOiBzh9iYq8Ud6Z8i8%2FSW5-eBayBestellimport-04.jpg?alt=media&#x26;token=cf111ad1-2c6d-4a6e-b826-7324b770150c" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FBP3c7YOD1M8roWOjhmJK%2FSW5-eBayBestellimport-05.jpg?alt=media&#x26;token=719b9e77-6702-4ffc-ab17-f82252537801" alt=""><figcaption></figcaption></figure></div>

Entfernen Sie hier bitte alle Haken bei den Versandservice. Erst mit Entfernung dieser Einstellung/en erhält das Plugin über die eBay Schnittstelle die Information, ob es sich um eine eBay Plus Bestellung handelt oder nicht.

## Bestellungen importieren <a href="#bestellungen_importieren" id="bestellungen_importieren"></a>

Sie habe zwei Möglichkeiten die Bestellungen von eBay in Ihr Shopware Backend zu holen.

### Manueller Import <a href="#manueller_import" id="manueller_import"></a>

Für das manuelle Abholen einer eBay Bestellung benötigen Sie die Bestellnummer von der eBay Bestellung. Um diese zu erhalten gehen Sie in Ihren eBay Account auf "mein eBay > alle Bestellungen". Kopieren Sie sich die Bestellnummern, welche Sie importieren möchten.

<div><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FBx3yZa6I9o5kFfLwFUK6%2FSW5-eBayBestellimport-06.jpg?alt=media&#x26;token=27e650d9-df84-431a-a84c-e526a648bd09" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FlG5T4qE5cKJbRwF8upnb%2FSW5-eBayBestellimport-07.jpg?alt=media&#x26;token=f6c057f4-63ff-4698-9a2f-0a238e3ba0c2" alt=""><figcaption></figcaption></figure></div>

Gehen Sie nun ins Backend von Shopware und öffnen die Externe Bestellungen. Klicken Sie auf der linken Seite den Button "Neue Bestellung importieren". Wählen Sie den Marktplatz "eBay" aus und fügen Ihre Bestellnummer ein. Mehrere Bestellnummern einfach untereinander einfügen. Klicken Sie anschließend auf den Button "Importieren".

### Automatischer Import - Cronjob einrichten <a href="#cronjob_einrichten" id="cronjob_einrichten"></a>

Für den automatischen Import benötigen Sie zwei aktive Cronjobs. Bei der Installation werden diese angelegt. Sie sind für die Abarbeitung der Aufträge verantwortlich.

* **eBay Bestellungen importieren** - Holt die Bestellungen von eBay ab und importiert diese in den Shop.
* **eBay Versandstatus setzen** - Informiert eBay das die Bestellung versendet wurde und sendet den Tracking Code.

Wenn das Bestellaufkommen zu groß ist, dann führen Sie den Cronjob lieber per Shell aus. Richten Sie die Cronjobs auf Ihrem Webserver ein und rufen Sie folgende Url auf:

* **eBay Bestellungen importieren** - /backend/ConnectorEbayApi/importOrder?key=123
* **eBay Versandstatus setzen** - /backend/ConnectorEbayApi/statusSend?key=123

Ersetzen Sie "123" durch den Eintrag, den Sie im Feld **"Gültiger Schlüssel"** in der [Externen Bestellverwaltung](https://coolbax.gitbook.io/coolbax-docs/shopware-5-plugins/marktplatze/externe-bestellverwaltung) vergeben haben.

## Fragen und Antworten <a href="#fragenantworten" id="fragenantworten"></a>

<details>

<summary>Es werden keine Bestellungen automatisch abgeholt?</summary>

Falls keine Bestellungen automatisch abgeholt werden, prüfen Sie bitte folgende Punkte:

* Ist das Plugin auf "Aktiv" gestellt?
* Ist das Cron-Plugin von Shopware aktiviert?
* Ist der Cronjob "eBay Bestellungen importieren" aktiv eingestellt?
* Ist der Cronjob auf Ihrem Server konfiguriert? Einrichten eines Cronjob auf dem Server.
* Sind die Einstellungen im Plugin korrekt?
* Haben Sie auch die richtigen Zugangsdaten im Plugin hinterlegt?

</details>

<details>

<summary>Es werden nicht alle Bestellungen importiert?</summary>

In den meisten Fällen ist die Kaufabwicklung vom Kunden noch nicht abgeschlossen, d.h. der Kunde hat dem Kauf zwar zugestimmt, aber noch keine Zahlungsart gewählt. In diesem Fall können solche Bestellungen noch nicht importieren werden, da von eBay keine Versandadresse übermittelt wird.

In Ihrem eBay Account können Sie schauen, ob die Kaufabwicklung abgeschlossen ist. Das Symbol "Taschenrechner" muss aktiv sein. Ist er grau, ist die Kaufabwicklung nicht abgeschlossen. Sie können auch auf die Nummer in der Spalte "Datensatznummer" drücken, um die Details der Bestellungen zu sehen. Unter "Verkaufsstatus und Anmerkungen" finden Sie dann den Hinweis zur Kaufabwicklung.

Um die Kaufabwicklung abzuschließen, können Sie die eBay Funktion "Rechnung senden" benutzen oder Sie schreiben den Kunden an und bitten ihn, die Kaufabwicklung von sich aus abzuschließen.

</details>

<details>

<summary>Es ist kein Cronjob vorhanden?</summary>

Bei der Installation werden die Cronjobs automatisch angelegt. Sollten diese dennoch nicht in den Grundeinstellungen > System > Cronjobs zu finden sein, gehen Sie bitte zum Abschnitt: Automatischer Import - Cronjob Einrichten. Für die Einrichtung auf Ihrem Server finden Sie [hier hilfreiche Hinweise](https://docs.shopware.com/de/shopware-5-de/einstellungen/system-cronjobs) oder Sie fragen direkt bei Ihrem Hoster nach.

</details>

<details>

<summary>Die Anrede bei importierte Bestellungen ist immer "Herr"?</summary>

Kunden haben in eBay keine Möglichkeit eine Anrede bei den Adressdaten zu hinterlegen. Für die Generierung einer Shopware Bestellung ist die Anrede allerdings Pflicht, daher wurde der Standartwert "Herr" festgelegt.

TIPP: Entfernen Sie einfach die Anrede aus z.B. den Dokumenten, sodass nur noch: Sehr geehrter Max Mustermann erscheint.

</details>

<details>

<summary>Der Versandstatus wird nicht abgeglichen?</summary>

Wenn der Versandstatus nicht zum Marktplatz hochgemeldet wird, überprüfen Sie bitte, ob der manuelle Abgleich funktioniert. Hierzu müssen Sie in die Übersicht der externen Bestellung gehen und auf das Icon "Blitz", bei einer versendeten Bestellung, klicken.

Abgleich funktioniert:

* Ist der Cronjob "eBay Versandstatus setzen" aktiv eingestellt? Bitte schauen Sie, wann die letzte Ausführung war
* Ist der Cronjob auf Ihrem Server konfiguriert? Einrichten eines [Cronjob](http://community.shopware.com/Cronjobs_detail_1102.html) auf dem Server.

Abgleich funktioniert nicht:

* Überprüfen Sie bitte, welche Einstellung im Plugin: Externen Bestellungen unter "Bestellstatus versendet" eingestellt ist. Es muss der gleiche Bestellstatus sein, den Sie nehmen, wenn eine Bestellung versendet wurde.

</details>

<details>

<summary>Mein User-Token ist abgelaufen. Wie bekomme ich einen neuen Token?</summary>

Der User Token läuft nach ca. 1,5 Jahren ab und muss erneuert werden. Loggen Sie sich hierfür in ihren eBay Developer Account ein. Gehen Sie anschließend auf: Hi (Ihr gewählter Name) > "Application access keys".

Es folgt eine Übersicht über Ihre Zugangsdaten (Production Übersicht verwenden!). Klicken Sie in der Übersicht rechts auf "User Tokens". Betätigen Sie anschließend den Button "Sign in to Production". In dem nun erscheinenden Anmeldefenster müssen Sie Ihre Anmeldedaten zu Ihrem eBay Shop eintragen. Danach müssen Sie nur noch den Button "I aggree" betätigen und anschließend wird ihnen der neue Token angezeigt.

Kopieren Sie diesen in Ihr Plug. Alle anderen Zugangs Daten bleiben gleich und müssen nicht erneuert werden.

</details>

<details>

<summary>Warum wird die Telefonnummer beim Bestellimport nicht oder nur manchmal übernommen?</summary>

Für die Übermittlung der Telefonnummer Ihres Kunden müssen folgende Voraussetzungen erfüllt sein:

eBay übergibt die Telefonnummern über die Schnittstelle nur unter folgenden Bedingungen:

* wenn Sie auf eBay einen "Verkaufsmamanger Pro" aktiviert haben - UND
* wenn der Käufer die Telefonnummer im Checkout (Bestellprozess) angegeben hat - UND
* nur wenn der Käufer sich bei eBay in den DACH-Ländern registriert hat.

Aus rechtlichen Gründen wird die Nummer jedoch nicht! übergeben, wenn z.B. die Telefonnummer, die ein in Deutschland registrierter Kunden nur bei seinen Registrierungsdaten hinterlegt hat.

Der Käufer muss seine Telefonnummer zusätzlich innerhalb der Bestellung als Pflichtangabe übermitteln. Um die Telefonnummer als Pflichtangabe für eine Bestellung zu definieren, müssen Sie unter Mein eBay > eBay-Konto > Einstellungen > Versandeinstellungen aufklappen und "Für den Versand ist eine Telefonnummer erforderlich" aktivieren

</details>

<details>

<summary>Was bedeutet folgende E-Mail von eBay: Your eBay marketplace account deletion/closure notification endpoint is down</summary>

eBay schickt alle 24 Stunden eine Anfrage an Ihren Server, ob dieser noch erreichbar ist. Es kann vorkommen, dass dieser in dem Moment temporär nicht erreichbar ist, dann probiert eBay es nach 24 Stunden erneut. Im Normalfall kriegen Sie die Nachricht, dass Ihr Server wieder erreicht werden konnte.

Sollte diese Meldung nochmal kommen, prüfen Sie bitte die Verbindung zu eBay und ob der Verifikationstoken mit Ihrem eBay Developer Account übereinstimmt.

</details>

<details>

<summary>Es werden nicht alle Bestellungen in der Shopware Bestellverwaltung angezeigt?</summary>

Es gibt immer mal wieder das Problem, dass eine Bestellung in der externen Bestellverwaltung hängen bleibt. Der Grund dafür liegt an den Adressdaten des Kunden. Bei Amazon und eBay gibt es keine vordefinierten Eingabefelder für die Kunden. Sie tragen ihre Adressdaten nach eigenen empfinden in die Spalten ein. Beim Import kann es daher passieren, dass der Nachname oder die Straßennummer in die Spalte Firma oder in ein Adresszusatzfeld importiert werden.

In der externen Bestellverwaltung finden Sie dies Bestellungen. Sie müssen nach Bestellungen schauen, welche keine Shopware Bestell-Nr. haben. Sie können auch den Filter "Generiert: nein" nutzen. Öffnen Sie die Bestellungen und korrigieren Sie die Adressdaten, danach können Sie die Bestellung manuell in eine Shopware Bestellung umwandeln oder Sie warten auf den Cronjob.

TIPP: Tragen Sie in den Einstellungen des Plugins: Externe Bestellungen unter "E-Mail Adresse" ihre E-Mail Adresse ein, um per Mail benachrichtigt zu werden, wenn eine Bestellung hängen geblieben ist.

</details>
