Import XML TEIF — Format Standard ElFatoora

Le mode Import XML TEIF Direct est destiné aux entreprises qui génèrent leurs fichiers XML conformes au standard TEIF/ElFatoora depuis leur ERP ou système interne. TEIF MANAGER détecte et importe ces fichiers depuis un dossier dédié.

🎯 Quand utiliser ce mode ?

Votre ERP ou système interne génère déjà des fichiers XML conformes au standard TEIF
Vous souhaitez la chaîne la plus courte : XML → validation → signature → TTN
Vous voulez automatiser l'import sans intervention humaine

✅ Avantages

Pas de conversion — traitement direct du XML TEIF natif
Contrôle total sur le contenu généré côté ERP
Import en lot automatisable

📁 Préparer les fichiers

Le principe : paires XML + PDF

L'import XML TEIF fonctionne avec des paires de fichiers : un fichier XML et son PDF associé, portant le même nom de base.

  Exemple de matching :

  facture-123.xml + facture-123.pdf → ✅ Paire valide

  facture-123.xml + facture-124.pdf → ❌ Non associés (noms différents)

⚠️ Correspondance sensible à la casse

Le matching est case-sensitive : Facture-123.xml et facture-123.pdf ne seront PAS associés.

Le PDF : obligatoire ou automatique

Situation	PDF requis à l'import ?
Template HTML désactivé (mode par défaut)	✅ Oui — PDF fourni obligatoire avec le XML
Template HTML activé	❌ Non — le PDF est généré automatiquement après validation TTN

📤 Comment importer

Étape 1 — Déposer les fichiers dans le dossier inbox

Copiez vos paires XML + PDF dans le dossier d'entrée dédié :

  %APPDATA%\TEIF Manager\entity-{id}\data-process\TEIF-Import\inbox\

Cliquez sur le bouton "Ouvrir dossier inbox" dans l'onglet Import XML pour ouvrir ce dossier directement depuis l'application.

Étape 2 — Détecter les fichiers

La détection se lance automatiquement à l'ouverture de l'onglet. Pour rescanner :

Cliquez sur "Rafraîchir la détection"
TEIF MANAGER liste toutes les paires XML/PDF valides trouvées dans l'inbox

Étape 3 — Lancer l'import

Vérifiez la liste des fichiers détectés
Cliquez sur "Importer Batch"
La progression s'affiche en temps réel

Après l'import

Les fichiers source sont archivés automatiquement dans TEIF-Import/processed/ (succès) ou TEIF-Import/errors/ (erreur)
Les factures sont créées en base avec le statut draft
La validation XSD démarre automatiquement (dans les 10 secondes) → statut awaiting_signature ou validation_error

♻️ Gestion des doublons

Si un numéro de facture existe déjà dans TEIF MANAGER, le fichier n'est pas rejeté : il est importé avec un suffixe automatique (_DUP1, _DUP2…) et un statut duplicate. L'original reste intact.

🔧 Standard XML TEIF

Les fichiers XML importés doivent être conformes au standard TEIF/ElFatoora :

Élément racine : <TEIF>
Structure : <InvoiceBody> contenant <Bgm><DocumentIdentifier>
Encodage : UTF-8 obligatoire

Le schéma XSD de référence (ElFatoora) est disponible auprès de Tunisie TradeNet (TTN).

💡 Validation XSD

La validation XSD n'a pas lieu au moment de l'import. Elle est effectuée automatiquement par le moteur de validation (toutes les 10 secondes). Les erreurs sont visibles dans l'onglet "Erreurs de Validation".

❌ Erreurs fréquentes

Erreur	Cause	Solution
Fichier XML non détecté	XML sans PDF associé (même nom de base)	Ajouter le PDF correspondant dans l'inbox
Paire non associée	Noms différents ou casse différente	Renommer pour avoir exactement le même nom
XML non parsable	Fichier XML malformé	Vérifier la génération côté ERP
DocumentIdentifier manquant	Élément `<Bgm/DocumentIdentifier>` absent	Corriger la structure XML
Encodage incorrect	XML non-UTF-8	Forcer UTF-8 dans le générateur XML
Validation XSD échouée (après import)	XML non conforme au schéma ElFatoora	Consulter l'onglet "Erreurs de Validation"

🔗 Guides associés

📞 Support

📧 support@teif.tn
⏰ Lundi - Vendredi, 8h - 18h

Besoin d'accompagnement sur la facture électronique ?

Voyez TEIF Manager en action sur vos propres factures, ou posez votre question à notre équipe.

📅 Demander une démo 💬 Contacter le support