Generic Services

In addition to the declaration-oriented Documents endpoints, the API exposes a generic service catalog for auxiliary lookups (e.g. employer master data).

GET WebServices/ServicesList

Returns all available services for the authenticated employer, with their parameters. No request parameters.

Response (no parameters)

[
  {
    "name": "EX_BASE_01",
    "description": "ΣΤΟΙΧΕΙΑ ΕΡΓΟΔΟΤΗ",
    "parameters": []
  },
  {
    "name": "EX_BASE_02",
    "description": "ΣΤΟΙΧΕΙΑ ΠΑΡΑΡΤΗΜΑΤΩΝ",
    "parameters": []
  }
]

Response (with parameters)

[
  {
    "name": "EX_BASE_03",
    "description": "ΣΤΟΙΧΕΙΑ ΤΟΥ SERVICE EX_BASE_03",
    "parameters": [
      {
        "name": "Param1",
        "description": "Περιγραφή παραμέτρου 1",
        "isRequired": true,
        "type": "Int",
        "maxLength": 0
      },
      {
        "name": "Param2",
        "description": "Περιγραφή παραμέτρου 2",
        "isRequired": false,
        "type": "Int",
        "maxLength": 0
      }
    ]
  }
]

Parameter type values

Value	Type
1	Text
2	Date
3	Int
4	Decimal
5	ListString
6	ListInt
7	ListStringDate
8	XML
9	MIME

maxLength applies only when type is Text.

POST WebServices/ExecuteService

Executes a named service with its parameters.

Request

POST /WebServices/ExecuteService
Content-Type: application/json

{
  "ServiceCode": "SERVICE1",
  "Parameters": [
    {
      "ParameterName": "Afm",
      "ParameterValue": "000000000"
    }
  ]
}

• ServiceCode and all required parameters must be supplied.
• If a service takes no parameters, send "Parameters": [].

Success response — 200 OK

{
  "EX_BASE_01": {
    "Ergodotis": {
      "Afm": "012345678",
      "Eponimia": "ΑΝΩΝΥΜΗ ΒΙΟΜΗΧΑΝΙΚΗ Κ ΕΜΠΟΡΙΚΗ ΕΤΑΙΡΕΙΑ",
      "DiakritikosTitlos": "ΕΤΑΙΡΕΙΑ ΑΕ",
      "Ame": "0987654321"
    }
  }
}

Error response — 400 Bad Request

{
  "message": "Service Code is not authenticated to specific User"
}

EX_BASE_04 — Monthly Employment Status (Μηνιαία Εργασιακή Κατάσταση)

Returns, per employee, a detailed snapshot of their employment status and leave/absence day counters for a given calendar month.

Request for EX_BASE_04

{
  "ServiceCode": "EX_BASE_04",
  "Parameters": [
    {
      "ParameterName": "ReportYear",
      "ParameterValue": "2024"
    },
    {
      "ParameterName": "ReportMonth",
      "ParameterValue": "10"
    }
  ]
}

Both ReportYear and ReportMonth are required.

Success response for EX_BASE_04 — 200 OK

{
  "EX_BASE_04": {
    "MiniaiaKatastash": {
      "f_ergodoti_id": "29281",
      "f_pararthma_aa": "0",
      "f_year": "2024",
      "f_month": "10",
      "f_ergazomenos_type": "Εξαρτημένη",
      "f_afm": "000000000",
      "f_eponimo": "ΚΑΠΟΙΟΣ",
      "f_onoma": "ΝΙΚΟΛΑΟΣ",
      "f_amka": "01010101010",
      "f_sxesh_apasxolhshs": "Αορίστου Χρόνου",
      "f_kathestos": "Πλήρης",
      "f_apodoxes": "5500.00",
      "f_week_wres": "40.0",
      "f_date_proslipsis": "2024-09-01T00:00:00+03:00",
      "f_arithmos_hmerwn_ergasias": "23",
      "f_arithmos_hmerwn_anapaushs_repo": "8",
      "f_arithmos_hmerwn_kanonikh_adeia": "0"
    }
  }
}

The full response includes one MiniaiaKatastash object per employee, with personal/employment details (f_afm, f_amka, f_sxesh_apasxolhshs, f_kathestos, f_apodoxes, f_week_wres, f_date_proslipsis, etc.) plus a large set of f_arithmos_hmerwn_* / f_arithmos_leptwn_* counters — one per leave/absence type (see Leave Type Codes) — giving the number of days/minutes of that type recorded for the employee in the requested month.