Τιμολόγια & αποδείξεις¶
Όλα τα παραστατικά εκδίδονται με την ίδια κλήση, SendInvoices. Αλλάζει μόνο ο τύπος (invoiceHeader.invoiceType) και λίγα πεδία.
Ποιον τύπο να διαλέξω¶
| Συναλλαγή | Τύπος | Λήπτης (counterpart) |
Έτοιμο JSON |
|---|---|---|---|
| Πώληση αγαθών σε επιχείρηση | 1.1 |
ναι | 1.1-sales-invoice.json |
| Παροχή υπηρεσιών σε επιχείρηση | 2.1 |
ναι | 2.1-service-invoice.json |
| Λιανική πώληση αγαθών σε ιδιώτη | 11.1 |
όχι | 11.1-retail-receipt.json |
| Λιανική παροχή υπηρεσιών σε ιδιώτη | 11.2 |
όχι | 11.2-service-receipt.json |
| Αγορά από μη υπόχρεο (τίτλος κτήσης) | 3.1 |
ναι | 3.1-title-of-acquisition.json |
| Τέλος ανθεκτικότητας κλιματικής κρίσης | 8.2 |
προαιρετικά | 8.2-climate-resilience-fee.json |
| Πιστωτικό / επιστροφή | 5.1, 5.2, 11.4 |
ανάλογα | Πιστωτικά & συσχετίσεις |
| Τιμολόγιο που είναι και δελτίο αποστολής | 1.1 + isDeliveryNote |
ναι | Διακίνηση |
Μόνο τύποι 1.1 έως 11.5
Μέσω Παρόχου εκδίδονται μόνο οι τύποι 1.1 έως 11.5. Οι τύποι 12.x έως 17.x δεν διαβιβάζονται από Πάροχο. Όλοι οι επιτρεπτοί τύποι: Πίνακες ΑΑΔΕ → Παραστατικά.
Οι 6 κανόνες που κόβουν τα περισσότερα λάθη¶
- Ένα παραστατικό ανά κλήση. Το
invoiceείναι πίνακας με ακριβώς ένα στοιχείο. - Σημερινή ημερομηνία. Το
issueDateπρέπει να είναι η σημερινή. Η μόνη εξαίρεση είναι η αποστολή μεtransmissionFailure = 1(Offline). - Πληρωμές = σύνολο. Το άθροισμα του
paymentMethods[].amountισούται με τοinvoiceSummary.totalGrossValue. Αν ο πελάτης πληρώνει αργότερα, στέλνετεtype: 5(Επί πιστώσει). - Όχι επωνυμία για ελληνικά ΑΦΜ. Στο
issuerκαι στοcounterpartμεcountry: "GR"δεν στέλνετεname. Η επωνυμία που τυπώνεται μπαίνει στοproviderAdditionalInvoiceDetails. - Χαρακτηρισμός σε κάθε γραμμή. Κάθε γραμμή εσόδου έχει
incomeClassificationμε ποσό ίσο με τοnetValue. Η σύνοψη έχει τα αθροίσματα ανά τύπο και κατηγορία. - Δύο μπλοκ, δύο σκοποί. Ό,τι είναι στο
providerAdditionalInvoiceDetailsπηγαίνει μόνο στο PDF. Όλα τα υπόλοιπα πηγαίνουν στην ΑΑΔΕ.
Συνηθισμένοι χαρακτηρισμοί εσόδων¶
| Περίπτωση | classificationType |
classificationCategory |
|---|---|---|
| Χονδρική πώληση εμπορευμάτων (1.1) | E3_561_001 |
category1_1 |
| Παροχή υπηρεσιών σε επιχείρηση (2.1) | E3_561_001 |
category1_3 |
| Λιανική πώληση εμπορευμάτων (11.1) | E3_561_003 |
category1_1 |
| Λιανική παροχή υπηρεσιών (11.2, εστίαση) | E3_561_003 |
category1_3 |
| Πώληση εντός ΕΕ | E3_561_005 |
category1_1 |
| Πώληση σε τρίτη χώρα | E3_561_006 |
category1_1 |
| Πληροφοριακά (π.χ. 8.6, γραμμή ΦΠΑ OSS) | — | category1_95 |
Ποιος συνδυασμός ισχύει για κάθε τύπο παραστατικού το ορίζει η ΑΑΔΕ (αρχείο «Συνδυασμοί χαρακτηρισμών»). Όλοι οι κωδικοί: Χαρακτηρισμοί.
Έτοιμα παραδείγματα¶
Όλα περνούν τον έλεγχο αθροισμάτων. Πριν τα στείλετε:
- βάλτε στο
issuer.vatNumberτον δικό σας ΑΦΜ του Sandbox (στα παραδείγματα είναι123456789), - βάλτε στο
issueDateτη σημερινή ημερομηνία, - αλλάξτε το
aa.
Ο ΑΦΜ λήπτη 987654324 είναι φανταστικός, αλλά έγκυρος ως προς το check digit.
1.1 — Τιμολόγιο Πώλησης
{
"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 — Τιμολόγιο Παροχής Υπηρεσιών
{
"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 — Απόδειξη Λιανικής Πώλησης
{
"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 — Απόδειξη Παροχής Υπηρεσιών
{
"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 — Τίτλος Κτήσης
{
"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 — Τέλος ανθεκτικότητας κλιματικής κρίσης
Το τέλος δηλώνεται ως λοιπός φόρος με ποσό: otherTaxesPercentCategory 20–30, ανά διανυκτέρευση. Βλ. Λοιποί φόροι.
{
"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": "Μετρητά"
}
}
}
]
}