ΑΡΘΡΟ

Σύστημα παραγγελιοληψίας και myDATA: η έκδοση μέσω παρόχου ΥΠΑΗΕΣ, από το δελτίο μέχρι την κάρτα

Έφτιαξες σύστημα που παίρνει την παραγγελία. Τώρα κάθε πελάτης ρωτά για την απόδειξη. Το σύστημά σου στέλνει την παραγγελία στο API και το Wrapp κάνει όλα τα υπόλοιπα αυτόματα: ποιο παραστατικό βγάζει κάθε στιγμή της βάρδιας, πώς συνδέεται το τερματικό καρτών, πώς ανοίγεις λογαριασμό για νέο πελάτη σε λίγα λεπτά, και τι χρειάζεται για την παραγωγή.

Το σύστημα παραγγελιοληψίας σου παίρνει την παραγγελία στο τραπέζι, τη στέλνει στην κουζίνα, κρατά τον λογαριασμό ανοιχτό και βγάζει reports. Και μετά έρχεται η ερώτηση που ακούγεται σε κάθε πώληση: «την απόδειξη πώς την κόβω;»

Η απάντηση είναι σύντομη: το σύστημά σου στέλνει την παραγγελία στο API του Wrapp, και από εκεί και πέρα όλα γίνονται αυτόματα. Παρακάτω είναι τι αναλαμβάνει το Wrapp, ποιο παραστατικό βγάζει κάθε στιγμή της βάρδιας, πώς ανοίγεις λογαριασμό για κάθε νέο πελάτη σου σε λίγα λεπτά, και τι χρειάζεται για να βγεις στην παραγωγή.

Τι κάνει το Wrapp αυτόματα

Το Wrapp είναι αδειοδοτημένος Πάροχος Ηλεκτρονικής Έκδοσης Στοιχείων (ΥΠΑΗΕΣ). Το σύστημά σου στέλνει τα είδη, τα ποσά και τον τρόπο πληρωμής. Όλα τα υπόλοιπα τα κάνει το Wrapp, χωρίς κανένα ενδιάμεσο βήμα από εσένα ή από τον πελάτη σου:

  • Εκδίδει το παραστατικό με σήμανση ΜΑΡΚ, QR και ώρα έκδοσης.
  • Το διαβιβάζει στο myDATA σε πραγματικό χρόνο, και αν η ΑΑΔΕ δεν απαντά, το ξαναστέλνει μόνο του.
  • Το παραδίδει στον πελάτη, έτοιμο για εκτύπωση ή με email.
  • Στέλνει το ποσό στο τερματικό καρτών και ολοκληρώνει την απόδειξη μόλις εγκριθεί η πληρωμή.
  • Υποβάλλει τη δήλωση παρόχου στην ΑΑΔΕ για κάθε πελάτη σου.

Η ενσωμάτωση με το REST API ολοκληρώνεται συνήθως σε λιγότερο από μία ώρα, και μετά δοκιμάζεις κάθε ροή σε staging πριν βγεις στην παραγωγή.

Η βάρδια σε παραστατικά

Κάθε στιγμή που καταγράφει το σύστημά σου αντιστοιχεί σε ένα παραστατικό που εκδίδεται μέσω του API. Αυτός είναι ο χάρτης που χρειάζεσαι πριν γράψεις την πρώτη γραμμή κώδικα.

