Οδηγίες Χρήσης και Λειτουργίας της Υπηρεσίας e-Invoicing
Ημερομηνία  29/12/2022

Η ΤΕΣΑΕ είναι πιστοποιημένος Πάροχος Υπηρεσιών Ηλεκτρονικής Έκδοσης Στοιχείων.Ως πάροχος διαθέτει άδεια καταλληλότητας λογισμικού Υπηρεσιών Παρόχου Ηλεκτρονικής Έκδοσης Στοιχείων (Υ.ΠΑ.Η.Ε.Σ). Τα Ηλεκτρονικά Παραστατικά τα οποία εκδίδονται από τον Συνδρομητή με την χρήση της Πλατφόρμας Υ.ΠΑ.Η.Ε.Σ της ΤΕΣΑΕ έχουν την μορφή η οποία περιγράφεται  στο παρόν κείμενο και είναι σύμφωνη με την Απόφαση Α.1017 (ΦΕΚ 457 Β.2020), την Απόφαση Α.1035/2020 (ΦΕΚ: 551 Β/2020) και τα άρθρα 14  και 15 του ν.4308/2014. 

Περιεχόμενα:

Συνοπτική περιγραφή υπηρεσίας

To e-invoicing.pegcloud.io είναι το interface για την Υπηρεσία Ηλεκτρονικής Έκδοσης Στοιχείων της ΤΕΣΑΕ.
Το απόρρητο της μεταφοράς δεδομένων εξασφαλίζεται με την χρήση του πρωτοκόλλου κρυπτογράφησης ssl.
Ο επισκέπτης μπορεί να αναζητήσει ένα παραστατικό που έχει εκδοθεί με τις υπηρεσίες Ηλεκτρονικής Έκδοσης Στοιχείων της ΤΕΣΑΕ.
Επιπλέον, ένας καταχωρημένος χρήστης μπορεί να συνδεθεί και να αναζητήσει στη λίστα των παραστατικών του και να προβάλει τα σύνολά τους, να πληροφορηθεί για τις υπολειπόμενες κλήσεις του για την χρήση του API καθώς και να διαχειριστεί τον λογαριασμό του.
Tέλος, τo e-invoicing-user-api.pegcloud.io είναι το API με το οποίο δίνεται η δυνατότητα σε ERP εφαρμογές να χρησιμοποιούν τις Υπηρεσίες Παροχής Ηλεκτρονικής έκδοσης στοιχείων της ΤΕΣΑΕ και να αυθεντικοποιούν τα παραστατικά τους.

Πρόσβαση στην υπηρεσία e-invoicing.pegcloud.io

Για να αποκτήσετε πρόσβαση στην υπηρεσία e-invoicing.pegcloud.io, χρησιμοποιήστε τον browser σας για να πλοηγηθείτε στη διεύθυνση: 

https://e-invoicing.pegcloud.io


Μπορείτε να επιλέξετε γλώσσα (Ελληνικά/Αγγλικά) με χρήση του σχετικού μενού πάνω δεξιά:

  • EL - Ελληνικά
  • EN - Αγγλικά

Αναζήτηση παραστατικού

 

Δίνεται η δυνατότητα αναζήτησης κάποιου e-παραστατικού που έχει εκδοθεί από την Υπηρεσία Ηλεκτρονικής Έκδοσης Στοιχείων της ΤΕΣΑΕ. με χρήση της σχετικής συμβολοσειράς αυθεντικοποίησης. Για τη λειτουργία αυτή, ο χρήστης δεν είναι απαραίτητο να έχει κάνει login.

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

Εφόσον βρεθεί e-παραστατικό με τη συγκεκριμένη συμβολοσειρά αυθεντικοποίησης, εμφανίζεται στην ίδια οθόνη.

Σε αντίθετη περίπτωση, εμφανίζεται σχετικό μήνυμα.

Σύνδεση στην υπηρεσία e-invoicing.pegcloud.io

Για να συνδεθείτε στην υπηρεσία e-invoicing.pegcloud.io, καταχωρείτε τα στοιχεία σύνδεσης που σας έχουν αποσταλεί κάνοντας κλικ στο σύνδεσμο [Σύνδεση] πάνω δεξιά.

 

Στην οθόνη που εμφανίζεται, συμπληρώνετε το όνομα χρήστη και το συνθηματικό σας στα ομώνυμα πεδία και κάνετε κλικ στο button [Σύνδεση].

  • Λαμβάνετε το όνομα χρήστη σας με e-mail και το συνθηματικό σας με SMS κατόπιν επικοινωνίας με την ΤΕΣΑΕ.
  • Με την πρώτη σύνδεση, θα σας ζητηθεί να αλλάξετε τον κωδικό σας. 

