AADE Mydata Api Documentation v0.5

myDATA
Ηλεκτρονικά Βιβλία ΑΑΔΕ

Τεχνική περιγραφή διεπαφής restapi για
διαβίβαση & λήψη δεδομένων
Έκδοση 0.5 – Αύγουστος 2019

Πίνακας περιεχομένων
1 Εισαγωγή ........................................................................................................................... 3
2 Σκοπός ............................................................................................................................... 3
3 Τεχνολογικές απαιτήσεις λογισμικών έκδοσης παραστατικών ........................................ 4
4 Περιγραφή του RESTAPI .................................................................................................... 4
4.1 Portal για Προγραμματιστές ..................................................................................... 4
4.2 Περιγραφή λειτουργίας της διεπαφής...................................................................... 5
4.2.1 Εγγραφή χρήστη ................................................................................................ 5
4.2.2 Χρήση υπηρεσιών ............................................................................................. 6
4.2.3 Απαραίτητα Headers ......................................................................................... 6
4.3 Περιγραφή λειτουργιών ............................................................................................ 7
4.3.1 sendInvoices ...................................................................................................... 7
4.3.2 sendIncomeClassification .................................................................................. 7
4.3.3 sendExpensesClassification ............................................................................... 8
4.3.4 receiveInvoices .................................................................................................. 9
5 Περιγραφή σχήματος παραστατικού .............................................................................. 11
5.1 Στοιχεία οντότητας .................................................................................................. 12
5.1.1 Διεύθυνση ....................................................................................................... 13
5.2 Επικεφαλίδα παραστατικού .................................................................................... 14
5.3 Στοιχεία παραστατικού ........................................................................................... 16
5.3.1 Δήλωση Διενέργειας (ΠΟΛ 1177/2018 Αρ. 27) ............................................... 20
5.4 Περίληψη παραστατικού ........................................................................................ 21
6 Περιγραφή Απαντήσεων ................................................................................................. 22
7 Σφάλματα ........................................................................................................................ 23
8 Παράρτημα ...................................................................................................................... 24
8.1 Είδη παραστατικών ................................................................................................. 24
8.2 Συντελεστές Φ.Π.Α .................................................................................................. 28
8.3 Κωδικοί εξαίρεσης από ΦΠΑ................................................................................... 28
8.4 Συντελεστές παρακράτησης φόρου ........................................................................ 29
8.5 Συντελεστές λοιπών φόρων ................................................................................... 29
8.6 Συντελεστές Χαρτοσήμου ....................................................................................... 30
1
myDATA REST API
8.7 Συντελεστές τελών .................................................................................................. 30
8.8 Χαρακτηρισμοί εσόδων........................................................................................... 30
8.9 Χαρακτηρισμοί εξόδων ........................................................................................... 31
8.10 Μονάδες Μέτρησης ................................................................................................ 31
8.11 Επισημάνσεις........................................................................................................... 31
2
myDATA REST API
1 Εισαγωγή introduction
myDATA, δηλαδή my Digital Accounting and Tax Application.
Είναι το όνομα της νέας ηλεκτρονικής πλατφόρμας, με την οποία η ΑΑΔΕ εισάγει τα
ηλεκτρονικά βιβλία στην καθημερινότητα των επιχειρήσεων.
Τα Ηλεκτρονικά Βιβλία ΑΑΔΕ αποτελούν ένα πολύ σημαντικό βήμα ψηφιακού

μετασχηματισμού του Δημοσίου και των επιχειρήσεων. Στόχος μας είναι πρωτίστως να
εξυπηρετήσουμε τις επιχειρήσεις, προσφέροντας μια πρωτοποριακή ψηφιακή πλατφόρμα
για την εκπλήρωση των φορολογικών τους υποχρεώσεων, που θα οδηγήσει σε
αυτοματοποίηση της συμπλήρωσης των φορολογικών δηλώσεων και θα τις απαλλάξει από
υποχρεώσεις που έχουν σήμερα, όπως η υποβολή Καταστάσεων Πελατών – Προμηθευτών
(ΜΥΦ).
Η ηλεκτρονική πλατφόρμα myDATA παρέχει εύκολες λύσεις για όλους. Τόσο για τις
επιχειρήσεις που διαθέτουν μηχανογραφημένα λογιστήρια και θα μπορούν να διαβιβάζουν
μαζικά και αυτοματοποιημένα τα αναγκαία δεδομένα, όσο και για τις λοιπές επιχειρήσεις,
που θα μπορούν να διαβιβάζουν τα δεδομένα με απλό τρόπο, μέσω ειδικής φόρμας
καταχώρισης στην ιστοσελίδα της ΑΑΔΕ.
My data, ie my digital accounting and tax application
It is the name of a new electronic platform, with which AADE introduces the electronic books
into the daily lives of businesses.
The electronic books of AADE are a very important step to a digital transformation of the
state and the businesses. Our goal is primarily to serve businesses by providing an
innovative digital platform for full-filling their tax obligation which will lead to the
automation of the filling of tax returns and relieve them of their current obligations such as
filling customer statements (MYF).
The electronic platform my data gives easy solutions for all. Both for businesses that have
computerized accounting systems that can transmit the necessary data in bulk and
automated, and for other companies that can transmit data in a simply way, through a
special registration form on the website of AADE.
2 Σκοπός Goal
Για τις ανάγκες των επιχειρήσεων και των επαγγελματιών που διαθέτουν
μηχανογραφημένα λογιστήρια, παρέχεται από την ΑΑΔΕ μια διεπαφή RESTAPI σε υποδομή
public cloud (Microsoft Azure). Έτσι, δίνεται η δυνατότητα σε συστήματα ERP ή άλλα
λογιστικά-εμπορικά συστήματα, να διασυνδέονται με την ΑΑΔΕ απρόσκοπτα και
αδιάλειπτα για την ανταλλαγή των σχετικών δεδομένων.
Πιο συγκεκριμένα, για μια επιχείρηση που χρησιμοποιεί κάποιο πληροφοριακό σύστημα
που αξιοποιεί το σχετικό API, οι προσφερόμενες λειτουργίες αυτοματοποιημένης
3
myDATA REST API
διασύνδεσης, είναι:
 Αποστολή δεδομένων για τα παραστατικά που εκδίδει.
 Αποστολή χαρακτηρισμών εσόδων που αφορούν τα παραστατικά που εκδίδει.
 Λήψη δεδομένων όσων παραστατικών έχουν εκδοθεί για αυτήν και έχουν
διαβιβαστεί από τους αντίστοιχους εκδότες στην ΑΑΔΕ.
 Αποστολή δεδομένων χαρακτηρισμών εξόδων στην ΑΑΔΕ.
Στο παρόν έγγραφο περιγράφονται οι παραπάνω λειτουργίες, καθώς και οι αναγκαίες

τεχνικές προδιαγραφές για την υλοποίηση των σχετικών κλήσεων της προσφερόμενης
διεπαφής RESTAPI.
For the needs of the businesses and professionals with computerized accounting, AADE provides a RESTAPI interface to
public cloud infrastructure (MICROSOFT AZURE). This enables ERP systems or other accounting - trading systems to
seamlessly and seamlessly interconnect with AADE for the exchange of relevant data.
Specifically, for an enterprise using an information system that leverages the relevant API, the automated interface
features offered are :
 Sending data on the documents issued
 Sending income ratings related to the documents it issues
 Receive data of any documents issued for it and transmitted by the respective issuers of AADE
 Send expense rating data to AADE
This document describes the above functions as well as the technical specifications necessary to implement the relative
calls of the RESTAPI interface offered.
4
myDATA REST API
3 Τεχνολογικές απαιτήσεις λογισμικών έκδοσης παραστατικών Technological
requirements for documentation software
1) Για την υλοποίηση της επικοινωνίας ενός συστήματος λογισμικού με την διεπαφή
χρησιμοποιούνται οι παρακάτω τεχνολογίες
• HTTPS – Secure HTTP
• Webservice
• REST API – REST interface required for the data reporting process
• XML – eXtensible Markup Language
2) Η διεπαφή μπορεί να χρησιμοποιηθεί από οποιοδήποτε λογισμικό που μπορεί να
υλοποιήσει HTTPS κλήσεις και να δημιουργήσει έγγραφα XML συμβατά με το σχήμα
που περιγράφεται στο παρόν έγγραφο.
3) Εκτός των σχετικών δεδομένων, το λογισμικό θα πρέπει να μπορεί να στείλει
ταυτόχρονα και αυτοματοποιημένα και τις απαραίτητες πληροφορίες για την
ταυτοποίηση του χρήστη μέσω της ίδιας HTTPS κλήσης.
1) The following technologies are used to implement a software system interface with the interface
 HTTPS-Secure HTTP
 Webservice
 REST API – REST interface required for the data reporting process
 XML-extensible Markup language
