(blue star) Produktdaten

Etappe 2: Produkterstellung (blue star)

DATENINTEGRATION ETAPPE 1

Angebotserstellung und -zuweisung

Durch die Umsetzung dieser Integrationsetappe ermöglichen Sie uns die Erstellung und Zuweisung Ihrer Angebote. Hier profitieren Sie vom bestehenden Produktportfolio unseres Online Shops, indem Ihre Angebotsdaten an bereits gepflegte Produkte angehängt werden (deckendes Sortiment).

Für die Erstellung und Zuweisung der Daten benötigen wir mindestens Ihre Angebotsdaten und die identifizierenden Stammdaten-Merkmale der Produkte. Diese werden nach der Aktivierung mit unserem Produktportfolio automatisiert abgeglichen und zugewiesen. Die Mindestkriterien dabei sind Artikelnummer, Preis, Bestand, und EAN/GTIN.

Wir empfehlen, die Preis- und Bestandesdaten von den übrigen Stammdaten getrennt zu übermitteln (siehe Abbildung 4), da sich so unterschiedliche Uploadfrequenzen konfigurieren lassen und die Datenverarbeitung weniger fehleranfällig ist. Die Artikelnummer des Partnerartikels (ProviderKey) muss dabei in der “führenden Spalte” jedes Datenblatts stehen. Sie gilt als Identifizierungs- und Zuordnungsmerkmal Ihrer Artikel über die gesamte Datenverarbeitungskette hinweg.

Inhalt

DATENAUFTEILUNG

Für eine schnellstmögliche Aufschaltung des deckenden Sortimentes werden die Stammdaten der Artikel sowie Bestandes- und Preisdaten benötigt. Es ist unerlässlich für einen erfolgreichen Datenfluss strukturell stabile Dateien bereitzustellen. Daher wird klar empfohlen, dass diese drei Informationsbereiche in drei separate Files aufgeteilt werden.

Abweichende Files sind für die erste Etappe möglich, sollten aber in den folgenden Etappen der Integration nochmals überarbeitet werden. Die Überarbeitung ist zusätzlicher Aufwand auf beiden Seiten und sollte wenn immer möglich eliminiert werden. 

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. Der Providerkey wird weiter auf allen Bestellungen an Sie als Identifikationsnummer für den Artikel dargestellt. Bereits zugeteilte Artikel-Nummern sollten in keinem Fall für andere Artikel wiederverwendet werden.

SORTIMENTSBESTIMMENDE DATEI

Eines der Files entspricht dem sortimentsbestimmenden File (Assortment-Datei), welches das aktive Sortiment steuert. Es werden nur Artikel aufgeschaltet, die in der "Assortment-Datei" aufgeführt sind. Artikel, die nicht mehr geliefert werden können, müssen in der nächsten Übermittlung mindestens aus der entsprechenden Datei (idealerweise aus allen Files) entfernt werden. Wir empfehlen das Sortiment über die Preisdaten zu steuern.

Die Angabe der "Assortment-Datei" muss im Dateinamen angegeben werden:

  • Bsp: StockData_BeispielAG_assortment.csv

DATEIFORMATE

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.

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

DATEISTRUKTUR PREISDATEN
LIEFERANTENMODELL (Retail / Vendor)

Allgemeine Hinweise zu den Preisdaten

  • Dateiname: PriceData_[ProviderName].[DATEIFORMAT] (Bsp: PriceData_digitecgalaxus.csv)

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

Die Datenaufbereitung der Preisdaten ist abhängig vom Integrationsmodell. Die Anforderungen sind für Lieferanten- (Retail) und Marktplatz-Modelle getrennt aufgeführt!

note

Verwenden Sie unsere CSV-Vorlagen

Verwenden Sie unsere CSV-Vorlagen

note

Verwenden Sie unsere XLSX-Vorlagen

Verwenden Sie unsere XLSX-Vorlagen

Minimalkriterien: Preisdaten Lieferantenmodell (Retail / Vendor)

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

PurchasePriceExclVat_[currency]

Dec(8,4)

Einkaufspeis exkl. MwSt.

