Αναφορά API Κάρτας Εργασίας (WRKCardSE)

Αυτή η σελίδα είναι η πλήρης αναφορά για την υποβολή WRKCardSE — κάθε endpoint, πεδίο και enum. Για οδηγούς βάσει εργασιών, δείτε τις Ροές Εργασίας. Για απλές εξηγήσεις αυτών των πεδίων, δείτε το Γλωσσάρι.

GET Documents/WRKCardSE — ανάκτηση του schema

Επιστρέφει το αναμενόμενο JSON shape για μια υποβολή WRKCardSE.

GET /Documents/WRKCardSE
Authorization: Bearer <accessToken>

{
  "Cards": {
    "Card": [
      {
        "f_afm_ergodoti": "f_afm_ergodoti",
        "f_aa": "f_aa",
        "f_comments": "f_comments",
        "Details": {
          "CardDetails": [
            {
              "f_afm": "f_afm",
              "f_eponymo": "f_eponymo",
              "f_onoma": "f_onoma",
              "f_type": "0",
              "f_reference_date": "2022-05-13",
              "f_date": "2022-05-13T09:21:37.4578278+03:00",
              "f_aitiologia": "f_aitiologia"
            }
          ]
        }
      }
    ]
  }
}

POST Documents/WRKCardSE — υποβολή προσέλευσης ή αποχώρησης

Δομή του request body

Cards
└── Card[]                    μία εγγραφή ανά παράρτημα
    ├── f_afm_ergodoti         ΑΦΜ εργοδότη
    ├── f_aa                   αριθμός παραρτήματος
    ├── f_comments             ελεύθερο σχόλιο (προαιρετικό)
    └── Details
        └── CardDetails[]      μία εγγραφή ανά γεγονός προσέλευσης/αποχώρησης
            ├── f_afm           ΑΦΜ εργαζομένου
            ├── f_eponymo       επώνυμο εργαζομένου
            ├── f_onoma         όνομα εργαζομένου
            ├── f_type          "0" προσέλευση | "1" αποχώρηση
            ├── f_reference_date  yyyy-MM-dd
            ├── f_date          ISO 8601 χρονοσφραγίδα με μετατόπιση
            └── f_aitiologia    κωδικός εκπρόθεσμης αιτιολόγησης, ή null

Πεδία Card

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
f_afm_ergodoti	string (9 ψηφία)	ναι	ΑΦΜ εργοδότη — πρέπει να ταιριάζει με τον συνδεδεμένο εργοδότη.
f_aa	string	ναι	Αριθμός παραρτήματος. "0" για το κεντρικό παράρτημα.
f_comments	string ή null	όχι	Ελεύθερο σχόλιο για αυτή την υποβολή.

Πεδία CardDetails

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
f_afm	string (9 ψηφία)	ναι	ΑΦΜ εργαζομένου.
f_eponymo	string	ναι	Επώνυμο εργαζομένου.
f_onoma	string	ναι	Όνομα εργαζομένου.
f_type	"0" | "1"	ναι	"0" = προσέλευση, "1" = αποχώρηση.
f_reference_date	string, yyyy-MM-dd	ναι	Η εργάσιμη ημέρα στην οποία ανήκει το γεγονός.
f_date	string, ISO 8601 με μετατόπιση	ναι	Ακριβής χρονοσφραγίδα του γεγονότος.
f_aitiologia	"001" | "002" | "003" | null	υπό συνθήκη	Απαιτείται μόνο όταν το γεγονός υποβάλλεται εκτός του 15-λεπτου παραθύρου εμπρόθεσμης υποβολής. Διαφορετικά null.

Enum f_type

Τιμή	Σημασία
"0"	Προσέλευση
"1"	Αποχώρηση

Enum f_aitiologia

Αυτοί οι κωδικοί εφαρμόζονται μόνο σε περιπτώσεις ανωτέρας βίας όπως περιγράφονται στις Εκπρόθεσμες & δικαιολογημένες υποβολές — δεν είναι μια γενική δικαιολογία "καθυστέρησης".

