A RetailForce Vat Compliance interfész ezen funkciója lehetővé teszi a DSFinV-K adatok generálását már adóügyi hitelesítésen átesett nyers adatokból.
A németországi RetailForce adóügyi megfelelési megvalósítással ellentétben ebben az esetben a feljebb lévő pénztárgép-rendszer olyan adatokat továbbít, amelyeket már egy TSE (hitelesített műszaki biztonsági eszköz / műszaki biztonsági rendszer) biztosított. Ez a funkció nem végez további adatfeldolgozást (aláírást) TSE-n keresztül, hanem csupán a megadott adatokat konvertálja a hivatalos DSFinV-K / Taxonomy formátumba.
Adatátvitel
Az adatokat az upstream rendszer a kiterjesztett RetailForce DOM (Document Object Model) formátumban, JSON formátumban szolgáltatja. Ennek általános leírása a linkelt cikkben található.
Az adatok a VAT Compliance API POST /v1.0/documents végpontjára kerülnek továbbításra, amely a https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui URL-en érhető el.
TSE-adatbővítés
Ahhoz, hogy a RetailForce system az adatokat DSFinV-K formátumba konvertálhassa, az upstream rendszerből érkező JSON-kérésnek tartalmaznia kell a TSE-adatokat. A fiskalizációs implementáció használata esetén ezeket az adatokat a RetailForce system az úgynevezett „fiscalResponse” keretében visszaküldi az upstream rendszernek.
A szokásos dokumentuminformációk mellett a DSFinV-K generálásához szükséges payload-nak a következő tulajdonságokat kell tartalmaznia.
Példa:
"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
}A szükséges adatok egy részét a tranzakció aláírásához használt TSE-ből kell lekérdezni.
A „Type” oszlopban szereplő információk:
- M ... kötelező („mandatory”)
- M* ... bizonyos országokban vagy bizonyos feltételek mellett kötelező
- R ... ajánlott („ajánlott”)
- O ... opcionális
| Elem | Típus |
Leírás | ||
| fiscalResponse | M |
A TSE-adatokat tartalmazó objektum | ||
| fiscalCountry | M |
A DSFinV-K generálásához meg kell adni a „[0] = Németország” értéket | ||
| FiscalDocumentNumber | M |
A TSE által az adott dokumentumhoz rendelt szám | ||
| fiscalDocumentStartTime | M |
A TSE által generált folyamat kezdési ideje UNIX időformátumban | ||
| Aláírás | M |
A TSE által az adott tranzakcióhoz biztosított aláírás | ||
| CashRegisterId | M |
A pénztárgép-rendszer ID-ja | ||
| QrCode | M |
The string of the transaction QR-kódja | ||
| AdditionalFields | M |
|||
| QrCodeDataString | M |
A tranzakció QR-kód stringje | ||
| Tranzakció kezdési ideje | M |
A tranzakció kezdési ideje | ||
| TransactionEndTime | M |
A tranzakció befejezési ideje | ||
| ProcessData | M |
A tranzakció feldolgozási adatai (<tranzakciótípus>^<bruttó forgalmi értékek>^<fizetés>) | ||
| ProcessType | M |
A tranzakció feldolgozási típusa (pl. Kassenbeleg-V1) | ||
| TseSerial | M |
A tranzakció aláírásához használt TSE sorozatszáma (TSE_SERIAL) | ||
| TseTimeFormat | M |
A TSE időformátuma (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
A TSE által használt aláírási algoritmus (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
A TSE tanúsítványának nyilvános kulcsa (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
A tranzakció aláírásához használt TSE aláírási számlálója (összes aláírás) | ||
| TseCertificate | M |
TSE tanúsítványa | ||
| fiscalDocumentRevision | M |
A tranzakció aláírási számlálója a FinishTransaction műveletnél | ||
Ezt a cikket automatikusan lefordították.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.