Import & Update von Artikeln (CSV)

Transkript

1 Import & Update von Artikeln (CSV) INHALTSVERZEICHNIS 1 Import von Artikeln 2 Pflichtfelder 3 Importbeispiele für Artikel 3.1 Import mit Mindestangaben 3.2 Import von Einzelartikeln 3.3 Import mit Kategorie-Zuweisungen 3.4 Import von Varianten-Artikeln mit allen Artikelangaben 3.5 Import von Artikel-Eigenschaften 3.6 Import von Freitxtfeldern (Attribute) 3.7 Import von Zubehör-Artikeln 3.8 Import eines Konfigurator-Artikels 3.9 Import von Übersetzungen 3.10 Import von Meta-Daten (Artikel) 3.11 Import von Staffelpreisen 4 Aktualisierung bestehender Artikel 4.1 Aktualisierung von Lagerbeständen 4.2 Aktualisierung ob Abverkauf aktiv 4.3 Aktualisierung von Lieferzeiten 4.4 Aktualisierung des EK-Preis 4.5 Aktualisierung von Artikelname, Herstellername oder Steuersatz 4.6 Aktualisierung von Preis 4.7 Aktualisierung von Maßeinheit / Preiseinheit 4.8 Aktualisierung von Preisgruppen 4.9 Aktualisierung von "&Aumlhnlichen Artikeln" 4.10 Aktualisierung von "Zusätzlicher Text" bei Varianten 4.11 Aktualisierung von Freitext-Feldern (Attribute) 4.12 Aktualisierung der Herstellernummer 4.13 Aktualisierung der Kurzbeschreibung 4.14 Aktualisierung der kompletten Meta Informationen 4.15 Aktualisierung von Höhe, Größe & Breite 4.16 Aktualisierung der Verpackungseinheit 4.17 Aktualisierung des Versandkostenfrei Flag 4.18 Aktualisierung von Gewicht 4.19 Aktualisierung der EAN 4.20 Aktualisierung der Beschreibung 4.21 Artikel aktivieren oder deaktivieren 4.22 Aktualisierung von Artikelnamen 4.23 Aktualisieren von Kategoriezuordnungen 5 Wichtiger Hinweis Import von Artikeln Es empfiehlt sich, die Export-Basis (SW3.5 oder SW4) für Ihre Importe zu verwenden bzw. diese als Vorlage für Importe anzupassen und zu nutzen. Über das Backend ist nur ein rudimentärer Import von Datensätzen möglich. Für den Import einer großen Anzahl an Datensätzen oder Bilder ist die Import/export-Schnittstelle nicht ausgelegt. In solchen Fällen empfehlen wir die Benutzung der shopware Rest-API.

2 Die Import-Datei muss UTF-8 codiert & DOS (CR+LF) formatiert sein. Als Spaltentrenner dient ein Semikolon und als Texttrenner dienen Anführungszeichen oben. Bitte beachten Sie, dass nicht alle Felder, welche beim Export angeboten werden, auch wieder importiert werden können. Es dürfen keine Leerzeilen im Feed vorhanden sein. Bei einem Komplett-Import von Artikel werden Artikelbilder nicht mit importiert. Diese müssen getrennt importiert werden. Siehe auch Wiki-Beitrag Import von Bildern. Hinweis: Neue Importe sollten immer in einer Testumgebung im Vorfeld geprüft werden. Legen Sie vor jedem Datei-Import in Ihre Produktiv-Umgebung eine komplette Sicherung Ihrer Datenbank an, so dass diese bei einem fehlerhaften Import wieder eingespielt werden kann. Hinweis: Bitte prüfen, dass Sie gültige Artikelpreise > 0 hinterlegen. Es dürfen keine 0 Euro Artikel importiert werden. Andernfalls kann es nachher im Backend zu Problemen mit diesen Artikeln kommen. Pflichtfelder Bei den Pflichtfeldern handelt es sich um Felder, welche bei bestimmten Importen zwangsläufig vorhanden seinen müssen. supplier: Herstellername (Pflichtfeld beim Erstimport) price: Preis der Kundengruppe EK - brutto (Pflichtfeld beim Erstimport) tax: MwSt.-Satz (Pflichtfeld beim Erstimport) WICHTIG: Beachten Sie den Aufbau der Artikelnummern in Shopware Zusätzlich kann das Grundgerüst, welches beim Artikelexport von Shopware4 übergeben wird, verwendet werden. Allerdings werden einige Spalten beim Import ignoriert. Z.B. muss der Import von Artikelbildern in einem separaten Bilder-Import erfolgen. Importbeispiele für Artikel Beim Artikel-Import stehen Ihnen die Formate csv (Semikolon getrennt) und xml zur Verfügung. Der Import erfolgt UTF-8 codiert & DOS (CR+LF) formatiert. Als Spaltentrenner dient ein Semikolon und als Texttrenner dienen Anführungszeichen oben. Bitte beachten Sie, dass nicht alle Felder welche exportiert werden auch wieder importiert werden können. Import mit Mindestangaben Bei diesem Beispiel wird der Artikel ohne Kategoriezuweisung angelegt. Der Herstellername wird automatisch erstellt, falls dieser noch nicht im vorab angelegt wurde. ordernumber;name;supplier;tax;price SW9801;Tischtennisball;Joola;19;9,95 Import von Einzelartikeln

