Shopware Knowledgebase

Zur Website von Shopware wechseln Shopware Trac / Quellcode Repository Shopware Klassen-Doku
Suchoptionen  
 

Import/Export - Import von Artikeln, Kategorien, Lagerbeständen, Kunden, Artikelpreisen

ab Version:3.0.5

Inhaltsverzeichnis

Import von Daten über CSV

Hinweis: Es empfiehlt sich die Export-Basis für Ihre Importe zu verwenden bzw. diese als Vorlage für Importe zu nutzen.

(Achten Sie jedoch darauf, ob der Export, sowie Import, alle von Ihnen befüllten Felder unterstützt)

Neue Importe sollten immer in einer Testumgebung im Vorfeld geprüft werden.

CSV-Dateien müssen Trennzeichen getrennt im Windows-Format gespeichert werden.

Import von Artikeln

Verfügbare Felder

Bei den Pflichtfeldern handelt es sich um Felder die zwangsläufig vorhanden seinen müssen.

  • ordernumber: Bestellnummer (Pflichtfeld)
  • supplier: Herstellername (Pflichtfeld)
  • price: Preis der Kundengruppe EK - brutto (Pflichtfeld)
  • tax: MwSt.-Satz (Pflichtfeld)

Zusätzlich können alle Felder, die im Artikelexport beschrieben sind verwendet werden.

Importbespiele für Artikel

Import mit Mindestangaben 

ordernumber	supplier	price		tax	
IM_0001		Canon		499		19	
IM_0002		Olympus		542		7

Import mit Kategorie-Zuweisung 

ordernumber	supplier	price	tax	name			description	categorypaths
IM_0003		Herstellername	99	19	Artikelbezeichnung	Beschreibung	Deutsch|Sicherheit|Alarmanlagen
											Deutsch|Sicherheit|Zweite Kategorie

oder 

ordernumber	supplier	price	tax	name			description	categories
IM_0003		Herstellername	99	19	Artikelbezeichnung	Beschreibung	3

Hinweis: Bei Kategoriezuordnung nur über die Kategorie ID, muss die Spalte categorypaths aus der Datei entfernt werden!

Aktualisierung der bestehenden Artikel 

ordernumber	description			active
IM_0001		Detailierte Beschreibung	1	
IM_0002		Beschreibung lang		0

Import Artikel-Eigenschaften 

ordernumber	name		supplier	tax	price	attributegroupID	attributevalues
SWT3038		Artikelname	Hersteller	19	100	4			XL|gelb

Zu jeder Option kann eine Eigenschaft importiert werden, nach der später gefiltert werden kann.

Import eines Konfigurator-Artikels 

ordernumber	supplier	price	categorypaths		configuratortype	configurator
IM_0010		Hersteller XY	499	Deutsch|Inhalt|10	1			IM_0010.1|63,0,0|120.00|Größe: S, Farbe: grün
					Deutsch|Inhalt|20				IM_0010.2|14,1,0|100.00|Größe: M, Farbe: grün
											IM_0010.3|12,1,0|110.00|Größe: L, Farbe: grün
											IM_0010.4|24,1,0|100.00|Größe: S, Farbe: schwarz
											IM_0010.5|37,1,1|120.00|Größe: M, Farbe: schwarz
											IM_0010.6|37,1,0|120.00|Größe: L, Farbe: schwarz

Import eines Artikels mit Übersetzung 

ordernumber	supplier	price	tax	categorypaths		name		name_en		description_long	description_long_en	
IM_0011		Hersteller XY	22.45	19	Deutsch|Inhalt|10	Artikelname	Articlename	Beschreibung		Description

Import mit Bilddateien

Hinweis: Bitte setzen Sie den Haken bei Artikel-Bilder importieren um Bilddateien zu importieren! Für Artikelbilder gibt es zusätzlich einen eigenen Import/Export, mit dem auch Bildzuordnungen erstellt werden können.

ordernumber	supplier	price	tax	images
SW_1823721	Herstellername	40.55	19	http://www.domain.tld/bild1.jpg|http://www.domain.tld/bild2.jpg

