POST /api/v1/transactions/AuditLog – RetailForce

POST-endpointet /api/v1/transactions/AuditLog gør det muligt at tilføje en hændelsespost for den pågældende skattepligtige client, hvilket er vigtigt for sporbarheden af transaktioner og systeminterne processer og er lovpligtigt i nogle lande.

OBS: Begivenheder skal sendes på det korrekte tidspunkt og i den korrekte rækkefølge. Ligesom med dokumenter må begivenheder (revisioner) ikke sendes som en batch (pakke)!

Resultat

Et vellykket opkald til endpointet (200)

tilføjer en revisionslogpost til den tekniske hændelsesjournal.

Anvendelse

Dette endpoint bruges til at logge begivenheder, som kassesystemet er forpligtet til at registrere.

Hændelseskode-tilknytning

Oplysninger om tilknytningen af RetailForce-hændelseskoder til hændelseskoder i bestemte lande findes i oversigten "Teknisk hændelseslog / Hændelseslog".

Krav

Fiskalklienten skal være initialiseret og i drift.

Overførselsproces

Anmodningen skal sendes som et JSON-objekt:

{
  "recordId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "uniqueClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "logEntryType": "100",
  "message": "string",
  "documentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "user": {
    "id": "string",
    "caption": "string",
    "firstName": "string",
    "lastName": "string",
    "taxNumber": "string",
    "dateOfEntry": "2022-01-01T00:00:00+01:00"
  },
  "amount": 0,
  "identifier": "string",
  "recordDateTime": "2023-12-07T10:14:19.859+01:00",
  "signature": "string"
}

Formularfelter

Oplysninger i kolonnen "Type":

M ... obligatorisk / påkrævet
M* ... obligatorisk / påkrævet i visse lande eller under visse betingelser
R ... anbefalet
O... valgfrit

Element		Type	Beskrivelse
RecordId			unik identifikator for posten.
uniqueClientId		M	UniqueClientId for kasseapparatet (fra RetailForce systemet), som revisionslogposten tilhører.
LogEntryType			Typen af revisionslogposten.
message			Meddelelsen i revisionslogposten.
DocumentGuid			En mulig forbindelse til et dokument i revisionslogposten
bruger			Brugeren (hvis relevant) af revisionslogposten.
	{...}
beløb			Dokumentets samlede beløb
identifikator			En mulig identifikator for revisionslogposten.
recordDateTime		M	recordDateTime for revisionslogposten.
signatur

Eksempel:

// Saving the transaction
{
  "recordId": "58b55595-2796-4d65-b90f-4b2e1549db44",
  "uniqueClientId": "58b55595-2796-4d65-b90f-4b2e1549db44",
  "LogEntryType": 100,
  "Message": "DocumentTypeSales",
  "documentGuid": "215c2395-ab4a-4132-858d-86459a9e883a",
  "user": {
    "id": "1234",
    "caption": "Max Thomas"
  },
  "amount": 12.5,
  "identifier": "0000001",
  "recordDateTime": "2023-12-07T10:15:45+01:00"
}
// Closing the cash drawer
{
  "recordDateTime": "2023-12-07T10:15:46+01:00",
  "UniqueClientId": "58b55595-2796-4d65-b90f-4b2e1549db44",
  "LogEntryType": 201,
  "Message": "DrawerClose",
  "DocumentGuid": null,
  "user": {
    "id": "1234",
    "caption": "Max Thomas"
  }
}

Svar

Mulige svar:

Kode	Beskrivelse
200	OK
202	Posten var en dublet
422	AuditLog-parameteren er null, eller der blev angivet en signatur for posten.

Denne artikel er oversat automatisk.