REST / JSON API

Γέφυρα διασύνδεσης TimeToWork

Τρέχουσα έκδοσηv1.3302/11/2026

Παρουσίαση

Σύντομη περιγραφή

Η παρούσα έκθεση αφορά την διασαφήνιση του τρόπου εισαγωγής/εξαγωγής δεδομένων προς και από το CLOUD λογισμικό ωρομέτρησης TimeToWork με τη χρήση γέφυρας Rest API.

Οτιδήποτε δεν περιγράφεται σε αυτή την αναφορά ως υλοποιημένο ή προς υλοποίηση, δεν είναι υπολογισμένο να πραγματοποιηθεί στα άμεσα σχέδια των υλοποιήσεων του προγράμματος και μπορεί φυσικά να ζητηθεί κατ’ επιλογή του πελάτη.

Διαδικασία σύνδεσης


Για να μπορεί να διασυνδεθεί κάποιο πρόγραμμα με το TimeToWork απαιτούνται οι εξής πληροφορίες :
  1. το username
  2. το password
  3. το subdomain
  4. το κλειδί API του συστήματος

Η κοινοποίηση στοιχείων πρόσβασης και κλειδιών API από την πλευρά του χρήστη θα πρέπει να πραγματοποιείται με ασφαλή τρόπο, μέσω ελέγχου και αποστολής μέσω email, χρησιμοποιώντας πάντα πρωτόκολλα ασφαλούς μεταφοράς δεδομένων (π.χ. SSL/TLS)

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

Για τη δημιουργία επιπλέον χρηστών ο πελάτης μπορεί να συνδεθεί στη σελίδα https://(your_subdomain).timetowork.gr και μέσα από το μενού Χρήστες να δημιουργήσει επιπλέον χρήστες με πρόσβαση στο σύστημα.

Η κοινοποίηση στοιχείων πρόσβασης και κλειδιών API από την πλευρά του χρήστη θα πρέπει να πραγματοποιείται με ασφαλή τρόπο, μέσω ελέγχου και αποστολής μέσω email, χρησιμοποιώντας πάντα πρωτόκολλα ασφαλούς μεταφοράς δεδομένων (π.χ. SSL/TLS)

Παράδειγμα διασύνδεσης και λήψης κλειδού connectionToken

 

Τρόπος σύνδεσης : POST

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Authenticate.php

Bearer token:  your_api_key_here

 

Content-Type: application/json

 


{
    "username": "_place__your_username_",
    "password": "_place__your_password_"
}
                                        

 

Επιτυχής απάντηση σύνδεσης:

 



{
    "Connection Success": true,
    "API key authentication": "Valid",
    "Company status": "Active",
    "Connection_token": "generated_connection_token_here",
    "Connection_token_expiration": "2023-02-11 13:00:00",
     "userrole": "Director"
}
                                        
Παρατηρήσεις

1. To Connection_token θα πρέπει να το αποθηκευσετε για το τρέχων Session γιατί θα το χρησιμοποιήσετε σχεδόν σε οποιαδήποτε άλλη σας ενέργεια μέσω API.

2. Το Connection_token_expiration δείχνει μέχρι πότε το τρέχω token έχει ισχύ. Μετά τη λήξη του θα χρειαστεί να εκδόσετε νεό. Μέχρι τη λήξη του όμως θα πρέπει να χρησιμοποιήσετε το συγκεκριμένο αλλιώς αν εκδίδετε χωρίς λόγο πολλαπλά token ντός της ημέρας κινδυνεύετε να ενεργοποιήσετε τα security limit rates και το σύστημα να σας κλειδώσει εκτός σύνδεσης προσωρινά ή μόνιμα.

 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους : λάθους καταχώρησης, ασφαλείας ή απενεργοποιημένης συνδρομής: 

 


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                        

 

Μήνυμα σφάλματος

Περιγραφή προβλήματος

Invalid username or password

Εσφαλμένου username ή/και κωδικού πρόσβασης

Invalid API key

Εσφαλμένη καταχώρηση apikey

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 του κυρίως Τμήματος που ανήκει

     

Τρόπος σύνδεσης : POST 

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Departments.php

Bearer token:  connectionToken

 

 

Παράδειγμα δημιουργίας Τμήματος

Content-Type: application/json

 


{
    "action": "create",
    "DepartmentName": "place_your_DepartmentName_here",
    "IsThisASubDepartment": false
}
                                                

 

 

Παράδειγμα δημιουργίας υποτμήματος

Content-Type: application/json

 


{
    "action" :  "create",
    "DepartmentName": "place_your_DepartmentName_here",
    "IsThisASubDepartment" : true,
    "DepartmentParentID" : "3"
}
                                                

** DepartmentParentID : To ID του κυρίως Τμήματος που ανήκει

 

Επιτυχής απάντηση σύνδεσης:


{
   "success": true,
    "New_DepartmentID": 16
}
                                                

 

Προσοχή το New_DepartmentID πρέπει να αποθηκεύεται στο συνεργαζόμενο πρόγραμμα προκειμένου να μπορεί να υπάρχει η γέφυρα των δύο προγραμμάτων και να μπορεί να γίνει η μελλοντική επεξεργασία του ή η διαγραφή του μέσω API. 

 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                                                
// Δείτε τον σχετικό Πίνακα σφαλμάτων



β. Επεξεργασία Τμήματος


Για την επεξεργασία Tμήματος μέσω API χρειάζεται : 

  • το connectionToken

  • το ID του Τμήματος (New_DepartmentID) που δόθηκε κατά τη δημιουργία του

  • στην περίπτωση του υποτμήματος, (προαιρετικά) το ID του κυρίως Τμήματος που ανήκει - αν επιθυμείτε να το αλλάξετε (πχ το υποτμήμα που ανήκει στο τμήμα 1 να το κάνουμε υποτμήμα του Τμήματος 2)

 

Τρόπος σύνδεσης : POST

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Departments.php

Bearer token:  connectionToken

Content-Type: application/json

 


{
    "action": "update",
    "DepartmentName": "place_your_DepartmentName_here",
    "DepartmentID" : "3"
}
                                                

 

 

Επιτυχής απάντηση σύνδεσης:

 


{
    "success": true,
    "message": "Department data was modified successfully"
}
                                                

 

 

 

 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                                                
// Δείτε τον σχετικό Πίνακα σφαλμάτων



 

 

γ. Διαγραφή Τμήματος


Για την διαγραφή Tμήματος μέσω API χρειάζεται : 

 

  • το connectionToken

  • το ID του Τμήματος (New_DepartmentID) που δόθηκε κατά τη δημιουργία του

 

Τρόπος σύνδεσης : POST 

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Departments.php

Bearer token:  connectionToken

Content-Type: application/json

 


{
    "action": "delete",
    "DepartmentID": "place_your_DepartmentID_here"
}
                                                

Επιτυχής απάντηση σύνδεσης:

 

                                                  
{
    "success": true,
    "message": "Department deleted successfully."
}
                                                
                                                

 

 

 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                                                




δ. Πίνακας σφαλμάτων Τμημάτων

 Μήνυμα σφάλματος

Περιγραφή προβλήματος

Department name too long

Χρησιμοποιήστε έως και 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 και πρέπει να επαναλάβετε την διαδικασία της αρχικής ταυτοποίησης/σύνδεσης





Ωράρια


α. Δημιουργία Ωραρίου


Για την δημιουργία ωραρίου μέσω API χρειάζεται : 

  • το connectionToken

  • η επιθυμητή ονομασία του.

  • Η κατηγορία του ωραρίου που θα δημιουργήσουμε

Τρόπος σύνδεσης : POST 

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Timeshifts.php

Bearer token:  connectionToken

Content-Type: application/json

Παράδειγμα δημιουργίας σταθερού ωραρίου

                                                    
{
  "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": "different",
    "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": "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"   // αν δεν οριστούν θα συνδεθούν όλα τα Τμήματα
}

                                                

 

 

Παράδειγμα δημιουργίας ελεύθερου ωραρίου

                                                    
{
  "action": "create",
  "shift_type": "flexible",
  "description": "8 hours flexible",
  "working_days": "Mon,Tue,Wed,Thu,Fri",
  "dailyHours": "8"
}
                                                    
                                                

 

Επιτυχής απάντηση σύνδεσης:


{
    "success": true,
    "message" = "Timeshift created successfully.",
    "New_TimeShiftID": 16
}
                                                

