Ξεκινώντας & λογαριασμός

Λογαριασμός δοκιμών, κλειδιά, πολλοί πελάτες σε ένα κλειδί, credits.

Πώς αποκτώ πρόσβαση στο δοκιμαστικό περιβάλλον (sandbox) και στην τεκμηρίωση του API;

Η τεκμηρίωση (οδηγοί, OpenAPI και συλλογή Postman με έτοιμα σενάρια και JSON) είναι δημοσιευμένη στο developer site. Λογαριασμό sandbox ανοίγετε μόνοι σας με εγγραφή στο developer portal (email και ΑΦΜ): μετά την επιβεβαίωση βρίσκετε στο portal το API key, και ο ΑΦΜ της εγγραφής ενεργοποιείται αυτόματα ως εκδότης. Οι κλήσεις δοκιμών γίνονται στο https://provider-dev.timologisi.online με το κλειδί στο header API-KEY. Τα παραστατικά του sandbox σβήνονται μετά από 30 ημέρες.

Δείτε: Περιβάλλοντα & API key

Ποιον ΑΦΜ λήπτη μπορώ να χρησιμοποιώ στα δοκιμαστικά τιμολόγια του sandbox;

Ως εκδότη βάζετε τον ΑΦΜ της εγγραφής σας. Ως λήπτη βάζετε φανταστικό ΑΦΜ που περνά τον έλεγχο check digit, όπως στα έτοιμα παραδείγματα. Μη βάζετε ΑΦΜ πραγματικής επιχείρησης: η ΑΑΔΕ επιστρέφει για κάθε λήπτη τα emails παραλαβής που έχει δηλώσει, και ο Πάροχος του στέλνει το PDF ακόμη και από το δοκιμαστικό.

Δείτε: Περιβάλλοντα & API key

Αποθηκεύει ο Πάροχος τα παραστατικά που εκδίδω, ή η αρχειοθέτηση είναι δική μου ευθύνη;

Ναι. Αφού διαβιβάσει το παραστατικό στο myDATA, ο Πάροχος παράγει το PDF και το αρχειοθετεί· στην παραγωγή η αρχειοθέτηση είναι μόνιμη. Το PDF και τα στοιχεία κάθε παραστατικού τα βρίσκετε μέσω του invoiceUrl, του GetInvoice/{uid}/{fileType} ή του RequestTransmittedDocs. Στο δοκιμαστικό τα παραστατικά σβήνονται μετά από 30 ημέρες. Καλό είναι να κρατάτε και στην εφαρμογή σας τα MARK, UID, Authentication Code και invoiceUrl.

Δείτε: Πώς λειτουργεί

Έχει το API και γραφικό περιβάλλον (web) για χειροκίνητη έκδοση παραστατικών;

Όχι. Το Provider API είναι φτιαγμένο για επικοινωνία συστήματος με σύστημα και δεν έχει οθόνη έκδοσης. Στο portal του λογαριασμού σας βλέπετε και αναζητάτε τα παραστατικά που εκδώσατε, αλλά δεν δημιουργείτε νέα. Για χειροκίνητη έκδοση η Novus έχει ξεχωριστή εφαρμογή ηλεκτρονικής τιμολόγησης, ανεξάρτητη από το API.

Δείτε: Περιβάλλοντα & API key

Μπορώ να συνδέσω απευθείας το δικό μου σύστημα (custom backend, e-shop ή ERP) με το API, χωρίς ενδιάμεσο λογισμικό ή πλατφόρμα της Novus;

Ναι. Η Novus είναι η ίδια ο πιστοποιημένος Πάροχος και η συνεργασία γίνεται απευθείας, χωρίς μεταπωλητή ή ERP. Το σύστημά σας καλεί το REST API με JSON, π.χ. όταν ολοκληρώνεται μια παραγγελία στο e-shop, και παίρνει MARK, UID, Authentication Code και PDF στην ίδια απάντηση. Η Novus παρέχει το επίπεδο του Παρόχου, δηλαδή το API και τη διασύνδεση με την ΑΑΔΕ. Τη λογική της έκδοσης (τύποι, ΦΠΑ, χαρακτηρισμοί, αρίθμηση) και την υλοποίηση στο σύστημά σας τις κάνετε εσείς.

Δείτε: Πώς λειτουργεί