Digitec Galaxus seitiger Einkaufspreis exklusive MwSt. und inkl./exkl. Produktgebühren.

  • Die Produktgebühren müssen je nach Firmensitz des Lieferanten in den Preisangaben enthalten sein:

    • Lieferanten mit Firmensitz im selben Land wie die einkaufende Partei: Einkaufspreis inkl. Produktgebühren

    • Lieferanten mit Firmensitz in einem anderen Land wie die einkaufende Partei: Einkaufspreis exkl. Produktgebühren

  • "currency": Angabe der Währung in der Kopfzeile in CHF od. EUR

Ergänzende Kriterien: Preisdaten Lieferantenmodell (Retail / Vendor)

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

SuggestedRetailPriceInclVat_[currency]

Dec(8,4)

Unverbindliche Preisempfehlung inkl. MwSt.

Unverbindliche Preisempfehlung inkl. Mehrwertsteuer.

"currency": Angabe der Währung in der Kopfzeile in CHF od. EUR

VatRatePercentage

Dec(2,2)

Mehrwertsteuersatz

Mehrwertsteuersatz als Zahlangabe ohne %-Zeichen.

Bsp: Schweiz: 8.1, 2.6, 0.0

DATEISTRUKTUR PREISDATEN
MARKTPLATZ

Allgemeine Hinweise zu den Preisdaten

  • Dateiname: PriceData_[ProviderName].[DATEIFORMAT] (Bsp: PriceData_digitecgalaxus.csv)

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

Die Datenaufbereitung der Preisdaten ist abhängig vom Integrationsmodell. Die Anforderungen sind für Retail- und Marktplatz-Modelle getrennt aufgeführt!

note

Verwenden Sie unsere CSV-Vorlagen

Verwenden Sie unsere CSV-Vorlagen

note

Verwenden Sie unsere XLSX-Vorlagen

Verwenden Sie unsere XLSX-Vorlagen

Minimalkriterien: Preisdaten Marktplatz

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

SalesPriceExclVat_[currency]

Dec(8,4)

Verkaufspreis exkl. MwSt.

Verkaufspreis einer Einzelhandelsverpackung (ConsumerUnit, CU) exkl. Mehrwertsteuer.

  • "currency": Angabe der Währung in der Kopfzeile in CHF od. EUR

  • EU-Hub Händler ohne Fiskalvertretung: übermittelt den EUR-Preis

  • EU-Hub Händler mit Fiskalvertretung: übermittelt den CHF-Preis.

VatRatePercentage

Dec(2,2)

Mehrwertsteuersatz

Mehrwertsteuersatz als Zahlangabe ohne %-Zeichen.

  • Bsp: Schweiz: 8.1, 2.6, 0.0

  • EU-Hub Händler ohne Fiskalvertretung: keine Übermittlung eines MwSt-Satzes

  • EU-Hub Händler mit Fiskalvertretung: übermittelt den CH MwSt-Satz.

Optionale Kriterien zur künftigen Optimierung der Preisdaten Marktplatz

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

SalesPriceInclVat_[currency]

Dec(8,4)

Verkaufspreis inkl. MwSt.

Verkaufspreis einer Einzelhandelsverpackung (ConsumerUnit, CU) inkl. Mehrwertsteuer.

  • "currency": Angabe der Währung in der Kopfzeile in CHF od. EUR

  • EU-Hub Händler ohne Fiskalvertretung: übermittelt den EUR-Preis

  • EU-Hub Händler mit Fiskalvertretung: übermittelt den CHF-Preis.

DATEISTRUKTUR BESTANDESDATEN

Allgemeine Hinweise zu den Bestandesdaten

  • Dateiname: StockData_[ProviderName].[DATEIFORMAT] Bsp: StockData_digitecgalaxus.csv)

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

Mengenangaben

  • Alle hier aufgeführten Mengenangaben beziehen sich auf Einzelhandelsverpackungen (ConsumerUnit, CU)

  • Ohne explizite Angaben der Mindestbestellmengen und Bestellmengenschritte werden alle Einzelhandelsverpackungen ohne Mindestmengen verarbeitet. Verpflichtende Bestellmengen (>1) müssen daher zwingend gemäss den unten beschriebenen Feldern “Ergänzende Kriterien zur Optimierung der Verfügbarkeit und Bestellabwickung” angegeben werden.

note

Verwenden Sie unsere CSV-Vorlagen

Verwenden Sie unsere CSV-Vorlagen

note

