Schnittstellenbeschreibung, Schnittstellendefinition

Schnittstellenspezifikation für Händler-Datenfeed

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."

Foto

URL eines authentischen Fotos des konkreten, gebrauchten Produktes (kein Foto eines Neuproduktes).

Fragen?

Unter den weiterführenden Links finden Sie Beispiel-Dateien für Anzeigen und lokale Shops.

Bei Fragen oder Hinweisen wenden Sie sich bitte direkt an unseren Softwareentwickler Christoph Wagner: cw[at]medianord.de