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

Ένα API για κάθε πάροχο ηλεκτρονικής τιμολόγησης

API ηλεκτρονικής τιμολόγησης για Ελλάδα και Γαλλία

Στείλτε ένα παραστατικό. Το Tallio το εκδίδει μέσω του αδειοδοτημένου παρόχου που ήδη χρησιμοποιεί ο έμπορος και επιστρέφει το αποτέλεσμα στο λογισμικό σας. Κάθε χώρα που υποστηρίζουμε έχει το δικό της sandbox, ώστε να δοκιμάζετε πριν περάσετε σε παραγωγή.

Πρώιμη πρόσβασηΑναφορά του API

Sandbox ενεργόΠαραγωγή σε ανάπτυξη6 πάροχοι στο πρόγραμμα

Απεικόνιση της έκδοσης σε παραγωγή. Το λογισμικό σας στέλνει ένα παραστατικό στο Tallio, που το ελέγχει και το δρομολογεί στον πάροχο του εμπόρου. Ο πάροχος, ο νόμιμος εκδότης, το υπογράφει και το διαβιβάζει στο myDATA της ΑΑΔΕ, που του αποδίδει αριθμό καταχώρισης (MARK). Ο αριθμός, ο κωδικός QR και το PDF επιστρέφουν μέσω του παρόχου και το Tallio ενημερώνει το λογισμικό σας ότι το παραστατικό εκδόθηκε. Το φύλλο είναι παράδειγμα.Πώς γίνεται η έκδοση σε παραγωγήPOST /api/v1/documents201 CreatedAuthorization: Bearer sk_…idempotency-key: order-1042{ "merchant": "mer_02y9O8rh7F50tGi0QcWRrx", "document": { "type": "1.1", "issue_date": "2026-10-10", "customer": { "name": "Kafeneio Lemonia IKE", … }, "lines": [ {…}, {…} ], "totals": { "net": 2500, "vat": 435, "gross": 2935 } }}Tallioεπικυρώνεικαι δρομολογείΠάροχος εμπόρουο νόμιμος εκδότης:υπογράφει, διαβιβάζειένας ανά παραστατικόAADE myDATAαποδίδει το MARKMARKκωδικός QR, PDFμέσω παρόχουΤιμολόγιο πώλησης1.1 · 2026-10-10ΔείγμαKafeneio Lemonia IKEΑΦΜ 666666662Olive oil, bulk15,00Delivery10,00ΦΠΑ4,35Σύνολο29,35 €MARK900000000000001PDF κατ’ αίτησηwebhookdocument.issuedυπογεγραμμένοtallio-signature: t=…,v1=…{ "type": "document.issued", "data": { "object": { "id": "doc_02y9O8rhJKVUXRvojdffcz", "status": "issued", "mark": "900000000000001", "qr_url": "https://sandbox.tallio.invalid/qr/90…" } }}
Απεικόνιση της έκδοσης σε παραγωγή. Το λογισμικό σας στέλνει ένα παραστατικό στο Tallio, που το ελέγχει και το δρομολογεί στον πάροχο του εμπόρου. Ο πάροχος, ο νόμιμος εκδότης, το υπογράφει και το διαβιβάζει στο myDATA της ΑΑΔΕ, που του αποδίδει αριθμό καταχώρισης (MARK). Ο αριθμός, ο κωδικός QR και το PDF επιστρέφουν μέσω του παρόχου και το Tallio ενημερώνει το λογισμικό σας ότι το παραστατικό εκδόθηκε. Το φύλλο είναι παράδειγμα.POST/api/v1/documentsTallioεπικυρώνει, δρομολογείΠάροχος εμπόρουυπογράφει, διαβιβάζειAADE myDATAαποδίδει το MARKΤιμολόγιο1.1 · 2026-10-10Kafeneio Lemonia IKEΣύνολο29,35 €MARK900000000000001PDF κατ’ αίτησηΔείγμαwebhook: document.issuedΠώς γίνεται η έκδοση σε παραγωγή

Ροή παραγωγής, ενδεικτικές τιμές. Στο sandbox, τα δοκιμαστικά παραστατικά δεν φτάνουν ποτέ σε πάροχο ή στην ΑΑΔΕ.

Ο έμπορος επιλέγει τον πάροχο. Το Tallio συνδέεται με αυτόν.

