DocumentType: AuditLog – Zapis revizijskih dogodkov

Z dokumentType AuditLog je zdaj mogoče beležiti netransakcijske dogodke (npr. prijave uporabnikov ali odpiranje blagajne) in jih podpisati prek standardne končne točke, tako kot običajne račune.

1. Nova vrsta dokumenta (documentType)

Enumeracija DocumentType enum zdaj vsebuje naslednjo možnost za zajemanje dogodkov, ki se lahko revidirajo:

• AuditLog (1002)

2. Nove lastnosti v modelu dokumenta

Ko nastavite documentType na AuditLog, je treba v Document objektu:

3. Razpoložljivi AuditLogEntryTypes

dogodki v dokumentu

• documentReprintOther
• documentSuspend
• documentResume
• dokumentVklopNačinaUsposabljanja
• način usposabljanja izklopljen
• tip_dokumentaProdaja
• tip_dokumenta_vračilo
• tip_dokumenta_proforma
• tip_dokumenta_dostava
• tip_dokumentaUsposabljanje
• tip_dokumenta_izplačilo
• tip_dokumenta_izplačilo
• tip_dokumenta_vplačilo
• tip_dokumenta_začetno_stanje
• tip_dokumenta_brez_prejemka
• tip_dokumentaRačun
• tip_dokumenta_drugo
• tip_dokumenta_razveljavljen
• tip_dokumenta_dolgoročno_naročilo
• tip_dokumenta_potrditev_plačila
• tip_dokumentaNaročilo_stranke
• tip_dokumentaZaloga
• tip_dokumenta_nakup
• ponatis dolgoročnega naročila
• ponatis potrdila o plačilu
• ponatis potrdila o prejemu
• ponatis računa
• duplikat potrdila
• duplikat računa
• dokumentPreklicDolgoročnegaNaročila
• sledenje-netiskanega-dolgoročnega-naročila
• dokumentPreklicVrstice
• dokumentRazveljavitevVrstice
• dokumentPrekličiDokument
• dokumentPosodobiPlačilo
• posodobitev dolgoročnega naročila dokumenta
• posodobitev vrstice v dokumentu
• posodobitev_tabele_dokumenta

Dogodki strojne opreme in uporabnikov

• predalOdpre
• zapiranje predala
• printerUnavailable
• printerAvailable
• userLogin
• odjava uporabnika
• sprememba pravic uporabnika

Dogodki aplikacij in sistema

• začetek aplikacije
• zaprtje aplikacije
• posodobitev aplikacije
• manjša posodobitev aplikacije
• posodobitev poslovne vmesne programske opreme aplikacije
• vklop zasilnega načina aplikacije
• izklop zasilnega načina aplikacije
• inicializacija aplikacije
• aplikacijaDodajDelovnoPostajo
• aplikacijaIzbrišiDelovnoPostajo
• applicationOfflineModeOn
• applicationOfflineModeOff

Dogodki v zvezi s temeljnimi podatki in celovitostjo podatkov

• sprememba cene glavnega podatkovnega elementa
• pogled na ceno glavnega podatkovnega elementa
• posodobitev osnovnega podatka o podjetju
• prenos lastništva
• varnostna kopija baze podatkov za celovitost podatkov
• obnova celovitosti podatkov v bazi
• prečiščenje baze podatkov zaradi celovitosti podatkov
• izbris dnevnika dogodkov za celovitost podatkov
• celovitost podatkovObnova podatkov
• celovitost podatkov: posredovanje podatkov
• dataIntegrityConsolidationComplete
• napaka celovitosti podatkov
• sprememba zaporedja podatkov
• napaka v zaporedju podatkov
• uvoz zunanjih podatkov
• izvoz podatkov za računovodstvo
• izvoz podatkov – splošno

Dogodki v zvezi s finančnim letom in poročili

• dan zaključka poslovnega obdobja
• mesec zaključka poslovnega obdobja
• leto zaključka poslovnega obdobja
• dan zaključka finančnega poročila
• poročilo o finančnem letu – poročilo uporabnika
• prejeta napaka v zvezi s finančnim poročilom od pristojnih organov
• letno arhivsko leto
• vmesni arhiv finančnega leta
• izvoz_fiskalnega_dnevnika
• ključ za posodobitev davčnega podpisa
• fiskalna revizija
• prenos datoteke revizije

Splošno

• drugo (splošni tip za dogodke, ki niso vključeni v seznam)

4. Pošiljanje dokumenta AuditLog

Dokumenti AuditLog se pošiljajo na isto končno točko kot vsi drugi transakcijski dokumenti: 

• POST /api/v1/transactions/storeDocument

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

Primer odgovora

Odgovor vsebuje podatke o fiskalizaciji, ki veljajo za zadevno državo, kot na primer v spodnjem primeru za Nemčijo, ki vključuje podrobnosti o TSE (tehnična varnostna oprema).

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

Ta članek je bil samodejno preveden.