Preisvergleich Schnittstellenbeschreibung | PDF

Chip Digital GmbH - Spezifikation für die Datenintegration
Letzte Änderung: 08.03.2016
CHIP Preisvergleich
Spezifikation für die Datenintegration
1
INHALT
1.
Allgemeine Informationen
1.1
CHIP bietet zwei Datei-Formate an
2.
Standard CSV-Format
2.1
Schnittstellenbeschreibung
2.2
Übergabe der Daten
2.3
Beispieldatei
2.4
Dateigröße
3.
Delta-Feeds-Format
3.1
Grundlegendes
3.2
Funktionsweise
3.3
Schnittstellenbeschreibung
3.4
Bereitstellung der Dateien
4.
Weitere Informationen
4.1
Händler-Logo
4.2
Welche Produkt-Kategorien bei CHIP gelistet werden können
4.3
Ansprechpartner bei CHIP
Chip Digital GmbH - Spezifikation für die Datenintegration
Letzte Änderung: 08.03.2016
1. Allgemeine Informationen
1.1
CHIP bietet zwei Datei-Formate an
Der CHIP Preisvergleich stellt Ihnen zwei Möglichkeiten des Daten-Imports zur Verfügung. Neben
dem Listing Ihrer Angebote über eine Standard CSV-Datei können Sie auch Delta-Feeds nutzen,
mit denen zum Beispiel Anbieter wie Amazon Angebote schnell und mit aktuellen Preisen in
Preissuchen bringen. Weitere Informationen zu den Delta-Feeds finden Sie unter Punkt 3.
2.
Standard CSV-Format
2.1
Schnittstellenbeschreibung
Einleitung:
Die Besucher des CHIP Preisvergleichs (www.chip.de/preisvergleich) sollen die Möglichkeit haben,
direkt per Klick von dem für sie attraktivsten Angebot auf die entsprechende Seite Ihres OnlineShops zu gelangen. Dafür müssen Sie eine Datei bereitstellen, die alle wichtigen Informationen zu
den Angeboten enthält, z.B. Preis, Deeplink, EAN etc.
Das benötigte Datei-Format sowie die Übergabe der Daten wird im Folgenden beschrieben.
Dateiformat der Angebotsdatei

Format: ASCII oder ISO8859-1 oder UTF Textdatei (Bitte vor der Integration angeben was
von beidem geliefert wird)

Datei-Name in Kleinbuchstaben: partnername.csv (partnername darf keine Sonderzeichen
enthalten. Wenn Ihr Shop z.B. PC-Shop GmbH heißt, nennen Sie die Datei pcshop.csv)
3

Datei-Endung: .csv oder .txt

Variable Feldlänge

Feldtrennzeichen: Semikolon (;) TAB ( ) oder Pipe (|)

Das Feldtrennzeichen darf nicht innerhalb eines Feldes vorkommen

Feldnamen (Spaltenüberschriften) in der ersten Zeile der Datei

Zu übermittelnde Daten beginnen ab Zeile 2 der Datei

