POST /api/v1/transactions/AuditLog – RetailForce

Koncový bod POST /api/v1/transactions/AuditLog umožňuje pridať záznam udalosti pre príslušného daňového klienta, čo je dôležité pre vysledovateľnosť transakcií a vnútorných procesov systému a v niektorých krajinách je to vyžadované zákonom.

Upozornenie: Udalosti musia byť odosielané v správnom čase a v správnom poradí. Rovnako ako v prípade dokumentov, ani udalosti (audity) nesmú byť odosielané hromadne (ako balík)!

Výsledok

Úspešné volanie koncového bodu (200)

pridá záznam do audítorského denníka do technického denníka udalostí.

Použitie

Tento koncový bod sa používa na zaznamenávanie udalostí, ktoré je pokladničný systém povinný zaznamenávať.

Mapovanie kódov udalostí

Informácie týkajúce sa priradenia kódov udalostí RetailForce ku kódom udalostí v konkrétnych krajinách nájdete v prehľade „Technický protokol udalostí / Protokol udalostí“.

Požiadavky

Daňový client musí byť inicializovaný a funkčný.

Proces prenosu

Žiadosť musí byť odoslaná ako objekt 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"
}

Pole formulára

Informácie v stĺpci „Typ“:

M ... povinné / vyžadované
M* ... povinné / vyžadované v určitých krajinách alebo za určitých podmienok
R ... odporúčané
O... nepovinné

Prvok		Typ	Popis
RecordId			jedinečný identifikátor záznamu.
uniqueClientId		M	ID jedinečného klienta (uniqueClientId) pokladnice (zo RetailForce system), ku ktorej patrí záznam v audítorskom protokole.
LogEntryType			Typ záznamu v audítorskom protokole.
message			Správa záznamu auditu.
DocumentGuid			Možné prepojenie na dokument záznamu v audítorskom protokole
user			Používateľ (ak je to relevantné) záznamu v audítorskom protokole.
	{...}
amount			Celková suma dokumentu
identifikátor			Možný identifikátor záznamu v audítorskom protokole.
recordDateTime		M	čas a dátum záznamu v audítorskom protokole.
signature

Príklad:

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

Odpoveď

Možné odpovede:

Kód	Popis
200	OK
202	Záznam bol duplicitný
422	Parameter AuditLog je nulový alebo bol nastavený podpis záznamu.

Tento článok bol preložený automaticky.