Facture électronique en Tunisie : comment l'intégrer à votre logiciel métier

El Fatoora, TTN, TEIF : de quoi parle-t-on

Trois sigles reviennent partout dès qu'on parle de facture électronique en Tunisie. Voici ce qu'ils recouvrent, côté technique :

• El Fatoora — la plateforme nationale par laquelle transitent les factures électroniques pour être validées et enregistrées.
• TTN (Tunisie TradeNet) — l'opérateur qui exploite El Fatoora : il reçoit la facture, la contrôle, renvoie un accusé et en conserve une trace.
• TEIF (Tunisian Electronic Invoice Format) — le format de fichier normalisé (XML) attendu par la plateforme. C'est votre logiciel qui le génère : vous ne manipulez jamais le fichier à la main.

À ces trois briques s'ajoute la signature électronique : chaque facture est signée numériquement pour être acceptée par la plateforme, puis marquée d'un identifiant unique et, en pratique, d'un QR code. Une facture qui n'est pas au bon format ou mal signée est simplement rejetée par El Fatoora.

Le parcours technique d'une facture électronique

Derrière l'apparente simplicité, une facture électronique suit toujours le même circuit. Comprendre ces étapes aide à voir où votre logiciel intervient — et où les erreurs se produisent.

1. Création — la facture est saisie (ou générée) dans votre outil de gestion, avec ses lignes, montants, taxes et mentions.
2. Génération du TEIF — le logiciel transforme la facture en fichier XML normalisé, conforme au format attendu.
3. Signature électronique — le fichier est signé numériquement, ce qui garantit son intégrité et son origine.
4. Transmission à El Fatoora — le fichier signé est envoyé à la plateforme via TTN, généralement par un échange automatisé (API).
5. Accusé (ou rejet) — la plateforme renvoie un accusé de réception si tout est conforme, ou un rejet motivé sinon. Cet aller-retour doit être tracé dans votre système.

Le point sensible n'est pas la technologie : c'est la qualité des données en entrée. Un client mal identifié, un taux de taxe erroné ou un modèle de facture incomplet se traduisent par des rejets à répétition. D'où l'intérêt de partir de données propres.

Anticiper les erreurs et l'indisponibilité de la plateforme

Une intégration sérieuse ne suppose pas que tout se passe bien. La plateforme peut être momentanément indisponible, lente, ou renvoyer un rejet. Votre système doit prévoir :

• File d'attente et ré-essais (retry) — en cas d'indisponibilité ou de latence, la facture est mise en attente et renvoyée automatiquement, sans bloquer l'utilisateur.
• Idempotence — un renvoi ne doit jamais créer de doublon côté plateforme : chaque facture porte une référence de suivi unique.
• Traitement asynchrone — l'envoi et la réception de l'accusé se font en arrière-plan ; l'utilisateur n'attend pas la réponse de TTN pour continuer.
• Mode dégradé — vous pouvez continuer à créer et signer les factures même si la transmission est temporairement impossible, puis vider la file dès le retour du service.
• Journalisation et alertes — chaque échec est tracé et remonté, pour qu'aucune facture ne reste bloquée sans que personne ne le sache.

L'intégrer à votre logiciel métier : tous les scénarios

La vraie question n'est pas « faut-il une facture électronique ? » mais « par où mon logiciel se connecte-t-il à la chaîne El Fatoora ? ». Il existe plusieurs points d'intégration, souvent combinables. Voici les scénarios les plus courants.

1. Se brancher sur une solution de facturation électronique tierce

Vous reliez votre logiciel métier (ERP, CRM, caisse) à une plateforme de facturation électronique existante, qui prend en charge la génération du TEIF, la signature et l'envoi à TTN. La connexion se fait via son API, ses connecteurs prêts à l'emploi ou ses webhooks. Rapide à déployer ; en contrepartie, vos données de facturation transitent par un prestataire tiers.

2. Intégrer un service de signature électronique

La signature (au standard XAdES) est une étape à part entière, qui peut être gérée de trois manières selon votre volume :

• Certificat sur token USB — signature locale avec code PIN, adaptée aux petits volumes et à une validation humaine.
• Cachet serveur (signature côté serveur) — automatise la signature sans intervention manuelle, pour les volumes importants et les flux automatisés.
• Service de signature à distance via API — la signature est fournie comme un service (souvent adossé à un module matériel sécurisé, HSM) que votre logiciel appelle directement.

3. Se connecter directement à la plateforme TTN

Votre logiciel dialogue directement avec El Fatoora via les canaux ouverts par TTN — API, web services ou SFTP — et prend en charge lui-même la génération du TEIF, la signature et le suivi des accusés. C'est le scénario qui offre le plus de maîtrise, au prix d'un effort d'ingénierie plus important.