Πρόσβαση στα δεδομένα του Εγγεγραμμένου Χρήστη έχει μόνο ο κάτοχος των δύο παραπάνω στοιχείων (όνομα χρήστη και συνθηματικό) για αυτό και ο κάθε Εγγεγραμμένος Χρήστης είναι αποκλειστικά υπεύθυνος για την πρόσβαση σε αυτά καθώς και την λήψη όλων των απαραίτητων μέτρων για την διαφύλαξη της μυστικότητάς τους. Σε περίπτωση απώλειας ή υποψίας διαρροής τους ο Εγγεγραμμένος Χρήστης πρέπει να ενημερώσει ΑΜΕΣΑ την ΤΕΣΑΕ. Η ΤΕΣΑΕ δεν αποκαλύπτει ή/και δημοσιοποιεί με κανέναν τρόπο προσωπικά δεδομένα και πληροφορίες των λογαριασμών των Εγγεγραμμένων Χρηστών. Η χρήση των παραπάνω δεδομένων αφορά αποκλειστικά την παροχή υπηρεσιών και προϊόντων προς τους Εγγεγραμμένους Χρήστες καθώς για την ενημέρωση τους σχετικά με αυτά.

Βασικές δυνατότητες και λειτουργίες

Στην κεντρική οθόνη της υπηρεσίας e-invoicing.pegcloud.io, ο χρήστης μπορεί:

  • Να δει τον αριθμό των κλήσεων προς την υπηρεσία που έχουν εκτελεστεί, αλλά και πόσες κλήσεις απομένουν
  • Να αναζητήσει ένα παραστατικό με βάση τη συμβολοσειρά αυθεντικοποίησης
  • Να δει τη λίστα των παραστατικών του, να κάνει αναζήτηση ανάμεσα σε αυτά με βάση την ημερομηνία καθως και να τα εμφανίσει
  • Να κάνει αναζήτηση της διεύθυνσης e-mail που έχει ορίσει ο πελάτης να λαμβάνει τα e-παραστατικά του,με βάση το ΑΦΜ του.
  • Να δει/επεξεργαστεί τα στοιχεία λογαριασμού του (αλλαγή συνθηματικού / καταχώρηση στοιχείων myDATA κ.ο.κ.)
  • Να καταχωρήσει στοιχεία που θα εμφανίζονται στα e-παραστατικά του(για παράδειγμα, λογότυπο / τίτλοι επιχείρησης κ.ο.κ.)

Κλήσεις

Στο κάτω μέρος της οθόνης εμφανίζονται οι παρακάτω πληροφορίες:

  • Κλήσεις που έχουν εκτελεστεί

Αφορά τις κλήσεις που έχουν εκτελεστεί επιτυχημένα προς την υπηρεσία e-invoicing.pegcloud.io (έχουν λάβει συμβολοσειρά αυθεντικοποίησης από την ΑΑΔΕ).

  • Κλήσεις που απομένουν

Αφορά τις υπολειπόμενες κλήσεις της υπηρεσίας e-invoicing.pegcloud.io που έχει αγοράσει ο χρήστης.

Οι παραπάνω ενδείξεις εμφανίζονται σε οποιοδήποτε μενού πλογηθεί ο συνδεδεμένος χρήστης.

Αναζήτηση Παραστατικού

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

Παραστατικά

Σε αυτή την οθόνη εμφανίζονται όλα τα e-παραστατικά που έχουν εκδοθεί από το συνδεδεμένο χρήστη με χρήση της υπηρεσίας e-invoicing.pegcloud.io, με βάση το εύρος ημερομηνιών που καθορίζεται στα φίλτρα [Ημερομηνία Από] και [Ημερομηνία Έως].

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

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

Μπορείτε να καταχωρήσετε την ημερομηνία και μέσω πληκτρολογίου, αρκεί να ακολουθήσετε τη μορφή DD/MM/YYYY.

Αλλάζοντας την ημερομηνία, η λίστα των e-παραστατικών ανανεώνεται αυτόματα. Αν τα αποτελέσματα είναι περισσότερα από 10, μπορείτε να κάνετε κλικ στο button [Περισσότερα] ώστε να σας εμφανίσει επιπλέον εγγραφές.

Κάθε κλικ στο παραπάνω button, προσθέτει ακόμα 10 αποτελέσματα στα ήδη υπάρχοντα.

