Το παρόν έγγραφο περιγράφει τις παραπάνω υπηρεσίες και τις τεχνικές προδιαγραφές που είναι απαραίτητες για την υλοποίηση των σχετικών κλήσεων της διεπαφής RESTAPI.

Συγκεκριμένα, για μια επιχείρηση που χρησιμοποιεί σύστημα πληροφοριών που χρησιμοποιεί το σχετικό API, οι δυνατότητες που προσφέρονται είναι:

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

Οι ακόλουθες τεχνολογίες χρησιμοποιούνται για τη δημιουργία σύνδεσης με τη διεπαφή.

HTTPS – Secure HTTP
Web Service
REST API – REST διεπαφή που απαιτείται για τη διαδικασία αναφοράς δεδομένων.
XML – eXtensible Markup Language

Η διεπαφή είναι προσβάσιμη σε οποιοδήποτε πρόγραμμα τιμολόγησης ικανό να στείλει μηνύματα HTTP και να δημιουργήσει XML συμβατό με σχήμα, όπως καθορίζεται στην παρούσα προδιαγραφή.

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

2. Επισκόπηση ενσωμάτωσης

Απαιτήσεις

Όλα τα αρχεία XML πρέπει να είναι καλά διαμορφωμένα, να τηρούν το σχήμα (XSD) και να είναι κωδικοποιημένα σε UTF-8.
Να είναι ασφαλής με χρήση ελέγχου ταυτότητας που περιγράφεται στο επόμενο κεφάλαιο.

Διαδικασία Πιστοποίησης

Δημιούργησε ένα λογαριασμό στο site https://api.sbz.gr και επικοινώνησε με το τεχνικό μας τμήμα στο email support@sbzsystems.com για να ενεργοποιήσουμε το δοκιμαστικό λογαριασμό σου.
Δοκίμασε και ανάπτυξε το API μας.
Έλεγξε και βεβαιώσου ότι δεν λαμβάνεις σφάλματα. Η δοκιμή για αυτό το API αποτελείται από αυτοδιαγνωστικούς ελέγχους που πραγματοποιούνται χρησιμοποιώντας τον δοκιμαστικό λογαριασμό σε περιβάλλον sandbox.
Δοκιμή ενσωμάτωσης. Όταν είσαι έτοιμος για δοκιμή, επικοινώνησε με το τεχνικό τμήμα της SBZ systems και τον τεχνικό που έχει ανατεθεί στον λογαριασμό σου για καθοδήγηση στο περιβάλλον δοκιμών.
Όταν όλα είναι εντάξει και οι ρυθμίσεις είναι έτοιμες, θα ενεργοποιήσουμε το παραγωγικό API-KEY που βρίσκεται στις ρυθμίσεις του διαχειριστικού μας.
Θα πρέπει να εξουσιοδοτήσεις την εταιρία μας στο TAXISNET. Ακολούθησε τις οδηγίες που βρίσκονται στα αρχεία SBZ_User_Contract.pdf και SBZ_Provider_Request.pdf.

Μετά την έναρξη

Θα πρέπει να συνεχίσεις να τηρείς τους Όρους και τις Προϋποθέσεις μας.
Θα πρέπει να παρακολουθείς τη σύνδεσή σου στο API για τυχόν προειδοποιήσεις ή σφάλματα
Θα πρέπει να αναφέρεις τυχόν προειδοποιήσεις ή σφάλματα που έλαβες σε οποιαδήποτε απάντηση και τον τρόπο επίλυσής τους.

3. Πιστοποίηση

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

Απαιτούνται οι παρακάτω κεφαλίδες:

Κλειδί	Τύπος δεδομένων	Αξία	Απαιτείται	Περιγραφή
API-KEY	String	{API-KEY}	YES	Το API_KEY του sandbox ή του λογαριασμού παραγωγής σας
Content-Type	String	application/xml; charset=utf-8	YES

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

Λάβε υπόψη ότι κάθε κλήση σε νέο αριθμό ΦΠΑ πρέπει πρώτα να έχει εξουσιοδοτηθεί από την πλευρά μας.

4. Υπηρεσίες API

4.1 SendInvoice

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

/sendInvoice.php (POST)
Κύριο μέρος σε μορφή xml που περιέχει το στοιχείο InvoicesDoc, το οποίο περιέχει ένα ή περισσότερα παραστατικά. Η δομή του στοιχείου InvoicesDoc περιγράφεται ανά τύπο AadeBookInvoiceType

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
issuerVat	xs:long	Ναι	ΑΦΜ οντότητας
invoiceMark	xs:string	Οχι	Μοναδικός Αριθμός Καταχώρησης
IssueDate	xs:string	Οχι	Ημερομηνία έκδοσης παραστατικού
issuedFrom	xs:string	Οχι	Έκδοση παραστατικού Εύρος ημερομηνιών από
issuedTo	xs:string	Οχι	Έκδοση παραστατικού Εύρος ημερομηνιών έως
urlType	xs:string	Οχι	Επιστρέφει ένα σύνδεσμο που οδηγεί στο παραστατικό
NextPageKey	xs:string	Οχι	Στοιχείο για μερική ανάκτηση αποτελεσμάτων Εάν επιστραφεί ένα nextPageKey, τότε εκτελέστε αυτό το url από την υπηρεσία για να λάβετε τα επόμενα 100 αποτελέσματα εάν υπάρχουν

Καταληκτικά σημεία

Περιβάλλον παραγωγής

https://api.sbz.gr/sign/sendinvoice.php?action=production

Περιβάλλον Sandbox

https://api.sbz.gr/sign/sendinvoice.php?action=sandbox

4.2 RequestTransmittedDocs

Με αυτήν τη μέθοδο μπορείτε να ανακτήσετε παραστατικά που έχουν υποβληθεί στο myData.

Η ανάκτηση γίνεται μέσω κλήσης HTTP (GET). Η μέθοδος επιστρέφει τα παραστατικά που έχουν τον ΑΦΜ εκδότη της καθορισμένης παραμέτρου.

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
issuerVat	xs:long	Ναι	ΑΦΜ οντότητας
invoiceMark	xs:string	Οχι	Μοναδικός Αριθμός Καταχώρησης
issuedDate	xs:string	Οχι	Ημερομηνία έκδοσης παραστατικού
issuedFrom	xs:string	Οχι	Έκδοση παραστατικού Εύρος ημερομηνιών από
issuedTo	xs:string	Οχι	Έκδοση παραστατικού Εύρος ημερομηνιών έως
urlType	xs:string	Οχι	Επιστρέφει ένα σύνδεσμο που οδηγεί στο παραστατικό
NextPageKey	xs:string	Οχι	Στοιχείο για μερική ανάκτηση αποτελεσμάτων Εάν επιστραφεί ένα nextPageKey, τότε εκτελέστε αυτό το url από την υπηρεσία για να λάβετε τα επόμενα 100 αποτελέσματα εάν υπάρχουν

Σημείωση: Εάν τα αποτελέσματα υπερβαίνουν το μέγιστο όριο των 100, επιστρέφονται με προσαυξήσεις.

Παρατηρήσεις:

Στην περίπτωση που τα αποτελέσματα αναζήτησης ξεπερνούν σε μέγεθος το μέγιστο επιτρεπτό όριο ο χρήστης θα τα λάβει τμηματικά. Τα πεδία nextPartitionKey και nextRowKey θα εμπεριέχονται σε κάθε τμήμα των αποτελεσμάτων και θα χρησιμοποιούνται ως παράμετροι στην κλήση για την λήψη του επόμενου τμήματος αποτελεσμάτων
Σε περίπτωση που κάποια εκ των παραπάνω παραμέτρων δεν έχει τιμή, η αναζήτηση πραγματοποιείται για όλες τις πιθανές τιμές αυτού του πεδίου, όπως προηγουμένως
Σε περίπτωση που μόνο μια εκ των dateFrom, dateTo παραληφθεί, η αναζήτηση θα εκτελεστεί μόνο για την ημερομηνία που έχει δοθεί στην άλλη παράμετρο. Αν και οι παράμετροι έχουν τιμή, η αναζήτηση θα εκτελεστεί για το διάστημα από dateFrom έως dateTo.
Εφόσον αποδοθεί τιμή στην παράμετρο maxMark, θα επιστραφούν όσες εγγραφές έχουν ΜΑΡΚ μικρότερο ή ίσο αυτή της τιμής
Οι τιμές των παραμέτρων receiverVatNumber και invType εφαρμόζονται πάντα με τον συντελεστή ισότητας (equal operator)
Στην παράμετρο invType δίνεται ως τιμή ο αριθμός που αντιστοιχεί στον συγκεκριμένο τύπο σύμφωνα με τον πίνακα 8.1 του Παραρτήματος

Καταληκτικά σημεία

Περιβάλλον παραγωγής

https://api.sbz.gr/sign/requesttransmitteddocs.php?issuerVAT={issuerVat}&action=production

Περιβάλλον Sandbox

https://api.sbz.gr/sign/requesttransmitteddocs.php?issuerVAT={issuerVat}&action=sandbox

4.3 PaymentSignature

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

/paymentsignature.php (POST)
Κύριο μέρος σε μορφή xml που περιέχει το στοιχείο ERPpayment, το οποίο περιέχει μια αίτηση υπογραφής πληρωμής για χρήση με τερματικό καρτών POS.

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
issuerVat	xs:long	Ναι	ΑΦΜ οντότητας
issueDate	xs:date	Ναι	Ημερομηνία έκδοσης παραστατικού
branch	xs:int	Ναι	Αριθμός υποκαταστήματος
invoiceType	xs:string	Ναι	Τύπος παραστατικού. Οι πιθανές τιμές είναι περιγράφεται στο Παράρτημα. Τα παραστατικά 8.5, 11.4, 5.1, 5.2 στέλνουν στο τερματικό κίνηση refund. Το παραστατικό 8.4 προ φόρτωση εκτός αν ορισθεί η preload
InitialTransaction	xs:string	Οχι	Υποχρεωτικό μόνο σε περίπτωση επιστροφής χρημάτων
series	xs:string	Ναι	Σειρά παραστατικού. Σε περίπτωση μη έκδοσης σειράς παραστατικού, το πεδίο σειράς πρέπει να έχει τιμή 0. Δεν πρέπει να περιέχει το χαρακτήρα “-”
aa	xs:string	Ναι	Αύξων αριθμός παραστατικού. Πρέπει να είναι μοναδικός ανά είδος παραστατικού 8.1
invoicemark	xs:long	Οχι	Μοναδικός Αριθμός Καταχώρησης
amount	xs:decimal	Ναι	Ποσό πληρωμής
totalNetValue	xs:decimal	Ναι	Συνολική καθαρή αξία
totalVatAmount	xs:decimal	Ναι	Συνολικό ποσό ΦΠΑ
totalGrossValue	xs:decimal	Ναι	Συνολική ακαθάριστη αξία
terminalid	xs:string	Ναι	Ψευδώνυμο μέσου πληρωμών όπως έχει ορισθεί στο api.sbz.gr
tipAmount	xs:decimal	Οχι	Αξία φιλοδωρήματος. Για μη ορισμό βάζουμε 0
instalments	xs:int	Οχι	Αριθμός δόσεων. Για μη ορισμό βάζουμε 0
preload	xs:int	Οχι	Προ φόρτωση συναλλαγής. Εμφανίζουμε τη γραμμή με τιμή 1 μόνο όταν χρειάζεται.

Απάντηση

Πεδίο	Τύπος	Περιγραφή
SigningAuthor	xs:long	Κωδικός παρόχου ηλεκτρονικής τιμολόγησης
Signature	xs:date	Υπογραφή Πληρωμής Παρόχου Υπηρεσιών Ηλεκτρονικής Έκδοσης Στοιχείων ΥΠΑΗΕΣ
Uid	xs:int	Αναγνωριστικό παραστατικού
Timestamp	xs:int	Η ώρα σε μορφή Y-m-d\TH:i:s
statusCode	xs:string	Αποτέλεσμα κλήσης μετά από έλεγχο της υπογραφής. Signature is valid αν είναι έγκυρη
Comments	xs:string	Σχόλια
pos_transactionId	xs:string	Μοναδικός αριθμός πληρωμής από τερματικό
pos_answer	xs:string	Τιμές που επιστρέφονται preloaded, success, failed
pos_transactionText	xs:string	Δεν επιστρέφεται από όλα τα τερματικά και έχει καθαρά ενημερωτικό σκοπό. Ένας πρόσθετος μοναδικός αριθμός από τερματικό, εάν υφίσταται.
pos_TerminalID	xs:string	Μοναδικός κωδικός τερματικού

Παρατηρήσεις:

Η διαφοροποίηση ταυτόχρονων και ετεροχρονισμένων συναλλαγών έγκειται στη χρήση ή μη της SendPayments
Για ετεροχρονισμένες συναλλαγές χρησιμοποιείται η SendPayments αφού γίνει κλήση πρώτα στην PaymentSignature
Για ταυτόχρονες συναλλαγές χρησιμοποιείται η SendInvoice αφού γίνει κλήση πρώτα στην PaymentSignature
Ο ΑΦΜ αναφοράς αποστέλλεται μέσω του πεδίου entityVatNumber

Καταληκτικά σημεία

Περιβάλλον παραγωγής

https://api.sbz.gr/sign/paymentsignature.php?action=production

Περιβάλλον Sandbox

https://api.sbz.gr/sign/paymentsignature.php?action=sandbox

4.4 SendPayments

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

/sendpayments.php (POST)
Headers όπως αναφέρεται στην παράγραφο: 4.1.2
Κύριο μέρος σε μορφή xml που αποτελείται από ένα ή περισσότερα στοιχεία PaymentMethodType. Ο τύπος περιγράφεται από το παρακάτω διάγραμμα

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
invoiceMark	xs:long	Ναι	Μοναδικός Αριθμός Καταχώρησης Παραστατικού
paymentMethodMark	xs:long	Όχι	Μοναδικός Αριθμός Καταχώρησης Τρόπου Πληρωμής
entityVatNumber	xs: string	Όχι	ΑΦΜ Οντότητας Αναφοράς
paymentMethodDetails	PaymentMethodDetailType	Ναι	Τρόποι Πληρωμής

Παρατηρήσεις:

Το πεδίο paymentMethodMark συμπληρώνεται από την υπηρεσία
Ο ΑΦΜ αναφοράς αποστέλλεται μέσω του πεδίου entityVatNumber,
Το αντικείμενο PaymentMethodDetailType αναλύεται λεπτομερώς στην παράγραφο 5.2
Κατά την χρήση της μεθόδου, τουλάχιστον ένα αντικείμενο PaymentMethodDetailType ανά παραστατικό πρέπει να είναι τύπου POS
Το σύνολο των ποσών amount ανά αντικείμενο PaymentMethodDetailType πρέπει να ισούται με το totalGrossValue του παραστατικού στο οποίο αντιστοιχεί το invoiceMark

Καταληκτικά σημεία

Περιβάλλον παραγωγής

https://api.sbz.gr/sign/sendpayments .php?action=production

Περιβάλλον Sandbox

https://api.sbz.gr/sign/sendpayments .php?action=sandbox

5. Περιγραφή InvoiceDoc

Αυτή η ενότητα περιγράφει αναλυτικά τα περιεχόμενα ενός παραστατικού (τύπος AadeBookInvoiceType). Η δομή του στοιχείου έχει ως εξής:

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή	Έγκυρες τιμές
uid	xs:string	Οχι	Αναγνωριστικό παραστατικού	Μήκος = 40 Συμπληρώνεται μόνο από τον πάροχο
mark	xs:long	Οχι	Μοναδικός Αριθμός Καταχώρησης παραστατικού	Συμπληρώνεται μόνο από τον πάροχο. Μοναδικός Αριθμός Καταχώρησης παραστατικού
cancelledByMark	xs:long	Οχι	Μοναδικός Αριθμός Ακύρωσης παραστατικού	Συμπληρώνεται μόνο από τον πάροχο
authenticationCode	xs:string	Οχι	Κωδικός ελέγχου ταυτότητας	Συμπληρώνεται μόνο από τον πάροχο
issuer	PartyType	Οχι	Εκδότης παραστατικού
counterpart	PartyType	Οχι	Αντίστοιχο παραστατικό
invoiceHeader	InvoiceHeaderType	Ναι	Επικεφαλίδα παραστατικού
paymentMethods	PaymentMethodDetailType	Οχι	μέθοδοι πληρωμής
invoiceDetails	InvoiceRowType	Ναι	Γραμμές παραστατικού
taxesTotals	TaxesType	Οχι	Συνολικοί φόροι	Περιέχει όλους τους φόρους εκτός από τον ΦΠΑ. Εάν ο χρήστης χρησιμοποιεί αυτό το στοιχείο, οι φόροι δεν θα υπάρχουν στα invoiceDetails
invoiceSummary	InvoiceSummaryType	Ναι	Περίληψη παραστατικού
API_InvoiceDetails	API_InvoiceDetailsType	Ναι	Στοιχεία παραστατικού