Import von Kategorien

Verfügbare Felder

Bei den Pflichtfeldern handelt es sich um Felder die zwangsläufig vorhanden seinen müssen.

  • categoryID: ID der Kategorie (Pflichtfeld)
  • description: Kategoriebezeichnung (Pflichtfeld)
  • parentID: ID des Elternelements (0=root) (Pflichtfeld)

Zusätzlich können alle Felder verwendet werden, die im Kategorie-Export beschrieben sind.

Importbespiele für Kategorien (CSV)

Import mit Mindestangaben

In diesem Beispiel werden Kategorien unterhalb der Hauptkategorie Deutsch (ID:3) angelegt. Die IDs der Kategorien lassen sich im Backend unter Artikel > Kategorien > (Kategorie wählen) > System-ID einsehen. 

categoryID	description	parentID
1000		Sicherheit	3
1001		Alarmanlagen	1000
1002		Feuermelder	1000
1003		Tresore		1000
1004		Garten		3
1005		Camping		1004
1006		Garten-Technik	1004

Import mit erweiterten Angaben 

categoryID	description	parentID	cmsheadline		cmstext		ac_attr5
1000		Sicherheit	3
1001		Alarmanlagen	1000		Kategorieübersicht 	Kategorietext	
1002		Feuermelder	1000							51147
1003		Tresore		1000
1004		Garten		3		Kategorieübersicht 	Kategorietext	
1005		Camping		1004
1006		Garten-Technik	1004

Aktualisierung bestehender Kategorien

Im folgenden Beispiel wird die Reihenfolge neu definiert 

categoryID	description	parentID	position
1001		Alarmanlagen	1000		3
1002		Feuermelder	1000		1
1003		Tresore		1000		2

Import von Lagerbeständen (Aktualisierung)

Verfügbare Felder

Beim der Aktualisierung der Lagerbestände sind lediglich die folgenden Felder relevant:

  • ordernumber: Bestellnummer (Pflichtfeld)
  • instock: Aktueller Lagerbestand (Pflichtfeld)

Zusätzliche Felder werden ignoriert!

Aktualisierungsbeispiel für Lagerbestände (CSV) 

ordernumber	instock
IM_2001		100
IM_2002		70
IM_2023		100
IM_1239		92

Import von Kunden

Verfügbare Felder

Bei den Pflichtfeldern handelt es sich um Felder die zwangsläufig vorhanden seinen müssen.

  • email: eMail-Adresse des Kunden (Pflichtfeld)
  • password: Unverschlüsseltes Passwort (Pflichtfeld) ODER
  • md5_password: Bereits MD5-verschlüsseltes Passwort (0=root) (Pflichtfeld)

Zusätzlich können alle Felder verwendet werden, die im Kunden-Export beschrieben sind.

Importbespiele für Kunden (CSV)

Import mit Mindestangaben Beispiel 1

In diesem Beispiel werden die Passwörter im Klartext übergeben. Beim Import werden diese automatisch MD5-verschlüsselt. 

email		password
max@domain.tld	H6ja$ahu
jan@domain.tld	jak)7a7a

Import mit Mindestangaben Beispiel 2

Alternative mit bereits im MD5-Format vorliegende Passwörter 

email		md5_password
max@domain.tld	ee3a2cf4094ed89839bd7e64e14ae677
jan@domain.tld	97f01e8f3232cb688b1aa83632bb9a10

Import mit Mindestangaben Beispiel 3

Import von MD5 und unverschlüsselten Passwörtern 

email		password	md5_password
max@domain.tld			ee3a2cf4094ed89839bd7e64e14ae677
jan@domain.tld	jak)7a7a

Import mit erweiterten Angaben

Import mit weiteren verfügbaren Feldern. 

email		md5_password				billing_company		billing_salutation	billing_firstname	billing_lastname	phone		shipping_countryID	customergroup
max@domain.tld	ee3a2cf4094ed89839bd7e64e14ae677				ms			Jana			Meier			0214-25581	2			EK
jan@domain.tld	97f01e8f3232cb688b1aa83632bb9a10	Musterfirma		mr			Max			Müller			0123 / 65847	2			H

