Skip to main content

Βασικές Έννοιες

Διαβάστε αυτή τη σελίδα πριν τις Ροές Εργασίας. Εξηγεί τις πέντε ιδέες που κάνουν το σύστημα Κάρτας Εργασίας του Εργάνη κατανοητό — όχι σύνταξη API, μόνο το νοητικό μοντέλο.

Γεγονός Κάρτας Εργασίας​

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

Κάθε γεγονός περιλαμβάνει:

  • ποιος — ο εργαζόμενος (ΑΦΜ, ονοματεπώνυμο)
  • πότε — η ακριβής χρονοσφραγίδα της προσέλευσης/αποχώρησης
  • σε ποια εργάσιμη ημέρα ανήκει (η "ημερομηνία αναφοράς")

Στέλνετε γεγονότα στον Εργάνη σε πραγματικό χρόνο, όπως συμβαίνουν.

Προσέλευση vs. αποχώρηση​

  • Προσέλευση — ο εργαζόμενος φτάνει.
  • Αποχώρηση — ο εργαζόμενος φεύγει.

Μια κανονική ημέρα παράγει ακριβώς μία προσέλευση και μία αποχώρηση. Ένα διακεκομμένο ωράριο (ο εργαζόμενος φεύγει και ξαναγυρίζει μέσα στην ημέρα) παράγει περισσότερα — δείτε Διακεκομμένα ωράρια.

Η ημερομηνία αναφοράς​

Κάθε γεγονός ανήκει σε μια ημερομηνία αναφοράς — την εργάσιμη ημέρα στην οποία προσμετράται, που δεν είναι απαραίτητα η ημερολογιακή ημερομηνία της χρονοσφραγίδας.

Αυτό έχει σημασία για τις νυχτερινές βάρδιες. Αν ένας εργαζόμενος κάνει προσέλευση στις 21:00 τη Δευτέρα και αποχώρηση στις 05:00 την Τρίτη, και τα δύο γεγονότα έχουν ημερομηνία αναφοράς Δευτέρα — ανήκουν στην ίδια βάρδια.

Κύκλος ζωής μιας υποβολής​

Κάθε γεγονός που στέλνετε περνά από τον ίδιο κύκλο ζωής:

  1. Υποβάλλετε ένα γεγονός προσέλευσης ή αποχώρησης.
  2. Το Εργάνη το επικυρώνει (ο εργαζόμενος υπάρχει, η Κάρτα Εργασίας είναι ενεργή γι' αυτόν, οι χρονοσφραγίδες έχουν λογική).
  3. Έγινε δεκτό → το Εργάνη επιστρέφει έναν αριθμό protocol. Το γεγονός είναι πλέον μέρος του επίσημου φακέλου του εργαζομένου.
  4. Απορρίφθηκε → το Εργάνη επιστρέφει 400 Bad Request με ένα message που εξηγεί τον λόγο. Τίποτα δεν καταγράφεται.

Δεν υπάρχει κατάσταση "σε εκκρεμότητα" — μια υποβολή γίνεται δεκτή ή απορρίπτεται αμέσως, στην ίδια απάντηση.

Τι σημαίνει ο αριθμός πρωτοκόλλου​

Η τιμή protocol (π.χ. "ΕΥΣ92") που επιστρέφεται σε επιτυχία είναι η απόδειξη αποδοχής. Είναι:

  • μοναδική για αυτή την υποβολή,
  • απαραίτητη αν χρειαστεί ποτέ να ανακτήσετε το υποβληθέν έγγραφο ως PDF,
  • αυτό που καταγράφετε για σκοπούς ελέγχου (audit).

Καμία τιμή protocol στην απάντηση σημαίνει ότι το γεγονός δεν καταγράφηκε. Θεωρήστε "έγινε δεκτό" και "έχει protocol" ως το ίδιο πράγμα.

Εμπρόθεσμη vs. εκπρόθεσμη υποβολή​

Το Εργάνη μετρά τον χρόνο ανάμεσα στο ίδιο το γεγονός (f_date) και στη στιγμή που το υποβάλλετε. Αν αυτή η διαφορά είναι 15 λεπτά ή λιγότερο (± 1 λεπτό), το γεγονός είναι εμπρόθεσμο και το f_aitiologia πρέπει να είναι null.

Αν η διαφορά είναι πάνω από 15 λεπτά, το γεγονός είναι εκπρόθεσμο, και η υποβολή απορρίπτεται εκτός αν δώσετε κωδικό αιτιολόγησης στο f_aitiologia. Οι κωδικοί αιτιολόγησης καλύπτουν μόνο περιπτώσεις ανωτέρας βίας (διακοπή ρεύματος/τηλεπικοινωνιών, βλάβη συστήματος) — δείτε Εκπρόθεσμες & δικαιολογημένες υποβολές.

Πρακτικός κανόνας: υποβάλετε κάθε γεγονός εντός 15 λεπτών από τη στιγμή που συνέβη. Αν το σύστημά σας δεν μπορεί να το εγγυηθεί (offline συσκευές, batch συγχρονισμοί), διαβάστε Αποτυχία δικτύου κατά το request πριν φτιάξετε τη λογική επανάληψης (retry).

Διορθώσεις, όχι επεξεργασίες​

Δεν υπάρχει endpoint "επεξεργασίας" ή "διαγραφής" για γεγονότα Κάρτας Εργασίας. Για να διορθώσετε ένα λάθος, υποβάλετε ένα νέο γεγονός του ίδιου τύπου, για τον ίδιο εργαζόμενο και ημερομηνία αναφοράς — το πιο πρόσφατο κερδίζει. Δείτε Διορθώσεις.

Τι ακολουθεί​