# Externe Bestellverwaltung

{% hint style="warning" %}
**INWEIS:** Angaben zur GPSR - Verordnung werden über ein extra Modul gepflegt. [Alle Informationen zum Thema finden Sie hier.](https://coolbax.gitbook.io/coolbax-docs/shopware-5-plugins/marktplatze/externe-bestellverwaltung/produktsicherheitsrichtlinien)
{% endhint %}

## 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="<https://store.shopware.com/de/cbax642317535409/externe-bestellverwaltung-gpsr.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%2F0CGqFAmRIXrNHb533nOC%2FSW5-Externe_Bestellung-01.jpg?alt=media&#x26;token=e113131e-4036-44ed-92e3-15e1a8965c39" alt="" width="375"><figcaption></figcaption></figure>

| Allgemein                          |                                                                                                                                                                                                                      |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Import Limit Shopware Bestellungen | Limit für das Erstellen der Shopware Bestellungen                                                                                                                                                                    |
| Bestellstatus versendet            | Einstellen des Bestellstatus ab wann, die Bestellung als versendet gilt. Es können auch mehrere ausgewählt werden (z.B. Teilweise ausgeliefert, Komplett ausgeliefert, Storniert/Abgelehnt, offen, abgebrochen usw.) |
| Externe Bestellnummer speichern    | Externe Bestellnummer für z.B. die Dokumentenverwaltung zusätzlich speichern                                                                                                                                         |
| E-Mail Adresse                     | Die E-Mail Adresse an die auftretende Fehler versendet werden. Wenn leer, dann werden keine E-Mails versendet                                                                                                        |

| Einstellungen Shopware Bestellübersicht |                                                                                                                  |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Spalte Transaktion ausblenden           | Wählen Sie, ob Sie die Transaktionsnummer in der Bestellübersicht von Shopware angezeigt haben möchten           |
| Spalte Zahlungsart ausblenden           | Wählen Sie, ob Sie die Zahlungsart in der Bestellübersicht von Shopware angezeigt haben möchten                  |
| Spalte Versand ausblenden               | Wählen Sie, ob Sie den Versand in der Bestellübersicht von Shopware angezeigt haben möchten                      |
| Spalte Shop ausblenden                  | Wählen Sie, ob Sie der Shop in der Bestellübersicht von Shopware angezeigt haben möchten                         |
| Spalte Markplatz ausblenden             | Wählen Sie, ob Sie den Marktplatz in der Bestellübersicht von Shopware angezeigt haben möchten                   |
| Spalte E-Mail ausblenden                | Wählen Sie, ob Sie die E-Mail Adressen Ihrer Kunden in der Bestellübersicht von Shopware angezeigt haben möchten |

| Optionale Einstellungen |                                                                                                        |
| ----------------------- | ------------------------------------------------------------------------------------------------------ |
| Gültiger Schlüssel      | Optional - Sie müssen dieses Feld nicht ausfüllen. Weitere Hinweise finden [hier](#cronjob_einrichten) |
| Proxy-Server            | Optional - Sie müssen dieses Feld nicht ausfüllen. Weitere Hinweise finden [hier](#proxy)              |

| Produktsicherheitsverordnung (GPSR) |                                                                                                                                                                          |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Aktiv                               | Wenn aktiv, werden die Informationen zur Produktsicherheitsverordnung auf der Produktdetailseite ausgegeben                                                              |
| Position                            | Wo sollen die Informationen auf der Produktdetailseite ausgegeben werden? (In einem extra Tab oder unter der Beschreibung) Weitere Hinweise finden [hier](#ausgabe_gpsr) |

{% hint style="warning" %}
**HINWEIS:** Alles zur Pflege der Informationen zur Produktsicherheitsverordnung finden Sie auf der Unterseite: [Produktsicherheitsrichtlinien](https://coolbax.gitbook.io/coolbax-docs/shopware-5-plugins/marktplatze/externe-bestellverwaltung/produktsicherheitsrichtlinien)
{% endhint %}

## Cronjob Einrichten <a href="#cronjob_einrichten" id="cronjob_einrichten"></a>

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

* **Shopware Bestellungen aus externen Accounts erstellen** - Erstellt die Bestellungen aus der externen Bestellverwaltung in Shopware Bestellungen. Dort können Sie wie gewöhnliche Bestellungen weiterverarbeitet oder durch eine WaWi abgeholt werden.
* **Status bei versandten Bestellungen in Tabelle setzen** - Bestellungen markieren, um dann den Versandstatus zu den Marktplätzen zu senden.

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:

* **Shopware Bestellungen aus externen Accounts erstellen** - /backend/ExternalOrderApi/createShopwareOrder?key=123
* **Status bei versandten Bestellungen in Tabelle setzen** - /backend/ExternalOrderApi/setStatus?key=123

Ersetzen Sie "123" durch den Eintrag den Sie im Feld **"Gültiger Schlüssel"** in den Plugin Einstellungen vergeben haben.

## Die externe Bestellübersicht <a href="#bestell_uebersicht" id="bestell_uebersicht"></a>

In der Übersicht unter "Filter Optionen" haben Sie auf der linken Seite die Möglichkeit Ihre Bestellungen nach Datum, Account/Marktplatz, Bestellstatus oder Zahlungsart gefiltert ausgeben zu lassen. Außerdem gibt es auch noch ein Eingabefeld in dem Sie gezielt nach Artikeln suchen können.

Auf der rechten Seite sehen Sie eine Auflistung der Bestellungen. Wichtige Informationen wie z.B. den Account/Marktplatz, den Zeitpunkt der Bestellung, die Bestellnummer, Betrag, usw. entnehmen Sie schon direkt aus der Tabellenübersicht.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FPZ6pffcG9f5WdS5i2Ozu%2FSW5-Externe_Bestellung-02.jpg?alt=media&#x26;token=afa08157-29c3-4385-9dd6-1ff7957684ed" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
**WICHTIG:** Wir empfehlen Ihnen KEINE eingespielte Bestellung aus der externen Bestellung zu löschen.
{% endhint %}

### Statistik <a href="#bestell_uebersicht_statistik" id="bestell_uebersicht_statistik"></a>

Unter dem Reiter "Statistiken" finden Sie eine statistische Auswertung von Umsatz je Account/Marktplatz.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FZpTFFmTUXC31h6j3JRtl%2FSW5-Externe_Bestellung-03.jpg?alt=media&#x26;token=62ea27a7-14ea-4c48-8b1a-ce54b665874c" alt="" width="563"><figcaption></figcaption></figure>

### Bestellungen manuell importieren <a href="#bestell_uebersicht_import" id="bestell_uebersicht_import"></a>

Hier haben Sie die Möglichkeit Bestellungen auch manuell zu importieren, ansonsten werden sie natürlich automatisch importiert.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FmMqnuwzwEd7EOD2e4cDk%2FSW5-Externe_Bestellung-04.jpg?alt=media&#x26;token=b5db75d4-8c1e-4bec-808c-470fceabf9e2" alt="" width="563"><figcaption></figcaption></figure>

## Bestellungs-Details <a href="#bestell_detail" id="bestell_detail"></a>

Diese Maske verschafft Ihnen eine Übersicht über alle wichtigen Details der Bestellung.

### Übersicht <a href="#bestell_detail_uebersicht" id="bestell_detail_uebersicht"></a>

In den Bestellungs-Details sehen Sie alle wichtigen und relevanten Informationen zu der Bestellung. Die Rechnung, die Lieferadresse sowie die Zahlungsart sind übersichtlich dargestellt und liefern die wichtigsten Informationen zu den jeweiligen Kategorien. Bestellungsdetails können natürlich auch eingesehen werden, sowie die Kundenkommentare oder auch interne Kommentare (falls hinterlegt).

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FDGXHBv1NekLIT93fjrQl%2FSW5-Externe_Bestellung-05.jpg?alt=media&#x26;token=79c263bd-7fd4-4859-8bb5-ba1dae7c0326" alt="" width="375"><figcaption></figcaption></figure>

### Detail <a href="#bestell_detail_detail" id="bestell_detail_detail"></a>

Im Reiter Detail können Sie alle Daten anpassen und ändern, wie z.B. die Zahlungsarten oder Rechnungs- bzw. Lieferadressen.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FG45YpUWX1zzoBd9dfpob%2FSW5-Externe_Bestellung-06.jpg?alt=media&#x26;token=7f852f04-a11f-4bb1-a7f6-b7a407776a7b" alt="" width="375"><figcaption></figcaption></figure>

### Positionen <a href="#bestell_detail_positionen" id="bestell_detail_positionen"></a>

Im letzten Reiter "Positionen" können sie Artikel öffnen oder durch den Button "Shop Bestellung öffnen" zur Shopware Bestellung gelangen, falls diese denn generiert wurde.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F0WqpDX5Z6NbyEwfHViUv%2FSW5-Externe_Bestellung-07.jpg?alt=media&#x26;token=6b1903b4-5409-47eb-9f2d-bc030727cb0c" alt="" width="375"><figcaption></figcaption></figure>

### Versanddienstleister <a href="#bestell_versanddienstleister" id="bestell_versanddienstleister"></a>

Sie haben die Möglichkeit den Versanddienstleiste für jede einzelne Bestellung auszuwählen. Dieser wird zusammen mit der Sendungsnummer zu den einzelnen Marktplätzen übermittelt. Für die Auswahl der Versanddienstleister gehen Sie in die Shopware Bestellverwaltung und öffnen die Bestellung.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FjbA00vvehwvtmmTBwwUZ%2FSW5-Externe_Bestellung-08.jpg?alt=media&#x26;token=1425bcd9-8159-44c9-88d5-cda4f79126ea" alt="" width="375"><figcaption></figcaption></figure>

## Die Ausgabe der externen Bestellnummer auf den Dokumenten <a href="#ausgabe_bestellnummer" id="ausgabe_bestellnummer"></a>

Um die externe Bestellnummer des jeweiligen Marktplatzes auf den Dokumenten auszugeben, müssen Sie in das jeweilige Dokumenten Template folgende Smarty Variable an einer beliebigen Stelle eintragen: {$Order.\_order.attributes.cbax\_external\_order\_ordernumber}

## Ausgabe der GPSR-Angaben auf der Artikeldetailseite <a href="#ausgabe_gpsr" id="ausgabe_gpsr"></a>

{% hint style="info" %}
**HINWEIS:** Die Einstellung zur Positionierung der GPSR-Angaben auf der Artikeldetailseite stellen Sie in den [Plugineinstellungen](#plugin_einstellungen) ein.
{% endhint %}

Um die Produktsicherheitsrichtlinien im Shopware Storefront auszugeben haben Sie zwei Möglichkeiten:

**In einem extra Tab** anzeigen bedeutet: Auf der Produktdetailseite wird ein extra Tap neben den Bewertungen des Produktes, mit dem Namen: Produktsicherheitsverordung (GPSR), eingefügt. In ihm werden die Information zur Produktsicherheit ausgegeben.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FaAWeI0TftyWoEs8qJxaA%2FSW5-Externe_Bestellung-09.jpg?alt=media&#x26;token=a24cf3de-ab1b-475f-9707-db269934a992" alt="" width="339"><figcaption></figcaption></figure>

**Unter der Beschreibung** anzeigen bedeutet: Auf der Produktdetailseite, direkt unter der Beschreibung werden die Angaben zur Produktsicherheit ausgegeben.

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2FaMMwhsVSom2eu8L10aOp%2FSW5-Externe_Bestellung-10.jpg?alt=media&#x26;token=9ed17367-3693-42e9-b252-960828ce7b70" alt="" width="339"><figcaption></figcaption></figure>

## Verwendung eines Proxy Server <a href="#proxy" id="proxy"></a>

Optional - Sie müssen dieses Feld nicht ausfüllen. Bei Verwendung eines Proxy Server geben Sie die IP-Adresse Ihres Proxy Servers zusammen mit der Nummer des Ports ein und zwar in folgendem Format: IP-Adresse : Nummer des Ports (falls notwendig). Beispiel: 10.10.0.5:1234

## Fragen und Antworten <a href="#fragenantworten" id="fragenantworten"></a>

<details>

<summary>Kein Menüpunkt "Externe Bestellungen" im Backend sichtbar?</summary>

In der Regel finden Sie die externe Bestellverwaltung unter dem Tab "Kunden". In seltenen Fällen ist die externe Bestellverwaltung nicht sichtbar, weil die entsprechenden Berechtigungen nicht vergeben sind. Um die externe Bestellverwaltung sichtbar zu machen, gehen Sie bitte wie folgt vor:

Einstellungen -> Benutzerverwaltung -> Regeln & Berechtigungen editieren -> Rolle: local\_admins (oder andere) auswählen -> Häkchen bei "externalorder" setzen.

</details>

<details>

<summary>Es werden nicht alle Bestellungen in der Shopware Bestellverwaltung angezeigt?</summary>

Es gibt immer mal wieder das Problem, dass eine Bestellung in der externen Bestellverwaltung hängen bleibt. Der Grund dafür liegt an den Adressdaten des Kunden. Bei Amazon und eBay gibt es keine vordefinierten Eingabefelder für die Kunden. Sie tragen ihre Adressdaten nach eigenen empfinden in die Spalten ein. Beim Import kann es daher passieren, dass der Nachname oder die Straßennummer in die Spalte Firma oder in ein Adresszusatzfeld importiert werden.

In der externen Bestellverwaltung finden Sie dies Bestellungen. Sie müssen nach Bestellungen schauen, welche keine Shopware Bestell-Nr. haben. Sie können auch den Filter "Generiert: nein" nutzen. Öffnen Sie die Bestellungen und korrigieren Sie die Adressdaten, danach können Sie die Bestellung manuell in eine Shopware Bestellung umwandeln oder Sie warten auf den Cronjob.

TIPP: Tragen Sie in den Einstellungen des Plugins: Externe Bestellungen unter "E-Mail Adresse" ihre E-Mail Adresse ein, um per Mail benachrichtigt zu werden, wenn eine Bestellung hängen geblieben ist.

</details>

<details>

<summary>Es werden keine Bestellungen automatisch umgewandelt?</summary>

Falls keine Bestellungen in Shopware Bestellungen umgewandelt werden, prüfen Sie bitte folgende Punkte:

* Ist das Plugin auf "Aktiv" gestellt?
* Ist das Cron-Plugin von Shopware aktiviert?
* Ist der Cronjob "Shopware Bestellungen aus externen Accounts erstellen" aktiv eingestellt?
* Ist der Cronjob "Status bei versandten Bestellungen in Tabelle setzen" aktiv eingestellt?
* Ist der Cronjob auf Ihrem Server konfiguriert? Einrichten eines Cronjob auf dem Server.
* Sind die Einstellungen im Plugin korrekt?

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