3 ordernumber;mainnumber;name;additionaltext;supplier;tax;price;net_price;pseudoprice;net_pseudoprice;baseprice; active;instock;stockmin;description;description_long;shippingtime;added;changed;releasedate;shippingfree;topsell er;keywords;minpurchase;purchasesteps;maxpurchase;purchaseunit;referenceunit;packunit;unitid;pricegroupid;pri cegroupactive;laststock;suppliernumber;impressions;sales;esd;weight;width;height;length;ean;unit;similar;crossell ing;categories;attr1;attr2;attr3;attr4;attr5;attr6;attr7;attr8;attr9;attr10;attr11;attr12;attr13;attr14;attr15;attr16;attr17;a ttr18;attr19;attr20;attributegroupid;attributevalues;configuratortype;configurator SW1133;;Tubenhonig;;Maja;19;89,9;75, ;139,9;117,56;34,9;1;2;0;Honig von Maja und Willi;"<p>Toller Tubenhonig von unseren fleißigen Bienchen</p>";1-3; ; :13; ;;1;Honig Maja Willi;;;;;;;;1;;1;WRA-705BL-W28;12128;235;;0,8;;;; ;;;;1146;;;;;;;;;;;;;;;;;;;;;;;; Import mit Kategorie-Zuweisungen Hier wird ein Artikel mit Beschreibung und Kategoriezuweisung (Kategorie Tischtennisplatte mit der ID 19 und Kategorie Freizeit mit der ID 26) angelegt. Die IDs der Kategorien lassen sich im Backend unter Artikel > Kategorien > (Kategorie wählen) > System-ID einsehen. In diesem Beispiel wird der Artikel den Kategorien 19 und 26 zugewiesen. ordernumber;name;supplier;tax;price;description;categories SW9802;Tischtennisplatte;Joola;19;549,95;"<p>Artikelbeschreibung in HTML<p>";19 26 Hinweis: Bei Kategoriezuordnung muss die Spalte categorypaths aus der Datei entfernt werden! Bitte beachten Sie, dass die Kategorie bereits vorhanden sein muss und diese keine Unterkategorien besitzt. Import von Varianten-Artikeln mit allen Artikelangaben Hier wird der Artikel SW mit den Varianten SW & SW angelegt. Der Artikel SW dient dabei als Hauptartikel (Vater). Bitte beachten Sie, dass das Feld configuratorsetid grundsätzlich gesetzt sein muss. Bei diesem Muster-Artikel wird die Konfigurator-Gruppe Gewicht mit den Konfiguratoroptionen W28, W30 und W32 benutzt. ordernumber;mainnumber;name;additionaltext;supplier;tax;price;net_price;pseudoprice;net_pseudoprice;baseprice; active;instock;stockmin;description;description_long;shippingtime;added;changed;releasedate;shippingfree;topsell er;keywords;minpurchase;purchasesteps;maxpurchase;purchaseunit;referenceunit;packunit;unitid;pricegroupid;pri cegroupactive;laststock;suppliernumber;impressions;sales;esd;weight;width;height;length;ean;unit;similar;crossell ing;categories;categorypaths;images;filtergroupid;propertyvalues;configuratorsetid;configuratortype;configurator Options;attr_attr1;attr_attr2;attr_attr3;attr_attr4;attr_attr5;attr_attr6;attr_attr7;attr_attr8;attr_attr9;attr_attr10;attr_att r11;attr_attr12;attr_attr13;attr_attr14;attr_attr15;attr_attr16;attr_attr17;attr_attr18;attr_attr19;attr_attr20 SW ;SW ;Wrangler Jeans darkstone W152;W28;Wrangler;19.00;89,9;75, ;139,9;117,56;34,9;1;2;;Wrangler Bluejeans mit 5 Taschen;"<p>Tolle Wrangler Jeans mit Reßverschluss und 4 Taschen. Bequemer Tragekomfort und hochwertige Verarbeitung!</p>";1-3; ; :13:00; ;;1;Wrangler Bluejeans Darkstone;;;;0.0000;0;;;1;;1;WRA-705BL-W28;;;;0;0;0;0; ;;;;7004;;;;;15;;Gewicht:W28;;;;;;;;;;;;;;;;; ;;; SW ;SW ;Wrangler Jeans darkstone W152;W30;Wrangler;19.00;89,9;75, ;139,9;117,56;34,9;1;13;;Wrangler Bluejeans mit 5 Taschen;"<p>Tolle Wrangler Jeans mit Reßverschluss und 4 Taschen. Bequemer Tragekomfort und hochwertige Verarbeitung!</p>";1-3; ; :13:00; ;;1;Wrangler Bluejeans Darkstone;;;;0.0000;0;;;1;;1;WRA-705BL-W30;;;;0;0;0;0; ;;;;7004;;;;;15;;Gewicht:W30;;;;;;;;;;;;;;;;; ;;; SW ;SW ;Wrangler Jeans darkstone

