Με τον τύπο εγγράφου AuditLog, είναι πλέον δυνατή η καταγραφή μη συναλλακτικών συμβάντων (π.χ. συνδέσεις χρηστών ή άνοιγμα του συρταριού μετρητών) και η υπογραφή τους μέσω του τυπικού τερματικού σημείου, ακριβώς όπως και στις κανονικές αποδείξεις.
1. Νέος τύπος εγγράφου (documentType)
Η DocumentType enum περιέχει πλέον την ακόλουθη επιλογή για την καταγραφή ελεγχόμενων συμβάντων:
- AuditLog (1002)
2. Νέες ιδιότητες στο μοντέλο εγγράφου
Όταν ορίζετε το documentType σε AuditLog, πρέπει να χρησιμοποιηθούν οι ακόλουθες νέες ιδιότητες στο Document αντικείμενο:
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
| AuditLogEntryType | enum LogEntryType | (Υποχρεωτικό) Ορίζει τον τύπο του συμβάντος ελέγχου. Μια πλήρης λίστα βρίσκεται στην επόμενη ενότητα. |
| amount | decimal; | (Προαιρετικό) Μια χρηματική αξία που σχετίζεται με την καταχώριση καταγραφής, π.χ. το ποσό μιας απόκλισης στο ταμείο. |
| αναγνωριστικό | string | (Προαιρετικό) Μια επιπλέον string για αναγνώριση ή για περισσότερο πλαίσιο, π.χ. για να υποδείξει ποιο συρτάρι μετρητών έχει ανοιχτεί. |
3. Διαθέσιμα AuditLogEntryTypes
Συμβάντα εγγράφου
- documentReprintOther
- documentSuspend
- documentResume
- ενεργοποίηση εκπαιδευτικής λειτουργίας εγγράφου
- εγγράφου Λειτουργία Εκπαίδευσης Απενεργοποιημένη
- τύπος εγγράφου Πωλήσεις
- τύπος εγγράφου Επιστροφή
- τύπος εγγράφου Προτιμολόγιο
- τύπος εγγράφου παράδοση
- τύπος εγγράφου Εκπαίδευση
- τύπος εγγράφου Ανάληψη
- τύπος εγγράφου πληρωμής
- τύπος εγγράφου: κατάθεση
- τύπος εγγράφου αρχικό υπόλοιπο
- τύπος εγγράφου μηδενική απόδειξη
- τύπος εγγράφου τιμολόγιο
- τύπος εγγράφου Άλλο
- τύπος εγγράφου ακύρωση
- τύπος εγγράφου Μακροπρόθεσμη παραγγελία
- τύπος εγγράφου Επιβεβαίωση πληρωμής
- τύπος εγγράφου Παραγγελία πελάτη
- τύπος εγγράφου Απογραφή
- τύπος εγγράφου Αγορά
- επαναεκτύπωση μακροπρόθεσμης παραγγελίας
- επανεκτύπωση-επιβεβαίωσης-πληρωμής
- εκτύπωση εγγράφου απόδειξης
- επαναεκτύπωση τιμολογίου
- αντίγραφο απόδειξης
- έγγραφο Αντίγραφο τιμολογίου
- έγγραφο Ακύρωση μακροπρόθεσμης παραγγελίας
- εντοπισμός μη εκτυπωμένης μακροπρόθεσμης παραγγελίας
- έγγραφοΑκύρωσηΓραμμής
- έγγραφοΑκύρωσηΓραμμής
- έγγραφοΑκύρωσηΕγγράφου
- ενημέρωση πληρωμής εγγράφου
- ενημέρωση μακροπρόθεσμης παραγγελίας εγγράφου
- ενημέρωση γραμμής εγγράφου
- ενημέρωση πίνακα εγγράφου
Συμβάντα υλικού και χρήστη
- άνοιγμα συρταριού
- κλείσιμο συρταριού
- printerUnavailable
- printerAvailable
- userLogin
- αποσύνδεση χρήστη
- αλλαγή δικαιωμάτων χρήστη
Συμβάντα εφαρμογών και συστήματος
- έναρξη εφαρμογής
- τερματισμός εφαρμογής
- ενημέρωση εφαρμογής
- εφαρμογήΕνημέρωσηΜικρή
- ενημέρωση-μεσαίου-λογισμικού-εφαρμογής
- ενεργοποίηση κατάστασης έκτακτης ανάγκης εφαρμογής
- απενεργοποίηση κατάστασης έκτακτης ανάγκης εφαρμογής
- εφαρμογήΑρχικοποίηση
- εφαρμογήΠροσθήκηΣταθμούΕργασίας
- εφαρμογή Διαγραφή σταθμού εργασίας
- applicationOfflineModeOn
- εφαρμογήΑπενεργοποίησηΛειτουργίαςΕκτόςΣύνδεσης
Συμβάντα κύριων δεδομένων και ακεραιότητας δεδομένων
- masterDataItemPriceChange
- αναζήτηση τιμής στοιχείου κύριων δεδομένων
- ενημέρωση εταιρείας στοιχείου κύριων δεδομένων
- μεταβίβαση ιδιοκτησίας
- dataIntegrityBackupDatabase
- Επαναφορά ακεραιότητας δεδομένων βάσης δεδομένων
- εξαγνισμός βάσης δεδομένων για ακεραιότητα δεδομένων
- εξαγνισμός αρχείου καταγραφής συμβάντων ακεραιότητας δεδομένων
- ακεραιότητα δεδομένων ανάκτηση δεδομένων
- ακεραιότητα δεδομένων προώθηση δεδομένων
- Ολοκλήρωση ενοποίησης ακεραιότητας δεδομένων
- αποτυχία ακεραιότητας δεδομένων
- αλλαγή ακολουθίας δεδομένων
- αποτυχία ακολουθίας δεδομένων
- εισαγωγή δεδομένων από εξωτερική πηγή
- εξαγωγή δεδομένων λογιστικής
- εξαγωγή δεδομένων γενικού χαρακτήρα
Γεγονότα χρήσης και αναφορών
- ημέρα κλεισίματος οικονομικής περιόδου
- μήνας κλεισίματος της φορολογικής περιόδου
- έτος κλεισίματος της φορολογικής περιόδου
- ημέρα κλεισίματος οικονομικής έκθεσης
- fiscalReportUserReport
- λάθος-δημοσιονομικής-περιόδου-που-ελήφθη-από-τις-αρχές
- έτος αρχειοθέτησης οικονομικών στοιχείων
- ενδιάμεσο έτος αρχειοθέτησης
- εξαγωγή λογιστικού ημερολογίου
- κλειδί ενημέρωσης υπογραφής φορολογικού
- fiscalAudit
- μεταφορά αρχείου ελέγχου
Γενικά
- άλλα (γενικός τύπος για συμβάντα που δεν περιλαμβάνονται στη λίστα)
4. Αποστολή εγγράφου AuditLog
Τα έγγραφα AuditLog υποβάλλονται στο ίδιο τελικό σημείο με όλα τα άλλα έγγραφα συναλλαγών:
POST /api/v1/transactions/storeDocument
Παράδειγμα JSON payload
{
"ModelVersion": "1.6.1",
"UniqueClientId": "2a296a14-f644-4f3f-9ea2-d3f00a3b587c",
"UniqueCashRegisterId": "005-006",
"FiscalModuleVersion": "1.10.2.0",
"FiscalCountryModuleVersion": "1.0.21",
"SoftwareName": "x x x",
"AdditionalFields": {},
"AutomaticVatCalculation": 0,
"AuditLogEntryType": "userLogin",
"DocumentGuid": "a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5",
"DocumentId": "AUD-LOGIN-001",
"CreateDate": "2025-08-08T12:59:10+02:00",
"BookDate": "2025-08-08T12:59:10+02:00",
"DocumentNumber": "AUD-LOGIN-001",
"IsTraining": true,
"DocumentType": "[1002] = AuditLog",
"User": {
"Id": "Armir A",
"Caption": "Armir A"
},
"AllocationGroups": [],
"PositionCount": 0,
"FiscalDocumentNumber": 8,
"FiscalDocumentRevision": 1,
"FiscalDocumentStartTime": 1754657874,
"Positions": [],
"Payments": [],
"AdditionalHeader": [],
"AdditionalFooter": [],
"FiscalAdditionalFields": {}
}Παράδειγμα απόκρισης
Η απάντηση περιέχει δεδομένα φορολογικής καταγραφής που αφορούν τη συγκεκριμένη χώρα, όπως το παρακάτω παράδειγμα για τη Γερμανία, το οποίο περιλαμβάνει λεπτομέρειες σχετικά με τον TSE (Τεχνικός Εξοπλισμός Ασφαλείας).
{
"FiscalCountry": "[0] = Germany",
"FiscalisationDocumentNumber": 8,
"FiscalDocumentNumber": "8",
"FiscalDocumentStartTime": 1754657874,
"ProcessStartTime": 0,
"ErrorDescription": null,
"CashRegisterId": "005-006",
"Signature": "wn0cwKYhCes0dy4gEfjB7aAQF+iHXsyX3E6u9bBsJtJZTMtOoJ4IMDUYNJzZyykmZdrEMiT3YqtBvG7J/3sNzw==",
"UserMessage": null,
"PrintMessage": "***Test***",
"RequestTime": "2025-08-08T12:58:47.310674+00:00",
"RequestCompletionTime": "2025-08-08T12:58:47.6602076+00:00",
"QrCode": "V0;005-006;SonstigerVorgang;AVSonstige;8;78;2025-08-08T12:57:54.000Z;2025-08-08T12:58:46.000Z;ecdsa-plain-SHA256;unixTime;wn0cwKYhCes0dy4gEfjB7aAQF+iHXsyX3E6u9bBsJtJZTMtOoJ4IMDUYNJzZyykmZdrEMiT3YqtBvG7J/3sNzw==;BFG6opUQnbSdHq76J8py+zy5iw9zeCdwgRkhQJIkDKz38NrDiAiFvNwKf4NRRyzyRXGZB1vuFmqWJLr+gi6GKIg=",
"PrintingFields": {
"NOT IMPLEMENTED": "NOT IMPLEMENTED"
},
"AdditionalFields": {
"QrCodeDataString": "V0;005-006;SonstigerVorgang;AVSonstige;8;78;2025-08-08T12:57:54.000Z;2025-08-08T12:58:46.000Z;ecdsa-plain-SHA256;unixTime;wn0cwKYhCes0dy4gEfjB7aAQF+iHXsyX3E6u9bBsJtJZTMtOoJ4IMDUYNJzZyykmZdrEMiT3YqtBvG7J/3sNzw==;BFG6opUQnbSdHq76J8py+zy5iw9zeCdwgRkhQJIkDKz38NrDiAiFvNwKf4NRRyzyRXGZB1vuFmqWJLr+gi6GKIg=",
"TransactionStartTime": 1754657874,
"TransactionEndTime": 1754657926,
"ProcessData": "AVSonstige",
"ProcessType": "SonstigerVorgang",
"TseSerial": "2b56a7b994fdb3be51f973b311db0a4494d88dc2d63efdc8fb6c2f1f3df1b696",
"TseTimeFormat": "unixTime",
"TseHashAlgorithm": "ecdsa-plain-SHA256",
"TsePublicKey": "BFG6opUQnbSdHq76J8py+zy5iw9zeCdwgRkhQJIkDKz38NrDiAiFvNwKf4NRRyzyRXGZB1vuFmqWJLr+gi6GKIg=",
"TseSignatureCounter": 78,
"TseCertificate": "MIID0jCCA1mgAwIBAgIRAOxMaXsnzvjB/LzUZ7EN3ogwCgYIKoZIzj0EAwMwVTELMAkGA1UEBhMCQVQxFTATBgNVBAoTDGZpc2thbHkgR21iSDEjMCEGA1UEAxMaVEVTVC1GSVNLQUxZLVRTRS1TVUItQ0EtMDExCjAIBgNVBAUTATEwHhcNMjUwNjI3MDAwMjM0WhcNMzMwNjI3MjM1OTU5WjCB2TELMAkGA1UEBhMCQVQxFTATBgNVBAoTDGZpc2thbHkgR21iSDFOMEwGA1UEAwxFVEVTVC1CU0ktRFNaLUNDLTExNTNfQlNJLURTWi1DQy0xMTMwX0M0RjlFNkVDNkUxRTRENjg5NTlDNjFEREFDNjU0QTdDMUkwRwYDVQQFE0AyYjU2YTdiOTk0ZmRiM2JlNTFmOTczYjMxMWRiMGE0NDk0ZDg4ZGMyZDYzZWZkYzhmYjZjMmYxZjNkZjFiNjk2MRgwFgYDVQQuEw9CU0ktRFNaLUNDLTExNTMwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAARRuqKVEJ20nR6u+ifKcvs8uYsPc3gncIEZIUCSJAys9/Daw4gIhbzcCn+DUUcs8kVxmQdb7hZqliS6/oIuhiiIo4IBgzCCAX8wDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAU4lSqfYaZDlZy+rtN24iJKVDaxzYwRAYIKwYBBQUHAQEEODA2MDQGCCsGAQUFBzAChihodHRwczovL2thc3NlbnNpY2h2LXRlc3QtcGtpLmZpc2thbHkuY29tMF4GA1UdHwRXMFUwU6BRoE+GTWh0dHA6Ly9rYXNzZW5zaWNodi10ZXN0LXBraS5maXNrYWx5LmNvbS9jcmw/aXNzdWVyPVRFU1QtRklTS0FMWS1UU0UtU1VCLUNBLTAxMEcGA1UdEgRAMD6BEm9mZmljZUBmaXNrYWx5LmNvbYYoaHR0cHM6Ly9rYXNzZW5zaWNodi10ZXN0LXBraS5maXNrYWx5LmNvbTBPBgNVHSAESDBGMEQGCisGAQQBg7YgAQMwNjA0BggrBgEFBQcCARYoaHR0cHM6Ly9rYXNzZW5zaWNodi10ZXN0LXBraS5maXNrYWx5LmNvbTAKBggqhkjOPQQDAwNnADBkAjAanoJFOYfYD6PN8k2WfLLiskBHuGiYKkLrTJWlvwzLpMU+7UeZT85eizm5BLo6OWwCMBsv+mErzb9grV/kHJsu9tJcIqhWXJSdKabAc4J6mTtiCFMSUikJgwO9NTpTdd1KEg==",
"FiscalDocumentRevision": 2
}
}
Αυτό το άρθρο μεταφράστηκε αυτόματα.
Σχόλια
0 σχόλια
Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.