Esta función de la interfaz de cumplimiento del IVA de RetailForce permite la generación de datos DSFinV-K a partir de datos brutos que ya han sido fiscalizados.
A diferencia de la implementación de fiscalización de RetailForce para Alemania, en este caso el sistema de caja registradora anterior transfiere datos que ya han sido protegidos mediante un TSE (dispositivo técnico de seguridad certificado / sistema técnico de seguridad). Esta función no lleva a cabo ningún procesamiento adicional de los datos (firmado) a través de un TSE, sino que se limita a convertir los datos suministrados al formato oficial DSFinV-K / Taxonomía.
Suministro de datos
El sistema anterior facilita los datos en el RetailForce DOM (Modelo de Objetos de Documento) en formato JSON. En el artículo enlazado se puede encontrar una descripción general al respecto.
Los datos se transmiten al punto final POST /v1.0/documents de la API de cumplimiento del Vat, accesible a través de la URL https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
Extensión de datos TSE
Para que el RetailForce system pueda convertir los datos al formato DSFinV-K, la solicitud JSON procedente del sistema de origen debe contener los datos TSE. Si se utiliza la implementación de fiscalización, el RetailForce system devolvería estos datos al sistema de origen en lo que se conoce como «fiscalResponse».
Además de la información habitual del documento, el payload para la generación de DSFinV-K debe incluir las siguientes propiedades.
Ejemplo:
"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
}Algunos de los datos requeridos deben consultarse en el TSE utilizado para firmar la transacción.
Información de la columna «Tipo»:
- M … obligatorio («mandatory»)
- M* ... obligatorio en determinados países o bajo ciertas condiciones
- R ... recomendado («recomendado»)
- O ... opcional
| Elemento | Tipo |
Descripción | ||
| fiscalResponse | M |
Objeto que contiene información sobre el TSE | ||
| fiscalCountry | M |
Para la generación de DSFinV-K, debe especificarse «[0] = Alemania» | ||
| fiscalDocumentNumber | M |
El número asignado por la TSE al documento específico | ||
| fiscalDocumentStartTime | M |
Hora de inicio del proceso generada por el TSE en formato de tiempo UNIX | ||
| Firma | M |
Firma proporcionada por el TSE para la transacción específica | ||
| cashRegisterId | M |
ID único del sistema de caja registradora | ||
| QrCode | M |
Cadena de datos del código QR de la transacción | ||
| AdditionalFields | M |
|||
| CadenaDeDatosDelCódigoQR | M |
String de datos del código QR de la transacción | ||
| Hora de inicio de la transacción | M |
Hora de inicio de la transacción | ||
| Hora de finalización de la transacción | M |
Hora de finalización de la transacción | ||
| Datos del proceso | M |
Datos del proceso de la transacción (<tipo>^<valores>^<pago>)</pago></valores></tipo> | ||
| Tipo de proceso | M |
Tipo de proceso de la transacción (p. ej., Kassenbeleg-V1) | ||
| TseSerial | M |
Número de serie del TSE utilizado para firmar la transacción (TSE_SERIAL) | ||
| TseTimeFormat | M |
Formato de hora del TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Algoritmo de firma utilizado por el TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Clave pública del certificado del TSE (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Contador de firmas (total de firmas) del TSE utilizado para firmar la transacción | ||
| TseCertificate | M |
Certificado del TSE | ||
| fiscalDocumentRevision | M |
Contador de firmas de la transacción en la operación «FinishTransaction» | ||
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.