POST /api/v1/transactions/AuditLog – RetailForce

Крайната точка POST /api/v1/transactions/AuditLog позволява добавянето на запис за събитие за съответния фискален client, което е важно за проследимостта на транзакциите и вътрешните процеси на системата и е законово изискване в някои държави.

Внимание: Събитията трябва да се изпращат в точното време и в точния ред. Както при документите, събитията (одитите) не трябва да се изпращат като пакет!

Резултат

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

добавя запис в аудиторския дневник в техническия дневник на събитията.

Употреба

Този краен пункт се използва за регистриране на събития, които системата за касови апарати е длъжна да записва.

Съответствие на кодовете на събитията

Информация относно съответствието между кодовете на събитията в RetailForce и кодовете на събитията в конкретни държави може да бъде намерена в обзора „Технически дневник на събитията / Дневник на събитията“.

Изисквания

The fiscal client must be initiated and operational.

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

Заявката трябва да бъде изпратена като 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... по избор

Елемент		Тип	Описание
RecordId			уникален идентификатор на записа.
uniqueClientId		M	uniqueClientId на касовия апарат (от RetailForce system), към който принадлежи записът в одиторския дневник.
LogEntryType			Типът на записа в одитния дневник.
message			Съобщение на записите в одитния дневник.
DocumentGuid			Възможна връзка с документ, свързан със записите в одиторския дневник
user			Потребителят (ако е приложимо) на записа в регистъра за одит.
	{...}
сума			Обща сума на документа
идентификатор			Възможен идентификатор за записа в одиторския дневник.
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	OK
202	Записът е дубликат
422	Параметърът AuditLog е нулев или е зададен подпис на записа.

Тази статия е преведена автоматично.