Στο κάτω μέρος, εμφανίζονται τα σύνολα που αφορούν τα e-παραστατικά για το εύρος ημερομηνιών που έχουν επιλεχθεί και πιο συγκεκριμένα, υπολογίζονται τα παρακάτω:

  • Σύνολο Καθαρής Αξίας
  • Σύνολο ΦΠΑ
  • Σύνολο Παρ. Φόρων
  • Σύνολο Λοιπών Φόρων
  • Σύνολο Χαρτοσήμου
  • Σύνολο Τελών
  • Σύνολο Κρατήσεων
  • Συνολική Αξία

Εμφάνιση παραστατικού

Μπορείτε να εμφανίσετε το επιθυμητό e-παραστατικό με κλικ στο εικονίδιο δεξιά από κάθε εγγραφή.

Ως αποτέλεσμα, ανοίγει νέα καρτέλα στον browser σας όπου εμφανίζεται το σχετικό e-παραστατικό.

Στην προβολή του παραστατικού, εμφανίζονται:

  • To logo της επιχείρησης και επιπλέον στοιχεία header/footer (εφόσον έχουν οριστεί στο υπο-μενού [Λογαριασμός->Στοιχεία Επιχείρησης])
  • Στοιχεία πελάτη(λήπτη)
  • Στοιχεία κίνησης(τρόπος πληρωμής κ.α.)
  • Στοιχεία ειδών του παραστατικού(περιγραφή, καθαρή αξία κ.α.)
  • Σύνολα αξίας του παραστατικού(καθαρή αξία, αξία ΦΠΑ κ.α.)
  • Στοιχεία που αφορούν στην αυθεντικότητα έκδοσής του:
    • Μ. Αρ. Κ.
    • Αναγνωριστικό
    • Υπογραφή
    • QR Code

Τέλος, με κλικ στο button [Εκτύπωση] πάνω δεξιά, το e-παραστατικό εκτυπώνεται ως αρχείο PDF χρησιμοποιώντας την ενσωματωμένη δυνατότητα επεξεργασίας PDF του browser σας.

Στην εκτύπωση αυτή, εμφανίζονται παρόμοια στοιχεία με αυτά της προβολής παραστατικού.

Εξαγωγή σε XML

Στη λίστα παραστατικών δίνεται η δυνατότητα επιλογής e-παραστατικών και εξαγωγής τους σε format XML. Η μορφή των παραγόμενων αρχείων είναι συμβατή με αυτή που απαιτεί η υπηρεσία myDATA.
Μπορείτε να επιλέξετε τα επιθυμητά παραστατικά τσεκάροντας το ανάλογο κουτάκι αριστερά από κάθε εγγραφή. Αν τσεκάρετε το κουτάκι στην κορυφή της στήλης, επιλέγονται αυτόματα όλες οι εγγραφές που εμφανίζονται εκείνη τη στιγμή.

Προσοχή: αν έχετε επιλέξει όλες τις εγγραφές που εμφανίζονται και κάνετε κλικ στο button [Περισσότερα], οι επιλογές θα χαθούν. Αν έχετε κάνει μερική επιλογή εγγραφών, οι εγγραφές θα παραμείνουν επιλεγμένες.

Εφόσον ολοκληρώσετε την επιλογή, κάνετε κλικ στο button [Εξαγωγή σε XML].

Η διαδικασία ολοκληρώνεται αυτόματα με το σχετικό αρχειο zip που κατεβαίνει στον browser σας. Αν το αποσυμπιέσετε, δημιουργείται ο σχετικός φάκελος ο οποίος περιέχει ένα xml αρχείο για κάθε παραστατικό που είχατε επιλέξει.

Αναζήτηση email

Ο συνδεδεμένος χρήστης μπορεί να εισάγει το ΑΦΜ ενός πελάτη για να βρει σε ποια διεύθυνση ηλεκτρονικού ταχυδρομείου επιθυμεί να λαμβάνει τα e-παραστατικά του.
Κάθε φορολογική οντότητα μπορεί να καταχωρήσει στο mytaxisnet ένα συγκεκριμένο e-mail το οποίο αφορά αποκλειστικά την αποστολή e-παραστατικών. Καταχωρώντας το ΑΦΜ στην οθόνη αυτή και κάνοντας κλικ στο button [Αναζήτηση], το e-mail αυτό αντλείται από την ΑΑΔΕ και εμφανίζεται αυτόματα.

