📄 Corriger les Erreurs de TĂ©lĂ©chargement

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 :

❌ Ligne 45 : Balise non fermĂ©e : <cbc:ID>FACTURE_001

Cause : Il manque la balise fermante </cbc:ID>

Solution :

❌ Incorrect :

<cbc:ID>FACTURE_001

✅ Correct :

<cbc:ID>FACTURE_001</cbc:ID>

2. Champ Obligatoire Manquant

Message d'erreur :

❌ Champ obligatoire manquant : <cbc:IssueDate>

Cause : La date d'émission n'est pas présente dans le XML

Solution : Ajoutez la balise avec la date au format YYYY-MM-DD

<cbc:IssueDate>2025-01-08</cbc:IssueDate>

3. Format de Date Incorrect

Message d'erreur :

❌ Format de date invalide : "08/01/2025". Attendu : "YYYY-MM-DD"

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

Solution :

❌ Incorrect :

<cbc:IssueDate>08/01/2025</cbc:IssueDate>

✅ Correct :

<cbc:IssueDate>2025-01-08</cbc:IssueDate>

4. Format de Montant Incorrect

Message d'erreur :

❌ Format de montant invalide : "1 250,50". Utilisez le point comme sĂ©parateur dĂ©cimal.

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

Solution :

❌ Incorrect :

<cbc:TaxInclusiveAmount>1 250,50</cbc:TaxInclusiveAmount>

✅ Correct :

<cbc:TaxInclusiveAmount>1250.50</cbc:TaxInclusiveAmount>

5. Incohérence dans les Calculs

Message d'erreur :

❌ IncohĂ©rence : Total HT (1000.00) + TVA 19% (190.00) ≠ Total TTC affichĂ© (1500.00)

Cause : Erreur de calcul dans le XML

Solution : Recalculez et corrigez le montant TTC

❌ Incorrect :

<cbc:TaxExclusiveAmount>1000.00</cbc:TaxExclusiveAmount>
<cbc:TaxAmount>190.00</cbc:TaxAmount>
<cbc:TaxInclusiveAmount>1500.00</cbc:TaxInclusiveAmount>

✅ Correct :

<cbc:TaxExclusiveAmount>1000.00</cbc:TaxExclusiveAmount>
<cbc:TaxAmount>190.00</cbc:TaxAmount>
<cbc:TaxInclusiveAmount>1190.00</cbc:TaxInclusiveAmount>

6. Matricule Fiscal Invalide

Message d'erreur :

❌ Format de matricule fiscal invalide : "123456". Attendu : 7 chiffres + 1 lettre + 3 chiffres

Cause : Le matricule ne respecte pas le format tunisien

Solution :

❌ Incorrect :

<cbc:CompanyID>123456</cbc:CompanyID>

✅ Correct :

<cbc:CompanyID>1234567A123</cbc:CompanyID>

7. Namespace Manquant ou Incorrect

Message d'erreur :

❌ Namespace UBL manquant ou incorrect

Cause : L'attribut xmlns n'est pas présent ou est incorrect

Solution : Ajoutez le namespace UBL 2.1 dans la balise racine

✅ Correct :

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
         xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
         xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
  ...
</Invoice>

🔧 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 concernĂ©e
  • La valeur erronĂ©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 votre XML :

É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 ou un correctif

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

📞 Support

Besoin d'aide pour corriger une erreur ?

📧 Email : support@teif.tn
⏰ Lundi - Vendredi, 9h - 17h (GMT+1)
💡 Joignez le fichier XML et le message d'erreur