2) The interface can be used by any software that can implement HTTPS calls and create XML documents
compatible with the format described in this document.
3) In addition, to the relevant data the software should be able to simultaneously and automatically
send the necessary information to identify the user through the same HTTPS call.
4 Περιγραφή του RESTAPI Description of RESTAPI
Συνοπτικά, η διεπαφή παρέχει τις εξής λειτουργίες-μεθόδους:
 /sendInvoices: διαδικασία υποβολής ενός ή περισσότερων παραστατικών,

συμπεριλαμβανομένων και διορθωμένων/τροποποιητικών
 /receiveInvoices: διαδικασία λήψης ενός ή περισσότερων παραστατικών, με
συγκεκριμένα κριτήρια
 /sendIncomeClassification: διαδικασία υποβολής χαρακτηρισμών εσόδων, ενός ή
περισσότερων, που θα αντιστοιχούν σε ήδη υποβεβλημένα παραστατικά
 /receiveIncomeClassification: διαδικασία λήψης ήδη υποβληθέντων χαρακτηρισμών
εσόδων
 /sendExpensesClassification: διαδικασία υποβολής χαρακτηρισμών εξόδων, ενός ή
περισσότερων, που θα αντιστοιχούν σε ήδη υποβεβλημένα παραστατικά
 /receiveExpensesClassification: διαδικασία λήψης ήδη υποβληθέντων χαρακτηρισμών
εξόδων
5
myDATA REST API
Λεπτομερής περιγραφή των λειτουργιών περιγράφονται σε επόμενο τμήμα αυτού του
εγγράφου.
Summary, the interface provides the following functions-methods:

- /sendinvoices: the process of submitting one or more documents, including
corrected/modified
- /receiveInvoices: the process of download one or more documents, with specific criteria
- /sendIncomeClassification: the process of submitting one or more income statements
corresponding to the documents already submitted
- /receiveIncomeClassification: the process of download the already submitting incomes
- /sendExpenseClassification: the process of submitting one or more expenses statements,
corresponding to the documents already submitted
- /receiveExpensesClassification: the process of obtaining already submitted expenses
characterizations
4.1 Portal για Προγραμματιστές Portal for programmers
Ειδικά για τη φάση ανάπτυξης και διενέργειας δοκιμών, οι διαθέσιμες μέθοδοι του RESTAPI
είναι διαθέσιμες στο URL:https://mydata-dev.azure-api.net
Επίσης, παρέχεται ειδικό portal για προγραμματιστές στο URL:https://mydata-

dev.portal.azure-api.net/
6
myDATA REST API
Σε αυτό, υπάρχει τεκμηρίωση όλων των διαθέσιμων μεθόδων, δίνονται code samples σε
διάφορες γλώσσες προγραμματισμού, καθώς και δυνατότητα εκτέλεσης απευθείας
δοκιμαστικών κλήσεων μέσα από το ίδιο το portal. Επιπλέον, από το profileτου χρήστη,
παρέχονται analytics reports σχετικά με τις κλήσεις που έχουν γίνει. Ακόμα, από το profile,
ο χρήστης έχει τη δυνατότητα επανέκδοσης/αλλαγής του subscription key.
Τέλος, για θέματα λειτουργικότητας, προβλημάτων ή προτάσεων βελτίωσης, υπάρχει η

δυνατότητα αναφοράς στο URL: https://mydata-dev.portal.azure-api.net/issues μέσω της
επιλογής ReportIssue.
Specifically for the development and testing phase, the available RESTAPI Methods are
available at url: https://mydata-dev.azure-api.net.
Also, it is provided specific portal for developers at url: L:https://mydata- dev.portal.azure-

api.net/
In it there is documentation of all the methods available, codes samples are provided in
different programming languages, as well as the ability to execute direct test calls through
the portal itself. In addition, the user profile provides analytic reports on calls made. Also,
from the profile, the user can reissue/change the subscription key.
Finally, for functionality issues, problems or suggestions, you can refer to the url:
https://mydata-dev.portal.azure-api.net/issues via the reportissue option
4.2 Περιγραφή λειτουργίας της διεπαφής Description of interface operation
4.2.1 Εγγραφή χρήστη User registration
Η χρήση των λειτουργιών της διεπαφής απαιτεί διαδικασία ταυτοποίησης του χρήστη
(authentication). Η ταυτοποίηση πραγματοποιείται μέσω αποστολής σε κάθε κλήση, ενός
ονόματος χρήστη καθώς και ενός subscription key στην ενότητα headers. Το subscription
key είναι ένα string, μοναδικό ανά χρήστη και είναι κοινό όλες της λειτουργίες της
διεπαφής.
Για να αποκτήσει ένας χρήστης τα παραπάνω διαπιστευτήρια-credentials,πρέπει να

δημιουργήσει έναν λογαριασμό στο μητρώο της διεπαφής μέσω ειδικής διαδικασίας
εγγραφής που προσφέρεται από την ηλεκτρονική πλατφόρμα myDATA.
Στην φόρμα της σελίδας συμπληρώνονται βασικά στοιχεία της οντότητας του χρήστη που
είναι απαραίτητα για την δημιουργία του προσωπικού του προφίλ. Τα βασικά στοιχεία που
7
myDATA REST API
είναι απαραίτητα για την διαδικασία της εγγραφής είναι τα εξής
 Επιθυμητό Όνομα Χρήστη (username)

 Email επικοινωνίας
 Είδος εξουσιοδότησης. Το είδος εξουσιοδότησης είναι αναγκαίο στην περίπτωση
που οι κωδικοί θα δοθούν σε τρίτη εξουσιοδοτημένη από το χρήστη οντότητα, για
την διαβίβαση των δεδομένων. Τέτοιες περιπτώσεις μπορούν να αφορούν
εξουσιοδότηση λογιστών, ανάθεση τιμολόγησης, ή εξουσιοδότηση
αυτοτιμολόγησης.
Σε περίπτωση επιτυχημένης εγγραφής, δημιουργείται o χρήστης στο σχετικό μητρώο του

RESTAPI, και παρέχεται ειδικό subscription key που θα χρησιμοποιεί ο χρήστης για την
ταυτοποίηση του κατά τις κλήσεις των υπηρεσιών της διεπαφής. Επίσης, αποστέλλεται
μήνυμα επιβεβαίωσης της εγγραφής στην διεύθυνση email που έχει δηλωθεί.
8
myDATA REST API
Μετά το στάδιο της εγγραφής ο χρήστης θα μπορεί να συνδεθεί στο portal της διεπαφής με
τα στοιχεία του λογαριασμού του από όπου θα μπορεί να δει και να αλλάξει το subscription
key.
*Σημείωση: Για την φάση ανάπτυξης και ελέγχου, η διαδικασία εγγραφής στις
προσφερόμενες υπηρεσίες του myDATA RESTAPI, θα γίνεται μέσω της εφαρμογής που είναι
διαθέσιμη στο URL:
https://mydata-register.azurewebsites.net
Using interface functions requires an user authentication process. Authentication is accomplished by sending each call, a username
and a subscription key to a headers section. The subscription key is a single string per user and is common to all interface function.
In order for a user to obtain the above credentials, he must create an account in the registry of the interface through a special
registration process offered by the my data online platform.
The page form fills in the key elements of the user’s entity that are needed to crate their personal profile. The essentials necessary for
the registration process are as follows:
 Username
 E-mail
 Type of warranty. The type of warranty is necessary in case the codes are given to a third party authorized entity to transmit the
data. Such cases may involve accountant authorization, invoicing or self-authorization.
In the event of a successful registration, the user is created in the relevant RESTAPI registry, and a special subscription key is provided
by the user to identify him/her when calling interface services. A confirmation message will also be sent to the registered e-mail
address.
After the stage of registration, the user can connect to the interface portal with the credentials of his account where he can watch and
change the subscription key.
Note: for the development and testing phase, the registration process for my data RESTAPI services will be done through the
application available at url: https://mydata-register.azurewebsites.net
4.2.2 Χρήση υπηρεσιών Use of services
H χρήση κάθε λειτουργίας της διεπαφής πραγματοποιείται μέσω της αποστολής μιας HTTPS
κλήσης (GET ή POST, ανάλογα με τη λειτουργία) στον αντίστοιχο σύνδεσμο URL.
Η κλήση πρέπει να εμπεριέχει την κατάλληλη κεφαλίδα (header) η οποία θα περιέχει

πληροφορίες απαραίτητες για την ταυτοποίηση του χρήστη και ένα σώμα (body) σε
XMLμορφή, του οποίου η δομή θα εξαρτάται από την υπηρεσία που καλείται. Για κάθε
κλήση ο χρήστης θα λαμβάνει μια απάντηση με πληροφορίες για την έκβαση της κλήσης
του, ομοίως σε XMLμορφή.
Στις υπηρεσίες υποβολής, ο χρήστης μπορεί να στείλει ένα ή πολλά αντικείμενα,

