Anbindung an behördliche Meldeschnittstellen: Mapping, Signatur, Quittungen und Nachmeldung
KURZ GESAGT: Schwierig an Behördenmeldungen ist nicht das Senden einer Anfrage, sondern dreierlei: Jede Behörde hat ihr eigenes, sich änderndes Nachrichtenformat, Quittungen kommen oft asynchron, und sowohl fehlende als auch falsche Meldungen haben Folgen. Wir teilen die Arbeit in drei Schichten. Quelldaten werden zuerst in interne Standardobjekte überführt und dann in die Nachricht der jeweiligen Behörde für eine bestimmte Spezifikationsversion umgesetzt. Eine gemeinsame Sendeschicht übernimmt Signatur, Verschlüsselung, Wiederholungen und Quittungen. Jede Meldung und jede Quittung wird prüffähig protokolliert, mit festgelegten Abläufen für Nachmeldung und Abgleich.
1.0 Format und Versand trennen
Das übliche Altmuster ist ein Dienst pro Region, in dem Feldzuordnung, Signatur und Versand fest einprogrammiert sind. Jede Spezifikationsänderung erfordert ein Release, die regionalen Dienste driften auseinander, und derselbe Signaturfehler muss mehrfach behoben werden.
Stabiler ist eine Schichtung nach Änderungshäufigkeit:
| Schicht | Aufgabe | Ändert sich mit |
|---|---|---|
| Erfassen | Daten aus Unternehmenssystemen holen und in interne Standardobjekte überführen | Unternehmenssystemen |
| Abbilden | Standardobjekte in die Nachricht einer Behörde und einer Spezifikationsversion | Spezifikationsversionen |
| Senden | Authentifizierung, Signatur, Verschlüsselung, Transport, Quittungen, Wiederholungen | selten |
Mappings werden je Behörde und Spezifikationsversion verwaltet. Geht eine neue Version live, bleibt die alte bestehen; umgeschaltet wird zum Stichtag, und zurückrollen heißt, das Datum zu ändern.
2.0 Mapping als Konfiguration, mit Tests
Mapping-Regeln sind Konfiguration: Feldzuordnung, Codetabellen-Umsetzung, Einheitenumrechnung und Pflichtfeldprüfungen. Einführungsberater pflegen sie über eine Oberfläche statt im Code. Auch Konfiguration kann falsch sein, daher:
- Zu jedem Mapping gehören Beispieldaten und erwartete Nachrichten, die nach jeder Änderung automatisch verglichen werden.
- Codetabellen wie Branchenschlüssel oder Gebietskennungen werden separat versioniert und mit Version referenziert.
- Konfigurationsänderungen durchlaufen eine Freigabe und werden protokolliert, sodass nachvollziehbar ist, wer wann was geändert hat.
Manche Fälle passen nie in Konfiguration. Geben Sie diesen Ausnahmen eine stabile Plugin-Schnittstelle, statt die Konfigurationssprache zu einer Programmiersprache auswachsen zu lassen, die Einführungsberater nicht pflegen können und Entwickler lieber nicht anfassen.
3.0 Die Sendeschicht
- Zertifikate und Schlüssel werden schreibgeschützt eingehängt, nie in der Datenbank gespeichert oder in der Konfigurationsoberfläche angezeigt; der Schlüsselwechsel folgt einem schriftlichen Ablauf.
- Eine Laufzeit unterstützt die von Behörden geforderten Transportwege, ob HTTP, langlebige TCP-Verbindungen oder eine Message Queue, statt für jeden Weg eigene Wiederholungs- und Log-Logik.
- Jede Meldung trägt eine eindeutige Vorgangsnummer, und ein erneuter Versand verwendet dieselbe, damit die Behörde deduplizieren kann. Dedupliziert die Behörde nicht, wird vor jedem erneuten Versand ein lokaler Status „bestätigt“ geprüft.
- Eine synchrone Quittung bedeutet meist nur „empfangen“. Das Verarbeitungsergebnis kommt als asynchrone Quittung oder muss abgefragt werden, und beide Wege werden gebraucht.
4.0 Wiederholung, Nachmeldung und Abgleich
| Situation | Vorgehen |
|---|---|
| Netzfehler oder Timeout | Exponentielles Backoff mit Obergrenze; darüber hinaus manuelle Warteschlange |
| Abgelehnt durch die Prüfung der Behörde | Keine automatische Wiederholung; der Grund geht an den Datenverantwortlichen, die korrigierte Meldung wird nachgereicht |
| Während eines Ausfalls versäumte Meldungen | Nachmeldung nach Zeitfenster, mit dokumentiertem Grund |
| Regelmäßig | Abgleich mit den Bestätigungen der Behörde; unbestätigte oder abweichende Einträge auflisten |
Einen Prüffehler zu wiederholen bringt nichts außer einer Reihe identischer Fehler und womöglich ausgelöster Rate-Limits auf Behördenseite.
5.0 Prüfprotokoll
Zu jeder Meldung werden Quelldatenstand, erzeugte Nachricht, Signatur-Digest, Sendezeit und Quittung aufbewahrt. Im Streitfall muss nachweisbar sein, was zu einem bestimmten Zeitpunkt gemeldet wurde und was zurückkam. Die Aufbewahrungsdauer richtet sich nach den Vorgaben der Behörde und den eigenen Compliance-Regeln des Unternehmens.
Wenn Sie einen fest verdrahteten Altdienst für Meldungen ersetzen oder eine neue Behörde anbinden, siehe Web, Cloud und Geräteverwaltung, oder Projekt besprechen.
Quellen
- Enterprise Integration Patterns, Guaranteed Delivery: https://www.enterpriseintegrationpatterns.com/patterns/messaging/GuaranteedMessaging.html
Häufige Fragen
Regionale Spezifikationen ändern sich oft. Kommt Konfiguration da wirklich mit?
Die meisten Änderungen fügen Felder hinzu, aktualisieren Codetabellen oder passen Prüfungen an, und das deckt Konfiguration ab. Ändern sich auch Nachrichtenstruktur oder Transport, müssen die Mapping-Vorlage oder sogar die Sendeschicht angepasst werden. Deshalb werden Mappings je Spezifikationsversion verwaltet; alte und neue Version laufen parallel und werden zum Stichtag umgeschaltet.
Die Testumgebung der Behörde verhält sich anders als die Produktion. Was dann?
Das ist häufig. Wir speichern jede echte Quittung aus den Integrationstests geschwärzt als Beispiel für Erfolg, Prüffehler und jeden Fehlercode, und wir gleichen nach dem Go-live häufiger ab, um zu finden, was die Testumgebung nie gezeigt hat.
Können wir mit einer einzigen Region anfangen?
Mit einer Region zu beginnen ist vernünftig, solange die Struktur für mehrere Behörden ausgelegt ist: Standardobjekte, Mapping-Schicht und Sendeschicht getrennt. Die zweite Region bringt dann nur ein neues Mapping statt eines kopierten Dienstes.
Unsere Einführungsberater programmieren nicht. Können sie die Mappings pflegen?
Feldzuordnungen und Codetabellen lassen sich im Alltag über die Oberfläche pflegen, und jede Änderung wird automatisch mit Beispieldaten verglichen, sodass ein Fehler sofort als Abweichung sichtbar wird. Ausnahmen, die Konfiguration nicht ausdrücken kann, setzen Entwickler über eine Plugin-Schnittstelle um.