Der Konfigurationsknoten finance bündelt alle shopweiten Einstellungen zu Währungen, Steuern und Steuersätzen.
Er definiert, in welcher Währung Preise ausgegeben und formatiert werden, ob Preise inklusive oder exklusive Steuer geführt sind und nach welcher Berechnungslogik die Steuer ermittelt wird.
Zudem werden hier die Steuersätze (z. B. nach Land/Region oder Kategorie) festgelegt sowie optionale Zuschläge wie Pfand oder Abgaben konfiguriert.

Inhaltsverzeichnis

1 1. finance* - Grundstruktur
2 2. finance.currency - Währungen
3 3. finance.taxRates - Steuersätze
4 4. finance.taxRatesAddition - Zusatzsteuersätze
5 5. finace.taxes - Steuerberechnung

1. `finance*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens finance:

finance: {
  currency: { ... },
  taxes: { ... },
  taxRates: { ... },
  taxRatesAddition: { ... }
}

Parameterbeschreibung

Parameter	Beschreibung

Parameter	Beschreibung
`currency`	Definiert die Währungs- und Formatierungseinstellungen des Shops. Hier werden Code (z. B. „EUR“), Symbol, Dezimalstellen und Trennzeichen angegeben. Werte in Textform oder numerisch.
`taxes`	Steuert die grundlegende Steuerlogik des Shops. Enthält Parameter wie Preisbasis (`gross` / `net`), Anzeigeart (`displayInclTax` = true/false) und Versandsteuer (`applyToShipping` = true/false). Werte als Schlüssel-Wert-Paare.
`taxRates`	Enthält die länderspezifischen Steuersätze in Listenform. Jeder Eintrag enthält eine ID (z. B. „standard“), den Prozentsatz (`rate`) und optionale Zuordnungen (`appliesTo`). Struktur: Objekt mit Länderkennzeichen als Schlüssel, Array als Wert.
`taxRatesAddition`	Optionale Zusatzsteuern oder Abgaben (z. B. Pfand). Aufbau analog zu `taxRates`, meist mit Feldern wie `type` („fixed_per_unit“ / „percent“), `value` (Zahl) und `appliesTo` (Liste von Artikelgruppen).

2. `finance.currency` - Währungen

Im Abschnitt currency werden eine oder mehrere Währungen definiert, die im Shop verfügbar sein sollen. Jede Währung wird als eigener Unterknoten angelegt und enthält Formatierungsregeln und ISO-Angaben. Über diese Definitionen werden Symbol, Schreibweise und Trennzeichen festgelegt, die später im Frontend bei der Preisdarstellung verwendet werden.

Die Zuordnung, welche Währung ein Subshop tatsächlich verwendet, erfolgt in der Subshop-Konfiguration

Beispielkonfiguration für EURO (`finance.currency.euro`):

{
  "decimalPlaces": 2,
  "decimalSeparator": ",",
  "isoCode": "EUR",
  "isoNum": "978",
  "symbol": "€",
  "symbolPosition": "right",
  "thousandsSeparator": "."
}

Beispielkonfiguration für BRITISCH PFUND (`finance.currency.britishpound`):

{
  "decimalPlaces": 2,
  "decimalSeparator": ".",
  "isoCode": "GBP",
  "isoNum": "826",
  "symbol": "£",
  "symbolPosition": "left",
  "thousandsSeparator": ","
}

Parameterbeschreibung

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`decimalPlaces`	int	Anzahl der Nachkommastellen, die für Preise angezeigt werden (z. B. 2 → „19,99 €“).
`decimalSeparator`	string	Zeichen zur Trennung von Ganz- und Nachkommastellen (z. B. `","` oder `"."`).
`thousandsSeparator`	string	Zeichen zur Trennung von Tausendern (z. B. `"."` oder `","`).
`symbol`	string	Währungssymbol, das im Shop angezeigt wird (z. B. `"€"`, `"£"`, `"$"`).
`symbolPosition`	enum	Position des Symbols relativ zum Betrag. Mögliche Werte: `left` (z. B. „£19.99“) oder `right` (z. B. „19,99 €“).
`isoCode`	string	Dreistelliger ISO-4217-Code der Währung (z. B. `"EUR"`, `"GBP"`, `"CHF"`). Wird systemintern zur Identifikation verwendet.
`isoNum`	string	Numerischer ISO-4217-Code der Währung (z. B. `978` = Euro, `826` = Pfund). Wird für internationale Prozesse und API-Kommunikation genutzt.

3. `finance.taxRates` - Steuersätze

Im Abschnitt taxRates werden die konkreten Mehrwertsteuersätze pro Land oder Region definiert.
Jeder Eintrag entspricht einem Land (z. B. de, en, at) und enthält eine Liste von steuerlichen Raten, die vom System für die Preisberechnung verwendet werden können.

Diese Definitionen sind global verfügbar und werden in der Regel über finance.taxes.defaultTaxRate oder in der jeweiligen Subshop-Konfiguration referenziert.

Beispielkonfiguration für deutsche Steuersätze (`finance.taxRates.de`)

{
  "id": "de",
  "defaultTaxRate": "19",
  "taxRates": [
    {
      "id": "19",
      "rate": 0.19
    },
    {
      "id": "7",
      "rate": 0.07
    },
    {
      "id": "0",
      "rate": 0
    }
  ]
}

Beispielkonfiguration für englische Steuersätze (`finance.taxRates.en`)

{
  "id": "en",
  "defaultTaxRate": "19",
  "taxRates": [
    {
      "id": "20",
      "rate": 0.2
    },
    {
      "id": "5",
      "rate": 0.05
    },
    {
      "id": "0",
      "rate": 0
    }
  ]
}

Parameterbeschreibung

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`id`	string	Interner Bezeichner für die Steuerdefinition des Landes. Wird meist identisch zum Ländercode geführt.
`defaultTaxRate`	string	Standard-Steuersatz-ID, die verwendet wird, wenn kein spezifischer Satz zugeordnet ist (z. B. `"19"`).
`taxRates`	list (object)	Liste aller verfügbaren Steuersätze für dieses Land. Jeder Eintrag enthält eine eindeutige ID und den prozentualen Satz als Dezimalwert.
`id`	string	Bezeichner des Steuersatzes (z. B. `"19"`, `"7"`, `"zero"`). Dient als Referenz innerhalb des Systems.
`rate`	float	Steuerwert als Dezimalzahl, nicht als Prozentangabe (z. B. `0.19` = 19 %). Wird für die Preisberechnung verwendet.

4. `finance.taxRatesAddition` - Zusatzsteuersätze

Im Abschnitt taxRatesAddition können zusätzliche steuerliche Aufschläge definiert werden, die ergänzend zu den regulären Mehrwertsteuersätzen gelten. Dies kann z. B. für Pfandbeträge, Umweltabgaben oder Sondersteuern genutzt werden.

Jede Landesdefinition verweist dabei auf die bestehenden Steuersätze (finance.taxRates.<land>) und ergänzt diese um einen oder mehrere zusätzliche Sätze.

Beispielkonfiguration für deutsche Zuatzsteuersätze (`finance.taxRatesAddition.de`)

{
  "additionalTaxRates": [
    {
      "id": "30",
      "rate": 0.3
    }
  ],
  "id": "de",
  "taxRates": "finance.taxRates.de"
}

Beispielkonfiguration für englische Zuatzsteuersätze (`finance.taxRatesAddition.en`)

{
  "additionalTaxRates": [
        {
          "id": "luxury",
          "rate": 0.25
        },
        {
          "id": "environment",
          "rate": 0.10
        }
  ]
  "id": "de",
  "taxRates": "finance.taxRates.de"
}

Parameterbeschreibung

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`id`	string	Bezeichner der Steuerdefinition des Landes, meist identisch mit dem Ländercode.
`taxRates`	singleAssoc	Referenz auf die regulären Steuersätze, auf denen die Zusatzsteuern aufbauen (z. B. `"finance.taxRates.de"`).
`additionalTaxRates`	list (object)	Liste zusätzlicher Steuersätze, die zusätzlich zu den regulären angewendet werden können.
`id`	string	Eindeutiger Bezeichner der Zusatzsteuer (z. B. `"30"`, `"luxury"`, `"environment"`).
`rate`	float	Steuer- oder Aufschlagswert als Dezimalzahl (z. B. `0.10` = 10 %). Wird zusätzlich zum regulären Satz berechnet.

5. `finace.taxes` - Steuerberechnung

Der Abschnitt finance.taxes definiert die Berechnungslogik und die Zuweisung der Steuersätze, die im jeweiligen Shop oder Subshop verwendet werden. Hier wird festgelegt,

ob Preise inklusive oder exklusive Steuer geführt werden,
welche Steuersätze aus der Konfiguration finance.taxRates verwendet werden,
und wie Haupt- und Nebenleistungen (z. B. Produkte, Versand) steuerlich berechnet werden.

Damit bildet dieser Abschnitt die Verknüpfung zwischen den definierten Steuersätzen (finance.taxRates) und der praktischen Anwendung für den Subshop.

Beispielkonfiguration:

{
  "ancillaryServicesCalculation": "static",
  "ancillaryServicesTaxRate": "19",
  "defaultTaxRate": "finance.taxRates.de",
  "mainServicesCalculation": "vertical",
  "pricesIncludeTaxes": true,
  "usedTaxes": "finance.taxRates.de"
}

Parameterbeschreibung

Property	Typ	Beschreibung

Property	Typ	Beschreibung
`pricesIncludeTaxes`	bool	Legt fest, ob Produktpreise inklusive Steuer (true) oder exklusive Steuer (false) geführt werden.
`defaultTaxRate`	singleAssoc	Referenz auf die Standard-Steuersatzdefinition. Typischerweise verweist dieser Eintrag auf einen Knoten unter `finance.taxRates` (z. B. `finance.taxRates.de`).
`usedTaxes`	singleAssoc	Gibt an, welche Steuersätze aus der `taxRates`-Konfiguration aktiv im Shop verwendet werden sollen. Kann ein oder mehrere Verweise enthalten.
`mainServicesCalculation`	enum	Definiert die steuerliche Berechnungsmethode. Beispielwerte: `horizontal` (Berechnung je Position) oder `vertical` (Berechnung auf Gesamtbetrag).
`ancillaryServicesCalculation`	enum	Definiert die Berechnungslogik für Nebenleistungen (z. B. Versand). Mögliche Werte: `static` - fester Steuersatz `distributed` - anteilig zur Warensteuer `highestCost`- Steuersatz mit dem höchsten Warenwert
`ancillaryServicesTaxRate`	string	Fester Prozentsatz für Nebenleistungen (z. B. Versandkostensteuer = „19“). Wird nur verwendet, wenn `ancillaryServicesCalculation = "static"` ist.

finance - Währungen & Steuern

Inhaltsverzeichnis

1. finance* - Grundstruktur

Parameterbeschreibung

2. finance.currency - Währungen

Beispielkonfiguration für EURO (finance.currency.euro):

Beispielkonfiguration für BRITISCH PFUND (finance.currency.britishpound):

Parameterbeschreibung

3. finance.taxRates - Steuersätze

Beispielkonfiguration für deutsche Steuersätze (finance.taxRates.de)

Beispielkonfiguration für englische Steuersätze (finance.taxRates.en)

Parameterbeschreibung

4. finance.taxRatesAddition - Zusatzsteuersätze

Beispielkonfiguration für deutsche Zuatzsteuersätze (finance.taxRatesAddition.de)

Beispielkonfiguration für englische Zuatzsteuersätze (finance.taxRatesAddition.en)

Parameterbeschreibung

5. finace.taxes - Steuerberechnung

Beispielkonfiguration:

Parameterbeschreibung

1. `finance*` - Grundstruktur

2. `finance.currency` - Währungen

Beispielkonfiguration für EURO (`finance.currency.euro`):

Beispielkonfiguration für BRITISCH PFUND (`finance.currency.britishpound`):

3. `finance.taxRates` - Steuersätze

Beispielkonfiguration für deutsche Steuersätze (`finance.taxRates.de`)

Beispielkonfiguration für englische Steuersätze (`finance.taxRates.en`)

4. `finance.taxRatesAddition` - Zusatzsteuersätze

Beispielkonfiguration für deutsche Zuatzsteuersätze (`finance.taxRatesAddition.de`)

Beispielkonfiguration für englische Zuatzsteuersätze (`finance.taxRatesAddition.en`)

5. `finace.taxes` - Steuerberechnung