# Etsy Bestellimport

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

Sie bekommen das Plugin [von uns per Mail ](https://www.coolbax.de/shopware-plugins/marktplaetze/57/etsy-bestellimport)gesendet. Speichern Sie sich den angehangenen Zip Ordner auf Ihrem Rechner ab und gehen in das Backend. Rufen Sie den Plugin Manager auf und wählen "Installiert". Drücken auf den Button "Plugin hochladen" und wählen den gerade gespeicherten Zip Ordner aus. Klicken Sie anschließend auf "Plugin hochladen". Danach finden Sie das Plugin im Plugin Manager unter "Deinstalliert" und können es anschließend, wie gewohnt, installieren und aktivieren.

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 können Sie in der Konfigurationsmaske die Einstellungen vornehmen und weitere Parameter ergänzen.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F5AU9CZ7Ef6OeVOwio8iJ%2FSW5-EtsyBestellimport-01.jpg?alt=media&#x26;token=14cd18fe-590e-4a0a-b110-3c0477c66518" alt="" width="375"><figcaption></figcaption></figure>

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

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

Für diesen Account müssen Sie keine extra Zugangsdaten anlegen, jedoch müssen Sie unsere App den Zugriff auf Ihr Konto gestatten.

{% embed url="<https://coolbax.gitbook.io/coolbax-docs/shopware-5-plugins/marktplatze/etsy-bestellimport/zugangsdaten-etsy>" %}
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%2FkwsWOHcPbxUKo5xiwhj6%2FSW5-EtsyBestellimport-02.jpg?alt=media&#x26;token=e61ad1a9-ce89-4311-ad36-8b999a1a43f5" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FjeptVsSLJASnmm5sTboH%2FSW5-EtsyBestellimport-03.jpg?alt=media&#x26;token=72b0baf0-0e66-4e3a-b9dd-1cc205f7e9df" alt=""><figcaption></figcaption></figure></div>

| Zugangsdaten  |                                                                |
| ------------- | -------------------------------------------------------------- |
| Mitgliedsname | Tragen Sie hier Ihren Etsy\* Shop Namen ein (ohne Leerzeichen) |

| Import                                     |                                                                     |
| ------------------------------------------ | ------------------------------------------------------------------- |
| Nur Bestellungen mit diesem Status abholen | Alle Bestellungen importieren (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    |

| Zuordnung Allgemein |                                                                                                                                                                                                                               |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Subshop             | Welchen 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.: Etsy\*, 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 %}

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

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

Um den Lagerbestand im Shop abzugleichen, müssen die Artikelnummern aus dem Shop auch in Etsy\* hinterlegt werden. Bitte achten Sie daher bei der Anlage von Artikeln darauf, dass im Feld "Bestandseinheit" die Artikelnummer aus ihrem Shop eintragen ist. Wenn die Artikelnummern nicht identisch sind, dann werden die Bestellungen zwar importiert, aber kein Lagerbestand abgeglichen.

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

{% hint style="warning" %}
**Hinweis:** Sie haben pro Tag 10.000 Calls frei. Sind diese aufgebracht, können Sie keine Bestellungen mehr abholen und müssen leider bis zum nächsten Tag warten.
{% endhint %}

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

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

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.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FCv415oquBdeSNgBUmaxz%2FSW5-EtsyBestellimport-04.jpg?alt=media&#x26;token=569c9be3-9a70-478d-8a0a-b11b3bc22e22" alt="" width="375"><figcaption></figcaption></figure>

Gehen Sie nun ins Backend von Shopware und öffnen das Plugin "Externe Bestellungen". Klicken Sie auf der linken Seite 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".

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FJEMHbShgcalNrv6iWAsJ%2FSW5-EtsyBestellimport-05.jpg?alt=media&#x26;token=92738f04-59bb-4c9d-a5de-b3001b455061" alt="" width="375"><figcaption></figcaption></figure>

### Automatischer Import - Cronjob Einrichten <a href="#automatischer_import" id="automatischer_import"></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.

* **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 Ihren Webserver ein und rufen Sie folgende Url auf:

* **Etsy Bestellungen importieren** - /backend/ConnectorEtsyApi/importOrder?key=123
* **Etsy Versandstatus setzen** - /backend/ConnectorEtsyApi/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.

## Fehler im Logfile finden <a href="#logfile" id="logfile"></a>

Alle Erfolgs- und Fehlermeldungen finden Sie wie gewohnt unter "Einstellungen > Logfile". Eine erweiterte und meist aussagekräftige Ausgabe finden Sie in unserem erweiterten Log unter "Einstellungen > Logfile > Externe Bestellungen Log". Hier haben Sie die Möglichkeit nach bestimmten Marktplätzen zu filtern.

## 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 "Etsy\* 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 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>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 "Etsy\* 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>


---

# 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/shopware-5-plugins/marktplatze/etsy-bestellimport.md?ask=<question>
```

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.