Import von Daten über XML

Hinweis: Die Exporte der Artikel, Kategorien, Lagerbestände und Kunden können 1 zu 1 als Import verwendet werden. Daher empfiehlt es sich diese als Basis für Ihre Importe zu verwenden.

Hinweis: Beachten Sie, dass alle Knoten deren Inhalt Markup-Zeichen enthält durch einen CDATA-Abschnitt umschlossen sind.

//Beispiel: 
<note><![CDATA[<p>Markup-Inhalte</p>]]></note>

Import von Artikeln

Verfügbare Felder

Bei den Pflichtfeldern handelt es sich um Knoten die zwangsläufig vorhanden seinen müssen.

  • ordernumber: Bestellnummer (Pflichtfeld)
  • supplier: Herstellername (Pflichtfeld)
  • price: Preis der Kundengruppe EK - brutto (Pflichtfeld)
  • tax: MwSt.-Satz (Pflichtfeld)

Hinweis: Die Pflichtfelder supplier und price sind nur notwendig, wenn es sich um einen neuen Artikel handelt.

Möchten Sie bestehende Artikel aktualisieren, so reicht es das Feld ordernumber + zu aktualisierende Felder anzugeben!

Zusätzlich können alle Knoten verwendet werden, die im Artikelexport beschrieben sind.

Importbespiele für Artikel

Import mit Mindestangaben 

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<shopware>
	<articles>
		<article>
			<ordernumber>IM_3000</ordernumber>
			<supplier>Herstellername</supplier>
			<price>25.60</price>
			<tax>19</tax>
		</article>
	</articles>
</shopware>

Import mit Kategorie-Zuweisung

In diesem Beispiel werden die beiden Artikel jeweils den Kategorien der ID 34 und 56 zugeordnet. Die IDs der Kategorien lassen sich im Backend unter Artikel > Kategorien > (Kategorie wählen) > System-ID einsehen. 

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<shopware>
	<articles>
		<article>
			<ordernumber>IM_3000</ordernumber>
			<supplier>Herstellername</supplier>
			<price>25.60</price>
			<tax>19</tax>
			<categories>
				<category>34</category>
				<category>56</category>
			</categories>
		</article>
		<article>
			<ordernumber>IM_3001</ordernumber>
			<supplier>Herstellername</supplier>
			<price>28.60</price>
			<tax>19</tax>
			<categories>
				<category>34</category>
				<category>56</category>
			</categories>
		</article>
	</articles>	
</shopware>

Aktualisierung der bestehenden Artikel

In dem folgenden Beispiel wird exemplarisch die Beschreibung, sowie der Lagerbestand des Artikel aktualisiert. Hierfür reicht die Angabe der Bestellnummer (ordernumber) 

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<shopware>
	<articles>
		<article>
			<ordernumber>IM_3000</ordernumber>
			<description_long><![CDATA[<p>Beschreibung des Artikels (Markup-Inhalte)</p>]]></description_long>
			<instock>60</instock>
			<tax>19</tax>
		</article>
	</articles>	
</shopware>

