Centre de Documentation FactureFacile
Guide de référence technique et opérationnel pour l'ensemble des modules : facturation certifiée avec timbre fiscal 1.000 DT, paie CNSS, comptabilité générale complète équivalente à Sage 100, connecteurs e-commerce et API publique.
Facturation Certifiée
Conforme DGI Tunisie : timbre 1.000 DT, taux TVA 19%, 13%, 7%, 0%, devis, BL et avoirs.
Comptabilité Sage 100
Plan tiers, balance âgée, lettrage automatique, rapprochement bancaire et export #MECG.
Paie & Barèmes CNSS
Calcul officiel CNSS salariale 9.18%, charges patronales 18.07%, IRPP et CSS 1%.
API REST & MCP
Intégration d'assistants IA et interconnexions ERP via protocole stdio et API publique v1.
1. Vue d'Ensemble de l'ERP
FactureFacile est une solution ERP tout-en-un développée pour le tissu économique tunisien (TPE, PME, commerçants, grossistes, sociétés de services et professions libérales). Elle offre une couverture opérationnelle complète : gestion commerciale, logistique multi-dépôts, gestion des ressources humaines conforme CNSS, messagerie d'équipe chiffrée, et une comptabilité en partie double équivalente aux standards de Sage 100.
2. Accès Démo & Configuration Initiale
Pour découvrir et tester l'application immédiatement avec des jeux de données réels, un espace de démonstration pré-configuré est accessible publiquement :
| Paramètre | Valeur de Démonstration | Description |
|---|---|---|
| URL de Connexion | https://badingo.barmaja.net/login.html |
Interface Web sécurisée (authentification par token JWT) |
| Identifiant (Email) | demo@barmaja.net |
Compte administrateur Entreprise (ID 1391) |
| Mot de Passe | demo1234 |
Accès complet à l'ensemble des modules |
| Clé API Démo | ff_live_demo1234567890abcdef1234567890 |
Clé utilisable dans l'en-tête HTTP X-API-KEY |
3. Matrice des Rôles & Permissions RBAC
L'accès des sous-comptes collaborateurs est strictement encadré par une matrice de 10 modules indépendants, validée côté backend par le contrôleur CakePHP et côté frontend par les gardes de routage Angular :
| ID Module | Désignation | Permissions Associées |
|---|---|---|
| Module 1 | Tableau de Bord / Accueil | Accès aux KPIs financiers, CA mensuel, encaissements et ratios. |
| Module 2 | Documents & Facturation | Création de devis, factures, bons de livraison, avoirs et exports PDF. |
| Module 3 | Produits & Stocks | Gestion du catalogue articles, prix d'achat, prix de vente et mouvements (+/-). |
| Module 4 | Clients | Répertoire des clients, matricules fiscaux, encours et créances. |
| Module 5 | Fournisseurs & Achats | Bons de commande fournisseurs, factures d'achat et dettes. |
| Module 6 | Employés & Paie RH | Fiches salariés, bulletins de paie CNSS, congés et notes de frais. |
| Module 7 | Paiements & Trésorerie | Encaissements, décaissements, comptes bancaires et caisses. |
| Module 8 | Comptabilité Générale (Sage 100) | Journaux, balance 6 colonnes, grand livre, plan tiers, lettrage et liasse G50. |
| Module 9 | Configuration Entreprise | Paramètres fiscaux, logo, mentions légales, devises et taux de TVA. |
| Module 10 | Gestion des Sous-Comptes | Création d'utilisateurs, attribution des mots de passe et droits RBAC. |
4. Facturation Conforme DGI & Timbre 1.000 DT
Toute pièce de vente générée par FactureFacile respecte scrupuleusement la réglementation fiscale tunisienne en vigueur :
Règles Fiscales Obligatoires
- Timbre Fiscal Légal : Application automatique d'un droit de timbre de 1.000 DT sur toute facture de vente TTC.
- Taux de TVA Légaux : Prise en charge des taux en vigueur : 19% (taux normal prestations et biens d'équipement), 13%, 7% (matières premières et santé) et 0% (exonération).
- Devise Nationale : Formatage monétaire officiel tunisien à 3 décimales (ex:
2 450.500 DT). - Mentions Légales : Matricule fiscal complet avec code TVA, catégorie et numéro d'établissement (ex:
1122334/A/M/000).
5. Gestion des Stocks & Multi-Dépôts PMP
Le module de gestion des stocks calcule en continu la valorisation de vos marchandises au Prix Moyen Pondéré (PMP) :
- Multi-Dépôts : Répartition des stocks entre plusieurs magasins ou entrepôts régionaux (ex: Tunis Siège, Sousse Dépôt, Sfax Magasin).
- Seuils d'Alerte : Chaque article possède un seuil minimum (
minimum_quantity) déclenchant une alerte visuelle avant toute rupture. - Mouvements Automatiques : La validation d'une facture de vente ou d'un bon de livraison décrémente automatiquement le stock disponible. L'émission d'une Facture d'Avoir réintègre immédiatement les articles retournés en inventaire.
6. Paie & Charges Sociales (Tunisie 2026)
Le moteur de paie est 100% conforme aux dispositions de la législation fiscale et sociale tunisienne (Code de l'IRPP, barème de la CNSS et Loi de Finances 2026) :
| Cotisation / Impôt | Taux Salarial | Taux Patronal | Assiette / Règles de Calcul |
|---|---|---|---|
| CNSS Régime Général | 9.18% | 16.57% | Salaire brut mensuel total imposable. |
| Accident du Travail (AT) | - | 1.00% | À la charge exclusive de l'employeur (varie de 0.4% à 5%). |
| FOPROLOS | - | 0.50% | Fond de promotion des logements sociaux pour les salariés. |
| Total Cotisations CNSS | 9.18% | 18.07% | Charges sociales totales obligatoires. |
| CSS (Solidarité) | 1.00% | - | Contribution Sociale de Solidarité sur revenu net imposable. |
7. Barème Progressif IRPP 2026
Après déduction de la CNSS salariale (9.18%), le calcul de l'impôt sur le revenu (IRPP) applique les abattements forfaitaires suivants :
- Frais professionnels : Déduction forfaitaire de 10% plafonnée à 2 000 DT / an (soit 166.667 DT / mois).
- Chef de famille : Déduction annuelle de 300 DT (soit 25.000 DT / mois).
- Enfants à charge : Déduction de 100 DT par enfant et par an (jusqu'à 4 enfants, soit 400 DT / an max).
| Tranche de Revenu Net Imposable Annuel | Taux d'Imposition IRPP |
|---|---|
| De 0 à 5 000 DT | 0% (Exonéré) |
| De 5 000 à 20 000 DT | 26% |
| De 20 000 à 30 000 DT | 28% |
| De 30 000 à 50 000 DT | 32% |
| Au-delà de 50 000 DT | 35% |
8. Comptabilité Complète Conforme Sage 100 (SCE Tunisie)
FactureFacile intègre un système comptable complet en partie double strictement équivalent aux fonctionnalités professionnelles de Sage 100 Comptabilité Cloud, conforme aux normes du Système Comptable des Entreprises (OECT) :
Architecture des Journaux Auxiliaires
Chaque opération commerciale ou financière est enregistrée dans son journal dédié avec numérotation séquentielle et contrôle strict de l'équilibre Débit = Crédit :
VT: Journal des Ventes (Facturation clients, TVA collectée 436719, Timbre fiscal 436780, Ventes 707000).AC: Journal des Achats (Factures fournisseurs 401000, TVA déductible 4366, Achats 607000).BQ: Journal de Banque (Encaissements et décaissements bancaires, compte 532000).CA: Journal de Caisse (Opérations en espèces, compte 540000).PAIE: Journal des Salaires (Salaires bruts 640000, CNSS à payer 453100, Net à payer 421000).OD: Opérations Diverses (Dotations aux amortissements 681100, régularisations).AN: Journal des À-Nouveaux (Reprise des soldes de bilan de début d'exercice).
Plan Tiers & Comptabilité Auxiliaire (Sage 100)
Chaque client (411CLI001), fournisseur (401FRN001) ou salarié (421SAL001) possède sa propre fiche tiers rattachée à son compte collectif. Le solde est calculé en temps réel avec suivi de l'encours et des délais de paiement.
Balance Âgée (Aging Balance)
Ventilation automatique des créances et dettes non lettrées en 5 tranches d'ancienneté pour le pilotage de la trésorerie et les relances clients :
| Tranche d'Échéance | Signification Métier | Action Recommandée |
|---|---|---|
| Non Échu | Factures dont la date limite de règlement n'est pas encore dépassée. | Suivi normal. |
| Échu 0 - 30 Jours | Retard de paiement récent (< 1 mois). | Première relance cordiale par email ou SMS. |
| Échu 31 - 60 Jours | Impayé persistant. | Appel téléphonique et rappel formel. |
| Échu 61 - 90 Jours | Retard critique. | Blocage temporaire des nouvelles commandes. |
| Au-delà de 90 Jours | Créance douteuse à haut risque. | Mise en demeure / Contentieux légal. |
9. Moteur de Lettrage Automatique & Manuel
Le lettrage permet de lier une facture émise à son règlement effectif dans les comptes de tiers :
- Lettrage Complet (Majuscule A, B, C...) : Appliqué dès que la somme des Débits égale exactement la somme des Crédits (solde nul).
- Lettrage Partiel (Minuscule a, b, c...) : Appliqué lors d'un paiement partiel ou acompte, permettant d'identifier le solde restant dû.
- Moteur Auto-Lettering 1-Clic : Algorithme parcourant l'ensemble des écritures non lettrées pour appairer automatiquement les montants concordants et références communes.
10. État de Rapprochement Bancaire (Compte 532)
Conforme à la méthode standard de rapprochement bancaire de Sage 100 :
Solde Comptable Compte 532000 + Écritures de débit non pointées (Virements reçus en cours) - Écritures de crédit non pointées (Chèques émis en circulation) = Solde Théorique Rapproché (Doit être égal au Solde du Relevé Bancaire)
L'interface permet de cocher les écritures concordantes et d'enregistrer l'état de rapprochement mensuel certifié.
11. Immobilisations & Amortissements (OD 6811)
Gestion complète du parc d'actifs de l'entreprise (Classe 2 SCE) :
- Fiche d'Immobilisation : Compte de dotation (
681100), compte d'amortissement cumulé (282xxx), valeur d'origine HT, durée d'utilisation et taux linéaire. - Calcul en Temps Réel de la VNC : Valeur Nette Comptable = Coût d'Acquisition - Amortissements Cumulés.
- Génération Automatique des Dotations : En un clic à la fin de l'exercice, l'ERP génère la pièce comptable équilibrée dans le journal
OD(Débit 681100 / Crédit 28xxxx).
12. Déclaration Fiscale Mensuelle G50 (DGI Tunisie)
L'ERP agrège en temps réel l'ensemble des données requises pour remplir la déclaration d'impôt mensuelle G50 télé-déclarable sur la plateforme de la Direction Générale des Impôts (DGI) :
| Rubrique Déclaration G50 | Base de Calcul & Taux | Compte Comptable Rattaché |
|---|---|---|
| TVA Collectée 19% | Ventes et prestations imposables au taux normal. | 436719 |
| TVA Déductible | Achats de biens d'équipement et de marchandises. | 436600 |
| Timbre Fiscal Total | Somme des droits de timbre (1.000 DT par facture TTC). | 436780 |
| Retenues à la Source sur Salaires | Cumul de l'IRPP mensuel retenu sur les fiches de paie. | 432000 |
| TCL (Taxe Collectivités Locales) | 0.2% du Chiffre d'Affaires Brut Local TTC. | 637000 / 437000 |
| FOPROLOS | 0.5% de la masse salariale brute mensuelle. | 645000 |
13. Clôture d'Exercice & Export Fichier Sage 100 (#MECG)
Pour assurer une interopérabilité totale avec les cabinets d'expertise comptable et les auditeurs, FactureFacile intègre les deux formats de référence du marché :
1. Export Natif Format Texte Sage 100 (#MECG)
Fichier structuré avec en-têtes #MECG importable sans aucune conversion dans Sage 100 Comptabilité Cloud / Coala :
#FORMAT=SAGE100_COMPTA_V17 #ENTREPRISE_ID=1391 #MECG;Date;Journal;CompteG;CompteTiers;NumPiece;Reference;Libelle;Sens;Montant;Echeance;Lettrage #MECG;10122025;VT;411000;CLI0821;VT-2026-0001;FAC-4482;Facture FAC-4482;D;3511.500;09012026;A #MECG;10122025;VT;436780;;VT-2026-0001;FAC-4482;Timbre fiscal 1.000 DT;C;1.000;; #MECG;10122025;VT;436719;;VT-2026-0001;FAC-4482;TVA collectee 19%;C;560.500;; #MECG;10122025;VT;707000;;VT-2026-0001;FAC-4482;Vente HT marchandises;C;2950.000;;
2. Export Normalisé OECT (Ordre des Experts Comptables de Tunisie)
Fichier CSV/TXT délimité par des points-virgules compatible avec tous les logiciels d'audit tunisiens.
14. Messagerie Instantanée d'Équipe & Fichiers
Chaque collaborateur de l'entreprise dispose d'une messagerie instantanée sécurisée intégrée à l'application web et mobile :
- Canaux Directs & Groupes : Échanges privés 1-à-1 ou discussions d'équipes par service (Facturation, Entrepôt, Direction).
- Partage de Pièces Jointes : Envoi direct de devis, factures PDF, reçus bancaires et photos de stock.
- Quota de Stockage : 1 Go inclus gratuitement par utilisateur. Surclassement possible à +50 Go pour les gros volumes d'archivage.
15. Connecteurs E-Commerce Shopify & WooCommerce
Synchronisez vos boutiques en ligne avec votre ERP en quelques minutes :
- Renseignez vos clés API et webhook secret dans l'onglet E-Commerce de l'ERP.
- À chaque commande validée sur votre boutique, une Facture Fiscale certifiée (avec TVA 19% et Timbre 1.000 DT) est générée automatiquement.
- Le stock des articles commandés est décrémenté en temps réel sur le dépôt assigné, éliminant les risques de vente en rupture.
16. API Publique REST v1 & Serveur MCP
FactureFacile propose une API REST complète documentée au format standard OpenAPI 3.0 ainsi qu'un serveur MCP (Model Context Protocol) permettant à des assistants IA (Claude, Antigravity, Cursor) d'exécuter des actions métier :
Authentification API
Incluez votre clé API dans l'en-tête de chaque requête HTTP :
curl -X GET "https://badingoapi.barmaja.net/api/v1/stock.json" \
-H "X-API-KEY: ff_live_demo1234567890abcdef1234567890" \
-H "Accept: application/json"
17. Application Bureau 100% Autonome Hors-Ligne
Pour les environnements à connectivité instable ou les caisses de magasins, téléchargez la version Bureau autonome :
- Windows (10/11 64-bit) : Télécharger le Setup .exe
- macOS (Apple Silicon & Intel) : Télécharger l'image .dmg
- Linux (Ubuntu, Debian, Fedora) : Télécharger l'exécutable .AppImage