Πάροχοι

  • Tallio sandbox

    Δοκιμαστικό περιβάλλον (χωρίς καταχώριση στην ΑΑΔΕ)

    Διαθέσιμο

  • Wrapp

    Πάροχος ΥΠΑΗΕΣ

    Σε ανάπτυξη

  • IMPACT

    Πάροχος ΥΠΑΗΕΣ

    Προγραμματισμένο

  • Epsilon Digital

    Πάροχος ΥΠΑΗΕΣ

    Προγραμματισμένο

  • SoftOne

    Πάροχος ΥΠΑΗΕΣ

    Προγραμματισμένο

  • Prosvasis

    Πάροχος ΥΠΑΗΕΣ

    Προγραμματισμένο

  • myDATA (AADE)

    Απευθείας στο myDATA

    Προγραμματισμένο

Πλατφόρμες

Οι ονομασίες είναι σήματα των δικαιούχων τους· η αναφορά δεν σημαίνει συνεργασία.

Δείτε κάθε πάροχο και τι σημαίνει η κατάστασή του

Η ηλεκτρονική τιμολόγηση είναι υποχρεωτική

Υποχρέωση από τον νόμο

Η Ελλάδα και η Γαλλία απαιτούν ηλεκτρονική τιμολόγηση, ξεκινώντας από τις μεγαλύτερες επιχειρήσεις. Κάθε πάροχος έχει το δικό του API· το λογισμικό σας χρειάζεται μόνο ένα.

  • Ελλάδα

    AADE · 17 Φεβ 2026

    Η ηλεκτρονική τιμολόγηση είναι υποχρεωτική για επιχειρήσεις με ακαθάριστα έσοδα 2023 άνω του 1.000.000 €, από τις 2 Μαρτίου 2026.

    Διαβάστε στο aade.gr (εξωτερικός ιστότοπος)

  • Γαλλία

    DGFiP · Ιούνιος 2026

    Κάθε επιχείρηση πρέπει να μπορεί να λαμβάνει ηλεκτρονικά τιμολόγια από την 1η Σεπτεμβρίου 2026· οι μεγάλες και οι μεσαίες τα εκδίδουν από τότε, οι μικρότερες από την 1η Σεπτεμβρίου 2027.

    Διαβάστε στο impots.gouv.fr (εξωτερικός ιστότοπος)

Μία κλήση, και η καταχώριση επιστρέφει

Πώς λειτουργεί

Το λογισμικό σας δεν μιλά ποτέ με τον πάροχο: το Tallio δρομολογεί κάθε παραστατικό σε αυτόν που ήδη χρησιμοποιεί ο έμπορος. Δείτε όλη τη ροή

  1. Στείλτε το παραστατικό

    Το λογισμικό σας το στέλνει μία φορά στο Tallio, με ένα κλειδί που κάνει τις επαναλήψεις ασφαλείς. Το Tallio το ελέγχει αμέσως.

  2. Το Tallio το δρομολογεί

    Πηγαίνει σε έναν μόνο πάροχο, αυτόν του εμπόρου, που το υπογράφει και το καταχωρίζει στη φορολογική διοίκηση.

  3. Λάβετε το αποτέλεσμα

    Ο αριθμός καταχώρισης και ο κωδικός QR επιστρέφουν στο λογισμικό σας, και το PDF είναι διαθέσιμο όταν το ζητήσετε.

Ελέγχεται πριν εκδοθεί

Για προγραμματιστές

Δείτε το αποτέλεσμα πριν εκδοθεί οτιδήποτε

Προεπισκόπηση

Κάντε προεπισκόπηση ενός παραστατικού για να δείτε πώς θα χαρακτηριστεί και τι πρέπει να ελέγξετε, χωρίς να σταλεί πουθενά.

  • Προεπιλογές που αλλάζετε ανά έμπορο

  • Προειδοποιήσεις πριν την έκδοση, ποτέ σιωπηλές υποθέσεις

POST /api/v1/documents/preview (excerpt)
{
  "type": "1.1",
  "totals": {
    "net": 2500,
    "vat": 435,
    "gross": 2935
  },
  "classification": {
    "source": "default",
    "warnings": [
      "No income classification on line 2; …"
    ]
  }
}

Ένα σχήμα σφάλματος για κάθε πάροχο

Σφάλματα

Τα σφάλματα διαβάζονται το ίδιο, όποιος πάροχος κι αν βρίσκεται πίσω τους. Όταν εμπλέκεται πάροχος, η δική του απάντηση συνοδεύει το σφάλμα.

422 provider_rejected
{
  "code": "provider_rejected",
  "message": "The provider rejected the document.",
  "provider_code": "228",
  "provider_message": "Invalid counterpart VAT number.",
  "retryable": false
}

Ασφαλείς επαναλήψεις

Επαναλήψεις

Στείλτε το ίδιο αίτημα δύο φορές και παίρνετε πίσω το πρώτο παραστατικό, ποτέ δεύτερη καταχώριση.