Import eines Konfigurator-Artikels 

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<shopware>
<articles>	
	<article>
		<ordernumber>IM_3100</ordernumber>
		<name>Testartikel Konfigurator</name>
		<supplier>Herstellername</supplier>
		<tax>19</tax>
		<categories>
			<category>11</category>
			<category>10</category>
		</categories>
		<configurator>
			<values>
				<value>
					<standard></standard>
					<active>1</active>
					<ordernumber>IM_0010.3</ordernumber>
					<instock>12</instock>
					<net_price>102.803738318</net_price>
					<price>110.00</price>
					<group1>Farbe</group1>
					<option1>grün</option1>
					<group2>Größe</group2>
					<option2>L</option2>
					<prices>
						<price>
							<pricegroup>H</pricegroup>
							<net_price></net_price>
							<price>0.00</price>
						</price>
					</prices>
				</value>
				<value>
					<standard></standard>
					<active>1</active>
					<ordernumber>IM_0010.6</ordernumber>
					<instock>37</instock>
					<net_price>112.14953271</net_price>
					<price>120.00</price>
					<group1>Farbe</group1>
					<option1>schwarz</option1>
					<group2>Größe</group2>
					<option2>L</option2>
					<prices>
						<price>
							<pricegroup>H</pricegroup>
							<net_price></net_price>
							<price>0.00</price>
						</price>
					</prices>
				</value>
				<value>
					<standard></standard>
					<active>1</active>
					<ordernumber>IM_0010.2</ordernumber>
					<instock>14</instock>
					<net_price>93.4579439252</net_price>
					<price>100.00</price>
					<group1>Farbe</group1>
					<option1>grün</option1>
					<group2>Größe</group2>
					<option2>M</option2>
					<prices>
						<price>
							<pricegroup>H</pricegroup>
							<net_price></net_price>
							<price>0.00</price>
						</price>
					</prices>
				</value>
				<value>
					<standard>1</standard>
					<active>1</active>
					<ordernumber>IM_0010.5</ordernumber>
					<instock>37</instock>
					<net_price>112.14953271</net_price>
					<price>120.00</price>
					<group1>Farbe</group1>
					<option1>schwarz</option1>
					<group2>Größe</group2>
					<option2>M</option2>
					<prices>
						<price>
							<pricegroup>H</pricegroup>
							<net_price></net_price>
							<price>0.00</price>
						</price>
					</prices>
				</value>
				<value>
					<standard></standard>
					<active></active>
					<ordernumber>IM_0010.1</ordernumber>
					<instock>63</instock>
					<net_price>112.14953271</net_price>
					<price>120.00</price>
					<group1>Farbe</group1>
					<option1>grün</option1>
					<group2>Größe</group2>
					<option2>S</option2>
					<prices>
						<price>
							<pricegroup>H</pricegroup>
							<net_price></net_price>
							<price>0.00</price>
						</price>
					</prices>
				</value>
				<value>
					<standard></standard>
					<active>1</active>
					<ordernumber>IM_0010.4</ordernumber>
					<instock>24</instock>
					<net_price>93.4579439252</net_price>
					<price>100.00</price>
					<group1>Farbe</group1>
					<option1>schwarz</option1>
					<group2>Größe</group2>
					<option2>S</option2>
					<prices>
						<price>
							<pricegroup>H</pricegroup>
							<net_price></net_price>
							<price>0.00</price>
						</price>
					</prices>
				</value>
			</values>
			<type>1</type>
		</configurator>
	</article>
</articles>
</shopware>

Import eines Artikels mit Übersetzung 

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<shopware>
<articles>	
	<article>
		<ordernumber>IM_3110</ordernumber>
		<name>Testartikel Konfigurator</name>
		<supplier>Herstellername</supplier>	
		<tax>19</tax>
		<description>Beschreibung</description>	
		<description_long><![CDATA[<p>Beschreibung lang</p>]]></description_long>	
		<attributes>
			<attribute id="4">Attr Deutsch</attribute>
		</attributes>
		<translations>
			<translation>
				<language>en</language>
				<name>testarticle configurator</name>
				<description>Description</description>
				<description_long><![CDATA[<p>Description long</p>]]></description_long>
				<attr4>Attr englisch</attr4>
			</translation>
		</translations>
	</article>
</articles>
</shopware>

Import mit Bilddateien

Hinweis: Bitte setzen Sie den Haken bei Artikel-Bilder importieren um Bilddateien zu importieren! Für Artikelbilder gibt es zusätzlich einen eigenen Import/Export, mit dem auch Bildzuordnungen erstellt werden können.

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<shopware>
<articles>	
	<article>
		<ordernumber>IM_3110</ordernumber>
		<name>Testartikel Konfigurator</name>
		<supplier>Herstellername</supplier>	
		<tax>19</tax>
		<images>
			<image>
				<main>1</main>
				<description>Erstes Bild</description>
				<position>1</position>
				<link>http://www.domain.tld/bilddatei1.jpg</link>
			</image>
			<image>
				<description>Zweites Bild</description>
				<position>1</position>
				<link>http://www.domain.tld/bilddatei2.jpg</link>
			</image>
		</images>
	</article>