4. Passer par un middleware d'intégration

Une brique intermédiaire (parfois open source) s'intercale entre votre outil et la plateforme : elle gère la génération TEIF, la signature, l'envoi et le suivi, et expose une interface simple que votre ERP appelle. Bon compromis entre rapidité et maîtrise.

5. Connecter votre ERP, CRM ou logiciel comptable existant

Via des connecteurs vers les outils du marché (Odoo, Sage, SAP, Oracle…) ou une intégration sur-mesure, la facture part directement depuis l'endroit où vous travaillez déjà — sans double saisie. Pour les métiers à règles particulières (récurrence, projets, prorata, multi-devises), la logique est modélisée au plus près de vos processus.

6. Couvrir vos canaux de vente

Vos factures ne naissent pas toutes au même endroit : site e-commerce, caisse (POS), application mobile. Une intégration complète branche aussi ces points de vente sur la chaîne électronique, pour qu'aucune facture n'échappe au circuit.

Ces scénarios se combinent : un ERP peut appeler un middleware, qui délègue la signature à un service dédié avant transmission à TTN. Quelle que soit l'architecture, l'intégration repose toujours sur trois éléments : un mapping propre entre vos données et les champs du TEIF, un échange automatisé avec la plateforme, et une gestion des accusés qui remonte le statut de chaque facture dans votre système. Bien conçue, l'opération est invisible pour l'utilisateur : il clique sur « envoyer », le reste est automatique.

Comment choisir votre scénario

Le bon choix dépend de quelques critères simples : votre volume de factures, la présence ou non d'un ERP ou logiciel de gestion, votre budget, votre exigence de maîtrise et de souveraineté des données, et l'effort d'ingénierie que vous pouvez y consacrer.

Comparer les principales architectures

Sur l'effort : une connexion directe ne se limite pas au « branchement ». Il faut intégrer le web service de TTN, gérer le certificat et la signature, passer les tests de conformité obligatoires, puis assurer la maintenance à chaque évolution du format TEIF ou de l'API. Comptez un ordre de grandeur de plusieurs semaines à quelques mois selon votre équipe, plus un coût de maintenance continu — à mettre en face du gain d'indépendance.

Quelle recommandation selon votre profil

• TPE / indépendant, faible volume, pas d'ERP — une solution de facturation tierce clé en main, avec signature sur token USB. Rapide, peu coûteux, rien à développer.
• PME avec un ERP ou un CRM — un middleware ou un connecteur qui branche votre outil existant sur El Fatoora, pour éviter la double saisie. Signature sur token USB si les volumes restent modérés.
• Gros volume / facturation automatisée — connexion directe à TTN (ou middleware robuste) avec cachet serveur ou signature à distance (API), pour signer sans intervention manuelle.
• Métier à règles particulières ou multi-canal (récurrence, projets, e-commerce + caisse) — un développement sur-mesure qui modélise vos règles et couvre tous vos canaux de vente.

Choisir le mode de signature

Une règle simple, guidée par le volume et l'automatisation :

• Token USB — petits volumes : chaque signature exige la présence physique du token et la saisie du code PIN, ce qui ne s'automatise pas. Au-delà de quelques factures par jour, cela devient un goulot d'étranglement.
• Cachet serveur — volumes importants, signature automatisée sans intervention.
• Signature à distance (API / HSM) — quand la signature doit être intégrée directement dans un flux logiciel.

Les questions à poser à un prestataire

• Générez-vous le TEIF et gérez-vous la signature et l'envoi à TTN de bout en bout ?
• Proposez-vous un connecteur vers mon ERP/CRM, ou une API ouverte ?
• Comment sont remontés les accusés et les rejets dans mon système ?
• Où sont hébergées et archivées mes factures, et sous quel format ?
• Quels modes de signature supportez-vous (token, cachet serveur, API) ?
• Que se passe-t-il si je veux changer de prestataire (réversibilité, export) ?

Un dernier point, en toute franchise : aucune architecture n'est « la meilleure » dans l'absolu. La solution tierce gagne en simplicité, la connexion directe en indépendance, le sur-mesure en adéquation métier — chacune se paie ailleurs. Le bon choix est celui qui correspond à votre volume, à vos compétences internes et à votre exigence de souveraineté ; pour un besoin standard, la solution la plus simple est souvent la bonne.

Ce que l'automatisation change au quotidien

Au-delà de l'aspect technique, l'intérêt est opérationnel. Une facturation électronique bien intégrée apporte des gains concrets :

