Skip to Content

Novus Provider API

Γρήγορη, ασφαλής και πλήρως αυτοματοποιημένη διασύνδεση με την υπηρεσία Παρόχου.

Το REST API του Παρόχου επιτρέπει σε ERP, POS και custom εφαρμογές να εκδίδουν και να διαβιβάζουν παραστατικά στη myDATA σε πραγματικό χρόνο, με ελάχιστη υλοποίηση από την πλευρά σας.

Δείτε το Swagger (Sandbox)

Illustration of a developer working on API integration with code elements
Person drawing a workflow diagram on a whiteboard

API integration illustration with cloud, server and connection icons

Τι είναι το Provider API

Το Novus Provider API είναι το ενιαίο σημείο επικοινωνίας ανάμεσα στο λογισμικό σας και την υπηρεσία Ηλεκτρονικής Τιμολόγησης του Παρόχου. Με λίγες απλές κλήσεις REST, σας επιτρέπει να:
  • Εκδίδετε και διαβιβάζετε παραστατικά στο myDATA μέσω Πιστοποιημένου Παρόχου
  • Παίρνετε MARK, UID, Authentication Code & PDF
  • Υποστηρίζετε πληρωμές POS με αυτόματη υπογραφή
  • Διαχειρίζεστε παραγγελίες εστίασης (Τύπος 8.6)
  • Ανακτάτε παραστατικά που έχουν ήδη σταλεί
  • Υλοποιείτε ακυρώσεις, πιστωτικά και διορθώσεις
  • Διαχειρίζεστε πολλαπλά ΑΦΜ μέσω του Portal

Ο στόχος του API είναι να κάνει την υλοποίηση όσο το δυνατόν πιο απλή, γρήγορη και σταθερή, μειώνοντας σημαντικά τον χρόνο ανάπτυξης.

Πώς λειτουργεί η διασύνδεση

Η διαδικασία είναι απλή και αποτελείται από τρία βασικά βήματα:

Αποστολή παραστατικού

Το λογισμικό σας στέλνει ένα JSON με τα στοιχεία του παραστατικού προς τον Πάροχο, μέσω μίας απλής κλήσης REST.

Άμεση απάντηση από τον Πάροχο

Η υπηρεσία επιστρέφει μέσα σε milliseconds:

  • ΜΑΡΚ

  • UID

  • Authentication Code

  • URL για το PDF

  • (Προαιρετικά) POS Signature για συναλλαγές κάρτας

Αυτόματη διαβίβαση στη myDATA
Ο Πάροχος αναλαμβάνει τη διαβίβαση στη myDATA και τη διαχείριση όλων των περιπτώσεων αδυναμίας επικοινωνίας, χωρίς καμία παρέμβαση από εσάς.

Αυτό σημαίνει ότι η ευθύνη για την επιτυχή διαβίβαση μεταφέρεται στον Πάροχο.

Automation and API configuration illustration with gears

Κύριες δυνατότητες του API


Έκδοση Παραστατικών (11.1, 1.1, 8.6, πιστωτικά, ακυρώσεις κ.λπ.)

Αποστολή όλων των τύπων παραστατικών, με πλήρη συμβατότητα με τις προδιαγραφές myDATA.

Υπογραφή POS (Card Payments)

Για πληρωμές με κάρτα, το API επιστρέφει την υπογραφή για το POS του συνεργαζόμενου NSP.

Restaurant Orders / Τύπος 8.6

Υποστήριξη για άνοιγμα τραπεζιού, παραγγελίες, ακυρώσεις και κλείσιμο με παραστατικό.

Ανάκτηση εκδοθέντων παραστατικών

Αναζήτηση και λήψη παραστατικών που έχουν ήδη εκδοθεί και διαβιβαστεί.

Αυτόματη διαχείριση σφαλμάτων

Σε Offline ή Failure της ΑΑΔΕ, ο Πάροχος αναλαμβάνει πλήρως τις επαναπροσπάθειες.

Αυτόματη αποστολή Email στον πελάτη

Δυνατότητα αυτόματης αποστολής του PDF παραστατικού απευθείας στον πελάτη.

🟩 Εργαλεία Ανάπτυξης

  • Swagger UI: πραγματικές δοκιμές σε πραγματικό χρόνο
  • Developer Portal: API Keys, ενεργοποιήσεις ΑΦΜ, ρυθμίσεις
    Documentation PDF: αναλυτικά παραδείγματα & οδηγίες

🟦 Περιβάλλοντα API

  •   Sandbox: πλήρως λειτουργικό περιβάλλον δοκιμών
  • Production: live περιβάλλον για ενεργούς πελάτες
  • Ίδιες κλήσεις & ίδια endpoints για εύκολη μετάβαση

🟧 Ταυτοποίηση & Ασφάλεια

  • Χρήση API-Key header για κάθε κλήση
  • Ρόλοι & δικαιώματα ανά ΑΦΜ
  • Secure HTTPS-only επικοινωνία
    Καταγραφή όλων των κλήσεων στο Portal

Πώς περνάτε σε live λειτουργία

1

Sandbox testing

Ολοκληρώνετε επιτυχώς τις δοκιμές στο περιβάλλον Sandbox.


2

Ραντεβού πιστοποίησης

Γίνεται έλεγχος της υλοποίησής σας από την ομάδα μας.

3

Υπογραφή σύμβασης

Υπογράφετε τη σύμβαση συνεργασίας Παρόχου.

4

Ενεργοποίηση ΑΦΜ μέσω Portal

Καταχωρείται το ΑΦΜ σας και ενεργοποιείται η πρόσβαση.

4

Έκδοση Production Key

Λαμβάνετε το production key και ξεκινάτε live λειτουργία.

Ξεκινήστε σήμερα και ενεργοποιήστε το API σε λίγα λεπτά.

Δοκιμάστε στο Sandbox, αποκτήστε Production Key και διασυνδέστε ERP/POS χωρίς πολύπλοκες διαδικασίες.

Επικοινωνήστε μαζί μας