Σε περίπτωση καταχώρησης λανθασμένου ΑΦΜ ή αν για το ΑΦΜ αυτό δεν έχει καταχωρηθεί e-mail για τα e-παραστατικά, εμφανίζεται αντίστοιχο μήνυμα.

Σημείωση: Προεπιλεγμένα, η υπηρεσία e-invoicing.pegcloud.io αποστέλλει αυτόματα το e-παραστατικό στο e-mail που περιγράφεται παραπάνω(εφόσον υπάρχει κάποιο).

Λογαριασμός

Στο μενού αυτό μπορείτε να δείτε / επεξεργαστείτε συγκεκριμένα στοιχεία του λογαριασμού σας στην υπηρεσία e-invoicing.pegcloud.io καθώς και να ορίσετε στοιχεία εμφάνισης στα e-παραστατικά σας, κάνοντας κλικ στα επιμέρους υπο-μενού.

Ο Λογαριασμός μου

Στην οθόνη αυτή εμφανίζονται στοιχεία του λογαριασμού σας (Επωνυμία, Επώνυμο, Όνομα, ΑΦΜ κ.α.). Δεν μπορείτε να τροποποιήσετε αυτά τα στοιχεία.


Επιπλέον, έχετε τη δυνατότητα να προχωρήσετε σε αλλαγή συνθηματικού με κλικ στο ομώνυμο button.

Στην οθόνη που εμφανίζεται, καταχωρείτε το νέο συνθηματικό της επιλογής σας.

Οι κανόνες δημιουργίας ενός νέου συνθηματικού είναι οι εξής:

  • Να αποτελείται από τουλάχιστον 8 χαρακτήρες
  • Να περιέχει τουλάχιστον ένα κεφαλαίο γράμμα
  • Να περιέχει τουλάχιστον ένα μικρό γράμμα
  • Να περιέχει τουλάχιστον έναν αριθμό
  • Να περιέχει τουλάχιστον ένα σύμβολο

Σε περίπτωση που κάποιος κανόνας δεν πληρείται στο συνθηματικό που δίνετε, θα εμφανιστεί σχετικό μήνυμα.

Τέλος, σε αυτή την οθόνη εκτελείτε τις ρυθμίσεις που απαιτούνται για τη σύνδεση της υπηρεσίας e-invoicing.pegcloud.io με την εφαρμογή ERP που χρησιμοποιείτε. 

Ρυθμίσεις λογαριασμού για την έκδοση e-παραστατικών

Για να εκδίδετε e-παραστατικά που θα λαμβάνουν επιτυχώς συμβολοσειρά αυθεντικοποίησης μέσα από τη μηχανογράφησή σας, θα πρέπει να καταχωρήσετε τα στοιχεία σύνδεσής σας στο myDATA Rest API ώστε η υπηρεσία e-invoicing.pegcloud.io να επικοινωνεί επιτυχώς με την ΑΑΔΕ και το ομώνυμο service.

Η διαδικασία εγγραφής στις προσφερόμενες υπηρεσίες του myDATA REST API γίνεται μέσω της εφαρμογής που είναι διαθέσιμη στο URL της πλατφόρμας του myDATA: https://www1.aade.gr/saadeapps2/bookkeeper-web

Μπορείτε να δείτε περισσότερα για τη διαδικασία εγγραφής στο myDATA REST API στο Εγχειρίδιο Χρήσης εδώ.

Τέλος, για να συνδεθεί η εφαρμογή μηχανογράφησής σας με την υπηρεσία e-invoicing.pegcloud.io, απαιτούνται 2 στοιχεία σύνδεσης:

  • API Bearer Token
  • Private Key

Κάνοντας κλικ στα buttons:

  • Παραγωγή Token
  • Παραγωγή Private Key

παράγονται οι αντίστοιχες αλφαριθμητικές τιμές, τις οποίες πρέπει να αντιγράψετε προσεκτικά ώστε να τις καταχωρήσετε στο σχετικό μενού ρυθμίσεων της εφαρμογής σας. Καταχωρείτε τις ρυθμίσεις κάνοντας κλικ στο button [Αποθήκευση].

API Documentation

Με τη χρήση του API, e-invoicing-user-api.pegcloud.io, δίνεται η δυνατότητα σε ERP εφαρμογές να χρησιμοποιούν τις Υπηρεσίες Παροχής Ηλεκτρονικής έκδοσης στοιχείων της ΤΕΣΑΕ και να αυθεντικοποιούν τα παραστατικά τους.

