# Galaxus Produktexport ## Installation und Deinstallation ### Installation {% hint style="info" %} Um das Plugin nutzen zu können, müssen folgende Plugins aktiviert und eingerichtet sein "[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)" und "[Marktplatz Galaxus Bestellimport | Pro](https://store.shopware.com/cbax698510285663/marktplatz-galaxus-bestellimport-pro.html)" {% endhint %} Sie können das Plugin [hier über den Shopware Community Store erwerben](https://store.shopware.com/cbax665491866372/marktplatz-galaxus-produktexport-sw6.html?c=4). 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, 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 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 und 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 > Galaxus Produktexport*. ### Allgemein | Einstellung | Bedeutung | | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Dynamische Produktgruppe | Dynamische Produktgruppe auswählen, wo die Produktdaten enthalten sind, welche zu Galaxus exportiert werden sollen. Mehr zum Theme finden Sie unter: [Produkte für Galaxus festlegen](#einstellungen_produkte) | | Regel zur Preisauswahl\* (optional) |

Wenn Sie andere Preise für Galaxus nutzen möchten, müssen Sie eine eigene Preisregel über den Rule Builder erstellen und diese hier hinterlegen. Mehr zum Theme finden Sie unter: Preisregel für Galaxus anlegen

Die Bedingung des Rule Builder spielt keine Rolle und wird nicht beachtet! Der Rule Builder dient nur zur Namensgebung und Zuweisung bei den "Erweiterte Preise".

| {% hint style="warning" %} \*Wenn Sie die erweiterten Preise für ein Produkt nutzen, wird diese IMMER anstelle des Standardpreises verwendet. Die Bedingungen der Regel werden dabei aber nicht ausgewertet! {% endhint %} #### Preisregel für Galaxus anlegen Sie möchten für Galaxus andere Preise übermitteln als Sie in Ihrem Shop eingestellt haben? Das ist kein Problem. Sie können eine eigene Preisregel anlegen und diese den Plugin Einstellungen unter: *Allgemein > Regel zur Preisauswahl* zuweisen. Um eine neue Preisregel anzulegen gehen Sie ins Hauptmenü unter: *Einstellungen > Shop > Rule Builder*. Hier nutzen Sie den Butten "Regel erstellen". {% embed url="" %} Shopware Handbuch zur Einrichtung von Rule Builder {% endembed %} {% hint style="danger" %} Die **Bedingung** des Rule Builder spielt keine Rolle und **wird nicht beachtet!** Der Rule Builder dient nur zur Namensgebung und Zuweisung bei den "Erweiterte Preise". {% endhint %}

Beispiel für die Anlage eines Galaxus Rule Builder

Auswahl des Galaxus Rule Builder im Produkt

