Integrationsschicht zwischen den internen Systemen eines Herstellers und der KBA-SOAP-Schnittstelle, die Schnittstellenänderungen auffängt

BLOG

KBA-Schnittstellenintegration für Automobilhersteller: So bleibt eine Legacy-SOAP-Verbindung stabil

Oktober 28 | Lukas Peter

Das Kraftfahrt-Bundesamt (KBA) tauscht Fahrzeug- und Typgenehmigungsdaten mit Herstellern über eine SOAP-Schnittstelle aus, deren Schema allein die Behörde festlegt. Bei einem Automobilhersteller hielt eine zentrale Integrationsschicht in Scheer PAS die internen Systeme stabil. Und das, obwohl die Spezifikation Lücken hatte, das KBA nur eingeschränkt Support bot, Passwörter regelmäßig erneuert werden mussten und sich die Schnittstelle kurzfristig änderte.

TL;DR

Das KBA bestimmt Schema, Dokumentation, Zugangsdaten und Fristen. Weil all das in einer Integrationsschicht lag, musste eine Überarbeitung der KBA-Schnittstelle mit zwei Monaten Frist nur dort umgesetzt werden, nicht in den eigenen Systemen des Herstellers.

Behördenschnittstellen bekommen in Integrationsprojekten selten viel Aufmerksamkeit. Sie sind eine Verbindung unter vielen, bis sie nicht mehr funktionieren. Dann steht die Fahrzeugzulassung still, und eine behördliche Frist richtet sich nach keinem Release-Plan. An ihnen zeigt sich, wie gut eine Integrationsschicht gebaut ist und was ein KI-Agent später von ihr bräuchte.

Das KBA bestimmt Schema, Dokumentation, Zugangsdaten und Fristen, und jeder dieser Faktoren kann Produktion, Zulassung und Berichterstattung stoppen

Warum ist die KBA-Schnittstelle schwer zu integrieren?

Die KBA-Schnittstelle ist schwer zu integrieren, weil der Hersteller keinen ihrer Parameter beeinflussen kann. Das KBA legt das Schema fest, schreibt die Dokumentation, bestimmt, wann Zugangsdaten erneuert werden müssen, und entscheidet, wann sich die Schnittstelle ändert. Jeder dieser Punkte kann den Prozess stoppen, wenn die Integration ihn nicht auffängt.

 

Das Schema ist fest. Es hat keine Erweiterungspunkte und keinen Platz für ein Feld, das dem Hersteller nützen würde. Die internen Daten müssen sich der Struktur der Behörde anpassen, nie umgekehrt.

 

Die offizielle Spezifikation war unvollständig, und der technische Support des KBA war begrenzt. Wie sich der Endpunkt in manchen Fällen verhält, zeigte sich erst im Test mit echten Nachrichten.

 

Der Zugang hängt an Passwörtern, die regelmäßig erneuert werden müssen. Wird eine Erneuerung verpasst, ist der Benutzer gesperrt und die Kommunikation mit dem KBA bricht ab.

 

Und wenn das KBA die Schnittstelle überarbeitet, bestimmt die Behörde die Frist, nicht der Release-Kalender des Herstellers. In diesem Projekt kündigte das KBA umfangreiche Änderungen an und ließ zwei Monate für die Umsetzung.

 

Fällt die Verbindung aus, stehen Produktion, Fahrzeugzulassung und Compliance-Reporting still.

Wie schützt eine Integrationsschicht interne Systeme vor Änderungen an der KBA-Schnittstelle?

Eine Integrationsschicht schützt interne Systeme, indem sie alles übernimmt, was KBA-spezifisch ist. Der Hersteller liefert seine Daten weiter im eigenen Format. Konfigurierbare Mappings und Regelwerke in Scheer PAS wandeln sie in die Struktur um, die das KBA verlangt, und auch die Verbindung selbst liegt dort. Ändert das KBA seine Schnittstelle, wird die Änderung dort umgesetzt, und ERP- sowie interne Stammdatensysteme bleiben, wie sie sind.

Genau diese Bündelung machte die kurze Umsetzungsfrist beherrschbar. Statt Änderungen über mehrere Backend-Systeme und deren Release-Zyklen abzustimmen, passte das Team Mappings und Servicemodelle in Scheer PAS an. Alle Änderungen wurden fristgerecht umgesetzt, und der Hersteller musste keines seiner eigenen Systeme anpassen.

 