Innerhalb der Felder dürfen keine HTML-Tags vorkommen.
Angebotsdatei, tabellarisch dargestellt
Die erforderlichen Spalten werden wie folgt nach Priorität dargestellt:
Prio A Spalten:
Diese Spalten sind zwingend erforderlich. Fehlt auch nur eine davon, ist
eine Integration in den CHIP Preisvergleich nicht möglich.
Prio B Spalten:
Für eine qualitativ einwandfreie Zuordnung sollten diese Spalten vorhanden
sein, sind aber nicht Pflicht.
Prio C Spalten:
Sonstige Spalten die möglicherweise in Zukunft eine Rolle im CHIP
Preisvergleich spielen. Keine Pflichtspalten.
Prio A Spalten:
Feldname
PRODUKT_ID
PRODUKT_NAME
Beschreibung
Typ
Produkt ID - Eineindeutige Bestellnummer
des Produkts in Ihrem Shop-System
(Händler Produkt Code). WICHTIG: Bitte
Text (max. 100
darauf achten, dass dieser Code nicht für
Zeichen)
andere Angebote wieder verwendet wird. Es
kann sonst zu unerwünschten
Fehlzuordnungen kommen.
Typenbezeichnung des angebotenen
Produkts ohne Herstellername, z.B.
Text (max. 255
LaserJet 1220. Genaue Modellbezeichnung Zeichen)
beachten.
Text (max. 255
Zeichen)
HERSTELLER
Herstellername, z.B. Hewlett Packard
KATEGORIE_PFAD
Produktkategorie des angebotenen
Text (max. 255
Produkts. So genau und tief wie möglich bis
Zeichen)
in die entsprechende Sub-Kategorie.
PREIS
Angebotspreis inkl. MwSt.
VERSANDKOSTEN
LIEFERZEIT
Falls in mehreren Spalten angegeben
(Vorkasse, Nachnahme etc.), bitte angeben
welcher Wert bevorzugt angezeigt werden
soll
Angabe ich welchem Zeitraum das Angebot
beim Kunden sein wird.
Handlungsempfehlung
Zahl (siehe 1.3
Formatierung von
Preisen)
Text (max. 100
Zeichen)
Text (max. 100
Zeichen)
EAN
EAN-Nummer ² (8-/13-stellig) des
angebotenen Produkts
Zahl (8 oder 13
Zeichen)
HPC / MPN
Hersteller Produkt Code. Vom Hersteller
vergebene, eineindeutige Produktnummer.
Auch MPN genannt (manufacturer part
number)
Text (max. 255
Zeichen)
DEEPLINK
Link in Ihren Shop, der direkt zu dem in
diesem Datensatz beschriebenen Angebot
führt. Beginnend mit http:// oder https://
Text
Chip Digital GmbH - Spezifikation für die Datenintegration
Letzte Änderung: 08.03.2016
ENERGIEEFFIZIENZKLASSE
A+++, B, C, usw.
Text
Prio B Spalten:
Feldname
Beschreibung
Typ
BESCHREIBUNG
Ausführliche Beschreibung des Angebots,
z.B. HP LaserJet 1220 mit 1.200x1.200dpi, Text
USB.
BILD
Link zum Bild des angebotenen Produkts.
Beginnend mit http:// oder https://
WAEHRUNG
Währung (für alle Preise). 3stelliges
Währungsformat nach ISO 4217 (z.B. EUR, Text (max. 3 Zeichen)
USD) ¹
WARENZUSTAND
Neu, gebraucht, refurbished, B-Ware usw. Text
Text
Prio C Spalten:
Feldname
Beschreibung
Typ
FARBE
Rot, grün usw.
Text
STÜCKZAHL
Anzahl der noch lagernden Ware
Zahl
GUTSCHEIN
Gutscheincode bzw. Informationen zu einer
möglichen Ermäßigung für von CHIP
Text (max. 3 Zeichen)
kommende User
¹
²
http://de.wikipedia.org/wiki/ISO_4217#Aktuell_g.C3.BCltige_W.C3.A4hrungen
http://de.wikipedia.org/wiki/European_Article_Number
Beispiel für Angebotsdatei (mustershop.csv):
5
PRODUKT_ID;PRODUKT_NAME;KATEGORIE_PFAD;HERSTELLER;EAN;HPC;BESCHREIBUNG
;DEEPLINK;PREIS;WAEHRUNG;BILD;VERSANDKOSTEN;LIEFERZEIT
123;Musterprodukt 111;Kommunikation/Handys;Nokia;0805931009029;P80900DE; Nokia N97
weiss Quad-Band, UMTS, GPRS, A-GPS, E-Mail, 5.0 Megapixelkamera, 4x Digitalzoom, LED-Blitz,
MP3-Player;http://www.mustershop.de/shop/product-id=123;420,21;EUR;
http://www.mustershop.de/prodpic/123.jpg;5,95;1 - 2 Wochen
456;Musterprodukt 222;Foto & Video/Digitalkameras;Hewlett Packard;0808736469777;
Q2214A#ACT;Hewlett Packard Photosmart 935 Digitalkamera: Mio. Pixel, 3x opt. Zoom + 7x Digital
Zoom, 32 MB SD Speicherkarte sowie SD-/MMC Kartensteckplatz, 3,8 cm LCD Display, USB
2.0,Softwarepaket; http://www.mustershop.de/shop/product-id=456;342,01;EUR;
http://www.mustershop.de/prodpic/456.jpg;5,95;versandfertig in 4 - 7 Tagen
Formatierung von Preisen

