Γενικά¶

Q: Υπάρχουν όρια (rate limits) στον αριθμό κλήσεων προς το API;

Προς το παρόν όριο υπάρχει μόνο στο Onboarding API: 60 κλήσεις ανά λεπτό ανά κλειδί, με το header X-RateLimit-Remaining· πάνω από αυτό απαντά 429 RATE_LIMITED με Retry-After. Στο Provider API ο Πάροχος δεν βάζει όριο, όμως κλήσεις όπως το RequestTransmittedDocs εξαρτώνται και από την ΑΑΔΕ, οπότε μην κάνετε polling πιο συχνά απ' όσο χρειάζεται. Δείτε: Onboarding API: endpoints

Q: Βρήκα παραστατικό που εμφανίζεται διαβιβασμένο στο myDATA αλλά λείπει από τα παραστατικά του Παρόχου· τι κάνω;

Για τη συμφωνία χρησιμοποιήστε το RequestTransmittedDocs, με ΑΦΜ εκδότη και διάστημα ημερομηνιών ή με invoiceMark/uid, για να δείτε τι έχει καταγράψει ο Πάροχος. Για να διερευνήσει μια ασυμφωνία, η Novus χρειάζεται το invoiceUid ή το request και το response JSON της συγκεκριμένης αποστολής. Γι' αυτό η εφαρμογή σας πρέπει να κρατά το request και το response κάθε αποστολής, μαζί με MARK, UID, Authentication Code και invoiceUrl. Δείτε: Υπόλοιπες κλήσεις

Όρια, αρχειοθέτηση, νομικό πλαίσιο.

Υπάρχουν όρια (rate limits) στον αριθμό κλήσεων προς το API;

Προς το παρόν όριο υπάρχει μόνο στο Onboarding API: 60 κλήσεις ανά λεπτό ανά κλειδί, με το header X-RateLimit-Remaining· πάνω από αυτό απαντά 429 RATE_LIMITED με Retry-After. Στο Provider API ο Πάροχος δεν βάζει όριο, όμως κλήσεις όπως το RequestTransmittedDocs εξαρτώνται και από την ΑΑΔΕ, οπότε μην κάνετε polling πιο συχνά απ' όσο χρειάζεται.

Δείτε: Onboarding API: endpoints

Πώς ενημερώνομαι για αλλαγές του myDATA και για νέες εκδόσεις της τεκμηρίωσης του API;

Τις αλλαγές που σας αφορούν (νέες εκδόσεις myDATA, νέα πεδία, αλλαγές στο API) τις ανακοινώνουμε στη σελίδα Αλλαγές (changelog) της τεκμηρίωσης, πριν τεθούν σε ισχύ. Η Novus Conceptus, ως πιστοποιημένος Πάροχος, προσαρμόζει την υποδομή της στις αλλαγές της ΑΑΔΕ. Για τις επίσημες ανακοινώσεις και προδιαγραφές, πηγή είναι η ενότητα myDATA του ιστότοπου της ΑΑΔΕ.

Δείτε: Changelog

Βρήκα παραστατικό που εμφανίζεται διαβιβασμένο στο myDATA αλλά λείπει από τα παραστατικά του Παρόχου· τι κάνω;

Για τη συμφωνία χρησιμοποιήστε το RequestTransmittedDocs, με ΑΦΜ εκδότη και διάστημα ημερομηνιών ή με invoiceMark/uid, για να δείτε τι έχει καταγράψει ο Πάροχος. Για να διερευνήσει μια ασυμφωνία, η Novus χρειάζεται το invoiceUid ή το request και το response JSON της συγκεκριμένης αποστολής. Γι' αυτό η εφαρμογή σας πρέπει να κρατά το request και το response κάθε αποστολής, μαζί με MARK, UID, Authentication Code και invoiceUrl.

Δείτε: Υπόλοιπες κλήσεις

Προσφέρει το API αναζήτηση στοιχείων επιχείρησης (επωνυμία, διεύθυνση) με βάση τον ΑΦΜ;

Όχι. Το Provider API δεν έχει αναζήτηση επωνυμίας ή διεύθυνσης με βάση τον ΑΦΜ· τα στοιχεία του λήπτη τα στέλνει η εφαρμογή σας. Για αναζήτηση υπάρχει η υπηρεσία «Αναζήτηση Βασικών Στοιχείων Μητρώου» της ΑΑΔΕ, με δικούς σας κωδικούς πρόσβασης.

Μπορώ να στέλνω μέσω Παρόχου μόνο ορισμένα παραστατικά (π.χ. μόνο τιμολόγια) και τα υπόλοιπα να τα διαβιβάζω με άλλο τρόπο;

Τεχνικά ο Πάροχος διαβιβάζει μόνο όσα παραστατικά στέλνει η εφαρμογή σας στο SendInvoices· ό,τι δεν στέλνετε δεν περνά από αυτόν. Το ποια παραστατικά πρέπει υποχρεωτικά να εκδίδονται μέσω Παρόχου το ορίζει όμως η νομοθεσία και όχι ο Πάροχος: από 1/10/2026 η υποχρέωση καλύπτει και την τελευταία ομάδα επιχειρήσεων για τα τιμολόγια B2B και B2G, που εκδίδονται είτε μέσω Παρόχου είτε μέσω των δωρεάν εφαρμογών της ΑΑΔΕ. Για κάθε πελάτη επιβεβαιώστε με τον λογιστή του ποια παραστατικά μπορούν να μείνουν εκτός Παρόχου.