ΣτιγμήΠαραστατικόΤι στέλνει το σύστημά σου
Παραγγελία στο τραπέζι8.6 Δελτίο Παραγγελίας ΕστίασηςΈνα δελτίο ανά γύρο, με το τραπέζι
Ο πελάτης πληρώνει το τραπέζι11.1 Απόδειξη λιανικήςΤα ΜΑΡΚ των δελτίων και το τραπέζι, και μετά κλείσιμο του τραπεζιού
Πάγκος, take-away, delivery11.1 Απόδειξη λιανικήςΑπευθείας, χωρίς δελτίο
Πληρωμή με κάρτα στο τερματικό11.1 Απόδειξη λιανικήςΤο τερματικό μαζί με την απόδειξη, που παίρνει ΜΑΡΚ μόλις εγκριθεί η πληρωμή
Κάρτα στην πόρτα ή στην παραλαβή11.1 Απόδειξη λιανικήςΤην απόδειξη αμέσως, με τη χρέωση να περιμένει στο τερματικό
Μετρητά και κάρτα στον ίδιο λογαριασμό11.1 και 8.4 Απόδειξη Είσπραξης POSΤην απόδειξη για όλο το ποσό επί πιστώσει, και την κάρτα με απόδειξη είσπραξης για το δικό της μέρος
Επιστροφή χρημάτων στην κάρτα8.5 Απόδειξη Επιστροφής POS ή 11.4Ανάλογα με το παραστατικό που χρέωσε την κάρτα
Ακύρωση απόδειξης11.4 Πιστωτικό λιανικήςΣυσχετισμένο με το ΜΑΡΚ της αρχικής
Λάθος δελτίο ή πελάτης που έφυγεΑκύρωση του 8.6Νέο μηδενικό δελτίο στο ίδιο τραπέζι
ΚέρασμαΓραμμή μηδενικής αξίας ή 6.1Ποιο από τα δύο, το αποφασίζει ο λογιστής της επιχείρησης
Γεύμα προσωπικού6.1 Στοιχείο ΑυτοπαράδοσηςΣε δική του σειρά, με την αιτιολογία στις παρατηρήσεις

Το πλήρες JSON για κάθε γραμμή του πίνακα, έτοιμο να το στείλεις, είναι στα παραδείγματα JSON για παραγγελιοληψία.

Το δελτίο παραγγελίας είναι το σημείο που κοστίζει όταν ανακαλυφθεί αργά: έχει 24 ώρες για να συσχετιστεί με την απόδειξη που το κλείνει, και τίποτα στο API δεν σου λέει ότι η συσχέτιση έλειψε. Ο κύκλος ζωής του, με πλήρη payloads, είναι στον οδηγό για το Δελτίο Παραγγελίας Εστίασης και τις 24 ώρες.

Οδηγοί ανά θέμα

Η κάρτα στο τραπέζι

Η Α.1155/2023 ορίζει ότι το τερματικό καρτών διασυνδέεται με το σύστημα που εκδίδει την απόδειξη. Όταν η έκδοση γίνεται μέσω του API, αυτό σημαίνει ότι το τερματικό συνδέεται με το Wrapp.

  • Μία ενσωμάτωση. Στέλνεις την απόδειξη με το τερματικό, το Wrapp στέλνει το ποσό στο τερματικό και διαβιβάζει στο myDATA. Δεν μιλάς ξεχωριστά με τον acquirer.
  • Μέσω cloud. Η συναλλαγή φτάνει στο τερματικό από server σε server. Στο κατάστημα δεν εγκαθίσταται τίποτα.
  • Το αποτέλεσμα έρχεται με webhook. Η απόδειξη παίρνει ΜΑΡΚ μόλις εγκριθεί η πληρωμή, και μια αποτυχία ή ακύρωση στο τερματικό σου έρχεται ξεχωριστά.
  • Συνδεδεμένο τερματικό από το Wrapp Core και πάνω. Όλα τα πακέτα είναι στη σελίδα με τα πακέτα του Wrapp.

Πώς συνδέεται κάθε τερματικό με το Wrapp το δείχνουν οι οδηγοί για Viva, Worldline Smart POS, epay και NBG Pay.

Η απόδειξη πριν από την κάρτα: aade_preloaded

Στην κανονική ροή η απόδειξη περιμένει την έγκριση στο τερματικό και παίρνει ΜΑΡΚ μετά. Υπάρχουν όμως στιγμές όπου η απόδειξη πρέπει να βγει πριν πληρώσει ο πελάτης:

  • Delivery με κάρτα στην πόρτα. Η απόδειξη φεύγει με την παραγγελία και ο διανομέας χρεώνει την κάρτα στην παράδοση.
  • Πληρωμή στην παραλαβή. Η παραγγελία ετοιμάζεται με την απόδειξη, και ο πελάτης πληρώνει όταν έρθει να την πάρει.
  • Ο λογαριασμός στο τραπέζι. Η απόδειξη τυπώνεται και πηγαίνει στο τραπέζι μαζί με το τερματικό.

