Import Pivot

Le mode Import Pivot permet d'importer des factures directement depuis les formats natifs de votre ERP, logiciel comptable ou système de gestion — sans conversion manuelle préalable.

TEIF MANAGER prend en charge six formats pivot : CSV, Excel, JSON, FEC, CXML SAP, XML BASIC.

🎯 Quand utiliser ce mode ?

Votre ERP ou logiciel comptable exporte dans l'un des formats supportés
Vous avez des données de facturation dans un tableur Excel ou un fichier CSV
Vous utilisez SAP et exportez des factures en CXML
Vous travaillez avec un logiciel français utilisant le format FEC (Sage, EBP, Ciel, etc.)
Vous voulez importer des données sans les convertir manuellement en XML TEIF

📋 Vue d'ensemble des formats supportés

Format	Extension	Idéal pour
CSV	.csv	Exports simples de tout ERP ou tableur
Excel	.xlsx / .xls	Données préparées dans Microsoft Excel
JSON	.json	Exports d'API ou ERP modernes (REST)
FEC	.txt	Logiciels comptables français (Sage, EBP, Ciel, Quadratus…)
CXML SAP	.xml	Systèmes SAP ERP / SAP S/4HANA
XML BASIC	.xml	Format TEIF simplifié pour intégration allégée

📁 Format CSV

Description

Fichier texte délimité par des virgules ou points-virgules. Export standard de la quasi-totalité des ERP et logiciels comptables.

Prérequis du fichier

✅ Encodage : UTF-8 (recommandé) ou ISO-8859-1
✅ Séparateur : virgule , ou point-virgule ;
✅ Première ligne : en-têtes de colonnes
✅ Une ligne = une facture (ou une ligne de facture)
❌ Pas de lignes vides au milieu des données

Champs attendus (minimum)

Numéro de facture
Date d'émission
Matricule fiscal émetteur
Matricule fiscal / CIN destinataire
Montant HT, montant TVA, montant TTC

💡 Mapping de colonnes

Si vos noms de colonnes diffèrent de ceux attendus, TEIF MANAGER propose un écran de correspondance pour associer vos colonnes aux champs TEIF.

Options de configuration

Séparateur de champ : , / ; / | / tabulation
Séparateur décimal : . ou ,
Format de date : JJ/MM/AAAA, AAAA-MM-JJ, etc.
Encodage : UTF-8, ISO-8859-1, Windows-1252

📊 Format Excel

Description

Fichiers Microsoft Excel au format .xlsx (Excel 2007+) ou .xls (Excel 97–2003).

Prérequis du fichier

✅ Format : .xlsx recommandé, .xls supporté
✅ Première ligne : en-têtes de colonnes
✅ Sélection de la feuille si le classeur en contient plusieurs
✅ Pas de cellules fusionnées dans la zone de données
❌ Les formules doivent avoir une valeur calculée (pas de liens brisés)

Options de configuration

Sélection de la feuille de travail (onglet)
Ligne de départ des données
Mapping de colonnes (même principe que CSV)

⚠️ Formats de date Excel

Vérifiez que vos colonnes de date sont bien au format Date dans Excel et non en texte, pour éviter les erreurs de conversion.

📋 Format JSON

Description

Format d'échange léger utilisé par les ERP et API modernes. Idéal pour des exports automatisés via REST API.

Structures acceptées

✅ Tableau JSON à la racine : [{…}, {…}, …] — chaque objet = une facture
✅ Objet avec tableau imbriqué : { "factures": [{…}, {…}] }
✅ Facture avec lignes imbriquées : { "entete": {…}, "lignes": [{…}] }

Encodage

✅ UTF-8 (standard JSON, obligatoire)

Options de configuration

Chemin vers le tableau de factures si le JSON est enveloppé (ex : $.factures)
Mapping des clés JSON vers les champs TEIF

🇫🇷 Format FEC

Description

Le Fichier des Écritures Comptables (FEC) est un format standardisé pour l'export comptable, produit par les logiciels français : Sage, EBP, Ciel, Quadratus, Cogilog, ACD, etc.

C'est un fichier texte délimité par des tabulations, avec une structure fixe définie par la réglementation.

Avantage clé

✅ Détection automatique

La structure FEC est normée. TEIF MANAGER la reconnaît automatiquement — aucun mapping manuel n'est nécessaire.

Prérequis du fichier

✅ Extension : .txt
✅ Encodage : ISO-8859-1 ou UTF-8
✅ Séparateur : tabulation
✅ Structure des colonnes FEC standard (JournalCode, EcritureDate, CompteNum, PieceRef, Debit, Credit…)

Comment exporter le FEC depuis votre logiciel

Sage : Fichier → Exporter → Fichier des Écritures Comptables
EBP : Outils → Exporter → FEC
Ciel : Dossier → Export DGFiP
Consultez la documentation de votre logiciel pour les autres cas

