Aplicação TaxonomyExporter – RetailForce

Objetivo

O TaxonomyExporter é uma aplicação local de linha de comandos desenvolvida pela RetailForce para a exportação de dados fiscais relacionados com o TSE alemão num ambiente offline. A aplicação processa ficheiros-fonte fiscais disponíveis a partir de um diretório ZIP local e gera uma exportação de taxonomia ou um ficheiro de exportação CSV.

A solução destina-se a cenários de implementação, suporte e revisão de conformidade em que os dados fiscais alemães devem ser extraídos para um formato de saída local estruturado.

Contexto do TSE alemão

No âmbito do quadro de fiscalização alemão, os sistemas de registo eletrónico abrangidos pelo § 146a AO devem proteger os registos de transações através de um Dispositivo Técnico de Segurança certificado, conhecido como TSE. O TSE é composto por um módulo de segurança, um suporte de armazenamento e uma interface digital.

No caso dos sistemas de caixa registadora, a estrutura dos dados de transação é definida pela DSFinV-K, a interface digital da administração fiscal alemã para sistemas de caixa registadora. O TaxonomyExporter insere-se nesta camada de exportação, e a sua função consiste em transformar os dados fiscais de origem disponíveis numa saída de taxonomia ou CSV para revisão e processamento posterior.

Visão geral da aplicação

O TaxonomyExporter dispõe de dois comandos:

Taxonomia: Exporta dados de taxonomia
csv: Gera primeiro a exportação da taxonomia e, em seguida, exporta o resultado como CSV

Ambos os comandos requerem um diretório de saída e um diretório de ficheiros ZIP. O ficheiro do Cliente Fiscal, o número de Vat e o número fiscal podem ser fornecidos como parâmetros opcionais. Caso o ficheiro do Cliente Fiscal seja omitido, a aplicação obtém os dados do Cliente Fiscal a partir do arquivo ZIP.

Sintaxe geral

TaxonomyExporter [comando] [opções]

Comandos disponíveis:

TaxonomyExporter taxonomia [opções]
TaxonomyExporter csv [opções]

Comandos de ajuda:

TaxonomyExporter /?
TaxonomyExporter taxonomia /?
TaxonomyExporter csv /?

Comando Taxonomy

O comando «taxonomy» gera a exportação da taxonomia a partir dos dados ZIP de origem.

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

Parâmetro	Obrigatório	Descrição
--outputDir	SIM	Diretório de saída para a exportação da taxonomia gerada
--zipDir	SIM	Diretório que contém os ficheiros ZIP de origem
--fcFileName	NÃO	Filename e caminho do ficheiro do Cliente Fiscal serializado
--VatNumber	NÃO	Substitui o número de Vat do Cliente Fiscal
--taxNumber	NÃO	Substitui o número fiscal do cliente fiscal

Comando CSV

O comando csv gera primeiro a exportação da taxonomia e, em seguida, converte-a para o formato CSV.

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

Parâmetro	Obrigatório	Descrição
--outputDir	SIM	Diretório de saída para a exportação em CSV gerada
--zipDir	SIM	Diretório que contém os ficheiros ZIP de origem
--ZipFileName	NÃO	Filename do ficheiro ZIP de origem sem extensão. Podem ser utilizados caracteres curinga
--fcFileName	NÃO	Nome do ficheiro e caminho do ficheiro do Cliente Fiscal serializado
--VatNumber	NÃO	Substitui o número de Vat do Cliente Fiscal
--taxNumber	NÃO	Substitui o número de identificação fiscal do cliente fiscal
--startDate	NÃO	Data de início para a exportação baseada em períodos
--endDate	NÃO	Data de fim para a exportação por período

Utilização típica

O utilizador executa a aplicação localmente, introduz o comando e os diretórios necessários, e a aplicação grava os ficheiros de exportação gerados na pasta de saída selecionada. O comando CSV também permite filtrar a exportação por filename de ficheiro ZIP e por intervalo de datas, o que permite a análise específica de ficheiros e por período.

Este artigo foi traduzido automaticamente.