Zum Inhalt springen
RUMLRUML

Open Format for Digital Law

3.7 Strukturbeispiel

3.7 Vollständiges Strukturbeispiel

{
"$format": "RUML",
"$specVersion": "1.0",
"metadata": {
"id": "ec36948d-fbb2-4815-985a-bd5e9375d934",
"version": "1.0.0",
"created": "2024-01-01T12:00:00+01:00",
"modified": "2024-01-15T14:30:00+01:00",
"status": "draft",
"documentType": "procedure",
"title": "Credit Approval"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"operator": "AND",
"label": "Approve credit?",
"children": ["2", "7"]
},
"2": {
"id": "6840b48d-117f-474e-ae4e-337b8e60537c",
"operator": "OR",
"label": "Income verification",
"children": ["3", "4"]
},
"3": {
"id": "9ddd08c6-a6d3-4f0f-9bb9-1adbe33b6e10",
"label": "High income"
},
"4": {
"id": "e07fe192-121b-43eb-90f0-eca4573ba8fa",
"operator": "AND",
"label": "Medium income + collateral",
"children": ["5", "6"]
},
"5": {
"id": "fcf02185-ffee-48a4-bf93-d2fb1b17944d",
"label": "Medium income"
},
"6": {
"id": "4a9f0fc7-c802-489e-8ae2-3596ba584fd9",
"label": "Collateral available"
},
"7": {
"id": "043fdfce-d617-4a76-af40-e02de43c07b8",
"operator": "NOT_AND",
"label": "No negative indicators",
"children": ["8", "9"]
},
"8": {
"id": "38f26fa1-17a5-4e38-9054-3147e3158a41",
"label": "Insolvency present"
},
"9": {
"id": "7baae662-0b5c-44bb-9a2b-802074fe5d0f",
"label": "Negative SCHUFA entry"
}
}
}
}

3.7.1 Ergänzungsbeispiel: RUML-Datei als Gesetz

Dieses Beispiel zeigt eine RUML-Datei, die einen Gesetzestext repräsentiert (documentType: "law"). Jeder Knoten markiert die Norm, die er repräsentiert, mit einem Anker vom Typ represents in der Node-Level-Capability ruml:text-reference; die zugehörigen Texteinträge liegen im data-Objekt der Root-Level-Capability ruml:text-reference (siehe Kapitel 4.12).

{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"data": {
"text_estg_32a": {
"title": "§ 32a EStG – Einkommensteuertarif",
"uri": "/akn/de/act/2024-01-01/estg#sec_32a",
"timestamp": "2024-01-15T00:00:00Z",
"status": "inForce",
"type": "embedded",
"text": "§ 32a Einkommensteuer\n(1) Die tarifliche Einkommensteuer bemisst sich nach dem zu versteuernden Einkommen. Sie beträgt ab dem Veranlagungszeitraum 2024 vorbehaltlich der §§ 32b, 32d, 34, 34a, 34b und 34c jeweils in Euro für zu versteuernde Einkommen bis 11.604 Euro (Grundfreibetrag): 0 ...",
"validFrom": "2024-01-01T00:00:00Z",
"language": "de"
},
"text_estg_1": {
"title": "§ 1 EStG – Steuerpflicht",
"uri": "/akn/de/act/2024-01-01/estg#sec_1",
"timestamp": "2024-01-15T00:00:00Z",
"status": "inForce",
"type": "embedded",
"text": "§ 1 Steuerpflicht\n(1) Natürliche Personen, die im Inland einen Wohnsitz oder ihren gewöhnlichen Aufenthalt haben, sind unbeschränkt einkommensteuerpflichtig.",
"validFrom": "2024-01-01T00:00:00Z",
"language": "de"
}
}
}
}
],
"metadata": {
"id": "ec36948d-fbb2-4815-985a-bd5e9375d934",
"version": "2024-01-01",
"created": "2024-01-15T10:00:00+01:00",
"modified": "2024-01-15T10:00:00+01:00",
"status": "draft",
"documentType": "law",
"title": "Income Tax – Basic Allowance"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"operator": "AND",
"label": "Income tax applies",
"children": ["2", "3"],
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_estg_32a",
"type": "represents"
}
]
}
}
]
},
"2": {
"id": "8fc54c7d-7f60-410e-9493-4f1eecfb1af8",
"label": "Income exceeds basic allowance",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_estg_32a",
"type": "represents"
}
]
}
}
]
},
"3": {
"id": "56b5b9db-b791-4fe5-abb0-a05cb0847db6",
"label": "Unlimited tax liability",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_estg_1",
"type": "represents"
}
]
}
}
]
}
}
}
}

