Άλλοι Τύποι Δηλώσεων

Ψάχνετε για προσέλευση/αποχώρηση Κάρτας Εργασίας;

Αυτό είναι το WRKCardSE — δείτε Ροές Εργασίας και την Αναφορά API Κάρτας Εργασίας. Αυτή η σελίδα καλύπτει κάθε άλλο τύπο υποβολής: ωράρια, έντυπα προσλήψεων, άδειες, και άλλα.

GET `Lookup/Submissions`

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

Απόκριση

[
  {
    "id": 82,
    "code": "WRKCardSE",
    "description": "Δήλωση έναρξης/λήξης εργασίας εργαζομένων"
  },
  {
    "id": 79,
    "code": "WKChgWK",
    "description": "Δήλωση Μεταβολής Στοιχείων Εργασιακής Σχέσης - Οργάνωση Χρόνου Εργασίας"
  },
  {
    "id": 8,
    "code": "E3",
    "description": "Ε3 ΕΝΙΑΙΟ ΕΝΤΥΠΟ ΑΝΑΓΓΕΛΙΑΣ ΠΡΟΣΛΗΨΗΣ"
  },
  {
    "id": 81,
    "code": "WTODaily",
    "description": "Οργάνωση Χρόνου Εργασίας - Μεταβαλλόμενο/Τροποποιούμενο ανά Ημέρα"
  },
  {
    "id": 80,
    "code": "WTOWeek",
    "description": "Οργάνωση Χρόνου Εργασίας - Σταθερό Εβδομαδιαίο"
  }
]

Το πεδίο code χρησιμοποιείται στις διαδρομές Documents/{code} παρακάτω. Η παραπάνω παραδειγματική απόκριση δεν είναι πλήρης — το παράρτημα συνοδευτικών αρχείων αναφέρει επιπλέον κωδικούς, μεταξύ των οποίων οι παρακάτω.

Άλλοι γνωστοί κωδικοί υποβολής

Κωδικός	Δήλωση
`OvTime`	E8 — Αναγγελία Νόμιμης Υπερωριακής Απασχόλησης
`OvTimeA`	E8 Απολογιστικό — εκ των υστέρων δήλωση υπερωρίας (βλ. Περιβάλλοντα & Συνοδευτικά Αρχεία)
`WTODailyA`	Μεταβαλλόμενο/Τροποποιούμενο ανά Ημέρα, παραλλαγή Απολογιστικό του `WTODaily`
`WTODailyD`	Μεταβαλλόμενο/Τροποποιούμενο ανά Ημέρα, παραλλαγή Οδηγοί του `WTODaily`
`WTOOv`	Υπερωρίες — παραλλαγή Οδηγοί
`WTOOvA`	Υπερωρίες — παραλλαγή Οδηγοί, Απολογιστικό
`WTOOvD`	Υπερωρίες — παραλλαγή Οδηγοί (παράδειγμα XML/JSON `WTOOv.json`)
`SixthDay`	Δήλωση Απασχόλησης την 6η Ημέρα
`ExProan`	Δήλωση Εξαίρεσης από την Υποχρέωση Προαναγγελίας
`WebE3N`	Έναρξη Απασχόλησης – Πρόσληψη
`WebE3M`	Έναρξη Απασχόλησης – Μεταβίβαση από Επιχείρηση
`WebE3D`	Έναρξη Απασχόλησης – Δανεισμός από Επιχείρηση
`WebE3PD`	Έναρξη Απασχόλησης – Πρόσληψη για Δανεισμό
`WebE5N`	Λήξη Απασχόλησης – Οικειοθελής Αποχώρηση
`WebE5O`	Λήξη Απασχόλησης – Δήλωση Όχλησης για Οικειοθελή Αποχώρηση
`WebE5AO`	Λήξη Απασχόλησης – Οικειοθελής Αποχώρηση μετά από Όχληση
`WebE5E`	Λήξη Απασχόλησης – Εθελούσια Έξοδος
`WebE6NXP`	Λήξη Απασχόλησης – Καταγγελία Σύμβασης χωρίς Προειδοποίηση
`WebE6NMP`	Λήξη Απασχόλησης – Καταγγελία Σύμβασης με Προειδοποίηση
`WebE7N`	Λήξη Απασχόλησης – Λύση Σύμβασης Ορισμένου Χρόνου

