Referenzdaten

Nicht jeder Wert sollte frei eingetippt werden. Länder, Masseinheiten, Mehrwertsteuersätze oder Auswahloptionen sind feste Grössen – und genau dort entstehen sonst die typischen Datenfehler: «kg» vs. «Kilogramm», «CH» vs. «Schweiz», ein falscher Steuersatz. buzzle löst das mit Referenzdaten: zentral gepflegte Wertelisten, aus denen Attribute ihre gültigen Werte beziehen. Das Ergebnis sind konsistente, dublettenfreie Produktdaten – über das gesamte Sortiment hinweg.

Das Prinzip: einmal pflegen, überall gültig

Ein referenzdatenbasiertes Attribut (siehe Attributtypen) verweist über einen ReferenceDataCode auf eine Referenzdatenliste. Statt den Wert frei einzugeben, wählen Redakteurinnen und Redakteure aus den gepflegten Einträgen. Ändert sich ein Eintrag zentral, wirkt die Änderung sofort überall, wo der Wert verwendet wird – kein Suchen und Ersetzen, keine vergessenen Stellen.

Spezialisierte Referenzdatentypen

buzzle kennt mehrere spezialisierte Referenzdatentypen, jeder mit eigenen Feldern und Regeln:

Typ	Zweck	Besondere Felder
Einfache Referenzdaten	Allgemeine Wertelisten / Optionen	Wert, mehrsprachige Bezeichnung
Länder	Länderliste	CountryCode (ISO-Ländercode)
Masseinheiten	Einheiten wie Stück, kg, Liter	Basiseinheit, Umrechnung
Mehrwertsteuer	MwSt-Sätze	Vat (Steuersatz in Prozent)
Lange Texte	Wiederverwendbare Textbausteine	mehrsprachiger Langtext
Dynamische Preise	Zeitlich gültige Preiswerte	ValidFrom, ValidTo, IsCumulative, Description

Masseinheiten

Masseinheiten dienen Attributen vom Typ AttributMitMasseinheit. Über eine Basiseinheit lassen sich Werte vergleichbar machen – etwa unterschiedliche Verpackungsgrössen auf eine gemeinsame Basis umrechnen. Das macht Filter, Vergleiche und Auswertungen über das Sortiment hinweg zuverlässig.

Mehrwertsteuer

MwSt-Referenzdaten halten den Steuersatz als Prozentwert (Vat) und fliessen direkt in die Preiskalkulation ein. So sind Steuersätze zentral gepflegt und immer korrekt kalkuliert.

Dynamische Preise

Dynamische Preis-Referenzdaten erlauben zeitlich gültige Werte mit Gültigkeit von/bis (ValidFrom/ValidTo) und einer Kumulativ-Option (IsCumulative). Damit lassen sich zum Beispiel Konditionen abbilden, die nur in einem bestimmten Zeitraum gelten – ohne manuelles Nachpflegen zum Stichtag.

Verwaltung über die API

Für die gängigen Typen stehen eigene Endpunkte bereit, unter anderem für Länder, Masseinheiten und Mehrwertsteuersätze. Referenzdaten lassen sich so auch automatisiert befüllen und mit Fremdsystemen synchron halten (siehe API & Integration) – ideal, wenn Stammdaten aus einem führenden System stammen.

Dein Nutzen

• Konsistente Daten ohne Schreibvarianten und Tippfehler
• Zentrale Pflege – eine Änderung wirkt überall
• Korrekte Kalkulation durch zentral gepflegte Steuersätze und Einheiten
• Automatisierbar über die API und Fremdsystem-Sync

Das Wichtigste in Kürze

• Zentrale Wertelisten statt freier Eingabe – konsistent und dublettenfrei
• Spezialisierte Typen: einfache Listen, Länder, Masseinheiten, MwSt, Langtexte, dynamische Preise
• Von Attributen über ReferenceDataCode referenziert
• Per API pflegbar und synchronisierbar