Hinweise zum Ergänzungsbeispiel:

  • Die Root-Level-Capability ruml:text-reference enthält die Normtexte in ihrem data-Objekt, adressiert über ihre Text-IDs (Kapitel 4.12)
  • Jeder Knoten markiert die Norm, die er repräsentiert, mit einem Anker vom Typ represents, der einen Texteintrag derselben Datei über dessen id benennt
  • Die Texte sind hier Klartext-Einträge (text), daher adressiert ein Anker einen ganzen Eintrag. Um einzelne Absätze oder Sätze zu verankern, trägt das Gesetz seinen Text als RUML Text, und Anker ergänzen die GUID des Elements als element (siehe 3.7.2)
  • Ein represents-Anker ist optional, SOLLTE aber bei Knoten einer documentType: "law"-Datei vorhanden sein

3.7.2 Ergänzungsbeispiel: Gesetz als RUML Text

Ein Gesetz wird einmal getragen, in der RUML-Datei, die es repräsentiert. Diese Datei trägt § 1 SGB XII als RUML Text, und ihre Knoten verankern sich in diesem Text — bis hinunter zu einzelnen Sätzen. Anker sind lokal (Kapitel 4.12): Andere Rulemaps verankern sich nicht in diesem Text, sondern referenzieren die Knoten dieser Datei.