Οι μορφές request/response JSON για αυτούς τους κωδικούς ακολουθούν το ίδιο πρότυπο με τα E3/WKChgWK/OvTime παραπάνω (ανακτήστε το schema μέσω GET Documents/{code} πριν την υποβολή). Το παράρτημα συνοδευτικών αρχείων αναφέρει το αρχείο παραδείγματος JSON για κάθε κωδικό (π.χ. testProslipsiNew.json για το WebE3N, testApoxwrhshNew.json για το WebE5N), αλλά τα ίδια τα schemas δεν περιλαμβάνονται στο εγχειρίδιο.

Υποτύποι δηλώσεων λήξης — απαιτήσεις επισύναψης αρχείου & υπογραφών

Κάθε κωδικός λήξης WebE5*/WebE6*/WebE7* αντιστοιχεί σε ένα Είδος ψηφιακής αναγγελίας λήξης εργασίας. Πέρα από τους παραπάνω κωδικούς, οι υποκείμενοι τύποι υποβολών καλύπτουν επίσης υποτύπους χωρίς ακόμη τεκμηριωμένο Web* κωδικό — όλοι όμως μοιράζονται την ίδια μορφή POST Documents/{code}, με απαίτηση επισύναψης αρχείου που διαφέρει ανά υποτύπο:

Υποτύπος λήξης εργασίας	Υποχρέωση επισύναψης αρχείου	Υπογραφή μόνο εργαζόμενου	Υπογραφές εργοδότη και εργαζόμενου
Αυτοδίκαιη Λύση Δοκιμαστικής Περιόδου	—	—	—
Εθελούσια Έξοδος	✓	—	✓
Καταγγελία Σύμβασης με Προειδοποίηση	✓	—	✓
Καταγγελία Σύμβασης χωρίς Προειδοποίηση	✓	—	✓
Λήξη Δανεισμού από Επιχείρηση	—	—	—
Λήξη λόγω Θανάτου	—	—	—
Λύση Σύμβασης Ορισμένου Χρόνου	—	—	—
Μεταβίβαση σε Επιχείρηση	—	—	—
Οικειοθελής Αποχώρηση	✓	✓	—
Οικειοθελής Αποχώρηση μετά από Όχληση	—	—	—
Δήλωση Όχλησης για δυνατότητα Οικειοθελούς Αποχώρησης	—	—	—
Συνταξιοδότηση με Καταγγελία Σύμβασης χωρίς Προειδοποίηση	✓	—	✓
Συνταξιοδότηση με Οικειοθελή Αποχώρηση	✓	✓	—
Οικειοθελής αποχώρηση λόγω συμπλήρωσης δεκαπενταετίας ή υπέρβασης ορίου ηλικίας συνταξιοδότησης με τη συγκατάθεση του εργοδότη	✓	—	✓

Όταν μια γραμμή απαιτεί επισύναψη αρχείου, το POST Documents/{code} πρέπει να περιλαμβάνει την υπογεγραμμένη δήλωση (PDF, με ηλεκτρονική υπογραφή από τα υποδεικνυόμενα μέρη, ή υπογεγραμμένη μέσω gov.gr/MyErgani) ως πεδίο Base64/MIME — ανακτήστε το ακριβές όνομα πεδίου μέσω GET Documents/{code} για τον συγκεκριμένο κωδικό. Οι γραμμές χωρίς απαίτηση επισύναψης παραλείπουν εντελώς αυτό το πεδίο.

GET `Documents/{code}`

Επιστρέφει το JSON schema για έναν δεδομένο ενεργό τύπο υποβολής, όπως αυτός επιστρέφεται από το Lookup/Submissions στο πεδίο code. Καλέστε το πριν φτιάξετε ένα request για έναν κωδικό που δεν έχετε χρησιμοποιήσει πριν — επιστρέφει τα ακριβή ονόματα και την ένθεση πεδίων που πρέπει να ταιριάζει το σώμα του POST σας.

GET /Documents/{code}
Authorization: Bearer <accessToken>