Ist die neue Preisregel erstellt, müssen Sie diese bei den entsprechenden Artikeln hinterlegen. Hierzu gehen Sie wieder in die Produktübersicht, wählen ein Produkt aus und gehen auf den Reiter "Erweiterte Preise". Hier können Sie unter "Bedingungsregel auswählen..." die gerade angelegte Preisregeln auswählen und konfigurieren {% hint style="info" %} Denken Sie auch daran, die neue Preisregel in den Plugin Einstellungen unter: Allgemein > Regel zur Preisauswahl zu hinterlegen! {% endhint %} #### Produkte für Galaxus festlegen Um Produkte an Galaxus zu exportieren, müssen Sie eine dynamische Produktgruppe anlegen. Hierfür gehen Sie auf: *Katalog > Dynamische Produktgruppen*. Alle wichtigen Informationen zur Anlage einer Dynamische Produktgruppen erhalten Sie in der Dokumentation von Shopware: {% embed url="" %} Shopware Handbuch zur Einrichtung von Dynamische Produktgruppen {% endembed %} Ihre angelegte Produktgruppe müssen Sie in der Konfiguration des Plugins unter dem Punkt: *Allgemein > Dynamische Produktgruppe* auswählen und speichern. Im Anschluss haben Sie die Möglichkeit, über den Button "Produktexport starten", den Export manuell zu starten. {% hint style="info" %} Denken Sie auch daran, die neue Preisregel in den Plugin Einstellungen unter: *Allgemein > Dynamische Produktgruppe* zu hinterlegen! {% endhint %} ### Fehler-Log-Einstellungen {% hint style="warning" %} Logs sollten nur für die Problemsuche verwendet werden und im Standard nicht aktiviert sein! {% endhint %} | Einstellung | Bedeutung | | ------------------------------------------------------------------- | ------------------------------------------------------------------- | | Über HTML in der Beschreibung benachrichtigen\* | Eintrag im Logbuch, wenn HTML in der Produktbeschreibung vorkommt. | | Über Produkt-Beschreibungen mit über 4000 Zeichen benachrichtigen\* | Eintrag im Logbuch, wenn die Beschreibung über 4000 Zeichen enthält | | Log über fehlende Hersteller erzeugen | Eintrag im Logbuch, wenn Hersteller bei Produkten fehlen. | | Log über fehlende Herstellernummern erzeugen | Eintrag im Logbuch, wenn Herstellernummern bei Produkten fehlen. | #### **Vorgaben von Galaxus** * Es dürfen keine HTML Elemente in der Produktbeschreibung vorkommen * Die Beschreibung darf nicht länger als 4000 Zeichen lang sein * Hersteller und die Herstellernummer dürfen im Feed nicht fehlen Zu lange Beschreibungen sowie HTML-Elemente werden automatisch gefiltert. Um die Anforderungen für Galaxus zu erfüllen, müssen unter anderem diese vier Kriterien beachtet werden. Möchten Sie über solche Fehler in Ihrem Feed informiert werden? Dann aktivieren Sie bitte diese Einstellung. ### Experteneinstellung In den Experteneinstellungen finden Sie drei Feeds. Die Dateien werden direkt nach der Generierung zu Galaxus hochgeladen und bleiben als Kopie im Verzeichnis: *files/export* auf ihrem FTP. | Spaltenname | Bedeutung | | ----------------------------------------- | ----------------------------------------------------------- | | Feed | Name des Feed bzw. Bezeichnung seines Inhalt | | [Generierungsstatus](#generierungsstatus) | Anzeige des aktuellen Status der Generierung | | Letzte Generierung | Anzeige der letzten Generierung in Tag und Uhrzeit | | Generierungsintervall (in s) | Anzeige des Intervall der Generierungen. Angabe in Sekunden | Über den Button: *Cronjob Generierung neustarten* können Sie den Cronjob manuell starten z. B. wenn Dateien nicht richtig verarbeitet wurden und hängen geblieben sind. Er setzt nicht den Zeitpunkt der letzte Feed-Erzeugung zurück. Hierfür nutzen Sie den Button: [Export-Datei jetzt erzeugen](#produktexport) in den Feed Einstellungen. #### Generierungsstatus Es gibt drei Status mit folgender Bedeutung: * grüner Haken: Feed wurde erfolgreich generiert * Datei wird aktuell erstellt: Feed wird aktuell generiert * rotes Kreuz: Ein Fehler ist bei der Generierung aufgetreten {% hint style="warning" %} Wenn der Generierungsstatus zu lange (1 Stunde aufwärts) auf "Datei wird aktuell erstellt" steht oder beim Bearbeiten der Experteneinstellungen ein Fehler auftritt, dann bitte Cronjobs neustarten! {% endhint %} ## Feed bearbeiten Sie haben die Möglichkeit, die Feeds individuell anzupassen. Hierzu müssen Sie am Ende der Tabelle ([Experteneinstellung](#experteneinstellung)) auf die drei Punkte klicken und auf: *Bearbeiten* klicken. ### Allgemein Hier finden Sie die Grundlegenden Einstellungen zu den Feeds. Nicht alle Einstellungen sind in jedem Feed enthalten. #### Grundeinstellung | Einstellung | Bedeutung | | ---------------------- | --------------------------------------------------------------------- | | Default Template laden | Zurücksetzen des [Template](#template) auf den ursprünglichen Zustand | {% hint style="warning" %} Laden Sie das Default Template ebenfalls neu, wenn ein Plugin Update eingespielt wurde, welches Änderungen im Feed beinhaltete. Die Änderungen werden erst mit dem neu laden des Default Template aktualisiert! {% endhint %} #### Storefront-Verkaufskanal | Einstellung | Bedeutung | | ----------- | ------------------- | | Währung | Auswahl der Währung | {% hint style="info" %} Die Währung muss dem Verkaufskanal zugewiesen sein, welchen Sie bei der Einrichtung des Plugins: *Galaxus Bestellimport* ([Plugin Einstellungen > Zuordnung Allgemein](/coolbax-docs/handbuecher/marktplaetze/galaxus-bestellimport.md#zuordnung-allgemein)) ausgewählt haben. {% endhint %} #### Produktexport | Einstellung | Bedeutung | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | Generierungsintervall | Bestimmen Sie, wie schnell der Feed neu generiert werden soll. Nach jeder Generierung wird er automatisch zu Galaxus hochgeladen. | | Export-Datei jetzt erzeugen | Führen Sie die Generierung manuell durch. | {% hint style="info" %} Folgende Generierungsintervalle werden für die Dateien empfohlen: * Lagerabgleich: alle 30 Minuten * Stammdaten: 1x am Tag * Variantendaten: alle 12 Stunden {% endhint %} #### API-Zugang | Einstellung | Bedeutung | | ----------- | ----------------------------------------------------- | | Export-URL | Angabe der URL, mit dem Sie den Feed ausgeben können. | {% hint style="info" %} Export-URLs werden pro Verkaufskanal erstellt. {% endhint %} ### Template {% hint style="warning" %} Anpassungen bitte nur mit dem nötigen Wissen über Feeds durchführen. {% endhint %} Sie können die Templates individuell anpassen. Sollten Sie Probleme bekommen, können Sie jederzeit auf das Default Template zurückgreifen. Nutzen Sie hierfür den Button: Default Template laden im Tap: [Allgemein > Grundeinstellungen](#grundeinstellung). {% hint style="info" %} Bitte beachten, dass eventuell im Hintergrund Log-Einträge erstellt werden (z. B. herausgefilterte Produkte ohne Herstellernummer) {% endhint %} Die Beschreibung für die einzelnen Spalten der Feeds können Sie sich hier herunterladen: {% file src="/files/kBCf6xqNNpfvbPOYfJ1S" %} Beschreibung des Lagerbestand Feed {% endfile %} {% file src="/files/HSucgzSVmSZcCfdKp7iL" %} Beschreibung des Stammdaten Feed {% endfile %} {% file src="/files/OYig96YZVmqUVj0nQnDp" %} Beschreibung des Variantendaten Feed {% endfile %} #### Probleme und Lösungen für die Bearbeitung der Feeds
Entfernung von Zeilenumbrüche in den Produkteigenschaften im Spezifikationen-Feed Führen Sie folgenden Befehl in der Datenbank aus: ``` Update `property_group_option_translation` SET name = REPLACE(REPLACE(name, char(10), char(32)), char(13), char(32)) ``` Verwenden Sie ggf. eine WHERE – Bedingung, um eine Teilmenge der Daten zu korrigieren: ``` WHERE `name` LIKE '%spanpl%' ```
## Zuweisung der Produktdaten {% hint style="info" %} Eigene Preise für Galaxus pflegen Sie über "Erweiterte Preise" bei den Produkten. Hierzu empfehlen wir einen eigenen Rule Builder anzulegen. Weiteren Informationen finden Sie unter: [Preisregel für Galaxus anlegen](#einstellungen_preisregel). {% endhint %} In den Produktdetails unter den Reiter: *Spezifikation > Galaxus Produkt Export* finden Sie neue Einstellungen für die Bereitstellung von Informationen für den Produktfeed von Galaxus. | Allgemein | | | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Titel | Optimieren Sie hier ihre Produktnamen für Galaxus. Ist dieses Feld nicht ausgefüllt, wird der eigentliche Artikelname verwendet. | | Beschreibung | Wie beim Titel, kann auch die Beschreibung für Galaxus abgeändert werden. Bleibt das Feld leer, wird die Shop Beschreibung verwendet. | | Individuellen Preis für dieses Produkt festlegen (überschreibt Preisregeln) | Legen Sie einen individuellen Preis für dieses Produkt fest. Die Preisregeln werden somit außer Kraft gesetzt. | | Mindestbestellmenge | Wie viele Stück müssen mindestens bestellt werden? | | Versandart | Wie wird das Produkt versendet? | | Ursprungsland | Herkunftsland des Produktes | | TaresCode | Schweizer Zolltarifnummer (TARES) | | TaricCode | Warencode (TARIC) für den EU-Raum | | Kategorie | Ist ein Produkt in mehreren Artikel vorhanden, können Sie eine Kategorie explizit bestimmen, welche für die Übertragung genutzt wird. | | Aus den Eigenschaften einzelne auswählen, die an Galaxus übertragen werden sollen | Mit Aktivierung können Sie entscheiden, welche Eigenschaften zu Galaxus übertragen werden sollen | | Eigenschaften |

