Glossary

Every field name below is the real wire field name used by the Ergani Web API — you'll see these exact names in requests and responses. This page maps each one to a plain-English meaning. Bookmark it: you'll come back to it while reading Workflows and the Work Card API Reference.

Identity fields

Field	Plain English
f_afm_ergodoti	The employer's Tax ID (ΑΦΜ). Used to confirm the submission belongs to the connected employer.
f_aa	The branch number (Α/Α Παραρτήματος) — "0" for the main branch.
f_afm	The employee's Tax ID (ΑΦΜ).
f_eponymo	The employee's surname.
f_onoma	The employee's first name.

Event fields

Field	Plain English
f_type	The kind of event: "0" = check-in (Προσέλευση), "1" = check-out (Αποχώρηση).
f_reference_date	The work-day this event belongs to, as yyyy-MM-dd. A check-out after midnight still belongs to the previous day's reference date.
f_date	The exact timestamp of the check-in/check-out, as ISO 8601 with a timezone offset (e.g. 2024-05-04T08:58:00+03:00).
f_aitiologia	A justification code (001, 002, or 003) required only when the event is submitted late. null for on-time events. See On-time vs. late.
f_comments	A free-text note attached to the whole submission. Optional.

Response fields

Field	Plain English
protocol	Ergani's confirmation ID for this submission. This is your proof the event was accepted — store it.
submitDate	The timestamp Ergani recorded the submission, as dd/MM/yyyy HH:mm.
id	An internal storage key for the submission. You won't need this for normal operation — use protocol instead.

Other terms

Term	Plain English
ΑΦΜ (AFM)	Greek Tax Registration Number — a 9-digit ID for both people and businesses.
WRKCardSE	The submission code for a Work Card check-in/check-out event. This is the code you send to Documents/{code}.
Παράρτημα (branch)	A physical location/establishment under the same employer. Identified by f_aa.
Ημερολόγιο Πραγματικής Απασχόλησης	"Actual Work Calendar" — Ergani's per-employee, per-day record built from accepted check-in/check-out events.