POST /api/v1/transactions/auditlog – RetailForce

POST /api/v1/transactions/auditlog galinis taškas leidžia pridėti įvykio įrašą atitinkamam fiskaliniam klientui; tai svarbu sandorių ir vidinių sistemos procesų atsekamumui užtikrinti, o kai kuriose šalyse tai yra įstatymu nustatyta prievolė.

Dėmesio: įvykiai turi būti siunčiami laiku ir teisinga tvarka. Kaip ir dokumentų atveju, įvykiai (auditai) negali būti siunčiami kaip partija (paketas)!

Rezultatas

Sėkmingas galinio taško (200) iškvietimas

įtraukia audito žurnalo įrašą į techninių įvykių žurnalą.

Naudojimas

Šis galinis taškas naudojamas įrašytiems įvykiams registruoti.

Įvykių kodų atitikimas

Informaciją apie „RetailForce“ įvykių kodų priskyrimą įvykių kodams tam tikrose šalyse rasite apžvalgoje „Techninis įvykių žurnalas / Event Log“.

Reikalavimai

Fiskalinis klientas turi būti inicijuotas ir paruoštas darbui.

Perdavimo procesas

Įrašas siunčiamas kaip JSON objektas:

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

Formos laukeliai

Informacija stulpelyje „Tipas“:

M ... privaloma („mandatory“)
M* ... privaloma tam tikrose šalyse arba tam tikromis sąlygomis
R ... rekomenduojama („recommended“)
O ... neprivaloma

Elementas		Tipas	Aprašymas
recordId			unikalus įrašo identifikatorius.
uniqueClientId		M	Kaso aparato uniqueClientId (iš RetailForce sistemos)
logEntryType			Audito žurnalo įrašo tipas
message			Audito įrašo pranešimas.
documentGuid			galimas nuoroda į dokumentą.
user			Informacija apie kasos aparato naudotoją.
	{...}
amount			Bendra sąskaitos suma.
identifier			galimas audito įrašo identifikatorius.
įrašoDataLaikas		M	Įrašo data ir laikas.
signature

Pavyzdys:

//Speichern der Transaktion
{
"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",
}
//Schliesung der Kassenschublade
{
  "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", 
  },
}

Atsakymas

Galimi atsakymai:

Kodas	Aprašymas
200	OK
202	Įrašas buvo dubliuotas
422	AuditLog parametras yra nulinis arba buvo nustatytas įrašo parašas.