Beschreibung der Datenübergabe an Yopedo

Datenschnittstelle Yopedo V1.3
Beschreibung der Datenübergabe
an Yopedo
Stand:
Version:
04.06.2015
1.3
Datenschnittstelle Yopedo V1.3
1. Allgemeines
Die Übertragung der Produktdaten eines registrierten Händlers an Yopedo erfolgt über eine
CSV-Datei, die alle benötigten Artikelinformationen enthält. Hierbei werden immer alle
Produkte des Händlers übergeben. Vorhandene Artikel dieses Händlers, die nicht in der Datei
enthalten sind, werden bei Yopedo entfernt.
2. Datensatzaufbau
Die Übergabedatei ist im CSV-Format zu erstellen, Zeichencodierung Windows-ASCII (ISO8859-1). Die Datenfelder werden entweder durch ein Semikolon (;) oder ein Tab-Zeichen
(ASCII-Code 9) getrennt. Die Datensätze werden durch einen Zeilenumbruch (CR/LF)
voneinander getrennt. Innerhalb der Felder darf sich kein Zeilenumbruch befinden. Beinhaltet
ein Feld ein Semikolon (z.B. die Beschreibung des Artikels), so ist dieses Feld in
Anführungszeichen („) zu setzen. Beginnt eine Zeile mit dem Zeichen „#“, so wird diese Zeile
nicht eingelesen.
Die Reihenfolge der Datenfelder ist wie folgt festgelegt (Felder mit * müssen gefüllt sein):
Feld Inhalt
Format
Beschreibung
1*
2
3*
4*
Produktbezeichnung
Beschreibung
Preis
ID
Text, max. 80 Zeichen
Text, max. 10000 Zeichen
Dezimalzahl, z.B. 1000,17
Text, max. 255 Zeichen
z.B. http://irgendwo.de/art_1.htm
5
Bild
z.B. http://irgendwo.de/art_1.jpg
Produktbezeichnung
Beschreibung des Artikels
Preis des Artikels inkl. MwST.
Eindeutige ID der Produktes. Diese muß für jedes Produkt
eindeutig sein und kann ´z.B. auch die Url zur Web-Seite des
Artikels sein. Produkte mit gleicher ID werden überschrieben.
Url zum 1. Bild des Artikels. Dieses sollte in einer Auflösung
von mind. 300x300 Pixel vorliegen. Für die verkleinerte
Darstellung wird es auf 120x120 skaliert. Wird hier ein größeres
Bild als 300x300 Pixel angegeben, so kann dieses bei der
Darstellung bei Yopedo gezoomt werden.
6*
Währung
dreistellig, z.B. EUR, CHF
7
Kategorie
Text, max. 255 Zeichen
8
Kz. Altersfreigabe
Zahl, einstellig
9
EAN-Code
Zahl, 8-,12-,13- oder 14-stellig
10
11
12
13
Hersteller
Bestellnummer
Mwst-% Wert
Preis vorher
Text, max. 50 Zeichen
Text, max. 30 Zeichen
Zahl, max. 2-stellig, z.B. 19
Dezimalzahl, z.B. 1000,17
14
15
Lieferzeit
Topprodukt
Text, max. 30 Zeichen
Zahl, einstellig
16
Versandkosten
Dezimalzahl, z.B. 4,75
17
Varianten
Text
Ist kein Bild für den Artikel vorhanden, ist dieses Feld leer zu
lassen. Mögliche Dateiformate sind GIF, PNG oder JPG.
Bezeichnung der Währung. Muß bei Yopedo.de immer EUR
sein.
Hier sollte der komplette „Kategoriepfad“ Ihres Produktes
stehen. Bei mehrere Ebene sollten die Ebenen durch das „>“
Zeichen getrennt sein, z.B. Spielzeug > Holzspielzeug oder
Auto & Motorrad > Motorräder.
Es sollte auf jeden Fall eine Kategorie angegeben werden, da
der Artikel sonst bei Yopedo keiner Kategorie zugewiesen
werden kann und somit nur über die Suchfunktion gefunden
wird.
Mögliche Inhalte:
1: FSK18 Artikel, Bild und Text werden erst nach
Altersverifikation dargestellt.
2: Erotikartikel, aber auch unter 18 Jahren, ohne Verifikation
0 oder leer: keine Einschränkung der Darstellung
EAN, ISBN oder UPC-Code, muß 8,12,13 oder 14 stellig sein.
Fehlerhafte Codes werden nicht übernommen.
VK-Preis, den der Artikel vorher hatte. Hiermit können
Sonderpreise, Schnäppchen, heruntergesetzte Artikel kenntlich
gemacht werden.
z.B. „Sofort lieferbar“ , „2 Tage“ etc.
Leer oder 0: Normaler Artikel
1: Artikel soll besonders priorisiert werden (wird bei manchen
Partnern als Topprodukt hervorgehoben) Achtung, nur wenige
Artikel kennzeichnen, da sonst „unwirksam“.
Falls dieses Feld leer bleibt, werden die Versandkosten
verwendet, die im Händlerbereich hinterlegt sind.
Sollte es keine Varianten dieses Artikels geben, Feld leer lassen.
Datenschnittstelle Yopedo V1.3
18
Bild 2
z.B. http://irgendwo.de/art_2.jpg
19
Bild 3
z.B. http://irgendwo.de/art_2.jpg
20
Bild 4
z.B. http://irgendwo.de/art_2.jpg
21
Bild 5
z.B. http://irgendwo.de/art_3.jpg
22
23
24
Gewicht
Grundpreis
MPN
Dezimalzahl, z.B. 4,75
Text, max. 30 Zeichen
Text, max. 30 Zeichen
Der Aufbau der Variantenspalte ist weiter unten genauer erklärt.
Url zum 2. Bild, Format, etc. analog zu 1. Bild
Sollte kein 2. Bild vorhanden sein, Feld leer lassen
Url zum 2. Bild, Format, etc. analog zu 1. Bild
Sollte kein 2. Bild vorhanden sein, Feld leer lassen
Url zum 2. Bild, Format, etc. analog zu 1. Bild
Sollte kein 2. Bild vorhanden sein, Feld leer lassen
Url zum 3. Bild, Format, etc. analog zu 1. Bild
Sollte kein 3. Bild vorhanden sein, Feld leer lassen
Gewicht in Kg
z.B. „1,25 EUR pro Kg“
Artikelnummer beim Hersteller
3. Aufbau der Variantenspalte:
Produkte, die es in verschiedenen Ausführungen gibt, können in der Variantenspalte
übergeben werden. Der Aufbau ist wie folgt:
<Variante1-Artikelnummer>:<Preis>:<Ausprägung>:<EAN>|<Variante2-Artikelnummer>:<Preis>:<Ausprägung>:<EAN>|...
Beispiel:
Schuhe, die in den Größen 42,43 und 44 erhältlich sind, wobei die Größe 44 einen
abweichenden Preis hat:
471142:19,99:Größe 42:12345001|471143:19,99:Größe 43:12345002|471144:21,99:Größe 44:12345003
3. Erstellung der Datei
Die Datei kann mit jedem Texteditor (z.B. Editor bzw. Notepad von Windows) erfasst
werden. Eine Vorlage zur Erfassung mittels Excel kann unter
http://www.yopedo.de/excel/leer.csv heruntergeladen werden. Diese muß allerdings in Excel
mittels „Datei/Speichern unter...“ als Dateityp „Text (Tabstopp-getrennt) (*.txt) “ oder „CSV
(Trennzeichen getrennt) (*.csv)“ gespeichert werden.
Wobei das Speichern "Tabstopp-getrennt" vorzuziehen ist, da es hierbei keine Probleme mit
dem Zeichen ";" in den Texten gibt.
Bei großer Artikelanzahl oder einem häufig wechselnden Artikelstamm empfiehlt sich aber
die dynamische Generierung auf dem Server des Online-Shops mittels eines Skripts (PHP,
Pearl, Asp, etc.). Dieses kann dann automatisch von Yopedo abgeholt werden und bedarf
deshalb langfristig keines Aufwands.
Eine Beispieldatei finden Sie unter http://www.yopedo.de/excel/beispiel.csv .
4. Übertragung der Daten
Um die erstellten Produktdaten von Yopedo einlesen zu lassen, müssen Sie diese auf Ihren
Webserver kopieren, und die Url zu dieser Datei im Loginbereich von Yopedo unter „Url zur
Importdatei“ des Menüpunktes „Meine Angaben“ hinterlegen.