4 W152;W32;Wrangler;19.00;89,9;75, ;139,9;117,56;34,9;1;;;Wrangler Bluejeans mit 5 Taschen;"<p>Tolle Wrangler Jeans mit Reßverschluss und 4 Taschen. Bequemer Tragekomfort und hochwertige Verarbeitung!</p>";1-3; ; :13:00; ;;1;Wrangler Bluejeans Darkstone;;;;0.0000;0;;;1;;1;WRA-705BL-W32;;;;0;0;0;0; ;;;;7004;;;;;15;;Gewicht:W32;;;;;;;;;;;;;;;;; ;;; Import von Artikel-Eigenschaften Hier ein einfaches Beispiel für einen Artikel-Import mit Eigenschaften. Für diesen Artikel soll die Eigenschaftsgruppe Edelbrände (filtergroupid 1) mit den dazugehörigen Eigenschaftswerten (propertyvalues) 0,2 Liter (22), klar (29), herb (32), Gekühlt (35) und >30% (40) hinterlegt werden. Die Eigenschaftswerte müssen vorab angelegt sein. ordernumber;name;filtergroupid;propertyvalues SW ;Münsterländer Lagerkorn 32%;1; Die filtergroupid finden Sie in der Tabelle s_filter. Die zugeordneten Werte (propertyvalues) finden sie in der Tabelle s_filter_values. Als Trennzeichen für die einzelnen Werte dient ein (Pipe). Hinweis: Die Spaltenbezeichnung für die Artikel-Eigenschaften hat sich geändert. In Shopware 3.5 lautet die Spaltenbezeichnung für die Artikel-Eigenschaften attributegroupid und attributevalues. In Shopware 4 lauten diese filtergroupid und propertyvalues. Import von Freitxtfeldern (Attribute) Sie haben die Möglichkeit für jeden Eltern- und Kind-Artikel alle 20 Freitextfelder zu importieren. Die Freitextfelder (attr1 bis attr20) müssen vorab angelegt sein. Hier ein einfaches Beispiel für den Import der Freitextfelder attr10 und attr11 bei einem Eltern- und einem Kind-Artikel. ordernumber;name;attr_attr10;attr_attr11 SW ;Testartikel;1;/media/pdf/preisliste.pdf SW ;Testartikel;0;/media/pdf/preisliste.pdf Import von Zubehör-Artikeln Hier ein einfaches Beispiel für den Import von Zubehör-Artikeln. Die Zubehör-Artikel müssen bereits angelegt sein. ordernumber;name;crosselling SW12301;;SW19991 SW12303;;SW19991 SW19992 Import eines Konfigurator-Artikels Beim Import von Konfigurator-Artikeln ist darauf zu achten, dass das Feld configuratorsetid immer gesetzt ist. Der gesetzte Wert ist dabei unerheblich und wird beim Import ignoriert - das Setzen des Feldes ist aber notwendig, um die neuen SW4-Konfiguratoren von den alten SW3-Konfiguratoren zu unterscheiden. Das Feld configuratortype wird beim Ex- und

