Zum Hauptinhalt springen
FromNine
Menü

Entwicklung

Schnitt­stellen, über die Daten fließen und die melden, wenn sie stocken.

Wir verbinden CRM, ERP, Fallsysteme und staatliche Plattformen über saubere Verträge, Ereignisse und Identitäten. So kommen Daten verlässlich an, Fehler bleiben nicht verborgen, und neue Funktionen, auch KI, lassen sich sicher andocken. Dazu gehört in Luxemburg die strukturierte E-Rechnung an öffentliche Auftraggeber.

Für Unternehmen und öffentliche Stellen in Luxemburg, die Systeme, Partner und staatliche Plattformen hier und in den Nachbarländern verbinden.

Integrationen & APIs: die BausteineVier gestaffelte Ebenen: obenauf die Abnehmer wie Portale, Apps und Agenten, darunter das API-Gateway mit der Identitätsprüfung, dann das Rückgrat für Ereignisse und zuunterst die führenden Systeme, in denen die Daten verbindlich liegen.01Portale, Apps und Agenten02API-Gateway und Identität03Ereignis-Backbone04Führende Systeme
  1. 01APIs, die vom Vertrag ausgehen, mit OpenAPI und AsyncAPI beschrieben, versioniert und dokumentiert
  2. 02Ereignisse mit gesicherter Reihenfolge, Idempotenz, Fehlerwarteschlange und Wiedereinspielung
  3. 03Datenflüsse durchgehend überwacht, jede Fehlerwarteschlange mit einem benannten Team

01 Probleme

Wofür man uns bei Integrationen ruft

  1. 01

    Direktverbindungen, an die sich niemand wagt

    CRM, ERP und Eigenentwicklungen hängen über Dutzende Einzelverbindungen aneinander. Wer ein Feld ändert, muss zehn Schnittstellen testen.

  2. 02

    Doppelte Datensätze und lautlose Ausfälle

    Ein zweiter Versuch legt einen zweiten Auftrag an, eine fehlgeschlagene Nachricht verschwindet spurlos, und der Fachbereich hört davon zuerst vom Kunden.

  3. 03

    Jeder neue Kanal bringt neue Schnittstellenarbeit

    Portal, App und nun ein KI-Assistent wollen dieselben Daten, und jeder bekommt seinen eigenen Export.

  4. 04

    Rechnungen und Behördenanbindungen werden zum Projekt

    Seit dem 18. März 2023 schicken alle Lieferanten öffentlicher Auftraggeber in Luxemburg strukturierte E-Rechnungen, und wer das von Hand über MyGuichet.lu erledigt, lädt jede Rechnung einzeln hoch. Jede neue Anbindung an eine staatliche Plattform oder ein eID-Verfahren kostet erneut Monate für Sicherheit und Zulassung.

02 Leistungsumfang