Προσοχή το New_TimeShiftID πρέπει να αποθηκεύεται στο συνεργαζόμενο πρόγραμμα προκειμένου να μπορεί να υπάρχει η γέφυρα των δύο προγραμμάτων και να μπορεί να γίνει η μελλοντική επεξεργασία του ή η διαγραφή του μέσω API. 

 

 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :

                                                    
{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                                                    
                                                

 

 

β. Επεξεργασία Ωραρίου

API v1.32 · 19/10/2026

Πεδίο 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:

{
  "action": "update",
  "timeshiftID": "9",
  "shift_type": "weekly",
  "ConnectedDepartmentIDs": "14,39"
}

Σε αυτή την ειδική ενημέρωση δεν στέλνονται πεδία ωρών: διατηρούνται οι αποθηκευμένες ώρες, η δεύτερη περίοδος και τα υπόλοιπα στοιχεία του ωραρίου. Το 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 του ωραρίου που δόθηκε κατά την δημιουργία του

Τρόπος σύνδεσης : POST 

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Timeshifts.php

Bearer token:  connectionToken

Content-Type: application/json

 

Παράδειγμα επεξεργασίας σταθερού ωραρίου


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

 

Επιτυχής απάντηση σύνδεσης:


{
    "success": true,
    "message": "Timeshift was updated succesfully",
    "New_TimeShiftID": 16
}
                                                

 

 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                                                

 

γ. Διαγραφή Ωραρίου


Για την διαγραφή ωραρίου μέσω API χρειάζεται : 

  • το connectionToken

  • το ID του ωραρίου, που δόθηκε κατά τη δημιουργία του

Τρόπος σύνδεσης : POST

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Timeshifts.php

Bearer token:  connectionToken

Content-Type: application/json

 


{
    "action": "delete",
    "timeshiftID": "11"
}
                                                

 

 

Επιτυχής απάντηση σύνδεσης:


{
    "success": true,
    "message": "Timeshift deleted successfully."
}
                                                

 

 

Ανεπιτυχής απάντησησύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                                                

δ. Πίνακας σφαλμάτων Ωραρίων


 Μήνυμα σφάλματος

Περιγραφή προβλήματος

Some department IDs do not exist in this company.

Κάποιο(α) από τα 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 χρειάζεται : 

  • το connectionToken

  • τα ID των εβδομαδιαίων βαρδιών

  • τα ID των εργαζομένων (Emp3dPartyID)

Τρόπος σύνδεσης : POST

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/ShiftsTable.php

Bearer token:  connectionToken

 

Παράδειγμα δημιουργίας / επεξεργασίας Βαρδιών

Content-Type: application/json


{
    "action": "link",
    "data": [
        {
            "Emp3dPartyID": 1,
            "dates": [
                { "Date": "2025-09-15", "timeshiftID": 2 },
                { "Date": "2025-09-16", "timeshiftID": 3 },
                { "Date": "2025-09-17", "timeshiftID": "DAYOFF" },     //ΡΕΠΟ
                { "Date": "2025-09-18", "timeshiftID": "DELETE" }      //Διαγραφή δεδομένων για εκείνη την ημ/νία
            ]
        },
        {
            "Emp3dPartyID": 2,
            "dates": [
            { "Date": "2025-09-15", "timeshiftID": 2 },
            { "Date": "2025-09-16", "timeshiftID": 4 }
            ]
        }
    ]
}
                                                

στ. Διαγραφή δεδομένων εβδομαδιαίου πίνακα – για επιλεγμένο χρονικό διάστημα για έναν ή περισσότερους Εργαζομένους


Για την διαγραφή των δεδομένων μέσω API χρειάζεται : 

  • το connectionToken

  • τα ID των εργαζομένων που θέλουμε να διαγραφεί

    (μπορεί να επιλεγεί και η επιλογή ‘all’ για όλους τους εργαζόμενους) 

Τρόπος σύνδεσης : POST

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/ShiftsTable.php

Bearer token:  connectionToken

 

Content-Type: application/json

 

Παράδειγμα διαγραφής των βαρδιών 2 εργαζομένων 

(για συγκεκριμένο χρονικό διάστημα) 

 


{
    "action": "delete_range",
    "data": [
        {
            "Emp3dPartyID": 101,
            "StartDate": "2025-09-15",  // (π.χ.., 2025-09-15 είναι η 15η Σεπτεμβρίου 2025)
            "EndDate": "2025-09-20"
        },
        {
            "Emp3dPartyID": 102,
            "StartDate": "2025-09-10",
            "EndDate": "2025-09-15"
        }
    ]
}
                                                

 

 

Παράδειγμα διαγραφής των βαρδιών όλων των εργαζομένων 

(για συγκεκριμένο χρονικό διάστημα) 


{
    "action": "delete_range",
    "data": [
        {
            "Emp3dPartyID": "all",
            "StartDate": "2025-09-01",
            "EndDate": "2025-09-30"
        }
    ]
}
                                                

 

 

Παρατηρήσεις

  1. Για λόγους ασφαλείας και πρόληψης λαθών, δεν γίνονται διαγραφές βαρδιών για χρονικό διάστημα μεγαλύτερου των 7 ημερών. Η διαδικασία μπορεί φυσικά να επαναληφθεί για άλλο χρονικό διάστημα. Αν ο πελάτης επιθυμεί μπορεί με απόλυτη δική του ευθύνη να μπορεί να διαγράφονται οι βάρδιες για όποιο χρονικό διάστημα επιθυμεί ή ακόμη και χωρίς κανένα απολύτως όριο.

  2. Όταν γίνεται διαγραφή βαρδιών, καταχωρείται και το ID/ & το Ονοματεπ/μο του   συνδεδεμένου χρήστη που διέγραψε μαζικά τις βάρδιες στο ιστορικό αλλαγών.

ζ. Επαναφορά άδειας μέσω εβδομαδιαίου προγράμματος για συγκεκριμένη ημερομηνία και για έναν εργαζόμενο


1. Αφορά μόνο την περίπτωση όπου ο εργαζόμενος είχε καταχωρημένη άδεια και στη συνέχεια, μέσω του εβδομαδιαίου προγράμματος, η ημέρα μετατράπηκε σε εργασία, ρεπό ή διαγράφηκε.

2. Κατά την επαναφορά, η άδεια επανέρχεται με τον αρχικό τύπο της (π.χ. αν ήταν αναρρωτική άδεια, θα επανέλθει ως αναρρωτική).

3. Η επαναφορά είναι δυνατή μόνο για ημέρες που έχουν προηγουμένως αφαιρεθεί μέσω του εβδομαδιαίου προγράμματος.


Τρόπος σύνδεσης : POST

URL: https://(subdomain).timetowork.gr/Utility/API/3PS/ShiftsTable.php

Bearer token: connectionToken

Content-Type: application/json


Παράδειγμα επαναφοράς άδειας για έναν εργαζόμενο


                                            {
                                                "action": "recall_vacation",
                                                "data": [
                                                    {
                                                        "Emp3dPartyID": "2",
                                                        "Date": "2026-04-13"
                                                    },
                                                    {
                                                        "Emp3dPartyID": "2",
                                                        "Date": "2026-04-14"
                                                    }
                                                ]
                                            }
                                            

Παρατηρήσεις

  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 ΕΡΓΑΖΟΜΕΝΟΥ

    // Δεν απαιτείται, θεωρείται προσωπικό δεδομένο και προϋποθέτει την συγκατάθεση του εργαζόμενου

  • ΚΙΝΗΤΟ ΕΡΓΑΖΟΜΕΝΟΥ

    // Δεν απαιτείται, θεωρείται προσωπικό δεδομένο και προϋποθέτει την συγκατάθεση του εργαζόμενου

  • ΤΜΗΜΑ ΕΡΓΑΣΙΑΣ ΕΡΓΑΖΟΜΕΝΟΥ 

  • ΤΥΠΟΣ ΩΡΑΡΙΟΥ  //S: Σταθερό Ωράριο || W:  Εβδομαδιαίο (βάρδια)

  • ID ΩΡΑΡΙΟΥ ΕΡΓΑΣΙΑΣ ΕΡΓΑΖΟΜΕΝΟΥ ",     

    // Δεν απαιτείται αν  εργαζεται με βάρδιες

  • ΗΜΕΡ. ΠΡΟΣΛΗΨΗΣ ,    //σε μορφή yyyy-mm-dd

  • ΑΦΜ

  • ΡΥΘΜΙΣΗ ΕΡΓΑΖΟΜΕΝΟΥ: Ο ΕΡΓΑΖΟΜΕΝΟΣ ΜΠΟΡΕΙ ΝΑ ΕΡΓΑΣΤΕΙ ΜΕΤΑ ΤΑ ΜΕΣΑΝΥΧΤΑ

  • ID ΕΞΩΤΕΡΙΚΟΥ ΧΡΗΣΤΗ

    //Αφορά το ID του εργαζομένου με βάση το συνεργ.πρόγραμμα

Και στην περίπτωση των πελατών με Hardware Controllers

  • ΚΑΡΤΑ ΠΡΟΣΒΑΣΗΣ

  • ID ΣΗΜΕΙΑ ΠΡΟΣΒΑΣΗΣ (αφορά τα πεδία πρόσβασης της επιχείρησης και υπάρχει σχετικό GET )


α. Εισαγωγή στοιχείων Εργαζόμενου


Τρόπος σύνδεσης : POST

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Employees.php

Bearer token:  connectionToken

 

Content-Type: application/json


{
  "CompanyApiKey": "your_api_key_here",
  "action": "create",
  "EmployeeDATA": [
    {
      "Emp3dPartyID": "_your_3dParty_EmployeeID_",
      "EmpFirstName": "_EmployeeFirstName_",
      "EmpLastName": "_EmployeeLastName_",
      "EmpFatherName": "_EmployeeFatherName_",
      "EmpMotherName": "_EmployeeMotherName_",
      "EmpDepartmentID": "_EmployeesDepartmentID_",
      "EmpTimeShiftType": "_S_or_W_",
      "EmpTimeShiftID": "_TimeshiftID_",
      "EmpHireDate": "_EmployeeHireDate YYYY-DD-MM_",
      "EmpTaxNumber": "_EmployeeTaxNumber_",
      "EmpEmail": "_EmployeeEmail_",
      "EmpMobile": "_EmployeeMobileNumber_",
      "CardNumberPart1": "_CardNumberPart1_Digits:xxxxx",
      "CardNumberPart2": "_CardNumberPart2_Digits:xxxxx ",
      "AccessPoints": "_AccessPoints_Ids_One_or_more_",        //Input Format (3ψηφ.) 001,002 κτλ…
     "EmpCanEmployeeWorkAfterMidnight": "_1 or 0_"
    }]
}

Παράδειγμα Δημιουργίας ενός ή περισσότερων Εργαζόμενων


{
  "CompanyApiKey": "your_api_key_here",
  "action": "create",
  "EmployeeDATA": [
    {
      "Emp3dPartyID": "111", 
      "EmpFirstName": "SAMPLE_NAME_A",   
      "EmpLastName": "SAMPLE_SURNAME_A",
      "EmpFatherName": "SAMPLE_FATHER_NAME_A",
      "EmpMotherName": "SAMPLE_MOTHER_NAME_A",
      "EmpDepartmentID": "3",
      "EmpTimeShiftType": "S",
      "EmpTimeShiftID": "5",
      "EmpHireDate": "2025-02-24",
      "EmpTaxNumber": "_EmployeeTaxNumber_",
      "EmpEmail": "employee@example.invalid",
      "EmpMobile": "_EmployeeMobileNumber_",
      "CardNumberPart1": "_CardNumberPart1_",
      "CardNumberPart2": "_CardNumberPart2_",
      "AccessPoints": "001,003",     _      //Input Format (3ψηφ.) 001,002 κτλ…
     "EmpCanEmployeeWorkAfterMidnight": "0"
    },
    {
      "Emp3dPartyID": "112", 
      "EmpFirstName": "SAMPLE_NAME_B",
      "EmpLastName": "SAMPLE_SURNAME_B",
      "EmpFatherName": "SAMPLE_FATHER_NAME_B",
      "EmpDepartmentID": "2",
      "EmpTimeShiftType": "W",
      "EmpHireDate": "2025-02-24",
      "EmpTaxNumber": "_EmployeeTaxNumber_",
      "CardNumberPart1": "_CardNumberPart1_",
      "CardNumberPart2": "_CardNumberPart2_",
      "AccessPoints": "001,002",
      "EmpCanEmployeeWorkAfterMidnight": "1"
    }
  ]
}

Επεξήγησεις

  • EmpFirstName: Όνομα  (ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ)

  • EmpLastName: Επίθετο  (ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ)

  • EmpFatherName: Πατρώνυμο 

  • EmpMotherName: Μητρώνυμο

  • EmpDepartmentID:  το ID του Τμήματος εργασίας   (ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ)

  • EmpTimeShiftType:  S: σταθερο, W: εβδομαδιαίο  (ΥΠΟΧΡΕΩΤΙΚΟ ΠΕΔΙΟ)

  • 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"
}]
                                                    

 

 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                                                

 

