Taxel

Taxel provides a GUI and command line interface (CLI) to generate the electronic balance sheet (eBilanz) in the XBRL format.

Generate a report in the XBRL standard with tax and accounting data; validate and send the XBRL document to the tax authorities.

Supported features:

• eBilanz

---

• What is eBilanz?
• Taxel GUI
  • Install Taxel GUI
• Taxel CLI
  • Install Taxel CLI
  • Usage
  • Testing
• Rust bindings and SDK for the ELSTER Rich Client (ERiC)
• Changelog

What is eBilanz?

eBilanz (short for Elektronische Bilanz) is the electronic transmission of the company balance sheet and P&L in a standardized format (XBRL) to the tax authorities in the context of tax declaration.

Taxel GUI

Install Taxel GUI

Prebuilt binaries and releases are not provided in this repository. Releases will be published in the taxel-releases repo.

Taxel CLI

Install Taxel CLI

git clone git@github.com:quambene/taxel.git
cd taxel

# Build and install taxel binary to ~/.cargo/bin
cargo install --path ./taxel-cli

Note: Run cargo install --path ./taxel-cli again to update to the latest version. Uninstall the binary with cargo uninstall taxel.

Usage

# Extract values from xml file
taxel extract \
    --xml-file "my_ebilanz.xml" \
    --output-file "my_ebilanz.csv"

# Generate xml file from csv file
taxel generate \
     --csv-file "my_ebilanz.csv" \
     --template-file "templates/elster_v11_ebilanz_v6.5_test.xml" \
     --output-file "my_bilanz.xml"

# Validate xml file
taxel validate \
    --tax-type "Bilanz" \
    --tax-version 6.4 \
    --xml-file "my_tax_data.xml"

# Validate xml file and print confirmation as pdf file
taxel validate \
    --tax-type "Bilanz" \
    --tax-version 6.4 \
    --xml-file "my_tax_data.xml" \
    --print "my_eBilanz.pdf"

# Send xml file to tax authorities
taxel send \
    --tax-type "Bilanz" \
    --tax-version 6.4 \
    --xml-file "my_tax_data.xml" \

# Send xml file to tax authorities and print confirmation as pdf file
taxel send \
    --tax-type "Bilanz" \
    --tax-version 6.4 \
    --xml-file "my_tax_data.xml" \
    --print "my_eBilanz.pdf"

Testing

# Run unit tests for taxel-cli
cargo test -p taxel-cli

# Run integration tests for taxel-cli (requires ERiC library)
cargo test -p taxel-cli --test '*' -- --test-threads=1

# Run external tests for taxel-cli (requires ERiC library and Elster certificate)
cargo test -p taxel-cli --release --test '*' --features external-test -- --test-threads=1

# Run unit tests for taxel
cargo test --lib -p taxel

# Run unit tests for taxel-py
cd taxel-py
pytest -v -m unit

Rust bindings and SDK for the ELSTER Rich Client (ERiC)

Rust bindings and SDK for ERiC were moved to https://github.com/quambene/eric-rs.

Changelog

The taxel repository contains multiple crates with separate changelogs:

• taxel: view changelog
• taxel-cli: view changelog
• taxel-gui: view changelog