POST /api/v1/documents
POST /api/v1/documents
idempotency-key: order-1042

HTTP/1.1 201 Created
idempotent-replayed: true

{
  "data": {
    "id": "doc_02y9O8rhJKVUXRvojdffcz",
    "status": "issued",
    "mark": "900000000000001"
  }
}

Καλέστε το από τον κώδικά σας ή από έναν πράκτορα AI

Σύνδεση

Το REST API λειτουργεί ήδη. Ένα SDK για TypeScript και ένας διακομιστής MCP για πράκτορες AI αναπτύσσονται, και παράγονται από την ίδια περιγραφή του API.

curl
Αναφορά του API
curl "$TALLIO_API_URL/api/v1/documents" \
  -H "Authorization: Bearer $TALLIO_API_KEY" \
  -H "idempotency-key: order-1042" \
  -H "Content-Type: application/json" \
  -d @document.json

Έρχονται κι άλλα SDK, όπως για Python και PHP.

Το Tallio συνδέει. Ο πάροχός σας εκδίδει.

Ευθύνες

Ο αδειοδοτημένος πάροχος παραμένει ο νόμιμος εκδότης και τηρεί το νόμιμο αρχείο. Το Tallio προετοιμάζει και δρομολογεί.

Ποιος κάνει τι για κάθε παραστατικό
ΒήμαΠοιος το κάνει
Έλεγχος του παραστατικού πριν την έκδοσηTallio
Δρομολόγηση στον πάροχο του εμπόρουTallio
Υπογραφή και διαβίβαση στη φορολογική διοίκησηΟ πάροχός σας
Τήρηση του νόμιμου αρχείουΟ πάροχός σας· το Tallio κρατά την κατάσταση του παραστατικού
Επιστροφή καταχώρισης, κωδικού QR και PDFΟ πάροχος στο Tallio, το Tallio στο λογισμικό σας

Συχνές ερωτήσεις

Ερωτήσεις

Όχι. Το Tallio συνδέει, δεν εκδίδει. Μέσω παρόχου, ο αδειοδοτημένος πάροχος που ήδη χρησιμοποιεί η επιχείρηση είναι ο νόμιμος εκδότης: υπογράφει κάθε παραστατικό, το διαβιβάζει στο myDATA της ΑΑΔΕ και τηρεί το νόμιμο αρχείο. Στην άμεση σύνδεση με το myDATA (προγραμματίζεται), η επιχείρηση διαβιβάζει με τα δικά της διαπιστευτήρια ΑΑΔΕ και η ΑΑΔΕ τηρεί την εγγραφή. Σε κάθε περίπτωση, το Tallio επιστρέφει το MARK.

Ναι. Η πρώιμη πρόσβαση συνοδεύεται από κλειδί sandbox. Το sandbox αντικαθιστά τον πάροχο και την ΑΑΔΕ, ώστε να στέλνετε δοκιμαστικά παραστατικά και να παίρνετε τις ίδιες απαντήσεις και τα ίδια webhooks, χωρίς τίποτα να φτάνει στην ΑΑΔΕ.

Όχι. Κάθε παραστατικό δρομολογείται σε έναν μόνο πάροχο και παίρνει ένα MARK. Ένα παραστατικό που έχει ήδη εκδοθεί δεν αποστέλλεται ξανά: ένα λάθος διορθώνεται με πιστωτικό που αναφέρει το αρχικό MARK.

Το Tallio κρατά τα μεταδεδομένα του παραστατικού, όπως την κατάσταση και το MARK, και δεν τηρεί φορολογικό αρχείο: ο πάροχος τηρεί το νόμιμο αρχείο και το Tallio ανακτά το PDF από τον πάροχο όταν το ζητήσετε. Για την υποστήριξη, το πλήρες αίτημα και η απάντηση φυλάσσονται κρυπτογραφημένα, με αφαιρεμένα τα προσωπικά δεδομένα, και διαγράφονται μετά από 90 ημέρες.

Τότε ίσως αρκεί μια απευθείας σύνδεση με αυτόν τον πάροχο. Το Tallio απευθύνεται σε λογισμικό που οι έμποροί του χρησιμοποιούν διαφορετικούς παρόχους ή μπορεί να αλλάξουν πάροχο αργότερα.

Εκδώστε το πρώτο σας δοκιμαστικό παραστατικό

Η πρώιμη πρόσβαση συνοδεύεται από κλειδί sandbox, ώστε να στέλνετε δοκιμαστικά παραστατικά πριν συνδεθεί οποιοσδήποτε πάροχος.

Πρώιμη πρόσβασηΔείτε πώς λειτουργεί