# Etsy Bestellimport ## Installation und Deinstallation ### Installation Sie können das Plugin [hier über den Shopware Community Store erwerben](https://store.shopware.com/cbax185582835649m/marktplatz-etsy-bestellimport-pro.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 und der Bestellimport bauen aufeinander auf und müssen in umgedrehter Reihenfolge deaktiviert bzw. deinstalliert werden. Nach folgender Reihenfolge deaktivieren bzw. deinstallieren Sie die Plugins: 1. Bestellimport deinstallieren 2. 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 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 > Etsy Bestellimport*. ### Zugangsdaten {% hint style="warning" %} Füllen Sie, vor der Erstellung der Zugangsdaten, alle weiteren Einstellungen des Plugins aus und speichern Sie diese ab. {% endhint %} Die Zugangsdaten können Sie erst mit Auswahl eines Verkaufskanals beantragen. Diesen wählen Sie in den Plugin Einstellungen aus. Folgend Sie anschließend der Anleitung zur Erstellung der Zugangsdaten: * [Schritt-für-Schritt Anleitung](https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/etsy-bestellimport/zugangsdaten-etsy) | Einstellung | Bedeutung | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | Domain für Etsy | Diese wird automatisch generiert, wenn Sie unter [Zuordnung Allgemein](#zuordnung-allgemein) einen Verkaufskanal gewählt haben. | | Verbindungsdaten löschen | Entfernt alle Einstellungen zur API von Etsy. | | Verbindung zur API überprüfen | Überprüfung, ob die Verbindung zu Etsy noch besteht. | ### 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 Versandarten 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 Um den Lagerbestand im Shop abzugleichen, müssen die Artikelnummern aus dem Shop auch auf Etsy hinterlegt werden. Wenn die Artikelnummern nicht identisch sind, dann werden die Bestellungen zwar importiert, aber kein Lagerbestand abgeglichen. ## Bestellungen importieren Sie haben zwei Möglichkeiten die Bestellungen von Etsy in Ihr Shopware Backend zu holen. ### Manueller Import Für das manuelle Abholen einer Etsy Bestellung benötigen Sie die Bestellnummer von der Etsy Bestellung. Um diese zu erhalten gehen Sie in Ihren Etsy Account auf "Mein Shop > Bestellungen". Dort finden Sie die benötigte Bestellnummer. Kopieren Sie sich die Bestellnummern, welche Sie importieren möchten.
Gehen Sie nun ins Backend von Shopware: Bestellungen > Marktplätze. Klicken Sie auf den Button "Neue Bestellung importieren". Wählen Sie den Marktplatz "Etsy" 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. * **Etsy Bestellungen importieren** - Holt die Bestellungen von Etsy ab und importiert diese in den Shop. * **Etsy Versandstatus setzen** - Informiert Etsy 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: * **Etsy Bestellungen importieren** - /api/cbax/etsy/importOrder?key=123 * **Etsy Versandstatus setzen** - /api/cbax/etsy/dispatchStatusSend?key=123 {% hint style="info" %} Ersetzen Sie "123" durch den Eintrag, den Sie im Feld **"Gültiger Schlüssel"** in der [Marktplatz Bestellverwaltung](https://coolbax.gitbook.io/coolbax-docs/handbuecher/bestellverwaltung-+-gprs#cronjob_einrichten) vergeben haben. {% endhint %} ## Versandinformationen hinterlegen Wie Sie eine Trackingnummern und den Versanddienstleister hinterlegen finden Sie im Handbuch der [Bestellverwaltung + GPSR](https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs) unter: [*Bestelldetails Shopware Bestellverwaltung*](https://coolbax.gitbook.io/coolbax-docs/handbuecher/bestellverwaltung-+-gprs#bestell_marktplatzdetail-2) --- # 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/etsy-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.