# Bestellverwaltung + GPRS

{% hint style="warning" %}
Angaben zur **GPSR - Verordnung** werden über ein extra Modul gepflegt. [Alle Informationen zum Thema finden Sie hier](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs/produktsicherheitsrichtlinien.md)
{% endhint %}

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

### Installation&#x20;

Sie können das Plugin [hier über den Shopware Community Store erwerben](https://store.shopware.com/cbax895325672158/externe-bestellverwaltung-z.b.-fuer-amazon-ebay-usw.-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

{% hint style="info" %}
Bei einem Shopware Update müssen die Bestellimporte und Produktexporte bzw. Lagerbestandsabgleich  deinstalliert werden, um die Bestellverwaltung deaktivieren zu können
{% endhint %}

Die Marktplatz Bestellverwaltung, die Bestellimporte und die Produktexporte bzw. der Lagerbestandsabgleich bauen aufeinander auf und müssen in umgedrehter Reihenfolge deaktiviert bzw. deinstalliert werden.

Nach folgender Reihenfolge deaktivieren bzw. deinstallieren Sie die Plugins:

1. Lagerbestandsabgleich / Produktexporte (wenn vorhanden)
2. Bestellimport deinstallieren
3. Bestellverwaltung deinstallieren

{% hint style="warning" %}
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 %}

## Plugin Einstellungen <a href="#plugin_einstellungen" id="plugin_einstellungen"></a>

{% hint style="info" %}
Sie haben zwei Möglichkeiten um zu den Plugin Einstellungen zu kommen:

* *Einstellungen > Erweiterungen > Marktplatz Konfigurationen >* Marktplatz Bestellverwaltung + GPSR
* *Erweiterungen > Meine Erweiterungen >* Marktplatz Bestellverwaltung + GPSR
  {% endhint %}

### Einstellungen

