This function of the RetailForce VAT Compliance interface enables the generation of DSFinV-K data from raw data that has already been fiscalised.
Unlike the RetailForce fiscalisation implementation for Germany, in this case the upstream cash register system transfers data that has already been secured by a TSE (certified Technical Security Device / Technical Security System). This function does not carry out any further processing of data (signing) via a TSE, but merely converts the supplied data into the official DSFinV-K / Taxonomy format.
Data Provision
The data is provided by the upstream system in the extended RetailForce Document Model (DOM – Document Object Model) in JSON format. A general description of this can be found in the linked article.
The data is transmitted to the POST /v1.0/documents endpoint of the VAT Compliance API, accessible via the URL https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
TSE Data Extension
In order for the RetailForce system to convert data into the DSFinV-K format, the JSON request from the upstream system must contain the TSE data. If the fiscalisation implementation is used, this data would be returned by the RetailForce system to the upstream system in what is known as the "fiscalResponse".
Besides the regular document information, the payload for DSFinV-K generation must include the following properties.
Example:
"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
}Some of the required data must be queried from the TSE used to sign the transaction.
Information in the "Type" column:
- M ... required ("mandatory")
- M* ... required in certain countries, or under certain conditions
- R ... recommended ("recommended")
- O ... optional
| Element | Type |
Description | ||
| fiscalResponse | M |
Object containing TSE information | ||
| FiscalCountry | M |
For DSFinV-K generation "[0] = Germany" must be specified | ||
| FiscalDocumentNumber | M |
The number assigned by the TSE to the specific document | ||
| FiscalDocumentStartTime | M |
Process start time generated by the TSE in UNIX time format | ||
| Signature | M |
Signature provided by the TSE for the specific transaction | ||
| CashRegisterId | M |
Unique ID of the cash register system | ||
| QrCode | M |
QR-Code data string of the transaction | ||
| AdditionalFields | M |
|||
| QrCodeDataString | M |
QR-Code data string of the transaction | ||
| TransactionStartTime | M |
Start time of the transaction | ||
| TransactionEndTime | M |
End time of the transaction | ||
| ProcessData | M |
Process data of transaction (<transaction type>^<gross turnover values>^<payment>) | ||
| ProcessType | M |
Process type of transaction (e.g. Kassenbeleg-V1) | ||
| TseSerial | M |
Serial number of the TSE used to sign the transaction (TSE_SERIAL) | ||
| TseTimeFormat | M |
Time format of the TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Signature algorithm used by the TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Public key of the TSE's certificate (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Signature Counter (total signatures) of the TSE used to sign the transaction | ||
| TseCertificate | M |
Certificate of the TSE | ||
| FiscalDocumentRevision | M |
Signature counter of the transaction at FinishTransaction-Operation | ||
Comments
0 comments
Please sign in to leave a comment.