Import/Export¶
Über den Menüpunkt Artikel > Import/Export können neben dem Export zu Preis-Suchmaschinen und -Portalen auch reguläre CSV Exporte nach eigenen Profilen vorgenommen und Importe durchgeführt werden.
Hinweis
Exporte und Importe sind auf die Dateiformate .csv bzw. .txt beschränkt. Hierbei muss immer der Zeichensatz UTF-8 ohne BOM (BOM steht für Byte Order Mark) verwendet werden. Der Einsatz anderer Zeichencodierungen kann zu Problemen beim Import oder fehlerhaften Einträgen in der Datenbank führen.
Die einzelnen Bereiche können über die Reiter Artikelexport, Preis-Portal und Import ausgewählt werden.
Export¶
Über die Reiter Artikelexport und Preis-Portal können Artikel aus dem Shop heraus exportiert werden. In den meisten Fällen werden die Artikel in eine sogenannte CSV-Datei geschrieben, die mit einem Tabellenkalkulationsprogramm geöffnet und bearbeitet werden kann.
Hinweis
CSV (Character Separated Values) steht für zeichengetrennte Werte. Für CSV-Dateien besteht kein einheitliches Format, da das Trennzeichen nicht innerhalb der Spaltentexte vorkommen darf und CSV-Dateien für eine Vielzahl von Anwendungszwecken genutzt werden. Da auch Spalten-Namen nicht einheitlich normiert sind, können sich CSV-Dateien von zwei verschiedenen Programmen grundlegend voneinander unterscheiden.
Das Trennzeichen und das Texterkennungszeichen für den Export kannst du unter Artikel > Import/Export konfigurieren, wenn du das Profil bearbeitest. Für den Import können beide Zeichen im Reiter Import festgelegt werden. Wenn keine Änderungen vorgenommen wurden, werden Exporte mit einer Pipe (|,Senkrechtstrich) als Trennzeichen und einem doppelten Anführungszeichen (") als Texttrenner/Texterkennungszeichen angelegt und Importe anhand derselben Einstellungen vorgenommen.
Exporte und Importe sind auf die Dateiformate .csv bzw. .txt beschränkt. Hierbei muss immer der Zeichensatz UTF-8 ohne BOM (BOM steht für Byte Order Mark) verwendet werden.
Wenn du den Menüpunkt Artikel > Import/Export das erste Mal aufrufst, findest du im Reiter Artikelexport das Standard-Export-Profil [Gambio] Artikelexport. Über die Profile werden die Einstellungen für den Export verwaltet. Du kannst beliebig viele Profile für unterschiedliche Exporte anlegen und diese ganz nach deinen Wünschen anpassen. Zunächst gehen wir von einem Export aller Artikel aus.
Du kannst wahlweise das Standard-Profil bearbeiten, um deine Einstellungen vorzunehmen oder durch einen Klick auf das Plus-Zeichen eine Kopie dieses Profils anlegen. Wenn du das Profil zuerst kopierst, hast du immer eine Sicherung der Original-Konfiguration vorliegen.
Um das Profil zu konfigurieren klicke bitte auf das Bleistift-Symbol, es öffnet sich das gewählte Profil mit geöffnetem Reiter Einstellungen.
Hinweis
Wenn du ein vorgegebenes Profil bearbeitest, sind bestimmte Einstellungsmöglichkeiten standardmäßig ausgegraut und lassen sich nicht anpassen. Wenn du diese Einstellungen ändern möchtest, empfehlen wir eine Kopie des Profils anzulegen, indem du in der Übersicht auf das grüne Pluszeichen klickst.
Hier kannst du zunächst den Namen des Profils und den Dateinamen deiner Export-Datei anpassen. Wichtig ist, dass die Dateiendung .csv hierbei erhalten bleibt. Die Einstellungen für Trennzeichen und Texttrenner können im Normalfall beibehalten werden. Wenn du Eigenschaften verwendest und die zugewiesenen Eigenschaften-Kombinationen mit exportieren möchtest, setze bitte den Haken bei Eigenschaften. Wenn du Änderungen vorgenommem hast, müssen diese mit einem Klick auf Speichern bestätigt werden, bevor du den aktuellen Reiter verlässt.
Wechsele nun in den Reiter Kategorien. Bevor du einen Export vornehmen kannst, müssen die Kategorien ausgewählt werden, aus denen die Artikel exportiert werden sollen. Setze hierzu hinter die jeweiligen Kategorien und Unterkategorien die Haken. Wahlweise kannst du auch über die oberste Checkbox Alle auswählen / Auswahl aufheben alle Kategorien auf ein Mal anhaken. Bestätige auch diese Änderung mit einem Klick auf Speichern.
Wechsele abschließend in den Reiter Spalten. Hier sollten nun in der Vorschau-Ansicht einige deiner Artikel angezeigt werden. Wenn du zuvor den Haken für Eigenschaften gesetzt hast, müssen nun die einzelnen Felder festgelegt werden. Wenn du keine Eigenschaften-Kombinationen exportieren möchtest, kannst du diesen Schritt einfach überspringen.
Scrolle hierzu mit dem oberen Scrollbalken ganz nach rechts, sodass die graue Box Eigenschaften in der oberen Hälfte des Fensters angezeigt wird und klicke darauf. Wähle im Bereich Eigenschaftsauswahl die Eigenschaften aus, dessen Kombinationen du mit exportieren willst. Um mehrere Eigenschaften auszuwählen, kannst du wahlweise die Strg- oder Shift-Taste gedrückt halten, während du diese anklickst. Wiederhole das Gleiche im Feld Kombinationsdaten, im Normalfall sollten hier alle Einträge ausgewählt werden. Bestätige die Auswahl mit einem Klick auf OK und speichere die Änderung.

Die Grundeinstellungen, die vor dem ersten Export mit einem neuen Profil vorgenommen werden sollten, sind nun abgeschlossen. Verlasse die Profilansicht mit einem Klick auf Schließen. Über die Schaltflächen Profil exportieren bzw. Exportieren und herunterladen kannst du den Export durchführen.

Eine genaue Beschreibung der möglichen Einstellungen findest du in den nachfolgenden Abschnitten.
CSV-Artikelexport¶
Die Export-Profile sind in einer Tabelle aufgeführt, in der Profilname, Dateiname, Cronjob und Letzter Export aufgelistet sind. Vor dem ersten Export wird der zugehörige Dateiname grau angezeigt, die Datei wurde noch nicht auf dem Server angelegt. Für jeden Eintrag stehen der Reihe nach die Schaltflächen Profil exportieren, Exportieren und herunterladen, Profil bearbeiten, Profil löschen und Profil kopieren zur Verfügung. Standardmäßig ist hier das Profil [Gambio] Artikelexport vorhanden.
![]()
Profil exportieren¶
Beim Klick auf die Schaltfläche Profil exportieren werden die Artikel nach den Einstellungen im jeweiligen Profil (siehe Profil bearbeiten) in die angegebene Datei im Verzeichnis export exportiert. Hierbei wird ein Dialogfenster angezeigt, in dem der aktuelle Fortschritt des Exportes angezeigt wird. Über einen Klick auf die Schaltfläche Abbrechen kann der Export vorzeitig beendet werden. Nach Abschluss des Exports kann der Dialog über einen Klick auf Schließen verlassen werden.
Profil exportieren und herunterladen¶
Diese Funktion unterscheidet sich nur unwesentlich von dem vorherigen Export. Nach Abschluss des Exportvorganges kann die Datei auf den lokalen Rechner heruntergeladen werden.
Profil bearbeiten¶

Über einen Klick auf Profil bearbeiten können die Einstellungen zu dem jeweiligen Profil aufgerufen werden. Es öffnet sich ein Fenster, das standardmäßig mit dem ausgewählten Reiter Einstellungen angezeigt wird. Weitere Reiter sind Spalten und Kategorien. Es stehen die Eingabefelder
- Profilname: der Name des aktuellen Profils
- Dateiname: der Dateiname der Exportdatei
- Trennzeichen: das verwendete Trennzeichen (standardmäßig Pipe: |)
- Texttrenner: der verwendete Texttrenner (standardmäßig doppeltes Anführungszeichen ")
zur Verfügung.
Darunter befinden sich Checkboxen für Eigenschaften und Automatischer Export. Wird die Box Eigenschaften angehakt, können die dem Artikel zugeordneten Eigenschaften-Kombinationen mit exportiert werden.
Hinweis
Die Einstellungen zu den einzelnen Eigenschaften können im Reiter Spalten vorgenommen werden, wenn der Haken gesetzt ist. Dort erscheint dann die Spalte Eigenschaften. Details hierzu findest du im Abschnitt Spalten dieses Kapitels.
Ist der Haken für Automatischer Export gesetzt, erscheinen die Optionen zum Einrichten des automatischen Exports über einen sogenannten Cronjob. Es können wahlweise die verschiedenen Wochentage an- bzw. abgewählt werden, für die eine Startzeit (jeweils zur vollen Stunde) aus dem Dropdown-Menü ausgewählt werden kann oder es kann ein Intervall von einer bis 12 Stunden gewählt werden. Ein so eingestellter automatischer Export wird durch ein Uhr-Symbol in der Spalte Cronjob angezeigt.
Spalten¶

Die Anzeige für den Reiter Spalten ist in zwei Teile gegliedert. Der obere Bereich stellt die Spalten der Export-Datei in der Art eines Bücherregals dar, über die Scrollleiste können die "Bücher" hin und her geschoben werden. Mit einem Klick auf den "Buchrücken" kann die Spalte bearbeitet werden. Der obere Teil des "Buchrückens" ist mit einem Pfeilkreuz und einem x versehen. Über das Pfeilkreuz kann die Spalte mit Klicken und Halten der linken Maustaste verschoben werden. Mit einem Klick auf das x kann die Spalte gelöscht werden, dies muss über eine Abfrage bestätigt werden. Über Spalte hinzufügen wird eine neue Spalte am Ende der Tabelle angefügt.
Beim Bearbeiten und Anlegen von Spalten sind folgende Eingaben möglich:
- Spaltenname
- Spalteninhalt
- Standardwert
Der Spalteninhalt entspricht einer Variable (Platzhalter für Dateneintrag) im Shop. Diese kann über das Dropdown-Menü Verfügbare Variablen festgelegt werden. Hier werden alle Möglichkeiten mit ihrer Beschreibung aufgelistet. Bitte beachte, dass diese ausschließlich aus Artikeln und Kategorien bezogen werden! Nach Auswahl des Eintrags kann der zugehörige Variablenname mit Klick auf Hinzufügen eingetragen werden. Bestätige die Änderung mit Klick auf OK, über Abbrechen werden die Änderungen verworfen.
Wenn Eigenschaften beim Export berücksichtigt werden, steht als letzter Eintrag die Spalte Eigenschaften zur Verfügung. Die einzelnen Eigenschaften können im Bereich Eigenschaftenauswahl durch Anklicken ausgewählt werden.
Hinweis
Wir empfehlen alle Eigenschaften und alle Kombinationsdaten zu exportieren.

Die Kombinationen im Artikel werden über die Kombinationsdaten ausgewählt. Diese sind der Reihe nach:
- products_properties_combis_id: ID der Kombinationen pro Artikel
- combi_sort_order: die Sortierreihenfolge der Kombination
- combi_model: die Artikelnummer der Kombination
- combi_ean: die EAN der Kombination
- combi_quantity: der Lagerstand der Kombination
- combi_shipping_status_id: der zugeordnete Lieferstatus der Kombination
- combi_weight: das eingetragene Gewicht der Kombination
- combi_price: der eingetragene Preis der Kombination
-
combi_price_type: wird der eingetragene Aufpreis verwendet?
calc = Preis aus Eigenschaften berechnen
fix = Kombinationsfestpreis
-
combi_vpe_id: die Verpackungseinheit der Kombination
- combi_vpe_value: der Wert im Bezug auf den Grundpreis
Das untere Drittel dieses Fensters dient zur Vorschau der Export-Datei.
Hinweis
Diese Ansicht wird standardmäßig leer angezeigt. Es müssen zunächst die Kategorien im Reiter Kategorien ausgewählt werden, bevor hier eine Vorschau erfolgt.
Kategorien¶
Über Auswahl des Reiters Kategorien können die Kategorien für den Export ausgewählt bzw. eingeschränkt werden. Setze hierzu den Haken vor die Kategorien, dessen Artikel du exportieren möchtest. Über einen Klick auf das Ordner-Symbol können die Unterkategorien der jeweiligen Kategorie angezeigt werden.

Durch Setzen des Hakens Alle auswählen / Auswahl aufheben können wahlweise alle Kategorien gewählt bzw. vom Export ausgeschlossen werden.
Wenn du Änderungen in einem Reiter vorgenommen hast und in einen anderen Reiter wechselst, werden diese nicht übernommen. Vor dem Wechsel wirst du in einem Dialog gefragt, ob die gemachten Änderungen verworfen werden sollen. Klicke auf Verwerfen wenn die Änderungen nicht übernommen werden sollen, du wechselst anschließend in den ausgewählten Reiter. Mit Klick auf Abbrechen gelangst du wieder in den Reiter zurück.
Für jeden Reiter kannst du die Änderungen mit Klick auf Speichern sichern. Mit Klick auf Schließen wird die Bearbeitung des Profils abgebrochen. Bei ungespeicherten Änderungen findet erneut eine Abfrage zum Verwerfen der Änderungen statt.
Profil löschen¶
Mit einem Klick auf das rote x kann ein angelegtes Profil gelöscht werden. Es erscheint ein Abfragedialog, in dem das Entfernen des Profils bestätigt werden muss. Das Löschen des Profils [Gambio] Artikelexport ist nicht möglich. Das x wird in diesem Fall halbtransparent angezeigt.
Profil kopieren¶
Über das grüne Plus-Zeichen kann ein Profil kopiert werden. Dies geschieht ohne gesonderte Abfrage, das Profil wird mit dem Zusatz Kopie im Profilnamen aufgeführt.
Funktionen der Profilseite¶
Unterhalb der Auflistung kann über die Schaltfläche Profil hinzufügen ein neues Profil erzeugt werden. Es stehen die gleichen Konfigurationsmöglichkeiten zur Verfügung wie im Reiter Einstellungen für die Funktion Profil bearbeiten.
Ist für mindestens ein Profil der automatische Export eingestellt, werden die Schaltflächen Cronjob fortsetzen und Cronjob-URL anzeigen eingeblendet. Die automatischen Exporte werden im Status pausiert angelegt. Über Cronjob fortsetzen werden die eingestellten Cronjobs aktiviert. Dies ist dadurch zu erkennen, dass die Uhren-Symbole in der Spalte Cronjob nicht mehr halbtransparent angezeigt werden. Wenn der Mauszeiger über das Symbol bewegt wird, erscheinen Datum und Uhrzeit des nächstens Exports.

Ein aktiver automatischer Export kann über Cronjob abbrechen oder Cronjob pausieren wieder inaktiv geschaltet werden.
Hierbei ist zu beachten, dass beim Abbrechen die CSV-Datei eines teilweise vorgenommenen Exports gelöscht wird. Ist der Cronjob pausiert, kann der Export über Cronjob fortsetzen wieder aufgenommen werden. Die zugehörige Datei wird beibehalten und weiter beschrieben.
Über Cronjob-URL anzeigen wird die URL zum Ausführen des Exports angezeigt. Diese URL muss in einen neu eingerichteten Cronjob bei deinem Hosting-Provider eingetragen werden. Weitere Details zu den Einstellungen erhältst du, wenn du auf das grüne Info-Symbol am Ende der Cronjob-URL klickst.
Preis-Portal¶
Artikel-Exporte zu Preisportalen können über den Reiter Preis-Portal vorgenommen werden. Die Export-Profile sind in einer Tabelle aufgeführt, in der Profilname, Dateiname, Cronjob und Letzter Export aufgelistet sind. Vor dem ersten Export wird der zugehörige Dateiname grau angezeigt, die Datei wurde noch nicht auf dem Server angelegt. Für jeden Eintrag stehen von links nach rechts die Schaltflächen Profil exportieren, Exportieren und herunterladen , Profil bearbeiten , Profil löschen und Profil kopieren zur Verfügung.


Profil exportieren¶
Beim Klick auf die Schaltfläche Profil exportieren werden die Artikel nach den Einstellungen im jeweiligen Profil (siehe Profil bearbeiten) in die angegebene Datei im Verzeichnis export exportiert. Hierbei wird ein Dialogfenster angezeigt, in dem der aktuelle Fortschritt des Exportes angezeigt wird. Über Klick auf die Schaltfläche Abbrechen kann der Export vorzeitig beendet werden. Nach Abschluss des Exports kann der Dialog über Klick auf Schließen verlassen werden.
Profil exportieren und herunterladen¶
Diese Funktion unterscheidet sich nur unwesentlich von dem vorherigen Export. Nach Abschluss des Exportvorganges kann die Datei auf den lokalen Rechner heruntergeladen werden.
Profil bearbeiten¶
Über einen Klick auf Profil bearbeiten können die Einstellungen zu dem jeweiligen Profil aufgerufen werden. Es öffnet sich ein Fenster, das standardmäßig mit dem ausgewählten Reiter Einstellungen angezeigt wird. Weitere Reiter sind Spalten, Kollektivspalten und Kategorien. Zudem wird in der oberen Leiste der Name des ausgewählten Profils angegeben.
Hinweis
Je nach Profil können die änderbaren Einstellungen abweichen. Wenn ein Teil der Konfiguration nicht geändert werden kann, wird dieser ausgegraut dargestellt. Um alle Einstellungen anpassen zu können, empfehlen wir das gewünschte Profil zu kopieren und die Kopie zu bearbeiten.
Einstellungen¶

Es stehen die folgenden Bereiche zur Verfügung:
| Feldname | Beschreibung |
|---|---|
| Profilname | der Name des Profils |
| Dateiname | der Name der Exportdatei |
| Trennzeichen | Spalten-Trennzeichen |
| Texttrenner | Texttrenner-Zeichen |
| Währung | zu exportierende Währung |
| Sprache | die zu verwendende Sprache |
| Anzahl zusätzlicher Bilder | wie viele zusätzliche Bilder sollen (neben dem ersten bzw. Haupt-Artikelbild) exportiert werden? |
| Kundengruppe | die Kundengruppe, dessen Preise verwendet werden sollen. Wähle Gast aus, wenn du für die gewünschte Kundengruppe nicht in allen Artikeln Kundengruppenpreise hinterlegt hast! |
| Kampagne | angelegte Kampagne, die verwendet werden soll |
| Versandkostenfrei ab | ab welchem Warenwert sollen deine Artikel versandkostenfrei versendet werden? |
| Mindestbestand | Gib hier ein, wie oft ein Artikel auf Lager sein muss, damit er beim Export berücksichtigt wird |
| Attribute | Attribute berücksichtigen (werden als eigenständige Artikel exportiert) |
| Eigenschaften | Eigenschaften berücksichtigen (werden als eigenständige Artikel exportiert) |
| Eigenschaftsbild anstelle des Artikelbildes verwenden: | Das Bild der jeweiligen Eigenschaften-Kombination wird anstelle des Haupt-Artikelbilds exportiert |
| Export-URL | Aus diesem Feld kann der Link zur Export-Datei herauskopiert werden |
Hinweis
Das Feld Versandkostenfrei ab ist standardmäßig mit 0 vorbelegt. Wird hier keine Änderung vorgenommen, werden eingetragene Versandkosten im Artikel nicht berücksichtigt.
Darunter befindet sich die Checkbox Automatischer Export. Ist der Haken gesetzt, erscheinen die Optionen zum Einrichten des automatischen Exports über einen sogenannten Cronjob. Es können wahlweise die verschiedenen Wochentage an- bzw. abgewählt werden, für die eine Startzeit (jeweils zur vollen Stunde) aus dem Dropdown-Menü ausgewählt werden kann oder es kann ein Intervall von einer bis 12 Stunden gewählt werden. Ein so eingestellter automatischer Export wird durch ein Uhr-Symbol in der Spalte Cronjob angezeigt.
Spalten¶
Die Anzeige für den Reiter Spalten ist in zwei Teile gegliedert. Der obere Bereich stellt die Spalten der Export-Datei in der Art eines Bücherregals dar, über die Scrollleiste können die "Bücher" hin und her geschoben werden. Mit einem Klick auf den "Buchrücken" kann die Spalte bearbeitet werden. Der obere Teil des "Buchrückens" ist mit einem Pfeilkreuz und einem x versehen. Über das Pfeilkreuz kann die Spalte mit Klicken und Halten der linken Maustaste verschoben werden. Mit einem Klick auf das x kann die Spalte gelöscht werden, dies muss über eine Abfrage bestätigt werden. Über Spalte hinzufügen wird eine neue Spalte am Ende der Tabelle angefügt.

Beim Bearbeiten und Anlegen von Spalten sind folgende Eingaben möglich:
- Spaltenname
- Spalteninhalt
- Standardwert
Der Spalteninhalt entspricht einer Variable (Platzhalter für Dateneintrag) im Shop. Diese kann über das Dropdown-Menü Verfügbare Variablen festgelegt werden. Hier werden alle Möglichkeiten mit ihrer Beschreibung aufgelistet. Nach Auswahl des Eintrags kann der zugehörige Variablenname mit Klick auf Hinzufügen eingetragen werden. Bestätige die Änderung mit Klick auf OK, über Abbrechen werden die Änderungen verworfen.
Hinweis
Im Bereich Preis-Portal sind andere Variablen auswählbar als beim regulären Export. Bei Bedarf kann jedoch eine Variable von dort kopiert und als Spalteninhalt für ein Export- Profil aus dem Preis-Portal eingefügt werden, um auch diese Inhalte zu exportieren.
Das untere Drittel dieses Fensters dient zur Vorschau der Export-Datei.
Hinweis
Diese Ansicht wird standardmäßig leer angezeigt. Es müssen zunächst die Kategorien im Reiter Kategorien ausgewählt werden, bevor hier eine Vorschau erfolgt.
Kollektivspalten¶
Kollektivspalten dienen der Selektierung von Werten aus verschiedenen Quellen in einer Spalte. Dabei können mehrere Eigenschafts-, Attributs- und/oder Zusatzfeldnamen angegeben werden, aus denen der entsprechende Wert ausgewählt wird.

- Spaltenname: Der Spaltenname entspricht der Überschrift in der exportierten CSV-Datei.
- _Eigenschaften/Attribute/Zusatzfelde_r: Hier kannst du die Namen der Eigenschaften, Attribute und/oder Zusatzfelder, in Form einer ";"-separierten Liste, eintragen, aus denen der Wert gewählt werden soll (z.B. Farbe;Lackfarbe;Wandfarbe).
- Standardwert: Dieser Wert wird als Spaltenwert verwendet, wenn kein passender Wert in den Eigenschaften, Attributen und Zusatzfeldern gefunden wurde.
- Eig./Attr./Zus.: Mit diesen Checkboxen kannst du wählen, in welchen Quellen die Namen gesucht werden sollen. Wenn du beispielsweise keine Attribute nutzt, empfiehlt es sich, die entsprechende Checkbox zu deaktivieren. Dies dient der Steigerung der Performanz des Exports.
Hinweis
Sollte es für die Selektierung des Spalteninhalts mehrere Treffer aus verschiedenen Quellen geben, so greift eine vorgegebene Priorisierung:
- Eigenschaften (höchste Priorität)
- Attribute
- Zusatzfelder (niedrigste Priorität)
Kategorien¶
Über Auswahl des Reiters Kategorien können die Kategorien für den Export ausgewählt bzw. eingeschränkt werden. Setze hierzu den Haken vor die Kategorien, dessen Artikel du exportieren möchtest. Über einen Klick auf das Ordner-Symbol können die Unterkategorien der jeweiligen Kategorie angezeigt werden.
Durch Setzen des Hakens Alle auswählen / Auswahl aufheben können wahlweise alle Kategorien gewählt bzw. vom Export ausgeschlossen werden.
Wenn du Änderungen in einem Reiter vorgenommen hast und in einen anderen Reiter wechselst, werden diese nicht übernommen. Vor dem Wechsel wirst du in einem Dialog gefragt, ob die gemachten Änderungen verworfen werden sollen. Klicke auf Verwerfen wenn die Änderungen nicht übernommen werden sollen, du wechselst anschließend in den ausgewählten Reiter. Mit einem Klick auf Abbrechen gelangst du wieder in den Reiter zurück.
Für jeden Reiter kannst du die Änderungen mit Klick auf Speichern sichern. Mit Klick auf Schließen wird die Bearbeitung des Profils abgebrochen. Bei ungespeicherten Änderungen findet erneut eine Abfrage zum Verwerfen der Änderungen statt.
Profil löschen¶
Mit einem Klick auf das rote x kann ein angelegtes Profil gelöscht werden. Es erscheint eine Sicherheitsabfrage, in der das Entfernen des Profils bestätigt werden muss. Das Löschen von standardmäßig angelegten Profilen ist nicht möglich. Das x wird in diesem Fall halbtransparent angezeigt.
Profil kopieren¶
Über das grüne Plus-Zeichen kann ein Profil kopiert werden. Dies geschieht ohne gesonderte Abfrage, das Profil wird mit dem Zusatz Kopie im Profilnamen aufgeführt.
Funktionen der Profilseite¶
Unterhalb der Auflistung kann über die Schaltfläche Profil hinzufügen ein neues Profil erzeugt werden. Es stehen die gleichen Konfigurationsmöglichkeiten zur Verfügung wie im Reiter Einstellungen für die Funktion Profil bearbeiten.
Ist für mindestens ein Profil der automatische Export eingestellt, werden die Schaltflächen Cronjob fortsetzen und Cronjob-URL anzeigen eingeblendet. Die automatischen Exporte werden im Status pausiert angelegt. Über Cronjob fortsetzen werden die eingestellten Cronjobs aktiviert. Dies ist dadurch zu erkennen, dass die Uhren-Symbole in der Spalte Cronjob nicht mehr halbtransparent angezeigt werden. Wenn der Mauszeiger über das Symbol bewegt wird, erscheinen Datum und Uhrzeit des nächstens Exports.
Ein aktiver automatischer Export kann über Cronjob abbrechen oder Cronjob pausieren wieder inaktiv geschaltet werden.
Hierbei ist zu beachten, dass beim Abbrechen die Export-Datei eines teilweise vorgenommenen Exports gelöscht wird. Ist der Cronjob pausiert, kann der Export über Cronjob fortsetzen wieder aufgenommen werden. Die zugehörige Datei wird beibehalten und weiter beschrieben.
Über Cronjob-URL anzeigen wird die URL zum Ausführen des Exports angezeigt. Diese URL muss in einen neu eingerichteten Cronjob bei deinem Provider eingetragen werden. Weitere Details zu den Einstellungen erhältst du, wenn du auf das grüne Info-Symbol am Ende der Cronjob-URL klickst.
Vorbereiten und Durchführen eines CSV-Exports¶
In diesem Kapitel betrachten wir Schritt für Schritt wie ein Export vorbereitet und durchgeführt wird. Hierbei verwenden wir das Standard-Profil aus dem Reiter Artikelexport, die Schritte lassen sich jedoch auch ohne Weiteres auf den Bereich Preis-Portal übertragen.
Als Beispiel nehmen wir an, dass wir Artikel aus der Kategorie Testkategorie mit den zugeordneten Eigenschaften-Kombination exportieren und hierbei den exportierten Preis von Netto auf Brutto umstellen sowie dabei das Dezimal-Trennzeichen von Punkt auf Komma ändern möchten.
Schritt 1 - Profil duplizieren¶
Es ist immer eine gute Idee, eine Kopie des Standardprofils zu verwenden, auch wenn zunächst keine Änderungen daran vorgenommen werden sollen. Da wir jedoch bestehende Spalten anpassen wollen, ist es eine Notwendigkeit.
Wir rufen also im Gambio Admin den Menüpunkt Artikel > Import/Export auf und gelangen direkt in den Abschnitt Artikelexport. Hier finden wir das Standardprofil. Über einen Klick auf das grüne Plus-Zeichen duplizieren wir das Profil.

Es wird mit einem neuen Namen in der Liste angelegt.

Schritt 2 - Profil bearbeiten¶

Über einen Klick auf das Bleistift-Symbol kann das Export-Profil bearbeitet werden. Es öffnet sich die Maske Einstellungen, hier nehmen wir folgende Änderungen vor:

- Umbenennen des Profilnamens: Artikelexport Kopie ist nicht gerade aussagekräftig. Um in absehbarer Zukunft nicht die Orientierung zu verlieren, tragen wir in das Feld Profilname einen treffenderen Namen ein.
- Anhaken der Eigenschaften: Da wir mit diesem Profil auch Eigenschaften-Kombinationen exportieren möchten, muss hier der Haken gesetzt werden. Nur so stehen uns am Ende die notwendigen Einstellugen zur Verfügung.
Bevor wir den Reiter wechseln, klicken wir auf Speichern.
Schritt 3 - Kategorien festlegen¶
Über den Reiter Kategorien legen wir fest, aus welchen Kategorien Artikel exportiert werden sollen.

Da wir in unserem Beispiel Artikel aus der Testkategorie exportieren wollen, setzen wir den entsprechenden Haken.
Auch diesen Schritt bestätigen wir mit einem Klick auf Speichern.
Schritt 4 - Spalte bearbeiten¶

Der Bereich Spalten hat eine zweigeteilte Ansicht. Oben sind die einzelnen Spalten mit ihren Namen wie Bücher in einem Regal aufgereiht. Über einen Klick auf den jeweiligen "Buchrücken" kann die zugehörige Spalte bearbeitet werden (hierzu gleich mehr).
Der Bereich darunter ist die Vorschau-Ansicht, in dem die ersten Einträge der Tabelle für jede Spalte dargestellt werden.
Hinweis
Wenn hier keine Einträge auftauchen, wurden wahrscheinlich noch keine Kategorien ausgewählt (siehe Schritt 3).
Mit den beiden horizontalen Scrollbalken (siehe rote Markierungen in der Abbildung) können beide Ansichten hin und her geschoben werden.
Eine bestehende Spalte bearbeiten
In Normalfall werden die Dezimalstellen bei Preisen und Gewichten mit einem Punkt getrennt. Wir wollen jedoch unsere Preise mit einem Komma statt einem Punkt als Dezimaltrenner exportieren. Zudem wollen wir keine Netto-Preise (wie sie standardmäßig in der Datenbank gespeichert werden) sondern Brutto-Preise exportieren.
Hinweis
Eine Auflistung der Spalten des Standardprofils mit ihrem Verwendungszweck findest du im nachfolgenden Kapitel Import dieses Handbuchs.
Zunächst suchen wir im oberen Bereich der Seite die passende Spalte p_priceNoTax:

Mit einem Klick auf den passenden "Buchrücken" öffnet sich die zugehörige Eingabemaske:

Entscheidend sind für uns das Feld Spalteninhalt und das Dropdown Verfügbare Variablen. Variablen dienen als Platzhalter für den entsprechenden Inhalt in der Datenbank. Sie werden grundsätzlich mit geschweiften Klammern angegeben, in unserem Fall {products_price}. Im unteren Bereich, der Vorschau-Ansicht, wird die zugehörige Spalte automatisch unter die Eingabemaske gerückt. Wir erkennen, dass es sich um den Netto-Preis mit einem Punkt als Dezimaltrenner handelt.
Um eine Variable zu ändern, müssen wir ihren Namen nicht händisch heraussuchen und eintragen. Stattdessen verwenden wir das Dropdown Verfügbare Variablen:

Hier suchen wir uns den passenden Eintrag heraus und klicken ihn an. Wenn man den Mauszeiger lange genug über den Eintrag hält, wird ein Tooltipp eingeblendet, der diesen genauer beschreibt.

Nachdem der Eintrag ausgewählt worden ist, kann er über die Schaltfläche Hinzufügen in das Feld Spalteninhalt eingetragen werden.

Beim Hinzufügen wird der alte Feldinhalt nicht ersetzt. Da nur der Brutto-Preis verbleiben soll, muss die alte Variable aus dem Feld Spalteninhalt gelöscht werden - dies kann natürlich auch vor dem Hinzufügen der neuen Variable erfolgen.

Nachdem die neue Variable alleine steht, wird der Brutto-Preis wie vorgesehen angezeigt. Die Änderung kann mit Klick auf OK bestätigt werden. Abschließend muss noch einmal auf Speichern geklickt werden.
Die Eigenschaften-Spalte bearbeiten
Wurde im Reiter Einstellungen der Haken für Eigenschaften gesetzt, wird eine eigene Spalte für das Bearbeiten der Eigenschaften im Export-Profil angezeigt. Sie befindet sich ganz am rechten Ende des "Bücherregals". Man muss also ganz nach rechts scrollen, damit sie angezeigt wird.


Die Eingabemaske besteht aus zwei sogenannten Multi-Select-Elementen - Eigenschaftenauswahl und Kombinationsdaten - und einem Dropdown für die beim Export zu verwendende Sprache. Es sollten grundsätzlich alle Eigenschaften und alle Kombinationsdaten ausgewählt werden. Klicke hierzu jeweils den ersten Eintrag eines Multi-Select-Elements an und klicke danach mit gedrückter Shift-Taste auf den letzten Eintrag:

Anschließend kann die Auswahl mit Ok bestätigt werden. Speichere alle Änderungen ab, bevor du den Dialog wieder schließt.
Schritt 5 - Export durchführen¶
![]()
Der Export kann über einen Klick auf das erste Icon gestartet werden.

Anschließend steht die Exportdatei über den Link in der Spalte Dateiname zum Download zur Verfügung.
Hinweis
Wir empfehlen zum Bearbeiten von CSV-Dateien das Programm LibreOffice Calc. Im nachfolgenden Kapitel findest du einen Abschnitt, der die notwendigen Schritte zum Öffnen und Speichern von CSV-Dateien mit LibreOffice Calc beschreibt.
Import¶
Über den Reiter Import können CSV-Dateien aus einem anderen Shop oder aus einer externen Quelle in den Shop importiert und die Artikel so in den Shop geladen werden.
Besonders wenn du die CSV-Datei eines Drittanbieters verwendest, muss diese vor dem Import gegebenenfalls aufbereitet werden.
Achtung
Es ist über den Artikelexport zwar möglich beliebige Spalten mit eigenen Namen anzulegen, jedoch können nur die Spalten importiert werden, die im Standard-Profil [Gambio] Artikelexport vorgegeben sind.
Um einen erfolgreichen Import durchführen zu können, sind die Spalten XTSOL sowie entweder p_id oder p_model als Pflichtangabe notwendig.
Wir empfehlen beide Spalten (p_id und p_model) in der CSV-Datei anzugeben. Bei neu angelegten Artikeln sollte das Feld p_id leer gelassen werden, der Wert wird automatisch vergeben. Eine Artikelnummer für p_model kann angegeben werden, ist aber nicht zwangsläufig notwendig.
Die Angabe p_model ist dann erforderlich, wenn ein Artikel durch einen Import aktualisiert werden soll, die p_id hierzu aber nicht bekannt ist. Umgekehrt kann die p_model leer gelassen werden, wenn die p_id (z.B. durch einen Export) bekannt ist.
Zudem sollten, um Problemen in einzelnen Shopversionen vorzubeugen, die Spalten p_shortdesc.en und p_shortdesc.de in der CSV-Datei enthalten sein. Es reicht, wenn diese mit einem Leerzeichen o.ä. befüllt sind.
Wir empfehlen als Trennzeichen | (Pipe-Symbol/senkrechter Strich, erreichbar über ALT GR und <) und Texterkennungszeichen/Texttrenner " (doppeltes Anführungszeichen) zu verwenden, wie in der Import-Maske voreingestellt.
Exporte und Importe sind auf die Dateiformate .csv bzw. .txt beschränkt. Hierbei muss immer der Zeichensatz UTF-8 ohne BOM (BOM steht für Byte Order Mark) verwendet werden. Der Einsatz anderer Zeichencodierungen kann zu Problemen beim Import oder fehlerhaften Einträgen in der Datenbank führen.
Hinweis
Beim Export von Artikeleigenschaften werden lediglich die Zuordnungen der Kombinationen zu den Artikeln durchgeführt. Durch den Import werden keine neuen Eigenschaften erzeugt. Diese müssen im Zielshop manuell angelegt und vorkonfiguriert werden.
Achtung
Wenn du in deiner Import-Datei die Spalten gm_min_order oder gm_graduated_qty verwendest, müssen hier jeweils Werte größer als 0 eingetragen werden.
Um eine CSV-Datei aufzubereiten, empfehlen wir diese mit einem Tabellenkalkulationsprogramm zu bearbeiten, bei dem es möglich ist sowohl das Trennzeichen als auch das Texterkennungszeichen bereits beim Öffnen der Datei festzulegen. Hierzu eignet sich z.B. die Tabellenkalkulation Calc aus dem quelloffenen und kostenlosen Office-Paket LibreOffice.
Wenn beide Zeichen korrekt eingetragen worden sind, wird die CSV-Datei in einer Tabellenform dargestellt, die sich relativ komfortabel bearbeiten lässt.
Aufbau des Import-Profils¶
Hinweis
Für eine Aktualisierung deiner Artikel empfehlen wir zunächst einen Export mit dem unveränderten Standardprofil vorzunehmen. Die so erzeugte Datei kann als Ausgangspunkt für die gewünschten Änderungen verwendet werden.
Passe hierbei nur die Daten an welche durch den Export geändert werden sollen und belasse die restliche Datei unverändert. Das unsachgemäße Entfernen von Spalten kann zu Problemen beim Import führen.
Damit deine CSV-Datei erfolgreich importiert werden kann, müssen die Spalten einerseits richtig benannt sein und die jeweiligen Inhalte passend zugeordnet worden sein. Eine Übersicht über die standardmäßig verfügbaren Spalten findest du in der nachfolgenden Tabelle:
| Spaltenname | Beschreibung | zugeordnete Variable |
|---|---|---|
| XTSOL | Steuerzeichen für den Beginn einer Zeile, Pflichtangabe | - |
| p_id | interne ID des Artikels; Pflichtangabe, wenn p_model nicht verwendet wird | {products_id} |
| p_model | dargestellte Artikelnummer des Artikels;Pflichtangabe, wenn p_id nicht verwendet wird | {products_model} |
| p_stock | Lagerbestand | {products_quantity} |
| p_sorting | Sortierreihenfolge innerhalb der Kategorie (siehe Kapitel Kategorien) | {products_sort} |
| p_startpage | Artikel als Empfehlung auf der Startseite anzeigen, wenn 1 | {products_startpage} |
| p_startpage_sort | Sortierreihenfolge auf der Startseite | {products_startpage_sort} |
| p_shipping | ID des Lieferstatus, (siehe Kapitel Lieferstatus) | {products_ shippingtime} |
| p_tpl | Name der Vorlagendatei für die Artikel- Detailseite | {product_template} |
| p_opttpl | Name der Vorlagendatei für die Artikelattribute auf der Artikel-Detailseite | {options_template} |
| p_manufacturer | ID des Herstellers | {manufacturers_id} |
| p_fsk18 | Artikel als FSK18-Artikel deklarieren, wenn 1 | {products_fsk18} |
| p_priceNoTax | Netto-Artikelpreis | {products_price} |
| p_priceNoTax.1 | Netto-Artikelpreis für die Kundengruppe mit der ID 1 (Standard: Gast) | {p_personal_offer#1} |
| p_priceNoTax.2 | Netto-Artikelpreis für die Kundengruppe mit der ID 2 (Standard: Neuer Kunde) | {p_personal_offer#2} |
| p_priceNoTax.3 | Netto-Artikelpreis für die Kundengruppe mit der ID 3 (Standard: Händler) | {p_personal_offer#3} |
| p_tax | ID der Steuerklasse dieses Artikels | {products_tax_class_id} |
| p_status | Status des Artikels [0/1] (0: inaktiv; 1: aktiv) | {products_status} |
| p_weight | Gewicht in Kilogramm mit vier Nachkommastellen, punktgetrennt | {products_weight} |
| p_ean | Europäische Artikel Nummer | {products_ean} |
| code_isbn | Internationale Standard Buch-Nummer | {code_isbn} |
| code_upc | Universeller Produkt Code | {code_upc} |
| code_mpn | Hersteller Teile-Nummer (manufacturer‘s part number) | {code_mpn} |
| code_jan | Japanische Artikel-Nummer | {code_jan} |
| brand_name | Markenname | {brand_name} |
| p_disc | Rabatt auf den Artikelpreis | {products_discount_allowed} |
| p_date_added | Einstellungsdatum, das Datum muss in dem Format YYYY-MM-DD HH:MM:SS (z.B. 2019-11-03 06:16:05) angegeben werden. | {products_date_added} |
| p_last_modified | Änderungsdatum, das Datum muss in dem Format YYYY-MM-DD HH:MM:SS (z.B. 2019-11-03 06:16:05) angegeben werden. | {products_last_modified} |
| p_date_available | Erscheinungsdatum, das Datum muss in dem Format YYYY-MM-DD HH:MM:SS (z.B. 2019-11-03 06:16:05) angegeben werden. | {products_date_available} |
| p_ordered | Menge des Artikels, die insgesamt bestellt worden ist | {products_ordered} |
| nc_ultra_shipping_ costs | Artikel-Versandkosten | {nc_ultra_shipping_costs} |
| gm_show_date_added | Veröffentlichungsdatum anzeigen [0/1] (0: nicht anzeigen; 1: anzeigen) | {gm_show_date_added} |
| gm_show_price_offer | „Woanders günstiger?“-Modul anzeigen [0/1] (0: nicht anzeigen; 1: anzeigen) | {gm_show_price_offer} |
| gm_show_weight | Artikelgewicht anzeigen [0/1] (0: nicht anzeigen; 1: anzeigen) | {gm_show_weight} |
| gm_show_qty_info | Lagerbestand anzeigen [0/1] (0: nicht anzeigen; 1: anzeigen) | {gm_show_qty_info} |
| gm_price_status | Artikelpreisstatus [0/½] (0: normal; 1:Preis auf Anfrage; 2: nicht käuflich) | {gm_price_status} |
| gm_min_order | Mindestbestellmenge [>0] | {gm_min_order} |
| gm_graduated_qty | Mögliche Mengenstaffelung [>0] | {gm_graduated_qty} |
| gm_options_template | Name der Vorlagendatei für die Artikelattribute in der Artikelübersicht | {gm_options_template} |
| p_vpe | ID der Verpackungseinheit (siehe Kapitel Verpackungseinheiten) | {products_vpe} |
| p_vpe_status | VPE anzeigen [0/1] (0: nicht anzeigen; 1: anzeigen) | {products_vpe_status} |
| p_vpe_value | Wechselfaktor für den Grundpreis | {products_vpe_value} |
| p_image.1 | zusätzliches Artikelbild (NUR der Dateiname , Beispiel: Testartikel.jpg) | {products_image#1} |
| p_image.2 | zusätzliches Artikelbild (NUR der Dateiname , Beispiel: Testartikel.jpg) | {products_image#2} |
| p_image.3 | zusätzliches Artikelbild (NUR der Dateiname , Beispiel: Testartikel.jpg) | {products_image#3} |
| p_image | Artikelbild (NUR der Dateiname, Beispiel: Testartikel.jpg) | {products_image} |
| p_name.en | Artikelname in der Sprache Englisch | {products_name.en} |
| p_desc.en | Beschreibung in der Sprache Englisch | {products_description.en} |
Hinweis
Artikel-Tabs werden in der CSV-Datei zusammen mit der Artikelbeschreibung gespeichert. Tabs werden hierbei nach dem Muster [TAB:Überschrift]Inhalt des Tabs an die Artikelbeschreibung angehängt.
| Spaltenname | Beschreibung | zugeordnete Variable |
|---|---|---|
| p_shortdesc.en | Kurzbeschreibung in der Sprache Englisch | {products_short_description.en} |
| p_checkout_information.en | Wesentliche Merkmale in der Sprache Englisch | {checkout_information.en} |
| p_meta_title.en | Meta-Titel in der Sprache Englisch | {products_meta_title.en} |
| p_meta_desc.en | Meta-Beschreibung in der Sprache Englisch | {products_meta_description.en} |
| p_meta_key.en | Meta-Keywords in der Sprache Englisch | {products_meta_keywords.en} |
| p_keywords.en | Zusatzbegriffe für die Suche in der Sprache Englisch | {products_keywords.en} |
| p_url.en | Herstellerlink für den Artikel in der Sprache Englisch | {products_url.en} |
| gm_url_keywords.en | URL-Keywords in der Sprache Englisch | {gm_url_keywords.en} |
Achtung
URL Keywords dürfen weder Leerzeichen, noch Umlaute oder Sonderzeichen enthalten.
| Spaltenname | Beschreibung | zugeordnete Variable |
|---|---|---|
| rewrite_url.en | URL Rewrite-Eintrag für die Sprache Englisch | {rewrite_url.en} |
| p_name.de | Artikelname in der Sprache Deutsch | {products_name.de} |
| p_desc.de | Beschreibung in der Sprache Deutsch | {products_description.de} |
Hinweis
Artikel-Tabs werden in der CSV-Datei zusammen mit der Artikelbeschreibung gespeichert. Tabs werden hierbei nach dem Muster [TAB:Überschrift]Inhalt des Tabs an die Artikelbeschreibung angehängt.
| Spaltenname | Beschreibung | zugeordnete Variable |
|---|---|---|
| p_shortdesc.de | Kurzbeschreibung in der Sprache Deutsch | {products_short_description.de} |
| p_checkout_information.de | Wesentliche Merkmale in der Sprache Deutsch | {checkout_information.de} |
| p_meta_title.de | Meta-Titel in der Sprache Deutsch | {products_meta_title.de} |
| p_meta_desc.de | Meta-Beschreibung in der Sprache Deutsch | {products_meta_description.de} |
| p_meta_key.de | Meta-Keywords in der Sprache Deutsch | {products_meta_keywords.de} |
| p_keywords.de | Zusatzbegriffe für die Suche in der Sprache Deutsch | {products_keywords.de} |
| p_url.de | Herstellerlink für den Artikel in der Sprache Deutsch | {products_url.de} |
| gm_url_keywords.de | URL-Keywords in der Sprache Deutsch | {gm_url_keywords.de} |
Achtung
URL Keywords dürfen weder Leerzeichen, noch Umlaute oder Sonderzeichen enthalten.
| Spaltenname | Beschreibung | zugeordnete Variable |
|---|---|---|
| rewrite_url.de | URL Rewrite-Eintrag fü die Sprache Deutsch | {rewrite_url.de} |
| p_cat.en | Kategorie-Verschachtelung für den Artikel in Englisch, Kategorien werden mit dem Größer-Zeichen getrennt | {c_path.en} |
| p_cat.de | Kategorie-Verschachtelung für den Artikel in Deutsch, Kategorien werden mit dem Größer-Zeichen getrennt | {c_path.de} |
Beispiel für Kategoriepfad
Bekleidung Herren > Hosen > Jeans
Achtung
Die Angabe der Kategorie-ID (in eckigen Klammern) ist für den Import nicht notwendig. Es muss immer der vollständige Kategorie-Pfad angegeben werden.
| Spaltenname | Beschreibung | zugeordnete Variable |
|---|---|---|
| google_export_ availability | Verfügbarkeit (Pflichtfeld für Google Artikelexport) [auf lager / nicht auf lager / vorbestellt] | {p_google_export_availability} |
| google_export_ condition | Zustand (Pflichtfeld für Google Artikelexport) [neu / gebraucht / erneuert] | {p_google_export_condition} |
| google_category | Google Kategorie | {p_google_category} |
| p_img_alt_text.en | Alternativtext für Hauptartikelbild in der Sprache Englisch | {p_gm_alt_text.en} |
| p_img_alt_text.1.en | Alternativtext für erstes zusätzliches Artikelbild in der Sprache Englisch | {p_gm_alt_text#1.en} |
| p_img_alt_text.2.en | Alternativtext für zweites zusätzliches Artikelbild in der Sprache Englisch | {p_gm_alt_text#2.en} |
| p_img_alt_text.3.en | Alternativtext für drittes zusätzliches Artikelbild in der Sprache Englisch | {p_gm_alt_text#3.en} |
| p_img_alt_text.de | Alternativtext für Hauptartikelbild in der Sprache Deutsch | {p_gm_alt_text.de} |
| p_img_alt_text.1.de | Alternativtext für erstes zusätzliches Artikelbild in der Sprache Deutsch | {p_gm_alt_text#1.de} |
| p_img_alt_text.2.de | Alternativtext für zweites zusätzliches Artikelbild in der Sprache Deutsch | {p_gm_alt_text#2.de} |
| p_img_alt_text.3.de | Alternativtext für drittes zusätzliches Artikelbild in der Sprache Deutsch | {p_gm_alt_text#3.de} |
| p_group_permission.0 | Kundengruppencheck, Zugriffsrecht für Kundengruppe mit der ID 0 (Admin) [0/1] (0: nicht vergeben; 1: vergeben) | {p_group_permission#0} |
| p_group_permission.1 | Kundengruppencheck, Zugriffsrecht für Kundengruppe mit der ID 1 (Gast) [0/1] (0: nicht vergeben; 1: vergeben) | {p_group_permission#1} |
| p_group_permission.2 | Kundengruppencheck, Zugriffsrecht für Kundengruppe mit der ID 2 (Neuer Kunde) [0/1] (0: nicht vergeben; 1: vergeben) | {p_group_permission#2} |
| p_group_permission.3 | Kundengruppencheck, Zugriffsrecht für Kundengruppe mit der ID 3 (Händler) [0/1] (0: nicht vergeben; 1: vergeben) | {p_group_permission#3} |
| specials_qty | Anzahl verfügbarer Sonderangebote pro Artikel | {specials_quantity} |
| specials_new_products_price | Sonderangebotspreis | {specials_new_products_price} |
| expires_date | Sonderangebot gültig bis, das Datum muss in dem Format YYYY-MM-DD HH:MM:SS (z.B. 2019-11-03 06:16:05) angegeben werden. | {expires_date} |
| specials_status | Sonderangebotsstatus [1/0] (1: aktiv; 0: inaktiv) | {status} |
| gm_priority | Priorität in der Sitemap [0.0 - 1.0] | {gm_priority} |
| gm_changefreq | Änderungsfrequenz in der Sitemap [never, yearly, monthly, weekly, daily, hourly, always] | {gm_changefreq} |
| gm_sitemap_entry | In die Sitemap aufnehmen [0/1] (0: nicht in die Sitemap aufnehmen; 1: in die Sitemap aufnehmen) | {gm_sitemap_entry} |
| p_qty_unit_id | ID der Mengeneinheit | {quantity_unit_id} |
| p_type | Artikeltyp [½/3] Standard, Download, Dienstleistung | {product_type} |
| p_property_image_list_id | ID der für die Eigenschaften verwendeten Image List/Kollektion | {p_property_image_list_id} |
Ergänzung des Import-Profils um Eigenschaften-Kombinationen¶
Wenn Eigenschaften-Kombinationen beim Import berücksichtigt werden sollen, können für die Kombinationsdaten (siehe auch Kapitel Export, Unterpunkt CSV-Artikelexport, Profil bearbeiten > Spalten) ausgewählt werden. Diese sind der Reihe nach:
- products_properties_combis_id: ID der Kombinationen pro Artikel
- combi_sort_order: die Sortierreihenfolge der Kombination
- combi_model: die Artikelnummer der Kombination
- combi_ean: die EAN der Kombination
- combi_quantity: der Lagerstand der Kombination
- combi_shipping_status_id: der zugeordnete Lieferstatus der Kombination
- combi_weight: das eingetragene Gewicht der Kombination
- combi_price: der eingetragene Preis der Kombination
-
combi_price_type: wird der eingetragene Aufpreis verwendet?
calc = Preis aus Eigenschaften berechnen
fix = Kombinationsfestpreis
-
combi_vpe_id: die Verpackungseinheit der Kombination
- combi_vpe_value: der Wert im Bezug auf den Grundpreis
Achtung
Die products_properties_combis_id muss für jede Zeile einen anderen Wert erhalten. Idealerweise werden die IDs fortlaufend vergeben.
Hinweis
Wir empfehlen einen Export mit allen Eingenschaften und Kombinationsdaten als Basis für einen Import zu verwenden bzw. bei einem Import grundsätzlich alle Eigenschaften und Kombinationsdaten anzugeben.
Datei mit Tabellenkalkulation bearbeiten¶
Datei öffnen¶
CSV-Dateien können idealerweise mit einer Tabellenkalkulation geprüft und bearbeitet werden. Wir empfehlen zu diesem Zweck die kostenlose Software Calc aus dem OpenOffice.org- oder LibreOffice-Paket.
Anhand von LibreOffice möchten wir die Besonderheiten beim Öffnen und Abspeichern von CSV-Dateien kurz erläutern.
CSV-Dateien trennen die Datensätze mit vorher definierten Trennzeichen. Um die Daten als Tabelle darstellen zu können, müssen diese Zeichen bekannt sein und beim Öffnen eingestellt werden. Standardmäßig werden hierfür das Pipe-Symbol als Trennzeichen und das doppelte Anführungszeichen als Texterkennungszeichen/Texttrenner verwendet. Stelle diese beiden Zeichen bitte im Dialogfenster ein (siehe Screenshot).


Zudem muss der verwendete Zeichensatz festgelegt werden, damit auch Umlaute und Sonderzeichen korrekt dargestellt und erkannt werden können. Im Shop wird hierfür UTF-8 ohne BOM verwendet. Stelle beim Öffnen ebenfalls sicher dass du eine Codierung nach UTF-8 als Zeichensatz einstellst.
Tabellenkalkulationen versuchen oftmals sogenannte Felddatentypen automatisch zu erkennen, um z.B. ein Datum entsprechend darzustellen. Bei einem CSV-Import dürfen die Daten jedoch nicht verändert werden. Um dies zu verhindern, klicke bitte in die linke obere Ecke der Beispieltabelle (kleines blaues Kästchen) um alle Felder zu markieren. Stelle anschließend den Spaltentyp im Dropdown auf Text.
Datei speichern¶
Wenn du die CSV-Datei nach dem Vornehmen der Änderungen speicherst, können die Einstellungen für Zeichensatz und Trennzeichen durch die Standardwerte der Tabellenkalkulation überschrieben werden.
Unter LibreOffice Calc kannst du dies verhindern, indem du über Datei > Speichern unter vor dem Speichern die sogenannten Filtereinstellungen bearbeitest. Setze im Dialog nun den Haken für das Bearbeiten der Filtereinstellungen.

Es werden dir nun nochmals die wichtigsten Einstellungen angezeigt. Stelle hierbei sicher, dass UTF-8 als Zeichensatz und die ursprünglichen Trennzeichen (standardmäßig Pipe-Symbol und doppeltes Anführungszeichen) verwendet werden.

Hinweis
Um das Pipe-Symbol | zu erhalten, drücke auf der Tastatur bitte gleichzeitig ALT GR und < (Spitze Klammer, links neben dem Y).
Import durchführen¶
Achtung
Vor dem Durchführen eines CSV-Imports sollte unbedingt eine Sicherung der Datenbank angelegt werden.
Du kannst dies wahlweise über die shopeigene Funktion unter Toolbox > Datenbanksicherung oder den Administrationsbereich deines Hosting-Anbieters vornehmen.
Import der Artikel¶
Den Import einer CSV-Datei kannst du unter Artikel > Import/Export über den Reiter Import vornehmen.

Unter Import-Datei hochladen stehen die Schaltflächen Durchsuchen und Hochladen zur Verfügung um eine CSV-Datei auf dem lokalen Rechner auszuwählen und in das Import-Verzeichnis des Shops zu laden.
Die Dateien im Verzeichnis import werden unter Verfügbare Import-Dateien aufgeführt und können nach Auswahl im Dropdown-Menü importiert werden. Die Einstellungen für Trennzeichen und Texttrenner können vor dem Import festgelegt werden. Klicke auf Importieren um den Import der ausgewählten Datei durchzuführen.
Alle weiteren Einstellungen, beispielsweise zu Eigenschaften, werden über das Export-Profil (siehe Artikelexport) vorgenommen und beim Importieren angewendet.
Import der Artikelbilder¶
Zu einem vollständigen Import gehören in aller Regel auch die Artikelbilder. Diese müssen händisch auf den FTP-Server hochgeladen werden. Lade die Bild-Dateien hierzu in den Unterordner
/images/product_images/original_images/
deines Shopverzeichnisses. Anschließend muss unter Einstellungen / Layout & Design / Bildverarbeitung (Image Processing) die Stapelverarbeitung ausgeführt werden, um die verwendeten Bilder für die Artikel zu erzeugen (z.B. Info-Bild, Thumbnails usw.).