Changelog

2.25.11 (2025-09-23)

General

Upgrade to PHP 8.4, and Composer 2.8 recommended.

Change in .env

• Change in PERIC_PATH_LIB subpath: replace \plugins2\ with \plugins\

• Recommended to switch to QUEUE_CONNECTION=database, added jobs table migration

• APP_VERSION and ERIC_VERSION can be removed from .env, as they have no relevance anymore

• Test certificates replaced (valid until: 2028-07-10)

• Fixed exception handling when Otto failed while starting download

• Fixed npm package vulnerabilites

Filings

Appeal

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

ESt 2020-2024 and Bank Details

• Stricter IBAN validation

ESt 2023

• Error message for rule G_Gewerbebetrieb_Gewinn_10 on attachment G changed

ESt 2024

• Added attachment N_GRE

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

Subsequent (Belegnachreichung 23)

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

Tax offices

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

Technical

• ERiC 42.4

  • eSigner 62.0.0.5

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

  • optimized execution time and memory usage for print operations

  • ERiC plugin subpath was changed from plugins2 into plugins

  • Otto fix for objects bigger than 1 MiB

  • ERiC fix concerning parallel starting of new instances in threads

• Laravel 12

• Tested with PHP 8.4.13

2.25.10 (2025-08-18)

General

• Fix path to driver when getting public key of a DATEV-Smartcard on Windows

• Add a health check endpoint for Smartcards

2.25.9 (2025-08-14)

Generel

• Use public key (German: Abholzertifikat) for VaSt retrieve if Smartcard not registered at ELSTER

2.25.8 (2025-07-29)

General

• Fix path to driver when decoding data for a Smartcard which is not registered at ELSTER

2.25.7 (2025-07-24)

General

• Adjust storage path for eric.log in Decode Service

• Add update.bat for manual updates on Windows

2.25.6 (2025-07-18)

General

• Return meta data for list endpoints (v31) as key: value pairs, where key is the attribute name

Meta is now an object not an array

• Adjusted OpenAPI and examples in Postman

• Change of certificate on production for /messages/* and /feedback/* endpoints, when EINREICHUNG_CERTIFICATE_FILE is set. Software certificate is used, instead of USB stick.

• Improved checking ELSTER server errors

2.25.5 (2025-07-10)

General

• Fixed selection of USB stick for Otto (retrieve endpoints)

• Fixed providing own ticket key in retrieve endpoints

• Listed certificates used in endpoints and environments

2.25.4 (2025-07-09)

General

• Fixed use of USB sticks (static call to Common::getStickDriver())

• Fixed providing null values for multiple keys (especially ticket and provisionDataTypes )

2.25.3 (2025-07)

General

• Fixed Datenabholung v31 (and set as default)

Please read Upgrade Datenabholung v31

• Content-Type header defaults to application/json for POST requests

• Content-Type other than application/json returns HTTP status code 415

• Unified naming of date range keys dateFrom and dateTill (from and till can be still used)

• Renamed key type to scope in list endpoints (type can be still used)

• Listed all provisionDataTypes for DIVA

• Updated OpenAPI and Postman documentations

2.25.2 (2025-06)

General

• VaSt v31

• Replaced 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