Format TEIF : structure XML, signature XAdES et envoi TTN

16 mai 2026 · Mis à jour le 8 octobre 2026 · 9 min de lecture · 1 500 mots · Format TEIF · Facture électronique · XML · Conformité

Par Ghassen Daoud · Co-fondateur de Gastevo · Gastevo, Testour

Le format TEIF (Tunisian Electronic Invoice Format) est le schéma XML dans lequel doit être produite toute facture électronique en Tunisie. Depuis l'article 53 de la Loi de Finances 2026, la facture électronique est obligatoire pour les prestations de services, en plus des opérations des entreprises de la DGE avec l'État et des ventes de médicaments et de carburants entre professionnels hors détaillants. La vente de marchandises par un commerce de détail n'est pas concernée (périmètre complet dans notre guide complet de la facture électronique 2026). Une facture électronique n'est pas un PDF envoyé par mail : c'est un fichier au format TEIF, signé électroniquement et enregistré via la plateforme El Fatoora opérée par Tunisie TradeNet (TTN).

Ce guide décompose la structure TEIF d'après le schéma officiel facture_INVOIC_V1.8.8_withSig.xsd publié par TTN, pour que vous compreniez ce que votre outil de facturation doit produire et ce qu'un comptable, un développeur ou un auditeur doit savoir vérifier. Gastevo inclut la facture électronique TEIF via El Fatoora ; cet article reste une lecture du schéma officiel et ne décrit pas notre implémentation.

1. Qu'est-ce que TEIF ?

TEIF est un format XML structuré défini par TTN pour standardiser l'échange électronique de factures en Tunisie. Son schéma officiel s'appelle facture_INVOIC et reprend les noms de segments des messages EDIFACT INVOIC (Bgm, Dtm, Lin, Moa, Pyt, Alc, etc.). Il ajoute des champs propres à la réglementation tunisienne : matricule fiscal au format local et codes de taxe nationaux. La version en vigueur dans ce guide est la 1.8.8 ; TTN publie aussi une version 1.9.0 en bêta sur sa page de téléchargement.

Concrètement, une facture TEIF est un fichier .xml qui contient :

• Un en-tête identifiant l'émetteur, le destinataire et la facture.
• Le détail des lignes (produit, quantité, prix, taxe).
• Les totaux (HT, TVA détaillée, TTC).
• Une signature électronique liée à un certificat reconnu.
• Une référence unique attribuée par TTN après validation.

2. Quelle est la structure d'un fichier TEIF ?

Le fichier suit une arborescence XML hiérarchique. D'après le schéma XSD 1.8.8, voici la décomposition simplifiée :

• TEIF (racine, attributs version et controlingAgency)
  • InvoiceHeader : identifiants de l'émetteur et du destinataire du message
  • InvoiceBody :
    • Bgm : identifiant et type du document
    • Dtm : dates (émission, échéance, etc.)
    • PartnerSection : émetteur et destinataire avec leurs identifiants
    • LocSection : lieux
    • PytSection : modalités de paiement
    • Ftx et SpecialConditions : textes libres et conditions particulières
    • LinSection : lignes de facture (une par produit ou service)
    • InvoiceMoa : montants totaux (HT, taxes, TTC)
    • InvoiceTax : détail des taxes par taux
    • InvoiceAlc : remises et frais au niveau de la facture
  • AdditionnalDocuments (orthographe du schéma) : documents annexes éventuels
  • RefTtnVal : référence unique de validation TTN
  • ds:Signature : signature électronique XAdES

3. Quels champs sont obligatoires dans une facture TEIF ?

Le schéma complet est publié par TTN sur sa page El Fatoora. Voici les éléments principaux.

InvoiceHeader

• MessageSenderIdentifier : matricule fiscal de l'émetteur, sur 13 caractères sans séparateur.
• MessageRecieverIdentifier (orthographe du schéma TTN, avec « ie ») : identifiant du destinataire. Le type d'identifiant peut être le matricule fiscal (I-01), la CIN (I-02), la carte de séjour (I-03) ou un autre identifiant (I-04).

Bgm et Dtm

• Bgm : numéro de facture unique côté émetteur (ex. FAC-2026-000123) et code du type de document (I-11 = facture).
• Dtm : date d'émission, dans l'élément DateText. Les formats de date autorisés par le schéma sont ddMMyy, ddMMyyHHmm et ddMMyy-ddMMyy (par exemple 170526 pour le 17 mai 2026).

PartnerSection

