Această funcție a interfeței RetailForce Vat Compliance permite generarea datelor DSFinV-K din datele brute care au fost deja fiscalizate.
Spre deosebire de implementarea fiscalizării RetailForce pentru Germania, în acest caz sistemul de casă de marcat din amonte transferă date care au fost deja securizate printr-un TSE (dispozitiv tehnic de securitate certificat / sistem tehnic de securitate). Această funcție nu efectuează nicio prelucrare suplimentară a datelor (semnare) prin intermediul unui TSE, ci doar convertește datele furnizate în formatul oficial DSFinV-K / Taxonomie.
Furnizarea datelor
Datele sunt furnizate de sistemul din amonte în modelul extins de documente RetailForce (RetailForce DOM – Document Object Model) în format JSON. O descriere generală a acestuia poate fi găsită în articolul la care se face referire.
Datele sunt transmise către punctul final POST /v1.0/documents al API-ului VAT Compliance, accesibil prin URL-ul https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
Extensia de date TSE
Pentru ca sistemul RetailForce să poată converti datele în formatul DSFinV-K, solicitarea JSON din partea sistemului din amonte trebuie să conțină datele TSE. În cazul utilizării implementării de fiscalizare, aceste date ar fi returnate de sistemul RetailForce către sistemul din amonte în cadrul așa-numitului „fiscalResponse”.
Pe lângă informațiile obișnuite despre document, payload-ul pentru generarea DSFinV-K trebuie să includă următoarele proprietăți.
Exemplu:
"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
}O parte din datele necesare trebuie interogate din TSE-ul utilizat pentru semnarea tranzacției.
Informații din coloana „Tip”:
- M ... obligatoriu („mandatory”)
- M* ... obligatoriu în anumite țări sau în anumite condiții
- R ... recomandat („recomandat”)
- O ... opțional
| Element | Tip |
Descriere | ||
| fiscalResponse | M |
Obiect care conține informații TSE | ||
| FiscalCountry | M |
Pentru generarea DSFinV-K trebuie specificat „[0] = Germania” | ||
| fiscalDocumentNumber | M |
Numărul atribuit de TSE documentului respectiv | ||
| fiscalDocumentStartTime | M |
Ora de începere a procesului generată de TSE în formatul de timp UNIX | ||
| Semnătură | M |
Semnătura furnizată de TSE pentru tranzacția specifică | ||
| cashRegisterId | M |
ID unic al sistemului de casă de marcat | ||
| QrCode | M |
String-ul de date al codului QR al tranzacției | ||
| AdditionalFields | M |
|||
| Șirul de date al codului QR | M |
String-ul de date al codului QR al tranzacției | ||
| Ora de începere a tranzacției | M |
Ora de începere a tranzacției | ||
| Ora de încheiere a tranzacției | M |
Ora de încheiere a tranzacției | ||
| ProcessData | M |
Date privind procesul tranzacției (<tipul tranzacției>^<valorile cifrei de afaceri brute>^<plata>) | ||
| ProcessType | M |
Tipul de proces al tranzacției (de ex. Kassenbeleg-V1) | ||
| TseSerial | M |
Numărul de serie al TSE utilizat pentru semnarea tranzacției (TSE_SERIAL) | ||
| TseTimeFormat | M |
Formatul de timp al TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Algoritmul de semnătură utilizat de TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Cheia publică a certificatului TSE (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Contor de semnături (numărul total de semnături) al TSE utilizat pentru semnarea tranzacției | ||
| TseCertificate | M |
Certificatul TSE-ului | ||
| FiscalDocumentRevision | M |
Contorul de semnături al tranzacției la operațiunea FinishTransaction | ||
Acest articol a fost tradus automat.
Comentarii
0 comentarii
Vă rugăm să vă autentificați pentru a lăsa un comentariu.