ενσωματώνοντας τα στο σώμα (body) της κλήσης σε ειδική μορφή
XML,(παραστατικά/λογιστικές εγγραφές ή χαρακτηρισμούς). Η απάντηση μπορεί να
περιέχει, για κάθε παραστατικό, ένα ή περισσότερα μηνύματα σφάλματος ή ένα μήνυμα
πετυχημένης υποβολής. Σε περίπτωση που ένα αντικείμενο υποβληθεί ξανά, έχοντας τα
9
myDATA REST API
ίδια αναγνωριστικά στοιχεία με προηγούμενα αποσταλμένο αντικείμενο, το τελευταίο
διατηρείται στην βάση δεδομένων των Ηλεκτρονικών Βιβλίων ως έγκυρο, και αντιστοίχως
το προηγούμενο ακυρώνεται.
Each interface function is performed by sending an HTTPS call (get or post depending on the
function) to the corresponding url.
The call must contain the appropriate header containing the information necessary for user
identification and a body in XML format whose structure will depend on the service being
called. For each call the user will receive an answer with information about the outcome of
their call, in XML format
In submission services, the user can send one or more objects, incorporating them into the body of the call in a specific
xml format, (documents/ accounting registrations or attributes). The answer can contain, for each document, one or more
error messages or a successful submission message. If any item resubmitted, having the same identifiers as a previous
shipped item, the last is remained on the database of electronic books as valid, and the previous one is canceled.
4.2.3 Απαραίτητα Headers Necessary headers
Κάθε κλήση πρέπει να περιέχει με τη μορφή ζευγαριών-τιμών, τα παρακάτω headers,τα

οποία είναι απαραίτητα για την ταυτοποίηση του χρήστη. Σε περίπτωση λανθασμένων
στοιχείων ο χρήστης θα λάβει μήνυμα σφάλματος.
KEY Data Type VALUE DESCRIPTION

aade-user-id String {Όνομα Χρήστη} Το όνομα χρήστη του λογαριασμού
name user the name user of account
ocp-apim-subscription-key String {Subscription Key} Το subscription key τουχρήστη
Every call must contain the following headers in the form of pair-values, which are necessary for user identification. In
case of incorrect information the user will receive error message
10
myDATA REST API
4.3 Περιγραφή λειτουργιών description of functions
4.3.1 sendInvoices
Η κλήση έχει τα ακόλουθα χαρακτηριστικά:
 /sendInvoices, μέθοδος POST
 Έχει headers όπως αναφέρεται στην παράγραφο 4.2.3
 Body που το περιεχόμενο του είναι xml και περιγράφεται από το

elementInvoicesDoc, το οποίο περιέχει ένα ή περισσότερα παραστατικά. Η δομή
του παραστατικού περιγράφεται από το AadeBookInvoiceType και αναλύεται στο
κεφάλαιο5.
*Σημείωση: Για τη φάση της ανάπτυξης και διενέργειας δοκιμών, η μέθοδος είναι
διαθέσιμη στο URL:https://mydata-dev.azure-api.net/SendInvoices
The call has the following characteristics:

 /sendInvoices, method POST
 It has header as referred to the par. 4.2.3
 Body whose content is an xml and described it from elementInvoicesDoc , which contains one or
more documents. The structure of the document described from the AadeBookInvoiceType and
analyzed on chapter 5.
*Note: For the development and testing phase the method is available at url: https://mydata-
dev.azure-api.net/SendInvoices
4.3.2 sendIncomeClassification
Η κλήση έχει τα ακόλουθα χαρακτηριστικά:
 /sendIncomeClassification, μέθοδος POST
 Έχει headersόπως αναφέρεται στην παράγραφο 4.2.3
11
myDATA REST API
 Body που το περιεχόμενο του είναι xml και περιγράφεται από το
elementIncomeClassificationsDoc. To element αυτό απεικονίζεται παρακάτω και
είναι μία ακολουθία από ένα ή περισσότερους χαρακτηρισμούς εσόδων.
The call has the following characteristics:
 /sendIncomeClassification, method POST
 It has header as referred to the par. 4.2.3
 Body whose content is an xml and described it from elementInvoicesDoc , which contains one or more
documents. This element is illustrated below and is a sequence of one or more revenue classifications.
12
myDATA REST API
Πεδίο field Τύπος type Υποχρεωτικό Περιγραφή description Αποδεκτές τιμές
required acceptable prices
mark xs:string Ναι yes Μοναδικός Αριθμός
Καταχώρησης
παραστατικού/λογιστικής
εγγραφής unique
registration number
documentar/accounting
entry
classificationReceipt xs:long Ναι yes Αποδεικτικό παραλαβής
χαρακτηρισμού.
Συμπληρώνεται από την
Υπηρεσία. Proof of receipt
of qualification. To be
completed by the service.
lineNumber xs:int Ναι yes Αριθμός γραμμής του
αρχικού
εγγραφής στην οποία
αναφέρεται ο
Χαρακτηρισμός original line
number
document/accounting
registration referred to in
characterization
classificationType xs:int Ναι yes Κωδικός χαρακτηρισμού Ελάχιστη τιμή
identification code minimum price= 101
Μέγιστη τιμή
maximum price = 110
classificationCategory xs:int Ναι yes Κατηγορία χαρακτηρισμού Ελάχιστη τιμή
classification category minimum price = 1
maximum price = 4
amount xs:decimal Ναι yes Ποσό amount Ελάχιστη τιμή
minimum price = 0
Δεκαδικά ψηφία
decimals = 5
13
myDATA REST API
διαθέσιμη στο URL:https://mydata-dev.azure-api.net/sendIncomeClassification
4.3.3 sendExpensesClassification
Η δομή του αιτήματος για αποστολή παραστατικών περιγράφεται από το

elementExpensesClassificationsDoc. Είναι μία ακολουθία από ένα ή περισσότερους
χαρακτηρισμούς εξόδων. Η δομή είναι παρόμοια με το χαρακτηρισμό εσόδων και
διαφοροποιείται μόνο στις πιθανές τιμές του πεδίου classificationType
The structure of the request to send documents is described by the elementExpensesClassificationDoc. It is a sequence of
one or more output classification. The structure is similar to revenue classification and differs only in the possible values
of the classification type field.
14
myDATA REST API
Ορισμοί Πεδίων

mark xs:string Ναι yes Μοναδικός Αριθμός
εγγραφής unique
registration number
documentar/accounting
entry
classificationReceipt xs:long Ναι yes Αποδεικτικό παραλαβής
χαρακτηρισμού.
Συμπληρώνεται από την
Υπηρεσία. Proof of receipt
of qualification. To be
completed by the service.
lineNumber xs:int Ναι yes Αριθμός γραμμής του
αρχικού
εγγραφής στην οποία
αναφέρεται ο
Χαρακτηρισμός original line
number
document/accounting
registration referred to in
characterization
classificationType xs:int Ναι yes Κωδικός χαρακτηρισμού Ελάχιστη τιμή
identification code minimum price= 201
maximum price = 212
classificationCategory xs:int Ναι yes Κατηγορία Ελάχιστη τιμή
χαρακτηρισμούclassification minimum price = 1
category Μέγιστη τιμή
maximum price = 4
amount xs:decimal Ναι yes Ποσό amount Ελάχιστη τιμή
minimum price = 0
decimals= 5
15
myDATA REST API
διαθέσιμη στο URL:https://mydata-dev.azure-api.net/sendExpensesClassification
4.3.4 receiveInvoices
Για μια οντότητα, υπάρχει η δυνατότητα λήψης των πρότυπων παραστατικών που έχουν
εκδοθεί για αυτήν, και έχουν διαβιβαστεί στην ΑΑΔΕ.
16
myDATA REST API
Αυτό πραγματοποιείται μέσω μιας HTTP κλήσης GET της μεθόδου, με την παρακάτω
παράμετρο η οποία λειτουργεί ως κριτήριο αναζήτησης.
Η κλήση επιστρέφει όσα παραστατικά έχουν ως λήπτη την οντότητα που αντιστοιχεί στο
όνομα χρήστη και subscription key, και αναγνωριστικό Μοναδικό Αριθμό Καταχώρησης
μεγαλύτερο του mark. Σε περίπτωση μη αποστολής τιμής για την παράμετρο mark, η
αναζήτηση θα φέρει όλα τα διαθέσιμα παραστατικά.
For an entity, it is possible to obtain the template documents issued for it and forwarded it
to AADE.
This is done via a HTTP call GET method, with the following parameter acting as criteria of
search.
The call returns the documents have as a receiver of entity corresponding to the username
and subscription key, and a unique registration number bigger than the MARK. In case of
failure send the value for the mark parameter, the search will contain all the available
documents.
Όνομα name Τύπος type Υποχρεωτικό Περιγραφή description

required
mark xs:string Όχι no Μοναδικός αριθμός καταχώρησης
unique registration number
continuationToken xs:string Όχι no Κλειδί για την τμηματική λήψη των
Αποτελεσμάτων key to partial
download of results
Παρατήρηση:Το continuationToken λαμβάνεται σε περίπτωση που τα αποτελέσματα

