List invoices
List your invoices, newest first (by id). Cancelled invoices are included: a non-null deletedAt means the invoice is cancelled. Each row has id (use it in correlatedIds) and uuid (use it in /invoices/{uuid}).
query Parameters
per_pageinteger · min: 1 · max: 250Results per page, maximum 250. The default depends on the endpoint: 25 for invoices and contacts, 50 for products, 20 for payments, purchases and tags, 15 for OCP links. Responses carry
links.next(null on the last page) andmeta.current_page/meta.last_page; request the next page withpage=<n>.Example: 100pageinteger · min: 1The page to return.
sortstring · enumSort column. Default
id; an unknown value falls back toid.Enum values:iddate_issuednumbercreated_atupdated_atdirstring · enumSort direction. Default
desc.Enum values:ascdescstartdatestring · dateInvoices issued on or after this date (
Y-m-d).enddatestring · dateInvoices issued on or before this date (
Y-m-d). Withstartdateequal to it, you get that single day.updated_atstring · dateInvoices changed on or after this date (
Y-m-d). Useful to sync changes.contact_idintegerOnly the invoices of this contact.
invcatintegerOnly invoices of this invoice type id (from
GET /account→data.relations.invoiceTypes).qstringAn exact invoice number, or an exact contact company name.
tagidintegerOnly invoices with this tag id.
unpaidstring · enumOnly unpaid, not cancelled invoices.
onalso limits to chargeable invoice types;1does not.Enum values:1onscheduledstringOnly recurring invoices (any value).
Headers
Acceptstringapplication/json
Responses
OK
dataobject[]linksobjectmetaobject
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.
Before you call
- Ids come from
GET /account(data.relations.vats,data.relations.paymentMethods,data.relations.invoiceTypes),GET /contactsandGET /products. Ids from another account are rejected with 422. - Pick the invoice type by its myDATA category. Each invoice type in
GET /account→data.relations.invoiceTypeshasmydataDefaultType, a category name. Use a type whose category covers themydataInvoiceTypecode you send (see the "Choosing the invoice type" table in the guide); several types can share a category (for example one per numberingseries); choose among them bynameandseries.pistosi: truemarks credit-note types. customerIdis required, unless the invoice type is set to hide the receiver.- The contact must be complete. A company contact needs a postal code, city and country, or you get 422 on
customer_zipcode,customer_cityorcustomer_country. With real-time myDATA on, the contact also needs a customer type (422 oncustomer_type). mydataInvoiceTypedepends on the contact. A company contact accepts 1.x, 2.x, 5.x, 6.x, 7.1, 8.1, 8.2, 11.3, 9.x and 10.x. A private individual accepts 3.x, 6.x, 7.1, 8.2, 11.1, 11.2, 11.4, 11.5, 13.31, 9.x and 10.x. Delivery notes (9.x, 10.x) may be issued without a customer.- Classifications and VAT exemptions are a tax decision. Ask your accountant, set them once in Settings → myData, and you can leave them out of the rows (see below).
- With real-time myDATA on,
invoiceDatecannot be in the future. mydataPaymentdoes not mark the invoice paid in Billit. It only tells myDATA how it was paid. SendisPaid: trueto mark it paid.
Examples for the common cases
Open the Examples dropdown of the request body (on the right) to load a ready request: a service invoice paid in cash, one on credit, a retail receipt (ΑΛΠ) to an individual, a credit note correlated to an invoice, and the specialised cases (tax row, self-pricing, payment methods, OSS). Under Example Responses, the tabs show the real response for each status code, and the 201 tab has the response of each example. They were captured from the API itself.
myDATA is sent in the background
The 201 response never contains a MARK. Read it later with GET /invoices/{uuid} → data.mydata:
mydata.state | Meaning |
|---|---|
| 1 | Waiting to be sent |
| 6 | In the sending queue |
| 2 | Accepted: the MARK is in mydata.invoiceMark |
| 3 | Rejected: the reasons are in mydata.errors |
| 7 | Waiting for the MARK of a correlated document |
| 4 | Cancelled |
| 5 | Labelled "excluded" (see excludeMydata) |
Response
201 returns the invoice summary, the same fields as one row of GET /invoices. Keep id (for correlatedIds) and uuid (for /invoices/{uuid}). The full invoice, with rows and myDATA details, comes from GET /invoices/{uuid}. A stay-tax invoice that spans two seasons is split into one invoice per season, and data is then an array.
Classifications and VAT exemptions: ask your accountant first
Every myDATA invoice row carries an income classification (incomeClassificationCat + incomeClassificationType), and a 0% VAT row also needs a VAT exemption reason (vatExceptionCat). Which ones apply depends on what you sell and to whom, and it has tax consequences. Ask your accountant which classifications and exemption reasons your products and services need before you issue invoices. The values in our examples only show the format; they are not a recommendation.
You do not have to send them in every request. Set them once in the app and leave them out of the rows:
- Account defaults: Settings → myData → "Εξ ορισμού χαρακτηρισμοί προϊόντων". For each invoice type, map each contact type (domestic, EU, outside the EU) to a classification category and type, plus the VAT exemption reason for 0% VAT.
- Per product (optional): a product can have its own mapping that overrides the defaults.
When a row has no classification, Billit uses the product's mapping for that document type, otherwise the account defaults for the contact's type (a private individual is matched by country). When a row has 0% VAT and no vatExceptionCat, the default exemption reason is used; if none is set, the invoice is created but myDATA will reject it (mydata.state 3). A value you send in the row always wins.
On PUT /invoices/{uuid}, with real-time myDATA on and mydataInvoiceType sent, every row needs its classification: the defaults are not filled in on update.
Stay tax (8.2): Τέλος ανθεκτικότητας / Φόρος διαμονής
The price is not sent: it comes from the invoice type. In GET /account → data.relations.invoiceTypes, a stay-tax type has a stayTax object with the accommodation category and the price per room and night for each season: pricePerRoomNightHighSeason (1 April – 31 October) and pricePerRoomNightLowSeason (1 November – 31 March). Other types have stayTax: null.
Issue it on its own: send the stay-tax type's invoiceTypeId, mydataInvoiceType "8.2", and one row with quantity (number of rooms), checkin and checkout (Y-m-d) and measurementUnit. No price or vatId. The amount is rooms × nights × the season's price; a same-day stay counts as one night. From mydataPayment only paymentMethod matters: the paid amount is set to each document's total.
A stay that crosses 1 November or 1 April is split: one document per season, and the 201 data is then an array of invoices.
Refused with 422 on products.0.checkout: check-out before check-in, a type without an accommodation category, or a stay in a season whose price is empty on the type (set it in the app first).
Or add it to another invoice: on any POST /invoices, send taxStayisEnabled: true, taxStayQuantity (rooms, at least 1), taxStayCheckin and taxStayCheckout (on or after check-in). The response is the main invoice; the 8.2 is issued right after it in the background, for the same customer and correlated to the invoice, on the account's latest stay-tax type. The same price checks run first (422 on taxStayCheckout). If the account has no stay-tax type, no 8.2 is issued.
The examples dropdown has a stay inside one season and a stay crossing 1 November; the 422 tab has a stay in a season without a price.
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 | Απόδειξη Λιανικής Πώλησης για Λογ/σμό Τρίτων |
| 13.31 | Πιστωτικό Στοιχ. Λιανικής ημεδαπής / αλλοδαπής |
| 9.1 | Δελτίο Αποστολής Συσχετιζόμενο |
| 9.2 | Συγκεντρωτικό Δελτίο Αποστολής |
| 9.3 | Δελτίο Αποστολής |
| 10.1 | Δελτίο Ποσοτικής Παραλαβής Συσχετιζόμενο |
| 10.2 | Δελτίο Ποσοτικής Παραλαβής Μη Συσχετιζόμενο |
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 |
| 8 | Άμεσες Πληρωμές IRIS |
paidAmount is required whenever paymentMethod is set, and epiPistosi (the amount on credit) is required whenever paidAmount is not 0: send 0 when everything is paid. If the whole amount is on credit ("Επί πιστώσει"), send paymentMethod as an empty string:
Code
For POS / e-Pos (7) send only paymentMethod, paidAmount and epiPistosi. This endpoint does not read POS transaction details (terminalId, signature, signingAuthor, transactionId, tipAmount); they are ignored.
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 date,
Y-m-d. With real-time myDATA on, it cannot be in the future.invoiceTypeIdnumber · requiredThe invoice type ID
productsobject[] · minItems: 1 · unique · required
customerIdintegerThe contact id from
GET /contacts. Required, unless the invoice type hides the receiver. The contact decides whichmydataInvoiceTypevalues are allowed (see the description).sendMailbooleanFill in true if you want your customer to receive the invoice by email.
vatPaymentSuspensionbooleanMarks the invoice with VAT payment suspension (myDATA
vatPaymentSuspension). It does not exclude the invoice from myDATA.dateExpiresstring | null · dateThe due date,
Y-m-d, on or afterinvoiceDate.isPaidbooleanThe invoice paid status
mydataInvoiceTypestring · minLength: 1The myDATA document type code, e.g.
"1.1". Allowed values depend on the contact: see "Before you call" and the table in the description.taxesobject[] · minItems: 1 · uniquetagsarrayAn array of tags if any
mydataPaymentobjectHow the invoice is paid, for myDATA.
paidAmountis required whenpaymentMethodis set;epiPistosiis required whenpaidAmountis not 0. Codes are in the description.mailOptionsstring | objectIn case you want to have custom email subject/body
reminderbooleanpaymentMethodsarray | nullThe online/offline payment methods shown on the invoice: an array of ids from
GET /account→data.relations.paymentMethods. Leave it out or send null for the account's default methods; send[-1]for no payment method at all.correlatedIdsinteger[]The documents this one relates to, as numeric invoice ids from
GET /invoices→data[].id(not theuuid). Required for a 5.1 credit note (422 without it). Each must belong to your account and be created within the last year. A credit note (5.1, 11.4) cannot exceed what is left of the invoices it corrects (422 oncorrelatedIds). For a Τιμολόγιο Πώλησης or ΑΛΠ type, correlated documents must be Συγκεντρωτικά Δελτία Αποστολής (9.2).taxStayisEnabledbooleanAlso issue a stay-tax (8.2) document for this invoice. See "Stay tax (8.2)" in the description.
taxStayQuantityinteger · min: 1With
taxStayisEnabled: number of rooms.taxStayCheckinstring · dateWith
taxStayisEnabled: check-in date,Y-m-d.taxStayCheckoutstring · dateWith
taxStayisEnabled: check-out date,Y-m-d, on or after check-in.
excludeMydataboolean · deprecated · requiredDeprecated: it has no effect on transmission. With real-time myDATA on, the invoice is sent anyway; the flag only labels it as excluded (
mydata.state5) until it is sent. Still accepted, so existing integrations keep working; do not send it in new ones.paymentMethodarray | null · deprecated · requiredDeprecated alias of
paymentMethods, which is validated against your payment methods. UsepaymentMethods.
Responses
Created. The invoice summary (the same fields as one row of GET /invoices). The MARK is not here yet: read mydata.state later from GET /invoices/{uuid}.
dataobject
Show Invoice
Show an invoice with its rows and myDATA details. For the PDF, add /pdf to the returned permalink.
data.mydata is present only for invoices that go to myDATA; mydata.state is explained in POST /invoices (1 waiting, 6 queued, 2 accepted with invoiceMark, 3 rejected with errors, 7 waiting for a correlated MARK, 4 cancelled, 5 excluded label). data.customer is missing when the invoice has no contact. A uuid that is not a valid UUID returns 422.
path Parameters
uuidstring · requiredThe uuid of invoice
Headers
Acceptstringapplication/json
Responses
OK
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.
PUT replaces the invoice
Send the whole invoice, as for POST /invoices. Fields you leave out are cleared, not kept:
notebecomes empty;dateExpires,templateId,selectedCustomerAddressand the B2G references (projectRef,contractRef,purchaseOrderRef,buyerReference) become null.tagsleft out removes all tags.vatPaymentSuspensionleft out turns it off.mydataInvoiceTypeleft out keeps the invoice's current type.
The invoice type cannot change. Send the invoice's current invoiceTypeId.
With real-time myDATA on and mydataInvoiceType sent, every row (except tax rows) needs incomeClassificationCat and incomeClassificationType. Unlike POST, they are not filled in for you.
sendMail and excludeMydata are ignored on update. isPaid only applies when a draft is issued.
When an update is refused
| Status | Why |
|---|---|
403 Not allowed | The invoice has payments and the update changes its total, or a POS payment locks it. |
409 Conflict | You sent loaded_at and the invoice changed after that time. Read it again and resend. |
| 422 | Validation failed, e.g. an invoiceDate that breaks the numbering order. |
| 500 | Document types that cannot change once they have a MARK (delivery notes), or an invoice created before 24/12/2020. |
After an update, the invoice goes back to mydata.state 1 and is sent to myDATA again, unless your provider has locked it. Read mydata.state as after a create.
path Parameters
uuidstring · requiredThe uuid of invoice
Headers
Acceptstringapplication/json
Request Body
invoiceDatestring · minLength: 1 · requiredY-m-d. Must keep the numbering order of the invoice type.invoiceTypeIdnumber · requiredThe invoice's current type id. The type cannot change.
productsarray · minItems: 1 · unique · required
customerIdnumberThe contact id. Required, unless the invoice type hides the receiver.
sendMailbooleanIgnored on update.
mydataInvoiceTypestring · minLength: 1The myDATA type code. Left out, the invoice keeps its current type.
taxesarray · minItems: 1 · uniquetagsarrayTag names. Left out, all tags are removed.
mydataPaymentobjectloaded_atstringOptional. The invoice's
updatedAtas you read it. If the invoice changed since, the update is refused with 409.
excludeMydataboolean · deprecated · requiredDeprecated and ignored on update.
Responses
OK
dataobjectInvoice model in billit.
Delete an invoice
Cancel or delete an invoice.
- Draft: deleted permanently on the first call.
- Issued invoice, first call: it is cancelled (it stays in the list with
deletedAtset). If it has a MARK, it is also cancelled in myDATA at once; if AADE refuses, you get 400MyData Errorand nothing changes. - Cancelled invoice, second call: deleted permanently, but only if it is the latest invoice of its type (highest id) and has no MARK. Otherwise: 403
Not the last invoice in this type., or 500 when it has a MARK.
Payments recorded against the invoice become credit on the customer.
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