Skip to main content

Other Declaration Types

Looking for Work Card check-in/check-out?

That's WRKCardSE — see Workflows and the Work Card API Reference. This page covers every other submission type: schedules, hiring forms, leaves, and more.

GET Lookup/Submissions

Returns all active submission types available to the authenticated user. No request parameters.

Response

[
{
"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": "Οργάνωση Χρόνου Εργασίας - Σταθερό Εβδομαδιαίο"
}
]

The code field is used in the Documents/{code} routes below. The example response above is not exhaustive — the companion-files appendix lists further codes, including the ones below.

Other known submission codes

CodeDeclaration
OvTimeE8 — Αναγγελία Νόμιμης Υπερωριακής Απασχόλησης (Overtime)
OvTimeAE8 Απολογιστικό — after-the-fact overtime (see Environments & Companion Files)
WTODailyAVariable/Modified Per-Day, Απολογιστικό (after-the-fact) variant of WTODaily
WTODailyDVariable/Modified Per-Day, Οδηγοί (drivers) variant of WTODaily
WTOOvOvertime — Οδηγοί (drivers) variant
WTOOvAOvertime — Οδηγοί, Απολογιστικό variant
WTOOvDOvertime — Οδηγοί variant (XML/JSON example WTOOv.json)
SixthDay6th-Day Employment Declaration
ExProanExemption from Pre-Announcement
WebE3NΈναρξη Απασχόλησης – Πρόσληψη (new hire)
WebE3MΈναρξη Απασχόλησης – Μεταβίβαση από Επιχείρηση (employee transferred in from another business)
WebE3DΈναρξη Απασχόλησης – Δανεισμός από Επιχείρηση (employee loaned/seconded in from another business)
WebE3PDΈναρξη Απασχόλησης – Πρόσληψη για Δανεισμό (hired for the purpose of being loaned out)
WebE5NΛήξη Απασχόλησης – Οικειοθελής Αποχώρηση (voluntary resignation)
WebE5OΛήξη Απασχόλησης – Δήλωση Όχλησης για Οικειοθελή Αποχώρηση (notice of intent to resign)
WebE5AOΛήξη Απασχόλησης – Οικειοθελής Αποχώρηση μετά από Όχληση (resignation following a prior notice)
WebE5EΛήξη Απασχόλησης – Εθελούσια Έξοδος (voluntary exit / severance)
WebE6NXPΛήξη Απασχόλησης – Καταγγελία Σύμβασης χωρίς Προειδοποίηση (contract termination without notice)
WebE6NMPΛήξη Απασχόλησης – Καταγγελία Σύμβασης με Προειδοποίηση (contract termination with notice)
WebE7NΛήξη Απασχόλησης – Λύση Σύμβασης Ορισμένου Χρόνου (end of fixed-term contract)

The JSON request/response shapes for these codes follow the same pattern as E3/WKChgWK/OvTime above (retrieve the schema via GET Documents/{code} before submitting). The companion-files appendix names each code's JSON example file (e.g. testProslipsiNew.json for WebE3N, testApoxwrhshNew.json for WebE5N) but the schemas themselves are not reproduced in the source manual.

Termination declaration sub-types — attachment & signature requirements

Each WebE5*/WebE6*/WebE7* termination code corresponds to one Είδος ψηφιακής αναγγελίας λήξης εργασίας (termination declaration sub-type). Beyond the codes above, the underlying submission types also cover sub-types with no dedicated Web* code yet documented — but all share the same POST Documents/{code} shape, with a file-attachment requirement that varies by sub-type:

Termination sub-typeRequires file attachmentEmployee-only signatureEmployer + employee signatures
Αυτοδίκαιη Λύση Δοκιμαστικής Περιόδου
Εθελούσια Έξοδος
Καταγγελία Σύμβασης με Προειδοποίηση
Καταγγελία Σύμβασης χωρίς Προειδοποίηση
Λήξη Δανεισμού από Επιχείρηση
Λήξη λόγω Θανάτου
Λύση Σύμβασης Ορισμένου Χρόνου
Μεταβίβαση σε Επιχείρηση
Οικειοθελής Αποχώρηση
Οικειοθελής Αποχώρηση μετά από Όχληση
Δήλωση Όχλησης για δυνατότητα Οικειοθελούς Αποχώρησης
Συνταξιοδότηση με Καταγγελία Σύμβασης χωρίς Προειδοποίηση
Συνταξιοδότηση με Οικειοθελή Αποχώρηση
Οικειοθελής αποχώρηση λόγω συμπλήρωσης δεκαπενταετίας ή υπέρβασης ορίου ηλικίας συνταξιοδότησης με τη συγκατάθεση του εργοδότη

When a row requires a file attachment, POST Documents/{code} must include the signed declaration (PDF, electronically signed by the indicated parties, or signed via gov.gr/MyErgani) as a Base64/MIME field — retrieve the exact field name via GET Documents/{code} for that code. Rows with no attachment requirement omit that field entirely.

GET Documents/{code}

Returns the JSON schema for a given active submission type, as returned by Lookup/Submissions in the code field. Call this before building a request for a code you haven't used before — it returns the exact field names and nesting your POST body must match.

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

For a worked example of this request/response pattern (using WRKCardSE), see the Work Card API Reference.

POST Documents/{code} — submit a new declaration

Submits a new declaration of the given type. The request body matches the shape returned by GET Documents/{code} for that code — field names and nesting vary by submission type. The response shape, however, is consistent across all codes:

[
{
"id": "92",
"protocol": "ΕΥΣ92",
"submitDate": "04/05/2022 01:13"
}
]
FieldDescription
idStorage key for the submission
protocolProtocol number (Αριθμός Πρωτοκόλλου) — your proof of acceptance
submitDateSubmission timestamp

Error response — 400 Bad Request

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

message describes the specific validation failure for that code. See Error Handling for the general pattern.

POST Documents/CancelSubmittedDocument — cancel a submitted declaration

Revokes (ανάκληση) a previously submitted declaration. As of this writing, this is supported only for:

  • Οργάνωση Χρόνου Εργασίας – Άδειες (Leave declarations), and
  • Οργάνωση Χρόνου Εργασίας – Άδειες ΟΡΘΗ ΕΠΑΝΑΛΗΨΗ (Leave correction resubmissions).

Request

POST /Documents/CancelSubmittedDocument
Content-Type: application/json
{
"TypeOfDocument": "00009",
"Protocol": "TA123",
"SubmittedDate": "19800410"
}
FieldDescription
TypeOfDocumentCode of the active submission type (κωδικός ενεργής υποβολής)
ProtocolProtocol number of the submission to cancel (αριθμός πρωτοκόλλου)
SubmittedDateSubmission date, format yyyymmdd

Success response — 200 OK

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

GET Documents/{code}?protocol=...&submittedDate=... — retrieve submitted PDF

Retrieves the PDF of a previously submitted declaration, returned as a Base64-encoded string.

Query parameters

ParameterDescription
protocolThe protocol number returned by the successful POST
submittedDateThe submission date, format yyyymmdd
GET /Documents/{code}?protocol=ΕΥΣ92&submittedDate=20220504
Authorization: Bearer <accessToken>