αναζήτησης ξεπερνούν το μέγιστο επιτρεπτό όριο και χρησιμοποιείται ως παράμετρος στην
κλήση για την επόμενη λήψη
διαθέσιμη στο URL:
https://mydata-dev.azure-api.net/RequestInvoices[?mark]&[continuationToken]
Note: continuationToken is obtained if the search results exceed the maximum permissible limit and it used as a
parameter in a call for the next reception
17
myDATA REST API
5 Περιγραφή σχήματος παραστατικού Document shape description
Αυτή η ενότητα περιγράφει αναλυτικά το περιεχόμενο του παραστατικού (τύπου

AadeBookInvoiceType) το οποίο αναμένεται να αποστέλλεται από τις εφαρμογές με την
μέθοδο /sendInvoices
Το AadeBookInvoiceType περιέχει τις πληροφορίες του παραστατικού και η δομή του είναι
η παρακάτω:
This section describes in detail the content of the document (type AADEBOOKINVOICE TYPE)
that is expected to be sent by applications with the / sendInvoices method.
AadeBookInvoiceType contains the document information and is structured as follow:

uid xs:string Όχι no Αναγνωριστικό Μήκος= 40
παραστατικού Συμπληρώνεται από την
document id Υπηρεσία. To be
completed by the service
mark xs:long Όχι no Μοναδικός Αριθμός Συμπληρώνεται από την
Καταχώρησης Υπηρεσία. To be
Παραστατικού unique completed by the
registration number service
issuer PartyType Ναι yes Εκδότης παραστατικού
18
myDATA REST API
document issuer
counterpart PartyType Ναι yes Λήπτης παραστατικού
document recipient
invoiceHeader InvoiceHeaderParty Ναι yes Επικεφαλίδα
Παραστατικού heading
document
invoiceDetails InvoiceRowParty Ναι yes Γραμμές παραστατικού
document lines
invoiceSummary InvoiceSummaryParty Ναι yes Περίληψη παραστατικού
document summary
Οι σύνθετοι τύποι PartyType, InvoiceHeaderParty, InvoiceRowParty, InvoiceSummaryParty

περιγράφονται αναλυτικά στη συνέχεια του κεφαλαίου.
The composite types of PartyType, InvoiceHeaderParty, InvoiceRowParty, InvoiceSummaryParty are described in more
details above.
19
myDATA REST API
Παρατηρήσεις
1) Το uid αποτελεί το αναγνωριστικό κάθε παραστατικού και συμπληρώνεται από την

Υπηρεσία. Υπολογίζεται από το SHA-1 hash6 πεδίων του παραστατικού τα οποία
είναι :
o ΑΦΜ Eκδότη
o Έτος Έκδοσης
o Αριθμός Εγκατάστασης στο Mητρώο του Taxis
o Τύπος Παραστατικού
o Σειρά
o ΑΑ
2) Το mark αποτελεί τον Μοναδικό Αριθμό Καταχώρησης του παραστατικού (Μ.ΑΡ.Κ).
Remarks
1) The uid is the id of each document and is completed by the service. It is calculated by the SHA-1 hash6 fields of the
document which are:
 Taxpayer issue
 Year of publishing
 Taxis registration number installation
 Type of document
 Series
 AA
2) The mark is the unique document registration number (M.AR.K).
5.1 Στοιχεία οντότητας Entity elements
Ο εκδότης και ο λήπτης του παραστατικού είναι elements τύπου PartyType.
The publisher and recipient of document are elements type PartyType
Πεδίο field Τύπος type Υποχρεωτικό Περιγραφή Αποδεκτές τιμές acceptable

20
myDATA REST API
required description prices
vatNumber xs:string Ναι yes ΑΦΜ vat number Οποιοσδήποτε έγκυρος
ΑΦΜ any valid vat number
country xs:string Ναι yes Κωδικός χώρας Κωδικοί χωρών codes of
code country countries
name xs:string Όχι no Επωνυμία name
address AddressType Όχι no Διεύθυνση
address
1) Ο κωδικός της χώρας είναι δύο χαρακτήρες και προέρχεται από την αντίστοιχη
λίστα χωρών όπως περιγράφεται στο ISO 3166.
Remarks
1) The code of country is two characters and comes from the corresponding country list as described in ISO 3166.
21
myDATA REST API
5.1.1 Διεύθυνση Οντότητας Entity address
Η διεύθυνση του εκδότη (ή του λήπτη) είναι element τύπου AddressType και η δομή του
περιγράφεται παρακάτω
The address of the publisher (or recipient) is an address type element and its structure is
described below.
Πεδίο field Τύπος Υποχρεωτικό Περιγραφή

type required description
street xs:string Ναι yes Οδός street
number xs:string Ναι yes Αριθμός Οδού
number of street
postalCode xs:string Ναι yes ΤΚ postal code
city xs:string Ναι yes Πόλη city
22
myDATA REST API
5.2 Επικεφαλίδα παραστατικού Document Header

branch xs:int Ναι yes Εγκατάσταση installation Ελάχιστη τιμή = 0
series xs:string Ναι yes Σειρά παραστατικού
document series
23
myDATA REST API
aa xs:long Ναι yes ΑΑ παραστατικού AA
document
24
myDATA REST API
issueDate xs:date Ναι yes Ημ. έκδοσης παραστατικού
day issue a document
invoiceType xs:string Ναι yes Τύπος παραστατικού type Λίστα τιμών price list:
of document 1.1, 1.2, 1.3,
1.4,1.5.1, 1.5.2,
1.6,2.1, 2.2, 2.3, 2.4,
3.1, 3.2,4,5.1, 5.2,6.1,
6.2, 7.1,8.1, 8.2,
8.3,9.1,9.2, 9.3,10.1,
10.2,11.1, 11.2, 11.3,
11.4,
12,13.1, 13.2,
13.3,13.4, 13.30,
13.31,14.1, 14.2,
14.3, 14.4,14.5,
14.30,
14.31,15.1,16.1,
16.30, 17.1, 17.2,
17.3, 17.4,17.5, 17.6
anastoliKatavolisFPA xs:boolean Όχι no Αναστολή καταβολής ΦΠΑ
suspension of payment of
vat
currency xs:string Ναι yes Νόμισμα coin Κωδικοί νομισμάτων
code coins
exchangeRate xs:decimal Όχι no Ισοτιμία equivalent Ελάχιστη τιμή
minimum price = 0
decimals = 2
correlatedInvoices xs:string Όχι no Συσχετιζόμενα
Παραστατικά associated
documents
1) To πεδίο exchangeRate είναι η ισοτιμία του νομίσματος σε σχέση με το ευρώ.

Πρέπει να συμπληρώνεται μόνο όταν το νόμισμα δεν έχει τιμή EUR.
2) Ο κωδικός νομισμάτων προέρχεται από την αντίστοιχη λίστα σύμφωνα με το
πρότυπο ISO4217.
3) Το element correlatedInvoices είναι λίστα τύπου string που περιέχει τα
αναγνωριστικά των συσχετιζόμενων παραστατικών
4) Σε περίπτωση που η εγκατάσταση του εκδότη είναι η έδρα, το πεδίο branch πρέπει
να έχει την τιμή 0
5) Σε περίπτωση μη έκδοσης σειράς παραστατικού, το πεδίο series πρέπει να έχει την
τιμή 0
25
myDATA REST API
Remarks
1) The field exchangerate is the exchange rate of the currency against the euro. It should be completed only when the
coin doesn’t have price euro.
2) The currency code comes from the corresponding list in accordance with ISO4217.
3) The element correlatedinvoices is a list type string which contains the associated document identifiers.
4) In case where the publisher’s installation is headquartered, the field branch must have price 0.
5) In case of non-issuance of a series of documents, the series field must have the price 0.
26
myDATA REST API
5.3 Στοιχεία παραστατικού Document details
Τα στοιχεία του παραστατικού (invoiceDetails) αποτελούνται από μία ή περισσότερες

