Αυτή η λειτουργία της διεπαφής συμμόρφωσης με τον Vat του RetailForce επιτρέπει τη δημιουργία δεδομένων DSFinV-K από ακατέργαστα δεδομένα που έχουν ήδη υποβληθεί σε φορολογική επεξεργασία.
Σε αντίθεση με την εφαρμογή φορολογικής επικύρωσης του RetailForce για τη Γερμανία, στην περίπτωση αυτή το ανάντη σύστημα ταμειακής μηχανής μεταφέρει δεδομένα που έχουν ήδη εξασφαλιστεί μέσω TSE (πιστοποιημένη Τεχνική Συσκευή Ασφαλείας / Τεχνικό Σύστημα Ασφαλείας). Η λειτουργία αυτή δεν πραγματοποιεί περαιτέρω επεξεργασία των δεδομένων (υπογραφή) μέσω TSE, αλλά απλώς μετατρέπει τα παρεχόμενα δεδομένα στην επίσημη μορφή DSFinV-K / Ταξινομία.
Παροχή δεδομένων
Τα δεδομένα παρέχονται από το ανάντη σύστημα στο εκτεταμένο μοντέλο εγγράφων RetailForce (DOM – Document Object Model) σε μορφή JSON. Μια γενική περιγραφή αυτού μπορεί να βρεθεί στο άρθρο που παρατίθεται στον σύνδεσμο.
Τα δεδομένα μεταδίδονται στο τελικό σημείο POST /v1.0/documents του API Vat Compliance, στο οποίο μπορείτε να έχετε πρόσβαση μέσω της διεύθυνσης URL https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
Επέκταση δεδομένων TSE
Προκειμένου το σύστημα RetailForce να μετατρέψει τα δεδομένα σε μορφή DSFinV-K, το αίτημα JSON από το ανάντη σύστημα πρέπει να περιέχει τα δεδομένα TSE. Εάν χρησιμοποιείται η εφαρμογή φορολογικής καταγραφής, τα δεδομένα αυτά θα επιστρέφονται από το σύστημα RetailForce στο ανάντη σύστημα μέσω της λεγόμενης «fiscalResponse».
Εκτός από τις συνήθεις πληροφορίες του εγγράφου, το payload για τη δημιουργία του DSFinV-K πρέπει να περιλαμβάνει τις ακόλουθες ιδιότητες.
Παράδειγμα:
"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
}Ορισμένα από τα απαιτούμενα δεδομένα πρέπει να ανακτηθούν από το TSE που χρησιμοποιήθηκε για την υπογραφή της συναλλαγής.
Πληροφορίες στη στήλη «Type»:
- M ... απαιτείται («υποχρεωτικό»)
- M* ... υποχρεωτικό σε ορισμένες χώρες ή υπό ορισμένες προϋποθέσεις
- R ... συνιστάται («recommended»)
- O ... προαιρετικό
| Στοιχείο | Τύπος |
Περιγραφή | ||
| fiscalResponse | M |
Αντικείμενο που περιέχει πληροφορίες TSE | ||
| fiscalCountry | M |
Για τη δημιουργία DSFinV-K πρέπει να καθοριστεί «[0] = Γερμανία» | ||
| fiscalDocumentNumber | M |
Ο αριθμός που έχει αποδοθεί από το TSE στο συγκεκριμένο έγγραφο | ||
| fiscalDocumentStartTime | M |
Ώρα έναρξης της διαδικασίας που δημιουργήθηκε από το TSE σε μορφή ώρας UNIX | ||
| Υπογραφή | M |
Υπογραφή που παρέχεται από το TSE για τη συγκεκριμένη συναλλαγή | ||
| cashRegisterId | M |
Μοναδικό ID του συστήματος ταμειακής μηχανής | ||
| QrCode | M |
String of QR-Code data for the transaction | ||
| AdditionalFields | M |
|||
| QrCodeDataString | M |
String of QR-Code data for the transaction | ||
| Ώρα έναρξης συναλλαγής | M |
Ώρα έναρξης της συναλλαγής | ||
| TransactionEndTime | M |
Ώρα λήξης της συναλλαγής | ||
| ProcessData | M |
Δεδομένα επεξεργασίας της συναλλαγής (<τύπος συναλλαγής>^<τιμές ακαθάριστου κύκλου εργασιών>^<πληρωμή>) | ||
| ProcessType | M |
Τύπος επεξεργασίας της συναλλαγής (π.χ. Kassenbeleg-V1) | ||
| TseSerial | M |
Αύξων αριθμός του TSE που χρησιμοποιήθηκε για την υπογραφή της συναλλαγής (TSE_SERIAL) | ||
| TseTimeFormat | M |
Μορφή ώρας του TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Αλγόριθμος υπογραφής που χρησιμοποιείται από το TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Δημόσιο κλειδί του πιστοποιητικού του TSE (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Μετρητής υπογραφών (συνολικός αριθμός υπογραφών) του TSE που χρησιμοποιήθηκε για την υπογραφή της συναλλαγής | ||
| TseCertificate | M |
Πιστοποιητικό του TSE | ||
| FiscalDocumentRevision | M |
Μετρητής υπογραφών της συναλλαγής κατά τη λειτουργία FinishTransaction | ||
Αυτό το άρθρο μεταφράστηκε αυτόματα.
Σχόλια
0 σχόλια
Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.