Changelog

2.26.1 (2026-01-06)

Manifest digest:

sha256:468d8d84f8c1fbf45454eb309752f46f45f9c01f82b386e92961e5c1c1c10293

Technisch

• Fix: Fehlender Pfad api/storage/framework/cache/data/ führte zum Fehler bei php artisan cache:clear und verhinderte den Start des Containers.

2.26.0 (2026-01-06)

Manifest digest:

sha256:2353d3d8b7269401f5a1a421dba1151c3627c3ea7e9882c50061875755b757bf

Fachlich

• LStA 2026

  • Kennzahlen 41 und 44 erlauben keine negativen Beträge mehr (s. ELSTER-Forum)

  • Neue Kennzahl 92 (Beschreibung: "Negativer Gesamtbetrag aufgrund Lohnsteuerjahresausgleich", Ja-Feld)

• LSTMitteilung v2 (ab VZ 2026)

Derzeit sind in v2 KMV-serverseitig mehrere Probleme bekannt.

• Mehrere Änderungen bei den Finanzämtern in HH, HE, NI, NW, SH

Technisch

• ERiC 43.3

  • eSigner 63.0.1

• PHP 8.4.16 (Debian 13.2 mit Kernel 6.12.54)

• UI dependencies aktualisiert:

  • Vue 3.5

  • TailwindCSS 4

  • Vite 7

2.25.3 (2025-07-18)

Manifest digest: sha256:cf93c233beebbd390e629425dc5a02c597635e36213bc193f1f1c2651658d87d

Fachlich

• LSTMitteilung v1 (ausschließlich im Testbetrieb und nur für VZ 2025)

LSTMitteilung soll ab VZ 2026 die derzeitige LStB ersetzen (produktiv voraussichtlich Dezember 2025). VZ vor 2026 werden weiterhin mit LStB übermittelt.

Weitere Informationen s. Migration von LStB zu LSTMitteilung

2.25.2 (2025-07)

Manifest digest: sha256:fa2d4a84bfd6316750dcfa7a6c0ee7a8c757e4ef9baab6254cd2bfb49669a456

Fachlich

• ELO2 (Lavendel) neue Schnittstellenversion v3 (die v2 wird weiterhin unterstützt)

Die produktive Umstellung soll am 11.11.2025 18:00 Uhr MEZ erfolgen. Ab dem Stichzeitpunkt wird nur v3 produktiv unterstützt. Vor dem Stichzeitpunkt wird auschließlich v2 produktiv unterstützt (s. ELSTER-Newsletter vom 12.06.2025, ELSTER-Newsletter vom 10.07.2025 und ELSTER-Forum).

Der Stichzeitpunkt ist in deric hinterlegt und kann mit der Umgebungsvariablen ELO2_VERSION_CHANGE_DATETIME_UTC geändert werden.

Weitere Informationen s. Upgrade ELO2 v3

• Preview für LSTMitteilung (ersetzt LStB ab VZ 2026)

Technisch

• ERiC 42.2

• Neue Umgebungsvariable ELO2_VERSION_CHANGE_DATETIME_UTC für den Zeitpunkt, ab dem ELO2 v3 produktiv von deric verwendet werden soll (vor dem Zeitpunkt wird v2 verwendet)

• Neue Umgebungsvariablen POTTO_TIMEOUT_CONNECT (Default: 300 Sekunden) und POTTO_TIMEOUT_IDLE (Default: 120 Sekunden) zur Einstellung der Timeouts von Otto (single-data-retrieve-Endpunkte)

• Experimentale Unterstützung von PostgreSQL 17

Bei Verwendung von PostgreSQL werden binäre Daten in Tabelle responses Spalten file_content und log_content hexadezimal enkodiert zwischengespeichert. Die Daten werden dekodiert (binär) in S3 hochgeladen.

• Der eric.log und otto.log kann bis zu 10 MiB groß werden (vorher nach max. 5 MiB rotiert)

• Optimierung der PDF-Generierung hinsichtlich Laufzeit und Speicherverbrauch

• Das ERiC-Plugin-Verzeichnis wurde von plugins2 in plugins umbenannt

• PHP 8.3.23 (Debian 12 mit Kernel 6.10.14)

2.25.1 (2025-05)