εγγραφές τύπου InvoiceRowType.
Invoice details are composed of one or more invoicerowtype.
27
myDATA REST API
28
myDATA REST API
Πεδίο field Τύπος type Υποχρεωτικό Περιγραφή Αποδεκτές τιμές
required description acceptable prices
lineNumber xs:int Ναι yes ΑΑ γραμμής Ελάχιστη τιμή
minimum price= 1
quantity xs:decimal Όχι no Ποσότητα Ελάχιστη τιμή
quantity minimum price= 0
measurementUnit xs:int Όχι no Ποσότητα Λίστα τιμών price list:
quantity 1,2,3
invoiceDetailType xs:int Ναι yes Επισήμανση Λίστα τιμών price list
labeling :
1,2
netValue xs:decimal Ναι yes Καθαρή αξία net Ελάχιστη τιμή
value minimum price= 0
decimals= 5
vatCategory xs:int Ναι yes Κατηγορία Ελάχιστη τιμή
ΦΠΑ category of minimum price= 1
vat Μέγιστη τιμή
maximum price= 7
vatExemptionCategory xs:int Όχι no Κατηγορία Ελάχιστη τιμή
Αιτίας minimum price =
Εξαίρεσης ΦΠΑ 1 Μέγιστη τιμή
category cause maximum price =
vat exemption 23
dienergia ShipType Όχι no ΠΟΛ
1177/2018 Αρ.
27
discountOption xs:boolean Όχι no Δικαίωμα False / True
Έκπτωσης right
of discount
withheldAmount xs:decimal Όχι no Ποσό Παρ. Ελάχιστη τιμή
Φόρου minimum price = 0
retention Δεκαδικά ψηφία
amount tax decimals= 5
withheldPercentCategory xs:int Όχι no Κατηγορία Ελάχιστη τιμή
Συντελεστή minimum price =
παρακράτησης 1 Μέγιστη τιμή
φόρου maximum price =
coefficient 12
category
withholding
tax
stampDutyPercentCategory xs:int Όχι no Κατηγορία Λίστα τιμών
Συντελεστή price list: 1,
Χαρτοσήμου 2, 3
coefficient
category stamp
feesAmount xs:decimal Όχι no Ποσό Τελών Ελάχιστη τιμή
amount of fees minimum price = 0
decimals= 5
29
myDATA REST API
feesPercentCategory xs:int Όχι no Κατηγορία Ελάχιστη τιμή
Συντελεστή minimum price=
Τελών 1 Μέγιστη τιμή
coefficient maximum price =
category fees 8
otherTaxesPercentCategory xs:int Όχι no Κατηγορία Ελάχιστη τιμή
Συντελεστή minimum price=
λοιπών φόρων 1 Μέγιστη τιμή
coefficient maximum price=
category other 9
taxes
otherTaxesAmount xs:decimal Όχι no Ποσό λοιπών Ελάχιστη τιμή
Φόρων amount minimum price= 0
of other wearer Δεκαδικά ψηφία
decimals= 5
deductionsPercentage xs:decimal Όχι no Κατηγορία Ελάχιστη τιμή
Συντελεστή minimum price= 0
Κρατήσεων Μέγιστη τιμή
coefficient maximum price = 100
category Δεκαδικά ψηφία
reservations decimals= 2
incomeClassification incomeClassificationType Όχι no Λίστα
χαρακτηρισμών
Εσόδων list
rating revenues
30
myDATA REST API
1) Οι πιθανές τιμές για τα πεδία vatCategory, vatExemptionCategory,

withheldPercentCategory, stampDutyPercentCategory, feesPercentCategory και
otherTaxesPercentCategory περιγράφονται αναλυτικά στο παράρτημα
2) Τα πεδία withheldAmount, feesAmount, otherTaxesAmount συμπληρώνονται μόνο
στις περιπτώσεις που οι αντίστοιχοι φόροι/τέλη αφορούν ποσά και όχι ποσοστά,
και συγκεκριμένα στις παρακάτω περιπτώσεις
Αρ. 60 ν.4172/2013 παρ.1

Παρακράτηση Φόρου Μισθωτών Υπηρεσιών παρ. 1 αρ. 15 ν. 4172/2013 withheldAmount
withholding tax for employees
Αρ. 43Α ν.4172/2013 παρ.6
Παρακράτηση Ειδικής Εισφοράς Αλληλεγγύης withholding of special solidarity withheldAmount
contribution
Αρ. 15 ν.4172/2013 παρ.3
Παρακράτηση Φόρου Αποζημίωσης λόγω Διακοπής Σχέσης Εργασίας παρ. 3
αρ. 15 ν. 4172/2013 withholding tax on termination of work relationship withheldAmount
Φόρος Διαμονής (ανά ημερήσια χρήση δωματίου ή διαμερίσματος) residence
tax (per room or apartment daily use)
Ξενοδοχεία 1-2 αστέρων 0,50 € hotels 1-2 stars otherTaxesAmount
Ξενοδοχεία 3 αστέρων 1,50 € hotels 3 stars otherTaxesAmount
Ενοικιαζόμενα - επιπλωμένα δωμάτια - διαμερίσματα 0,50 € rented-furnished otherTaxesAmount
rooms-apartments
Περιβαλλοντικό Τέλος & πλαστικής σακούλας ν. 2339/2001 αρ. 6α 0,07 λεπτά
ανά τεμάχιο enviromental end and plastic bag feesAmount
3) Το πεδίο vatExemptionCategory είναι απαραίτητο στην περίπτωση που το

vatCategory υποδηλώνει κατηγορία συντελεστή 0% ΦΠΑ
Remarks
1) The possible prices for the fields vatcategory, vatexemptioncategory, withheldpercentcategory,

stampdutypercentcategory, feespercentcategory and other taxespercentcategory are described in detail in the
annex.
2) The fields withheldamount, feesamount, othertaxesamount are completed in only where corresponding taxes/fees
are for amounts and not percentages, and in particular in the following cases.
3) The field vatexemptioncategory is required in case that the vatcategory indicates 0% vat rate category.
31
myDATA REST API
5.3.1 Δήλωση Διενέργειας (ΠΟΛ 1177/2018 Αρ. 27) statement of action
Η Δήλωσης Διενέργειας είναι στοιχείο τύπου ShipType και η δομή του περιγράφεται
παρακάτω
The statement of action is a shiptype component and its structure is described below
Πεδίο field Τύπος Υποχρεωτικό Περιγραφή description

type required
applicationId xs:string Ναι yes Αριθμός Δήλωσης
διενέργειας δραστηριότητας
registration number carrying
out an activity
applicationDate xs:date Ναι yes Ημερομηνία Δήλωσης date of
statement
doy xs:string Όχι no ΔΟΥ Δήλωσης DOY statement
shipID xs:string Ναι yes Στοιχεία Πλοίου vessel details
32
myDATA REST API
5.4 Περίληψη παραστατικού document summary
Πεδίο field Τύπος type Υποχρεωτικό Περιγραφή Αποδεκτές τιμές

required description acceptable prices
totalNetValue xs:decimal Ναι yes Σύνολο καθαρής Ελάχιστη τιμή
Αξίας total net minimum price= 0
worth Δεκαδικά ψηφία
decimals= 5
totalVatAmount xs:decimal Ναι yes Σύνολο ΦΠΑ total Ελάχιστη τιμή
vat minimum price = 0
decimals= 5
totalWithheldAmount xs:decimal Ναι yes Σύνολο Ελάχιστη τιμή
παρακρατήσεων minimum price = 0
φόρων total Δεκαδικά ψηφία
withholding decimals= 5
taxes
totalFeesAmount xs:decimal Ναι yes Σύνολο τελών total Ελάχιστη τιμή
fees minimum price = 0
decimals= 5
totalStampDutyamount xs:decimal Ναι yes Σύνολο Ελάχιστη τιμή
Χαρτοσήμου total minimum price = 0
stamp Δεκαδικά ψηφία
33
myDATA REST API
decimals= 5
totalOtherTaxesAmoun xs:decimal Ναι yes Σύνολο λοιπών Ελάχιστη τιμή

t Φόρων total of minimum price= 0
other taxes Δεκαδικά ψηφία
decimals = 5
totalDeductionsAmount xs:decimal Ναι yes Σύνολο Ελάχιστη τιμή
Κρατήσεων total minimum price = 0
reservations Δεκαδικά ψηφία
decimals = 5
totalGrossValue xs:decimal Ναι yes Συνολική αξία total Ελάχιστη τιμή
value minimum price= 0
decimals = 5
incomeClassification incomeClassification Ναι Λίστα
Type χαρακτηρισμών
Εσόδων list ratings
revenue
34
myDATA REST API
6 Περιγραφή Απαντήσεων Description of answers
Στις περιπτώσεις που ο χρήστης χρησιμοποιήσει κάποιο service υποβολής οντότητας

(sendInvoice, sendIncomeClassification, sendExpensesClassification) θα λαμβάνει ως
απάντηση από την διεπαφή ένα αντικείμενο ResponseDoc σε xml μορφή. Το αντικείμενο
περιλαμβάνει μια λίστα από στοιχεία τύπου response, ένα για κάθε οντότητα που
υποβλήθηκε.
If the user uses an entity submission service (sendinvoice, sendincomeclassification,

sendexpensesclassification) they will receive a responsedoc object in xml format from the
interface. The object contains a list of response type elements, one for each entity
submitted.
Πεδίο field Τύπος type Υποχρεωτικ Περιγραφή Tιμές prices

