Lokal per Docker starten

Der schnellste Einstieg ist Elmar REST als Docker-Container.

Jede laufende Instanz unterstützt ein Zertifikat. In typischen Setups betreiben Sie eine Instanz pro Organisation oder Zertifikat.

Schnellstart

docker run --rm \
  -e ERIC_MANUFACTURER_ID=<IHRE_HERSTELLER_ID> \
  -p 8080:8080 \
  --add-host=host.docker.internal:host-gateway \
  lingomesh/elster-rest-api:2026.0.0

Öffnen Sie nach dem Start http://localhost:8080/docs/swagger-ui, um die API interaktiv über die eingebaute OpenAPI-Dokumentation zu erkunden.

Konfiguration

Elmar REST wird über Umgebungsvariablen konfiguriert, die in den Docker-Container injiziert werden:

Variable	Beschreibung
`ERIC_MANUFACTURER_ID`	Ihre ERiC-Hersteller-ID
`ERIC_CERT_PATH`	Pfad zur ELSTER-Zertifikatsdatei (.pfx) innerhalb des Containers
`ERIC_CERT_PIN`	Zertifikats-PIN
`ERIC_NATIVE_LIBS_DIR`	Pfad zu den nativen ERiC-Bibliotheken (im Docker-Image vorkonfiguriert)
`ERIC_TESTMODE`	`true` für Testübermittlungen (Standard), `false` für Produktion
`ERIC_DATEN_LIEFERANT`	Datenlieferant-Identifikationsstring
`ERIC_REGISTER_LOG_CALLBACK`	`true` um ERiC-Log-Callback zu aktivieren

Bei direkter Nutzung des Java-SDK (ohne Docker) haben Sie mehr Flexibilität — Zertifikate können über die von ERiC erwarteten Dateisystempfade geladen werden.

Funktionstest

Prüfen Sie die Service-Info-Endpunkte:

# ERiC-Version
curl http://localhost:8080/api/info/eric-version

# Zertifikatseigenschaften
curl http://localhost:8080/api/info/eric-certificate-properties

# Testmodus-Status
curl http://localhost:8080/api/info/testmode-enabled

Wie geht's weiter?

Lesen Sie den Integrationsleitfaden für Endpunkt-Details, Payload-Formate und Fehlerbehandlung
Erkunden Sie die Architektur für Concurrency- und Compliance-Details
Schauen Sie in die FAQ für häufige Fragen

Integrationsleitfaden Architektur