Kompatibilität:

WebSite X5 Evo und Pro


Nachdem ein Warenkorb für den E-Commerce erstellt wurde, könnte es nützlich sein, den Produktkatalog exportieren zu können, beispielsweise um ihn in ein anderes Projekt einzufügen oder in einer anderen Software - z.B. für die Rechnungsverwaltung - zu nutzen. Umgekehrt kann es sich als ebenso nützlich erweisen, einen existierenden Produktkatalog zu importieren, um ihn nicht neu erstellen zu müssen.

WebSite X5 ermöglicht einen solchen Import bzw. Export mithilfe der entsprechenden Befehle und in der Werkzeugleiste des Dialogfensters Onlineshop > Produkte. Beim Export des Produktkatalogs wird eine Datei im Format .TXT oder .CSV generiert, die mit einem herkömmlichen Text-Editor (z.B. im Windows-Editor) oder Microsoft Excel geöffnet und bearbeitet werden kann.


Um die Export-Datei eines Produktkatalogs manuell zu bearbeiten oder eine Datei für den Import zu erstellen, beachten Sie bitte folgende Regeln:

  • Die erste Zeile muss die Spaltenüberschriften, also folgende Einträge enthalten:
ID;Category;Name/Code;Description;Price;Enable VAT;VAT Value;Weight;Images;Options;Enable Discounts;Discounts
  • Wird eine Spaltenüberschrift entfernt, geht der Wert für alle Produkte verloren. Die Pflichtfelder Category, Name/Code, Description und Price können nicht gelöscht werden.
  • Jede Zeile unter den Spaltenüberschriften muss einem Produkt entsprechen.
  • Alle Parameter müssen mit einem ";" voneinander getrennt werden.
  • Für jedes Produkt müssen angegeben werden: Kategorie, Produktname, Produktbeschreibung und der Preis des Produkts. Alle anderen Felder sind optional und können ausgelassen werden (für das jeweilige Feld zwischen den Semikolons ";" nichts eingeben).
  • Die Produkt-ID wird vom Programm und nicht manuell generiert: Lassen Sie das Feld der Produkt-ID daher leer, wenn Sie ein neues Produkt eingeben.
  • Eventuell eingegebene, überflüssige Leerzeichen werden beim Import automatisch gelöscht.

Die in der .TXT- oder .CSV-Datei enthaltenen Parameter sind im Einzelnen:


Parameter: ID
Obligatorisch
Nein
Beschreibung
Dies ist ein eindeutiger Identifizierungs-Code für das Produkt.
Wert
Er wird automatisch vom Programm generiert und dem Produkt zugeordnet.


Soll eine zuvor exportierte .TXT- oder .CSV-Datei aktualisiert werden, ändern Sie die dort bereits zugewiesenen Produkt-IDs nicht und lassen Sie das Feld für neu hinzugefügte Produkte frei. Auch, wenn eine .TXT- oder .CSV-Datei von Grund auf neu erstellt wird, um sie anschließend zu importieren, müssen die Produkt-IDs nicht manuell erstellt werden. In der Importphase vergleicht das Programm die IDs, um Zweifacheinträge zu vermeiden, und generiert fehlende automatisch.

Parameter: Category
Obligatorisch
Ja
Beschreibung
Kategorie, der das Produkt zugeordnet wurde.
Wert
Mithilfe des Zeichens ">" kann der Pfad der Kategorien und Unterkategorien wiedergegeben werden.


Ist das Produkt zum Beispiel ein T-Shirt, das im Katalog der Unterkategorie "Casual" der Kategorie "Herrenbekleidung" zugeordnet wurde, kann dieser Pfad in der .TXT- oder .CSV-Datei folgendermaßen angegeben werden:


... ; Herrenbekleidung > Casual ; ...


Auf diese Weise können alle benötigten Unterkategorien definiert werden.

Parameter: Name/Code
Obligatorisch
Ja
Beschreibung
Dem Produkt zugewiesener Name oder Code.
Wert
Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter dem Feld Name/Code des Dialogfensters Produkteinstellungen | Allgemein entnommen.
Parameter: Description
Obligatorisch
Ja
Beschreibung
 Beschreibung des Produkts.
Wert
Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter dem Feld Beschreibung des Dialogfensters Produkteinstellungen | Allgemein entnommen.
Parameter: Price
ObligatorischJa
Beschreibung
Preis des Produkts.
Wert
Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter dem Feld Preis des Dialogfensters Produkteinstellungen | Allgemein entnommen.
Parameter: Enable VAT
Obligatorisch
NeinBeschreibung

Hier wird angegeben, ob für das Produkt ein besonderer Umsatzsteuersatz vorgesehen ist. 

Wert
Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter aus dem Feld MwSt. (%) des Dialogfensters Produkteinstellungen | Allgemein. Diese Option ist nur dann verfügbar, wenn unter E-Commerce | Verfügbarkeit die Option Typ ingeschlossen aktiviert wurde für die Angabe der MwSt und dient dem Zweck, auf das Produkt einen speziellen Mehrwertsteuersatz anzuwenden, der von dem der anderen Produkte im Katalog verschieden ist. In diesem Fall wird der Preis ohne Mehrwertsteuer angegeben.


Der Parameter kann nur die zwei Werte 0 oder 1 haben, je nachdem, ob die vorstehend genannte Option MwSt. (%) aktiviert wurde oder nicht.

Parameter: VAT Value
Obligatorisch
NeinBeschreibung
Höhe der Umsatzsteuer für den Fall, dass die Anwendung eines speziellen Umsatzsteuersatzes auf den Produktpreis vorgesehen ist.
Wert
Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter dem Feld MwSt. (%) des Dialogfensters Produkteinstellungen | Allgemein as, ebenso wie bei dem zuvor genannten Parameter, nur dann verfügbar ist, wenn im Fenster E-Commerce | Verfügbarkeit die Option Typ "MwSt. Inkl" per le Angabe der MwSt.


