Schnittstellenbeschreibung, Schnittstellendefinition

Schnittstellenspezifikation für Händler-Datenfeed

2018-10-02 Für die Listung von Produkten in dem Widget "Lokale Händler" und ggf. zusätzlich im Preisvergleich-Widget benötigen wir mindestens einmal pro Tag aktuelle Preisdaten, die uns entweder per FTP übermittelt werden oder die wir vom Server des Händlers abrufen. Denselben Datenfeed können wir bei Bedarf zusätzlich zur Generierung automatischer Produktanzeigen verwenden, die wir per API auf dem Google-Adserver erstellen. (Jan-Markus Rupprecht)

Formatdefinition

Format: CSV
1. Zeile Definition
Felder jeweils in Anführungszeichen "
Trennzeichen: Pipe |
Dateikodierung: UTF-8
Reihenfolge: beliebig

Pflichtfelder

EAN: EAN des Produktes, dient zur Verknüpfung, muss eine "echte" EAN des Produkts sein (auch bei Gebrauchtgeräten/Vorführgeräten), die auch tatsächlich genau dem Produkt entspricht. Bei selbstgebauten Bundles oder Gebrauchtgeräten mit abweichendem Lieferumfang muss dieses Feld leer sein oder durch 0000000000000 gefüllt werden. Fantasie-EANs sind in dieser Spalte zu vermeiden, da diese zu automatischem Falsch-Mapping führen können.
z. B. "0018208947621"
Name: Produktname; z. B. "Nikon D 5500 schwarz + AF-P 18-55 VR Kit"
Hersteller: Hersteller bzw. Marke
z. B. "Nikon"
Lagerbestand: Anzahl vorrätige Artikel (alles größer 0 wird als vorrätig betrachtet); z. B. "1"
Preis: Preis in Euro ("0,00" führt dazu, dass für den Artikel im Widget kein Preis angezeigt wird); z. B. "729,99"
TimeStamp: Zeitpunkt des Exports der Daten (damit wir sicher sein können, dass die Zeile aktuell ist); Format: dd.MM.yyyy HH:mm:ss oder dd.MM.yyyy HH:mm; z. B. "29.09.2018 15:45:20"
Id: Eindeutige Identifikation eines Produktes. Diese sollte sich nicht ändern über Aktualisierungen des Feeds.; Dieses Feld wurde 2019-05-07 neu hinzugefügt.; z. B. "SK942547"

Zusätzliches Pflichtfeld, wenn der Feed auch für das Preisvergleich-Widget genutzt wird

Produktlink: URL zum Produkt im Onlineshop; z. B. "https://www.haendlerwebsite.de/d5500_kit"

Optionale Felder

Hersteller Artikel Nr: Artikelnummer des Herstellers, eine weitere Chance für uns zur Verknüpfung; z. B. "VBA440K006"

Weitere optionale Felder relevant bei der Erstellung automatischer Anzeigen

MappingEAN: Dient der automatischen Zuordnung für eigene Kits, die nicht dem original Bundle entsprechen oder normal nicht einzeln verfügbaren (entbundelten) Geräten oder Gebrauchtgeräte mit abweichendem Lieferumfang kann hier die EAN des zugehörigen Produktes eingetragen werden, um eine korrekte Zuordnung in den Anzeigen zu ermöglichen, z. B. die EAN des entsprechenden Kameragehäuses oder Standard-Kits. Dieses Feld wurde 2020-02-19 neu hinzugefügt.; z. B. "0018208947621"
Text: Freitext, gefolgt von bis zu 4 weiteren Feldern Text2, Text3, etc. (kann leer gelassen werden)
z. B. "100 € Cashback vom Hersteller bis 31. Januar" oder "Nur heute 10 % Hausmesse-Rabatt!"
Versand: Versandkosten innerhalb Deutschlands in Euro; z. B. "4,99"
Anzeige: Ja/Nein-Feld, ob für dieses Produkt eine Anzeige erstellt werden soll (relevant, wenn einem Datenfeed sowohl für die Händler-Widgets als auch für automatisch im Adserver erstellte Anzeigen dient); "Ja" oder "Nein"
Zustand: Produktzustand; 0 = Neu, 1 = Gebraucht, 2 = B-Ware (Verpackung beschädigt, Lieferumfang u.U. nicht vollständig), 3 = Vorführgerät mit voller Garantie
z. B. "0"

Weitere optionale Felder für das Second-Hand-Widget

ZustandTextKurz: Beschreibung des Zustands als Text,; z. B. "Gut", "Hervorragend", "Defekt, als Ersatzteil", "Neuwertige Kundenretoure"
ZustandTextLang: Eine ausführliche Beschreibung, auch Anmerkungen zu einem anderen Lieferumfang.; z. B. "Dieser Artikel ist in einem gebrauchten Zustand mit starken Gebrauchsspuren. Ein Gummigriff fehlt, aber alle anderen Griffe sind vorhanden und sind in gutem Zustand."