1 Datenaufbereitung Etappe 1

DATENINTEGRATION ETAPPE 1

Angebotszuweisung

Durch die Umsetzung dieser Etappe ermöglichen wir die Zuweisung von Angeboten. Partner profitieren vom bestehenden Produktportfolio der Onlineshops, indem Angebotsdaten an bereits gepflegte Produkte angehängt werden (deckendes Sortiment).

Die Angebote werden nach der Aktivierung mit unserem Produktportfolio abgeglichen und zugewiesen. Die Mindestkriterien dabei sind Artikelnummer, Preis, Bestand und EAN/GTIN.

Inhalt

1 GTIN & ARTIKELNUMMER
2 ÜBERMITTLUNGS-FREQUENZ
3 SORTIMENTS-BESTIMMENDE DATEI
4 HINWEISE ZUR DOKUMENTATION
5 DATEISTRUKTUR ETAPPE 1
- 5.1 Minimalkriteren: Angebotszuweisung
- 5.2 Ergänzende Kriterien zur Optimierung der Verfügbarkeit und Bestellabwicklung

GTIN & ARTIKELNUMMER

Der Providerkey ist die eindeutige Artikel-Nr. für einen Artikel aus dem Sortiment des Partners. Sie wird als Identifikationsnummer verwendet und muss zwingend in allen gelieferten Dateien mitgeliefert werden. Der Providerkey wird auf allen Bestellungen als Identifikationsnummer für den Artikel ausgespielt. Bereits zugeteilte Artikelnummern sollten in keinem Fall für andere Artikel wiederverwendet werden.

Der Providerkey und die GTIN bilden bei Galaxus eine Einheit und entsprechen einem Produkt. Neue GTINs müssen zwingend mit neuen Providerkeys eingespielt werden. GTIN-Änderungen an demselben Providerkey sind nicht erlaubt.

Datenfluss bei Galaxus: 4 Datenverarbeitung

ÜBERMITTLUNGS-FREQUENZ

Voraussetzung für eine reibungslose Abwicklung der Bestellung sind korrekte und aktuelle Informationen. Um alle Informationen in einem File übermitteln zu können, muss das File alle 30 Minuten (mindestens: 1 mal pro Tag) aktualisiert werden.

Datenstruktur

Kann das File nicht so oft aktualisiert werden, können Bestände auch separat übermittelt werden, um sie unabhängig von anderen Daten schnell und häufig zu senden.

Etappe 1: Alternative Darstellung

Alternative Darstellung

SORTIMENTS-BESTIMMENDE DATEI

Artikel, die als EOL-Produkte gelten (Produkte ohne aktives Angebot im System), müssen spätestens in der nächsten Übermittlung aus der entsprechenden Datei entfernt werden.

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

Bsp: StockPricingData_BeispielAG_assortment.csv

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.

DATEISTRUKTUR ETAPPE 1

Allgemeine Hinweise

Dateiname: StockPricingData_[ProviderName].[DATEIFORMAT] (Bsp: StockPricingData_digitecgalaxus.csv)
Übermittlungsfrequenz: alle 30 Minuten (mindestens: 1 mal pro Tag)
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.

Die hier aufgeführten Minimalkriterien sind für die Angebotszuweisung relevant.

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

Direkt zur Datenaufbereitung Stammdaten "Etappe 2: Produkterstellung"

Verwende unsere CSV-Vorlagen

Verwende unsere XLSX-Vorlagen

Minimalkriteren: Angebotszuweisung

Kopfzeile	Datentyp	Bezeichnung	Beschreibung

Kopfzeile	Datentyp	Bezeichnung	Beschreibung
ProviderKey	Str(50) ASCII 32-126	Partnerspezifische Artikelnummer	Eindeutige Identifikationsnummer des Artikels. 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) Die einmal für einen Artikel hinterlegte GTIN sollte nicht geändert werden. Eine nachträgliche Anpassung ist nicht erlaubt. Daher ist es wichtig, von Anfang an die korrekte GTIN zu pflegen. Eine falsche oder geänderte GTIN kann zu fehlerhaften Zuordnungen und falschen Daten und Bestellungen führen. Die 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: gtin.info oder GS1 Switzerland. Die physisch aufgedruckte GTIN muss mit der übermittelten GTIN übereinstimmen. Verwende ausschliesslich die vom Hersteller offiziell* vergebenen GTINs.*
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. Die Herstellernummer muss vollständig und unverändert übermittelt werden. Sie darf nicht gekürzt oder durch Leerzeichen, Trennzeichen oder andere Änderungen angepasst werden. Doppelte Herstellernummer-Marken-Kombinationen werden kategorisch ausgeschlossen.
PriceExclVat_[currency]	Dec(8,4)	Preis exkl. MwSt.	Digitec Galaxus seitiger Preis 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 Marktplatz CH: Ist nur CHF als Währung gestattet.
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 Nicht nötig für Händler.
VatRatePercentage	Dec(2,2)	Mehrwertsteuersatz	Mehrwertsteuersatz als Zahlangabe ohne %-Zeichen. Bsp: Schweiz: 8.1, 2.6, 0.0 Nicht nötig für Lieferanten & EU-Hub Händler.
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 Bestellabwicklung

