Η παρούσα έκθεση αφορά την διασαφήνιση του τρόπου εισαγωγής/εξαγωγής δεδομένων προς και από το
CLOUD λογισμικό ωρομέτρησης TimeToWork με τη χρήση γέφυρας Rest API.
Οτιδήποτε δεν περιγράφεται σε αυτή την αναφορά ως υλοποιημένο ή προς υλοποίηση, δεν είναι
υπολογισμένο να πραγματοποιηθεί
στα άμεσα σχέδια των υλοποιήσεων του προγράμματος και μπορεί φυσικά να ζητηθεί
κατ’ επιλογή του πελάτη.
Διαδικασία σύνδεσης
Για να μπορεί να διασυνδεθεί κάποιο πρόγραμμα με το TimeToWork απαιτούνται οι εξής πληροφορίες :
το username
το password
το subdomain
το κλειδί API του συστήματος
Η κοινοποίηση στοιχείων πρόσβασης και κλειδιών API από την πλευρά του χρήστη θα πρέπει να πραγματοποιείται με ασφαλή τρόπο,
μέσω ελέγχου και αποστολής μέσω email, χρησιμοποιώντας πάντα πρωτόκολλα ασφαλούς μεταφοράς δεδομένων (π.χ. SSL/TLS)
Ο χειριστής μπορεί να χρησιμοποιήσει αυτά τα στοιχεία για να διασυνδεθεί με τη γέφυρα ή να προσθέσει και άλλους χειριστές
(χρήστες) μέσα από τη πλατφόρμα του TimeToWork.
Για τη δημιουργία επιπλέον χρηστών ο πελάτης μπορεί να συνδεθεί στη σελίδα
https://(your_subdomain).timetowork.gr
και μέσα από το μενού Χρήστες να δημιουργήσει επιπλέον χρήστες με πρόσβαση στο σύστημα.
Η κοινοποίηση στοιχείων πρόσβασης και κλειδιών API από την πλευρά του χρήστη θα πρέπει να πραγματοποιείται με ασφαλή τρόπο,
μέσω ελέγχου και αποστολής μέσω email, χρησιμοποιώντας πάντα πρωτόκολλα ασφαλούς μεταφοράς δεδομένων (π.χ. SSL/TLS)
Παράδειγμα διασύνδεσης και λήψης κλειδού connectionToken
1. To Connection_token θα πρέπει να το αποθηκευσετε για το τρέχων Session γιατί θα το χρησιμοποιήσετε
σχεδόν σε οποιαδήποτε άλλη σας ενέργεια μέσω API.
2. Το Connection_token_expiration δείχνει μέχρι πότε το τρέχω token έχει ισχύ. Μετά τη λήξη του θα χρειαστεί
να εκδόσετε νεό.Μέχρι τη λήξη του όμως θα πρέπει να χρησιμοποιήσετε το συγκεκριμένο αλλιώς αν εκδίδετε
χωρίς λόγο πολλαπλά token ντός της ημέρας κινδυνεύετε να ενεργοποιήσετε τα security limit rates και το
σύστημα να σας κλειδώσει εκτός σύνδεσης προσωρινά ή μόνιμα.
Ανεπιτυχής απάντηση σύνδεσης
Η απόρριψη μπορεί να γίνει για πολλούς λόγους : λάθους καταχώρησης, ασφαλείας ή απενεργοποιημένης συνδρομής:
API key missing. Please add your Company API key as a Bearer token in the POST request`s Authorization header.
Δεν καταχωρήσατε το apikey ως bearer token, στην αίτηση (POST) που κάνετε.
Company is Inactive - Contact your Supplier
Απενεργοποιημένος λογαριασμός εταιρείας. Ελέγξτε οικονομικές οφειλές σας ή επικοινωνήστε με τον εγκαταστάτη σας.
Χρήστες
Ο χειριστής ή χρήστης του TimeToWork μπορεί να συνδέεται μόνο με τη πλατφόρμα και να κάνει διάφορες ενέργειες.
Η σύνδεση με εξωτερικό πρόγραμμα γίνεται με την χρήση των ίδιων στοιχείων πρόσβασης (username/password) και στη πλατφόρμα του TimeToWork και στο πρόγραμμα του εξωτερικού χρήστη.
H δημιουργία / επεξεργασία / διαγραφή χρηστών μέσα από REST API, στη παρούσα φάση δεν υποστηρίζεται.
Διαχειριστής
Προϊστάμενος
Επίβλεψη συμβάντων (πχ.Φύλακας/Security)
Εγκαταστάτης
Προβολή συμβάντων ωρομέτρησης
Δημιουργία τροποποιημένων συμβάντων ωρομέτρησης
Προβολή αναφορών ωρομέτρησης
Διαχείριση Εργαζομένων
Διαχείριση ωραρίων
Διαχείριση αδειών
Διαχείριση Προϊσταμένων
Διαχείριση Χρηστών
Μενού ρυθμίσεων εφαρμογής
Παραμετροποίηση ωρομετρητών
Τμήματα
α. Δημιουργία Τμήματος
Για την δημιουργία Tμήματος μέσω API χρειάζεται :
το connectionToken
η επιθυμητή ονομασία του.
Στην περίπτωση του υποτμήματος, το ID του κυρίως Τμήματος που ανήκει
** DepartmentParentID : To ID του κυρίως Τμήματος που ανήκει
Επιτυχής απάντηση σύνδεσης:
{
"success": true,
"New_DepartmentID": 16
}
Προσοχή το New_DepartmentID πρέπει να αποθηκεύεται στο συνεργαζόμενο πρόγραμμα προκειμένου να μπορεί να υπάρχει η γέφυρα των δύο προγραμμάτων και να μπορεί να γίνει η μελλοντική επεξεργασία του ή η διαγραφή του μέσω API.
Για την επεξεργασία Tμήματος μέσω API χρειάζεται :
το connectionToken
το ID του Τμήματος (New_DepartmentID) που δόθηκε κατά τη δημιουργία του
στην περίπτωση του υποτμήματος, (προαιρετικά) το ID του κυρίως Τμήματος που ανήκει - αν επιθυμείτε να το αλλάξετε (πχ το υποτμήμα που ανήκει στο τμήμα 1 να το κάνουμε υποτμήμα του Τμήματος 2)
Χρησιμοποιήστε έως και 30 χαρακτήρες για την ονομασία του Τμήματος ή του υποτμήματος
DepartmentName key is required.
Δεν καταχωρήσατε το πεδίο της ονομασίας του Τμήματος. Προσθέστε στη json, key με το πεδίο DepartmentName και έπειτα δώστε τη τιμή με το όνομα που θέλετε.
Department name is empty. Please input your desired Department name.
Το πεδίο με το όνομα του Τμήματος είναι κενό.
Subdepartment but with no Parent Department ID
Το τμήμα ορίστηκε ως υποτμήμα αλλά δεν ορίστηκε το ID του κυρίως Τμήματος του
You are creating a subdepartment but Parent Department ID is not valid
Το τμήμα ορίστηκε ως υποτμήμα αλλά το ID του κυρίως Τμήματος δεν υπάρχει σε αυτή την επιχείρηση/Οργανισμό. Μπορείτε να βρείτε τα ID των Τμημάτων με GET στην αντίστοιχη κατηγορία.
DepartmentID does not exist
Το ID του Τμήματος που διαλέξατε δεν υπάρχει στην επιχείρηση / Οργανισμό.
Duplicate department name
Το τμήμα με αυτή την ονομασία υπάρχει ήδη
Subdepartment but with no Parent Department ID
Το τμήμα ορίστηκε ως υποτμήμα αλλά δεν ορίστηκε το ID του κυρίως Τμήματος του
Department associated with Active Employees
Στο επιλεγμένο Τμήμα είναι ήδη συνδεδεμένοι ενεργοί εργαζόμενοι. Μετακινήστε τους εργαζομένους του σε κάποιο άλλο Τμήμα και μετά διαγράψτε το.
Department ID not found.
Το ID του Τμήματος που επιλέξατε δεν υπάρχει. Επιλέξτε το σωστό ID.
Invalid action specified
Η ενέργεια που επιλέξατε καταχωρήθηκε λάθος. Επιλέξτε μεταξύ create, update, delete αναλόγως της περίπτωσης που σας ενδιαφέρει
Invalid request method or action not specified.
Έχετε επιλέξει λάθος τρόπο αποστολής/ λήψης αποτελεσμάτων (POST/GET κτλ) είτε δεν επιλέξατε την σωστή ενέργεια μεταξύ create/update/delete
DepartmentID is required.
Δεν καταχωρήσατε το ID του Τμήματος
DepartmentID value is expected to be a digit.
Το ID του Τμήματος μπορεί να είναι αποτελείται μόνο από ψηφία.
Only Director role can Create/Modify/Delete Departments
Για να μπορέσετε να δημιουργήσετε/επεξεργαστείτε ή να διαγράψετε κάποιο Τμήμα εργασίας θα πρέπει να συνδεθείτε
με κωδικούς Διαχειριστή του προγράμματος και όχι ως Προϊστάμενος ή Εργαζόμενος
Invalid or expired token
Έχει παρέλθει το χρονικό διάστημα έκδοσης του connection Token και πρέπει να επαναλάβετε την διαδικασία
της αρχικής ταυτοποίησης/σύνδεσης
{
"action": "create",
"shift_type": "steady",
"description": "Morning shift",
"working_days": "Mon,Tue,Wed,Thu,Fri", //Προσοχή σε μορφή 3 γραμμ.αγγλικών
"first_session_entry": "09:00",
"first_session_exit": "12:00",
"second_session_entry": "15:00", //Προαιρετικό αν δεν έχει 2η βάρδια
"second_session_exit": "20:00" //Προαιρετικό αν δεν έχει 2η βάρδια
}
Παράδειγμα δημιουργίας σταθερού ωραρίου / διαφορετικό ανά ημέρα
{
"action": "create",
"shift_type": "weekly",
"first_session_entry": "09:00",
"first_session_exit": "12:00",
"second_session_entry": "15:00", //Προαιρετικό αν δεν έχει 2η βάρδια
"second_session_exit": "20:00", //Προαιρετικό αν δεν έχει 2η βάρδια
"ConnectedDepartmentIDs": "3,4,6" // αν δεν οριστούν θα συνδεθούν όλα τα Τμήματα
}
Προσοχή το New_TimeShiftID πρέπει να αποθηκεύεται στο συνεργαζόμενο πρόγραμμα προκειμένου να μπορεί να υπάρχει η γέφυρα των δύο προγραμμάτων και να μπορεί να γίνει η μελλοντική επεξεργασία του ή η διαγραφή του μέσω API.
{
"action": "update",
"shift_type": "steady",
"TimeshiftID": "11", //To ID που δόθηκε κατά τη δημιουργία του (New_TimeShiftID)
"description": "Morning shift",
"working_days": "Mon,Tue,Wed,Thu,Fri", //Προσοχή σε μορφή 3 γραμμ.αγγλικών
"first_session_entry": "09:00",
"first_session_exit": "12:00",
"second_session_entry": "15:00", //Προαιρετικό αν δεν έχει 2η βάρδια
"second_session_exit": "20:00" //Προαιρετικό αν δεν έχει 2η βάρδια
}
Παράδειγμα επεξεργασίας σταθερού ωραρίου / διαφορετικό ανά ημέρα
{
"action": "update",
"shift_type": "different",
"TimeshiftID": "11", //To ID που δόθηκε κατά τη δημιουργία του
"description": "Mon 08-12 | Tue:09-14 | Fri: 7-11&13-15.30 2256",
"shifts": [
{
"day": "Mon",
"first_session_entry": "08:00",
"first_session_exit": "12:00"
},
{
"day": "Tue",
"first_session_entry": "09:00",
"first_session_exit": "13:00"
},
{
"day": "Fri",
"first_session_entry": "07:00",
"first_session_exit": "11:00",
"second_session_entry": "13:00",
"second_session_exit": "15:30"
}
]
}
Παράδειγμα επεξεργασίας βάρδιας
{
"action": "update",
"shift_type": "weekly",
"TimeshiftID": "11", //To ID που δόθηκε κατά τη δημιουργία του
"working_days": "Mon,Tue,Wed,Thu,Fri", //Προσοχή σε μορφή 3 γραμμ.αγγλικών
"first_session_entry": "09:00",
"first_session_exit": "12:00",
"second_session_entry": "15:00", //Προαιρετικό αν δεν έχει 2η βάρδια
"second_session_exit": "20:00", //Προαιρετικό αν δεν έχει 2η βάρδια
"ConnectedDepartmentIDs": "3,4,6" // αν δεν οριστούν θα συνδεθούν όλα τα Τμήματσ
}
Παράδειγμα επεξεργασίας ελεύθερου ωραρίου
{
"action": "update",
"shift_type": "flexible",
"TimeshiftID": "11", //To ID που δόθηκε κατά τη δημιουργία του
"description": "8 hours flexible",
"working_days": "Mon,Tue,Wed,Thu,Fri",
"dailyHours": "8"
}
Για λόγους ασφαλείας και πρόληψης λαθών, δεν γίνονται διαγραφές βαρδιών για χρονικό διάστημα μεγαλύτερου των 7 ημερών. Η διαδικασία μπορεί φυσικά να επαναληφθεί για άλλο χρονικό διάστημα. Αν ο πελάτης επιθυμεί μπορεί με απόλυτη δική του ευθύνη να μπορεί να διαγράφονται οι βάρδιες για όποιο χρονικό διάστημα επιθυμεί ή ακόμη και χωρίς κανένα απολύτως όριο.
Όταν γίνεται διαγραφή βαρδιών, καταχωρείται και το ID/ & το Ονοματεπ/μο του συνδεδεμένου χρήστη που διέγραψε μαζικά τις βάρδιες στο ιστορικό αλλαγών.
ζ. Επαναφορά άδειας μέσω εβδομαδιαίου προγράμματος
για συγκεκριμένη ημερομηνία και για έναν εργαζόμενο
1. Αφορά μόνο την περίπτωση όπου ο εργαζόμενος είχε καταχωρημένη άδεια και στη συνέχεια,
μέσω του εβδομαδιαίου προγράμματος, η ημέρα μετατράπηκε σε εργασία, ρεπό ή διαγράφηκε.
2. Κατά την επαναφορά, η άδεια επανέρχεται με τον αρχικό τύπο της
(π.χ. αν ήταν αναρρωτική άδεια, θα επανέλθει ως αναρρωτική).
3. Η επαναφορά είναι δυνατή μόνο για ημέρες που έχουν προηγουμένως αφαιρεθεί μέσω του εβδομαδιαίου προγράμματος.
Η επαναφορά πραγματοποιείται ανά ημερομηνία. Στην ίδια κλήση μπορούν όμως (όπως και στο παραπάνω παράδειγμα) να συμπεριληφθούν πολλαπλές ημερομηνίες για τον ίδιο ή για διαφορετικούς εργαζόμενους.
Αν δεν υπάρχει καταγεγραμμένη ακυρωμένη άδεια για την επιλεγμένη ημερομηνία,
επιστρέφεται σχετικό μήνυμα σφάλματος.
Η ενέργεια καταγράφεται στο ιστορικό αλλαγών (Change History),
μαζί με το ID και το ονοματεπώνυμο του χρήστη που την εκτέλεσε.
η. Πίνακας γενικών σφαλμάτων Ωραρίων
Μήνυμα σφάλματος
Περιγραφή προβλήματος
Invalid action specified
Η ενέργεια που επιλέξατε καταχωρήθηκε λάθος. Επιλέξτε μεταξύ create, update, delete αναλόγως της περίπτωσης που σας ενδιαφέρει
Invalid request method or action not specified.
Έχετε επιλέξει λάθος τρόπο αποστολής/ λήψης αποτελεσμάτων (POST/GET κτλ) είτε δεν επιλέξατε την σωστή ενέργεια μεταξύ create/update/delete
TimeShiftID is required.
Δεν καταχωρήσατε το ID του ωραρίου. Το ID σας δόθηκε κατά τη δημιουργία του.
Only Director role can Create/Modify/Delete Timeshifts
Για να μπορέσετε να δημιουργήσετε/επεξεργαστείτε ή να διαγράψετε κάποιο Ωράριο εργασίας θα πρέπει να συνδεθείτε με κωδικούς Διαχειριστή του προγράμματος και όχι ως Προϊστάμενος ή Εργαζόμενος
Invalid start date format for employee xxx. Expected YYYY-DD-MM.
Η ημερομηνία έναρξης ή λήξης του χρονικού διαστήματος διαγραφής των δηλωμένων βαρδιών πρέπει να είναι της μορφής yyyy-dd-mm (ΕΕΕΕ-ΜΜ-ΗΜ)
For security reasons and to prevent accidental changes, you can delete up to 7 days at a time.
Για λόγους ασφαλείας και αποφυγής λαθών, μπορείτε να διαγράψετε έως 7 ημέρες κάθε φορά.
No cancelled vacation found for this employee on the selected date.
Δεν βρέθηκε ακυρωμένη άδεια για τον συγκεκριμένο εργαζόμενο στην επιλεγμένη ημερομηνία.
Εργαζόμενοι
Οι εργαζόμενοι μπορούν να εισαχθούν μέσω της γέφυρας API καταχωρώντας τα εξής στοιχεία
ΟΝΟΜΑ ΕΡΓΑΖΟΜΕΝΟΥ
ΕΠΩΝΥΜΟ ΕΡΓΑΖΟΜΕΝΟΥ
ΠΑΤΡΩΝΥΜΟ ΕΡΓΑΖΟΜΕΝΟΥ
ΜΗΤΡΩΝΥΜΟ ΕΡΓΑΖΟΜΕΝΟΥ
EMAIL ΕΡΓΑΖΟΜΕΝΟΥ
// Δεν απαιτείται, θεωρείται προσωπικό δεδομένο και προϋποθέτει την συγκατάθεση του εργαζόμενου
ΚΙΝΗΤΟ ΕΡΓΑΖΟΜΕΝΟΥ
// Δεν απαιτείται, θεωρείται προσωπικό δεδομένο και προϋποθέτει την συγκατάθεση του εργαζόμενου
EmpTimeShiftID: το ID του ωραρίου (ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ)
EmpHireDate: Ημερ/νια πρόσληψης σε μορφή ΕΕΕΕ-ΜΜ-ΗΜ (yyyy-mm-dd)
EmpTaxNumber: ΑΦΜ εργαζομενου
Emp3dPartyID: το ID του εργαζόμενου στο συνεργαζόμενο πρόγραμμα 3d Party (ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ)
CardNumberPart1: τα 5 πρώτα ψηφία της κάρτας του εργαζόμενου
(ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ μόνο αν η επιχείρηση έχει hardwarecontrollers)
CardNumberPart2: τα 5 τελευταία ψηφία της κάρτας του εργαζόμενου
(ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ μόνο αν η επιχείρηση έχει hardwarecontrollers)
AccessPoints: τα ID των καρταναγνωστών που θέλουμε να έχει πρόσβαση ο εργαζόμενος, σε μορφή 3ψηφίων πχ 001 για τον πρώτο, 002 για τον δεύτερο κτλ.
(ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ μόνο αν η επιχείρηση έχει hardwarecontrollers)
EmpCanEmployeeWorkAfterMidnight:
1: ο εργαζόμενος μπορεί να εργάζεται και μετά τα μεσάνυχτα και το πρωτο συμβαν της ημερας ως λήξη θεωρείται λογικό αφού μπορεί να λήγει τότε η βραδινή βάρδια του (πχ εργαζόμενοι με βραδινές εναλλασσόμενες βάρδιες)
0: ο εργαζόμενος δεν αναμένεται να δουλεύει μετά τα μεσάνυχτα. Πρώτο συμβάν της ημέρας ως λήξη σημαίνει ότι ο εργαζόμενος ξέχασε να χτυπήσει την έναρξη της ημέρας και εμφανίζεται ως σφάλμα (πχ εργαζόμενοι με πρωινό - σταθερό ωράριο)
(Αν δεν καταχωρηθεί καθόλου η παράμετρος θεωρείται ως προεπιλογή το 1ο σενάριο `μπορεί να εργαστεί και μετά τα μεσάνυχτα`)
Επιτυχής απάντηση σύνδεσης:
[
{ "success": true,
"message": "Employee created successfully",
"Employee Last Name": "ΠΕΤΡΟΓΛΟΥ",
"Employee First Name": "ΓΙΑΝΝΗΣ",
"3dPartyID": "008"
"TimeToWorkEmployeeID": 17
},
{ "success": true,
"message": "Employee created successfully",
"Employee Last Name": "ΔΙΑΜΑΝΤΙΔΗΣ",
"Employee First Name": "ΝΙΚΟΣ",
"3dPartyID": "009"
"TimeToWorkEmployeeID": 18
}
]
Αν η επιχείρηση έχει access control - κάρταναγνώστες λαμβάνετε και μία πληροφορία
για την/τις κάρτα/ες που εστάλη προς ενεργοποίηση
[{
"success": true,
"message": "Employee created successfully",
"Employee Last Name": "ΠΕΤΡΟΓΛΟΥ",
"Employee First Name": "ΓΙΑΝΝΗΣ",
"Card Status": {
"status": "success",
"message": "Card sent and executed successfully." //Η κάρτα φαίνεται να ενεργοποιήθηκε στο καρταναγνώστη
},
"TimeToWorkEmployeeID": 1,
"3dPartyID": "167"
}, {
"success": true,
"message": "Employee created successfully",
"Employee Last Name": "ΔΙΑΜΑΝΤΙΔΗΣ",
"Employee First Name": "ΝΙΚΟΣ",
"Card Status": {
"status": "warning",
"message": "Card sent but not confirmed as executed in a 15sec(s) time-period. Please verify card status." // Η κάρτα δεν φαίνεται να ενεργοποιήθηκε στο χρονικό διάστημα των 15 δευτ. Ελέγξτε τη σωστή λειτουργία της.
},
"TimeToWorkEmployeeID": 2,
"3dPartyID": "145"
}]
Για την επεξεργασία Εργαζόμενου μέσω API χρειάζεται :
το connectionToken
το ID του εξωτερικού χρήστη του συνεργαζόμενου προγράμματος
Προσοχή! Τροποποιούνται μόνο τα πεδία που καταχωρούνται στην εντολή json.
Όλα τα υπόλοιπα πεδία παραμένουν αμετάβλητα από την καταχώρηση της εισαγωγής του Εργαζόμενου. Αν δεν εντοπιστούν αλλαγές το σύστημα δεν πραγματοποιεί κάποια αλλαγή.
Emp3dPartyID: το ID του εργαζόμενου στο συνεργαζόμενο πρόγραμμα 3d Party (ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ)
EmpFirstName: Όνομα
EmpLastName: Επίθετο
EmpFatherName: Πατρώνυμο
EmpMotherName: Μητρώνυμο
EmpDepartmentID: το ID του Τμήματος εργασίας
EmpTimeShiftType: S: σταθερο, W: εβδομαδιαίο
EmpTimeShiftID: το ID του σταθερού ωραρίου. To ID των σταθερών ωραρίων δίνεται κατά τη δημιουργία τους.
Αν ο εργαζόμενος εργάζεται με βάρδιες ακολουθείται η διαδικασία της αντιστοίχισης εβδομαδιαίου ωραρίου / βαρδιών και αυτό το πεδίο παραλείπεται.
EmpHireDate: Ημερ/νια πρόσληψης
EmpTaxNumber: ΑΦΜ εργαζομενου
CardNumberPart1: τα 5 πρώτα ψηφία της κάρτας του εργαζόμενου
CardNumberPart2: τα 5 τελευταία ψηφία της κάρτας του εργαζόμενου
AccessPoints: τα ID των καρταναγνωστών που θέλουμε να έχει πρόσβαση ο εργαζόμενος
EmployeeStatus: 1 Ενεργοποίηση/Επαναφορά εργαζομένου ή 0: Διαγραφή/Απενεργοποίηση εργαζόμενου
EmpCanEmployeeWorkAfterMidnight:
1: ο εργαζόμενος μπορεί να εργάζεται και μετά τα μεσάνυχτα και το πρωτο συμβαν της ημερας ως λήξη θεωρείται λογικό αφού μπορεί να λήγει τότε η βραδινή βάρδια του (πχ εργαζόμενοι με βραδινές εναλλασσόμενες βάρδιες)
0: ο εργαζόμενος δεν αναμένεται να δουλεύει μετά τα μεσάνυχτα. Πρώτο συμβάν της ημέρας ως λήξη σημαίνει ότι ο εργαζόμενος ξέχασε να χτυπήσει την έναρξη της ημέρας και εμφανίζεται ως σφάλμα (πχ εργαζόμενοι με πρωινό - σταθερό ωράριο)
Επιτυχής απάντηση σύνδεσης:
[{ "success": true,"message": "Employee modified successfully",
"Employee Last Name": "ΠΕΤΡΟΓΛΟΥ",
"Employee First Name": "ΓΙΑΝΝΗΣ",
"TimeToWorkEmployeeID": 1,
"3dPartyID": "111"
}, {
"success": true,
"message": "No changes made - Nothing to Change!",
"Employee Last Name": "ΑΝΤΩΝΙΟΥ",
"Employee First Name": "ΝΙΚΟΣ",
"TimeToWorkEmployeeID": 2, "3dPartyID": "112"}]
Σημ. Ο εργαζόμενος δεν διαγράφεται ποτέ από το σύστημα TimeToWork. Απλά εμφανίζεται ότι δεν εργάζεται πλέον στην επιχείρηση και απενεργοποιείται η κάρτα ωρομέτρησης του.
Για την διαγραφή Εργαζόμενου μέσω API χρειάζεται :
το connectionToken
το ID του εξωτερικού χρήστη του συνεργαζόμενου προγράμματος
Η κάρτα εργασίας έχει ήδη καταχωρηθεί στο παρελθόν σε άλλο Εργαζόμενο. Δεν μπορείτε να την καταχωρήσετε ξανά σε άλλο Εργαζόμενο. Μόνο να τροποποιήσετε τα στοιχεία του παλαιού Εργαζόμενου στα στοιχεία του νέου.
Emp3dPartyID already connected to another Employee ID
Το ID εξωτερικού χρήστη που καταχωρήσατε είναι ήδη συνδεδεμένο με άλλο Εργαζόμενο
Steady shift but missing timeshift ID
Ο Εργαζόμενος ορίστηκε ότι εργάζεται με σταθερό ωράριο αλλά δεν επιλέχθηκε το σχετιζόμενο ωράριο του
Employee TaxNumber -wrong format
Το ΑΦΜ του εργαζομένου δεν είναι σωστό (πχ. το προσωπικό ΑΦΜ για την Ελλάδα είναι 9 αριθμητικά ψηφία)
This card is already connected to another Employee
Η κάρτα εργασίας έχει ήδη αποδοθεί σε άλλο Εργαζόμενο. Οι κάρτες συνδέονται με κάθε Εργαζόμενο και δεν μπορούν να συνδέονται και μεταξύ άλλων (ενεργών η μη) εργαζομένων.
Missing CardNumber1 Data
Ο εργαζόμενος ορίστηκε ότι εργάζεται σε σύστημα με κάρτες αλλά δεν καταχωρήσατε τα πρώτα 5 ψηφία της
CardNumber2 is in wrong format
Τα τελευταία 5 ψηφία της κάρτας δεν είναι σωστά (ο αριθμός των 5 πρώτων ή τελευταίων ψηφίων απ είναι 00000-65535)
Card Number1 is correct but Card Number2 is empty
Καταχωρήσατε μόνο το 1ο τμήμα της κάρτας
Card Number2 is correct but Card Number1 is empty
Καταχωρήσατε μόνο το 2ο τμήμα της κάρτας
Manager can NOT create an Employee in this Department ID
‘Εχετε συνδεθεί ως Προϊστάμενος και δε μπορείτε να εισάγετε Εργαζόμενο σε αυτό το Τμήμα εργασίας
Access Point ID is missing
Δεν καταχωρήσατε ID πρόσβασης εργαζομένου. Το πεδίο είναι υποχρεωτικό ακόμα και αν υπάρχει μόνο ένα πεδίο πρόσβασης
Requested Access PointID is not in correct format
Έχετε επιλέξει ένα ή παραπάνω ID πρόσβασης εργαζομένου με λάθος στοιχεία
Employee should be connected with a Department ID
Ο εργαζόμενος πρέπει να ανήκει σε κάποιο Τμήμα εργασίας
Employee timeshift type - Wrong format
Ο τύπος εργασίας του Εργαζόμενου (EmpTimeShiftType) μπορεί να είναι είτε S (Σταθερό ωράριο είτε W (βάρδια σε εβδομαδιαία βάση)
You have reached your current Employee Max Limit. You cannot create any more Employees. Please upgrade your current subscription plan.
Η τρέχουσα συνδρομή σας δεν σας επιτρέπει να δημιουργήσετε νέους εργαζόμενους διότι έχει φτάσει το ανώτατο όριο εργαζομένων. Παρακαλούμε αναβαθμίστε τη συνδρομή σας σε μεγαλύτερο όριο.
Σημ. Υπολογίζονται πάντα οι ΕΝΕΡΓΟΙ εργαζόμενοι και όχι όποιοι έχουν αποχωρήσει από την Επιχείρηση/Οργανισμό.
Άδειες
Για την δημιουργία αδείας χρειάζονται τα εξής στοιχεία :
το ID του εξωτερικού χρήστη του συνεργαζόμενου προγράμματος
Τη περίπτωση (create/update/delete)
Το ApiKey που της εταιρείας
Η επιλογή μεταξύ άδειας 24 ωρών ή άδεια ωρών
Το ID της αιτίας άδειας (δείτε το σχετικό §11α )
Την ημερομηνία που θα ξεκινήσει η άδεια
Την ημερομηνία που θα λήξει
(αν είναι ολίγων ωρών θα αγνοηθεί)
Την ώρα έναρξης (αν είναι 24ωρών θα αγνοηθεί)
Την ώρα λήξης (αν είναι 24ωρών θα αγνοηθεί)
Αν θα είναι επιβεβαιωμένη άδεια ή απλά αίτηση
(Τη παρούσα χρονική στιγμή δεν υποστηρίζεται μέσω RestAPI η δημιουργία αίτησης αδείας αλλά μόνο η επιβεβαιωμένη)
Προσοχή : Οι Προϊστάμενοι μπορούν να δημιουργούν άδειες μόνο για εργαζόμενους που ανήκουν στο(α) Τμήμα(τα) που έχουν δικαιοδοσία. Οι Διαχειριστές δεν έχουν κανένα περιορισμό.
Invalid holiday reason ID for chosen Vacation length type.
Δόθηκε περίοδος αδείας μίας ή περισσότερης ημέρας αλλά η αιτία αδείας ανήκει σε άδεια ολιγόωρη ή το αντίστροφο δόθηκε άδεια ολιγόωρη με αιτία αδείας που ανήκει σε άδεια ημερών.
Overlapping vacations days for same time period
Υπάρχουν ήδη άδειες που συμπίπτουν στο ίδιο χρονικό διάστημα για τον Εργαζόμενο
Employee is not active working in Company
Ο εργαζόμενος έχει αποχωρήσει από την επιχείρηση
VacationID not available in your Country
Η Αιτία αδείας που έχετε επιλέξει δεν είναι διαθέσιμη στη χώρα σας.
Manager Cant create a Vacation for this Employee
‘Εχετε συνδεθεί ως Προιστάμενος και δε μπορείτε να δημιουργήσει άδεια για τον συγκεκριμένο Εργαζόμενο (προφανώς βρίσκεται σε Τμήμα εκτός δικαιοδοσίας του)
No VacationLengthType chosen
Πρέπει να επιλέξετε το τύπο της άδειας
//AllDay : ολοήμερη, PartDay: ολιγόωρη
No employee found with the provided ID
Δεν βρέθηκε εργαζόμενος στη συγκεκριμένη επιχείρηση με το δηλωμένο EmployeeID
Missing or wrong format of StartTime
Επιλέχθηκε ολιγόωρη άδεια εργαζομένου και δεν καταχωρήθηκε η ώρα έναρξης της άδειας
Missing or wrong format of EndTime
Επιλέχθηκε ολιγόωρη άδεια εργαζομένου και δεν καταχωρήθηκε η ώρα λήξης της άδειας
Start date cannot be later than end date
Η ημερ/νια έναρξης της άδειας πρέπει να είναι ίδια ή προγενέστερη της ημερ/νιας λήξης της.
VacationLengthType Incorrect. Please choose either AllDay or PartDay.
Πρέπει να επιλέξετε μεταξύ AllDay (ολοήμερου τύπου άδεια) ή PartDay (ολιγόωρη εντός της ίδιας ημέρας)
β. Επεξεργασία άδειας
Για τη παρούσα φάση οι άδειες δέχονται επεξεργασία μόνο ως προς τον λόγο που δόθηκε η άδεια. Για την επεξεργασία Άδειας μέσω API χρειάζεται :
‘Εχετε συνδεθεί ως Προϊστάμενος και δε μπορείτε να διαγράψετε άδεια για τον συγκεκριμένο Εργαζόμενο (προφανώς βρίσκεται σε Τμήμα εκτός δικαιοδοσίας του)
Vacation ID not found.
Δεν βρέθηκε κάποια άδεια εργαζομένου με τέτοιο αριθμό (VacationID).
δ. Πίνακας σφαλμάτων αδειών
Μήνυμα σφάλματος
Περιγραφή προβλήματος
Invalid action specified
Η ενέργεια που επιλέξατε καταχωρήθηκε λάθος. Επιλέξτε μεταξύ create, update, delete αναλόγως της περίπτωσης που σας ενδιαφέρει
Invalid request method or action not specified.
Έχετε επιλέξει λάθος τρόπο αποστολής/ λήψης αποτελεσμάτων (POST/GET κτλ) είτε δεν επιλέξατε την σωστή ενέργεια μεταξύ create/update/delete
This VacationReasonID is not available. Please try another one.
Ο αριθμός VacationReasonID Που αντιστοιχεί στην αιτία αδείας δεν είναι σωστός. Επιλέξτε το σωστό αριθμό αιτίας.
Company ApiKey is required.
Δεν καταχωρήσατε το APIKEY της επιχείρησης σας μέσα στην εντολή.
Wrong ApiKey_xxx
Καταχωρήσατε εσφαλμένο ApiKey
Ωρομέτρηση
Η ωρομέτρηση στο TimeToWorkμπορεί να
πραγματοποιείται μέσω :
·Hardware Ωρομετρητήμε χρήση καρτών προσέγγισης RF
·Rest API (3rd Party software)
H διαδικασία ωρομέτρησης μέσω Rest API (3rd Party software) στη παρούσα φάση υποστηρίζει μόνο τη ωρομέτρηση με την καταχώρηση του αριθμό της κάρτας ωρομέτρησης ή του Εργανη QRCode του εργαζόμενου και μόνο πλήρως CLOUD εγκαταστάσεις (χωρίς hardware συσκευές ωρομετρησης
Ο αριθμός της κάρτας που καταχωρήσατε δεν αντιστοιχεί σε κάποιο Εργαζόμενο της επιχείρησης.
CardNumber2 is in wrong format
Ο αριθμός κάρτας έχει καταχωρηθεί λάθος. Η αρίθμηση είτε για τα πρώτα 5 ψηφία είτε για τα τελευταία είναι αριθμός 5 ψηφίων από το 00001 έως το 65535.
Invalid EventWay type.
Τη παρούσα χρονική στιγμή ο μοναδικός τρόπος εισαγωγής δεδομένων είναι μέσω του αριθμού της κάρτας του εργαζόμενου.
Διαθέσιμες επιλογές για το πεδίο type : [“card digits"]
Invalid JSON data
Κάτι καταχωρήσατε λάθος στην εντολή Json.
Wrong ApiKey_C112
Ο αριθμός APIKEY είναι λάθος. Βεβαιωθείτε ότι καταχωρήσατε το σωστό apikey της επιχείρησης.
You are not allowed to create attendance with Future Datetime value (maximum 5 minutes difference)
Η ημερομηνία και η ώρα του συμβάντος δε μπορεί να έχει διαφορά μεγαλύτερη των 5 λεπτών από την τρέχουσα ώρα και ημέρα
You are not allowed to create attendance with Past Datetime value (maximum 5 minutes difference)
Η ημερομηνία και η ώρα του συμβάντος δε μπορεί να έχει διαφορά μεγαλύτερη των 5 λεπτών από την τρέχουσα ώρα και ημέρα
This company doesnt allow Employees to attend via 3rd party POSTS.
Η επιχείρηση δεν επιτρέπει την δημιουργία συμβάντων ωρομέτρησης μέσω 3rd party POST API.
Μαζική διαγραφή δεδομένων
Για την διευκόλυνση των δοκιμών, συνήθως
κατά τη διασύνδεση με νέο συνεργαζόμενο πρόγραμμα, προστέθηκε η δυνατότητα της
διαγραφής δοκιμαστικών δεδομένων της πλατφόρμας μέσω API.
Η διαγραφή αυτή αφορά στη παρούσα έκδοση
:
·Τους Εργαζόμενους
·Τις άδειες
·Τα ωράρια
·Το πρόγραμμα εργασίας (βάρδιες)
Η διαγραφεί μπορεί να γίνει τμηματικά
(μόνο οι άδειες, τα ωράρια ή το πρόγραμμα εργασίας ή και πλήρως με τη διαγραφή
όλων των παραπάνω. Οι εργαζόμενοι δε μπορούν να διαγραφούν χωρίς τη διαγραφή
των υπολοίπων διότι δημιουργείται πρόβλημα στη διασύνδεση των ‘ορφανών΄
δεδομένων.
MassDeletionExtrakey
Ταυτόχρονα με την ενεργοποίηση αυτής της
δυνατότητας για την επιχείρηση σας, θα σας αποσταλεί σε εμαιλ το MassDeletionExtrakey που απαιτείται για τη συγκεκριμένη
ενέργεια. Το κλειδί αυτό μπορεί να έχει χρονικό ορίζοντα λειτουργίας είτε ενός
μηνός από την ώρα αποστολής του είτε απεριόριστο, σύμφωνα με τις ανάγκες του
έργου σας.
Για την διαγραφή των δοκιμαστικών δεδομένων
μέσω API χρειάζεται :
- διαφορετικών ωραρίων ανά ημέρα
αλλά σταθερών ανά εβδομάδα
- ελεύθερων ωραρίων.
Η διαγραφή αφορά όλους τους
Εργαζόμενους.
Κατά τη διαγραφή όλοι οι
εργαζόμενοι ρυθμίζονται να εργάζονται σε εβδομαδιαίο ωράριο προκειμένου να
υπάρχει κάποιο ωράριο συσχετισμένο με αυτούς.
-mass_delete_timetable
διαγραφή όλων των προγραμμάτων εργασιών των
Εργαζομένων. Η διαγραφή αφορά όλες τις βάρδιες χωρίς χρονικό περιορισμό αλλά δε
διαγράφει τις βάρδιες σαν ωράριο.
-mass_delete_weekly_shifts
διαγραφή όλων των βαρδιών των Εργαζομένων.
Η διαγραφή αφορά όλες τις βάρδιες χωρίς χρονικό περιορισμό και κατ’ επέκταση
και όλα τα υφιστάμενα προγράμματα εργασιών χωρίς χρονικό περιορισμό.
-mass_delete_vacations
διαγραφή
όλων των αδειών όλων των Εργαζομένων χωρίς χρονικό περιορισμό.
-mass_delete_all
διαγραφή
όλων των ανωτέρω καθώς και των δεδομένων συσχετισμένα με τους Εργαζόμενους
(προσωπικές ρυθμίσεις, πρόσβαση σε καρταναγνώστες, ακύρωση όλων των καρτών
πρόσβασης, Ιστορικού αναφοράς τροποποιήσεων), Ιστορικού συμβάντων, Αναφορών
εργασιών, Τμημάτων εργασίας, μετρητών/δεικτών εργασίας, ρυθμίσεις αποστολών σε
Εργαζομένους)
Προσοχή οι
διαγραφές αυτές γίνονται μόνο εφόσον είναι απαραίτητο για τις δοκιμές του
συστήματος , οριστικά και χωρίς τη δυνατότητα επαναφοράς τους
‘Έχετε συνδεθεί ως
Προϊστάμενος και δε μπορείτε να προβείτε σε μαζικές διαγραφές. Μόνο οι
διαχειριστές μπορούν να προβούν σε τέτοιες ενέργειες και πάντα εφόσον έχει
ενεργοποιηθεί αυτή η δυνατότητα στη συγκεκριμένη επιχείρηση/πλατφόρμα.
Your company
is not allowed to mass Delete Data. Contact your Technical supervisor.
Δεν έχει ενεργοποιηθεί η
δυνατότητα μαζικών διαγραφών για αυτή την επιχείρηση. Επικοινωνήστε με τον
τεχνικό σας υπεύθυνο για την αναγκαιότητα μίας τέτοιας ενεργοποίησης.
Your mass
deletion key is not correct
Το κλειδί μαζικής διαγραφής
που εισάγατε δεν είναι σωστό.
Your mass
deletion key is expired.
Το κλειδί μαζικής διαγραφής
που εισάγατε δεν είναι πλέον ενεργό. Επικοινωνήστε με τον τεχνικό σας
υπεύθυνο για την επαν-ενεργοποίηση του.
Action not
specified.
Δεν επιλέξατε μία αναμενόμενη
ενέργεια. Παρακαλούμεεπιλέξτεμεταξύτωνεπιλογών
Δεν υπάρχουν δεδομένα να
διαγραφούν για την επιλογή που επιλέξατε
Λήψη πληροφοριών (GET)
α. Λήψη ID διαθέσιμών κατηγοριών αδειών
Για να μάθετε το συσχετισμό της περιγραφής της κάθε Άδειας με το σχετικό ID που θα χρειαστείτε για την έκδοση μίας, μπορείτε να λάβετε τις πληροφορίες μέσω GET με τη παρακάτω διαδικασία:
Οι άδειες αφορούν τις συνήθεις αιτίες άδειας σε Ελλάδα, Γερμανία, Κύπρο και Ουκρανία που εξάγεται, τη παρούσα χρονική στιγμή, το πρόγραμμα. Στο μέλλον μπορούν να προστεθούν επιπλέον χώρες όταν προκύψει ενδιαφέρον από νέες χώρες.
Οι μεταφρασμένοι λόγοι στα Ελληνικά για τις άδειες φαίνονται στο παρακάτω πίνακα:
ID
Αγγλική περιγραφή
Ελληνική περιγραφή
Άδεια ωρών
1
Vacations
Κανονική
2
Maternity
Προστασίας της μητρότητας
3
Paternity
Πατρότητας
4
Getting Married
Γάμου
5
Death Of Close Relative
Θάνατος κοντινού συγγενή
6
Provide assistance (medical or other)
Φροντιστή
7
Educational-Exams
Εκπαιδευτική - Εξετάσεων
8
Being a Parent
Γονική
9
Not being able to reach Job
Αδυναμία προσέλευσης στον εργασιακό χώρο
10
Giving Blood
Αιμοδοσίας
11
Special Leave for Single Parents
Ειδική μονογονεϊκή άδεια
12
Monitoring child development in school
Άδεια παρακολούθησης σχολικής επίδοσης τέκνου
13
Childcare when child is sick
‘Αδεια λόγω ασθένειας παιδιού ή άλλου εξαρτ.μέλους
14
Childcare
Φροντίδας τέκνου
15
COVID
Ειδική άδεια COVID
24
Adopt a child
Άδεια υιοθεσίας
16
Military Service
Στρατιωτική θητεία
25
Sick
Αναρρωτική
26
NoPayment
‘Ανευ αποδοχών
27
Special Maternity Leave
Ειδική άδειας προστασίας μητρότητας
28
Leave for Election
‘Αδεια εκλογών
29
Leave for Prenatal Examinations and Gynecological Check-up
Άδεια Προγεννητικών Εξετάσεων και Γυναικολογικού Ελέγχου
β. Λήψη σημείων πρόσβασης επιχείρησης (Access Point IDs)
Το ενδιαφέρον αυτής της λήψης αφορά μόνο εγκαταστάσεις που βρίσκονται εγκατεστημένοι HardWare Controllers, προκειμένου να γνωρίζει το σύστημα από ποια σημεία πρόσβασης μπορεί να κάνει ωρομέτρηση ο κάθε Εργαζόμενος.
Ta σημεία που επιστρέφονται με TimeAttendance : 0 σημαίνει ότι δε μπορεί να γίνει ωρομέτρηση από εκεί γιατί χρησιμοποιούνται αποκλειστικά για χρήση Access Control.
Αν η εταιρεία δεν έχει εγκατεστημένα μηχανήματα - ωρομετρητές - Access Control και λειτουργεί αποκλειστικά με softwareUnits (πχ κινητά τηλέφωνα ή Tablet) θα λάβετε την απάντηση :
Αν η τιμή είναι 1 σημαίνει ότι το Τμήμα είναι υποτμήμα άλλου Τμήματος
ParentDepartmentLevel1
Αυτή η τιμή δείχνει το ID του κυρίως Τμήματος για το συγκεκριμένο Υποτμήμα.
DoesDepartmentHaveSemiHolidayEmployees
Αν η εταιρεία ανήκει στον Δημόσιο Τομέα στην Ελλάδα εμφανίζεται στο σύστημα TimeToWork η επιλογή να υπάρχουν οι ημι-αργίες. Αν οι εργαζόμενοι του Τμήματος έχουν αυτή τη δυνατότητα φαίνεται στη παράμετρο ως τιμή 1.
δ. Λήψη Ωραρίων επιχείρησης (Timeshifts)
Με αυτή την μέθοδο λαμβάνουμε τα διαθέσιμα ωράρια της Επιχείρησης στις 4 κατηγορίες που υπάρχουν :
Περιγραφή
Υποστηρίζει 2 βάρδιες την ίδια μέρα
Σταθερό με ίδιες ώρες ανά ημέρα
Σταθερό ανά εβδομάδα με διαφορ.ώρες/ ημέρα
Βάρδια
Ελεύθερο
Μπορούμε να τα λάβουμε και τα 4 ή ξεχωριστά ανά περίπτωση διαλέγοντας τη κατάλληλη παράμετρο url - endpoint ανά περίπτωση:
Η επικοινωνία με τη πλατφόρμα TimeToWork μέσω της γέφυρας REST API υπόκειται σε περιορισμούς ασφαλείας για την προστασία του τελικού χρήστη.
Οι περιορισμοί αυτοί γίνονται σταδιακά και επηρεάζονται από την συχνότητα των συνδέσεων, τον αριθμό των προσπαθειών, το χρόνο και τη μέθοδο προσπάθειας πολλαπλών συνδέσεων στη γέφυρα. Οι περιορισμοί αυτοί μπορούν να είναι είτε με τη προσωρινή διακοπή των συνδέσεων για λίγα λεπτά, ώρες ή και μόνιμα με τη προσθήκη blacklist, αναλόγως του τύπου της προσπάθειας.
Αναλόγως της περίπτωσης ,αν κριθεί αναγκαίο, μπορεί να οριοθετηθεί και γεωπεριορισμός των συνδέσεων προς τη πλατφόρμα με βάση την IPσύνδεσης του χρήστη.
Οι λεπτομέρειες περιορισμού δεν είναι προς κοινοποίηση πέραν του ήδη αναφερθέντος χρονικού περιθωρίου για το connectionToken.
Το connectionToken όπως προ-αναφέρθηκε έχει διάρκεια ζωής 60 λεπτών και απαιτείται η επανέκδοση του του, μόνο αν λήξει,με τη επανάληψη της προαναφερθείσας διαδικασίας (επαναπιστοποίηση/reauthentication). Η συνεχής και αναίτια λήψη νέων Bearer Token(αν πχ έχουν εκδοθεί τοκεν που δεν έληξαν) μπορεί να ενεργοποιήσει το ημερήσιο όριο τους και να μπλοκαριστεί η επανέκδοση νεότερων για 24ώρες.
Παραδείγματα μηνυμάτων ασφαλείας & Γεωπεριορισμού
Μήνυμα σφάλματος
Περιγραφή προβλήματος
Blocked due to country restrictions.
Προσπαθήσατε να συνδεθείτε στη πλατφόρμα εταιρείας από IP που προέρχεται από μη επιτρεπόμενη Χώρα. Αν είναι ανάγκη να συνδέεστε και από άλλες χώρες μπορείτε είτε να τις δηλώσετε ή να ζητήσετε να απελευθερώσουμε τελείως αυτόν τον περιορισμό.
You are temporarily blocked due to too many requests. Please try in a minute.
Κάνατε πολλές προσπάθειες σύνδεσης και το σύστημα ενεργοποίησε το ratelimit block. Προσπαθήστε ξανά σε ένα λεπτό.
Αν θεωρείτε ότι το μήνυμα αυτό ενεργοποιήθηκε χωρίς να κάνετε πολλές προσπάθειες, μπορείτε να μας ζητήσετε να το βελτιώσουμε.
You are temporarily blocked due to too many requests. Please try again in 10 minutes.
Κάνατε πολλές προσπάθειες σύνδεσης και το σύστημα ενεργοποίησε το ratelimit block. Προσπαθήστε ξανά σε 10 λεπτά.
Αν θεωρείτε ότι το μήνυμα αυτό ενεργοποιήθηκε χωρίς να κάνετε πολλές προσπάθειες, μπορείτε να μας ζητήσετε να το βελτιώσουμε.
You are temporarily blocked due to too many requests. Please try again in 24 Hours.
Κάνατε πολλές προσπάθειες σύνδεσης και το σύστημα ενεργοποίησε το ratelimit block. Προσπαθήστε ξανά σε 24ώρες.
Αν θεωρείτε ότι το μήνυμα αυτό ενεργοποιήθηκε χωρίς να κάνετε πολλές προσπάθειες, μπορείτε να μας ζητήσετε να το βελτιώσουμε.
You have input a wrong username/password/apikey
more than X times.
You are temporarily blocked.
Try again in ‘Z’
Κάνατε πολλές αποτυχημένες προσπάθειες σύνδεσης και το σύστημα ενεργοποίησε το blacklist limitblock.
Προσπαθήστε ξανά στο χρονικό διάστημα ‘Z’.
To χρονικό διάστημα Z μπορεί να είναι από 1, λεπτό 10 λεπτά, μία ώρα ή και οριστικό μπλοκάρισμα αναλόγως των προσπαθειών / συχνότητας προσπαθειών / Χώρας προέλευσης κτλ.
Αν θεωρείτε ότι το μήνυμα αυτό ενεργοποιήθηκε χωρίς να κάνετε πολλές προσπάθειες, μπορείτε να μας ζητήσετε να το βελτιώσουμε.
Εκδόσεις (Versioning)
Οποιαδήποτε μεταβολή έκδοσης δε λειτουργεί αντεπίστροφα, ακυρώνοντας αυτομάτως τις προηγούμενες εκδόσεις.
Για σημαντικές αναμενόμενες μεταβολές εκδόσεων ενημερώνεται ο πελάτης στα εμαιλ επικοινωνίας του προτού
δοθούν στην πραγματική χρήση, προκειμένου να ολοκληρωθούν οι όποιες αναμενόμενες μεταβολές και από τη πλευρά του.
23 Απριλίου 2026
1.26
ΔΙΟΡΘΩΣΗΔιαγραφή άδειας κατά τη διαγραφή της μέσω του εβδομαδιαίου προγράμματος.
ΝΕΟΝέα παράμετρος (recall_vacation) στον εβδομαδιαίο πίνακα – Δυνατότητα επαναφοράς άδειας μέσω του προγράμματος (αφορά μόνο άδειες που είχαν δοθεί και ακυρώθηκαν μέσω του εβδομαδιαίου προγράμματος).
22 Απριλίου 2026
1.25
ΔΙΟΡΘΩΣΗΜείωση ή διάσπαση άδειας και επαναϋπολογισμός ημερών άδειας στην περίπτωση που δοθεί σε εργαζόμενο εργάσιμη ημέρα στο εβδομαδιαίο του πρόγραμμα, ενώ βρίσκεται ήδη σε άδεια.
16 Απριλίου 2026
1.24
ΝΕΟΔυνατότητα εισαγωγής των πεδίων email και κινητού τηλεφώνου του εργαζόμενου
09 Ιανουαρίου 2026
1.23
ΒΕΛΤΙΩΣΗΌταν υποβάλλεται αίτημα άδειας που ξεκινά και ολοκληρώνεται σε διαφορετικό ημερολογιακό έτος, η άδεια διαχωρίζεται αυτόματα ανά έτος και δημιουργούνται δύο ξεχωριστές άδειες (μία για κάθε έτος).
27 Οκτωβρίου 2025
1.22
ΝΕΟΠροσθήκη δυνατότητας ωρομέτρησης μέσω της εισαγωγής των στοιχείων της κάρτας ωρομέτρησης και του κειμένου QRCODE του Εργάνη του Εργαζόμενου
29 Σεπτεμβρίου 2025
1.21
ΔΙOΡΘΩΣΗΜικρές διορθώσεις σε κενά που υπήρχαν σε κάποια endpoint urls