Qu'est-ce que le format TEIF ?

Le TEIF est le format de données défini par Tunisie TradeNet (TTN) pour les factures déposées sur El Fatoora. C'est un fichier XML décrit par un schéma XSD officiel, accompagné d'un guide d'implémentation qui précise les règles que le schéma ne peut pas exprimer à lui seul. La version utilisée en production est la 1.8.8. TTN publie ses documents techniques et leurs mises à jour : la version du schéma doit donc être suivie de près, car un fichier construit sur une mauvaise version est rejeté.

La structure du TEIF reprend la logique et les noms de segments des messages de facture du standard international UN/EDIFACT (INVOIC), complétés par les identifiants et codes propres à la fiscalité tunisienne.

Facture PDF et facture TEIF : quelle différence ?

Un PDF est une image de la facture, lisible par un humain. Le fichier TEIF contient les mêmes informations sous forme de données structurées, lisibles par une machine. C'est ce fichier, signé par l'émetteur puis enregistré par TTN, qui constitue la facture électronique. Le PDF portant le QR code et la référence TTN en est la représentation visuelle, utile pour l'envoi au client et la consultation.

La structure d'un fichier TEIF

Un fichier TEIF s'organise en grands blocs :

L'en-tête (InvoiceHeader) identifie l'émetteur et le destinataire du message, en principe par leur matricule fiscal.
Le corps (InvoiceBody) contient le numéro et le type de document, les dates, les partenaires (vendeur, acheteur, adresses), les lignes de facture, les montants, la ventilation des taxes et les conditions de paiement.
La signature électronique de l'émetteur, au format XAdES, ajoutée après la génération du fichier.

Voici un extrait simplifié, donné à titre d'illustration :

<TEIF version="1.8.8" controlingAgency="TTN">
  <InvoiceHeader>
    <MessageSenderIdentifier type="I-01">0000000AAM000</MessageSenderIdentifier>
    <MessageRecieverIdentifier type="I-01">1111111BBM000</MessageRecieverIdentifier>
  </InvoiceHeader>
  <InvoiceBody>
    <Bgm>…numéro et type de document (I-11 : facture)…</Bgm>
    <Dtm>…date d'émission…</Dtm>
    <PartnerSection>…vendeur et acheteur…</PartnerSection>
    <LinSection>…lignes de la facture…</LinSection>
    <InvoiceMoa>…montants HT, TVA, TTC…</InvoiceMoa>
    <InvoiceTax>…ventilation des taxes…</InvoiceTax>
  </InvoiceBody>
  <ds:Signature>…signature XAdES de l'émetteur…</ds:Signature>
</TEIF>

Pour développer ou vérifier un fichier, référez-vous toujours au schéma XSD et au guide d'implémentation publiés par TTN : ils font foi sur les noms d'éléments, les listes de codes et les formats attendus.

Les données à préparer

Les identifiants des parties

Le matricule fiscal s'écrit sur 13 caractères, sans séparateur : 7 chiffres, une lettre clé, le code TVA, le code catégorie et 3 chiffres pour l'établissement (par exemple 0000000AAM000). Lorsque le destinataire n'a pas de matricule fiscal, d'autres identifiants sont prévus, comme le numéro de carte d'identité nationale ou de carte de séjour.

Les informations de la facture

un numéro de facture unique côté émetteur et le type de document (facture, avoir, etc.) ;
la date d'émission et, le cas échéant, la période de facturation, dans les formats imposés ;
pour chaque ligne : désignation, quantité, prix unitaire hors taxes et taxe applicable ;
les totaux hors taxes, de TVA et toutes taxes comprises ;
la ventilation par taux de TVA et les autres taxes éventuelles (droit de timbre, FODEC, etc.) ;
les conditions et moyens de paiement.

Les montants sont exprimés en dinars avec trois décimales (les millimes). Les totaux doivent être cohérents avec la somme des lignes et des taxes : un écart, même minime, peut entraîner un rejet.

La signature du fichier

Le fichier TEIF est signé selon la norme XAdES (XML Advanced Electronic Signatures), avec l'algorithme RSA-SHA256 et un certificat délivré par TunTrust, conformément aux spécifications techniques de signature publiées par TTN. Le signataire doit avoir été déclaré à TTN lors de l'adhésion. Les supports de certificat et les bonnes pratiques sont détaillés dans notre page sur la signature électronique.

Les causes de rejet les plus fréquentes

fichier non conforme au schéma XSD (élément manquant, ordre incorrect, valeur hors liste de codes) ;
matricule fiscal mal formé ou incomplet ;
montants incohérents entre les lignes, les taxes et les totaux ;
format de date non respecté ;
encodage du fichier autre que UTF-8 ;
signature absente, invalide ou réalisée avec un certificat expiré ou non déclaré ;
utilisation d'une version du schéma différente de celle attendue en production.

La meilleure parade consiste à valider chaque fichier contre le schéma XSD avant son envoi, et à traiter les retours de la plateforme de manière organisée.

Comment E Fatourti génère vos fichiers TEIF

Avec E Fatourti, vous importez vos factures PDF ou les créez directement dans l'application. La solution les convertit automatiquement au format TEIF, contrôle les données obligatoires, signe le fichier avec votre certificat TunTrust, le dépose sur El Fatoora et récupère la référence et le QR code attribués par TTN pour les intégrer au PDF final. Vous n'avez pas à manipuler de XML.

L'extrait de fichier ci-dessus est simplifié et illustratif. Les spécifications officielles de TTN prévalent.

Le format TEIF expliqué