Παρατηρήσεις

Οι σύνθετοι τύποι PartyType, PaymentMethodDetailType, InvoiceHeaderType, InvoiceRowType, TaxTotalsType, InvoiceSummaryType και API_InvoiceDetailsType περιγράφονται παρακάτω σε αυτήν την ενότητα.

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

Ο εκδότης και ο αντισυμβαλλόμενος είναι στοιχεία τύπου PartyType.

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή	Έγκυρες τιμές
vatNumber	xs:string	Ναι	ΑΦΜ	Οποιοσδήποτε έγκυρος ΑΦΜ
Country	xs:string	Ναι	Κωδικός χώρας	Κωδικοί χωρών (ISO 3166)
branch	xs:int	Ναι	Αριθμός υποκαταστήματος	Ελάχιστη τιμή = 0 Εάν το υποκατάστημα είναι έδρα ή δεν υπάρχει, το πεδίο υποκαταστήματος πρέπει να έχει τιμή 0.
Name	xs:string	Οχι	Ονομα
Address	AddressType	Οχι	Διεύθυνση
documentIdNo	xs:string	Οχι	Επίσημος αριθμός παραστατικού	Μέγιστο 100 χαρακτήρες Ισχύει μόνο σε περίπτωση παραστατικού χωρίς φόρους tax free (ειδική κατηγορία παραστατικών = 4)
supplyAccountNo	xs:string	Οχι	Αριθμός Παροχής Ηλεκτρικής Ενέργειας	Μέγιστο 100 χαρακτήρες Ισχύει μόνο για έγγραφα καυσίμων

Παρατηρήσεις

Για τα πεδία του εκδότη το όνομα και η διεύθυνση ισχύουν μόνο σε περίπτωση που δεν είναι από την Ελλάδα. Για το αντίστοιχο πεδίο το όνομα δεν πρέπει να υποβάλλεται εάν η οντότητα είναι από την Ελλάδα.
Ο κωδικός της χώρας είναι δύο χαρακτήρες και προέρχεται από την αντίστοιχη λίστα χωρών όπως περιγράφεται στο ISO 3166.
Σε περίπτωση που η εγκατάσταση του εκδότη είναι η έδρα ή δεν υφίσταται, το πεδίο branch πρέπει να έχει την τιμή 0
Για τον εκδότη, τα στοιχεία Επωνυμία και Διεύθυνση δεν γίνονται αποδεκτά στην περίπτωση που αφορούν οντότητα εντός Ελλάδας (GR). Για τον λήπτη, το στοιχείο Επωνυμία δεν γίνονται αποδεκτό στην περίπτωση που αφορά οντότητα εντός Ελλάδας (GR)
Ο αριθμός επίσημου εγγράφου, είναι επιτρεπτός μόνο στην περίπτωση διαβίβασης παραστατικών που ανήκουν στην Ειδική Κατηγορία Παραστατικού Tax free (το πεδίο της επικεφαλίδας του παραστατικού specialInvoiceCategory έχει την τιμή 4), και μπορεί να είναι οποιοδήποτε επίσημο έγγραφο ταυτοποίησης (π.χ αριθμός διαβατηρίου) του λήπτη του παραστατικού.
Ο αριθμός Παροχής Ηλ. Ρεύματος, είναι επιτρεπτός μόνο στην περίπτωση διαβίβασης παραστατικών καυσίμων (το πεδίο της επικεφαλίδας του παραστατικού fuelInvoice έχει την τιμή true – αποδεκτό μόνο για διαβίβαση από παρόχους) και είναι πληροφορία του λήπτη του παραστατικού.
Ο κωδικός χώρας έκδοσης του επίσημου εγγράφου (π.χ διαβατηρίου), είναι επιτρεπτός μόνο στην περίπτωση διαβίβασης παραστατικών που ανήκουν στην Ειδική Κατηγορία Παραστατικού Tax free (το πεδίο της επικεφαλίδας του παραστατικού specialInvoiceCategory έχει την τιμή 4) και εφόσον έχει συμπληρωθεί το πεδίο αριθμός επίσημου εγγράφου (documentIdNo) και αφορά τον λήπτη του παραστατικού.

5.1.1 Διεύθυνση

Η διεύθυνση του εκδότη και του αντισυμβαλλομένου είναι στοιχεία τύπου AddressType.

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
Street	xs:string	Οχι	Δρόμος
number	xs:string	Οχι	Αριθμός
postalCode	xs:string	Ναι	Ταχυδρομικός Κώδικας
City	xs:string	Ναι	Πόλη

5.2 Μέθοδος πληρωμής

Ο τρόπος πληρωμής είναι στοιχείο τύπου PaymentMethodDetailType και η δομή του περιγράφεται παρακάτω:

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή	Έγκυρες τιμές
type	xs:int	Ναι	Τύπος Πληρωμής	Ελάχιστη = 1 Μέγιστη= 9 Οι πιθανές τιμές του πεδίου περιγράφονται στο προσάρτημα
amount	xs:decimal	Ναι	Ποσό Πληρωμής	Ελάχιστη = 0 Δεκαδικά = 2 Το ποσό του πεδίου μπορεί να αναφέρεται σε ένα μέρος της αξίας του τιμολογίου
paymentMethodInfo	xs:string	Όχι	Πληροφορίες	Η paymentMethodInfo περιέχει επιπλέον πληροφορίες για τον καθορισμένο τύπο
transactionId	xs:string	Όχι	Αριθμός συναλλαγής από τερματικό POS	Διαβιβάζεται στην περίπτωση πληρωμών με type = 7
tid	xs:string	Όχι	TID τερματικού POS	Διαβιβάζεται στην περίπτωση πληρωμών με type = 7

Παρατηρήσεις

Οι τιμές του πεδίου type περιγράφονται σε αντίστοιχο πίνακα του παραρτήματος
Το πεδίο amount μπορεί να αντιστοιχεί σε ένα τμήμα της συνολικής αξίας του παραστατικού
Το πεδίο Πληροφορίες μπορεί να περιέχει επιπλέον πληροφορίες σχετικά με τον συγκεκριμένο τύπο (πχ Αρ. Λογαριασμού Τραπέζης)
Το πεδίο ProvidersSignature είναι τύπου ProviderSignatureType, ο οποίος τύπος περιγράφεται παρακάτω, και διαβιβάζεται στην περίπτωση πληρωμών με type = 7 και όταν η διαβίβαση γίνεται από το κανάλι του παρόχου

5.2.1 Υπογραφή Πληρωμής Παρόχου

Το πεδίο ProvidersSignature είναι στοιχείο τύπου ProviderSignatureType και η δομή του περιγράφεται παρακάτω:

Πεδίο

Τύπος

Υποχρεωτικό

Περιγραφή

SigningAuthor

xs:string

Ναι

Αριθμός Απόφασης έγκρισης ΥΠΑΗΕΣ

Παρόχου

Signature

xs:string

Ναι

Υπογραφή

5.3 Επικεφαλίδα παραστατικού

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή	Έγκυρες τιμές
Series	xs:string	Ναι	Σειρά παραστατικού	Σε περίπτωση μη έκδοσης σειράς παραστατικού, Το πεδίο σειράς πρέπει να έχει τιμή 0 Δεν πρέπει να περιέχει το χαρακτήρα “-”
Aa	xs:string	Ναι	αύξων αριθμός παραστατικού	Μέγιστα ψηφία = 5
issueDate	xs:date	Ναι	Ημερομηνία έκδοσης παραστατικού
invoiceType	xs:string	Ναι	Τύπος παραστατικού	Οι πιθανές τιμές είναι περιγράφεται στο Παράρτημα
vatPaymentSuspension	xs:boolean	Οχι	Αναστολή πληρωμήςΦΠΑ
currency	xs:string	Οχι	Νόμισμα	Κωδικός νομίσματος (ISO4217)
exchangeRate	xs:decimal	Οχι	Συναλλαγματική ισοτιμία	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 5 Η συναλλαγματική ισοτιμία έναντι του ευρώ. Θα πρέπει να συμπληρώνεται μόνο όταν το νόμισμα δεν είναι EUR.
correlatedInvoices	xs:long	Οχι	Συσχετισμένα παραστατικά	Το στοιχείο είναι μια λίστα συμβολοσειρών που περιέχει το MARK των συσχετισμένων παραστατικών αναγνωριστικά
correlatedInvoicesLabel	xs:string	Οχι	Συσχετισμένα παραστατικά Ονόματα	Απαιτείται μόνο όταν χρησιμοποιείτε συσχετισμένα παραστατικά. Το στοιχείο είναι ένα πεδίο κειμένου που περιέχει το Φιλικό Όνομα των σχετικών παραστατικών
selfPricing	xs:boolean	Οχι	Ένδειξη αυτοτιμολόγησης
dispatchDate	xs:date	Οχι	Ημερομηνία αποστολής
dispatchTime	xs:time	Οχι	χρόνος αποστολής
vehicleNumber	xs:string	Οχι	Αριθμός οχήματος
movePurpose	xs:int	Οχι	Σκοπός κίνησης	Ελάχιστη τιμή = 1 Μέγιστη τιμή = 8 Τιμές που περιγράφονται στο Παράρτημα
movePurposeLabel	xs:string	Οχι	Σκοπός του Περιγραφή κίνησης
fuelInvoice	xs:boolean	Οχι	Έγγραφο καυσίμων (ένδειξη)
specialInvoiceCategory	xs:int	Οχι	Ειδική Κατηγορία Εγγράφων	Ελάχιστη τιμή = 1 Μέγιστη τιμή = 4 περιγράφεται στον Πίνακα 8.19
isDeliveryNote	xs:boolean	Οχι	Ένδειξη Παραστατικού Διακίνησης
multipleConnectedMarks		Οχι	Πολλαπλά Συνδεόμενα MARKs
tableAA		Ναι	ΑΑ Τραπεζιού	Αποδεκτό μόνο για παραστατικό τύπου 8.6 – Μέγιστο επιτρεπτό μήκος 50
totalCancelDeliveryOrders	xs:boolean	Οχι	Ένδειξη συνολικής αναίρεσης Δελτίων Παραγελίας	Αποδεκτό μόνο για παραστατικό τύπου 8.6

Παρατηρήσεις

To πεδίο exchangeRate είναι η ισοτιμία του νομίσματος σε σχέση με το ευρώ. Πρέπει να συμπληρώνεται μόνο όταν το νόμισμα δεν έχει τιμή EUR.
Ο κωδικός νομισμάτων προέρχεται από την αντίστοιχη λίστα σύμφωνα με το πρότυπο ISO4217.
Το στοιχείο correlatedInvoices είναι λίστα και περιέχει τα ΜΑΡΚ των συσχετιζόμενων παραστατικών
Σε περίπτωση μη έκδοσης σειράς παραστατικού, το πεδίο series πρέπει να έχει την τιμή 0
Το πεδίο selfPricing ορίζει αν πρόκειται για παραστατικό Αυτοτιμολόγησης
Οι πιθανές τιμές των πεδίων movePurpose και invoiceType περιγράφονται αναλυτικά στους αντίστοιχους πίνακες του Παραρτήματος
Το πεδίο fuelInvoice ορίζει αν πρόκειται για παραστατικό πώλησης υγρών καυσίμων καυσίμων και επιτρέπεται η αποστολή μόνο για την περίπτωση των παρόχων.
Οι πιθανές τιμές του πεδίου specialInvoiceCategory περιγράφονται αναλυτικά στον αντίστοιχα πίνακα του Παραρτήματος
Οι πιθανές τιμές του πεδίου invoiceVariationType περιγράφονται αναλυτικά στον αντίστοιχα πίνακα του Παραρτήματος. Επίσης λεπτομέρειες σχετικά με τον τρόπο χρήσης τους από επιχειρησιακής σκοπιάς περιγράφονται στο σχετικό επιχειρησιακό έγγραφο.
Το πεδίο otherCorrelatedEntities (Λοιπές συσχετιζόμενες οντοτήτες) είναι λίστα τύπου EntityType
Η δομή του τύπου otherCorrelatedEntities περιγράφεται στη συνέχεια
Η δομή του τύπου otherDeliveryNoteHeader περιγράφεται στη συνέχεια
Το πεδίο isDeliveryNote ορίζει αν πρόκειται για παραστατικό που είναι και δελτίο αποστολής (π.χ το παραστατικό τύπου 1.1 – Τιμολόγιο Πώλησης, εφόσον φέρει την ένδειξη isDeliveryNote = true, τότε είναι και δελτίο διακίνησης και θα πρέπει να αποσταλούν και επιπλέον στοιχεία διακίνησης)
Το πεδίο otherMovePurposeTitle συμπληρώνεται όταν έχει επιλεγεί ως movePurpose = 19 (Λοιπές Διακινήσεις) και ορίζει τον τίτλο της άλλης διακίνησης
Το πεδίο thirdPartyCollection ορίζει αν η επιχείρηση που κάνει χρήση Μέσων Πληρωμών ως Χρήστης υπηρεσιών πληρωμών και εισπράττει για λογαριασμό τρίτων (περίπτωση παραστατικού 8.4 – Απόδειξη Είσπραξης POS) ή αν επιστρέφει ποσά συναλλαγής για λογαριασμό τρίτων (περίπτωση παραστατικού 8.5 – Απόδειξη Επιστροφής POS)

5.3.1 Λοιπά Γενικά Στοιχεία Διακίνησης

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή	Αποδεκτές τιμές
loadingAddress	AddressType	Ναι	Διεύθυνση Φόρτωσης	Συμπληρώνεται για παραστατικά που είναι δελτία αποστολής (π.χ 9.3) ή τιμολόγιο και δελτίο αποστολής (isDeliveryNote = true)
deliveryAddress	AddressType	Ναι	Διεύθυνση Παράδοσης	Συμπληρώνεται για παραστατικά που είναι δελτία αποστολής (π.χ 9.3) ή τιμολόγιο και δελτίο αποστολής (isDeliveryNote = true)
startShippingBranch	xs:int	Οχι	Εγκατάσταση έναρξης διακίνησης (Εκδότη)	Συμπληρώνεται για παραστατικά που είναι δελτία αποστολής (π.χ 9.3) ή τιμολόγιο και δελτίο αποστολής (isDeliveryNote = true)
completeShippingBranch	xs:int	Οχι	Εγκατάσταση ολοκλήρωσης διακίνησης (Λήπτη)	Συμπληρώνεται για παραστατικά που είναι δελτία αποστολής (π.χ 9.3) ή τιμολόγιο και δελτίο αποστολής (isDeliveryNote = true)

Παρατηρήσεις:

Το πεδίο loadingAddress είναι τύπου AddressType, ο οποίος τύπος αναλύεται σε προγενέστερη αντίστοιχη παράγραφο (5.1.1)
Το πεδίο deliveryAddress είναι τύπου AddressType, ο οποίος τύπος αναλύεται σε προγενέστερη αντίστοιχη παράγραφο (5.1.1)
Με το πεδίο startShippingBranch ορίζεται το υποκατάστημα από το οποίο έγινε η έναρξη της διακίνησης, σε περίπτωση που η έναρξη της διακίνησης γίνεται από κάποιο υποκατάστημα (εγκατάσταση) του εκδότη του παραστατικού, το οποίο είναι διαφορετικό από το υποκατάστημα του εκδότη του δελτίου
Με το πεδίο completeShippingBranch ορίζεται το υποκατάστημα στο οποίο θα ολοκληρωθεί η διακίνηση, σε περίπτωση που η διακίνηση θα ολοκληρωθεί σε κάποιο υποκατάστημα (εγκατάσταση) του λήπτη του παραστατικού, το οποίο είναι διαφορετικό από το υποκατάστημα του λήπτη του δελτίου

5.4 Λεπτομέρειες παραστατικού