Wenn Die Option MwSt. (%) im Fenster Produkteinstellungen | Allgemein aktiviert wurde aber keinen Wert festgelegt wurde wird den Wert Standardwert (%) der für jedes Produkt im Tab Produkteinstellungen | Verfügbarkeit festgelegt wurde, benutzt.

Parameter: Weight
Obligatorisch
NeinBeschreibung
Gewicht des Produkts.
Wert
Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter dem Feld Gewicht des Dialogfensters Produkteinstellungen | Allgemein entnommen.
Parameter: Options
Obligatorisch
NeinBeschreibung
Liste eventuell verfügbarer Produktvarianten.
Wert
Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter dem Feld Liste der Haupt-Varianten des Dialogfensters Produkteinstellungen | Optionen.


Bei der Erstellung einer zu importierenden .TXT- oder .CSV-Datei hingegen kann die Liste der Hauptvarianten mit Hilfe des Zeichens "|" folgendermaßen erstellt werden:


... ; Variante1 |Variante2 | Variante3 ; ....


Auf diese Weise können alle benötigten Produktvarianten definiert werden.

Parameter: Enable Discounts
Obligatorisch
NeinBeschreibung
Hier wird angegeben, ob, für das Produkt ein Mengenrabatt vorgesehen ist.
Wert
Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter dem Feld Mengenrabatt aktivieren des Dialogfensters Produkteinstellungen | Rabatt.


Der Parameter kann nur die zwei Werte 0 oder 1 haben, je nachdem, ob die vorstehend genannte Option Mengenrabatt aktivieren aktiviert wurde oder nicht.

Parameter: Discounts
Obligatorisch
NeinBeschreibung
Liste der auf das Produkt anzuwendenden Mengenrabatte, sofern vorgesehen.
Wert
Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter wie der zuvor genannte dem Feld Mengenrabatt aktivieren des Dialogfensters Produkteinstellungen | Rabatt entnommen.


Bei der Erstellung einer zu importierenden .TXT- oder .CSV-Datei hingegen muss die Liste der Produktvarianten folgendermaßen erstellt werden:


... ; Menge : Rabatt | Menge : Rabatt ; ...


Ist zum Beispiel für eine Bestellung von mehr als 20 Stück ein Rabatt von 10% und für Bestellmengen über 50 Stück ein Rabatt von 15% vorgesehen, geben Sie folgende Sequenz ein:


... ; 20 : 10 | 50 : 15 ; ...


Mit dem Zeichen "|" können alle benötigten Rabatte und Mengen definiert werden.

Parameter: Availability Type
ObligatorischNeinDescriptionDie Art Information über die Verfügbarkeit am Lager eines Produkts.
WertBeim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter vom Dialogfensters Produkteinstellungen> Verfügbarkeit entnommen.


Bei der Erstellung einer zu importierenden .TXT- oder .CSV-Datei hingegen muss der Parameter folgendermaßen erstellt werden:


  • ..;Unset;.. -  für die Option Keine Informationen über die Produktverfügbarkeit;
  • ..;Fixed;.. -  für die Option Geschätzte Verfügbarkeit;
  • ..;Dynamic;.. - für die Option     Effektive Verfügbarkeit
Parameter: Available
ObligatorischNeinDescriptionDie geschätzte oder effektive Verfügbarkeit eines Produkts.
WertBeim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter vom Dialogfensters Produkteinstellungen> Verfügbarkeit entnommen.


Bei der Erstellung einer zu importierenden .TXT- oder .CSV-Datei hingegen muss der Parameter folgendermaßen erstellt werden:


  • ..;Available;.. - für die Option Geschätzte Verfügbarkeit | Vorrätig;
  • ..;Lack;.. - für die Option Geschätzte Verfügbarkeit | Begrenzte Verfügbarkeit;
  • ..;Not Available;.. - für die Option Geschätzte Verfügbarkeit | Nicht am Lager.

Bei der Option Effektive Verfügbarkeit wird die Menge aus dem Wert Aktueller Lagerbestand übernommen.

Parameter: Pending
ObligatorischNeinDescriptionWenn die effektive Verfügbarkein eingestellt wird, zeigt der Parameter viel viele Produkte aus dem Lager entfernt oder hinzugefügt werden sollen.
WertBeim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter vom Dialogfensters Produkteinstellungen> Verfügbarkeit> Hinzuzufügende / zu entfernende Menge entnommen


Bei der Erstellung einer Datei .TXT oder . CSV zeigt der Parameter nur den eingestellten Wert.
Parameter: Images
Obligatorisch
Nein
BescreibungListe der Bilder eines Produkts.
Wert
Wenn Sie den Katalog in .TXT oder .CSV exportieren, wird dieser Parameter aus dem Fenster Produkteinstellungen | Bild übernommen. Von jedem Bild wird der ursprüngliche absolute Pfad übernommen.


Bei der Erstellung einer zu importierenden .TXT- oder .CSV-Datei hingegen kann die Liste der Produktbilder mit Hilfe des Zeichens "|" und unter Angabe des relativen oder absoluten Pfads folgendermaßen erstellt werden:


... ; PathImage1 | PathImage2 | PathImage3 ; ..

Beim Import einer zuvor exportierten oder manuell erstellten .TXT- oder .CSV-Datei wird diese sehr wahrscheinlich vom Programm aktualisiert, beispielsweise durch Einfügen fehlender Produkt-IDs. Ist eine aktuelle Kopie der .TXT- oder .CSV-Datei gewünscht, muss daher der Produktkatalog erneut exportiert werden.