Μετάβαση στο περιεχόμενο

Τιμολόγια & αποδείξεις

Όλα τα παραστατικά εκδίδονται με την ίδια κλήση, 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 κανόνες που κόβουν τα περισσότερα λάθη

  1. Ένα παραστατικό ανά κλήση. Το invoice είναι πίνακας με ακριβώς ένα στοιχείο.
  2. Σημερινή ημερομηνία. Το issueDate πρέπει να είναι η σημερινή. Η μόνη εξαίρεση είναι η αποστολή με transmissionFailure = 1 (Offline).
  3. Πληρωμές = σύνολο. Το άθροισμα του paymentMethods[].amount ισούται με το invoiceSummary.totalGrossValue. Αν ο πελάτης πληρώνει αργότερα, στέλνετε type: 5 (Επί πιστώσει).
  4. Όχι επωνυμία για ελληνικά ΑΦΜ. Στο issuer και στο counterpart με country: "GR" δεν στέλνετε name. Η επωνυμία που τυπώνεται μπαίνει στο providerAdditionalInvoiceDetails.
  5. Χαρακτηρισμός σε κάθε γραμμή. Κάθε γραμμή εσόδου έχει incomeClassification με ποσό ίσο με το netValue. Η σύνοψη έχει τα αθροίσματα ανά τύπο και κατηγορία.
  6. Δύο μπλοκ, δύο σκοποί. Ό,τι είναι στο 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": "Μετρητά"
        }
      }
    }
  ]
}