Support

Changelog

2.25.3 (2025-09)

Additional message endpoints

Manifest digest:

sha256:b22634cf7a47376ac7a6648f9cb3fab736cc945f0f1f8ffdd28041d1baa35875

Data types

New messages (procedure ElsterNachricht):

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

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

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

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

Previous1. GeneralNextHow the solution works

Last updated

Was this helpful?