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. |
Komentarai
0 komentarų
Tam, kad paliktumėte komentarus prisijunkite