| Einstellung                                              | Bedeutung                                                                                                                                                                                                                                          |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Limit für Shopware Bestellungen mit einmal zu generieren | Limit für das Erstellen der Shopware Bestellungen                                                                                                                                                                                                  |
| E-Mail Adresse (empfohlen für Fehlerbenachrichtigungen)  | <p>Die E-Mail Adresse AN die die Fehler versendet werden. Bleibt das Feld leer, werden keine E-Mails versendet <br><br><mark style="color:blue;">HINWEIS: Mehrere E-Mail Adressen sind möglich und werden mit einem Semikolon getrennt.</mark></p> |
| Debug (empfohlen für detailliertere Fehlermeldungen)     | Debug Modus. Nur zur Ausgabe von detaillierten E-Mail Meldungen                                                                                                                                                                                    |
| Absendername                                             | Der Absendername von dem die Fehler versendet werden                                                                                                                                                                                               |
| E-Mail Absenderadresse                                   | Die E-Mail Absenderadresse VON der die Fehler versendet werden                                                                                                                                                                                     |
| Gültiger Schlüssel (Pflichtfeld!)\*                      | Er dient zur Absicherung ihrer Cronjobs. Diese können, ohne die eingetragene Zahlenkette, nicht aufgerufen und durchgeführt werden. Weitere Hinweise finden Sie unter: [Conjobs einrichten](#cronjob_einrichten)                                   |

{% hint style="info" %}
\* Mit der erstmaligen Installation des Plugins wird ein einmaliger Schlüssel automatisch generiert. Sie können diesen individuell anpassen.
{% endhint %}

### Status Einstellungen

| Einstellung                                                                  | Bedeutung                                                                                                                                       |
| ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Soll der Liefer- oder Bestellstatus für den Versandstatus verwendet werden\* | Entscheiden Sie, welcher Status zur Versandbestätigung verwendet werden soll                                                                    |
| Bestellstatus versendet                                                      | Ab wann gilt eine Bestellung als versendet, um den Versandstatus an den jeweiligen Marktplatz zu melden                                         |
| Lieferstatus versendet                                                       | Ab wann gilt eine Bestellung als versendet um den Versandstatus an den jeweiligen Marktplatz zu melden.                                         |
| Bestellstatus abgebrochen                                                    | Ab wann gilt eine Bestellung als abgebrochen bzw. storniert(bei erfolgter Versandmeldung) um den Status an den jeweiligen Marktplatz zu melden. |

{% hint style="warning" %}
\* Achten Sie in ihren Abläufen darauf, dass die Sendungsnummer bereits in der Bestellung hinterlegt sein muss, bevor die Versandbestätigung an die Marktplätze übermittelt wird.&#x20;
{% endhint %}

### Standard Produkt

| Einstellung                    | Bedeutung                                                                                                                |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Dummy Produkt\* (Pflichtfeld!) | Wählen Sie ein Produkt (ein Dummy Produkt) für Bestellungen, bei denen kein passendes Produkt in Shopware gefunden wurde |

{% hint style="info" %}
\* Für die Erstellung einer Bestellung in Shopware wird ein gültiges Produkt benötigt. Sollte kein passendes Produkt zu finden sein, wird das gewählte Dummy Produkt zugewiesen.

Für die richtige Zuordnung muss die Amazon **SKU/Bestandseinheit = Produktnummer** von Shopware sein.
{% endhint %}

### Optionale Einstellungen

| Einstellung           | Bedeutung                                                                                                                            |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Proxy-Server          | Optional - Sie müssen dieses Feld nicht ausfüllen. Weitere Informationen finden Sie unter: [Verwendung Proxy Server](#proxy)         |
| App-URL überschreiben | Optional - Sie müssen dieses Feld nicht ausfüllen. Möglichkeit die APP\_URL zu überschreiben (wird z.B. für Emailersetzung genutzt). |

### Produktsicherheitsverordnung (GPSR)

{% hint style="warning" %}
Alles zur Pflege der Informationen zur Produktsicherheitsverordnung finden Sie auf der Unterseite: [Produktsicherheitsrichtlinien](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs/produktsicherheitsrichtlinien.md)
{% endhint %}

| Einstellung                                                                     | Bedeutung                                                            |
| ------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| Anzeige in der Storefront                                                       | Bei Aktivierung werden die GPSR Daten im Frontend ausgegeben         |
| [Wo sollen die Daten angezeigt werden?](#moglichkeiten-zur-ausgabe-im-frontend) | Wie sollen die Informationen im Shopware Frontend ausgegeben werden? |

#### Möglichkeiten zur Ausgabe im Frontend der GPSR-Angaben

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 der Beschreibung des Produktes, mit dem Namen: *Produktsicherheit,* eingefügt. In ihm werden die Information zur Produktsicherheit ausgegeben.

<figure><img src="/files/IUy7ShDoT4NZfVKTZ8ta" alt=""><figcaption><p>Beispiel für Anzeige in einem extra Tap</p></figcaption></figure>

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

<figure><img src="/files/zslPjtwPDzBi0XIJTdeA" alt=""><figcaption><p>Beispiel für Anzeige unter der Produktbeschreibung</p></figcaption></figure>

### Migration von GPSR-Daten von SW5 zu SW6

| Einstellung                                               | Bedeutung                                                                                      |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Shopware 5 Shop-Domain                                    | Hier wird eine aufrufbare Shop-Domain von Shopware 5 benötigt ( z. B.: <https://mein-shop.de>) |
| Gültiger Schlüssel in Shopware 5                          | Den gültigen Schlüssel finden Sie in der Plugin-Konfiguration in Shopware 5                    |
| [Importieren von GPSR-Daten](#importieren-von-gpsr-daten) | Start der Migration                                                                            |

#### Importieren von GPSR-Daten

Mit Betätigung des Buttons werden die GPSR-Daten von Shopware 5 zu Shopware 6 importiert.

{% hint style="warning" %}
Der Vorgang kann mehrmals durchgeführt werden, jedoch werden bereits importierte Einträge nicht mehr aktualisiert!
{% endhint %}

Eine Zuordnung von GPSR-Daten zu vorhandene Produkten und Herstellern erfolgt ebenfalls.

{% hint style="warning" %}
Bitte beachten Sie, dass keine Produkte oder Hersteller über die Migration angelegt werden! Nur mit einer Übereinstimmung vorhandener Produkte bzw. Hersteller in SW5 und SW6 kann eine Zuordnung erfolgen.
{% endhint %}

Hierfür müssen folgende Voraussetzungen erfüllt sein:

* **Produkte:**\
  Produkte werden anhand der Artikel-/Produktnummer zugeordnet, d. h. die Artikelnummer in Shopware 5 muss identisch mit der Produktnummer in Shopware 6 sein.
* **Hersteller:**\
  Die Zuordnung der Hersteller erfolgt über den Namen. Hersteller müssen in beiden Systemen den gleichen Namen besitzen, zudem muss er einmalig sein. Sollten (in einem System) zwei Hersteller den selben Namen haben, kann keine Zuordnung erfolgen!

{% hint style="info" %}
Fehler / Warnungen /Hinweise finden Sie im [Logbuch](#logbuch) bei den Marktplatz Konfigurationen.&#x20;
{% endhint %}

## Marktplatz Konfigurationen

Über die Marktplatz Konfigurationen kommen Sie zu den Plugin Einstellungen der gesamten Marktplätze sowie der Marktplatz Bestellverwaltung. Sie gelangen über: *Einstellungen > Erweiterungen > Marktplatz Konfigurationen* dorthin.

Auf einem Blick erhalten Sie eine Übersicht über aktive / installierte und deaktivierte / deinstallierte Marktplätze, sowie das Datum des letzten Updates, die Plugin Version, das letzte Import Datum und die Links zu den Handbüchern. Zusätzlich erfahren Sie, welche Marktplätze ebenfalls im Shopware Store erwerben werden können.

### Logbuch <a href="#logbuch" id="logbuch"></a>

{% hint style="warning" %}
Logbucheinträge werden nach 60 Tagen gelöscht
{% endhint %}

Im Logbuch erhalte Sie detaillierte Informationen zu Fehlermeldungen, Warnungen oder Erfolgsmeldungen für die gesamten Marktplätze und die Marktplatz Bestellverwaltung. Sie gelangen zu dem Logbuch über den Button: *Hilfstools > Logbuch*.

<figure><img src="/files/aZBRJnCN6j0X2J0GAQfy" alt=""><figcaption></figcaption></figure>

#### Logbuch-Details anzeigen

Um zu den detaillierten Informationen zu gelangen, können Sie einerseits in der Spalte "Text" auf die jeweilige Zeile klicken oder sie nutzen das Menü in der letzten Spalte. Klicken Sie hierzu auf die drei Punkte. Es öffnet sich ein Fenster mit den jeweiligen Informationen.

<figure><img src="/files/IMO9v8vrvP2ZfP0ZYtwL" alt=""><figcaption></figcaption></figure>

#### Filter für Logbuch

In der Übersicht haben Sie zudem noch die Möglichkeit Filter zur besseren Übersicht anzuwenden. Hier können Sie nach Marktplätzen oder Typ filtern.

<div><figure><img src="/files/QibvP9DiTrc0SXVvtuje" alt=""><figcaption></figcaption></figure> <figure><img src="/files/N9lSG0ZHn08mouq4DAht" alt=""><figcaption></figcaption></figure></div>

### Cronjobverwaltung <a href="#cronjobverwaltung" id="cronjobverwaltung"></a>

Sie gelangen zu der Cronjobverwaltung über: *Hilfstools > Cronjobverwaltung*. Hier finden Sie die gesamten Cronjobs welche unter anderem für die Marktplatzbestellverwaltung und die Marktplätze verwendet werden.

{% hint style="info" %}
Ab der Plugin Version 3.1.3 bzw. 4.0.1 werden alle Cronjobs angezeigt (unabhängig, ob diese von Coolbax oder Drittanbieter Plugins bzw. Shopware stammen).
{% endhint %}

<figure><img src="/files/CDVp7CwcoDCGoHxSVBjH" alt=""><figcaption></figcaption></figure>

Die darauf angezeigte Tabelle zeigt Ihnen die Cronjobs. Sie haben hier die Möglichkeit, einzelne Cronjobs mittels Doppelklick auf die Zeile, zu bearbeiten. Ändern Sie z. B. den Status, das Intervall oder den Zeitpunkt der nächsten Ausführung. Wie Sie alle Cronjobs auf einmal zurücksetzen, erfahren Sie unter: [Cronjobs zurücksetzen](#cronjobs-zuruecksetzen).

#### Bedeutung der Status

Die nachfolgende Tabelle zeigt alle möglichen Status der Cronjobs auf und erklärt deren Bedeutung:

| Status                                 | Bedeutung                                                                          |
| -------------------------------------- | ---------------------------------------------------------------------------------- |
| Cronjob aktiv                          | Der Cronjob ist aktiv und kann Ausgeführt werden.                                  |
| Cronjob deaktiviert                    | Der Cronjob ist deaktiviert und wird nicht ausgeführt                              |
| Cronjob wartet auf Ausführung          | Der Cronjob wird demnächst ausgeführt.                                             |
| Cronjob wird auf Ausführung            | Der Cronjob wird gerade ausgeführt.                                                |
| Cronjob fehlgeschlagen und deaktiviert | Bei der Durchführung des Cronjob ist ein Fehler aufgetreten und wurde deaktiviert. |

#### Filtermöglichkeiten

Einen bestimmten Status können Sie über den Filter auf der rechten Seite filtern und anzeigen lassen.

<div><figure><img src="/files/8xxRrwK1XekuHLnu2GMy" alt=""><figcaption></figcaption></figure> <figure><img src="/files/S6gVSJJxYRo78g6Jv6c4" alt=""><figcaption></figcaption></figure></div>

Zur Filterung stehen Ihnen der aktuelle **Status** der Cronjobs zur Verfügung. Nach dem **Typ** können Sie ab der Plugin Version 3.1.3 bzw. 4.0.1 filtern. Hier filtern Sie nach Coolbax, Drittanbieter oder Shopware Cronjobs. Sie haben ebenfalls die Möglichkeit, alle anzeigen zu lassen.

#### **Cronjobs zurücksetzen**

Mit diesem Button setzen Sie alle Status zurück auf "Cronjob aktiv". Sie haben somit die Möglichkeit einen Status wie "Cronjob fehlgeschlagen" mit einem Klick bei mehreren Cronjobs zu korrigieren, damit diese beim nächsten Durchlauf wieder arbeiten können.

{% hint style="warning" %}
Bitte beachten Sie, dass deaktivierte Cronjobs weiterhin deaktiviert bleiben. Dieser Status verändert sich nicht!
{% 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.

* **Umwandlung der externen Bestellungen in Shopware-Bestellungen** - 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 'Versandt' in Bestellverwaltung übertragen** - Bestellungen markieren, um dann den Versandstatus zu den Marktplätzen zu senden.
* **Status 'Abgebrochen' in Bestellverwaltung übertragen** - Diese Funktion soll in Zukunft folgen

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 (aktuelle Version)" %}

* **Umwandlung der externen Bestellungen in Shopware-Bestellungen** - /api/cbax/externalOrder/createShopwareOrder?key=123
* **Status bei versandten Bestellungen in Tabelle setzen** - /api/cbax/externalOrder/setDispatchStatus?key=123
* **Status bei abgebrochenen Bestellungen in Tabelle setzen** - /api/cbax/externalOrder/setCanceledStatus?key=123
  {% endtab %}

{% tab title="bis Shopware 6.3 (alte Version)" %}

* **Umwandlung der externen Bestellungen in Shopware-Bestellungen** - /api/v{version}/cbax/externalorder/createShopwareOrder?key=123
* **Status 'Versandt' in Bestellverwaltung übertragen** - /api/v{version}/cbax/externalorder/setDispatchStatus?key=123
* **Status 'Abgebrochen' in Bestellverwaltung übertragen** - /api/v{version}/cbax/externalorder/setCanceledStatus?key=123
  {% endtab %}
  {% endtabs %}

{% hint style="info" %}
Ersetzen Sie "123" durch den Eintrag den Sie im Feld **"Gültiger Schlüssel"** in den [Plugin Einstellungen](#plugin_einstellungen) vergeben haben.
{% endhint %}

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

Um zur Externen Bestellübersicht zu gelangen, gehen Sie auf: *Bestellungen > Marktplätze*. Die Übersicht zeigt Ihnen alle bereits importierten Bestellungen an. Um alle wichtigen Informationen zu erhalten, haben Sie die Möglichkeit Spalten ein und auszublenden.

Über den Button "Konfigurationen" gelangen Sie in die Konfigurationsübersicht der Marktplätze und können dort die Einstellungen für die Marktplätze und die Marktplatz Bestellverwaltung anpassen. Weitere Information finden Sie unter: [Marktplatz Konfigurationen](#marktplatz-konfigurationen).

Sie haben die Möglichkeit den Inhalt der Bestellübersicht selber anzupassen. Dazu klicken Sie auf das Menü auf der rechten Seite und aktivieren die Spalten, welche für Sie interessant sind. Folgende Inhalte stehen Ihnen zur Verfügung:

* Marktplatz
* Bestelldatum
* Marktplatz Bestell-Nr
* Shopware Bestell-Nr
* Kundenname
* Rechnungsadresse
* Zahlungsart
* Betrag
* Bestellstatus
* [Versand ](#status-der-uploads)
* [Rechnung Upload](#status-der-uploads)
* [Abgebrochen](#status-der-uploads)
* Tracking Code
* Generierungsfehler

Mit der Aktivierung der Einstellung "Kompaktmodus verwenden" können Sie die Zeilenhöhe verringern, damit mehr Zeilen auf einer Seite dargestellt werden können.

#### Status der Uploads

Mit den Spalten: Versand, Rechnung Upload und Abgebrochen können Sie erkennen, welche Informationen hochgeladen wurde.&#x20;

* <mark style="color:$info;background-color:$info;">Grauer Punkt = Upload wäre möglich</mark>
* <mark style="color:blue;background-color:$primary;">Blauer Punkt = Upload ist vorbereitet und wartet auf die Übermittlung</mark>
* <mark style="background-color:$success;">Grüner Punkt = Upload war erfolgreich</mark>
* <mark style="color:red;background-color:red;">Roter Punkt = Ein Fehler ist aufgetreten. Upload wurde nicht durchgeführt</mark>
* <mark style="color:$info;background-color:$info;">Graues Kreuz = Upload ist für diesen Markplatz nicht möglich</mark>

<figure><img src="/files/nnBNLkBptpmTdzHD9mEo" alt=""><figcaption></figcaption></figure>

### **Filter**&#x20;

Zur besseren Übersicht, haben Sie die Möglichkeit nach bestimmten Bestellungen zu filtern. Hierzu nutzen Sie die Filter auf der rechten Seite. Sie können filtern nach: Marktplatz, Verkaufskanal, Versandstatus und Generierungsstatus.

<div><figure><img src="/files/955bqo1YcFk7bbq1JPEk" alt=""><figcaption><p>Filter auf der rechten Seite  in der Marktplatz Übersicht</p></figcaption></figure> <figure><img src="/files/g3jvTux6ajRli1fWNott" alt=""><figcaption><p>Filteroptionen</p></figcaption></figure></div>

### **Suche**&#x20;

Über das Suchfeld von Shopware können Sie nach bestimmten Bestellungen suchen. Nutzen Sie z. B. die externe Bestellnummer oder die Shopware Bestellnummer (wenn vorhanden) um eine bestimmte Bestellung zu finden

<figure><img src="/files/9tFAt13t58vlDpVN3pKg" alt=""><figcaption><p>Suchfeld von Shopware mit externe Bestellnummer</p></figcaption></figure>

{% hint style="info" %}
Ab der Plugin Version 3.1.3 bzw. 4.0.1 können Sie auch in der Shopware Bestellübersicht nach externen Bestellnummern suchen!
{% endhint %}

### **Aktionen**

Die Aktionen finden Sie am Ende der Tabelle. Klicken Sie auf die drei Punkte auf der rechten Seite damit das Menü geöffnet wird. Mit Hilfe der Aktionsmöglichkeiten können Sie:

* Bestelldetails ansehen&#x20;
* Aus einer externen Bestellung einen Shopware Bestellung generieren&#x20;
* Versandstatus\* hochladen&#x20;
* Rechnungen\*\* hochladen
* Stornorechnungen\*\* hochladen
* Bestellung löschen

<figure><img src="/files/TKrO5x5ChMlWkdQaCXI8" alt=""><figcaption><p>Aktionsmöglichkeiten in der Marktplatz Übersicht</p></figcaption></figure>

{% hint style="warning" %}
\* Bitte beachten Sie, dass der in den Plugin Einstellung hinterlegte Status eingestellt sein muss, um einen Versandstatus zu übermitteln
{% endhint %}

{% hint style="warning" %}
\*\* Bitte beachten Sie, damit das Dokument bereits erstellt sein muss, bevor der Bestellstatus gesetzt wird.&#x20;
{% endhint %}

### Massenbearbeitung <a href="#bestell_uebersicht_import" id="bestell_uebersicht_import"></a>

Wählen Sie mehrere Bestellungen aus (Checkbox aktivieren) um die Massenbearbeitung zu nutzen. Nachdem Sie ihre Auswahl getroffen haben erscheinen folgende Aktionsmöglichkeiten:

* [Bestellungen löschen](#bestell_marktplatzdetail)
* [Versandstatus zurücksetzen](#bestell_marktplatzdetail-1)
* [Rechnung vorbereiten](#rechnung-vorbereiten)
* [Rechnungsstatus zurücksetzen](#rechnungsstatus-zurucksetzen)
* [Stornostatus zurücksetzen](#stornostatus-zurucksetzen)

<figure><img src="/files/4sp2BAhdQaZHGPFKJ8yZ" alt=""><figcaption><p>Massenbearbeitung in der Marktplatz Übersicht</p></figcaption></figure>

#### Bestellungen löschen <a href="#bestell_marktplatzdetail" id="bestell_marktplatzdetail"></a>

{% hint style="danger" %}
**WICHTIG:** Wir empfehlen KEINE eingespielten Bestellungen aus der externen Bestellung zu löschen!\
\
Sollte eine Bestellung bereits importiert und in eine Shopware Bestellung umgewandelt sein, laufen Sie Gefahr, dass durch einen erneute Import, wieder eine Shopware Bestellung angelegt wird und Sie die Bestellung doppelt ausliefern! &#x20;
{% endhint %}

Mit "Löschen" können Sie mehrere Externe Bestellungen aus der Marktplatz Bestellverwaltung löschen. Einzelne Bestellungen können ebenfalls über die [Aktionen](#aktionen) gelöscht werden.

#### Versandstatus zurücksetzen <a href="#bestell_marktplatzdetail" id="bestell_marktplatzdetail"></a>

Diese Funktion ermöglicht es Ihnen einen fehlerhaften Versands Status zurückzusetzen, um einen erneuten Upload zu ermöglichen.

#### Rechnung vorbereiten

{% hint style="warning" %}
Die Funktion wird normalerweise von einem Cronjob durchgeführt. Muss es einmal schnell gehen, können Sie die Funktion manuell anstoßen.
{% endhint %}

Mit "Rechnung vorbereiten" sagen Sie dem System, dass diese Bestellung ein Rechnungsdokument besitzt und die Rechnung an den Marktplatz hochgeladen werden kann.&#x20;

{% hint style="info" %}
Um einen Versand oder Storno/Gutschrift vorzubereiten nutzen Sie bitte [Weitere Einstellungen](#weitere-einstellungen)
{% endhint %}

#### Rechnungsstatus zurücksetzen

Diese Funktion ermöglicht es Ihnen einen fehlerhaften Rechnungsstatus zurückzusetzen, um einen erneuten Upload zu ermöglichen.

#### Stornostatus zurücksetzen

Diese Funktion ermöglicht es Ihnen einen fehlerhaften Stornostatus zurückzusetzen, um einen erneuten Upload zu ermöglichen.

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

Um eine Bestellung manuell zu importieren, klicken Sie auf den Button „Neue Bestellung importieren“. In dem nun öffnenden Fenster wählen Sie den Marktplatz und tragen die entsperrende Bestellnummer in die vorgesehenen Felder. Möchten Sie mehrere Bestellungen mit einmal holen, müssen Sie die Bestellnummern untereinander eintragen.

<figure><img src="/files/JjBHIRGHgsUAcjupWfsM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ojGQ7HhHCHYaauCYaylG" alt=""><figcaption><p>Beispiel für den manuellen Import von mehreren eBay-Bestellungen</p></figcaption></figure>

{% hint style="warning" %}
**Achtung:** Einige wenige Marktplätze lassen einen manuellen Import nicht zu. Informieren Sie sich hierzu in dem Handbuch des jeweiligen Bestellimports.
{% endhint %}

### Weitere Einstellungen

Der Button mit dem Zahnrad-Symbol enthält Links zu den [Marktplatz Konfigurationen](#marktplatz-konfigurationen), zum [Logbuch](#logbuch) und zur [Cronjob-Verwaltung](#cronjobverwaltung). Des Weiteren können Sie den Prozess: [Versand vorbereiten](#versand-vorbereiten) und [Storno/Gutschrift vorbereiten](#storno-gutschrift-vorbereiten) anstoßen.

<figure><img src="/files/j5jErY3hEFipbHaJuq90" alt=""><figcaption></figcaption></figure>

#### Versand vorbereiten

Mit dieser Funktion wird der Versandstatus bei alle (möglichen) Bestellungen vorbereitet.

#### Storno/Gutschrift vorbereiten

Mit dieser Funktion wird der Status für Storno/Gutschriften bei alle (möglichen) Bestellungen vorbereitet.

{% hint style="info" %}
Um einen Rechnung vorzubereiten nutzen Sie bitte die [Massenbearbeitung](#bestell_uebersicht_import).
{% endhint %}

## Bestelldetails Marktplatz Bestellverwaltung <a href="#bestell_marktplatzdetail" id="bestell_marktplatzdetail"></a>

Sie können sich eine Bestellung genauer ansehen und bearbeiten, indem Sie auf die Bestellnummer in der Spalte "Marktplatz Bestell-Nr." klicken. Ist die Bestellung bereits in einer Shopware Bestellung generiert, können Sie über die Bestellnummer in der Spalte "Shopware Bestell-Nr." zu den Shopware Bestelldetails kommen.

<figure><img src="/files/G7DI9ZMNGzyoM6sLB7Zl" alt=""><figcaption></figcaption></figure>

### Details <a href="#bestell_marktplatzdetail_uebersicht" id="bestell_marktplatzdetail_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.

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

Bei „Positionen“ ist ersichtlich, welche Produkte der Kunde bestellt hat. Klickt man in den Spalte „Name“ einen Artikelnamen an, gelangt man direkt zu diesem Artikel (solange ein passender Artikel im Shop angelegt ist). Findet das System keinen passenden Artikel, gelangt man zum Dummyprodukt. Das Dummyprodukt legen Sie in den Plugin Einstellungen fest. Weitere Informationen finden Sie unter: [Plugin Einstellungen](#plugin_einstellungen).

### Rechnungs- und Lieferadresse <a href="#bestell_marktplatzdetail_adressdaten" id="bestell_marktplatzdetail_adressdaten"></a>

Bei "Rechnungsadresse" bzw. "Lieferadresse" können Sie alle hinterlegten Daten anpassen und ändern.

## Bestelldetails Shopware Bestellverwaltung <a href="#bestell_shopwaredetail" id="bestell_shopwaredetail"></a>

In der Detailansicht der Shopware Bestellungen erhalten Sie die Möglichkeit von den vor eingestellten Einstellungen der Marktplätze abzuweichen. Sie haben die Möglichkeit den Versanddienstleister für jede Bestellung zu ändern. Diese Einstellung finden Sie unter "Marktplatz". Zudem sehen Sie hier noch einmal die Marktplatz Bestellnummer.

{% hint style="info" %}
Für die Amazon Bestellungen gibt es weitere Einstellungsmöglichkeiten. Hier kann zusätzlich der Lieferservice und der Abweichender Versandt Dienstleister eingetragen werden, wenn im Feld Versand Dienstleister "Other" ausgewählt wurde.
{% endhint %}

<figure><img src="/files/95cjO2Y0IEDfPk901d1R" alt=""><figcaption><p>Beispiel eines zusätzlichen Tap für Amazon</p></figcaption></figure>

### Sendungsnummer hinterlegen

{% hint style="info" %}
Die Pickware Plugins: "[DHL Versand](https://store.shopware.com/viiso52049132916f/dhl-versand.html)" oder "[GLS Versand](https://store.shopware.com/pickw94187261995f/gls-versand.html)" werden von uns unterstützt. Eine manuelle Hinterlegung der Trackingnummern ist nicht notwendig.
{% endhint %}

Bei der Übermittlung des Versandstatus muss eine Sendungsnummer mitgeliefert werden. Um manuell eine Sendungsnummer zu hinterlegen gehen Sie auf: *Bestellungen > Übersicht* und öffnen eine Marktplatz Bestellung. Dort gehen Sie auf: *Details > Versand > Sendungsnummer(n).*

<figure><img src="/files/O78xnn1J7TWtTdOgvWh7" alt=""><figcaption><p>Feld, in dem Sie die Trackingnummer hinterlegen müssen</p></figcaption></figure>

### Rücksendungsnummer für OTTO Bestellungen

OTTO Bestellungen benötigen nicht nur die Sendungsnummer, sondern auch eine Rücksendungsnummer. Diese müssen bereits bei der Übermittlung des Versandstatus vorhanden sein.

Die Rücksendungsnummer muss ebenfalls im Feld Sendungsnummer(n) hinterlegt sein. In folgender Reihenfolge hinterlegen Sie beide Trackingnummer :

1. Nummer: Versand
2. Nummer: Rückversand

<figure><img src="/files/5Av7Sf33CmdzyahWXlZf" alt=""><figcaption><p>Reihenfolge der Nummern im Feld Sendungsnummer(n)</p></figcaption></figure>

## Übermittlung des Versandstatus

Den Versandstatus setzen Sie in der Bestellübersicht von Shopware. Ist der entsprechende Status gesetzt, übergibt ein Cronjob die Information an die Marktplatz Bestellverwaltung. Ein weiterer Cronjob übernimmt anschließend die Übermittlung an den entsprechenden Marktplatz.

{% hint style="info" %}
Welcher Status als Versandstatus gilt, haben Sie in den Plugin Einstellungen unter: [*Status Einstellungen > Bestellstatus versendet*](#status-einstellungen) festgelegt.
{% endhint %}

### Sendungsnummer und Rücksendungsnummer

Um die Sendungsnummer und Rücksendungsnummer (für OTTO) erfolgreich zu übermitteln, müssen diese bereits im System hinterlegt sein, BEVOR der Versandstatus gesetzt wird. Die Nummern tragen Sie in den Bestelldetails der Shopware Bestellverwaltung unter: [*Details > Versand > Sendungsnummer(n)*](#trackingnummer-hinterlegen) ein.

### Rechnungen übermitteln

Rechnungen können an Amazon übermittelt werden. In den Plugin Einstellungen von Amazon müssen Sie zuerst die Einstellung: [*Rechnungs-Upload > Rechnungs-Upload\* aktivieren*](/coolbax-docs/handbuecher/marktplaetze/amazon-bestellimport.md#rechnungs-upload) aktivieren. \
Wählen Sie anschließend einen Bestellstatus aus, mit dem Sie dem Plugin sagen, wann eine Rechnung zur Verfügung steht und an Amazon übermittelt werden kann. Diese Einstellung setzen Sie unter: [*Rechnungs-Upload >* Rechnungs-Upload für Bestellungen mit diesem Status](/coolbax-docs/handbuecher/marktplaetze/amazon-bestellimport.md#rechnungs-upload).

{% hint style="danger" %}
Nutzen Sie nicht den selben Status für die Rechnungen wie für den Versandstatus! **Rechnungen dürfen erst NACH dem Versandstatus übermittelt werden**.&#x20;
{% endhint %}

Sind alle Einstellungen gesetzt, gehen Sie in die Shopware Bestellverwaltung zu einer Bestellung. Ändern Sie den Status für den Versand in den Status für den Rechnungs-Upload um. Ein Cronjob wird nun die Information an die Marktplatz Bestellverwaltung senden. Anschließend wird ein weiterer Cronjob die Datei an Amazon übermitteln.

{% hint style="warning" %}
Beachten Sie, dass jeder Cronjob in unterschiedlichen Intervallen arbeitet. Um die Reihenfolge einzuhalten, müssen die Cronjobs aufeinander abgestimmt sein. Richten Sie bitte Ihre Cronjobs dementsprechend ein!
{% endhint %}

## Mehrwertsteuer in Abhängigkeit der Länder

Wenn Ihr Unternehmen seinen Sitz in der EU hat, unterliegt es je nach Land des Geschäftspartners und je nachdem, ob Sie mit Waren oder Dienstleistungen handeln, unterschiedlichen Mehrwertsteuerpflichten.

Informieren Sie sich hierzu z.B. auf der Seite: Your Europe (Eine offizielle Website der Europäischen Union)

{% embed url="<https://europa.eu/youreurope/business/taxation/vat/cross-border-vat/index_de.htm>" %}
Link zu: Your Europe (Eine offizielle Website der Europäischen Union)
{% endembed %}

Um die unterschiedlichen Steuersätze zu hinterlegen, gehen Sie auf: Einstellungen > Shop > Steuern. wählen dort einen Steuersatz aus und fügen die Länder mit den abweichenden Steuersätzen hinzu.&#x20;

Eine ausführliche Beschreibung finden Sie in der Shopware Dokumentation:

{% embed url="<https://docs.shopware.com/de/shopware-6-de/einstellungen/steuern#andere-steuerregeln-fuer-einzelne-laender>" %}
Shopware Handbuch zu andere Steuerregeln für einzelne Länder&#x20;
{% endembed %}

{% hint style="info" %}
Hinterlegen Sie hier Länder mit 0%, wo Sie keine Mehrwertsteuer erheben brauchen (z. B. Schweiz).
{% endhint %}

## Anlage von Kundendaten

Kundendaten von externen Bestellungen werden als Gastbestellung angelegt. Bestellt der Kunde ein weiteres Mal, wird das bestehende Gastkonto vom System genutzt. Als Matching Kriterium wird die übermittelte E-Mail Adresse genutzt.

Für das Matching ist es unabhängig, ob der Gastaccount zu einem Kundenaccount umgewandelt wurde oder der Account deaktiviert ist.

## Flow Builder - Automatische Abläufe generieren

Ab der Plugin Version 3.0.8 können Sie eigene automatische Abläufe generieren. Diese erstellen Sie über die Flow Builder von Shopware. Wie Sie diese erstellen, erfahren Sie in der Dokumentation von Shopware

{% embed url="<https://docs.shopware.com/de/shopware-6-de/einstellungen/Flow-Builder>" %}
Shopware Handbuch zur Erstellung von Flow Builder
{% endembed %}

Ab der Plugin Version 3.0.8 erhalten Sie einen neuen Ordner mit dem Namen "Coolbax" bei Auslöser. Unter diesen, finden Sie alle Möglichkeiten, welche Sie als Auslöser verwenden können.

Möchten Sie z. B. automatisch eine Rechnung erzeugen, wenn die Bestellung in eine Shopware Bestellung generiert wurde, dann nutzen Sie den Auslöser: *Coolbax > Bestellungen > Eingang* und wählen anschließend die Aktion Dokument erstellen > Rechnung.

<figure><img src="/files/uL4z9XarJcua7KX7SQaR" alt=""><figcaption></figcaption></figure>

## Verwendung 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>Wo wird die Sendungsnummer hinterlegt bzw. wo kann ich diese finden?</summary>

Die Sendungsnummer tragen Sie IMMER bei der Shopware Bestellung ein. Öffnen Sie diese und gehen auf den Reiter: *Details.* Scrollen Sie nun zu Versand und in dem Feld: *Sendungsnummer(n)* finden Sie Sendungsnummer bzw. können diese hier eintragen.

</details>

<details>

<summary>Warum wird meine Sendungsnummer nicht dem Marktplatz übermittelt?</summary>

War die Sendungsnummer bereits vorhanden, als Sie die Versandinformation an den Marktplatz mitgeteilt haben? Meist liegt hier der Fehler. Überprüfen Sie ihren Ablauf und schauen, wann die Sendungsnummer bei der Bestellung hinterlegt ist.&#x20;

Überprüfen Sie anschließend ihre [Plugin Einstellungen](#plugin_einstellungen). Unter: *Status Einstellungen* legen Sie erst einmal fest ob der Liefer- oder Bestellstatus für die Übermittlung des Versands herangezogen werden soll. In den weiteren Einstellungen wählen Sie den genauen Status aus.&#x20;

**Beispiel:**\
In den Plugin Einstellungen haben Sie den *Lieferstatus gewählt* und dieser muss auf: *Versandt* stehen.&#x20;

Für alle Marktplatz Bestellungen die ab jetzt den *Lieferstatus: Versendet* haben, bekommt das System die Information: Bestellung versendet > Versandstatus an Marktplätze mitteilen. Ist in diesem Stadium die Sendungsnummer noch nicht bei den Bestellungen eingetragen, wird keine Sendungsnummer an die Marktplätze übertragen.

</details>

<details>

<summary>Beim Import der Bestellungen erscheint nicht der Produktname aus dem Shop?</summary>

Bei dem Import der Bestellungen wird versucht, anhand der Produktnummer, eine Verbindung herzustellen. Die Produktnummer muss dafür im Marktplatz hinterlegt sein. Im Allgemeinen wird das relevante Feld im Marktplatz: *SKU, Bestandseinheit, Artikel- oder Produktnummer des Händlers* benannt.

**Klappt die Identifizierung** des Produktes wird der Produkttitel von Shopware verwendet und der Lagerbestand entsprechend angepasst.

**Klappt die Identifizierung nicht**, wird der Produkttitel vom Marktplatz verwendet und nur der Lagerbestand Ihres [Standard-Produktes (Dummy Produkt)](#standard-produkt) angepasst.

Im Optimalfall sollte sich der Lagerbestand Ihres [Standard-Produktes](#standard-produkt) also nie ändern.

</details>


---

# 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/bestellverwaltung-+-gprs.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.