Salt la conținutul principal

DocumentType: AuditLog – Înregistrarea evenimentelor de audit

Armir Alidema
  • Actualizat

Cu documentType-ul „AuditLog”, este acum posibilă înregistrarea evenimentelor netranzacționale (de exemplu, autentificările utilizatorilor sau deschiderea sertarului de bani) și semnarea acestora prin intermediul punctului de lucru standard, la fel ca în cazul chitanțelor obișnuite.

 

1. Tip de document nou (documentType)

Enumerarea DocumentType enum conține acum următoarea opțiune pentru înregistrarea evenimentelor auditabile:

  • AuditLog (1002)

 

2. Proprietăți noi în modelul de document

Când setați documentType la AuditLog, următoarele proprietăți noi trebuie utilizate în Document :

Proprietate Tip Descriere
AuditLogEntryType Enum LogEntryType (Obligatoriu) Definește tipul evenimentului de audit. O listă completă poate fi găsită în secțiunea următoare.
amount decimal? (Opțional) O valoare monetară asociată cu înregistrarea din jurnal, de exemplu, suma unei discrepanțe la casa de marcat.
identificator string (Opțional) Un string suplimentar pentru identificare sau pentru a oferi mai mult context, de exemplu pentru a indica care sertar de bani a fost deschis.

3. Evenimente disponibile AuditLogEntryTypes

Evenimente legate de documente

  • documentReprintOther
  • documentSuspend
  • documentResume
  • documentModDeInstruireActivat
  • documentModDeInstruireOprit
  • documentTipVânzări
  • documentTipRetur
  • documentTipProforma
  • tipDocumentLivrare
  • tip_document_formare
  • tip_document Retragere
  • tip_document_plată
  • tip_document_depozit
  • tip_document_sold_inițial
  • tip_document_chitanță_nulă
  • tip_document_factură
  • tip_document_altele
  • tipDocumentAnulat
  • tip_document_comandă_pe_termen_lung
  • tipDocumentConfirmarePlată
  • tipDocumentComandăClient
  • tipDocumentInventar
  • tipDocumentAchiziție
  • reimprimare comandă pe termen lung
  • reimprimare confirmare de plată
  • reimprimare document chitanță
  • reimprimare factură
  • documentDuplicatChitanță
  • documentDuplicatFactură
  • documentAnulareComandăPeTermenLung
  • documentUrmărireComandăPeTermenLungNeimprimată
  • documentAnulareLinie
  • documentAnulareLinie
  • documentAnulareDocument
  • documentActualizarePlată
  • actualizare comandă pe termen lung
  • actualizare linie document
  • documentActualizareTabel

Evenimente hardware și ale utilizatorului

  • deschidere sertar
  • închidere sertar
  • imprimantă indisponibilă
  • imprimantăDisponibilă
  • autentificare utilizator
  • deconectare utilizator
  • modificare drepturi utilizator

Evenimente ale aplicației și ale sistemului

  • pornire aplicație
  • închidere aplicație
  • actualizare aplicație
  • actualizareMinorăAplicație
  • actualizare middleware fiscal aplicație
  • aplicațieModDeUrgențăActivat
  • aplicațieModDeUrgențăOprit
  • inițializare aplicație
  • aplicațieAdăugareStațieDeLucru
  • aplicație Ștergere stație de lucru
  • aplicațieModOfflineActivat
  • aplicațieModOfflineOprit

Evenimente privind datele de referință și integritatea datelor

  • modificarePrețElementDateDeReferință
  • masterDataItemPriceLookup
  • actualizare companie element date de referință
  • transfer de proprietate
  • backup-baza-de-date-integritate-date
  • restabilirea integrității datelor în baza de date
  • integritatea datelor - curățare bază de date
  • integritateDateȘtergereJurnalEvenimente
  • integritatea datelor: recuperarea datelor
  • integritatea datelor-redirecționare date
  • integritateaDatelorFinalizareConsolidare
  • Eșec integritate date
  • modificareSecvențăDate
  • Eșec secvență date
  • importul datelor externe
  • export date contabile
  • export-date-generic

Evenimente fiscale și de raportare

  • fiscalPeriodClosingDay
  • luna de închidere a perioadei fiscale
  • fiscalPeriodClosingYear
  • Ziua de închidere a raportului fiscal
  • raport fiscal - raport utilizator
  • eroare fiscală primită de la autorități
  • Anul de arhivare fiscală
  • arhivă fiscală intermediară
  • export jurnal fiscal
  • fiscalCheieDeActualizareASemnăturii
  • audit fiscal
  • transfer-fișier-audit-fiscal

General

  • altele (un tip generic pentru evenimente care nu sunt incluse în listă)

4. Trimiterea unui document AuditLog

Documentele AuditLog sunt trimise către același punct final ca toate celelalte documente tranzacționale: 

  • POST /api/v1/transactions/storeDocument

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

Exemplu de răspuns

Răspunsul conține date de fiscalizare relevante pentru țara respectivă, cum ar fi exemplul de mai jos pentru Germania, care include detalii privind TSE (Echipament tehnic de securitate).

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

Acest articol a fost tradus automat.

Articole conexe

Comentarii

0 comentarii

Vă rugăm să vă autentificați pentru a lăsa un comentariu.

Susținut de Zendesk