Changelog

2.25.2 (2025-06)

General

• VaSt v31

• Replace checkDatenabholung with version 41.2.4

2.25.1 (2025-02)

Data types

New messages (procedure ElsterNachricht):

• Advance Payment (Anpassung von Vorauszahlungen 21)

• Appeal (Einspruch)

  • Appeal New (Einspruch 22)

  • Appeal Addendum (Einspruch Nachtrag 1)

  • Appeal Withdrawal (Einspruch Rücknahme 1)

• Bank Details (Änderung der Bankverbindung 20)

• Deadline (Antrag auf Fristverlängerung 21)

• Other (Sonstige Nachrichten 21)

General

• Universal message endpoint

• Added migration for responses table to change the type of column server_response from MEDIUMTEXT to LONGTEXT

The execution of the migration might take some time for big databases.

2.25.0 (2025-01)

Filings

ESt 2024

New tax year 2024 (without attachment N-GRE)

Attachment N-GRE for ESt 2024 is planned to be released on 2025-02-24

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

• Fields 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 have been renamed

General

• Changes in environment variables:

  • Added new environment variables for setting a custom software certificate, which is used in production for submission of ESt and retrieval of AssessmentData

    • EINREICHUNG_CERTIFICATE_FILE , if provided the software certificate is used for submission of ESt and retrieval of AssessmentData

    • EINREICHUNG_CERTIFICATE_PIN (defaults to PERIC_CERTIFICATE_PIN)

    • EINREICHUNG_PATH_CERTIFICATES (defaults to PERIC_PATH_CERTIFICATES )

  • TAXID_TEST_CERTIFICATE_FILE replaced CUSTOM_CERTIFICATE_FILE, and is used for VaSt on test environment (default value: test-softidnr-pse.pfx)

  • USE_SOFTWARE_CERTIFICATE removed, as not utilized anymore on test environment

  • Recommended to set CACHE_STORE=file (replaces CACHE_DRIVER)

  • Recommended to set LOG_STACK=daily

  • TIMEZONE was replaced with APP_TIMEZONE (default value: UTC, did not change)

• Added bufa and economicid endpoints for validation purposes (cf. Postman)

• Non-breaking changes in API responses:

  • transferTicket is returned in response (relevant in send and retrieve usecase). ERiC tries connecting to ELSTER server upto four times, every time generating an unique transfer ticket, the key transferTicket holds the transfer ticket for which a connection with ELSTER was successfully established

  • fileContent key is always returned. In case no file content in database, returned value is null

  • serverResponsePayload is verbose now, by default on all endpoints

• Extended tests in Postman

Example-IDs changed in multiple retrieval endpoints for retrievable results

Technical

• ERiC 41.2

• Laravel 11

• Tested with PHP 8.2.27

• Support MariaDB 11.4

2.24.3 (2024-09)

Technical

• Fix: BRM /vast/list-access-requests now always returns an array in response path data.serverResponsePayload.Nutzdaten.SpezRechtListe.Antrag

• Fix: BRM /vast/single-request now allows notifyEmail: null

• Fix: Request validation did not stop on first failure and proceeded with other validations containing unexpected validation input

2.24.2 (2024-07)

Filings

ESt

Only minor changes

• In ESt 2021, 2022 an “en dash” – was replaced with a “hyphen” -

• In ESt 2023 a paper form line number was corrected (in Anlage L)

Technical

• ERiC 40.1

2.24.1 (2024-04)

Filings

ESt 2023

• Multiple rules on attachments N and N-GRE in context DHHF.Allg (English: „double household”, German: „Doppelte Haushaltsführung”) have been changed as with previous ERiC versions submission of declarations for TY 2023 is possible, where the relevant data is missing

• Custom list for field E0204503 in context N.Wk.Arb_Zim.Einz (German: „Einzelangabe zur Art im Bereich häusliches Arbeitszimmer”) was extended with „Jahrespauschale (ggf. zeitanteilig)“. The list is not closed and can be overridden with any text up to 999 characters

• Change in rule Regel_KAP_BET_2023_101920015

Tax offices

• Changes of tax offices names in Hessen as of March 1st, 2024, due to reorganisation

Technical

• ERiC 39.5

• Fix: Charset encoding of VaSt single retrieve

2.24.0 (2024-03)

Initial version

Data types

• ESt 2020-2023

• VaSt (BRM and ElsterVaStDaten 19)

• BDÜ (ElsterErklaerungDaten 19)

• DIVA (ElsterDIVADaten 19)

• Subsequent message with feedback retrieval (Belegnachreichung 22 with MitteilungAbholung 19)

Technical

• Sandbox running on Windows Server 2022 Datacenter 21H2 (64-bit)

• ERiC 39.4

• PHP 8.2.12

• Apache 2.4.58

• MariaDB 10.4.32

• Laravel 10