Aller au contenu

Une API pour tous les prestataires de facturation électronique

API de facturation électronique pour la Grèce et la France

Envoyez un document. Tallio l’émet via le prestataire agréé que votre marchand utilise déjà et renvoie le résultat à votre logiciel. Chaque pays que nous prenons en charge dispose d’un sandbox, pour tester avant la mise en production.

Sandbox en serviceProduction en développement6 prestataires prévus

Illustration de l’émission en production. Votre logiciel envoie un document à Tallio, qui le vérifie et l’achemine vers le prestataire du marchand. Le prestataire, l’émetteur légal, le signe et le transmet à myDATA, la plateforme de l’AADE en Grèce, qui lui attribue un numéro d’enregistrement (MARK). Le numéro, le code QR et le PDF reviennent par le prestataire, et Tallio informe votre logiciel que le document est émis. La feuille est un exemple.L’émission en productionPOST /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 } }}Talliovalideet acheminePrestataire du marchandl’émetteur légal :signe et transmetun par documentAADE myDATAattribue le MARKMARKcode QR, PDFvia le prestataireΤιμολόγιο πώλησης1.1 · 2026-10-10ExempleKafeneio Lemonia IKEΑΦΜ 666666662Olive oil, bulk15,00Delivery10,00ΦΠΑ4,35Σύνολο29,35 €MARK900000000000001PDF sur demandewebhookdocument.issuedsignétallio-signature: t=…,v1=…{ "type": "document.issued", "data": { "object": { "id": "doc_02y9O8rhJKVUXRvojdffcz", "status": "issued", "mark": "900000000000001", "qr_url": "https://sandbox.tallio.invalid/qr/90…" } }}
Illustration de l’émission en production. Votre logiciel envoie un document à Tallio, qui le vérifie et l’achemine vers le prestataire du marchand. Le prestataire, l’émetteur légal, le signe et le transmet à myDATA, la plateforme de l’AADE en Grèce, qui lui attribue un numéro d’enregistrement (MARK). Le numéro, le code QR et le PDF reviennent par le prestataire, et Tallio informe votre logiciel que le document est émis. La feuille est un exemple.POST/api/v1/documentsTalliovalide, acheminePrestataire du marchandsigne, transmetAADE myDATAattribue le MARKΤιμολόγιο1.1 · 2026-10-10Kafeneio Lemonia IKEΣύνολο29,35 €MARK900000000000001PDF sur demandeExemplewebhook: document.issuedL’émission en production

Parcours de production, valeurs d’exemple. Dans le sandbox, les documents de test n’atteignent jamais un prestataire ni l’AADE.

Vos marchands choisissent le prestataire. Tallio s’y connecte.

Prestataires

  • Tallio sandbox

    Environnement de test (sans enregistrement AADE)

    Disponible
  • Wrapp

    Prestataire agréé

    En développement
  • IMPACT

    Prestataire agréé

    Prévu
  • Epsilon Digital

    Prestataire agréé

    Prévu
  • SoftOne

    Prestataire agréé

    Prévu
  • Prosvasis

    Prestataire agréé

    Prévu
  • myDATA (AADE)

    myDATA en direct

    Prévu

Plateformes

Les noms sont des marques de leurs titulaires ; leur mention n’implique aucun partenariat.

Voir chaque prestataire et ce que signifie son statut

La facturation électronique est obligatoire

Une obligation légale

La Grèce et la France imposent la facturation électronique, en commençant par les plus grandes entreprises. Chaque prestataire a sa propre API ; votre logiciel n’en a besoin que d’une.

  • Grèce

    AADE · 17 févr. 2026

    La facturation électronique est obligatoire pour les entreprises au chiffre d’affaires 2023 supérieur à 1 000 000 €, depuis le 2 mars 2026.

    Lire sur aade.gr (site externe)
  • France

    DGFiP · juin 2026

    Toute entreprise doit pouvoir recevoir des factures électroniques depuis le 1er septembre 2026 ; les grandes entreprises et les ETI les émettent depuis, les PME et microentreprises à partir du 1er septembre 2027.

    Lire sur impots.gouv.fr (site externe)

