Ergani II Docs

Κύριες ροές εργασίας

Υποβάλετε ένα γεγονός WRKCardSE όταν προσέρχεται ένας εργαζόμενος, σημειώνοντας την αρχή μιας βάρδιας.

Υποβάλετε ένα γεγονός WRKCardSE όταν αποχωρεί ένας εργαζόμενος, σημειώνοντας το τέλος μιας βάρδιας.

Λήψη και ανανέωση του access token που απαιτείται για κάθε αίτημα στο Web API.

Επανυποβάλετε μια προσέλευση ή αποχώρηση για τον ίδιο εργαζόμενο και ημερομηνία — υπερισχύει η πιο πρόσφατη υποβολή.

Αυθεντικοποίηση — Στείλτε τα διαπιστευτήριά σας με POST για να λάβετε access token.
Αποστολή αιτήματος WRKCardSE — Στείλτε με POST ένα γεγονός προσέλευσης ή αποχώρησης για έναν εργαζόμενο.
Λήψη αριθμού πρωτοκόλλου — Μια επιτυχής υποβολή επιστρέφει έναν αριθμό πρωτοκόλλου — την απόδειξη παραλαβής σας.
Ολοκληρώθηκε — Το γεγονός καταγράφεται στον Εργάνη. Δεν απαιτείται καμία άλλη ενέργεια.

Στείλτε γεγονότα προσέλευσης και αποχώρησης WRKCardSE για εργαζομένους σε πραγματικό χρόνο.

Κάθε γεγονός γίνεται μέρος του ιστορικού παρουσίας ενός εργαζομένου στον Εργάνη.

Οι υποβολές καλύπτουν τις υποχρεώσεις αναφοράς Ψηφιακής Κάρτας Εργασίας του εργοδότη βάσει της ελληνικής εργατικής νομοθεσίας.

Δεν υπάρχει εγγύηση idempotency στον server — η επανάληψη υποβολής του ίδιου γεγονότος δημιουργεί δύο εγγραφές.
Υπερισχύει η πιο πρόσφατη υποβολή — μια μεταγενέστερη προσέλευση/αποχώρηση για τον ίδιο εργαζόμενο και ημερομηνία αντικαθιστά την προηγούμενη.
Αυστηροί κανόνες χρονοσφραγίδας — τα γεγονότα πρέπει να αντιστοιχούν στην πραγματική ώρα προσέλευσης/αποχώρησης· οι εκπρόθεσμες υποβολές απαιτούν κωδικούς αιτιολόγησης.
Ο client πρέπει να διαχειρίζεται επαναλήψεις και αποτυχίες — το API δεν επαναλαμβάνει αιτήματα από μόνο του, και ένα αποτυχημένο αίτημα μπορεί είτε να έχει καταγραφεί είτε όχι.

Δείτε τον οδηγό παραγωγικής χρήσης και την αναφορά σφαλμάτων για το πώς να τα διαχειριστείτε στην πράξη.