Erstellen der CSV-Datei

In dieser Dokumentation wird der Aufbau der CSV-Datei für Shopgate beschrieben. Dabei gelten diese Regeln für das Erstellen der CSV-Datei:

  • Pro Zeile steht immer nur ein Produkt
  • Die Zeilen sind mit einem New-Line-Zeichen (\n) getrennt (Textformat UNIX)
  • Die Kodierung der Datei muss UTF-8 sein
  • Wenn die Umlaute nicht richtig dargestellt werden, sind Ihre Daten nicht in UTF-8
  • Als Trennzeichen für die Spalten wird ein Semikolon (;) verwendet.
  • Als Feldbegrenzerzeichen werden doppelte Anführungszeichen (") verwendet.
  • Enthält der Text einer Spalte ein Semikolon (;) so muss diese Spalte mit dem Feldbegrenzerzeichen (") maskiert werden
  • Enthält der Text einer Spalte ein doppeltes Anführungszeichen (") so muss dieses Zeichen verdoppelt werden
  • Es spricht nichts dagegen, jede Spalte mit dem Feldbegrenzerzeichen (") zu versehen
  • In der ersten Zeile wird die Überschrift angezeigt (Spaltenname).
  • Der Spaltenname muss exakt so wie von uns vorgegeben verwendet werden.
  • Spalten mit einer unbekannten Überschrift werden ignoriert.
  • Die Reihenfolge der Spalten ist egal.

Produktdatei importieren


Pflichtfelder

Diese Felder müssen in der Produkt CSV-Datei vorhanden sein. Sollte eine der Spalten fehlen kann die Datei nicht importiert werden. Sollte der Wert in manchen Zeilen falsch sein, kann das Produkt in der jeweiligen Zeile auch nicht importiert werden.

Eine Beispieldatei können Sie hier herunterladen.

Spaltenname Beschreibung Beispiel
item_number

Pflichtfeld
Typ: Text
Artikelnummer
Geben Sie hier die Artikelnummer von dem Produkt an. Jedes Produkt braucht eine Artikelnummer und diese muss eindeutig sein. Solten mehrere Produkte die gleiche Artikelnummer haben, können diese nicht bei Shopgate importiert werden.
B5178743
item_name

Pflichtfeld
Typ: Text
Produktname
Geben Sie hier bitte den Produktnamen an.
iPod touch 32GB
unit_amount

Pflichtfeld
Typ: Dezimal
Einzelpreis
Einzelpreis inkl. Umsatzsteuer mit max. zwei Nachkommastellen. Als Dezimaltrennzeichen bitte einen Punkt verwenden. (Kein Komma). Dieser Wert muss immer größer als 0 sein.
179.99
description

Pflichtfeld
Typ: Text
Beschreibung
Hier können Sie eine passende Beschreibung zu dem Produkt angeben. Zur Formatierung bitte HTML verwenden. Achten Sie darauf, dass in der Beschreibung keine Zeilenumbrüche sind, da sonst die CSV-Datei ungültig wird. Zeilenumbrüche bitte als HTML angeben.
Großartiger mobiler Spielspaß. Hier hast du die Finger im Spiel. Und nicht nur die. Denn mit den Spielen auf dem iPod touch tauchst du richtig in die Action ein - einfach neigen, tippen, drehen. Und via Wi-Fi kannst du jederzeit im App Store neue Spiele kaufen.
urls_images

Pflichtfeld
Typ: Text
Links zu Produktbildern
Link zu einem großen Produktbild auf Ihrem Server. Es werden die Formate JPG,PNG,GIF unterstützt.
Sie können auch gerne mehrere URLs angeben. Benutzen Sie dazu das Trennzeichen "||" zwischen den einzelnen Links
http://images.apple.com/ipodtoruch/gallery/images/1.jpg
categories

Pflichtfeld
Typ: Text
Kategorien
Geben Sie mindestens eine Kategorie an.
Um eine Unterkategorie zu definieren, verwenden Sie bitte folgendes Trennzeichen "=>". Möchten Sie einem Produkt mehreren Kategorien zuordnen, verwenden Sie das Trennzeichen "||"
Alternativ können Sie auch eine eigene Kategorie CSV-Datei erstellen.
Elektronik=>MP3-Player=>Apple
is_available

Pflichtfeld
Typ: 0 / 1
Ist Lieferbar
1 = Produkt ist sofort lieferbar
0 = Produkt ist nicht lieferbar
1
available_text

Pflichtfeld
Typ: Text
Lieferzeit als Freitext
Tragen Sie hier die Lieferzeit als Text ein.
2-3 Tage
manufacturer

Pflichtfeld
Typ: Text
Herstellername
Name des Herstellers
Apple
url_deeplink

Pflichtfeld
Typ: Text
Link zur Produktseite
Vollständiger Link zu dem Produkt in Ihrem Shop
http://www.apple.com/de/ipodtouch/


Weitere Angaben

Diese Angaben können zusätzlich in der CSV-Datei vorhanden sein. Grundsätzlich gilt: Je mehr Informationen Sie uns geben, desto besser können wir Ihre Produkte in dem mobilen Shop darstellen und desto höher ist die Conversion Rate. Wenn der Wert von einer optionalen Spalte keine gültigen Angaben enthält wird diese Information ignoriert, das Produkt jedoch trotzdem übernommen.

Spaltenname Beschreibung Beispiel
properties

Optional
Typ: text
Zusätzliche Eigenschaften
Falls Sie weitere besonders relevante Eigenschaften Ihres Produkts angeben wollen, haben Sie hier die Möglichkeit mit entsprechen Paaren aus key=>value dies zu tun. Ein häufiger Anwendungsfall sind zum Beispiel gebrauchte Produkte. Hier können Sie z.B. (Zustand=>gebraucht) für einen gebrauchten Artikel angeben. Möchten Sie mehrere Eigenschaften für ein Produkt angeben, verwenden sie dazu bitte folgende Trennzeichen "||".
Zustand=>gebraucht
manufacturer_item_number

Optional
Typ: Text
Hersteller Nummer
Die Artikelnummer des Herstellers.
A1403
currency

Optional
Typ: Text
Währung
Derzeit wird nur EUR unterstützt.

tax_percent

Optional
Typ: Dezimal
Enthaltene Steuer
Angabe in Prozent als Zahl
19
msrp

Optional
Typ: Dezimal
Unverbindliche Preisempfehlung
Unverbindliche Preisempfehlung des Herstellers
99.95
shipping_costs_per_order

Optional
Typ: Dezimal
Versandkosten pro Bestellung
Versandkosten pro Bestellung
Kann auch im Shop definiert werden
0
additional_shipping_costs_per_unit

Optional
Typ: Dezimal
Zusätzliche Versandkosten
Zusätzliche Versandkosten pro Artikel
1
basic_price

Optional
Typ: Text
Grundpreis
Angabe des Grundpreises wenn notwendig

use_stock

Optional
Typ: bool
Berücksichtigen der Produktanzahl
Wenn dieses Feld gesetzt ist, wird das Feld "stock_quantity" ausgewertet.

stock_quantity

Optional
Typ: int
Anzahl der Vorhandenen Artikel
Dieses Feld wird berücksichtigt, wenn use_stock auf "true" gesetzt ist. Dieses Feld enthält die Stückzahl, die auf Lager ist.
123
ean

Optional
Typ: Zahl
EAN
Der integrierte Barcodescanner sucht die EAN
4006942220451
last_update

Optional
Typ: Datum
Datum der Aktualisierung
Format: YYYY-MM-DD

tags

Optional
Typ: string
Schlagwörter
Komma getrennte liste mit Schlagwörtern für dieses Produkt für die Suche.
hose,jeans,blau
sort_order

Optional
Typ: Dezimal
Sortierung
Sortierungsangabe für die Darstellung Ihrer Produkte. Je höher der Index, desto weiter oben steht das Produkt.
1
marketplace

Optional
Typ: bool
Produkt in Shopgate listen
Den Artikel im Shopgate-Marktplatz anzeigen. Default: 1
0
internal_order_info

Optional
Typ: Text
Informationen zur Bestellung
Hier haben Sie die Möglichkeit Informationen über ein Produkt zu hinterlegen, die bei der Bestellung durch einen Kunden zusätzlich zu der Bestellung an Sie zuruckgegeben werden. Diese Information ist für den Kunden nicht sichtbar.
ean: 12345678
related_shop_item_numbers

Optional
Typ: Text
Zugehörige Produktnummern
Verwenden Sie dieses Feld, wenn Sie verschiedene Zubehörartikel zu einem Produkt anbieten möchten.Geben Sie einfach die Artikelnummern der Produkte an, die Sie als Zubehör auflisten möchten. Mehrere Artikelnummern werden durch "||" getrennt.
10001||10003||3456
age_rating

Optional
Typ: Zahl
Altersfreigabe
Tragen Sie hier ein, ab welchem Alter der Artikel freigegeben ist
16
weight

Optional
Typ: Zahl
Gewicht
Geben Sie in dieser Spalte das Gewicht Ihres Artikels in Gramm an.
2000
is_free_shipping

Optional
Typ: Zahl
Versandkosten frei
Wenn diese Option auf "1" steht und ein Kunde dieses Produkt bestellt, dann entfallen die kompletten Versandkosten.
Achtung: Wenn sich ein Produkt mit "additional_shipping_costs_per_unit" in dem Warenkorb befindet, dann entfallen auch diese zusätzlichen Versandkosten.
Default: 0
1
block_pricing

Optional
Typ: Text
Staffelpreise
Anhand dieses Feldes können Sie Staffelpreise für Ihren Artikel hinterlegen
Dieses Feld wird beim Import noch nicht berücksichtigt
5=>5.00||10=>4.50||20=>4.00
noch nicht implementiert!

category_numbers

Optional
Typ: Text
Kategorien
Geben Sie mindestens eine Kategorie an.
Wenn das Produkt in einer bestimmten Position in der Kategorie stehen soll, so können Sie nach der Kategorie-Id, mit "=>" getrennt, einen Order-Index übergeben. Je höher dieser Order-Index, desto weiter oben steht das Produkt in der Kategorie. Möchten Sie einem Produkt mehreren Kategorien zuordnen, verwenden Sie das Trennzeichen "||".
Wenn Sie dieses Feld verwenden, dann müssen Sie auch eine eigene Kategorie CSV-Datei erstellen. Ebenso wird bei Verwendung dieses Feldes, das Feld categories ignoriert.
34=>2||46=>3||56=>5
oder
34||46||56
oder
34

pzn

Optional
Typ: Text
PZN
Die PZN (Pharmazentralnummer), für Arzneimittel.
-4908802
is_highlight

Optional
Typ: boolean
Produkt als Highlight markieren
Dieses Produkt wird in der App als Highlight dargestellt
1
highlight_order_index

Optional
Typ: int
Highlight Position
Bestimmt die Position des Elements innerhalb der Highlight Produkte
12


Angaben zu Artikeln mit verschiedenen Optionen

Falls Sie in Ihrem Shop Produkte haben, die Sie mit verschiedenen Optionen anbieten möchten, dann benutzen Sie bitte die folgenden Spalten. Typische Produkte sind z.B. Brillen mit unterschiedlicher Krümmung oder Dioptrien

Spaltenname Beschreibung Beispiel
has_options

Optional
Typ: 0 / 1
Produkt hat Optionen
Verwenden Sie dieses Feld nur, wenn Sie ein Produkt mit verschieden Optionen (z.B. Brille) anbieten möchten. 1 = Produkt hat verschiedene Optionen (Dioptrien, Krümmung, etc.) 0 = Produkt hat keinen Optionen

option_1

Optional
Typ: Text
Option 1
Beinhaltet den Namen einer Option. Optional kann auch noch eine interne Nummer für die spätere Zuordnung übergeben werden.
Farbe
D123=Farbe

option_1_values

Optional
Typ: Text
Option 1 Werte
Beinhaltet die Werte zur Option 1. Optional können zu den einzelnen Werten auch noch eine interne Nummer und/oder eine absolute Preisdifferenz bei Auswahl dieses Wertes angegeben werden. Die optionale interne Nummer muss mit einem "=" vor den eigentlichen Wert der Option(z.B "blau") geschrieben werden und dient der internen Zuordnung in Ihrem Shopsystem (vergleichbar mit einer Artikelnummer). Soll auch der Preis des Produkts je Auswahl geändert werden, muss der Differenzbetrag in Eurocent nach dem Namen geschrieben werden, getrennt von einem "=>". Die verschieden Optionen müssen Sie mit folgendem Trennzeichen "||" voneinander abgrenzen.
12001=rot=>-200||12002=gelb||
12003=grün||blau||schwarz=200

option_2

Optional
Typ: Text
Option 2
(Siehe option_1)

option_2_values

Optional
Typ:
Option 2 Werte
(siehe option_1_values)

option_3

Optional
Typ: Text
Option 3
(Siehe option_1)

option_3_values

Optional
Typ:
Option 3 Werte
(siehe option_1_values)

option_4

Optional
Typ: Text
Option 4
(Siehe option_1)

option_4_values

Optional
Typ:
Option 4 Werte
(siehe option_1_values)

option_5

Optional
Typ: Text
Option 5
(Siehe option_1)

option_5_values

Optional
Typ:
Option 5 Werte
(siehe option_1_values)

option_6

Optional
Typ: Text
Option 6
(Siehe option_1)

option_6_values

Optional
Typ:
Option 6 Werte
(siehe option_1_values)

option_7

Optional
Typ: Text
Option 7
(Siehe option_1)

option_7_values

Optional
Typ:
Option 7 Werte
(siehe option_1_values)

option_8

Optional
Typ: Text
Option 8
(Siehe option_1)

option_8_values

Optional
Typ:
Option 8 Werte
(siehe option_1_values)

option_9

Optional
Typ: Text
Option 9
(Siehe option_1)

option_9_values

Optional
Typ:
Option 9 Werte
(siehe option_1_values)

option_10

Optional
Typ: Text
Option 10
(Siehe option_1)

option_10_values

Optional
Typ:
Option 10 Werte
(siehe option_1_values)



Angaben zu Artikeln mit verschiedenen Varianten

Falls Sie in Ihrem Shop Produkte haben, die Sie in verschiedenen Varianten anbieten möchten, dann benutzen Sie bitte die folgenden Spalten. Typische Produkte sind z.B. Schuhe in veschiedenen Größen

Spaltenname Beschreibung Beispiel
has_children

Optional
Typ: 0 / 1
Produkt hat Eigenschaften
Verwenden Sie dieses Feld nur, wenn Sie ein Produkt in verschieden Varianten(z.B. Schuhe) anbieten möchten. 1 = Produkt hat verschiedene Eigenschaften (Größe, Farbe, etc.) = Elternprodukt
0 = Kindprodukt oder Produkt ohne auswählbare Eigenschaften
Elternprodukt: 1 Kindprodukt 1: 0 Kindprodukt 2: 0
parent_item_number

Optional
Typ: Text
Artikelnummer des Elternprodukts
Dieses Feld ist nur dann relevant, wenn es sich um ein Kindprodukt handelt, damit wir diesem das passende Elternprodukt zuordnen können
Elternprodukt: 0 Kindprodukt 1: 69a8783 Kindprodukt 2: 69a8783
attribute_1

Optional
Typ: Text
Eigenschaft 1
Hier wird eine mögliche Eigenschaft eines Produkts definiert.
Beispiel Elternprodukt: Größe
Beispiel Kindprodukt: 38
Die angegebenen Werte im Kindprodukt müssen zu dem angegebenen Namen der Eigenschaft im Elternprodukt passen.
Bund
attribute_2

Optional
Typ: Text
Eigenschaft 2
Eine weitere Eigenschaft des Produkts. Nur benutzen, wenn Eigenschaft 1 schon vewendet
Länge
attribute_3

Optional
Typ: Text
Eigenschaft 3
Eine weitere Eigenschaft des Produkts. Nur benutzen, wenn Eigenschaft 2 schon vewendet
Größe
attribute_4

Optional
Typ: Text
Eigenschaft 4
Eine weitere Eigenschaft des Produkts. Nur benutzen, wenn Eigenschaft 3 schon vewendet
Farbe
attribute_5

Optional
Typ: text
Eigenschaft 5
Eine weitere Eigenschaft des Produkts. Nur benutzen, wenn Eigenschaft 4 schon vewendet

attribute_6

Optional
Typ: Text
Eigenschaft 6
Eine weitere Eigenschaft des Produkts. Nur benutzen, wenn Eigenschaft 5 schon vewendet

attribute_7

Optional
Typ: Text
Eigenschaft 7
Eine weitere Eigenschaft des Produkts. Nur benutzen, wenn Eigenschaft 6 schon vewendet

attribute_8

Optional
Typ: Text
Eigenschaft 8
Eine weitere Eigenschaft des Produkts. Nur benutzen, wenn Eigenschaft 7 schon vewendet

attribute_9

Optional
Typ: Text
Eigenschaft 9
Eine weitere Eigenschaft des Produkts. Nur benutzen, wenn Eigenschaft 8 schon vewendet

attribute_10

Optional
Typ: Text
Eigenschaft 10
Eine weitere Eigenschaft des Produkts. Nur benutzen, wenn Eigenschaft 9 schon vewendet



Personlisierung von Artikeln

Falls Sie in Ihrem Shop Produkte haben, die ein Kunde für sich personalisieren kann, dann benutzen Sie bitte die folgenden Spalten. Ein typisches Beispiel stellen Bilder oder Texte auf T-Shirts oder eine Ringgravur dar.

Spaltenname Beschreibung Beispiel
has_input_fields

Optional
Typ: Zahl
Produkt ist personalisierbar
Verwenden Sie dieses Feld nur, wenn es sich um ein Produkt handelt, dass vom Käufer mitgelieferte Informationen beinhalten kann.
1 = Produkt ist personalisierbar
0 = Produkt ist nicht personalisierbar
1
input_field_1_type

Optional
Typ: Text
Art des Input-Feldes
Geben Sie hier an, um welche Art des Input-Feldes sich handelt.
text = ein Text
image = ein Bild
text
input_field_1_label

Optional
Typ: Text
Beschreibung / Verwendungsart
Geben Sie hier an in welcher Art die Eingabe des Nutzers verwendet wird. zB. Text T-Shirt Rückseite
Text auf Rückseite
input_field_1_infotext

Optional
Typ: Text
Infotext / Hilfetext
Geben Sie hier an, welchen Informationstext Sie diesem Inputfeld Ihrem Kunden zur Verfügung stellen möchten.
Geben Sie hier Ihren Text für Ihre Ringgravur an!
input_field_1_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
Geben Sie hier an, ob die Informationen zwingend für eine Bestellung dieses Artikels benötigt werden.
1 = ja
0 = nein
1
input_field_1_add_amount

Optional
Typ: Zahl
Aufpreis
Wenn sich der Preis Ihrer Produkte bei einer Personalisierung verändert, können Sie hier den Aufpreis angeben
5.50
input_field_2_type

Optional
Typ: Text
Art des Input-Feldes
(siehe input_field_1_type)

input_field_2_label

Optional
Typ: Text
Beschreibung / Verwendungsart
(siehe input_field_1_label)

input_field_2_infotext

Optional
Typ: Text
Infotext / Hilfetext
(siehe input_field_1_infotext)

input_field_2_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
(siehe input_field_1_required)

input_field_2_add_amount

Optional
Typ: Zahl
Aufpreis
(siehe input_field_1_add_amount)

input_field_3_type

Optional
Typ: Text
Art des Input-Feldes
(siehe input_field_1_type)

input_field_3_label

Optional
Typ: Text
Beschreibung / Verwendungsart
(siehe input_field_1_label)

input_field_3_infotext

Optional
Typ: Text
Infotext / Hilfetext
(siehe input_field_1_infotext)

input_field_3_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
(siehe input_field_1_required)

input_field_3_add_amount

Optional
Typ: Zahl
Aufpreis
(siehe input_field_1_add_amount)

input_field_4_type

Optional
Typ: Text
Art des Input-Feldes
(siehe input_field_1_type)

input_field_4_label

Optional
Typ: Text
Beschreibung / Verwendungsart
(siehe input_field_1_label)

input_field_4_infotext

Optional
Typ: Text
Infotext / Hilfetext
(siehe input_field_1_infotext)

input_field_4_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
(siehe input_field_1_required)

input_field_4_add_amount

Optional
Typ: Zahl
Aufpreis
(siehe input_field_1_add_amount)

input_field_5_type

Optional
Typ: Text
Art des Input-Feldes
(siehe input_field_1_type)

input_field_5_label

Optional
Typ: Text
Beschreibung / Verwendungsart
(siehe input_field_1_label)

input_field_5_infotext

Optional
Typ: Text
Infotext / Hilfetext
(siehe input_field_1_infotext)

input_field_5_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
(siehe input_field_1_required)

input_field_5_add_amount

Optional
Typ: Zahl
Aufpreis
(siehe input_field_1_add_amount)

input_field_6_type

Optional
Typ: Text
Art des Input-Feldes
(siehe input_field_1_type)

input_field_6_label

Optional
Typ: Text
Beschreibung / Verwendungsart
(siehe input_field_1_label)

input_field_6_infotext

Optional
Typ: Text
Infotext / Hilfetext
(siehe input_field_1_infotext)

input_field_6_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
(siehe input_field_1_required)

input_field_6_add_amount

Optional
Typ: Zahl
Aufpreis
(siehe input_field_1_add_amount)

input_field_7_type

Optional
Typ: Text
Art des Input-Feldes
(siehe input_field_1_type)

input_field_7_label

Optional
Typ: Text
Beschreibung / Verwendungsart
(siehe input_field_1_label)

input_field_7_infotext

Optional
Typ: Text
Infotext / Hilfetext
(siehe input_field_1_infotext)

input_field_7_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
(siehe input_field_1_required)

input_field_7_add_amount

Optional
Typ: Zahl
Aufpreis
(siehe input_field_1_add_amount)

input_field_8_type

Optional
Typ: Text
Art des Input-Feldes
(siehe input_field_1_type)

input_field_8_label

Optional
Typ: Text
Beschreibung / Verwendungsart
(siehe input_field_1_label)

input_field_8_infotext

Optional
Typ: Text
Infotext / Hilfetext
(siehe input_field_1_infotext)

input_field_8_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
(siehe input_field_1_required)

input_field_8_add_amount

Optional
Typ: Zahl
Aufpreis
(siehe input_field_1_add_amount)

input_field_9_type

Optional
Typ: Text
Art des Input-Feldes
(siehe input_field_1_type)

input_field_9_label

Optional
Typ: Text
Beschreibung / Verwendungsart
(siehe input_field_1_label)

input_field_9_infotext

Optional
Typ: Text
Infotext / Hilfetext
(siehe input_field_1_infotext)

input_field_9_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
(siehe input_field_1_required)

input_field_9_add_amount

Optional
Typ: Zahl
Aufpreis
(siehe input_field_1_add_amount)

input_field_10_type

Optional
Typ: Text
Art des Input-Feldes
(siehe input_field_1_type)

input_field_10_label

Optional
Typ: Text
Beschreibung / Verwendungsart
(siehe input_field_1_label)

input_field_10_infotext

Optional
Typ: Text
Infotext / Hilfetext
(siehe input_field_1_infotext)

input_field_10_required

Optional
Typ: Zahl
Benötigt um das Produkt bestellen zu können?
(siehe input_field_1_required)

input_field_10_add_amount

Optional
Typ: Zahl
Aufpreis
(siehe input_field_1_add_amount)

Bei Rückfragen helfen wir Ihnen gerne per E-Mail an technik@shopgate.com oder telefonisch unter +49 (6033) 7470-50 weiter.