5 Import nicht berücksichtigt. Konfigurator-Artikel werden immer im Standard importiert. additionaltext - Empfohlen (Zusätzlicher Text in den Varianten Stammdaten) configuratorsetid - Pflichtfeld (Hinweis s.o.) configuratortype - Optional (Wird momentan nicht unterstützt - Hinweis s.o.) configuratoroptions - Pflichtfeld mainnumber - Pflichtfeld (Hier tragen Sie die Artikelnummer der Hauptvariante / Hauptartikel ein. Der Hauptvariante selber muss keine mainnumber zugeweisen sein.) Hier ein Beispiel für einen Import eines Shopware 4 Konfigurator-Artikels: ordernumber;mainnumber;name;additionaltext;supplier;tax;price;net_price;categories;configuratorsetid;configurat ortype;configuratoroptions ABC123;ABC123;Testartikel;Blau / M;Shopware;19.00;19,99;16, ;41;2;;Farbe:Blau Größe:M ABC123.1;ABC123;Testartikel;Blau / L;Shopware;19.00;19,99;16, ;41;2;;Farbe:Blau Größe:L ABC123.2;ABC123;Testartikel;Blau / XL;Shopware;19.00;19,99;16, ;41;2;;Farbe:Blau Größe:XL ABC123.3;ABC123;Testartikel;Blau / 2XL;Shopware;19.00;19,99;16, ;41;2;;Farbe:Blau Größe:2XL ABC123.4;ABC123;Testartikel;Gelb / M;Shopware;19.00;19,99;16, ;41;2;;Farbe:Gelb Größe:M ABC123.5;ABC123;Testartikel;Gelb / L;Shopware;19.00;19,99;16, ;41;2;;Farbe:Gelb Größe:L ABC123.6;ABC123;Testartikel;Gelb / XL;Shopware;19.00;19,99;16, ;41;2;;Farbe:Gelb Größe:XL ABC123.7;ABC123;Testartikel;Gelb / 2XL;Shopware;19.00;19,99;16, ;41;2;;Farbe:Gelb Größe:2XL ABC123.8;ABC123;Testartikel;Grün / M;Shopware;19.00;19,99;16, ;41;2;;Farbe:Grün Größe:M ABC123.9;ABC123;Testartikel;Grün / L;Shopware;19.00;19,99;16, ;41;2;;Farbe:Grün Größe:L ABC123.10;ABC123;Testartikel;Grün / XL;Shopware;19.00;19,99;16, ;41;2;;Farbe:Grün Größe:XL ABC123.11;ABC123;Testartikel;Grün / 2XL;Shopware;19.00;19,99;16, ;41;2;;Farbe:Grün Größe:2XL ABC123.12;ABC123;Testartikel;Lila / M;Shopware;19.00;19,99;16, ;41;2;;Farbe:Lila Größe:M ABC123.13;ABC123;Testartikel;Lila / L;Shopware;19.00;19,99;16, ;41;2;;Farbe:Lila Größe:L ABC123.14;ABC123;Testartikel;Lila / XL;Shopware;19.00;19,99;16, ;41;2;;Farbe:Lila Größe:XL ABC123.15;ABC123;Testartikel;Lila / 2XL;Shopware;19.00;19,99;16, ;41;2;;Farbe:Lila Größe:2XL Hinweis: Da Shopware3-Konfiguratoren nur einmalig importiert werden können, empfehlen wir dringend, für den Import von Konfigurator-Artikeln die SW4-Konfiguratoren zu verwenden. Import von Übersetzungen Pro Feed kann nur eine Sprache importiert werden. Dieses Beispiel bezieht sich auf eine Übersetzung für die Shop-ID 2. Deshalb wurden die Feldüberschriften mit _2 erweitert. Die Shop-ID`s können in der Tabelle s_core_shops ausgelesen werden. ordernumber;name;name_2;description_2;description_long_ ;Testartikel Deutsch ;Testartikel Englisch 1;Kurzbeschreibung Englisch 1;<p>Beschreibung Englisch 1</p> Import von Meta-Daten (Artikel) Artikel können auch mit Meta Angaben importiert werden, hierzu sind die Spalten "descritpion" (Kurzbeschreibung, "metatitle" (Titel) und "keywords" (Keywords) erlaubt und nach dem folgenden Schema anzugeben. ordernumber;name;description;metatitle;keywords SW10045;Testartikel;Meta Kurzbeschreibung;MetaTitle;Keyword1,Keyword2

6 Import von Staffelpreisen Sie können bei bestehenden Artikeln Staffelpreise hinzufügen. Wichtig ist, dass Sie den Import mit dem passenden Import-Modul Daten: Artikelpreise auswählen. In diesem Muster Feed wird dem Artikel SW10005 insg. 3 Staffelpreise hinzugefügt. Mit der Spalte from definieren Sie, ab welcher Artikelanzahl der Staffel-Preis in der Spalte price gilt. ordernumber;price;from SW10003;9; SW10003;7;11 SW10003;5;101 Aktualisierung bestehender Artikel Durch einen einfachen Import können Sie innerhalb kürzester Zeit Ihren Artikelstamm aktualisieren. Z.B. können Sie so bei Dropshipping-Artikeln die Lagerbestände Ihrer Lieferanten übernehmen oder Artikel deaktivieren. Aktualisierung von Lagerbeständen Bei der Aktualisierung der Lagerbestände sind lediglich folgende 2 Felder relevant: name: Artikelname (Pflichtfeld) instock: Aktueller Lagerbestand (Pflichtfeld) Zusätzliche Felder werden ignoriert! Bei diesem Beispiel wird der Lagerbestand von Artikel SW9802 auf 29 erhöht. ordernumber;name;instock sw9802;handball;29 Bitte wählen sie beim Importieren der csv-datei das Daten-Feld Auf Lager aus. Aktualisierung ob Abverkauf aktiv name: Artikelname (Pflichtfeld) laststock: Abverkauf (0=nein/1=ja) ordernumber;name;laststock SW10007;Testartikel;1 Aktualisierung von Lieferzeiten name: Artikelname (Pflichtfeld) shippingtime: Lieferzeit (Pflichtfeld) In diesem Beispiel wird die Lieferzeit auf 1-3 Tage festgelegt.

7 ordernumber;name;shippingtime sw9802;testartikel;1-3 Aktualisierung des EK-Preis name: Artikelname (Pflichtfeld) baseprice: EK-Preis (Pflichtfeld) Bei diesem Beispiel wird bei der Artikelnummer n2610 der Einkaufspreis auf 2,99 gesetzt. ordernumber;name;baseprice n2610;nokia 2610 Phone;2,99 Aktualisierung von Artikelname, Herstellername oder Steuersatz name: Artikelname (Pflichtfeld) supplier = Hersteller (Pflichtfeld) tax = Steuersatz (Pflichtfeld) price = Bruttopreis (Pflichtfeld) ordernumber;name;supplier;tax;price SW-12000;Testartikel;Shopware;19.00;6,99 Aktualisierung von Preis price = Bruttopreis (Pflichtfeld) ordernumber;price SW-12000;6,99 Hinweis: Diesen Import sollten Sie nur nutzen, wenn Sie die Felder "Einkaufspreis" und "Pseudopreis" nicht in Shopware pflegen, denn diese Preise werden mit dem Wert "0" überschrieben. Zur Preisaktualisierung sollte generell der Preisimport genutzt werden. Aktualisierung von Maßeinheit / Preiseinheit Bei diesem Importbeispiel wird bei dem Artikel mit der Artikelnummer SW10003 die Maßeinheit mit der der id = 1 gesetzt. Die Zuordnung der Unit-id zu den jeweiligen Einheiten finden Sie in der Tabelle s_core_units. ordernumber;name;unitid SW10003;Testartikel;1

8 Aktualisierung von Preisgruppen Bei diesem Importbeispiel wird bei dem Artikel mit der Artikelnummer SW1234 die Preisgruppe mit der ID3 gesetzt. Die Preisgruppen ID finden Sie in der Tabelle s_core_pricegroups. ordernumber;name;pricegroupid SW1234;Testartikel;3 Aktualisierung von "&Aumlhnlichen Artikeln" Dieses Beispiel zeigt auf, wie dem Artikel SW1133 ein ähnlicher Artikel (SW1023) zugewiesen wird: ordernumber;name;supplier;tax;similar SW1133;Tubenhonig;Maja;19;SW10239 Aktualisierung von "Zusätzlicher Text" bei Varianten Bei der Erstellung von Varianten wird ein "zusätzlicher Text" generiert. Sie können diesen Text einfach updaten. Beachten Sie, dass bei jedem Datensatz die Spalte configuratorsetid mit 1 gefüllt sein muss. ordernumber;mainnumber;name;additionaltext;configuratorsetid; SW10001;SW ;Testartikel;Neuer Variantentext;1; Aktualisierung von Freitext-Feldern (Attribute) Dieses Beispiel zeigt auf, wie das Artikel-Freitextfeld / Attributfeld 1 gesetzt wird. Der Spaltenname für Freitextfelder ist fortlaufend. Für das Freitextfeld 2 wird entsprechend der Name attr_attr2 gesetzt. ordernumber;name;supplier;attr_attr1 SW-1233;Artikelname;Hersteller;"Inhalt Attributfeld 1" Aktualisierung der Herstellernummer ordernumber;name;supplier;suppliernumber SW-1234;Artikelname;Hersteller;ABC12345 Aktualisierung der Kurzbeschreibung ordernumber;name;description;metatitle;keywords 123;Test;SEO short description;titeltag;keyword1,keyword2 Aktualisierung der kompletten Meta Informationen

9 ordernumber;name;description;metatitle;keywords 123;Test;SEO short description;titeltag;keyword1,keyword2 Aktualisierung von Höhe, Größe & Breite ordernumber;name;supplier;width;height;length SW-1234;Artikelname;Hersteller;1;4,2 Aktualisierung der Verpackungseinheit ordernumber;name;supplier;referenceunit;packunit SW-1234;Artikelname;Hersteller;10;Flasche(n) Aktualisierung des Versandkostenfrei Flag ordernumber;name;supplier;shippingfree SW-1234;Artikelname;Hersteller;1 Aktualisierung von Gewicht ordernumber;name;supplier;weight SW-1234;Artikelname;Hersteller;1,4 Aktualisierung der EAN ordernumber;name;supplier;ean SW-1234;Artikelname;Hersteller; Aktualisierung der Beschreibung ordernumber;name;description_long SW10001;Testartikel;"<p>Neue detailierte Artikelbescheibung</p>" Artikel aktivieren oder deaktivieren Dieser einfache Daten-Feed zeigt auf, wie der Artikel sw9802 im Shop deaktiviert wird. ordernumber;name;active sw9802;tischtennisplatte;0 Aktualisierung von Artikelnamen ordernumber;name sw9802;testartikel mit neuem Namen

10 Aktualisieren von Kategoriezuordnungen In folgenden Beispiel ist der Artikel SW10001 bereits der Kategorie mit der ID5 zugewiesen. Zusätzlich soll dieser Artikel aber noch der Kategorie mit der ID6 zugewiesen werden. Entsprechend müssen beide Kategorie mit einem Pipe getrennt in der Spalte categories hinterlegt werden. Der Aufbau für die CSV-Datei muss folgendermaßen aussehen: ordernumber;name;categories SW10001;Fussball;5 6 Wichtiger Hinweis Hinweis: Unser Wiki-Artikel Häufige Fehler beim Import zeigt Ihnen häufige Fehler beim Datei-Import auf und bietet zu dem Lösungsansätze für einen erfolgreichen Import.