Changelog

2.26.0 (2025-12)

ERiC 43.3 with ESt 2025 (without attachment N-GRE) and new preview versions of messages

Manifest digest: sha256:7a907fd35d10856e3454c36cbd097e9012cfd03b28db13b0ac8fa015e644fe7d

Overview

• Support tax year 2025 for ESt

• New preview versions of messages unifying the length of text messages to 15.000 characters. Planned for productive release on 2026-02-23.

ESt-beschraenkt 2025 (and attachment N-GRE for ESt 2025) is planned to be released on 2026-02-23, currently only a preview documentation is available.

General

• Added ESt 2025 without attachment N-GRE (German: "Grenzgänger")

• ERiC 43.3.2

  • eSigner 63.0.1

    • bug fix for uninitialized values, which could cause crashes

    • memory leak fixed

  • Otto fix for objects bigger than 1 MiB

  • ERiC plugin subpath was changed from plugins2 into plugins

  • optimized execution time and memory usage for print operations

  • eric.log and otto.log are now rotated when 10 MiB in size

  • ERiC fix concerning parallel starting of new instances in threads

• PHP 8.4.15 (based on Debian 13.2 with Linux Kernel 6.12)

• Laravel 12

Economic-ID (German: "Wirtschafts-Identifikationsnummer") on forms is planned to be optional up until ~End 2027.

Details

ESt 2025

• Enumeration for field E0109814 (German: Ergänzende Angaben) introduced

• Error Regel_ESt1A_2025_101100200 when German postal code provided and foreign country provided for person A

• Hint Regel_ESt1A_2025_101100203 for joint assessment (German: Zusammenveranlagung) added

• Field E0502619 (German: Zuordnung Kinderzulage) on attachment Kind added

• Line numbers references in text have been corrected for attachments N, SO and AUS

• Multiple changes in other attachments (inter alia ESt1A, AgB, AUS, AV, Kind, G, S, SO, V and 32c). Please check documentation for changes related to fields your users usually fill in

ESt 2024

• Four rules changed and two removed on attachment G

• Condition and error message of rule S_Selbstaendige_Arbeit_Gewinn_3 changed on attachment S

• Max. repeated limits have been increased to 99 for multiple contexts on attachments AgB, HA_35a, Kind, N, Vor (for example Schulgeld, Entfernungspauschale)

ESt 2023

• Error message for rule G_Gewerbebetrieb_Gewinn_10 on attachment G changed

ESt 2020-2024 and Bank Details

• Stricter IBAN validation

ESt and ESt-beschraenkt

• Added Albania, Moldova, Montenegro and North Macedonia to list of supported SEPA countries

Appeal 22

• Added stricter rule making sure, that suspensionOfExecution is set correctly for each justification

Subsequent 23

• Added two new taxTypes: 1380 [OSS/IOSS] and 2180 [Gewinnermittlung nach § 13a EStG]

Tax offices

• Multiple changes in BE, BW, HE, HH, NI, NW and SH

Messages (preview)

Appeal 23, AppealAddendum 2, AppealWithdrawal 2

• justification max. length 15.000 characters

• Added taxTypes for so called Pillar II related acts (for multinationals, not releavant for natural persons, German: Mindeststeuer)

Subsequent 24

• justification max. length 15.000 characters

• Added multiple taxTypes typically used by companies, and field period (German: Zeitraum)

• Added appropriate rules related to new tax types

2.25.5 (2025-12)

Additional message endpoint

Manifest digest:

sha256:4ff5e1f00b2f68e8be10fb0f12191cf1783a77f34323ef699645579c5684a13e

Data type

New message endpoint:

• Other (Sonstige Nachrichten)

2.25.4 (2025-11)

New test certificates

Manifest digest:

sha256:365b1e422e185503e578dc1007afedb151b9b3ef404434cd810d9e0d9e1f8906

Genaral

• Replaced test certifactes (valid until: 2028-07-10)

• Fixed attachments in S3 feature for AppealNew and AppelAddendum messages

2.25.3 (2025-09)

Additional message endpoints

Manifest digest:

sha256:b22634cf7a47376ac7a6648f9cb3fab736cc945f0f1f8ffdd28041d1baa35875

Data types