Γι' αυτές υπάρχει το aade_preloaded, με τις χρήσεις του αναλυτικά στον οδηγό για το aade_preloaded. Στέλνεις την 11.1 με το τερματικό και "aade_preloaded": true:

  1. Η απόδειξη εκδίδεται αμέσως, με ΜΑΡΚ και τρόπο πληρωμής «επί πιστώσει», και η χρέωση περιμένει στο τερματικό.
  2. Όταν ο πελάτης πληρώσει με κάρτα σε εκείνο το τερματικό, το Wrapp αλλάζει τον τρόπο πληρωμής της απόδειξης σε κάρτα, με νέο ΜΑΡΚ πληρωμής. Τα στοιχεία της κάρτας τα διαβάζεις από το GET /invoices/{id}, γιατί δεν έρχεται δεύτερο webhook.
  3. Αν τελικά πληρώσει μετρητά, ακυρώνεις τη χρέωση στο τερματικό και η απόδειξη μένει «επί πιστώσει». Δεν χρειάζεται τίποτα άλλο: ούτε πιστωτικό, ούτε νέα απόδειξη.

Ταμειακή: την αντικαθιστάς ή την κρατάς

Η έκδοση μέσω παρόχου είναι νόμιμη εναλλακτική της ταμειακής μηχανής, βάσει του άρθρου 12 §10 του ν.4308/2014. Ένας πελάτης σου μπορεί να αντικαταστήσει την ταμειακή του εντελώς, και αυτό είναι που του προτείνουμε:

  • Έκδοση από το cloud, με διαβίβαση στο myDATA σε πραγματικό χρόνο.
  • Από τις συσκευές που ήδη έχει, μέσα από το δικό σου σύστημα, χωρίς δεύτερη συσκευή στο ταμείο.
  • Χωρίς φορολογικό μηχανισμό για πιστοποίηση και service, και χωρίς «Ζ» στο τέλος της ημέρας.

Αν θέλει να κρατήσει την ταμειακή του, μπορεί: μια επιχείρηση δηλώνει νόμιμα περισσότερα από ένα ταμειακά συστήματα, οπότε το Wrapp δουλεύει και δίπλα της. Αυτό που δεν αλλάζει σε καμία περίπτωση είναι η θέση της επιχείρησης απέναντι στην ΑΑΔΕ και η δήλωση παρόχου.

Τι περιλαμβάνει η ενσωμάτωση

  • REST API για έκδοση σε πραγματικό χρόνο, με τεκμηρίωση και σαφή error codes του myDATA.
  • Περιβάλλον staging για δοκιμή κάθε τύπου παραστατικού από άκρη σε άκρη, πριν πας production.
  • Όλα τα παραστατικά της βάρδιας: Δελτίο Παραγγελίας Εστίασης (8.6), απόδειξη λιανικής (11.1), πιστωτικό λιανικής (11.4), αποδείξεις είσπραξης και επιστροφής POS (8.4 και 8.5), αυτοπαράδοση (6.1), και τιμολόγια για το catering και τις εταιρικές παραγγελίες.
  • Partner Portal και Partners API για να ανοίγεις λογαριασμό σε κάθε νέο πελάτη σου σε λίγα λεπτά.

Νέος πελάτης, έτοιμος σε λίγα λεπτά

