DocumentType: AuditLog – Záznam auditních událostí

S typem dokumentu AuditLog je nyní možné zaznamenávat netransakční události (např. přihlášení uživatelů nebo otevření pokladní zásuvky) a nechat je podepsat prostřednictvím standardního koncového bodu, stejně jako běžné účtenky.

1. Nový typ dokumentu (DocumentType)

Výčet DocumentType výčtová proměnná nyní obsahuje následující možnost pro zaznamenávání událostí podléhajících auditu:

• AuditLog (1002)

2. Nové vlastnosti v modelu dokumentu

Při nastavení documentType na AuditLog, je nutné v objektu Document objektu:

3. Dostupné AuditLogEntryTypes

události dokumentu

• documentReprintOther
• documentSuspend
• documentResume
• documentTrainingModeOn
• vypnutí režimu školení dokumentu
• typ_dokumentuProdej
• typ_dokumentu_vrácení
• typ_dokumentuProforma
• typ_dokumentu_dodávka
• typ_dokumentuŠkolení
• typ_dokumentu_výběr
• typ_dokumentu_výplata
• typ_dokumentu_vklad
• typ_dokumentu_počáteční_zůstatek
• typ_dokumentu_nulový_příjem
• typ_dokumentu_faktura
• typ_dokumentu_Ostatní
• typ_dokumentu_zrušený
• typ_dokumentu_dlouhodobá_objednávka
• typ_dokumentuPotvrzení_platby
• typ_dokumentuZákaznická_objednávka
• typ_dokumentu_skladové_zásoby
• typ_dokumentu_nákup
• reprint_dlouhodobé_objednávky
• dokumentReprintPotvrzeníPlatby
• dokumentReprintPotvrzení
• dokumentReprintFaktura
• duplikát dokladu – potvrzení o platbě
• duplikát faktury
• dokumentZrušeníDlouhodobéObjednávky
• dokumentSledováníNevytisknutéDlouhodobéObjednávky
• dokumentZrušitŘádek
• dokumentZrušitPoložku
• dokumentZrušitDokument
• dokumentAktualizovatPlatbu
• aktualizace dlouhodobé objednávky v dokumentu
• dokumentAktualizovatŘádek
• dokumentAktualizovatTabulku

Události týkající se hardwaru a uživatelů

• otevření zásuvky
• zavření zásuvky
• tiskárnaNeníK dispozici
• tiskárna k dispozici
• userLogin
• odhlášení uživatele
• změna uživatelských práv

Události aplikace a systému

• spuštění aplikace
• vypnutí aplikace
• aktualizace aplikace
• drobná aktualizace aplikace
• aktualizaceFiskálníhoMiddlewaruAplikace
• zapnutí nouzového režimu aplikace
• vypnutí nouzového režimu aplikace
• inicializace aplikace
• aplikacePřidatPracovníStanici
• aplikaceOdstranitPracovníStanici
• aplikaceRežimOfflineZapnuto
• aplikaceRežimOfflineVypnuto

Události týkající se kmenových dat a integrity dat

• změnaCenyPoložkyKmenovýchÚdajů
• vyhledání ceny položky kmenových dat
• aktualizace položky kmenových dat – změna společnosti
• přenos vlastnictví
• záloha databáze pro integritu dat
• obnovení integrity dat v databázi
• dataIntegrityPurgeDatabase
• vymazání protokolu událostí integrity dat
• integrita dat – obnova dat
• dataIntegrityForwardData
• dataIntegrityConsolidationComplete
• selhání integrity dat
• změna datové sekvence
• selhání datové sekvence
• import dat z externího zdroje
• export dat z účetnictví
• export dat – obecné

Události týkající se účetního období a výkazů

• fiskální období – den uzavření
• měsíc uzavření účetního období
• rok uzavření účetního období
• den uzavření finančního výkazu
• zpráva-uživatele-o-finančním-výsledku
• fiskální chyba obdržená od úřadů
• rok archivace účetnictví
• fiskální archivní mezilehlý
• export účetního deníku
• aktualizační klíč daňového podpisu
• daňová kontrola
• fiskálníAuditPřenosSouboru

Obecné

• ostatní (obecný typ pro události, které nejsou uvedeny v seznamu)

4. Odeslání dokumentu AuditLog

Dokumenty AuditLog se odesílají na stejný koncový bod jako všechny ostatní transakční dokumenty: 

• POST /api/v1/transactions/storeDocument

Příklad obsahu JSON

{
  "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říklad odpovědi

Odpověď obsahuje fiskalizační údaje relevantní pro danou zemi, jako například v níže uvedeném příkladu pro Německo, který zahrnuje podrobnosti o TSE (technické bezpečnostní zařízení).

{
  "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ánek byl přeložen automaticky.