Komma (,) als Dezimaltrennzeichen

Kein Tausendertrennzeichen

Keine Währungsangabe in diesem Feld (Diese Information wird in einem separaten Feld
verwaltet)

Einheitlich zwei Nachkommastellen (ggf. 00)

Mindestens eine Stelle vor dem Komma befüllt (ggf. mit 0)

Zulässige Zeichen: „0“-„9“ + „,“

Beispiele für Preise: „149,95“, „1369,00“, „0,99“
Beispiele:
Inhalt einer übermittelten Datei (Auszug)
BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN
Nokia N97;1234,56;EUR;3 Werktage
BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN
Nokia N97;1234.56 ;EUR;3 Werktage
BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN
Nokia N97;1.234,56;EUR;3 Werktage
Kommentar
OK – entspricht den Spezifikationen
Fehler: Falsches Dezimaltrennzeichen
Fehler: Tausendertrennzeichen verwendet
BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN
Nokia N97;1234,56EUR;EUR;3 Werktage
Fehler: Währungsangabe bei der Zahl
BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN
Nokia N97;,99;EUR;3 Werktage
Fehler: Preis von 99 Cents ohne führende
Null – Richtig wäre 0,99 gewesen.
BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN
Nokia N97;1234;EUR;3 Werktage
Fehler: Preis von EUR 1234 ohne
Nachkommastellen – Richtig wäre 1234,00
gewesen
Chip Digital GmbH - Spezifikation für die Datenintegration
Letzte Änderung: 08.03.2016
2.2
Übergabe der Daten
Sie können die Angebotsdatei (partnername.csv) entweder selbst per FTP auf den CHIP-Server
hochladen oder die Daten von Ihrem Server per FTP/HTTP bereitstellen.
FTP-Upload auf den CHIP-Server
Im ersten Fall erhalten Sie die Adresse des CHIP-FTP-Servers sowie die Zugangsdaten (Login,
Passwort). Mit diesem Zugang gelangen Sie direkt in Ihr Partnerverzeichnis, in dem Sie Ihre Datei
abspeichern, überschreiben oder löschen können. Beim Transfer der Daten ist unbedingt darauf zu
achten, dass die Daten im ASCII-Modus (Modus für Textdateien) und nicht im Binary-Modus
übertragen werden.
Bereitstellung der Daten per HTTP/FTP von Ihrem Server
Sie stellen die Angebotsdatei auf einer URL oder in einem per FTP zugänglichen Verzeichnis auf
Ihrem Server zur Verfügung. CHIP holt die Datei in regelmäßigen Abständen (in der Regel
stündlich) ab. Die erforderlichen Daten für den Download, z.B. HTTP-Link oder FTP-Adresse/Zugang teilen Sie uns bitte vor der Integration mit.
WICHTIG: Zusätzliche Informationen zum down- bzw. upload
Sollten Sie innerhalb des laufenden Vertrags Ihre Datei temporär nicht zur Verfügung stellen, bzw.
die Datei von unserem FTP-Server löschen, hat dies keine Auswirkungen auf die bisher online
angezeigten Angebote. Eine Fallback-Lösung sorgt dafür dass die Angebote der zuletzt
funktionieren Datei weiterhin online bleiben. Möchten Sie kündigen oder Ihre Angebote kurzfristig
deaktivieren, informieren Sie uns bitte schriftlich oder telefonisch.
2.3
Beispieldatei
www.chip.de/preisvergleich/beispiel_datei
2.4
Dateigröße
Maximale Dateigröße:
1GB
Maximale Anzahl an Zeilen:
500.000
7
3.
Delta-Feeds-Format
3.1
Grundlegendes
Die Spezifikation der Delta Feeds im CSV – Format für den CHIP Preisvergleich soll die vom BGH im
1
Urteil vom 11. März 2010 (Az: I ZR 123/09) geforderte „höchstmögliche Aktualität“ der Preise
gewährleisten.
Grundsätzlich haben alle Angaben aus der „Spezifikation für das CSV-Format“ für den CHIP
Preisvergleich weiterhin bestand. Die Spezifikation der Delta Feeds ist lediglich eine Erweiterung
der in der o.g. festgelegten Spezifikationen.
1
http://www.shopbetreiber-blog.de/2010/08/25/bgh-urteil-im-volltext-preise-in-suchmaschinen-mussenaktuell-sein/
Chip Digital GmbH - Spezifikation für die Datenintegration
Letzte Änderung: 08.03.2016
3.2
Funktionsweise
Im Gegensatz zum üblichen CSV Import bestehen die Delta Feeds nicht mehr nur noch aus einer
Datei, sondern aus einer Basis Datei, die nur gelegentlich (z.B. alle 7 Tage) erstellt wird, sowie
Delta Dateien, die nur noch die neuesten Änderungen seit der letzten Datei (egal ob Basis oder
Delta!) beinhalten und dadurch unsererseits wesentlich schneller importiert werden können.
Welche Auswirkungen das auf den Import der Angebote hat, sehen Sie im folgenden
Diagramm:
9
3.3
Schnittstellenbeschreibung
Um die Delta Feeds im CHIP Preisvergleich nutzen zu können, benötigen Sie neben den weiterhin
gültigen Spezifikationen aus der „Spezifikation für das CSV-Format“ folgende Änderungen:
1. Einen Feedindex, in dem alle aktuellen Basis- und Delta – Dateien aufgeführt sind
2. Eine zusätzliche Spalte „DELTA“ in den CSV Dateien
3. Fest definierte Dateinamen mit variablen Anteilen
Feedindex
Der Feedindex ist notwendig, damit unser Import weiß welche Dateien bei Ihnen aktuell importiert
sein müssen, um auf dem aktuellsten Stand zu sein. Wurden unsererseits zum Beispiel bereits die
Basis Datei und 2 Delta Feeds importiert und es kommt ein dritter Delta Feed hinzu, so muss der
Feedindex die Informationen für die Basis Datei sowie die 3 Delta Dateien beinhalten.
Der Feedindex ist eine eigene CSV Datei, mit folgenden Eigenschaften:
-
Keine Spaltenüberschriften
-
Feldtrennzeichen: TAB
-
Zeichen für String – Kapselung: Keines
Der Feedindex muss aus 4 Spalten bestehen, die folgende Informationen beinhalten:
-
Dateiname
-
Timestamp der Datei
-
MD5 Hash der Datei
-
Dateigröße in Bytes
Ein Beispiel für einen Feedindex finden Sie unter folgendem Link zum download:
http://www.chip.de/preisvergleich/feedindex
Wenn Sie nun eine neue Basis – Datei (z.B. 7 Tage später) erstellen, dann sollte die bisherige Basis
– Datei sowie alle dazugehörigen Delta – Dateien nicht mehr im Feedindex auftauchen!
Chip Digital GmbH - Spezifikation für die Datenintegration
Letzte Änderung: 08.03.2016
Zusätzliche Spalte „DELTA“
Zusätzlich zu den Spalten, die sie in Punkt 1.2 der „Spezifikation für das CSV – Format“ finden,
benötigen Sie für die Delta Feeds eine zusätzliche Spalte „DELTA“, die angibt ob sich ein Datensatz
geändert hat oder ob er gelöscht wurde. Diese Spalte muss in Basis- und Delta – Datei immer
vorhanden sein!
Während die Delta Spalte in Basis – Dateien immer leer sein muss, muss sie in den Delta Dateien
einen der folgenden 2 Werte einnehmen:
ADD
Das Angebot hat sich verändert oder ist neu hinzugekommen
REMOVE
Das Angebot existiert nicht mehr
Angelehnt an das Beispiel aus Punkt 1.2 der „Spezifikation für das CSV – Format“ ein Beispiel für
eine Angebotsdatei mit Deltas:
PRODUKT_ID;PRODUKT_NAME;KATEGORIE_PFAD;HERSTELLER;EAN;HPC;BESCHREIBUNG
;DEEPLINK;PREIS;WAEHRUNG;BILD;VERSANDKOSTEN;LIEFERZEIT;DELTA
123;Musterprodukt 111;Kommunikation/Handys;Nokia;0805931009029;P80900DE; Nokia N97
weiss Quad-Band, UMTS, GPRS, A-GPS, E-Mail, 5.0 Megapixelkamera, 4x Digitalzoom, LED-Blitz,
MP3-Player;http://www.mustershop.de/shop/product-id=123;420,21;EUR;
http://www.mustershop.de/prodpic/123.jpg;5,95;1 - 2 Wochen
456;Musterprodukt 222;Foto & Video/Digitalkameras;Hewlett Packard;0808736469777;
Q2214A#ACT;Hewlett Packard Photosmart 935 Digitalkamera: Mio. Pixel, 3x opt. Zoom + 7x Digital
Zoom, 32 MB SD Speicherkarte sowie SD-/MMC Kartensteckplatz, 3,8 cm LCD Display, USB
2.0,Softwarepaket; http://www.mustershop.de/shop/product-id=456;342,01;EUR;
http://www.mustershop.de/prodpic/456.jpg;5,95;versandfertig in 4 - 7 Tagen;ADD
Dateinamen
Zur Verwendung der Deltafeeds müssen ihre Basis- und Delta – Dateien ein bestimmtes
Namensschema beachten.
Basis – Dateien
[shopname]_[datum|YYYYMMDD].base.csv
Die Variable [feedname] sollte den Namen ihres Shops beinhalten, [datum] das Datum im
Format YYYYMMDD an dem Sie die Basis Datei erstellt haben.
Eine Basis Datei, die am 28. September 2010 erstellt wurde, würde also folgendermaßen
aussehen:
mustershop_20100928.base.csv
11
Delta – Dateien
[shopname]_[datum|YYYYMMDD]_[nr].delta.csv
Die Variable [shopname] enthält wie bei den Basis – Dateien erneut Shopnamen, [datum] das
Datum, an dem der Basis Feed erstellt wurde. Die Variable [nr] ist eine forlaufende Nummer zur
Angabe um den wievielten Delta Feed zur aktuellen Basis Datei es sich handelt, anfangend bei 1.
Die erste Delta Datei zur Basis – Datei aus 2.3.1 lautet also:
mustershop_20100928_1.delta.csv
Die 142. Delta Datei, die mehrere Tage nach der Basis Datei erstellt wurde sieht folgendermaßen
aus:
mustershop_20100928_142_delta.csv
Beispiele für Basis und Delta – Dateien finden Sie unter den folgenden Links zum
download:
http://www.chip.de/preisvergleich/base
http://www.chip.de/preisvergleich/delta
Weitere Hinweise
Bitte achten Sie darauf, dass Basis- und Delta-Dateien zu jeder Zeit dieselbe Spaltenanzahl,
Spaltenreihenfolge und außerdem zu jeder Zeit dasselbe Feldtrennzeichen sowie Zeichen zur String
– Kapselung aufweisen.
3.4
Bereitstellung der Dateien
Feedindex, sowie Basis- und Deltadateien müssen sich auf Ihrem Server stets im selben
Verzeichnis befinden, es empfiehlt sich von daher ggf. einen Unterordner für die Feeds anzulegen.
Damit wir mit der Integration Ihrer Delta Feeds beginnen können, benötigen wir von Ihnen nur
noch die URL zum Feedindex, zum Beispiel: http://www.mustershop.de/csv/feedindex.csv
Bitte stellen Sie außerdem sicher, dass der Feedindex nur Dateien aufführt, die auch vollständig
heruntergeladen werden können.
Chip Digital GmbH - Spezifikation für die Datenintegration
Letzte Änderung: 08.03.2016
4.
Weitere Informationen
4.1
Shop-Logo
Bitte in jedem Fall vor der endgültigen Integration in der Größe 96x31 px anliefern (png, jpg, gif)
Außerdem benötigen wir ein hochauflösendes png. Hier gilt: Je größer, desto besser.
4.2
Produkt Kategorien im CHIP Preisvergleich
Unter folgender URL können Sie sehen welche Produkt Kategorien bei uns gelistet werden können.
www.chip.de/preisvergleich/kategorie_uebersicht
4.3
Ansprechpartner bei CHIP
E-Commerce Manager:
Category Manager:
Frank Wierschem
CHIP Digital GmbH
St.-Martin-Straße 66
81541 München
Martin Nowakowsky
CHIP Digital GmbH
St.-Martin-Straße 66
81541 München
Telefon: 089/74642-127
Fax: 089/74642-261
eMail: [email protected]
Telefon: 089/74642-221
Fax: 089/74642-261
eMail: [email protected]
Bei Fragen stehen wir Ihnen gerne zur Verfügung.
13

Download Report