Manifest digest: sha256:9447f8b3a40e5220596a031f6040115f4f1b7031315aee28ef0851c01a597df3

Fachlich

(nichts)

Technisch

Datenabholung v31 wird ab dem 09.06.2025 die einzige von ELSTER serverseitig unterstützte Version sein. Dieses image enthält nur v31, und entfernt frühere Versionen der Datenabholung.

• ERiC 41.6 (mit Plugin checkDatenabholung 41.2.4)

  • eSigner 62.0.0.5

• Neue statusTypes: error-otto-processing und error-otter-response um auf Fehler beim herunterladen von dataUuid (single-data-retrieve-Endpunkte) mittels der Otto-Bibliothek und Fehler vom OTTER-Server hinzuweisen.

• Otto 41.5

  • Zum Fehlercode wird nun auch ein deutschsprachiger Text zurückgegeben. Falls keiner vorhanden ist, wird ein englischsprachiger generischer Text zurückgegeben.

  • ELSTER Bugfix: Behebung einer vorzeitiger Beendigung der Abholung von Datensätzen über 1 MiB.

• Datenabholung v31 ist nun die einzige unterstützte Version

• PHP 8.3.21 (Debian 12 mit Kernel 6.10.14)

2.25.0 (2024-12)

Manifest digest: sha256:f7b17f11d0e692185b43ad510e2547f9867f98a333e0edf3ef85c1714d89d4ec

Fachlich

• LStA 2025

• LStB 2025 (Version 1.36)

  • bitte beachten Sie die Änderungen im Vordruck und dem Schema im Vergleich zu Jahr 2024 (s. einführende Informationen im Kapitel 3 vom Dokument: SST_ElsterLohn_Datenschnittstelle_LStB_202501.pdf)

Technisch

Datenabholung v19 wird vstl. am 09.06.2025 28.04.2025 serverseitig von ELSTER deaktiviert. Aus diesem Grund ist v31 nun der Defaultwert.

• ERiC 41.2 mit Plugin checkDatenabholung 40.2.2

  • cURL 8.10.1

  • OpenSSL 3.0.15

• Otto 41.2

  • Nicht konfigurierbarer Timeout von 120 Sekunden für fehlende Antwort nach Verbindungsaufbau

  • Behebung von Fehlern

  • Anpassung von internen Abläufen

• Unterstützt sowohl Datenabholung v19 als auch Datenabholung v31

• Datenabholung v31 ist nun der Defaultwert

• Fehler bei Bestätigung der Abholung bei ELSTER mit v31 werden mit HTTP Status Code 501 zurückgegeben

• Zwei Finanzämternamen in Thüringen wurden wegen Fusion umbenannt

• Laravel 11

• PHP 8.3.14 (Debian 12 mit Kernel 6.10.14)

2.24.3 (auschschließlich Preview)

Preview für die Umstellung der Datenabholungsprozesse v31

Image: registry.rechtlogisch.de/gt/deric:eric-40-2

Fachlich

• keine

Technisch

• ⚠️ Siehe: Upgrade Datenabholung v31

• ERiC 40.2 (intern wird nun cURL 8.7.1, zlib 1.3.1 und libHaru 2.4.4 verwendet)

• Otto 40.2 (neue Bibliothek für die Abholung von Objekten/Protokollen von den OTTER-Servern)

• Postman-Dokumentation mit Beispielen für Preview Datenabholung v31 erweitert

• ELSTER bug fix: das sog. erictoolkit hat für bestimmte Finanzamtsbezirke in NRW inkorrekte Validierungsergebnisse bei Steuernummerprüfung zurückgegeben. Das erictoolkit wird im Endpunkt /v1/check/taxnumber verwendet. Vom Fehler war die Übermittlung nicht betroffen, weil dort das erictoolkit nicht verwendet wird und die Validierung der Steuernummer mit der in ERiC integrierten Validierung stets das korrekte Ergebnis zurückgeben hat

• Development-Modus: Telescope Debuginformationen werden nun automatisch nach 7 Tagen (168 Stunden) gelöscht. Die Anzahl der Stunden kann mit der Umgebungsvariable TELESCOPE_PRUNE_AFTER_HOURS konfiguriert werden.

2.24.2 (2024-04)

Fachlich

• Umbenennung mehrerer Finanzämter in Hessen zum 1. März 2024 aufgrund von Reorganisation

