DocumentType: AuditLog – Запис на събития за одит

With the documentType AuditLog, it is now possible to record non-transactional events (for example, user logins or opening the cash drawer) and have them signed via the standard endpoint, exactly as with ordinary receipts.

1. Нов тип документ (documentType)

Сега DocumentType enum вече съдържа следната опция за записване на събития, подлежащи на одит:

• AuditLog (1002)

2. Нови свойства в модела на документа

Когато зададете documentType на AuditLog, в Document :

3. Налични AuditLogEntryTypes

събития за документи

• documentReprintOther
• documentSuspend
• documentResume
• documentTrainingModeOn
• documentTrainingModeOff
• документТипПродажби
• документТипВръщане
• documentTypeПроформа
• типДокументДоставка
• тип_документОбучение
• тип_документ_теглене
• тип_документ_изплащане
• тип_документ_вход
• тип_документ_начален_баланс
• тип_документ_нулева_разписка
• тип_документ_фактура
• тип_документДруго
• тип_документ_анулиран
• тип_документ_дългосрочна_поръчка
• типДокументПотвърждениеНаПлащане
• типДокументПоръчкаНаКлиент
• тип_документ_Инвентар
• тип_документ_покупка
• препечатване на дългосрочна поръчка
• документПрепечатПотвърждениеНаПлащане
• препечатване на разписка
• документПрепечатФактура
• документДубликатКвитанция
• документДубликат на фактура
• отказ от дългосрочна поръчка
• проследяване на неотпечатана дългосрочна поръчка
• документОтмянаНаРед
• documentАнулиране на ред
• documentCancelDocument
• documentUpdatePayment
• documentUpdateLongTermOrder
• documentUpdateLine
• documentUpdateTable

Събития, свързани с хардуера и потребителите

• отваряне на чекмедже
• затваряне на чекмедже
• принтерът е недостъпен
• принтерът е наличен
• userLogin
• излизане на потребител
• промяна на правата на потребителя

Събития в приложението и системата

• започване на приложение
• затваряне на приложение
• актуализация на приложението
• незначително обновяване на приложението
• актуализация на фискалния мидълуеър на приложението
• апликацияАвариенРежимВключен
• приложениеАвариенРежимИзключен
• инициализиране на приложение
• приложениеДобавянеНаРаботнаСтанция
• приложениеИзтриванеРаботнаСтанция
• приложениеОфлайнРежимВключен
• приложениеОфлайнРежимИзключен

Събития, свързани с основните данни и целостта на данните

• промяна на цената на елемент от основните данни
• търсене на цена на елемент от основните данни
• актуализация на основна данна за артикул от компания
• transferOwnership
• резервно копие на базата данни за целостта на данните
• възстановяване на целостта на данните в базата данни
• проверка_на_целостта_на_данните_изчистване_на_базата_данни
• изчистване на събитията за целостта на данните
• целостност на данните възстановяване на данни
• целостност на данните – препращане на данни
• завършване на консолидацията на целостта на данните
• неуспех на целостта на данните
• промяна на последователността на данните
• Отказ на последователността на данните
• импорт на данни от външен източник
• експорт на данни за счетоводство
• експорт на данни - общо

Събития, свързани с финансовата година и отчетите

• ден_на_закриване_на_фискалния_период
• месец на приключване на фискалния период
• година на приключване на фискалния период
• ден на приключване на финансовия отчет
• отчет за финансовия период – потребителски отчет
• фискална грешка, получена от властите
• година на архивиране на финансовите отчети
• фискаленАрхивМеждинен
• експорт на счетоводен дневник
• ключ за актуализация на фискалния подпис
• фискален одит
• фискаленОдитПрехвърлянеНаФайл

Общо

• други (общ тип за събития, които не са включени в списъка)

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

Тази статия е преведена автоматично.