Esta função da interface de conformidade fiscal do Vat do RetailForce permite a geração de dados DSFinV-K a partir de dados brutos que já tenham sido fiscalizados.
Ao contrário da implementação de fiscalização da RetailForce para a Alemanha, neste caso o sistema de caixa registadora a montante transfere dados que já foram protegidos por um TSE (Dispositivo Técnico de Segurança / Sistema Técnico de Segurança certificado). Esta função não realiza qualquer processamento adicional dos dados (assinatura) através de um TSE, limitando-se a converter os dados fornecidos para o formato oficial DSFinV-K / Taxonomia.
Fornecimento de dados
Os dados são fornecidos pelo sistema a montante no RetailForce DOM alargado (DOM – Modelo de Objeto de Documento) no formato JSON. Pode encontrar uma descrição geral deste modelo no artigo cujo link se encontra abaixo.
Os dados são transmitidos para o ponto final POST /v1.0/documents da API de Conformidade do Vat, acessível através do URL https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
Extensão de dados TSE
Para que o RetailForce system possa converter os dados para o formato DSFinV-K, o pedido JSON proveniente do sistema a montante deve conter os dados TSE. Caso seja utilizada a implementação de fiscalização, estes dados seriam devolvidos pelo RetailForce system ao sistema a montante através do que é conhecido como «fiscalResponse».
Para além das informações habituais do documento, a payload para a geração do DSFinV-K deve incluir as seguintes propriedades.
Exemplo:
"FiscalResponse": {
"FiscalCountry": "[0] = Germany",
"FiscalDocumentNumber": "456",
"FiscalDocumentStartTime": 1795079983,
"Signature": ""ZZxwQhSr73fn2m+XzGKavYaMbT3+IZ0JT5QK2JgYY/CV5ZTo4RL9hfJAJ4NF02PvkDQkY9e+USUH39UuqOhEHw==",
"CashRegisterId": "003-009",
"QrCode": "V0;00345-00340;Kassenbeleg-V1;Beleg^899.90_0.00_0.00_0.00_0.00^899.90:Bar;1;9;2026-11-13T06:52:41.000Z;2026-11-13T06:53:20.000Z;ecdsa-plain-SHA256;unixTime;ZZxwQhSr73fn2m+XzGKavYaMbT3+IZ0JT5QK2JgYY/CV5ZTo4RL9hfJAJ4NF02PvkDQkY9e+USUH39UuqOhEHw==;BE46T7QBOkFER5Mm3Q/YqRtCDI+dS5FJh8LrQ38MpSNTdwmP/N3ZHtKMQqvNCEoQOSjcnNVwXu+m8HyY0SdD8e0=",
"AdditionalFields": {
"QrCodeDataString": "V0;00345-00340;Kassenbeleg-V1;Beleg^899.90_0.00_0.00_0.00_0.00^899.90:Bar;1;9;2026-11-13T06:52:41.000Z;2026-11-13T06:53:20.000Z;ecdsa-plain-SHA256;unixTime;ZZxwQhSr73fn2m+XzGKavYaMbT3+IZ0JT5QK2JgYY/CV5ZTo4RL9hfJAJ4NF02PvkDQkY9e+USUH39UuqOhEHw==;BE46T7QBOkFER5Mm3Q/YqRtCDI+dS5FJh8LrQ38MpSNTdwmP/N3ZHtKMQqvNCEoQOSjcnNVwXu+m8HyY0SdD8e0=",
"TransactionStartTime": 1795079983,
"TransactionEndTime": 1795079983,
"ProcessData": "Beleg^899.90_0.00_0.00_0.00_0.00^899.90:Bar",
"ProcessType": "Kassenbeleg-V1",
"TseSerial": "941a7ca5395caba8c5672e8f9910d1c5620b51aa9ac2c16063e0b0560ff5ea3d",
"TseTimeFormat": "unixTime",
"TseHashAlgorithm": "ecdsa-plain-SHA256",
"TsePublicKey": "BE46T7QBOkFER5Mm3Q/YqRtCDI+dS5FJh8LrQ38MpSNTdwmP/N3ZHtKMQqvNCEoQOSjcnNVwXu+m8HyY0SdD8e0=",
"TseSignatureCounter": 578,
"TseCertificate": "-----BEGIN CERTIFICATE----- \nMIIBszCCAVmgAwIBAgIUJ8x7k9L2mN4pQ6rS8tU0vW2xY4zA6bC8dE0fG2hI4jKw \nCgYIKoZIzj0EAwIwEDEOMAwGA1UEAwwFdGVzdDAeFw0yNjAxMDEwMDAwMDBaFw0y \nNzAxMDEwMDAwMDBaMBAxDjAMBgNVBAMMBXRlc3QwWTATBgcqhkjOPQIBBggqhkjO \nPQMBBwNCAAQu/XH7f/zEnaT0viY3mlDqtLt1T7Vb3FjTMjFtIbd4T94QjlmUpLU3 \nO7tc/t/8xJ2k9L4mN5pQ6rS7tU8vW9xY0zA1bC2dE3fG4hI5jK6lM7nO8pQ9rS0t \nU1vW2xY3zA4bC5dE6fG7hKNCMEAwHQYDVR0OBBYEFJ8x7k9L2mN4pQ6rS8tU0vW2 \nxY4zMB8GA1UdIwQYMBaAFJ8x7k9L2mN4pQ6rS8tU0vW2xY4zMA8GA1UdEwEB/wQF \nMAMBAf8wCgYIKoZIzj0EAwIDSAAwRQIhAJ8x7k9L2mN4pQ6rS8tU0vW2xY4zA6bC \n8dE0fG2hI4jKAiEA7v1x+3/8xJ2k9L4mN5pQ6rS7tU8vW9xY0zA1bC2dE3fG4hI= \n-----END CERTIFICATE-----",
"FiscalDocumentRevision": 1
}Alguns dos dados necessários devem ser obtidos a partir do TSE utilizado para assinar a transação.
Informações na coluna «Tipo»:
- M ... obrigatório («mandatório»)
- M* ... obrigatório em determinados países ou sob determinadas condições
- R ... recomendado («recomendado»)
- O ... opcional
| Elemento | Tipo |
Descrição | ||
| fiscalResponse | M |
Objeto que contém informações sobre o TSE | ||
| fiscalCountry | M |
Para a geração do DSFinV-K, deve ser especificado «[0] = Alemanha» | ||
| fiscalDocumentNumber | M |
O número atribuído pela TSE ao documento específico | ||
| fiscalDocumentStartTime | M |
Hora de início do processo gerada pelo TSE no formato de hora UNIX | ||
| Assinatura | M |
Assinatura fornecida pelo TSE para a transação específica | ||
| cashRegisterId | M |
ID único do sistema de caixa registadora | ||
| QrCode | M |
String de dados do código QR da transação | ||
| AdditionalFields | M |
|||
| QrCodeDataString | M |
String de dados do código QR da transação | ||
| Hora de início da transação | M |
Hora de início da transação | ||
| Hora de fim da transação | M |
Hora de fim da transação | ||
| ProcessData | M |
Dados do processo da transação (<tipo de transação>^<valores do volume de negócios bruto>^<pagamento>) | ||
| ProcessType | M |
Tipo de processamento da transação (por exemplo, Kassenbeleg-V1) | ||
| TseSerial | M |
Número de série do TSE utilizado para assinar a transação (TSE_SERIAL) | ||
| TseTimeFormat | M |
Formato de hora do TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Algoritmo de assinatura utilizado pelo TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Chave pública do certificado do TSE (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Contador de assinaturas (total de assinaturas) do TSE utilizado para assinar a transação | ||
| TseCertificate | M |
Certificado do TSE | ||
| fiscalDocumentRevision | M |
Contador de assinaturas da transação na operação «FinishTransaction» | ||
Este artigo foi traduzido automaticamente.
Comentários
0 comentários
iniciar sessão para comentar.