Was wir liefern

  1. 01 API-Strategie und API-Management

    Wir entwerfen APIs vom Vertrag her, mit OpenAPI und AsyncAPI, legen Regeln für Versionen fest, lassen sie von einem Gateway durchsetzen und machen über ein Entwicklerportal sichtbar, was es schon gibt, damit Teams es wiederverwenden.

    Was wir tun

    • Überblick über die API-Landschaft und ihre Verantwortlichen
    • Entwurfsrichtlinien und ein Prüfverfahren
    • Gateway-Regeln für Sicherheit, Kontingente und Versionen
    • Entwicklerportal und API-Katalog

    Was Sie erhalten

    • API-Richtlinien, die Ihre Teams tatsächlich anwenden
    • Gateway-Konfiguration als Code
    • Katalog dokumentierter APIs
  2. 02 Ereignis­gesteuerte Integration

    Broker, Change Data Capture und das Outbox-Muster, samt den Details, an denen das Ganze steht oder fällt: Reihenfolge, idempotente Verarbeitung, Fehlerwarteschlangen und das erneute Einspielen von Nachrichten.

    Was wir tun

    • Ereignismodell und Namenskonventionen
    • Outbox und CDC an den Quellsystemen
    • Idempotente Abnehmer und Zusagen zur Reihenfolge
    • Fehlerwarteschlangen mit Werkzeugen zum Wiedereinspielen

    Was Sie erhalten

    • Ereignis-Backbone im Betrieb
    • Schema-Registry mit Kompatibilitätsregeln
    • Betriebshandbuch für Wiedereinspielen und Wiederanlauf
  3. 03 Integrations­plattformen, gewählt je Datenfluss

    Ob SAP Integration Suite, MuleSoft oder die Integrationsdienste von Azure, AWS und Google Cloud: Jede Lösung passt zu bestimmten Flüssen. Wann sich eine iPaaS gegenüber eigener Entwicklung rechnet und wann nicht, sagen wir Ihnen ohne Rücksicht auf Lizenzen.

    Was wir tun

    • Bewertung der vorhandenen Middleware
    • Plattformwahl auf Basis der Gesamtkosten
    • Wiederverwendbare Mappings und Konnektoren
    • Ablösung alter Middleware

    Was Sie erhalten

    • Begründete Entscheidung für die Integrationsplattform
    • Bibliothek von Integrationsmustern
    • Migrationsplan für die bestehenden Schnittstellen
  4. 04 Identität und Vertrauen zwischen Systemen

    OAuth 2.0 und OpenID Connect, gegenseitiges TLS, Identitäten für Dienste und die Anbindung elektronischer Identitäten für Bürger und Unternehmen: LuxTrust und der luxemburgische eID-Ausweis, in den Nachbarländern itsme, BundID und FranceConnect, dazu DigiD und eHerkenning, Cl@ve, SPID und CIE.

    Was wir tun

    • Identitätsarchitektur für Personen und Dienste
    • Entwurf von Tokens, Berechtigungen und Einwilligungen
    • Unterstützung bei eID-Zulassung und Zertifizierung
    • Vorbereitung auf die EUDI-Wallets

    Was Sie erhalten

    • Identitätskonzept mit Bedrohungsmodell
    • eID-Anbindung im Produktivbetrieb
    • Dienstidentitäten und Rotation von Geheimnissen eingerichtet
  5. 05 Anbindung an staatliche Plattformen

    In Luxemburg geht es vor allem um die E-Rechnung an öffentliche Auftraggeber, die ausschließlich über Peppol oder MyGuichet.lu zugestellt werden darf. Jenseits der Grenze binden wir unter anderem den Federal Service Bus und MAGDA in Belgien, XÖV-Standards und FIT-Connect in Deutschland sowie API Entreprise in Frankreich an, außerdem Digikoppeling und Common Ground in den Niederlanden, PDND in Italien und das Once-Only Technical System der EU.

    Was wir tun

    • Aufnahme beim Betreiber der Plattform
    • Abbildung auf nationale Datenstandards und Rechnungsformate
    • Sicherheits- und Protokollvorgaben der jeweiligen Plattform
    • Entwurf für den einmaligen Austausch von Nachweisen (Once-Only)

    Was Sie erhalten

    • Zugelassene Anbindung an die Plattform
    • Dokumentation der Abbildungen
    • Betriebsabläufe, mit dem Betreiber abgestimmt
  6. 06 Transparenz im Betrieb für den Fachbereich

    Eine Überwachung der Datenflüsse, die auch der Fachbereich lesen kann, Abgleiche zwischen Systemen und Fehlerwarteschlangen, die jemandem gehören und abgearbeitet werden.

    Was wir tun

    • Überwachung der Datenflüsse in fachlichen Begriffen
    • Abgleichsberichte zwischen Systemen
    • Einordnung und Weiterleitung von Fehlern
    • Alarme an die jeweiligen Verantwortlichen

    Was Sie erhalten

    • Integrations-Dashboard je Geschäftsprozess
    • Laufende Abgleichsprüfungen
    • Zuständigkeiten für jede Fehlerwarteschlange

03 Architektur

Eine Referenz­architektur zur Veranschaulichung

Die führenden Systeme geben ihre Daten auf zwei Wegen heraus. Wer sofort eine Antwort braucht, fragt über System-APIs an; ein Gateway prüft dabei Identität, Rechte und Kontingente. Änderungen dagegen gehen als Ereignisse hinaus, über eine Outbox oder per Change Data Capture, und jeder Abnehmer verkraftet es, wenn dieselbe Nachricht zweimal kommt.

Was scheitert, landet in einer Fehlerwarteschlange, aus der es sich erneut einspielen lässt, und nicht in einer Logdatei. Ein Überwachungsband stellt jeden Datenfluss in der Sprache des Fachbereichs dar, damit die Prozessverantwortlichen sehen, wenn etwas steht.

Schichten in der Zeichnung

