Guide de la FNE-DGI

À partir d'un document (facture, avoir…), EASY-IA construit le payload normalisé, l'envoie à l'API de la DGI, reçoit la certification (identifiant, sticker, QR), puis produit la facture certifiée (PDF/ticket) et trace tout. Si l'API est indisponible, la demande est mise en file et re-tentée — la vente n'est pas bloquée.

une facture de caisse est certifiée en une seconde : le ticket sort avec le QR de la DGI ; en cas de coupure réseau, elle part en file et se certifie dès le retour.

Dans FNE ▸ Configuration, renseignez le régime fiscal et le mode environnement : test (bac à sable DGI, pour valider l'intégration sans effet réel) puis production. Un bouton Tester la configuration confirme le dialogue avec la DGI avant d'ouvrir les vannes.

vous testez 5 factures en bac à sable, contrôlez le rendu certifié, puis passez en production — zéro mauvaise surprise le premier jour.

FNE ▸ Clés API stocke les identifiants d'accès à la DGI, permet leur rotation (renouvellement sans interruption), un test et un audit des accès. Les clés ne sont jamais exposées en clair.

à l'expiration d'une clé, vous la faites tourner en un clic : les certifications continuent sans coupure.

Le Health check et la page Santé des connecteurs indiquent l'état du lien DGI et de chaque source. Les paramètres de retry et de circuit breaker (coupe-circuit) se règlent pour encaisser les incidents sans accumuler les erreurs.

si l'API DGI ralentit, le coupe-circuit s'ouvre, les demandes s'empilent en file, et tout repart automatiquement au rétablissement.

FNE ▸ Soumission facture envoie un document à la DGI et renvoie la facture certifiée. Soumission par lot traite des centaines de factures d'un coup. La prévisualisation du payload montre exactement ce qui sera envoyé, et Réponse API DGI ce qui revient.

en fin de journée, vous certifiez en lot les 300 factures du jour ; chacune reçoit son identifiant DGI et son sticker.

Au-delà de la facture : avoir, proforma, bordereau, RNE (reçu normalisé électronique) et reçu agricole. Chaque type respecte les règles de la DGI et porte sa certification.

un avoir sur une facture certifiée est lui-même certifié et rattaché à la facture d'origine, pour une annulation traçable.

Sept sources sont prises en charge : caisse (POS), achats, ERP tiers (via connecteur), import CSV, API REST, saisie manuelle et SQL/ODBC. Un mapping par modèle traduit le format d'origine vers le payload DGI.

une entreprise facture dans son ERP historique ; EASY-IA récupère chaque facture par connecteur et la certifie — aucun changement d'habitude.

Le mode batch POS encaisse les ventes même quand la DGI est momentanément injoignable, puis certifie en rattrapage dès le retour du lien — avec suivi des batches.

pendant une coupure, la caisse continue d'encaisser ; les tickets sont certifiés en lot dès la reconnexion, sans perte.

Le Journal des certifications liste chaque document avec son statut (certifié, en file, rejeté), la File d'attente montre ce qui reste à traiter, et Recherche FNE retrouve une certification précise. État des annulations suit les avoirs.

vous filtrez le journal sur « en attente » après une coupure, et voyez la file se vider à mesure que la DGI répond.

Le registre d'idempotence garantit qu'une même demande (même document) n'est soumise qu'une fois, même en cas de re-tentative réseau — pas de doublon de certification ni de double consommation de sticker.

une re-tentative après un délai d'attente ne recrée pas la facture : le registre reconnaît la demande et renvoie la certification déjà obtenue.

La Jauge des stickers affiche le stock restant, Consommation et Volume par source montrent le rythme, et la Prédiction estime la date d'épuisement. Des Alertes préviennent avant la rupture, et Coût des stickers suit la dépense.

la prédiction annonce une rupture dans 9 jours au rythme actuel : l'alerte part, vous réapprovisionnez avant de tomber à zéro.

Trois filets : le retry re-tente automatiquement, le circuit breaker coupe temporairement pour ne pas aggraver, et la file DLQ (lettres mortes) recueille ce qui échoue durablement pour re-traitement manuel. La facturation n'est jamais bloquée côté vente.

en cas de panne DGI prolongée, les demandes s'accumulent proprement en file ; au retour, elles se certifient dans l'ordre, sans intervention.

Le Registre des workflows de rejet suit chaque cas ; Top motifs de rejet révèle les causes récurrentes ; la correction IA propose des corrections, et vous re-soumettez en un clic. Les cas bloquants sont escaladés.

un rejet « NIF client invalide » revient souvent : vous corrigez la source, et le taux de rejet chute le mois suivant.

TVA collectée agrège la TVA des factures certifiées, TVA avoirs la réduit des avoirs, et le Pré-remplissage e-TVA prépare la déclaration à partir de ces données — avec Suivi des déclarations.

la TVA collectée du mois sort directement des certifications, avoirs déduits — l'e-TVA est pré-remplie, prête à contrôler.

Rapprochement FNE ↔ compta confronte les documents certifiés aux écritures comptables et signale les écarts (certifié non comptabilisé, ou l'inverse). Les Écritures comptables et le Crédit de TVA complètent la vue.

le rapprochement signale 3 factures certifiées sans écriture : vous régularisez avant la clôture.

Conformité CGI et Validation des mentions contrôlent les mentions obligatoires ; la signature NF525 garantit l'inaltérabilité ; la Génération PDF et le ticket RNE produisent le document final avec QR de vérification.

une facture sans mention obligatoire est bloquée au contrôle avant envoi, et non découverte lors d'un contrôle fiscal.

La Validation IA détecte en amont les anomalies (données incohérentes, TVA douteuse, doublons), la cross-validation TVA recoupe les montants, et la correction automatique propose des corrections — réduisant les rejets DGI. La performance des modèles est suivie.

l'IA repère un taux de TVA incohérent avant l'envoi : la facture est corrigée et certifiée du premier coup.

La Piste d'audit journalise chaque action (soumission, rejet, forçage, rotation de clé), le Registre d'archivage conserve les certifications, et des rapports dédiés (intégrité, NF525, signature, RGPD) démontrent la conformité.

lors d'un contrôle, l'auditeur exporte le rapport d'intégrité et la piste d'audit : chaque facture certifiée est traçable de bout en bout.

Le Dashboard réunit les KPI : taux de succès, taux de rejet, délais de workflow, prévision de stickers, tendances de volumes. Des SLO (latence, débit, disponibilité) et un dashboard SLO prouvent la qualité de service, y compris en multi-entités.

la direction suit un taux de succès de 99,2 % et une prévision de stickers à 3 semaines, en un écran.

Oui : le Portail de vérification permet de contrôler qu'une facture est bien certifiée (via son QR/identifiant), et une PWA mobile rend le suivi accessible sur téléphone.

un client scanne le QR de sa facture et confirme sur le portail qu'elle est authentique et certifiée par la DGI.

FNE ▸ Rôles utilisateurs affecte et révoque les accès (configuration, soumission, conformité, pilotage), avec export. Associé à la piste d'audit, cela encadre qui peut forcer, re-soumettre ou faire tourner une clé.

l'opérateur certifie et traite les rejets, mais seul l'administrateur gère les clés API et le passage en production.