New messages (procedure ElsterNachricht):

• Appeal (Einspruch)

  • Appeal New (Einspruch 22)

  • Appeal Addendum (Einspruch Nachtrag 1)

  • Appeal Withdrawal (Einspruch Rücknahme 1)

• Bank Details (Änderung der Bankverbindung 20)

General

• Universal message endpoint

• Fixed error in messages for reference (Aktenzeichen), when bufaTaxOffice is missing

2.25.2 (2025-06)

ERiC 41.4 with plugin checkDatenabholung 41.2.4

Manifest digest:

sha256:61b1eb482c5705c4d9132c2ec1b32b687e810caa7e3163add3ab0350fd782a8f

General

Datenabholung v19 will be deactivated on the server-side by ELSTER on 2025-06-09

• Replaced plugin checkDatenabholung with version 41.2.4 (based on version conainted in ERiC package 41.4)

• PHP 8.3.21 (based on Debian 12 with Linux Kernel 6.10.14)

• Removed deprecated endpoints for Datenabholung v19

2.25.1 (2025-02)

ERiC 41.4 with ESt-beschraenkt 2024 and attachment N-GRE for ESt 2024

Manifest digest:

sha256:223146b90200593dc1e3a5b59f005235e6b39d12aa0ddb694fbb9128f01bdfba

General

Datenabholung v19 will be deactivated on the server-side by ELSTER on 2025-06-09 2025-04-28. We plan to publish an image version which will support only v31 mid May 2025, after ERiC 42 has been released.

• Added ESt-beschraenkt 2024

• Added ESt 2024 with attachment N-GRE (German: "Grenzgänger")

• ERiC 41.4.6 (with plugin checkDatenabholung 40.2.2, to support Datenabholung v19 and eSigner 62.0.0.2)

• PHP 8.3.17 (based on Debian 12 with Linux Kernel 6.12)

• Changed dataIds for Assessment Data v19 endpoints in Postman, as some documents have been deleted by ELSTER

Details

ESt 2024

• Some changes to rules for attachments G, S and Mob (cf. ELSTER delta documentation)

ESt-beschraenkt 2024

• Some changes to context names (for example fields E7106702, E7106703, and in attachments L, G, S)

• Multiple changes, in especially in field descriptions, field formats and rules (cf. ELSTER documentation)

2.25.0 (2024-12)

ERiC 41.2 with ESt 2024 (without attachment N-GRE)

Manifest digest: sha256:944873599d296e1fcc1bb4a200229e7e6f3b8bdb4469ea8e54f54ea5207dd463

Overview

• Support tax year 2024 for ESt

General

Datenabholung v19 will be deactivated on the server-side by ELSTER on 2025-06-09 2025-04-28. For this reason, v31 is now the default value.

• Added ESt 2024 without attachment N-GRE (German: "Grenzgänger")

• ERiC 41.2.6 (with plugin checkDatenabholung 40.2.2, to support Datenabholung v19)

• Supports both Datenabholung v19, and Datenabholung v31

• Datenabholung v31 is now the default version

• New check endpoint for Economic-ID (German: Wirtschafts-Identifikationsnummer); providing Economic-ID (ID for companies) on forms is optional till ~End 2026

• Default test certificate changed back to test-softorg-pse.pfx (assessment data list and retrieve v31 uses the CEZ Datenabholung)

Due to the change of the default test certificate, multiple example IDs changed in the Postman documentation.

• Image tag versions follow now API version registry.rechtlogisch.de/tt/deric:2.25.0 (instead of ERiC versions)

• On errors during retrieve or confirm with v31 HTTP status code 501 and data.status: error-elster-response is being returned

• Changelog contains from now on the manifest digest of the released image

• PHP 8.3.14 (based on Debian 12 with Linux Kernel 6.10)

• Laravel 11

Details

ESt 2024

• Length of fields E0100602 and E0101702 (Wohnort) were increased to 25 characters

• Field E0101105 and E0102302 were introduced for changes in church affiliation

• Field Economic-ID (German: Wirtschafts-Identifikationsnummer) has been added on multiple attachments, the field is optional till ~End 2026.

• Multiple changes in other attachments. Please check documentation for changes related to fields your users usually fill in

