Facture normalisée électronique (Côte d'Ivoire)

Facture normalisée électronique (Côte d'Ivoire)

Présentation

Ce module certifie vos factures Dolibarr auprès de la plateforme FNE (Facture Normalisée Électronique) de la Direction Générale des Impôts de Côte d'Ivoire, conformément à la réforme de la facturation électronique ivoirienne.

Concrètement, un onglet FNE apparaît sur vos factures clients. Il montre la requête exacte qui partirait vers la DGI, puis, sur confirmation explicite, l'envoie et enregistre la réponse. Un registre local conserve la trace de chaque envoi, avec son journal, pour qu'une même facture ne parte jamais deux fois.

Le module ne certifie rien tout seul. Aucun envoi n'est déclenché par la validation d'une facture, par une tâche planifiée ou par un automatisme quelconque : c'est toujours un opérateur qui décide, pièce par pièce. Cette retenue est volontaire, et la page FAQ explique pourquoi.

Ce que le module sait faire

  • Certifier une facture de vente auprès de la plateforme FNE, depuis l'onglet FNE de la facture client
  • Émettre un avoir certifié à partir d'un avoir Dolibarr, dans la limite des quantités réellement certifiées
  • Certifier un bordereau d'achat de produits agricoles, sur affirmation explicite de l'exploitant, depuis l'onglet Bordereau FNE d'une facture fournisseur
  • Tenir un registre local de chaque certification : état, référence FNE, identifiant DGI, empreinte du corps envoyé, réponse brute conservée
  • Tenir un journal en ajout seul : chaque requête partie, chaque réponse avec son code HTTP, chaque décision d'opérateur, avec son auteur et son motif
  • Simuler avant d'envoyer : l'adresse, les en-têtes et le corps JSON exacts sont affichés, clé d'API masquée, avant que quoi que ce soit ne parte
  • Traduire vos taux de TVA et vos prélèvements vers la nomenclature FNE, et bloquer la pièce plutôt que de deviner quand la règle manque
  • Afficher la référence FNE à côté de la référence Dolibarr, sur la fiche facture et dans la liste des factures
  • Produire un document de certification portant la référence FNE et le QR code de vérification renvoyés par la plateforme
  • Remonter le stock de stickers et les avertissements renvoyés par la plateforme à chaque certification

Ce que le module ne fait pas

Ces limites viennent de l'API publiée par la DGI, pas d'un choix de conception.

  • Aucune annulation. Une facture certifiée ne s'annule pas. Elle se corrige par un avoir, et l'avoir de la plateforme est un simple retour de marchandise.
  • Aucune lecture. L'API ne propose aucun point d'entrée de consultation : impossible de demander à la DGI si une facture existe déjà. Le registre local est la seule mémoire disponible.
  • Aucune date choisie. Le corps de la requête ne porte aucune date : la plateforme date la facture à l'instant de l'appel. Une certification a posteriori correctement datée est impossible.
  • Ni acomptes, ni factures de situation, ni proforma, ni factures de remplacement. L'API ne les couvre pas ; le module les refuse explicitement.
  • Aucune facture fournisseur ordinaire. Côté acheteur, il n'y a rien à certifier : c'est le fournisseur qui certifie sa vente.

Avant toute chose

L'installation du module n'est pas la première étape. Votre entreprise doit d'abord être inscrite auprès de la DGI, avoir fait valider ses factures spécimens, et avoir reçu son adresse de production et sa clé d'API. Tout cela est décrit dans Inscription auprès de la DGI, à lire en premier.

Prérequis

Prérequis Valeur
Dolibarr 18.0 ou supérieur
PHP 7.4 ou supérieur
Modules Dolibarr activés Tiers, Factures
Extension PHP GD nécessaire seulement pour afficher l'image du QR code à l'écran
Dossier FNE inscription validée par la DGI, spécimens acceptés, clé d'API délivrée

Pages de cette documentation

Support

Éditeur : CAP-REL. Le module intègre une page À propos, accessible depuis sa configuration, qui rassemble les liens de support.

Inscription auprès de la DGI