POST /api/v1/transactions/auditlog – RetailForce

Крајња тачка POST /api/v1/transactions/auditlog омогућава додавање уноса догађаја за одговарајућег пореског клијента, што је важно за праћење трансакција и унутрашњих система и законски је обавезно у неким земљама.

Пажња: Догађаји морају бити послати у право време и у исправном редоследу. Као и код докумената, догађаје (аудите) не треба слати као пакет!

Резултат

Успешан позив крајње тачке (200)

додаје упис у дневник ревизије у технички журнал догађаја.

Употреба

Ова крајња тачка се користи за евидентирање догађаја које је систем благајне обавезан да забележи.

Мапирање кодова догађаја

Информације о мапирању кодова догађаја RetailForce на кодове догађаја у појединим земљама могу се наћи у прегледу "Технички дневник догађаја / Дневник догађаја".

Захтеви

Фискални клијент мора бити иницијализован и оперативан.

Процес преноса

Захтев мора бити послат као JSON објекат:

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

Поља обрасца

Информације у колони "Тип":

M ... обавезно / потребно у одређеним земљама или под одређеним условима
M* ... обавезно / потребно у одређеним земљама или под одређеним условима
R ... препоручено
O... опционално

Елемент		Тип	Опис
идентификатор записа			јединствени идентификатор уноса.
јединствени идентификатор клијента		M	uniqueClientId касе (из система RetailForce), којој припада унос у дневник ревизије.
logEntryType			Тип уноса у дневник ревизије.
порука			Порука записа о ревизији.
documentGuid			Могућа веза са документом уписа у дневник ревизије
корисник			Корисник (ако је применљиво) записа у дневнику ревизије.
	{...}
износ			Укупни износ документа
идентификатор			Могући идентификатор за унос у дневник ревизије.
recordDateTime		M	временски запис уноса у дневник ревизије.
потпис

Пример:

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

Одговор

Могући одговори:

Код	Опис
200	У реду
202	Запис је био дупликат
422	Параметар AuditLog је null или је подешен потпис уноса.

Овај чланак је аутоматски преведен.