2 Datenaufbereitung Etappe 2

2 Datenaufbereitung Etappe 2

DATENINTEGRATION ETAPPE 2

Neues Sortiment

Das Ziel der zweiten Etappe ist die vollständige Erstellung und Anreicherung Ihres Produktportfolios. Dazu gehört die Abbildung Ihres gesamten Sortiments durch erweiterte Stammdaten sowie die Ergänzung der Artikel mit weiterführenden Informationen.

Für die Produkterstellung benötigen wir zusätzliche Produktdaten, die der eindeutigen Identifikation, Kategorisierung und Darstellung der Artikel dienen. Die dafür notwendigen Dateien und Felder werden in diesem Kapitel beschrieben.

Für die Spezifikationen ist ein separate Datei verpflichtend. Eine optionale Accessory-Datei ermöglicht es, Zubehör eindeutig den Hauptartikeln zuzuordnen.

Voraussetzung für die Umsetzung von Etappe 2: Produkterstellung und Anreicherung ist eine abgeschlossene Etappe 1!

zurück zu Etappe 1: Angebotserstzuweisung


DATENAUFTEILUNG

Neben den bestehenden Angebotsdaten kommen nun zusätzliche Aspekte in den Stammdaten hinzu, darunter die Spezifikationen, Medien und Zubehör-Verlinkungen. Die Spezifikationen müssen in einem separaten File dargestellt werden. Zusätzlich empfehlen wir, auch die Medien zu den Produkten sowie weitere relevante Stammdaten in jeweils eigenen, separaten Files aufzubereiten.

Option 1

Option 2

Option 1

Option 2

image-20260123-121434.png

 

image-20260218-065043.png

 

Der Providerkey ist die eindeutige Artikel-Nr. für einen Artikel des Partner. Sie wird als Identifikationsnummer verwendet und muss zwingend in allen gelieferten Dateien mitgeliefert werden. Anhand des Provderkeys werden die Informationen zusammengefasst.

 


HINWEISE ZUR DOKUMENTATION

Die Dokumentation der Datenstruktur weist an diversen Stellen technische Begriffe und Hinweise auf. Diese sind für eine korrekte Datenaufbereitung zentral und vereinfachen – sofern korrekt in den Files umgesetzt – die technische Integration enorm. In der unten aufgeführten Tabelle finden sich dazu nähere Erläuterungen und Beispiele.

 


PRODUKTTYPEN

Ein bestmögliches Shoperlebnis setzt voraus, dass wir die Struktur den Bedürfnissen unserer Kunden anpassen. Daher ändert sich diese permanent. Um einen Überblick über unsere Produkttypen (Kategorien) zu erhalten, kann der Auszug heruntergeladen werden.

Für neues Sortiment ist eine korrekte Produkttyp-Zuweisung von zentraler Bedeutung. Um eine bestmögliche Qualität zu erreichen, empfehlen wir, uns sämtliche Rohdaten zu übermitteln und nicht selbst zu versuchen, auf unsere Kategorien zu mappen. Unsere Produkttyp-KI erzielt die besten Ergebnisse mit Originaldaten.

Download:


DATEISTRUKTUR STAMMDATEN

 

Allgemeine Hinweise zu den Stammdaten

  • Dateiname: ProductData_[ProviderName].[DATEIFORMAT] (Bsp: ProductData_digitecgalaxus.csv)

  • Übermittlungsfrequenz: alle 24 Stunden (optimal: alle 12 Stunden)

  • Mit markierte Informationen sind bereits in den Stammdaten Etappe 1 aufgeführt. Die in Etappe 2 aufgeführten Informationen können als Ergänzung der bereits umgesetzten Produktdaten-Files ergänzt werden.

 

Verwende unsere CSV-Vorlagen

Verwende unsere XLSX-Vorlagen

Minimalkriterien: Stammdaten

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

ProviderKey

Str(50)
ASCII 32-126