Un appel, et l’enregistrement revient

Fonctionnement

Votre logiciel ne parle jamais au prestataire : Tallio achemine chaque document vers celui que votre marchand utilise déjà. Voir le parcours complet

  1. Envoyez le document

    Votre logiciel l’envoie une seule fois à Tallio, avec une clé qui rend les nouvelles tentatives sûres. Tallio le vérifie aussitôt.

  2. Tallio l’achemine

    Il part vers un seul prestataire, celui du marchand, qui le signe et l’enregistre auprès de l’administration fiscale.

  3. Recevez le résultat

    Le numéro d’enregistrement et le code QR reviennent à votre logiciel, et le PDF est disponible quand vous le demandez.

Vérifiable avant l’émission

Pour les développeurs

Voyez le résultat avant toute émission

Aperçu

Prévisualisez un document pour voir comment il sera classé et ce qu’il faut vérifier, sans rien envoyer.

  • Des valeurs par défaut modifiables par marchand

  • Des avertissements avant l’émission, jamais de suppositions silencieuses

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; …"
    ]
  }
}

Une seule forme d’erreur pour tous les prestataires

Erreurs

Les erreurs se lisent de la même façon, quel que soit le prestataire. Quand un prestataire est en cause, sa propre réponse accompagne l’erreur.

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

Réessayez sans risque

Nouvelles tentatives

Envoyez deux fois la même requête et vous recevez le premier document, jamais un second enregistrement.

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"
  }
}

Appelez-la depuis votre code ou depuis un agent

Intégrer

L’API REST fonctionne dès aujourd’hui. Un SDK TypeScript et un serveur MCP pour les agents d’IA sont en développement, générés à partir de la même description de l’API.

curl
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

D’autres SDK arrivent, par exemple pour Python et PHP.

Tallio connecte. Votre prestataire émet.

Responsabilités

Le prestataire agréé reste l’émetteur légal et conserve l’archive légale. Tallio prépare et achemine.

Qui fait quoi pour chaque document
ÉtapeQui s’en charge
Vérifier le document avant l’émissionTallio
L’acheminer vers le prestataire du marchandTallio
Le signer et le transmettre à l’administration fiscaleVotre prestataire
Conserver l’archive légaleVotre prestataire ; Tallio garde le statut du document
Renvoyer l’enregistrement, le code QR et le PDFLe prestataire à Tallio, Tallio à votre logiciel

Questions fréquentes

Questions

Non. Tallio est le connecteur, jamais l’émetteur de référence. En Grèce, sur la voie prestataire, le prestataire agréé que l’entreprise utilise déjà est l’émetteur légal : il signe chaque document, le transmet à myDATA, la plateforme de l’administration fiscale grecque (AADE), et conserve l’archive légale. Sur la voie directe vers myDATA (prévue), l’entreprise transmet avec ses propres identifiants AADE et l’AADE conserve l’enregistrement. Dans les deux cas, Tallio renvoie le MARK.

Oui. L’accès anticipé comprend une clé sandbox. Le sandbox remplace le prestataire et l’AADE : vous envoyez des documents de test et recevez les mêmes réponses et les mêmes webhooks, sans que rien n’atteigne l’AADE.

Non. Chaque document est acheminé vers un seul prestataire et reçoit un seul MARK. Un document déjà émis n’est jamais renvoyé : une erreur se corrige par un avoir qui reprend le MARK d’origine.

Tallio conserve les métadonnées du document, comme son statut et le MARK, et ne tient aucune archive fiscale : le prestataire conserve l’archive légale, et Tallio récupère le PDF auprès du prestataire quand vous le demandez. Pour le support, la requête et la réponse complètes sont conservées chiffrées, données personnelles masquées, et supprimées au bout de 90 jours.

Une intégration directe avec ce prestataire peut alors suffire. Tallio s’adresse aux logiciels dont les marchands utilisent des prestataires différents, ou pourraient en changer plus tard.

Émettez votre premier document de test

L’accès anticipé comprend une clé sandbox, pour envoyer des documents de test avant qu’un prestataire soit connecté.