POST /api/v1/transactions/AuditLog – RetailForce

Končna točka POST /api/v1/transactions/AuditLog omogoča dodajanje vnosa dogodka za zadevnega davčnega klienta, kar je pomembno za sledljivost transakcij in notranjih sistemskih procesov ter je v nekaterih državah zakonsko obvezno.

Pozor: Dogodke je treba poslati ob pravem času in v pravem vrstnem redu. Tako kot pri dokumentih tudi dogodkov (revizij) ne smete pošiljati v svežnju (paketu)!

Rezultat

Uspešen klic končne točke (200)

doda vnos v revizijski dnevnik v tehnični dnevnik dogodkov.

Uporaba

Ta končna točka se uporablja za beleženje dogodkov, ki jih mora sistem blagajne obvezno zabeležiti.

Preslikava kod dogodkov

Informacije o preslikavi kod dogodkov RetailForce v kode dogodkov v posameznih državah najdete v pregledu »Tehnični dnevnik dogodkov / Dnevnik dogodkov«.

Zahteve

Fiskalni client mora biti inicializiran in delovati.

Postopek prenosa

Zahteva mora biti poslana kot 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 obrazca

Informacije v stolpcu »Type«:

M ... obvezno / zahtevano
M* ... obvezno v nekaterih državah ali pod določenimi pogoji
R ... priporočeno
O... neobvezno

Element		Tip	Opis
RecordId			edinstven identifikator vnosa.
uniqueClientId		M	uniqueClientId blagajne (iz RetailForce systema), h kateri pripada vnos v revizijski dnevnik.
LogEntryType			Vrsta vnosa v revizijski dnevnik.
message			Sporočilo vnosa v revizijski dnevnik.
DocumentGuid			Morebitna povezava z dokumentom vnosa v revizijski dnevnik
uporabnik			Uporabnik (če je to ustrezno) vnosa v revizijski dnevnik.
	{...}
znesek			Skupni znesek dokumenta
identifikator			Morebitni identifikator za vnos v revizijski dnevnik.
recordDateTime		M	datum in čas vnosa v revizijski dnevnik.
signature

Primer:

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

Možni odgovori:

Koda	Opis
200	OK
202	Zapis je bil podvojen
422	Parameter AuditLog je null ali je bil nastavljen podpis vnosa.

Ta članek je bil samodejno preveden.