Ό required description
entitylineNumber xs: int Ναι yes Αριθμός οντότητας
number of entity
statusCode xs: string Ναι yes Κωδικός Success,
Αποτελέσματος ValidationError,
AuthenticationError,
code result
TechnicalError,
XMLSyntaxError
entityUid xs: string Όχι no Αναγνωριστικό Mήκος length=40
Παραστατικού
identifier document
entityMark xs: string Όχι no Μοναδικός
Αριθμός
Παραστατικού
unique number
registration
document
errors ErrorType Όχι no Λίστα σφαλμάτων
error list
35
myDATA REST API
Το είδος της απάντησης (πετυχημένη ή αποτυχημένη διαδικασία) καθορίζεται από την τιμή
του πεδίου statusCode.
 Σε περίπτωση επιτυχίας το πεδίο statusCode έχει τιμή Successκαι η απάντηση

περιλαμβάνει τις αντίστοιχες τιμές για τα πεδία entityUid και entityMark για κάθε
οντότητα που υποβλήθηκε.
36
myDATA REST API
 Σε περίπτωση αποτυχίας το πεδίο statusCode έχει τιμή αντίστοιχη του είδους του
σφάλματος και η απάντηση περιλαμβάνει μια λίστα στοιχείων σφάλματος τύπου
ErrorType για κάθε οντότητα που η υποβολή της απέτυχε. Όλα τα στοιχεία
σφάλματος ανά οντότητα είναι υποχρεωτικά της ίδιας κατηγορίας που χαρακτηρίζει
την απάντηση
Remarks
 If successful, the status code field has a success value and the answer contains the corresponding
values for the entity uid and entity mark fields for each submitted entity.
 If not successful the field status code has a value corresponding to the type of error and the response
includes a list of error type for each entity that failed to submit. All error from entity data are
mandatory in same category that characterizes the response.
7 Σφάλματα Errors
Κάθε στοιχείο σφάλματος που αφορά μια οντότητα αποτελείται από ένα μήνυμα που
περιγράφει το σφάλμα και έναν κωδικό σφάλματος.
Each error element that concerns an entity consists of a message describing the error and an
error code.
Πεδίο field Τύπος type Υποχρεωτικό required Περιγραφή

description
message xs: string Ναι yes Μήνυμα σφάλματος
error message
code xs: string Ναι yes Κωδικός σφάλματος
error code
Ορισμοί Πεδίων
Πεδίο field Τύπος type

message xs: string
code xs: string
37
myDATA REST API
8 Παράρτημα Annex
8.1 Είδη παραστατικών Type of documents
Αντικριζόμενα Παραστατικά Εκδότη

Κωδικός Περιγραφή Description
ημεδαπής / αλλοδαπής
contributing documents
domestic foreign publisher
Τιμολόγιο Πώλησης Sale
invoice
1.1 Τιμολόγιο Πώλησης Sale invoice
Τιμολόγιο Πώλησης / Ενδοκοινοτικές

1.2
Παραδόσεις Sale
invoice/Intra-community
deliveries
Τιμολόγιο Πώλησης / Παραδόσεις Τρίτων
1.3
Χωρών Sale
invoice/Third Country
deliveries
Τιμολόγιο Πώλησης / Πώληση για

1.4
Λογαριασμό Τρίτων
Invoice of sale/Sale of
third party account
Τιμολόγιο Πώλησης / Εκκαθάριση

1.5
Πωλήσεων Τρίτων Sales
invoice/Third party sales
clearance
Τιμολόγιο Πώλησης / Αμοιβή από
1.5
Πωλήσεις Τρίτων Sales
invoice/Third Party sales fees
Τιμολόγιο Πώλησης / Συμπληρωματικό
1.6
Παραστατικό Sales
Invoice/Supplementary
Document
Τιμολόγιο Παροχής Υπηρεσιών
Service invoice
2.1 Τιμολόγιο Παροχής Provision Invoice
Τιμολόγιο Παροχής / Ενδοκοινοτική

2.2
Παροχή Υπηρεσιών Invoice of
Provision/Intra-community
38
myDATA REST API
service provision
Τιμολόγιο Παροχής / Παροχή Υπηρεσιών

2.3
Τρίτων Χωρών Invoice of
Provision/Provision of Third
Country services
Τιμολόγιο Παροχής / Συμπληρωματικό
2.4
Παραστατικό Supply
Invoice/Supplementary
document
Τίτλος Κτήσης Acquisition title
39
myDATA REST API
3.1 Τίτλος Κτήσης (μη υπόχρεος Εκδότης)
Acquisition Title (Non-obligatory issuer)
Τίτλος Κτήσης (άρνηση έκδοσης από
3.2
υπόχρεο Εκδότη)
Acquisition title (denial of
issue by a liable issuer)
Για Μελλοντική Χρήση For future
use
Πιστωτικό Τιμολόγιο Credit
memo
5.1 Πιστωτικό Τιμολόγιο / Συσχετιζόμενο

Credi invoice/related
Πιστωτικό Τιμολόγιο / Μη
5.2
Συσχετιζόμενο Credit
invoice/non related
Στοιχείο Αυτοπαράδοσης -
Ιδιοχρησιμοποίησης Self
delivery element
6.1 Στοιχείο Αυτοπαράδοσης Self-delivery

element
6.2 Στοιχείο Ιδιοχρησιμοποίησης ownership

element
Συμβόλαιο - Έσοδο Contract

Revenue
7.1 Συμβόλαιο - Έσοδο Contract-revenue
Ειδικό Στοιχείο (Έσοδο) – Απόδειξη

Είσπραξης Special
Item (Revenue)-proof
of collection
8.1 Ενοίκια - Έσοδο Rentals-Revenue
Ειδικό Στοιχείο – Απόδειξης Είσπραξης

8.2
Φόρου Διαμονής Special
Element-Proof of period tax
collection
Ειδικό Στοιχείο Αγροτών / Πώληση - Παροχή
8.3 αρ.41 παρ.3 ν. 2859/2000 (Μελλοντική
Χρήση) Farmer special/sale-provision no41
par3 ν2859/2000 (future use)
Παραστατικό Διακίνησης
Transaction document
40
myDATA REST API
9.1 Παραστατικό Διακίνησης Συσχετιζόμενο
Traffic document Associated
Παραστατικό Διακίνησης Συσχετιζόμενο -

9.2
Συγκεντρωτικό Related
document- Aggregate
41
myDATA REST API
Παραστατικό Διακίνησης Μη
9.3
Συσχετιζόμενο Non
correlated handling
document
Παραστατικό Διακίνησης (Ποσοτικής
Παραλαβής) Shipping
document (quantity
receipt)
10.1 Παραστατικό Διακίνησης Συσχετιζόμενο

Traffic document associated
Παραστατικό Διακίνησης Μη
10.2
Συσχετιζόμενο non
correlated handling
document
Μη Αντικριζόμενα Παραστατικά
Εκδότη ημεδαπής / αλλοδαπής non
matching documents
domestic/foreign publisher
Παραστατικά Λιανικής retail

documents
11.1 ΑΛΠ ALP
11.2 ΑΠΥ APY
11.3 Απλοποιημένο Τιμολόγιο Simplified

invoice
11.4 Πιστωτικό Στοιχ. Λιανικής credit element
retail
Για Μελλοντική Χρήση for future 12
use
Μη Αντικριζόμενα Παραστατικά
Λήπτη ημεδαπής / αλλοδαπής Non
matching document domestic
/foreign recipient
Λήψη Παραστατικών Λιανικής

download retail documents
Έξοδα - Αγορές Λιανικών Συναλλαγών
13.1
expenses-domestic/foreign
retail markets
Παροχή Λιανικών Συναλλαγών ημεδαπής
13.2
/ αλλοδαπής domestic retail provision
foreigner
13.3 Κοινόχρηστα shared
13.4 Συνδρομές subscriptions
42
myDATA REST API
Παραστατικά Οντότητας ως
13.30
Αναγράφονται από την ίδια (Δυναμικό)
entity documents as listed by her
(dynamic)
Πιστωτικό Στοιχ. Λιανικής ημεδαπής /
13.31
αλλοδαπής credit element
retail/non-domestic retail
Αντικριζόμενα Παραστατικά Λήπτη
Domestic/ foreign recipient
receiving documents
Παραστ. Εξαιρ. Οντοτήτων ημεδαπής /
αλλοδαπής Ref excellent
domestic/foreign entities
14.1 Τιμολόγιο / Ενδοκοινοτικές Αποκτήσεις

invoice/intra-community acquisitions
43
myDATA REST API
14.2 Τιμολόγιο / Αποκτήσεις Τρίτων Χωρών
Third country invoice /acquisitions
Τιμολόγιο / Ενδοκοινοτική Λήψη
14.3
Υπηρεσιών invoice/intra-
community receipt of
services
Τιμολόγιο / Λήψη Υπηρεσιών Τρίτων
14.4
Χωρών
invoice/receipt of
third country services
14.5 ΕΦΚΑ EFKA
14.30
Entity documents as listed by her
(dynamic)
14.31 Πιστωτικό ημεδαπής / αλλοδαπής

domestic /foreign credit
Συμβόλαιο - Έξοδο contract-
exit
15.1 Συμβόλαιο - Έξοδο contract-exit
Ειδικό Στοιχείο (Έξοδο) – Απόδειξη