Partnerspezifische Artikelnummer

Eindeutige Identifikationsnummer des Partnerartikels.

  • Die Artikelnummern müssen eindeutig sein. Duplikate sind nicht gestattet.

  • Wir erwarten nur Zeichen im Bereich ASCII 32-126

Gtin

Int(8)
Int(12)
Int(13)
Int(14)

 

EAN/GTIN-Code des Artikels

Eindeutige und global gültige Identifikationsnummer des Artikels. Erlaubt sind folgende Datenstrukturen innerhalb der GTIN-Familie:

  • GTIN-12 (UPC), GTIN-13 (EAN-13, ISSN, ISBN), GTIN-14 (EAN/UCC-128 or ITF-14), GTIN-8 (EAN-8)

  • Der EAN/GTIN bildet die Grundlage für unsere automatisierten Zuweisungs- und Produkterstellungsprozesse. Für einen reibungslosen Datentransfer sollten GTINs für die Produkte angefordert werden: GS1 Schweiz: Barcode anfordern, GS1 Deutschland: Barcode anfordern

  • Die EAN/GTINs müssen eindeutig und global gültig sein. Duplikate sind nicht gestattet.

  • Der EAN/GTIN muss auf der Einzelhandelsverpackung sichtbar sein.

  • Weiterführende Informationen zu Gtins und GS1 unter: http://gtin.info oder GS1 Switzerland.

BrandName

Str(100)

Marke / Verlag

Hersteller-Marke des Artikels.

Produkte können nur mit einer zugehörigen Marke erstellt/weiterverarbeitet werden.

CategoryGroup_[index]

Str(200)

Kategoriegruppen des Artikels

Die Kategoriegruppen, beginnend mit der höchsten Ebene CategoryGroup _1, bilden zusammen einen Kategorie-Stammbaum, der den Artikel hierarchisch zuordnet.

  • "index" - Fortlaufende Nummerierung der CategoryGroups, Bsp: CategoryGroup_1, CategoryGroup_2, CategoryGroup_3, …

ProductCategory

Str(200)

Produktkategorie des Artikels

Die Produktkategorie bildet die tiefste (detaillierteste) Ebene des Kategorien-Stammbaums.

  • Es ist nicht zwingend, die Kategorien in der Datenübermittlung exakt gleich zu benennen wie bei Digitec Galaxus. Es kann auch eine partnerspezifische Kategorisierung verwendet werden, woraus Digitec Galaxus automatisiert ein Kategorien-Matching erstellen wird.

PackagingWeight_[unit]

Dec(8,4)

Verpackungsgewicht [mg,g,kg]

Verpackungsgewicht/Bruttogewicht: Produktgewicht plus Originalverpackung einer Einzelhandelsverpackung.

  • Artikel ohne Gewicht werden für EU-Hub Händler kategorisch ausgeschlossen.

  • "unit" - mögliche Einheiten: mg (Milligramm), g (Gramm), kg (Kilogramm)

ProductTitle_[language]

Str(100)

Artikel-/Produktname

Bereinigter Name des Artikels für eine der folgenden Sprachen: Deutsch, Englisch, Französisch oder Italienisch. Produktnamen müssen einheitlich und von Spezifikationen bereinigt sein.

  • Die Qualität der Produktnamen ist für ein einheitliches Auftreten im Online-Shop und die Kaufbarkeit der Produkte entscheidend. Beachte unsere Richtlinien zur Datenqualität.

  • "language" im Standard ISO 639-1, Bsp:

    ProductTitle_de, ProductTitle_en, ProductTitle_fr, ProductTitle_it

CountryOfOrigin

Str(2)

Ursprungsland

Als Ursprungsland gilt das Land, in dem die Ware vollständig gewonnen oder hergestellt oder in dem die letzte wesentliche Verarbeitung durchgeführt wurde.

  • CountryOfOrigin im Standard ISO 3166 ALPHA-2, Bsp: CH, DE

  • Es darf nur ein CountryOfOrigin pro Artikelnummer übermittelt werden

  • Ursprungsregeln: Non-Preferential Rules of Origin

 

