# eBay Bestellimport ## Installation und Deinstallation ### Installation {% hint style="info" %} Wichtig: Bitte beachten Sie, dass für die Verwendung dieses Plugin folgendes Plugins einmalig installiert und aktiviert sein muss: "[Marktplatz Bestellverwaltung - z.B. für Amazon, eBay usw. | Pro](https://store.shopware.com/cbax895325672158/marktplatz-bestellverwaltung-z.b.-fuer-amazon-ebay-usw.-pro.html)". {% endhint %} Sie können das Plugin [hier über den Shopware Community Store erwerben](https://store.shopware.com/cbax853519574315/marktplatz-ebay-bestellimport-sw6.html). Das Plugin wird wie ein ganz gewöhnliches Plugin installiert. Sollten Sie zum ersten Mal ein Plugin installieren, finden Sie unter dem folgenden Link eine Anleitung zur Installation von Plugins: {% embed url="" %} Shopware Handbuch zur Installation von Apps & Plugins {% endembed %} Nach der Installation des Plugins schalten Sie das Plugin aktiv. ### Deaktivierung / Deinstallation Die Marktplatz Bestellverwaltung, der Bestellimport und der Produktexport bauen aufeinander auf und müssen in umgedrehter Reihenfolge deaktiviert bzw. deinstalliert werden. Nach folgender Reihenfolge deaktivieren bzw. deinstallieren Sie die Plugins: 1. Produktexport deinstallieren (wenn vorhanden) 2. Bestellimport deinstallieren 3. Bestellverwaltung deinstallieren {% hint style="info" %} Wenn Sie die Plugins nur vorübergehend deinstallieren möchten, empfehlen wir, die gespeicherten App-Daten beizubehalten. Dadurch bleiben alle Einstellungen bei einer späteren Neuinstallation erhalten. {% endhint %} {% hint style="info" %} Bei einem Shopware Update muss der Produktexport (wenn vorhanden) und der Bestellimport deinstalliert werden, um die Bestellverwaltung deaktivieren zu können {% endhint %} ## Plugin Einstellungen Um in die Konfigurationsmaske zu gelangen, gehen Sie ins Hauptmenü auf: *Einstellungen > Erweiterungen > Marktplatz Konfigurationen > eBay Bestellimport*. ### Zugangsdaten 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. {% tabs %} {% tab title="Zugangsdaten erstellen" %} 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. * [Zu den Zugangsdaten](https://developer.ebay.com/signin?return_to=%2Fmy%2Fkeys) * [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md) {% endtab %} {% tab title="Zugangsdaten erneuern" %} coming soon {% endtab %} {% endtabs %} #### Alerts & Notifications | Einstellung | Bedeutung | | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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 [Schritt-für-Schritt Anleitung.](/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md#alertnotifikations) | | Marketplace account deletion notification endpoint | Wird beim Einrichten der Alerts & Notifactions benötigt! Weitere Informationen finden Sie in der [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md#alertnotifikations) | #### Auth´n´Auth Token einrichten | Einstellung | Bedeutung | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | DEV-ID | DEV-ID zur API von eBay. Weitere Informationen finden Sie in der [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md#appdevcertid) | | APP-ID | APP-ID zur API von eBay. Weitere Informationen finden Sie in der [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md#appdevcertid) | | CERT-ID | CERT-ID zur API von eBay. Weitere Informationen finden Sie in der [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md#appdevcertid) | | User-Token | User-Token zur API von eBay. Weitere Informationen finden Sie in der [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md#auth) | | Marktplatz | Der eBay Marktplatz auf dem die Artikel gelistet werden. | | Von eBay erwartete Währung | Wird bei Änderung des eBay Marktplatzes automatisch bestimmt. | #### oAuth2 Token einrichten | Einstellung | Bedeutung | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | RuName | Wird für die Erstellung des oAuth2 Token einrichten benötigt Informationen finden Sie in der [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md#oauth2) | | Your auth accepted URL | Wird beim Einrichten des RuNamen benötigt! | | Mitgliedsname | Der Mitgliedsname von eBay. | *** ### Import | Einstellung | Bedeutung | | ---------------------------------------------- | -------------------------------------------------------------------- | | Nur Bestellungen mit diesem Status importieren | Bestellung ist zur Bearbeitung freigegeben (empfohlen) | | Datum des letzten automatischen Import | An welchem Tag wurde der letzte automatische Import durchgeführt | | Uhrzeit des letzten automatischen Import | Zu welcher Uhrzeit wurde der letzte automatische Import durchgeführt | | Bestellstatus nach Import | Welchen Bestellstatus sollen die Bestellungen nach dem Import haben | | Lieferstatus nach Import | Welcher Lieferstatus sollen die Bestellungen nach dem Import haben | | Zahlstatus nach Import | Welchen Zahlstatus sollen die Bestellungen nach dem Import haben | ### Zuordnung Allgemein | Einstellung | Bedeutung | | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Verkaufskanal | Welchen Shop sollen die Bestellungen zugeordnet werden. Die Auswahl der Kanäle ist auf Storefronts beschränkt ist, da für die Generierung einer Bestellung ein gültiger Verkaufskanal mit Domain benötigt wird. | | Steuersatz | Welchen Steuersatz sollen die Produkte bekommen, welche nicht im Shop angelegt sind | | Kundengruppe | Wählen Sie eine Kundengruppe (unabhängig vom Verkaufskanal). | | Bestellnummer für Shopware Bestellverwaltung auswählen | Soll die Marktplatz- oder eine Shopware Bestellnummer zum Generieren der Bestellung verwendet werden. | ### Zuordnung Versandarten | Einstellung | Bedeutung | | ------------------------------- | ---------------------------------------------------------------------------- | | Standard Versandart | Welcher Versandart sollen die Bestellungen standartmäßig zugewiesen werden. | | Standard Versand Dienstleister: | Über welchen Versand Dienstleister werden die Waren standartmäßig versendet? | {% hint style="info" %} Einzelne Abweichungen bei den Versand Dienstleister können nochmals in der Bestellung eingestellt werden. {% endhint %} ### Länderabhängige Versanddienstleister {% hint style="info" %} Mit den nachfolgenden Einstellungen können Sie von den Standardeinstellungen abweichen, wenn Sie länderabhängig unterschiedliche Versandarten oder Versand Dienstleister nutzen. {% endhint %} | Einstellung | Bedeutung | | -------------------- | ------------------------------------------------------------------------------------------ | | Land | Wählen Sie das Land aus, für welches Sie eine andere Versandeinstellung hinterlegen wollen | | Versanddienstleister | Wer soll der Versanddienstleister für das gewählte Land sein? | | Versandart | Welche Versandart soll genutzt werden (z.B. Standard oder Express) ? | ### Zuordnung Zahlungsarten | Einstellung | Bedeutung | | ----------- | --------------------- | | Zahlungsart | Zuordnung Zahlungsart | {% hint style="warning" %} Weisen Sie bitte alle angegebenen Zahlungsarten eine Zahlungsart aus ihrem Shop zu, auch wenn Sie diese Zahlungsart nicht anbieten. Eine Abspeicherung der Einstellungen ist sonst nicht möglich. {% endhint %} ## Lagerbestand im Shop abgleichen Der Lagerbestand eines Artikel kann reduziert werden, wenn eine eBay Bestellung eingeht und in eine Shopware Bestellung generiert wurde. Hierfür ist Voraussetzung, dass die Produktnummern aus dem Shop ebenfalls im eBay Account im Feld: Bestandseinheit hinterlegt ist.
Sollten die Produktnummern und Bestandseinheit nicht identisch sein, werden die Bestellungen zwar importiert, aber es findet kein Lagerbestand statt. ## Bestellungen importieren Sie haben zwei Möglichkeiten die Bestellungen von eBay in Ihr Shopware Backend zu holen. ### Manueller Import 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.
Gehen Sie nun ins Backend von Shopware: *Bestellungen > Marktplatz*. Klicken Sie auf 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". Sie haben nun die Bestellung erfolgreich in Shopware importiert. Möchten Sie diese anschließend noch in eine Shopware Bestellung umwandeln, gehen Sie zum Ende der Spalte Ihrer Bestellung, öffnen das Menü und klicken auf "Shopware Bestellung erzeugen" ### Automatischer Import - Cronjob einrichten 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: {% tabs %} {% tab title="Ab Shopware 6.4.x (aktuelle Version)" %} * **eBay Bestellungen importieren** - /api/cbax/ebay/importOrder?key=123 * **eBay Versandstatus setzen** - /api/cbax/ebay/dispatchStatusSend?key=123 {% endtab %} {% tab title="Vor Shopware 6.4.x (alte Version)" %} * **eBay Bestellungen importieren** - /api/v{version}/cbax/ebay/importOrder?key=123 * **eBay Versandstatus setzen** - /api/v{version}/cbax/ebay/dispatchStatusSend?key=123 {% endtab %} {% endtabs %} {% hint style="info" %} Ersetzen Sie "123" durch den Eintrag, den Sie im Feld **"Gültiger Schlüssel"** in der [Marktplatz Bestellverwaltung](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md#cronjob_einrichten) vergeben haben. {% endhint %} ## Versandinformationen hinterlegen Wie Sie eine Trackingnummern und den Versanddienstleister hinterlegen finden Sie im Handbuch der [Bestellverwaltung + GPSR](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md) unter: [*Bestelldetails Shopware Bestellverwaltung*](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md#bestell_marktplatzdetail-2) ## Fragen und Antworten
Was bedeutet folgende E-Mail von eBay: Your eBay marketplace account deletion/closure notification endpoint is down 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. Oftmals erhalten Kunden dieses Meldung, nach der Umstellung von Shopware 5 zu Shopware 6. Kunden müssen die Verbindung wieder herstellen – siehe hierzu: [*Zugangsdaten eBay > Alerts & Notifikations*](/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport/zugangsdaten-ebay.md#alertnotifikations)
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/ebay-bestellimport.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.