With the AuditLog documentType, it is now possible to record non-tranzakciós events (e.g., user logins or opening the cash drawer) and sign them using the standard endpoint, just like traditional receipts.
1. Új dokumentumtípus (documentType)
Az DocumentType enum mostantól a következő opciót tartalmazza az ellenőrizhető események rögzítéséhez:
- AuditLog (1002)
2. Új tulajdonságok a dokumentummodellben
A documentType értéket AuditLogértékre állítja, a Document objektumban a következő új tulajdonságokat kell használni:
| Tulajdonság | Típus | Leírás |
|---|---|---|
| AuditLogEntryType | LogEntryType enum | (Kötelező) Meghatározza az audit esemény típusát. A teljes lista a következő szakaszban található. |
| összeg | decimal? | (Opcionális) A naplóbejegyzéshez társított pénzösszeg, pl. a pénztárgép-eltérés összege. |
| azonosító | string | (Opcionális) További string azonosításra vagy a kontextus kiegészítésére, pl. annak jelzésére, hogy melyik pénztárfiókot nyitották ki. |
3. Elérhető AuditLogEntryTypes
Dokumentum-események
- documentReprintOther
- documentSuspend
- documentResume
- documentTrainingModeOn
- documentTrainingModeOff
- dokumentumTípusÉrtékesítés
- dokumentumTípusVisszatérítés
- dokumentumTípusProforma
- dokumentumtípus: Szállítás
- dokumentumtípus: Képzés
- dokumentumtípus: kifizetés
- dokumentumtípus: kifizetés
- dokumentumtípus: befizetés
- dokumentumtípus: nyitóegyenleg
- dokumentumtípusNullBevétel
- számlatípus: számla
- dokumentumtípus: Egyéb
- dokumentumtípus-érvénytelen
- dokumentumtípusHosszú távú megrendelés
- fizetési-visszaigazolás-dokumentumtípus
- dokumentumtípus: vevői megrendelés
- dokumentumtípusKészlet
- dokumentumtípus: beszerzés
- hosszú távú megrendelés újranyomtatása
- dokumentumÚjranyomtatásFizetésiErősítés
- dokumentumÚjranyomtatásNyugta
- dokumentumÚjranyomtatásSzámla
- dokumentum-nyugta-másolat
- dokumentum-duplikátum számla
- hosszú távú megrendelés törlése
- dokumentum-nyomkövetés-nyomtatás nélküli hosszú távú megrendelés
- dokumentumSorTörlése
- dokumentumSor érvénytelenítése
- documentCancelDocument
- dokumentumFizetésFrissítése
- dokumentumHosszú távú megrendelés frissítése
- dokumentumSorFrissítés
- documentUpdateTable
Hardver- és felhasználói események
- fióknyitás
- fiók bezárása
- nyomtató nem elérhető
- nyomtató elérhető
- felhasználóBejelentkezés
- felhasználó kijelentkezése
- felhasználói jogok módosítása
Alkalmazás- és rendszeresemények
- alkalmazás indítása
- alkalmazásLeállítás
- alkalmazásfrissítés
- alkalmazásfrissítés-kis
- alkalmazás-pénzügyi-közbenső-szoftver-frissítés
- alkalmazás vészhelyzeti mód bekapcsolva
- alkalmazás vészhelyzeti mód kikapcsolása
- alkalmazás inicializálása
- alkalmazás munkaállomás hozzáadása
- alkalmazásMunkállomásTörlése
- alkalmazásOfflineMódBe
- alkalmazásOfflineMódKi
Törzsadatok és adatintegritási események
- alapadat-elem árváltozás
- alapadat-tétel árkeresés
- alapadat-tétel frissítése vállalatonként
- tulajdonjog-átruházás
- adatintegritás-biztonsági mentés adatbázis
- adatintegritás-adatbázis-visszaállítás
- adatintegritás adatbázis-törlés
- adatintegritás-eseménynapló-törlés
- adatintegritás-adat-helyreállítás
- adatintegritás-adatátvitel
- adatintegritás-konszolidáció befejezve
- adatintegritás-hiba
- adat-sorrend-változás
- adatsorrend-hiba
- adatimport-külső
- adat-export-könyvelés
- adat-export-általános
Pénzügyi és jelentési események
- pénzügyi időszak zárónapja
- pénzügyi időszak zárási hónapja
- pénzügyi időszak zárási éve
- pénzügyi-jelentés-zárónap
- pénzügyi beszámoló felhasználói jelentés
- hatóságoktól kapott pénzügyi hiba
- pénzügyi archívum éve
- könyvelési archívum közbenső
- pénzügyi napló export
- pénzügyi aláírás frissítési kulcs
- pénzügyi ellenőrzés
- pénzügyi ellenőrzési fájlátvitel
Általános
- egyéb (a listában nem szereplő események általános típusa)
4. AuditLog-dokumentum elküldése
AuditLog dokumentumokat ugyanahhoz a végponthoz kell elküldeni, mint az összes többi tranzakciós dokumentumot:
POST /api/v1/transactions/storeDocument
Példa JSON payload-ra
{
"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": {}
}Példa a válaszra
A válasz az adott országra vonatkozó adóügyi adatokat tartalmazza, mint például az alábbi, Németországra vonatkozó példában, amely a TSE (Technical Security Equipment – műszaki biztonsági berendezés) adatait is tartalmazza.
{
"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
}
}
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.