POST /api/v1/transactions/auditlog – RetailForce

Krajnja točka POST /api/v1/transactions/auditlog omogućuje dodavanje unosa događaja za odgovarajućeg fiskalnog klijenta, što je važno za sljedivost transakcija i internih sustavnih procesa te je zakonski obavezno u nekim zemljama.

Pažnja: Događaji se moraju slati u ispravno vrijeme i ispravnim redoslijedom. Kao i kod dokumenata, događaji (revizije) se ne smiju slati kao paket!

Rezultat

Uspješni poziv krajnje točke (200)

dodaje zapis u dnevnik revizije u tehnički dnevnik događaja.

Upotreba

Ova krajnja točka služi za evidentiranje događaja koje je sustav blagajne obvezan zabilježiti.

Mapiranje kodova događaja

Informacije o mapiranju RetailForce kodova događaja na kodove događaja u pojedinim zemljama mogu se pronaći u pregledu "Tehnički dnevnik događaja / Dnevnik događaja".

Zahtjevi

Fiskalni klijent mora biti inicijaliziran i operativan.

Proces prijenosa

Zahtjev se mora poslati kao 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"
}

Polja obrasca

Informacije u stupcu "Tip":

M ... obavezno / potrebno
M* ... obavezno / potrebno u određenim zemljama ili pod određenim uvjetima
R ... preporučeno
O... opcionalno

Element		Tip	Opis
ID zapisa			jedinstveni identifikator unosa.
jedinstveni identifikator klijenta		M	uniqueClientId blagajne (iz sustava RetailForce), kojoj pripada unos u dnevnik revizije.
logEntryType			Vrsta unosa u dnevnik revizije.
poruka			Poruka revizijske bilješke.
documentGuid			Moguća veza s dokumentom unosa u evidenciji revizije
korisnik			Korisnik (ako je primjenjivo) unosa u evidenciji revizije.
	{...}
iznos			Ukupni iznos dokumenta
identifikator			Mogući identifikator za unos u dnevnik revizije.
recordDateTime		M	vrijeme evidentiranja unosa u dnevnik revizije.
potpis

Primjer:

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

Odgovor

Mogući odgovori:

Kod	Opis
200	U redu
202	Zapis je bio duplikat
422	Parametar AuditLog je null ili je postavljena potpisnica unosa.

Ovaj je članak automatski preveden.