Web API του Εργάνη
Το Εργάνη είναι η ψηφιακή πλατφόρμα οργάνωσης χρόνου εργασίας του Υπουργείου Εργασίας. Το Web API επιτρέπει στο λογισμικό σας να υποβάλλει και να ανακτά δηλώσεις εργασιακών σχέσεων απευθείας — αντί να χρησιμοποιείτε τις φόρμες ή τις μεταφορτώσεις XML.
Σε ποιον απευθύνεται
Κάνετε ενσωμάτωση αν φτιάχνετε ή λειτουργείτε:
- ένα σύστημα ωρομέτρησης / παρακολούθησης παρουσίας, που αναφέρει προσελεύσεις και αποχωρήσεις εργαζομένων σε πραγματικό χρόνο (ο μηχανισμός Ψηφιακής Κάρτας Εργασίας), ή
- λογισμικό μισθοδοσίας ή HR, που υποβάλλει μεταβολές εργασιακής σχέσης, ωράρια ή έντυπα προσλήψεων.
Αυτή η τεκμηρίωση είναι δομημένη γύρω από την πρώτη περίπτωση — την Ψηφιακή Κάρτα Εργασίας — γιατί είναι η ροή που χρειάζονται οι περισσότεροι και έχει το πιο σαφές, συνεπές σχήμα API. Αν χρειάζεστε τους άλλους τύπους δηλώσεων (ωράρια, έντυπα προσλήψεων, άδειες), δείτε Άλλοι τύποι δηλώσεων μετά την ολοκλήρωση της ροής Κάρτας Εργασίας.
Η προτεινόμενη πορεία
- Οδηγός Γρήγορης Εκκίνησης — αυθεντικοποίηση και αποστολή του πρώτου σας γεγονότος προσέλευσης. 5–10 λεπτά.
- Βασικές Έννοιες — το νοητικό μοντέλο: γεγονότα, ημερομηνίες αναφοράς, κύκλος ζωής υποβολής.
- Αυθεντικοποίηση — κύκλος ζωής token και ανανέωση, για παραγωγική χρήση.
- Ροές Εργασίας — προσέλευση, αποχώρηση, διορθώσεις, εκπρόθεσμες υποβολές, μαζικές αποστολές.
- Διαχείριση Σφαλμάτων και Οδηγός Παραγωγικής Χρήσης — πριν τη μετάβαση σε παραγωγή.
Περιβάλλοντα
| Περιβάλλον | Βάση API |
|---|---|
| Δοκιμαστικό | https://trialv2eservices.yeka.gr/WebservicesAPI/Api/ |
| Παραγωγικό | https://eservices.yeka.gr/WebservicesAPI/Api/ |
Και τα δύο περιβάλλοντα χρησιμοποιούν πραγματικά διαπιστευτήρια e-ΕΦΚΑ. Τα έγγραφα που υποβάλλονται στο δοκιμαστικό περιβάλλον φέρουν την ένδειξη ΑΚΥΡΟ και δεν έχουν νομική ισχύ — εδώ κάνετε τις δοκιμές σας. Μην στρέψετε την ενσωμάτωσή σας στο παραγωγικό περιβάλλον πριν επιβεβαιώσετε ολόκληρη τη ροή στο δοκιμαστικό.
Τι ακολουθεί
Ξεκινήστε με τον Οδηγό Γρήγορης Εκκίνησης.