Diese Funktion der RetailForce VAT Compliance Schnittstelle ermöglicht die Erzeugung von DSFinV-K Daten aus bereits fiskalisierten Rohdaten.
Im Unterschied zur RetailForce Fiskalisierungs-Implementierung für Deutschland, übergibt in diesem Fall das Kassensystem Daten, welche bereits durch eine TSE abgesichert wurden. Diese Funktion führt keine weitere Absicherung (Signierung) über eine TSE durch, sondern konvertiert lediglich die angelieferten Daten in das offizielle DSFinV-K / Taxonomy Format.
Datenbereitstellung
Die Bereitstellung der Daten durch das Kassensystem erfolgt im erweiterten RetailForce-Dokumentenmodell (DOM – Document Object Model) im JSON-Format bereitgestellt. Eine allgemeine Beschreibung hierzu finden Sie im verlinkten Artikel.
Die Daten werden an den Endpunkt POST /v1.0/documents der Vat Compliance API übermittelt, der über die URL https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui erreichbar ist.
Erweiterung TSE-Daten
Damit das RetailForce-System die Daten in das DSFinV-K-Format konvertieren kann, muss die JSON-Anfrage aus dem Vorsystem die TSE-Daten enthalten. Bei Verwendung der Fiskalisierungsimplementierung würden diese Daten vom RetailForce-System im Rahmen der sogenannten "fiscalResponse" an das Vorsystem zurückgegeben.
Neben den regulären Belegdaten muss der Payload für die DSFinV-K-Generierung die folgenden Eigenschaften enthalten.
Beispiel:
"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
}Einige der erforderlichen Daten müssen von der TSE abgefragt werden, die zur Signierung der Transaktion verwendet wurde.
Informationen in der Spalte „Type“:
- M … erforderlich („mandatory“)
- M* … in bestimmten Ländern oder unter bestimmten Bedingungen erforderlich
- R … empfohlen („empfohlen“)
- O … optional
| Element | Typ |
Beschreibung | ||
| fiscalResponse | M |
Objekt, welches TSE-Informationen enthält | ||
| fiscalCountry | M |
Für die DSFinV-K Generierung muss "[0] = Germany" angegeben werden | ||
| fiscalDocumentNumber | M |
Die von der TSE dem jeweiligen Beleg zugewiesene Nummer | ||
| fiscalDocumentStartTime | M |
Von der TSE generierte Startzeit des Vorgangs im UNIX-Zeitformat | ||
| Signature | M |
Von der TSE für die jeweilige Transaktion bereitgestellte Signatur | ||
| CashRegisterId | M |
Eindeutige ID des Kassensystems | ||
| QrCode | M |
QR-Code-String der Transaktion | ||
| AdditionalFields | M |
|||
| QrCodeDataString | M |
QR-Code-String der Transaktion | ||
TransactionStartTime |
M |
Startzeit der Transaktion | ||
| TransactionEndTime | M |
Endzeit der Transaktion | ||
| ProcessData | M |
Prozessdaten der Transaktion (<transaktionsart>^<bruttoumsatzwerte>^<zahlung>)</zahlung></bruttoumsatzwerte></transaktionsart> | ||
| ProcessType | M |
Prozesstyp der Transaktion (z.B. Kassenbeleg-V1) | ||
| TseSerial | M |
Seriennummer der TSE, die zur Signierung der Transaktion verwendet wurde (TSE_SERIAL) | ||
| TseTimeFormat | M |
Zeitformat der TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Von der TSE verwendeter Signaturalgorithmus (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Öffentlicher Schlüssel des Zertifikats der TSE (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Signaturzähler (Gesamtzahl der Signaturen) der TSE, die zum Signieren der Transaktion verwendet wurde | ||
| TseCertificate | M |
Zertifikat der TSE | ||
| fiscalDocumentRevision | M |
Signaturzähler der Transaktion bei der Operation „FinishTransaction“ | ||
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.