Auch komplexe Antwortnachrichten des KBA werden zurückübersetzt, in ein Format, das die Prozesse des Herstellers verstehen. Interne Systeme verarbeiten das XML der Behörde nie direkt.

 

Der Nachteil ist, dass die Integrationsschicht zu eigener Software wird, die betreut, versioniert und getestet werden muss. Für eine Schnittstelle, die sich nach fremdem Zeitplan ändert, ist das trotzdem die günstigere Lösung.

Wie verhindert man, dass ablaufende Zugangsdaten die Fahrzeugzulassung blockieren?

Ablaufende KBA-Passwörter sind kein Risiko mehr, sobald die Integrationsschicht sie überwacht und rechtzeitig erneuert. Ein Kalendereintrag reicht dafür nicht. In diesem Projekt prüft ein automatisierter Prozess in Scheer PAS laufend, ob die Zugangsdaten noch gültig sind, und erneuert Passwörter, bevor sie ablaufen. Benutzerkonten werden nicht gesperrt, und Geschäftsprozesse laufen weiter.

 

Das klingt nach einem Detail. In der Praxis sind abgelaufene Zugangsdaten aber einer der wenigen Fehler, die eine korrekt gemappte, vollständig getestete Schnittstelle über Nacht stoppen können.

Iterative Tests am echten KBA-Endpunkt schließen Lücken in der Dokumentation, bis das Mapping akzeptiert wird

Wie integriert man eine Schnittstelle mit unvollständiger Dokumentation?

Eine Schnittstelle mit unvollständiger Dokumentation muss anhand ihres tatsächlichen Verhaltens integriert werden, nicht nur anhand der Spezifikation. Weil wichtige Informationen fehlten, analysierte das Projektteam, wie sich der KBA-Endpunkt tatsächlich verhielt, richtete die Mappings danach aus, was er tatsächlich annahm und zurückgab, und entwickelte die Integration iterativ mit Tests und Validierungen, bis sie im Produktivbetrieb zuverlässig lief.

 

Dieser Weg ist am Anfang langsamer aber insgesamt schneller. Was dabei auffällt, landet im Mapping. Daran lässt sich die nächste Schnittstellenänderung prüfen.

 

KBA-Einschränkungen auf einen Blick 

Einschränkung beim KBA

Risiko ohne Integrationsschicht

Wie die Integrationsschicht damit umgeht

Festes SOAP-Schema

Interne Daten passen nicht

Mapping auf das KBA-XML-Schema

Unvollständige Spezifikation, begrenzter Support

Nachrichten werden im Produktivbetrieb abgelehnt oder falsch verarbeitet

Iterative Tests gegen den echten Endpunkt; alles, was dabei auffiel, floss ins Mapping

Passwörter, die regelmäßig erneuert werden müssen

Gesperrter Benutzer, Kommunikation mit dem KBA bricht ab

Automatische Überwachung und Erneuerung

Schnittstellenänderungen mit behördlicher Frist

Änderungen verteilen sich auf mehrere Backend-Systeme und deren Release-Zyklen

Nur Mappings und Servicemodelle, ERP bleibt unberührt

Warum sollte ein KI-Agent nicht direkt an das KBA melden?

Ein KI-Agent sollte nicht direkt an das KBA melden, weil das KBA jede Meldung erfasst und sich eine falsche nur über einen Verwaltungsvorgang korrigieren lässt, nicht per Rollback. Ein Sprachmodell kann XML erzeugen, das gültig aussieht und trotzdem einen Code verwendet, den die Behörde nicht akzeptiert, oder ein Feld weglässt, das der Endpunkt erwartet.

 

Die Schicht, die diese Anbindung zuverlässig gemacht hat, ist dieselbe, die ein Agent bräuchte. Der Agent kann entscheiden, dass ein Datensatz gemeldet werden muss, die Daten zusammentragen und die Anfrage vorbereiten. Scheer PAS mappt sie dann, prüft sie gegen das Schema, nutzt Zugangsdaten, die der Agent nie sieht, und sendet sie.

 

