Die 3-Schichten-Architektur

Elmar.tax ist als drei Schichten aufgebaut, die aufeinander aufbauen. Jede Schicht ist einzeln nutzbar, aber die meisten Teams brauchen nur die oberste.

Schicht 3 — Empfohlen für die meisten Teams
Elmar REST Service

      REST-API, die die darunterliegenden Schichten kapselt. Akzeptiert JSON oder XML.
      Läuft als Docker-Container innerhalb Ihrer Infrastruktur.
      Stellt jedes Steuerformular als dedizierten Endpunkt bereit.
    
Schicht 2 — Java-Teams
elster-databinding

      Typsichere Java-Modelle, generiert aus ELSTER-XSDs.
      Einheitliches Factory-Pattern: TransferHeader → NutzdatenHeader → Nutzdatenblock → DatenTeil → ElsterForm.
      Ein Maven-Modul pro Formular/Jahr für saubere Versionsisolierung.
    
Schicht 1 — Java-Teams, fortgeschritten
eric-wrapper-sdk

      Java-Wrapper um ERiC mit Project Panama (Foreign Function & Memory API, JDK 24+).
      Kein JNI. Concurrency-sicherer Zugriff auf ERiCs Single-Threaded-Kern.
      Plattformübergreifend: Linux (x64) und macOS (universal).
    
Fundament — bereitgestellt von der Finanzverwaltung
ERiC (ELSTER Rich Client)

      Offizielle native C-Bibliothek für den sicheren Datenaustausch mit ELSTER-Servern.
      Single-Threaded. Im Elmar-Docker-Image enthalten.
    

Wie es zusammenspielt

ERiC (unten) ist die offizielle C-Bibliothek der Finanzverwaltung. Sie übernimmt Verschlüsselung, TLS und die Kommunikation mit den ELSTER-Servern. Sie ist Single-Threaded und erwartet Aufrufe von einem einzelnen Thread.
eric-wrapper-sdk kapselt ERiC mittels jextract-generierter Panama-Bindings. Es stellt EricFacade bereit — eine Java-idiomatische Schnittstelle, die parallele Zugriffe serialisiert, Zertifikate verwaltet und native Fehlercodes auf Java-Exceptions abbildet.
elster-databinding generiert JAXB-Klassen aus offiziellen ELSTER-XSDs und stellt eine Factory pro Formular/Jahr bereit. Jede Factory baut den vollständigen ELSTER-Umschlag: TransferHeader + NutzdatenHeader + Nutzdatenblock + DatenTeil = ElsterForm.
Elmar REST (oben) ist eine Spring-Boot-Kotlin-Anwendung, die alles zusammenführt. Sie nimmt TaxDeclaration-Payloads per HTTP entgegen, wandelt sie in ELSTER-Umschläge um und reicht sie über ERiC ein. Sie gibt ERiCs Antwort transparent zurück — keine zusätzliche Validierungsschicht.

Concurrency-Modell

ERiC ist Single-Threaded. Elmar handhabt dies transparent:

REST-Aufrufe werden intern serialisiert — parallele Requests warten, bis der aktuelle ERiC-Austausch abgeschlossen ist
Das ist sicher und korrekt für typische Middleware-Workloads
Für High-Concurrency-Spitzen (z.B. monatliche UStVA-Fristen) integrieren Sie Elmar hinter einer Work-Queue auf Ihrer Seite
Asynchrone Verarbeitung und eingebautes Queueing stehen auf der Roadmap

Betriebsmodell

Ein Zertifikat pro laufender Instanz — jeder Container wird mit einem einzelnen ELSTER-Zertifikat konfiguriert
Synchrone Verarbeitung — Request rein, Response raus, keine Hintergrund-Jobs
Keine eingebaute Authentifizierung — Elmar ist als interner Service konzipiert, hinter Ihrem eigenen API-Gateway oder Netzwerkbereich
Docker-first — Linux und macOS unterstützt; Windows funktioniert über Container

Compliance und Lizenzierung

Aufgrund der ERiC-Lizenzierung und regulatorischer Vorgaben ist Elmar.tax so konzipiert, dass es vollständig innerhalb der Kundeninfrastruktur läuft und nicht als SaaS- oder Portallösung betrieben werden darf.

Dies ist eine fundamentale Designentscheidung, keine Einschränkung — sie stellt sicher, dass Sie die Vorschriften der Finanzverwaltung einhalten und gleichzeitig die volle Kontrolle über Ihre Daten und Zertifikate behalten.