• Fini la double saisie — la donnée n'est saisie qu'une fois, à la source. Moins de temps perdu, moins d'erreurs de recopie.
• Suivi en temps réel — vous voyez immédiatement quelles factures sont acceptées, en attente ou rejetées, sans vérifier manuellement.
• Traçabilité complète — chaque facture, sa signature et son accusé sont conservés et retrouvables en quelques clics.
• Trésorerie mieux pilotée — des factures parties plus vite et un suivi clair facilitent les relances et le recouvrement.
• Des données propres pour la compta — les informations circulent d'un système à l'autre sans ressaisie, ce qui fiabilise vos clôtures.

Autrement dit, le passage à l'électronique est l'occasion de remettre au propre tout votre processus de facturation — souvent le vrai bénéfice du chantier.

Archivage, hébergement et souveraineté

Une facture électronique n'est pas qu'un envoi ponctuel : c'est une donnée que vous devez pouvoir retrouver, relire et prouver longtemps après. Trois points techniques méritent votre attention :

• Conservation durable — archivez à la fois le TEIF signé (la preuve à valeur probante) et une version lisible (PDF) de chaque facture, avec son accusé, dans un format qui restera exploitable dans le temps.
• Chiffrement — vos données doivent être chiffrées au repos (stockage) et en transit (TLS) ; les clés et certificats sont conservés séparément, dans un coffre ou un module sécurisé.
• Intégrité et preuve — la signature électronique garantit qu'une facture archivée n'a pas été altérée ; conservez-la pour pouvoir le prouver en cas de contrôle ou de litige.
• Contrôle d'accès et traçabilité — accès restreint par rôle, journalisation des consultations, pour des données qui portent des informations sensibles sur vos clients et votre activité.
• Sauvegardes et redondance — copies régulières, géo-redondance, plan de restauration testé : une archive qu'on ne peut pas restaurer ne sert à rien.
• Hébergement maîtrisé — cloud européen, cloud souverain local ou sur vos propres serveurs : le choix dépend de votre sensibilité et de vos contraintes.

C'est un sujet à cadrer dès le départ avec votre solution : un archivage bricolé après coup coûte toujours plus cher qu'un archivage pensé dès la conception.

Questions fréquentes

Qu'est-ce que le format TEIF, concrètement ?

C'est un fichier XML normalisé qui structure toutes les informations de la facture de façon standardisée, pour que la plateforme puisse la lire automatiquement. Votre logiciel le génère ; vous n'avez pas à l'écrire vous-même.

Dois-je changer de logiciel de facturation ?

Pas nécessairement. Souvent, on peut brancher la génération du TEIF, la signature et l'envoi sur votre outil existant. Le changement ne se justifie que si votre logiciel actuel est trop limité ou fermé.

Comment brancher El Fatoora sur mon ERP existant ?

Via un connecteur qui relie votre ERP à la plateforme : il récupère les données de facture, produit le TEIF, le signe, l'envoie et remonte l'accusé. L'utilisateur continue de travailler dans son ERP habituel.

Que se passe-t-il si une facture est rejetée ?

La plateforme renvoie un motif de rejet. Une bonne intégration affiche ce motif dans votre système, vous corrigez la donnée en cause et renvoyez la facture. D'où l'importance de partir de données propres.

Où sont hébergées mes factures ?

Cela dépend de la solution retenue : elles transitent par la plateforme, mais vous devez aussi en garder une copie exploitable. L'endroit et le mode d'hébergement (cloud européen, souverain ou sur vos serveurs) sont un choix à clarifier dès le départ.

Notre approche chez OCEAN SOFT

Chez OCEAN SOFT, nous sommes éditeur de logiciels. Notre rôle n'est pas de vous vendre un énième outil à côté des autres, mais de connecter la facture électronique à votre logiciel métier — pour qu'elle se fasse sans double saisie et sans changer vos habitudes.

• Intégration à votre existant — génération du TEIF, signature et envoi à El Fatoora directement depuis votre outil de gestion.
• Automatisation de bout en bout — envoi, suivi des accusés et gestion des rejets, sans intervention manuelle.
• Souveraineté de vos données — vous gardez la maîtrise de l'hébergement et de l'archivage de vos factures.
• Mise en place rapide — dans la logique de nos pilotes livrés en quelques semaines, pas en plusieurs mois.

Pour toutes les questions d'obligations, d'échéances et de règles fiscales, votre expert-comptable reste l'interlocuteur de référence. Cet article traite volontairement de la seule dimension technique et opérationnelle.

Vous voulez brancher la facture électronique sur votre logiciel sans casser vos processus ? Décrivez-nous votre situation : nous vous dirons franchement par quoi commencer.