Verwenden Sie unsere XLSX-Vorlagen

Verwenden Sie unsere XLSX-Vorlagen

Minimalkriteren: Bestandesdaten

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

QuantityOnStock

Int(5)

Genauer Lagerbestand

Wir empfehlen den genauen Lagerbestand zu übermitteln. Dieser Wert hat Einfluss auf die Priorisierung des Händlers/Lieferanten bei der Auswahl von Verkaufsangeboten.

Negative Bestände werden als Rückstände behandelt.

Ergänzende Kriterien zur Optimierung der Verfügbarkeit und Bestellabwickung

Kopfzeile

Datentyp

Bezeichnung

Beschreibung

RestockTime

Int(3)*

Wiederbeschaffungsdauer in Arbeitstage

Wiederbeschaffungs- oder Bereitstellungszeit in Arbeitstage bis zum Zeitpunkt an dem der Artikel wieder an Lager des Partners ist. (RestockDate – today), Nationale Feiertage können vernachlässigt werden

  • *Maximalwert = 365 (1 Jahr)

  • Bei unbekannter Restocktime muss das Feld leer übermittelt werden, der Wert “0” wird als Fehler interpretiert

  • Es kann entweder RestockTime oder RestockDate umgesetzt werden - beide sind technisch nicht möglich.

  • RestockTime oder RestockDaten werden nur berücksichtigt wenn der Lagerbestand 0 ist. Bei positivem Bestand wird der Wert ignoriert.

RestockDate

Date

Wiederbeschaffungsdatum

Datum ab dem der Artikel wieder an Lager des Partners ist.

Wir empfehlen die Angabe der Wiederbeschaffungsdauer bzw. des Wiederbeschaffungsdatum in jedem Fall (unabhängig vom Lagerbestand). Diese Informationen haben Auswirkungen auf die Verfügbarkeit und werden für automatisierte Bestellvorgänge verwendet.

(warning) Es kann entweder RestockTime oder RestockDate umgesetzt werden - beide sind technisch nicht möglich.

(warning) RestockTime oder RestockDaten werden nur berücksichtigt wenn der Lagerbestand 0 ist. Bei positivem Bestand wird der Wert ignoriert.

ExpectedRestockQuantity

Int(5)

Erwartete Wiederbeschaffungsmenge

Der erwartete verfügbare Lagerbestand beim Zeitpunkt an dem der Artikel wieder an Lager beim Partner ist.

Diese Angabe ist nur bei verfügbarem Wiederbeschaffungsdatum relevant und wird künftig für automatisierte Bestellvorgänge verwendet.

MinimumOrderQuantity

Short

Mindestbestellmenge (MOQ)

Die minimal bestellbare Stückzahl von Einzelhandelsverpackungen (Consumer Units). Im Gegensatz zur Umverpackungsmenge (TU) ist die hier angegebene Menge für Lagerlieferungen als auch Endkundenbelieferungen verbindlich. Bsp: MOQ = 5 → mögliche Bestellmengen: 5,6,7,8,…

Grundsätzlich sollte die MOQ > 1 nur aus logistischen Gründen und immer in Kombination mit dem Bestellmengenschritt gesetzt werden. Z.B. wenn Teller oder Gläser aufgrund ihrer Zerbrechlichkeit nicht einzeln transportiert werden können. Sofern ein Einzelversand möglich ist, sollte die MOQ = 1 und anstelle dessen mit eine grössere Umverpackung (TU) angebeben werden.

  • Maximalwert = 32'767

  • Wenn kein MOQ-Wert übermittelt wird, gehen wir von 1 Stück als Standardwert aus.

  • Die Angabe von MOQ < OQS ist nicht valid.

OrderQuantitySteps

Short

Bestellmengenschritt (OQS)

Die minimal bestellbare Stückzahl und Schrittgrösse von Einzelhandelsverpackungen (ConsumerUnits). Im Gegensatz zur Umverpackungsmenge (TU) ist die hier angegebene Menge für Lagerlieferungen als auch Endkundenbelieferungen verbindlich. Bsp: OQS = 5 → mögliche Bestellmengen: 5,10,15,…

