Formats de Fichiers Acceptés
🎯 Objectif
TEIF MANAGER accepte uniquement les fichiers XML conformes aux normes tunisiennes de facturation Ă©lectronique.
✅ Formats Supportés
1. XML Standard (UBL 2.1)
Extension : .xml
Description :
- ✅ Format principal utilisé pour les factures électroniques en Tunisie
- âś… Conforme au standard UBL 2.1 (Universal Business Language)
- ✅ Structure hiérarchique avec balises XML
Exemple de structure :
<?xml version="1.0" encoding="UTF-8"?> <Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"> <cbc:ID>FACTURE_2025_001</cbc:ID> <cbc:IssueDate>2025-01-08</cbc:IssueDate> <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode> ... </Invoice>
2. Archive ZIP
Extension : .zip
Description :
- âś… Permet d'importer plusieurs factures XML en une seule fois
- âś… Le ZIP doit contenir uniquement des fichiers
.xml - ✅ Structure de dossiers interne acceptée
Exemple de structure ZIP :
factures_janvier_2025.zip
├── facture_001.xml
├── facture_002.xml
├── facture_003.xml
└── client_xyz/
├── facture_010.xml
└── facture_011.xml
❌ Formats NON Supportés
| Format | Extension | Raison |
|---|---|---|
| Format non structuré, non traitable | ||
| Excel | .xlsx, .xls | Format propriétaire, non conforme TTN |
| Word | .docx, .doc | Format propriétaire, non conforme TTN |
| CSV | .csv | Pas assez structuré pour les factures |
| JSON | .json | Non conforme Ă la norme UBL 2.1 |
⚠️ Important
Les PDF sont générés automatiquement par TEIF MANAGER après signature. Vous n'avez pas besoin de les créer manuellement.
📋 Spécifications XML Requises
Structure Obligatoire
Chaque fichier XML doit contenir :
- âś… DĂ©claration XML :
<?xml version="1.0" encoding="UTF-8"?> - âś… Namespace UBL :
xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" - ✅ Éléments obligatoires : ID, IssueDate, InvoiceTypeCode, etc.
Champs Obligatoires
| Champ | Balise XML | Description |
|---|---|---|
| Numéro de facture | <cbc:ID> | Identifiant unique de la facture |
| Date d'Ă©mission | <cbc:IssueDate> | Format : YYYY-MM-DD |
| Type de facture | <cbc:InvoiceTypeCode> | 380 = facture normale |
| Fournisseur | <cac:AccountingSupplierParty> | Informations complètes de l'émetteur |
| Client | <cac:AccountingCustomerParty> | Informations complètes du destinataire |
| Lignes de facture | <cac:InvoiceLine> | Au moins 1 ligne |
| Montant total | <cbc:TaxInclusiveAmount> | Montant TTC |
Encodage
Les fichiers XML doivent être encodés en UTF-8 pour supporter les caractères arabes et français.
âś… Validation Automatique
Dès qu'un fichier XML est téléchargé, TEIF MANAGER vérifie :
- âś… Format XML valide : Structure syntaxiquement correcte
- âś… Namespace UBL 2.1 : Conforme au standard
- ✅ Champs obligatoires : Tous présents
- ✅ Format des données : Dates, montants, codes corrects
- ✅ Cohérence : Calculs TVA, totaux exacts
Si une erreur est détectée, la facture passe en statut "❌ Erreur de validation".
👉 Guide : Validation automatique
👉 Guide : Corriger les erreurs de validation
🔧 Générer des Fichiers XML Conformes
Depuis un ERP
La plupart des ERP modernes peuvent générer des factures XML UBL 2.1 :
- âś… Odoo : Module de facturation Ă©lectronique tunisienne
- âś… SAP : Export XML UBL
- âś… Sage : Export factures Ă©lectroniques
Consultez la documentation de votre ERP pour configurer l'export XML.
Depuis Excel ou CSV
Si vous avez vos factures dans Excel/CSV, vous pouvez :
- Utiliser un outil de conversion (script Python, Excel VBA, etc.)
- Importer dans un ERP compatible
- Contacter BTB LABS pour un script de conversion personnalisé
📧 support@teif.tn
Création Manuelle (Petit Volume)
Pour quelques factures, vous pouvez créer le XML manuellement :
- Téléchargez un modèle XML depuis TEIF MANAGER
- Ouvrez-le avec un Ă©diteur de texte (Notepad++, VS Code)
- Modifiez les valeurs (numéro, dates, montants, etc.)
- Sauvegardez au format UTF-8
- Téléchargez dans TEIF MANAGER
👉 Menu TEIF MANAGER : Aide → Télécharger Modèle XML
đź’ˇ Bonnes Pratiques
1. Utilisez UTF-8
- ✅ Garantit la compatibilité avec les caractères arabes et français
- ✅ Évite les problèmes d'encodage
2. Validez Avant d'Importer
- ✅ Utilisez un validateur XML en ligne pour vérifier la structure
- âś… Testez en mode Simulation avant Production
3. Nommage Cohérent
- âś… Utilisez des noms de fichiers explicites
- âś… Exemple :
FA-20250108-CLIENT123.xml - ❌ Évitez :
facture.xml
4. Structure de Dossiers
- âś… Organisez vos fichiers par client, date, ou statut
- âś… Facilite le suivi et l'archivage
❓ Questions Fréquentes
Puis-je importer des PDF ?
❌ Non. TEIF MANAGER génère automatiquement les PDF après signature.
Mon ERP génère du XML mais TEIF MANAGER le rejette ?
⚠️ Vérifiez que le XML est conforme UBL 2.1. Consultez les logs pour voir l'erreur exacte.
Puis-je convertir mes factures Excel en XML ?
âś… Oui, mais vous aurez besoin d'un script ou outil de conversion. Contactez le support.
Combien de factures dans un ZIP ?
✅ Illimité, mais recommandé : 100-500 factures maximum par ZIP pour des performances optimales.
🔗 Guides Associés
- 👉 Uploader des factures
- 👉 Validation automatique
- 👉 Corriger les erreurs de validation
- 👉 Téléchargement des factures
đź“ž Support
Pour toute question sur les formats XML :
📧 Email : support@teif.tn
⏰ Lundi - Vendredi, 9h - 17h (GMT+1)