Kopfzeile	Datentyp	Bezeichnung	Beschreibung

Kopfzeile	Datentyp	Bezeichnung	Beschreibung
LeadTime und Made-To-Order oder Configure-To-Order Quantity (=MtoCtoQuantity) werden nur berücksichtigt, wenn der Partner Account dafür freigegeben ist. Die Freigabe erhalten nur Partner, die Made-To-Order Produkte oder Configure-To-Order Produkte in ihrem Feed anbieten. Damit Du die Freigabe dafür erhältst, wende dich bitte an deinen Portfolio Development Manager.
LeadTime	Int(3)*	Produktionszeit in Arbeitstagen	Die Lead Time beschreibt die Produktionsdauer in Arbeitstagen, die ab dem Bestellzeitpunkt benötigt wird, bis die Ware hergestellt und versandbereit ist. Für Produkte, die On-Demand produziert werden und nicht an Lager sind, muss eine Lead Time angegeben werden. Diese Information hat Auswirkungen auf die Verfügbarkeit und Shop-Anzeige gegenüber dem Kunden. Maximalwert = 90 Wenn der Wert 0 (Tage) übermittelt wird, behandeln wir ihn genauso, als ob kein Wert übermittelt worden wäre. Lead Time wird nur berücksichtigt, wenn der Lagerbestand 0 ist. Bei positivem Bestand wird der Wert ignoriert.
MtoCtoQuantity (Made-To-Order / Configure-To-Order)	Int(5)	Mögliche Produktionsmenge	Die MTOCTO Quantity bezeichnet die Menge an Ware, die ab Bestellzeitpunkt theoretisch innerhalb der angegeben Lead Time hergestellt werden kann und versandbereit ist. Diese Angabe ist nur bei verfügbarer Lead Time relevant und wird für automatisierte Bestellvorgänge verwendet. Kriterien: Lagerbestand ist 0 -> Bei positivem Bestand wird der Wert ignoriert. Lead Time ist vorhanden MtoCto Quantity ist eine positive Zahl MtoCto Quantity = 0 → gilt als unbekannte Verfügbarkeit
Primär nutzen wir „QuantityOnStock“ zur Verfügbarkeitsberechnung. Ist dieser Wert nicht vorhanden, 0 oder leer, verwenden wir „RestockDate/Time“ und „ExpectedRestockQuantity“. Diese Informationen haben Auswirkungen auf die Verfügbarkeit und werden für automatisierte Bestellvorgänge verwendet.
RestockTime	Int(3)*	Wiederbeschaffungsdauer in Arbeitstagen	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 = 150 Wenn der Wert 0 (Tage) übermittelt wird, behandeln wir ihn genauso, als ob kein Wert übermittelt worden wäre. 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.
ExpectedRestockQuantity	Int(5)	Erwartete Wiederbeschaffungsmenge	Der erwartete verfügbare Lagerbestand beim Zeitpunkt an dem der Artikel wieder an Lager beim Partner ist. Positive Zahl 0 → gilt als unbekannte Verfügbarkeit
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 = 65'535 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
RetailUnitQuantity	Int(4)	Artikel pro Verkaufseinheit	Anzahl Artikel pro Einzelhandelsverpackung.
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,…* Diese Daten werden aktuell von uns noch nicht berücksichtigt, wir arbeiten aber daran, dies in unser System zu integrieren, damit wir sie berücksichtigen können. 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 Diese Daten werden aktuell von uns noch nicht berücksichtigt, wir arbeiten aber daran, dies in unser System zu integrieren, damit wir sie berücksichtigen können.