</articles>
</shopware>

Import von Kategorien

Verfügbare Felder

Bei den Pflichtfeldern handelt es sich um Felder die zwangsläufig vorhanden seinen müssen.

  • categoryID: ID der Kategorie (Pflichtfeld)
  • description: Kategoriebezeichnung (Pflichtfeld)
  • parentID: ID des Elternelements (0=root) (Pflichtfeld)

Zusätzlich können alle Knoten verwendet werden, die im Kategorie-Export beschrieben sind.

Importbespiele für Kategorien

Import mit Mindestangaben

Im folgenden Beispiel wird unterhalb der Kategorie Deutsch (ID:3) die Kategorie Sicherheit samt Unterkategorien Alarmanlage und Selbschutz angelegt. 

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<shopware>
	<categories>
		<category>
			<categoryID>3000</categoryID>
			<parentID>3</parentID>
			<description>Sicherheit</description>
		</category>
		<category>
			<categoryID>3001</categoryID>
			<parentID>3000</parentID>
			<description>Alarmanlagen</description>
		</category>
		<category>
			<categoryID>3002</categoryID>
			<parentID>3000</parentID>
			<description>Selbstschutz</description>
		</category>
	</categories>
</shopware>

Import mit erweiterten Angaben 

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<shopware>
	<categories>
		<category>
			<categoryID>3000</categoryID>
			<parentID>3</parentID>
			<position>2</position>
			<description>Disicio</description>
			<cmstext><![CDATA[<p>incunabula. Nec gluto se obex, has</p>]]></cmstext>
			<ac_attr5>18818194</ac_attr5>
		</category>
		<category>
			<categoryID>3001</categoryID>
			<parentID>3</parentID>
			<position>1</position>
			<description>Subaudio</description>
			<cmstext><![CDATA[<p>Salus, adduco sto iam Retendo, balanus</p>]]></cmstext>			
		</category>
	</categories>
</shopware>

Aktualisierung bestehender Kategorien 

<shopware>
	<categories>
		<category>
			<categoryID>3000</categoryID>
			<position>1</position>
		</category>
		<category>
			<categoryID>3001</categoryID>
			<position>2</position>			
		</category>
	</categories>
</shopware>

Fehlermeldungen

Das Modul gibt zusätzlich Feedback über folgende Fehler:

1 von 2 Artikeln konnten nicht importiert werden,

  • weil die Herstellerangabe fehlte.
  • weil der angegebene Steuersatz nicht gefunden werden konnte.
  • weil der angegebene Hauptartikel nicht gefunden werden konnte.
  • weil die angegebene ArtikelID nicht gefunden werden konnte.
  • weil die Bestellnummer schon für eine Konfigurator-Variante vergeben war.
  • weil der Konfigurator und die Varianten nicht zusammen genutzt werden können.

1 Bild konnte nicht importiert werden,

  • weil das Bild nicht geöffnet werden konnte
  • weil die angegebene Datei kein Bild war.
  • weil das Bildformat nicht unterstützt wurde.

Artikel pro Anfrage

Um Timeouts zu vermeiden, wurde eine Konfigurationsmöglichkeit hinzugefügt, die bestimmt wie viele Artikel in einem Schritt importiert werden. Hier ist der Standard Wert 10 Artikel pro Anfrage.

Falls der Server für die Anfrage trotzdem noch zu lange braucht und einen Timeout wirft, sollte die Anzahl der Artikel pro Anfrage weiter verringert werden.

Artikel-PDF erstellen

Artikel bewerten

Waren diese Informationen hilfreich? Ja Nein


Kategorien:

Bedienung / Online-Handbuch |

Hilfe |

Import/Export |

Inhalte

Bestell-Nr.: SW1365

Lieferzeit ca. 5 Tage

€ 1,00

Preise inkl. gesetzlicher
MwSt. zzgl. Versandkosten*

€ 1,00

Preise inkl. gesetzlicher
MwSt. + Versandkosten*