> For the complete documentation index, see [llms.txt](https://coolbax.gitbook.io/coolbax-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/otto-bestellimport.md). # OTTO Bestellimport ## Installation und Deinstallation ### 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="" %} 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 > OTTO Bestellimport*. ### Zugangsdaten Für die Zugangsdaten müssen Sie sich bei uns registrieren und die Autorisierung durchlaufen. Am Ende der Autorisierung erhalten Sie das Passwort für Ihre Plugin Einstellungen. * [Zur Registrierung und Autorisierung](https://www.coolbax.de/kunden/login) * [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/otto-bestellimport/zugangsdaten-otto.md) | Einstellungen | Bedeutung | | --------------- | ------------------------------------------------------------------------------------------------ | | Otto Partner Id | Otto Partner Id zur API von OTTO | | API Passwort | Dieses Passwort erhalten Sie nach der erfolgreichen Registrierung und Autorisierung bei Coolbax. | ### Import {% hint style="danger" %} Da Vorkasse-Bestellungen erst nach erfolgreichem Zahlungseingang seitens OTTO freigegeben und in Shopware übertragen werden, können durch diese verzögerten Importe Probleme mit Überverkäufen entstehen. Wir bitten Sie, dies in Ihrer Lagerhaltung entsprechend zu berücksichtigen. {% endhint %} | 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). | | Quelle der externen Bestellnummer auswählen | Soll die OTTO Auftrags-ID oder die OTTO Auftragsnummer als externen Bestellnummer verwendet werden. | | 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 {% hint style="warning" %} Derzeit kann systembedingt nur ein Retourenlager berücksichtigt werden. Bei der Nutzung mehrerer Retourenlager kann es zu Fehlern kommen. Bitte hinterlegen Sie in OTTO daher nur ein einziges Retourenlager. {% endhint %} | 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 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 Sie haben zwei Möglichkeiten die Bestellungen von OTTO in Ihr Shopware Backend zu holen. ### Manueller Import 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".
### 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. * **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](/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) ## Fragen und Antworten
Wo kann ich Fehlermeldungen einsehen bzw. wo finde ich das Logbuch? Alle Fehlermeldungen werden im Logbuch gesammelt und gespeichert. Hier erhalten Sie detaillierte Informationen zu Fehlermeldungen, Warnungen oder Erfolgsmeldungen für die gesamten Marktplätze und die Marktplatz Bestellverwaltung. Wie Sie zum Logbuch kommen finden Sie in unserem Handbuch: [Bestellverwaltung + GPSR > Marktplatz Konfigurationen](https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs#marktplatz-konfigurationen)
Wo kann ich den Bestell- und Lieferstatus einstellen? Einstellungen zu den Bestell-bzw. Lieferstatus stellen Sie in der Konfiguration des Grundplugin: [Bestellverwaltung + GPSR](https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs#status-einstellungen) ein.
Wo finde ich die Cronjob Einstellungen zu dem Plugin Die Cronjob Einstellungen befinden sich im Grundplugin: Bestellverwaltung + GPSR. Wie Sie zu den Cronjobs kommen und alles weitere wissenswerte finden Sie unter: [Bestellverwaltung + GPSR > Cronjobverwaltung](https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs#cronjobverwaltung)