WebSite X5Help Center

 
Incomedia
Incomedia

Export / Import von Produkten aus dem / in den Warenkorb  de

Autor: Incomedia
Besucht 6022, Followers 2, Geteilt 28  

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 mit Hilfe der entsprechenden Befehle in der Werkzeugleiste des Dialogfensters Warenkorb E-Commerce | Tab 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;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 ";" (Semikolon) 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: Mit Hilfe 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 Produktbezeichnung/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

Obligatorisch: Ja

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: Nein

Beschreibung: 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 dem Feld USt. (%) des Dialogfensters Produkteinstellungen | Allgemein entnommen. Diese Option ist nur dann verfügbar, wenn die Option USt. für jedes Produkt festlegen im Tab Optionen aktiviert wurde und dient dem Zweck, für das Produkt einen speziellen Umsatzsteuersatz zu berechnen, der von dem der anderen Produkte im Katalog verschieden ist. In diesem Fall wird der Preis ohne Umsatzsteuer angegeben.
Der Parameter kann nur die zwei Werte 0 oder 1 haben, je nachdem, ob die vorstehend genannte Option USt. (%) aktiviert wurde oder nicht.

Parameter: VAT Value

Obligatorisch: Nein

Beschreibung: 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 USt. (%) des Dialogfensters Produkteinstellungen | Allgemein entnommen, das, ebenso wie bei dem zuvor genannten Parameter, nur dann verfügbar ist, wenn die Option USt. für jedes Produkt festlegen im Tab Optionen aktiviert wurde.
Bei Aktivierung der Option USt. (%) im Dialogfenster Produkteinstellungen | Allgemein ohne einen Wert festzulegen, wird der Wert der Standard-USt. (%) verwendet, der unter Optionen eingestellt wurde.

Parameter: Weight

Obligatorisch: Nein

Beschreibung: 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: Nein

Beschreibung: Liste eventuell verfügbarer Produktvarianten.

Wert: Beim Export des Katalogs in eine .TXT- oder .CSV-Datei wird dieser Parameter dem Feld Produktvarianten des Dialogfensters Produkteinstellungen | Optionen entnommen.
Bei der Erstellung einer zu importierenden .TXT- oder .CSV-Datei hingegen kann die Liste der Produktvarianten 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: Nein

Beschreibung: 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 | Optionen entnommen.
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: Nein

Beschreibung: 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 | Optionen 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.


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.

Zur Veranschaulichung steht eine kleine Beispieldatei im Format .CSV zum Download bereit: http://www.websitex5.com/changelog/v9/files/cart9.csv

Gepostet am