Πιστοποίηση & μετάβαση σε παραγωγή¶
Πριν πάρετε κλειδί παραγωγής, πιστοποιούμε ότι η εφαρμογή σας κάνει σωστά τα βασικά: εκδίδει, πιστώνει, τυπώνει και χειρίζεται τα σφάλματα. Δεν χρειάζεται ραντεβού ούτε Word, και δεν χρειάζεται να μας στείλετε MARK: τα παραστατικά που εκδώσατε στο δοκιμαστικό τα βλέπουμε εμείς.
flowchart LR
A["Τρέχετε τα βασικά σενάρια<br/>από την εφαρμογή σας"] --> B["Αίτηση<br/>πιστοποίησης"]
B --> C{"Έλεγχος<br/>Novus"}
C -- "χρειάζεται διόρθωση" --> A
C -- "εγκρίθηκε" --> D["Κλειδί<br/>παραγωγής"]
D --> E["Ενεργοποίηση<br/>πελατών"]1. Τρέξτε τα βασικά σενάρια¶
- Τα σενάρια τα τρέχετε από τη δική σας εφαρμογή, στο δοκιμαστικό περιβάλλον, με τον ΑΦΜ που δηλώσατε στην εγγραφή σας.
- Το Postman έχει έτοιμο κάθε σενάριο (φάκελοι 1, 2, 3 και 9): δείτε εκεί τι ακριβώς πρέπει να στέλνει η εφαρμογή σας. Η πιστοποίηση όμως γίνεται από την εφαρμογή σας, όχι από το Postman.
- Σημειώστε τις ημερομηνίες που τα τρέξατε. Θα μας τις δώσετε στην αίτηση.
- Στείλτε την αίτηση μέσα σε 30 ημέρες: στο δοκιμαστικό τα παραστατικά σβήνονται μετά από 30 ημέρες.
| # | Τι κάνετε | Στην αίτηση |
|---|---|---|
| Β1 | Ένα παραστατικό με δύο γραμμές, μία με ΦΠΑ 24% και μία με 13%: 11.1 αν κάνετε λιανική, 1.1 αν κάνετε χονδρική (αν κάνετε και τα δύο, και τα δύο). | Τίποτα. Το βλέπουμε εμείς. |
| Β2 | Ένα πιστωτικό που αναφέρεται στο Β1: 11.4, ή 5.1 με correlatedInvoices. |
Τίποτα. Το βλέπουμε εμείς. |
| Β3 | Την εκτύπωση του Β1, όπως τη βγάζει η εφαρμογή σας (κανόνες εκτύπωσης). | PDF ή φωτογραφία. Αν δίνετε στον πελάτη το PDF του Παρόχου (invoiceUrl), αρκεί να το δηλώσετε. |
| Β4 | Ένα σκόπιμο λάθος (π.χ. πληρωμές διαφορετικές από το σύνολο → HTTP 400). Ο χρήστης σας πρέπει να δει κατανοητό μήνυμα. | Δήλωση |
| Β5 | Στέλνετε ξανά το Β1, ίδιο ακριβώς → σφάλμα ΑΑΔΕ 228. Η εφαρμογή πρέπει να το δείξει ως «ήδη εκδομένο», με το MARK του αρχικού, και όχι ως αποτυχία. | Δήλωση |
2. Οι υπόλοιπες ενότητες: δεν πιστοποιούνται¶
Πληρωμή με κάρτα, εστίαση, διακίνηση, B2G, OSS και Onboarding API δεν περνούν από πιστοποίηση. Στην αίτηση δηλώνετε ποιες χρησιμοποιείτε, και την υλοποίησή τους την ελέγχετε εσείς, με τον οδηγό και το Postman.
| Ενότητα | Οδηγός | Postman | Προσοχή |
|---|---|---|---|
| Κάρτα / IRIS | Πληρωμή με κάρτα / IRIS | φάκελος 4 | Κάθε υπογραφή που ζητάτε πρέπει να ολοκληρωθεί με CompletionPosInvoices. |
| Εστίαση | Εστίαση | φάκελος 5 | Τραπέζι ανοιχτό πάνω από 24 ώρες μπλοκάρει την έκδοση για όλη την εγκατάσταση του πελάτη σας. |
| Διακίνηση | Διακίνηση | φάκελος 6 | |
| B2G | Δημόσιο (B2G) | φάκελος 7 | Χρειάζεστε ξεχωριστό δοκιμαστικό κλειδί B2G. |
| OSS | OSS | φάκελος 8 | Τον ξένο ΦΠΑ τον υπολογίζει η εφαρμογή σας. |
| Onboarding API | Onboarding API | συλλογή Onboarding | Αν χρησιμοποιείτε webhooks, επαληθεύετε την υπογραφή κάθε κλήσης. |
3. Στείλτε την αίτηση πιστοποίησης¶
Όταν τρέξουν τα σενάρια, συμπληρώστε την αίτηση:
Η αίτηση ζητά:
- εταιρεία, εφαρμογή και έκδοση,
- το email του δοκιμαστικού λογαριασμού σας και τον ΑΦΜ εκδότη που χρησιμοποιήσατε,
- τις ημερομηνίες που τρέξατε τα σενάρια,
- την εκτύπωση του Β3 (ή τη δήλωση ότι δίνετε το PDF του Παρόχου),
- τις δηλώσεις για τα Β4 και Β5,
- τις ενότητες που χρησιμοποιείτε.
4. Τι γίνεται μετά¶
- Ελέγχουμε τα παραστατικά σας και την εκτύπωση, και σας απαντάμε στην ίδια αίτηση.
- Αν χρειάζεται διόρθωση, σας λέμε τι ακριβώς. Διορθώνετε, ξανατρέχετε μόνο αυτό το σενάριο και απαντάτε στην ίδια αίτηση.
- Αν εγκριθεί, σας στέλνουμε τις οδηγίες για τον λογαριασμό και το κλειδί παραγωγής.
5. Ενεργοποίηση ΑΦΜ πελατών (μόνο στην παραγωγή)¶
Για κάθε πελάτη (ΑΦΜ εκδότη) απαιτούνται:
- Σύμβαση του πελάτη με τη Novus Conceptus, υπογεγραμμένη από τον νόμιμο εκπρόσωπο.
- Εξουσιοδότηση της Novus Conceptus ως Παρόχου από τον πελάτη στο myAADE.
- Δήλωση Παρόχου στην ΑΑΔΕ. Την υποβάλλουμε εμείς μετά την έγκριση.
Όλα αυτά γίνονται αυτόματα μέσω του Onboarding API: δημιουργείτε αίτημα, ο πελάτης υπογράφει τη σύμβαση και εσείς παρακολουθείτε την κατάσταση μέχρι την έγκριση. Εναλλακτικά γίνονται από το portal. Δείτε Onboarding API.
6. Credits¶
Κάθε κλήση χρεώνει credits από το υπόλοιπο του λογαριασμού σας (χρεώσεις ανά τύπο). Αγοράζετε credits από το portal παραγωγής. Όταν το υπόλοιπο δεν επαρκεί, η κλήση απορρίπτεται με HTTP 400 "You don't have enough balance to send this request." και το παραστατικό δεν διαβιβάζεται.
Κανόνες εκτύπωσης¶
Αν χρησιμοποιείτε το PDF του Παρόχου (invoiceUrl), οι κανόνες καλύπτονται ήδη. Αν τυπώνετε δικό σας παραστατικό (π.χ. σε θερμικό εκτυπωτή), πρέπει να περιέχει:
- την επωνυμία και τον ιστότοπο του Παρόχου: Novus Conceptus | https://timologisi.online,
- το QR code (από το
invoiceUrl/qrUrl), - τα MARK, UID και Authentication Code,
- την ημερομηνία και την ώρα έκδοσης, ευανάγνωστα,
- σε πληρωμή με POS: τα στοιχεία πληρωμής, δηλαδή το transaction id και την υπογραφή Παρόχου που χρησιμοποιήθηκε, για κάθε ποσό ξεχωριστά,
- σε offline έκδοση: την ένδειξη «Απώλεια Διασύνδεσης Παρόχου - ΑΑΔΕ» ή «Απώλεια Διασύνδεσης Οντότητας - Παρόχου», ανάλογα με την περίπτωση.
Μετά τη μετάβαση¶
- Τηρείτε τους όρους χρήσης.
- Παρακολουθείτε τις απαντήσεις για warnings και errors.
- Αν αργότερα προσθέσετε μια ενότητα (π.χ. κάρτα ή εστίαση), δεν χρειάζεται νέα πιστοποίηση: ακολουθήστε τον οδηγό της.
- Γραφτείτε στις ενημερώσεις του changelog. Εκεί ανακοινώνουμε κάθε αλλαγή ΑΑΔΕ πριν τεθεί σε ισχύ.