# Kaufland Bestellimport

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

Sie können das Plugin über den Shopware Community Store erwerben. Das Plugin wird wie ein ganz gewöhnliches Plugin installiert.&#x20;

{% embed url="<http://store.shopware.com/cbax909672904410/hitmeister-bestellimport-erweiterung.html>" %}
Plugin über den Shopware Community Store erwerben
{% endembed %}

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%2FVbhrOoEyfDQbPesCyX5F%2FSW5-Kaufland%20-01.jpg?alt=media&#x26;token=c0f81779-4aa7-4985-a0d9-758da66349e9" 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>

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.

{% embed url="<https://sellerportal.kaufland.de/settings/api>" %}
Zu den Zugangsdaten von Kaufland
{% 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%2F5A1RKF3QHNlYSg9CYKaV%2FSW5-Kaufland%20-03.jpg?alt=media&#x26;token=d4f56465-9a88-4cc2-a23d-58d22deec1d2" alt=""><figcaption></figcaption></figure> <figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FmADLWKb12I9k7pVPtJun%2FSW5-Kaufland%20-02.jpg?alt=media&#x26;token=be207066-e82d-45aa-a0df-3c7902eb91ed" alt=""><figcaption></figcaption></figure></div>

| Zugangsdaten |                                 |
| ------------ | ------------------------------- |
| Client Key   | Client Key zur API von Kaufland |
| Secret Key   | Secret Key zur API von Kaufland |

| Import                                     |                                                                                                                                      |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| Nur Bestellungen mit diesem Status abholen | Welcher Kaufland  Bestellstatus soll gesetzt sein, damit die Bestellung in Shopware importiert werden kann (Mehrfachauswahl möglich) |
| 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.: Kaufland, 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 Zahlungsarten |                      |
| ----------------------- | -------------------- |
| Kaufland                | Zuordung 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 Kaufland 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 habe zwei Möglichkeiten die Bestellungen von Kaufland in Ihr Shopware Backend zu holen.

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

Für das manuelle Abholen einer Kaufland Bestellung benötigen Sie die Bestellnummer von der Kaufland Bestellung. Um diese zu erhalten gehen Sie in Ihren Kaufland Account auf "Händlerbereich > Meine Verkäufe ". 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%2FWtEaBppIPDvn4d8W7D4Z%2FSW5-Kaufland%20-04.jpg?alt=media&#x26;token=a45bbe50-879d-450b-8bbb-385bdf6a3afa" alt="" width="375"><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 "Kaufland" 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%2F68ASUzLyDnsUUr54bqz7%2FSW5-Kaufland%20-05.jpg?alt=media&#x26;token=a609012d-07a0-4560-8dbe-ea17e7408d61" alt="" width="375"><figcaption></figcaption></figure>

### Automatischer Import - Cronjob Einrichten <a href="#automatischer_import" id="automatischer_import"></a>

Bei der Installation werden 2 neue Cronjobs angelegt. Sie sind für die Abarbeitung der Aufträge verantwortlich.

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

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

## 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 "Kaufland 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 "Kaufland Versandstatus setzen" aktiv eingestellt? Bitte schauen Sie, wann die letzte Ausführung war
* Ist der Cronjob auf Ihrem Server konfiguriert? Einrichten eines Cronjob 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>
