# OTTO Bestellimport

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

### Installation

{% hint style="info" %}
**Wichtig:** Bitte beachten Sie, dass für die Verwendung des Plugin "Marktplatz Otto Bestellimport | Pro" das Plugin "[Marktplatz Bestellverwaltung - z.B. für Amazon, eBay usw. | Pro](https://store.shopware.com/cbax895325672158/externe-bestellverwaltung-z.b.-fuer-amazon-ebay-usw.-sw6.html)"  einmalig installiert und aktiviert sein muss. \
\
Zudem müssen Sie eine Trackingnummern für den Versand und den Rückversand bereitstellen. Hierzu können Sie z. B. die Pickware Plugins: "[DHL Versand](https://store.shopware.com/viiso52049132916f/dhl-versand.html)" oder "[GLS Versand](https://store.shopware.com/pickw94187261995f/gls-versand.html)" nutzen.
{% endhint %}

Sie können das Plugin [hier über den Shopware Community Store erwerben](https://www.coolbax.de/handbuecher/marktplaetze/plugin-marktplatz-otto-bestellimport-pro). 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="<https://docs.shopware.com/de/shopware-6-de/Erweiterungen/MeineErweiterungen#meine-plugins>" %}
Shopware Handbuch zur Installation von Apps & Plugins
{% endembed %}

Nach der Installation des Plugins schalten Sie das Plugin aktiv.&#x20;

### 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  <a href="#plugin_einstellungen" id="plugin_einstellungen"></a>

Um in die Konfigurationsmaske zu gelangen, gehen Sie ins Hauptmenü auf: *Einstellungen > Erweiterungen > Marktplatz Konfigurationen > OTTO Bestellimport*.

### Zugangsdaten

Ihre Zugangsdaten erhalten Sie mit der Registrierung bei OTTO. Mit den ersten E-Mails werden Ihnen die Zugangsdaten automatisch mitgeteilt. Haben Sie diese E-Mail nicht mehr, wenden Sie sich bitte an das Support Team von OTTO.

E-Mail: <service@otto.de>\
Telefon: 040 - 3603 3603

Sie können sich an unseren Einstellungen auf dem Screenshots richten. Natürlich können Sie auch andere verwenden.

| Einstellungen | Bedeutung                     |
| ------------- | ----------------------------- |
| API User      | API User zur API von OTTO     |
| API Passwort  | API Passwort zur API von OTTO |

### Import <a href="#allgemein" id="allgemein"></a>

| Einstellungen                                  | 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

| Einstellungen                                          | 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

| Einstellungen                      | 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? Ist Ihr Versand Dienstleister nicht dabei, wählen Sie "Other" und füllen das eingeblendete Feld "Eigener Versand Dienstleister" aus. |
| Standard Rückversand Dienstleister | Über welchen Versand Dienstleister sollen die Waren standartmäßig zurückgesendet werden?                                                                                                                          |

### Absenderdaten des Händlers

| Einstellungen | Bedeutung                                              |
| ------------- | ------------------------------------------------------ |
| Postleitzahl  | Tragen Sie hier die Postleitzahl ihres Firmensitz ein. |
| Ort           | Tragen Sie hier den Ort ihres Firmensitz ein.          |
| Land          | Tragen Sie hier das Land ihres Firmensitz ein.         |

{% 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 %}

| Einstellungen        | 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?                                                     |

### Zuordnung Zahlungsarten

| Zuordnung Zahlungsarten | Bedeutung             |
| ----------------------- | --------------------- |
| 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 auf OTTO als SKU Nummer hinterlegt werden. 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>

Sie haben zwei Möglichkeiten die Bestellungen von OTTO in Ihr Shopware Backend zu holen.

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

Für das manuelle Abholen einer OTTO Bestellung benötigen Sie die Bestellnummer von der OTTO Bestellung. Diese finden Sie in ihren OTTO Account.

Kopieren Sie sich die Bestellnummer und gehen Sie anschließend ins Backend von Shopware auf Bestellungen > Marktplatz. Klicken Sie auf den Button "Neue Bestellung importieren". Wählen Sie den Marktplatz "OTTO" aus und fügen die 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%2Fa5LM4Z0z3kOlTi2sJr4y%2FPluginSW6_OttoBestellimport-001.jpg?alt=media&#x26;token=3b2a54a9-ec61-4cd1-8ed4-eb7f403c61b6" alt=""><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.

* **OTTO Bestellungen importieren** - Holt die Bestellungen von OTTO ab und importiert diese in den Shop.
* **OTTO Versandstatus setzen** - Informiert OTTO 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:

* **OTTO Bestellungen importieren** - /api/cbax/OTTO/importOrder?key=123
* **OTTO Versandstatus setzen** - /api/cbax/OTTO/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)