β. Επεξεργασία στοιχείων Εργαζόμενου


Για την επεξεργασία Εργαζόμενου μέσω API χρειάζεται : 

  • το connectionToken

  • το ID του εξωτερικού χρήστη του συνεργαζόμενου προγράμματος

     

Προσοχή! Τροποποιούνται μόνο τα πεδία που καταχωρούνται στην εντολή json. 

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

 

Τρόπος σύνδεσης : POST

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Employees.php

Bearer token:  connectionToken

 

Content-Type: application/json

 


{
  "CompanyApiKey": "your_api_key_here",
  "action": "update",
  "EmployeeDATA": [
    {
      "Emp3dPartyID": "_your_3dParty_EmployeeID_",
      "EmpFirstName": "_EmployeeFirstName_",
      "EmpLastName": "_EmployeeLastName_",
      "EmpFatherName": "_EmployeeFatherName_",
      "EmpMotherName": "_EmployeeMotherName_",
      "EmpDepartmentID": "_EmployeesDepartmentID_",
      "EmpTimeShiftType": "_S_or_W_",
      "EmpTimeShiftID": "_TimeshiftID_",
      "EmpHireDate": "_EmployeeHireDate YYYY-DD-MM_",
      "EmpTaxNumber": "_EmployeeTaxNumber_",
      "CardNumberPart1": "_CardNumberPart1_Digits:xxxxx",
      "CardNumberPart2": "_CardNumberPart2_Digits:xxxxx ",
      "AccessPoints": "_AccessPoints_Ids_One_or_more_",  //Input Format (3ψηφ.) 001,002 κτλ…
      "EmployeeStatus": "_1 or 0_",
     "EmpCanEmployeeWorkAfterMidnight": "_1 or 0_"
    }]
}


Παράδειγμα επεξεργασίας ενός ή περισσότερων Εργαζόμενων
{
  "CompanyApiKey": "your_api_key_here",
  "action": "update",
  "EmployeeDATA": [
    {
      "Emp3dPartyID": "111",
      "EmpTaxNumber": "_EmployeeTaxNumber_",
      "AccessPoints": "004,005"
    },
    {
     "Emp3dPartyID": "112",
      "EmpCanEmployeeWorkAfterMidnight": 0
     }
 ]
}

 

 

Επεξήγησεις

  • 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"
}]

 

 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                                            

γ. Διαγραφή Εργαζομένου


Σημ. Ο εργαζόμενος δεν διαγράφεται ποτέ από το σύστημα TimeToWork. Απλά εμφανίζεται ότι δεν εργάζεται πλέον στην επιχείρηση και απενεργοποιείται η κάρτα ωρομέτρησης του.

 

Για την διαγραφή Εργαζόμενου μέσω API χρειάζεται : 

  • το connectionToken

  • το ID του εξωτερικού χρήστη του συνεργαζόμενου προγράμματος 

 

Τρόπος σύνδεσης : POST 

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/Employees.php

Bearer token:  connectionToken

 

Content-Type: application/json

 


{
    "CompanyApiKey" : "YOUR_16_CHAR_KEY",
    "action": "disable",
    "Emp3dPartyID" : "_your_3dParty_EmployeeID_"
}
                                            

 

 

Επιτυχής απάντηση σύνδεσης:


{
    "success": true,
    "message": "Deletion success.",
    "EmployeeID": 2,
    "Employee Last Name": "SAMPLE_SURNAME_D",
    "EmployeeFirst Name": "SAMPLE_NAME_D",
    "Disabled Card Number": "_CardNumber_" //Αν στην εγκατάσταση υπάρχουν κάρτες
}
                                                

 

 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}
                                                

δ. Πίνακας σφαλμάτων Εργαζομένων

Μήνυμα σφάλματος

Περιγραφή προβλήματος

Missing Employee LastName 

Δεν καταχωρήσατε το Επώνυμο του Εργαζομένου

Access Card already declared in past 

Η κάρτα εργασίας έχει ήδη καταχωρηθεί στο παρελθόν σε άλλο Εργαζόμενο. Δεν μπορείτε να την καταχωρήσετε ξανά σε άλλο Εργαζόμενο. Μόνο να τροποποιήσετε τα στοιχεία του παλαιού Εργαζόμενου στα στοιχεία του νέου.

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.

ΜέθοδοςGET
ΧρήσηΛήψη διαθέσιμων τύπων
URLhttps://(subdomain).timetowork.gr/Utility/API/3PS/VacationTypes.php
ΜέθοδοςPOST
ΧρήσηΔημιουργία ή αντιστοίχιση
URLhttps://(subdomain).timetowork.gr/Utility/API/3PS/VacationTypes.php
Authentication και tenant binding

