# Τεκμηρίωση για developers της Novus Conceptus

> Η Novus Conceptus είναι πιστοποιημένος Πάροχος Ηλεκτρονικής Τιμολόγησης της ΑΑΔΕ (Κωδικός Παρόχου 005). Αυτή είναι η πλήρης τεκμηρίωση του Provider API (έκδοση τιμολογίων, αποδείξεων, δελτίων διακίνησης και τιμολογίων B2G μέσω myDATA) και του Onboarding API (ενεργοποίηση πελατών), με τους πίνακες κωδικών της ΑΑΔΕ, έτοιμα παραδείγματα JSON και τις συχνές ερωτήσεις.

- Δοκιμαστικό περιβάλλον (sandbox): https://provider-dev.timologisi.online (δωρεάν λογαριασμός με εγγραφή). Παραγωγή: https://provider.timologisi.online (μετά την πιστοποίηση).
- Κάθε κλήση στέλνει το API key στο HTTP header `API-KEY`. Ένα κλειδί εξυπηρετεί όλους τους ΑΦΜ εκδότη του λογαριασμού.
- Το `SendInvoices` δέχεται ακριβώς ένα παραστατικό ανά κλήση και επιστρέφει MARK, UID, Authentication Code και το link του PDF στην ίδια απάντηση.
- Όλες οι σελίδες σε ένα αρχείο: https://developers.novusconceptus.com/el/llms-full.txt
- Αγγλική έκδοση: https://developers.novusconceptus.com/llms.txt και https://developers.novusconceptus.com/llms-full.txt
- OpenAPI (YAML) και συλλογές Postman: https://developers.novusconceptus.com/el/tools/

## Αρχική