Τιμή	Σημασία
"001"	Διακοπή ρεύματος ή τηλεπικοινωνιών
"002"	Πρόβλημα στα συστήματα του εργοδότη
"003"	Πρόβλημα σύνδεσης με τον Εργάνη

Παράδειγμα request

{
  "Cards": {
    "Card": [
      {
        "f_afm_ergodoti": "094187530",
        "f_aa": "0",
        "f_comments": "test from REST API",
        "Details": {
          "CardDetails": [
            {
              "f_afm": "028233026",
              "f_eponymo": "ΚΑΠΟΙΟΣ",
              "f_onoma": "ΛΑΜΠΡΟΣ",
              "f_type": "0",
              "f_reference_date": "2024-05-04",
              "f_date": "2024-05-04T08:58:00+03:00",
              "f_aitiologia": null
            }
          ]
        }
      }
    ]
  }
}

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

[
  {
    "id": "92",
    "protocol": "ΕΥΣ92",
    "submitDate": "04/05/2024 08:58"
  }
]

Πεδίο	Περιγραφή
id	Εσωτερικό κλειδί αποθήκευσης. Δεν χρειάζεται για κανονική λειτουργία.
protocol	Αριθμός πρωτοκόλλου — αποθηκεύστε τον.
submitDate	Χρονοσφραγίδα που κατέγραψε το Εργάνη, dd/MM/yyyy HH:mm.

Απάντηση σφάλματος — 400 Bad Request

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

Δείτε Διαχείριση Σφαλμάτων για τη σημασία και τη διόρθωση.

Πολλαπλά γεγονότα σε ένα request

Ένα μόνο POST μπορεί να περιέχει:

• Πολλαπλές εγγραφές CardDetails κάτω από ένα Card — πολλούς εργαζομένους/γεγονότα για το ίδιο παράρτημα.
• Πολλαπλές εγγραφές Card κάτω από το Cards.Card — γεγονότα για διαφορετικά παραρτήματα του ίδιου εργοδότη, σε ένα request.

Δείτε Μαζικές υποβολές για ένα αναπτυγμένο παράδειγμα.

Επαναλαμβανόμενα γεγονότα για τον ίδιο εργαζόμενο και ημέρα

Μπορείτε να υποβάλετε περισσότερες από μία προσελεύσεις/αποχωρήσεις για το ίδιο f_afm και f_reference_date — ακόμα και πολλαπλά γεγονότα του ίδιου f_type (π.χ. δύο προσελεύσεις). Το Εργάνη θεωρεί πάντα το πιο πρόσφατα υποβληθέν γεγονός ενός δεδομένου τύπου ως το έγκυρο για αυτή την ημερομηνία αναφοράς. Έτσι λειτουργούν και τα διακεκομμένα ωράρια (προσέλευση, αποχώρηση, προσέλευση, αποχώρηση την ίδια ημέρα) και οι διορθώσεις — δείτε Διορθώσεις και Διακεκομμένα ωράρια.

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

GET /Documents/WRKCardSE?protocol=ΕΥΣ92&submittedDate=20240504
Authorization: Bearer <accessToken>

Παράμετρος query	Περιγραφή
protocol	Η τιμή protocol που επέστρεψε το επιτυχημένο POST.
submittedDate	Η ημερομηνία υποβολής, ως yyyymmdd.

Επιστρέφει το έγγραφο ως Base64-encoded PDF string.

POST Documents/CancelSubmittedDocument

Ανακαλεί μια προηγουμένως υποβληθείσα δήλωση. Μέχρι στιγμής, αυτό υποστηρίζεται μόνο για δηλώσεις αδειών (Οργάνωση Χρόνου Εργασίας – Άδειες και τις διορθώσεις τους ΟΡΘΗ ΕΠΑΝΑΛΗΨΗ) — όχι για WRKCardSE. Για να διορθώσετε μια προσέλευση/αποχώρηση, υποβάλετε ένα νέο γεγονός για τον ίδιο εργαζόμενο και ημερομηνία αναφοράς — δείτε Διορθώσεις.

POST /Documents/CancelSubmittedDocument
Content-Type: application/json
Authorization: Bearer <accessToken>

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

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

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

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