# mini-eric

<h2 align="center">ELSTER XML Processing Tools</h2>

<p align="center">Command-line tools and PHP SDK for processing German ELSTER XML documents with the ERiC API</p>

<p align="center"><a href="https://app.gitbook.com/s/IRqfkb9cGoXWFRnwRjAT/getting-started/quickstart" class="button primary">Quick start</a> <a href="https://app.gitbook.com/s/IRqfkb9cGoXWFRnwRjAT/cli/overview" class="button secondary">CLI Reference</a></p>

<p align="center"></p>

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-terminal">:terminal:</i></td><td><strong>CLI</strong></td><td>Command-line tools for processing ELSTER XML documents with ERiC API integration</td><td><a href="https://app.gitbook.com/s/IRqfkb9cGoXWFRnwRjAT/cli/cli-reference">CLI Reference</a></td></tr><tr><td><i class="fa-code">:code:</i></td><td><strong>PHP SDK</strong></td><td>Object-oriented PHP wrapper for easy integration into your application</td><td><a href="https://app.gitbook.com/s/IRqfkb9cGoXWFRnwRjAT/php-sdk/overview">Overview</a></td></tr><tr><td><i class="fa-file-code">:file-code:</i></td><td><strong>Examples</strong></td><td>Ready-to-use XML examples for various ELSTER data types and use cases</td><td><a href="https://app.gitbook.com/s/IRqfkb9cGoXWFRnwRjAT/examples/examples">Examples</a></td></tr></tbody></table>

{% columns %}
{% column %}

#### Process ELSTER documents in minutes

mini-eric provides powerful tools for processing German ELSTER XML documents. Whether you need to validate, transmit, or download data from German tax authorities, we've got you covered.

* **Draft**: Validate XML and generate PDF previews
* **Send**: Validate and transmit documents with PDF confirmation
* **Transmit**: Transmit documents (without PDF confirmation)
* **Download**: Download data from OTTER server using object UUID

<a href="https://app.gitbook.com/s/IRqfkb9cGoXWFRnwRjAT/getting-started/quickstart" class="button primary" data-icon="rocket-launch">Quick start</a> <a href="https://app.gitbook.com/s/IRqfkb9cGoXWFRnwRjAT/cli/cli-reference" class="button secondary" data-icon="terminal">CLI Reference</a>
{% endcolumn %}

{% column %}
{% code title="CLI examples" overflow="wrap" %}

```php
# draft
ceric --pathXml info.xml --dataType Kontoinformation

# send
ceric --usecase send --pathXml ustva-2026.xml --dataType UStVA_2026

# transmit
ceric --usecase transmit --pathXml inbox.xml --dataType PostfachAnfrage_31

# download
cotto --objectUuid aaaaaaaa-bbbb-4ccc-dddd-eeeeeeeeeee

```

{% endcode %}
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% code title="PHP example" overflow="wrap" %}

```bash
use Rechtlogisch\MiniEric\Ceric;
use Rechtlogisch\MiniEric\Dto\CericInput;

$ceric = new Ceric();
$result = $ceric->draft(new CericInput(
    dataType: 'Kontoinformation',
    pathXml: '/path/to/info.xml',
));

if ($result->cericOutput->exitCode === '0') {
    echo "PDF generated: " . $result->cericOutput->pathOutputFile;
}
```

{% endcode %}
{% endcolumn %}

{% column %}

#### Built for German tax filings

mini-eric is specifically designed for German tax filings submitted via ELSTER, and supports all  data types and procedures, for example:

* **ElsterAnmeldung**: Periodic returns (UStVA\_,\* LStA\_\* and more)
* **ElsterErklaerung**: Yearly declarations (USt\_\*, ESt\_\*, KSt\_\* and more)
* **ElsterFSE**: Registration for tax purposes (ElsterFSE\_\*)
* **ElsterKMV**: KONSENS-Mitteilungsverfahren (Gewerbemeldung, LSTMitteilung, MVZMitteilung, MVOMitteilung and more)
* **ElsterLohn\***: Wage related (DUe\*, LStB)&#x20;
* **ElsterNachricht**: Messages to the tax office (Aufzeichnung146a\_\*, Belegnachreichung\_\*, Einspruch\* and more)
* **ElsterExtern**: ZMDO and IBANMeldung
* **ElsterDatenabholung**: Data retrieval (Postfach\* operations)
* **Otto**: Data retrieval from OTTER servers

<a href="https://app.gitbook.com/s/IRqfkb9cGoXWFRnwRjAT/basics/data-types" class="button primary" data-icon="file-code">Data types</a> <a href="https://app.gitbook.com/s/IRqfkb9cGoXWFRnwRjAT/examples/examples" class="button secondary" data-icon="file-code">Examples</a>
{% endcolumn %}
{% endcolumns %}

<h2 align="center"></h2>

<h2 align="center">Trusted by developers worldwide</h2>

<p align="center">Built for reliability and compliance with German legal regulations.</p>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-github">:github:</i></td><td><strong>Open Source</strong></td><td>We develop for developers and share useful tools open source on GitHub.</td><td><a href="https://github.com/rechtlogisch/" class="button secondary">Visit our GitHub</a></td></tr></tbody></table>