Wählen Sie hier aus, welche Eigenschaften übertragen werden sollen.

Die Einstellung: Aus den Eigenschaften einzelne auswählen, die an Galaxus übertragen werden sollen muss aktiv sein.

| | Nachbestellte Menge | Geben Sie hier die Menge an, welche für das Produkt nachbestellt wurde. | | Produktionszeit in Tagen\* |

Anzahl der Tage, die für die Produktion der entsprechenden Menge gebraucht wird.

\* dieses Feld müssen nur Produzenten ausfüllen keine Händler

| | Produzierte Menge\* |

Menge, die in der angegeben Produktionszeit hergestellt wird.

\* dieses Feld müssen nur Produzenten ausfüllen keine Händler

| Sie können die *Galaxus Produkt Export* über *Moduseinstellungen* ein- und ausblenden. Die Einstellung befindet sich am rechten Bildschirmrand:

Moduseinstellungen mit der Option: Galaxus Produkt Export

## Fragen und Antworten
Bei der Aktivierung des Plugins erscheint eine Fehlermeldung? Das Plugin setzt auf den [Galaxus Bestellimport](/coolbax-docs/handbuecher/marktplaetze/galaxus-bestellimport.md) auf. Bitte überprüfen Sie, ob dort alle Einstellungen konfiguriert sind, bevor Sie den Galaxus Produktexport aktivieren.
Wird das Plugin: Stücklisten von Pickware unterstützt? Ja, dieses Plugin ist kompatibel mit dem Pickware Stücklisten Plugin
Wie bzw. wo kann ich einen Feed aufrufen/herunterladen? Um einen Feed aufzurufen bzw. herunter zu laden, haben Sie zwei Möglichkeiten. **FTP:** Shopware-Root/files/export/ **Backend:** Galaxux Produktexport Konfiguration > Feed aus Experteneinstellungen auswählen (z.B. Coolbax Galaxus Stammdaten) > API-Zugang > Export-URL kopieren und im neuen Tap aufrufen
{% hint style="warning" %} **Beachten Sie, dass der Feed bereits erstellt worden sein muss.** Sollten Sie keine Datei auf den FTP finden bzw. eine Fehlermeldung beim Aufruf über das Backend erhalten, gehen Sie wie folgt vor:\ \ Galaxux Produktexport Konfiguration > Feed aus Experteneinstellungen auswählen (z.B. Coolbax Galaxus Stammdaten) > Produktexport > Button: "Export-Datei jetzt erzeugen" nutzen {% endhint %}
### Fehlermeldungen
"... : SalesChannelDomain in Import Configuration missing" In der Konfiguration des Galaxus Bestellimport wurde kein Verkaufskanal zugewiesen.
--- # 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/galaxus-produktexport.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.