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

Η εφαρμογή σας (ERP, POS, e-shop, PMS) στέλνει το παραστατικό σε JSON στον Novus Provider. Ο Πάροχος:

1. κάνει τους δικούς του ελέγχους (δικαιώματα, credits, κανόνες εστίασης/POS κ.λπ.),
2. το διαβιβάζει στην ΑΑΔΕ (myDATA) και παίρνει MARK, UID και Authentication Code,
3. παράγει το PDF με QR code και όλα τα υποχρεωτικά στοιχεία παρόχου,
4. το στέλνει με email στους παραλήπτες που δηλώσατε και το αρχειοθετεί,
5. σας επιστρέφει τα παραπάνω στην απάντηση, στην ίδια κλήση.

Ποια παραστατικά περνούν από τον Πάροχο

Μόνο οι τύποι 1.1 έως 11.5 (τιμολόγια, αποδείξεις, πιστωτικά, ειδικά στοιχεία, δελτία, λιανική). Οι τύποι 12.x έως 17.x (παραστατικά λήπτη, έξοδα, εγγραφές τακτοποίησης) δεν διαβιβάζονται από Πάροχο.

sequenceDiagram
    autonumber
    participant APP as Η εφαρμογή σας<br/>(ERP / POS)
    participant NP as Novus Provider API
    participant AADE as ΑΑΔΕ myDATA
    participant C as Πελάτης (λήπτης)
    APP->>NP: POST /api/v1/Provider/SendInvoices (JSON, API-KEY)
    NP->>NP: Έλεγχοι Novus (δικαιώματα, credits, κανόνες)
    alt Αποτυχία ελέγχων Novus
        NP-->>APP: HTTP 400 / 401 { "errors": [...] }
    else Επιτυχία
        NP->>AADE: SendInvoices (XML, υπογεγραμμένο από τον Πάροχο)
        AADE-->>NP: MARK, UID, AuthenticationCode ή σφάλματα
        NP->>NP: PDF + QR, αρχειοθέτηση
        NP-->>APP: HTTP 200 { response: [ statusCode, invoiceMark, invoiceUid, invoiceUrl, ... ] }
        NP-)C: Email με το PDF (αν δηλώθηκε παραλήπτης)
    end

Βασικές έννοιες

Όρος	Τι είναι	Πού το βρίσκετε
MARK	Μοναδικός Αριθμός Καταχώρησης του παραστατικού στο myDATA.	response[].invoiceMark
UID	Αναγνωριστικό του παραστατικού: SHA-1 των ΑΦΜ εκδότη, ημερομηνίας, εγκατάστασης, τύπου, σειράς, ΑΑ. Μοναδικό: δεύτερη αποστολή με τα ίδια στοιχεία απορρίπτεται.	response[].invoiceUid
Authentication Code	Συμβολοσειρά αυθεντικοποίησης, υποχρεωτική για παραστατικά που εκδίδονται μέσω Παρόχου.	response[].authenticationCode
QR / invoiceUrl	Σύνδεσμος προς το PDF και τη σελίδα επαλήθευσης του Παρόχου. Τυπώνεται ως QR στο παραστατικό.	response[].invoiceUrl, qrUrl
aadeQrUrl	Ο επίσημος σύνδεσμος επαλήθευσης της ΑΑΔΕ. Είναι πληροφοριακός, δεν χρειάζεται ενέργεια.	response[].aadeQrUrl
Provider signature	Υπογραφή Παρόχου για πληρωμές με κάρτα/IRIS μέσω POS (Α.1155/2023).	Πληρωμή με κάρτα / IRIS
Credits	Η χρέωση κάθε κλήσης, από το υπόλοιπο του λογαριασμού σας.	response[].credits, Credits

Ποιος κάνει τι

• Η εφαρμογή σας

  ---

  • Σωστά ποσά, ΦΠΑ, χαρακτηρισμούς εσόδων/εξόδων και τύπο παραστατικού.
  • Αρίθμηση (σειρά + ΑΑ) χωρίς κενά και διπλότυπα.
  • Τα στοιχεία εκτύπωσης (providerAdditionalInvoiceDetails).
  • Χειρισμό σφαλμάτων και επανάληψη αποστολής όπου απαιτείται.

• Ο Novus Provider

  ---

  • Διαβίβαση στο myDATA ως πιστοποιημένος Πάροχος.
  • PDF με QR, MARK, UID, Authentication Code και στοιχεία Παρόχου.
  • Αποστολή email στον λήπτη και αρχειοθέτηση.
  • Αυτόματη διαβίβαση αργότερα, αν η ΑΑΔΕ είναι εκτός λειτουργίας (statusCode = Offline).

Ο Πάροχος δεν «διορθώνει» δεδομένα

Ο Πάροχος προωθεί στην ΑΑΔΕ τα στοιχεία όπως τα λαμβάνει. Ποσά, κατηγορίες ΦΠΑ και χαρακτηρισμοί είναι ευθύνη της εφαρμογής που εκδίδει το παραστατικό.

Τα τρία πιθανά αποτελέσματα μιας αποστολής

Αποτέλεσμα	Πώς το αναγνωρίζετε	Τι κάνετε
Εκδόθηκε	HTTP 200 και statusCode = "Success"	Αποθηκεύετε MARK, UID, AuthenticationCode, invoiceUrl.
Εκδόθηκε, η ΑΑΔΕ ήταν offline	HTTP 200 και statusCode = "Offline"	Δεν το ξαναστέλνετε. Ο Πάροχος το διαβιβάζει αυτόματα. Βλ. Offline.
Δεν εκδόθηκε	HTTP 4xx/5xx ή HTTP 200 με statusCode = ValidationError / XMLSyntaxError / TechnicalError	Διορθώνετε και ξαναστέλνετε. Βλ. Errors & status codes.