- [Πιστοποιημένος Πάροχος Ηλεκτρονικής Τιμολόγησης: API για την εφαρμογή σας](https://developers.novusconceptus.com/el/): API ηλεκτρονικής τιμολόγησης από πιστοποιημένο Πάροχο της ΑΑΔΕ. Στέλνετε παραστατικά σε JSON και παίρνετε MARK myDATA, PDF με QR code και αποστολή με email.

## Ξεκινώντας

- [Πώς λειτουργεί](https://developers.novusconceptus.com/el/start/how-it-works/): Πώς λειτουργεί το API του Παρόχου: η εφαρμογή σας στέλνει JSON, το διαβιβάζουμε στο myDATA της ΑΑΔΕ και επιστρέφουμε MARK, UID, Authentication Code και PDF.
- [Περιβάλλοντα & API key](https://developers.novusconceptus.com/el/start/account/): Δοκιμαστικό περιβάλλον και παραγωγή στο API ηλεκτρονικής τιμολόγησης: εγγραφή, API key στο header API-KEY, base URLs και τεχνικές απαιτήσεις για το myDATA.
- [Το πρώτο σας παραστατικό](https://developers.novusconceptus.com/el/start/first-invoice/): Εκδώστε την πρώτη σας απόδειξη λιανικής (11.1) στο δοκιμαστικό: έτοιμο JSON για το SendInvoices, κώδικας cURL, C#, Delphi, Python και απάντηση με MARK myDATA.
- [Πιστοποίηση & μετάβαση σε παραγωγή](https://developers.novusconceptus.com/el/start/go-live/): Πιστοποίηση και μετάβαση σε παραγωγή: τρέχετε τα βασικά σενάρια myDATA από την εφαρμογή σας, κάνετε αίτηση online και ενεργοποιείτε τους ΑΦΜ των πελατών σας.

## Οδηγοί

- [Τιμολόγια & αποδείξεις](https://developers.novusconceptus.com/el/guides/invoices/): Έκδοση τιμολογίων και αποδείξεων λιανικής μέσω του API ηλεκτρονικής τιμολόγησης για το myDATA: τύποι παραστατικών ΑΑΔΕ, χαρακτηρισμοί εσόδων και έτοιμα JSON.
- [Πιστωτικά & συσχετίσεις](https://developers.novusconceptus.com/el/guides/credit-notes/): Έκδοση πιστωτικών 5.1, 5.2 και 11.4 στο myDATA μέσω API ηλεκτρονικής τιμολόγησης: συσχέτιση με MARK, αντιλογισμός παραστατικού και έτοιμα παραδείγματα JSON.
- [Φόροι, τέλη, κρατήσεις](https://developers.novusconceptus.com/el/guides/taxes/): Πώς δηλώνετε στο myDATA παρακρατούμενο φόρο, τέλη, λοιπούς φόρους, ψηφιακό τέλος συναλλαγής και κρατήσεις — ανά γραμμή ή με taxesTotals, με παραδείγματα JSON.
- [Πληρωμή με κάρτα / IRIS](https://developers.novusconceptus.com/el/guides/card-payments/): Πληρωμή με κάρτα και IRIS με υπογραφή Παρόχου για διασυνδεδεμένα POS (Α.1155/2023): διασύνδεση με NSP, CompletionPosInvoices, δοκιμές και αποτυχία πληρωμής.
- [Εστίαση: Δελτίο Παραγγελίας 8.6](https://developers.novusconceptus.com/el/guides/food-service/): Δελτίο Παραγγελίας Εστίασης 8.6 στο myDATA μέσω API: παραγγελίες τραπεζιού, ακύρωση ειδών, κλείσιμο τραπεζιού με multipleConnectedMarks και ο κανόνας 24 ωρών.
- [Διακίνηση: δελτία αποστολής](https://developers.novusconceptus.com/el/guides/delivery/): Δελτία αποστολής στο myDATA μέσω API: τιμολόγιο-δελτίο αποστολής, σκέτο 9.3, πεδία του Ψηφιακού Δελτίου Αποστολής (myDATA 2.0), ποσοτική παραλαβή και ακύρωση.
- [Δημόσιο (B2G)](https://developers.novusconceptus.com/el/guides/b2g/): Πώς στέλνετε ηλεκτρονικά τιμολόγια B2G σε φορείς του Δημοσίου (EN 16931) μέσω API — δρομολόγηση, κωδικοί CPV, τιμές δοκιμών και παραδείγματα JSON.
- [OSS: πωλήσεις σε ιδιώτες στην ΕΕ](https://developers.novusconceptus.com/el/guides/oss/): Πώς δηλώνετε στο myDATA πωλήσεις εξ αποστάσεως σε ιδιώτες στην ΕΕ μέσω One Stop Shop (OSS) — απαλλαγή ΦΠΑ 30, ΑΛΠ με δύο γραμμές και παράδειγμα JSON.
- [Offline & επαναλήψεις](https://developers.novusconceptus.com/el/guides/offline/): Τι κάνετε όταν χαθεί η σύνδεση με τον Πάροχο ή με την ΑΑΔΕ (myDATA): επαναλήψεις, transmissionFailure 1 και 2, σφάλμα 228 και πότε ξαναστέλνετε παραστατικό.

## Provider API

- [Provider API](https://developers.novusconceptus.com/el/provider-api/): Τεκμηρίωση του Provider API για έκδοση παραστατικών και διαβίβαση στο myDATA της ΑΑΔΕ (2.0.2) — base URL, αυθεντικοποίηση με API key και όλες οι κλήσεις.
- [SendInvoices](https://developers.novusconceptus.com/el/provider-api/send-invoices/): Αναφορά του SendInvoices στο API ηλεκτρονικής τιμολόγησης. Έκδοση παραστατικού, διαβίβαση στο myDATA της ΑΑΔΕ, MARK, UID, PDF και όλα τα πεδία.
- [SendInvoicesB2G](https://developers.novusconceptus.com/el/provider-api/send-invoices-b2g/): Η κλήση SendInvoicesB2G για ηλεκτρονικά τιμολόγια προς φορείς του Δημοσίου (B2G, EN 16931) — επιτρεπτοί τύποι, υποχρεωτικά πεδία, κωδικοί BT και δοκιμές.
- [Υπόλοιπες κλήσεις](https://developers.novusconceptus.com/el/provider-api/other-endpoints/): Οι υπόλοιπες κλήσεις του Provider API για ηλεκτρονική τιμολόγηση myDATA — αναζήτηση παραστατικών, ακύρωση δελτίων, υπόλοιπο credits, PDF, πληρωμές POS, εστίαση.
- [Σφάλματα & statusCode](https://developers.novusconceptus.com/el/provider-api/errors/): Χειρισμός σφαλμάτων στο API ηλεκτρονικής τιμολόγησης myDATA — κωδικοί HTTP, τιμές statusCode, σφάλματα ελέγχου της ΑΑΔΕ, παραστατικά Offline και επαναλήψεις.
- [Κωδικοί σφαλμάτων ΑΑΔΕ](https://developers.novusconceptus.com/el/provider-api/aade-errors/): Όλοι οι κωδικοί σφαλμάτων της ΑΑΔΕ myDATA που μπορεί να επιστρέψει η διαβίβαση μέσω Παρόχου, με περιγραφή και το αγγλικό μήνυμα της απάντησης.
- [Χρεώσεις (credits)](https://developers.novusconceptus.com/el/provider-api/credits/): Χρεώσεις σε credits στο API ηλεκτρονικής τιμολόγησης myDATA — κόστος ανά κλήση και τύπο παραστατικού (τιμολόγια, λιανική, B2G, POS) και έλεγχος υπολοίπου.

## Onboarding API

- [Onboarding API: πώς λειτουργεί](https://developers.novusconceptus.com/el/onboarding-api/): Πώς το Onboarding API της Novus ενεργοποιεί νέους πελάτες (ΑΦΜ) στο API key σας, από την υπογραφή της σύμβασης έως τη Δήλωση Παρόχου στην ΑΑΔΕ.
- [Onboarding API: endpoints](https://developers.novusconceptus.com/el/onboarding-api/endpoints/): Αναφορά στα endpoints του Onboarding API της Novus για ενεργοποίηση πελατών (ΑΦΜ) στην ηλεκτρονική τιμολόγηση, με πεδία αίτησης, σύμβαση και κωδικούς σφαλμάτων.
- [Webhooks](https://developers.novusconceptus.com/el/onboarding-api/webhooks/): Webhooks του Onboarding API της Novus για ειδοποιήσεις σε πραγματικό χρόνο όταν αλλάζει μια αίτηση πελάτη, με retries και επαλήθευση υπογραφής HMAC-SHA256.

## Πίνακες ΑΑΔΕ

- [Πίνακες ΑΑΔΕ](https://developers.novusconceptus.com/el/aade/): Όλοι οι πίνακες κωδικών της ΑΑΔΕ για το myDATA 2.0.2: παραστατικά, ΦΠΑ, φόροι, χαρακτηρισμοί, πληρωμές, διακίνηση. Με αναζήτηση.
- [Παραστατικά](https://developers.novusconceptus.com/el/aade/documents/): Πίνακες ΑΑΔΕ myDATA 2.0.2: Παραστατικά. Όλοι οι κωδικοί με περιγραφή, όπως τους στέλνετε στο API του Παρόχου Novus Conceptus.
- [ΦΠΑ](https://developers.novusconceptus.com/el/aade/vat/): Πίνακες ΑΑΔΕ myDATA 2.0.2: ΦΠΑ. Όλοι οι κωδικοί με περιγραφή, όπως τους στέλνετε στο API του Παρόχου Novus Conceptus.
- [Φόροι, τέλη, κρατήσεις](https://developers.novusconceptus.com/el/aade/taxes/): Πίνακες ΑΑΔΕ myDATA 2.0.2: Φόροι, τέλη, κρατήσεις. Όλοι οι κωδικοί με περιγραφή, όπως τους στέλνετε στο API του Παρόχου Novus Conceptus.
- [Χαρακτηρισμοί εσόδων / εξόδων](https://developers.novusconceptus.com/el/aade/classifications/): Πίνακες ΑΑΔΕ myDATA 2.0.2: Χαρακτηρισμοί εσόδων / εξόδων. Όλοι οι κωδικοί με περιγραφή, όπως τους στέλνετε στο API του Παρόχου Novus Conceptus.
- [Γραμμές & πληρωμές](https://developers.novusconceptus.com/el/aade/lines-payments/): Πίνακες ΑΑΔΕ myDATA 2.0.2: Γραμμές & πληρωμές. Όλοι οι κωδικοί με περιγραφή, όπως τους στέλνετε στο API του Παρόχου Novus Conceptus.
- [Διακίνηση](https://developers.novusconceptus.com/el/aade/movement/): Πίνακες ΑΑΔΕ myDATA 2.0.2: Διακίνηση. Όλοι οι κωδικοί με περιγραφή, όπως τους στέλνετε στο API του Παρόχου Novus Conceptus.

## Postman & παραδείγματα

- [Postman & παραδείγματα](https://developers.novusconceptus.com/el/tools/): Συλλογές Postman, αρχεία OpenAPI (YAML) και 32 έτοιμα JSON για το API ηλεκτρονικής τιμολόγησης myDATA: τιμολόγια, αποδείξεις, POS, εστίαση, διακίνηση, B2G.

## Συχνές ερωτήσεις

- [Συχνές ερωτήσεις](https://developers.novusconceptus.com/el/faq/): Συχνές ερωτήσεις developers για το API ηλεκτρονικής τιμολόγησης της Novus, για myDATA, ΑΑΔΕ, ενεργοποίηση πελατών, τιμολόγια, πιστωτικά, σφάλματα και POS.
- [Ξεκινώντας & λογαριασμός](https://developers.novusconceptus.com/el/faq/start/): Ξεκινώντας με το API ηλεκτρονικής τιμολόγησης της Novus, με sandbox, API key, πολλούς ΑΦΜ πελατών σε ένα κλειδί, αρχειοθέτηση παραστατικών και credits.
- [Πιστοποίηση & παραγωγή](https://developers.novusconceptus.com/el/faq/go-live/): Πώς γίνεται η πιστοποίηση στο API ηλεκτρονικής τιμολόγησης της Novus, από τα σενάρια στο sandbox έως το κλειδί παραγωγής, και κάλυψη τιμολογίων B2B και B2C.
- [Onboarding & πελάτες](https://developers.novusconceptus.com/el/faq/onboarding/): Ενεργοποίηση πελατών στον Πάροχο ηλεκτρονικής τιμολόγησης με το Onboarding API: αίτηση, σύμβαση, εξουσιοδότηση στο myAADE και Δήλωση Παρόχου στην ΑΑΔΕ.
- [Έκδοση παραστατικών](https://developers.novusconceptus.com/el/faq/invoices/): Συχνές ερωτήσεις για έκδοση τιμολογίων και αποδείξεων μέσω Παρόχου στο myDATA: απάντηση SendInvoices, σειρά και ΑΑ, χαρακτηρισμός εσόδων, PDF και email.
- [Πιστωτικά & ακυρώσεις](https://developers.novusconceptus.com/el/faq/credit-notes/): Πώς ακυρώνεται παραστατικό στο myDATA μέσω Παρόχου: απόδειξη λιανικής με 11.4, τιμολόγιο χονδρικής με 5.1 ή 5.2, αυτοτιμολόγηση και correlatedInvoices.
- [Σφάλματα](https://developers.novusconceptus.com/el/faq/errors/): Τι σημαίνουν τα συχνά σφάλματα του API ηλεκτρονικής τιμολόγησης και του myDATA της ΑΑΔΕ (401, 400, Offline, 202, 207, 208, 312) και πώς κάνετε ασφαλή επανάληψη.
- [Κάρτα / POS](https://developers.novusconceptus.com/el/faq/card-payments/): Συχνές ερωτήσεις για πληρωμή με κάρτα ή IRIS μέσω POS: διασύνδεση με NSP, δοκιμές χωρίς τερματικό, υπογραφή Παρόχου, αποτυχία πληρωμής και επιστροφές.
- [Εστίαση](https://developers.novusconceptus.com/el/faq/food-service/): Συχνές ερωτήσεις για δελτία παραγγελίας εστίασης 8.6 μέσω Παρόχου και myDATA: κλείσιμο τραπεζιού, MARK 0 σε offline, GetOpenTables και GetOpenOrdersForTable.
- [Διακίνηση](https://developers.novusconceptus.com/el/faq/delivery/): Συχνές ερωτήσεις για δελτία αποστολής και Ψηφιακή Διακίνηση μέσω Παρόχου ηλεκτρονικής τιμολόγησης: 9.x και 10.x, isDeliveryNote, movePurpose, myDATA 2.0.2.
- [B2G (Δημόσιο)](https://developers.novusconceptus.com/el/faq/b2g/): Συχνές ερωτήσεις για τιμολόγια B2G προς το Δημόσιο μέσω Παρόχου: Κωδικός Αναθέτουσας Αρχής, τύπος προϋπολογισμού, ΑΔΑ, Ενάριθμος, CPV και σφάλματα.
- [Γενικά](https://developers.novusconceptus.com/el/faq/general/): Γενικές ερωτήσεις για το API ηλεκτρονικής τιμολόγησης της Novus, με όρια κλήσεων, αλλαγές myDATA, συμφωνία με την ΑΑΔΕ, αναζήτηση ΑΦΜ και υποχρεώσεις.

## Αλλαγές

- [Αλλαγές](https://developers.novusconceptus.com/el/changelog/): Αλλαγές στο API ηλεκτρονικής τιμολόγησης Novus ανά μήνα: κάθε ενημέρωση myDATA της ΑΑΔΕ έως την έκδοση 2.0.2, υλοποιημένη στο Provider API.

## Προαιρετικά

- [English version of this documentation, full text](https://developers.novusconceptus.com/llms-full.txt)