TaxonomyExporter Application – RetailForce

Purpose

TaxonomyExporter is a local command-line application developed by RetailForce for German TSE-related fiscal data export in an offline environment. The application processes available fiscal source files from a local ZIP directory and generates either a taxonomy export or a CSV export file.

The solution is intended for implementation, support and compliance review scenarios where German fiscalisation data must be extracted into a structured local output format.

German TSE Context

Under the German fiscalisation framework, electronic recording systems within the scope of § 146a AO must protect transaction records through a certified Technical Security Device, known as TSE. The TSE consists of a security module, a storage medium and a digital interface.

For cash register systems, the transaction data structure is defined by DSFinV-K, the German fiscal administration’s digital interface for cash register systems. TaxonomyExporter sits in this export layer, and its role is to transform available fiscal source data into taxonomy or CSV output for review and further processing.

Application Overview

TaxonomyExporter has two commands:

Taxonomy: Exports taxonomy data
csv: First generates the taxonomy export and then exports the result as CSV

Both commands require an output directory and a ZIP file directory. The Fiscal Client file, VAT number and tax number can be provided as optional parameters. Where the Fiscal Client file is omitted, the application obtains the Fiscal Client data from the ZIP archive.

General Syntax

TaxonomyExporter [command] [options]

Available commands:

TaxonomyExporter taxonomy [options]
TaxonomyExporter csv [options]

Help commands:

TaxonomyExporter /?
TaxonomyExporter taxonomy /?
TaxonomyExporter csv /?

Taxonomy Command

The taxonomy command generates the taxonomy export from the source ZIP data.

.\TaxonomyExporter.exe taxonomy --outputDir <outputDir> --zipDir <zipDir>

Parameter	Required	Description
--outputDir	YES	Output directory for the generated taxonomy export
--zipDir	YES	Directory containing the source ZIP files
--fcFileName	NO	Filename and path of the serialized Fiscal Client file
--vatNumber	NO	Overrides the Fiscal Client VAT number
--taxNumber	NO	Overrides the Fiscal Client tax number

CSV Command

The csv command generates the taxonomy export first and then converts it into CSV format.

.\TaxonomyExporter.exe csv --outputDir <outputDir> --zipDir <zipDir>

Parameter	Required	Description
--outputDir	YES	Output directory for the generated CSV export
--zipDir	YES	Directory containing the source ZIP files
--zipFileName	NO	Source ZIP filename without extension. Wildcards can be used
--fcFileName	NO	Filename and path of the serialized Fiscal Client file
--vatNumber	NO	Overrides the Fiscal Client VAT number
--taxNumber	NO	Overrides the Fiscal Client tax number
--startDate	NO	Start date for period-based export
--endDate	NO	End date for period-based export

Typical Use

The user runs the application locally, provides the command and required directories, and the application writes the generated export files into the selected output folder. The CSV command can also filter the export by ZIP filename and by date range, which supports file-specific and period-based review.