Questa funzione dell’interfaccia RetailForce Vat Compliance consente la generazione di dati DSFinV-K a partire da dati grezzi già fiscalizzati.
A differenza dell’implementazione della fiscalizzazione di RetailForce per la Germania, in questo caso il sistema di registrazione delle vendite a monte trasferisce dati già protetti da un TSE (Dispositivo di Sicurezza Tecnico certificato / Sistema di Sicurezza Tecnico). Questa funzione non esegue alcuna ulteriore elaborazione dei dati (firmatura) tramite un TSE, ma si limita a convertire i dati forniti nel formato ufficiale DSFinV-K / Taxonomy.
Fornitura dei dati
I dati vengono forniti dal sistema a monte nel modello di documento esteso di RetailForce (DOM – Document Object Model) in formato JSON. Una descrizione generale di tale modello è disponibile nell’articolo collegato.
I dati vengono trasmessi all’endpoint POST /v1.0/documents dell’API Vat Compliance, accessibile tramite l’URL https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
Estensione dei dati TSE
Affinché il RetailForce system possa convertire i dati nel formato DSFinV-K, la richiesta JSON proveniente dal sistema a monte deve contenere i dati TSE. Qualora venga utilizzata l’implementazione della fiscalizzazione, tali dati verrebbero restituiti dal RetailForce system al sistema a monte tramite la cosiddetta «fiscalResponse».
Oltre alle normali informazioni relative al documento, il payload per la generazione del formato DSFinV-K deve includere le seguenti proprietà.
Esempio:
"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
}Alcuni dei dati richiesti devono essere ricavati dal TSE utilizzato per firmare la transazione.
Informazioni nella colonna «Tipo»:
- M ... obbligatorio («mandatory»)
- M* ... obbligatorio in determinati paesi o in determinate condizioni
- R ... raccomandato (“raccomandato”)
- O ... facoltativo
| Elemento | Tipo |
Descrizione | ||
| fiscalResponse | M |
Oggetto contenente informazioni relative al TSE | ||
| fiscalCountry | M |
Per la generazione del DSFinV-K è necessario specificare "[0] = Germania" | ||
| fiscalDocumentNumber | M |
Il numero assegnato dalla TSE al documento specifico | ||
| fiscalDocumentStartTime | M |
Ora di inizio del processo generata dal TSE in formato UNIX | ||
| Firma | M |
Firma fornita dal TSE per la transazione specifica | ||
| cashRegisterId | M |
ID univoco del sistema di cassa | ||
| QrCode | M |
Stringa di dati del codice QR relativa alla transazione | ||
| AdditionalFields | M |
|||
| Stringa di dati del codice QR | M |
Stringa di dati del codice QR della transazione | ||
| Ora di inizio della transazione | M |
Ora di inizio della transazione | ||
| Ora di fine della transazione | M |
Ora di fine della transazione | ||
| ProcessData | M |
Dati di elaborazione della transazione (<tipo>^<valori>^<pagamento>)</pagamento></valori></tipo> | ||
| Tipo di processo | M |
Tipo di elaborazione della transazione (ad es. Kassenbeleg-V1) | ||
| TseSerial | M |
Numero di serie del TSE utilizzato per firmare la transazione (TSE_SERIAL) | ||
| TseTimeFormat | M |
Formato temporale del TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Algoritmo di firma utilizzato dal TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Chiave pubblica del certificato del TSE (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Contatore delle firme (numero totale di firme) del TSE utilizzato per firmare la transazione | ||
| TseCertificate | M |
Certificato del TSE | ||
| FiscalDocumentRevision | M |
Contatore delle firme della transazione nell’operazione FinishTransaction | ||
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.