Connexion Base de Données

Le mode Connexion Base de Données permet à TEIF MANAGER de se connecter directement à la base de données de votre ERP pour récupérer les données de facturation — sans export de fichier manuel.

Bases de données supportées : Oracle, Microsoft SQL Server (MSSQL), PostgreSQL, MySQL, MariaDB, et tout pilote ODBC.

---

🎯 Quand utiliser ce mode ?

• Vous avez un ERP avec base de données accessible en réseau local ou VPN
• Vous souhaitez automatiser la récupération des factures sans exports manuels
• Vous avez un volume élevé de factures à traiter régulièrement
• Vous souhaitez que votre ERP reçoive automatiquement le retour TTN (QR code, référence, XML signé)

---

🗄️ Bases de données supportées

Base de données	Port par défaut	Notes
Oracle Database	1521	Connexion native (haute performance) ou via ODBC
Microsoft SQL Server	1433	MSSQL 2016, 2019, 2022
PostgreSQL	5432	PostgreSQL 12+
MySQL	3306	MySQL 5.7, 8.0
MariaDB	3306	MariaDB 10.4+
ODBC (générique)	Dépend du driver	IBM DB2, Sybase, AS/400, Informix, FileMaker, SAP HANA, et tout SGBD avec pilote ODBC Windows

---

📋 Prérequis et permissions

Permissions requises côté base de données

Permission	Nécessaire ?	Quand ?
SELECT sur les tables de facturation	✅ Oui — toujours	Lecture des données à importer
INSERT ou UPDATE sur la table de callback	⚙️ Optionnel	Uniquement si le Callback BDD est activé
CREATE / DDL	❌ Non	Jamais nécessaire

---

⚙️ Paramètres de connexion

Paramètre	Description	Exemple
Type de BDD	Sélectionner dans la liste	Oracle (Natif), MySQL, ODBC…
Hôte	Adresse IP ou nom DNS du serveur	192.168.1.50
Port	Pré-rempli selon le type de BDD	5432
Base de données	Nom de la base	erp_production
Utilisateur / Mot de passe	Compte dédié — mot de passe stocké chiffré localement	teif_user

Notes spécifiques par base

• Oracle : Service Name ou SID requis (ex : ORCL, XE)
• MSSQL : Authentification SQL Server uniquement (Windows/AD non supporté)
• MySQL/MariaDB : Accès autorisé depuis l'IP du poste TEIF (pas uniquement localhost)
• ODBC : Nom du DSN Windows configuré dans le Gestionnaire de sources de données ODBC (64 bits)

---

🔄 Workflow d'import

1. Créer la connexion — saisir les paramètres et tester la connexion
2. Configurer la requête SQL — sélectionner la table/vue source, ou saisir une requête SELECT
3. Mapper les colonnes — associer les colonnes de votre BDD aux champs TEIF
4. Sauvegarder la configuration — réutilisable via le Lancement Rapide
5. Lancer l'import — manuel ou via Lancement Rapide

---

↩️ Callback BDD — Retour d'information dans votre ERP

Une fois la facture traitée par TTN (validation, signature, réception), TEIF MANAGER peut écrire le retour directement dans votre base de données source. C'est le Callback BDD.

Cela permet à votre ERP de récupérer automatiquement les données produites par ElFatoora, sans intervention manuelle.

Données écrites en retour

Donnée	Obligatoire	Description
Numéro de facture	✅ Oui	Clé de correspondance entre TEIF et votre table
QR Code ElFatoora	✅ Oui	QR code généré après validation TTN
Référence TTN	✅ Oui	Identifiant unique de réception TTN (ref_unique)
Date de statut	⚙️ Optionnel	Horodatage de la validation
Flag de traitement	⚙️ Optionnel	Colonne marqueur (ex : 1 = traitée) pour filtrer les prochains imports
XML final signé	⚙️ Optionnel	XML TEIF signé XAdES, archivé dans une colonne de votre table

Mode d'écriture

Deux opérations au choix :

• UPDATE — met à jour la ligne existante dans votre table (mode recommandé)
• INSERT — crée une nouvelle ligne dans une table de suivi dédiée

Configuration du Callback

1. Dans la configuration d'import BDD, déplier la section "Callback BDD"
2. Activer le toggle "Activer"
3. Choisir l'opération : INSERT ou UPDATE
4. Saisir le nom de la table cible et les noms de colonnes correspondants
5. Activer les options supplémentaires (date, flag, XML) si besoin
6. Cliquer sur "Tester le Callback" pour vérifier que la table et les colonnes existent

---

🔒 Sécurité

• Mot de passe stocké chiffré localement — jamais transmis à BTB LABS
• Activez SSL/TLS pour les connexions hors réseau local
• Limitez l'accès BDD à l'IP du poste TEIF MANAGER uniquement
• ❌ N'exposez jamais la BDD directement sur Internet

---

🔧 Dépannage

Connexion refusée / timeout

• ✅ Vérifiez que le service BDD est démarré
• ✅ Vérifiez hôte, port, et règles firewall
• ✅ Testez la connectivité réseau depuis le poste

Authentification échouée

• ✅ Vérifiez login / mot de passe
• ✅ MySQL/MariaDB : accès autorisé depuis l'IP du poste (pas uniquement localhost)
• ✅ Oracle : compte non verrouillé
• ✅ MSSQL : authentification SQL Server activée sur l'instance

ODBC : source de données non trouvée

• ✅ DSN créé dans le Gestionnaire ODBC 64 bits Windows
• ✅ Pilote ODBC du fabricant installé
• ✅ Testez le DSN depuis le gestionnaire avant de relancer TEIF

Callback BDD : 0 ligne affectée

• ✅ Vérifiez que la colonne numero_facture correspond bien à la clé de votre table
• ✅ Vérifiez que l'utilisateur a les permissions INSERT/UPDATE sur la table callback
• ✅ Utilisez le bouton "Tester le Callback" pour valider la configuration

---

❓ Questions fréquentes

TEIF MANAGER modifie-t-il mes données sources ?

❌ Non — les données sources sont lues uniquement. Le Callback écrit dans une table cible séparée que vous configurez.

Puis-je connecter plusieurs bases (multi-ERP) ?

✅ Oui. Chaque entité TEIF peut avoir sa propre configuration de connexion BDD.

Mon ERP est dans le cloud — puis-je me connecter ?

✅ Si votre hébergeur expose la BDD avec accès réseau. Sinon, utilisez Import Pivot avec un export fichier.

Puis-je utiliser le Callback pour alimenter mon ERP avec le QR code ?

✅ C'est précisément l'objectif du Callback BDD — votre ERP peut récupérer le QR code et la référence TTN automatiquement après validation.

---

🔗 Guides associés

• 👉 Import Pivot (fichiers CSV, Excel, FEC…)
• 👉 Import XML TEIF Direct
• 👉 Cycle de Vie des Factures

---

📞 Support

📧 support@teif.tn
⏰ Lundi - Vendredi, 8h - 18h
💡 Précisez votre type de BDD, sa version, et le message d'erreur exact