> For the complete documentation index, see [llms.txt](https://za.docs.rechtlogisch.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://za.docs.rechtlogisch.de/beta/general/changelog.md).

# Changelog

## 2.27.0-beta.1 (2026-11-14)

Preview of yearly update

### Filings

{% hint style="warning" %}
WIP: Synopsis
{% endhint %}

#### ESt 2026

New tax year 2026  (without attachment N-GRE)

{% hint style="warning" %}
[Multiple changes](https://forum.elster.de/herstellerforum/forum/eric/eric-setup/165450-fachliche-%C3%A4nderungsauswertung-eric-novemberrelease-2026-geplant-30-11-2026) to ESt\_2026 have been announced to be introduced in ERiC 45.2 (planned release 2026-11-30)
{% endhint %}

### Messages

* Max. size of single attachment was raised to 105 MB and of all attachment to 1024 MB.

#### Subsequent

* Submission without tax number (as of v25; planned productive start at ELSTER: 2026-11-30)

#### Other

* Submission without tax number (as of v23; planned productive start at ELSTER: 2026-11-30)

### VaSt

* New document `VaSt_ZUW` (German: Spenden und Mitgliedsbeiträge) introduced

### Tax offices

*

### Technical

* Datenabholung v32 (only supported version)
* Transfer Handle was removed from ERiC
* ERiC 45.1 (Beta)
* Tested with PHP 8.4.27 and Apache 2.4.71

## 2.26.2 (2026-09-22)

### General

{% hint style="warning" %}
Available DIVA `provisionDataTypes` changed
{% endhint %}

### DIVA

Changes to [provisionDataTypes](/beta/retrieval/diva.md#available-provisiondatatypes-for-list-endpoint)

* Removed:
  * AnzeigeEinerLotterie (temporarily deactivated ELSTER side)
  * GlueckspielF (temporarily deactivated ELSTER side)
  * VerbindlicheAuskunftInfoF
* Added:
  * DivaBescheid34aEStG
  * DivaBescheidGrESt
  * DivaBescheidGrundsteuer
  * DivaBescheidOSS
  * KDBVollmachtRM
  * OZGPPNachricht
  * VDBKDBRueckmeldungLief
* Excluded from default:
  * OZGMitteilung (temporarily deactivated ELSTER side)

### Documentation

* Uploaded v21.0 of [DIVA document types catalog](/beta/retrieval/diva.md#document-types)

### Technical

* Updated composer and npm dependencies
* Tested with PHP 8.4.25

## 2.26.1 (2026-04-07)

### General

{% hint style="warning" %}
Default changed for DIVA `provisionDataTypes` retrieval
{% endhint %}

* Listing DIVA default for  `provisionDataTypes` changed. All ELSTER-side activated [provisionDataTypes](/beta/retrieval/diva.md#available-provisiondatatypes-for-list-endpoint) are listed now by default

{% hint style="warning" %}
`Anhang` (especially for DIVA) is now always an array
{% endhint %}

* Adjusted server response structure of `/list` endpoints, so `Anhang` is now an array, and adjusted [OpenAPI](/beta/api/openapi.md) specification
* Fixed issue when multiple `provisionDataTypes` provided, and some of them returned zero documents
* Fixed issue with returning metadata key names when first `provisionDataTypes` had no documents

### Documentation

* Added `EPAntwortKopie` and `IBANMeldungRM` to list of [available provisionDataTypes](/beta/retrieval/diva.md#available-provisiondatatypes-for-list-endpoint)
* Uploaded v20.0 of [DIVA document types catalog](/beta/retrieval/diva.md#document-types)

### Technical

* Updated composer and npm dependencies
* Refactored Annotations to Attributes and removed `doctrine/annotations` dependency&#x20;
* Tested with PHP 8.4.19

## 2.26.0 (2025-12-02)

### Filings

#### ESt 2025

New tax year 2025  (without attachment N-GRE)

{% hint style="info" %}
Attachment N-GRE for ESt 2025 is planned to be released on 2026-02-23
{% endhint %}

* 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

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

### Tax offices

* Six [tax offices](https://za.docs.rechtlogisch.de/beta/general/pages/W5ETleopNehTvdOTs1FW#id-43.3) in NI changed slightly their spelling and one was removed `2331`

### Technical

* ERiC 43.3
  * eSigner 63.0.1.0
* Tested with PHP 8.4.15

## 2.25.11 (2025-09-23)

### General

{% hint style="warning" %}
Upgrade to [PHP 8.4](/beta/setup/upgrade-php.md), and Composer 2.8 recommended.
{% endhint %}

{% hint style="danger" %}
Change in .env
{% endhint %}

* Change in `PERIC_PATH_LIB` subpath: replace `\plugins2\` with `\plugins\`&#x20;
* Recommended to switch to [`QUEUE_CONNECTION=database`](/beta/setup/queue.md), 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](https://za.docs.rechtlogisch.de/beta/general/pages/W5ETleopNehTvdOTs1FW#id-42.4) 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

{% hint style="info" %}
`Meta` is now an object not an array
{% endhint %}

* Adjusted OpenAPI and examples in Postman
* Change of [certificate](/beta/setup/certificates.md#production) 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](/beta/setup/certificates.md) 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)

{% hint style="warning" %}
Please read [Upgrade Datenabholung v31](/beta/general/upgrade-datenabholung-v31.md)
{% endhint %}

* `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](/beta/retrieval/diva.md#available-provisiondatatypes-for-list-endpoint) 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](/beta/filings/message/advance-payment.md) (Anpassung von Vorauszahlungen 21)
* [Appeal](/beta/filings/message/appeal.md) (Einspruch)
  * [Appeal New](/beta/filings/message/appeal/new.md) (Einspruch 22)
  * [Appeal Addendum](/beta/filings/message/appeal/addendum.md) (Einspruch Nachtrag 1)
  * [Appeal Withdrawal](/beta/filings/message/appeal/withdrawal.md) (Einspruch Rücknahme 1)
* [Bank Details](/beta/filings/message/bank-details.md) (Änderung der Bankverbindung 20)
* [Deadline](/beta/filings/message/deadline.md) (Antrag auf Fristverlängerung 21)
* [Other](/beta/filings/message/other.md) (Sonstige Nachrichten 21)

### General

* [Universal](/beta/filings/message/universal.md) message endpoint
* Added migration for `responses` table to change the type of column `server_response` from `MEDIUMTEXT` to `LONGTEXT`&#x20;

{% hint style="info" %}
The execution of the migration might take some time for big databases.
{% endhint %}

## 2.25.0 (2025-01)

### Filings

#### ESt 2024

New tax year 2024  (without attachment N-GRE)

{% hint style="info" %}
Attachment N-GRE for ESt 2024 is planned to be released on 2025-02-24
{% endhint %}

* 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](https://za.docs.rechtlogisch.de/beta/general/pages/W5ETleopNehTvdOTs1FW#id-41.2) 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](/beta/api/postman.md))
* 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

{% hint style="info" %}
Example-IDs changed in multiple retrieval endpoints for retrievable results
{% endhint %}

### 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](https://za.docs.rechtlogisch.de/beta/general/pages/W5ETleopNehTvdOTs1FW#id-39.5) 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