Κάθε εστιατόριο που υπογράφει μαζί σου χρειάζεται δικό του λογαριασμό Wrapp. Τον ανοίγεις εσύ, με ένα κουμπί στο Partner Portal ή με μία κλήση στο Partners API, και ο πελάτης σου δεν χρειάζεται να ψάξει τίποτα:

  1. Ο λογαριασμός ανοίγει αμέσως και εμφανίζεται στη λίστα των πελατών σου.
  2. Το API key του πελάτη φτάνει στο webhook σου την ίδια στιγμή, οπότε το σύστημά σου είναι έτοιμο να εκδίδει για εκείνον.
  3. Ο πελάτης λαμβάνει email με σύνδεσμο για να ολοκληρώσει τη ρύθμιση του λογαριασμού του.
  4. Τη δήλωση παρόχου στην ΑΑΔΕ την υποβάλλει το Wrapp, μέσω του myAADE. Ο πελάτης ενημερώνεται με e-κοινοποίηση και email, και αν δεν απαντήσει σε 10 ημέρες η δήλωση τεκμαίρεται αποδεκτή.

Δεν υπάρχει χαρτί, ραντεβού ή επίσκεψη στον λογιστή για να ξεκινήσει. Πώς δημιουργείς τον partner σου και πώς προσκαλείς πελάτες, βήμα βήμα, είναι στον οδηγό για το Wrapp Partner Portal, και ποιος υποβάλλει τη δήλωση στον οδηγό για τη δήλωση παρόχου.

Το χρονικό παράθυρο

Από τις 2 Νοεμβρίου 2026 η ηλεκτρονική τιμολόγηση είναι υποχρεωτική για τα B2B παραστατικά του συνόλου των επιχειρήσεων, με μεταβατική περίοδο έως 31/1/2027 που προϋποθέτει εμπρόθεσμη δήλωση. Για τους πελάτες σου αφορά τα τιμολόγια προς επιχειρήσεις: catering, εκδηλώσεις, εταιρικούς λογαριασμούς. Είναι η ερώτηση που θα σου κάνουν τώρα, όχι κάποτε. Το πλήρες χρονοδιάγραμμα και τα πρόστιμα είναι στον οδηγό για τις 2/11/2026.

Από το staging στην παραγωγή

  1. Δοκιμαστικός λογαριασμός. Κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ σου και πάτα «Δοκίμασε το API». Παίρνεις email σύνδεσης και API key για το staging.wrapp.ai, με τις σειρές ήδη στημένες.
  2. Χτίζεις τις ροές σου στο staging, μία για κάθε στιγμή του πίνακα παραπάνω. Για την κάρτα συνδέεις ένα δοκιμαστικό τερματικό Viva: το staging βλέπει μόνο δοκιμαστικά τερματικά.
  3. Ενεργοποιείς πακέτο στον λογαριασμό παραγωγής. Για συνδεδεμένο τερματικό, από το Wrapp Core και πάνω.
  4. Παίρνεις το API key παραγωγής από τα «Στοιχεία API» στο wrapp.ai και αλλάζεις τη διεύθυνση από staging.wrapp.ai σε wrapp.ai.
  5. Δημιουργείς τις σειρές της παραγωγής, μία για κάθε τύπο που εκδίδεις. Οι σειρές του staging δεν μεταφέρονται.
  6. Δηλώνεις τα πραγματικά τερματικά στον λογαριασμό παραγωγής, με το Merchant ID και το Terminal ID τους.
  7. Ορίζεις το webhook του λογαριασμού παραγωγής.
  8. Ελέγχεις το πρώτο πραγματικό παραστατικό: ΜΑΡΚ και εκτύπωση.

Η ίδια εικόνα από τη σκοπιά του πελάτη σου

Τι σημαίνει πρακτικά για μια επιχείρηση εστίασης η διασυνδεδεμένη λειτουργία, από την παραγγελιοληψία μέχρι το παραστατικό, το περιγράφουμε από τη σκοπιά του επιχειρηματία στο άρθρο για την ψηφιοποίηση της εστίασης. Χρήσιμο και ως υλικό για τη δική σου πώληση: είναι οι ερωτήσεις που θα σου κάνει ο πελάτης.

Πώς ξεκινάς

Κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ σου και άνοιξε μόνος σου τον δοκιμαστικό λογαριασμό: έχεις email σύνδεσης και API key για το staging.wrapp.ai, με τις σειρές τιμολόγησης ήδη στημένες. Πού βρίσκεις το key, ανάλογα με το πού είσαι στον λογαριασμό σου, το δείχνει ο οδηγός για το δοκιμαστικό API key. Μόλις οι ροές σου δουλεύουν, δημιουργείς τον partner σου και προσκαλείς τον πρώτο σου πελάτη.

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

Τι κάνει το Wrapp και τι το σύστημά μου;

Το σύστημά σου στέλνει στο API τα είδη, τα ποσά και τον τρόπο πληρωμής. Το Wrapp, ως αδειοδοτημένος πάροχος ΥΠΑΗΕΣ, κάνει όλα τα υπόλοιπα αυτόματα: εκδίδει το παραστατικό με ΜΑΡΚ και QR, το διαβιβάζει στο myDATA σε πραγματικό χρόνο και το ξαναστέλνει μόνο του αν η ΑΑΔΕ δεν απαντά, το παραδίδει στον πελάτη για εκτύπωση ή με email, στέλνει το ποσό στο τερματικό καρτών, και υποβάλλει τη δήλωση παρόχου για κάθε πελάτη σου.

Ποια παραστατικά χρειάζεται ένα σύστημα παραγγελιοληψίας;

Το Δελτίο Παραγγελίας Εστίασης (8.6) για κάθε γύρο στο τραπέζι, την απόδειξη λιανικής (11.1) που το κλείνει ή που εκδίδεται απευθείας στον πάγκο και στο take-away, το πιστωτικό λιανικής (11.4), τις αποδείξεις είσπραξης και επιστροφής POS (8.4 και 8.5) για τη μικτή πληρωμή και τις επιστροφές στην κάρτα, και το στοιχείο αυτοπαράδοσης (6.1). Το ίδιο API εκδίδει και τα τιμολόγια για το catering και τις εταιρικές παραγγελίες, καθώς και όλους τους υπόλοιπους τύπους του myDATA.

Πόσο χρόνο θέλει η ενσωμάτωση;

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

Τι γίνεται αν ένα δελτίο παραγγελίας δεν συσχετιστεί με απόδειξη;

Το δελτίο έχει 24 ώρες από την έκδοσή του για να συσχετιστεί με το παραστατικό που το κλείνει. Αν περάσουν, το άρθρο 9 της Α.1112/2025 υποχρεώνει τον πάροχο να διακόψει την αυθεντικοποίηση και τη διαβίβαση όλων των παραστατικών της επιχείρησης, μέχρι να κλείσουν τα ανοιχτά δελτία. Το API δεν απορρίπτει μια απόδειξη χωρίς συσχέτιση, οπότε τον έλεγχο τον κρατάει το σύστημά σου. Η λίστα των ανοιχτών δελτίων είναι διαθέσιμη από το API.

Χρειάζεται να εγκατασταθεί κάτι στο κατάστημα για το τερματικό καρτών;

Όχι. Το σύστημά σου στέλνει την απόδειξη με το τερματικό στο API, και το Wrapp στέλνει το ποσό στο τερματικό μέσω cloud, από server σε server. Δεν χρειάζεται τοπική εφαρμογή ή γέφυρα στο κατάστημα, ούτε ξεχωριστή σύνδεση με τον acquirer. Η απόδειξη παίρνει ΜΑΡΚ μόλις εγκριθεί η πληρωμή, και το αποτέλεσμα σου έρχεται με webhook.

Μπορεί η απόδειξη να βγει πριν πληρώσει ο πελάτης με κάρτα;

