Automatiser la certification¶

Certifier un document, c'est le faire entrer dans le module, puis le transmettre à la FNE. À la main, une personne remplit un classeur Excel, le charge et clique sur Transmettre. Automatisée, la même chaîne part de votre système de gestion et y revient sans que personne n'ouvre le module : vos factures et vos avoirs sont collectés, transmis à la FNE, et leur résultat vous est rendu.

Cette page présente le principe des méthodes que le module propose pour y parvenir.

Vue d'ensemble¶

Le module propose trois méthodes. Les deux premières reposent sur le même socle, la collecte du modèle : un dépôt SFTP, déclaré sur un modèle, où les documents arrivent sous forme de fichiers et d'où les résultats repartent. Avec la troisième, l'API, votre système s'adresse directement au module, sans dépôt de fichiers.

flowchart LR
    SI["Votre système<br/>de gestion"]
    PROG["Votre programme<br/>d'export"]
    AGENT["Agent résident"]
    SFTP[("Dépôt SFTP<br/>de la collecte")]
    MOD["Module<br/>Facturation fiscale"]
    FNE["FNE (DGI)"]
    SI --> PROG
    SI --> AGENT
    PROG <-- "documents et résultats" --> SFTP
    AGENT <-- "documents et résultats" --> SFTP
    SFTP <-- "collecte et retour" --> MOD
    MOD <-- "certification" --> FNE
    SI <-- "API" --> MOD

Votre propre collecte : votre système exporte lui-même ses documents vers le dépôt et y récupère les résultats.
L'agent résident : un programme fourni par Minlessika, installé chez vous, lit vos documents dans votre base de données et fait ce travail à votre place.
L'API : votre système envoie chaque document directement au module, qui le prévient du résultat ou le lui donne à la demande.

Les principes communs¶

Quelle que soit la méthode, la chaîne obéit aux mêmes règles :

La transmission est automatique. Un document reçu est importé puis transmis à la FNE sans intervention.
Le résultat revient à sa source. Une fois le verdict de la FNE connu, le module rend la réponse — référence FNE et PDF certifié, ou motif du rejet — par la voie d'où le document était arrivé.
Tout reste visible. Les documents reçus apparaissent dans Imports et dans l'Historique des transmissions, comme ceux que vous chargez à la main, et un document qui échoue se rejoue depuis Factures et avoirs en échec.
La facture d'abord, l'avoir ensuite. Un avoir cite la facture qu'il corrige : la FNE ne le certifie qu'une fois cette facture certifiée.

Les deux méthodes par fichiers partagent en outre les règles de la collecte du modèle :

Un fichier, un document. Chaque facture et chaque avoir voyage dans son propre fichier, que le module reconnaît à la marque de modèle qu'il contient.
Le module vient chercher. Il consulte le dépôt à intervalle régulier ; rien n'est à pousser vers lui.

Méthode 1 — Votre propre collecte¶

Votre système de gestion, ou un programme que vous écrivez à côté de lui, produit un fichier par document et le dépose sur le dépôt. Il y récupère ensuite ce que la FNE a répondu. Le module fournit le fichier vide à remplir ; le reste de l'échange est un contrat de fichiers, que vous implémentez à votre rythme et avec vos outils.

sequenceDiagram
    autonumber
    participant P as Votre programme
    participant S as Dépôt SFTP
    participant M as Facturation fiscale
    participant F as FNE
    P->>S: dépose un fichier par document
    M->>S: collecte les fichiers
    M->>F: transmet chaque document
    F-->>M: référence FNE ou rejet
    M->>S: dépose le verdict et le PDF certifié
    P->>S: récupère les résultats

Cette méthode convient à un système qui sait exporter des fichiers et parler SFTP. Le contrat est détaillé dans Intégrer votre propre collecte de factures.

Méthode 2 — L'agent résident¶

L'agent résident est un programme fourni par Minlessika, installé sur une machine de votre réseau. Il lit lui-même les factures et les avoirs dans votre base de données, les dépose sur le dépôt de la collecte, puis rapporte les résultats dans votre base. Vous n'écrivez aucun programme : vous exposez vos documents dans des vues, et la correspondance entre ces vues et le modèle se règle depuis le module.

