# Galaxus Bestellimport

## Installation und Deinstallation

### Installation

{% hint style="info" %}
Wichtig: Bitte beachten Sie, dass für die Verwendung dieses Plugin folgendes Plugins einmalig installiert und aktiviert sein muss:  "[Marktplatz Bestellverwaltung - z.B. für Amazon, eBay usw. | Pro](https://store.shopware.com/cbax895325672158/marktplatz-bestellverwaltung-z.b.-fuer-amazon-ebay-usw.-pro.html)".
{% endhint %}

Sie können das Plugin [hier über den Shopware Community Store erwerben](https://store.shopware.com/cbax698510285663/marktplatz-galaxus-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="<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

Die Marktplatz Bestellverwaltung, der Bestellimport und der Produktexport bauen aufeinander auf und müssen in umgedrehter Reihenfolge deaktiviert bzw. deinstalliert werden.

Nach folgender Reihenfolge deaktivieren bzw. deinstallieren Sie die Plugins:

1. Produktexport deinstallieren (wenn vorhanden)
2. Bestellimport deinstallieren
3. 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 Produktexport (wenn vorhanden) und der Bestellimport deinstalliert werden, um die Bestellverwaltung deaktivieren zu können
{% endhint %}

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

Um in die Konfigurationsmaske zu gelangen, gehen Sie ins Hauptmenü auf: *Einstellungen > Erweiterungen > Marktplatz Konfigurationen > Galaxus Bestellimport*.

### Zugangsdaten

Um als Händler seine Produkte bei Galaxus anbieten zu können, muss Galaxus Sie als Händler im Händlerprogramm aufgenommen haben. Sind Sie noch nicht dabei, können Sie Ihr Interesse über das Formular bekunden.

{% file src="<https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2Fe3XTiQ2qcvn2nx6CYASD%2FGalaxus_Interessenformular_Haendlerprogramm.pdf?alt=media&token=124b9a6d-3df3-45d7-9118-4bc80e9cb77d>" %}
PDF zur Anmeldung eines Händleraccounts bei Galaxus
{% endfile %}

Galaxus öffnet seinem Onlineshops keinesfalls für jeden Anbieter, sondern arbeiten nur mit ausgewählten Händlern, welche mit der Philosophie, dem Image und Qualitätsgedanken von digitec und Galaxus einhergehen. Galaxus behält sich das Recht vor, Sie als Händler abzulehnen, wenn diese Voraussetzungen nicht gegeben sind.

Sollten Sie bereits aktiver Händler bei Galaxus sein, wenden Sie sich bitte an ihre Ansprechpartner. Er wird Ihnen die Zugangsdaten zukommen lassen.

{% hint style="info" %}
**Hinweis:** Bitte beachten Sie, dass SSH2 auf Ihrem Server installiert und eingerichtet sein muss, um eine Verbindung herstellen zu können.
{% endhint %}

| Einstellung   | Bedeutung                                   |
| ------------- | ------------------------------------------- |
| Host          | Host-Server vom FTP                         |
| Benutzername  | Benutzername von Galaxus                    |
| Passwort      | Passwort von Galaxus                        |
| System        | Auswahl ob Testsystem oder Produktiv-System |
| Hersteller-Id | Hersteller-Id von Galaxus                   |

### Import <a href="#allgemein" id="allgemein"></a>

| Einstellung                              | Bedeutung                                                            |
| ---------------------------------------- | -------------------------------------------------------------------- |
| 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

| Einstellung                                            | 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. |
| Verkaufskanal Url                                      | Wählen Sie hier eine erreichbare Url aus. Sie wird für den Export von Bildern benötigt (für Plugin: Galaxus Produktexport)                                                                                      |
| Steuersatz                                             | Welchen Steuersatz sollen die Produkte bekommen, welche nicht im Shop angelegt sind                                                                                                                             |
| Kundengruppe                                           | Es wird die Standardkundengruppe des gewählten Verkaufskanal genutzt. Eine Änderung ist nicht möglich.                                                                                                          |
| Bestellnummer für Shopware Bestellverwaltung auswählen | Soll die Marktplatz- oder eine Shopware Bestellnummer zum Generieren der Bestellung verwendet werden.                                                                                                           |

### Zuordnung Versandarten

| Einstellung                     | 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 %}

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

| Einstellung | Bedeutung             |
| ----------- | --------------------- |
| Zahlungsart | Zuordnung 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 Galaxus 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 haben zwei Möglichkeiten die Bestellungen von Galaxus in Ihr Shopware Backend zu holen.

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

Für das manuelle Abholen einer Galaxus Bestellung benötigen Sie die Bestellnummer von der Galaxus Bestellung. Um diese zu erhalten müssen Sie in Ihr Shopverzeichnis (per FTP). Gehen Sie dort auf:&#x20;

```
Shopware-Root/files/plugins/cbax_modul_order_import_galaxus/Orders/input
```

In dem Ordner "input" finden Sie XML-Dateien zu Bestellungen, welche noch nicht importiert wurde. Um Sie manuell zu importieren, kopieren Sie sich bitte die letzte Zahl.

<div data-full-width="false"><figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2F7A0VG9MDDWVAXCcXtVuM%2FPluginSW6_Galaxus-Bestellimport-001.jpg?alt=media&#x26;token=fc61e7f3-0c7f-4a44-8f45-c76ea7781b4e" alt=""><figcaption></figcaption></figure></div>

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 "Galaxus" 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%2FVxrgSXNOMlSj8VfuR9fT%2FPluginSW6_Galaxus-Bestellimport-002.jpg?alt=media&#x26;token=f4a13e70-522a-43c4-921a-1b493cfc549f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Dateien werden nach der Umwandlung nicht mehr direkt gelöscht sondern in das Unterverzeichnis */archive* verschoben und erst nach 30 Tagen automatisch gelöscht
{% endhint %}

