# Kaufland Bestellimport ## Installation und Deinstallation ### Installation Sie können das Plugin [hier über den Shopware Community Store erwerben](https://store.shopware.com/cbax373262985415/marktplatz-real-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="" %} 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 > Kaufland Bestellimport*. ### Zugangsdaten 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="" %} Zu den Zugangsdaten von Kaufland {% endembed %} Sie können sich an unseren Einstellungen auf dem Screenshots richten. Natürlich können Sie auch andere verwenden. | Einstellungen | Bedeutung | | -------------------------- | ---------------------------------------------------------------------------------------- | | Client Key | Client Key zur API von Kaufland | | Secret Key | Secret Key zur API von Kaufland | | "Verbindung prüfen" Button | Mit diesem Button können Sie jederzeit Überprüfen, ob die Verbindung zu Kaufland besteht | ### Import | Einstellungen | Bedeutung | | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | Nur Bestellungen mit diesem Status importieren | Welcher Kaufland Bestellstatus soll gesetzt sein, damit die Bestellung in Shopware importiert werden kann (Mehrfachauswahl möglich) | | 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? | {% 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 | Einstellungen | Bedeutung | | ------------- | --------------------- | | Zahlungsart | Zuordnung Zahlungsart | ### Rechnungs-Upload | Einstellungen | Bedeutung | | --------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | Rechnungs-Upload aktivieren | Wenn Sie Dokumente zu Kaufland exportieren möchten, schalten diese Funktion auf aktiv. | | Rechnungsdokument für Upload | Wählen Sie das Dokument aus, welches zu Kaufland exportiert werden soll. | | Rechnungs-Upload für Bestellungen mit diesem Status | Wann soll das Dokument exportiert werden? Wählen Sie hier einen entsprechenden Bestellstatus aus | ## Lagerbestand im Shop abgleichen 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 Sie haben zwei Möglichkeiten die Bestellungen von Kaufland in Ihr Shopware Backend zu holen. ### Manueller Import 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 "Bestellungen > Bestellverwaltung". Dort finden Sie die benötigte Bestellnummer.
Gehen Sie nun ins Backend von Shopware auf Bestellungen > Marktplatz. Klicken Sie auf 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".
### 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. * **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. (folgt demnächst) 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: {% tabs %} {% tab title="Ab Shopware 6.4.x (aktuelle Version)" %} * **Kaufland Bestellungen importieren** - /api/cbax/real/importOrder?key=123 * **Kaufland Versandstatus setzen** - /api/cbax/real/dispatchStatusSend?key=123 {% endtab %} {% tab title="Vor Shopware 6.4.x (alte Version)" %} * **Kaufland Bestellungen importieren** - /api/v{version}/cbax/real/importOrder?key=123 * **Kaufland Versandstatus setzen** - /api/v{version}/cbax/real/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](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md#cronjob_einrichten) vergeben haben. {% endhint %} ## Versandinformationen hinterlegen Wie Sie eine Trackingnummern und den Versanddienstleister hinterlegen finden Sie im Handbuch der [Bestellverwaltung + GPSR](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md) unter: [*Bestelldetails Shopware Bestellverwaltung*](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md#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/kaufland-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.