Corriger les Erreurs de Validation

🎯 Objectif

Ce guide vous aide à identifier et corriger les erreurs de validation XML détectées par TEIF MANAGER.

---

🔍 Identifier l'Erreur

Étape 1 : Localiser la Facture en Erreur

1. Onglet "Factures"
2. Filtrez par statut : "❌ Erreur de validation"
3. Repérez les factures avec l'icône rouge ❌

Étape 2 : Consulter le Message d'Erreur

1. Cliquez sur la facture en erreur
2. Section "Détails de l'Erreur"
3. Lisez attentivement :
   • 📝 Message d'erreur
   • 📍 Ligne XML concernée (si indiquée)
   • 💡 Suggestion de correction

---

❌ Erreurs Courantes et Solutions

1. Balise XML Manquante ou Mal Fermée

Message d'erreur :

Cause : Erreur de syntaxe XML (balise ouvrante sans balise fermante)

Solution : Ouvrez le fichier dans un éditeur XML (Notepad++, VS Code), localisez la ligne indiquée, et ajoutez la balise de fermeture manquante.

2. Champ Obligatoire Manquant

Message d'erreur :

Cause : Un champ requis par le standard TEIF est absent du XML

Solution : Ajoutez l'élément manquant en vous référant au schéma XSD ElFatoora (disponible sur le site de Tunisie TradeNet).

3. Format de Date Incorrect

Message d'erreur :

Cause : La date n'est pas au format ISO 8601

Solution : Changez le format de la date de 08/01/2025 vers 2025-01-08.

4. Format de Montant Incorrect

Message d'erreur :

Cause : Utilisation de la virgule au lieu du point, ou espaces dans le montant

Solution : Remplacez 1 250,50 par 1250.50 (point comme séparateur décimal, pas d'espace).

5. Incohérence dans les Calculs

Message d'erreur :

Cause : Erreur de calcul dans le XML

Solution : Recalculez le montant TTC : 1000 + 190 = 1190.00 et corrigez la valeur dans le fichier XML.

6. Matricule Fiscal Invalide

Message d'erreur :

Cause : Le matricule ne respecte pas le format tunisien

Solution : Vérifiez le matricule fiscal auprès de votre comptable ou sur votre extrait de registre de commerce.

7. Structure XML Non Conforme au Format TEIF

Message d'erreur :

Cause : Le fichier XML ne respecte pas la structure définie par le standard TEIF

Solution :

• ✅ Téléchargez un modèle XML depuis TEIF MANAGER (Menu Aide → Télécharger Modèle XML)
• ✅ Comparez votre fichier avec le modèle
• ✅ Consultez le schéma XSD ElFatoora sur le site de Tunisie TradeNet

---

🔧 Processus de Correction

Étape 1 : Ouvrir le Fichier XML

1. Localisez le fichier XML source sur votre PC
2. Ouvrez-le avec un éditeur de texte :
   • ✅ Notepad++ (recommandé)
   • ✅ Visual Studio Code
   • ✅ Sublime Text
   • ⚠️ Notepad Windows (basique, déconseillé)

Étape 2 : Localiser l'Erreur

Utilisez la recherche (Ctrl + F) pour trouver :

• La ligne indiquée dans le message d'erreur
• La balise ou la valeur concernée

Étape 3 : Corriger

Modifiez le XML selon la solution indiquée ci-dessus.

Étape 4 : Sauvegarder

Important : Sauvegardez en UTF-8 !

• Notepad++ : Menu Encodage → Encoder en UTF-8
• VS Code : Cliquez sur l'encodage (barre du bas) → UTF-8

Étape 5 : Re-télécharger dans TEIF MANAGER

1. Retournez dans TEIF MANAGER
2. Supprimez l'ancienne version (clic droit → Supprimer)
3. Re-téléchargez le fichier corrigé
4. ✅ La validation automatique se déclenche
5. ✅ Si tout est OK, la facture passe en statut "Validée"

---

🛠️ Outils Utiles

Validateurs XML en Ligne

Avant de re-télécharger, testez la syntaxe de votre XML :

• 🌐 XMLValidation.com
• 🌐 CodeBeautify XML Validator

Éditeurs XML Spécialisés

• ✅ Notepad++ avec plugin XML Tools
• ✅ Oxygen XML Editor (professionnel)
• ✅ Visual Studio Code avec extension XML

---

💡 Bonnes Pratiques

1. Utilisez un Modèle

• ✅ Téléchargez un modèle conforme depuis TEIF MANAGER
• ✅ Menu Aide → Télécharger Modèle XML
• ✅ Utilisez-le comme base pour vos factures

2. Validez en Simulation d'Abord

• ✅ Testez toujours en mode Simulation
• ✅ Corrigez toutes les erreurs
• ✅ Passez en Production une fois sûr

3. Automatisez si Possible

• ✅ Si votre ERP génère du XML non conforme, contactez l'éditeur
• ✅ Demandez une mise à jour pour conformité au format TEIF/ElFatoora

4. Documentez les Erreurs Récurrentes

• ✅ Notez les erreurs fréquentes
• ✅ Créez des scripts de correction si nécessaire

---

❓ Questions Fréquentes

Puis-je corriger directement dans TEIF MANAGER ?

❌ Non. Vous devez corriger le fichier XML source et le re-télécharger.

Combien de fois puis-je réessayer ?

✅ Illimité. Corrigez et re-téléchargez autant que nécessaire.

Les anciennes versions sont-elles conservées ?

❌ Non. La nouvelle version remplace l'ancienne.

Puis-je demander de l'aide pour corriger ?

✅ Oui. Contactez le support avec le fichier XML et le message d'erreur.

---

🔗 Guides Associés

• 👉 Formats de fichiers acceptés
• 👉 Uploader des factures
• 👉 Validation automatique
• 👉 Consulter les logs
• 👉 Contacter le support

---

📞 Support

Besoin d'aide pour corriger une erreur ?

📧 Email : support@teif.tn
⏰ Lundi - Vendredi, 8h - 18h
💡 Joignez le fichier XML et le message d'erreur