Ergänzende Kriterien für EU Partner

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

GPSRNameAddress

Str(300)

Name und Postanschrift des Herstellers

Der Firmenname und die Postanschrift des Herstellers, der das Produkt in den Europäischen Wirtschaftsraum (EWR) einführt.

  • Format: "{Name}, {Straße} {Hausnummer}, {PLZ} {Ort}, {Land}"

  • Beispiel: "Mustermann GmbH, Musterstraße 123A, 12345 Musterstadt, Deutschland"

  • Kommas trennen die verschiedenen Bestandteile der Adresse (Name, Straße und Hausnummer, PLZ und Ort, Land).

  • Leerzeichen trennen Straße und Hausnummer sowie PLZ und Ort.

  • Ländername: Den vollständigen Ländernamen oder den ISO 3166-1 Alpha-2 Code verwenden (z. B. «Deutschland» oder «DE»).

  • Adresszusatz (optional): Falls erforderlich, können zusätzliche Informationen wie «c/o» oder «Etage» nach dem Namen hinzugefügt werden, z. B. «Mustermann GmbH, c/o Max Mustermann, Musterstrasse 123A, 12345 Musterstadt, Deutschland».

GPSREmailUrl

Str(200)

Email-Adresse oder URL

Die E-Mail Adresse oder die URL des Herstellers, der das Produkt in den Europäischen Wirtschaftsraum (EWR) einführt.

  • Die URLs müssen frei zugänglich sein.

WEEENumber

Str(10)

WEEE Nummer

Bsp: “DE12345678”

  • Nur gültige WEEE Nummern übermitteln. Falls der Partner sich wieder vom EAR Register abmeldet (Marktaustritt), so darf die Nummer nicht mehr übermittelt werden.

  • Werden mehrere WEEE Nummern geführt, soll die neueste Nummer übermittelt werden.

Warnhinweise können wie bis anhin über den Eigenschafts Feed übermittelt werden.

Ergänzende Kriterien zur Optimierung der Datenqualität: Stammdaten

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

Length_[unit]

Dec(8,4)

Verpackungslänge

Länge der Originalverpackung

"unit" - mögliche Einheiten: mm (Millimeter), cm (Zentimeter), m (Meter)

Width_[unit]

Dec(8,4)

Verpackungsbreite

Breite der Originalverpackung

"unit" - mögliche Einheiten: mm (Millimeter), cm (Zentimeter), m (Meter)

Height_[unit]

Dec(8,4)

Verpackungshöhe

Höhe der Originalverpackung

"unit" - mögliche Einheiten: mm (Millimeter), cm (Zentimeter), m (Meter)

ReleaseDate_[country]

Date

Erscheinungsdatum

Datumsangabe bei Neuerscheinungen. Das Datum wird im Shop angezeigt.

"country" im Standard ISO 3166 ALPHA-2, Bsp: ReleaseDate_CH

TARESCode

Str(9)

Schweizer Zolltarifnummer (TARES)

TARES Datenbank, Bsp:  "12345678" od. "1234.5678"

  • Die Validierung des Inhalts lässt nur das optionale Zeichen "." (Punkt) zu. Andere Sonderzeichen sind nicht erlaubt.

  • Regex für die Validierung: /^([0-9]{4})\.?([0-9]{4})$/

VariantName

Str(100)

Familienname/Variantenname

Eindeutige Identifikation für zusammengehörige Artikel. Digitec Galaxus verwendet diese Informationen für die Erstellung von Produktvarianten.

Es wird empfohlen den ProductTitle ohne Zusätze zu verwenden da dieser bei vielen Produkte mit Varianten bereits identisch ist.

LongDescription_[language]

Str(4000)