Και οι δύο μέθοδοι απαιτούν ενεργό 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
{
  "success": true,
  "apiVersion": "1.0",
  "vacationTypes": [
    {
      "VacationReasonID": 42,
      "ExternalVacationTypeID": "EXT-LEAVE-017",
      "Description": "Elected representatives leave",
      "GreekTranslation": "Άδεια αιρετών οργάνων",
      "DisplayName": "Άδεια αιρετών οργάνων",
      "VacationLengthType": "AllDay",
      "IsItPartDay": 0,
      "Country": "GR",
      "Scope": "company"
    }
  ],
  "requestId": "19f28c209ce94270a28e33d5ed71e403"
}

POST · Δημιουργία ή εύρεση εταιρικού τύπου

{
  "CompanyApiKey": "****************",
  "ExternalVacationTypeID": "EXT-LEAVE-017",
  "Description": "Elected representatives leave",
  "GreekTranslation": "Άδεια αιρετών οργάνων",
  "VacationLengthType": "AllDay"
}

Η πρώτη επιτυχής δημιουργία επιστρέφει 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 του αιτήματος άδειας πρέπει να συμφωνεί με τον τύπο.

{
  "action": "create",
  "CompanyApiKey": "****************",
  "Emp3dPartyID": "12345",
  "VacationReasonID": 42,
  "VacationLengthType": "AllDay",
  "StartDate": "2026-09-10",
  "EndDate": "2026-09-10"
}

Κύριοι κωδικοί σφαλμάτων

HTTPCodeΣημασία
400invalid_external_vacation_type_idΛείπει ή δεν είναι έγκυρο το external ID.
401invalid_tokenΛείπει ή δεν είναι ενεργό το Bearer token.
403tenant_host_mismatchΤο token χρησιμοποιήθηκε σε subdomain άλλης εταιρείας.
409external_id_conflictΤο external ID αντιστοιχεί ήδη σε διαφορετικό περιεχόμενο.
429daily_creation_limitΗ εταιρεία δημιούργησε 30 τύπους την ίδια ημέρα.
503migration_requiredΔεν έχει ολοκληρωθεί απαιτούμενο server-side βήμα εγκατάστασης.

Οι παρακάτω μεταβολές άδειας απαιτούν Διαχειριστή με το αντίστοιχο δικαίωμα API. Τα παραδείγματα δεν αποτελούν κλήσεις σε πραγματικό εργαζόμενο.

API v1.33 · 02/11/2026

α. Δημιουργία άδειας

HTTPPOST
AuthorizationBearer connectionToken
URLhttps://(subdomain).timetowork.gr/Utility/API/3PS/Vacations.php

Όλα τα παραδείγματα είναι ενδεικτικά και οι απαντήσεις δείχνουν βασικά πεδία. Στείλτε Authorization: Bearer connectionToken και Content-Type: application/json. Απαιτείται λογαριασμός Διαχειριστή με δικαίωμα Vacations. Το token, το 16-χαρακτήρων CompanyApiKey και το subdomain πρέπει να αφορούν την ίδια εταιρεία. Παραμένουν ενεργοί οι έλεγχοι αντιστοίχισης εργαζομένου και έγκρισης άδειας.

ΠεδίοΤιμή / κανόνας
action"create"
CompanyApiKeyAPI key της εταιρείας.
Emp3dPartyIDΉδη αντιστοιχισμένο εξωτερικό ID εργαζομένου.
VacationLengthTypeAllDay / PartDay
VacationReasonIDΤο επιστρεφόμενο id ενεργής, κατάλληλης κατηγορίας από το GET κατηγοριών.
StartDate, EndDateYYYY-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.

Αίτημα: 10/08/2026–03/04/2028
{
  "CompanyApiKey": "YOUR_16_CHAR_KEY",
  "Emp3dPartyID": 7001,
  "action": "create",
  "VacationLengthType": "AllDay",
  "allow_long_period": true,
  "VacationReasonID": 1,
  "StartDate": "2026-08-10",
  "EndDate": "2028-04-03"
}
Βασικά πεδία επιτυχούς απάντησης
{
  "success": true,
  "split": true,
  "mergedVacID": 20001,
  "MergedPeriod": {
    "StartDate": "2026-08-10",
    "EndDate": "2028-04-03"
  },
  "VacationIDs": [
    20001,
    20002,
    20003
  ],
  "Parts": [
    {
      "VacationID": 20001,
      "StartDate": "2026-08-10",
      "EndDate": "2026-12-31",
      "mergedVacID": 20001,
      "MergedPeriod": {
        "StartDate": "2026-08-10",
        "EndDate": "2028-04-03"
      }
    },
    {
      "VacationID": 20002,
      "StartDate": "2027-01-01",
      "EndDate": "2027-12-31",
      "mergedVacID": 20001,
      "MergedPeriod": {
        "StartDate": "2026-08-10",
        "EndDate": "2028-04-03"
      }
    },
    {
      "VacationID": 20003,
      "StartDate": "2028-01-01",
      "EndDate": "2028-04-03",
      "mergedVacID": 20001,
      "MergedPeriod": {
        "StartDate": "2026-08-10",
        "EndDate": "2028-04-03"
      }
    }
  ]
}

Η απάντηση επιστρέφει όλα τα VacationIDs, το κοινό mergedVacID και την αρχική συνολική MergedPeriod, τόσο στην κορυφή όσο και σε κάθε Parts. Φυλάξτε και τα επιμέρους IDs και το κοινό ID. Τα RealDays ανά τμήμα άδειας και το VacationRealDays συνολικά υπολογίζονται από τα ωράρια και τις αργίες· τα IDs του παραδείγματος δεν είναι πραγματικές καταχωρίσεις.

Παλαιότερες διασπασμένες άδειες

Η παρουσία κοινής ομάδας επιβεβαιώνεται μόνο από το επιστρεφόμενο mergedVacID. Μην ενώνετε μόνοι σας παλιές καταχωρίσεις επειδή έχουν συνεχόμενες ημερομηνίες. Όταν δεν υπάρχει ομάδα, τα πεδία μεταδεδομένων του GET είναι null.

Άδεια μέσα σε ένα έτος

Παραμένει η απάντηση με ένα VacationID. Το παρακάτω είναι υποσύνολο των πεδίων της απάντησης.

{
  "success": true,
  "VacationID": 20004,
  "VacationRealDays": 1
}

Άδεια συγκεκριμένων ωρών

{
  "CompanyApiKey": "YOUR_16_CHAR_KEY",
  "Emp3dPartyID": 7001,
  "action": "create",
  "VacationLengthType": "PartDay",
  "VacationReasonID": 29,
  "StartDate": "2026-11-05",
  "EndDate": "2026-11-05",
  "StartTime": "09:00:00",
  "EndTime": "13:00:00"
}

Η άδεια ωρών απαιτεί ίδια 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.

API v1.33 · 02/11/2026

β. Επεξεργασία αιτίας άδειας

HTTPPOST
AuthorizationBearer connectionToken
URLhttps://(subdomain).timetowork.gr/Utility/API/3PS/Vacations.php

Όλα τα παραδείγματα είναι ενδεικτικά και οι απαντήσεις δείχνουν βασικά πεδία. Στείλτε Authorization: Bearer connectionToken και Content-Type: application/json. Απαιτείται λογαριασμός Διαχειριστή με δικαίωμα Vacations. Το token, το 16-χαρακτήρων CompanyApiKey και το subdomain πρέπει να αφορούν την ίδια εταιρεία. Παραμένουν ενεργοί οι έλεγχοι αντιστοίχισης εργαζομένου και έγκρισης άδειας.

Το update αλλάζει μόνο την αιτία μίας καταχώρισης, όχι τις ημερομηνίες ή τις ώρες. Χρησιμοποιήστε VacationID και VacationNewReasonID. Το mergedVacID δεν υποστηρίζεται ως παράμετρος για update.

Προστασία επιμέρους τμήματος ομαδοποιημένης άδειας

Η νέα προαιρετική παράμετρος allow_modify_merged_vac έχει προεπιλογή false. Αν το VacationID ανήκει σε ομάδα, απαιτείται ρητά true. Αλλάζει μόνο το συγκεκριμένο τμήμα άδειας, όχι όλα τα τμήματα άδειας. Για άδεια χωρίς ομάδα η παράμετρος δεν απαιτείται.

{
  "CompanyApiKey": "YOUR_16_CHAR_KEY",
  "Emp3dPartyID": 7001,
  "action": "update",
  "VacationID": 20002,
  "VacationLengthType": "AllDay",
  "VacationNewReasonID": 1,
  "allow_modify_merged_vac": true
}
{
  "success": true,
  "VacationID": 20002,
  "VacationNewReason": "Annual",
  "mergedVacID": 20001,
  "MergedPeriod": {
    "StartDate": "2026-08-10",
    "EndDate": "2028-04-03"
  }
}

Χωρίς την επιβεβαίωση επιστρέφεται 409 MERGED_VACATION_MODIFICATION_REQUIRES_OPT_IN με τα στοιχεία της ομάδας. Λανθασμένος τύπος της σημαίας επιστρέφει 422 INVALID_ALLOW_MODIFY_MERGED_VAC.

