Ο e-ΕΦΚΑ δεν έχει API.Έτσι έβαλα ένα ρομπότ να τον διαβάζει

Στο Forologika ο χρήστης βλέπει σε μία οθόνη τι χρωστάει στην εφορία και στον e-ΕΦΚΑ. Για το myDATA υπάρχει επίσημο API. Για τις εισφορές του e-ΕΦΚΑ και τις οφειλές του ΚΕΑΟ, όχι. Η μόνη λύση ήταν ένας αυτοματισμός που μπαίνει στην πλατφόρμα όπως θα έμπαινε ο ίδιος ο χρήστης.

Αυτή είναι η ιστορία αυτού του «ρομπότ»: τι έφτιαξα, τι χάλασε και τι έμαθα.

Τι κάνει το ρομπότ σε κάθε διαδρομή

Το ρομπότ είναι ένας browser χωρίς οθόνη που συνδέεται όπως θα συνδεόταν ένας άνθρωπος και διαβάζει ποσά και ημερομηνίες λήξης από το επίσημο ειδοποιητήριο PDF, όχι από κείμενα της σελίδας που αλλάζουν συχνά.

Μία διαδρομή του ρομπότ

1. Ξεκινά ένας browser χωρίς οθόνηPlaywright, σε δικό του server, ξεχωριστά από την ιστοσελίδα
2. Συνδέεται μέσω TAXISnetΖητά από τον χρήστη τον κωδικό μίας χρήσης (OTP) όπου χρειάζεται
3. Διαβάζει το επίσημο ειδοποιητήριο PDFΕισφορές, ποσά και ημερομηνίες λήξης
4. Επιστρέφει μόνο τα απαραίτηταΜόνο τα στοιχεία που χρειάζεται η εφαρμογή

Τι χάλασε (και πώς το διόρθωσα)

Η πλατφόρμα μετακόμισε

Τον Σεπτέμβριο του 2026 η πύλη του e-ΕΦΚΑ άλλαξε διεύθυνση. Η παλιά έβγαζε απλώς σφάλμα «δεν βρέθηκε». Αυτό είναι το μεγαλύτερο ρίσκο κάθε τέτοιου αυτοματισμού: την άλλη πλευρά δεν την ελέγχω εγώ. Γι’ αυτό και ο worker είναι απομονωμένος. Όταν κάτι αλλάζει, η υπόλοιπη εφαρμογή συνεχίζει να δουλεύει και ο χρήστης βλέπει τα τελευταία στοιχεία που έχουν διαβαστεί.

Browsers που δεν έκλειναν ποτέ

Κάθε σύνδεση ανοίγει έναν browser. Όταν μια συνεδρία δεν έκλεινε σωστά, ο browser έμενε ανοιχτός και «κρατούσε» το προφίλ του, με αποτέλεσμα η επόμενη σύνδεση να αποτυγχάνει. Πλέον κάθε ολοκληρωμένη συνεδρία κλείνει υποχρεωτικά τον browser της και οι νέες συνεδρίες ξεκινούν μία μία.

Το όριο των 120 δευτερολέπτων

Η εφαρμογή περιμένει απάντηση από τον worker για περίπου δύο λεπτά, και μια αργή κρατική σελίδα μπορούσε να ξεπεράσει αυτό το όριο. Πλέον ο worker απαντά πάντα μέσα σε 90 δευτερόλεπτα, έστω και με «δεν ολοκληρώθηκε ακόμα, ξαναδοκιμάζω», ώστε ο χρήστης να μη μένει ποτέ με μια οθόνη που απλώς περιμένει.

Πληρωμές που φαίνονταν απλήρωτες

Ο e-ΕΦΚΑ καταχωρίζει τις πληρωμές με καθυστέρηση έως και έξι εβδομάδων, οπότε χρήστες που είχαν πληρώσει έβλεπαν τις εισφορές τους ως ληξιπρόθεσμες. Για μια εφαρμογή που στέλνει ειδοποιήσεις, αυτό είναι το χειρότερο δυνατό λάθος.

Πλέον ένας μήνας θεωρείται απλήρωτος μόνο 60 μέρες μετά την προθεσμία του, όταν η καθυστέρηση της πλατφόρμας έχει πια καλυφθεί.

Και το myDATA;

Το myDATA έχει επίσημο API, αλλά και όρια. Μια επιχείρηση με χιλιάδες παραστατικά το τρίμηνο έβρισκε γρήγορα το όριο αιτημάτων της ΑΑΔΕ. Η λύση ήταν μια ουρά εργασιών: κάθε μήνας διαβάζεται ως ξεχωριστή εργασία, με αναμονή και επανάληψη όποτε η ΑΑΔΕ ζητά να μειωθεί ο ρυθμός. Ο χρήστης βλέπει την εικόνα να συμπληρώνεται σταδιακά, χωρίς σφάλματα.

Ό,τι δεν ελέγχω, το απομονώνω

Ο αυτοματισμός ζει σε δικό του server, για να μη ρίχνει την εφαρμογή όταν πέφτει η άλλη πλευρά. Διαβάζει το επίσημο PDF, που είναι πιο σταθερό από οποιαδήποτε σελίδα. Και υπολογίζει τον χρόνο του κράτους: οι καθυστερήσεις στην καταχώριση πληρωμών είναι κανόνας, όχι εξαίρεση.

---

Το Forologika είναι online στο forologika.net με δωρεάν δοκιμή 15 ημερών. Αν η επιχείρησή σας χρειάζεται σύνδεση με κρατικές ή άλλες πλατφόρμες, η πρώτη κουβέντα είναι δωρεάν.