> 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/setup/certificates.md).

# Certificates

v2

Based on set environment variables a given certificate is being used. This tables list which certificate is being used grouped by environments.

{% hint style="info" %}
`/*` denotes a wildcard, meaning: applies to all endpoints in this group
{% endhint %}

## Production

Default `CERTIFICATE_FILE` is `dvccsap11002.dll` (DATEV USB Stick)

| Endpoint                                              | Default           | When EINREICHUNG\_CERTIFICATE\_FILE set                                                                               |
| ----------------------------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------- |
| [**/est**](/beta/filings/est.md)                      | CERTIFICATE\_FILE | EINREICHUNG\_CERTIFICATE\_FILE<sup>1</sup>                                                                            |
| [**/message/\***](/beta/filings/message.md)           | CERTIFICATE\_FILE | EINREICHUNG\_CERTIFICATE\_FILE<sup>2,</sup> <sup></sup><sup><mark style="color:red;">3<mark style="color:red;"></sup> |
| [**/assessment-data/\***](/beta/retrieval/bdu.md)     | CERTIFICATE\_FILE | EINREICHUNG\_CERTIFICATE\_FILE<sup>1</sup>                                                                            |
| [**/diva/\***](/beta/retrieval/diva.md)               | CERTIFICATE\_FILE | CERTIFICATE\_FILE                                                                                                     |
| [**/feedback/\***](/beta/retrieval/feedback.md)       | CERTIFICATE\_FILE | EINREICHUNG\_CERTIFICATE\_FILE<sup>2,</sup> <sup></sup><sup><mark style="color:red;">3<mark style="color:red;"></sup> |
| [**/steuerkonto/\***](/beta/retrieval/steuerkonto.md) | CERTIFICATE\_FILE | CERTIFICATE\_FILE                                                                                                     |
| [**/vast/\***](/beta/retrieval/vast.md)               | CERTIFICATE\_FILE | CERTIFICATE\_FILE                                                                                                     |

<sup>1</sup> `assessment-data` can be retrieved only with the certificate with which the (ESt) declaration was submitted, in case no designated retrieval key was provided in the declaration XML itself

<sup>2</sup> `feedback` can be retrieved only with the certificate the message was submitted, in case no designated retrieval key was provided in the message XML itself

<sup><mark style="color:red;">3<mark style="color:red;"></sup> ⚠️ Change as of [v2.25.6](https://za.docs.rechtlogisch.de/beta/setup/pages/-MG4FPiZ91v7aL1O3o0H#id-2.25.6-2025-07-18). Before `CERTIFICATE_FILE` was default.

## Development

Default `CERTIFICATE_FILE` is `test-softorg-pse.pfx` . Development uses by default only official test software certificates.

| Endpoint                                              | Default                                                      |
| ----------------------------------------------------- | ------------------------------------------------------------ |
| [**/est**](/beta/filings/est.md)                      | test-softorg-pse.pfx                                         |
| [**/message/\***](/beta/filings/message.md)           | test-softorg-pse.pfx                                         |
| [**/assessment-data/\***](/beta/retrieval/bdu.md)     | Datenabholung<sup>4</sup>                                    |
| [**/diva/\***](/beta/retrieval/diva.md)               | test-soft<mark style="color:orange;">**idnr**</mark>-pse.pfx |
| [**/feedback/\***](/beta/retrieval/feedback.md)       | test-softorg-pse.pfx                                         |
| [**/steuerkonto/\***](/beta/retrieval/steuerkonto.md) | test-softorg-pse.pfx                                         |
| [**/vast/\***](/beta/retrieval/vast.md)               | test-soft<mark style="color:orange;">**idnr**</mark>-pse.pfx |

<sup>4</sup> `Datenabholung` is an official client certificate (German: Client Erzeugtes Zertifikat) provided by ELSTER, specially for assessment data, and consists of two files