Πληρωμής special
item (expense)-proof
of payment
16.1 Ενοίκιο Έξοδο exit rental
16.30
entity documents as listed by her
(dynamic)
Εγγραφές Τακτοποίησης Εσόδων-
Εξόδων revenue-
expense settlement
records
Εγγραφές Οντότητας entity

records
17.1 Μισθοδοσία payroll
17.2 Αποσβέσεις depreciation
Λοιπές Εγγραφές Τακτοποίησης Εσόδων -

17.3
Λογιστική Βάση other
44
myDATA REST API
revenue settlement records-
accounting base
Λοιπές Εγγραφές Τακτοποίησης Εσόδων -

17.4
Φορολογική Βάση other
revenue settlement records-
tax base
Λοιπές Εγγραφές Τακτοποίησης Εξόδων -
17.5
Λογιστική Βάση other
expense settlement records
-accounting base
Λοιπές Εγγραφές Τακτοποίησης Εξόδων -
17.6
Φορολογική Βάση other
expense settlement records-
tax base
45
myDATA REST API
8.2 Συντελεστές Φ.Π.Α. Vat rates
Κωδικός Περιπτώσεις % Φ.Π.Α. % Φ.Π.Α.

code cases of vat vat%
1 ΦΠΑ συντελεστής 24% 24%

vat rate 24%

vat rate 13%
vat rate 6%

vat rate 17%
vat rate 9%
vat rate 4%
7 Άνευ Φ.Π.Α. without 0%
vat
8.3 Κωδικοί εξαίρεσης από ΦΠΑ vat exemptions codes
Κωδ. Περιγραφή description Κωδ. Περιγραφή description

code code
Χωρίς ΦΠΑ - άρθρο 27.1.γ - Πλοία Ανοικτής Θαλάσσης
1 Χωρίς ΦΠΑ - άρθρο 3 του Κώδικα ΦΠΑ 13 του Κώδικα ΦΠΑ
2 Χωρίς ΦΠΑ - άρθρο 5 του Κώδικα ΦΠΑ 14 Χωρίς ΦΠΑ - άρθρο 28 του Κώδικα ΦΠΑ
4 Χωρίς ΦΠΑ - άρθρο 14 του Κώδικα ΦΠΑ 16 Χωρίς ΦΠΑ - άρθρο 39α του Κώδικα ΦΠΑ
8 Χωρίς ΦΠΑ - άρθρο 24 του Κώδικα ΦΠΑ 20 ΦΠΑ εμπεριεχόμενος - άρθρο 43 του Κώδικα ΦΠΑ
Χωρίς ΦΠΑ - άρθρο 27 - Πλοία Ανοικτής
12 Θαλάσσης του Κώδικα ΦΠΑ
46
myDATA REST API
8.4 Συντελεστές παρακράτησης φόρου tax withholding rates
Κωδικός
Περιπτώσεις % Παρακράτησης - Προκαταβολής Φόρου cases % withholding tax % Παρ. Φόρου
code
advance
Αρ. 64 ν.4172/2013 παρ.1 - Συντελεστές Παρακράτησης Φόρου number 64
ν.4172/2013 par.1- tax withholding rates
1 Περιπτ. β’- Τόκοι - 15% about b-interest -15% 15%
2 Περιπτ. γ’ - Δικαιώματα - 20% about c-rights -20% 20%
3 Περιπτ. δ’ - Αμοιβές Συμβουλών Διοίκησης - 20% about d- management 20%
consulting fees 20%
4 Περιπτ. δ’ - Τεχνικά Έργα - 3% about d-technical works- 3% 3%
Αρ. 64 ν.4172/2013 παρ.2 -
Προμήθειες Αγαθών και Υπηρεσιών Φ.Γ.Κ number .64 ν4172/2013 par 2 ggs
supplies and services supplies
5 Υγρά καύσιμα και προϊόντα καπνοβιομηχανίας 1% liquid fuel and 1%
tobaccoproducts 1%
6 Λοιπά Αγαθά 4% other goods 4% 4%
7 Παροχή Υπηρεσιών 8% service 8% 8%
Αρ. 69 ν.4172/2013 παρ.4 - Προκαταβολή του Φόρου Εισοδήματος από Επιχειρηματική
Δραστηριότητα που αποκτούν Φυσικά Πρόσωπα number. 69
ν.4172/2013 παρ.4 advancement of income tax from business activity
acquired by natural persons
8 Προκαταβλητέος Φόρος Αρχιτεκτόνων και Μηχανικών επί Συμβατικών Αμοιβών,
4%
για Εκπόνηση Μελετών και Σχεδίων 4% prepaid tax on architects and engineers
on contractual fees for design and design 4%
9 Προκαταβλητέος Φόρος Αρχιτεκτόνων και Μηχανικών επί Συμβατικών Αμοιβών, που
10%
αφορούν οποιασδήποτε άλλης φύσης έργα 10% prepaid tax on architects and engineers on
contractual fees apply to any other kind of projects 10%
Αρ. 69 ν.4172/2013 παρ.5 περ. α έως ε - number.69 ν.4172/2013 par.5 per a to
e
10 Προκαταβλητέος Φόρος στις Αμοιβές Δικηγόρων 15% advanced tax on lawyers’ 15%
fees 15%
Αρ. 60 ν.4172/2013 παρ.2 num.60 ν.4172/2013 par 2
11 Παρακράτηση Φόρου Μισθωτών Υπηρεσιών παρ. 2 αρ. 15 ν. 4172/2013 -
15%
Αξιωματικών Εμπορικού Ναυτικού employee tax withholding par.2 number 15
ν.4172/2013
12 Παρακράτηση Φόρου Μισθωτών Υπηρεσιών παρ. 2 αρ. 15 ν. 4172/2013 -
10%
Κατώτερο Πλήρωμα Εμπορικού Ναυτικού employee tax withholding par 2 no. 15
ν.4172/2013
8.5 Συντελεστές λοιπών φόρων
Κωδικός
code Περιπτώσεις % Λοιπών Φόρων cases % other taxes % Λοιπών φόρων
1. Φόρος Ασφαλίστρων premium tax

1 α1) ασφάλιστρα κλάδου πυρός 20% 20% fire insurance premiums 15%
2 α2) ασφάλιστρα κλάδου πυρός 20% 20% fire insurance premiums 5%
3 β) ασφάλιστρα κλάδου ζωής 4% 4% life insurance premiums 4%
4 γ) ασφάλιστρα λοιπών κλάδων 15%. 15% premiums for other 15%
sectors
5 δ) απαλλασσόμενα φόρου ασφαλίστρων 0%. 0% premium tax 0%
exempt
47
myDATA REST API
6 2.Ειδικός Φόρος στις διαφημίσεις που προβάλλονται από την
5%
τηλεόραση (ΕΦΤΔ) 5% special tax on advertisements displayed by
5% television
3. Ειδικός φόρος πολυτελείας εμπορευμάτων χωρών της Ε.Ε. και
εγχωρίως παραγόμενων ειδών (αρθρ. 17 ν. 3833/2010) Excise
tax on goods of Eu countries and domestically produced species
(art.17 ν.3833/2010)
7 3.1 Φόρος πολυτελείας 10% επί της φορολογητέας αξίας για τα
ενδοκοινοτικώςαποκτούμενα και εισαγόμενα από τρίτες χώρες 10% luxury 10%
tax on 10% on the taxable value of intra-community 10% imported and
imported from third countries
8 3.2 Φόρος πολυτελείας 10% επί της τιμής πώλησης προ Φ.Π.Α. για τα
10%
εγχωρίως παραγόμενα είδη 10% luxury tax of 10%
on the sales price before vat for domestically
produced items 10%
9
Δικαίωμα του Δημοσίου στα εισητήρια των καζίνο (80% επί του εισητηρίου) 80%
state’s right to casino tickets (80% on tickets)
48
myDATA REST API
8.6 Συντελεστές Χαρτοσήμου Stamp rates
Κωδικός Περιπτώσεις % Χαρτοσήμων % Χαρτ.

code cases % of stamps
1 Συντελεστής 1,2 % 1,20%
8.7 Συντελεστές τελών charges

Κωδικός Περιπτώσεις % Τελών cases % of charges % Τελών
code
1 1. Τέλος συνδρομητών κινητής τηλεφωνίας και τέλος καρτοκινητής
Τηλεφωνίας mobile subscriber fee and
prepaid fee telephony
2 Για μηνιαίο λογαριασμό μέχρι και 50 ευρώ 12% up to 50 12,00%
euro monthly account 12%
3 Για μηνιαίο λογαριασμό
15,00%
από 50,01 μέχρι και 100 ευρώ 15% for a montly bill from
50,01 to 100 euros 15%
4 Για μηνιαίο λογαριασμό από 100,01 μέχρι και 150 ευρώ 18% 18,00%
for a monthly bill from 100,01 to 150 euros 18%
5 Για μηνιαίο λογαριασμό
20,00%
από 150,01 ευρώ και άνω 20%
for a monthly bill from 150,01
and up 20%
6 Τέλος καρτοκινητής επί της αξίας του χρόνου ομιλίας (12%) 12,00%
fees for airtime 12%
7 2. Τέλος στη συνδρομητική τηλεόραση 10% fees on pay tv 10,00%
8 3. Τέλος συνδρομητών σταθερής τηλεφωνίας 5% 5% fixed 5,00%
telephony subscriber fee
9 4. Εισφορά δακοκτονίας 2% 2% disease 2,00%
contribution
8.8 Χαρακτηρισμοί εσόδων revenue ratings

