Γενικές Υπηρεσίες

Πέρα από τα endpoints Documents που σχετίζονται με δηλώσεις, το API διαθέτει και έναν γενικό κατάλογο υπηρεσιών για βοηθητικές αναζητήσεις (π.χ. βασικά στοιχεία εργοδότη).

GET WebServices/ServicesList

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

Απόκριση (χωρίς παραμέτρους)

[
  {
    "name": "EX_BASE_01",
    "description": "ΣΤΟΙΧΕΙΑ ΕΡΓΟΔΟΤΗ",
    "parameters": []
  },
  {
    "name": "EX_BASE_02",
    "description": "ΣΤΟΙΧΕΙΑ ΠΑΡΑΡΤΗΜΑΤΩΝ",
    "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
      }
    ]
  }
]

Τιμές type παραμέτρου

Τιμή	Τύπος
1	Text
2	Date
3	Int
4	Decimal
5	ListString
6	ListInt
7	ListStringDate
8	XML
9	MIME

Το maxLength εφαρμόζεται μόνο όταν type είναι Text.

POST WebServices/ExecuteService

Εκτελεί μια ονομαζόμενη υπηρεσία με τις παραμέτρους της.

Αίτημα

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

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

• Το ServiceCode και όλες οι υποχρεωτικές παράμετροι πρέπει να παρέχονται.
• Εάν μια υπηρεσία δεν δέχεται παραμέτρους, στείλτε "Parameters": [].

Απόκριση επιτυχίας — 200 OK

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

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

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

EX_BASE_04 — Μηνιαία Εργασιακή Κατάσταση

Επιστρέφει, ανά εργαζόμενο, μια αναλυτική εικόνα της εργασιακής του κατάστασης και τους μετρητές ημερών/λεπτών αδειών-απουσιών για συγκεκριμένο ημερολογιακό μήνα.

Αίτημα για το EX_BASE_04

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

Τα ReportYear και ReportMonth είναι υποχρεωτικά.

Απόκριση επιτυχίας για το 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"
    }
  }
}

Η πλήρης απόκριση περιλαμβάνει ένα αντικείμενο MiniaiaKatastash ανά εργαζόμενο, με προσωπικά/εργασιακά στοιχεία (f_afm, f_amka, f_sxesh_apasxolhshs, f_kathestos, f_apodoxes, f_week_wres, f_date_proslipsis, κ.λπ.) και ένα μεγάλο σύνολο μετρητών f_arithmos_hmerwn_* / f_arithmos_leptwn_* — έναν ανά τύπο άδειας/απουσίας (δείτε Κωδικοί Τύπων Αδειών) — που δίνουν τον αριθμό ημερών/λεπτών του συγκεκριμένου τύπου για τον εργαζόμενο στον μήνα που ζητήθηκε.