Πεδίο	Τύπος		Υποχρεωτικό	Περιγραφή	Έγκυρες τιμές
lineNumber	xs:int		Ναι	Αριθμός σειράς	Ελάχιστη τιμή = 1
lineCode	xs:string		Οχι	Κωδικός είδους
recType	xs:string		Οχι	Τύπος γραμμής	Ελάχιστη τιμή = 1 Μέγιστη τιμή = 6
fuelCode	FuelCodes		Οχι	Κωδικός καυσίμου	Λίστα κωδικών καυσίμου Τιμές που περιγράφονται στο Παράρτημα
quantity	xs:decimal		Οχι	Ποσότητα	Ελάχιστη τιμή = Προεπιλογή = 1
lineQuantity	xs:decimal		Οχι	Ποσότητα μόνο για χρήση από το API παρόχου εφόσον δεν υπάρχει η quantity	Ελάχιστη τιμή = Προεπιλογή = 1
classificationIdentifier	xs:string		Μόνο για B2G Οχι	Κωδικός CPV
measurementUnit	xs:int		Ναι	Μονάδα ποσότητας	1,2,3 Τιμές που περιγράφονται στο Παράρτημα
measurementUnitLabel	xs:string		Ναι		Απαιτείται μόνο όταν υπάρχει μονάδα μέτρησης
invoiceDetailType	xs:int		Οχι	Παρατήρηση αυτοτιμολόγησης	1,2 Τιμές που περιγράφονται στο Παράρτημα
lineUnitPrice	xs:decimal		Ναι	Η τιμή μονάδας
totalNetPriceBeforeDiscount	xs:decimal		Ναι	Συνολική τιμή όλων (μονάδες x ποσότητα)
totalDiscountValue	xs:decimal		Ναι	Συνολική αξία έκπτωσης	Ελάχιστη τιμή = 0
netValue	xs:decimal		Ναι	Καθαρή αξία	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
vatCategory	xs:int		Ναι	Κατηγορία ΦΠΑ	Ελάχιστη = 1, Μέγιστη = 8 Τιμές που περιγράφονται στο Παράρτημα Για περιπτώσεις που δεν εφαρμόζεται ΦΠΑ, το πεδίο vatCategory θα έχει την τιμή 8
vatCategoryPercent	xs:decimal		Ναι	Περιγραφή κατηγορίας ΦΠΑ (π.χ.24.00)
vatAmount	xs:decimal		Ναι	Ποσό ΦΠΑ	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
vatExemptionCategory	xs:int		Οχι	Κατηγορία απαλλαγής ΦΠΑ	Ελάχιστη τιμή = 1 Μέγιστη τιμή = 23 Τιμές που περιγράφονται στο Παράρτημα Απαιτείται εάν η Κατηγορία ΦΠΑ υποδεικνύει συντελεστή ΦΠΑ 0%.
vatExemptionCategoryLabel	xs:string		Ναι*	VAT exemption Description	Απαιτείται μόνο όταν η κατηγορία απαλλαγής από τον ΦΠΑ υπάρχει
dienergia	ShipType		Οχι	Άρθρο 27 of POL 1177/2018
discountOption	xs:boolean		Οχι	Επιλογή έκπτωσης	False / True
withheldAmount		xs:decimal	Οχι	Ποσό παρακράτησης φόρου		Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2 Το πεδίο συμπληρώνεται όταν υπάρχει ο αντίστοιχος φόρος (ακόμα και αν είναι ποσοστό)
withheldPercentCategory		xs:int	Οχι	Κατηγορία συντελεστή παρακράτησης φόρου		Ελάχιστη τιμή = 1 Μέγιστη τιμή = 12 Τιμές που περιγράφονται στο Παράρτημα
stampDutyAmount		xs: decimal	Οχι	Ποσό τελών χαρτοσήμου		Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
stampDutyPercentCategory		xs:int	Οχι	Κατηγορία συντελεστή χαρτοσήμου		1, 2, 3 Τιμές που περιγράφονται στο Παράρτημα
feesAmount		xs:decimal	Οχι	Ποσό τελών		Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2 Τα πεδία συμπληρώνονται όταν υπάρχει ο αντίστοιχος φόρος (ακόμα και αν είναι ποσοστό)
feesPercentCategory		xs:int	Οχι	Κατηγορία ποσοστού τελών		Ελάχιστη τιμή = 1 Μέγιστη τιμή = 8 Τιμές που περιγράφονται στο Παράρτημα
otherTaxesPercentCategory		xs:int	Οχι	Κατηγορία άλλων φορολογικών συντελεστών		Ελάχιστη τιμή = 1 Μέγιστη τιμή = 9 Τιμές που περιγράφονται στο Παράρτημα
otherTaxesAmount		xs:decimal	Οχι	Ποσό άλλων φόρων		Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2 Τα πεδία συμπληρώνονται όταν υπάρχει ο αντίστοιχος φόρος (ακόμα και αν είναι ποσοστό)
deductionsAmount		xs:decimal	Οχι	Ποσό μειώσεων		Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
lineDescription		xs:string
lineComments		xs:string	Οχι	Γραμμικά σχόλια		Συμπληρώνεται από τον χρήστη και χρησιμοποιείται μόνο για ενημερωτικούς σκοπούς
incomeClassification		IncomeClassificationType	Οχι	Ταξινόμηση εισοδήματος
expensesClassification		ExpensesClassificationType	Οχι	Ταξινόμηση εξόδων
itemDescr		xs:string	Οχι	Περιγραφή αντικειμένου		Μέγιστο 300 χαρακτήρες Αποδεκτό μόνο για έγγραφα της ειδικής κατηγορίας αφορολόγητου

Παρατηρήσεις

