Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- schemes:legalentity:nameanddetails [2024/12/12 15:32] – [description] lars_gerulat
+++ schemes:legalentity:nameanddetails [2026/09/08 14:34] (aktuell) – B2Base-Schemaentwurf: internationale Datenmodelle, Beispiele und Erläuterungen 0.0.0.0
@@ Zeile 1: / Zeile 1: @@
-====== nameanddetails ======
+====== Juristische Personen ======
-====== description ======
-Das Schema beschreibt eine juristische Person mit folgenden Hauptaspekten:
-  - Name: Der vollständige rechtliche Name der juristischen Person.
-  - Registrierungsnummern: Eine Liste von Registrierungsnummern, die den Typ (z. B. IHK, Gericht, Finanzaufsicht) und die zugehörige Nummer enthalten.
-  - Adresse: Ein Verweis auf ein separates Schema, das die Adressdetails der juristischen Person definiert.
-  - Kontaktinformationen: Ein Verweis auf ein separates Schema, das die Kontaktdetails wie E-Mails, Telefonnummern und soziale Medien beschreibt.
-Das Schema ist modular aufgebaut und verwendet Verweise ($ref), um wiederverwendbare und standardisierte Definitionen für Adress- und Kontaktdetails zu integrieren. Es stellt sicher, dass alle wesentlichen Informationen für die Identifizierung und Kontaktaufnahme einer juristischen Person erfasst werden.
-====== references ======
-  * [[schemes:person:addressdetails|schemes:person:addressdetails]]
-  * [[schemes:person:contactdetails|schemes:person:contactdetails]]
+<WRAP b2hero>
+**B2Base · 1.0.0-draft.1 · Projektentwurf**
-====== examples ======
+Rechtliche Bezeichnung und optionale Register-, Adress- und Kontaktangaben.
-===== json notation =====
-<code>
+[[schemes:scheme|Bibliothek]] · [[schemes:legalentity|Juristische Personen]] · [[schemes:principles|Internationale Grundregeln]]
+</WRAP>
+===== Direkt verwenden =====
+[[b2schema>1.0.0-draft.1/legalentity/nameanddetails.schema.json|Austauschschema (JSON)]] · [[b2schema>1.0.0-draft.1/legalentity/nameanddetails.editor.schema.json|Schema für den Designer]] · [[b2schema>1.0.0-draft.1/legalentity/nameanddetails.examples.json|Beispieldaten]]
+**Austauschschema:** vollständige Strukturprüfung mit JSON Schema 2020-12. **Designer-Fassung:** gleiche Datenfelder mit reduzierten Strukturregeln zur Feldübernahme. [[:guidelines#im_workflowdesigner_verwenden|Anleitung und Grenzen]]
+===== Felder im Überblick =====
+^ Feld ^ Typ ^ Pflicht im Modul ^ Bedeutung ^
+| ''name'' | string | Ja | Vollständiger rechtlicher Name in Originalschrift. |
+| ''names'' | array | Nein | Zusätzliche Sprachfassungen; nicht automatisch rechtlich gleichwertig. |
+| ''jurisdiction'' | string | Nein | Optionales Land der maßgeblichen Rechtsordnung; weitere Ebene in jurisdictionName. |
+| ''jurisdictionName'' | string | Nein | Zusätzliche oder abweichende Zuständigkeitsbezeichnung. |
+| ''legalForm'' | object | Nein | Rechtsform aus einem benannten nationalen oder internationalen Vokabular. |
+| ''registrationNumbers'' | array | Nein | Bekannte Registereinträge. |
+| ''address'' | object | Nein | Eine oder mehrere Adressen. |
+| ''contactInformation'' | object | Nein | Mindestens ein bekannter Kontaktkanal. |
+| ''extensions'' | object | Nein | Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern. |
+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.
+===== International richtig einsetzen =====
+  * Nicht jede juristische Person hat dieselben Registerarten oder alle Kontaktangaben verfügbar. Der rechtliche Name ist der gemeinsame Mindestkern.
+  * address und contactInformation enthalten tatsächliche Datenobjekte. Ein $ref in Beispieldaten würde diese Daten nicht laden.
+  * Nationale Registerprüfungen und die rechtliche Bedeutung der Rechtsform gehören in ein fachliches Profil.
+===== Gültige Beispiele =====
+Alle Beispiele sind synthetisch. Sie werden mit dem mitgelieferten Schema geprüft; daraus folgt keine fachliche Echtheit oder externe Erreichbarkeit.
+==== Beispiel 1 ====
+<file json example-1.json>
 {
-  "name": "Tech Solutions GmbH",
+  "name": "株式会社サンプル",
+  "jurisdiction": "JP",
+  "names": [
+    {
+      "text": "Sample Corporation",
+      "language": "en"
+    }
+  ]
+}
+</file>
+==== Beispiel 2 ====
+<file json example-2.json>
+{
+  "name": "Example Association",
   "registrationNumbers": [
     {
-      "type": "IHK",
+      "type": "association-register",
-      "number": "HRB123456"
+      "number": "00042",
-    },
+      "scheme": "https://example.org/register/associations"
-    {
-      "type": "Court",
-      "number": "AG987654"
-    },
-    {
-      "type": "Financial Authority",
-      "number": "BA12345"
     }
-  ],
+  ]
-  "address": {
-    "$ref": "https://b2base.eu/doku.php?id=schemes:person:addressdetails"
-  },
-  "contactInformation": {
-    "$ref": "https://b2base.eu/doku.php?id=schemes:person:contactdetails"
-  }
 }
-</code>
+</file>
-===== array notation =====
-<code>
-$legalEntity['name'] = "Tech Solutions GmbH";
-$legalEntity['registrationNumbers'][0]['type'] = "IHK";
+===== Umstellung aus dem bisherigen Wiki =====
-$legalEntity['registrationNumbers'][0]['number'] = "HRB123456";
-$legalEntity['registrationNumbers'][1]['type'] = "Court";
-$legalEntity['registrationNumbers'][1]['number'] = "AG987654";
-$legalEntity['registrationNumbers'][2]['type'] = "Financial Authority";
-$legalEntity['registrationNumbers'][2]['number'] = "BA12345";
-$legalEntity['address']['$ref'] = "https://b2base.eu/doku.php?id=schemes:person:addressdetails";
+Register, Adresse und Kontakt sind nicht mehr generell Pflicht. registrationNumbers benötigt nun scheme. Die alten Wiki-URLs als $ref und die gleichnamigen Platzhalter in Beispieldaten wurden durch lokal eingebettete Schemata und echte Daten ersetzt.
-$legalEntity['contactInformation']['$ref'] = "https://b2base.eu/doku.php?id=schemes:person:contactdetails";
+[[schemes:migration|Änderungsübersicht und Migrationsregeln]]
-</code>
+===== Vollständiges Schema =====
-====== schema ======
-<code>
+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.
+<file json nameanddetails.schema.json>
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://b2base.eu/doku.php?id=schemes:legalentity:nameanddetails",
+  "$id": "https://b2base.eu/schemas/1.0.0-draft.1/legalentity/nameanddetails.schema.json",
-  "title": "b2base:schemes:legalentity:nameanddetails",
+  "title": "Juristische Personen",
-  "description": "A schema for representing a legal entity's name and registration details.",
+  "$comment": "B2Base 1.0.0-draft.1. Projektentwurf, kein durch ISO oder andere Normungsgremien verabschiedeter Standard.",
   "type": "object",
+  "description": "Juristische Person; Registersysteme werden nicht auf deutsche Behörden reduziert.",
   "properties": {
     "name": {
       "type": "string",
-      "description": "The full legal name of the entity.",
+      "minLength": 1,
-      "example": "Tech Solutions GmbH"
+      "description": "Vollständiger rechtlicher Name in Originalschrift."
+    },
+    "names": {
+      "type": "array",
+      "description": "Zusätzliche Sprachfassungen; nicht automatisch rechtlich gleichwertig.",
+      "items": {
+        "$ref": "#/$defs/LocalizedText"
+      }
+    },
+    "jurisdiction": {
+      "$ref": "#/$defs/CountryCode",
+      "description": "Optionales Land der maßgeblichen Rechtsordnung; weitere Ebene in jurisdictionName."
+    },
+    "jurisdictionName": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Zusätzliche oder abweichende Zuständigkeitsbezeichnung."
+    },
+    "legalForm": {
+      "$ref": "#/$defs/CodedValue",
+      "description": "Rechtsform aus einem benannten nationalen oder internationalen Vokabular."
     },
     "registrationNumbers": {
       "type": "array",
-      "description": "A list of legal registration numbers of the entity, with their respective types.",
+      "description": "Bekannte Registereinträge.",
       "items": {
         "type": "object",
+        "description": "Registerkennung.",
         "properties": {
           "type": {
             "type": "string",
-            "description": "The type of registration, e.g., IHK, court, financial authority.",
+            "minLength": 1,
-            "example": "IHK"
+            "description": "Registerart."
           },
           "number": {
             "type": "string",
-            "description": "The registration number associated with this type.",
+            "minLength": 1,
-            "example": "HRB123456"
+            "description": "Registerkennung; führende Nullen erhalten."
+          },
+          "scheme": {
+            "type": "string",
+            "minLength": 1,
+            "description": "URI des Registers oder Kennungssystems.",
+            "format": "uri"
+          },
+          "issuer": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Registerführende Stelle."
+          },
+          "country": {
+            "$ref": "#/$defs/CountryCode"
           }
         },
-        "required": ["type", "number"]
+        "required": [
+          "type",
+          "number",
+          "scheme"
+        ],
+        "additionalProperties": false
       },
       "minItems": 1
     },
     "address": {
-      "$ref": "https://b2base.eu/doku.php?id=schemes:person:addressdetails",
+      "$ref": "#/$defs/AddressDetails"
-      "description": "The legal address of the entity as defined in the address details schema."
     },
     "contactInformation": {
-      "$ref": "https://b2base.eu/doku.php?id=schemes:person:contactdetails",
+      "$ref": "#/$defs/ContactDetails"
-      "description": "The contact details of the entity as defined in the contact details schema."
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern.",
+      "properties": {},
+      "additionalProperties": true,
+      "propertyNames": {
+        "format": "uri"
+      }
     }
   },
