Invoices & receipts¶
All documents are issued with the same call, SendInvoices. Only the type (invoiceHeader.invoiceType) and a few fields change.
Which type to choose¶
| Transaction | Type | Recipient (counterpart) |
Ready-made JSON |
|---|---|---|---|
| Sale of goods to a business | 1.1 |
yes | 1.1-sales-invoice.json |
| Services to a business | 2.1 |
yes | 2.1-service-invoice.json |
| Retail sale of goods to a consumer | 11.1 |
no | 11.1-retail-receipt.json |
| Retail services to a consumer | 11.2 |
no | 11.2-service-receipt.json |
| Purchase from a non-obligated seller (title of acquisition) | 3.1 |
yes | 3.1-title-of-acquisition.json |
| Climate crisis resilience fee | 8.2 |
optional | 8.2-climate-resilience-fee.json |
| Credit note / return | 5.1, 5.2, 11.4 |
depends | Credit notes & correlations |
| Invoice that is also a delivery note | 1.1 + isDeliveryNote |
yes | Goods movement |
Only types 1.1 to 11.5
Through a certified e-invoicing provider you can issue only types 1.1 to 11.5. Types 12.x to 17.x are not transmitted by a provider. All allowed types: AADE code tables → Documents.
The 6 rules that prevent most errors¶
- One document per call.
invoiceis an array with exactly one element. - Today's date.
issueDatemust be today's date. The only exception is sending withtransmissionFailure = 1(Offline). - Payments = total. The sum of
paymentMethods[].amountequalsinvoiceSummary.totalGrossValue. If the customer pays later, sendtype: 5(On credit). - No name for Greek VAT numbers (ΑΦΜ). In
issuerandcounterpartwithcountry: "GR", do not sendname. The name printed on the document goes inproviderAdditionalInvoiceDetails. - Classification on every line. Every income line has an
incomeClassificationwith an amount equal tonetValue. The summary holds the totals per type and category. - Two blocks, two purposes. Everything in
providerAdditionalInvoiceDetailsgoes only to the PDF. Everything else goes to AADE (the Greek tax authority).
Common income classifications¶
| Case | classificationType |
classificationCategory |
|---|---|---|
| Wholesale of goods (1.1) | E3_561_001 |
category1_1 |
| Services to a business (2.1) | E3_561_001 |
category1_3 |
| Retail sale of goods (11.1) | E3_561_003 |
category1_1 |
| Retail services (11.2, food service) | E3_561_003 |
category1_3 |
| Sale within the EU | E3_561_005 |
category1_1 |
| Sale to a non-EU country | E3_561_006 |
category1_1 |
| Informational (e.g. 8.6, OSS VAT line) | — | category1_95 |
AADE defines which combination is valid for each document type (in its "Συνδυασμοί χαρακτηρισμών" file, i.e. classification combinations). All codes: Classifications.
Ready-made examples¶
All of them pass the totals check. Before you send them:
- put your own sandbox VAT number in
issuer.vatNumber(the examples use123456789), - set
issueDateto today's date, - change
aa.
The recipient VAT number 987654324 is fictitious, but its check digit is valid.
1.1 — Sales Invoice
{
"invoice": [
{
"issuer": {
"vatNumber": "123456789",
"country": "GR",
"branch": 0
},
"counterpart": {
"vatNumber": "987654324",
"country": "GR",
"branch": 0,
"address": {
"street": "Οδός Πελάτη",
"number": "10",
"postalCode": "15772",
"city": "Ζωγράφου"
}
},
"invoiceHeader": {
"series": "A",
"aa": "1001",
"issueDate": "2026-09-24",
"invoiceType": "1.1",
"currency": "EUR",
"dispatchDate": "2026-09-24",
"dispatchTime": "10:00:00",
"vehicleNumber": "ABC-1234",
"movePurpose": 1,
"movePurposeLabel": "Πώληση"
},
"paymentMethods": [
{
"type": 5,
"amount": 124
}
],
"invoiceDetails": [
{
"lineNumber": 1,
"lineCode": "655-000023",
"quantity": 1,
"measurementUnitLabel": "ΤΜΧ",
"lineUnitPrice": 120,
"totalNetPriceBeforeDiscount": 120,
"totalDiscountValue": 20,
"netValue": 100,
"vatCategory": 1,
"vatCategoryPercent": 24,
"vatAmount": 24,
"lineDescription": "Αντικατάσταση Λέβητα",
"incomeClassification": [
{
"classificationType": "E3_561_001",
"classificationCategory": "category1_1",
"amount": 100
}
]
}
],
"invoiceSummary": {
"totalNetValue": 100,
"totalVatAmount": 24,
"totalWithheldAmount": 0,
"totalFeesAmount": 0,
"totalStampDutyAmount": 0,
"totalOtherTaxesAmount": 0,
"totalDeductionsAmount": 0,
"totalGrossValue": 124,
"incomeClassification": [
{
"classificationType": "E3_561_001",
"classificationCategory": "category1_1",
"amount": 100
}
]
},
"providerAdditionalInvoiceDetails": {
"issuer": {
"name": "TEST ISSUER ΙΚΕ",
"profession": "Εμπόριο ειδών θέρμανσης",
"taxoffice": "Α' Αθηνών",
"addressStreet": "Οδός Δοκιμής",
"addressNumber": "1",
"addressPostalCode": "10431",
"addressCity": "Αθήνα",
"addressCountry": "Ελλάδα",
"phone": "2100000000",
"email": "info@example.com",
"webSite": "www.example.com",
"registryNumber": "ΓΕΜΗ: 000000000000",
"emtyLine2": "IBAN: GR00 0000 0000 0000 0000 0000 000"
},
"counterpart": {
"code": "C-0001",
"name": "TEST CLIENT ΑΕ",
"profession": "Χονδρικό εμπόριο",
"taxoffice": "Ζωγράφου",
"addressStreet": "Οδός Πελάτη",
"addressNumber": "10",
"addressPostalCode": "15772",
"addressCity": "Ζωγράφου",
"addressCountry": "Ελλάδα",
"phone": "2100000001",
"email": "client@example.com"
},
"additionalDetails": {
"documentLabel": "Τιμολόγιο Πώλησης",
"documentLanguageCode": "EL",
"documentSizeCode": 0,
"documentComments": "Εξόφληση εντός 30 ημερών.",
"paymentMethodInvoiceLabel": "Επί πιστώσει"
}
}
}
]
}
2.1 — Service Invoice
{
"invoice": [
{
"issuer": {
"vatNumber": "123456789",
"country": "GR",
"branch": 0
},
"counterpart": {
"vatNumber": "987654324",
"country": "GR",
"branch": 0,
"address": {
"street": "Οδός Πελάτη",
"number": "10",
"postalCode": "15772",
"city": "Ζωγράφου"
}
},
"invoiceHeader": {
"series": "A",
"aa": "1002",
"issueDate": "2026-09-24",
"invoiceType": "2.1",
"currency": "EUR"
},
"paymentMethods": [
{
"type": 5,
"amount": 100
},
{
"type": 6,
"amount": 24
}
],
"invoiceDetails": [
{
"lineNumber": 1,
"lineCode": "655-000023",
"quantity": 1,
"measurementUnitLabel": "ΤΜΧ",
"lineUnitPrice": 120,
"totalNetPriceBeforeDiscount": 120,
"totalDiscountValue": 20,
"netValue": 100,
"vatCategory": 1,
"vatCategoryPercent": 24,
"vatAmount": 24,
"lineDescription": "Αντικατάσταση Λέβητα",
"incomeClassification": [
{
"classificationType": "E3_561_001",
"classificationCategory": "category1_3",
"amount": 100
}
]
}
],
"invoiceSummary": {
"totalNetValue": 100,
"totalVatAmount": 24,
"totalWithheldAmount": 0,
"totalFeesAmount": 0,
"totalStampDutyAmount": 0,
"totalOtherTaxesAmount": 0,
"totalDeductionsAmount": 0,
"totalGrossValue": 124,
"incomeClassification": [
{
"classificationType": "E3_561_001",
"classificationCategory": "category1_3",
"amount": 100
}
]
},
"providerAdditionalInvoiceDetails": {
"issuer": {
"name": "TEST ISSUER ΙΚΕ",
"profession": "Εμπόριο ειδών θέρμανσης",
"taxoffice": "Α' Αθηνών",
"addressStreet": "Οδός Δοκιμής",
"addressNumber": "1",
"addressPostalCode": "10431",
"addressCity": "Αθήνα",
"addressCountry": "Ελλάδα",
"phone": "2100000000",
"email": "info@example.com",
"webSite": "www.example.com",
"registryNumber": "ΓΕΜΗ: 000000000000",
"emtyLine2": "IBAN: GR00 0000 0000 0000 0000 0000 000"
},
"counterpart": {
"code": "C-0001",
"name": "TEST CLIENT ΑΕ",
"profession": "Χονδρικό εμπόριο",
"taxoffice": "Ζωγράφου",
"addressStreet": "Οδός Πελάτη",
"addressNumber": "10",
"addressPostalCode": "15772",
"addressCity": "Ζωγράφου",
"addressCountry": "Ελλάδα",
"phone": "2100000001",
"email": "client@example.com"
},
"additionalDetails": {
"documentLabel": "Τιμολόγιο Παροχής Υπηρεσιών",
"documentLanguageCode": "EL",
"documentSizeCode": 0,
"documentComments": "Εξόφληση εντός 30 ημερών.",
"paymentMethodInvoiceLabel": "Επί πιστώσει"
}
}
}
]
}
11.1 — Retail Sales Receipt
{
"invoice": [
{
"issuer": {
"vatNumber": "123456789",
"country": "GR",
"branch": 0
},
"invoiceHeader": {
"series": "A",
"aa": "1007",
"issueDate": "2026-09-24",
"invoiceType": "11.1",
"currency": "EUR"
},
"paymentMethods": [
{
"type": 3,
"amount": 124
}
],
"invoiceDetails": [
{
"lineNumber": 1,
"lineCode": "655-000023",
"quantity": 1,
"measurementUnitLabel": "ΤΜΧ",
"lineUnitPrice": 120,
"totalNetPriceBeforeDiscount": 120,
"totalDiscountValue": 20,
"netValue": 100,
"vatCategory": 1,
"vatCategoryPercent": 24,
"vatAmount": 24,
"lineDescription": "Αντικατάσταση Λέβητα",
"incomeClassification": [
{
"classificationType": "E3_561_003",
"classificationCategory": "category1_1",
"amount": 100
}
]
}
],
"invoiceSummary": {
"totalNetValue": 100,
"totalVatAmount": 24,
"totalWithheldAmount": 0,
"totalFeesAmount": 0,
"totalStampDutyAmount": 0,
"totalOtherTaxesAmount": 0,
"totalDeductionsAmount": 0,
"totalGrossValue": 124,
"incomeClassification": [
{
"classificationType": "E3_561_003",
"classificationCategory": "category1_1",
"amount": 100
}
]
},
"providerAdditionalInvoiceDetails": {
"issuer": {
"name": "TEST ISSUER ΙΚΕ",
"profession": "Εμπόριο ειδών θέρμανσης",
"taxoffice": "Α' Αθηνών",
"addressStreet": "Οδός Δοκιμής",
"addressNumber": "1",
"addressPostalCode": "10431",
"addressCity": "Αθήνα",
"addressCountry": "Ελλάδα",
"phone": "2100000000",
"email": "info@example.com",
"webSite": "www.example.com",
"registryNumber": "ΓΕΜΗ: 000000000000",
"emtyLine2": "IBAN: GR00 0000 0000 0000 0000 0000 000"
},
"additionalDetails": {
"documentLabel": "Απόδειξη Λιανικής Πώλησης",
"documentLanguageCode": "EL",
"documentSizeCode": 1,
"documentComments": "Εξόφληση εντός 30 ημερών.",
"paymentMethodInvoiceLabel": "Επί πιστώσει"
}
}
}
]
}
11.2 — Service Receipt
{
"invoice": [
{
"issuer": {
"vatNumber": "123456789",
"country": "GR",
"branch": 0
},
"invoiceHeader": {
"series": "A",
"aa": "1008",
"issueDate": "2026-09-24",
"invoiceType": "11.2",
"currency": "EUR"
},
"paymentMethods": [
{
"type": 1,
"amount": 124
}
],
"invoiceDetails": [
{
"lineNumber": 1,
"lineCode": "655-000023",
"quantity": 1,
"measurementUnitLabel": "ΤΜΧ",
"lineUnitPrice": 120,
"totalNetPriceBeforeDiscount": 120,
"totalDiscountValue": 20,
"netValue": 100,
"vatCategory": 1,
"vatCategoryPercent": 24,
"vatAmount": 24,
"lineDescription": "Αντικατάσταση Λέβητα",
"incomeClassification": [
{
"classificationType": "E3_561_003",
"classificationCategory": "category1_3",
"amount": 100
}
]
}
],
"invoiceSummary": {
"totalNetValue": 100,
"totalVatAmount": 24,
"totalWithheldAmount": 0,
"totalFeesAmount": 0,
"totalStampDutyAmount": 0,
"totalOtherTaxesAmount": 0,
"totalDeductionsAmount": 0,
"totalGrossValue": 124,
"incomeClassification": [
{
"classificationType": "E3_561_003",
"classificationCategory": "category1_3",
"amount": 100
}
]
},
"providerAdditionalInvoiceDetails": {
"issuer": {
"name": "TEST ISSUER ΙΚΕ",
"profession": "Εμπόριο ειδών θέρμανσης",
"taxoffice": "Α' Αθηνών",
"addressStreet": "Οδός Δοκιμής",
"addressNumber": "1",
"addressPostalCode": "10431",
"addressCity": "Αθήνα",
"addressCountry": "Ελλάδα",
"phone": "2100000000",
"email": "info@example.com",
"webSite": "www.example.com",
"registryNumber": "ΓΕΜΗ: 000000000000",
"emtyLine2": "IBAN: GR00 0000 0000 0000 0000 0000 000"
},
"additionalDetails": {
"documentLabel": "Απόδειξη Παροχής Υπηρεσιών",
"documentLanguageCode": "EL",
"documentSizeCode": 0,
"documentComments": "Εξόφληση εντός 30 ημερών.",
"paymentMethodInvoiceLabel": "Επί πιστώσει"
}
}
}
]
}
3.1 — Title of Acquisition
{
"invoice": [
{
"issuer": {
"vatNumber": "123456789",
"country": "GR",
"branch": 0
},
"counterpart": {
"vatNumber": "987654324",
"country": "GR",
"branch": 0,
"address": {
"street": "Οδός Πελάτη",
"number": "10",
"postalCode": "15772",
"city": "Ζωγράφου"
}
},
"invoiceHeader": {
"series": "A",
"aa": "1003",
"issueDate": "2026-09-24",
"invoiceType": "3.1",
"currency": "EUR",
"exchangeRate": 1.19552,
"dispatchDate": "2026-09-24",
"dispatchTime": "10:00:00",
"vehicleNumber": "ABC-1234",
"movePurpose": 1,
"movePurposeLabel": "Πώληση"
},
"paymentMethods": [
{
"type": 5,
"amount": 100
}
],
"invoiceDetails": [
{
"lineNumber": 1,
"lineCode": "655-000023",
"quantity": 1,
"measurementUnitLabel": "ΤΜΧ",
"lineUnitPrice": 120,
"totalNetPriceBeforeDiscount": 120,
"totalDiscountValue": 20,
"netValue": 100,
"vatCategory": 8,
"vatCategoryPercent": 0,
"vatAmount": 0,
"lineDescription": "Αντικατάσταση Λέβητα",
"expensesClassification": [
{
"classificationType": "E3_102_002",
"classificationCategory": "category2_1",
"amount": 100
}
]
}
],
"invoiceSummary": {
"totalNetValue": 100,
"totalVatAmount": 0,
"totalWithheldAmount": 0,
"totalFeesAmount": 0,
"totalStampDutyAmount": 0,
"totalOtherTaxesAmount": 0,
"totalDeductionsAmount": 0,
"totalGrossValue": 100,
"expensesClassification": [
{
"classificationType": "E3_102_002",
"classificationCategory": "category2_1",
"amount": 100
}
]
},
"providerAdditionalInvoiceDetails": {
"issuer": {
"name": "TEST ISSUER ΙΚΕ",
"profession": "Εμπόριο ειδών θέρμανσης",
"taxoffice": "Α' Αθηνών",
"addressStreet": "Οδός Δοκιμής",
"addressNumber": "1",
"addressPostalCode": "10431",
"addressCity": "Αθήνα",
"addressCountry": "Ελλάδα",
"phone": "2100000000",
"email": "info@example.com",
"webSite": "www.example.com",
"registryNumber": "ΓΕΜΗ: 000000000000",
"emtyLine2": "IBAN: GR00 0000 0000 0000 0000 0000 000"
},
"counterpart": {
"code": "C-0001",
"name": "TEST CLIENT ΑΕ",
"profession": "Χονδρικό εμπόριο",
"taxoffice": "Ζωγράφου",
"addressStreet": "Οδός Πελάτη",
"addressNumber": "10",
"addressPostalCode": "15772",
"addressCity": "Ζωγράφου",
"addressCountry": "Ελλάδα",
"phone": "2100000001",
"email": "client@example.com"
},
"additionalDetails": {
"documentLabel": "Τίτλος Κτήσης",
"documentLanguageCode": "EL",
"documentSizeCode": 0,
"documentComments": "Εξόφληση εντός 30 ημερών.",
"paymentMethodInvoiceLabel": "Επί πιστώσει"
}
}
}
]
}
8.2 — Climate crisis resilience fee
Declare the fee as an "other tax" with a fixed amount: otherTaxesPercentCategory 20–30, per overnight stay. See Other taxes.
{
"invoice": [
{
"issuer": {
"vatNumber": "123456789",
"country": "GR",
"branch": 0
},
"counterpart": {
"vatNumber": "987654324",
"country": "GR",
"branch": 0,
"address": {
"street": "Οδός Πελάτη",
"number": "10",
"postalCode": "15772",
"city": "Ζωγράφου"
}
},
"invoiceHeader": {
"series": "A",
"aa": "1006",
"issueDate": "2026-09-24",
"invoiceType": "8.2",
"currency": "EUR"
},
"paymentMethods": [
{
"type": 3,
"amount": 6.0
}
],
"invoiceDetails": [
{
"lineNumber": 1,
"lineCode": "CRF-01",
"quantity": 2,
"measurementUnitLabel": "ΔΙΑΝ.",
"lineUnitPrice": 0,
"totalNetPriceBeforeDiscount": 0,
"totalDiscountValue": 0,
"netValue": 0,
"vatCategory": 8,
"vatCategoryPercent": 0,
"vatAmount": 0,
"otherTaxesPercentCategory": 21,
"otherTaxesAmount": 6.0,
"lineDescription": "Τέλος ανθεκτικότητας κλιματικής κρίσης (2 διανυκτερεύσεις)",
"incomeClassification": [
{
"classificationCategory": "category1_95",
"amount": 0
}
]
}
],
"invoiceSummary": {
"totalNetValue": 0,
"totalVatAmount": 0,
"totalWithheldAmount": 0,
"totalFeesAmount": 0,
"totalStampDutyAmount": 0,
"totalOtherTaxesAmount": 6.0,
"totalDeductionsAmount": 0,
"totalGrossValue": 6.0,
"incomeClassification": [
{
"classificationCategory": "category1_95",
"amount": 0
}
]
},
"providerAdditionalInvoiceDetails": {
"issuer": {
"name": "TEST ISSUER ΙΚΕ",
"profession": "Εμπόριο ειδών θέρμανσης",
"taxoffice": "Α' Αθηνών",
"addressStreet": "Οδός Δοκιμής",
"addressNumber": "1",
"addressPostalCode": "10431",
"addressCity": "Αθήνα",
"addressCountry": "Ελλάδα",
"phone": "2100000000",
"email": "info@example.com",
"webSite": "www.example.com",
"registryNumber": "ΓΕΜΗ: 000000000000",
"emtyLine2": "IBAN: GR00 0000 0000 0000 0000 0000 000"
},
"counterpart": {
"code": "C-0001",
"name": "TEST CLIENT ΑΕ",
"profession": "Χονδρικό εμπόριο",
"taxoffice": "Ζωγράφου",
"addressStreet": "Οδός Πελάτη",
"addressNumber": "10",
"addressPostalCode": "15772",
"addressCity": "Ζωγράφου",
"addressCountry": "Ελλάδα",
"phone": "2100000001",
"email": "client@example.com"
},
"additionalDetails": {
"documentLabel": "Τέλος Ανθεκτικότητας Κλιματικής Κρίσης",
"documentLanguageCode": "EL",
"documentSizeCode": 0,
"documentComments": "Εξόφληση εντός 30 ημερών.",
"paymentMethodInvoiceLabel": "Μετρητά"
}
}
}
]
}