POST /api/v1/transactions/AuditLog – RetailForce

POST-ändpunkten /api/v1/transactions/AuditLog möjliggör tillägg av en händelsepost för respektive skatteclient, vilket är viktigt för spårbarheten av transaktioner och systeminterna processer och är lagligt krav i vissa länder.

Observera: Händelser måste skickas vid rätt tidpunkt och i rätt ordning. Precis som med dokument får händelser (revisioner) inte skickas som en sats (paket)!

Resultat

Ett lyckat anrop till slutpunkten (200)

lägger till en revisionsloggpost i den tekniska händelseloggen.

Användning

Denna slutpunkt används för att logga händelser som kassasystemet är skyldigt att registrera.

Händelsekodsmappning

Information om mappningen av RetailForce-händelsekoder till händelsekoder i specifika länder finns i översikten ”Teknisk händelselogg / Händelselogg”.

Krav

Fiskalklienten måste vara initialiserad och i drift.

Överföringsprocess

Begäran måste skickas som ett 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"
}

Formulärfält

Information i kolumnen ”Typ”:

M ... obligatoriskt / krävs
M* ... obligatoriskt i vissa länder eller under vissa förutsättningar
R ... rekommenderat
O... valfritt

Element		Typ	Beskrivning
RecordId			Unikt identifierare för posten.
uniqueClientId		M	Det unika klient-ID:t (uniqueClientId) för den kassa (från RetailForce systemet) som revisionsloggposten tillhör.
LogEntryType			Typen av posten i revisionsloggen.
message			Meddelande för revisionsposten.
DocumentGuid			En eventuell koppling till ett dokument i revisionsloggposten
användare			Användaren (om tillämpligt) för revisionsloggposten.
	{...}
belopp			Dokumentets totala belopp
identifierare			En möjlig identifierare för posten i granskningsloggen.
recordDateTime		M	recordDateTime för revisionsloggposten.
signatur

Exempel:

// 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

Möjliga svar:

Kod	Beskrivning
200	OK
202	Posten var en dubblett
422	AuditLog-parametern är null eller så har postens signatur angetts.

Den här artikeln har översatts automatiskt.