### Automatischer Import - Cronjob einrichten <a href="#cronjob_einrichten" id="cronjob_einrichten"></a>

Für den automatischen Import benötigen Sie fünf aktive Cronjobs. Bei der Installation werden diese angelegt. Sie sind für die Abarbeitung der Aufträge verantwortlich.

* **Galaxus Dateien herunterladen** - Lädt die Dateien vom Galaxus Server auf ihren Server und löscht diese anschließend bei Galaxus
* **Galaxus Bestellungen importieren** - Importieren der Bestellungen in Shopware, in die Bestellverwaltung und die Bestellbestätigungsdatei wird erzeugen
* **Galaxus Status "Abgebrochen" setzen** - Die Datei für den abgebrochenen Status wird erzeugen
* **Galaxus Status "Versendet" setzen** - Die Datei für den versendeten Status wird erzeugen
* **Galaxus Dateien hochladen**- Lädt die Dateien (Versandbestätigung und die Bestätigung, dass die Bestellung eingelesen wurde) vom ihrem Server zu Galaxus hoch.

Wenn das Bestellaufkommen zu groß ist, dann führen Sie den Cronjob lieber per Shell aus. Richten Sie die Cronjobs auf Ihrem Webserver ein und rufen Sie folgende URL auf:

{% tabs %}
{% tab title="Ab Shopware 6.4.x (aktuelle Version)" %}

* **Galaxus Dateien herunterladen** - /api/cbax/galaxus/downloadFiles?key=123
* **Galaxus Bestellungen importieren** - /api/cbax/galaxus/importOrder?key=123
* **Galaxus Status "Abgebrochen" setzen -** /api/cbax/galaxus/canceledStatusSend?key=123
* **Galaxus Status "Versendet" setzen** - /api/cbax/Galaxus/dispatchStatusSend?key=123
* **Galaxus Dateien hochladen**- /api/cbax/galaxus/uploadFiles?key=123
  {% endtab %}

{% tab title="Bis Shopware 6.3.x (alte Version)" %}

* **Galaxus Dateien herunterladen** - /api/v{version}/cbax/galaxus/downloadFiles?key=123
* **Galaxus Bestellungen importieren** - /api/v{version}/cbax/galaxus/importOrder?key=123
* **Galaxus Status "Abgebrochen" setzen -** /api/v{version}/cbax/galaxus/canceledStatusSend?key=123
* **Galaxus Status "Versendet" setzen** - /api/v{version}/cbax/Galaxus/dispatchStatusSend?key=123
* **Galaxus Dateien hochladen**- /api/v{version}/cbax/galaxus/uploadFiles?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](https://coolbax.gitbook.io/coolbax-docs/handbuecher/bestellverwaltung-+-gprs#cronjob_einrichten) vergeben haben.
{% endhint %}

## Versandinformationen hinterlegen

Wie Sie eine Trackingnummern und den Versanddienstleister hinterlegen finden Sie im Handbuch der [Bestellverwaltung + GPSR](https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs) unter: [*Bestelldetails Shopware Bestellverwaltung*](https://coolbax.gitbook.io/coolbax-docs/handbuecher/bestellverwaltung-+-gprs#bestell_marktplatzdetail-2)

{% hint style="danger" %}
Sollte keine Trackingnummer oder kein Versanddienstleister hinterlegt sein, erhalten Sie zu der entsprechenden Bestellung eine [Fehlermeldung per E-Mail: Ungültiger/fehlender SHIPMENT\_CARRIER](#e-mail-ungultiger-fehlender-shipment_carrier)
{% endhint %}

## Fragen und Antworten

<details>

<summary>Zeilenumbrüche in den Eigenschaften entfernen</summary>

coming soon

</details>

<details>

<summary>Kryptisch E-Mail Adressen der Kunden beim Import</summary>

Galaxus übermittelt keine direkten E-Mail Adressen von Kunden. Aus diesen Grund wird vom Marktplatz automatisch eine künstliche, für jeden Kunden eindeutigem E-Mail Adresse erzeugt.

Wenn ein Kunde ein zweites Mal bestellt, wird bei gleichen Adressdaten (Firma, Vor-, Nachname, Straße, Hausnummer, PLZ und Land) die Bestellung dem Kundendatensatz der ersten Bestellung zugewiesen.

</details>

<details>

<summary>Wird das Plugin: Stücklisten von Pickware unterstützt?</summary>

Ja, dieses Plugin ist kompatibel mit dem Pickware Stücklisten Plugin

</details>

### Fehlermeldungen

<details>

<summary>E-Mail: Ungültiger/fehlender SHIPMENT_CARRIER</summary>

Erhalten Sie eine E-Mail mit dem Betreff: *Ungültiger/fehlender SHIPMENT\_CARRIER* haben Sie wahrscheinlich keine Trackingnummern oder kein Versanddienstleister bei einer Bestellung hinterlegt.&#x20;

<figure><img src="https://857504323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIjmVDBFtwlXBYXSv10K6%2Fuploads%2Fu0GdBJoSNuhjlzQMpxHu%2FGalaxusProduktexport-006.jpg?alt=media&#x26;token=e136cf04-aa6d-4982-91fe-1118895b1d49" alt=""><figcaption><p>Beispiel einer E-Mail mit der Fehlermeldung</p></figcaption></figure>

</details>