Denne funktion i RetailForce Vat-grænsefladen gør det muligt at generere DSFinV-K-data ud fra rådata, der allerede er fiskaliseret.
I modsætning til RetailForce-implementeringen af skattepligt i Tyskland overfører det opstrøms kassesystem i dette tilfælde data, der allerede er sikret via en TSE (certificeret teknisk sikkerhedsenhed / teknisk sikkerhedssystem). Denne funktion foretager ingen yderligere databehandling (signering) via en TSE, men konverterer blot de leverede data til det officielle DSFinV-K-/taksonomiformat.
Datalevering
Dataene leveres af det overordnede system i den udvidede RetailForce DOM (Document Object Model) i JSON-format. En generel beskrivelse heraf findes i den linkede artikel.
Dataene overføres til POST /v1.0/documents-endpointet i VAT Compliance API, som er tilgængeligt via URL'en https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
TSE-dataudvidelse
For at RetailForce systemet kan konvertere data til DSFinV-K-formatet, skal JSON-anmodningen fra det opstrøms system indeholde TSE-dataene. Hvis fiscaliseringsimplementeringen anvendes, returneres disse data af RetailForce systemet til det opstrøms system i det, der kaldes "fiscalResponse".
Ud over de almindelige dokumentoplysninger skal payloaden til generering af DSFinV-K indeholde følgende egenskaber.
Eksempel:
"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
}Nogle af de påkrævede data skal hentes fra den TSE, der blev brugt til at underskrive transaktionen.
Oplysninger i kolonnen "Type":
- M ... påkrævet ("obligatorisk")
- M* ... påkrævet i visse lande eller under visse betingelser
- R ... anbefalet ("anbefalet")
- O ... valgfrit
| Element | Type |
Beskrivelse | ||
| fiscalResponse | M |
Objekt, der indeholder TSE-oplysninger | ||
| fiscalCountry | M |
Ved generering af DSFinV-K skal "[0] = Tyskland" angives | ||
| FiscalDocumentNumber | M |
Det nummer, som TSE har tildelt det pågældende dokument | ||
| fiscalDocumentStartTime | M |
Processtarttid genereret af TSE i UNIX-tidsformat | ||
| Signatur | M |
Signatur leveret af TSE for den specifikke transaktion | ||
| CashRegisterId | M |
Unikt ID for kassesystemet | ||
| QrCode | M |
QR-kode-string for transaktionen | ||
| AdditionalFields | M |
|||
| QrCodeDataString | M |
QR-kode-string for transaktionen | ||
| Transaktionsstarttid | M |
Transaktionens starttidspunkt | ||
| Transaktionens sluttidspunkt | M |
Transaktionens sluttidspunkt | ||
| ProcessData | M |
Transaktionsdata (<transaktionstype>^<bruttoomsætningsværdier>^<betaling>) | ||
| ProcessType | M |
Transaktionens procestype (f.eks. Kassenbeleg-V1) | ||
| TseSerial | M |
Serienummer på den TSE, der blev brugt til at underskrive transaktionen (TSE_SERIAL) | ||
| TseTimeFormat | M |
Tidformat for TSE'en (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Signaturalgoritme, der anvendes af TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Offentlig nøgle til TSE's certifikat (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Signaturtæller (samlet antal signaturer) for TSE, der blev brugt til at underskrive transaktionen | ||
| TseCertificate | M |
Certifikat for TSE'en | ||
| fiscalDocumentRevision | M |
Signaturtæller for transaktionen ved FinishTransaction-Operation | ||
Denne artikel er oversat automatisk.
Kommentarer
0 kommentarer
Log ind for at kommentere.