Grundsätzlich sollte die OQS > 1 nur aus logistischen Gründen und immer in Kombination mit der Mindestbestellmenge gesetzt werden. Z.B. wenn Teller oder Gläser aufgrund ihrer Zerbrechlichkeit nicht einzeln transportiert werden können. Sofern ein Einzelversand möglich ist, sollte die OQS = 1 und anstelle dessen mit eine grössere Umverpackung (TU) angebeben werden.

  • Maximalwert = 32'767

  • Wenn kein OQS-Wert übermittelt wird, gehen wir von 1 Stück als Standardwert aus.

  • Die Angabe von OQS > MOQ ist nicht valid.

WarehouseCountry

Str(2)

Land des Lagers

Das Land des Lagers, aus dem der Artikel versendet wird. Diese Angabe ist für Sortimente mit mehreren Lagern und unterschiedlicher Lieferdauer relevant.

  • Angabe im Standard ISO 3166-2 Ländercode

WarehouseId

Str(50)

Lager GLN

Die Identifikationsnummer des Lagers. Diese Angabe ist für Sortimente mit mehreren Lagern die sich im selben Land befinden relevant.

  • Global Location Number GLN | GS1 Switzerland

  • Kann keine GLN übermittelt werden, kann auch die Postleitzahl verwendet werden.

DirectDeliverySupported

Bool

Direktlieferung unterstützt

Für Lieferanten mit aktivierter Endkundenbelieferung können einzelne Artikel für die Endkundenbelieferung zugelassen bzw. davon ausgeschlossen werden.

Zulässige Werte: true, false / 1, 0

Optionale Kriterien zur künftigen Optimierung der Bestandesdaten

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

RetailUnitQuantity

Int(4)

Artikel pro Verkaufseinheit

Anzahl Artikel pro Einzelhandelsverpackung.

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

PackagingQuantity

Int(4)

Packstück

Anzahl Pakete pro Einzelhandelsverpackung.

Bsp: 1 Tischplatte (1 Pack) + 4 Tischbeine (1 Pack): PackagingQuantity = 2

ShipmentType

Int(1)

Versandart des Artikels

1: Brief, 2: Paket, 3: Sperrgut, 4: Stückgut

1: Brief → Format B4 (3533 x 250 mm), 501-1000 g
2: Paket → 100 x 60 x 60 cm, bis 30 kg
3: Sperrgut → Länge: 250 cm / Gurtmass: 400 cm (2x Höhe + 2x Breite + längste Seite), bis 30 kg
4: Stückgut → Ab 30 kg

TradeUnit

Ushort

Umverpackungeinheit (TU)

Anzahl Einzelhandels-Artikel (ConsumerUnits) pro Umverpackungsmenge. Die Angabe der TU ist nur für Lagerlieferungen relevant. Bsp: TU = 6 → wahrscheinliche Bestellmengen: 6,12,18,…

Beim Einkauf orientieren wir uns an diesem Wert und bestellen wenn möglich die exakte Umverpackungmenge oder ein Vielfaches davon. Korrekt übermittelte Umverpackungseinheiten (TU) optimieren daher die Lagerlieferungen erheblich.

  • Maximalwert = 65’535

LogisticUnit

Ushort

Palettenmenge (LU)

Anzahl Artikel in Einzelhandelsverpackungen (ConsumerUnits) pro Palette. Die Angabe der LU ist nur für Lagerlieferungen relevant.

  • Maximalwert = 65’535

DATEISTRUKTUR STAMMDATEN

Allgemeine Hinweise zu den Stammdaten

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

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

Die hier aufgeführten Minimalkriterien sind nur für die Angebotsdatenerstellung und -zuweisung relevant.

Wir empfehlen allen, die von der automatisierten Erstellung neuer Sortimente profitieren möchten, direkt die erweiterte Datenaufbereitung der Stammdaten in “Etappe 2: Produkterstellung” umzusetzen.

→ Direkt zur Datenaufbereitung Stammdaten "Etappe 2: Produkterstellung"

note

Verwenden Sie unsere CSV-Vorlagen

Verwenden Sie unsere CSV-Vorlagen

note

Verwenden Sie unsere XLSX-Vorlagen

Verwenden Sie unsere XLSX-Vorlagen

Minimalkriteren: Stammdaten für die Angebotserstellung und -Zuweisung (Identifikationsmerkmale)

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

(blue star) Produktdaten

(blue star) Seitenanfang

Etappe 2: Produkterstellung (blue star)