Μπορώ να μεταφέρω στη Novus παραστατικά που έχω ήδη εκδώσει μέσω άλλου παρόχου, στέλνοντάς τα ξανά;

Όχι. Τα παραστατικά που έχουν ήδη διαβιβαστεί στο myDATA δεν ξαναστέλνονται, γιατί μια νέα αποστολή δημιουργεί σύγκρουση στο myDATA (π.χ. διπλότυπο, σφάλμα 228). Επιπλέον, μέσω Παρόχου το issueDate πρέπει να είναι η σημερινή ημερομηνία. Κρατήστε το ιστορικό στη δική σας εφαρμογή ή στον προηγούμενο πάροχο και εκδίδετε μέσω Novus μόνο τα νέα παραστατικά.

Δείτε: Σφάλματα & statusCode

Μπορώ να αλλάξω το email ενός λογαριασμού που έχω ήδη ενεργοποιήσει στο developer portal;

Όχι, το email ενός ενεργοποιημένου λογαριασμού δεν αλλάζει. Κάντε νέα εγγραφή στο developer portal με το σωστό email· ο λογαριασμός Sandbox και το API key δημιουργούνται μετά την επιβεβαίωση του email και τον ορισμό κωδικού. Επειδή email και ΑΦΜ που δηλώνετε στην εγγραφή χρησιμοποιούνται και στην αίτηση πιστοποίησης, ελέγξτε τα πριν την υποβολή.

Δείτε: Περιβάλλοντα & API key

Αναλαμβάνει η Novus την υλοποίηση της διασύνδεσης στο ERP μου ή παρέχει έτοιμο module για κάποιο ERP;

Όχι. Η Novus παρέχει το REST API (Provider API και Onboarding API) και την τεχνική τεκμηρίωση, και η διασύνδεση γίνεται από τη δική σας ομάδα ανάπτυξης, τον κατασκευαστή του λογισμικού σας ή εξωτερικό συνεργάτη. Η εφαρμογή σας παραμένει το περιβάλλον εργασίας και καλεί το API σε κάθε έκδοση. Είναι υπεύθυνη για σωστά ποσά, ΦΠΑ, χαρακτηρισμούς, αρίθμηση και χειρισμό σφαλμάτων. Για να ξεκινήσετε υπάρχουν έτοιμα JSON, OpenAPI και συλλογή Postman.

Δείτε: Πώς λειτουργεί

Μπορώ να μοιράζω ελεύθερα τα credits του λογαριασμού μου σε όλους τους πελάτες (ΑΦΜ) που εξυπηρετώ;

Ναι. Ένα API key μπορεί να έχει πολλούς ΑΦΜ πελατών με κοινό υπόλοιπο credits: κάθε παραστατικό, όποιου ΑΦΜ, χρεώνεται από το ίδιο υπόλοιπο, που το βλέπετε με GET /api/v1/Provider/GetCreditsBalance. Αν προτιμάτε, μπορείτε να κάνετε και ξεχωριστή εγγραφή (ξεχωριστό API key, με δικά του credits) για κάθε ΑΦΜ. Σε κάθε περίπτωση, κάθε νέος ΑΦΜ ενεργοποιείται με σύμβαση και έγκριση της Novus, από το Onboarding API ή το portal.

Δείτε: Χρεώσεις (credits)

Πόσα credits χρεώνεται κάθε παραστατικό και χρεώνονται οι αποτυχημένες αποστολές;

Τα τιμολόγια (1.x, 2.x, 3.x, 5.x, 6.x, 7.1, 8.1, 8.2) και τα παραστατικά διακίνησης (9.x, 10.x) χρεώνουν 1 credit, ενώ η λιανική (11.1–11.5), οι αποδείξεις POS 8.4/8.5 και το 8.6 χρεώνουν 0,5. Η υπογραφή Παρόχου για κάρτα/IRIS χρεώνει επιπλέον 0,25 ανά γραμμή πληρωμής, όπως και οι ακυρώσεις δελτίων. Χρεώνονται μόνο οι επιτυχημένες κλήσεις: απορρίψεις από τους ελέγχους του Παρόχου και ValidationError της ΑΑΔΕ δεν χρεώνονται. Τα credits κάθε κλήσης επιστρέφονται στο πεδίο credits και το υπόλοιπο με GetCreditsBalance.

Δείτε: Χρεώσεις (credits)