-  "required": ["name", "registrationNumbers", "address", "contactInformation"]
+  "required": [
+    "name"
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "LocalizedText": {
+      "type": "object",
+      "description": "Text mit expliziter Sprache; Originalschreibweise erhalten.",
+      "properties": {
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Inhalt in Unicode."
+        },
+        "language": {
+          "$ref": "#/$defs/LanguageTag"
+        }
+      },
+      "required": [
+        "text",
+        "language"
+      ],
+      "additionalProperties": false
+    },
+    "LanguageTag": {
+      "type": "string",
+      "minLength": 1,
+      "description": "BCP-47-Sprachtag, etwa de, zh-Hant-TW, sr-Latn oder x-internal. Das Muster prüft nur die Grundform, nicht Registrierung oder alle BCP-47-Regeln.",
+      "pattern": "^[A-Za-z]{1,8}(-[A-Za-z0-9]{1,8})*$"
+    },
+    "CountryCode": {
+      "type": "string",
+      "minLength": 1,
+      "description": "ISO 3166-1 Alpha-2, Großbuchstaben. Das Muster prüft nur die Schreibweise; zugewiesenen Code und Gültigkeitszeitpunkt gesondert prüfen.",
+      "pattern": "^[A-Z]{2}$"
+    },
+    "CodedValue": {
+      "type": "object",
+      "description": "Fachlicher Code mit benanntem Vokabular.",
+      "properties": {
+        "value": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Code aus dem bezeichneten Vokabular; als Text unverändert übernehmen."
+        },
+        "scheme": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Absolute URI des Vokabulars, einschließlich einer Version, falls dessen Bedeutung veränderlich ist.",
+          "format": "uri"
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Optionale lesbare Bezeichnung."
+        },
+        "language": {
+          "$ref": "#/$defs/LanguageTag",
+          "description": "Sprache der Bezeichnung, nicht Staatsangehörigkeit."
+        }
+      },
+      "required": [
+        "value",
+        "scheme"
+      ],
+      "additionalProperties": false
+    },
+    "AddressDetails": {
+      "type": "object",
+      "description": "Eine oder mehrere Adressen.",
+      "properties": {
+        "addresses": {
+          "type": "array",
+          "description": "Bekannte Adressen.",
+          "items": {
+            "$ref": "#/$defs/Address"
+          },
+          "minItems": 1
+        },
+        "extensions": {
+          "type": "object",
+          "description": "Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern.",
+          "properties": {},
+          "additionalProperties": true,
+          "propertyNames": {
+            "format": "uri"
+          }
+        }
+      },
+      "required": [
+        "addresses"
+      ],
+      "additionalProperties": false
+    },
+    "Address": {
+      "type": "object",
+      "description": "Internationale Post- oder Standortadresse. Weder Straße, Hausnummer, Stadt noch Postleitzahl sind weltweit obligatorisch.",
+      "properties": {
+        "type": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Verwendungszweck, etwa home, work oder delivery."
+        },
+        "addressLines": {
+          "type": "array",
+          "description": "Geordnete Druckzeilen in der Originalschrift; bei Angabe maßgeblich für die Darstellung.",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Eine Adresszeile."
+          },
+          "minItems": 1
+        },
+        "language": {
+          "$ref": "#/$defs/LanguageTag"
+        },
+        "recipient": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Optionale Empfängerbezeichnung."
+        },
+        "street": {
+          "type": "object",
+          "description": "Straßenname.",
+          "properties": {
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Straßenname."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "additionalProperties": false
+        },
+        "number": {
+          "type": "object",
+          "description": "Hausnummer, auch alphanumerisch.",
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Hausnummer, auch alphanumerisch."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "value"
+          ],
+          "additionalProperties": false
+        },
+        "unit": {
+          "type": "object",
+          "description": "Einheit oder Wohnung.",
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Einheit oder Wohnung."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "value"
+          ],
+          "additionalProperties": false
+        },
+        "floor": {
+          "type": "object",
+          "description": "Etagenbezeichnung.",
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Etagenbezeichnung."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "value"
+          ],
+          "additionalProperties": false
+        },
+        "postBox": {
+          "type": "object",
+          "description": "Postfach.",
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Postfach."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "value"
+          ],
+          "additionalProperties": false
+        },
+        "blockOrPlotNumber": {
+          "type": "object",
+          "description": "Block- oder Parzellenbezeichnung.",
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Block- oder Parzellenbezeichnung."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "value"
+          ],
+          "additionalProperties": false
+        },
+        "city": {
+          "type": "object",
+          "description": "Ort oder Zustellbezirk.",
+          "properties": {
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Ort oder Zustellbezirk."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "additionalProperties": false
+        },
+        "state": {
+          "type": "object",
+          "description": "Region, Provinz oder Bundesstaat.",
+          "properties": {
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Region, Provinz oder Bundesstaat."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "additionalProperties": false
+        },
+        "postalCode": {
+          "type": "object",
+          "description": "Postleitzahl als Text; keine globale fünfstellige Regel.",
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Postleitzahl als Text; keine globale fünfstellige Regel."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "value"
+          ],
+          "additionalProperties": false
+        },
+        "wardNumber": {
+          "type": "object",
+          "description": "Verwaltungsbezirk.",
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Verwaltungsbezirk."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "required": [
+            "value"
+          ],
+          "additionalProperties": false
+        },
+        "country": {
+          "type": "object",
+          "description": "Zielland. Name und Code sind verschiedene Informationen.",
+          "properties": {
+            "code": {
+              "$ref": "#/$defs/CountryCode"
+            },
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Landesname in der angegebenen Sprache."
+            },
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
+          },
+          "additionalProperties": false,
+          "anyOf": [
+            {
+              "required": [
+                "code"
+              ]
+            },
+            {
+              "required": [
+                "name"
+              ]
+            }
+          ]
+        },
+        "militaryAddress": {
+          "type": "boolean",
+          "description": "Kennzeichnet eine militärische Adresse, falls bekannt."
+        },
+        "geolocation": {
+          "$ref": "#/$defs/Geolocation"
+        },
+        "extensions": {
+          "type": "object",
+          "description": "Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern.",
+          "properties": {},
+          "additionalProperties": true,
+          "propertyNames": {
+            "format": "uri"
+          }
+        }
+      },
+      "required": [
+        "country"
+      ],
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "addressLines"
+          ]
+        },
+        {
+          "required": [
+            "street"
+          ]
+        },
+        {
+          "required": [
+            "postBox"
+          ]
+        },
+        {
+          "required": [
+            "city"
+          ]
+        },
+        {
+          "required": [
+            "geolocation"
+          ]
+        },
+        {
+          "required": [
+            "blockOrPlotNumber"
+          ]
+        }
+      ]
+    },
+    "Geolocation": {
+      "type": "object",
+      "description": "WGS-84-Koordinaten in Dezimalgrad. Benannte Felder vermeiden eine vertauschte Achsenreihenfolge.",
+      "properties": {
+        "latitude": {
+          "type": "number",
+          "description": "Breitengrad.",
+          "minimum": -90,
+          "maximum": 90
+        },
+        "longitude": {
+          "type": "number",
+          "description": "Längengrad.",
+          "minimum": -180,
+          "maximum": 180
+        },
+        "accuracyMeters": {
+          "type": "number",
+          "description": "Geschätzter horizontaler Unsicherheitsradius in Metern.",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "latitude",
+        "longitude"
+      ],
+      "additionalProperties": false
+    },
+    "ContactDetails": {
+      "type": "object",
+      "description": "Mindestens ein bekannter Kontaktkanal.",
+      "properties": {
+        "emails": {
+          "type": "array",
+          "description": "E-Mail-Adressen; Unicode ist zulässig.",
+          "items": {
+            "type": "object",
+            "description": "Ein E-Mail-Kontakt.",
+            "properties": {
+              "type": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Verwendungszweck."
+              },
+              "address": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Internationale E-Mail-Adresse; Zustellbarkeit und SMTPUTF8-Unterstützung separat prüfen.",
+                "format": "idn-email"
+              },
+              "language": {
+                "$ref": "#/$defs/LanguageTag"
+              }
+            },
+            "required": [
+              "address"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "phoneNumbers": {
+          "type": "array",
+          "description": "Internationale Telefonnummern.",
+          "items": {
+            "type": "object",
+            "description": "Eine vollständig normalisierte Rufnummer ohne Durchwahl.",
+            "properties": {
+              "type": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Verwendungszweck."
+              },
+              "number": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Pluszeichen und höchstens 15 Ziffern nach E.164; keine Aussage über tatsächliche Vergabe.",
+                "pattern": "^\\+[1-9][0-9]{1,14}$"
+              },
+              "extension": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Durchwahl separat; kein Bestandteil der E.164-Rufnummer."
+              },
+              "displayNumber": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Optionale ursprüngliche Schreibweise."
+              }
+            },
+            "required": [
+              "number"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "socialMedia": {
+          "type": "array",
+          "description": "Weitere Plattformkontakte.",
+          "items": {
+            "type": "object",
+            "description": "Plattform und Kennung.",
+            "properties": {
+              "platform": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Plattform."
+              },
+              "handle": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Unveränderter Benutzername."
+              },
+              "url": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Optionaler Profil-Link.",
+                "format": "uri"
+              }
+            },
+            "required": [
+              "platform",
+              "handle"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "websites": {
+          "type": "array",
+          "description": "Webseiten.",
+          "items": {
+            "type": "object",
+            "description": "Eine Webseite.",
+            "properties": {
+              "type": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Verwendungszweck."
+              },
+              "url": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Internationale Webadresse; Abruf gesondert entscheiden.",
+                "format": "iri",
+                "pattern": "^https?://"
+              }
+            },
+            "required": [
+              "url"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "extensions": {
+          "type": "object",
+          "description": "Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern.",
+          "properties": {},
+          "additionalProperties": true,
+          "propertyNames": {
+            "format": "uri"
+          }
+        }
+      },
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "emails"
+          ]
+        },
+        {
+          "required": [
+            "phoneNumbers"
+          ]
+        },
+        {
+          "required": [
+            "socialMedia"
+          ]
+        },
+        {
+          "required": [
+            "websites"
+          ]
+        }
+      ]
+    }
+  },
+  "examples": [
+    {
+      "name": "株式会社サンプル",
+      "jurisdiction": "JP",
+      "names": [
+        {
+          "text": "Sample Corporation",
+          "language": "en"
+        }
+      ]
+    },
+    {
+      "name": "Example Association",
+      "registrationNumbers": [
+        {
+          "type": "association-register",
+          "number": "00042",
+          "scheme": "https://example.org/register/associations"
+        }
+      ]
+    }
+  ]
 }
-</code>
+</file>
+===== Quellen und Abgrenzung =====
+  * [[https://www.w3.org/International/questions/qa-personal-names|W3C: Personal names around the world]]
+  * [[https://json-schema.org/understanding-json-schema/structuring|JSON Schema: Aufbau und Referenzen]]
+  * [[https://www.iso.org/iso-3166-country-codes.html|ISO: ISO 3166-Ländercodes]]
+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.
+[[schemes:scheme|Zur Bibliothek]] · [[:guidelines|Integration]] · [[:faq|Häufige Fragen]]