Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »


Das Ziel der zweiten Integrationsetappe ist die Abbildung ihres Vollsortiments mittels Erweiterung der Stammdaten. Für die Realisierung werden zusätzliche Produktdaten benötigt. Sie dienen der eindeutigen Identifikation, der Kategorisierung und Darstellung der Produkte, damit diese für den Endkunden kaufbar sind. 

Die neuen Dateien oder benötigten Erweiterungen werden in diesem Kapitel dokumentiert. 

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

zurück zu Etappe 1: Angebotserstellung und -zuweisung


Neben den bestehenden Angebotsdaten kommen nun weitere Aspekte in den Stammdaten dazu sowie die Medien zu den Produkten. Wir empfehlen die Medien in einem weiteren separaten File aufzubereiten.

Der Providerkey ist die eindeutige Artikel-Nr. für einen Artikel des Lieferanten/Händler/Provider. Sie wird als Identifikationsnummer verwendet und muss zwingend in allen gelieferten Dateien mitgeliefert werden.


Wir bieten für die Datenaufbereitung diverse Dateiformate an. Wählen Sie den für Ihre Anwendung geeigneten Standard und beachten Sie in der folgenden Übersicht die Anforderungen an die Dateistruktur. Wir empfehlen den CSV-Standard für automatisierte Datenaufbereitungen, während sich bei manuellen Eingriffen in den Dateien eher XLSX-Dateien eignen.

 Klicken Sie hier für die Anzeige der Dateiformate

Type

CSV-Standard

XLSX-Standard

Exception/ Remark / Example

File format

CSV / TXT

XLSX

Other formats possible in consultation but not recommended

File name

  • File names for initial configuration - without spaces / special characters / umlaut.

  • File names for file updates - the files must be replaced by the old files for each transmission and have exactly the same file names as the previous ones.

Examples:

  • ProductData_DigitecGalaxus.csv

  • PriceData_DigitecGalaxus.xlsx

Character coding

UTF-8

-

Other character codes possible in consultation but not recommended

Separator

; (Semicolon)

-

Other limit signs possible in consultation

Header

Header with column designation is mandatory

  • Duplicates are not allowed for column names

  • Column name must be present

  • Column names must not contain line breaks

 Example XLSX - break in Header

Decimals

Decimal places must be separated with a . (dot) or , (comma).

  • Example - VatRatePercentage: 8.1

  • Thousands separators are not allowed: 1000 or 1',00

  • Comma must not be used if the separator in the CSV is also a comma

Text / Parsing

Strings (data type: text) must be enclosed in inverted commas (").

-

In the case of descriptions and product data, it is particularly important that these are enclosed in inverted commas because they can contain the characters that also act as separators (semicolon, comma, pipe) and/or line breaks which, if unmasked, prevent the import.

In the example, you can see the correct masking of inches, as well as the masking of the inverted commas that appear in the texts.

LongDescription_en: "TV with size 46"" and stand with white label ""Kings of E-Commerce""

Strcuture

The structuring of the data within the text file must be observed.

  • The data to be read in is in the first sheet tab and there are no hidden sheet tabs

  • Completely empty lines or notes in the file should be avoided if possible.

 ExampleXLSX - Multiple worksheets
 Example - Empty Line / notes

Scientific notations

Scientific notations are not allowed

Often csv files are opened and saved in Excel. This process changes the structure of the numbers contained in the file. Information such as Gtin, item number and others become unusable as a result. See example:

 Example - Scientific notations

Number format

-

  • ·Cells with numeric values may only be in standard or number format. Other formats, such as accounting or user-defined, are not allowed

  • Excel deletes leading zeros from numbers, which can lead to problems, especially with article numbers or GTINs. In such a case, the partner should format the affected column as text.

 Example - number formats
 Example - Leading zeros

Date

Option 1: YYYY-MM-DD

Option 2: DD.MM.YYYY

  • One-digit days/months must be supplemented with a leading zero, e.g. 2020-07-01 or 01.07.2020.

  • Separators are to be used according to the formats.

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 Sie dazu nähere Erläuterungen und Beispiele.

 Klicken Sie hier für die Anzeige der Dokumentationshinweise

Topic

Designation

Example

Data declaration

  • Str: String, Text

  • Int: Integer, Number

  • Short: (Signed short) 0 - 32'767

  • Ushort: (Unsigned short) 0 - 65’535

  • Dec: Decimal, Number with decimals

  • Bool: Boolean, true/false, 1/0

  • Date: Date

-

Information in brackets

After the data type, the permissible number range, the number of characters or the format is indicated in brackets.

  • (10): A maximum of 10 digits or characters are permitted.

  • (10,4): A maximum of 10 digits before and 4 digits after the decimal point are permitted.

  • (8-14): Between 8 and 14 digits or characters are allowed.

Str(100), Int(5), Dec(8,4)

Indexierung

*_index: Describes a consecutive numbering of columns with the same content.

ImageUrl_1, ImageUrl_2

Sprachen

*_language: Describes the language identification of language-dependent columns with the same content. (following standard ISO 639-1)

ProductTitle_de, ProductTitle_en

Währung

*_currency: Describes how to mark the currency of price columns. Prices can be indicated in CHF or in EUR.

SalesPriceExclVat_CHF, PurchasePriceExclVat_EUR

Einheiten

*_unit: Describes the labelling of the units of dimension-specific columns. The permissible units are indicated in the corresponding columns.

Weight_g, Length_cm

Länder

*_country: Describes the country identification of country-specific columns. (following standard ISO 3166 ALPHA-2)

ReleaseDate_CH, ReleaseDate_DE


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 hier aufgeführten restliche Stammdaten können als Erweiterung der bestehenden Daten betrachtet werden.

Minimalkriterien: Stammdaten

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

ProviderKey

Str(100)
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. Fordern Sie daher für einen reibungslosen Datentransfer GTINs für ihre Produkte an: 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: 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.

Auf Anfrage kann Digitec Galaxus die hausinterne Kategoriestruktur bereitstellen.

Weight_[unit]

Dec(8,4)

Verpackungsgewicht [mg,g,kg]

Verpackungsgewicht: 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_de

Str(100)

Deutscher Artikel-/Produktname

Bereinigter Name des Artikels in der Sprache Deutsch. 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. Beachten Sie unsere Richtlinien zur Datenqualität.

Ergänzende Minimalkriterien für EU-Hub Partner: Stammdaten

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

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})$/

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. 

 Validierung anhand eines Beispiels "Gebundenes Kinderbuch"

