Skip to main content

Διαχείριση Σφαλμάτων

Το Εργάνη δεν δημοσιεύει πλήρη κατάλογο κωδικών σφαλμάτων

Δεν υπάρχει λίστα αριθμημένων κωδικών σφαλμάτων. Τα σφάλματα επιστρέφονται ως 400 Bad Request με ένα αναγνώσιμο string message στα ελληνικά. Ο παρακάτω πίνακας καλύπτει κάθε μήνυμα σφάλματος που τεκμηριώνεται στα επίσημα εγχειρίδια και τα σφάλματα αυθεντικοποίησης. Για κάθε άλλο message, διαβάστε το κατά γράμμα — περιγράφει τον συγκεκριμένο κανόνα επικύρωσης που αποτυγχάνει — και μην επαναλάβετε χωρίς αλλαγή στο request.

Πώς να διαβάσετε μια απάντηση σφάλματος​

{
  "message": "Για το Παράρτημα: 0\\nΤο ΑΦΜ δεν αντιστοιχεί στον συνδεδεμένο εργοδότη."
}
  • HTTP status 400 → το request απορρίφθηκε. Τίποτα δεν καταγράφηκε. Δεν εκδόθηκε protocol.
  • message → ελληνικό κείμενο που περιγράφει ακριβώς τι δεν είναι σωστό, συχνά αναφέροντας το συγκεκριμένο παράρτημα (Παράρτημα) ή πεδίο.

Τεκμηριωμένα σφάλματα​

HTTP statusmessage (ή συνθήκη)ΣημασίαΒασική αιτίαΔιόρθωσηΕπανάληψη;
400Το ΑΦΜ δεν αντιστοιχεί στον συνδεδεμένο εργοδότη.Το ΑΦΜ εργαζομένου στο f_afm, ή το ΑΦΜ εργοδότη στο f_afm_ergodoti, δεν ταιριάζει με τον εργοδότη με τον οποίο είναι συνδεδεμένα τα διαπιστευτήρια σας.Λάθος ΑΦΜ, ή δοκιμή ΑΦΜ παραγωγής στο δοκιμαστικό περιβάλλον (ή το αντίστροφο).Χρησιμοποιήστε το ΑΦΜ του εργοδότη/εργαζομένου που είναι πραγματικά συνδεδεμένος με τον λογαριασμό σας σε αυτό το περιβάλλον.Όχι — διορθώστε πρώτα τα δεδομένα.
400"message": "Service Code is not authenticated to specific User" (από WebServices/ExecuteService)Ο λογαριασμός σας δεν είναι εξουσιοδοτημένος για το αιτούμενο ServiceCode.Η υπηρεσία είναι περιορισμένη σε συγκεκριμένους τύπους/ρόλους χρηστών.Επιβεβαιώστε ότι η υπηρεσία είναι διαθέσιμη για τον λογαριασμό σας μέσω WebServices/ServicesList.Όχι.
401Unauthorized σε οποιοδήποτε endpoint εκτός από AuthenticationΤο access token δεν είναι έγκυρο ή έχει λήξει.Λήξη token (διάρκεια ζωής 3ω), ή δεν στάλθηκε.Καλέστε Authentication/Refresh, και επαναλάβετε το αρχικό request μία φορά.Ναι, μία φορά, μετά την ανανέωση.
401Unauthorized στο Authentication/RefreshΤο refresh token δεν είναι έγκυρο ή έχει λήξει (διάρκεια ζωής 7η).Έχει περάσει πολύς χρόνος από την τελευταία κλήση Authentication.Καλέστε ξανά το Authentication με διαπιστευτήρια.Ναι, μία φορά, μετά την επαναυθεντικοποίηση.
—Header απάντησης api-token-expired: trueΊδιο με 401 παραπάνω — το access token έχει λήξει.Όπως παραπάνω.Όπως παραπάνω.Ναι, μία φορά, μετά την ανανέωση.
429Too Many RequestsΈχετε υπερβεί το όριο ρυθμού του Εργάνη για κλήσεις αυθεντικοποίησης.Κλήση Authentication ή Authentication/Refresh σε κάθε request αντί για επαναχρησιμοποίηση tokens.Σταματήστε να αυθεντικοποιείστε ανά request — δείτε Αυθεντικοποίηση.Όχι — διορθώστε πρώτα το μοτίβο κλήσεων, μετά κάντε αναμονή πριν επαναλάβετε.

Σφάλματα επικύρωσης που δεν είναι στον παραπάνω πίνακα​

Οι υποβολές WRKCardSE απορρίπτονται επίσης για λόγους που καλύπτονται στην Αναφορά API Κάρτας Εργασίας και στις Βασικές Έννοιες, χωρίς ένα μοναδικό σταθερό μήνυμα:

  • Ένα απαιτούμενο πεδίο λείπει ή έχει λάθος τύπο (π.χ. το f_type δεν είναι "0" ή "1").
  • Το f_aitiologia είναι null αλλά το γεγονός είναι εκπρόθεσμο κατά περισσότερο από 15 λεπτά, ή το f_aitiologia έχει τιμή αλλά το γεγονός είναι εμπρόθεσμο.
  • Το f_aitiologia έχει τιμή διαφορετική από "001", "002", "003".
  • Ο συνδυασμός f_reference_date / f_date παραβιάζει τους κανόνες προσέλευσης ή αποχώρησης στην Αναφορά API Κάρτας Εργασίας.

Για όλα αυτά, το message περιγράφει το συγκεκριμένο πρόβλημα — θεωρήστε το αυθεντικό και προσαρμόστε το request. Κανένα από αυτά δεν είναι επαναλήψιμο χωρίς αλλαγή στο payload.

Γενικός κανόνας​

StatusΕπανάληψη;
400Όχι — διορθώστε το request.
401 / api-token-expired: trueΝαι, μία φορά, μετά την ανανέωση ή επαναυθεντικοποίηση.
429Όχι αμέσως — βρίσκεστε υπό rate limiting λόγω του τρόπου που καλείτε το API, όχι λόγω αυτού του request.
5xxΔείτε τον Οδηγό Παραγωγικής Χρήσης για στρατηγική επανάληψης/backoff.

Τι ακολουθεί​