GAEB XML Fehler beheben – Tipps & Tools

GAEB XML ist das Standardformat für den elektronischen Datenaustausch im Bauwesen. In der Praxis hapert es jedoch häufig: Dateien werden nicht eingelesen, Positionen fehlen, oder die Übertragung zwischen Programmen erzeugt Fehler, die erst später im Prozess auffallen. Dieser Artikel zeigt, welche GAEB XML Fehler typischerweise auftreten, wie du sie erkennst und wie du sie mit den richtigen Tools oder mit KI-Unterstützung behebst.

Warum GAEB XML im Bauablauf so fehleranfällig ist

GAEB XML wurde entwickelt, um Leistungsverzeichnisse, Ausschreibungsdaten und Angebote maschinenlesbar zwischen Auftraggebern, Bietern und AVA-Programmen auszutauschen. Die Spezifikation ist komplex: Es gibt unterschiedliche Phasen (DA81, DA82, DA83, DA84 usw.), verschiedene Versionen (GAEB 90, GAEB 2000, GAEB XML 3.x) und eine Vielzahl optionaler Felder mit strengen Formatvorgaben.

Das Problem in der Praxis: Viele Baubetriebe exportieren GAEB-Dateien aus unterschiedlichen Programmen, und jedes Programm interpretiert die Spezifikation leicht anders. Wenn dann ein Bieter die Datei in sein eigenes AVA-Programm importiert, entstehen Fehler. Manchmal meldet das Programm einen konkreten Fehler, manchmal importiert es die Datei ohne Meldung, aber mit fehlenden oder falsch zugeordneten Inhalten.

Kalkulatoren und IT-Verantwortliche stehen dann vor der Frage: Wo liegt der Fehler, und wie behebe ich ihn ohne stundenlange manuelle Prüfung?

Typische GAEB XML Fehler und ihre Ursachen

Falsches Phasenformat: Eine DA83-Datei (Angebotsabgabe) wird als DA81 (Ausschreibung) weitergereicht oder umgekehrt. Empfangssysteme lehnen die Datei ab oder interpretieren sie falsch. Prüfe immer, ob das Phasenattribut im Root-Element mit dem tatsächlichen Verwendungszweck übereinstimmt.

Zeichencodierungsfehler: GAEB XML erwartet UTF-8 oder ISO-8859-1, je nach Version. Sonderzeichen wie Umlaute (ä, ö, ü) oder das Scharfe-S führen zu Parse-Fehlern, wenn die Codierung nicht stimmt. Das passiert besonders beim Export aus älteren Programmen oder bei manuell bearbeiteten Dateien.

Ungültige Positionsnummern: Leistungsverzeichnis-Positionen müssen eindeutige, hierarchisch korrekte OZ-Nummern tragen. Doppelte Nummern oder Nummern, die nicht der Gliederungsstruktur entsprechen, verursachen Importfehler im Empfangssystem. Mehr zur korrekten Struktur von LV-Positionen findest du im Artikel Leistungsverzeichnis Positionen mit KI generieren.

Fehlende Pflichtfelder: Bestimmte Tags wie Mengeneinheit, Einheitspreis oder Kurztext sind je nach Phase Pflicht. Werden sie leer exportiert oder fehlen sie im XML-Baum, validiert die Datei nicht gegen das Schema. Manche AVA-Programme füllen fehlende Felder still mit Nullwerten auf, was die Kalkulation verfälscht.

Schemaversion stimmt nicht: GAEB XML 3.1 und 3.2 unterscheiden sich in Details. Ein Export aus einem neueren Programm kann gegen ein älteres Schema ungültig sein. Das ist besonders relevant, wenn Auftraggeber ein bestimmtes Format vorschreiben.

Verschachtelte Gruppen ohne Abschlusstag: Fehlerhafte XML-Struktur durch nicht korrekt geschlossene Tags ist selten, aber tückisch. Solche Fehler lassen sich nur mit einem XML-Editor oder Validator erkennen.

So prüfst du GAEB XML Dateien auf Fehler

Der erste Schritt ist eine Schemavalidierung. Die GAEB-Datenaustausch-Gesellschaft stellt XSD-Schemadateien bereit, gegen die du deine XML-Datei prüfen kannst. Tools wie XMLSpy, oXygen oder auch kostenlose Online-Validatoren können das übernehmen. Damit erkennst du strukturelle Fehler sofort.

Für inhaltliche Prüfungen, also ob die Positionsinhalte sinnvoll sind und ob alle erforderlichen Felder belegt sind, reicht eine reine Schemavalidierung nicht aus. Hier helfen spezialisierte GAEB-Prüftools, die viele AVA-Softwareanbieter mitliefern. Alternativ kannst du die Datei in einem neutralen AVA-Programm importieren und die Importprotokolle auswerten.

Wenn du GAEB-Dateien regelmäßig aus unterschiedlichen Quellen empfängst, lohnt sich ein automatisierter Prüfschritt im Workflow, bevor die Datei in die Kalkulation geht. Wie eine solche automatisierte Verarbeitung aussehen kann, zeigt der Artikel GAEB-Datei automatisch erstellen mit KI im Bau.

GAEB XML Fehler mit KI beheben

Für Kalkulatoren, die keine tiefen XML-Kenntnisse haben, ist KI ein pragmatischer Weg, Fehler zu analysieren. Du kannst den Inhalt einer fehlerhaften GAEB-Datei oder die Fehlermeldung aus deinem AVA-Programm direkt in ein KI-Tool wie BauGPT einspeisen und konkrete Hinweise auf die Fehlerursache erhalten.

BauGPT kann beispielsweise:

Das spart Zeit gegenüber dem Weg über Hotlines oder Handbücher, vor allem bei unbekannten Fehlercodes. Wie KI dabei helfen kann, Ausschreibungsunterlagen insgesamt schneller zu prüfen, erklärt der Artikel Ausschreibungsunterlagen schnell prüfen mit KI-Hilfe.

Fehler von vornherein vermeiden

Die beste Fehlerbehebung ist die Vermeidung. Wenn du GAEB-Dateien selbst erstellst oder exportierst, hilft ein strukturierter Workflow:

Für Betriebe, die regelmäßig an öffentlichen Ausschreibungen teilnehmen, lohnt sich auch ein genauer Blick auf die Anforderungen des Auftraggebers: Welche GAEB-Phase ist gefordert, welche Version, gibt es Besonderheiten im Leistungsverzeichnis? Der Artikel Bau-Ausschreibung mit KI verstehen gibt dazu einen guten Überblick.

GAEB XML Fehler sind lösbar. Mit den richtigen Tools, einem klaren Prüfprozess und bei Bedarf KI-Unterstützung lassen sich die häufigsten Probleme schnell eingrenzen und beheben, ohne dass der Kalkulationsworkflow zum Erliegen kommt.