Η ταυτοποίηση του Εγγεγραμμένου Χρήστη για τη χρήση του API, γίνεται με τη χρήση του Bearer token, ο κάθε Εγγεγραμμένος Χρήστης είναι αποκλειστικά υπεύθυνος για την πρόσβαση στο Bearer token καθώς και την λήψη όλων των απαραίτητων μέτρων για την διαφύλαξη της μυστικότητάς τους. Μπορείτε να λάβετε το Bearer token κάνοντας σύνδεση με τους κωδικούς σας στο https://e-invoicing.pegcloud.io/, από την επιλογή [Ο λογαριασμός μου]. Σε περίπτωση απώλειας ή υποψίας διαρροής του ο Εγγεγραμμένος Χρήστης πρέπει να ενημερώσει ΑΜΕΣΑ την ΤΕΣΑΕ. Η ΤΕΣΑΕ δεν αποκαλύπτει ή/και δημοσιοποιεί με κανέναν τρόπο προσωπικά δεδομένα και πληροφορίες των λογαριασμών των Εγγεγραμμένων Χρηστών.

Μπορείτε να δείτε το documentation για το API, e-invoicing-user-api.pegcloud.io, στον σύνδεσμο https://www.tesae.gr/e-invoicing-rest-api.

Στοιχεία Επιχείρησης

Μέσα από την υπηρεσία e-invoicing.pegcloud.io, σας δίνεται η δυνατότητα να μορφοποιήσετε το e-παραστατικό σας.

Η μορφοποίηση είναι προαιρετική.
 

Συγκεκριμένα, μπορείτε να ορίσετε τα εξής στοιχεία που αφορούν την προβολή παραστατικού και την εκτύπωση PDF:

  • Logo e-παραστατικού

Για να καταχωρήσετε μια εικόνα που θα χρησιμοποιηθεί ως logo, κάνετε κλικ στο button [Choose file] και μέσα από το παράθυρο που εμφανίζεται, επιλέγετε το επιθυμητό αρχείο.

Το αρχείο πρέπει να είναι τύπου PNG ή JPG και να μην έχει μέγεθος μεγαλύτερο από 2MB.

  • Τίτλοι Παραστατικού

Καταχωρείτε τους επιθυμητούς τίτλους στα σχετικά πεδία.

  • Τίτλοι Παραστατικού footer

Καταχωρείτε τους επιθυμητούς τίτλους στα σχετικά πεδία.

Για τα δύο τελευταία, ορίζετε αντίστοιχα και τίτλους για Αγγλικά. 

 

Αποσύνδεση από την υπηρεσία e-invoicing.pegcloud.io

Για να αποσυνδεθείτε από την υπηρεσία, κάνετε κλικ στο σύνδεσμο [Αποσύνδεση] πάνω δεξιά.

Η υπηρεσία επιστρέφει στην αρχική της οθόνη.

Αδυναμία Χρήσης του API

Σε περίπτωση που για κάποιο λόγο δεν είναι δυνατή η χρήση του API της υπηρεσίας e-invoicing.pegcloud.io (για παράδειγμα, δεν υπάρχει πρόσβαση στο internet), θα χρειαστεί να ενημερώσετε την ΤΕΣΑΕ για τα παραστατικά που δεν έλαβαν επιτυχώς συμβολοσειρά αυθεντικοποίησης, κάνοντας χρήση της εφαρμογής WhatsApp (Μπορείτε να την εγκαταστήσετε στο κινητό σας μέσα από GooglePlay/AppStore) και ακολουθώντας τα παρακάτω βήματα:

  • Καταγράφετε την σειρά και τον αριθμό των παραστατικών αυτών (π.χ. 000123, Α022234)
  • Δημιουργείτε μια νέα συνομιλία στην εφαρμογή WhatsApp όπου ορίζετε ως αριθμό παραλήπτη το νούμερο 697 221 3405 (Θα σας εμφανίσει ως όνομα επαφής [TESAEgroup])
  • Στο κείμενο της συνομιλίας, καταχωρείτε σειρά και αριθμό του παραστατικού που δεν απεστάλη (δεν θα πρέπει να υπάρχει κενό ανάμεσα στη σειρά και στον αριθμό, για παράδειγμα Α1234 και όχι Α 1234).
  • Πατάτε το button της αποστολής.
  • Αυτόματα θα λάβετε απάντηση με κείμενο [Επιβεβαίωση Λήψης:], ακολουθούμενο από το λεκτικό του παραστατικού που καταχωρήσατε προηγουμένως.
  • Επαναλαμβάνετε τη διαδικασία της καταχώρησης και αποστολής για κάθε παραστατικό που έχετε καταγράψει.