Anwendung „TaxonomyExporter“ – RetailForce

Zweck

TaxonomyExporter ist eine von RetailForce entwickelte lokale Befehlszeilenanwendung für den Export deutscher TSE-bezogener fiskalischer Daten in einer Offline-Umgebung. Die Anwendung verarbeitet verfügbare fiskalische Quelldateien aus einem lokalen ZIP-Verzeichnis und generiert entweder einen Taxonomie-Export oder eine CSV-Exportdatei.

Die Lösung ist für Implementierungs-, Support- und Compliance-Prüfungsszenarien vorgesehen, in denen deutsche Steuerdaten in ein strukturiertes lokales Ausgabeformat extrahiert werden müssen.

Kontext der deutschen TSE

Im Rahmen der deutschen Fiskalisierungsvorschriften müssen elektronische Aufzeichnungssysteme im Sinne von § 146a AO Transaktionsdatensätze durch eine zertifizierte technische Sicherheitseinrichtung (TSE) schützen. Die TSE besteht aus einem Sicherheitsmodul, einem Speichermedium und einer digitalen Schnittstelle.

Bei Kassensystemen wird die Struktur der Transaktionsdaten durch die DSFinV-K definiert, die digitale Schnittstelle der deutschen Finanzverwaltung für Kassensysteme. TaxonomyExporter ist in dieser Exportschicht angesiedelt und hat die Aufgabe, verfügbare fiskalische Quelldaten in eine Taxonomie- oder CSV-Ausgabe zur Überprüfung und Weiterverarbeitung umzuwandeln.

Anwendungsübersicht

TaxonomyExporter verfügt über zwei Befehle:

Taxonomy: Exportiert Taxonomie-Daten
csv: Erzeugt zunächst den Taxonomie-Export und exportiert das Ergebnis anschließend als CSV

Beide Befehle erfordern ein Ausgabeverzeichnis und ein ZIP-Dateiverzeichnis. Die Fiscal-Client-Datei, die VAT-Identifikationsnummer und die Steuernummer können als optionale Parameter angegeben werden. Wird die Fiscal-Client-Datei nicht angegeben, bezieht die Anwendung die Fiscal-Client-Daten aus dem ZIP-Archiv.

Allgemeine Syntax

TaxonomyExporter [Befehl] [Optionen]

Verfügbare Befehle:

TaxonomyExporter taxonomy [Optionen]
TaxonomyExporter csv [Optionen]

Hilfe-Befehle:

TaxonomyExporter /?
TaxonomyExporter taxonomy /?
TaxonomyExporter csv /?

Befehl „Taxonomy“

Der Befehl „taxonomy“ generiert den Taxonomie-Export aus den ZIP-Quelldaten.

.\TaxonomyExporter.exe taxonomy --outputDir <outputdir> --zipDir <zipdir></zipdir></outputdir>

Parameter	Erforderlich	Beschreibung
--outputDir	Ja	Ausgabeverzeichnis für den generierten Taxonomie-Export
--zipDir	JA	Verzeichnis, das die Quell-ZIP-Dateien enthält
--fcFileName	NEIN	Dateiname und Pfad der serialisierten Fiscal-Client-Datei
--VatNumber	NEIN	Überschreibt die VAT-Identifikationsnummer des Fiscal-Clients
--taxNumber	NEIN	Überschreibt die Steuernummer des Steuerclients

CSV-Befehl

Der Befehl „csv“ generiert zunächst den Taxonomie-Export und konvertiert diesen anschließend in das CSV-Format.

.\TaxonomyExporter.exe csv --outputDir <outputdir> --zipDir <zipdir></zipdir></outputdir>

Parameter	Erforderlich	Beschreibung
--outputDir	JA	Ausgabeverzeichnis für den generierten CSV-Export
--zipDir	JA	Verzeichnis, das die Quell-ZIP-Dateien enthält
--ZipFileName	NEIN	Dateiname der ZIP-Quelldatei ohne Dateiendung. Es können Platzhalter verwendet werden
--fcFileName	NEIN	Dateiname und Pfad der serialisierten Fiscal-Client-Datei
--VatNumber	NEIN	Überschreibt die VAT-Identifikationsnummer des Fiscal Client
--taxNumber	NEIN	Überschreibt die Steuernummer des Steuerclients
--startDate	NEIN	Startdatum für den periodenbasierten Export
--endDate	NEIN	Enddatum für den zeitraumbezogenen Export

Typische Verwendung

Der Anwender startet die Anwendung lokal, übergibt den Befehl sowie die erforderlichen Verzeichnisse, und die Anwendung schreibt die generierten Exportdateien in den angegebenen Ausgabeordner. Der CSV-Befehl kann den Export zudem nach ZIP-Filenamen und nach Datumsbereich filtern, was eine dateispezifische und zeitraumbezogene Überprüfung ermöglicht.

Dieser Artikel wurde automatisch übersetzt.