ℹ️ Note

TEIF MANAGER extrait les écritures de type facturation client du FEC pour construire les factures électroniques. Les autres écritures comptables sont ignorées.

🏢 Format CXML SAP

Description

Le Commerce XML (cXML) est le format standard SAP pour l'échange de documents commerciaux (factures, commandes, avis d'expédition) dans les systèmes SAP ERP, SAP S/4HANA, SAP Ariba.

Prérequis du fichier

✅ Extension : .xml
✅ Structure cXML valide (élément racine <cXML>)
✅ Document de type InvoiceDetailRequest
✅ Encodage UTF-8

Comment exporter depuis SAP

SAP ERP / S/4HANA : Transactions MIRO ou FV60 → Export cXML
SAP Ariba : Network → Factures → Exporter
Consultez votre équipe SAP Basis pour l'export automatisé en production

⚠️ Matricule fiscal tunisien

Les exports cXML SAP ne contiennent pas toujours le matricule fiscal tunisien. Vérifiez que vos fiches fournisseur/client SAP incluent ce champ, ou complétez-le dans l'écran de mapping.

📄 Format XML BASIC

Description

Le format XML BASIC est une structure XML allégée proposée par TEIF MANAGER. Plus simple que le format XML TEIF complet, il convient pour :

Une intégration légère depuis un ERP maison ou un système interne
Des scripts d'export personnalisés simples à écrire
Des cas où le XML TEIF complet est trop complexe à générer directement

Obtenir le modèle

✅ Téléchargez le modèle officiel

Dans TEIF MANAGER : Aide → Télécharger → Modèle XML BASIC
Le fichier modèle inclut des commentaires explicatifs sur chaque champ.

Prérequis du fichier

✅ Extension : .xml
✅ Encodage : UTF-8
✅ Structure conforme au modèle fourni

🔄 Workflow général d'import

Quelle que soit le format, le processus suit les mêmes étapes :

Accéder au mode Import Pivot
Onglet Factures → bouton Import Pivot
Sélectionner le format
CSV / Excel / JSON / FEC / CXML SAP / XML BASIC
Choisir le fichier
Parcourir et sélectionner votre fichier source
Configurer le format (si applicable)
Séparateur CSV, feuille Excel, chemin JSON…
Mapper les champs
Associez vos colonnes aux champs attendus par TEIF MANAGER
Non requis pour FEC (détection automatique)
Prévisualiser
Vérifiez les premières lignes avant d'importer
Importer
Les factures sont créées et passent en validation automatique

📌 Après l'import

Les factures importées suivent le cycle de vie normal : Validation → Signature → Soumission TTN. Aucune différence avec un import XML TEIF direct.

💡 Bonnes pratiques

Préparer vos fichiers

✅ Nettoyez vos données (supprimer les doublons, les lignes vides)
✅ Vérifiez les formats de date dans votre fichier
✅ Assurez-vous que le matricule fiscal est bien présent pour chaque facture
✅ Encodage UTF-8 pour éviter les problèmes avec les caractères arabes et français

Tester avant d'importer en masse

✅ Commencez par un fichier de 5 à 10 lignes pour valider le mapping
✅ Utilisez le mode Simulation pour les premiers imports
✅ Vérifiez la prévisualisation avant de lancer l'import complet

Sauvegarder la configuration de mapping

✅ Une fois votre mapping configuré, sauvegardez-le sous un nom (ex : "Export Sage Clients")
✅ Il sera réutilisable pour les prochains imports du même format

❌ Erreurs fréquentes

Erreur	Cause probable	Solution
Encodage incorrect	Fichier non-UTF-8 avec caractères spéciaux	Ré-enregistrer en UTF-8 depuis Notepad++ ou votre logiciel
Colonnes non détectées	Séparateur CSV incorrect	Changer le séparateur dans les options d'import
Date invalide	Format de date non reconnu	Spécifier le format exact (JJ/MM/AAAA, AAAA-MM-JJ…)
Matricule manquant	Colonne non mappée ou vide dans la source	Vérifier la source ou mapper manuellement
Montants incohérents	Séparateur décimal `,` vs `.`	Configurer le bon séparateur décimal dans les options
FEC non reconnu	Export FEC corrompu ou partiel	Re-exporter depuis le logiciel comptable

🔗 Guides associés

📞 Support

📧 support@teif.tn
⏰ Lundi - Vendredi, 8h - 18h
💡 Joignez un extrait de votre fichier (anonymisé) pour un diagnostic rapide

Besoin d'accompagnement sur la facture électronique ?

Voyez TEIF Manager en action sur vos propres factures, ou posez votre question à notre équipe.

📅 Demander une démo 💬 Contacter le support