Führende Systeme
ERP, CRM und Fallbearbeitung bleiben maßgeblich für ihre Daten.
Synchrone APIs
System-APIs mit Versionsnummern, geschützt durch ein Gateway mit OAuth 2.0, mTLS und Kontingenten.
Ereignisse
Outbox, Broker, Fehlerwarteschlange und Mappings der Integrationsplattform.
Abnehmer
Portale, Apps, Agenten, Partner und staatliche Plattformen, mit eID überall dort, wo Bürgerinnen und Bürger beteiligt sind.
Beispiel zur Veranschaulichung
  1. Führende Systeme

    • ERP, CRM und Fallsysteme
  2. Synchrone APIs

    • System-APIs
    • API-Gateway: OAuth 2.0, mTLS, Kontingente
  3. Ereignisse

    • Outbox und CDC
    • Ereignis-Broker
    • Fehlerwarteschlange und Wiedereinspielen
    • Mappings der Integrationsplattform
  4. Abnehmer

    • Portale, Apps und Agenten
    • Partner, Peppol und staatliche Plattformen
    • Identität: OIDC, mTLS, eID
  5. Betrieb

    • Überwachung, Abgleich, Fehlerwarteschlangen mit Verantwortlichen
APIs und Ereignis-Backbone nebeneinander

Veranschaulichende Architektur, kein Kundensystem.

Diagramm als Text lesen

Anfragen von Portalen, Apps und Agenten erreichen die führenden Systeme über ein API-Gateway und versionierte System-APIs.

Daneben melden die führenden Systeme jede Änderung über Outbox und CDC an einen Broker. Dieser verteilt sie an Partner, Peppol und staatliche Plattformen sowie an die Integrationsplattform, die die Mappings übernimmt. Was nicht zugestellt werden kann, wartet in einer Fehlerwarteschlange auf das erneute Einspielen. Den Austausch mit Partnern sichern Identitätsdienste mit OAuth, mTLS und eID.

Ein Überwachungsband darunter zeigt Status der Datenflüsse, Abgleiche und Fehlerwarteschlangen mit ihren Verantwortlichen.

04 Abwägungen und Grenzen

Technische Abwägungen und Grenzen

  • Genau einmal ist eine Frage des Entwurfs, keine Einstellung

    Unser Umgang damit

    Wir rechnen damit, dass Nachrichten doppelt oder in falscher Reihenfolge eintreffen, und bauen die Abnehmer idempotent, mit Schlüsseln und Reihenfolgeregeln, die je Ereignistyp vereinbart sind.

    Grenzen und Abhängigkeiten

    Manche Altsysteme können keine Idempotenzschlüssel annehmen und nicht melden, was sie verarbeitet haben. Dort ergänzen wir Abgleiche, statt etwas vorzutäuschen.

  • Eine iPaaS ist nicht immer die Antwort

    Unser Umgang damit

    Für viele Standardkonnektoren und Mappings ist eine Plattform die bessere Wahl. Bei komplexer Logik, großen Mengen oder strengen Antwortzeiten gewinnt eigener Code. Die Wahl halten wir je Schnittstelle fest.

    Grenzen und Abhängigkeiten

    Hersteller ändern ihre Lizenzbedingungen. Was heute wenig kostet, kann in drei Jahren den größten Anteil am Integrationsbudget ausmachen. Wir kalkulieren deshalb über mehrere Jahre.

  • Staatliche Plattformen bestimmen ihr eigenes Tempo

    Unser Umgang damit

    Antragsunterlagen, Sicherheitsbelege und Testpläne liegen bei uns früh bereit, und der Kontakt zum Betreiber steht ab Projektbeginn.

    Grenzen und Abhängigkeiten

    Wie lange Zulassung und Aufnahme dauern, bestimmt der Betreiber. Wir berücksichtigen das im Plan und machen deutlich, wann diese Schritte den Zeitplan bestimmen.

  • KI als Abnehmer braucht schmale APIs

    Unser Umgang damit

    Agenten und Assistenten erhalten eigene, eng gefasste APIs mit Grenzen und Prüfprotokoll, nicht denselben breiten Zugang wie interne Dienste.

    Grenzen und Abhängigkeiten

    Jede API, die ein Agent nutzen darf, erhöht das Risiko. Wir prüfen sie einzeln mit Ihrer Informationssicherheit, bevor sie live geht.

05 Arbeitsweise