Οι πιθανές τιμές για τα πεδία μέτρηση Unit, invoiceDetailType, vatCategory, vatExemptionCategory, deheldPercentCategory, stampDutyPercentCategory, feesPercentCategory και otherTaxesPercentCategory αναφέρονται αναλυτικά στους αντίστοιχους πίνακες στο Παράρτημα
Το πεδίο vatExemptionCategory είναι απαραίτητο σε περίπτωση που το vatCategory υποδεικνύει μια κατηγορία συντελεστή ΦΠΑ 0%
Για περιπτώσεις λογιστικών εγγραφών όπου δεν εφαρμόζεται ΦΠΑ, το πεδίο vatCategory θα έχει την τιμή 8
Τα σχόλια γραμμής συμπληρώνονται από τον χρήστη και χρησιμοποιούνται για σκοπούς ενημέρωσης της υπηρεσίας
1. Σε περίπτωση αποστολής γραμμών με recType = 2 (γραμμή τέλους ΦΠΑ) ή/και recType = 3 (γραμμή Άλλοι φόροι με ΦΠΑ), θα επιτρέπεται ταυτόχρονα, εάν επιθυμείτε, η αποστολή παρακράτησης/τελών /άλλο φόρους/σφραγίδα/εκπτώσεις και σε επίπεδο παραστατικού και όχι απαραίτητα ανά γραμμή περίληψης εγγράφων. Στις περιπτώσεις αυτών των γραμμών, τα ποσά που αντιστοιχούν σε τέλη ΦΠΑ (recType = 2) ή άλλους φόρους (recType =3 αντίστοιχα, θα αποστέλλονται στο πεδίο της καθαρής αξίας της γραμμής (netValue), ενώ τα αντίστοιχα πεδία τέλος ποσό (feesAmount) ή ποσό άλλων φόρων (otherTaxesAmount) δεν θα συμπληρωθεί.Επίσης, δεν επιτρέπεται η αποστολή άλλων τύπων φόρων/τελών/παρακρατήσεων/ενσήμων σε αυτές τις γραμμές (π.χ. σε γραμμή με recType = 2 άλλοι φόροι/ δεν επιτρέπονται κρατήσεις/παρακράτηση/σφραγίδα σε αυτή τη γραμμή).
2. Η αποστολή με recType = 7 (αρνητικό πρόσημο τιμών) επιτρέπεται μόνο στην περίπτωση διαβίβασης των εγγράφων 17.3, 17.4, 17.5 και 17.6 και με αυτόν τον τρόπο υποδεικνύεται ότι οι τιμές της γραμμής είναι αρνητικές (στα αντίστοιχα πεδία τιμών το οι τιμές αναγράφονται στις απόλυτες/θετικές τους τιμές). Σημειώνεται ότι στα αθροίσματα των τιμών στην ενότητα Document Summary (InvoiceSummaryType) θα μεταδοθούν τα αθροίσματα των απόλυτων τιμών των αντίστοιχων τιμών των γραμμών ανεξάρτητα από το αν υπάρχουν γραμμές που φέρουν ή όχι την ένδειξη recType = 7.
Οι πιθανές τιμές για το πεδίο Κωδικός καυσίμου περιγράφονται αναλυτικά στον αντίστοιχο πίνακα στο Παράρτημα. Επιτρέπεται η αποστολή του μόνο σε περίπτωση παρόχων και εφόσον πρόκειται για παραστατικό Fuel (invoiceHeaderType.fuelInvoice = true). Η τιμή 999 χρησιμοποιείται στην περίπτωση που σε άλλο παραστατικό πλην των καυσίμων υπάρχει ανάγκη τιμολόγησης και άλλων χρεώσεων. Μόνο μία γραμμή με αυτόν τον κωδικό επιτρέπεται ανά έγγραφο και η καθαρή αξία αυτής της γραμμής πρέπει να είναι μικρότερη ή ίση με το άθροισμα της καθαρής αξίας των υπόλοιπων κωδικών καυσίμων του παραστατικού.

5.4.1 Δήλωση Ανάληψης Δραστηριότητας

Η δήλωση ανάληψης δραστηριότητας είναι στοιχείο τύπου ShipType:

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
applicationId	xs:string	Ναι	Αριθμός Δήλωσης Επιχείρησης Δραστηριότητας
applicationDate	xs:date	Ναι	Ημερομηνία αίτησης
doy	xs:string	Οχι	Υποβολή Φορολογικής Δήλωσης Δ.Ο.Υ
shipID	xs:string	Ναι	Λεπτομέρειες αποστολής

5.5 Σύνολα φόρων

Το στοιχείο TaxTotalsType που περιέχει τους συνολικούς φόρους έχει την ακόλουθη δομή:

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή	Έγκυρες Αξίες
taxType	xs:byte	Ναι	Είδος φόρου	1 = Παρακρατούμενοι φόροι 2 = Τέλη 3 = Άλλοι φόροι 4 = Τέλη χαρτοσήμου 5 = Εκπτώσεις
taxCategory	xs:byte	Ναι	Φορολογική κατηγορία	Βλέπε πίνακες 8.4 – 8.8 του παραρτήματος
underlyingValue	xs:decimal	Οχι	Υποκείμενη αξία στην οποία αναφέρεται ο φόρος	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
percentage	xs:decimal	Μόνο για B2G Ναι	Ποσοστό κράτησης, παρακράτησης	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
reason	xs:string	Μόνο για B2G Ναι	Περιγραφή κράτησης, παρακράτησης
taxAmount	xs:decimal	Ναι	Ποσό φόρου	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
Id	xs:byte	Οχι	Αριθμός γραμμής
ReducesPayable	xs:boolean	Οχι	Μειώνει το πληρωτέο ποσό	Προεπιλογή = False
taxTypeLabel	xs:string	Οχι	Περιγραφή της υπηρεσίας

5.6 Περίληψη παραστατικού

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή	Έγκυρες Αξίες
totalNetValue	xs:decimal	Ναι	Συνολική καθαρή αξία	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
totalVatAmount	xs:decimal	Ναι	Συνολικό ποσό ΦΠΑ	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
totalWithheldAmount	xs:decimal	Ναι	Συνολικό ποσό παρακράτησης φόρων	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
totalFeesAmount	xs:decimal	Ναι	Συνολικό ποσό τελών	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
totalStampDutyamount	xs:decimal	Ναι	Συνολικό ποσό τελών χαρτοσήμου	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
totalOtherTaxesAmount	xs:decimal	Ναι	Συνολικό ποσό άλλων φόρων	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
totalDeductionsAmount	xs:decimal	Ναι	Συνολικό ποσό παρακρατήσεων	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
totalGrossValue	xs:decimal	Ναι	Συνολική ακαθάριστη αξία	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
incomeClassification	IncomeClassificationType	Οχι	Ταξινόμηση εισοδήματος
expensesClassification	ExpensesClassificationType	Οχι	Ταξινόμηση εξόδων

Παρατηρήσεις

Στοιχεία incomeClassification και expensesClassification περιέχει τα αθροίσματα όλων των συνδυασμών πεδίων classificationType και classificationCategory που υπάρχουν στα στοιχεία του παραστατικού.
Όλα τα πεδία περίληψης φόρων περιέχουν τη σύνοψη των αντίστοιχων φόρων των στοιχείων του παραστατικού ή στο στοιχείο taxesTotals.
totalGrossValue = totalNetValue + totalVatAmount + totalFeesAmount + totalStampDutyamount + totalOtherTaxesAmount – totalWithheldAmount

5.7 Ταξινόμηση εισοδήματος

Στοιχείο IncomeClassificationType που περιέχει την ταξινόμηση εισοδήματος έχει την ακόλουθη δομή:

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή	Έγκυρες Αξίες
classificationType	xs: string	Ναι	Ταξινόμηση τύπος	Περιγράφονται οι πιθανές τιμές των πεδίων στο παράρτημα
classificationCategory	xs: string	Ναι	Κατηγορία ταξινόμησης	Οι πιθανές τιμές των πεδίων περιγράφονται στο παράρτημα
amount	xs:decimal	Ναι	Ποσό	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
id	xs:byte	Οχι	Αύξων αριθμός ταξινόμησης	Χρησιμοποιείται για σειριακή αρίθμηση (1,2,3…κ.λπ.) των ταξινομήσεων μιας σειράς

Παρατηρήσεις

Λόγω της αποστολής εγγράφων μέσω παρόχου, δεν είναι απαραίτητη η αποστολή ταξινόμησης.
Το πεδίο id χρησιμοποιείται για τη σειριακή αρίθμηση (1,2,3… κ.λπ.) των ονομασιών μέσα σε μια γραμμή

5.8 Ταξινόμηση εξόδων

Στοιχείο ExpensesClassificationType που περιέχει την ταξινόμηση εισοδήματος έχει την ακόλουθη δομή:

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή	Έγκυρες Αξίες
ClassificationType	xs: string	Ναι	Τύπος ταξινόμησης	Οι πιθανές τιμές των πεδίων περιγράφονται στο παράρτημα
classificationCategory	xs: string	Ναι	Κατηγορία ταξινόμησης	Οι πιθανές τιμές των πεδίων περιγράφονται στο παράρτημα
amount	xs:decimal	Ναι	Ποσό	Ελάχιστη τιμή = 0 Δεκαδικά ψηφία = 2
id	xs:byte	Οχι	Αύξων αριθμός ταξινόμησης	Χρησιμοποιείται για σειριακή αρίθμηση (1,2,3… κ.λπ.) των ταξινομήσεων μιας σειράς

Παρατηρήσεις

Λόγω της αποστολής εγγράφων μέσω παρόχου, δεν είναι απαραίτητη η αποστολή ταξινόμησης.

5.9 Λεπτομέρειες

Ο εκδότης και ο αντισυμβαλλόμενος είναι στοιχεία τύπου PartyType.

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
API_Issuer	API_IssuerType	Ναι	API_Issuer
API_Counterpart	API_CounterpartType	Ναι	API_Counterpart
API_Additionals	API_AdditionalsType	Ναι	API_Additionals

5.9.1 Εκδότης

Στοιχείο API_IssuerType που περιέχει την ακόλουθη δομή:

Πεδίο	Τύπος	Υποχρεωτικό	Έγκυρες Αξίες
IssuerName	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerProfession	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerTaxOffice	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerAddressStreet	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerAddressNumber	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerAddressPostalCode	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerAddressCity	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerAddressCountry	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerPhone	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerFax	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerEmail	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerWebSite	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerRegistryNumber	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerEmtyLine	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β
IssuerEmtyLine2	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β

5.9.2 Αντισυμβαλλόμενος

Στοιχείο API_ConterpartType που περιέχει την ακόλουθη δομή:

Πεδίο	Τύπος	Υποχρεωτικό	Έγκυρες Αξίες
CounterpartCode	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartName	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartVat	xs: string	Οχι	Χρησιμοποιείται κατά παραγγελία μόνο εάν ο τύπος παραστατικού είναι 11.1 ή 11.2
CounterpartProfession	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartTaxOffice	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartAddressStreet	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartAddressNumber	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartAddressPostalCode	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartAddressCity	xs: string	Ναι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartAddressCountry	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartPhone	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β
CounterpartEmail	xs: string	Οχι	Πεδία που περιγράφονται στο Παράρτημα Β

5.9.3 Πρόσθετα

Στοιχείο API_AdditionalsType που περιέχει την ακόλουθη δομή:

Πεδίο	Τύπος	Υποχρεωτικό	Έγκυρες Αξίες
DocumentLabel	xs: string	Ναι	Περιγραφή τύπου παραστατικού, που περιγράφεται στο Παράρτημα Β
DocumentComments	xs: string	Οχι	Περιγραφή τύπου παραστατικού, που περιγράφεται στο Παράρτημα Β
paymentMethodInvoiceLabel	xs: string	Οχι	Περιγραφή τύπου παραστατικού, που περιγράφεται στο Παράρτημα Β
Logo_ID	xs: string	Οχι	Προεπιλεγμένο ID = 1. Μπορεί να οριστεί στο API Portal
DispatchPlaceFrom	xs: string	Οχι	Τόπος προέλευσης αποστολής
DispatchPlaceTo	xs: string	Οχι	Ο τόπος προορισμού της αποστολής
DispatchMethod	xs:string	Οχι	Τρόπος αποστολής
docTime	xs: string	Οχι	Η ώρα έκδοσης του παραστατικού
b2g	xs:boolean	Μόνο για B2G Ναι	Ναι, όχι για το αν αφορά παραστατικό προς το Δημόσιο
buyerIdentifier	xs: string	Μόνο για B2G Ναι	Αναθέτουσα αρχή
contractReference	xs: string	Μόνο για B2G Ναι	Αριθμός Διαδικτυακής Ανάρτησης Μητρώου
projectReference	xs: string	Μόνο για B2G Ναι	Αναγνωριστικό σύμβασης

6. Απαντήσεις

6.1 Υποβολή δεδομένων

Όταν ο χρήστης χρησιμοποιεί την υπηρεσία υποβολής (SendInvoices), θα λάβει την απάντηση ResponseDoc σε μορφή xml. Το αντικείμενο περιέχει μια λίστα στοιχείων απόκρισης, ένα για κάθε οντότητα που υποβάλλεται.

Πεδίο	Τύπος	Περιγραφή
Index	xs: int	Ο αριθμός γραμμής της οντότητας μέσα στο xml που υποβλήθηκε
invoiceUid	xs: string	Αναγνωριστικό παραστατικού
invoiceMark	xs: long	Μοναδικός Αριθμός Καταχώρησης
AuthenticationCode
InvoiceUrl		Ο σύνδεσμος που οδηγεί στο παραστατικό
Errors	ErrorType	Λίστα σφαλμάτων
units	xs: long	Διαθέσιμες μονάδες προς χρήση
statusCode	xs: string	Κωδικός κατάστασης

Παρατηρήσεις

Το είδος της απάντησης (πετυχημένη ή αποτυχημένη διαδικασία) καθορίζεται από την τιμή του πεδίου statusCode.
Σε περίπτωση επιτυχίας το πεδίο statusCode έχει τιμή Success και η απάντηση περιλαμβάνει τις αντίστοιχες τιμές για τα πεδία invoiceUid, invoiceMark, classificationMark και cancellationMark, ανάλογα με την οντότητα που υποβλήθηκε.
Σε περίπτωση αποτυχίας το πεδίο statusCode έχει τιμή αντίστοιχη του είδους του σφάλματος και η απάντηση περιλαμβάνει μια λίστα στοιχείων σφάλματος τύπου ErrorType για κάθε οντότητα που η υποβολή της απέτυχε. Όλα τα στοιχεία σφάλματος ανά οντότητα είναι υποχρεωτικά της ίδιας κατηγορίας που χαρακτηρίζει την απάντηση
Το πεδίο invoiceUid επιστρέφει μόνο στην περίπτωση που η υποβολή αφορούσε παραστατικό
Το πεδίο classificationMark επιστρέφει μόνο στην περίπτωση που η υποβολή αφορούσε χαρακτηρισμό
Το πεδίο authenticationCode επιστρέφει στην περίπτωση που η υποβολή έγινε μέσω παρόχου
Το πεδίο cancellationMark επιστρέφει μόνο στην περίπτωση που η υποβολή αφορούσε ακύρωση παραστατικού
Το πεδίο invoiceMark περιέχει το mark του υποβληθέντος παραστατικού στην περίπτωση που υποβλήθηκαν παραστατικά και το mark του παραστατικού που αφορούσαν οι υποβληθέντες χαρακτηρισμοί, στην περίπτωση υποβολής χαρακτηρισμών
Το πεδίο qrUrl επιστρέφει μόνο στις υποβολές παραστατικών τύπου από 1.1 έως 11.5

6.2 Ανάκτηση δεδομένων

Όταν ο χρήστης καλεί μια υπηρεσία αιτήματος δεδομένων (RequestTransmittedDocs), θα λάβει ένα αντικείμενο RequestedDoc σε μορφή xml. Το αντικείμενο θα περιλαμβάνει τη λίστα των ζητούμενων παραστατικών για το issueerVatNumber που δίνεται ως παράμετρος, καθώς και το στοιχείο continuationToken (σε περιπτώσεις όπου τα δεδομένα υπερβαίνουν το επιτρεπόμενο όριο και ανακτώνται μερικώς).

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
nextPageKey	nextPageKey	Οχι	Στοιχείο για μερική ανάκτηση αποτελεσμάτων Εάν επιστραφεί ένα nextPageKey, τότε εκτελέστε αυτό το url από την υπηρεσία για να λάβετε τα επόμενα αποτελέσματα
counterpartVatNumber		Ναι
InvoiceMark		Ναι
invoiceUid	AadeBookInvoiceType	Ναι
invoiceAuthenticationCode	CancelledInvoiceType	Ναι
invoiceBranchCode	xs:long	Ναι
invoiceType	xs:long	Ναι
invoiceSeries	xs:date	Ναι
incomeAa	InvoiceIncomeClassificationType	Ναι
invoiceDateIssued	InvoiceExpensesClassificationType	Ναι
invoiceTotalNetValue	xs:string	Ναι
invoiceTotalVatValue	xs:string	Ναι
invoiceTotalGrossValue	xs:string	Ναι
invoiceUrl	xs:string	Ναι	Έγγραφο pdf ή xml

Παρατηρήσεις:

Σε περίπτωση που θα επιστρέφεται το στοιχείο continuationToken τα πεδία nextPartitionKey και nextRowKey θα είναι συμπληρωμένα από την υπηρεσία και χρησιμοποιούνται στην επόμενη κλήση της ίδιας μεθόδου που είχε οριστεί από τον χρήστη
Οι τύποι AadeBookInvoiceType, InvoiceIncomeClassificationType,
InvoiceExpensesClassificationType και PaymentMethodType περιγράφονται σε προηγούμενες παραγράφους

7. Σφάλματα

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

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
message	xs: string	Ναι	Μήνυμα σφάλματος
code	xs: string	Ναι	Κωδικός σφάλματος

7.1 Τεχνικά και λειτουργικά λάθη

#	HTTP Απάντηση	Κωδικός κατάστασης	Κδ.	Περιγραφή
1	HTTP 200 OK	XMLSyntaxError	101	Σφάλμα επικύρωσης σύνταξης XML
2	HTTP 200 OK	ValidationError	102	Ο αριθμός ΦΠΑ {vatNumber} δεν ανήκει σε ενεργή εταιρεία
3	HTTP 200 OK	ValidationError	103	Παρακαλώ περάστε το σύμβολο στις παραμέτρους αιτήματος
4	HTTP 200 OK	ValidationError	104	Το αιτούμενο τιμολόγιο δεν βρέθηκε
3	HTTP 200 OK	ValidationError	201	Ο ΑΦΜ του συντάκτη δεν είναι ίδιος με τον ΑΦΜ του χρήστη
5	HTTP 200 OK	ValidationError	202	Μη έγκυρος ΑΦΜ Παραλήπτη
6	HTTP 200 OK	ValidationError	203	Η Ακαθάριστη Αξία δεν ταιριάζει με το άθροισμα της καθαρής αξίας συν τους φόρους
7	HTTP 200 OK	ValidationError	204	Το {Field} είναι υποχρεωτικό για αυτόν τον τύπο τιμολογίου
8	HTTP 200 OK	ValidationError	205	Το {Field} είναι απαγορευμένο για αυτόν τον τύπο τιμολογίου
9	HTTP 200 OK	TechnicalError	206	Μη αναμενόμενο τεχνικό σφάλμα για τη γραμμή τιμολογίων
10	HTTP 200 OK	ValidationError	207	Το άθροισμα των καθαρών αξιών των γραμμών τιμολογίου δεν ταιριάζει με τη συνολική καθαρή αξία του τιμολογίου
11	HTTP 200 OK	ValidationError	208	Το άθροισμα των ακαθάριστων αξιών των γραμμών τιμολογίων δεν ταιριάζει με τη συνολική ακαθάριστη αξία του τιμολογίου
12	HTTP 200 OK	ValidationError	209	Το άθροισμα του ποσού ΦΠΑ των γραμμών τιμολογίου δεν ταιριάζει με το συνολικό ποσό ΦΠΑ του τιμολογίου
13	HTTP 200 OK	ValidationError	210	Το άθροισμα του παρακρατηθέντος ποσού των γραμμών παραστατικού δεν ταιριάζει με το συνολικό παρακρατηθέν ποσό του παραστατικού
14	HTTP 200 OK	ValidationError	211	Η συναλλαγματική ισοτιμία πρέπει να είναι μεγαλύτερη από 0 όταν το νόμισμα δεν είναι ευρώ
15	HTTP 200 OK	ValidationError	212	Το στοιχείο ΑΑ πρέπει να είναι αριθμός (θετικός) για τον εκδότη από την Ελλάδα
16	HTTP 200 OK	ValidationError	213	Το {Πεδίο} πρέπει να έχει τιμή 0 για αυτόν τον τύπο παραστατικού
17	HTTP 200 OK	ValidationError	214	Το στοιχείο {Element} πρέπει να αποσταλεί μόνο εάν είναι αληθές
18	HTTP 200 OK	ValidationError	215	Η κατηγορία ΦΠΑ πρέπει να έχει την τιμή 8 για αυτόν τον τύπο παραστατικού
19	HTTP 200 OK	ValidationError	216	Η κατηγορία ΦΠΑ πρέπει να έχει αξία διαφορετική από 8 για αυτόν τον τύπο παραστατικού
20	HTTP 200 OK	ValidationError	217	Όταν η κατηγορία vat έχει τιμή 7, το στοιχείο vatExemptionCategory είναι υποχρεωτικό
21	HTTP 200 OK	ValidationError	218	Το Ποσό ΦΠΑ πρέπει να έχει τιμή 0 για αυτόν τον τύπο παραστατικού
22	HTTP 200 OK	ValidationError	219	Το Όνομα Εκδότη απαγορεύεται για τον Εκδότη από την Ελλάδα
23	HTTP 200 OK	ValidationError	220	Το όνομα του αντισυμβαλλομένου απαγορεύεται για τον αντισυμβαλλόμενο από την Ελλάδα
24	HTTP 200 OK	ValidationError	221	Το {Πεδίο} είναι απαγορευμένο για τις γραμμές που έχουν invoiceDetailType = 2 για αυτόν τον τύπο παραστατικού
25	HTTP 200 OK	ValidationError	222	Το {Πεδίο} πρέπει να έχει τιμή μεγαλύτερη από 0 για αυτόν τον τύπο παραστατικού
26	HTTP 200 OK	ValidationError	223	Μη υποστηριζόμενος τύπος παραστατικού
27	HTTP 200 OK	ValidationError	224	Επιτρέπονται φόροι είτε ανά γραμμή παραστατικού είτε ανά παραστατικό (όχι και στα δύο)
28	HTTP 200 OK	ValidationError	225	Το {Πεδίο} πρέπει να υπάρχει (δεν μπορεί να είναι null) καθώς το {Πεδίο} δεν είναι null (γραμμή παραστατικού {lineNumber})
29	HTTP 200 OK	ValidationError	226	Το άθροισμα του ποσού {field} του παραστατικού {section} δεν ταιριάζει με το συνολικό ποσό {field} του παραστατικού
30	HTTP 200 OK	ValidationError	227	Το {Πεδίο} δεν μπορεί να υπάρχει (πρέπει να είναι null) αφού το { Πεδίο 1} είναι null (invoice line : {lineNumber}) [ Πιθανές τιμές {Πεδίο 1, Πεδίο 2}: {‘feesAmount’, feesPercentCategory’}, {‘stampDutyAmount, ‘stampDutyPercentCategory’}, {‘withheldAmount’, ‘withheldPercentCategory’}]
31	HTTP 200 OK	ValidationError	228	Το {Πεδίο} δεν είναι έγκυρο [Πιθανές τιμές {Field}: {UID, InvoiceType}
32	HTTP 200 OK	ValidationError	229	Το {Πεδίο 1} δεν είναι σωστό σύμφωνα με το δεδομένο: {Field2} (γραμμή παραστατικού: {αριθμός σειράς}) [ Πιθανές τιμές {Field1, Field2}: {‘feesAmount’, feesPercentCategory’}, {‘stampDutyAmount, ‘stampDutyPercentCategory’}, {‘withheldAmount’, ‘withheldPercentCategory’}]
33	HTTP 200 OK	ValidationError	230	Το {Πεδίο} είναι υποχρεωτικό για λεπτομέρειες παραστατικού (number} [Πιθανές τιμές {Πεδίο}: {Ταξινομήσεις E3, ταξινομήσεις ΦΠΑ}
34	HTTP 200 OK	ValidationError	231	{Το {Πεδίο} απαγορεύεται για λεπτομέρειες παραστατικού (αριθμός} [Πιθανές τιμές {Πεδίο}: {Ε3 ταξινομήσεις, ταξινομήσεις ΦΠΑ}
35	HTTP 200 OK	ValidationError	233	UID: Το ” + {uid} + ” έχει ήδη σταλεί
36	HTTP 200 OK	ValidationError	234	Οι τιμές 7 ή 8 δεν επιτρέπονται για την κατηγορία ΦΠΑ για αυτόν τον τύπο παραστατικού
37	HTTP 200 OK	ValidationError	235	Ο εκδότης πρέπει να είναι διαφορετικός από τον αντίστοιχο
38	HTTP 200 OK	ValidationError	236	Ο Αποστολέας (αριθμός ΦΠΑ): ” + {afm} + ” πρέπει να είναι διαφορετικός από τον εκδότη (αριθμός ΦΠΑ)
39	HTTP 200 OK	ValidationError	237	Οι υποκείμενες Αξίες των φόρων δεν μπορούν να είναι μεγαλύτερες από το σύνολο της καθαρής αξίας παραστατικού
40	HTTP 200 OK	ValidationError	239	Το φορολογικό ποσό των φόρων δεν μπορεί να είναι μεγαλύτερο από τη συνολική καθαρή αξία του παραστατικού
41	HTTP 200 OK	ValidationError	240	240/ValidationError -Taxamount {Taxamount } της φορολογικής γραμμής: {A/A} δεν μπορεί να είναι μεγαλύτερη από την αντίστοιχη υποκείμενη τιμή
42	HTTP 200 OK	ValidationError	241	241/ValidationError -{ Το πεδίο 1} δεν μπορεί να είναι μεγαλύτερο από την αντίστοιχη καθαρή αξία γραμμής παραστατικού (γραμμή παραστατικού: + {linenumber} ) [Πιθανές τιμές { Πεδίου 1}: {‘feesAmount’, ‘otherTaxesPercentAmount’, ‘stampDutyAmount, ‘withheldAmount’}]
43	HTTP 200 OK	ValidationError	242	242/ValidationError – Η χώρα του { Field } για αυτόν τον τύπο παραστατικού πρέπει να είναι η Ελλάδα [Πιθανές { Πεδίου} τιμές: {Issuer, Counterpart}
44	HTTP 200 OK	ValidationError	243	243/ValidationError – Η χώρα του { Field } για αυτόν τον τύπο παραστατικού πρέπει να είναι στην Ευρώπη αλλά όχι στην Ελλάδα [Πιθανές τιμές {Field}: {Issuer, Counterpart}
45	HTTP 200 OK	ValidationError	244	244/ValidationError – Η χώρα του {Field} για αυτόν τον τύπο παραστατικού δεν πρέπει να είναι στην ΕΕ [Πιθανές τιμές {Field}: {Issuer, Counterpart}
46	HTTP 200 OK	ValidationError	245	Ο πάροχος δεν είναι εξουσιοδοτημένος να εκδίδει παραστατικά για: {vat Number}
47	HTTP 200 OK	ValidationError	246	Το παραστατικό του τύπου 1.5 πρέπει να έχει τουλάχιστον μία γραμμή με λεπτομέρεια = 1 και ένα με λεπτομέρεια τύπου=2
48	HTTP 200 OK	ValidationError	247	Γραμμή παραστατικού: {lineNumber}. Το {Field} είναι απαγορευμένο. [Πιθανές τιμές {Field}: {recType=1, recType=4, recType=5}
49	HTTP 200 OK	ValidationError	248	Το παραστατικό με MARK {mark} δεν μπορεί να ακυρωθεί επειδή δεν δημοσιεύτηκε από τον ΑΦΜ {vat}
50	HTTP 200 OK	ValidationError	249	Το παραστατικό με MARK {mark} δεν μπορεί να ακυρωθεί λόγω δημοσίευσης από τον πάροχο
51	HTTP 200 OK	ValidationError	250	Το παραστατικό με MARK {mark} δεν μπορεί να ακυρωθεί επειδή δημοσιεύτηκε από την τιμολόγηση myDATA
52	HTTP 200 OK	ValidationError	251	Το παραστατικό με MARK {mark} δεν μπορεί να ακυρωθεί επειδή έχει ήδη ακυρωθεί
53	HTTP 200 OK	ValidationError	252	Η εγγραφή με MARK {mark} δεν αποτελεί έγκυρο παραστατικό
54	HTTP 200 OK	ValidationError	254	TaxLine (TaxTotals) : + {taxlinenumber} . {field + fieldData} είναι απαγορευμένος
55	HTTP 200 OK	ValidationError	301	Τα παραστατικά με ΜΑΡΚ {mark} δεν βρέθηκαν
56	HTTP 200 OK	ValidationError	302	Διπλότυπος αριθμός σειράς ταξινόμησης {lineNumber}
57	HTTP 200 OK	ValidationError	303	Ο αριθμός γραμμής {lineNumber} δεν βρέθηκε στο παραστατικό με MARK {mark}
58	HTTP 200 OK	ValidationError	304	Όλες οι σειρές παραστατικών ή καμία δεν πρέπει να περιλαμβάνουν ταξινομήσεις
59	HTTP 200 OK	ValidationError	305	Γραμμή παραστατικού: {lineNumber}. Διπλότυπος τύπος ταξινόμησης {classificationType} και κατηγορία {classificationCategory}
60	HTTP 200 OK	ValidationError	306	Γραμμή παραστατικού: {lineNumber}. Το άθροισμα των ταξινομήσεων δεν είναι ίσο με την καθαρή αξία της γραμμής
61	HTTP 200 OK	ValidationError	307	Ο τύπος ταξινόμησης {classificationType} απαγορεύεται για την κατηγορία ταξινόμησης {classificationCategory}
62	HTTP 200 OK	ValidationError	308	Η κατηγορία ταξινόμησης {classificationCategory} απαγορεύεται για τον τύπο παραστατικού {classificationType}
63	HTTP 200 OK	ValidationError	309	Απαγορεύονται οι ταξινομήσεις για τον τύπο παραστατικού {invoiceType}
64	HTTP 200 OK	TechnicalError	310	Όλες οι ταξινομήσεις παραστατικών ή καμία θα πρέπει να έχουν κατηγορία τιμής κατηγορίας 2_4
65	HTTP 200 OK	ValidationError	311	Ταξινόμηση με τύπο {classificationType} και κατηγορία ” {classificationCategory} δεν βρέθηκε στην περίληψη παραστατικών
66	HTTP 200 OK	ValidationError	312	Το άθροισμα ταξινομήσεων με τύπο {classification Type} και κατηγορία {classification Category} δεν ταιριάζει με το σχετικό σύνολο στην περίληψη παραστατικών
67	HTTP 200 OK	ValidationError	313	Ο τύπος ταξινόμησης {classificationType} απαγορεύεται για την κατηγορία ταξινόμησης {classificationCategory} σε συνδυασμό με τον τύπο παραστατικού {invoiceType}
68	HTTP 200 OK	ValidationError	314	Όλα τα παραστατικά πρέπει να περιέχουν είτε την ενότητα ταξινομήσεων εσόδων ή εξόδων, όχι και τα δύο ούτε κανένα
69	HTTP 200 OK	ValidationError	315	Οι ταξινομήσεις ΦΠΑ δεν έχουν κατηγορία
70	HTTP 200 OK	ValidationError	316	Δεν επιτρέπονται ταξινομήσεις ΦΠΑ σε περίπτωση απαλλαγής από τον ΦΠΑ
71	HTTP 200 OK	ValidationError	317	Στοιχεία παραστατικού { lineNumber } : Η ταξινόμηση ΦΠΑ πρέπει να είναι τύπου 366 σε περίπτωση vatExemptionCategory = 16
72	HTTP 200 OK	ValidationError	318	Το στοιχείο {Field} πρέπει να έχει την ίδια τιμή με το συσχετισμένο
73	HTTP 200 OK	ValidationError	319	Η καθαρή αξία του συσχετιζόμενου παραστατικό έχει ήδη υπερβεί το άθροισμα των καθαρών αξιών που σχετίζονται με αυτό
74	HTTP 200 OK	ValidationError	320	Μη έγκυρος τύπος συσχετιζόμενου παραστατικού
75	HTTP 200 OK	ValidationError	321	Οι ταξινομήσεις δεν επιτρέπονται στην περίληψη παραστατικού
76	HTTP 200 OK	ValidationError	322	Μη υποστηριζόμενος τύπος συσχετιζόμενου παραστατικού
77	HTTP 200 OK	ValidationError	323	Ο χρήστης δεν μπορεί να χρησιμοποιήσει απευθείας αυτήν την υπηρεσία λόγω ετήσιου ακαθάριστου ορίου εισοδήματος
78	HTTP 200 OK	TechnicalError	330	Απροσδόκητο τεχνικό σφάλμα για τη γραμμή ταξινόμησης
79	HTTP 401	AuthError	5001	Λείπει η κεφαλίδα του API_KEY
80	HTTP 401	AuthError	5002	Ο Αριθμός ΦΠΑ του εκδότη δεν σχετίζεται με τη Συνδρομή σας
81	HTTP 404	XMLSyntaxError	5004	Μη έγκυρο. Ο πόρος δεν βρέθηκε
82	HTTP 401	AuthError	5005	Λείπει η κεφαλίδα του API_KEY
83	HTTP 401	AuthError	5006	Ο εκδότης VatNumber δεν σχετίζεται με τη Συνδρομή σας
84	HTTP 400	XMLException	5008	Γενικό σφάλμα εξαίρεσης
85	HTTP 401	XMLSyntaxError	6001	Η ετικέτα συσχετισμένων παραστατικών είναι υποχρεωτική
86	HTTP 401	XMLSyntaxError	6002	movePurposeLabel είναι υποχρεωτικό
87	HTTP 401	XMLSyntaxError	6003	Η ποσότητα πεδίου δεν μπορεί να είναι μικρότερη από 1
88	HTTP 401	XMLSyntaxError	6004	Η ετικέτα της μονάδας μέτρησης είναι υποχρεωτική
89	HTTP 401	XMLSyntaxError	6005	Ελέγξτε τη σύνταξη XML! Απαιτούμενα πεδία
90	HTTP 401	XMLSyntaxError	6006	Η κατηγορία vatExemption είναι υποχρεωτική
91	HTTP 401	XMLSyntaxError	6007	Η vatExemptionCategory δεν πρέπει να οριστεί
92	HTTP 401	XMLSyntaxError	6008	Ελέγξτε τη σύνταξη XML! Απαιτούμενα πεδία
93	HTTP 401	XMLSyntaxError	6009	Ελέγξτε τη σύνταξη XML! Απαιτούμενα πεδία
94	HTTP 401	XMLSyntaxError	6010	Τα πεδία DocumentLabel, paymentMethodΙnvoiceLabel είναι υποχρεωτικά
95	HTTP 405	ValidationError	6030	Το NextPageKey δεν είναι έγκυρο
96	HTTP 405	ValidationError	6031	Το πεδίο έκδοσης ΦΠΑ είναι υποχρεωτικό!
97	HTTP 405	ValidationError	6032	Το InvoiceMark δεν αποτελεί έγκυρη τιμή Int64
98	HTTP 405	ValidationError	6033	issuedDate δεν είναι έγκυρη ημερομηνία (εεεε-μμ-ηη)
99	HTTP 405	ValidationError	6034	Η ημερομηνία έκδοσης δεν είναι έγκυρη ημερομηνία
100	HTTP 405	ValidationError	6035	Το issuedFrom δεν είναι έγκυρη ημερομηνία (εεεε-μμ-ηη)
101	HTTP 405	ValidationError	6036	Το issuedFrom δεν είναι έγκυρη ημερομηνία
102	HTTP 405	ValidationError	6037	Το issuedFrom δεν είναι έγκυρη ημερομηνία (εεεε-μμ-ηη)
103	HTTP 405	ValidationError	6038	Το issuedFrom δεν είναι έγκυρη ημερομηνία (εεεε-μμ-ηη)
104	HTTP 405	ValidationError	6039	Οι αποδεκτές τιμές urlType είναι “url” ή “source”
105	HTTP 405	ValidationError	6040	Οι συνδυασμοί παραμέτρων ημερομηνίας δεν είναι έγκυροι. In case of using issuedDate then issuedFrom and issuedTo must be blank. In case of using issuedFrom or issuedTo then issuedDate must be blank.
106	HTTP 200 OK	BalanceError	7001	Το διαθέσιμο υπόλοιπό σας δεν επαρκεί για την αποστολή αυτού του παραστατικού. Ανανεώστε το υπόλοιπό σας
107	HTTP 200 OK	TechnicalError	7002	Δεν υπάρχει απάντηση από την ΑΑΔΕ transmissionFailure=2
108	HTTP 200 OK	TechnicalError	–	Μη αναμενόμενο σφάλμα συνθήκης

8. Παράρτημα Α

8.1 Είδη παραστατικών

Αντικριζόμενα Παραστατικά Εκδότη ημεδαπής / αλλοδαπής	Κωδικός	Περιγραφή
Τιμολόγιο Πώλησης
	1.1	Τιμολόγιο Πώλησης
	1.2	Τιμολόγιο Πώλησης / Ενδοκοινοτικές Παραδόσεις
	1.3	Τιμολόγιο Πώλησης / Παραδόσεις Τρίτων Χωρών
	1.4	Τιμολόγιο Πώλησης / Πώληση για Λογαριασμό Τρίτων
	1.5	Τιμολόγιο Πώλησης / Εκκαθάριση Πωλήσεων Τρίτων – Αμοιβή από Πωλήσεις Τρίτων
	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.4	Απόδειξη Είσπραξης POS
	8.5	Απόδειξη Επιστροφής POS
Δελτίο Παραγγελίας
	8.6	Δελτίο Παραγγελίας εστίασης
Παραστατικό Διακίνησης
	9.3	Δελτίο Αποστολής
Μη Αντικριζόμενα Παραστατικά Εκδότη ημεδαπής / αλλοδαπής	Κωδικός	Περιγραφή
Παραστατικά Λιανικής
	11.1	Απόδειξη λιανικής πώλησης
	11.2	Απόδειξη παροχής υπηρεσιών
	11.3	Απλοποιημένο Τιμολόγιο
	11.4	Πιστωτικό Στοιχ. Λιανικής
	11.5	Απόδειξη Λιανικής Πώλησης για Λογ/σμό Τρίτων

8.2 Κατηγορία ΦΠΑ

1	συντελεστής ΦΠΑ 24%	24%
2	συντελεστής ΦΠΑ 13%	13%
3	συντελεστής ΦΠΑ 6%	6%
4	συντελεστής ΦΠΑ 17%	17%
5	συντελεστής ΦΠΑ 9%	9%
6	συντελεστής ΦΠΑ 4%	4%
7	Χωρίς ΦΠΑ	0%
8	Εγγραφές χωρίς ΦΠΑ (π.χ. μισθοδοσία,αποσβέσεις)	–
9	συντελεστής ΦΠΑ 3%	3%
10	συντελεστής ΦΠΑ 4%	4%

8.3 Αιτία Απαλλαγής ΦΠΑ

Κωδ.	Περιγραφή	Κώδικας	Περιγραφή
1	Χωρίς ΦΠΑ – άρθρο 2 και 3 του κώδικα ΦΠΑ	17	Χωρίς ΦΠΑ – άρθρο 40 του Κώδικα Φ.Π.Α
2	Χωρίς ΦΠΑ – άρθρο 5 του Κώδικα Φ.Π.Α	18	Χωρίς ΦΠΑ – άρθρο 41 του Κώδικα Φ.Π.Α
3	Χωρίς ΦΠΑ – άρθρο 13 του Κώδικα Φ.Π.Α	19	Χωρίς ΦΠΑ – άρθρο 47 του Κώδικα Φ.Π.Α
4	Χωρίς ΦΠΑ – άρθρο 14 του Κώδικα Φ.Π.Α	20	Περιλαμβάνεται ΦΠΑ – άρθρο 43 του κώδικα ΦΠΑ
5	Χωρίς ΦΠΑ – άρθρο 16 του Κώδικα Φ.Π.Α	21	Περιλαμβάνεται ΦΠΑ – άρθρο 44 του κώδικα ΦΠΑ
6	Χωρίς ΦΠΑ – άρθρο 19 του Κώδικα Φ.Π.Α	22	Περιλαμβάνεται ΦΠΑ – άρθρο 45 του κώδικα ΦΠΑ
7	Χωρίς ΦΠΑ – άρθρο 22 του Κώδικα Φ.Π.Α	23	Περιλαμβάνεται ΦΠΑ – άρθρο 46 του κώδικα ΦΠΑ
8	Χωρίς ΦΠΑ – άρθρο 24 του Κώδικα Φ.Π.Α	24	Χωρίς ΦΠΑ – άρθρο 6 του Κώδικα Φ.Π.Α
9	Χωρίς ΦΠΑ – άρθρο 25 του Κώδικα Φ.Π.Α	25	Χωρίς ΦΠΑ – POL.1029/1995
10	Χωρίς ΦΠΑ – άρθρο 26 του Κώδικα Φ.Π.Α	26	Χωρίς ΦΠΑ – POL.1167/2015
11	Χωρίς ΦΠΑ – άρθρο 27 του Κώδικα Φ.Π.Α	27	Άλλες Εξαιρέσεις ΦΠΑ
12	Χωρίς ΦΠΑ – άρθρο 27 – Θαλάσσια σκάφη του κωδικού Φ.Π.Α	28	Χωρίς ΦΠΑ – άρθρο 24 παρ. β’ παρ.1 του τον Κώδικα ΦΠΑ, (αφορολόγητο)
13	Χωρίς ΦΠΑ – άρθρο 27.1.γ – Θαλάσσια σκάφη του κωδικού Φ.Π.Α	29	Χωρίς ΦΠΑ – άρθρο 47β του Κώδικα ΦΠΑ (ΟΣΣ καθεστώς εκτός ΕΕ)
14	Χωρίς ΦΠΑ – άρθρο 28 του Κώδικα Φ.Π.Α	30	Χωρίς ΦΠΑ – άρθρο 47γ, του Κώδικα Φ.Π.Α (Κατάσταση OSS ΕΕ)
15	Χωρίς ΦΠΑ – άρθρο 39 του Κώδικα Φ.Π.Α	31	Χωρίς ΦΠΑ – άρθρο 47δ του Κωδικός ΦΠΑ (IOSS)
16	Χωρίς ΦΠΑ – άρθρο 39α του Κώδικα Φ.Π.Α

8.4 Παρακράτηση φόρων

Κωδ.	Περιγραφή	Φόρος
1	Περίπτωση β’ – Τόκοι – 15%	15%
2	Περίπτωση γ’ – Δικαιώματα – 20%	20%
3	Περίπτωση δ’ – Αμοιβές συμβούλων διαχείρισης – 20%	20%
4	Περίπτωση δ’ – Τεχνικά Έργα – 3%	3%
5	Υγρά καύσιμα και προϊόντα καπνοβιομηχανίας – 1%	1%
6	Άλλα αγαθά – 4%	4%
7	Παροχή Υπηρεσιών – 8%	8%
8	4% Φόρος Αρχιτέκτων και Μηχανικού επί Συμβατικών Αμοιβών για Σύνταξη Έρευνας και Σχεδίων, Προκαταβολή	4%
9	10% Φόρος Αρχιτέκτων και Μηχανικού επί Συμβατικές Αμοιβές για οποιοδήποτε άλλο Έργο, Προκαταβολή	10%
10	Φόρος δικηγορικής αμοιβής 15%, προκαταβολή	15%
11	Παρακράτηση Φόρου Μισθωτών Υπηρεσιών (άρθρο 15 παρ. 1 Ν. 4172/2013)	Ποσό
12	Παρακράτηση Φόρου Μισθωτών Υπαλλήλων Εμπορικού Ναυτικού (άρθρο 15 παρ. 2 Ν. 4172/2013)	15%
13	Παρακράτηση φόρου μισθωτών πληρωμάτων κατώτερης βαθμίδας Εμπορικού Ναυτικού (άρθρο 15 παράγραφος 2 του Ν. 4172/2013)	10%
14	Ειδική Παρακράτηση Εισφοράς Αλληλεγγύης	Ποσό
15	Αποζημίωση Καταγγελίας Παρακράτησης Φόρου Απασχόλησης (άρθρο 15 παρ. 3 Ν. 4172/2013)	Ποσό
16	Παρακράτηση συναλλαγών στο εξωτερικό βάσει συμφωνιών αποφυγής διπλή φορολογία (S.A.D.F.)	Ποσό
17	Άλλες φορολογικές εκπτώσεις	Ποσό
18	Παρακρατούμενο Φόρο Μερίσματα ανά παρ. 1 αρ. 64 n. 4172/2013	5%

8.5 Άλλοι φόροι

Κωδ.	Περιγραφή	Φόρος
3	β) 4% ασφάλιστρα ζωής	4%
4	γ) 15% λοιπά ασφάλιστρα	15%
5	δ) 0% αφορολόγητα ασφάλιστρα	0%
6	Ξενοδοχεία 1-2 αστέρων 0,50 €	Ποσό
7	Ξενοδοχεία 3 αστέρων 1,50 €	Ποσό
8	Ξενοδοχεία 4 αστέρων 3,00 €	Ποσό
9	Ξενοδοχεία 5 αστέρων 4,00 €	Ποσό
10	Ενοικιαζόμενα δωμάτια – Επιπλωμένα δωμάτια – Διαμερίσματα 0,50 €	Ποσό
11	Ειδικός φόρος 5% σε τηλεοπτικές διαφημίσεις (EFTD)	5%
12	Φόρος πολυτελείας 10% επί της φορολογητέας αξίας των ενδοκοινοτικών αγαθών που αποκτώνται και αυτών που εισάγονται από τρίτες χώρες	10%
13	Φόρος πολυτελείας 10% στην τιμή πώλησης προ ΦΠΑ για τα εγχώρια προϊόντα	10%
14	80% Δημόσια τέλη στην τιμή του εισιτηρίου εισόδου για τα καζίνο	80%
15	Ασφάλιστρα ζωής 20%	20%
16	Δασμοί-Φορολογία	Ποσό
17	Άλλοι φόροι	Ποσό
18	Χρεώσεις άλλων φόρων	Ποσό
19	ΕΦΚ – Ειδικός Φόρος Κατανάλωσης	Ποσό

8.6 Τέλος χαρτοσήμου

Κωδ.	Περιγραφή	Φόρος
1	Τιμή 1,2 %	1,20%
2	Τιμή 2,4 %	2,40%
3	Τιμή 3,6 %	3,60%
4	Άλλες περιπτώσεις χαρτοσήμου	Ποσό

8.7 Αμοιβές

Κωδ.	Περιγραφή	Φόρος
1	12% για μηνιαίους λογαριασμούς έως 50€	12,00%
2	15% για μηνιαίους λογαριασμούς μεταξύ 50,01 € και 100	15,00%
3	18% για μηνιαίους λογαριασμούς μεταξύ 100,01 € και 150 €	18,00%
4	20% για μηνιαίους λογαριασμούς άνω των 150€	20,00%
5	Προπληρωμένο τέλος τηλεφωνίας 12% στον χρόνο ομιλίας	12,00%
6	10% τηλεοπτική συνδρομή	10,00%
7	5% χρέωση συνδρομητή σταθερού τηλεφώνου	5,00%
8	Οικολογικός φόρος και φόρος πλαστικής σακούλας (άρθρο 6Α του Ν. 2339/2001)	Ποσό
9	Εισφορά δακοκτονίας 2%	2,00%
10	Άλλες αμοιβές	Ποσό
11	Λοιπά Φορολογικά Τέλη	Ποσό
12	Εισφορά δακοκτονίας	Ποσό
13	Για μηνιαίο λογαριασμό κάθε σύνδεσης (10%)	10%
14	Τέλος καρτοκινητής επί της αξίας του χρόνου ομιλίας (10%)	10%
15	Τέλος κινητής και καρτοκινητής για φυσικά πρόσωπα ηλικίας 15 έως και 29 ετών (0%)	0%
16	Εισφορά προστασίας περιβάλλοντος πλαστικών προϊόντων 0,04 λεπτά ανά τεμάχιο [άρθρο 4 ν. 4736/2020]	Ποσό
17	Τέλος ανακύκλωσης 0,08 λεπτά ανά τεμάχιο [άρθρο 80 ν. 4819/2021]	Ποσό
18	Τέλος διαμονής παρεπιδημούντων	Ποσό
19	Τέλος επί των ακαθάριστων εσόδων των εστιατορίων και συναφών καταστημάτων	Ποσό
20	Τέλος επί των ακαθάριστων εσόδων των κέντρων διασκέδασης	Ποσό
21	Τέλος επί των ακαθάριστων εσόδων των καζίνο	Ποσό
22	Λοιπά τέλη επί των ακαθάριστων εσόδων	Ποσό

8.8 Κατηγορία κατάταξης εισοδήματος

Κωδ.	Περιγραφή
category1_1	Έσοδα από Πώληση Εμπορευμάτων (+) / (-)
category1_2	Έσοδα από Πώληση Προϊόντων (+) / (-)
category1_3	Έσοδα από Παροχή Υπηρεσιών (+) / (-)
category1_4	Έσοδα από Πώληση Παγίων (+) / (-)
category1_5	Λοιπά Έσοδα/ Κέρδη (+) / (-)
category1_6	Αυτοπαραδόσεις / Ιδιοχρησιμοποιήσεις (+) / (-)
category1_7	Έσοδα για λ/σμο τρίτων (+) / (-)
category1_8	Έσοδα προηγούμενων χρήσεων (+)/ (-)
category1_9	Έσοδα επομένων χρήσεων (+) / (-)
category1_10	Λοιπές Εγγραφές Τακτοποίησης Εσόδων (+) / (-)
category1_95	Λοιπά Πληροφοριακά Στοιχεία Εσόδων (+) / (-)

8.9 Τύπος ταξινόμησης εισοδήματος

Κωδ.	Περιγραφή
E3_106	Ιδιοπαραγωγή παγίων – Αυτοπαραδόσεις – Καταστροφές αποθεμάτων/Εμπορεύματα
E3_205	Ιδιοπαραγωγή παγίων – Αυτοπαραδόσεις – Καταστροφές αποθεμάτων/Πρώτες ύλες και λοιπά υλικά
E3_210	Ιδιοπαραγωγή παγίων – Αυτοπαραδόσεις – Καταστροφές αποθεμάτων/Προϊόντα και παραγωγή σε εξέλιξη
E3_305	Ιδιοπαραγωγή παγίων – Αυτοπαραδόσεις – Καταστροφές αποθεμάτων/Πρώτες ύλες και λοιπά υλικά
E3_310	Ιδιοπαραγωγή παγίων – Αυτοπαραδόσεις – Καταστροφές αποθεμάτων/Προϊόντα και παραγωγή σε εξέλιξη
E3_318	Ιδιοπαραγωγή παγίων – Αυτοπαραδόσεις – Καταστροφές αποθεμάτων/Έξοδα παραγωγής
E3_561_001	Πωλήσεις αγαθών και υπηρεσιών Χονδρικές – Επιτηδευματιών
E3_561_002	Πωλήσεις αγαθών και υπηρεσιών Χονδρικές βάσει άρθρου 39α παρ 5 του Κώδικα Φ.Π.Α. (Ν.2859/2000)
E3_561_003	Πωλήσεις αγαθών και υπηρεσιών Λιανικές – Ιδιωτική Πελατεία
E3_561_004	Πωλήσεις αγαθών και λιανικών βάσει άρθρου 39α παρ 5 του Κώδικα Φ.Π.Α. (Ν.2859/2000)
E3_561_005	Πωλήσεις αγαθών και υπηρεσιών Εξωτερικού Ενδοκοινοτικές
E3_561_006	Πωλήσεις αγαθών και υπηρεσιών Εξωτερικού Τρίτες Χώρες
E3_561_007	Πωλήσεις αγαθών και υπηρεσιών Λοιπά
E3_562	Λοιπά συνήθη έσοδα
E3_563	Πιστωτικοί τόκοι και συναφή έσοδα
E3_564	Πιστωτικές συναλλαγματικές διαφορές
E3_565	Έσοδα συμμετοχών
E3_566	Κέρδη από διάθεση μη κυκλοφορούντων περιουσιακών στοιχείων
E3_567	Κέρδη από αναστροφή προβλέψεων και απομειώσεων
E3_568	Κέρδη από επιμέτρηση στην εύλογη αξία
E3_570	Ασυνήθη έσοδα και κέρδη
E3_595	Έξοδα σε ιδιοπαραγωγή
E3_596	Επιδοτήσεις – Επιχορηγήσεις
E3_597	Επιδοτήσεις – Επιχορηγήσεις για επενδυτικούς σκοπούς – κάλυψη δαπανών
E3_880_001	Πωλήσεις Παγίων Χονδρικές
E3_880_002	Πωλήσεις Παγίων Λιανικές
E3_880_003	Πωλήσεις Παγίων Εξωτερικού Ενδοκοινοτικές
E3_880_004	Πωλήσεις Παγίων Εξωτερικού Τρίτες Χώρες
E3_881_001	Πωλήσεις για λογ/σμο Τρίτων Χονδρικές
E3_881_002	Πωλήσεις για λογ/σμο Τρίτων Λιανικές
E3_881_003	Πωλήσεις για λογ/σμο Τρίτων Εξωτερικών Ενδοκοινοτικές
E3_881_004	Πωλήσεις για λογ/σμο Τρίτων Εξωτερικού Τρίτες Χώρες

8.10 Κατηγορία Κατάταξης Εξόδων

Κωδ.	Περιγραφή
category2_1	Αγορές Εμπορευμάτων (-) / (+)
category2_2	Αγορές Α’-Β’ Υλών (-) / (+)
category2_3	Λήψη Υπηρεσιών (-) / (+)
category2_4	Γενικά Έξοδα με δικαίωμα έκπτωσης ΦΠΑ (-) / (+)
category2_5	Γενικά Έξοδα χωρίς δικαίωμα έκπτωσης ΦΠΑ (-) / (+)
category2_6	Αμοιβές και Παροχές προσωπικού (-) / (+)
category2_7	Αγορές Παγίων (-) / (+)
category2_8	Αποσβέσεις Παγίων (-) / (+)
category2_9	Έξοδα για λ/σμο τρίτων (-) / (+)
category2_10	Έξοδα προηγούμενων χρήσεων (-) / (+)
category2_11	Έξοδα επομένων χρήσεων (-) / (+)
category2_12	Λοιπές Εγγραφές Τακτοποίησης Εξόδων (-) / (+)
category2_13	Αποθέματα Έναρξης Περιόδου (-) / (+)
category2_14	Αποθέματα Λήξης Περιόδου (-) / (+)
category2_95	Λοιπά Πληροφοριακά Στοιχεία Εξόδων (-) / (+)

8.11 Είδος ταξινόμησης δαπανών

Κωδ.	Περιγραφή
E3_101	Εμπορεύματα έναρξης
E3_102_001	Αγορές εμπορευμάτων χρήσης (καθαρό ποσό)/Χονδρικές
E3_102_002	Αγορές εμπορευμάτων χρήσης (καθαρό ποσό)/Λιανικές
E3_102_003	Αγορές εμπορευμάτων χρήσης (καθαρό ποσό)/Αγαθών του άρθρου 39α παρ.5 του Κώδικα Φ.Π.Α. (ν.2859/2000)
E3_102_004	Αγορές εμπορευμάτων χρήσης (καθαρό ποσό)/Εξωτερικού Ενδοκοινοτικές
E3_102_005	Αγορές εμπορευμάτων χρήσης (καθαρό ποσό)/Εξωτερικού Τρίτες Χώρες
E3_102_006	Αγορές εμπορευμάτων χρήσης (καθαρό ποσό)Λοιπά
E3_104	Εμπορεύματα λήξης
E3_201	Πρώτες ύλες και υλικά έναρξης/Παραγωγή
E3_202_001	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Χονδρικές
E3_202_002	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Λιανικές
E3_202_003	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Εξωτερικού Ενδοκοινοτικές
E3_202_004	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Εξωτερικού Τρίτες Χώρες
E3_202_005	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Λοιπά
E3_204	Αποθέματα λήξης πρώτων υλών και υλικών/Παραγωγή
E3_207	Προϊόντα και παραγωγή σε εξέλιξη έναρξης/Παραγωγή
E3_209	Προϊόντα και παραγωγή σε εξέλιξη λήξης/Παραγωγή
E3_301	Πρώτες ύλες και υλικά έναρξης/Αγροτική
E3_302_001	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Χονδρικές
E3_302_002	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Λιανικές
E3_302_003	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Εξωτερικού Ενδοκοινοτικές
E3_302_004	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Εξωτερικού Τρίτες Χώρες
E3_302_005	Αγορές πρώτων υλών και υλικών χρήσης (καθαρό ποσό)/Λοιπά
E3_304	Αποθέματα λήξης πρώτων υλών και υλικών/Αγροτική
E3_307	Προϊόντα και παραγωγή σε εξέλιξη έναρξης/Αγροτική
E3_309	Προϊόντα και παραγωγή σε εξέλιξη λήξης/Αγροτική
E3_312	Αποθέματα έναρξης (ζώων – φυτών)
E3_313_001	Αγορές ζώων – φυτών (καθαρό ποσό)/Χονδρικές
E3_313_002	Αγορές ζώων – φυτών (καθαρό ποσό)/Λιανικές
E3_313_003	Αγορές ζώων – φυτών (καθαρό ποσό)/Εξωτερικού Ενδοκοινοτικές
E3_313_004	Αγορές ζώων – φυτών (καθαρό ποσό)/Εξωτερικού Τρίτες Χώρες
E3_313_005	Αγορές ζώων – φυτών (καθαρό ποσό)/Λοιπά
E3_315	Αποθέματα τέλους (ζώων – φυτών)/Αγροτική
E3_581_001	Παροχές σε εργαζόμενους/Μικτές αποδοχές
E3_581_002	Παροχές σε εργαζόμενους/Εργοδοτικές εισφορές
E3_581_003	Παροχές σε εργαζόμενους/Λοιπές εξοπλισμός
E3_582	Ζημιές επιμέτρησης περιουσιακών στοιχείων
E3_583	Χρεωστικές συναλλαγματικές διαφορές
E3_584	Ζημιές από διάθεση-απόσυρση μη κυκλοφορούντων περιουσιακών στοιχείων
E3_585_001	Προμήθειες διαχείρισης ημεδαπής – αλλοδαπής (management fees)
E3_585_002	Δαπάνες από συνδεδεμένες επιχειρήσεις
E3_585_003	Δαπάνες από μη συνεργαζόμενα κράτη ή από κράτη με προνομιακό φορολογικό καθεστώς
E3_585_004	Δαπάνες για ενημερωτικές ημερίδες
E3_585_005	Έξοδα υποδοχής και φιλοξενίας
E3_585_006	Έξοδα ταξιδιών
E3_585_007	Ασφαλιστικές Εισφορές Αυτοαπασχολούμενων
E3_585_008	Έξοδα και προμήθειες παραγγελιοδόχου για λογαριασμό αγροτών
E3_585_009	Λοιπές Αμοιβές για υπηρεσίες ημεδαπής
E3_585_010	Λοιπές Αμοιβές για υπηρεσίες αλλοδαπής
E3_585_011	Ενέργεια
E3_585_012	Ύδρευση
E3_585_013	Τηλεπικοινωνίες
E3_585_014	Ενοίκια
E3_585_015	Διαφήμιση και προβολή
E3_585_016	Λοιπά έξοδα
E3_586	Χρεωστικοί τόκοι και συναφή έξοδα
E3_587	Αποσβέσεις
E3_588	Ασυνήθη έξοδα, ζημιές και πρόστιμα
E3_589	Προβλέψεις (εκτός από προβλέψεις για το προσωπικό)
E3_882_001	Αγορές ενσώματων παγίων χρήσης/Χονδρικές
E3_882_002	Αγορές ενσώματων παγίων χρήσης/Λιανικές
E3_882_003	Αγορές ενσώματων παγίων χρήσης/Εξωτερικού Ενδοκοινοτικές
E3_882_004	Αγορές ενσώματων παγίων χρήσης/Εξωτερικού Τρίτες Χώρες
E3_883_001	Αγορές μη ενσώματων παγίων χρήσης/Χονδρικές
E3_883_002	Αγορές μη ενσώματων παγίων χρήσης/Λιανικές
E3_883_003	Αγορές μη ενσώματων παγίων χρήσης/Εξωτερικού Ενδοκοινοτικές
E3_883_004	Αγορές μη ενσώματων παγίων χρήσης/Εξωτερικού Τρίτες Χώρες
VAT_361	Αγορές & δαπάνες στο εσωτερικό της χώρας
VAT_362	Αγορές & εισαγωγές επενδ. Αγαθών (πάγια)
VAT_363	Λοιπές εισαγωγές εκτός επενδ. Αγαθών (πάγια)
VAT_364	Ενδοκοινοτικές αποκτήσεις αγαθών
VAT_365	Ενδοκοινοτικές λήψεις υπηρεσιών άρθρ. 14.2.α
VAT_366	Λοιπές πράξεις λήπτη

8.12 Μέθοδοι πληρωμής

Κωδ.	Περιγραφή
1	Επαγ. Λογαριασμός Πληρωμών Ημεδαπής
2	Επαγ. Λογαριασμός Πληρωμών Αλλοδαπής
3	Μετρητά
4	Επιταγή
5	Επί Πιστώσει
6	Web Banking
7	POS / e-POS
8	Άμεσες Πληρωμές IRIS

8.13 Μονάδα μέτρησης

Κωδ.	Περιγραφή
1	Τεμάχια
2	Κιλά
3	Λίτρα
4	Πρόσθετο (αγνοείται στο σύνολο ποσότητας)
5	Τετραγωνικά Μέτρα
6	Κυβικά Μέτρα
7	Τεμάχια_Λοιπές Περιπτώσεις

8.14 Σκοπός κίνησης

Κωδ.	Περιγραφή
1	Πώληση
2	Πώληση για Λογαριασμό Τρίτων
3	Δειγματισμός
4	Έκθεση
5	Επιστροφή
6	Φύλαξη
7	Επεξεργασία Συναρμολόγηση
8	Μεταξύ Εγκαταστάσεων Οντότητας
9	Αγορά
10	Εφοδιασμός πλοίων και αεροσκαφών
11	Δωρεάν διάθεση
12	Εγγύηση
13	Χρησιδανεισμός
14	Αποθήκευση σε Τρίτους
15	Επιστροφή από Φύλαξη
16	Ανακύκλωση
17	Καταστροφή άχρηστου υλικού
18	Διακίνηση Παγίων (Ενδοδιακίνηση)
19	Λοιπές Διακινήσεις

8.15 Παρατηρήσεις

Κωδ.	Περιγραφή
1	Εκκαθάριση Πωλήσεων Τρίτων
2	Αμοιβή από Πωλήσεις Τρίτων

8.16 Τύπος εγγραφής

Κωδ.	Περιγραφή	Παρατηρήσεις
1	Ειδική Γραμμή Παρακρατούμενων Φόρων	Ανενεργός – για μελλοντική χρήση
2	Γραμμή Τέλους με Φ.Π.Α.
3	Γραμμή Λοιπών Φόρων με Φ.Π.Α
4	Ειδική Γραμμή Χαρτοσήμου	Ανενεργός – για μελλοντική χρήση
5	Ειδική Γραμμή Κρατήσεων	Ανενεργός – για μελλοντική χρήση
6	Δωροεπιταγή
7	Αρνητικό πρόσημο αξιών	Έγκυρο μόνο στις περιπτώσεις των παραστατικών 17.3, 17.4, 17.5 και 17.6 και υποδηλώνει ότι τα ποσά των αξιών της γραμμής είναι αρνητικά

8.17 Κωδικοί καυσίμου

Κωδ.	Περιγραφή
10	Benzine 95RON
11	Benzine 95RON+
12	Benzine 100RON
13	Benzine LRP
20	Diesel
21	Diesel premium
30	Diesel Heatnn
31	Diesel Heat premium
32	Diesel Linht
40	LPG (υγραέριο)
50	CNG (πεπιεσμένο φυσικό αέριο)
60	Αρωματικοί Υδρογονάνθρακες Δασμολογικής Κλάσης 2707
61	Κυκλικοί Υδρογονάνθρακες Δασμολογικής Κλάσης 2902
70	Ελαφρύ πετρέλαιο (WHITE SPIRIT)
71	Ελαφριά λάδια
72	Βιοντίζελ
999	Λοιπές χρεώσεις υπηρεσιών. Χρησιμοποιείται στις περιπτώσεις που σε ένα παραστατικό εκτός από καύσιμα υπάρχει η ανάγκη να τιμολογούνται και λοιπές χρεώσεις μικρών ποσών

8.18 Τύπος Απόκλισης Παραστατικού

Κωδ.	Περιγραφή	Παρατηρήσεις
1	Διαβίβαση Παράλειψης από Λήπτη	Χρησιμοποιείται αυτή η τιμή για Διαβίβαση Δεδομένων από τον Λήπτη λόγω Παράλειψης Διαβίβασης του Εκδότη. Επιτρεπτοί τύποι παραστατικών: 1.1, 1.6, 2.1, 2.4, 5.2, 8.1 και 8.2
2	Διαβίβαση Παράλειψης από Εκδότη	Χρησιμοποιείται αυτή η τιμή για Διαβίβαση Δεδομένων από τον Εκδότη, στην περίπτωση που συμφωνεί με την επισήμανση του Λήπτη περί παράλειψης διαβίβασης από μέρους του (εκδότη) Επιτρεπτοί τύποι παραστατικών:11.3, 11.4, 13.1, και 13.31
3	Διαβίβαση Απόκλισης από Λήπτη	Χρησιμοποιείται αυτή η τιμή για Διαβίβαση Δεδομένων (μη αντικριζόμενα παραστατικά) από τον Λήπτη λόγω Απόκλισης Διαβίβασης Δεδομένων από τον Εκδότη Επιτρεπτοί τύποι παραστατικών: 11.3, 11.4, 13.1, και 13.31 (Ειδικά και αποκλειστικά για παραστατικά που εκδόθηκαν εντός του 2021 οι επιτρεπτοί τύποι είναι οι 1.1 και 5.2)
4	Διαβίβαση Απόκλισης από Εκδότη	Χρησιμοποιείται αυτή η τιμή για Διαβίβαση Δεδομένων από τον Εκδότη, στην περίπτωση που συμφωνεί με την επισήμανση του Λήπτη «Απόκλιση Διαβίβασης» στον αντικριζόμενο Τύπο Παραστατικού Α1 που είχε διαβιβάσει στον Λήπτη Επιτρεπτοί τύποι παραστατικών: 11.3, 11.4, 13.1, και 13.31

8.19 Ειδική Κατηγορία Παραστατικού

Κωδ.	Περιγραφή	Παρατηρήσεις
1	Επιδοτήσεις – Επιχορηγήσεις
2	Έσοδα Λιανικής Ξενοδοχείων – Χρεώσεις Δωματίου
3	Λογιστική Εγγραφή
4	Tax Free	Έγκυρη τιμή μόνο για διαβίβαση μέσω erp ή έκδοση μέσω παρόχου ή timologio
5	Σύνθετες συναλλαγές ημεδαπής – αλλοδαπής
6	Δικαιούχοι του άρθρου 3 της υπό στοιχεία 139818 ΕΞ2022/28.09.2022 (Β’5083) κοινής υπουργικής απόφασης
7	Αγορά αγροτικών αγαθών υπηρεσιών Άρθρο 41 του Κώδικα ΦΠΑ
8	Έσοδα Λιανικών ΦΗΜ ΑΑΔΕ_1 Μόνο για ανάγνωση – μη έγκυρη τιμή για αποστολή μέσω ERP / Πάροχο
9	Έσοδα Λιανικών ΦΗΜ ΑΑΔΕ_2	Μόνο για ανάγνωση – μη έγκυρη τιμή για αποστολή μέσω ERP / Πάροχο
10	Έσοδα Λιανικών ΦΗΜ Επιχείρησης Απόκλιση
11	Επίδομα Θέρμανσης
12	Συναλλαγές εστίασης

9. Παράρτημα Β

Ένα παραστατικό έχει την ακόλουθη δομή

10. Παραδείγματα XML

10.1 Δημιουργία παραστατικού

Αίτηση

Μέθοδος POST με HEADER (API-KEY και CONTENT-TYPE)

…/sendinvoice.php

<!– 1 **18792** AUTOPARK DUSSELDORF GMBH –>

</issuer>

<name>AUTOPARK DUSSELDORF GMBH</name>

<city>DUSSELDORF </city>

</address>

</counterpart>

</invoiceHeader>

</paymentMethodDetails>

</paymentMethods>

<!– SHARP RZ E701 0,0000000000014% €8,06451612903219 –>

<!– provider –>

<measurementUnitLabel>ΤΕΜΑΧΙΟ</measurementUnitLabel>

<lineCode>SHARP RZ E701</lineCode>

<lineDescription>SHARP RZ E701</lineDescription>

<!– –>

<N1:classificationType>E3_561_005</N1:classificationType>

<N1:classificationCategory>category1_1</N1:classificationCategory>

<N1:amount>8.06</N1:amount>

<N1:id>1</N1:id>

</incomeClassification>

</invoiceDetails>

<!– provider –>

<API_InvoiceDetails>

<API_Issuer>

<IssuerProfession>ΕΜΠΟΡΙΟ</IssuerProfession>

<IssuerTaxoffice>ΑΘΗΝΩΝ</IssuerTaxoffice>

<IssuerAddressStreet>ΙΑΣΩΝΙΔΟΥ 20 ΕΛΛΗΝΙΚΟ</IssuerAddressStreet>

</API_Issuer>

<API_Counterpart>

<CounterpartName>AUTOPARK DUSSELDORF GMBH</CounterpartName>

<CounterpartAddressStreet>FORSTSTRASSE 27 29 HILDEN</CounterpartAddressStreet>

<CounterpartAddressCity>DUSSELDORF</CounterpartAddressCity>

<CounterpartEmail>info@autopd.de</CounterpartEmail>

</API_Counterpart>

<API_Additionals>

<DocumentLabel>ΤΙΜΟΛΟΓΙΟ – ΔΕΛΤΙΟ ΑΠΟΣΤΟΛΗΣ</DocumentLabel>

<paymentMethodInvoiceLabel>ΠΙΣΤΩΣΗ</paymentMethodInvoiceLabel>

<Logo_ID>1</Logo_ID>

</API_Additionals>

</API_InvoiceDetails>

<!– –>

<N1:classificationType>E3_561_005</N1:classificationType>

<N1:classificationCategory>category1_1</N1:classificationCategory>

<N1:amount>8.06</N1:amount>

<N1:id>1</N1:id>

</incomeClassification>

</invoiceSummary>

</invoice>

</InvoicesDoc>

Απάντηση

<?xml version=”1.0″ encoding=”utf-8″?>

<statusCode>Success</statusCode>

<InvoiceUrl>https://api.sbz.gr/sign/doc.php/8761DDC45884684F0BEFF93FED3B8B37B5D1F7C4/production/</InvoiceUrl>

</response>

</SBZResponseDoc>

<!– RUID: [5C86DB8FDE417509630911038DAA95A73857CCFD] –>

Περισσότερες δοκιμές μπορούν να γίνουν χρησιμοποιώντας το Postman

10.2 Αίτημα μεταδιδόμενων εγγράφων

Αίτηση

Μέθοδος GET με HEADER (API-KEY και CONTENT-TYPE)

../requesttransmitteddocs.php

Απάντηση

<invoiceUrl>https://api.sbz.gr/sign/doc.php/7C93AC58AEFA1542EE648981236CFCB863854FC5/production/</invoiceUrl>

</InvoiceProviderType>

</RequestedProviderDoc>

10.3 Αίτημα υπογραφής πληρωμής

Αίτηση

Μέθοδος POST με HEADER (API-KEY και CONTENT-TYPE)

../paymentsignature.php

<?xml version=”1.0″ encoding=”UTF-8″?>

</ERPpayment>

Απάντηση

<SigningAuthor>013</SigningAuthor> <Signature>3046022100a32a9776f774afc0990d5fa13f288daf0b98c943507f05eef480653b697a399a022100947f00e0ccc6c528d0cacdac6bca87e088f1f5f87c9004e193266447133bf204</Signature>

<statusCode>Signature is valid</statusCode> <Comments>448925613-2024-10-03-0-11.1-Δ-11765|0|D4333239CFEF5FF5810FCB0121688AE2804XXX;;20241003124834;1649;1458;191;1649;67353113</Comments>

<pos_transactionId>698420127</pos_transactionId>

<pos_answer>success</pos_answer>

<pos_transactionText>tr1;108;427702042242;562328</pos_transactionText>

<pos_TerminalID>67353113</pos_TerminalID>

</response>

</ERPpayment>

11. Ειδικοί χαρακτήρες

Οι ακόλουθοι χαρακτήρες δεν γίνονται δεκτοί σε κανένα πεδίο κειμένου του xml και πρέπει να αποστέλλονται με τον σωστό τρόπο.

Χαρακτήρας	Σωστός τρόπος αποστολής	Παράδειγμα
<	<	XML: < SBZ > Output: <SBZ>
>	>	XML: < SBZ > Output: <SBZ>
&	&	XML: BOYS & GIRLS Output: BOYS & GIRLS

12. Διαχείριση API

Σημειώστε ότι η Διαχείριση API είναι διαθέσιμη μετά τη διαδικασία πιστοποίησης.

Εδώ μπορείτε να συνδεθείτε με τα διαπιστευτήρια που θα σας στείλουμε μετά τη διαδικασία πιστοποίησης.

Στη διαχείριση έχεις τις ακόλουθες επιλογές:

Ανέβασε το λογότυπο της εταιρίας σου για τα παραστατικά που εκδίδεις και όρισέ το αλλάζοντας τη τιμή logo_id.
Πρόσθεσε μονάδες αγοράζοντας ένα πακέτο μέσω πιστωτικής ή χρεωστικής κάρτας.
Δες όλα τα παραστατικά που εκδίδονται μέσω API.
Κατέβασε όλα τα παραστατικά που εκδίδονται μέσω API.
Έλεγξε το υπόλοιπό σου.
Απόκτησε την πιο πρόσφατη έκδοση του Rest API.

12.1 Επαλήθευση παραστατικού

Για να ελέγξουμε ένα παραστατικό που έχει εκδοθεί επιλέγουμε στην αρχική σελίδα Επαλήθευση παραστατικού και στη συνέχεια γράφουμε το mark ή το κωδικό αυθεντικοποίησής του και πατάμε το μεγεθυντικό φακό.

12.2 XML παραστατικού βάσει του προτύπου EN 16931-1:2017

Στο διαχειριστικό, στη στήλη ΜΑΡΚ δίπλα στο XML του παραστατικού υπάρχει εικονίδιο με το σήμα της Ευρωπαϊκής ένωσης για λήψη του XML βάσει του προτύπου EN 16931-1:2017- Electronic Invoicing.

Παράδειγμα:

<?xml version=”1.0″ encoding=”UTF-8″?>

<!– Header information –>

<BT-1>448925613|2023-03-08|0|1.1|E|25</BT-1>

<!– Seller information –>

<BG-4>

<BT-27>DEMO COMPANY AE</BT-27>

<BT-28>DEMO COMPANY AE</BT-28>

<BT-30></BT-30>

<BT-31>EL448925613</BT-31>

<BT-34>support@sbzsystems.com</BT-34>

</BG-4>

<BG-5>

<BT-35>ΙΑΣΩΝΙΔΟΥ 20 ΕΛΛΗΝΙΚΟ</BT-35>

<BT-37></BT-37>

<BT-38></BT-38>

<BT-40>GR</BT-40>

</Country>

</BG-5>

<!– Buyer information –>

<BG-7>

<BT-44>ΑΛΕΚΟΣ ΠΑΠΑΔΟΠΟΥΛΟΣ</BT-44>

<BT-48>EL026883248</BT-48>

<BT-49></BT-49>

</BG-7>

<BG-8>

<BT-50></BT-50>

<BT-52>ΑΘΗΝΑ</BT-52>

<BT-53>21354</BT-53>

<BT-55>GR</BT-55>

</Country>

</BG-8>

<BG-11>

<BT-62></BT-62>

<BT-63></BT-63>

</BG-11>

<!– Deliver to address –>

<BG-15>

<BT-75></BT-75>

<BT-77>ΑΘΗΝΑ</BT-77>

<BT-78>21354</BT-78>

</BG-15>

<!– Invoice line items –>

<!– Line 1 –>

<BG-25>

<BT-126>1</BT-126>

<BT-129>1,00</BT-129>

<BT-131>42,00</BT-131>

</BG-25>

<BG-31>

<BT-151>S</BT-151>

<BT-152>24,00</BT-152>

</BG-31>

<!– Line 2 –>

<BG-25>

<BT-126>2</BT-126>

<BT-129>1,00</BT-129>

<BT-131>10,00</BT-131>

</BG-25>

<BG-31>

<BT-151>S</BT-151>

<BT-152>24,00</BT-152>

</BG-31>

<!– Document level allowances –>

<BG-20>

<BT-92>0,00</BT-92>

<BT-95>S</BT-95>

</BG-20>

<!– Document level charges –>

<BG-21>

<BT-102>S</BT-102>

<BT-110>12,48</BT-110>

<BT-112>64,48</BT-112>

</BG-21>

<!– 24,00% –>

<BG-23>

<BT-116>52,00</BT-116>

<BT-117>12,48</BT-117>

<BT-119>24,00</BT-119>

<BT-120></BT-120>

<BT-121></BT-121>

<BT-118>S</BT-118>

</BG-23>

</Invoice>

13. Υποχρεώσεις παρόχου

Ως πάροχος ενημερώνουμε και επικαιροποιούμε τον κατάλογο των αντισυμβαλλόμενων οντοτήτων με τις οποίες συμβαλλόμαστε, άμεσα, με κάθε μεταβολή. Ο κατάλογος αυτός περιέχει βασικά στοιχεία, όπως την επωνυμία, τη διεύθυνση, το ΑΦΜ και τη φύση της συμβαλλόμενης σχέσης.
Είμαστε υπεύθυνοι για την ταυτοποίηση της οντότητας που υποστηρίζουμε και με την οποία συμβαλλόμαστε. Η διαδικασία ταυτοποίησης της οντότητας γίνεται μέσω των κωδικών TAXISNET που αποδίδονται σε κάθε οντότητα που προσφέρει ή λαμβάνει υπηρεσίες μέσω της πλατφόρμας.
Ως πάροχος είμαστε υποχρεωμένοι να δηλώσουμε εντός δέκα (10) ημερών, σε ηλεκτρονική υπηρεσία της Α.Α.Δ.Ε., τη σύναψη σύμβασης με την εκάστοτε οντότητα που συμβαλλόμαστε. Η ίδια υποχρέωση δήλωσης και στο ίδιο χρονικό διάστημα επιβάλλεται και στη συμβεβλημένη οντότητα, η οποία πρέπει να δηλώσει επίσης τα στοιχεία του παρόχου και των υπηρεσιών που προσφέρει.
Λαμβάνουμε όλα τα απαραίτητα μέτρα, ώστε το λογισμικό ΥΠΑΗΕΣ, που διαθέτουμε προς χρήση, να διασφαλίζει πλήρως την έκδοση παραστατικού, καθώς και την αυθεντικοποίηση αυτού (πιστοποίηση προέλευσης και ακεραιότητα του περιεχομένου του). Φέρουμε ευθύνη απέναντι στην υπόχρεη οντότητα για τη διασφάλιση της έκδοσης, αυθεντικοποίησης του συνόλου των παραστατικών αυτής και διαβίβασης αυτών στη διεπαφή ‘’myDATA’’, μέσω των παρεχόμενων από εμάς υπηρεσιών. Τα παραστατικά αυθεντικοποιούνται μόνο εφόσον υπάρχει επικοινωνία, σε αντίθετη περίπτωση η έκδοση διακόπτεται.
Είμαστε υποχρεωμένοι να παρέχουμε άμεση πρόσβαση στο σύνολο των δεδομένων που αφορούν κάθε οντότητα με την οποία συμβαλλόμαστε, στην ίδια την οντότητα και στις αρμόδιες Υπηρεσίες της Α.Α.Δ.Ε. για τη διενέργεια φορολογικών ελέγχων. Σε περίπτωση που μας ζητηθεί η πρόσβαση σε αυτά τα δεδομένα από τις αρμόδιες αρχές, θα διασφαλίσουμε την άμεση και επαρκή παροχή των δεδομένων αυτών. Υπάρχει δυνατότητα στο διαχειριστικό του συστήματός μας ώστε ο έλεγχος να πραγματοποιείται από την Α.Α.Δ.Ε. και απομακρυσμένα.
Διαθέτουμε σε λειτουργία προς την Α.Α.Δ.Ε. κατάλληλη διεπαφή για τη λήψη στοιχείων παραστατικών των οντοτήτων με τις οποίες συμβαλλόμαστε. Η διεπαφή μας επιτρέπει την άμεση άντληση όλων των στοιχείων εκάστου παραστατικού, με βάση το μορφότυπο και τα κριτήρια αναζήτησης που αναρτώνται στον ιστότοπο της Α.Α.Δ.Ε., μέχρι τη λήξη του επόμενου ημερολογιακού έτους από αυτό της έκδοσής του. Επιπλέον, η διεπαφή μας επιτρέπει την άντληση λίστας με όλα τα παραστατικά που εξέδωσε μία οντότητα σε συγκεκριμένο ημερολογιακό διάστημα. Υπάρχει δυνατότητα στο διαχειριστικό του συστήματός μας ώστε ο έλεγχος να πραγματοποιείται από την Α.Α.Δ.Ε. και απομακρυσμένα.
Κατόπιν αιτήματος της Α.Α.Δ.Ε., ως πάροχος έχουμε υποχρέωση να παραδώσουμε εντός πέντε (5) εργάσιμων ημερών, το σύνολο των δεδομένων των παραστατικών όλων των συμβεβλημένων με εμάς οντοτήτων, για συγκεκριμένο ημερολογιακό διάστημα. Ο τρόπος παράδοσης των δεδομένων είναι μέσω μορφοποιημένου μορφοτύπου που αναρτάται σε ιστότοπο της Α.Α.Δ.Ε. και περιλαμβάνει τα απαιτούμενα στοιχεία. Επιπλέον, υπάρχει δυνατότητα στο διαχειριστικό του συστήματός μας ώστε ο έλεγχος να πραγματοποιείται από την Α.Α.Δ.Ε. και απομακρυσμένα.
Σε περίπτωση διακοπής της συνεργασίας μεταξύ εμάς και της συμβεβλημένης οντότητας, υποχρεούμαστε ως πάροχοι να παραδώσουμε στην οντότητα το σύνολο των παραστατικών τους σε ηλεκτρονικό μέσο, με χρονοσήμανση και ψηφιακά υπογεγραμμένο. Η παράδοση θα πραγματοποιείται σε συμφωνηθέντα μεταξύ εμάς και της συμβεβλημένης οντότητας ηλεκτρονικά μέσα, με ασφάλεια και μεριμνώντας για την εμπιστευτικότητα των δεδομένων. Επιπλέον, υπάρχει απλοποιημένη διαδικασία λήψης παραστατικών στο στο διαχειριστικό του συστήματός μας, επιλέγοντας την επιθυμητή περίοδο.
Ως πάροχος, εφαρμόζουμε την εγκεκριμένη στη χορηγηθείσα άδεια καταλληλότητας ΥΠΑΗΕΣ πιστοποιημένη πολιτική ασφαλείας, ως προς τη διαθεσιμότητα και την ακεραιότητα των δεδομένων που διαχειριζόμαστε. Εξασφαλίζουμε ότι η πολιτική ασφαλείας ενημερώνεται τακτικά και υπάρχει η ανάλογη υποδομή για τη απρόσκοπτη διαθεσιμότητα και ακεραιότητα των δεδομένων.
Ως πάροχος, διαβιβάζουμε δεδομένα των εκδιδόμενων λογιστικών αρχείων (στοιχείων) στην Α.Α.Δ.Ε., σύμφωνα με τις διατάξεις του άρθρου 15Α του ν. 4174/2013, όπως ισχύει. Προσφέρουμε στην Α.Α.Δ.Ε. τα απαραίτητα δεδομένα εντός των προθεσμιών που προβλέπονται από τον νόμο, ώστε να διασφαλίζεται η συμμόρφωση των συμβεβλημένων οντοτήτων με τις φορολογικές υποχρεώσεις τους. Επιπλέον, εφαρμόζουμε όλα τα απαραίτητα μέτρα ασφαλείας για την προστασία των δεδομένων που διαχειριζόμαστε.
Ως πάροχος, έχουμε υποχρέωση διαφύλαξης των δεδομένων των παραστατικών και των αντίστοιχων στοιχείων αυθεντικοποίησης και τεκμηρίωσης αυτών, για κάθε οντότητα με την οποία συμβάλλουμε, για όσο χρόνο συμφωνούμε με την οντότητα – χρήστη των υπηρεσιών μας και κατ’ ελάχιστο για όσο χρονικό διάστημα προβλέπεται να διαφυλάσσονται από την υπόχρεη οντότητα, σύμφωνα με τις διατάξεις του άρθρου 7 του ν. 4308/2014 και του άρθρου 13 του ν. 4174/2013. Συνεπώς, διασφαλίζουμε ότι τα παραστατικά και τα στοιχεία τους θα παραμείνουν ασφαλή και προστατευμένα εφόσον φυλάσσονται σε 2 ακόμα διακομιστές σε διαφορετικές τοποθεσίες εκτός του διακομιστή της έκδοσης.
Ως πάροχος, διαθέτουμε στις συμβαλλόμενες οντότητες, με κάθε σύμβαση ΥΠΑΗΕΣ, ηλεκτρονικές οδηγίες στα Ελληνικά και στα Αγγλικά. Αυτό εξασφαλίζει ότι οι συνεργάτες μας μπορούν να χρησιμοποιήσουν αποτελεσματικά τις υπηρεσίες μας και να έχουν πλήρη κατανόηση του τρόπου λειτουργίας τους. Οι οδηγίες βρίσκονται στην ιστοσελίδα https://www.sbzsystems.com/el/category/ilektronikes-ypografes/ypostirixi-ilektronikes-ypografes
Εκπαιδεύουμε την υπόχρεη οντότητα σχετικά με τις διαδικασίες χρήσης των υπηρεσιών μας για την ηλεκτρονική έκδοση στοιχείων ΥΠΑΗΕΣ και τις ενημερώνουμε για τις συμβατικές τους υποχρεώσεις. Παρέχουμε εκπαιδευτικό υλικό στην ιστοσελίδα https://www.sbzsystems.com/el/category/ilektronikes-ypografes/ypostirixi-ilektronikes-ypografes και παρέχουμε τηλεφωνική γραμμή εξυπηρέτησης διαθέσιμη Δευτέρα έως Παρασκευή, 09:00 – 18:00. Στόχος μας είναι η διασφάλιση ότι η υπόχρεη οντότητα χρησιμοποιούν τις υπηρεσίες μας σωστά και συμμορφώνονται πλήρως με τις υποχρεώσεις τους.
Ως πάροχος, υποχρεούμαστε να εξασφαλίζουμε την ανωνυμία των εκδιδόμενων στοιχείων λιανικής πώλησης στη συμβαλλόμενη οντότητα. Αυτό σημαίνει ότι εξασφαλίζουμε ότι οι πληροφορίες που σχετίζονται με τις συναλλαγές τους δεν διατίθενται σε τρίτους, εκτός αν αυτό απαιτείται από τη νομοθεσία ή από εντολή δικαστικής αρχής. Στους διακομιστές μας έχουν πρόσβαση τεχνικοί που έχουν υπογράψει σύμβαση εχεμύθειας.
Ο χρόνος παρεχόμενης υπηρεσίας προς οποιαδήποτε οντότητα – χρήστη ΥΠΑΗΕΣ ανέρχεται τουλάχιστον σε 99% του χρόνου που παρέχεται από το τηλεπικοινωνιακό δίκτυο. Αυτό καταγράφεται στην ιστοσελίδα https://api.sbz.gr/check_mydata_availability_cron.php?analysis=1. Συνεχώς παρακολουθούμε την απόδοση του συστήματος και προβαίνουμε σε αναβαθμίσεις και βελτιώσεις που εξασφαλίζουν τη σταθερότητα και την αξιοπιστία της υπηρεσίας μας.
Παρέχουμε πρόσβαση στις αρμόδιες Ελεγκτικές Αρχές και Υπηρεσίες, έτσι ώστε να ελέγχουν την τήρηση των προϋποθέσεων της άδειας λειτουργίας μας. Επιπλέον, υπάρχει δυνατότητα στο διαχειριστικό του συστήματός μας ώστε ο έλεγχος των παραστατικών να πραγματοποιείται απομακρυσμένα.
Ως πάροχος, παρέχουμε υποστήριξη για τον φορολογικό έλεγχο μέσω του λογισμικού μας ΥΠΑΗΕΣ. Το λογισμικό είναι εγκατεστημένο στις επιχειρήσεις των χρηστών μας και διαθέτει δυνατότητα να παρουσιάζει πλήρως τα εκδοθέντα παραστατικά και σε περίπτωση διακοπής επικοινωνίας με τον πάροχο. Επιπλέον, τα εκδοθέντα παραστατικά φυλάσσονται με ευθύνη του εκδότη, προσφέροντας έτσι πλήρη υποστήριξη στην τήρηση των φορολογικών προϋποθέσεων.
Το ως άνω λογισμικό, κατόπιν εισαγωγής των απαραίτητων παραμέτρων χρονικού εύρους, παρουσιάζει μια συνολική και λεπτομερή αναφορά για όλα τα εκδοθέντα παραστατικά. Μπορούμε να δούμε με ακρίβεια τα ποσά καθαρής αξίας ανά κατηγορία ΦΠΑ, τα αντίστοιχα ποσά του φόρου ΦΠΑ και το συνολικό ποσό για κάθε κατηγορία.

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

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

13.1 Διασύνδεση POS – Ταμειακών Συστημάτων

Με τα Μέσα Πληρωμών (EFT/POS) σύμφωνα με την υπό στοιχεία Α.1155/2023

Ως πάροχος διενεργούμε κρυπτογράφηση και έλεγχο της Υπογραφής Πληρωμής Ταμειακού Συστήματος ΥΠΑΗΕΣ.
Είμαστε υποχρεωμένοι να καταγράφουμε και να τεκμηριώνουμε τον χρόνο διάρκειας της Υπογραφής Πληρωμής Ταμειακού Συστήματος ΥΠΑΗΕΣ – (Provider’s Signature) έως είκοσι τέσσερις (24) ώρες για τα αιτήματα πληρωμής συναλλαγών των χρηστών υπηρεσιών πληρωμών και έως δύο (2) ώρες για τα αιτήματα πληρωμής συναλλαγών των χρηστών υπηρεσιών πληρωμών που δραστηριοποιούνται στην εστίαση για σκοπούς είτε αποδοχής είτε απόρριψής της.
Έχουμε υποχρέωση να αυθεντικοποιούμε και να διαβιβάζουμε δεδομένα στην ψηφιακή πλατφόρμα myDATA με αντίστοιχη διαδικασία μοναδικοποίησης των παραστατικών και των συναλλαγών πληρωμής με τη χρήση Μέσων Πληρωμών (EFT/POS).
Η διασύνδεσή μας, ως πάροχος, με τα Ταμειακά Συστήματα ΥΠΑΗΕΣ, τα Μέσα Πληρωμών (EFT/POS) και την Α.Α.Δ.Ε. για τη διαβίβαση των οριζόμενων δεδομένων διενεργείται σε πραγματικό χρόνο.
Είμαστε υποχρεωμένοι να καταγράφουμε και να τεκμηριώνουμε ότι το αλγεβρικό άθροισμα των συναλλαγών που επιλέγεται να διενεργηθούν με τη χρήση Μέσων Πληρωμών (EFT/POS) από Χρήστες υπηρεσιών πληρωμών ανεξαρτήτως του πλήθους αυτών, δεν δύναται να υπερβαίνει το συνολικό ποσό των παραστατικών που σχετίζονται με τις συναλλαγές αυτές.
Είμαστε υποχρεωμένοι να καταγράφουμε και να διαβιβάζουμε στην ψηφιακή πλατφόρμα myDATA τα υπό έκδοση παραστατικά που ο Χρήστης υπηρεσιών πληρωμών δεν διαβίβασε για τις Υπογραφές Πληρωμών ΥΠΑΗΕΣ- (Provider Signatures) που αιτήθηκε και δεν συσχετίστηκαν από το Ταμειακό Σύστημα ΥΠΑΗΕΣ με παραστατικά και Μοναδική Ταυτότητα Πληρωμής, εντός του χρονικού ορίου που ορίζεται ανά περίπτωση σύμφωνα με την υπό στοιχεία Α.1155/2023 απόφαση του Διοικητή της Α.Α.Δ.Ε.. Τα υπό έκδοση παραστατικά της περίπτωσης αυτής για τη διαβίβαση τους στην ψηφιακή πλατφόρμα myDATA έχουν την επισήμανση «Υπό Έκδοση».
Έχουμε υποχρέωση να δημιουργούμε κατάλληλη Μέθοδο Διασύνδεσης με τα Ταμειακά Συστήματα ΥΠΑΗΕΣ που αντιστοιχούν στο πεδίο ευθύνης μας.
Έχουμε υποχρέωση να τηρούμε τον Βασικό Κανόνα Διασύνδεσης της υπό στοιχεία Α.1155/2023 απόφασης του Διοικητή της Α.Α.Δ.Ε. που αντιστοιχεί στο πεδίο ευθύνης μας.
Έχουμε υποχρέωση να τηρούμε τις λοιπές υποχρεώσεις σύμφωνα με τα οριζόμενα της υπό στοιχεία Α.1155/2023 απόφασης Διασύνδεσης που αντιστοιχούν στο πεδίο ευθύνης μας.

14. Ιστορικό αναθεώρησης

Έκδοση 1.0

Αρχική έκδοση

Έκδοση 1.2

Μικρές αλλαγές

Έκδοση 1.3

Υποστήριξη POS

Υποστήριξη Δελτίων αποστολής

Έκδοση 1.4

Υποστήριξη B2G

Έκδοση 1.5

Δελτία παραγγελίας εστίασης

Έκδοση 1.6

Τιμολόγιο δελτίο αποστολής

Διορθώσεις τεκμηρίωσης

Έκδοση 1.7

Εμπλουτισμός επιστροφής λαθών

Σήμανση δελτίων αποστολής στο διαχειριστικό

Σήμανση δελτίων παραγγελίας στο διαχειριστικό