Chip Digital GmbH - Spezifikation für die Datenintegration Letzte Änderung: CHIP Preisvergleich. Spezifikation für die Datenintegration

Transkript

1 CHIP Preisvergleich Spezifikation für die Datenintegration 1

2 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

3 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 Standard CSV-Format 2.1 Schnittstellenbeschreibung Einleitung: Die Besucher des CHIP Preisvergleichs ( sollen die Möglichkeit haben, direkt per Klick von dem für sie attraktivsten Angebot auf die entsprechende Seite Ihres Online- Shops 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 ISO 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) 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. 3

4 Angebotsdatei, tabellarisch dargestellt Die erforderlichen Spalten werden wie folgt nach Priorität dargestellt: Prio A Spalten: Prio B Spalten: Prio C Spalten: Diese Spalten sind zwingend erforderlich. Fehlt auch nur eine davon, ist eine Integration in den CHIP Preisvergleich nicht möglich. Für eine qualitativ einwandfreie Zuordnung sollten diese Spalten vorhanden sein, sind aber nicht Pflicht. Sonstige Spalten die möglicherweise in Zukunft eine Rolle im CHIP Preisvergleich spielen. Keine Pflichtspalten. Prio A Spalten: Feldname Beschreibung Typ Produkt ID - Eineindeutige Bestellnummer des Produkts in Ihrem Shop-System PRODUKT_ID (Händler Produkt Code). WICHTIG: Bitte Text (max. 100 darauf achten, dass dieser Code nicht für andere Angebote wieder verwendet wird. Es kann sonst zu unerwünschten Fehlzuordnungen kommen. PRODUKT_NAME HERSTELLER Typenbezeichnung des angebotenen Produkts ohne Herstellername, z.b. LaserJet Genaue Modellbezeichnung beachten. Herstellername, z.b. Hewlett Packard Text (max. 255 Text (max. 255 KATEGORIE_PFAD PREIS VERSANDKOSTEN LIEFERZEIT Produktkategorie des angebotenen Text (max. 255 Produkts. So genau und tief wie möglich bis in die entsprechende Sub-Kategorie. Zahl (siehe 1.3 Angebotspreis inkl. MwSt. Formatierung von Preisen) Falls in mehreren Spalten angegeben (Vorkasse, Nachnahme etc.), bitte angeben Text (max. 100 welcher Wert bevorzugt angezeigt werden soll Angabe ich welchem Zeitraum das Angebot beim Kunden sein wird. Handlungsempfehlung Text (max. 100 EAN HPC / MPN DEEPLINK EAN-Nummer ² (8-/13-stellig) des angebotenen Produkts Hersteller Produkt Code. Vom Hersteller vergebene, eineindeutige Produktnummer. Auch MPN genannt (manufacturer part number) Link in Ihren Shop, der direkt zu dem in diesem Datensatz beschriebenen Angebot führt. Beginnend mit oder Zahl (8 oder 13 Text (max. 255 Text

5 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, USB. Text BILD Link zum Bild des angebotenen Produkts. Beginnend mit oder Text WAEHRUNG Währung (für alle Preise). 3stelliges Währungsformat nach ISO 4217 (z.b. EUR, Text (max. 3 USD) ¹ WARENZUSTAND Neu, gebraucht, refurbished, B-Ware usw. 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 kommende User Text (max. 3 ¹ ² Beispiel für Angebotsdatei (mustershop.csv): 5

6 PRODUKT_ID;PRODUKT_NAME;KATEGORIE_PFAD;HERSTELLER;EAN;HPC;BESCHREIBUNG ;DEEPLINK;PREIS;WAEHRUNG;BILD;VERSANDKOSTEN;LIEFERZEIT 123;Musterprodukt 111;Kommunikation/Handys;Nokia; ;P80900DE; Nokia N97 weiss Quad-Band, UMTS, GPRS, A-GPS, , 5.0 Megapixelkamera, 4x Digitalzoom, LED-Blitz, MP3-Player; Wochen 456;Musterprodukt 222;Foto & Video/Digitalkameras;Hewlett Packard; ; 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; 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; ;EUR;3 Werktage BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN Nokia N97;1.234,56;EUR;3 Werktage BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN Nokia N97;1234,56EUR;EUR;3 Werktage BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN Nokia N97;,99;EUR;3 Werktage BESCHREIBUNG;PREIS;WAEHRUNG;VERSANDKOSTEN Nokia N97;1234;EUR;3 Werktage Kommentar OK entspricht den Spezifikationen Fehler: Falsches Dezimaltrennzeichen Fehler: Tausendertrennzeichen verwendet Fehler: Währungsangabe bei der Zahl Fehler: Preis von 99 Cents ohne führende Null Richtig wäre 0,99 gewesen. Fehler: Preis von EUR 1234 ohne Nachkommastellen Richtig wäre 1234,00 gewesen

7 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 Dateigröße Maximale Dateigröße: 1GB Maximale Anzahl an Zeilen:

8 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 Urteil vom 11. März 2010 (Az: I ZR 123/09) 1 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

9 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 9 Diagramm:

10 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: 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!

11 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 REMOVE Das Angebot hat sich verändert oder ist neu hinzugekommen 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; ;P80900DE; Nokia N97 weiss Quad-Band, UMTS, GPRS, A-GPS, , 5.0 Megapixelkamera, 4x Digitalzoom, LED-Blitz, MP3-Player; Wochen 456;Musterprodukt 222;Foto & Video/Digitalkameras;Hewlett Packard; ; 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; 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_ base.csv 11

12 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 lautet also: mustershop_ _1.delta.csv Die 142. Delta Datei, die mehrere Tage nach der Basis Datei erstellt wurde sieht folgendermaßen aus: mustershop_ _142_delta.csv Beispiele für Basis und Delta Dateien finden Sie unter den folgenden Links zum download: 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: Bitte stellen Sie außerdem sicher, dass der Feedindex nur Dateien aufführt, die auch vollständig heruntergeladen werden können.

13 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 Ansprechpartner bei CHIP E-Commerce Manager: Category Manager: Frank Wierschem Martin Nowakowsky CHIP Digital GmbH CHIP Digital GmbH St.-Martin-Straße 66 St.-Martin-Straße München München Telefon: 089/ Telefon: 089/ Fax: 089/ Fax: 089/ Bei Fragen stehen wir Ihnen gerne zur Verfügung. 13