DocumentType: AuditLog – Registrering av 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 regular receipts.

1. Ny dokumenttyp (documentType)

Enumet DocumentType enum innehåller nu följande alternativ för att registrera händelser som kan granskas:

AuditLog (1002)

2. Nya egenskaper i dokumentmodellen

När du ställer in documentType till AuditLog, måste följande nya egenskaper användas i Document objektet:

Egenskap	Typ	Beskrivning
AuditLogEntryType	LogEntryType-enum	(Obligatoriskt) Definierar typen av granskningshändelse. En fullständig lista finns i nästa avsnitt.
amount	decimal?	(Valfritt) Ett monetärt värde kopplat till loggposten, t.ex. beloppet för en avvikelse i kassan.
identifier	string	(Valfritt) En ytterligare string för identifiering eller för mer sammanhang, t.ex. för att ange vilken kassalåda som har öppnats.

3. Tillgängliga `AuditLogEntryTypes`

dokumenthändelser

documentReprintOther
documentSuspend
documentResume
documentTrainingModeOn
documentTrainingModeOff
dokumentTypFörsäljning
documentTypeReturn
documentTypeProforma
dokumenttypLeverans
dokumenttypUtbildning
dokumenttypUttag
dokumenttypUtbetalning
dokumenttypInbetalning
dokumenttypInledandeSaldo
dokumenttypNullkvitto
dokumenttypFaktura
dokumenttypÖvrigt
dokumenttypOgiltig
dokumenttypLångsiktigOrder
dokumenttypBetalningsbekräftelse
dokumenttypKundorder
dokumenttypLager
dokumenttypInköp
dokumentåtertryckLångsiktig beställning
dokumentåterutskriftbetalningsbekräftelse
dokumentÅtertryckKvitto
dokumentÅtertryckFaktura
dokumentDuplikatKvitto
dokumentDupliceraFaktura
dokumentAvbrytLångsiktigOrder
spåraoutskrivenLångsiktigBeställning
dokumentAvbrytRad
documentOgiltigförklaraRad
documentCancelDocument
dokumentUppdateraBetalning
dokumentUppdateraLångsiktigBeställning
dokumentUppdateraRad
documentUpdateTable

Hårdvaru- och användarhändelser

drawerOpen
lådaStängd
printerUnavailable
printerAvailable
användarinloggning
användarutloggning
användarrättigheterändras

Applikations- och systemhändelser

programstart
applikationStängsAv
applikationsuppdatering
applikationsuppdatering (mindre)
applikationensFiscalMiddleware-uppdatering
applikationNödlägePå
applikationNödlägeAv
applikationInitialisera
applikationLägg till arbetsstation
applikationTaBortArbetsstation
applikationOfflinelägePå
applikationOfflinelägeAv

Huvuddata och händelser som rör dataintegritet

masterDataItemPriceChange
uppslag på pris för huvuddataobjekt
masterDataItemUpdateCompany
överförÄganderätt
dataIntegrityBackupDatabase
dataIntegrityRestoreDatabase
dataintegritet-rensa-databas
dataintegritet-rensa-händelselogg
dataintegritetÅterställning av data
dataIntegrityVidarebefordraData
dataIntegrityConsolidationComplete
dataIntegrityFailure
dataSekvensÄndring
dataSekvensfel
dataimportExtern
dataExportRedovisning
dataExportGenerisk

Händelser relaterade till räkenskapsår och rapporter

fiscalPeriodClosingDay
fiscalPeriodClosingMonth
fiscalPeriodClosingYear
fiscalReportClosingDay
användarrapport för bokslut
fiskalfel mottaget från myndigheter
arkiveringsår
mellanliggande arkivår
export av skattejournal
uppdateringsnyckel för skattemässig signatur
skatterevision
fiscalAuditFileTransfer

Allmänt

other (en generisk typ för händelser som inte ingår i listan)

4. Skicka in ett AuditLog-dokument

AuditLog-dokument skickas till samma slutpunkt som alla andra transaktionsdokument:

POST /api/v1/transactions/storeDocument

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

Exempel på svar

Svaret innehåller fiscaliseringsdata som är relevanta för respektive land, såsom exemplet nedan för Tyskland, som inkluderar TSE-uppgifter (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
  }
}

Den här artikeln har översatts automatiskt.