Ναι, με το aade_preloaded. Η 11.1 εκδίδεται αμέσως με ΜΑΡΚ και τρόπο πληρωμής «επί πιστώσει», και η χρέωση περιμένει στο τερματικό. Όταν ο πελάτης πληρώσει με κάρτα, ο τρόπος πληρωμής αλλάζει σε κάρτα με νέο ΜΑΡΚ πληρωμής. Αν πληρώσει μετρητά, ακυρώνεις τη χρέωση στο τερματικό και η απόδειξη μένει «επί πιστώσει», χωρίς πιστωτικό ή νέα απόδειξη. Ταιριάζει στο delivery με κάρτα στην πόρτα, στην πληρωμή στην παραλαβή και στον λογαριασμό που πηγαίνει τυπωμένος στο τραπέζι.

Ποιος υποβάλλει τη δήλωση στην ΑΑΔΕ για τους πελάτες μου;

Ο πάροχος, μέσω του myAADE, εντός 10 ημερών από την έναρξη ισχύος της σύμβασης. Η επιχείρηση ενημερώνεται μέσω των e-κοινοποιήσεων και με email και έχει 10 ημέρες να την αποδεχθεί ή να την απορρίψει. Αν η προθεσμία περάσει άπρακτη, η δήλωση θεωρείται αποδεκτή. Αν ο πάροχος δεν την υποβάλει εμπρόθεσμα, η υποχρέωση μεταφέρεται στην επιχείρηση. Πρακτικά, είναι μια γραφειοκρατία που δεν σηκώνεις εσύ.

Υπάρχει περιβάλλον staging και πώς αποκτώ πρόσβαση;
Ναι. Κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ σου και άνοιξε μόνος σου τον δοκιμαστικό λογαριασμό: έχεις email σύνδεσης και API key για το staging.wrapp.ai, με τις σειρές τιμολόγησης ήδη στημένες. Πού βρίσκεις το key, ανάλογα με το πού είσαι στον λογαριασμό σου, το δείχνει ο οδηγός για το δοκιμαστικό API key.
Τι χρειάζεται για να βγω στην παραγωγή;

Ενεργό πακέτο στον λογαριασμό παραγωγής, το API key παραγωγής από τα «Στοιχεία API» στο wrapp.ai, μία σειρά για κάθε τύπο που εκδίδεις (οι σειρές του staging δεν μεταφέρονται), τα πραγματικά τερματικά δηλωμένα με Merchant ID και Terminal ID, και το webhook της παραγωγής. Μετά ελέγχεις το πρώτο πραγματικό παραστατικό: ΜΑΡΚ και εκτύπωση.

Οι πελάτες μου έχουν ταμειακές μηχανές. Τι αλλάζει για αυτούς;

Η έκδοση μέσω παρόχου είναι νόμιμη εναλλακτική της ταμειακής μηχανής, οπότε ο πελάτης σου μπορεί να την αντικαταστήσει εντελώς, και αυτό του προτείνουμε: έκδοση από το cloud με διαβίβαση σε πραγματικό χρόνο, από τις συσκευές που ήδη έχει, χωρίς φορολογικό μηχανισμό για service και χωρίς καθημερινό «Ζ». Αν θέλει να την κρατήσει, μπορεί, γιατί μια επιχείρηση δηλώνει νόμιμα περισσότερα από ένα ταμειακά συστήματα. Σε καμία περίπτωση δεν αλλάζουν οι υποχρεώσεις της επιχείρησης έναντι της ΑΑΔΕ.

Πώς ανοίγουν λογαριασμό οι πελάτες μου;
Τον ανοίγεις εσύ, με ένα κουμπί στο Partner Portal ή με μία κλήση στο Partners API. Ο λογαριασμός ανοίγει αμέσως, το API key του πελάτη φτάνει στο webhook σου την ίδια στιγμή, και ο πελάτης λαμβάνει email για να ολοκληρώσει τη ρύθμιση. Τη δήλωση παρόχου στην ΑΑΔΕ την υποβάλλει το Wrapp. Τα βήματα είναι στον οδηγό για το Wrapp Partner Portal.

Χρειάζεσαι βοήθεια;

Αν έχεις απορία για αυτό το θέμα ή θέλεις να σιγουρευτείς ότι όλα ρυθμίστηκαν σωστά, επικοινώνησε μαζί μας και θα το δούμε μαζί.