POST /api/v1/transactions/AuditLog – RetailForce

Το τελικό σημείο POST /api/v1/transactions/AuditLog επιτρέπει την προσθήκη μιας εγγραφής συμβάντος για τον αντίστοιχο φορολογικό πελάτη, η οποία είναι σημαντική για την ιχνηλασιμότητα των συναλλαγών και των εσωτερικών διαδικασιών του συστήματος και απαιτείται νομικά σε ορισμένες χώρες.

Προσοχή: Τα συμβάντα πρέπει να αποστέλλονται την σωστή χρονική στιγμή και με τη σωστή σειρά. Όπως και με τα έγγραφα, τα συμβάντα (έλεγχοι) δεν πρέπει να αποστέλλονται μαζικά (ως πακέτο)!

Αποτέλεσμα

Μια επιτυχής κλήση του τελικού σημείου (200)

προσθέτει μια καταχώριση καταγραφής ελέγχου στο τεχνικό ημερολόγιο συμβάντων.

Χρήση

Αυτό το τελικό σημείο χρησιμοποιείται για την καταγραφή συμβάντων που το σύστημα ταμειακής μηχανής υποχρεούται να καταγράφει.

Αντιστοίχιση κωδικών συμβάντων

Πληροφορίες σχετικά με την αντιστοίχιση των κωδικών συμβάντων του RetailForce με τους κωδικούς συμβάντων σε συγκεκριμένες χώρες μπορείτε να βρείτε στην επισκόπηση «Τεχνικό αρχείο καταγραφής συμβάντων / Αρχείο καταγραφής συμβάντων».

Απαιτήσεις

Ο φορολογικός πελάτης πρέπει να έχει αρχικοποιηθεί και να είναι σε λειτουργία.

Διαδικασία μετάδοσης

Το αίτημα πρέπει να αποσταλεί ως αντικείμενο 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"
}

Πεδία φόρμας

Πληροφορίες στη στήλη «Τύπος»:

M ... υποχρεωτικό / απαιτείται
M* ... υποχρεωτικό / απαιτείται σε ορισμένες χώρες ή υπό ορισμένες προϋποθέσεις
R ... συνιστάται
O... προαιρετικό

Στοιχείο		Τύπος	Περιγραφή
RecordId			μοναδικός αναγνωριστικός κωδικός της εγγραφής.
uniqueClientId		M	Το uniqueClientId του ταμειακού μηχανήματος (από το RetailForce system), στο οποίο ανήκει η καταχώριση του αρχείου καταγραφής ελέγχου.
LogEntryType			Ο τύπος της καταχώρησης στο αρχείο καταγραφής ελέγχου.
message			Μήνυμα της καταχώρησης ελέγχου.
DocumentGuid			Πιθανή σύνδεση με ένα έγγραφο της καταχώρησης στο αρχείο καταγραφής ελέγχου
user			Ο χρήστης (εάν υπάρχει) της καταχώρησης στο αρχείο καταγραφής ελέγχου.
	{...}
amount			Συνολικό ποσό του εγγράφου
αναγνωριστικό			Ένα πιθανό αναγνωριστικό για την καταχώριση στο αρχείο καταγραφής ελέγχου.
ημερομηνία-ώρα εγγραφής		M	η ημερομηνία και ώρα καταγραφής της εγγραφής στο αρχείο καταγραφής ελέγχου.
υπογραφή

Παράδειγμα:

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

Απάντηση

Πιθανές απαντήσεις:

Κωδικός	Περιγραφή
200	OK
202	Η εγγραφή ήταν διπλή
422	Η παράμετρος AuditLog είναι null ή έχει οριστεί υπογραφή της εγγραφής.

Αυτό το άρθρο μεταφράστηκε αυτόματα.