📄 Erreur de Soumission TTN

Erreur lors de la Soumission TTN

⚠️ Symptômes

Lors de la soumission de factures au réseau TTN, vous rencontrez l'un de ces problèmes :

❌ Messages d'Erreur Courants

  • "Erreur de connexion au serveur TTN"
  • "Authentification refusée (401)"
  • "Accès interdit (403)"
  • "Facture refusée par la TTN"
  • "Timeout lors de la soumission"
  • "Identifiants API invalides"

🔍 Causes Possibles

Erreur Cause Solution
401 Unauthorized Identifiants API TTN incorrects Vérifier les identifiants
403 Forbidden Accès non autorisé Contacter les autorités fiscales
Timeout Problème de connexion Internet Vérifier la connexion
Facture refusée Format XML non conforme Corriger le XML
Certificat invalide Certificat expiré/révoqué Renouveler le certificat

✅ Solutions par Type d'Erreur

1. Erreur 401 - Authentification Refusée

Cause

Vos identifiants API TTN (Client ID / Client Secret) sont incorrects ou expirés.

Solution

  1. Menu ⚙️ Paramètres
  2. Onglet "API TTN"

  3. Vérifiez vos identifiants :

    • Client ID : doit correspondre à celui fourni par les autorités fiscales
    • Client Secret : sensible à la casse, vérifiez qu'il n'y a pas d'espaces
  4. Si les identifiants sont incorrects, contactez les autorités fiscales pour les obtenir

⚠️ Où Obtenir les Identifiants API TTN ?

Les identifiants API TTN sont fournis par les autorités fiscales tunisiennes lors de votre enregistrement au système de facturation électronique.

📞 Contactez-les si vous ne les avez pas reçus.

2. Erreur 403 - Accès Interdit

Cause

Votre compte API TTN n'a pas les autorisations nécessaires ou est suspendu.

Solution

  1. Vérifiez que votre matricule fiscal est bien enregistré auprès de la TTN
  2. Contactez les autorités fiscales pour vérifier le statut de votre compte
  3. Assurez-vous que vous êtes en règle fiscalement

3. Erreur de Connexion / Timeout

Cause

Problème de connexion Internet ou serveurs TTN indisponibles.

Solution

  1. Vérifier votre connexion Internet :

    • Ouvrez un navigateur et testez une URL
    • Vérifiez que le proxy/firewall n'bloque pas TEIF MANAGER

  2. Vérifier le statut de la TTN :

    • Consultez le site officiel de la TTN
    • Vérifiez s'il y a une maintenance programmée

  3. Réessayer plus tard :

    • Les serveurs TTN peuvent être temporairement indisponibles
    • Tentez à nouveau après 15-30 minutes

4. Facture Refusée par la TTN

Cause

Le format XML de la facture ne respecte pas les normes TTN.

Solution

  1. Consultez le message d'erreur détaillé dans TEIF MANAGER :

    • Onglet "Factures"
    • Cliquez sur la facture en erreur
    • Section "Détails de l'Erreur"
  2. Corrigez le fichier XML source selon les indications
  3. Re-téléchargez la facture corrigée
  4. Signez et soumettez à nouveau

👉 Guide : Corriger les erreurs de validation

5. Certificat Invalide

Cause

Votre certificat TunTrust est expiré, révoqué ou non reconnu par la TTN.

Solution

  1. Vérifiez le statut de votre certificat dans les Paramètres
  2. Si expiré : Renouveler le certificat
  3. Si révoqué : Obtenir un nouveau certificat

🔧 Diagnostic Étape par Étape

Étape 1 : Vérifier la Connexion Internet

  1. Ouvrez un navigateur web
  2. Testez l'accès à un site externe (ex: google.com)
  3. ✅ Si ça fonctionne, passez à l'étape suivante
  4. ❌ Si ça ne fonctionne pas, résolvez votre problème de connexion

Étape 2 : Vérifier les Identifiants API TTN

  1. Menu ⚙️ Paramètres → API TTN

  2. Vérifiez :

    • Client ID (pas d'espaces, majuscules/minuscules respectées)
    • Client Secret (sensible à la casse)
  3. Cliquez sur "Tester la Connexion"
  4. ✅ Si "Connexion réussie", passez à l'étape suivante
  5. ❌ Si échec, corrigez les identifiants

Étape 3 : Vérifier le Certificat

  1. Menu ⚙️ Paramètres → Token/Carte à Puce

  2. Vérifiez le statut du certificat :

    • ✅ "VALID" : OK, passez à l'étape suivante
    • ❌ "EXPIRED" : Renouveler
    • ❌ "REVOKED" : Obtenir un nouveau certificat

Étape 4 : Consulter les Logs

  1. Menu Aide → Ouvrir les journaux
  2. Recherchez les entrées contenant "TTN" ou "submission"
  3. Notez les messages d'erreur détaillés
  4. Utilisez ces informations pour identifier la cause

👉 Guide : Consulter les logs

Étape 5 : Contacter le Support (Si Nécessaire)

Si le problème persiste :

  1. Rassemblez les informations :

    • Message d'erreur exact
    • Fichiers de logs
    • Captures d'écran
  2. Contactez le support BTB LABS : support@teif.tn

🔔 Prévention

Bonnes Pratiques

  • ✅ Testez en Simulation avant de passer en Production
  • ✅ Maintenez vos identifiants API à jour
  • ✅ Vérifiez régulièrement la validité de votre certificat
  • ✅ Validez vos factures avant de les signer
  • ✅ Surveillez les logs pour détecter les erreurs rapidement

❓ Questions Fréquentes

Puis-je soumettre des factures sans connexion Internet ?

❌ Non. La soumission à la TTN nécessite une connexion Internet active.

Combien de temps pour une soumission ?

⏱️ Entre 2 et 10 secondes par facture selon la charge du réseau TTN.

Puis-je soumettre plusieurs factures en même temps ?

✅ Oui. TEIF MANAGER permet la soumission en lot.

Que se passe-t-il si la soumission échoue ?

⚠️ La facture reste dans l'état "Signée" et vous pouvez réessayer la soumission après correction.

Les factures rejetées sont-elles perdues ?

❌ Non. Elles restent dans TEIF MANAGER et peuvent être corrigées et resoumises.

🔗 Guides Associés

📞 Support

Support BTB LABS (TEIF MANAGER)

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

Support Autorités Fiscales (API TTN)

📞 Contactez les autorités fiscales tunisiennes pour tout problème lié aux identifiants API ou à l'accès TTN.

📊 Résumé : Erreurs de Soumission TTN

Type d'Erreur Solution Rapide
401 Unauthorized Vérifier identifiants API TTN
403 Forbidden Contacter autorités fiscales
Timeout Vérifier connexion Internet
Facture refusée Corriger le format XML
Certificat invalide Renouveler/obtenir nouveau certificat