Táto funkcia rozhrania RetailForce Vat Compliance umožňuje generovanie údajov DSFinV-K zo surových údajov, ktoré už prešli fiskalizáciou.
Na rozdiel od implementácie fiskalizácie v RetailForce pre Nemecko v tomto prípade systém pokladníc na vyššej úrovni prenáša údaje, ktoré už boli zabezpečené prostredníctvom TSE (certifikované technické bezpečnostné zariadenie / technický bezpečnostný systém). Táto funkcia nevykonáva žiadne ďalšie spracovanie údajov (podpisovanie) prostredníctvom TSE, ale iba prevádza dodané údaje do oficiálneho formátu DSFinV-K / Taxonomy.
Poskytovanie údajov
Údaje poskytuje nadriadený systém v rozšírenom modeli dokumentov RetailForce (DOM – Document Object Model) vo formáte JSON. Všeobecný popis tohto modelu nájdete v článku, na ktorý odkazuje tento text.
Údaje sa prenášajú na koncový bod POST /v1.0/documents rozhrania API pre dodržiavanie predpisov o DPH, ktorý je dostupný cez URL https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
Rozšírenie údajov TSE
Aby systém RetailForce mohol previesť údaje do formátu DSFinV-K, musí žiadosť JSON z nadradeného systému obsahovať údaje TSE. Ak sa používa implementácia fiskalizácie, systém RetailForce by tieto údaje vrátil nadradenému systému v takzvanom „fiscalResponse“.
Okrem bežných informácií o doklade musí payload pre generovanie formátu DSFinV-K obsahovať nasledujúce vlastnosti.
Príklad:
"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
}Niektoré z požadovaných údajov je potrebné získať z TSE použitého na podpísanie transakcie.
Informácie v stĺpci „Type“:
- M ... povinné („mandatory“)
- M* ... povinné v určitých krajinách alebo za určitých podmienok
- R ... odporúčané („odporúčané“)
- O ... nepovinné
| Prvok | Typ |
Popis | ||
| fiscalResponse | M |
Objekt obsahujúci informácie o TSE | ||
| FiscalCountry | M |
Pre generovanie DSFinV-K je potrebné špecifikovať „[0] = Nemecko“ | ||
| fiscalDocumentNumber | M |
Číslo pridelené burzou TSE konkrétnemu dokumentu | ||
| fiscalDocumentStartTime | M |
Čas začiatku spracovania vygenerovaný TSE vo formáte času UNIX | ||
| Podpis | M |
Podpis poskytnutý TSE pre konkrétnu transakciu | ||
| cashRegisterId | M |
Jedinečné ID pokladničného systému | ||
| QrCode | M |
String údajov QR kódu transakcie | ||
| AdditionalFields | M |
|||
| QrCodeDataString | M |
String údajov QR kódu transakcie | ||
| Čas začiatku transakcie | M |
Čas začiatku transakcie | ||
| Čas ukončenia transakcie | M |
Čas ukončenia transakcie | ||
| ProcessData | M |
Údaje o procese transakcie (<typ transakcie>^<hodnoty hrubého obratu>^<platba>) | ||
| ProcessType | M |
Typ spracovania transakcie (napr. Kassenbeleg-V1) | ||
| TseSerial | M |
Sériové číslo TSE použitého na podpísanie transakcie (TSE_SERIAL) | ||
| TseTimeFormat | M |
Formát času TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Algoritmus podpisu používaný TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Verejný kľúč certifikátu TSE (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Počítadlo podpisov (celkový počet podpisov) modulu TSE použitého na podpísanie transakcie | ||
| TseCertificate | M |
Certifikát TSE | ||
| fiscalDocumentRevision | M |
Počítadlo podpisov transakcie pri operácii FinishTransaction | ||
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.