API v1.33 · 02/11/2026

γ. Διαγραφή ενός τμήματος άδειας ή ολόκληρης ομάδας

HTTPPOST
AuthorizationBearer connectionToken
URLhttps://(subdomain).timetowork.gr/Utility/API/3PS/Vacations.php

Όλα τα παραδείγματα είναι ενδεικτικά και οι απαντήσεις δείχνουν βασικά πεδία. Στείλτε Authorization: Bearer connectionToken και Content-Type: application/json. Απαιτείται λογαριασμός Διαχειριστή με δικαίωμα Vacations. Το token, το 16-χαρακτήρων CompanyApiKey και το subdomain πρέπει να αφορούν την ίδια εταιρεία. Παραμένουν ενεργοί οι έλεγχοι αντιστοίχισης εργαζομένου και έγκρισης άδειας.

Στείλτε ακριβώς μία παράμετρο: VacationID ή mergedVacID. Δεν χρειάζεται allow_modify_merged_vac για διαγραφή. Η εταιρεία και τα δικαιώματα του token εξακολουθούν να ελέγχονται.

Διαγραφή μόνο ενός ετήσιου τμήματος άδειας

{
  "CompanyApiKey": "YOUR_16_CHAR_KEY",
  "action": "delete",
  "VacationID": 20002
}

Τα άλλα τμήματα άδειας παραμένουν. Η αρχική MergedPeriod δεν μικραίνει επειδή διαγράφηκε ένα τμήμα άδειας.

Διαγραφή ολόκληρης της ομάδας

{
  "CompanyApiKey": "YOUR_16_CHAR_KEY",
  "action": "delete",
  "mergedVacID": 20001
}
{
  "success": true,
  "message": "Vacation deleted successfully.",
  "VacationIDs": [
    20001,
    20002,
    20003
  ],
  "mergedVacID": 20001,
  "MergedPeriod": {
    "StartDate": "2026-08-10",
    "EndDate": "2028-04-03"
  }
}

Τα δύο παραδείγματα είναι εναλλακτικά. Η ομαδική απάντηση περιλαμβάνει τα IDs των τμημάτων άδειας που διαγράφηκαν σε αυτή την κλήση· αν ένα τμήμα άδειας έχει ήδη διαγραφεί, δεν περιλαμβάνεται ξανά. Η απλή διαγραφή διατηρεί το πεδίο VacationID στην απάντηση.

Η διαγραφή ενός έτους δεν διαγράφει τα άλλα έτη

Αν διαγράψετε μόνο το τμήμα άδειας του 2026 και ξαναστείλετε όλη την περίοδο 2026–2027, το ενεργό τμήμα άδειας του 2027 θα εξακολουθεί να δημιουργεί επικάλυψη. Αναζητήστε όλες τις χρονιές με GET ή χρησιμοποιήστε το γνωστό mergedVacID όταν επιθυμείτε διαγραφή ολόκληρης της ομάδας.

API v1.33 · 02/11/2026

Σφάλματα δημιουργίας και διαχείρισης αδειών

HTTPcodeΕνέργεια εφαρμογής
422VACATION_PERIOD_TOO_LARGEΠερίοδος άνω των 365 ημερών: προσθέστε JSON allow_long_period: true, μόνο αν επιθυμείτε τη μεγάλη περίοδο.
422INVALID_ALLOW_LONG_PERIODΗ τιμή πρέπει να είναι JSON boolean.
422LONG_PERIOD_ALL_DAY_ONLYΗ επιλογή ισχύει μόνο για AllDay.
422PART_DAY_SINGLE_DATE_REQUIREDΗ άδεια ωρών πρέπει να αφορά μία ημερομηνία.
422INVALID_VACATION_IDΗ τιμή της παραμέτρου πρέπει να είναι θετικός ακέραιος ή ψηφιακό string, έως 2147483647.
409VACATION_OVERLAPΔιαβάστε Conflicts και τις ακριβείς ημερομηνίες.
409MERGED_VACATION_MODIFICATION_REQUIRES_OPT_INΕπιβεβαιώστε ότι θέλετε αλλαγή μόνο αυτού του τμήματος άδειας και στείλτε allow_modify_merged_vac: true.
422INVALID_ALLOW_MODIFY_MERGED_VACΗ τιμή πρέπει να είναι JSON boolean.
422VACATION_UPDATE_REQUIRES_PART_IDΣτο update χρησιμοποιήστε ένα VacationID, όχι mergedVacID.
422VACATION_SELECTOR_REQUIREDΣτο delete δώστε ακριβώς ένα από VacationID, mergedVacID.
404VACATION_NOT_FOUNDΤο ID δεν βρέθηκε στην εταιρεία της σύνδεσης. Επανελέγξτε με GET.
409ADVANCED_VACATIONS_APPROVAL_REQUIREDΑπαιτείται η προβλεπόμενη διαδικασία έγκρισης.
503VACATION_SAVE_STATE_UNKNOWNΜε ExecutionConfirmed: false, ελέγξτε με GET πριν επαναλάβετε δημιουργία.
409VACATION_CREATE_FAILEDΑποτυχία άδειας ωρών, π.χ. επικάλυψη ή μη έγκυρες ώρες. Ελέγξτε τα στοιχεία και το μήνυμα.
503VACATION_CREATE_FAILED, VACATION_TRANSACTION_UNAVAILABLE, VACATION_MUTATION_UNAVAILABLEΑποτυχία αποθήκευσης χωρίς αποθηκευμένες αλλαγές. Διορθώστε την αιτία πριν επαναλάβετε.
503VACATION_IDENTITY_UNAVAILABLEΑδυναμία επιβεβαίωσης ID. Ελέγξτε localSaved και ExecutionConfirmed: μπορεί η μεταβολή να έχει ήδη εκτελεστεί.
503VACATION_MIGRATION_IN_PROGRESS, VACATION_LOCAL_IDENTITY_NOT_READY, ADVANCED_VACATIONS_POLICY_UNAVAILABLEΠροσωρινά μη διαθέσιμη λειτουργία ή έλεγχος πολιτικής. Απαιτείται τεχνικός έλεγχος.

Η μεταβολή εφαρμόζεται μόνο στην εταιρεία της σύνδεσης και στον εργαζόμενο που επιτρέπεται από τα δικαιώματα. Μην θεωρείτε κάθε 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 μπορεί να πραγματοποιείται μέσω :

 

·        MobileApp (Android – IOS)

·        Tablet (KIOSK) Μεχρήση QRCode – Coming Soon NFC cards

·        Hardware Ωρομετρητή  με χρήση καρτών προσέγγισης RF

·        Rest API (3rd Party software)

 

H διαδικασία ωρομέτρησης μέσω Rest API (3rd Party software) στη παρούσα φάση υποστηρίζει μόνο τη ωρομέτρηση με την καταχώρηση του αριθμό της κάρτας ωρομέτρησης ή του Εργανη QRCode του εργαζόμενου και μόνο πλήρως CLOUD εγκαταστάσεις (χωρίς hardware συσκευές ωρομετρησης

Τρόπος σύνδεσης :POST

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/CreateEvent.php

Bearer token:  connectionToken

 

Content-Type: application/json


- Με την καταχώρηση των στοιχείων της κάρτας ωρομέτρησης

                                                
{
  "CompanyApiKey": "_your_company_api_key_",
  "EventWay": {
    "EntryExit": "_Entry or Exit_",
    "EventDateTime":"2023-10-26 10:12:13",
    "type": "card_digits",
    "value": {
      "CardNumberPart1": "_Employees_first_5_card_digits",
      "CardNumberPart2": "_Employees_last_5_card_digits"
    }
  }
}
                                                
                                            

- Με την καταχώρηση των στοιχείων του κειμένου QRCode του Εργανη του Εργαζόμενου

                                                
{
  "CompanyApiKey": "_your_company_api_key_",
  "EventWay": {
    "EntryExit":"_Entry or Exit_",
    "EventDateTime":"2025-10-24 13:12:13",
    "type": "ErganiQR",
    "value": {
      "ErganiQrCode": "_input_here_Ergani_QrCode_Employee_text_"
    }
  }
}
                                                
                                            
Σημ: Το QrCode του ΕΡΓΑΝΗ είναι της μορφής erg|nm:..........


Επιτυχής απάντηση σύνδεσης:

   


{
    "success": true,
    "message": "Cloud Event Created Correctly",
    "EventID": 31
}
                                            

 
 


 

Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :


{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}

// Δείτε τον σχετικό Πίνακα σφαλμάτων

β. Πίνακας σφαλμάτων Εισαγωγής δεδομένων

Μήνυμα σφάλματος

Περιγραφή προβλήματος

 

Invalid Card

Ο αριθμός της κάρτας που καταχωρήσατε δεν αντιστοιχεί σε κάποιο Εργαζόμενο της επιχείρησης. 

 

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 χρειάζεται :

 

-        το connectionToken

-        Το ApiKey που της εταιρείας

-        ToMassDeletionExtraKey

 

Τρόπος σύνδεσης :POST

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/MassDeleteData.php

Bearer token:  connectionToken

 

Content-Type: application/json

                                                
{
    "CompanyApiKey" : "YOUR_16_CHAR_KEY",
    "MassDeletionExtrakey": "_your_mass_deletion_extrakey_",
    "action": "_chosen_action_"
}
                                                
                                            

 

chosen action:

 

-        mass_delete_steady_timeshifts

διαγραφή όλων των

- σταθερών ωραρίων ανά ημέρα

- διαφορετικών ωραρίων ανά ημέρα αλλά σταθερών ανά εβδομάδα

-  ελεύθερων ωραρίων.

Η διαγραφή αφορά όλους τους Εργαζόμενους.

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

 

 

-        mass_delete_timetable

    διαγραφή όλων των προγραμμάτων εργασιών των Εργαζομένων. Η διαγραφή αφορά όλες τις βάρδιες χωρίς χρονικό περιορισμό αλλά δε διαγράφει τις βάρδιες σαν ωράριο.

 

 

-        mass_delete_weekly_shifts

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

 

 

-        mass_delete_vacations

διαγραφή όλων των αδειών όλων των Εργαζομένων χωρίς χρονικό περιορισμό.

 

 

-        mass_delete_all

διαγραφή όλων των ανωτέρω καθώς και των δεδομένων συσχετισμένα με τους Εργαζόμενους (προσωπικές ρυθμίσεις, πρόσβαση σε καρταναγνώστες, ακύρωση όλων των καρτών πρόσβασης, Ιστορικού αναφοράς τροποποιήσεων), Ιστορικού συμβάντων, Αναφορών εργασιών, Τμημάτων εργασίας, μετρητών/δεικτών εργασίας, ρυθμίσεις αποστολών σε Εργαζομένους)

 