ESt 2023

• Rules concerning postal codes and IBANs got stricter. Please provide only valid postal codes and valid IBANs

Tax offices

• Two tax offices in Thüringen renamed

2.24.4 (2024-09-16)

Manifest digest: sha256:35527d05b1bbbdc103e7adbd1e6c565caf67edc9c47495d56ac12b1f0a002bc3

Fix: attachment version (from 2 to 3) and extend tests of subsequent messages with attachments

2.24.3 (2024-09)

ERiC 40.2 with Datenabholung v31 and Otto

Overview

• Rule change from error to hint for child tax-ID in ESt 2023

• Preview for Datenabholung v31 and Otto. Currently used Datenabholung v19 will get removed client-side with ERiC 41 in November 2024. Please consider timely upgrade - cf. Upgrade Datenabholung v31

General

• ERiC 40.2.10

• PHP 8.2.23 (based on Debian 12 with Linux Kernel 6.10)

• Default test certificate changed to test-soft-pse.pfx as needed test data available only with this certificate

Details

ESt 2023

• Rule Regel_Kind_2023_100500059 change from error to hint. Leaving this field empty should be done only in rare cases. Missing entry will most likely trigger additional questions from tax office and extend time needed to assess.

Tax offices

• Changes of tax offices names in Hessen, due to reorganisation

2.24.2 (2024-06)

Added self-signed-SSL-certifacte and redirected traffic to HTTPS on port 443.

2.24.1 (2024-02)

ERiC 39.4 with ESt-beschraenkt 2023 and attachment N-GRE for ESt 2023

Overview

• ESt-beschraenkt has some breaking changes in the structure

General

• Added ESt-beschraenkt 2023

• Added ESt 2023 with attachment N-GRE (German: "Grenzgänger")

• ERiC 39.4.6

• PHP 8.2.16 (based on Debian 12 with Linux Kernel 6.6)

• POST body size fix

• Documented feature: Subsequent message attachments in S3

Details

ESt-beschraenkt

• Order of elements in ESt1C.Allg.A.StPfl has been changed. Field E7100602 is now placed at second position, and E7101301 before street (This change does not apply to years before 2023.)

• Contexts ESt1C.Wk.EP.Erste_Taetig and ESt1C.Wk.EP.Sammelp have been merged and the field E0203003 added to determine one of the options. (This change does not apply to years before 2023.)

Fixes

• Maximal POST body size allowed is 50MB

• Subsequent: filingAttachments allows now only to use keys Rueckmeldung and Anhang, and does not throw an 500 error if other keys are being provided

Known performance issue

Big attachments provided directly into a subsequent message body cause relatively high memory usage - up to 12x of the size of the attachments. We are currently looking into it and recommend to use the FEATURES_ATTACHMENTS_IN_S3.

2.24.0 (2024-01)

ERiC 39.3 with ESt 2023

Overview

• ESt has some breaking changes in the structure

• Change in tax offices (added page Tax offices)

General

• Added ESt 2023

• ERiC 39.3.2

• PHP 8.2 (based on Debian 12 with Linux Kernel 5.15)

Details

ESt

• E0840401 has to be provided only if affirmative (1 = yes). (This change does not apply to years before 2023.)

• Contexts ESt1A.N.Wk.EP.Erste_Taetig and ESt1A.N.Wk.EP.Sammelp have been merged and the field E0203003 added to determine one of the options. (This change does not apply to years before 2023.)

• Contexts K_Verh_A, K_Verh_B and K_Verh_and_P have been reorganized regarding the structure. (This change does not apply to years before 2023.)

• For every child a tax-id needs to be provided in E0500406. (This change does not apply to years before 2023.)

• Order of elements in ESt1A.Allg.A has been changed. Optional field E0100403 is now placed after religion fields E01004*2. (This change does not apply to years before 2023.)

Tax offices

• Added BUFA 1115 Berlin International (not relevant for personal income tax)

2.23.2 (2023-10)

Initial release

General

• ESt 2019-2022

• EStbeschraenkt 2019-2022

• ElsterErklaerungDaten 19

• Belegnachreichung 22

• MitteilungAbholung 19

• ERiC 38.3.8

• Linux Kernel 5.4