Ta funkcja interfejsu RetailForce Vat Compliance umożliwia generowanie danych DSFinV-K na podstawie surowych danych, które zostały już poddane fiskalizacji.
W odróżnieniu od implementacji fiskalizacji RetailForce dla Niemiec, w tym przypadku nadrzędny system kasowy przekazuje dane, które zostały już zabezpieczone za pomocą TSE (certyfikowanego technicznego urządzenia zabezpieczającego / technicznego systemu zabezpieczającego). Funkcja ta nie przeprowadza dalszego przetwarzania danych (podpisywania) za pośrednictwem TSE, a jedynie konwertuje dostarczone dane do oficjalnego formatu DSFinV-K / taksonomii.
Dostarczanie danych
Dane są dostarczane przez system nadrzędny w rozszerzonym modelu dokumentu RetailForce (DOM – Document Object Model) w formacie JSON. Ogólny opis tego rozwiązania można znaleźć w artykule, do którego prowadzi link.
Dane są przesyłane do punktu końcowego POST /v1.0/documents interfejsu API Vat Compliance, dostępnego pod adresem URL https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
Rozszerzenie danych TSE
Aby system RetailForce mógł przekonwertować dane do formatu DSFinV-K, żądanie JSON z systemu nadrzędnego musi zawierać dane TSE. W przypadku korzystania z implementacji fiskalizacji dane te są zwracane przez system RetailForce do systemu nadrzędnego w ramach tzw. „fiscalResponse”.
Oprócz standardowych informacji o dokumencie, payload służący do generowania formatu DSFinV-K musi zawierać następujące właściwości.
Przykład:
"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
}Niektóre z wymaganych danych należy pobrać z urządzenia TSE użytego do podpisania transakcji.
Informacje w kolumnie „Typ”:
- M … wymagane („obowiązkowe”)
- M* … wymagane w niektórych krajach lub pod pewnymi warunkami
- R … zalecane („zalecane”)
- O … opcjonalne
| Element | Typ |
Opis | ||
| fiscalResponse | M |
Obiekt zawierający informacje dotyczące TSE | ||
| FiscalCountry | M |
W celu wygenerowania pliku DSFinV-K należy podać wartość „[0] = Niemcy” | ||
| FiscalDocumentNumber | M |
Numer nadany przez TSE konkretnemu dokumentowi | ||
| fiscalDocumentStartTime | M |
Czas rozpoczęcia przetwarzania wygenerowany przez TSE w formacie czasu UNIX | ||
| Podpis | M |
Podpis dostarczony przez TSE dla konkretnej transakcji | ||
| cashRegisterId | M |
Unikalny ID systemu kasowego | ||
| QrCode | M |
String danych kodu QR dotyczący transakcji | ||
| AdditionalFields | M |
|||
| CiągDanychKoduQR | M |
String danych kodu QR transakcji | ||
| Czas rozpoczęcia transakcji | M |
Czas rozpoczęcia transakcji | ||
| Czas zakończenia transakcji | M |
Czas zakończenia transakcji | ||
| Dane procesu | M |
Dane dotyczące transakcji (<typ transakcji>^<wartości obrotu brutto>^<płatność>) | ||
| ProcessType | M |
Typ przetwarzania transakcji (np. Kassenbeleg-V1) | ||
| TseSerial | M |
Numer seryjny urządzenia TSE użytego do podpisania transakcji (TSE_SERIAL) | ||
| TseTimeFormat | M |
Format czasu modułu TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Algorytm podpisu stosowany przez TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Klucz publiczny certyfikatu TSE (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Licznik podpisów (łączna liczba podpisów) modułu TSE wykorzystanego do podpisania transakcji | ||
| TseCertificate | M |
Certyfikat TSE | ||
| fiscalDocumentRevision | M |
Licznik podpisów transakcji w operacji FinishTransaction | ||
Ten artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.