Le TEIF (Tunisian Electronic Invoice Format) est le format XML que Tunisie TradeNet (TTN) impose à toute facture déposée sur El Fatoora. Le fichier reprend les données de la facture (vendeur, acheteur, lignes, taxes, totaux), porte la signature électronique XAdES de l'émetteur, puis TTN le complète avec sa référence unique, sa propre signature et un QR code. C'est ce XML validé, et non le PDF, qui constitue la facture électronique au sens de la loi tunisienne. Cet article ouvre le fichier bloc par bloc, à partir des spécifications officielles de TTN et de ce que génère Clic2Up pour chaque facture.
En bref : Au 13 octobre 2026, un fichier TEIF est un XML en UTF-8 dont l'élément racine déclare sa version (1.8.8 dans le schéma de référence de TTN). Il contient un en-tête avec le matricule fiscal de l'émetteur, un corps avec le numéro et le type de document, les dates, les parties, les lignes, les totaux et les taxes (TVA, FODEC, droit de timbre, chacune avec son code), puis la signature XAdES-B du fournisseur. Après contrôle, TTN ajoute le bloc RefTtnVal (référence unique, date, QR code) et ses propres signatures, que la signature du fournisseur exclut d'avance. Le PDF n'est qu'une copie lisible ; le XML validé se conserve dix ans.
Qu'est-ce que le format TEIF ?
TEIF est le format de données défini par Tunisie TradeNet pour échanger les factures électroniques. Le guide d'implémentation de TTN le présente comme fondé sur le standard INVOIC de l'UN/EDIFACT, le référentiel d'échange de données des Nations unies, avec une modélisation en XML décrite par un schéma du W3C.
Au 13 octobre 2026, le dossier de spécifications téléchargeable sur tradenet.com.tn contient le guide d'implémentation version 2.0 du 20 octobre 2021, le schéma XSD 1.8.8 en deux variantes (avec et sans signature), un schéma 1.8.9, un exemple de facture signée et les spécifications de signature fournisseur version 3.0 du 29 mai 2026.
Cet article décrit le fichier. Pour savoir qui doit émettre des factures électroniques, depuis quand et à quel coût, lisez notre guide complet El Fatoora 2026.
Quelle est la structure d'un fichier TEIF ?
L'élément racine TEIF porte deux attributs obligatoires : la version du format et l'agence de contrôle (« TTN »). Il contient ensuite les blocs suivants, dans cet ordre. La colonne « Obligatoire » reprend le tableau de structure du guide de TTN.
| Bloc | Contenu | Obligatoire |
|---|---|---|
| InvoiceHeader | Matricule fiscal de l'émetteur et identifiant du destinataire | Oui |
| Bgm | Numéro de la facture et type de document | Oui |
| Dtm | Dates : émission, échéance, période facturée | Oui |
| PartnerSection | Fournisseur, client et autres intervenants | Oui |
| PytSection | Conditions et instructions de paiement (RIB, mode) | Non |
| LinSection | Lignes de la facture | Oui |
| InvoiceMoa | Totaux de la facture | Oui |
| InvoiceTax | Détail des taxes : TVA, FODEC, timbre, autres | Oui |
| InvoiceAlc | Remises ou charges sur l'ensemble de la facture | Non |
| RefTtnVal | Référence TTN, date et QR code, ajoutés par TTN | Ajouté après validation |
| ds:Signature | Signature du fournisseur, puis signatures de TTN | Oui |
D'autres blocs facultatifs existent (texte libre, lieux, conditions particulières, documents joints) ; une facture ordinaire s'en passe.
Chaque information codée renvoie à un référentiel de l'annexe A du guide : I-0 pour les types d'identifiant, I-1 pour les types de document, I-3 pour les dates, I-6 pour le rôle des partenaires, I-16 pour les taxes, I-17 pour les montants. Les sections qui suivent donnent les codes utiles.
Comment le vendeur et l'acheteur sont-ils identifiés ?
Dans l'en-tête, l'élément MessageSenderIdentifier contient le matricule fiscal de l'émetteur, avec le type I-01. C'est un point de contrôle majeur : ce matricule doit être celui du compte TTN qui dépose la facture, sinon TTN refuse le dépôt.
Le guide décrit le matricule en cinq parties : l'identifiant à 7 chiffres, une lettre clé (toutes les lettres sauf I, O et U), le code TVA (A, P, B, F ou N), le code catégorie (M, P, C, N ou E) et le numéro d'établissement secondaire (000 pour l'établissement principal). Dans le XML, il s'écrit sans barres obliques, comme 0736202XAM000, le matricule de TTN dans son propre exemple.
Le destinataire est identifié par l'un des quatre types du référentiel I-0 :
| Code | Type d'identifiant |
|---|---|
| I-01 | Matricule fiscal tunisien |
| I-02 | Carte d'identité nationale (CIN) |
| I-03 | Carte de séjour |
| I-04 | Matricule fiscal non tunisien |
Le bloc PartnerSection reprend chaque partie avec son rôle (I-62 pour le fournisseur, I-64 pour le client), un identifiant, un nom et, facultativement, une adresse. Un client particulier s'identifie par sa CIN ; Clic2Up refuse d'envoyer une facture dont le client n'a ni matricule ni CIN.
Numéro, type de document et dates
Le bloc Bgm contient le numéro de la facture (DocumentIdentifier), celui de votre série de numérotation, et le type de document selon le référentiel I-1 :
| Code | Type de document |
|---|---|
| I-11 | Facture |
| I-12 | Facture d'avoir |
| I-13 | Note d'honoraire |
| I-14 | Décompte (marché public) |
| I-15 | Facture Export |
| I-16 | Bon de commande |
Clic2Up dépose les factures (I-11), les factures d'avoir (I-12) et les notes d'honoraires (I-13), et classe une facture de vente en euro ou en dollar en Facture Export (I-15). Le guide prévoit aussi un code de référence (I-89) pour citer la facture à laquelle un document se rapporte.
Le bloc Dtm porte les dates, chacune avec son code : I-31 pour la date d'émission, I-32 pour la date limite de paiement, I-36 pour la période de facturation. Les dates s'écrivent au format jour, mois, année sur deux chiffres chacun : 070612 pour le 7 juin 2012 dans l'exemple de TTN.
Comment les lignes de facture sont-elles décrites ?
Chaque ligne (Lin, dans LinSection) contient :
- un numéro de ligne (ItemIdentifier) ;
- un code article de 35 caractères au plus et une désignation (LinImd) ;
- une quantité avec son unité de mesure (LinQty) ;
- le taux de TVA de la ligne (LinTax, code I-1602) ;
- les montants (LinMoa) : prix unitaire hors taxe (I-183) et montant hors taxe de la ligne (I-171) ;
- facultativement, une remise ou une charge propre à la ligne (LinAlc) et un texte libre.
Tous les montants portent la devise selon la norme ISO 4217. En dinar, ils s'écrivent avec trois décimales, au millime près.
Comment TVA, FODEC et droit de timbre apparaissent-ils ?
Le bloc InvoiceTax récapitule les taxes de la facture, avec un sous-bloc InvoiceTaxDetails par taxe et par taux. Chaque sous-bloc donne le type de taxe (code du référentiel I-16), le taux, la base taxable (I-177) quand elle s'applique et le montant de la taxe (I-178). Les codes du référentiel :
| Code | Taxe |
|---|---|
| I-1601 | Droit de timbre |
| I-1602 | TVA |
| I-1603 | Autre |
| I-1604 | Retenue à la source |
| I-162 | Taxe professionnelle de compétitivité FODEC |
| I-163 | Taxe sur les emballages métalliques |
| I-164 | Taxe pour la protection de l'environnement (TPE) |
| I-165 à I-169 | Autres taxes spécifiques (climatiseurs, lampes et tubes, fruits et légumes, produits de la pêche…) |
En pratique, une facture à deux taux de TVA aura deux blocs I-1602, un par taux. Le droit de timbre a son propre bloc, avec un taux de 0 et son seul montant. Le FODEC a un bloc par taux, dont la base est le hors taxe des lignes soumises. Dans les fichiers produits par Clic2Up, la base des blocs TVA inclut le FODEC et les autres taxes qui entrent dans l'assiette de la TVA.
Quelle règle les totaux doivent-ils respecter ?
Le bloc InvoiceMoa porte les totaux de la facture, chacun avec un code du référentiel I-17 : I-176 pour le total hors taxe, I-181 pour le total des taxes, I-180 pour le total TTC. D'autres codes existent (total de la base taxable, montant exonéré, montant en suspension de TVA…) pour les cas particuliers.
La facture doit tomber juste : hors taxe, plus FODEC, plus les autres taxes incluses, plus TVA, plus droit de timbre, égale TTC. Clic2Up vérifie cette égalité, à 5 millimes près, avant de signer. Si elle n'est pas respectée, la facture n'est pas envoyée et le message détaille le calcul.
Les erreurs de ce type, et les autres raisons pour lesquelles TTN refuse une facture, sont détaillées dans Facture rejetée par El Fatoora : causes et solutions.
Comment la signature XAdES protège-t-elle la facture ?
La signature du fournisseur est insérée dans le fichier lui-même (signature dite enveloppée) et suit la norme XAdES-B, définie par l'ETSI (EN 319 132-1). Les spécifications de TTN fixent les détails :
- une seule signature fournisseur par facture, dans un bloc ds:Signature dont l'identifiant est « SigFrs » ;
- la canonisation XML exclusive et des empreintes SHA-256 ; l'algorithme de signature indiqué par TTN est RSA-SHA256 ;
- des propriétés signées : l'heure de signature, l'empreinte et l'émetteur du certificat, le rôle du signataire et la politique de signature de TTN (identifiant OID, empreinte et adresse du document) ;
- deux exclusions : la signature elle-même et le bloc RefTtnVal ne font pas partie de ce qui est signé.
Ces deux exclusions expliquent le fonctionnement d'ensemble : TTN peut ajouter sa référence, son QR code et ses propres signatures après coup, sans invalider celle du fournisseur. À l'inverse, toute modification du reste du fichier après la signature la casse. TTN demande donc de signer le XML dans sa forme finale exacte, en UTF-8, en évitant les caractères spéciaux.
Le certificat doit être délivré par l'Agence nationale de certification électronique (TunTrust). Les spécifications de TTN citent ID-Trust, le Cachet Entreprise, Digigo et Mobile ID (e-Houwiya). Les certificats Mobile ID utilisent une clé à courbe elliptique ; Clic2Up les signe avec l'algorithme ECDSA-SHA256 correspondant.
Pour choisir un certificat, lisez notre comparatif Digigo ou ID-Trust.
Que contient la facture une fois validée par TTN ?
Quand le contrôle réussit, TTN renvoie un fichier complété. Le guide TEIF décrit ce qu'il ajoute :
- le bloc RefTtnVal, avec la référence unique de la facture (code I-88), la date de sa génération (code I-37, au format jour, mois, année, heure et minute) et le cachet électronique visible (ReferenceCev), c'est-à-dire le QR code encodé en base64 ;
- une signature de TTN sur le cachet électronique visible (identifiant SigCEv) ;
- une signature de TTN sur le message validé (identifiant SigTTN).
C'est ce fichier final qui fait foi. Quand Clic2Up obtient la validation de TTN, il récupère ce fichier, extrait le QR code pour l'imprimer sur le PDF, et vérifie les signatures qu'il contient : pour chacune, la période de validité du certificat, sa chaîne de confiance, sa révocation (OCSP, avec repli sur la liste de révocation) et l'intégrité cryptographique. Le rapport de vérification est conservé avec la facture.
PDF ou XML : lequel fait foi ?
Le XML. L'article 18 du Code de la TVA définit la facture électronique comme un document qui contient les mentions obligatoires, porte la signature électronique de l'émetteur, est enregistré auprès de TTN et porte la référence unique attribuée par TTN. Seul le fichier TEIF validé réunit ces quatre conditions. Un PDF, même signé, n'est pas une facture électronique.
Le PDF reste la version lisible, celle qu'on envoie au client ou qu'on imprime. Le Code de la TVA autorise une copie papier de la facture électronique si elle porte la référence d'enregistrement chez TTN ; l'exemple de TTN affiche « Copie de la facture électronique enregistrée chez TTN sous la référence : … ». Clic2Up imprime la référence TTN et le QR code sur le PDF de chaque facture validée.
Les mentions exactes de la copie papier, fixées par la note commune n° 2 de 2026, sont reprises dans notre guide El Fatoora 2026.
Combien de temps conserver le XML, et où ?
Dix ans, comme toute facture : l'article 62 du Code de l'IRPP et de l'IS impose de conserver les documents comptables pendant dix ans. TTN enregistre et conserve les factures électroniques et peut en remettre une copie, au tarif de sa grille. Il reste prudent de garder votre propre exemplaire.
Gardez le fichier final renvoyé par TTN, celui qui porte RefTtnVal et les signatures de TTN, plutôt que le seul fichier signé que vous avez déposé ou le PDF. Dans Clic2Up, le XML signé déposé et le XML final validé sont conservés avec chaque facture, et le téléchargement fournit le XML final dès qu'il est disponible.
Faut-il écrire le XML TEIF soi-même ?
Non. Un logiciel de facturation relié à El Fatoora produit le fichier à partir de la facture saisie normalement : vous remplissez un client, des lignes, des taux ; le logiciel construit le XML, le fait signer et le dépose. Les entreprises qui développent leur propre intégration trouveront dans le dossier de TTN le guide, les schémas XSD, un exemple signé et la description des web services de dépôt et de consultation.
Clic2Up génère le TEIF de chaque facture, facture d'avoir et note d'honoraires, le fait signer avec Digigo, ID-Trust ou Mobile ID et le dépose chez TTN. Il est gratuit jusqu'au 31 décembre 2026, toutes les fonctions incluses, sans carte bancaire ; ensuite dès 9 TND HT/mois (voir les tarifs). Les étapes pour démarrer sont sur la page facture électronique, et vous pouvez créer un compte tout de suite.
Questions fréquentes sur le format TEIF
Que veut dire TEIF ?
TEIF signifie Tunisian Electronic Invoice Format. C'est le format XML défini par Tunisie TradeNet (TTN) pour les factures déposées sur El Fatoora. Il est construit sur le message INVOIC de la norme UN/EDIFACT des Nations unies et décrit par un schéma XML du W3C.
Quelle version du TEIF utiliser en 2026 ?
Au 13 octobre 2026, le dossier de TTN contient le guide d'implémentation TEIF 2.0 (20 octobre 2021), le schéma XSD 1.8.8 et un schéma 1.8.9 ; la version est déclarée dans l'attribut version de l'élément racine. La signature suit les spécifications fournisseur 3.0 du 29 mai 2026.
Un PDF signé peut-il remplacer le XML TEIF ?
Non. La facture électronique au sens de l'article 18 du Code de la TVA est le document signé, enregistré chez TTN et portant la référence unique de TTN : c'est le XML TEIF validé. Le PDF n'est qu'une représentation lisible, qui peut servir de copie papier s'il porte la référence TTN et les mentions prévues.
Où se trouvent la référence TTN et le QR code dans le fichier ?
Dans le bloc RefTtnVal, que TTN ajoute après validation : la référence unique (code I-88), la date de sa génération (code I-37, au format jour, mois, année, heure et minute) et le cachet électronique visible, c'est-à-dire le QR code, encodé en base64 dans l'élément ReferenceCev.
Comment le FODEC et le droit de timbre apparaissent-ils dans le TEIF ?
Chacun a son bloc dans InvoiceTax, avec son code : I-162 pour le FODEC, I-1601 pour le droit de timbre, I-1602 pour la TVA. Les blocs TVA et FODEC portent une base (I-177) et un montant (I-178) ; le droit de timbre est déclaré à un taux de 0 avec son seul montant. Dans Clic2Up, la base de la TVA inclut le FODEC.
Peut-on émettre une facture TEIF en euros ou en dollars ?
Le TEIF porte la devise sur chaque montant (code ISO 4217) et prévoit un type de document « Facture Export » (I-15). Clic2Up accepte les factures en dinar, en euro et en dollar, une seule devise par facture, et classe une facture de vente en devise étrangère en Facture Export.
Comment vérifier la signature d'un fichier TEIF ?
Les spécifications de TTN recommandent l'outil en ligne ETSI Signature Conformance Checker, option XAdES. Clic2Up a aussi un écran de vérification qui contrôle, pour chaque signature, la validité du certificat, sa chaîne de confiance, sa révocation et l'intégrité du document.
Sources
- Tunisie TradeNet : dossier des spécifications techniques El Fatoora (guide d'implémentation du message TEIF V2.0 du 20 octobre 2021, schémas XSD 1.8.8 et 1.8.9, exemple de facture signée, spécifications web services) — archive ZIP
- Tunisie TradeNet : spécifications techniques de la signature électronique fournisseur, version 3.0 du 29 mai 2026
- Tunisie TradeNet : politique de signature électronique
- Tunisie TradeNet : page El Fatoora
- Code de la TVA, édition à jour au 1er janvier 2026 (article 18, paragraphe II ter : facture électronique et copie papier) — jibaya.tn, portail de l'administration fiscale
- Code de l'IRPP et de l'IS 2026 (article 62, paragraphe IV : conservation pendant dix ans)
- Note commune n° 2 de 2026 : extension de la facture électronique aux prestations de services, mentions de la copie papier — texte en arabe