Häufige Fragen (FAQ)

Ist das eine SaaS- oder Portallösung?

Nein. Aufgrund der ERiC-Lizenzierung und regulatorischer Vorgaben ist Elmar.tax so konzipiert, dass es vollständig innerhalb Ihrer eigenen Infrastruktur läuft und nicht als SaaS- oder Portallösung betrieben werden darf. Dies ist beabsichtigt — Sie deployen es als internen Service und behalten die volle Kontrolle über Daten und Zertifikate.

Warum ein separater REST-Service statt ERiC direkt einzubetten?

Die meisten Software-Stacks profitieren von einer sauberen Service-Grenze:

• Isoliert nativen Code — ERiC ist eine C-Bibliothek mit plattformspezifischen Binaries. Im Container bedeutet das: Ihre Hauptanwendung muss sich nicht mit nativen Bibliotheken, JNI oder Speicherverwaltung befassen.
• Vereinfacht den Betrieb — ELSTER unabhängig von Ihrer Hauptanwendung deployen, skalieren und überwachen.
• Sprachunabhängig — jeder Stack, der HTTP spricht, kann integrieren, nicht nur Java.
• Reduziert Risiko — ERiC-Threading, Zertifikatsverwaltung und Fehler-Mapping sind jemand anderes Problem.

Kann ich nur das Java-SDK ohne die REST-Schicht nutzen?

Ja. Wenn Sie auf Java sind und eine direkte Integration wollen, können Sie eric-wrapper-sdk und elster-databinding als Maven-Dependencies nutzen. Die REST-Schicht wird für die meisten Teams empfohlen, aber die unteren Schichten sind vollständig eigenständig nutzbar.

Unterstützt Elmar JSON?

Ja. Elmar REST akzeptiert sowohl JSON- als auch XML-Payloads. Intern werden beide gleich behandelt und als XML an ELSTER gesendet. Die JSON-Feldnamen entsprechen 1:1 dem JAXB-Modell (das die ELSTER-XSD-Struktur widerspiegelt).

Wie funktioniert Concurrency?

ERiC ist Single-Threaded by Design. Elmar handhabt das sicher durch interne Serialisierung — parallele REST-Aufrufe warten, bis der aktuelle ERiC-Austausch abgeschlossen ist. Das ist korrekt und vorhersagbar.

Für High-Concurrency-Spitzen (z.B. monatliche UStVA-Fristen) integrieren Sie Elmar hinter einer Work-Queue auf Ihrer Seite. Eingebaute asynchrone Verarbeitung und Queueing stehen auf der Roadmap.

Validiert Elmar meine Payloads?

Elmar fügt keine eigene Validierungsschicht hinzu. Es leitet Ihren Payload durch ERiC und gibt ERiCs Antwort — einschließlich etwaiger Validierungsfehler — transparent zurück. Das bedeutet, Sie erhalten immer dasselbe Ergebnis wie bei einer direkten ERiC-Integration.

Welche Steuerformulare werden unterstützt?

Aktuell: UStVA (2025, 2026), USt (2025), GewSt (2024), KSt (2024), FSE KapG (2023). Neue Formulare und Jahre werden als modulare Erweiterungen hinzugefügt. ESt und Bilanzformulare stehen auf der Roadmap.

Welche Plattformen werden unterstützt?

Das Docker-Image unterstützt Linux und macOS. Windows funktioniert über Container (Docker Desktop oder WSL2). Die zugrundeliegende ERiC-Bibliothek unterstützt Linux (x64) und macOS (universal/Intel).

Welche Java-Version wird benötigt?

Der REST-Service läuft auf JDK 21+ im Docker-Image. Bei direkter Nutzung der unteren Java-Schichten benötigt das eric-wrapper-sdk JDK 24+ mit aktivierten Preview-Features (Project Panama / Foreign Function & Memory API).

Gibt es Authentifizierung?

Aktuell nicht. Elmar REST ist als interner Service konzipiert — Sie deployen es hinter Ihrer eigenen Netzwerkgrenze oder Ihrem API-Gateway. Eingebaute Auth steht mit wachsender Nutzung auf der Roadmap.

Kann ich mehrere Zertifikate betreiben?

Jeder laufende Container unterstützt ein Zertifikat. Um mehrere Organisationen zu bedienen, betreiben Sie eine Elmar-Instanz pro Zertifikat. Dieses Modell ist einfach, sicher und passt natürlich zur Container-Orchestrierung.

Gibt es eine OpenAPI-Spezifikation?

Ja. Wenn Elmar REST läuft, besuchen Sie /docs/swagger-ui für die interaktive Swagger-UI oder /docs/api für die rohe OpenAPI-3.1-JSON-Spezifikation.