Inscription auprès de la DGI

Le module ne vous inscrit pas auprès de l'administration fiscale et ne peut pas le faire. Tant que votre dossier n'est pas ouvert et validé, aucune facture ne peut être certifiée, quel que soit votre paramétrage. Cette page décrit ce que vous devez obtenir de la DGI, et dans quel ordre.

Prévoyez du temps : la validation de conformité est une étape administrative, pas un formulaire en ligne.

Étape 1 - Inscrire votre entreprise sur la plateforme FNE

Rendez-vous sur le portail de la facture normalisée électronique de la DGI, fne.dgi.gouv.ci, et créez le dossier de votre entreprise. La procédure d'interfaçage par API que le module applique est publiée au même endroit : FNE-procedureapi.pdf.

Votre dossier désigne un gestionnaire principal. C'est la seule personne qui verra la clé d'API, plus tard, dans l'onglet Paramétrage de votre espace FNE. Choisissez-la en conséquence : c'est elle qui devra la transmettre à la personne qui paramètre Dolibarr.

Ce que vous devez repartir avec, ou demander explicitement :

• votre NCC (numéro de compte contribuable) d'entreprise, tel qu'il figure sur votre espace FNE ;
• les valeurs de point de vente (pointOfSale) et d'établissement (establishment) de votre dossier.

[!IMPORTANT] Le point de vente et l'établissement sont validés par la DGI, aucune liste de valeurs valides n'est publiée, et l'API ne permet pas de les découvrir. Ils identifient votre dossier auprès de l'administration et ne viennent pas de votre logiciel de facturation. Tant que vous n'avez pas les vraies valeurs, n'inventez rien : une valeur approchante fait refuser toutes vos factures.

Étape 2 - Travailler d'abord sur l'environnement de test

La DGI publie une plateforme d'essai à l'adresse http://54.247.95.108/ws. C'est la seule adresse d'essai que le module accepte, et c'est aussi l'environnement sélectionné par défaut après l'installation.

Vous y obtenez une clé d'API d'essai. Deux précautions valent d'être dites avant de la saisir :

[!WARNING] L'adresse d'essai est en HTTP clair, sur une adresse IP nue. Votre clé d'API d'essai circule donc en clair sur le réseau, lisible par n'importe quel intermédiaire. Tenez-la pour compromise dès le premier envoi. Ne réutilisez jamais une clé d'essai en production, et demandez son remplacement à la DGI si elle a servi à autre chose qu'à des essais.

Sur l'environnement de test, les factures ne sont pas certifiées fiscalement. En revanche, la plateforme d'essai se comporte comme la vraie, y compris dans ses défauts : elle a déjà été observée en train de certifier des factures tout en répondant une erreur serveur. Ce n'est donc pas un bac à sable sans conséquence, c'est un miroir des pièges de la production. Profitez-en pour apprendre à lire le registre du module et à traiter une issue inconnue.

Étape 3 - Faire valider vos factures spécimens

La DGI valide la conformité de fond et de forme de vos documents avant d'ouvrir votre accès de production. Vous devez lui adresser des factures spécimens, produites par votre chaîne réelle, à l'adresse support.fne@dgi.gouv.ci.

Profitez de cet échange pour obtenir par écrit ce que la procédure publiée ne contient pas. Ces points ne sont pas des détails : sans les deux premiers, aucune facture normalisée conforme n'est produisible.

1. Le visuel FNE, la maquette de la facture normalisée et la liste des mentions obligatoires, ainsi que le format imposé de la numérotation.
2. Les valeurs de point de vente et d'établissement valides pour votre dossier.
3. Le comportement réel de la plateforme sur une erreur serveur : la facture est-elle enregistrée, et sous quel délai le portail la publie-t-il ?
4. L'existence éventuelle d'un moyen de vérifier qu'une facture existe avant de la renvoyer.
5. L'adresse de production, et si elle est bien en HTTPS.
6. La durée de vie de la clé d'API, sa procédure de rotation et la conduite à tenir en cas de compromission.
7. Le mode de consultation et de rechargement du stock de stickers.
8. Le catalogue des messages d'erreur renvoyés par la plateforme, pour savoir lesquels valent la peine d'être réessayés.

Étape 4 - Récupérer l'adresse de production et la clé d'API

Une fois vos spécimens validés, la DGI vous transmet l'adresse de production. La clé d'API de production est visible dans l'onglet Paramétrage de votre espace FNE, par le seul gestionnaire principal du dossier.

Ces deux éléments sont les derniers à saisir dans le module, et c'est délibérément la dernière chose que vous ferez : tant qu'ils ne sont pas renseignés et que l'environnement n'est pas basculé, aucun envoi ne peut atteindre la vraie plateforme.

[!CAUTION] Le module exige HTTPS en production, sans dérogation. Si l'adresse qui vous est transmise commence par http://, ne cherchez pas à contourner ce refus : revenez vers la DGI. La clé d'API est un jeton porteur, et une adresse en clair la donne à quiconque écoute.

Le stock de stickers

Le modèle est prépayé : chaque certification consomme un sticker. La plateforme renvoie le solde restant dans la réponse de chaque certification, et c'est le seul moyen de le connaître. Aucune interface de programmation ne permet de le consulter à la demande, ni de le recharger.

Le module affiche ce solde sur sa page d'accueil et sur chaque certification, et vous alerte sous un seuil que vous choisissez. Anticipez vos commandes de stickers auprès de la DGI : une rupture se découvre au beau milieu d'un flux de facturation.

Et ensuite

Vous pouvez passer à l'installation, puis à la configuration du module.