sequenceDiagram
    autonumber
    participant B as Votre base de données
    participant A as Agent résident
    participant S as Dépôt SFTP
    participant M as Facturation fiscale
    participant F as FNE
    M-->>A: configuration : vues à lire, correspondance des champs
    A->>B: lit les documents nouveaux ou modifiés
    A->>S: dépose un fichier par document
    M->>S: collecte les fichiers
    M->>F: transmet chaque document
    F-->>M: référence FNE ou rejet
    M->>S: dépose le verdict et le PDF certifié
    A->>S: récupère les résultats
    A->>B: écrit les résultats dans une table de retour

Trois principes gouvernent l'agent :

Il se pilote depuis le module. L'agent s'enrôle une fois, dans Paramètres › Agents résidents, puis vient chercher sa configuration de lui-même. Changer une correspondance de champs ne demande aucune intervention sur sa machine.
Il ne lit que ce qui a bougé. À chaque passage, il ne reprend que les documents créés ou modifiés depuis le précédent.
Vos données d'accès restent chez vous. Les accès à votre base ne quittent pas la machine de l'agent, qui lit vos vues en lecture seule et n'ouvre que des connexions sortantes.

Cette méthode convient à qui ne souhaite rien développer.

Obtenir l'agent

L'agent lit aujourd'hui les bases Oracle. Demandez-le à votre interlocuteur Minlessika : son manuel d'installation l'accompagne.

Méthode 3 — L'API¶

Votre système de gestion s'adresse directement au module, par des appels web sécurisés : il lui envoie chaque facture et chaque avoir. Aucun dépôt de fichiers n'est à tenir, aucun programme n'est à installer chez vous.

La certification n'est pas instantanée : le module accuse réception du document, puis le transmet à la FNE. Le résultat vous parvient ensuite de l'une de ces deux manières :

Par webhook. Vous déclarez une adresse de votre système, et le module l'appelle dès que le verdict de la FNE est connu. Votre système n'a rien à demander : il est prévenu.
Par vérification du statut. Votre système interroge le module, au rythme qui lui convient, sur le statut d'une facture ou d'un avoir. Cette voie sert les systèmes qui n'exposent aucune adresse joignable depuis Internet : tous les appels partent de chez vous.

sequenceDiagram
    autonumber
    participant P as Votre système
    participant M as Facturation fiscale
    participant F as FNE
    P->>M: envoie un document
    M-->>P: accuse réception
    M->>F: transmet le document
    F-->>M: référence FNE ou rejet
    alt Par webhook
        M->>P: appelle votre adresse avec le verdict
    else Par vérification du statut
        P->>M: demande le statut du document
        M-->>P: rend le verdict
    end

Cette méthode convient à un système capable d'appeler un service web, et à qui veut le résultat au plus près de l'émission du document.

Choisir sa méthode¶

Trois questions suffisent à s'orienter :

flowchart TD
    Q1{"Pouvez-vous faire évoluer<br/>votre système de gestion ?"}
    Q2{"Sait-il appeler<br/>un service web ?"}
    Q3{"Vos documents sont-ils<br/>dans une base Oracle ?"}
    API["Méthode 3<br/>L'API"]
    COL["Méthode 1<br/>Votre propre collecte"]
    AGT["Méthode 2<br/>L'agent résident"]
    XLS["Import Excel"]
    Q1 -- "Oui" --> Q2
    Q1 -- "Non" --> Q3
    Q2 -- "Oui" --> API
    Q2 -- "Non, mais il exporte des fichiers" --> COL
    Q3 -- "Oui" --> AGT
    Q3 -- "Non" --> XLS

Le tableau suivant résume ce qui distingue les méthodes :

	Import Excel	Votre propre collecte	Agent résident	API
Qui apporte les documents	Une personne charge un classeur	Votre programme dépose des fichiers	L'agent lit votre base de données	Votre système appelle le module
Ce que vous développez	Rien	L'export des fichiers et la lecture des résultats	Rien : vous exposez des vues	Les appels à l'API
Transmission à la FNE	Un clic sur Transmettre	Automatique	Automatique	Automatique
Où revient le résultat	À l'écran	Sur le dépôt SFTP	Dans votre base de données	Par webhook, ou à la demande de votre système

L'import Excel n'est pas une automatisation : il figure ici comme point de comparaison, et reste utile pour de petits volumes ou un rattrapage ponctuel.

Et ensuite ?¶

Créer un modèle, préalable aux méthodes par fichiers
Intégrer votre propre collecte de factures
Rejouer une transmission en échec

Changelog¶

1.0 (1er octobre 2026) : création du document.