3 Datenaufbereitung Etappe 3

CSV / TXT

XLSX

Andere Formate in Absprache möglich aber nicht empfohlen

• Dateinamen bei initialer Konfiguration - ohne Leerzeichen / Sonderzeichen / Umlaut

• Dateinamen bei Fileupdates - die Dateien müssen bei jeder Übermittlung durch die alten Dateien ersetzt werden und die exakt gleichen Dateinamen wie die vorhergehenden aufweisen.

Beispiele:

• ProductData_DigitecGalaxus.csv

• PriceData_DigitecGalaxus.xlsx

UTF-8

-

Andere Zeichencodierungen in Absprache möglich aber nicht empfohlen

; (Semikolon)

-

Andere Trennzeichen in Absprache möglich

Kopfzeile (Header) mit Spaltenbenennung ist Pflicht

• bei Spaltennamen sind keine Duplikate erlaubt

• Spaltenname muss vorhanden sein

• Spaltennamen dürfen keine Zeilenumbrüche enthalten

 Beispiel XLSX - Umbruch im Header

Nachkommastellen müssen mit einem . (Punkt) oder , (Komma) getrennt werden.

• Beispiel – VatRatePercentage: 8.1

• Tausendertrennzeichen sind nicht erlaubt: 1'000 od. 1,000

•  Komma darf nicht verwendet werden, wenn das Trennzeichen im CSV auch Komma ist.

Zeichenketten/Strings (Datentyp: Text) müssen innerhalb von Anführungszeichen (") stehen.

-

Bei Beschreibungen und Produktdaten ist es besonders wichtig, dass diese in Anführungszeichen stehen, weil sie die auch als Trennzeichen fungierende Zeichen (Semikolon, Komma, Pipe) und/oder Zeilenumbrüche enthalten können, die, wenn unmaskiert, den Import verhindern.

Im Beispiel sieht man die korrekte Maskierung von Zollangaben, so auch die Maskierung von den in den Texten vorkommenden Anführungszeichen.

• LongDescription_de: "Fernseher mit der Grösse 46"" und Standfuss mit weisser Aufschrift ""Kings of E-Commerce"""

Die Strukturierung der Daten innerhalb der Textdatei muss eingehalten werden.

• Die einzulesenden Daten befinden sich in der ersten Blattregisterkarte und es sind keine versteckten Blattregisterkarten vorhanden

• Komplett leeren Zeilen oder Notizen im File sollten möglichst vermieden werden

Wissenschaftliche Notationen sind nicht erlaubt

Häufig werden csv-Dateien in Excel geöffnet und gespeichert. Dieser Vorgang ändert die Struktur der im File enthaltenen Zahlen. Informationen wie Gtin, Artikelnummer und andere werden dadurch unbrauchbar. Siehe Beispiel:

 Beispiel - Wissenschaftliche Notation

-

• Zellen mit nummerischen Werten dürfen nur im Standard- oder Zahlen-Format sein. Andere Formate, wie z.B. Buchhaltung oder Benutzerdefiniert, sind nicht erlaubt

• Excel streicht führende Nullen bei Zahlen, was zu Problemen führen kann, vor allem bei Artikelnummern oder GTINs. Bei so einem Fall soll der Partner die betroffen Spalte als Text formatieren

Option 1: YYYY-MM-DD

Option 2: DD.MM.YYYY

• Einstellige Tage/Monate müssen mit einer führenden Null ergänzt werden, Bsp: 2020-07-01 oder 01.07.2020.

• Trennzeichen sind den Formaten entsprechend zu verwenden.

• Str: String, Text

• Int: Integer, Ganzzahl

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

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

• Dec: Decimal, Dezimalzahl

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

• Date: Datum

-

Hinter dem Datentyp wird in Klammern der zulässige Zahlenbereich, die Anzahl Zeichen oder das Format angegeben.

• (10): Maximal 10 Ziffern oder Zeichen sind zugelassen.

• (10,4): Maximal 10 Vor- und 4 Nachkommastellen sind zugelassen.

• (8-14): Zwischen 8 und 14 Ziffern oder Zeichen sind zugelassen.

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

*_index: Beschreibt eine fortlaufende Nummerierung von Spalten gleichen Inhalts.

ImageUrl_1, ImageUrl_2

*_language: Beschreibt die Sprachenkennzeichnung von sprachenabhängigen Spalten gleichen Inhalts. (Nach Standard ISO 639-1)

ProductTitle_de, ProductTitle_en

*_currency: Beschreibt die Kennzeichnung der Währung von Preisspalten. Preise können in CHF oder in EUR angegeben werden.

SalesPriceExclVat_CHF, PurchasePriceExclVat_EUR

*_unit: Beschreibt die Kennzeichnung der Einheiten von dimensionsspezifischen Spalten. Die zulässigen Einheiten sind in den entsprechenden Spalten angegeben.

Weight_g, Length_cm

*_country: Beschreibt die Länderkennzeichnung von länderspezifischen Spalten. (Nach Standard ISO 3166 ALPHA-2)

ReleaseDate_CH, ReleaseDate_DE