XBau 2.6 Schnittstellendokumentation
Was ist XBau?
XBau (XBau-Hochbau) ist ein vom IT-Planungsrat verabschiedeter XÖV-Standard für den elektronischen Datenaustausch im Baugenehmigungsverfahren. Er definiert XML-basierte Nachrichtentypen, mit denen Bauaufsichtsbehörden, Fachbehörden (TöB), Gemeinden und Antragsteller strukturiert kommunizieren. Der Standard wird von der XLeitstelle gepflegt. Das Bauplan Amt Cockpit basiert auf der Spezifikation XBau-Hochbau Release 2.6 (Endfassung). Der modulare Aufbau besteht aus dem XBau-Kernmodul (gemeinsame Datentypen, Codelisten) und dem XBau-Hochbau-Modul (Verfahrensnachrichten).
Wichtige Nachrichtentypen (XBau 2.6)
Jede XBau-Nachricht hat einen vierstelligen Nachrichtentyp-Code:
| Code | Nachricht | Richtung |
|---|---|---|
| 02xx | Baugenehmigungsverfahren | |
| 0200 | Baugenehmigung – Antrag | Antragsteller → Behörde |
| 0201 | Baugenehmigung – Empfangsbestätigung | Behörde → Antragsteller |
| 0202 | Baugenehmigung – Änderung | Antragsteller → Behörde |
| 0203 | Baugenehmigung – Nachforderung | Behörde → Antragsteller |
| 0204 | Baugenehmigung – Bescheid | Behörde → Antragsteller |
| 021x | Vorbescheid | |
| 0210 | Vorbescheid – Antrag | Antragsteller → Behörde |
| 0212 | Vorbescheid – Bescheid | Behörde → Antragsteller |
| 03xx | Beteiligungsverfahren | |
| 0300 | Beteiligung – Anforderung Stellungnahme | Behörde → TöB |
| 0301 | Beteiligung – Stellungnahme | TöB → Behörde |
| 0302 | Nachbarbeteiligung – Anforderung | Behörde → Nachbar |
| 0303 | Nachbarbeteiligung – Stellungnahme | Nachbar → Behörde |
| 04xx | Statistiknachrichten | |
| 0400 | Hochbaustatistik – Übermittlung | Behörde → Statistikamt |
| 05xx | Prüfung bautechnischer Nachweise | |
| 0500 | Prüfingenieur – Beauftragung | Behörde → Prüfingenieur |
| 0501 | Prüfingenieur – Prüfbericht | Prüfingenieur → Behörde |
| 06xx | Genehmigungsfreistellung | |
| 0600 | Genehmigungsfreistellung – Anzeige | Antragsteller → Behörde |
| 09xx | Bauzustandsanzeigen | |
| 0900 | Baubeginnanzeige | Bauherr → Behörde |
| 0950 | Fertigstellungsanzeige | Bauherr → Behörde |
Schwerpunkte in XBau 2.6
- Erweiterte Unterstützung für den digitalen Bauantrag gemäß OZG (Onlinezugangsgesetz) — Ende-zu-Ende-Digitalisierung
- Erweiterungen bei der Abgeschlossenheitsbescheinigung (025x-Serie) mit angepassten Prozessen und erweitertem Datenumfang
- Kapitel Bauüberwachung (09xx-Serie) — Baubeginnanzeige, Bauzustandsanzeigen, Fertigstellungsanzeige
- Verbesserte Hochbaustatistik-Nachrichten (04xx) für Kommunikation mit Statistikämtern
- Übermittlung von Bauvorlagen an Prüfingenieure (05xx-Serie) für bautechnische Nachweise
- Aktualisiertes XBau-Kernmodul mit generischem Antragstyp und XÖV-Kernkomponenten (Anschrift, Person)
So funktioniert das Monitoring
Das Bauplan Amt Cockpit dient als Monitoring- und Informationssystem für Bauaufsichtsbehörden. Es liest XBau-Nachrichten von Fachverfahren wie Prosoz Bau ein und stellt alle Vorgänge in einer zentralen Übersicht dar — ohne dass Sachbearbeiter das Fachverfahren ständig öffnen müssen.
┌──────────────┐ XBau 2.6 ┌──────────────────┐
│ Prosoz Bau │───(XML/OSCI)───▶│ Import-Service │
│ (Fachverf.) │ │ (API Backend) │
└──────────────┘ └────────┬─────────┘
│
Parse & Upsert
│
┌────────▼─────────┐
│ PostgreSQL │
│ (Verfahren, │
│ Fristen, Events) │
└────────┬─────────┘
│
Next.js SSR
│
┌────────▼─────────┐
│ Bauplan Amt │
│ Cockpit UI │
│ (Dashboard, │
│ Fristen, Gantt) │
└──────────────────┘Import-Wege
Der Import-Service prüft regelmäßig ein Inbox-Verzeichnis auf neue XBau-XML-Dateien. Prosoz Bau exportiert Nachrichten (z.B. 0200 Bauantrag) als Dateien in dieses Verzeichnis. Der Parser extrahiert Aktenzeichen, Bauherr, Grundstück etc. und erstellt oder aktualisiert das Verfahren in der Datenbank.
POST /api/v1/import/xbau/pollVerfahren können auch manuell über die API mit optionalem XBau-XML angelegt werden. Dies ist nützlich für Tests oder wenn XBau-Nachrichten von externen Systemen per HTTP zugestellt werden.
POST /api/v1/import/xbau/manualXBau-Felder im Datenmodell
Folgende XBau-Felder werden beim Import extrahiert und im System gespeichert:
- Gemarkung, Flur, Flurstück
- Straße, Hausnummer
- PLZ, Ort
- Name
- Adresse (Straße, PLZ, Ort)
- Telefon, E-Mail
- Wohneinheiten, Geschosse
- Grund-/Wohn-/Nutzfläche
- Baukosten, Stellplätze
Integration mit Prosoz Bau
Prosoz (Herten) ist einer der führenden Anbieter von Fachverfahren für Bauaufsichtsbehörden. Das Kernsystem ProBAUG verarbeitet Bauanträge und kommuniziert über den XBau-Standard via XTA-Transport (XML Transport Adapter) mit Portalen und externen Stellen. Die Plattform Prosoz elan comfort ergänzt ProBAUG um digitale Antragstellung, Genehmigungsverarbeitung und medienbruchfreie Behördenbeteiligung.
Im Produktionsbetrieb würde die Anbindung wie folgt funktionieren:
- Prosoz Bau / ProBAUG exportiert bei Statusänderungen (neuer Antrag, Genehmigung, etc.) automatisch XBau-Nachrichten als XML-Dateien oder über XTA/OSCI-Transport.
- Der Import-Service dieses Cockpits empfängt die Nachrichten per Dateisystem-Polling oder HTTP-Endpoint und parst die XBau-XML-Struktur.
- Verfahren werden angelegt oder aktualisiert — inkl. automatischer Fristberechnung und Audit-Logging aller Änderungen.
- Das Dashboard zeigt alle Verfahren in Echtzeit mit Status, Fristen, Beteiligungen und Dokumentenübersicht — ohne ProBAUG öffnen zu müssen.
Hinweis: Demo-Modus
Diese Instanz läuft aktuell im Demo-Modus mit Beispieldaten. Im Produktionsbetrieb würden die Verfahrensdaten automatisch über die XBau-Schnittstelle aus Prosoz Bau importiert. Der Admin-Login (admin/admin) dient nur der Demonstration, um Beispieldaten zu erstellen und zu bearbeiten.