Technisch

• ERiC 39.5

• Unterseite Finanzämter hinzugefügt

• Unterseite Hilfreiche Unterlagen entfernt

• Dokumente aus Hilfreiche Unterlagen in Finanzämter, ELSTER Steuernummer und ELO2 verschoben

2.24.1 (2024-03)

ERiC 39.4 (enthalten in 2.24.1) wird für LStA 2024, LStB und ELO2 zum 29.04.2024 Mindestversion. Die Datenübertragung mit früheren ERiC-Versionen wird von ELSTER serverseitig ab diesem Datum verhindert. Für LStA vor 2024 und Datenabholung ist mindestens ERiC 39.2 (enthalten in 2.24.0) notwendig.

Fachlich

Änderungen

• LStA 2024 Kennzahlen 43 und 91 wurden ersatzlos gelöscht

• LStA 2024 Textkorrektur zur Kennzahl 21 : § 19a Absatz 4a Satz 1 (war § 19a Absatz 4b Satz 1)

• Für die Verfahren ElsterLohn (LStB) und ElsterLohn2 (ELO2) wurde für das Element DatenLieferant im sog. Transfer- und Nutzdatenheader eine Begrenzung auf 256 Zeichen eingeführt. Davon ist u. a. der DEVELOPER_NAME betroffen.

• ELSTER Dokumentation in REST-API > Datenarten hochgeladen

Technisch

• ERiC 39.4

• Datenart LStA: Vorvalidierung gibt einen Fehler zurück wenn die Kennzahl (code) im jeweiligen Anmeldungszeitraum nicht unterstützt wird

• Facelift UI Web-Dashboard

2.24.0 (2024-01)

Fachlich

Neue Zeiträume

• LStA 2024

• LStB 2024

Änderungen

• LStA 2024 neue Kennzahl 21

• Datenabholung Version 19

• ELSTER Dokumentation in REST-API > Datenarten hochgeladen

Technisch

• ERiC 39.3

• Container Registry nun: registry.rechtlogisch.de (Zugangsdaten unverändert)

• URL Dokumentation nun: https://gt.docs.rechtlogisch.de

• PHP 8.3

• Laravel 10

• Datenart LStA: Falls ERiC nur Hinweise zurückgibt, wird nun ein entsprechender status, message und HTTP status code zurückgegeben (s. Postman-Beispiel)

• Als Webserver wird nun nginx verwendet (Apache is weiterhin optional möglich mit Image Tag: registry.rechtlogisch.de/gt/deric:apache, der interne Webserver-Port im Container ist nun Port 80, sowohl für nginx als auch für Apache)

• Das sog. Transfer Ticket fängt nun mit eh an (früher et) und wird lokal von ERiC generiert

• Es werden bis zu vier Verbindungsversuche unternommen bevor ein Fehler geworfen wird. Somit werden bis zu vier Transfer Tickets generiert und lokal in der Datenbank in responses.process_result gespeichert

• In der docker-compose.yml und den Beispielen wurden die service-Namen geändert

  • mysql in db

  • redis in cache

  • minio in s3

2.23.5 (2023-11)

• Fix Datenart LStB: Fehler bei Übermittlung

2.23.4 (2023-10)

• Datenart LStA: Ergänzung Vorvalidierung Periode 19 (ganzes Jahr)

2.23.3 (2023-06)

• Anpassung Exception Handler

2.23.2 (2023-05)

• Datenart ElsterLohnDaten: Steuer-ID nicht zulässig für Einzelabholung

• Fix: Telescope Zugang auf Development

• Fix: Erhöhung zugelassene Größe von responses.process_result, responses.server_response und status.data auf 16 MiB

2.23.1 (2023-03)

• Datenart LStBStorno hinzugefügt

• Datenart LStB: Ergänzung Validierung federalState

• Datenart ElsterLohnDaten: Korrektur vorhandener Filtermöglichkeiten für die Suchkriterien

• Datenarten LStBStorno und ElsterLohnDaten: Verwendung der Korrekten Vorvalidierungsregeln

• Rückgabe von Details bei invaliden XML-Strukturen

• Fix: Übergabe der externen ticketId aus dem Request

• Fix: UI ELO2 (zuvor inkorrekte Route /lst verwendet)

2.23.0 (2023-02)

• Initiale version