Der Agent berührt weder den SOAP-Envelope noch die Endpunktadresse noch die Zugangsdaten. Er ruft eine Operation mit definierter Ein- und Ausgabe auf.

 

In diesem Projekt wurden keine KI-Agenten eingesetzt. Die hier beschriebene Integrationsschicht ist die Voraussetzung für ihren späteren Einsatz.

Schemaprüfung, isolierte Zugangsdaten und menschliche Freigabe, bevor eine vom Agenten vorbereitete Meldung das KBA erreicht

Welche Guardrails brauchen KBA-Meldungen, die ein Agent vorbereitet?

Meldungen, die ein Agent vorbereitet, müssen geprüft werden, bevor sie das Unternehmen verlassen. Sobald eine Meldung beim KBA ankommt, ist sie erfasst. Drei Prüfungen sind spezifisch für diese Schnittstelle. 

 

Schema-Prüfung gegen die aktuelle KBA-Schemaversion, dazu Plausibilitätsprüfungen gegen interne Stammdaten. Eine Meldung, die hier durchfällt, erreicht die Behörde nie. 

 

Getrennte Zugangsdaten. Der Agent fordert eine Operation an, die Integrationsschicht hält und erneuert die Zugangsdaten. Der Agent sieht oder speichert sie nie. 

 

Freigabe vor dem Senden für alles, was einen behördlichen Datensatz verändert. Abfragen können automatisch laufen. Meldungen warten auf eine Person.

 

Die allgemeinen Anforderungen an die Governance von KI-Agenten, von Validierung und Berechtigungen bis hin zu Protokollierung und menschlicher Freigabe, werden in diesem Artikel.

Was wir gelernt haben

Behandeln Sie die KBA-Schnittstelle als etwas, das sich ändert, ohne Sie zu fragen. Alles, was KBA-spezifisch ist, gehört an einen Ort, und dieser Ort ist nicht das ERP-System. 

 

Automatisieren Sie die Erneuerung der Zugangsdaten, bevor Sie sie brauchen. Das ist die günstigste Maßnahme im ganzen Projekt und die, die am ehesten vergessen wird. 

 

Rechnen Sie mit Lücken in der Dokumentation, verlassen Sie sich nicht auf den Support der Behörde und planen Sie Zeit für Tests gegen den echten Endpunkt ein. 

 

Und wenn KI-Agenten auf der Roadmap stehen, brauchen sie genau diese Schicht darunter. Bauen Sie sie zuerst für die Schnittstelle auf. 

 

Behördenschnittstellen gelten meist als Pflichtübung. Projekte wie dieses zeigen, dass sich eine Integrationsschicht gerade hier bezahlt macht und dass ein KI-Agent ohne diese Schicht genau hier zuerst scheitern würde.

Häufige Fragen

Wofür nutzen Hersteller die KBA-Schnittstelle?

 

Um Fahrzeug- und Typgenehmigungsdaten mit dem Kraftfahrt-Bundesamt auszutauschen, das das Zentrale Fahrzeugregister führt und als nationale Typgenehmigungsbehörde zuständig ist. Fällt die Verbindung aus, stehen zulassungsbezogene Prozesse und das Compliance-Reporting still. 

 

Müssen bei Änderungen an der KBA-Schnittstelle ERP-Systeme angepasst werden?

 

Nicht, wenn das Mapping zwischen internen Daten und dem KBA-Schema in einer Integrationsschicht liegt. Schnittstellenänderungen werden dann dort umgesetzt, und ERP- sowie interne Stammdatensysteme bleiben unverändert. 

 

Wer sollte für die Erneuerung der KBA-Zugangsdaten zuständig sein?

 

Die Integrationsplattform, die sie nutzt. Sie kann die Gültigkeit überwachen, rechtzeitig erneuern und eine Warnung auslösen, wenn eine Erneuerung fehlschlägt. Eine Kalendererinnerung schafft das nicht zuverlässig. 

 

Über den Autor

 

Lukas Peter ist Entwickler und technischer Berater bei Scheer PAS. Er baut Integrations-Services in Scheer PAS Designer und PAS Code, darunter xUML- und BPMN-Servicemodelle, REST- und dateibasierte Adapter sowie Anbindungen an SAP-Datenquellen. Link zum LinkedIn-Profil des Autors – https://www.linkedin.com/in/lukas-peter-9998b1250/