# Hood Bestellimport

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

### Installation

Sie können das Plugin [hier über den Shopware Community Store erwerben](https://store.shopware.com/cbax122139459487/marktplatz-hood-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="<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 > Hood Bestellimport*.

### Zugangsdaten

{% hint style="warning" %}
Damit Sie die API nutzen können müssen Sie einen Platin Shop bei Hood besitzen.
{% endhint %}

Ihre Zugangsdaten erhalten Sie durch Klick auf folgenden Link. Dort müssen Sie sich für Hood Direktkauf registrieren. Das Formular finden Sie am Ende der Seite.

{% embed url="<https://www.hood.de/externe-anbindungen.htm>" %}
Zu den Zugangsdaten von Hood
{% endembed %}

| Einstellung   | Bedeutung                      |
| ------------- | ------------------------------ |
| Mitgliedsname | Mitgliedsname zum Hood Account |
| Passwort      | Passwort zur API von Hood      |

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

| Einstellung                                    | Bedeutung                                                            |
| ---------------------------------------------- | -------------------------------------------------------------------- |
| Nur Bestellungen mit diesem Status importieren | Bestellung in Bearbeitung (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?                                                     |

### Zuordnung Zahlungsarten

| Einstellung | 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 Hood 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 Hood in Ihr Shopware Backend zu holen.

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

Für das manuelle Abholen einer Hood Bestellung benötigen Sie die Bestellnummer von der Hood Bestellung. Um diese zu erhalten gehen Sie in Ihren Hood Account auf: *Mein Shop > Bestellungen*. Dort finden Sie die benötigte Bestellnummer. Kopieren Sie sich die Bestellnummern, welche Sie importieren möchten.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FzEkIaq2h5NdSKNfkcIEx%2FPluginSW6_HoodBestellimport-001.jpg?alt=media&#x26;token=bff4084e-8a59-49ff-ba1d-cbdaddf7046e" alt=""><figcaption></figcaption></figure>

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 "Hood" 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%2FpjbfqjpcRfJn32lNPxFP%2FPluginSW6_HoodBestellimport-002.jpg?alt=media&#x26;token=5dc305ac-e01d-4c79-9153-359f6c054acc" alt=""><figcaption></figcaption></figure>

### 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.

* **Hood Bestellungen importieren** - Holt die Bestellungen von Hood ab und importiert diese in den Shop.
* **Hood Versandstatus setzen** - Informiert Hood 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)" %}

* **Hood Bestellungen importieren** - /api/cbax/hood/importOrder?key=123
* **Hood Versandstatus setzen** - /api/cbax/hood/dispatchStatusSend?key=123
  {% endtab %}

{% tab title="Vor Shopware 6.4.x (alte Version)" %}

* **Hood Bestellungen importieren** - /api/v{version}/cbax/hood/importOrder?key=123
* **Hood Versandstatus setzen** - /api/v{version}/cbax/hood/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](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/hood-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.