Η παρούσα έκθεση αφορά την διασαφήνιση του τρόπου εισαγωγής/εξαγωγής δεδομένων προς και από το
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.
Πεδίο ID και αλλαγή μόνο των συνδεδεμένων τμημάτων
Στα αιτήματα update και delete χρησιμοποιήστε timeshiftID, ακριβώς με αυτή τη γραφή και με λατινικούς χαρακτήρες. Η τιμή είναι το ID που λάβατε ως New_TimeShiftID. Τα πεδία απάντησης New_TimeShiftID, Updated_TimeShiftID και το ξεχωριστό πεδίο εργαζομένου EmpTimeShiftID δεν αλλάζουν. Για συμβατότητα γίνεται δεκτή και μία παλαιότερη λατινική γραφή του πεδίου εισόδου· οι διασυνδέσεις πρέπει να χρησιμοποιούν το επίσημο timeshiftID. Αν σταλούν ταυτόχρονα διαφορετικά ID, επιστρέφεται 400 CONFLICTING_TIMESHIFT_IDS, χωρίς αλλαγή ωραρίου.
Για αλλαγή μόνο των τμημάτων μιας υπάρχουσας βάρδιας weekly, στείλτε το παρακάτω JSON με το ενεργό Bearer token στο POST /Utility/API/3PS/Timeshifts.php:
Σε αυτή την ειδική ενημέρωση δεν στέλνονται πεδία ωρών: διατηρούνται οι αποθηκευμένες ώρες, η δεύτερη περίοδος και τα υπόλοιπα στοιχεία του ωραρίου. Το DepartmentIDs γίνεται επίσης δεκτό ως συμβατή γραφή του ConnectedDepartmentIDs σε weekly update. Δεν επιλέγονται αυτόματα όλα τα τμήματα σε αυτό το αίτημα. Τα τμήματα ελέγχονται στην εταιρεία του token και διατηρείται ο υπάρχων έλεγχος διπλής βάρδιας με ίδιες ώρες και κοινά τμήματα. Αν στείλετε πεδία ωρών, ισχύει το υπάρχον συμβόλαιο πλήρους ενημέρωσης βάρδιας των παραδειγμάτων που ακολουθούν.
Ασύμβατες ταυτόχρονες λίστες τμημάτων: 400 CONFLICTING_DEPARTMENT_IDS. Μη έγκυρο ID ή λίστα: 422 INVALID_TIMESHIFT_ID / INVALID_DEPARTMENT_IDS. Τμήμα άλλης εταιρείας ή ανύπαρκτο τμήμα: 422 DEPARTMENT_NOT_FOUND. Η επιτυχία αφορά την αποθήκευση στο TimeToWork· το cloudSync παραμένει ξεχωριστό αποτέλεσμα συγχρονισμού.
Για την επεξεργασία ωραρίου μέσω API χρειάζεται :
το connectionToken
το ID του ωραρίου που δόθηκε κατά την δημιουργία του
{
"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"
}
Κάποιο(α) από τα ID των Τμημάτων που επιλέξατε να συσχετιστούν με το ωράριο δεν υπάρχουν.
Invalid Timeshift ID for this company
Το ωράριο με το επιλεγμένο ID δεν υπάρχει.
The description for Timeshift cannot be empty
Η περιγραφή του επιλεγμένου ωραρίου δεν μπορεί να είναι κενή
Employee doesn't exist in this Company
Ο εργαζόμενος που επιλέξατε δεν υπάρχει στην επιχείρηση. Ελέξτε ξανά το σχετικό 3dParty ID του.
Timeshift description key (description) is required
Δεν καταχωρήσατε το πεδίο της ονομασίας του Ωραρίου. Προσθέστε στη json, key με το πεδίο description και έπειτα δώστε τη τιμή με το όνομα που θέλετε.
Invalid format: Department IDs should be digits separated by commas.
Πρέπει να καταχωρήσετε ένα ή περισσότερα τμήματα με το ID τους διαχωρισμένα με κόμμα (πχ 1,3,5)
Chosen description exists in another timeshift. Please choose a different one.
H επιλεγμένη ονομασία ωραρίου έχει ήδη καταχωρηθεί σε άλλο ωράριο.
Time must be in 24-hour format HH:MM, e.g., 14:30
Το ωράριο πρέπει να έχει τη μορφή 24ωρης ώρας πχ. 14:30 (Δυόμιση το μεσημέρι…)
Please input days of timeshift in format of 3 letters Day1,Day2 i.e. Mon,Tue,Fri etc...
Παρακαλούμε καταχωρήστε τις ημέρες σε 3χαρ μορφή στα Αγγλικά χωρισμένα με κόμματα
πχ Mon,Wed,Fri
(μτφ: Δευτέρα Τετάρτη, Παρασκευή…)
Duplicate day found: xxx. Please remove duplicates.
Βρέθηκε διπλή καταχώρηση ημέρας μέσα στο δηλωμένο ωράριο εβδομάδας (πχ Δευτ- 09-17, Τρίτη 10-15 και ξανα Δευτ- 10-14)
Πρέπει να δηλώνετε μόνο μία φορά την κάθε ημέρα στο ωράριο
A timeshift with the same hours already exists in one or more selected departments.
Η δημιουργία ή τροποποίηση της βάρδιας απορρίφθηκε, επειδή υπάρχει ήδη βάρδια με τις ίδιες ώρες σε ένα ή περισσότερα από τα επιλεγμένα Τμήματα. Αλλάξτε τις ώρες ή αφαιρέστε τα κοινά Τμήματα. Ίδιες ώρες επιτρέπονται όταν οι βάρδιες αφορούν εντελώς διαφορετικά Τμήματα.
ε. Δημιουργία εβδομαδιαίου πίνακα – Συσχετισμός βαρδιών Εργαζομένων
Η επεξεργασία και η δημιουργία προγράμματος βαρδιών γίνεται με τον ίδιο τρόπο.
Για την δημιουργία/επεξεργασία βαρδιών μέσω API χρειάζεται :
Για λόγους ασφαλείας και πρόληψης λαθών, δεν γίνονται διαγραφές βαρδιών για χρονικό διάστημα μεγαλύτερου των 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": "SAMPLE_SURNAME_A",
"Employee First Name": "SAMPLE_NAME_A",
"3dPartyID": "008"
"TimeToWorkEmployeeID": 17
},
{ "success": true,
"message": "Employee created successfully",
"Employee Last Name": "SAMPLE_SURNAME_B",
"Employee First Name": "SAMPLE_NAME_B",
"3dPartyID": "009"
"TimeToWorkEmployeeID": 18
}
]
Αν η επιχείρηση έχει access control - κάρταναγνώστες λαμβάνετε και μία πληροφορία
για την/τις κάρτα/ες που εστάλη προς ενεργοποίηση
[{
"success": true,
"message": "Employee created successfully",
"Employee Last Name": "SAMPLE_SURNAME_A",
"Employee First Name": "SAMPLE_NAME_A",
"Card Status": {
"status": "success",
"message": "Card sent and executed successfully." //Η κάρτα φαίνεται να ενεργοποιήθηκε στο καρταναγνώστη
},
"TimeToWorkEmployeeID": 1,
"3dPartyID": "167"
}, {
"success": true,
"message": "Employee created successfully",
"Employee Last Name": "SAMPLE_SURNAME_B",
"Employee First Name": "SAMPLE_NAME_B",
"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": "SAMPLE_SURNAME_A",
"Employee First Name": "SAMPLE_NAME_A",
"TimeToWorkEmployeeID": 1,
"3dPartyID": "111"
}, {
"success": true,
"message": "No changes made - Nothing to Change!",
"Employee Last Name": "SAMPLE_SURNAME_C",
"Employee First Name": "SAMPLE_NAME_C",
"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.
Η τρέχουσα συνδρομή σας δεν σας επιτρέπει να δημιουργήσετε νέους εργαζόμενους διότι έχει φτάσει το ανώτατο όριο εργαζομένων. Παρακαλούμε αναβαθμίστε τη συνδρομή σας σε μεγαλύτερο όριο.
Σημ. Υπολογίζονται πάντα οι ΕΝΕΡΓΟΙ εργαζόμενοι και όχι όποιοι έχουν αποχωρήσει από την Επιχείρηση/Οργανισμό.
Άδειες
API v1.33 · 02/11/2026
Ποιο ID αποθηκεύω και χρησιμοποιώ;
Πεδίο
Χρήση
VacationID
Μία συγκεκριμένη καταχώριση ή ένα ετήσιο τμήμα άδειας. Χρησιμοποιείται για update ή διαγραφή αυτού του τμήματος άδειας.
mergedVacID
Κοινό σημείο αναφοράς μιας πολυετούς άδειας. Χρησιμοποιείται για διαγραφή ολόκληρης της ομάδας. Δεν χρησιμοποιείται ως παράμετρος για update.
MergedPeriod
Η αρχική συνολική περίοδος της ομάδας, με StartDate και EndDate. Δεν αποτελεί υπολογισμό από τα αποτελέσματα της τρέχουσας σελίδας.
VacationReasonID
Κατηγορία άδειας από το GetVacationIDs.php, όχι ID καταχώρισης ή ομάδας.
Emp3dPartyID
Το δικό σας εξωτερικό ID εργαζομένου, στην εταιρεία της σύνδεσης. Η ίδια τιμή σε άλλη εταιρεία δεν δηλώνει τον ίδιο εργαζόμενο.
Τα IDs προκύπτουν από την απάντηση του API
Αποθηκεύστε τα IDs μαζί με την εταιρεία της σύνδεσης. Μην παράγετε IDs, μην υποθέτετε ότι είναι συνεχόμενα και μην κάνετε υπολογισμούς ανάμεσα σε IDs. Το πεδίο VacationID παραμένει το δημόσιο συμβόλαιο για τις καταχωρίσεις· δεν απαιτείται νέα παράμετρος επιλογής βάσης. Τα πρόσθετα πεδία CloudVacationID, όπου επιστρέφονται, δεν αντικαθιστούν το VacationID στα αιτήματα.
Έτοιμο για δοκιμές · 31/08/2026
Προσαρμοσμένοι τύποι αδειών μέσω API
Η διασύνδεση μπορεί πλέον να διαβάζει τον πραγματικό κατάλογο τύπων αδειών της συνδεδεμένης εταιρείας και να δημιουργεί, με ασφαλή και επαναλήψιμο τρόπο, έναν νέο εταιρικό τύπο. Δεν δημιουργούνται ούτε μεταβάλλονται καθολικοί τύποι αδειών του TimeToWork.
Και οι δύο μέθοδοι απαιτούν ενεργό Bearer token με δικαίωμα Vacations. Το POST απαιτεί επιπλέον το 16-χαρακτήρων CompanyApiKey. Token, API key και subdomain πρέπει να ανήκουν στην ίδια εταιρεία· το CompanyID δεν επιλέγεται από τον caller.
GET · Λήψη του ενεργού καταλόγου
GET /Utility/API/3PS/VacationTypes.php HTTP/1.1
Host: (subdomain).timetowork.gr
Authorization: Bearer token_...
Accept: application/json
Η πρώτη επιτυχής δημιουργία επιστρέφει HTTP 201 και created: true. Η επανάληψη του ίδιου αιτήματος επιστρέφει HTTP 200, created: false και ακριβώς το ίδιο VacationReasonID. Αν το ίδιο external ID σταλεί με διαφορετικά δεδομένα, επιστρέφεται HTTP 409 με κωδικό external_id_conflict.
ExternalVacationTypeID
Υποχρεωτικό, σταθερό και case-sensitive ID 1–128 ASCII χαρακτήρων.
Description
Αγγλική τεχνική περιγραφή έως 150 χαρακτήρες. Αν λείπει, παράγεται σταθερή Greeklish περιγραφή.
GreekTranslation
Ελληνική περιγραφή έως 200 χαρακτήρες. Απαιτείται τουλάχιστον μία από τις δύο περιγραφές.
VacationLengthType
Ακριβώς AllDay ή PartDay.
Server-side ασφάλεια: η δημιουργία, η αντιστοίχιση, η αποφυγή διπλοεγγραφών και το audit εκτελούνται αποκλειστικά από το TimeToWork. Η εφαρμογή τρίτου χρησιμοποιεί μόνο το δικό της ExternalVacationTypeID και το επιστρεφόμενο VacationReasonID, χωρίς πρόσβαση σε εσωτερικά στοιχεία υποδομής ή credentials.
Χρήση του επιστρεφόμενου τύπου σε άδεια
Το VacationReasonID που επιστρέφεται χρησιμοποιείται στο υπάρχον /Utility/API/3PS/Vacations.php. Το VacationLengthType του αιτήματος άδειας πρέπει να συμφωνεί με τον τύπο.
Όλα τα παραδείγματα είναι ενδεικτικά και οι απαντήσεις δείχνουν βασικά πεδία. Στείλτε Authorization: Bearer connectionToken και Content-Type: application/json. Απαιτείται λογαριασμός Διαχειριστή με δικαίωμα Vacations. Το token, το 16-χαρακτήρων CompanyApiKey και το subdomain πρέπει να αφορούν την ίδια εταιρεία. Παραμένουν ενεργοί οι έλεγχοι αντιστοίχισης εργαζομένου και έγκρισης άδειας.
Πεδίο
Τιμή / κανόνας
action
"create"
CompanyApiKey
API key της εταιρείας.
Emp3dPartyID
Ήδη αντιστοιχισμένο εξωτερικό ID εργαζομένου.
VacationLengthType
AllDay / PartDay
VacationReasonID
Το επιστρεφόμενο id ενεργής, κατάλληλης κατηγορίας από το GET κατηγοριών.
StartDate, EndDate
YYYY-MM-DD · StartDate <= EndDate
StartTime, EndTime
Για PartDay, σε μορφή HH:MM:SS.
allow_long_period
Προαιρετικό JSON boolean, προεπιλογή false. Μόνο για AllDay.
Πολυετής άδεια: ετήσια τμήματα άδειας και κοινό ID
Η ολοήμερη άδεια χωρίζεται στα όρια κάθε ημερολογιακού έτους. Χωρίς allow_long_period: true ισχύει όριο 365 ημερολογιακών ημερών για ολόκληρο το αίτημα, συμπεριλαμβανομένων πρώτης και τελευταίας ημέρας. Με true επιτρέπεται μεγαλύτερη περίοδος. Ακόμη και περίοδος μικρότερη των 365 ημερών δημιουργεί ετήσια τμήματα άδειας αν αλλάζει έτος. Ένα πλήρες δίσεκτο έτος 366 ημερών χρειάζεται true.
Η απάντηση επιστρέφει όλα τα VacationIDs, το κοινό mergedVacID και την αρχική συνολική MergedPeriod, τόσο στην κορυφή όσο και σε κάθε Parts. Φυλάξτε και τα επιμέρους IDs και το κοινό ID. Τα RealDays ανά τμήμα άδειας και το VacationRealDays συνολικά υπολογίζονται από τα ωράρια και τις αργίες· τα IDs του παραδείγματος δεν είναι πραγματικές καταχωρίσεις.
Παλαιότερες διασπασμένες άδειες
Η παρουσία κοινής ομάδας επιβεβαιώνεται μόνο από το επιστρεφόμενο mergedVacID. Μην ενώνετε μόνοι σας παλιές καταχωρίσεις επειδή έχουν συνεχόμενες ημερομηνίες. Όταν δεν υπάρχει ομάδα, τα πεδία μεταδεδομένων του GET είναι null.
Άδεια μέσα σε ένα έτος
Παραμένει η απάντηση με ένα VacationID. Το παρακάτω είναι υποσύνολο των πεδίων της απάντησης.
Η άδεια ωρών απαιτεί ίδια StartDate και EndDate. Τα 1 και 29 στα παραδείγματα κατηγοριών είναι ενδεικτικά: επιλέξτε το ID που επιστρέφει η δική σας εταιρεία για ολοήμερη άδεια ή άδεια ωρών αντίστοιχα. Οι σημαίες δέχονται JSON boolean true/false, όχι "true", 1 ή "false". Το ConfirmedStatus δεν αποτελεί υποστηριζόμενη επιλογή δημιουργίας.
Οι ημερομηνίες πρέπει να είναι υπαρκτές και συμβατές με την απασχόληση του εργαζομένου. Το allow_long_period δεν παρακάμπτει επικάλυψη, δικαιώματα ή έγκριση. Για αβέβαιη έκβαση ή χαμένη απάντηση αναζητήστε πρώτα την περίοδο με GET, πριν επαναλάβετε δημιουργία.
API v1.33 · 02/11/2026
Επικάλυψη: ποια καταχώριση και ποιο διάστημα;
Για ολοήμερη άδεια, η απόρριψη 409 VACATION_OVERLAP διατηρεί το υπάρχον μήνυμα και προσθέτει συγκεκριμένα IDs και περιόδους. Δεν αποθηκεύεται νέα άδεια. Η αποτυχία επικάλυψης άδειας ωρών μπορεί να επιστραφεί ως 409 VACATION_CREATE_FAILED, χωρίς τον αναλυτικό πίνακα Conflicts.
{
"success": false,
"code": "VACATION_OVERLAP",
"message": "Overlapping vacations days for same time period. No changes were saved.",
"RequestedPeriod": {
"StartDate": "2026-09-18",
"EndDate": "2027-06-17"
},
"ConflictSummary": "VacationID 20005 covers 2027-01-01 to 2027-06-17; overlapping interval: 2027-01-01 to 2027-06-17.",
"Conflicts": [
{
"VacationID": 20005,
"StartDate": "2027-01-01",
"EndDate": "2027-06-17",
"OverlapStartDate": "2027-01-01",
"OverlapEndDate": "2027-06-17"
}
],
"ConflictsTruncated": false
}
Πεδίο
Περιγραφή
RequestedPeriod
Ολόκληρη η περίοδος που ζητήσατε.
Conflicts[].VacationID
Η καταχώριση που εμποδίζει τη δημιουργία· το ίδιο ID χρησιμοποιείται στο update/delete.
StartDate / EndDate
Η πραγματική πλήρης περίοδος της υπάρχουσας άδειας.
OverlapStartDate / OverlapEndDate
Το συγκεκριμένο κοινό διάστημα με το αίτημά σας.
ConflictsTruncated
Αν είναι true, επιστρέφονται μόνο οι πρώτες 50 επικαλύψεις. Συνεχίστε τον έλεγχο με GET.
Το παράδειγμα εξηγεί γιατί μια άδεια του επόμενου έτους μπορεί να εμποδίζει την επανακαταχώριση, ακόμη κι αν το τμήμα άδειας του τρέχοντος έτους έχει διαγραφεί. Μην διαγράφετε αυτόματα τις εγγραφές του Conflicts χωρίς έλεγχο.
API v1.33 · 02/11/2026
Αποθήκευση, συγχρονισμός και ασφαλής επανάληψη
Οι απαντήσεις μεταβολής περιλαμβάνουν πρόσθετο cloudSync: αντικείμενο για μία καταχώριση, πίνακα για πολλά ετήσια τμήματα άδειας. Το success: true δεν αναιρείται από αποτυχία του πρόσθετου συγχρονισμού. Αν cloudSync.ok: false και localSaved: true, η άδεια έχει ήδη καταχωριστεί: μην επαναλάβετε τη δημιουργία. Με κωδικό VACATION_MASTER_LOCAL_OK_CLOUD_FAILED ζητήστε τεχνικό έλεγχο. Το retryDurable: false δεν αποτελεί εγγύηση αυτόματης επανάληψης· η άμεση εμφάνιση στο GET μπορεί να καθυστερεί.
Αν η απάντηση δηλώνει localSaved: true και ExecutionConfirmed: true, μην αντιμετωπίσετε το αίτημα ως μη εκτελεσμένο μόνο από το HTTP status. Με ExecutionConfirmed: false η έκβαση είναι αβέβαιη: αναζητήστε πρώτα τον εργαζόμενο και την περίοδο, πριν δοκιμάσετε ξανά. Μην χρησιμοποιείτε το τεχνικό cloudSync.LocalVacationID ως παράμετρο του API.
Όλα τα παραδείγματα είναι ενδεικτικά και οι απαντήσεις δείχνουν βασικά πεδία. Στείλτε Authorization: Bearer connectionToken και Content-Type: application/json. Απαιτείται λογαριασμός Διαχειριστή με δικαίωμα Vacations. Το token, το 16-χαρακτήρων CompanyApiKey και το subdomain πρέπει να αφορούν την ίδια εταιρεία. Παραμένουν ενεργοί οι έλεγχοι αντιστοίχισης εργαζομένου και έγκρισης άδειας.
Το update αλλάζει μόνο την αιτία μίας καταχώρισης, όχι τις ημερομηνίες ή τις ώρες. Χρησιμοποιήστε VacationID και VacationNewReasonID. Το mergedVacID δεν υποστηρίζεται ως παράμετρος για update.
Η νέα προαιρετική παράμετρος allow_modify_merged_vac έχει προεπιλογή false. Αν το VacationID ανήκει σε ομάδα, απαιτείται ρητά true. Αλλάζει μόνο το συγκεκριμένο τμήμα άδειας, όχι όλα τα τμήματα άδειας. Για άδεια χωρίς ομάδα η παράμετρος δεν απαιτείται.
Χωρίς την επιβεβαίωση επιστρέφεται 409 MERGED_VACATION_MODIFICATION_REQUIRES_OPT_IN με τα στοιχεία της ομάδας. Λανθασμένος τύπος της σημαίας επιστρέφει 422 INVALID_ALLOW_MODIFY_MERGED_VAC.
API v1.33 · 02/11/2026
γ. Διαγραφή ενός τμήματος άδειας ή ολόκληρης ομάδας
Όλα τα παραδείγματα είναι ενδεικτικά και οι απαντήσεις δείχνουν βασικά πεδία. Στείλτε Authorization: Bearer connectionToken και Content-Type: application/json. Απαιτείται λογαριασμός Διαχειριστή με δικαίωμα Vacations. Το token, το 16-χαρακτήρων CompanyApiKey και το subdomain πρέπει να αφορούν την ίδια εταιρεία. Παραμένουν ενεργοί οι έλεγχοι αντιστοίχισης εργαζομένου και έγκρισης άδειας.
Στείλτε ακριβώς μία παράμετρο: VacationID ή mergedVacID. Δεν χρειάζεται allow_modify_merged_vac για διαγραφή. Η εταιρεία και τα δικαιώματα του token εξακολουθούν να ελέγχονται.
Τα δύο παραδείγματα είναι εναλλακτικά. Η ομαδική απάντηση περιλαμβάνει τα IDs των τμημάτων άδειας που διαγράφηκαν σε αυτή την κλήση· αν ένα τμήμα άδειας έχει ήδη διαγραφεί, δεν περιλαμβάνεται ξανά. Η απλή διαγραφή διατηρεί το πεδίο VacationID στην απάντηση.
Η διαγραφή ενός έτους δεν διαγράφει τα άλλα έτη
Αν διαγράψετε μόνο το τμήμα άδειας του 2026 και ξαναστείλετε όλη την περίοδο 2026–2027, το ενεργό τμήμα άδειας του 2027 θα εξακολουθεί να δημιουργεί επικάλυψη. Αναζητήστε όλες τις χρονιές με GET ή χρησιμοποιήστε το γνωστό mergedVacID όταν επιθυμείτε διαγραφή ολόκληρης της ομάδας.
API v1.33 · 02/11/2026
Σφάλματα δημιουργίας και διαχείρισης αδειών
HTTP
code
Ενέργεια εφαρμογής
422
VACATION_PERIOD_TOO_LARGE
Περίοδος άνω των 365 ημερών: προσθέστε JSON allow_long_period: true, μόνο αν επιθυμείτε τη μεγάλη περίοδο.
422
INVALID_ALLOW_LONG_PERIOD
Η τιμή πρέπει να είναι JSON boolean.
422
LONG_PERIOD_ALL_DAY_ONLY
Η επιλογή ισχύει μόνο για AllDay.
422
PART_DAY_SINGLE_DATE_REQUIRED
Η άδεια ωρών πρέπει να αφορά μία ημερομηνία.
422
INVALID_VACATION_ID
Η τιμή της παραμέτρου πρέπει να είναι θετικός ακέραιος ή ψηφιακό string, έως 2147483647.
409
VACATION_OVERLAP
Διαβάστε Conflicts και τις ακριβείς ημερομηνίες.
409
MERGED_VACATION_MODIFICATION_REQUIRES_OPT_IN
Επιβεβαιώστε ότι θέλετε αλλαγή μόνο αυτού του τμήματος άδειας και στείλτε allow_modify_merged_vac: true.
422
INVALID_ALLOW_MODIFY_MERGED_VAC
Η τιμή πρέπει να είναι JSON boolean.
422
VACATION_UPDATE_REQUIRES_PART_ID
Στο update χρησιμοποιήστε ένα VacationID, όχι mergedVacID.
422
VACATION_SELECTOR_REQUIRED
Στο delete δώστε ακριβώς ένα από VacationID, mergedVacID.
404
VACATION_NOT_FOUND
Το ID δεν βρέθηκε στην εταιρεία της σύνδεσης. Επανελέγξτε με GET.
409
ADVANCED_VACATIONS_APPROVAL_REQUIRED
Απαιτείται η προβλεπόμενη διαδικασία έγκρισης.
503
VACATION_SAVE_STATE_UNKNOWN
Με ExecutionConfirmed: false, ελέγξτε με GET πριν επαναλάβετε δημιουργία.
409
VACATION_CREATE_FAILED
Αποτυχία άδειας ωρών, π.χ. επικάλυψη ή μη έγκυρες ώρες. Ελέγξτε τα στοιχεία και το μήνυμα.
Προσωρινά μη διαθέσιμη λειτουργία ή έλεγχος πολιτικής. Απαιτείται τεχνικός έλεγχος.
Η μεταβολή εφαρμόζεται μόνο στην εταιρεία της σύνδεσης και στον εργαζόμενο που επιτρέπεται από τα δικαιώματα. Μην θεωρείτε κάθε 409 σφάλμα διάρκειας. Ελέγχετε μαζί HTTP status, success, code και τα πρόσθετα στοιχεία της απάντησης. Ορισμένες παλαιότερες απορρίψεις επικύρωσης εξακολουθούν να επιστρέφουν μόνο success: false και message, ακόμη και με HTTP 200.
Μήνυμα σφάλματος
Περιγραφή προβλήματος
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.
Δεν επιλέξατε μία αναμενόμενη
ενέργεια. Παρακαλούμεεπιλέξτεμεταξύτωνεπιλογών
Κλήση μόνο ανάγνωσης με ενεργό Bearer token Διαχειριστή και δικαίωμα Vacations, στο subdomain της ίδιας εταιρείας. Επιστρέφει τις ενεργές, μη διαγραμμένες καταχωρίσεις του εργαζομένου, μαζί με τα ετήσια τμήματα άδειας και τα μεταδεδομένα ομάδας.
Query parameter
Κανόνας
3dPartyEmpID
Υποχρεωτικό εξωτερικό ID. Δέχεται επίσης Emp3dPartyID· αν δοθούν και τα δύο, πρέπει να συμφωνούν.
StartDate, EndDate
Προαιρετικά, YYYY-MM-DD. Επιτρέπεται μία ημερομηνία, και οι δύο ή καμία. Δεν υπάρχει προεπιλεγμένο φίλτρο τρέχοντος έτους.
VacationLengthType
Προαιρετικό: FullDay ή PartDay. Το AllDay γίνεται επίσης δεκτό αντί του FullDay.
Limit / Offset
Προεπιλογές 100 / 0. Μέγιστο Limit: 500.
GET /Utility/API/3PS/GETData/GetEmployeeVacations.php?3dPartyEmpID=7001&StartDate=2026-08-10&EndDate=2028-04-03&VacationLengthType=FullDay HTTP/1.1
Host: (subdomain).timetowork.gr
Authorization: Bearer connectionToken
Accept: application/json
Χωρίς ημερομηνίες μπορείτε να διαβάσετε όλες τις χρονιές του εργαζομένου, ακολουθώντας τη σελιδοποίηση:
GET /Utility/API/3PS/GETData/GetEmployeeVacations.php?3dPartyEmpID=7001&Limit=100&Offset=0
Τα φίλτρα περιόδου χρησιμοποιούν επικάλυψη, όχι μόνο ημερομηνία έναρξης. Η απάντηση διατηρεί τις πραγματικές ημερομηνίες κάθε τμήματος άδειας. Στείλτε φίλτρα στο URL, όχι JSON body. Άγνωστες / επαναλαμβανόμενες παράμετροι και μη έγκυρες ημερομηνίες απορρίπτονται.
Χωρίς ομάδα επιστρέφονται mergedVacID: null και MergedPeriod: null. Η MergedPeriod παραμένει η αρχική συνολική περίοδος ακόμη κι αν τα φίλτρα / η σελιδοποίηση εμφανίζουν μόνο ένα τμήμα άδειας. Το Status αφορά την άδεια, όχι την αποστολή της στο ΕΡΓΑΝΗ.
Αν HasMore: true, επαναλάβετε τα ίδια φίλτρα με Offset = NextOffset. Κενό αποτέλεσμα: success: true, Vacations: []. Στις καταχωρίσεις επιστρέφεται AllDay / PartDay, ενώ το FullDay είναι η ονομασία φίλτρου. Για άδεια ωρών τα StartTime / EndTime επιστρέφονται ως HH:MM:SS.
Χρησιμοποιήστε το VacationID για επεξεργασία ή διαγραφή
Αποθηκεύστε το VacationID που επιστρέφει αυτό το GET. Δεν χρειάζεται δική σας αντιστοίχιση ανάμεσα σε βάσεις. Το πρόσθετο CloudVacationID μπορεί να έχει ίδια αριθμητική τιμή σε ενημερωμένες εγκαταστάσεις· μην βασίζετε τη λογική σας στην ισότητα ή διαφορά τους. Σε παλαιότερες καταχωρίσεις μπορεί να επιστραφεί VacationID: null: τότε δεν υπάρχει διαθέσιμο ID για μεταβολή μέσω του υπάρχοντος API. Μην αντικαθιστάτε αυτή την τιμή με CloudVacationID· ζητήστε έλεγχο της καταχώρισης. Το VacationReasonID μπορεί επίσης να είναι null.
Σφάλματα GET
400 μη έγκυρα φίλτρα · 401 μη έγκυρη σύνδεση · 403 δικαιώματα / εταιρεία · 404 employee_not_found · 405 · 409 ambiguous_employee · 429 · 503. Οι απαντήσεις περιλαμβάνουν requestId.
Απαιτείται ενεργό Bearer token και το ξεχωριστό δικαίωμα GetVacationIDs.
Μη χρησιμοποιείτε σταθερή αρίθμηση κατηγοριών
Χρησιμοποιείτε πάντα το id που επιστρέφει ο κατάλογος της συγκεκριμένης εταιρείας ως VacationReasonID ή VacationNewReasonID. Εταιρείες με custom κατηγορίες μπορεί να έχουν διαφορετικά αριθμητικά IDs για τις ίδιες περιγραφές. Τα νέα είδη αδειών προστίθενται χωρίς να απαιτείται αλλαγή των ήδη χρησιμοποιούμενων custom IDs.
Πεδία απάντησης
Πεδίο
Σημασία
id
ID κατηγορίας για την εταιρεία της σύνδεσης.
Description
English description
GreekTranslation
Ελληνική απόδοση ή null.
DisplayName
Περιγραφή για εμφάνιση: ελληνική απόδοση όταν υπάρχει, αλλιώς Description.
IsItPartDay
0: ολοήμερη · 1: ώρες.
AllDayVacation
"1": ολοήμερη · "0": ώρες.
Greece, Germany, Cyprus, Ukraine
Σημαίες χώρας του καταλόγου. Για εταιρικές κατηγορίες ελέγχονται η εταιρεία και ο τύπος διάρκειας· ο παλαιότερος κοινός κατάλογος εφαρμόζει και περιορισμούς χώρας.
Το 84 είναι μόνο ενδεικτικό ID. Ο κατάλογος της σύνδεσής σας είναι η πηγή των πραγματικών IDs. Μην συγχέετε τις κατηγορίες (GetVacationIDs) με τις καταχωρισμένες άδειες (GetEmployeeVacations).
Νέες ελληνικές κατηγορίες — προσθήκες 02/11/2026
Description
Ελληνική περιγραφή
Διάρκεια
Disability Parent Reduced Hours
Μειωμένο ωράριο γονέα παιδιού με αναπηρία
Ώρες
Bereaved Parent Leave
Άδεια πενθούντος γονέα
Ολοήμερη
Gynecological Check-up Leave
Άδεια γυναικολογικού ελέγχου
Ολοήμερη
Other Reasons Leave
Άλλοι λόγοι (Ολοήμερη άδεια)
Ολοήμερη
Violence or Harassment Danger Leave
Απουσία από την εργασία λόγω επικείμενου σοβαρού κινδύνου βίας ή παρενόχλησης
Ολοήμερη
Minor Student Leave
Άδεια ανήλικων σπουδαστών
Ολοήμερη
KANEP Student Educational Leave
Εκπαιδευτική άδεια για φοιτητές στο Κ.ΑΝ.Ε.Π. – Γ.Σ.Ε.Ε.
Ολοήμερη
Flexible Work Arrangements (Days)
Ευέλικτες ρυθμίσεις εργασίας (Ημέρες)
Ολοήμερη
Prenatal Examinations (Hours)
Άδεια προγεννητικού ελέγχου (Ώρες)
Ώρες
Serious Child Illness Leave
Άδεια λόγω σοβαρών νοσημάτων παιδιών
Ολοήμερη
Child Hospitalization Leave
Άδεια λόγω νοσηλείας παιδιών
Ολοήμερη
Οι παραπάνω περιγραφές εμφανίζονται όπου οι κατηγορίες είναι διαθέσιμες για την εταιρεία. Το «Άλλοι λόγοι» ολοήμερης άδειας είναι διαφορετική κατηγορία από τον ήδη υπάρχοντα τύπο ωρών. Ελέγξτε IsItPartDay και μην επιλέγετε κατηγορία μόνο από την ονομασία. Ο κατάλογος μπορεί να περιλαμβάνει και κατηγορίες που δημιούργησε η ίδια η εταιρεία μέσω VacationTypes.php.
α. Λήψη 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)
Οποιαδήποτε μεταβολή έκδοσης δε λειτουργεί αντεπίστροφα, ακυρώνοντας αυτομάτως τις προηγούμενες εκδόσεις.
Για σημαντικές αναμενόμενες μεταβολές εκδόσεων ενημερώνεται ο πελάτης στα εμαιλ επικοινωνίας του προτού
δοθούν στην πραγματική χρήση, προκειμένου να ολοκληρωθούν οι όποιες αναμενόμενες μεταβολές και από τη πλευρά του.
2 Νοεμβρίου 2026
1.33
APIΠολυετείς άδειες: όλα τα ετήσια IDs, κοινό mergedVacID και αρχική MergedPeriod.
APIΕπικάλυψη με συγκεκριμένα IDs και ημερομηνίες. GET αδειών για όλες τις χρονιές και χρήση του επιστρεφόμενου VacationID.
APIΝέες ελληνικές κατηγορίες, ολοήμεροι «Άλλοι λόγοι» και εταιρικός κατάλογος χωρίς σταθερή αρίθμηση για custom κατηγορίες.
19 Οκτωβρίου 2026
1.32
ΒΕΛΤΙΩΣΗΔημιουργία ολοήμερης άδειας: έως 365 ημερολογιακές ημέρες χωρίς ειδική επιλογή. Το προαιρετικό JSON boolean allow_long_period: true επιτρέπει μεγαλύτερη περίοδο και τη χωρίζει ανά ημερολογιακό έτος, χωρίς να παρακάμπτει δικαιώματα, πρόσληψη, έγκριση ή επικαλύψεις. Αντικαθιστά το προηγούμενο όριο διάρκειας της v1.31.
ΔΙΟΡΘΩΣΗΕπεξεργασία / διαγραφή ωραρίων: επίσημο πεδίο εισόδου timeshiftID, συμβατότητα με μία παλαιότερη λατινική γραφή και ασφαλής ενημέρωση μόνο τμημάτων σε βάρδιες, χωρίς αλλαγή των αποθηκευμένων ωρών ή των πεδίων απάντησης.
10 Οκτωβρίου 2026
1.31
ΝΕΟΆδειες Εργαζόμενου: GET ανά εξωτερικό ID εργαζομένου, με προαιρετική περίοδο, FullDay/PartDay και σελιδοποίηση. Επιστρέφει το VacationID που χρησιμοποιεί το υπάρχον API τροποποίησης.
ΒΕΛΤΙΩΣΗΔημιουργία πολυετούς ολοήμερης άδειας: η περίοδος δεν περιορίζεται σε ένα ημερολογιακό έτος. Έως 3.661 ημερολογιακές ημέρες ανά αίτημα (περίπου 10 έτη), με διαδοχικά ετήσια τμήματα άδειας και ξεχωριστά VacationIDs.
31 Αυγούστου 2026
1.30
DOCSΗ δημόσια τεκμηρίωση περιγράφει αποκλειστικά το API contract, τα απαιτούμενα πεδία και τις αποκρίσεις, χωρίς εσωτερικές λεπτομέρειες υποδομής.
31 Αυγούστου 2026
1.29
ΝΕΟΠροστέθηκε το VacationTypes.php για ανάγνωση και idempotent δημιουργία εταιρικών τύπων αδειών μέσω GET και POST.
SAFEΠροστέθηκε αυστηρό tenant binding μεταξύ Bearer token, Company API key και subdomain, ημερήσιο όριο δημιουργιών, request correlation και API audit.
SERVERΗ αντιστοίχιση, η αποφυγή διπλοεγγραφών και το audit εκτελούνται server-side. Οι εφαρμογές τρίτων χρησιμοποιούν μόνο το external ID και το επιστρεφόμενο VacationReasonID.
25 Αυγούστου 2026
1.28
API Το endpoint λήψης τύπων αδειών επιστρέφει επιπλέον GreekTranslation, DisplayName και IsItPartDay, χωρίς αλλαγή των υφιστάμενων fields.
ΝΕΟ Προστέθηκαν οι κοινές κατηγορίες αδειών με IDs 25–35.
CRITICAL Σταθεροποιήθηκε η αντιστοίχιση των Vacation IDs, ώστε οι εφαρμογές τρίτων να χρησιμοποιούν πάντα το ID που επιστρέφει το API.
28 Ιουλίου 2026
1.27
ΔΙΟΡΘΩΣΗ Απόρριψη της δημιουργίας ή τροποποίησης ωραρίου τύπου «Βάρδια», όταν υπάρχει ήδη άλλη βάρδια με τις ίδιες ώρες και τουλάχιστον ένα κοινό Τμήμα εργασίας.
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