Wie wir arbeiten

Erst entwirren, dann bauen, und am Ende hat jeder Datenfluss einen Verantwortlichen.

  1. 01

    Datenflüsse erfassen

    Jede Schnittstelle mit ihrem Volumen, ihren bisherigen Ausfällen und ihrem fachlichen Verantwortlichen.

    ErgebnisIntegrationslandkarte mit Risikoreihenfolge

  2. 02

    Regeln festlegen

    API-Richtlinien, Konventionen für Ereignisse, Identitätsmodell und die Wahl der Plattform.

    ErgebnisIntegrationsrichtlinien und Entscheidungsprotokolle

  3. 03

    Fluss für Fluss umziehen

    Wir beginnen mit den riskantesten Flüssen und vergleichen die neue mit der alten Schnittstelle, bis die Zahlen deckungsgleich sind.

    ErgebnisUmgezogene Flüsse mit Abgleichsnachweis

  4. 04

    Sichtbar betreiben

    Dashboards je Geschäftsprozess und Fehlerwarteschlangen mit benannten Verantwortlichen.

    ErgebnisZuständigkeitskarte der Flüsse und Dashboards

06 Menschliche Kontrolle

Wo Menschen die Kontrolle behalten

Integration läuft ohne Aufsicht. Die Verantwortung für Fehler nicht.

  • Jede Fehlerwarteschlange hat einen Verantwortlichen

    Gescheiterte Nachrichten gehen an ein zuständiges Team, mit Kontext und der Möglichkeit, sie erneut einzuspielen, nicht in ein gemeinsames Log.

  • Vertragsänderungen werden geprüft

    Inkompatible Änderungen an APIs oder Ereignissen werden mit den Abnehmern durchgesprochen, bevor sie veröffentlicht werden.

  • Wiedereinspielen ist eine bewusste Handlung

    Nachrichten erneut in ein führendes System einzuspielen, ist eine berechtigte Aktion und wird mit Person und Grund protokolliert.

07 Technologien

Technologien, mit denen wir arbeiten

Integrations­plattformen
  • SAP Integration Suite
  • MuleSoft
  • Azure Integration Services
  • Integrationsdienste von AWS und Google Cloud
Ereignisse und Streaming
  • Apache Kafka
  • RabbitMQ
  • Ereignis-Broker der Cloud-Anbieter
  • Debezium für Change Data Capture
APIs
  • OpenAPI und AsyncAPI
  • API-Gateways und Entwicklerportale
  • GraphQL, wo es passt
  • Vertragstests
Identität
  • OAuth 2.0 und OpenID Connect
  • Gegenseitiges TLS
  • Keycloak und Identitätsdienste der Cloud
  • Nationale eID-Verfahren

Eine hier genannte Technologie beschreibt unsere Erfahrung in der Entwicklung. Sie bedeutet weder eine Partnerschaft mit dem Hersteller noch dessen Empfehlung.

08 Beispiel

Ein veranschaulichendes Beispiel

Beispiel zur Veranschaulichung

E-Rechnungen aus dem ERP an öffentliche Auftraggeber in Luxemburg und Deutschland

01Ausgangslage
Ein Handwerksbetrieb für Gebäudetechnik arbeitet für Gemeinden in Luxemburg und für öffentliche Kunden in Deutschland. Die Buchhaltung erfasst jede Rechnung einzeln von Hand im Formular auf MyGuichet.lu; Rückfragen zu abgelehnten Rechnungen kommen Wochen später.
02Was wir bauen würden
Das ERP erzeugt strukturierte Rechnungen im Format Peppol BIS Billing 3.0 oder als XRechnung und versendet sie über den Peppol-Zugangspunkt eines Dienstleisters. Statusmeldungen und Ablehnungen fließen als Ereignisse zurück ins ERP.
03Wo Menschen entscheiden
Rechnungen über einem festgelegten Betrag gibt die Buchhaltung vor dem Versand frei; abgelehnte Rechnungen landen bei einer benannten Person mit dem Grund der Ablehnung.
04Was wir messen würden
Anteil der Rechnungen, die ohne manuelle Erfassung ankommen, Zeit vom Rechnungsdatum bis zur Empfangsbestätigung und Zahl der Ablehnungen pro Monat.

09 Branchen