{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"data": {
"text_main": {
"title": "Sozialgesetzbuch (SGB) Zwölftes Buch (XII) – Sozialhilfe",
"uri": "eli/bund/bgbl-1/2003/s3023/2026-07-30/1/deu",
"timestamp": "2026-10-09T00:00:00Z",
"type": "embedded",
"digest": "sha3-256:541651b3dea3102b4e29d035fbeebd8d6473630975d4848e57bf2831bb0249b3",
"source": {
"uri": "https://testphase.rechtsinformationen.bund.de/v1/legislation/eli/bund/bgbl-1/2003/s3023/2026-07-30/1/deu/regelungstext-verkuendung-1.xml"
},
"content": {
"type": "akomaNtoso",
"attrs": {
"xmlns": "http://Inhaltsdaten.LegalDocML.de/1.8.2/"
},
"content": [
{
"type": "act",
"attrs": {
"name": "regelungstext"
},
"content": [
{
"type": "body",
"attrs": {
"eId": "hauptteil-n1",
"GUID": "1f4e2a90-6b3c-4d7e-8a51-0c9d2e7f3b11"
},
"content": [
{
"type": "article",
"attrs": {
"eId": "art-z1",
"GUID": "0b1e9e8a-2c55-4f5f-9a3e-6d1c7b2a4e01"
},
"content": [
{
"type": "num",
"attrs": {
"eId": "art-z1_bezeichnung-n1",
"GUID": "6e3a1d70-9c42-4b85-a7f1-3d2c8b0e5f12"
},
"content": ["§ 1"]
},
{
"type": "heading",
"attrs": {
"eId": "art-z1_überschrift-n1",
"GUID": "2a9c5e81-4d07-4f3b-b6e2-8f1a0c7d9e13"
},
"content": ["Aufgabe der Sozialhilfe"]
},
{
"type": "paragraph",
"attrs": {
"eId": "art-z1_abs-z",
"GUID": "5d8f3c21-7a64-4c0b-8e2f-1a9b6c3d7e02"
},
"content": [
{
"type": "num",
"attrs": {
"eId": "art-z1_abs-z_bezeichnung-n1",
"GUID": "8b2d4f63-1e90-4a7c-9d35-6f0e2b1c8a14"
}
},
{
"type": "content",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1",
"GUID": "3c7e9b05-2f18-4d6a-8e4c-1b9d0f5a7c15"
},
"content": [
{
"type": "p",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1_text-n1",
"GUID": "d4a1c826-5b3e-4f07-a9d2-7e6c3b0f1a16"
},
"content": [
"Aufgabe der Sozialhilfe ist es, den Leistungsberechtigten die Führung eines Lebens zu ermöglichen, das der Würde des Menschen entspricht.",
{
"type": "marker",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1_text-n1_marker-n1",
"GUID": "9a7c2e14-3b58-4d6f-a1e0-4c2b8d5f6a03",
"refersTo": "satzende"
}
},
" Die Leistung soll sie so weit wie möglich befähigen, unabhängig von ihr zu leben; darauf haben auch die Leistungsberechtigten nach ihren Kräften hinzuarbeiten.",
{
"type": "marker",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1_text-n1_marker-n2",
"GUID": "f15b8e37-6a29-4c41-8d7f-2e0a9c3b5d17",
"refersTo": "satzende"
}
},
" Zur Erreichung dieser Ziele haben die Leistungsberechtigten und die Träger der Sozialhilfe im Rahmen ihrer Rechte und Pflichten zusammenzuwirken.",
{
"type": "marker",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1_text-n1_marker-n3",
"GUID": "7e2c0a49-8d16-4b5e-9f83-5a1d4c6e2b18",
"refersTo": "satzende"
}
}
]
}
]
}
]
}
]
}
]
}
]
}
]
}
}
}
}
}
],
"metadata": {
"id": "ec36948d-fbb2-4815-985a-bd5e9375d934",
"version": "2026-07-30",
"created": "2026-10-09T00:00:00Z",
"modified": "2026-10-09T00:00:00Z",
"status": "inForce",
"validFrom": "2026-07-30T00:00:00Z",
"documentType": "law",
"title": "SGB XII § 1"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"operator": "AND",
"label": "Aufgabe der Sozialhilfe",
"children": ["2", "3"],
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_main",
"element": "5d8f3c21-7a64-4c0b-8e2f-1a9b6c3d7e02",
"type": "represents"
}
]
}
}
]
},
"2": {
"id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
"label": "Beneficiary works towards independence as far as possible",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_main",
"element": "f15b8e37-6a29-4c41-8d7f-2e0a9c3b5d17",
"type": "represents"
}
]
}
}
]
},
"3": {
"id": "c3d4e5f6-a7b8-4c9d-ae1f-2a3b4c5d6e7f",
"label": "Beneficiary cooperates with the social assistance agency",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_main",
"element": "7e2c0a49-8d16-4b5e-9f83-5a1d4c6e2b18",
"type": "represents"
},
{
"id": "text_main",
"element": "9a7c2e14-3b58-4d6f-a1e0-4c2b8d5f6a03",
"type": "refers-to"
}
]
}
}
]
}
}
}
}

Hinweise zum RUML-Text-Beispiel:

  • Der Text von § 1 SGB XII existiert einmal, in dieser Datei; jeder Anker benennt den Eintrags-Key text_main und als element eine GUID seines RUML Text
  • 5d8f3c21-… ist der Absatz von § 1; f15b8e37-… und 7e2c0a49-… sind die Satzende-Marker von Satz 2 und Satz 3, weil LegalDocML.de Satzenden mit satzende-Markern auszeichnet
  • Knoten 3 repräsentiert Satz 3 und verweist auf Satz 1 (9a7c2e14-…), der das Ziel nennt, dem das Zusammenwirken dient
  • Erhält das Gesetz eine neue Fassung, bleiben die Anker unverändert: Die GUID-Werte bestehen fort, solange die Elemente existieren, auch wenn sie neu nummeriert werden