POST /api/v1/transactions/AuditLog – RetailForce

Punctul final POST /api/v1/transactions/AuditLog permite adăugarea unei înregistrări de eveniment pentru clientul fiscal respectiv, ceea ce este important pentru trasabilitatea tranzacțiilor și a proceselor interne ale sistemului și este o cerință legală în unele țări.

Atenție: Evenimentele trebuie trimise la momentul corect și în ordinea corectă. La fel ca în cazul documentelor, evenimentele (auditurile) nu trebuie trimise în lot (pachet)!

Rezultat

O apelare reușită a punctului final (200)

adaugă o înregistrare de jurnal de audit în jurnalul de evenimente tehnice.

Utilizare

Acest punct final este utilizat pentru înregistrarea evenimentelor pe care sistemul de casă de marcat este obligat să le înregistreze.

Corelarea codurilor de eveniment

Informații privind corelarea codurilor de evenimente RetailForce cu codurile de evenimente din anumite țări pot fi găsite în secțiunea „Jurnalul de evenimente tehnice / Jurnalul de evenimente”.

Cerințe

Clientul fiscal trebuie să fie inițializat și operațional.

Procesul de transmitere

Solicitarea trebuie trimisă sub forma unui obiect 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"
}

Câmpurile formularului

Informații din coloana „Tip”:

M ... obligatoriu / necesar
M* ... obligatoriu în anumite țări sau în anumite condiții
R ... recomandat
O... opțional

Element		Tip	Descriere
RecordId			identificator unic al înregistrării.
uniqueClientId		M	ID-ul unic al clientului (uniqueClientId) al casei de marcat (din RetailForce system) căreia îi aparține înregistrarea din jurnalul de audit.
LogEntryType			Tipul înregistrării din jurnalul de audit.
message			Mesajul înregistrării de audit.
DocumentGuid			O posibilă legătură cu un document al înregistrării din jurnalul de audit
user			Utilizatorul (dacă este cazul) al înregistrării din jurnalul de audit.
	{...}
sumă			Suma totală a documentului
identificator			Un posibil identificator pentru înregistrarea din jurnalul de audit.
recordDateTime		M	recordDateTime al înregistrării din jurnalul de audit.
semnătură

Exemplu:

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

Răspuns

Răspunsuri posibile:

Cod	Descriere
200	OK
202	Înregistrarea era duplicată
422	Parametrul AuditLog este nul sau a fost setată semnătura înregistrării.

Acest articol a fost tradus automat.