Tip dokumenta: AuditLog - Zapis događaja revizije – RetailForce

Uz tip dokumenta AuditLog sada je moguće bilježiti događaje koji nisu transakcijske prirode (npr. prijave korisnika ili otvaranje ladice za novac) i potpisati ih putem standardne krajnje točke, baš kao i obične račune.

1. Nova vrsta dokumenta (DocumentType)

The DocumentType enum sada sadrži sljedeću opciju za bilježenje događaja podložnih reviziji:

AuditLog (1002)

2. Nova svojstva u modelu dokumenta

Kada postavite documentType za AuditLog, sljedeće nove svojstva moraju se koristiti u Document objektu:

Svojstvo	Tip	Opis
auditLogEntryType	LogEntryType enum	(Obavezno) Definira vrstu revizijskog događaja. Potpuni popis možete pronaći u sljedećem odjeljku.
iznos	decimalno?	(Neobavezno) Novčani iznos povezan s unosom u zapisnik, npr. iznos razlike u blagajni.
identifikator	niz	(Opcionalno) Dodatni niz za identifikaciju ili za više konteksta, npr. za označavanje koje je ladice za gotovinu otvorena.

3. Dostupno `AuditLogEntryTypes`

Događaji dokumenta

documentReprintOther
documentSuspend
nastaviDokument
documentTrainingModeOn
documentTrainingModeOff
documentTypeProdaja
documentTypeReturn
documentTypeProforma
documentTypeDelivery
documentTypeTraining
documentTypeWithDrawal
documentTypeIsplata
documentTypePayIn
documentTypePočetnoStanje
documentTypeNulaPotvrda
documentTypeRačun
documentTypeOstalo
documentTypeNevažeći
documentTypeDugoročnaNarudžba
documentTypePotvrdaPlaćanja
documentTypeCustomerOrder
documentTypeInventar
documentTypePurchase
documentReprintLongTermOrder
ponovni-ispis-potvrde-plaćanja
documentReprintPotvrda
documentReprintFaktura
documentDuplicateReceipt
documentDuplicateInvoice
documentNapustiDugoročnuNarudžbu
documentTraceUnprintedLongTermOrder
documentCancelLine
documentVoidLine
documentCancelDocument
documentUpdatePayment
documentUpdateLongTermOrder
documentUpdateLine
documentUpdateTable

Hardverski i korisnički događaji

drawerOpen
zatvoriFioku
printerNedostupan
printerDostupan
userLogin
odjavaKorisnika
promjenaPravaKorisnika

Događaji aplikacije i sustava

pokretanjeAplikacije
zatvaranjeAplikacije
ažuriranje aplikacije
applicationUpdateMinor
applicationFiscalMiddlewareUpdate
applicationEmergencyModeOn
applicationEmergencyModeOff
applicationInitialize
applicationAddWorkstation
applicationDeleteWorkstation
applicationOfflineModeOn
applicationOfflineModeOff

Događaji za glavne podatke i integritet podataka

masterDataItemPriceChange
masterDataItemPriceLookup
masterDataItemUpdateCompany
prijenos vlasništva
dataIntegrityBackupDatabase
dataIntegrityObnoviBazuPodataka
dataIntegrityOčistiBazuPodataka
dataIntegrityPurgeEventLog
integritetpodatakaoporavakpodataka
dataIntegrityProslijediPodatke
dataIntegrityConsolidationComplete
dataIntegrityFailure
dataSequenceChange
neuspjeh slijeda podataka
dataImportExternal
dataExportAccounting
generički izvoz podataka

Fiskalni i izvještajni događaji

danZavršetkaFiskalnePerioda
mjesecZavršetkaFiskalnePerioda
fiscalPeriodClosingYear
fiscalReportClosingDay
fiscalReportUserReport
fiscalErrorReceivedFromAuthorities
fiscalArchiveYear
fiskalnaArhivaIntermedijarna
fiskalniDnevnikIzvoz
ključ ažuriranja fiskalnog potpisa
fiskalnaRevizija
fiscalAuditFileTransfer

Općenito

ostalo (opći tip za događaje koji nisu uključeni na popis)

4. Objavljivanje AuditLog dokumenta

Dokumenti AuditLog šalju se na isti krajnji punkt kao i svi ostali transakcijski dokumenti:

POST /api/v1/transactions/storeDocument

Primjer JSON tereta

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

Primjer odgovora

Odgovor sadrži podatke o fiskalizaciji relevantne za pojedinu zemlju, kao što je primjer u nastavku za Njemačku, koji uključuje detalje o TSE (tehničkoj sigurnosnoj opremi).

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

Ovaj je članak automatski preveden.