Για ένα αναλυτικό παράδειγμα αυτού του προτύπου request/response (με χρήση του WRKCardSE), δείτε την Αναφορά API Κάρτας Εργασίας.

POST `Documents/{code}` — υποβολή νέας δήλωσης

Υποβάλλει μια νέα δήλωση του δεδομένου τύπου. Το σώμα του request ταιριάζει με τη δομή που επιστρέφει το GET Documents/{code} για αυτόν τον κωδικό — τα ονόματα πεδίων και η ένθεση διαφέρουν ανά τύπο υποβολής. Η μορφή της απόκρισης, όμως, είναι συνεπής σε όλους τους κωδικούς:

[
  {
    "id": "92",
    "protocol": "ΕΥΣ92",
    "submitDate": "04/05/2022 01:13"
  }
]

Πεδίο	Περιγραφή
`id`	Κλειδί αποθήκευσης για την υποβολή
`protocol`	Αριθμός Πρωτοκόλλου — η απόδειξη αποδοχής σας
`submitDate`	Χρονοσήμανση υποβολής

Απόκριση σφάλματος — `400 Bad Request`

{
  "message": "Για το Παράρτημα: 0\\nΤο ΑΦΜ δεν αντιστοιχεί στον συνδεδεμένο εργοδότη."
}

Το message περιγράφει τη συγκεκριμένη αποτυχία επικύρωσης για αυτόν τον κωδικό. Δείτε Διαχείριση Σφαλμάτων για το γενικό πρότυπο.

POST `Documents/CancelSubmittedDocument` — ακύρωση υποβληθείσας δήλωσης

Ανακαλεί μια προηγουμένως υποβληθείσα δήλωση. Μέχρι στιγμής, αυτό υποστηρίζεται μόνο για:

Οργάνωση Χρόνου Εργασίας – Άδειες (δηλώσεις αδειών), και
Οργάνωση Χρόνου Εργασίας – Άδειες ΟΡΘΗ ΕΠΑΝΑΛΗΨΗ (επανυποβολές διόρθωσης αδειών).

Request

POST /Documents/CancelSubmittedDocument
Content-Type: application/json

{
  "TypeOfDocument": "00009",
  "Protocol": "TA123",
  "SubmittedDate": "19800410"
}

Πεδίο	Περιγραφή
`TypeOfDocument`	Κωδικός του ενεργού τύπου υποβολής
`Protocol`	Αριθμός πρωτοκόλλου της υποβολής που ανακαλείται
`SubmittedDate`	Ημερομηνία υποβολής, μορφή `yyyymmdd`

Απάντηση επιτυχίας — `200 OK`

{
  "message": "Η ακύρωση ολοκληρώθηκε επιτυχώς"
}

GET `Documents/{code}?protocol=...&submittedDate=...` — ανάκτηση υποβληθέντος PDF

Ανακτά το PDF μιας προηγουμένως υποβληθείσας δήλωσης, το οποίο επιστρέφεται ως συμβολοσειρά κωδικοποιημένη σε Base64.

Παράμετροι αιτήματος

Παράμετρος	Περιγραφή
`protocol`	Ο αριθμός πρωτοκόλλου που επιστράφηκε από το επιτυχημένο POST
`submittedDate`	Η ημερομηνία υποβολής, σε μορφή `yyyymmdd`

GET /Documents/{code}?protocol=ΕΥΣ92&submittedDate=20220504
Authorization: Bearer <accessToken>

GET Lookup/Submissions​

Απόκριση​

Άλλοι γνωστοί κωδικοί υποβολής​

Υποτύποι δηλώσεων λήξης — απαιτήσεις επισύναψης αρχείου & υπογραφών​

GET Documents/{code}​

POST Documents/{code} — υποβολή νέας δήλωσης​

Απόκριση σφάλματος — 400 Bad Request​

POST Documents/CancelSubmittedDocument — ακύρωση υποβληθείσας δήλωσης​

Request​

Απάντηση επιτυχίας — 200 OK​

GET Documents/{code}?protocol=...&submittedDate=... — ανάκτηση υποβληθέντος PDF​

Παράμετροι αιτήματος​