CountryOfOrigin

Str(2)

Ursprungsland

Ursprung (Produktionsland) des gelieferten Artikels.

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

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

 Klicken Sie hier für Anzeige der ergänzenden Produktdatenfelder → Herstellernummer, Verpackungsdimensionen, Erscheinungsdatum, Variantennamen, Produktbeschreibung

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

ManufacturerKey

Str(4-50)

Herstellernummer des Artikels

Eindeutige Identifikationsnummer des Herstellers eines Produkts. Die Herstellernummern müssen innerhalb derselben Marke/Hersteller eindeutig sein.

  • Herstellernummern müssen mind. vier Zeichen enthalten.

  • Doppelte Herstellernummer-Marken-Kombinationen werden kategorisch ausgeschlossen.

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

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.

ProductTitle_[language]

Str(100)

Artikelname/Produktname [en,fr,it]

Bereinigter Name des Artikels in einer ergänzenden Sprache 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. Beachten Sie unsere Richtlinien zur Datenqualität.

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

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. Beachten Sie 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

Optionale Kriterien zur künftigen Optimierung der Stammdaten

 Klicken Sie hier um die optionalen Stammdatenfelder anzuzeigen → Garantie- und DOA-Frist, Rückgabeart, Altersbeschränkung

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

WarrantyPeriod

Int(3)

Garantie-Frist

Servicefalltyp: Garantie. Angaben des Herstellers. (in Monaten)

DeadOnArrivalPeriod

Int(3)

DOA-Frist

Servicefalltyp: DOA (Dead on Arrival). Angaben des Herstellers. (in Tagen)

Als DOA-Fall gelten alle unmittelbar erkennbaren Mängel am Produkt, die bei der Auslieferung an den Endkunden bereits bestanden haben oder innerhalb der angegebenen DOA-Frist auftreten.

ReturnType

Int(1)

Rückgabeart

1: BringIn, 2: OnSite, 3: PickUpAndReturn / Angaben des Herstellers

MinimumAge_[country]

Int(2)

Gesetzliche Altersbeschränkung

Gesetzliche Altersbeschränkung (in Jahren)

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

Diese Information können wir zur Zeit nur in den Spezifikationen verarbeiten. Wir bitten daher, die Altersbeschränkung im Spezifikationenfeld in “Etappe 3: Anreicherung Spezifikationen” zu berücksichtigen.


Allgemeine Hinweise zu den Medien

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

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

Minimalkriterien: Medien

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

ProviderKey

Str(100)
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(300)

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.

 Sie können selber keine Bildlinks generieren? Kein Problem!

Folgend finden Sie eine Auswahl an Tools welche Ihnen dies ermöglicht:

https://imageshack.com/

https://imgur.com/

https://i-converter.com/files/jpg-to-url

https://app.photobucket.com/explore

https://postimages.org/

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

ImageURL_[index]

Str(300)

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

Erweiterte Kriterien: Medien

 Klicken Sie hier für Anzeige der ergänzenden Kriterien Medien → Produktlink

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

ProductLink_[language]_[index]

Str(300)

Produktlinks (HTTPS)

Ein Link pro Spalte. Produktlinks können auf Herstellerseiten, Produktreviews etc. verweisen.

  • Links auf Wiederverkaufsplattformen und anderen Onlineshops sind untersagt.

  • "language" im Standard ISO 639-1

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

  • Bsp: ProductLink_de_1, ProductLink_de_2, ProductLink_en_1, ProductLink_en_2,  ...

Optionale Kriterien: Medien

 Klicken Sie hier für Anzeige der optionalen Kriterien Medien → Dokumente, Videos, Zolldokumente

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

ProductShopURL

Str(300)

Produktlink (HTTPS)

Direktlink zum Angebot im Onlineshop des Partners

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)

Videolinks (HTTPS)

Ein Link pro Spalte. Aktuell werden nur YouTube und Vimeo Videolinks unterstützt.

  • Es werden nur offizielle Videos vom Hersteller verwendet (Copyright). Wir zeigen keine Gewalt zu Werbezwecken, weder an Tieren noch an Menschen.

  • "language" im Standard ISO 639-1

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

  • Bsp: VideoURL_de_1, VideoURL_de_2, VideoURL_en_1, VideoURL_en_2,  ...

CustomsDocumentType_[country]

Str(300)

Zolldokument Typ

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

  • Beispiel eines Zolldokumenten Typs: "3LLC.N.O.R.N.N.R.O.A18"

CustomsDocumentURL_[country]

Str(300)

Zolldokumentlink (HTTPS)

Ein Link pro Spalte.

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


  • No labels