DocumentType: AuditLog – Záznam audítorských udalostí

With the documentType AuditLog, it is now possible to record netransakčné udalosti (napr. prihlásenia používateľov alebo otvorenie pokladničnej zásuvky) a nechať ich podpísať prostredníctvom štandardného koncového bodu, rovnako ako bežné doklady.

1. Nový typ dokumentu (documentType)

Výpočet DocumentType enum teraz obsahuje nasledujúcu možnosť na zaznamenávanie podujatí podliehajúcich auditu:

• AuditLog (1002)

2. Nové vlastnosti v modeli dokumentu

Pri nastavení documentType na AuditLog, je potrebné v objekte Document objekte:

3. Dostupné AuditLogEntryTypes

Udalosti dokumentu

• documentReprintOther
• documentSuspend
• documentResume
• režim školenia dokumentu zapnutý
• vypnutie režimu školenia dokumentu
• typ_dokumentu_predaj
• typ_dokumentu_vrátenie
• typ_dokumentu_proforma
• typ_dokumentu_dodávka
• typ_dokumentuŠkolenie
• typ_dokumentu_výber
• typ_dokumentu_výplata
• typ_dokumentu_vklad
• typ_dokumentu_počiatočný_zostatok
• typ_dokumentu_príjem_nulový
• typ_dokumentu_faktúra
• typ_dokumentu_iné
• typ_dokumentu_zrušený
• typ_dokumentu_dlhodobá_objednávka
• typ_dokumentuPotvrdenie_platby
• typ_dokumentuZákaznícka_objednávka
• typ_dokumentu_zásoby
• typ_dokumentu_nákup
• reprint dlhodobej objednávky
• reprint potvrdenia o platbe
• reprint dokladu o prijatí
• dokumentReprintFaktúra
• duplikát potvrdenia o platbe
• duplikát faktúry
• dokumentZrušenieDlhodobejObjednávky
• dokumentSledovanieNevytlačenejDlhodobejObjednávky
• dokumentZrušiťRiadok
• dokumentZrušiťRiadok
• dokumentZrušiťDokument
• aktualizácia platby v dokumente
• aktualizácia dlhodobej objednávky
• aktualizácia riadku v dokumente
• aktualizácia tabuľky v dokumente

Hardvérové a užívateľské udalosti

• otvorenie zásuvky
• zatiahnutie zásuvky
• tlačiareňNedostupná
• tlačiareň je k dispozícii
• prihlásenie používateľa
• odhlásenie používateľa
• zmena oprávnení používateľa

Udalosti aplikácie a systému

• spustenie aplikácie
• vypnutie aplikácie
• aktualizácia aplikácie
• drobná aktualizácia aplikácie
• aktualizácia fiškálneho middlewaru aplikácie
• aplikáciaNúdzovýRežimZapnutý
• vypnutie núdzového režimu aplikácie
• inicializácia aplikácie
• aplikácia Pridať pracovnú stanicu
• aplikáciaOdstrániťPracovnúStanicu
• aplikáciaOfflineModeOn
• aplikáciaRežimOfflineVypnutý

Udalosti týkajúce sa hlavných údajov a integrity údajov

• zmenaCenyPoložkyKmeňovýchÚdajov
• vyhľadanie ceny položky hlavných údajov
• aktualizácia položky hlavných údajov – spoločnosť
• transferOwnership
• zálohovanie databázy na účely zabezpečenia integrity údajov
• obnovenie integrity údajov v databáze
• dataIntegrityPurgeDatabase
• Vymazanie protokolu udalostí integrity údajov
• integrita údajov – obnova údajov
• integrita_dát_posielanie_dát
• dataIntegrityKonsolidáciaDokončená
• zlyhanie integrity údajov
• Zmena poradia údajov
• zlyhanie poradia údajov
• import údajov z externého zdroja
• export údajov z účtovníctva
• export údajov – všeobecné

Udalosti týkajúce sa účtovného obdobia a správ

• Deň uzavretia účtovného obdobia
• mesiac uzavretia účtovného obdobia
• rok uzavretia účtovného obdobia
• Deň uzavretia finančnej správy
• fiskálna správa – užívateľská správa
• chyba vo finančnej správe prijatá od orgánov
• rok archivácie účtovnej závierky
• medzidobie daňového archívu
• export daňového denníka
• aktualizačný kľúč daňového podpisu
• daňová kontrola
• fiskálnyAuditPrenosSúborov

Všeobecné

• iné (všeobecný typ pre udalosti, ktoré nie sú zahrnuté v zozname)

4. Odosielanie dokumentu AuditLog

Dokumenty AuditLog sa odosielajú na rovnaký koncový bod ako všetky ostatné transakčné dokumenty: 

• POST /api/v1/transactions/storeDocument

Príklad JSON payloadu

{
  "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": {}
}

Príklad odpovede

Odpoveď obsahuje údaje o fiskalizácii relevantné pre príslušnú krajinu, ako napríklad v nižšie uvedenom príklade pre Nemecko, ktorý obsahuje podrobnosti o TSE (technické bezpečnostné zariadenie).

{
  "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
  }
}

Tento článok bol preložený automaticky.