Προσοχή οι διαγραφές αυτές γίνονται μόνο εφόσον είναι απαραίτητο για τις δοκιμές του συστήματος , οριστικά και χωρίς τη δυνατότητα επαναφοράς τους




Παραδείγματα

 

                                                {
    "CompanyApiKey" : "YOUR_16_CHAR_KEY",
    "MassDeletionExtrakey": "_your_mass_deletion_extrakey_",
    "action": "mass_delete_all"
}
                                            




Επιτυχής απάντηση σύνδεσης:

 


{
    "success": true,
    "message":"The selected deletion was successfully completed. "
}
                                            

 

 


Ανεπιτυχής απάντηση σύνδεσης

Η απόρριψη μπορεί να γίνει για πολλούς λόγους :

                                                
{
    "success": false,
    "message": "xxxxxxx" // Δείτε το παρακάτω πίνακα
}

                                            
// Δείτε τον σχετικό Πίνακα σφαλμάτων

β. Πίνακας σφαλμάτων Μαζικής διαγραφής

Μήνυμα σφάλματος

Περιγραφή προβλήματος

 

You must connect as a Director to mass Delete

‘Έχετε συνδεθεί ως Προϊστάμενος και δε μπορείτε να προβείτε σε μαζικές διαγραφές. Μόνο οι διαχειριστές μπορούν να προβούν σε τέτοιες ενέργειες και πάντα εφόσον έχει ενεργοποιηθεί αυτή η δυνατότητα στη συγκεκριμένη επιχείρηση/πλατφόρμα.

 

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.

Δεν επιλέξατε μία αναμενόμενη ενέργεια. Παρακαλούμε επιλέξτε μεταξύ των επιλογών

(mass_delete_steady_timeshifts, mass_delete_timetable, mass_delete_weekly_shifts κτλ.)

 

No data to delete!

 

Δεν υπάρχουν δεδομένα να διαγραφούν για την επιλογή που επιλέξατε

 

Λήψη πληροφοριών (GET)


API v1.33 · 02/11/2026

Άδειες εργαζομένου — GET και όλα τα VacationIDs

HTTPGET
AuthorizationBearer connectionToken
URLhttps://(subdomain).timetowork.gr/Utility/API/3PS/GETData/GetEmployeeVacations.php

Κλήση μόνο ανάγνωσης με ενεργό 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. Άγνωστες / επαναλαμβανόμενες παράμετροι και μη έγκυρες ημερομηνίες απορρίπτονται.

Παράδειγμα απάντησης

{
  "success": true,
  "apiVersion": "1.0",
  "3dPartyEmpID": "7001",
  "EmployeeID": 41,
  "CloudEmpID": 200,
  "Filters": {
    "StartDate": "2026-08-10",
    "EndDate": "2028-04-03",
    "VacationLengthType": "FullDay"
  },
  "Vacations": [
    {
      "VacationID": 20001,
      "CloudVacationID": 20001,
      "VacationReasonID": 1,
      "VacationTypeName": "Annual",
      "VacationLengthType": "AllDay",
      "StartDate": "2026-08-10",
      "EndDate": "2026-12-31",
      "StartTime": null,
      "EndTime": null,
      "Status": "Completed",
      "UpdatedAt": "2026-11-02 08:00:00",
      "mergedVacID": 20001,
      "MergedPeriod": {
        "StartDate": "2026-08-10",
        "EndDate": "2028-04-03"
      }
    },
    {
      "VacationID": 20002,
      "CloudVacationID": 20002,
      "VacationReasonID": 1,
      "VacationTypeName": "Annual",
      "VacationLengthType": "AllDay",
      "StartDate": "2027-01-01",
      "EndDate": "2027-12-31",
      "StartTime": null,
      "EndTime": null,
      "Status": "Completed",
      "UpdatedAt": "2026-11-02 08:00:00",
      "mergedVacID": 20001,
      "MergedPeriod": {
        "StartDate": "2026-08-10",
        "EndDate": "2028-04-03"
      }
    },
    {
      "VacationID": 20003,
      "CloudVacationID": 20003,
      "VacationReasonID": 1,
      "VacationTypeName": "Annual",
      "VacationLengthType": "AllDay",
      "StartDate": "2028-01-01",
      "EndDate": "2028-04-03",
      "StartTime": null,
      "EndTime": null,
      "Status": "Completed",
      "UpdatedAt": "2026-11-02 08:00:00",
      "mergedVacID": 20001,
      "MergedPeriod": {
        "StartDate": "2026-08-10",
        "EndDate": "2028-04-03"
      }
    }
  ],
  "Pagination": {
    "Limit": 100,
    "Offset": 0,
    "Count": 3,
    "HasMore": false,
    "NextOffset": null
  },
  "requestId": "example-request-7001"
}

Χωρίς ομάδα επιστρέφονται 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.

API v1.33 · 02/11/2026

Κατηγορίες αδειών και IDs της εταιρείας

HTTPGET
AuthorizationBearer connectionToken
URLhttps://(subdomain).timetowork.gr/Utility/API/3PS/GETData/GetVacationIDs.php

Απαιτείται ενεργό Bearer token και το ξεχωριστό δικαίωμα GetVacationIDs.

Μη χρησιμοποιείτε σταθερή αρίθμηση κατηγοριών

Χρησιμοποιείτε πάντα το id που επιστρέφει ο κατάλογος της συγκεκριμένης εταιρείας ως VacationReasonID ή VacationNewReasonID. Εταιρείες με custom κατηγορίες μπορεί να έχουν διαφορετικά αριθμητικά IDs για τις ίδιες περιγραφές. Τα νέα είδη αδειών προστίθενται χωρίς να απαιτείται αλλαγή των ήδη χρησιμοποιούμενων custom IDs.

Πεδία απάντησης
ΠεδίοΣημασία
idID κατηγορίας για την εταιρεία της σύνδεσης.
DescriptionEnglish description
GreekTranslationΕλληνική απόδοση ή null.
DisplayNameΠεριγραφή για εμφάνιση: ελληνική απόδοση όταν υπάρχει, αλλιώς Description.
IsItPartDay0: ολοήμερη · 1: ώρες.
AllDayVacation"1": ολοήμερη · "0": ώρες.
Greece, Germany, Cyprus, UkraineΣημαίες χώρας του καταλόγου. Για εταιρικές κατηγορίες ελέγχονται η εταιρεία και ο τύπος διάρκειας· ο παλαιότερος κοινός κατάλογος εφαρμόζει και περιορισμούς χώρας.
{
  "success": true,
  "vacationReasons": [
    {
      "id": 84,
      "Description": "Other Reasons Leave",
      "GreekTranslation": "Άλλοι λόγοι (Ολοήμερη άδεια)",
      "DisplayName": "Άλλοι λόγοι (Ολοήμερη άδεια)",
      "IsItPartDay": 0,
      "AllDayVacation": "1",
      "Greece": "1",
      "Germany": "0",
      "Cyprus": "0",
      "Ukraine": "0"
    }
  ]
}

