products-.csv

Template-Datei zum Herunterladen, hier klicken.
Ausgefüllte Beispiel-Datei zum Herunterladen, hier klicken.

Beschreibung

Mit products-.csv übermittelt ein Lieferant die Stammdaten seiner Artikel: zum Beispiel Artikelname, Kategorie, Nährwerte, Zutaten, Herkunft, Allergene oder Angaben zu Wein und Fleisch. Dieser Datentyp enthält die meisten Datenfelder und bildet die Basis für alle weiteren produktbezogenen Dateien.

Für jeden Artikel müssen zwingend folgende Angaben mitgegeben werden:

Name in allen benötigten Sprachen (product_name_<LOCALE>)
Artikelnummer (abstract_sku)
Kategorie (category_key)
Mehrwertsteuersatz (tax_code)
Basiseinheit, entweder als Verpackungseinheit (base_packaging_code) oder als Masseinheit (base_measurement_code)
Menge der Basiseinheit für die Anzeige des Basispreises (base_price_quantity)

Alle weiteren Felder (z. B. Nährwerte, Allergene, Herkunft, Wein- und Fleischangaben) sind optional und müssen nur befüllt werden, sofern sie auf den jeweiligen Artikel zutreffen.

Abhängigkeiten zu anderen Datentypen:

Die Verpackungseinheiten und deren Preise werden separat in products_packaging-.csv und products_prices-.csv definiert und über die gemeinsame abstract_sku mit dem Artikel verknüpft. Eine abstract_sku muss zwingend zuerst (oder im selben Import) in products-.csv angelegt werden, bevor sie in diesen Dateien verwendet werden kann.
Allfällige kundenspezifische Bestellberechtigungen und -beschränkungen zum Artikel werden in product_restrictions-.csv definiert.
Wird der Artikel in einer Bestellliste verwendet, muss die sku als aktiver Artikel in products-.csv vorhanden sein (siehe shopping_list_items-.csv).
Die category_key muss einer gültigen, in Mercanto definierten Kategorie entsprechen.

Verfügbare Spalten