Χαρακτηρισμός Συναλλαγών
characterization of transactions
1 Έσοδα (+) / (-) income
Κωδ. Περιγραφή description
Έσοδα από Πώληση Εμπορευμάτων
101
(+) / (-) revenue from sale of goods
102 Έσοδα από Πώληση Προϊόντων (+) / (-)
sales revenue
103 Έσοδα από παροχή Υπηρεσιών (+) / (-)
revenue from services
104 Έσοδα από Πώληση Παγίων (+) / (-)
income from sale of assets
105 Λοιπά Έσοδα/ Κέρδη (+) / (-) other
income profit
106 Αυτοπαραδόσεις(+) / (-) self-deliveries
107 Έσοδα για λ/σμο τρίτων (+) / (-) revenue
for third party
49
myDATA REST API
108 Έσοδα προηγούμενων χρήσεων (+)/ (-)
previous year income
109 Έσοδα επομένων χρήσεων (+) / (-)
subsequent income
Λοιπές Εγγραφές Τακτοποίησης Εσόδων
110
(+) / (-) other revenue settlement
records
50
myDATA REST API
8.9 Χαρακτηρισμοί εξόδων output characteristics
Χαρακτηρισμός Συναλλαγών characterization of

transactions
2 Έξοδα (-) / (+) expenses
Κωδ. Περιγραφή description
201 Αγορές Εμπορευμάτων (-) / (+) commodity markets
202 Αγορές Α'-Β' Υλών (-) / (+) purchases of A’-B’
materials
203 Λήψη Υπηρεσιών (-) / (+) download services
204 Γενικά Έξοδα με δικαιωμα εκπτωσης ΦΠΑ (-) / (+)
general expenses with vat deduction
205 Γενικά Έξοδα χωρίς δικαιωμαεκπτωσης ΦΠΑ (-) / (+)
general expenses without vat deduction
Αμοιβές και Παροχές προσωπικού
206
(-) / (+) remuneration and staff benefits
207 Αγορές Παγίων (-) / (+) purchase of fixed asset
208 Αποσβέσεις Παγίων (-) / (+) depreciation of assets
209 Έξοδα για λ/σμο τρίτων (-) / (+) expenses for third
party
Έξοδα προηγούμενων χρήσεων
210
(-) / (+) previous
year expenses
211 Έξοδα επομένων χρήσεων (-) / (+) post-use expenses
Λοιπές Εγγραφές Τακτοποίησης Εξόδων
212
(-) / (+) other expense settlement record
8.10 Μονάδες Μέτρησης units of measurement
Κωδικός Περιγραφή description

code
1 Τεμάχια pieces
2 Κιλά kg
3 Λίτρα liter
8.11 Επισημάνσεις highlights
Κωδικός Περιγραφή description

code
1 Εκκαθάριση Πωλήσεων Τρίτων
clearance of third party sales
2 Αμοιβή από Πωλήσεις Τρίτων
51
myDATA REST API
remuneration of third party
sales
52
myDATA REST API

AADE Mydata Api Documentation v0.5

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

AADE Mydata Api Documentation v0.5

Uploaded by

Copyright:

Available Formats

myDATA

Ηλεκτρονικά Βιβλία ΑΑΔΕ

Έκδοση 0.5 – Αύγουστος 2019

myDATA, δηλαδή my Digital Accounting and Tax Application.

Τα Ηλεκτρονικά Βιβλία ΑΑΔΕ αποτελούν ένα πολύ σημαντικό βήμα ψηφιακού

My data, ie my digital accounting and tax application

 Αποστολή δεδομένων για τα παραστατικά που εκδίδει.

 Αποστολή χαρακτηρισμών εσόδων που αφορούν τα παραστατικά που εκδίδει.

 Αποστολή δεδομένων χαρακτηρισμών εξόδων στην ΑΑΔΕ.

Στο παρόν έγγραφο περιγράφονται οι παραπάνω λειτουργίες, καθώς και οι αναγκαίες

 Sending data on the documents issued

 Sending income ratings related to the documents it issues

 Send expense rating data to AADE

4 Περιγραφή του RESTAPI Description of RESTAPI

Συνοπτικά, η διεπαφή παρέχει τις εξής λειτουργίες-μεθόδους:

 /sendInvoices: διαδικασία υποβολής ενός ή περισσότερων παραστατικών,

Summary, the interface provides the following functions-methods:

4.1 Portal για Προγραμματιστές Portal for programmers

Επίσης, παρέχεται ειδικό portal για προγραμματιστές στο URL:https://mydata-

Τέλος, για θέματα λειτουργικότητας, προβλημάτων ή προτάσεων βελτίωσης, υπάρχει η

Also, it is provided specific portal for developers at url: L:https://mydata- dev.portal.azure-

4.2 Περιγραφή λειτουργίας της διεπαφής Description of interface operation

4.2.1 Εγγραφή χρήστη User registration

Για να αποκτήσει ένας χρήστης τα παραπάνω διαπιστευτήρια-credentials,πρέπει να

 Επιθυμητό Όνομα Χρήστη (username)

Σε περίπτωση επιτυχημένης εγγραφής, δημιουργείται o χρήστης στο σχετικό μητρώο του

4.2.2 Χρήση υπηρεσιών Use of services

Η κλήση πρέπει να εμπεριέχει την κατάλληλη κεφαλίδα (header) η οποία θα περιέχει

Στις υπηρεσίες υποβολής, ο χρήστης μπορεί να στείλει ένα ή πολλά αντικείμενα,

4.2.3 Απαραίτητα Headers Necessary headers

Κάθε κλήση πρέπει να περιέχει με τη μορφή ζευγαριών-τιμών, τα παρακάτω headers,τα

KEY Data Type VALUE DESCRIPTION

Η κλήση έχει τα ακόλουθα χαρακτηριστικά:

 /sendInvoices, μέθοδος POST

 Έχει headers όπως αναφέρεται στην παράγραφο 4.2.3

 Body που το περιεχόμενο του είναι xml και περιγράφεται από το

The call has the following characteristics:

Η κλήση έχει τα ακόλουθα χαρακτηριστικά:

 /sendIncomeClassification, μέθοδος POST

 Έχει headersόπως αναφέρεται στην παράγραφο 4.2.3

The call has the following characteristics:

 /sendIncomeClassification, method POST

 It has header as referred to the par. 4.2.3

Η δομή του αιτήματος για αποστολή παραστατικών περιγράφεται από το

Πεδίο field Τύπος type Υποχρεωτικό Περιγραφή description Αποδεκτές τιμές

Όνομα name Τύπος type Υποχρεωτικό Περιγραφή description

Παρατήρηση:Το continuationToken λαμβάνεται σε περίπτωση που τα αποτελέσματα

Αυτή η ενότητα περιγράφει αναλυτικά το περιεχόμενο του παραστατικού (τύπου

AadeBookInvoiceType contains the document information and is structured as follow:

Πεδίο field Τύπος type Υποχρεωτικό Περιγραφή description Αποδεκτές τιμές

Οι σύνθετοι τύποι PartyType, InvoiceHeaderParty, InvoiceRowParty, InvoiceSummaryParty

1) Το uid αποτελεί το αναγνωριστικό κάθε παραστατικού και συμπληρώνεται από την

2) Το mark αποτελεί τον Μοναδικό Αριθμό Καταχώρησης του παραστατικού (Μ.ΑΡ.Κ).

5.1 Στοιχεία οντότητας Entity elements

Ο εκδότης και ο λήπτης του παραστατικού είναι elements τύπου PartyType.

The publisher and recipient of document are elements type PartyType

Πεδίο field Τύπος type Υποχρεωτικό Περιγραφή Αποδεκτές τιμές acceptable

Πεδίο field Τύπος Υποχρεωτικό Περιγραφή

Πεδίο field Τύπος type Υποχρεωτικό Περιγραφή description Αποδεκτές τιμές

1) To πεδίο exchangeRate είναι η ισοτιμία του νομίσματος σε σχέση με το ευρώ.

Τα στοιχεία του παραστατικού (invoiceDetails) αποτελούνται από μία ή περισσότερες

Invoice details are composed of one or more invoicerowtype.

1) Οι πιθανές τιμές για τα πεδία vatCategory, vatExemptionCategory,