DocumentType: AuditLog – Registrering af revisionshændelser – RetailForce

With the AuditLog documentType, it is now possible to register non-transaction-related events (e.g., user logins or opening the cash drawer) and have them signed via the standard endpoint, just like ordinary receipts.

1. Ny dokumenttype (documentType)

Enum'et DocumentType enum indeholder nu følgende mulighed for registrering af begivenheder, der kan underkastes revision:

AuditLog (1002)

2. Nye egenskaber i dokumentmodellen

Når du angiver documentType til AuditLog, skal følgende nye egenskaber anvendes i Document objektet:

Egenskab	Type	Beskrivelse
AuditLogEntryType	LogEntryType-enum	(Obligatorisk) Definerer typen af revisionshændelse. En komplet liste findes i det næste afsnit.
amount	decimal?	(Valgfri) En monetær værdi knyttet til logposten, f.eks. beløbet for en uoverensstemmelse i kasseapparatet.
identifier	string	(Valgfrit) En yderligere string til identifikation eller for at give mere kontekst, f.eks. for at angive, hvilken kasse, der er blevet åbnet.

3. Tilgængelige `AuditLogEntryTypes`

Dokumenthændelser

documentReprintOther
documentSuspend
documentResume
documentTrainingModeOn
dokumentTræningstilstandFra
dokumentTypeSalg
dokumentTypeRetur
dokumentTypeProforma
dokumenttypeLevering
dokumenttypeUddannelse
dokumenttypeUdbetaling
dokumenttypeUdbetaling
dokumenttypeIndbetaling
dokumenttypeÅbningssaldo
dokumenttypeNullKvittering
dokumenttypeFaktura
dokumenttypeAndet
dokumenttypeAnnulleret
dokumenttypeLangtidsordre
dokumenttypeBetalingsbekræftelse
dokumenttypeKundeordre
dokumenttypeLager
dokumenttypeIndkøb
dokumentGenudskrivningLangtidsordre
dokumentGenudskrivningBetalingsbekræftelse
dokumentGenudskrivningKvittering
dokumentGenudskrivningFaktura
dokumentDuplikatKvittering
duplikat af faktura
dokumentAnnullerLangtidsordre
sporing af ikke-udskrevet langtidskontrakt
dokumentAnnullerLinje
dokumentAnnullerLinje
documentAnnullerDokument
dokumentOpdaterBetaling
dokumentOpdaterLangtidsordre
dokumentOpdaterLinje
dokumentOpdaterTabel

Hardware- og brugerbegivenheder

skuffeÅben
skuffelukning
printerUnavailable
printerTilgængelig
brugerLogin
brugerLogout
brugerrettigheder ændret

Applikations- og systemhændelser

programstart
applikationsnedlukning
applikationsopdatering
applicationUpdateMinor
applikationsregnskabs-middleware-opdatering
applikationNødtilstandTil
applikationNødtilstandFra
applikationInitialiser
applikationTilføjArbejdsstation
applikationSletArbejdsstation
applikationOfflineModeOn
applikationOfflineModeOff

Begivenheder vedrørende stamdata og dataintegritet

masterDataItemPriceChange
masterDataItemPriceLookup
masterDataItemUpdateCompany
transferOwnership
dataIntegrityBackupDatabase
dataintegritet-gendannelse af database
dataintegritet-rensning af database
dataintegritet-rensning af hændelseslog
dataintegritet-datagendannelse
dataIntegrityVideresendData
dataIntegrityKonsolideringAfsluttet
dataIntegrityFejl
dataSekvensÆndring
dataSekvensFejl
dataImportEkstern
dataeksport-regnskab
dataeksport-generisk

Regnskabs- og rapportbegivenheder

regnskabsperiodens afslutningsdag
regnskabsperiodens afslutningsmåned
regnskabsperiodens afslutningsår
regnskabsrapportens afslutningsdag
regnskabsrapport-brugerrapport
regnskabsfejl modtaget fra myndighederne
regnskabsarkivår
regnskabsarkiv-mellemår
eksport af regnskabsjournal
skattemæssigSignaturOpdateringsnøgle
revisionskontrol
fiscalAuditFileTransfer

Generelt

other (en generisk type for begivenheder, der ikke er med på listen)

4. Indsendelse af et AuditLog-dokument

AuditLog-dokumenter indsendes til samme endpoint som alle andre transaktionsdokumenter:

POST /api/v1/transactions/storeDocument

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

Eksempel på svar

Svaret indeholder fiscaliseringsdata, der er relevante for det pågældende land, såsom eksemplet nedenfor for Tyskland, der inkluderer TSE-oplysninger (Technical Security Equipment).

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

Denne artikel er oversat automatisk.