Feld (* = Pflicht)	Beschreibung
`product_name_<LOCALE>` * Localized String (10000)	Name des Artikels in der entsprechenden Sprache. **
`abstract_sku` * String (100)	Stock keeping unit des Artikels (Artikelnummer). Zulässige Zeichen: Zahlen `0-9`, Buchstaben `A-Z a-z`, Bindestriche `–`, Unterstriche `_`, Klammern `()`, Punkte `.`.
`category_key` * String (enum)	Zuweisung des Artikels zu einer spezifischen Mercanto-Kategorie. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#artikelkategorie
`tax_code` * String (enum)	Mehrwertsteuersatz des Artikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#mwstsatz
`base_measurement_code` * String (enum)	Definiert die Basis-Masseinheit des Artikels. Entweder dieses Feld oder `base_packaging_code` muss befüllt sein. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#einheit
`base_packaging_code` * String (enum)	Definiert die Basis-Verpackungseinheit des Artikels. Entweder dieses Feld oder `base_measurement_code` muss befüllt sein. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#verpackungseinheit
`base_price_quantity` * Number (1, 10000000)	Menge der Basiseinheit für die Anzeige des Basispreises. Beispiel 1: Wert 20 → CHF 16.50/20 Stück Beispiel 2: Wert 1 → CHF 16.50/Stück (1 wird in diesem Fall nicht angezeigt)
`availability_status` * String (enum)	Aktueller Verfügbarkeitsstatus des Artikels Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#verfugbarkeitsstatus
`delivery_product_group` String (100)	Produktliefergruppe, für die die hinterlegten Lieferdaten gelten. default = `DEFAULT`
`status` String (enum)	Definiert den aktuellen Status des Artikels. Inaktive Artikel werden in Mercanto nicht angezeigt (Ausnahme: Inventur). Zulässige Werte: `active`, `inactive` default = `active`
`no_public_listing` boolean (0, 1)	Markiert, ob ein Artikel im öffentlichen Katalog angezeigt werden soll, wobei `0` = wird angezeigt, `1` = wird nicht angezeigt. default = `0`
`no_public_price` boolean (0, 1)	Markiert, ob der Preis des Artikels im öffentlichen Katalog angezeigt werden soll, wobei `0` = wird angezeigt, `1` = wird nicht angezeigt. default = `0`
`novelty` boolean (0, 1)	Markiert, ob ein Artikel mit dem «NEU» Tag versehen werden soll, wobei `0` = Tag wird nicht angezeigt, `1` = Tag wird angezeigt. default = `0`
`promotion_date_start` String (DD.MM.YYYY)	«Gültig ab» Datum, wenn es eine Promotion zum Produkt gibt. Es müssen immer beide Daten gefüllt sein.
`promotion_date_end` String (DD.MM.YYYY)	«Gültig bis» Datum, wenn es eine Promotion zum Produkt gibt. Es müssen immer beide Daten gefüllt sein.
`promotion_key` String (100)	Promotionscode
`promotion_name_<LOCALE>` Localized String (10000)	Bezeichnung zur Promotion in der entsprechenden Sprache. **
`search_keywords_<LOCALE>` Localized String (10000)	Kommaseparierte Liste von Stichwörtern zum Artikel, die bei der Suche im Katalog berücksichtigt werden - in der entsprechenden Sprache. **
`tier_level` Integer (1, 999999999)	Definiert die Priorität des Artikels innerhalb des Lieferantenkatalogs. Je höher der Wert, desto weiter oben wird der Artikel im Katalog angezeigt. Achtung: Hat keinen Einfluss auf die Position im Gesamtkatalog oder in "Mein Sortiment" des Kunden!
`quantity_selection_type` String (enum)	Definiert den Auswahltypen des Artikels. Zulässitge Werte: `default`, `measurement_per_item`, `open_measurement` `default` = Angabe in entsprechender Menge wie auf dem Artikel definiert `measurement_per_item` = Angabe in `Stück` pro <`kg`, `m`, `l`> `open_measurement` = Offene Menge in <`kg`, `m`, `l`>
`alternative` Array (sku)	Kommaseparierte Liste von Artikelnummern von alternativen Artikeln.
`complementary` Array (sku)	Kommaseparierte Liste von Artikelnummern von verwandten Artikeln.
`successor` Array (sku)	Kommaseparierte Liste von Artikelnummern von Nachfolgeartikeln.
`order_deadline_date` String (DD.MM.YYYY)	Letzter Tag, an welchem das Produkt bestellt werden kann. Muss bei `availability_status` = `preorder` mitgegeben werden
`order_deliverable_` `from_date` String (DD.MM.YYYY)	Frühestes Datum, an welchem das Produkt geliefert werden kann. Muss bei `availability_status` = `delivery_delay` und `preorder` mitgegeben werden.
`availability_` `information_<LOCALE>` Localized String (10000)	Zusatzinformation zur Verfügbarkeit in der entsprechenden Sprache. **
`certifications` Array (String)	Kommaseparierte Liste von Zertifizierungen des Artikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#label
`technical_` `description_<LOCALE>` Localized String (10000)	Sachbezeichnung nach Lebensmittelgrundverordnung, gibt an, um welche Art von Lebensmittel es sich handelt - in der entsprechenden Sprache. **
`short_name_<LOCALE>` Localized String (10000)	Gekürzter Produktname - in der entsprechenden Sprache. **. Wird für die Breadcrumb-Navigation verwendet im Katalog.
`gtin` String (8, 14)	Global Trade Item Number des Artikels.
`gpc_code` Integer (10000000, 10009999)	GS1 Global Product Classification (GPC) Brick Code. 8-stelliger Code, der immer mit 1000 beginnt.
`net_content` Number (0, 10000000)	Nettoinhalt der Basiseinheit des Artikels. Muss befüllt sein, wenn `net_content_unit` befüllt ist.
`net_content_unit` String (enum)	Einheit des Nettoinhalts. Muss befüllt sein, wenn `net_content` befüllt ist. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#einheit
`drained_weight` Number (0, 10000000)	Abtropfgewicht des Artikels in Kilogramm.
`weight_per_consumer_unit` Number (0, 10000000)	Nettoinhalt in Kg.
`warehousing_type` String (enum)	Temperaturbereich für den Artikel.. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#lagerungsart
`warehousing_` `environment_<LOCALE>` Localized String (10000)	Beschreibung der Lagerungsanweisungen in der entsprechenden Sprache. **
`shelf_life_days` Integer (0, 10000000)	Haltbarkeit in Tagen ab Zustellung.
`product_` `description_<LOCALE>` Localized String (10000)	Artikelbeschreibung in der entsprechenden Sprache. **
`ingredients_<LOCALE>` Localized String (10000)	Inhaltsstoffe des Artikels (Lebensmittel) in der entsprechenden Sprache. **
`brand_name` String (1000)	Marke des Artikels.
`producer_name` String (1000)	Hersteller des Artikels.
`origin_country` Array (enum)	Kommaseparierte Liste der Herkunftsländer der Rohstoffe des Artikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#landercode
`origin_locality` Localized String (10000)	Weitere Details zum Herkunftsort.
`production_country` Array (enum)	Kommaseparierte Liste der Länder, wo der Artikel hergestellt wird. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#landercode
`production_locality` Localized String (10000)	Weitere Details zum Produktionsort.
`convenience_level` String (enum)	Im kulinarischen Bereich beschreiben sogenannte ‚Convenience-Stufen‘ den Grad der Verarbeitung bzw. Zubereitung, den ein Lebensmittel benötigt, bevor es verzehrt werden kann. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#convenience-grad
`nutrition_score` String (enum)	Angabe der Nährwertklassifizierung des Artikels. Gilt nur für Food-Artikel. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#nutriscore
`energy_label` String (enum)	Angabe der Energieeffizienzklasse des Artikels. Gilt nur für Non-Food-Artikel. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#energieetikette
`beelong_score` String (enum)	Umweltauswirkungs-Rating des Artikels nach Beelong. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#beelongscore
`energy_kj` Number (0,10000000)	Nährwerte: Energiegehalt in Kilojoule pro 100g/ml.
`energy_kcal` Number (0,10000000)	Nährwerte: Energiegehalt in Kilokalorien pro 100g/ml.
`protein` Number (0,100)	Nährwerte: Eiweiss in Gramm pro 100g/ml.
`carbs` Number (0,100)	Nährwerte: Kohlenhydrate in Gramm pro 100g/ml.
`fat` Number (0,100)	Nährwerte: Fett in Gramm pro 100g/ml.
`saturated_fat` Number (0,100)	Nährwerte: Gesättigte Fettsäuren in Gramm pro 100g/ml.
`sugar` Number (0,100)	Nährwerte: Zucker in Gramm pro 100g/ml.
`fibres` Number (0,100)	Nährwerte: Nahrungsfasern in Gramm pro 100g/ml.
`salt` Number (0,100)	Nährwerte: Salz in Gramm pro 100g/ml.
`allergen_celery` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_crustaceans` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_egg` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_fish` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_gluten` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_lactose` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_lupins` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_milk` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_molluscs` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_mustard` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_nuts` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_peanuts` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_sesame` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_soy` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`allergen_sulfites` String (enum)	Angabe, ob der Artikel dieses Allergen enthält. Zulässige Werte: `contains` (= enthält Allergen), `freeOf` (= enthält Allergen nicht), `mayContain` (= kann Allergen enthalten)
`diet` Array (diet)	Kommaseparierte Liste der Klassifizierungen der Ernährungsform des Artikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#ernahrungsform
`alcohol_percentage` Number (0, 100)	Alkoholgehalt in Volumenprozent.
`alcohol_drinking_` `temperature` String (100)	Empfohlene Schanktemperatur.
`alcohol_vintage_year` Number (100)	Jahrgang.
`alcohol_winery_<LOCALE>` Localized String (10000)	Weingut in der entsprechenden Sprache. **
`alcohol_grape_<LOCALE>` Localized String (10000)	Rebsorte(n) in der entsprechenden Sprache. **
`alcohol_drinking_` `period_<LOCALE>` Localized String (10000)	Empfohlene Trinkzeit des Weins, bspw. in Jahren nach der Ernte in der entsprechenden Sprache. **
`alcohol_` `degustation_<LOCALE>` Localized String (10000)	Beschreibung zum Geschmack des Weins der entsprechenden Sprache. **
`alcohol_culinary_ recommendation_<LOCALE>` Localized String (10000)	Empfehlungen zum Servieren des Getränks, zu welchen Speisen es passt, etc.in der entsprechenden Sprache. **
`alcohol_label_<LOCALE>` Localized String (10000)	Zusätzliches Label wie bspw. «Gran Reserva» o.Ä. in der entsprechenden Sprache. **
`alcohol_wine_region` Array (enum)	Kommaseparierte Liste der Regionen aus denen der Wein stammt. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#weinregion
`color_text_<LOCALE>` Localized String (10000)	Spezifische Informationen zur Farberscheinung in der entsprechenden Sprache. Hinweis**: Feld ist veraltet und sollte nicht mehr benutzt werden.
`color` String (enum)	Allgemeine Farbklassifizierung zur Filterung im Katalog.
`migel_number` String (1000)	Nummer des Artikels aus der «Mittel- und Gegenstandsliste».
`meat_body_part_<LOCALE>` Localized String (255)	Teilstück des Fleisches in der entsprechenden Sprache. **
`fishing_area` Array (enum)	Kommaseparierte Liste der Fangzonen des Tieres nach FAO. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#fangzone
`fish_latin_name` String (1000)	Lateinischer Name des Fisches.
`fish_method_` `of_capture_<LOCALE>` Localized String (10000)	Fangmethode des Fisches in der entsprechenden Sprache. **
`fish_production_` `type_<LOCALE>` Localized String (10000)	Art der Fischzucht in der entsprechenden Sprache. **
`advance_order_days` Integer (0, 10000000)	Gibt an, wie viele Tage im Voraus der Artikel bestellt werden muss oder wie viele Tage der Bearbeitung erforderlich sind, bevor es geliefert werden kann.
`order_comments_allowed` boolean (0, 1)	Markiert, ob ein Kommentar zum Artikel erlaubt ist. default = `0`
`clothing_size` String (enum)	EU-Größenangaben (z. B. EU_38, EU_42/44) für Bekleidung, die Buchstabengrößen S/M/L sowie „One-Size“. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#kleidergrosse
`shoe_size` String (enum)	Größenangaben für alle Schuhmodelle. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#schuhgrosse
`size_sml` String (enum)	Allgemeine Größen wie XXS, M, L oder XL. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#grosse

Typischer Anwendungsfall: Ein Lieferant lanciert einen neuen Artikel „Bio-Apfelsaft 1L“. Dazu werden Name, Artikelnummer, Kategorie, Mehrwertsteuersatz und Basiseinheit erfasst sowie ergänzend Herkunftsland, Zutaten und Nährwerte hinterlegt, damit der Artikel korrekt im Katalog angezeigt wird.

** = <LOCALE> ist durch das Sprachkürzel de, fr, it oder en zu ersetzen, wobei die hinterlegte Standardsprache Pflicht ist.