Ausführliche Beschreibung des Artikels [de,en,fr,it]

Ausführliche Beschreibung des Artikels mit relevanten Informationen über das Produkt wie z.B. Grösse, Material, Age Range, besondere Features, technische Spezifikationen, Form, Muster, Stoffart, Design)

  • Die Qualität der Produktbeschreibung ist für ein einheitliches Auftreten im Online-Shop und die Kaufbarkeit der Produkte entscheidend. Beachte unsere Richtlinien zur Datenqualität.

  • Die Produktbeschreibung wird allgemein gehalten und beinhaltet keine Werbetexte oder partnerspezifischen Angaben.

  • Weblinks und bullet points sind nicht erlaubt.

  • Eine der Sprachen Deutsch, Englisch, Französisch oder Italienisch ist Pflicht.

  • "language" im Standard ISO 639-1, Bsp: LongDescription_de, LongDescription_fr

Composition_[language]

Str(4000)

Zusammensetzung [de,en,fr,it]

Beschreibung der Zusammensetzung, bzw. der Inhaltsstoffe eines Produktes. Diese sind bei spezifischen Warengruppen gesetzlich vorgeschrieben, also Compliance-relevant.

  • Dies sind z.B.:

    • Zutatenliste (Alle Zutaten, welche in einem Lebensmittel enthalten sind, müssen ausgewiesen werden)

    • Allergendeklaration (Zutaten und die daraus hergestellten Erzeugnisse die Allergien oder andere unerwünschte Reaktionen auslösen können, müssen speziell ausgewiesen werden)

    • Inhaltsstoffe (z.B. Parfum)

  • Die Qualität der Produkttexte ist für ein einheitliches Auftreten im Online-Shop und die Kaufbarkeit der Produkte entscheidend. Beachte unsere Richtlinien zur Datenqualität.

  • “language” im Standard ISO 639-1, Bsp: Composition_de, Composition_en, Composition_fr

Application_[language]

Str(4000)

Anwendung [de,en,fr,it]

Beschreibung der Anwendung eines Produktes. Diese sind bei spezifischen Warengruppen gesetzlich vorgeschrieben, also Compliance-relevant.

  • Dies betrifft z.B. folgende Warengruppen:

    • Medizinprodukte

    • Arznei

  • Die Qualität der Produkttexte ist für ein einheitliches Auftreten im Online-Shop und die Kaufbarkeit der Produkte entscheidend. Beachte unsere Richtlinien zur Datenqualität.

  • “language” im Standard ISO 639-1, Bsp: Application_de, Application_en, Application_fr

MinimumAge_[country]

Int(2)

Gesetzliche Altersbeschränkung

Gesetzliche Altersbeschränkung (in Jahren)

"country" im Standard ISO 3166 ALPHA-2, Bsp: MinimumAge_DE

TARICCode

Int(6-11) od. Str(14)

Warencode (TARIC) für den EU-Raum

TARIC Datenbank, Besteht normalerweise aus 11 Zeichen (ohne Leerschläge) oder 14 Zeichen (mit Leerschlägen), Bsp: "49019900009" od. "4901 9900 00 9"

Die Validierung des Inhalts lässt nur optionale Leerschläge zu. Andere Sonderzeichen sind nicht erlaubt. Tariccodes mit weniger als 11 Zeichen werden am Ende (rechts) mit Nullen aufgefüllt. 


DATEISTRUKTUR MEDIEN

Allgemeine Hinweise zu den Medien

  • Dateiname: MediaData_[ProviderName].[DATEIFORMAT] (Bsp: MediaData_digitecgalaxus.csv)

  • Übermittlungsfrequenz: alle 48 Stunden (optimal: alle 24 Stunden)

Verwende unsere CSV-Vorlagen

Verwende unsere XLSX-Vorlagen

 

Minimalkriterien: Medien

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

ProviderKey

Str(50)
ASCII 32-126

