Austauschschema (JSON) · Schema für den Designer · Beispieldaten

Austauschschema: vollständige Strukturprüfung mit JSON Schema 2020-12. Designer-Fassung: gleiche Datenfelder mit reduzierten Strukturregeln zur Feldübernahme. Anleitung und Grenzen

Pflichtangaben gelten für das jeweilige Objekt, wenn dieses Modul verwendet wird. Zusätzliche Alternativen und Statusregeln stehen im Austauschschema. Optionale Felder weglassen, wenn sie unbekannt oder nicht anwendbar sind; ein leeres Pflichtfeld ist kein gültiger Ersatz.

• Nicht jede Währung besitzt zwei Nachkommastellen. Zulässige Genauigkeit und Rundung sind mit der ISO-4217-Liste und dem Geschäftsvorgang abzugleichen.
• amount bleibt beim Transport Text. Rechnen mit einer Dezimalbibliothek; JavaScript Number kann Werte runden.
• Negative Beträge sind strukturell erlaubt, etwa für Korrekturen. Ein Rechnungs- oder Preisprofil kann sie gezielt verbieten.

Alle Beispiele sind synthetisch. Sie werden mit dem mitgelieferten Schema geprüft; daraus folgt keine fachliche Echtheit oder externe Erreichbarkeit.

example-1.json

{
  "amount": "1234.50",
  "currency": "EUR"
}

example-2.json

{
  "amount": "1250",
  "currency": "JPY"
}

example-3.json

{
  "amount": "12.345",
  "currency": "KWD"
}

Neues wiederverwendbares Modul. Keine automatische Umdeutung vorhandener Zahlenbeträge; eine Migration braucht Währung und vereinbarte Dezimalgenauigkeit.

Änderungsübersicht und Migrationsregeln

Die Datei ist eigenständig: verwendete Bausteine sind unter $defs eingebettet, Referenzen bleiben lokal. $id ist die kanonische Kennung. Die Downloads oben verwenden den aktuellen Server; eine Veröffentlichung unter der kanonischen Domain ist damit nicht behauptet.

money.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://b2base.eu/schemas/1.0.0-draft.1/financial/money.schema.json",
  "title": "Geldbeträge",
  "$comment": "B2Base 1.0.0-draft.1. Projektentwurf, kein durch ISO oder andere Normungsgremien verabschiedeter Standard.",
  "type": "object",
  "description": "Exakter Geldbetrag mit expliziter Währung; Dezimaltext verhindert binäre Rundung beim Transport.",
  "properties": {
    "amount": {
      "type": "string",
      "minLength": 1,
      "description": "Vorzeichen erlaubt; Dezimalpunkt, keine Tausendertrennzeichen und kein Exponent.",
      "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$"
    },
    "currency": {
      "$ref": "#/$defs/CurrencyCode"
    }
  },
  "required": [
    "amount",
    "currency"
  ],
  "additionalProperties": false,
  "$defs": {
    "CurrencyCode": {
      "type": "string",
      "minLength": 1,
      "description": "ISO-4217-Währungscode; Schreibweise allein belegt weder Zuweisung noch historische Gültigkeit.",
      "pattern": "^[A-Z]{3}$"
    }
  },
  "examples": [
    {
      "amount": "1234.50",
      "currency": "EUR"
    },
    {
      "amount": "1250",
      "currency": "JPY"
    },
    {
      "amount": "12.345",
      "currency": "KWD"
    }
  ]
}

• SIX: ISO-4217-Währungen und Nachkommastellen

Quellen geprüft am 8. September 2026. Die B2Base-Felder und ihre Kombination sind ein eigener Entwurf. Code-Register, nationale Regeln, Echtheit, Zeitfolgen und Referenzziele benötigen die im jeweiligen Verfahren vereinbarten Zusatzprüfungen.

Zur Bibliothek · Integration · Häufige Fragen