product_abstract
Beispiel-Datei in gitlab.
Beschreibung
Hierunter fallen alle Daten, welche für einen bestimmten Artikel gültig sind. Dazu zählen Informationen wie beispielsweise Artikelname, Nährwerte, Zutaten, Herkunft und vieles mehr. Dieser Datentyp beinhaltet die meisten Datenfelder.
Für jedes product_abstract muss zwingend ein Name (name), eine SKU (abstract_sku), ein Kategorienschlüssel (category_key), ein Status (status), der Mehrwertsteuersatz (tax_code), die Basiseinheit (base_packaging_code für Verpackungseinheiten oder base_measurement_code für Masseinheiten) und die Menge der Basiseinheit für die Anzeige des Basispreises (base_price_quantity) mitgegeben werden.
Verfügbare Felder
| Feld (* = Pflicht) | Beschreibung |
name * Localized String (10000) | Name des Artikels. |
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 |
status * String (enum) | Definiert den aktuellen Status des Artikels. Inaktive Artikel werden in Mercanto nicht angezeigt (Ausnahme: Inventur). Zulässige Werte: active, inactive |
tax_code * String (enum) | Mehrwertsteuersatz des Artikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#mwstsatz |
delivery_product_groupString (100) | Produktliefergruppe, für die die hinterlegten Lieferdaten gelten. default = DEFAULT |
catalog/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 |
catalog/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 |
catalog/base_price_quantity * Integer (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) |
catalog/no_public_listing boolean (true, false) | Markiert, ob ein Artikel im öffentlichen Katalog angezeigt werden soll. default = false |
catalog/no_public_price boolean (true, false) | Markiert, ob der Preis des Artikels im öffentlichen Katalog angezeigt werden soll. default = true |
catalog/novelty boolean (true, false) | Markiert, ob ein Artikel mit dem «NEU» Tag versehen werden soll. default = false |
catalog/alternative Array (sku) | Liste von Artikelnummern von alternativen Artikeln. Array von Objekten => ["abstract_sku1","abstract_sku2","..."] |
catalog/complementary Array (sku) | Liste von Artikelnummern von verwandten Artikeln. |
catalog/successor Array (sku) | Liste von Artikelnummern von Nachfolgeartikeln. |
catalog/search_keywords Array (String) | Liste von Stichwörtern zum Artikel, die bei der Suche im Katalog berücksichtigt werden. |
catalog/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! |
catalog/quantity_selection_type String (enum) | Definiert den Auswahltypen des Artikels. Zulässige 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> |
certifications Array (String) | Liste von Zertifizierungen des Artikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#label |
technical_description String (10000) | Sachbezeichnung nach Lebensmittelgrundverordnung, gibt an, um welche Art von Lebensmittel es sich handelt. |
short_name Localized String (10000) | Gekürzter Produktname. Wird für die Breadcrumb-Navigation verwendet im Katalog. |
gpc_codeInteger (10000000, 10009999) | GS1 Global Product Classification (GPC) Brick Code. 8-stelliger Code, der immer mit 1000 beginnt. |
gtin String (8, 14) | Global Trade Item Number des Artikels. |
measurements/net_content Number (0, 10000000) | Nettoinhalt des Artikels. Muss befüllt sein, wenn net_content_unit befüllt ist. |
measurements/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 |
measurements/drained_weight Number (0, 10000000) | Abtropfgewicht des Artikels in Kilogramm. |
measurements/weight_per_consumer_unitNumber (0, 10000000) | Das Gewicht einer einzelnen Basiseinheit in Kilogramm. |
warehousing/type String (enum) | Temperaturbereich für den Artikel. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#lagerungsart |
warehousing/environment Localized String (10000) | Beschreibung der Lagerungsanweisungen. |
warehousing/shelf_life_days Number (0, 10000000) | Haltbarkeit in Tagen ab Zustellung. |
description Localized String (10000) | Artikelbeschreibung. |
ingredients Localized String (10000) | Inhaltsstoffe des Artikels (Lebensmittel). |
brand String (1000) | Marke des Artikels. |
producer String (1000) | Hersteller des Artikels. |
origin_country Array (enum) | 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) | 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_levelString (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 |
color_textLocalized String (10000) | Spezifische Informationen zur Farberscheinung. |
colorString (enum) | Allgemeine Farbklassifizierung zur Filterung im Katalog. |
nutriton_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 |
nutrition_values/energy_kJ Number (0,10000000) | Nährwerte: Energiegehalt in Kilojoule pro 100g/ml. |
nutrition_values/energy_kcal Number (0,10000000) | Nährwerte: Energiegehalt in Kilokalorien pro 100g/ml. |
nutrition_values/protein Number (0,100) | Nährwerte: Eiweiss in Gramm pro 100g/ml. |
nutrition_values/carbs Number (0,100) | Nährwerte: Kohlenhydrate in Gramm pro 100g/ml. |
nutrition_values/fat Number (0,100) | Nährwerte: Fett in Gramm pro 100g/ml. |
nutrition_values/fat_saturated Number (0,100) | Nährwerte: Gesättigte Fettsäuren in Gramm pro 100g/ml. |
nutrition_values/sugar Number (0,100) | Nährwerte: Zucker in Gramm pro 100g/ml. |
nutrition_values/fibres Number (0,100) | Nährwerte: Nahrungsfasern in Gramm pro 100g/ml. |
nutrition_values/salt Number (0,100) | Nährwerte: Salz in Gramm pro 100g/ml. |
allergens_food/contains Array (enum) | Liste der Allergene die in diesem Artikel vorhanden sind. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#allergene |
allergens_food/freeOf Array (enum) | Liste der Allergene die in diesem Artikel vorhanden sind. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#allergene |
allergens_food/mayContain Array (enum) | Liste der Allergene die in diesem Artikel vorhanden sind. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#allergene |
diet Array (diet) | Liste der Klassifizierungen der Ernährungsform des Artikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#ernahrungsform |
alcohol/alcohol_percentage Number (0, 100) | Alkoholgehalt in Volumenprozent. |
alcohol/drinking_temperature String (100) | Empfohlene Schanktemperatur. |
alcohol/vintage_year Number (100) | Jahrgang. |
alcohol/winery Localized String (10000) | Weingut. |
alcohol/grape Localized String (10000) | Rebsorte(n). |
alcohol/drinking_period Localized String (10000) | Empfohlene Trinkzeit des Weins, bspw. in Jahren nach der Ernte. |
alcohol/degustation Localized String (10000) | Beschreibung wie der Wein schmeckt. |
alcohol/recommendation Localized String (10000) | Empfehlungen zum Servieren des Getränks, zu welchen Speisen es passt, etc. |
alcohol/label Localized String (10000) | Zusätzliches Label wie bspw. «Gran Reserva» o.Ä. |
alcohol/wine_region Array (enum) | Liste der Regionen aus denen der Wein stammt. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#weinregion |
care/migel String (1000) | Nummer des Artikels aus der «Mittel- und Gegenstandsliste». |
meat/body_part Localized String (255) | Teilstück des Fleisches. |
seafood/fishing_area Array (enum) | Liste der Fangzonen des Tieres nach FAO. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#fangzone |
seafood/latin_name String (1000) | Lateinischer Name des Fisches. |
seafood/method_of_capture Localized String (10000) | Fangmethode des Fisches. |
seafood/production_type Localized String (10000) | Art der Fischzucht. |
wearable/clothing_size String (enum) | Größenbezeichnung für tragbare Produkte. EU-Größen in numerischer Form (z. B. EU_38, EU_42/44) für Bekleidung und Schuhe, alphabetische S/M/L-Größen sowie one_size. |
wearable/shoe_size String (enum) | Größenangaben für alle Arten von Schuhen. |
wearable/size_sml String (enum) | Grösse des Artikels. Zulässige Werte: http://my.mercanto.ch/de/definierte-werte#grosse |
ordering/advance/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. |
ordering/comments_allowed boolean (true, false) | Markiert, ob ein Kommentar zum Artikel erlaubt ist. default = false |