Validation Automatique

🎯 Objectif

La validation automatique est le processus par lequel TEIF MANAGER vérifie qu'un fichier XML de facture est conforme aux normes tunisiennes.

Cette validation s'effectue automatiquement dès qu'un fichier est téléchargé.

---

⚙️ Fonctionnement

Déclenchement Automatique

La validation se déclenche automatiquement dans ces cas :

• ✅ Upload manuel d'un fichier XML via l'interface
• ✅ Dépôt d'un fichier dans le répertoire surveillé
• ✅ Import depuis un ERP via API
• ✅ Extraction d'un fichier ZIP

Durée

⏱️ 1-3 secondes par facture en moyenne

---

🔍 Vérifications Effectuées

1. Structure XML

Ce qui est vérifié :

• ✅ Syntaxe XML correcte (balises ouvrantes/fermantes)
• ✅ Hiérarchie des éléments valide
• ✅ Attributs conformes
• ✅ Encodage UTF-8

Exemple d'erreur :

2. Namespace et Version UBL

Ce qui est vérifié :

• ✅ Namespace UBL 2.1 présent
• ✅ Version correcte : xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"

Exemple d'erreur :

3. Champs Obligatoires

Champs vérifiés :

Champ	Balise	Obligatoire
Numéro de facture	<cbc:ID>	✅ Oui
Date d'émission	<cbc:IssueDate>	✅ Oui
Type de facture	<cbc:InvoiceTypeCode>	✅ Oui
Fournisseur	<cac:AccountingSupplierParty>	✅ Oui
Client	<cac:AccountingCustomerParty>	✅ Oui
Lignes de facture	<cac:InvoiceLine>	✅ Oui (≥1)
Montant TTC	<cbc:TaxInclusiveAmount>	✅ Oui

Exemple d'erreur :

4. Format des Données

Ce qui est vérifié :

Type de Donnée	Format Attendu	Exemple Valide
Date	YYYY-MM-DD	2025-01-08
Montant	Décimal (point)	1250.50
Code TVA	S, Z, E, etc.	S (standard)
Matricule fiscal	7 chiffres + 1 lettre + 3 chiffres	1234567A123
Code devise	ISO 4217	TND

Exemple d'erreur :

5. Cohérence des Calculs

Ce qui est vérifié :

• ✅ Somme des lignes = Total HT
• ✅ Total HT + TVA = Total TTC
• ✅ Taux TVA corrects (19%, 13%, 7%, 0%)
• ✅ Montants cohérents (quantité × prix unitaire)

Exemple d'erreur :

6. Règles Métier Tunisiennes

Ce qui est vérifié :

• ✅ Matricule fiscal valide (format tunisien)
• ✅ Code postal tunisien (4 chiffres)
• ✅ Numéro de facture unique (pas de doublon)
• ✅ Date d'émission cohérente (pas dans le futur)

---

📊 Résultats de la Validation

✅ Facture Validée

Si toutes les vérifications passent :

• ✅ Statut : "Validée"
• ✅ La facture est prête à être signée
• ✅ Affichée avec une icône verte ✅

❌ Erreur de Validation

Si une ou plusieurs vérifications échouent :

• ❌ Statut : "Erreur de validation"
• ❌ La facture est bloquée
• ❌ Affichée avec une icône rouge ❌
• 📝 Message d'erreur détaillé disponible

---

👀 Consulter les Résultats

Vue d'Ensemble

1. Onglet "Factures"
2. Consultez la colonne "Statut"
3. Filtrez par statut :
   • ✅ "Validée"
   • ❌ "Erreur de validation"

Détails d'une Erreur

1. Cliquez sur une facture "❌ Erreur de validation"
2. Section "Détails de l'Erreur"
3. Consultez :
   • 📝 Message d'erreur complet
   • 📍 Ligne XML concernée (si applicable)
   • 💡 Suggestions de correction

---

🔄 Revalider une Facture

Si vous corrigez le fichier XML source et le re-téléchargez :

1. Supprimez l'ancienne version (clic droit → Supprimer)
2. Téléchargez le fichier corrigé
3. ✅ La validation se déclenche automatiquement
4. ✅ Si tout est OK, la facture passe en statut "Validée"

👉 Guide : Corriger les erreurs de validation

---

💡 Bonnes Pratiques

1. Testez en Simulation d'Abord

• ✅ Uploadez vos factures en mode Simulation
• ✅ Vérifiez qu'elles sont toutes validées
• ✅ Passez en mode Production une fois sûr

2. Utilisez un Modèle XML

• ✅ Téléchargez un modèle depuis TEIF MANAGER (Menu Aide)
• ✅ Utilisez-le comme base pour vos factures
• ✅ Garantit la conformité

3. Vérifiez Votre ERP

• ✅ Si votre ERP génère du XML non conforme, contactez l'éditeur
• ✅ Demandez une mise à jour pour conformité UBL 2.1 Tunisie

4. Consultez les Logs

• ✅ Pour des erreurs complexes, consultez les logs détaillés
• ✅ Menu Aide → Ouvrir les journaux

---

❓ Questions Fréquentes

Combien de temps prend la validation ?

⏱️ 1-3 secondes par facture en moyenne.

La validation nécessite-t-elle une connexion Internet ?

❌ Non. La validation est locale, pas besoin d'Internet.

Puis-je désactiver la validation automatique ?

❌ Non. C'est une étape obligatoire pour garantir la conformité.

Mon XML est valide mais TEIF MANAGER le rejette ?

⚠️ Vérifiez qu'il est conforme UBL 2.1 ET aux règles tunisiennes. Consultez les logs pour détails.

Puis-je forcer l'upload d'une facture non conforme ?

❌ Non. Seules les factures validées peuvent être signées et soumises.

---

🔗 Guides Associés

• 👉 Formats de fichiers acceptés
• 👉 Uploader des factures
• 👉 Corriger les erreurs de validation
• 👉 Consulter les logs

---

📞 Support

Pour toute question sur la validation :

📧 Email : support@teif.tn
⏰ Lundi - Vendredi, 9h - 17h (GMT+1)