Partnerspezifische Artikelnummer

Eindeutige Identifikationsnummer des Partnerartikels.

  • Die Artikelnummern müssen eindeutig sein. Duplikate sind nicht gestattet.

  • Wir erwarten nur Zeichen im Bereich ASCII 32-126

MainImageURL

Str(500)

Erster Bilderlink (HTTPS)

Freigestelltes Produktbild mit weissem Hintergrund, möglichst Frontalansicht. Die längste Kante der Bilder muss mindestens 600px sein (ohne Rand um das Produkt). Die Grösse von 8 MB pro Bild darf nicht überschritten werden.

  • Die URL muss frei zugänglich sein.

  • Es werden die Formate JPG, JPEG und PNG unterstützt.

  • Qualitative Anforderungen, bitte Richtlinien zur Datenqualität beachten.

Wir nutzen jeweils das letzte Bildset, das uns übermittelt wird. Sollen Bilder geändert werden, soll darauf geachtet werden, dass neue Bilder eine entsprechende neue URL erhalten. Bereits importierte URLs werden nicht erneut importiert.

Tools:

ImageShack - Best place for all of your image hosting and image sharing needs

Imgur: The magic of the Internet

CONVERT JPG TO URL | free files converter

Private Group Photo & Video Sharing

Postimages — free image hosting / image upload

Digitec Galaxus empfiehlt Ihnen die oben genannten Tools. Es bestehen jedoch keine Abmachungen oder Sonderkonditionen zu den genannten Plattformen.

ImageURL_[index]

Str(500)

Weitere Bilderlinks (HTTPS)

Ein Link pro Spalte. Der Link muss frei zugänglich sein. JPG, JPEG und PNG werden unterstützt. Die längste Kante der Bilder muss mindestens 600px sein (ohne Rand um das Produkt). Die Grösse von 8 MB pro Bild darf nicht überschritten werden.

  • Die URLs müssen frei zugänglich sein.

  • Es werden die Formate JPG, JPEG und PNG unterstützt.

  • Qualitative Anforderungen, bitte Richtlinien zur Datenqualität beachten.

  • "index" - Fortlaufende Nummerierung der Bilder.

  • Bsp: MainImageURL, ImageURL_1, ImageURL _2, ImageURL _3, …, ImageURL_n

Wir nutzen jeweils das letzte Bildset, das uns übermittelt wird. Sollen Bilder geändert werden, soll darauf geachtet werden, dass neue Bilder eine entsprechende neue URL erhalten. Bereits importierte URLs werden nicht erneut importiert.

EnergyLabel

Str(300)

Energielabel Bilderlink (HTTPS)

Ein Link pro Spalte und Angabe Energieeffizienzklasse.

  • Der Link muss frei zugänglich sein. JPG, JPEG und PNG werden unterstützt.

  • Die Energieeffizienzklasse sollte nochmals innerhalb der Specifikationen übermittelt werden

 

Optionale Kriterien: Medien

Folgende Informationen können zur Zeit noch nicht verarbeitet werden. Wir optimieren jedoch laufend unsere technischen Systeme und erweitern die Informationsverarbeitung für entsprechende Felder zu gegebener Zeit. Das Mitliefern der Informationen in den Datenfiles hilft uns dabei die Relevanz und Priorisierung künftiger Erweiterungen besser einzuschätzen.

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

DocumentURL_[language]_[index]

Str(300)

Dokumentlinks (HTTPS)

Ein Link pro Spalte. Dokumentlinks können Gebrauchsanweisungen, Grössentabellen, Sicherheitsdatenblätter etc. beinhalten.

  • "language" im Standard ISO 639-1

  • "index" - Fortlaufende Nummerierung für mehrere URLs in der selben Sprache.

  • Bsp: DocumentURL_de_1, DocumentURL_de_2, DocumentURL_en_1, DocumentURL_en_2,  ...

VideoURL_[language]_[index]

Str(300)