Το 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.

β. Λήψη σημείων πρόσβασης επιχείρησης (Access Point IDs)

Το ενδιαφέρον αυτής της λήψης αφορά μόνο εγκαταστάσεις που βρίσκονται εγκατεστημένοι HardWare Controllers, προκειμένου να γνωρίζει το σύστημα από ποια σημεία πρόσβασης μπορεί να κάνει ωρομέτρηση ο κάθε Εργαζόμενος. 

Ta σημεία που επιστρέφονται με TimeAttendance : 0 σημαίνει ότι δε μπορεί να γίνει ωρομέτρηση από εκεί γιατί χρησιμοποιούνται αποκλειστικά για χρήση Access Control.

Τρόπος σύνδεσης : GET

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/GETData/GetAccessPoints.php

Bearer token:  connectionToken

Headers

key:  x-api-key value: your_api_key_here

 

Επιτυχής απάντηση σύνδεσης:

 


{
    "success": true,
    "CompanyUsesHardWareControllers": true,
    "AccessPoints":
     [{
        "id": "1",
        "Description": "MainEntry",
        "TimeAttendance": "1"
     },
     {
        "id": "2",
        "Description": "Warehouse",
        "TimeAttendance": "1"
     },
     {
        "id": "3",
        "Description": "Back Entry",
        "TimeAttendance": "0"
    }]
}

 

 

 Αν η εταιρεία δεν έχει εγκατεστημένα μηχανήματα - ωρομετρητές - Access Control και λειτουργεί αποκλειστικά με softwareUnits (πχ κινητά τηλέφωνα ή Tablet) θα λάβετε την απάντηση  :

 

{
    "success": true,
    "CompanyUsesHardWareControllers": false
}

γ. Λήψη Τμημάτων επιχείρησης (Departments)

Με αυτή την μέθοδο λαμβάνουμε τα ενεργά Τμήματα της επιχείρησης και πληροφορίες για αυτά. 

Τρόπος σύνδεσης : GET

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/GETData/GetCompanyDepartments.php

Bearer token:  connectionToken

Headers

key:  x-api-key value: your_api_key_here

 

Επιτυχής απάντηση σύνδεσης:


{
    "success": true,
    "Departments": [{
        "id": 1,
        "Name": "SALES",
        "IsThisASubDepartment": 0,
        "ParentDepartmentLevel1": 1,
       "DoesDepartmentHaveSemiHolidayEmployees": 0
    }, {
        "id": 2,
        "Name": "TECHNICAL",
        "IsThisASubDepartment": 0,
        "ParentDepartmentLevel1": 2,
       "DoesDepartmentHaveSemiHolidayEmployees": 0
    }, {
        "id": 3,
        "Name": "ADMINISTRATION",
        "IsThisASubDepartment": 0,
        "ParentDepartmentLevel1": 3,
       "DoesDepartmentHaveSemiHolidayEmployees": 0
    }]
}

Επεξηγήσεις


  1. IsThisASubDepartment

    Αν η τιμή είναι 1 σημαίνει ότι το Τμήμα είναι υποτμήμα άλλου Τμήματος

  2. ParentDepartmentLevel1

    Αυτή η τιμή δείχνει το ID του κυρίως Τμήματος για το συγκεκριμένο Υποτμήμα.

     

  3. DoesDepartmentHaveSemiHolidayEmployees

    Αν η εταιρεία ανήκει στον Δημόσιο Τομέα στην Ελλάδα εμφανίζεται στο σύστημα TimeToWork η επιλογή να υπάρχουν οι ημι-αργίες. Αν οι εργαζόμενοι του Τμήματος έχουν αυτή τη δυνατότητα φαίνεται στη παράμετρο ως τιμή 1. 

     

δ. Λήψη Ωραρίων επιχείρησης (Timeshifts)

Με αυτή την μέθοδο λαμβάνουμε τα διαθέσιμα ωράρια της Επιχείρησης στις 4 κατηγορίες που υπάρχουν : 

Περιγραφή

Υποστηρίζει 2 βάρδιες την ίδια μέρα

Σταθερό με ίδιες ώρες ανά ημέρα 

Σταθερό ανά εβδομάδα με διαφορ.ώρες/ ημέρα

Βάρδια

Ελεύθερο

                                             

Μπορούμε να τα λάβουμε και τα 4 ή ξεχωριστά ανά περίπτωση διαλέγοντας τη κατάλληλη παράμετρο url  - endpoint ανά περίπτωση: 

 

_______________

 

  • Σταθερό με ίδιες ώρες ανά ημέρα

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/GETData/GetCompanyTimeshifts.php?category=steady

_______________

 

  • Σταθερό ανά εβδομάδα με διαφορετικές ώρες ανα ημέρα) 

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/GETData/GetCompanyTimeshifts.php?category=different

 

_______________

 

  • Βάρδια

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/GETData/GetCompanyTimeshifts.php?category=weekly

 

_______________

 

  • Ελεύθερο

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/GETData/GetCompanyTimeshifts.php?category=flexible

 

_______________

 

  • Όλα μαζί

UrL: https://(subdomain).timetowork.gr/Utility/API/3PS/GETData/GetCompanyTimeshifts.php?category=all

 

_______________

 

 

Ανεξάρτητα από το endpoint η υπόλοιπη διαδικασία λήψης πληροφοριών για τα ωράρια είναι η εξής  :

 

URL: (To URL που επιλέξατε παραπάνω)

Τρόπος σύνδεσης : GET

Bearer token:  connectionToken

Headers

key:  x-api-key value: your_api_key_here

 

 

Επιτυχής απάντηση σύνδεσης:


(Αφορά τη περίπτωση της παραμέτρου steady)

 

    
{
    "success": true,
    "message": {
        "Category type": "Steady",
        "Explain": "Same hours every week, same days. Up to 2 shifts per day.",
        "Example": "Monday-Friday 09:00-12:00 & 15:00-20:00",
        "Data": [{
            "id": 6,
            "Chosen_Description": "d-g 9-17",
            "working_days": "Mon,Tue,Wed,Thu,Fri",
            "FirstSessionEntry": "09:00",
            "FirstSessionExit": "17:00",
            "HasTwoShifts": 0,
            "SecondSessionEntry": "",
            "SecondSessionExit": ""
        }]
    }
}
    

 

 

(Αφορά τη περίπτωση της παραμέτρου weekly)

 


{
    "success": true,
    "message": {
        "Category type": "Shifts for weekly needs",
        "Explain": "Shifts created to fill rotating program schedules for employees based on company needs. Up to 2 shifts per day.",
        "Example": "09:00-12:00 or 08:30-14:00 | 18:00-20:00",
        "Data": [{
            "id": 3,
            "Chosen_Description": "09:00-17:00",
            "FirstSessionEntry": "09:00",
            "FirstSessionExit": "17:00",
            "SecondSessionEntry": "",
            "SecondSessionExit": "",
            "DepartmentIDs": "1,2,3",
            "DepartmentNames": "DEEDEFE, ERFERREGERG, ΓΕΝΙΚΟ"
        }, {
            "id": 4,
            "Chosen_Description": "17:00-19:00",
            "FirstSessionEntry": "17:00",
            "FirstSessionExit": "19:00",
            "SecondSessionEntry": "",
            "SecondSessionExit": "",
            "DepartmentIDs": "1,2",
            "DepartmentNames": "DEEDEFE, ΓΕΝΙΚΟ"
        }, {
            "id": 5,
            "Chosen_Description": "15:00-19:00/22:00-23:00",
            "FirstSessionEntry": "15:00",
            "FirstSessionExit": "19:00",
            "SecondSessionEntry": "22:00",
            "SecondSessionExit": "23:00",
            "DepartmentIDs": "1",
            "DepartmentNames": "ΓΕΝΙΚΟ"
        }]
}
}

(Αφορά τη περίπτωση της παραμέτρου all)