In Ihrer Branche

  • Daten, die der Staat schon hat, nur einmal anfragen, Anmeldung mit LuxTrust oder dem eID-Ausweis und die Protokollierung, die staatliche Plattformen verlangen. Mehr zu unserer Arbeit für Staat & Gemeinden.

  • ERP, MES und Lieferantenportale über Ereignisse verbunden, damit Planung, Fertigung und Service dasselbe Bild haben, auch wenn Werke und Kunden auf beiden Seiten der Mosel liegen.

  • Kernsysteme, CRM und Partner-APIs von Banken, Fondsverwaltern und Versicherern, verbunden mit starker Identität, Prüfprotokoll und Abgleichen, denen die Finanzabteilung vertraut.

Luxemburg

Interoperabilität über die Grenzen der Großregion

Wer an öffentliche Auftraggeber in Luxemburg liefert, schickt seine Rechnungen seit dem 18. März 2023 strukturiert, unabhängig vom Betrag, und zwar nur über Peppol oder MyGuichet.lu, nicht per E-Mail. Akzeptiert werden unter anderem Peppol BIS Billing 3.0 und XRechnung in UBL oder CII. Ein Lieferant aus Deutschland, Belgien oder den Niederlanden kann also über Peppol nach Luxemburg fakturieren, auch im Format XRechnung.

Grenzüberschreitende Dienste treffen in jedem Land auf eine andere Austauschplattform, ein anderes eID-Verfahren und andere Datenstandards. Die Verordnung für ein interoperables Europa verlangt von öffentlichen Stellen, die grenzüberschreitende Interoperabilität zu bewerten, und mit eIDAS 2 muss jeder Mitgliedstaat eine EUDI-Wallet anbieten. Wir bauen Integrationsschichten, in denen nationale Plattformen und Identitätsverfahren Adapter hinter stabilen internen Verträgen sind. Ein weiteres Land bedeutet dann einen neuen Adapter und dessen Zulassung, nicht den Umbau der Systeme dahinter.

Fragen zu Integrationen und APIs

Integrationsplattform oder eigene Schnittstellen?

Meist beides. Für Standardanbindungen, Mappings und neue Partner ist eine Plattform effizienter; wo es um hohe Volumen, kurze Antwortzeiten oder komplexe Regeln geht, ist ein eigener Dienst oft die bessere Lösung. Die Entscheidung fällt je Fluss und wird begründet dokumentiert.

Binden Sie Salesforce, SAP und Odoo an?

Ja, regelmäßig, untereinander und mit Eigenentwicklungen oder staatlichen Systemen, etwa für die E-Rechnung an Luxemburger Auftraggeber über Peppol. FromNine ist Partner aller drei Hersteller (Salesforce Summit Partner, SAP Gold Partner, Odoo Gold Partner), unsere Integrationsteams arbeiten also mit den Plattformspezialisten zusammen. Mehr zu unseren SAP-Integrationen.

Brauchen wir ereignisgesteuerte Integration?

Ereignisse lohnen sich, sobald mehrere Systeme auf dieselbe Änderung reagieren oder Teams unabhängig voneinander ausliefern sollen. Fragt nur ein System ein anderes etwas ab, genügt häufig eine API. Die meisten Landschaften kombinieren beides.

Können Sie nationale eID-Verfahren anbinden?

Ja. MyGuichet.lu zeigt, was in Luxemburg üblich ist: Es akzeptiert LuxTrust-Produkte, den luxemburgischen eID-Ausweis und notifizierte eIDAS-Mittel aus anderen EU- und EWR-Staaten, die allerdings nicht für jedes Verfahren eine Unterschrift erlauben. Wir binden solche Verfahren an und planen für die EUDI-Wallets, die die Mitgliedstaaten nach eIDAS 2 bis zum 24. Dezember 2026 bereitstellen sollen. Die Zulassungsvorgaben unterscheiden sich je Verfahren; wir berücksichtigen sie früh.

Wir haben alte Middleware. Müssen wir sie ersetzen?

Nein, zumindest nicht auf einmal. Wir inventarisieren, was darüber läuft, ziehen die riskantesten oder kostspieligsten Flüsse zuerst um und gleichen die Ergebnisse so lange ab, bis jeder neue Fluss seine Zuverlässigkeit bewiesen hat.

Bringen Sie die Schnittstelle mit, die am häufigsten ausfällt

Wir zeigen, wie wir sie beobachtbar, idempotent und eindeutig zuständig machen würden, und was dasselbe für den Rest bedeuten würde.