Create an invoice
In order to get back or post payload with MyData information, you need to enable the Mydata plugin first. Please do from your settings menu if your business is located in Greece and you need to connect myData to your account.
Mydata details
mydataInvoiceType options
| Option | Description |
|---|---|
| 1.1 | Τιμολόγιο Πώλησης |
| 1.2 | Τιμολόγιο Πώλησης / Ενδοκοινοτικές Παραδόσεις |
| 1.3 | Τιμολόγιο Πώλησης / Παραδόσεις Τρίτων Χωρών |
| 1.4 | Τιμολόγιο Πώλησης / Πώληση για Λογαριασμό Τρίτων |
| 1.5 | Τιμολόγιο Πώλησης / Εκκαθάριση Πωλήσεων Τρίτων - Αμοιβή από Πωλήσεις Τρίτων |
| 1.6 | Τιμολόγιο Πώλησης / Συμπληρωματικό Παραστατικό |
| 2.1 | Τιμολόγιο Παροχής |
| 2.2 | Τιμολόγιο Παροχής / Ενδοκοινοτική Παροχή Υπηρεσιών |
| 2.3 | Τιμολόγιο Παροχής / Παροχή Υπηρεσιών σε λήπτη Τρίτης Χώρας |
| 2.4 | Τιμολόγιο Παροχής / Συμπληρωματικό Παραστατικό |
| 3.1 | Τίτλος Κτήσης (μη υπόχρεος Εκδότης) |
| 3.2 | Τίτλος Κτήσης (άρνηση έκδοσης από υπόχρεο Εκδότη) |
| 5.1 | Πιστωτικό Τιμολόγιο / Συσχετιζόμενο |
| 5.2 | ΠιστωτικόΤιμολόγιο / Μη Συσχετιζόμενο |
| 6.1 | Στοιχείο Αυτοπαράδοσης |
| 6.2 | Στοιχείο Ιδιοχρησιμοποίησης |
| 7.1 | Συμβόλαιο - Έσοδο |
| 8.1 | Ενοίκια -Έσοδο |
| 8.2 | Ειδικό Στοιχείο –Απόδειξης Είσπραξης Φόρου Διαμονής |
| 11.1 | ΑΛΠ |
| 11.2 | ΑΠΥ |
| 11.3 | Απλοποιημένο Τιμολόγιο |
| 11.4 | Πιστωτικό Στοιχ. Λιανικής |
| 11.5 | Απόδειξη Λιανικής Πώλησης για Λογ/σμό Τρίτων |
incomeClassificationCat options
| Option | Description |
|---|---|
| category1_1 | Έσοδα από Πώληση Εμπορευμάτων |
| category1_2 | Έσοδα από Πώληση Προϊόντων |
| category1_3 | Έσοδα από Παροχή Υπηρεσιών |
| category1_4 | Έσοδα από Πώληση Παγίων |
| category1_5 | Λοιπά Έσοδα/ Κέρδη |
| category1_6 | Αυτοπαραδόσεις / Ιδιοχρησιμοποιήσεις |
| category1_7 | Έσοδα για λ/σμο τρίτων |
| category1_8 | Έσοδα προηγούμενων χρήσεων |
| category1_9 | Έσοδα επομένων χρήσεων |
| category1_10 | Λοιπές Εγγραφές Τακτοποίησης Εσόδων |
| category1_95 | Λοιπά Πληροφοριακά Στοιχεία Εσόδων |
incomeClassificationType options
| Option | Description |
|---|---|
| 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 | Πωλήσεις για λογ/σμο Τρίτων Εξωτερικού Τρίτες Χώρες |
paymentMethod options
| Option | Description |
|---|---|
| 1 | Επαγ. Λογαριασμός Πληρωμών Ημεδαπής |
| 2 | Επαγ. Λογαριασμός Πληρωμών Αλλοδαπής |
| 3 | Μετρητά |
| 4 | Επιταγή |
| 6 | Web banking |
| 7 | POS / e-Pos |
If all the amount is on "Επι πιστώσει" then parse as empty string. Check the example for more details
Code
if the payment method is POS/E-pos some extra keys should exist in order for Mydata to register tha transaction properly
Code
VAT exclusion reason options
| Option | Description |
|---|---|
| 1 | Χωρίς ΦΠΑ - άρθρο 2 και 3 του Κώδικα ΦΠΑ |
| 2 | Χωρίς ΦΠΑ - άρθρο 5 του Κώδικα ΦΠΑ |
| 3 | Χωρίς ΦΠΑ - άρθρο 17 του Κώδικα ΦΠΑ |
| 4 | Χωρίς ΦΠΑ - άρθρο 18 του Κώδικα ΦΠΑ |
| 5 | Χωρίς ΦΠΑ - άρθρο 21 του Κώδικα ΦΠΑ |
| 6 | Χωρίς ΦΠΑ - άρθρο 24 του Κώδικα ΦΠΑ |
| 7 | Χωρίς ΦΠΑ - άρθρο 27 του Κώδικα ΦΠΑ |
| 8 | Χωρίς ΦΠΑ - άρθρο 29 του Κώδικα ΦΠΑ |
| 9 | Χωρίς ΦΠΑ - άρθρο 30 του Κώδικα ΦΠΑ |
| 10 | Χωρίς ΦΠΑ - άρθρο 31 του Κώδικα ΦΠΑ |
| 11 | Χωρίς ΦΠΑ - άρθρο 32 του Κώδικα ΦΠΑ |
| 12 | Χωρίς ΦΠΑ - άρθρο 32 του Κώδικα ΦΠΑ - Πλοία Ανοικτής Θαλάσσης του Κώδικα ΦΠΑ |
| 13 | Χωρίς ΦΠΑ - άρθρο 32 .1.γ. του Κώδικα ΦΠΑ - Πλοία Ανοικτής Θαλάσσης του Κώδικα ΦΠΑ |
| 14 | Χωρίς ΦΠΑ - άρθρο 33 του Κώδικα ΦΠΑ |
| 15 | Χωρίς ΦΠΑ - άρθρο 44 του Κώδικα ΦΠΑ |
| 16 | Χωρίς ΦΠΑ - άρθρο 45 του Κώδικα ΦΠΑ |
| 17 | Χωρίς ΦΠΑ - άρθρο 47 του Κώδικα ΦΠΑ |
| 18 | Χωρίς ΦΠΑ - άρθρο 48 του Κώδικα ΦΠΑ |
| 19 | Χωρίς ΦΠΑ - άρθρο 54 του Κώδικα ΦΠΑ |
| 20 | ΦΠΑ εμπεριεχόμενος - άρθρο 50 του Κώδικα ΦΠΑ |
| 21 | ΦΠΑ εμπεριεχόμενος - άρθρο 51 του Κώδικα ΦΠΑ |
| 22 | ΦΠΑ εμπεριεχόμενος - άρθρο 52 του Κώδικα ΦΠΑ |
| 23 | ΦΠΑ εμπεριεχόμενος - άρθρο 53 του Κώδικα ΦΠΑ |
| 24 | Χωρίς ΦΠΑ - άρθρο 8 του Κώδικα ΦΠΑ |
| 25 | Χωρίς ΦΠΑ - ΠΟΛ.1029/1995 |
| 26 | Χωρίς ΦΠΑ - ΠΟΛ.1167/2015 |
| 27 | Λοιπές Εξαιρέσεις ΦΠΑ |
| 28 | Χωρίς ΦΠΑ – άρθρο 29 περ. β' παρ.1 του Κώδικα ΦΠΑ, (Tax Free) |
| 29 | Χωρίς ΦΠΑ – άρθρο 56 του Κώδικα ΦΠΑ (OSS_μη ενωσιακό καθεστώς) |
| 30 | Χωρίς ΦΠΑ – άρθρο 57 του Κώδικα ΦΠΑ (OSS_ενωσιακό καθεστώς) |
| 31 | Χωρίς ΦΠΑ – άρθρο 58 του Κώδικα ΦΠΑ (IOSS) |
SelfPricing - Αυτοτιμολόγηση
If you want to generate invoices with selfPricing is a bit different. This invoice is actually an expense so the customer is a supplier not a customer ( or could be both in some cases) and the mydata specifics are a bit different, again because this kind of invoice is actuallly an expense.
- only 1.1,2.1 mydataInvoiceType is allowed in this case.
- The customerId should point to a customer that has a type of supplier or both a supplier or customer type.
- You should select classifications from expenses not income
- You should select a classification for the VAT as well ( check VatClassifications options )
- To understand how you should make this post, check the example (select from the dropdown in the body request on your right) for SelfPricing.
expenseClassificationCat options
| Option | Description |
|---|---|
| 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 | Λοιπά Πληροφοριακά Στοιχεία Εξόδων |
expenseClassificationType options
| Option | Description |
|---|---|
| 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 | Αποθέματα λήξης πρώτων υλών και υλικών/Παραγωγή |
| ... | ... |
VatClassifications options
| Option | Description |
|---|---|
| VAT_361 | Αγορές & δαπάνες στο εσωτερικό της χώρας |
| VAT_362 | Αγορές & εισαγωγές επενδ. Αγαθών (πάγια) |
| VAT_363 | Λοιπές εισαγωγές εκτός επενδ. Αγαθών (πάγια) |
| VAT_364 | Ενδοκοινοτικές αποκτήσεις αγαθών |
| VAT_365 | Ενδοκοινοτικές λήψεις υπηρεσιών άρθρ. 14.2.α |
| VAT_366 | Λοιπές πράξεις λήπτη |
OSS (One Stop Shop)
To generate invoices with OSS you need to use a Zero Vat for all rows. In the row of the OSS Tax, the "taxRate" key is needed as a decimal and the ProductId should be an OSS Tax Product (You can get this ID by making a request at my account endpoint, check the Relations key - OssProductTaxes)
Headers
Acceptstringapplication/json
Request Body
invoiceDatestring · date · requiredThe invoice's date, in Y-m-d format
invoiceTypeIdnumber · requiredThe invoice type ID
productsobject[] · minItems: 1 · unique · required
customerIdnumberThe customer ID
sendMailbooleanFill in true if you want your customer to receive the invoice by email.
excludeMydatabooleanBy making this true, the invoice is excluded from myData.
vatPaymentSuspensionbooleanBy making this true, the invoice is excluded from myData.
dateExpiresstring | null · dateThe invoice's date, in Y-m-d format
isPaidbooleanThe invoice paid status
mydataInvoiceTypestring · minLength: 1The invoice type according Mydata
taxesobject[] · minItems: 1 · uniquetagsarrayAn array of tags if any
mydataPaymentobjectIs needed if Mydata plugin is enabled. Check the possible options in the endpoint's description.
mailOptionsstring | objectIn case you want to have custom email subject/body
reminderbooleanpaymentMethodarray | nullBy setting to null or not including at all you set the "default" payment methods. If you want to set certain online/offline payment methods, ad their id in an array. In case you want to expilicitly avoid any payment for this invoice put the value of -1 in the array
Responses
Created
dataobjectInvoice model in billit.
Update an invoice
Update an invoice
In order to get back or post payload with MyData information, you need to enable the Mydata plugin first. Please do from your settings menu if your business is located in Greece and you need to connect myData to your account.
path Parameters
uuidstring · requiredThe uuid of invoice
Headers
Acceptstringapplication/json
Request Body
customerIdnumber · requiredsendMailboolean · requiredexcludeMydataboolean · requiredinvoiceDatestring · minLength: 1 · requiredinvoiceTypeIdnumber · requiredmydataInvoiceTypestring · minLength: 1 · requiredtaxesarray · minItems: 1 · unique · requiredproductsarray · minItems: 1 · unique · requiredtagsarray · requiredmydataPaymentobject · required
Responses
OK
dataobjectInvoice model in billit.
Delete an invoice
Delete an invoice. By deleting an invoice, you actually cancel it the first time. Only way you can actually delete it permantly is if the invoice is the last one for a certain invoice type.
path Parameters
uuidstring · requiredThe uuid of invoice
Headers
Acceptstringapplication/json
Responses
No Content
alp-signature
In order to use this endpoint you need to have enabled the connection with our partner Ilyda for Signing digitally invoices. This endpoint returns a legal sign that you can then forward to a POS.
Request Body
amountnumberExample: 100netAmountnumberExample: 80.65vatAmountnumberExample: 19.35grossAmountnumberExample: 100sellerVatstringExample: 177472438seriesstringExample: TCinvoiceTypeCodestringExample: 11.1sellerBranchintegerDefault: 0terminalIdstringExample: pos_1
Responses
OK
invoiceSignaturesobject[]invoiceMarking| nullerrors| null