Changelog

2.25.1 (2025-02)

New messages (procedure ElsterNachricht):

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.

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

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

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)
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

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

Only minor changes

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

Initial version

ESt 2020-2023
VaSt (BRM and ElsterVaStDaten 19)
BDÜ (ElsterErklaerungDaten 19)
DIVA (ElsterDIVADaten 19)
Subsequent message with feedback retrieval (Belegnachreichung 22 with MitteilungAbholung 19)

Last updated 2 months ago

Was this helpful?