{
    "success": true,
    "message": {
        "success": true,
        "categories": {
            "steady": {
                "Category type": "Steady",
                "Explain": "Same hours every week, same days. Up to 2 shifts per day.",
                "Example": "Monday-Friday 09:00-12:00 & 15:00-20:00",
                "Data": [{
                    "id": 6,
                   "Chosen_Description": "d-g 9-17",
                    "working_days": "Mon,Tue,Wed,Thu,Fri",
                   "FirstSessionEntry": "09:00",
                   "FirstSessionExit": "17:00",
                    "HasTwoShifts": 0,
                   "SecondSessionEntry": "",
                   "SecondSessionExit": ""
                }]
            },
            "different": {
                "Category type": "Category: Different days, same weekly pattern",
                "Explain": "Different days each week, but pattern repeats weekly. Up to 2 shifts per day.",
                "Example": "Monday 09:00-12:00, Tuesday 08:30-14:00 & 18:00-20:00",
                "Data": [{
                    "TimeShiftID": 1,
                    "shifts": [{
                        "id": 1,
                        "DAY": "Monday",
                       "FirstSession": "09:00",
                       "FirstSessionExit": "17:00",
                       "SecondSessionEntry": "",
                       "SecondSessionExit": ""
                    }, {
                        "id": 2,
                        "DAY": "Tuesday",
                       "FirstSession": "08:00",
                       "FirstSessionExit": "14:00",
                       "SecondSessionEntry": "17:00",
                       "SecondSessionExit": null
                    }, {
                        "id": 3,
                        "DAY": "Wednesday",
                       "FirstSession": "09:00",
                       "FirstSessionExit": "17:00",
                       "SecondSessionEntry": "",
                       "SecondSessionExit": ""
                    }, {
                        "id": 4,
                        "DAY": "Thursday",
                       "FirstSession": "09:00",
                       "FirstSessionExit": "17:00",
                       "SecondSessionEntry": "",
                       "SecondSessionExit": ""
                    }, {
                        "id": 5,
                        "DAY": "Friday",
                       "FirstSession": "09:00",
                       "FirstSessionExit": "17:00",
                       "SecondSessionEntry": "",
                       "SecondSessionExit": ""
                    }]
                }, {
                    "TimeShiftID": 2,
                    "shifts": [{
                        "id": 6,
                        "DAY": "Monday",
                       "FirstSession": "07:00",
                       "FirstSessionExit": "15:00",
                       "SecondSessionEntry": "",
                       "SecondSessionExit": ""
                    }, {
                        "id": 7,
                        "DAY": "Tuesday",
                       "FirstSession": "07:00",
                       "FirstSessionExit": "18:00",
                       "SecondSessionEntry": "",
                       "SecondSessionExit": ""
                    }, {
                        "id": 8,
                        "DAY": "Wednesday",
                       "FirstSession": "07:00",
                       "FirstSessionExit": "14:00",
                       "SecondSessionEntry": "",
                       "SecondSessionExit": ""
                    }, {
                        "id": 9,
                        "DAY": "Thursday",
                       "FirstSession": "07:00",
                       "FirstSessionExit": "14:00",
                       "SecondSessionEntry": "",
                       "SecondSessionExit": ""
                    }, {
                        "id": 10,
                        "DAY": "Friday",
                       "FirstSession": "07:00",
                       "FirstSessionExit": "14:00",
                       "SecondSessionEntry": "16:00",
                       "SecondSessionExit": null
                    }]
                }]
            },
            "weekly": {
                "Category type": "Flexible shift",
                "Explain": "Expected hours to work (in hours) in chosen Days",
                "Example": "8 / 7.30",
                "Data": [{
                    "id": 7,
                   "Chosen_Description": "dwewefef",
                   "Daily_Expected_Hours": "8",
                   "ExpectedToComeToWorkDays": "Mon,Wed,Fri"
                }]
            },
            "flexible": {
                "Category type": "Shifts for weekly needs",
                "Explain": "Shifts created to fill rotating program schedules for employees based on company needs. Up to 2 shifts per day.",
                "Example": "09:00-12:00 or 08:30-14:00|18:00-20:00",
                "Data": [{
                    "id": 3,
                   "Chosen_Description": "09:00-17:00",
                    "FirstSessionEntry": "09:00",
                   "FirstSessionExit": "17:00",
                   "SecondSessionEntry": "",
                   "SecondSessionExit": "",
                    "DepartmentIDs": "1,2,3",
                   "DepartmentNames": "DEEDEFE, ERFERREGERG, ΓΕΝΙΚΟ"
                }, {
                    "id": 4,
                   "Chosen_Description": "17:00-19:00",
                   "FirstSessionEntry": "17:00",
                   "FirstSessionExit": "19:00",
                   "SecondSessionEntry": "",
                   "SecondSessionExit": "",
                    "DepartmentIDs": "1,2",
                   "DepartmentNames": "DEEDEFE, ΓΕΝΙΚΟ"
                }, {
                    "id": 5,
                    "Chosen_Description": "15:00-19:00/22:00-23:00",
                   "FirstSessionEntry": "15:00",
                   "FirstSessionExit": "19:00",
                   "SecondSessionEntry": "22:00",
                   "SecondSessionExit": "23:00",
                    "DepartmentIDs": "1",
                   "DepartmentNames": "ΓΕΝΙΚΟ"
                }]
            }
        }
    }
}

Ασφάλεια - Περιορισμοί

Η επικοινωνία με τη πλατφόρμα 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Διαγραφή ενός τμήματος άδειας ή όλης της ομάδας. Επεξεργασία τμήματος άδειας μόνο με allow_modify_merged_vac: true.

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

ΒΕΛΤΙΩΣΗΠροσθήκη επιστροφής ελέγχου δημιουργίας κάρτας

16 Σεπτεμβρίου 2025
1.20

ΝΕΟΔυνατότητα διαγραφής δεδομένων (Data reset) για επιλεγμένες επιχειρήσεις μέσω DeleteKey

15 Σεπτεμβρίου 2025
1.19

ΒΕΛΤΙΩΣΗΒελτίωση κλειδώματος χρηστών με χρήση περιορισμού IP σε επιλεγμένες επιχειρήσεις

23 Ιουλίου 2025
1.18

ΝΕΟΛήψη (GET) ωραρίων

9 Ιουλίου 2025
1.17

ΝΕΟΛήψη (GET) σημείων πρόσβασης (Access Points)

25 Ιουνίου 2025
1.16

ΝΕΟΕπεξεργασία πίνακα βαρδιών

ΒΕΛΤΙΩΣΗΑυτόματη προσθήκη στο πίνακα βαρδιών όταν κάποιος εργαζόμενος παίρνει άδεια

11 Ιουνίου 2025
1.15

ΝΕΟΔημιουργία πίνακα βαρδιών

18 Μαιου 2025
1.14

ΝΕΟΔημιουργία/Επεξεργασία/Διαγραφή ωραρίων

14 Μαιου 2025
1.13

ΝΕΟΔιαγραφή εσφαλμένων δεδομένων ωρομέτρησης για Mobile App

30 Απριλίου 2025
1.12

ΝΕΟΑποστολή αίτησης άδειας Εργαζόμενου (Mobile App)

16 Απριλίου 2025
1.11

ΔΙΟΡΘΩΣΗΔιορθώσεις αποστολής καρτών σε εταιρείες με καρταναγνώστες

2 Απριλίου 2025
1.10

ΝΕΟΔημιουργία εργαζομένων και μέσω εταιρειών/Οργανισμών με κάρτες(Hardware installations)

27 Μαρτίου 2025
1.09

ΝΕΟΔημιουργία τεχνητού συμβάντος (Mobile App)

17 Μαρτίου 2025
1.08

ΝΕΟΛήψη (GET) πληροφοριών Τμημάτων επιχείρησης

19 Φεβρουαρίου 2025
1.07

NEOΔημιουργία/Επεξεργασία/Απόλυση βασικών στοιχείων εργαζομένου

ΒΕΛΤΙΩΣΗΠροσθήκη πεδίων 'ΜΗΤΡΩΝΥΜΟ' στα πεδία εισαγωγής/επεξεργασίας στον Εργαζόμενο

5 Φεβρουαρίου 2025
1.06

NEOΛήψη (GET) ID διαθέσιμων αδειών εργαζομένων

15 Ιανουαρίου 2025
1.05

ΒΕΛΤΙΩΣΗΔημιουργία/Επεξεργασία & διαγραφή αδειών

ΒΕΛΤΙΩΣΗΛήψη (GET) ID διαθέσιμων αδειών / Υποστήριξη αδειών για Γερμανία,Ουκρανία και Κύπρο

23 Μαρτίου 2024
1.04

ΝΕΟΔημιουργία/Επεξεργασία αδειών

ΝΕΟΛήψη (GET) ID διαθέσιμων αδειών

18 Ιουνίου 2024
1.03

ΝΕΟΔημιουργία/Επεξεργασία/Διαγραφή Τμημάτων

3 Ιουνίου 2023
1.02

ΒΕΛΤΙΩΣΗOffline ωρομέτρηση μέσω Mobile app

ΔΙΟΡΘΩΣΗBasic rate limiting - μικρές διορθώσεις

ΔΙΟΡΘΩΣΗBasic georistriction - μικρές διορθώσεις

11 Μαρτίου 2022
1.01

ΝΕΟΑρχική κατασκευή γέφυρας για αυθεντικοποίηση χρηστών

ΝΕΟΑποστολή ωρομετρήσεων μέσω Mobile App

ΝΕΟΛήψη πληροφοριών εταιρείας

ΝεοΛήψη πληροφοριών εργαζόμενου

ΝΕΟBasic rate limiting

ΝΕΟBasic georistriction