Deux fonctions de partenaire : émetteur (code I-62) et destinataire (code I-64). Chaque partenaire porte sa raison sociale, son identifiant (matricule fiscal ou autre type d'identifiant) et son adresse.

LinSection (lignes de facture)

Chaque ligne de la facture est un nœud Lin. Elle porte l'identifiant de l'article, sa description (Imd), la quantité, la taxe applicable (code I-1602 pour la TVA) et les montants de ligne (Moa), dont le prix unitaire hors taxes (code I-183).

InvoiceMoa et InvoiceTax

Ces deux blocs portent les totaux. Particularité tunisienne importante :

• Les totaux sont détaillés par taux de TVA (7 %, 13 %, 19 %) : voir notre guide TVA multi-taux. Dans InvoiceMoa, I-176 = total hors taxes, I-181 = total des taxes, I-180 = total TTC.
• Le timbre fiscal est déclaré séparément des taxes.
• La version 1.8.8 du schéma n'accepte pas le code I-1604 (retenue à la source) : ne comptez pas sur un bloc dédié à la RAS dans cette version.
• Le total TTC doit correspondre à la somme des lignes, des taxes et des timbres, moins les remises.

Piège fréquent : le code I-179 ne désigne pas un total de TVA, il désigne le capital de l'entreprise.

Exemple de structure TEIF (extrait simplifié)

Voici un extrait XML volontairement court, limité aux éléments dont la syntaxe est confirmée par le schéma XSD 1.8.8. Il illustre une facture de 250 TND HT à 19 % de TVA. Les identifiants et valeurs sont fictifs. Le fichier réel contient aussi les partenaires, les lignes, le détail des taxes et la signature.

<?xml version="1.0" encoding="UTF-8"?>
<TEIF version="1.8.8" controlingAgency="TTN">
  <InvoiceHeader>
    <MessageSenderIdentifier type="I-01">1234567AAM000</MessageSenderIdentifier>
    <MessageRecieverIdentifier type="I-01">7654321KNC000</MessageRecieverIdentifier>
  </InvoiceHeader>

  <InvoiceBody>
    <Bgm>
      <DocumentIdentifier>FAC-2026-000123</DocumentIdentifier>
      <DocumentType code="I-11">Facture</DocumentType>
    </Bgm>
    <Dtm>
      <DateText format="ddMMyy">170526</DateText>
    </Dtm>

    <!-- PartnerSection, LinSection, InvoiceTax : voir le schéma XSD -->

    <InvoiceMoa>
      <AmountDetails>
        <Moa amountTypeCode="I-176" currencyIdentifier="TND">250.000</Moa>
        <Moa amountTypeCode="I-181" currencyIdentifier="TND">47.500</Moa>
        <Moa amountTypeCode="I-180" currencyIdentifier="TND">297.500</Moa>
      </AmountDetails>
    </InvoiceMoa>
  </InvoiceBody>

  <!-- RefTtnVal : rempli par TTN après validation -->

  <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
    <!-- bloc de signature XAdES -->
  </ds:Signature>
</TEIF>

Les codes utilisés (I-01, I-11, I-176, I-180, I-181) proviennent du référentiel du schéma TTN. Les deux matricules de l'exemple respectent le motif du schéma (7 chiffres, lettre, lettre de régime, lettre de catégorie, 3 chiffres) mais sont fictifs. Le champ RefTtnVal est rempli par TTN après validation, pas par l'émetteur. Le bloc ds:Signature est ajouté lors de la signature électronique.

4. Comment signer une facture TEIF avec XAdES ?

La signature est ce qui transforme un fichier XML "joli" en une facture à valeur légale. Elle utilise le standard XAdES (XML Advanced Electronic Signatures) avec un certificat reconnu par l'État tunisien. TunTrust (ANCE) en publie les tarifs sur sa page dédiée (consultée en octobre 2026) :

• ID-Trust : 350 TND HT, valable 2 ans.
• DigiGo : 50 TND HT, valable 2 ans, plus des packs de recharge de 50 à 100 TND. TunTrust le décrit comme un certificat pour les services e-gov (télé-déclaration fiscale, déclaration CNSS) et ne dit pas qu'il sert à signer les factures TTN.

Nous ne recommandons pas de certificat pour la signature des factures : TTN publie une spécification technique de la signature fournisseur (version 3.0) sur sa page El Fatoora, et c'est elle, avec TTN et TunTrust, qui dit quel certificat est accepté. Un certificat n'est utile que si votre activité entre dans le périmètre de la facture électronique.

La signature est apposée sur le document, puis encapsulée dans le XML lui-même via le nœud ds:Signature. Tout changement ultérieur du document invalide la signature.

5. Référence unique, cachet visible et QR code

Chaque facture enregistrée par TTN se voit attribuer une référence unique (RefTtnVal). Le schéma prévoit aussi une référence de cachet électronique visible (ReferenceCEV) destinée à la représentation lisible de la facture. Le contenu exact d'un QR code de vérification n'est pas défini dans le schéma XSD : reportez-vous à la documentation TTN avant de l'imprimer sur vos factures.

6. Quel est le cycle de vie d'une facture TEIF ?

1. Génération : votre outil de facturation crée le XML à partir des données de vente.
2. Signature : le XML est signé avec le certificat de l'émetteur.
3. Transmission : le fichier signé est envoyé à TTN (service web SOAP, SFTP ou portail web selon les spécifications techniques TTN).
4. Validation TTN : la plateforme contrôle le fichier par rapport au schéma, la signature et les identifiants.
5. Attribution d'une référence unique : si valide, TTN attribue une RefTtnVal.
6. Conservation et copies : TTN conserve la facture, en délivre une copie sur demande et en transmet une copie au ministère des Finances.

7. Quelles erreurs éviter avec le format TEIF ?

• Matricule fiscal mal formaté : le schéma impose 13 caractères, sans barre oblique, tiret ni espace, dans l'ordre : sept chiffres, trois lettres, trois chiffres. Une forme comme 1234567/A/B/000 échoue à la validation.
• Date au mauvais format : seuls ddMMyy, ddMMyyHHmm et ddMMyy-ddMMyy sont admis. ddMMyyyy ou YYYY-MM-DD ne le sont pas.
• Mauvais code de montant : I-179 est le capital de l'entreprise, pas un total de TVA. Les codes I-189 et supérieurs sont rejetés.
• Version du schéma : l'attribut version est limité à 1.8.1 jusqu'à 1.8.8.
• Total TTC inexact : veillez à ce que les montants d'InvoiceMoa soient cohérents avec les lignes et les taxes.
• Certificat expiré : un certificat de signature périmé invalide la signature. Surveillez les renouvellements.
• Encodage : déclarez et utilisez UTF-8 pour les caractères accentués et l'arabe.

8. Comment votre outil de facturation devrait gérer TEIF

Un bon outil ne vous oblige pas à comprendre TEIF. Il génère le fichier, le signe, l'envoie et reçoit la confirmation de TTN en arrière-plan.

Concrètement, il devrait :

• Capturer l'identifiant fiscal du client dès qu'une vente à un professionnel est ouverte.
• Générer le XML TEIF conforme au schéma XSD en vigueur.
• Signer le fichier avec votre certificat.
• Envoyer le fichier signé à TTN selon ses spécifications techniques.
• Stocker la RefTtnVal retournée.
• Gérer les cas d'échec (réseau indisponible, certificat expiré, validation refusée) avec une file d'attente et un mécanisme de nouvelle tentative.

9. Et pour les ventes aux consommateurs ?

Pour les ventes à un consommateur final, le ticket de caisse classique reste le document de vente : la facturation électronique TEIF concerne les opérations dans le périmètre (prestations de services, opérations DGE avec l'État, médicaments et carburants entre professionnels hors détaillants). Une boutique qui vend des marchandises au détail n'est pas dans ce périmètre.

Cela dit, votre outil doit pouvoir basculer rapidement en mode « facture » si un client professionnel en demande une, sans interrompre le flux de la caisse.

10. Pour aller plus loin

Cet article s'inscrit dans une série sur la conformité fiscale tunisienne 2026. Consultez aussi :

• Facture électronique en Tunisie 2026 : guide complet (Article 53, El Fatoora, sanctions) : la vue d'ensemble juridique et opérationnelle.
• TVA Tunisie 2026 : guide multi-taux pour parapharmacie, parfumerie et commerce : comment gérer plusieurs taux de TVA produit par produit.
• Chèque différé en Tunisie · logiciel de pharmacie.
• Comment choisir son logiciel de caisse · comparatif tunisien 2026 · caisse vs cloud.
• Pages métier : Parapharmacie · Parfumerie · Supérette · Multi-magasins.
• Modules : Ventes · Stock · Achats.
• Glossaire · méthodologie éditoriale · à propos de Gastevo · tarifs.

La facture électronique TEIF est incluse dans Gastevo. Pour en discuter, contactez l'équipe Gastevo ou démarrez un essai gratuit de la caisse.

Sources et références

• El Fatoora, ressources officielles Tunisie TradeNet (TTN) : schémas XSD, spécifications techniques, signature fournisseur, dossier d'abonnement.
• Note commune DGI n° 02/2026 : commentaire officiel de l'article 53 de la Loi de Finances 2026.
• Tunisie TradeNet : opérateur de la plateforme nationale d'échanges électroniques commerciaux.
• JIBAYA, portail fiscal tunisien : actualités sur la facturation électronique et les obligations des contribuables.

Cet article est informatif. Les spécifications techniques du format TEIF peuvent évoluer selon les décrets d'application à venir. Consultez la documentation officielle TTN et votre expert-comptable pour validation.