E-INVOICING

Gestion des factures électroniques. Permet de générer (automatiquement ou manuellement) des factures au format électronique et de les envoyer à un Point d'Accès agréé de facturation électronique.

01. PRÉSENTATION DU MODULE

01. PRÉSENTATION DU MODULE

Présentation du module


mp21833d20260730112805-image_cover_small.png

Le module EInvoicing met Dolibarr en conformité avec la réforme française de la facturation électronique. Il assure une communication sécurisée et bidirectionnelle entre votre Dolibarr et une Plateforme Agréée (PA, anciennement appelée PDP).

Les quatre fonctions du module

Fonction

Description

Émission

À la validation d'une facture client, le module génère un fichier de facture électronique conforme (XML CII ou PDF Factur-X), le contrôle, puis le transmet à la PA. Il suit ensuite le cycle de vie de la facture (déposée, reçue, approuvée, refusée, payée…) et déclare les encaissements.

Réception

Le module interroge la PA pour récupérer les factures que vos fournisseurs vous adressent, et crée automatiquement les factures fournisseurs correspondantes dans Dolibarr (brouillons), en rapprochant le tiers, les produits et les commandes. Vous pouvez ensuite approuver, refuser ou signaler le paiement de ces factures directement depuis Dolibarr.

Suivi

Une page d'accueil récapitule ce qui a été reçu, envoyé, ce qui est en anomalie et ce qui reste à surveiller. Des e-mails de notification et des rapports planifiés peuvent être envoyés à une liste de destinataires.

Sécurité

Une facture transmise à la PA devient immuable dans Dolibarr (plus de modification, suppression ni dévalidation). Toute correction passe par un avoir ou une facture rectificative.

Licence et coûts

Le module est gratuit (licence GPL v3). La PA que vous choisissez facture en revanche généralement un abonnement ou un coût par flux : le contrat est passé directement avec elle.

Plateformes prises en charge

SuperPDP (en direct ou via un partenaire), Esalink Hubtimize. D'autres plateformes peuvent être ajoutées par des modules tiers.

Périmètre

Seuls les tiers français (entreprises assujetties) sont concernés par l'e-invoicing. Les particuliers (B2C), les tiers étrangers et les ventes en caisse relèvent du e-reporting et ne donnent pas lieu à une facture électronique.

Version décrite

Élément

Valeur

Version du module

1.5.0.7 (base communautaire Dolibarr 1.5.0 + compléments InfraS)

Dolibarr

18.0 minimum (instances « Dolibarr LTS by InfraS » 2026.x = 22.0.x)

Date du document

novembre 2026

02. MOTS CLÉS

02. MOTS CLÉS

Vocabulaire et concepts clés

Plateforme Agréée (PA) / PDP

Opérateur immatriculé par l'administration qui reçoit vos factures, les contrôle, les achemine au destinataire et vous transmet celles de vos fournisseurs. Le module se connecte à la PA par une API sécurisée (OAuth).

Facture électronique

Un fichier structuré, lisible par une machine. Le module produit deux formats :

Le fichier est stocké dans les « Fichiers joints » de la facture.

Profil

Niveau de détail du XML : MINIMUM, BASIC WL, BASIC, EN 16931, 

EXTENDED : EXTENDED-CTC-FR. 

Le module choisit le profil adapté ; le profil EXTENDED-CTC-FR est nécessaire pour certaines informations Chorus Pro.

Adresse de facturation électronique (identifiant de routage, BT-34 / BT-49)

Adresse à laquelle une facture est acheminée dans l'annuaire national. En France : le SIREN, ou « SIREN_suffixe » (le suffixe pouvant être un SIRET, un code service, un texte libre). Chaque tiers a une adresse par défaut (déduite de son SIREN) et peut avoir des adresses spécifiques.

Annuaire

Répertoire national (norme AFNOR XP Z12-013) qui liste, pour chaque SIREN, les adresses de réception actives. Un destinataire absent de l'annuaire ou sans adresse active ne peut pas recevoir de facture électronique : l'envoi est rejeté avec une erreur de routage.

Flux

Chaque échange avec la PA (facture envoyée, facture reçue, statut de cycle de vie) est un flux identifié par un identifiant unique (flow_id). La page « Flux échangés » les liste.

Cycle de vie

Suite de statuts normalisés (codes 200 à 213) qui suivent une facture de son dépôt jusqu'à son paiement.

CDAR

Message normalisé par lequel le module envoie un statut de cycle de vie (par exemple « Approuvée », « Refusée », « Encaissée ») à la PA.

Mode réel / mode test

Le module fonctionne soit en bac à sable (identifiants de test, annuaire de test incomplet), soit en production (identifiants « réels »). Les identifiants sont stockés séparément pour les deux modes.

03. ACTIVER LA FACTURATION ÉLECTRONIQUE

03. ACTIVER LA FACTURATION ÉLECTRONIQUE

ACTIVATION ET PRÉREQUIS

Ce document vous explique comment activer la facturation électronique sur votre logiciel Dolibarr, vous guide dans le choix de votre Plateforme Agréée (PA) parmi les options possibles, puis vous accompagne dans la configuration et l’utilisation du module EInvoicing.

Prérequis : 

➔ Posséder un justificatif d’immatriculation d’entreprise : extrait KBis avec SIREN, RNE ou équivalent. 

➔ Une pièce d’identité du gérant de l’organisation, ou à défaut un justificatif « France Identité ». 

➔ Version Dolibarr ≥ 18 : Si vous avez installé le logiciel Dolibarr par vous-même, il vous revient de le mettre à jour vers la version 18 au minimum (v22 LTS recommandée).

➔ Avoir installé le module EInvoicing sur votre Dolibarr (si vous utilisez l’offre SaaS DolinfraS LTS, ceci aura été fait automatiquement mi-août 2026 et un e-mail vous en aura informé ; sinon, voir le chapitre précédent).

Choisir sa Plateforme Agréée (PA) :

À ce jour, il existe une centaine de Plateformes Agréées auxquelles les logiciels peuvent plus ou moins bien se connecter (Voir la liste du gouvernement ici).

L’erreur principale consiste à choisir sa plateforme sous la pression de sa banque ou de son comptable, ces derniers ayant souvent des intérêts liés à certaines plateformes (commissions, accès directs). 

Une plateforme choisie par votre banque ou votre comptable « fonctionnera », mais la gestion sera en grande partie manuelle : vous ne bénéficierez pas des automatismes promis par la facturation électronique, et la gestion de deux systèmes représentera une charge supplémentaire. Exemple : les PA les plus souvent proposées par les comptables récupèrent vos factures clients de Dolibarr pour les envoyer, mais ne poussent pas vos factures fournisseurs reçues dans Dolibarr : il faudra les ressaisir manuellement au lieu de les récupérer automatiquement.

Ne vous laissez pas influencer par les intérêts commerciaux de votre comptable : une plateforme agréée se choisit en fonction du logiciel de facturation que vous utilisez, et non en fonction des accords entre une PA et votre comptable. C’est à lui de s’adapter à votre choix. S’il privilégie ses intérêts aux vôtres, envisagez de changer de comptable.

Pour le logiciel Dolibarr, la plateforme agréée 100% compatible, sans intermédiaire, est SuperPDP.

La plateforme EsaLink est également supportée, mais requiert de passer par un intermédiaire (consultez dans ce cas le guide de l’association PDPLibre). D’autres plateformes seront ajoutées courant 2027, ce qui permettra d’offrir encore plus d’alternatives aux utilisateurs plutôt qu’une plateforme imposée. Les choix que nous recommandons :

La plateforme agréée SuperPDP est recommandée car vous pouvez gérer votre compte vous-même, sans intégrateur intermédiaire. SuperPDP prélève une commission (environ 1 centime par facture, soit quelques euros par an : c’est actuellement la moins chère du marché). La gestion reste toutefois en grande partie manuelle ; cette option convient si vous avez peu de factures à traiter par mois.

Une facture émise, une facture reçue ou un e-reporting : chaque document traité compte pour une unité, sans autres frais. 

Critères

Mode A — Hubtimize(Esalink) assisté via InfraS


Mode B — Inscription directe à SuperPDP

Complexité

Simple : tout est géré par InfraS

Moyenne : gestion autonome, nécessitant des connaissances techniques (clés d’API).

Tarif

0,121 € HT par document traité + 150 € HT de contribution unique (inscription, configuration et formation incluses)

Tarif API SuperPDP (facturé directement par SuperPDP)

Support de InfraS en cas de problème

Complet

Nécessite un ticket de support InfraS

Disponibilité

Inscription à partir du 16 août 2026 

Envoi/Réception facture à partir du 01/09/2026

Inscription à partir du 16 août 2026 

Envoi/Réception facture à partir du 01/09/2026

Recommandé :                                                                                                                                                                                 Choisissez le mode A si vous souhaitez une mise en place rapide, simplifiée et automatisée, ou si vous ne disposez pas de connaissances techniques (gestion de clés d’API).

Activation du module EInvoicing et connexion à la Plateforme Agréée :

Une fois le module EInvoicing installé sur votre Dolibarr (voir premier chapitre) et le choix du mode d’inscription à votre Plateforme Agréée effectué (voir chapitre précédent), vous pouvez passer à la création de votre compte et à votre déclaration nationale de facturation électronique.

Étape 1 — Activer le module EInvoicing :

  1. Rendez-vous sur la page Accueil → Configuration → Modules/Applications. 
  2. Recherchez le module EInvoicing et activez-le.

Étape 2 — Vérifier les informations de votre société

Dans la page de configuration du module EInvoicing, si des informations obligatoires sur votre société ne sont pas renseignées, vous trouverez un lien menant vers une page permettant de les corriger. 

Ce sont des informations de votre société ou de votre organisation requises pour générer des factures électroniques conformes (raison sociale, adresse, e-mail, numéro de TVA, SIREN, numéro RNA). Utilisez le lien pour les corriger en cas d’alerte, puis revenez sur cet écran. Passez à l’étape 3 dès qu’aucune alerte ne s'affiche.

Étape 3 — Finaliser la configuration 

Une fois les informations de votre société ou de votre organisation vérifiées, revenez à la page de configuration du module EInvoicing afin de finaliser la configuration selon votre choix du mode d’inscription.

03. ACTIVER LA FACTURATION ÉLECTRONIQUE

Mode A : Inscription à HUBTIMIZE assisté via INFRAS

Pourquoi opter pour la PA EsaLink (Hubtimize) ?

Depuis l'annonce de la réforme, plus de 150 Plateformes Agréées ont vu le jour — s'engager sans discernement n'était pas envisageable. Plutôt que de vous orienter vers le premier opérateur venu, InfraS a retenu trois critères rigoureux :

Il en résulte le choix de la PA Esalink (plateforme Hubtimize), retenue à l'issue de tests en conditions réelles et d'une négociation collective. Vous pouvez en bénéficier dès aujourd'hui : notre offre est détaillée ci-dessous.

Audit de votre installation Dolibarr

Nos experts :

  • Analysent votre configuration actuelle
  • Cartographient vos flux de facturation
  • Identifient précisément les écarts à combler pour répondre aux exigences de la réforme
Mise en conformité Factur-X
  • Paramétrage de Dolibarr pour émettre et recevoir des factures au format structuré (Factur-X, UBL, CII)
  • Accompagnement dans le choix de votre Plateforme Agréée et interfaçage technique complet
Formation et support continu
  • Sessions pratiques pour vos équipes comptabilité, ADV et achats
  • Hotline francophone dédiée
  • Documentation adaptée à vos processus internes

Un partenariat solide, conçu pour Dolibarr

Esalink (solution Hubtimize) figure parmi les toutes premières Plateformes Agréées définitivement immatriculées par la DGFiP (décembre 2025). Forte de plus de quinze années d'expertise en échanges de données informatisés (EDI), elle est également la première PA éprouvée en conditions réelles avec Dolibarr.

PDP Libre (association loi 1901) regroupe les volumes de l'ensemble de ses membres distributeurs : plus la communauté s'élargit, plus le tarif unitaire diminue — au bénéfice de tous. InfraS distribue cette solution sous le label « Compatible PDP Libre » et demeure votre interlocuteur unique.

Votre mise en service, en cinq étapes : 

1. Signature du contrat

Un contrat clair : tarification au document traité, conditions particulières et accord de traitement des données (RGPD) intégrés. La signature ne prend que quelques minutes.

2. Dossier d'identification (KYC)

Le dossier d'identification vous est transmis dès la signature du contrat. Vous le complétez à l'aide de quelques pièces (voir la liste ci-dessous) ; nous vous accompagnons à chaque étape, la vérification réglementaire étant assurée par Esalink.

3. Configuration du module Dolibarr

Nous installons et paramétrons le module sur votre instance, puis validons les flux (émission, réception, e-reporting) en environnement de préproduction.

4. Formation de vos équipes Une session d'environ trente minutes suffit : le module s'inscrit naturellement dans vos usages Dolibarr.

5. Mise en production Vos factures transitent désormais par la Plateforme Agréée : vous êtes en conformité avec la réforme, sans changer d'ERP.

Les pièces à réunir : 

Le dossier d'identification se constitue rapidement. Les éléments suivants vous seront demandés :



03. ACTIVER LA FACTURATION ÉLECTRONIQUE

Mode B : Inscription directe à SuperPDP

Si vous préférez gérer, indépendamment d’InfraS, votre souscription à SuperPDP (configuration du compte, paiements, etc.), suivez les étapes ci-dessous (ce mode requiert des connaissances techniques) :

1 - Choisissez l’inscription directe à SuperPDP depuis la page de configuration du module.

n1.png

2 - Suivez les opérations indiquées à l’écran :

C’est-à-dire : rendez-vous sur superpdp.tech pour créer un compte. Dans votre espace SuperPDP, ouvrez le menu « Applications » pour créer une clé d’API. Lors de la création de la clé, renseignez l’URL fournie sur l’écran de configuration du module.

n2.png

3 - Une fois ces instructions suivies, vous obtiendrez un Client ID et un Client Secret : 

n3.png

4 - Renseignez ces informations dans les champs correspondants, puis cliquez sur Enregistrer : 

n4.png

5 - Cliquez ensuite sur le lien Se connecter (Générer le jeton d’accès).

n5.png

n5.png

✅ Votre compte SuperPDP est créé et votre Dolibarr est connecté à la facturation électronique (voir chapitre suivant UTILISATION DE LA FACTURATION ÉLECTRONIQUE).

04. LA FACTURATION ÉLECTRONIQUE

04. LA FACTURATION ÉLECTRONIQUE

À PROPOS

Qu’est-ce que la facturation électronique, pourquoi ?

La facturation électronique est un nouveau moyen d’échanger les factures entre clients et fournisseurs. À partir d’une certaine date (variable selon les profils, voir chapitre suivant), l’administration française vous oblige à envoyer à vos clients, et à recevoir de vos fournisseurs, vos factures via une Plateforme Agréée ou PA, en remplacement de l’envoi par e-mail. 

En France, c’est en général le SIREN qui servira d’adresse électronique pour identifier les émetteurs et les destinataires (en remplacement de l’adresse e-mail). Les factures échangées avec des pays hors de France continueront d’être envoyées par le moyen de votre choix (e-mail, courrier, etc.). Leurs données devront toutefois être déclarées à l’administration via votre Plateforme Agréée, tout comme celles des ventes aux particuliers : c’est l’« e-reporting », également pris en charge par le module. 

Ce changement majeur, qui impacte les processus et les logiciels de toutes les entreprises françaises, permet à l’administration un meilleur contrôle des flux et des déclarations et, aux entreprises, d’automatiser leurs échanges de factures. 

Qui est concerné, et à quelle échéance ? 

Toutes les entreprises établies en France et assujetties à la TVA (disposant d’un SIREN) sont concernées par la facturation électronique, quelle que soit leur taille. Seul le calendrier de mise en conformité diffère selon la taille de l’entreprise, comme le montre le tableau ci-dessous.

Type d’entreprise

Critères

Réception

Émission

Grandes entreprises

Effectif ≥ 5 000 salariés, ou CA > 1,5 Md€ et bilan > 2 Md€

Sept. 2026

Sept. 2026

ETI

Moins de 5 000 salariés, et CA ≤ 1,5 Md€ ou bilan ≤ 2 Md€

Sept. 2026

Sept. 2026

PME

Moins de 250 salariés, et chiffre d’affaires ≤ 50 M€ ou bilan ≤ 43 M€

Sept. 2026

Sept. 2027

TPE / Micro-entreprises

Moins de 10 salariés, et CA ≤ 2 M€ ou bilan ≤ 2 M€

Sept. 2026

Sept. 2027

À noter :                                                                                                                                                                                      Même si votre entreprise n'émet qu'en septembre 2027, elle doit pouvoir recevoir une facture électronique dès septembre 2026. C'est le scénario de la grande majorité des TPE et PME : un pied dans le dispositif sans obligation d'émission immédiate.

À quoi sert ce module ?

La réforme française de la facturation électronique impose que les logiciels de gestion échangent leurs factures via un « Point d'accès » (PA), aussi appelé Plateforme de Dématérialisation Partenaire (PDP), plateforme agréée par l'État. Le module EInvoicing relie Dolibarr à ce point d'accès :

Le module lui-même est gratuit ; le point d'accès (l'abonnement chez le partenaire agréé) est en revanche généralement facturé séparément par ce partenaire.


05. UTILISATION DE LA FACTURATION ÉLECTRONIQUE

05. UTILISATION DE LA FACTURATION ÉLECTRONIQUE

UTILISATION AU QUOTIDIEN

Le module de facturation électronique (module EInvoicing) doit avoir été installé et configuré (voir chapitre précédent) pour permettre la réception (et éventuellement l'envoi) de factures électroniques via votre application Dolibarr. Une fois le module configuré, le cycle de vie d'une facture client se déroule ainsi :

  1. À la création de la facture : le module détermine si elle doit ou non donner lieu à une facture électronique (une facture à un particulier, par exemple, ne le nécessite pas).
  2. À la validation de la facture : selon vos réglages, la facture électronique est générée automatiquement, ou bien vous devez cliquer sur le bouton « Générer la facture électronique » présent sur la fiche de la facture.
  3. Vous pouvez à tout moment cliquer sur « Vérifier l'annuaire » pour confirmer que le destinataire est bien joignable électroniquement.
  4. Le bouton « Transmettre » envoie la facture générée au point d'accès (inutile si l'envoi automatique est activé). « Retransmettre » permet un nouvel envoi si nécessaire.
  5. Une fois transmise, la facture est verrouillée : référence, dates, montants, tiers et modalités de paiement ne peuvent plus être modifiés. Pour corriger une facture déjà transmise, il faut émettre un avoir, puis créer une nouvelle facture (ou dupliquer la facture existante).
  6. Lors de l'encaissement (même partiel) d'une facture dont la TVA est due sur les encaissements, le module signale automatiquement ce paiement au point d'accès (statut « Payé »).

Nettoyage et pré-vérifications recommandés : 

Afin d'éviter toute erreur d'envoi, tout rejet de facture par votre client ou tout défaut de réception des factures fournisseurs, assurez-vous que les informations des tiers existants (clients et fournisseurs) sont complètes, correctes et à jour, notamment : 

Comment envoyer une facture client : 

Un bloc « Facturation électronique » apparaît sur la fiche de la facture client. Il vous permet de consulter l'état de la facture électronique, l'accessibilité du client, ainsi que l'adresse de facturation électronique à laquelle la facture sera envoyée.

j1.png

Une fois la facture validée, un bouton « Facturation électronique » apparaît. Il permet de régénérer la facture électronique, de vérifier sa conformité et, surtout, de la transmettre à la plateforme agréée pour envoi au client.

Si vous avez activé l'option « Génération automatique de la facture électronique lors de la validation de la facture » (activée par défaut), la facture électronique a déjà été générée : il vous suffit de la « Transmettre ». Dans le cas contraire, vous devez d'abord cliquer sur « Régénérer la facture électronique » avant de pouvoir la transmettre.

j2.png

Une fois la facture transmise, vous pouvez suivre son statut dans le bloc Facturation électronique de la fiche de la facture client…

j3.png

… ou via la colonne « État de la facture électronique » de la liste des factures clients.j4.png 

Attention : une fois la facture « transmise », seules quelques informations secondaires pourront encore être modifiées. En cas d'erreur (ou de rejet par le client), il faudra émettre un avoir, le transmettre, puis créer une nouvelle facture corrigée. 

Note : pour que le statut soit mis à jour, il est nécessaire de lancer régulièrement la synchronisation (voir chapitre suivant).

Comment lancer une synchronisation et récupérer mes factures fournisseurs :

La synchronisation de votre Dolibarr avec la plateforme agréée a pour objectif de récupérer les factures fournisseurs et, si vous avez transmis des factures clients, de mettre à jour leur statut.

Pour récupérer vos factures fournisseurs et/ou mettre à jour le statut de vos factures clients, il est nécessaire de lancer la synchronisation (manuelle ou programmée). Pour cela, rendez-vous dans Accueil → Facturation → Gestion des factures électroniques → Synchronisation des factures électroniques, puis lancez une synchronisation.

j5.png

Le déroulement de la synchronisation dépend de la configuration du module EInvoicing (onglet Options de réception). Si vous avez activé la création automatique des tiers et des produits manquants (non recommandé), la synchronisation s'effectue sans interruption, dans la limite définie. 

Dans le cas contraire, la synchronisation s'interrompt chaque fois qu'un tiers (client ou fournisseur) ou un produit est manquant dans votre Dolibarr. Vous êtes alors invité à le créer manuellement à l'aide d'un formulaire de création prérempli avec les informations issues de la facture électronique. Pour éviter ces arrêts, vous pouvez définir un produit ou un service par défaut sur la fiche du fournisseur, choisir un produit générique pour toutes les lignes non reconnues, ou activer le pré-import : une synchronisation lancée à la main vous présente alors d'abord les lignes sans produit, pour que vous les associiez avant l'import (voir chapitre 11).

En cas d'erreur lors de la synchronisation, un message s'affiche avec les instructions nécessaires pour la résoudre. Une fois la synchronisation terminée, le statut de vos factures clients est mis à jour et les factures fournisseurs reçues sont créées dans votre Dolibarr. 

Exemple : vue du statut de la facture client

j6.png

Exemple : vue de la liste des factures clients 

j7.png

Exemple : vue de la liste des factures fournisseurs

j8.png


Exemple : vue d'une facture fournisseur (le champ « Source » indique la plateforme dont est issue la facture)


Approuver ou refuser les factures fournisseurs reçues :

Vous pouvez approuver ou refuser les factures fournisseurs reçues depuis le bouton « Facture électronique » de la fiche de la facture fournisseur.

j9.png

Une fois la facture approuvée ou refusée, le cycle de vie électronique de la facture fournisseur est terminé. 

Notez que cette étape d'approbation ou de refus n'est pas obligatoire : votre obligation se limite à la réception des factures. Vous pouvez continuer à informer votre fournisseur de l'approbation ou du refus d'une facture par le circuit traditionnel (téléphone, e-mail, courrier…). De même, la gestion des litiges de paiement se fait comme auparavant, en dehors du système de facturation électronique.

Cas des factures hors périmètre : 

Les factures saisies par le point de vente, les factures émises à des particuliers (qui ne disposent pas de numéro SIREN et ne peuvent donc pas recevoir de facture électronique), ainsi que les factures destinées à des entreprises étrangères, ne sont pas dans le périmètre de la facturation électronique. Vous les saisissez comme auparavant, en vous assurant que le statut de facturation électronique est bien « Ne pas gérer la facturation électronique ». 

Toutes ces factures hors périmètre seront déclarées sous forme de « résumé » via la fonction « E-reporting », que le module prend également en charge.

06. CONFIGURATION DU MODULE

06. CONFIGURATION DU MODULE

Constantes cachées

Constante

Rôle

EINVOICING_ALLOW_DEVTOOLS

Active l'onglet Outils de développement et la plateforme TESTPDP.

EINVOICING_ONLY_GENERATE

Génère les fichiers de facture électronique sans jamais rien envoyer ni recevoir (les options d'envoi, de joignabilité et de réception disparaissent).

EINVOICING_DISABLE_READABLE_PDF

Ne récupère pas le PDF lisible des factures reçues (gain de temps).

EINVOICING_ALLOW_MULTICOMPANY_INVOICE_MOVE

Liste des identifiants d'entités : ajoute un bouton « Changer d'entité » sur les factures fournisseurs reçues

EINVOICING_MULTICOMPANY_USE_MASTER_SETUP

Identifiant de l'entité principale dont la configuration et la réception sont partagées.

EINVOICING_TOLERANT_SUPPLIER_REF_MATCH

 (+ _MIN_LENGTH, défaut 8)

Rapprochement tolérant de la référence fournisseur à l'import : la référence du XML est recherchée comme mot entier dans ref_supplier

 (ex. « FA202610 » retrouve « PAY123 - FA202610 - dinner »). Plusieurs candidats = ambiguïté, pas d'import.

EINVOICING_PREFER_ORIGINAL

Préfère le document original au document converti à l'import.

EINVOICING_SUPPORT_EXPORT_MAX

Nombre maximal d'enregistrements par export de support (archive ZIP).

EINVOICING_XML_PROFILE

Force le profil : MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, EXTENDEDFR.

EINVOICING_ENABLE_MANUAL_ACTION_QUEUE

 / 

EINVOICING_ENABLE_POSTPONE_FLOWS

Options expérimentales. La première met en file d'attente les flux qui demandent une action manuelle, au lieu d'arrêter la synchronisation, et affiche le menu « File d'attente de synchronisation » (voir chapitre 11). La seconde reporte ces flux à la synchronisation suivante ; elle est signalée dangereuse par les auteurs.

EINVOICING_SUPERPDPVIAPARTNER_ONLY_DOMAIN

Pour un serveur faisant office de proxy OAuth : liste des domaines autorisés à recevoir les jetons. Un avertissement de sécurité s'affiche tant qu'elle est vide.

EINVOICING_BLOCK_INVOICE_NO_ROUTING_ID

Bloque la génération et l'envoi vers un tiers sans adresse de facturation électronique saisie sur sa fiche (sinon l'adresse est déduite du SIREN). Était une option de l'ancien onglet « Options ».

EINVOICING_ENABLE_DEPRECATED_OPTION_IMPORT_AS_FREE_LINES

Réaffiche dans l'onglet « Options de réception » l'option dépréciée « Importer les lignes sans produit / service comme des lignes libres » (fortement déconseillée). Une instance qui l'avait activée continue de l'appliquer.

EINVOICING_ADD_A_DEDICATED_AGENDA_VIEW

Ajoute l'onglet « Événements liés à la facturation électronique » sur la fiche des factures clients (voir chapitre 10).

EINVOICING_FLOWS_SYNC_CRON_SIZE

Nombre de flux traités par appel lors de la synchronisation planifiée ; à défaut, « Nombre de flux traités par défaut par appel » de l'onglet « Options avancées ».

MAIN_VAT_EXEMPTION_CODE_FOR_<taux>[_<code TVA>]

Dolibarr 18 à 23 : code VATEX pour un taux à 0 % (voir chapitre 07).


06. CONFIGURATION DU MODULE

Onglet « Débogage »

r6.png

Mode débogage : Même interrupteur que l'option « Conserver le détail complet des appels API » de l'onglet « Options avancées ».

Journal du module (diagnostic) : Affiche le fichier journal Dolibarr (module Logs/Syslog, sortie « Fichier »), sa taille et sa date ; boutons « Télécharger le journal » et « Actualiser ». Si le journal est vide, activer la sortie fichier du module Syslog, reproduire l'opération, puis revenir.

Vérifier un XML de facture électronique (facture client) :  Charger le fichier <ref>_cii.xml joint à une facture ; le module l'affiche et recherche les éléments vides (cause de rejet PEPPOL-EN16931-R008). Rien n'est écrit ni envoyé.

Simuler un import XML (aperçu) : Charger un XML CII reçu ; le module montre ce que l'import créerait : tiers (existant ou à créer), lignes avec produit trouvé / produit par défaut / nouveau / ligne libre / à associer manuellement, remises, TVA, totaux recalculés comparés aux totaux déclarés (écart en rouge), note publique. Simulation à blanc : rien n'est créé dans Dolibarr.

ℹ Ces trois outils ne sont actifs que si le mode débogage est activé.

06. CONFIGURATION DU MODULE

Onglet « Options avancées »

Réglages techniques communs à l'envoi et à la réception.

Section « Paramètres »

r4.png

Nombre de flux traités par défaut par appel : Défaut : 100.

Délai de recouvrement de synchronisation par défaut (heures) : Défaut : 12. Nombre d'heures de recul par rapport à la dernière synchronisation pour ne manquer aucun flux ; un flux déjà traité est simplement ignoré.

E-mails de notification (factures reçues et anomalies) : Adresses séparées par virgule ou point-virgule. Elles reçoivent : 

Activer la prise en charge de Chorus (fonctionnalité non finalisée) : Ajoute sur les factures et commandes des champs complémentaires : code de service, numéro de marché, numéro d'engagement, identifiant de transmission Chorus Pro. Le code de service est envoyé comme identifiant d'acheteur (BT-46, schéma 0224) si le profil est EXTENDED-CTC-FR.

Conserver le détail complet des appels API dans l'historique (mode débogage) : Enregistre requêtes et réponses complètes dans le journal des appels. Ralentit la synchronisation. Nécessaire pour un export de support utile. Même réglage que l'interrupteur « Mode débogage » de l'onglet « Débogage ».

06. CONFIGURATION DU MODULE

Onglet « Options d'envoi »

Options de l'émission des factures clients (Dolibarr → PA). Depuis la version 1.5.0 du module, l'ancien onglet « Options » est réparti entre les onglets « Options d'envoi », « Options de réception » et « Options avancées ».

En tête : l'interrupteur « Activer la génération et l'exportation des factures clients ». Le désactiver masque les options ci-dessous et toutes les fonctions d'émission (boutons, blocs des fiches, statuts sortants).

Section « Synchronisation des factures clients (Dolibarr → PA/PDP) »

r2.png

Protocole d'échange : CII (recommandé) ou FACTURX. Avec Factur-X, un avertissement rappelle que le PDF de Dolibarr doit être au format PDF/A-3b.

Génération automatique de la facture électronique une fois la facture validée : Oui (défaut) : le fichier est généré à la validation (et à chaque régénération du PDF). Non : génération uniquement par le bouton.

Activer la validation des données des tiers via les API gouvernementales : Vérifie en temps réel le SIREN/SIRET (registre data.gouv.fr) et le numéro de TVA (VIES) avant génération et envoi. Non bloquant si les services sont indisponibles. Signale : SIREN inconnu, entreprise fermée, nom / code postal / ville différents du registre.

Validation locale du fichier de facture électronique généré : Contrôle local d'un sous-ensemble des règles EN 16931 (totaux BR-CO-10 à 17, lignes, catégories et taux de TVA, format SIREN BR-FR-10 et 32) :

    • Pas de vérification.
    • Avertissement seulement (défaut).
    • Blocage (arrêt de la génération en cas de violation).

Filet de sécurité rapide ; la validation officielle reste celle de la PA.

Validation à distance par la plateforme agréée du fichier généré : Affiché si la PA propose un validateur

Le résultat est affiché dans le bloc de la fiche facture.

Annuler l'enregistrement de la facture si la génération automatique échoue : (affiché si génération automatique = Oui) Par défaut la facture est validée même si la facture électronique échoue ; on peut la régénérer ensuite.

Vérifier à distance et afficher la joignabilité du destinataire dans l'annuaire sur l'écran de facturation : Activé par défaut. Affiche sur la fiche facture le résultat de la recherche du destinataire dans l'annuaire (lecture seule, jamais bloquant). En mode test, l'annuaire est incomplet : indicatif seulement.

Exiger que le tiers destinataire soit joignable avant la transmission :

La facture électronique est toujours générée ; seule la transmission est bloquée. Jamais bloquant si l'annuaire est indisponible ou si le tiers n'a pas de SIREN. Attention à la troisième option sur une plateforme qui ne renvoie jamais l'état des lignes : tous les destinataires seraient bloqués.

Ne pas générer de factures électroniques pour les particuliers (B2C) : Les factures aux particuliers sont marquées « e-reporting ». Dolibarr détermine lui-même si un tiers est une entreprise ou un particulier.

Modules de point de vente à exclure : Liste (séparée par des virgules, défaut « takepos ») des modules dont les factures ne sont pas envoyées individuellement mais relèvent du e-reporting.

Schéma de l'identifiant du tiers (BT-29, BT-46) : Pour un vendeur français : 0225 (adresse annuaire, défaut), 0009 (SIRET) ou « Ne pas déclarer ». Hors France : code ICD ISO 6523 du registre national (0208 Belgique, 0211 Italie…), ou vide.

Transmission automatique à la Plateforme Agréée lors de la validation : Oui : la facture est transmise juste après sa génération à la validation, sans passer par le bouton « Transmettre ». Jamais de renvoi d'une facture déjà transmise. Nécessite la génération temps réel. Depuis la 1.1.0, seule la génération déclenchée par la validation transmet ; une simple régénération du PDF (paiement, bouton « Générer », action de masse) ne transmet plus.

Taille maximale du fichier de facture électronique (Mo) : Avertissement non bloquant si le fichier dépasse cette taille (ex. 10 Mo pour Chorus Pro). Vide ou 0 = pas de contrôle.

Mentions légales (obligatoires en France, règle BR-FR-05) :

Laissées vides, les textes par défaut affichés sont utilisés. Aucune des trois mentions ne peut nier les frais dus de plein droit.

Informer le client lorsqu'un paiement a été reçu Affiché « Obligatoire » : le statut 212 « Encaissée » est envoyé à chaque encaissement client, sans option de désactivation (voir chapitre 10, « Déclaration des encaissements » ; un encaissement dont l'envoi a échoué se déclare à la main par « Déclarer un paiement (212) »).

Notes complémentaires (codes UNTDID 4451)

Sous les options, le tableau « Notes complémentaires » ajoute des notes à toutes les factures électroniques générées. Choisir un « Code UNTDID » dans la liste (sa description s'affiche), saisir le « Texte de la note complémentaire », puis cliquer sur « Ajouter ». Chaque note est écrite dans le document avec son code de sujet, comme les trois mentions légales ci-dessus (codes PMT, PMD et AAB, qui ne figurent donc pas dans la liste). Les notes enregistrées sont listées en dessous, avec « Modifier » et la suppression.

Les codes proposés sont ceux du dictionnaire « Facturation électronique - Dictionnaire des codes UNTDID 4451 » (Accueil > Configuration > Dictionnaires), où un code peut être désactivé.

06. CONFIGURATION DU MODULE

Onglet « Options de réception »

Options de la réception des factures fournisseurs (Dolibarr ← PA).

En tête : l'interrupteur « Activer la réception des factures électroniques d'achat ». Le désactiver masque les options ci-dessous et toutes les fonctions de réception.

Section « Synchronisation des factures d'achat (Dolibarr ← PA/PDP) »

r3.png

Génération automatique des produits / services manquants : Oui : un produit introuvable est créé à l'import. Non (recommandé) : l'import de la facture s'arrête jusqu'à résolution manuelle, sauf si la ligne est résolue par le produit ou le service par défaut du fournisseur, le produit générique ou un choix fait dans la fenêtre de pré-import.

Attribuer un code-barres aux produits créés à l'import : (affiché si la création automatique est active et le module Codes-barres activé) Le produit créé reçoit comme code-barres le GTIN du fournisseur (BT-157), ou le prochain code de votre numérotation. Désactivé par défaut : les produits créés n'ont pas de code-barres, ce qui garde vos codes pour vos propres produits.

Utiliser un produit générique pour les lignes sans produit : (affiché si la création automatique est désactivée) Une ligne dont le produit est introuvable, chez un fournisseur sans produit ni service par défaut, est rattachée au « Produit générique » choisi juste en dessous, quel que soit le fournisseur (par exemple « Achats divers », avec son propre compte comptable d'achat). Le produit ou le service par défaut du fournisseur reste prioritaire. Ces lignes restent listées dans la page « Associer les produits d'une facture électronique » pour être revues.

Pré-import des lignes sans produit avant une synchronisation manuelle : Une synchronisation lancée depuis l'écran de synchronisation affiche d'abord les lignes dont le produit est introuvable, pour les lier à un produit existant, les laisser en ligne libre ou faire créer le produit (voir chapitre 11, « Pré-import des lignes sans produit »). La tâche planifiée n'est pas concernée. Désactivée par défaut ; activée d'office à la mise à jour sur une instance qui importait déjà les lignes sans produit en lignes libres.

Type de produit par défaut à utiliser à l'import lorsqu'il n'est pas fourni (factures mixtes) : « Produit par défaut », « Service par défaut » ou vide. Une facture reçue indique dans son cadre de facturation (BT-23) si elle facture des biens, des services ou les deux. Pour une facture mixte, ce réglage choisit lequel des défauts du fournisseur utiliser ; vide, l'import d'une facture mixte s'arrête lorsqu'une de ses lignes a besoin d'un défaut.

Faire correspondre les références produits des fournisseurs quelle que soit leur formulation : Comparaison tolérante (ignore séparateurs, casse, accents) si aucun prix fournisseur ne correspond exactement. Désactivé par défaut car approximatif. En cas d'ambiguïté, la ligne est laissée au mappage manuel.

Intégrer les frais d'une ligne dans sa propre description plutôt que sur une ligne distincte : Par défaut, les frais d'une ligne reçue (BG-28 : frais de traitement, surcharge carburant…) sont importés comme des lignes distinctes, et la ligne du produit reste nette de ces frais. Activée, l'option décrit les frais dans la ligne du produit, dont le total correspond alors au montant du document, frais inclus. Réglable aussi fournisseur par fournisseur sur sa fiche (voir chapitre 09).

Génération automatique des tiers manquants : Oui : le fournisseur inconnu est créé. Non (recommandé) : l'import s'arrête sur ce flux jusqu'à la création du fournisseur ou son association à un tiers existant.

Compléter les informations manquantes des tiers à la réception : Remplit uniquement les champs vides du tiers (SIREN, TVA, adresse…) à partir de la facture reçue, sans écraser l'existant.

Limite d'activation de la synchronisation des flux : Oui : applique un nombre maximal de flux par synchronisation (voir « Nombre de flux traités par défaut par appel », onglet « Options avancées »).

Interdire la validation des factures fournisseurs si les données Dolibarr ne correspondent pas aux données de la facture électronique : Compare devise, totaux HT, TVA, TTC et ventilation par taux. NE PAS ACTIVER : le code du module signale cette option comme défectueuse. Un contrôle de cohérence des totaux est de toute façon appliqué à la validation.

Informer le fournisseur lorsqu'une facture fournisseur est validée : Oui : le statut 205 « Approuvée » est envoyé à la validation de la facture fournisseur, une seule fois, jamais si déjà approuvée ou refusée, jamais sur l'avoir d'une facture refusée. Non par défaut (une facture approuvée ne peut plus être refusée).

Informer le fournisseur du paiement d'une facture : Oui : le statut 211 « Paiement transmis » est envoyé quand une facture fournisseur reçue via la PA est classée payée. Une fois par facture. Facultatif dans la réforme et consomme un flux : désactivé par défaut.

L'option « Importer les lignes sans produit / service comme des lignes libres » n'est plus affichée depuis la version 1.5.0 (dépréciée, fortement déconseillée). Elle ne réapparaît qu'avec la constante cachée EINVOICING_ENABLE_DEPRECATED_OPTION_IMPORT_AS_FREE_LINES ; une instance qui l'avait activée continue de l'appliquer.

06. CONFIGURATION DU MODULE

Onglet « Outils de développement »

Visible uniquement si la constante cachée EINVOICING_ALLOW_DEVTOOLS = 1.

r5.png

Réservé aux tests, jamais à la production.

Autoriser le renvoi d'une facture déjà transmise : Pour tester le comportement de la PA en cas de doublon (le renvoi sera refusé).

Autoriser la régénération de la facture électronique d'une facture transmise :  Conserve le bouton « Régénérer » pour inspecter le XML.

Générateur de factures d'exemple : Choix du vendeur, de l'acheteur, du format (CII / Factur-X) et du type (standard, remplacement, acompte, avoir, situation) ; boutons « Générer un exemple de facture » et « Générer, envoyer et récupérer un exemple de facture ».

Liens externes : Liens vers les validateurs externes et les annuaires (gouvernement, SuperPDP, Peppol test) pour vérifier votre identifiant.

Proxy OAuth : Aide à la configuration du proxy OAuth (mode opérateur).

06. CONFIGURATION DU MODULE

Onglet « Paramètres de la Plateforme Agréée »

Cet onglet établit la connexion avec votre PA.

r1.png

Mode réel activé (sinon mode test / bac à sable)

Oui = production. Non = bac à sable. Les identifiants saisis sont conservés séparément pour chaque mode : on peut basculer sans les perdre.

Sélectionnez votre Plateforme Agréée (PA)

Liste des plateformes compatibles. Une fois la plateforme choisie et enregistrée, sa configuration spécifique apparaît en dessous. Si la plateforme mémorisée n'est plus disponible (module fournisseur désactivé), un avertissement invite à en choisir une autre.

Utiliser le contact de facturation comme acheteur de la facture électronique

Factures françaises uniquement. Si la facture possède un contact de type « Contact client facturation », il devient l'acheteur du XML à la place du tiers :

Désactivé par défaut. Dans tous les cas le contact de facturation est écrit comme contact de l'acheteur (BG-9).

Configuration spécifique SuperPDP

Un encadré rappelle les étapes : créer un compte SuperPDP, créer une « Application » (type Confidentiel, URL de redirection fournie par la page, « Format de conversion AFNOR préféré » = CII), récupérer le couple client_id / client_secret (le secret n'est affiché qu'une seule fois).

Champs :

Paramètre

Description

Votre identifiant de facturation électronique d'entreprise

Laisser vide pour utiliser le SIREN de votre société, ou saisir SIREN ou SIREN_suffixe.

Attention :

 cet identifiant doit exister dans l'annuaire.

Protocole d'échange

CII (recommandé) ou Factur-X.

Type d'authentification OAuth

« Client Credentials » (votre propre compte) ou « Authorization Code » (délégation, usage marque grise).

Client ID / Client Secret

Identifiants de l'application SuperPDP.

En mode délégation

  • URL de redirection (à recopier à l'identique dans SuperPDP)
  • Inscription à l'annuaire (send_and_receive)
  • Date officielle uniquement (only_future)
  • Domaine autorisé
  • Adresse de facturation électronique à créer

Boutons :

Générer le jeton d'accès / Régénérer le jeton d'accès : Obtient le jeton OAuth et le mémorise. Un lien permet de supprimer la connexion.

Test de connexion : Vérifie que la PA est joignable.

Afficher mes informations distantes :

Montre ce que la PA connaît de votre société : vérification d'identité (KYB/KYC), plateforme détectée, adresses de facturation électronique enregistrées, adresses Peppol, nom et adresse enregistrés. Le module signale :

Si le champ « Format de conversion AFNOR préféré » de votre application SuperPDP est vide, la PA refuse de transmettre les factures reçues ; s'il vaut UBL, le module ne peut pas les lire. Il doit valoir CII (Factur-X est aussi accepté).

Configuration spécifique Esalink (Hubtimize)

Un encadré renvoie vers un distributeur PDP Libre pour l'abonnement. Champs : identifiant de facturation électronique, protocole, Client ID (nom d'utilisateur), Client Secret (mot de passe), Clé API, puis génération du jeton et test de connexion.

SuperPDP via un partenaire

Lorsqu'un intégrateur a configuré le mode « via partenaire », une entrée « SuperPDP (installation gratuite et facile via <partenaire>) » apparaît : la connexion s'établit par un tunnel OAuth hébergé par le partenaire, sans saisir de client_id / client_secret.

Plateforme de test (TESTPDP)

Visible uniquement si la constante EINVOICING_ALLOW_DEVTOOLS est active. Implémentation de référence qui n'appelle aucun service : réservée aux tests de génération de fichiers.

ℹ Après l'enregistrement d'une nouvelle plateforme, un test de connexion est lancé automatiquement et son résultat affiché.

06. CONFIGURATION DU MODULE

Permissions utilisateur

Dans la fiche de chaque utilisateur ou groupe, module « EInvoicing » :

Permission

Portée

Lire les documents synchronisés et les journaux (read)

Accès à la page d'accueil, aux flux, aux appels, aux références fournisseurs, à la file d'attente.

Créer / lancer / mettre à jour la synchronisation (write)

Bouton « Synchroniser », mappage des produits, actions sur la file d'attente.

Supprimer les documents de synchronisation et les journaux (delete)

Suppression des flux et journaux.

Les actions sur les factures (générer, transmettre, envoyer un statut, abandonner) suivent les droits des modules Factures clients et Fournisseurs (création / modification). Accepter une facture fournisseur reçue exige le droit de la valider.

06. CONFIGURATION DU MODULE

Tâches planifiées

Toutes sont créées DÉSACTIVÉES : il faut les activer explicitement.

Tâche

Fréquence

Rôle

EInvoicingDocumentSync

Toutes les heures

Synchronisation avec la PA : récupère les factures fournisseurs et les statuts de cycle de vie des factures envoyées. INDISPENSABLE en production ; sans elle, seul le bouton « Synchroniser » de la page « Flux échangés » met les données à jour.

EInvoicingCronSuppliersNoSiren

Hebdomadaire

E-mail listant les fournisseurs français sans SIREN. Conseil : première exécution un lundi à 07 h 00.

EInvoicingCronSentInvoices

Quotidien

E-mail d'état des factures envoyées, en mettant en évidence celles sans confirmation de réception (cycle de vie < 202).

EInvoicingCronOutbound

Quotidien

E-mail récapitulant ce qui a été transmis à la PA sur 24 heures (encaissements 212, autres statuts avec résultat de la plateforme, factures envoyées).

Les trois rapports utilisent les adresses de « E-mails de notification » (onglet « Options avancées »).

L'état de la tâche EInvoicingDocumentSync (OK, en retard, en échec, bloquée…) est affiché sur la page d'accueil du module, dans le widget « Synchronisation de la facturation électronique » et dans le tableau de bord de Dolibarr (voir chapitre 12).

07. PRÉPARATION DES DONNÉES

07. PRÉPARATION DES DONNÉES

Préparer les données avant la première facture

Fiche de votre société

Un bandeau d'avertissement s'affiche sur les pages du module (en mode réel) tant que ces informations sont incomplètes :

Si vous avez choisi une adresse de facturation électronique spécifique dans la configuration de la PA, elle doit commencer par votre SIREN et exister dans l'annuaire.

Fiches tiers

Client professionnel français :

Fournisseur :

Le SIREN (ou à défaut SIRET ou TVA) est essentiel au rapprochement automatique des factures reçues. Sans identifiant, le fournisseur risque d'être recréé en doublon (voir le rapport « Fournisseurs sans SIREN »).

Taux de TVA à 0 % et codes d'exonération

Quand une ligne porte un taux de TVA à 0 %, la norme exige un motif codé (BT-121, liste VATEX). Le module refuse de générer plutôt que d'émettre un document au motif inconnu.

Version de Dolibarr

Où renseigner le code VATEX

Dolibarr 18 à 23

Constante cachée MAIN_VAT_EXEMPTION_CODE_FOR_<taux>[_<code TVA>], saisie dans Accueil > Configuration > Divers.

Dolibarr 24 et plus

Colonne « Code d'exonération de la TVA » du dictionnaire des taux de TVA. Le code VATEX-EU-O fait passer la ligne en catégorie « Non soumise à la TVA » (opération hors champ) : la facture ne porte alors aucun numéro de TVA et ne peut pas mélanger opérations hors champ et opérations taxées ou exonérées.

La catégorie de TVA d'une ligne (BT-151) est lue depuis le code TVA de la ligne : un code commençant par « AE » (ex. AE, AE-IC) déclare une autoliquidation, avec le code VATEX-FR-AE pour un vendeur français. La note du dictionnaire sert de motif d'exonération (BT-120).

Produits et services

Pour la réception

Chaque ligne de facture reçue est rapprochée d'un produit Dolibarr dans cet ordre :

  1. Le prix fournisseur (onglet « Prix fournisseurs » du produit) dont la référence fournisseur est égale à la référence portée par la ligne (BT-155). Une ligne sans référence fournisseur (factures OVH ou Bouygues Telecom, par exemple) est recherchée sur son libellé : quand une telle ligne est rattachée à un produit, le module enregistre le tarif fournisseur sous ce libellé pour la reconnaître aux factures suivantes.
  2. Si l'option est active : la même référence en comparaison tolérante.
  3. La référence acheteur de la ligne (BT-156), si elle est la référence d'un de vos produits.
  4. Le produit ou le service par défaut défini sur la fiche du fournisseur (bloc « Facturation électronique ») : le service pour une facture de services, le produit pour une facture de biens (cadre de facturation BT-23 ; voir chapitre 09 pour les factures mixtes).
  5. Si l'option est active : le produit générique choisi dans l'onglet « Options de réception ».
  6. Sinon : choix fait dans la fenêtre de pré-import (synchronisation manuelle, si l'option est active), création automatique si l'option est active, ou arrêt de l'import de la facture jusqu'à résolution manuelle (voir chapitre 11).

ℹ Seuls les produits marqués « à l'achat » peuvent recevoir une référence fournisseur.

Pour l'émission

Chaque ligne doit avoir un libellé ou une description (BT-153, règle BR-25), sinon la génération signale les lignes concernées.

Sur la fiche d'un client, deux champs facultatifs complètent les factures électroniques qui lui sont adressées : « Notre identifiant fournisseur chez ce client » (BT-29) et « Référence acheteur par défaut » (BT-10). Ne les remplir que si le client les demande (voir chapitre 09).

08. TRAVAUX PLANIFIÉ

08. TRAVAUX PLANIFIÉ

Pour aller plus loin

k1.png

k2.png

Important : Si, dans la configuration du module EInvoicing, la création automatique des produits/services et des tiers manquants n’est pas activée, la synchronisation peut être interrompue lorsqu’une facture fournisseur fait référence à un tiers ou à un produit/service qui n’existe pas encore dans votre application. Dans ce cas, lancez une synchronisation manuelle afin de créer les éléments manquants et permettre la poursuite de la synchronisation.

Pour vérifier d'un coup d'œil que la tâche tourne, utilisez le widget « Synchronisation de la facturation électronique » de la page d'accueil de Dolibarr : il indique l'état de la tâche (OK, en retard, en échec, bloquée…), la cause de la dernière erreur et le dernier document enregistré (voir chapitre 12).

09. FICHE TIERS

09. FICHE TIERS

La fiche tiers : bloc « Facturation électronique »

Un bloc « Facturation électronique » est ajouté sur la fiche de chaque tiers.

Adresse de facturation électronique

Adresse par défaut : Déduite automatiquement du SIREN (source « Automatique »).

Adresses spécifiques : Saisir « SIREN » ou « SIREN_suffixe » (jamais une adresse postale : le champ est contrôlé) avec un libellé facultatif, puis « Ajouter ». Chaque adresse peut être définie par défaut (« Définir comme valeur par défaut ») ou supprimée.

Bouton « Récupérer les adresses depuis l'annuaire » : Lit dans l'annuaire AFNOR toutes les adresses de réception déclarées pour le SIREN du tiers, enrichies de la désignation et de l'adresse postale de chaque établissement (registre public des entreprises, siège signalé). Cocher les adresses à ajouter (les actives sont précochées) puis « Ajouter la sélection ». Les adresses déjà enregistrées sont indiquées « Déjà enregistrée ». Nécessite un SIREN sur le tiers.

Création ou modification de la fiche : L'adresse saisie dans le champ de routage est enregistrée par le module à l'enregistrement du tiers.

Motif de non-gestion

Indique pourquoi le tiers est exclu de la facturation électronique :

Produit et service par défaut (fournisseurs, si la réception est active)

« Produit par défaut » et « Service par défaut » : utilisés à l'import d'une facture de ce fournisseur quand une ligne ne correspond à aucun produit existant. Le module choisit d'après le cadre de facturation du document (BT-23) : le service par défaut pour une facture de services, le produit par défaut pour une facture de biens ou sans cadre. Si un seul des deux est défini, il sert dans tous les cas. Ce sont des « fourre-tout » : toutes les lignes non reconnues y sont rattachées.

Pour une facture mixte (biens et services), l'option « Type de produit par défaut à utiliser à l'import lorsqu'il n'est pas fourni (factures mixtes) » de l'onglet « Options de réception » décide ; sans réglage, l'import de la facture s'arrête lorsqu'une ligne a besoin d'un défaut.

Frais de ligne (fournisseurs)

« Incorporez les informations relatives aux frais à la description » : remplace, pour ce fournisseur seulement, l'option générale « Intégrer les frais d'une ligne dans sa propre description plutôt que sur une ligne distincte » (onglet « Options de réception »). Conserver la valeur par défaut sauf besoin particulier de ce fournisseur.

Champs propres aux clients (émission)

Laisser ces champs vides si le client ne les a pas demandés.

Fusion de tiers

Les adresses de routage suivent le tiers conservé.

10. FACTURES CLIENTS

10. FACTURES CLIENTS

Factures clients : émettre une facture électronique

i7.png

Cycle complet automatique (configuration par défaut)

  1. Vous créez la facture. À la création, le module évalue si elle relève de la facturation électronique (tiers français, entreprise, assujetti) et lui attribue un statut initial (« Non généré » ou « Ne pas générer »).
  2. Vous validez la facture. Dolibarr génère le PDF. Le module enchaîne :
    1. Contrôle des données obligatoires (société, tiers, facture : SIREN, TVA, adresses, IBAN si virement, avoir avec facture source, mentions…) et, si l'option est active, contrôle via les API gouvernementales ;
    2. Contrôle de joignabilité du destinataire dans l'annuaire (selon option) ;
    3. Génération du fichier <ref>_cii.xml ou <ref>_facturx.pdf dans les fichiers joints de la facture, puis validation locale EN 16931 ;
    4. Pré-validation à distance par la PA si réglée sur « automatique » ;
    5. Transmission à la PA si « Transmission automatique » = Oui.
    Le statut passe à « Généré (prêt à envoyer) » puis, après transmission, « Envoyé (en attente d'accusé de réception) ». 3. Suivi du cycle de vie. Un contrôle périodique (page ouverte : rafraîchissement automatique du statut ; tâche planifiée horaire ; bouton « Synchroniser ») récupère les statuts du cycle de vie renvoyés par la PA : 200 Déposée, 201 Émise, 202 Reçue, 203 Mise à disposition, 205 Approuvée, 210 Refusée, 213 Rejetée… 4. Encaissements. Chaque encaissement enregistré sur la facture est déclaré à la PA (statut 212).

ℹ Si la génération échoue, la facture est validée quand même (sauf option « Annuler l'enregistrement si la génération échoue ») et un message détaille la cause ; vous corrigez puis cliquez « Générer » ou « Régénérer ».

Le bouton « Facture électronique » et ses actions

Sur la fiche d'une facture validée, un bouton déroulant « Facture électronique » propose selon l'état :

Générer :  Crée le fichier de facture électronique (première génération).

Régénérer :  Recrée le fichier (facture non transmise). Sur une facture transmise, le bouton est grisé avec le motif « Facture déjà transmise à la plateforme (non modifiable). Pour la corriger, émettez un avoir. »

Vérifier le fichier de facture électronique : (si la pré-validation à distance est réglée sur « manuelle ») Demande à la PA de contrôler le fichier. Résultat : « Vérification préliminaire réussie » ou « a échoué ».

Transmettre / Retransmettre : Ouvre une fenêtre de confirmation qui récapitule le tiers, les montants et l'adresse électronique de destination, puis envoie le fichier à la PA. Retour : « Facture envoyée avec succès - ID de flux : … ». Le bouton disparaît une fois la facture transmise (sauf option de test). « Retransmettre » n'apparaît que si le dépôt précédent a été refusé (statut « Erreur technique »).

Déclarer un paiement (212) : (facture transmise dont la TVA est exigible à l'encaissement, ayant au moins un paiement) Déclare à la main un encaissement à la PA quand l'envoi automatique a échoué (plateforme indisponible, par exemple). La fenêtre de confirmation demande de choisir le paiement et rappelle combien de statuts de paiement ont déjà été envoyés : ne déclarez qu'un paiement qui ne l'a pas encore été, sinon la plateforme le compte deux fois.

Abandonner la transmission : (facture en anomalie ou jamais reçue). Une facture hors périmètre affiche un unique bouton grisé « Facture électronique » dont l'infobulle explique la raison (tiers non français, particulier…) et renvoie au bouton standard « Générer » pour le PDF.

Une facture générée ou envoyée pour une autre PA que celle configurée est signalée et ses actions désactivées.

Le bloc « Facturation électronique » de la fiche facture

Sous les champs standard de la facture :

État de facturation électronique : Statut courant avec, sur une facture brouillon, la possibilité de le modifier (par exemple pour forcer « Ne pas générer de facture électronique (autre raison) », ou le remettre à « Non généré »). Infobulle : le statut est fixé à la validation ; la synchronisation le tient à jour.

Motif de non-gestion : Pour une facture exclue : hors zone, B2C, non assujetti, choix de l'utilisateur (réévalué d'après les données actuelles du tiers).

Commentaires de validation : Message renvoyé par la PA (accusé de dépôt, motif d'erreur).

Résultat de prévalidation Point d'Accès : Verdict du validateur distant, s'il a été sollicité.

Adresse de routage spécifique (BT-49)

Accessibilité du tiers destinataire (annuaire)

Référence de la facture de l'acheteur (BT-10)

Historique : Lien vers l'onglet « Événements » de la facture, filtré sur les événements de facturation électronique.

Badge de statut dans le bandeau

Sous le statut Dolibarr de la facture, un badge « Facture électronique : … » affiche le statut électronique courant, ou « Abandonnée » si le suivi a été abandonné. Même badge sur les factures fournisseurs reçues.

Lignes à montant négatif

Une remise saisie sous forme de ligne à prix négatif n'est pas conforme (règle BR-27) : la PA rejette ou signale la facture. Le module affiche un encadré « Ligne(s) à montant négatif - non conforme(s) » listant les lignes.

Vérification de joignabilité du destinataire (annuaire)

Si l'option est active, la ligne « Accessibilité du tiers destinataire (annuaire) » interroge automatiquement l'annuaire à l'ouverture de la fiche (lien « Consulter le répertoire » pour relancer) et répond :

Résultat

Signification

Joignable

Une adresse de réception active a été trouvée.

Injoignable

Le destinataire (SIREN) est absent de l'annuaire.

Injoignable

Présent mais sans ligne d'adressage active.

Adresse électronique inaccessible

L'adresse utilisée sur la facture n'est pas déclarée (une autre adresse du tiers l'est peut-être).

Non joignable pour le moment

L'adresse ne prend effet qu'à une date future.

Indéterminé

La plateforme n'a pas communiqué l'état de la ligne.

La vérification porte sur l'adresse réellement utilisée pour l'envoi (adresse spécifique de la facture ou adresse par défaut du tiers). Une mention précise si la réponse vient du répertoire propre à la plateforme plutôt que du service standardisé.

Adresse de routage spécifique à une facture

Champ « Adresse de routage spécifique » : vide = adresse par défaut du tiers. Vous pouvez saisir une autre adresse (SIREN ou SIREN_suffixe, contrôlée) ou cliquer sur « Récupérer les adresses depuis l'annuaire » : le module liste les adresses de réception du SIREN avec désignation, adresse postale et siège, et « Utiliser cette adresse pour la facture » l'applique à la facture et l'ajoute aux adresses du tiers. Modifiable tant que la facture n'est pas transmise.

Référence acheteur (BT-10) et Chorus Pro

« Référence de la facture de l'acheteur » : référence propre au client pour router la facture dans son organisation (service, boîte interne…). Envoyée en BT-10. Si elle est vide, la « Référence acheteur par défaut » saisie sur la fiche du client est utilisée (voir chapitre 09).

Avec l'option Chorus activée, les champs « Code de service (Chorus Pro) », « Numéro du marché », « Numéro d'engagement » et « Identifiant transmission Chorus Pro » apparaissent sur la facture (et les trois premiers sur les commandes).

ℹ Le code de service est envoyé comme identifiant d'acheteur (BT-46, schéma 0224) ; il doit ne contenir que lettres, chiffres et + - _ . (100 caractères maximum) et exige le profil EXTENDED-CTC-FR, sinon un message l'indique.

Verrouillage d'une facture transmise

Dès qu'une facture a été transmise (un identifiant de flux existe) :

Abandonner le suivi d'une facture

Pour une facture en anomalie (erreur, refus, rejet) ou dont la réception n'est jamais confirmée, et que vous avez traitée autrement (renvoyée par e-mail, par exemple), l'action « Abandonner la transmission » demande un commentaire obligatoire, consigné dans les événements de la facture.

La facture quitte alors les alertes, les rapports et le tableau de bord (sections « À surveiller » et « Anomalies ») et porte le badge « Abandonnée ». Elle peut être réactivée depuis la section « Factures clients abandonnées » de la page d'accueil (bouton « Réactiver »).

Onglet « Événements de facturation électronique »

i8.png

Onglet ajouté à la fiche facture (« Événements liés à la facturation électronique ») lorsque la constante cachée EINVOICING_ADD_A_DEDICATED_AGENDA_VIEW vaut 1 (voir « Constantes cachées », chapitre 06) :

Statut actuel : Frise chronologique des statuts, colorés par acteur (Vendeur, PA, Acheteur), avec la mention « Pas encore transmis » le cas échéant.

Journal détaillé : Date, plateforme, sens (entrant / sortant), statut, commentaires, statut de validation du message envoyé (Ok / En attente / Erreur).

Aperçu du fichier XML

Dans la liste des fichiers joints de la facture, une icône « Afficher le fichier XML de la facture électronique » ouvre le XML CII dans une fenêtre, avec coloration et indentation, sans le télécharger. Disponible aussi sur les factures fournisseurs reçues (XML reçu, ré-indenté s'il était sur une ligne).

Déclaration des encaissements (statut 212)

Obligation de la réforme lorsque la TVA est exigible à l'encaissement : à chaque paiement client enregistré sur une facture transmise, le module envoie le statut 212 « Encaissée » avec la date et le montant (une facture payée en deux fois donne deux statuts ; les acomptes sont toujours déclarés). Aucune option ne le désactive.

Cas où il n'est pas envoyé :

Si l'envoi automatique d'un encaissement a échoué, l'action « Déclarer un paiement (212) » du bouton « Facture électronique » permet de le déclarer à la main.

Actions de masse depuis la liste des factures

Dans la liste des factures clients, sélectionner des factures puis :

Un récapitulatif indique le nombre de factures traitées, ignorées (déjà transmises, hors périmètre) et en échec, avec le détail par facture.

Factures hors périmètre (particuliers, étrangers, points de vente)

Sont automatiquement placées en « Ne pas générer de facturation électronique (e-reporting) » :

Le statut « Ne pas générer de facture électronique (autre raison) » peut être choisi manuellement sur un brouillon.

11. FACTURES FOURNISSEURS

11. FACTURES FOURNISSEURS

Factures fournisseurs : recevoir des factures électroniques

La synchronisation

Menu Facturation > Gestion des factures électroniques > Synchronisation des factures électroniques (page « Flux échangés »).

j1.png

Encadré de synchronisation

La même opération est réalisée automatiquement par la tâche planifiée EInvoicingDocumentSync. Un flux déjà présent dans la liste n'est jamais réimporté.

Résumé de la synchronisation après exécution

ℹ Si des e-mails de notification sont configurés, un e-mail « Facture(s) électronique(s) reçue(s) » est envoyé après chaque synchronisation ayant importé des factures (avec lien vers chacune) ou rencontré des échecs d'import (voir chapitre 16).

Ce que fait l'import

Pour chaque facture reçue, le module :

  1. Lit le document (XML CII ou Factur-X ; un document UBL n'est pas lisible et est réessayé à la prochaine synchronisation).
  2. Identifie ou crée le fournisseur (voir « Résolution du fournisseur ») et complète ses informations si l'option est active.
  3. Crée une facture fournisseur brouillon, du type déclaré (standard, avoir, acompte, remplacement), aux dates du document, avec :
      • La référence fournisseur (numéro de facture du fournisseur, BT-1). Le module conserve aussi ce numéro à part : si vous modifiez ensuite la référence fournisseur de la facture, les statuts envoyés, les avoirs et les factures qui la citent la retrouvent toujours.
      • Les lignes avec produit rapproché (voir « Résolution des produits et services »), quantité, prix unitaire (un prix « pour N unités » est ramené à l'unité), remises de ligne, frais de ligne et de document, TVA. Les frais d'une ligne (BG-28) sont importés comme des lignes distinctes, ou intégrés à la description de la ligne selon l'option « Intégrer les frais d'une ligne dans sa propre description » et le réglage de la fiche du fournisseur.
      • Les totaux annoncés par le document : si le mode de calcul de TVA de l'instance ne les reproduit pas, le module tente l'autre mode et le signale, sinon il reporte l'écart sur la dernière ligne de chaque taux pour respecter les montants du document.
      • Les acomptes déjà réglés déduits, si la facture d'acompte référencée existe dans Dolibarr.
      • La référence de commande déclarée par le fournisseur (BT-13), conservée dans tous les cas ; si un bon de commande fournisseur unique porte cette référence pour ce fournisseur, la facture y est liée automatiquement (et rejoint son projet) ; plusieurs commandes ou commande d'un autre fournisseur : non liée, message explicatif ;
      • Les notes libres du document (BT-22) dans la note publique.
      • L'adresse de livraison en contact de type « Livraison ».
  4. Joint le fichier XML reçu à la facture (et le PDF lisible fourni par la PA, sauf option contraire).
  5. Enregistre le flux, son accusé et les statuts déjà reçus.
  6. Ajoute à la facture un événement « Import de la facture reçue … » qui indique le flux, la plateforme et la version du module.

Un document qui référence une facture absente de Dolibarr (avoir sur une facture inconnue, situation précédente…) n'est pas importé : créez la facture manquante avec sa référence exacte et l'import se fera à la synchronisation suivante.

Une facture reçue déjà présente (même référence fournisseur) mais avec un montant différent est signalée en doublon à traiter.

Un document incohérent, dont la somme des lignes ne correspond pas au total des lignes qu'il annonce (règle BR-CO-10), est importé avec un message d'avertissement, mais la facture créée ne peut pas être validée ni approuvée : refusez le document au fournisseur pour qu'il en envoie un corrigé.

Résolution du fournisseur

Le tiers est recherché sur ses identifiants structurés (SIREN, SIRET), puis sur le numéro de TVA. Un simple nom ou une adresse e-mail identiques ne suffisent pas : le module ne rattache jamais un document à un tiers sur cette seule base. Si le nom du fournisseur diffère de celui du tiers trouvé par identifiant, un avertissement invite à vérifier la fiche.

Tiers introuvable :

Résolution des produits et services

Chaque ligne est rapprochée d'un produit dans l'ordre décrit au chapitre 07 : prix fournisseur, comparaison tolérante, référence acheteur, produit ou service par défaut du fournisseur, produit générique.

Produit introuvable :

Pré-import des lignes sans produit

r7.png

Option « Pré-import des lignes sans produit avant une synchronisation manuelle » (onglet « Options de réception »). Quand elle est active, le bouton « Synchroniser » lit d'abord auprès de la PA, sans rien enregistrer, les factures fournisseurs que la synchronisation va importer, et affiche dans la fenêtre « Produits introuvables avant import » les lignes dont le produit est introuvable (réf. produit, réf. fournisseur, prix unitaire, description). Pour chaque ligne :

Les lignes que seul le produit générique résout figurent aussi dans la fenêtre, ce produit présélectionné ; celles que le produit ou le service par défaut du fournisseur résout n'y figurent pas. « Valider et importer » lance la synchronisation, qui applique ces choix dans la transaction de chaque facture : une facture en échec ne laisse aucun produit créé, et un choix inapplicable arrête l'import de sa facture avec le motif. Rien n'est importé si vous annulez.

Aucune ligne n'est importée sans avoir été présentée : une facture que la fenêtre n'a pas pu afficher (au-delà de 200 lignes, document illisible lors de l'analyse, facture arrivée entre-temps) arrête la synchronisation avant elle ; relancez la synchronisation pour qu'elle soit proposée. La tâche planifiée n'affiche pas de fenêtre : elle applique les réglages de l'import (création automatique, produit générique, ligne libre ou arrêt).

File d'attente « Flux en attente d'une action manuelle »

Menu Facturation > Gestion des factures électroniques > File d'attente de synchronisation (menu affiché seulement si la constante cachée EINVOICING_ENABLE_MANUAL_ACTION_QUEUE vaut 1).

Sans cette constante (fonctionnement par défaut), un flux qui ne peut pas être importé arrête la synchronisation sur ce flux, avec les « Actions à entreprendre ». Avec elle, un flux qui ne peut pas être importé (produit ou tiers manquant, facture existante avec un montant différent) est mis en file d'attente et la synchronisation continue avec les autres flux. La file conserve le flux même lorsqu'il sort de la fenêtre glissante de synchronisation.

Colonne

Contenu

Identifiant de flux

Identifiant unique du flux

Type

Entrant / sortant

Référence du document

Référence portée par la facture

Motif

Produit introuvable / Tiers introuvable / Facture trouvée avec un montant différent

Action manuelle proposée

Lien vers l'action à mener

Tentatives

Nombre de tentatives d'import

Date de mise à jour

Dernière modification

Statut

En attente / Résolu / Ignoré

Actions par ligne

Liens d'action manuelle : Créer le produit, créer le tiers, associer…

Associer à un tiers existant : Le module propose des tiers candidats (par SIREN, SIRET, TVA ou mots du nom), puis un écran de comparaison champ par champ (valeur de la facture / valeur actuelle du tiers) où vous cochez les champs à écrire sur le tiers. Les identifiants vides sont précochés ; les conflits sont laissés décochés (ne cocher que s'il s'agit vraiment de la même entité). Un identifiant déjà porté par un autre tiers ne peut pas être écrit (unicité Dolibarr) : le module propose d'associer ce tiers. À la validation, le flux est resynchronisé.

Réessayer : Relance la synchronisation de ce seul flux ; s'il passe, il devient « Résolu ».

Ignorer : Retire le flux de la liste « En attente » (réversible).

Rouvrir : Remet en attente un flux ignoré ou résolu.

Supprimer : Supprime définitivement l'entrée de la file.

Page « Associer les produits d'une facture électronique »

Menu Facturation > Synchronisation > Associer les produits.

Ouverte depuis le menu, la page liste les flux reçus dont des lignes restent à associer (nombre de lignes, nombre de lignes à associer) : choisissez-en un, ou saisissez un autre identifiant de flux. Elle s'ouvre aussi depuis les « Actions à entreprendre » d'un flux bloqué. Elle affiche les lignes de la facture reçue (référence produit fournisseur, référence produit acheteur, identifiant global EAN/GTIN, libellé, quantité, prix, TVA) et permet de choisir pour chacune le produit Dolibarr correspondant (produits « à l'achat » uniquement).

« Enregistrer l'association » crée un prix fournisseur sur chaque produit avec la référence fournisseur : c'est le premier critère utilisé aux imports suivants.

ℹ Le fournisseur est lu dans le document (« Fournisseur identifié à partir du document »). S'il n'est pas encore connu de Dolibarr, la page demande de choisir le tiers sur lequel enregistrer les références ; un tiers choisi qui n'est pas le vendeur du document est signalé.

Page « Références de prix des fournisseurs »

Menu Facturation > Synchronisation > Références de prix des fournisseurs.

j2.png

Liste toutes les références fournisseur enregistrées sur vos produits (fournisseur, référence, libellé fournisseur, produit Dolibarr). Actions :

Il est recommandé de gérer ces références depuis l'onglet « Prix fournisseurs » de chaque produit ; cette page sert au contrôle et aux corrections ponctuelles. Le module détecte les conflits (même référence, même fournisseur, même quantité) qui écraseraient silencieusement une ligne.

La fiche facture fournisseur

Bloc « Facturation électronique »

Source : « Plateforme Agréée » (avec l'identifiant de flux) ou « Créé manuellement ».

Statut facture électronique : Dernier statut du cycle de vie reçu ou envoyé.

Dernier statut d'envoi : Dernier statut que vous avez transmis (205, 210, 211) et son état de validation.

Référence de commande déclarée par le fournisseur (BT-13) : Référence reprise du document reçu.

Historique : Lien vers les événements.

Badge de statut dans le bandeau et aperçu du XML reçu dans les fichiers joints

Dans la liste des factures fournisseurs, les colonnes « Source » (masquée par défaut) et « État de facturation électronique » (affichée par défaut) se choisissent, avec leurs filtres, dans le sélecteur de colonnes de la liste.

Encadrés d'information possibles

Répondre au fournisseur : statuts 205, 210, 211

Le bouton déroulant « Facture électronique » d'une facture fournisseur reçue propose « Modifier et soumettre le statut de la facture » avec les statuts envoyables :

Approuvé par le client (205)

Confirmation demandée. Sur un brouillon, accepter la facture la valide aussi dans Dolibarr (elle quitte le brouillon et obtient sa référence définitive) ; il faut donc le droit de valider. Une fois approuvée, le refus n'est plus proposé.

Refusé par le client (210)

Confirmation avec choix obligatoire d'un motif (voir chapitre 15). Terminal : clôt l'échange, la facture fournisseur est abandonnée (fermée avec le code « refusée ») et exclue des listes comptables.

Paiement transmis (211)

Disponible sur une facture validée déjà répondue et payable ; ne nécessite pas d'approbation préalable. Masqué après un refus et sur un brouillon.

Chaque envoi est historisé (onglet Événements, sens « Sortant », statut de validation Ok / En attente / Erreur). Un envoi refusé par la PA sur l'adresse électronique du fournisseur (motif MDT-73) précise l'adresse en cause : soit corriger l'identifiant de routage enregistré sur la fiche du fournisseur, soit en enregistrer un, puis renvoyer le statut depuis l'onglet.

ℹ Les statuts 200 à 204, 206 à 209 et 213 sont reçus et affichés mais jamais envoyés par le module.

Réimporter un document reçu

Tant que la facture fournisseur créée par l'import est en brouillon, le document reçu peut être importé à nouveau : après avoir corrigé la fiche du fournisseur, ou si la facture a été rattachée au mauvais tiers.

Action « Réimporter le document de facture électronique », depuis la fiche du flux (page « Flux échangés » > ouvrir le flux) ou depuis le bouton « Facture électronique » de la facture fournisseur (grisée, avec le motif, quand elle n'est pas utilisable). Le module redemande le document à la PA (rien n'est envoyé) et reconstruit le brouillon sur place : l'en-tête est relu, fournisseur compris, et les lignes et fichiers joints par l'import précédent sont remplacés ; la référence, les fichiers joints à la main, les événements, les contacts, les notes et les statuts déjà reçus sont conservés. Un événement « Réimportation de la facture reçue … » est ajouté. Si le brouillon a été supprimé, le document est importé comme une nouvelle facture.

Un statut de cycle de vie reçu qui n'a pu être rattaché à aucune facture se relit depuis la fiche de son flux, action « Importez à nouveau ce flux de cycle de vie » : il est rattaché à la facture fournisseur correspondante si elle est maintenant trouvée.

Une facture fournisseur qui n'est plus un brouillon ne peut pas être remplacée.

Validation, suppression et contrôles

À la validation d'une facture fournisseur issue d'une facture électronique

Un échec d'envoi de statut n'annule jamais la validation.

Suppression

Une facture fournisseur créée depuis une facture électronique ne peut plus être supprimée après validation. Seul son brouillon peut l'être ; le document reçu reste alors dans la liste des flux (réimportable, voir « Réimporter un document reçu »). Le fichier XML reçu ne peut pas être supprimé de la facture.

Changer d'entité (multi-société)

Avec le module Multi-société et la constante EINVOICING_ALLOW_MULTICOMPANY_INVOICE_MOVE renseignée (liste des entités), un bouton « Changer d'entité » apparaît sur les factures fournisseurs modifiables.

Cas d'usage : toutes les entités partagent le même SIREN, les factures sont reçues dans l'entité principale puis réparties. Le fournisseur doit être visible dans l'entité cible ; les fichiers joints sont déplacés (avertissement sinon).

12. TABLEAUX DE BORD

12. TABLEAUX DE BORD

Page d'accueil : tableau de bord de suivi

Menu Facturation > Gestion des factures électroniques.

j4.png

En-tête et tableau de bord

En tête : plateforme connectée (« Votre logiciel semble lié à la plateforme agréée … ») ou invitation à configurer, puis un tableau de bord de synchronisation : date de la dernière synchronisation, nombre de factures clients et fournisseurs synchronisées, et état de la tâche planifiée de synchronisation : ligne « Synchronisation automatique » (OK, En cours, En retard, Échec, Bloquée, Jamais exécutée, Non planifiée ou Désactivé), cause de la dernière erreur, date d'exécution prévue si la tâche est en retard, et « Dernier document enregistré ».

Factures fournisseurs reçues (7 derniers jours)

Période modifiable (date de début / fin, « Afficher la période », retour « 7 derniers jours »). Fournisseur, référence, montants, statut, lien « Ouvrir la facture ».

Factures clients émises

À surveiller

Factures envoyées sans confirmation de réception (cycle de vie < 202), quel que soit leur âge, avec accusé de dépôt, cycle de vie et motif CDAR. Un blocage typique « Ack Ok / 200 Déposée / NON_TRANSMISE » signifie que le destinataire n'a pas encore reçu : vérifier l'adresse de routage.

En transit

Envoyées récemment  

Dépôt acquitté, réception en attente.

Réception confirmée

Reçues par la plateforme sur la période.

Anomalies (factures émises ou reçues)

Factures en erreur, refus, litige, suspension ou rejet technique, avec sens (émise / reçue), statut et motif lisible.

Factures clients abandonnées

Factures dont le suivi a été abandonné avec le commentaire, et un bouton « Réactiver ».

Données transmises à la plateforme (24 h)

Fournisseurs sans SIREN (France)

Fournisseurs français (ou sans pays) sans SIREN ni SIRET ni TVA, avec lien « Ouvrir la fiche ». Les fournisseurs étrangers sont exclus.

Widget et tableau de bord de Dolibarr

Le widget « Synchronisation de la facturation électronique », placé par défaut sur la page d'accueil de Dolibarr (utilisateurs ayant le droit de lecture du module), reprend ces lignes d'état de la tâche de synchronisation.

Dès que la tâche planifiée de synchronisation est active, la carte « Factures » du tableau de bord de Dolibarr affiche aussi la ligne « Synchronisation de la facturation électronique : <état> », comptée en retard lorsque la tâche est en échec, en retard ou bloquée. Elle renvoie vers cette page.

13. PAGES DE FLUX

13. PAGES DE FLUX

Page « Flux échangés »

Liste des flux

Sous l'encadré de synchronisation, la liste de tous les flux :

j1.png

Colonne

Contenu

Date de synchronisation

Date d'enregistrement du flux dans Dolibarr

Identifiant de flux

Identifiant unique (flow_id)

Type de flux

SupplierInvoice, CustomerInvoiceLC (cycle de vie d'une facture client), SupplierInvoiceLC…

Direction

Entrée / Sortie

Syntaxe, profil

Format et niveau de détail du document

Référence de suivi

Référence du document

Objet lié

Facture client ou fournisseur

Plateforme, entité

PA et entité Dolibarr concernées

Récapitulatif du flux

Accusé et statut de cycle de vie, code motif, description

Dates

Soumission et mise à jour

Filtres et tri sur chaque colonne, vue liste ou kanban.

Fiche d'un flux

Cliquer sur l'identifiant : détail des champs, XML archivé, onglets Notes, Fichiers joints, Événements ; actions « Réimporter le document de facture électronique » (voir chapitre 11, « Réimporter un document reçu »), « Importez à nouveau ce flux de cycle de vie » pour un statut reçu non rattaché, et « Supprimer » (impossible si le flux est lié à une facture fournisseur existante).

Export de support (archive ZIP)

Action de masse « Exporter dans une archive ZIP » : constitue une archive de support à partir des flux sélectionnés (flux, appel API associé, constantes de configuration avec secrets caviardés, versions).

Les archives contiennent les documents tels qu'enregistrés (noms, adresses, e-mails, téléphones) : les lire avant de les transmettre.

Nombre maximal d'enregistrements limité (constante EINVOICING_SUPPORT_EXPORT_MAX). Les réponses complètes n'y figurent que si le mode débogage était actif au moment des appels.

ℹ Une synchronisation n'importe jamais à nouveau un flux déjà listé : pour réimporter, passer par la fiche du flux.

14. PAGES DE SYNCHRONISATION

14. PAGES DE SYNCHRONISATION

Page « Journaux d'appels et de synchronisation »

Menu Facturation > Gestion des factures électroniques > Journaux d'appels et de synchronisation.

j3.png

Contenu du journal

Page réservée aux utilisateurs avancés pour diagnostiquer les échanges avec la PA. Chaque appel API est journalisé :

Champ

Contenu

Identifiant

Call-000001…

Type, méthode

Nature de l'appel

Point d'accès

Endpoint appelé

Requête / réponse

Corps de la requête et réponse (données sensibles caviardées ; détail complet uniquement en mode débogage)

Limite de lot

Nombre maximal de flux demandés

Flux

Totaux / ignorés / réussis

Statut

Succès / Échec

Plateforme

PA concernée

Message

Message récupéré, détail du traitement

ℹ Le journal survit aux annulations de transaction : un appel effectué reste tracé même si l'opération Dolibarr qui l'a déclenché a été annulée.

15. STATUS

15. STATUS

Statuts et motifs

Statuts internes Dolibarr (avant / hors cycle de vie)

Statut

Signification

Statut inconnu

—

Non généré

Facture éligible, fichier pas encore créé

Généré (prêt à envoyer)

Fichier créé, pas transmis

Envoyé (en attente de validation)

Transmis, en cours de contrôle par la PA

Envoyé (en attente d'accusé de réception)

Transmis, accusé attendu

Erreur technique

Dépôt refusé par la PA : corriger et retransmettre

Ne pas générer de facturation électronique (e-reporting)

Hors périmètre (B2C, étranger, caisse)

Ne pas générer de facture électronique (autre raison)

Exclusion manuelle

Statuts du cycle de vie (codes normalisés 200 à 213)

Sur une facture client, Dolibarr est le vendeur : il reçoit les statuts et envoie 212. Sur une facture fournisseur, Dolibarr est l'acheteur : il peut envoyer 205, 210, 211.

Code

Libellé

Émis par

Module

200

Déposée

PA du vendeur

reçu (oblig.)

201

Émise par la PA du vendeur

PA du vendeur

reçu

202

Reçue par la PA du client

PA du client

reçu

203

Disponible pour le client

PA du client

reçu

204

Prise en charge

acheteur

reçu

205

Approuvée par le client

acheteur

envoi (option ou bouton)

206

Approuvée partiellement

acheteur

reçu

207

Contestée (en litige)

acheteur

reçu

208

Suspendue

acheteur

reçu

209

Complétée

vendeur

reçu

210

Refusée par le client

acheteur

envoi (bouton, motif oblig.)

211

Paiement transmis

acheteur

envoi (option ou bouton)

212

Paiement reçu (encaissée)

vendeur

envoi auto

213

Rejetée par la PA du vendeur

PA du vendeur

reçu (oblig.)

Seuls 200, 210, 212 et 213 sont obligatoires dans la réforme ; les autres sont facultatifs et leur absence ne prouve pas un échec. Le seul signal négatif fiable est 213.

Les statuts 207, 208, 210 et 213 et le statut interne « Erreur technique » placent la facture en « Anomalie » dans le tableau de bord et les alertes.

Motifs de refus et de rejet

Motifs proposés lors d'un refus (210)
Motifs de rejet technique (213) renvoyés par la PA

16. NOTIFICATIONS

16. NOTIFICATIONS

Notifications par e-mail et rapports planifiés

Destinataires et expéditeur

Destinataires : option « E-mails de notification » de l'onglet « Options avancées » (chapitre 06). Expéditeur : adresse MAIN_MAIL_EMAIL_FROM de Dolibarr (obligatoire).

E-mails envoyés à chaque synchronisation (manuelle ou planifiée)

« Facture(s) électronique(s) reçue(s) »

Liste des factures fournisseurs importées (fournisseur, référence, montants, lien « Ouvrir ») et, le cas échéant, la section « Factures reçues NON importées » avec le motif (fournisseur inconnu, produit inconnu…) : ces factures sont sur la PA mais pas encore dans Dolibarr ; le module réessaiera.

« Facture(s) électronique(s) en anomalie »

Factures émises ou reçues qui viennent de passer en erreur, refus, litige, suspension ou rejet, avec statut et motif.

Rapports planifiés (tâches à activer, chapitre 06)

Rapport

Fréquence

« Fournisseurs sans SIREN à compléter »

Hebdomadaire

« Factures envoyées en attente de confirmation de réception »

Quotidien

« Données transmises à la plateforme (24 h) »

Quotidien

La sortie de chaque tâche indique le nombre d'éléments et les destinataires, ou « rien à envoyer ».

Le bouton « Envoyer un e-mail de test » de l'onglet « Options avancées » permet de vérifier la chaîne d'envoi.

Les e-mails partent par la configuration e-mail de Dolibarr (Accueil > Configuration > E-mails). Si la fonction PHP mail() est désactivée sur le serveur (cas de l'hébergement InfraS), une méthode d'envoi SMTP doit y être configurée : sinon l'envoi est refusé avec le message « Envoi impossible : la fonction PHP mail() est désactivée sur ce serveur et aucun envoi par SMTP n'est configuré dans Dolibarr », sans bloquer la synchronisation.

17. DÉPANNAGE

17. DÉPANNAGE

Dépannage et questions fréquentes

« La facture électronique n'a pas pu être générée en raison de problèmes de configuration »

Lire la liste des erreurs (SIREN manquant ou invalide, TVA manquante ou au mauvais format, adresse ou ville vide, avoir sans facture source, IBAN manquant pour un virement, lignes sans description…). Corriger la fiche société, la fiche tiers ou la facture, puis « Générer ».

« Motif inconnu d'exemption de TVA pour la ligne … »

Renseigner le code VATEX du taux à 0 % concerné.

« Le format recommandé est CII, et non Factur-X »

Le PDF Dolibarr n'est pas en PDF/A-3b : passer le « Format des documents PDF » sur PDF/A-3b (Accueil > Configuration > PDF) ou choisir CII.

« Cette facture utilise un modèle ODT/ODS, mais aucune version PDF n'a été générée »

Factur-X exige un PDF : activer MAIN_ODT_AS_PDF ou utiliser un modèle PDF.

Facture envoyée mais aucun statut ne progresse

Vérifier que la tâche planifiée EInvoicingDocumentSync est active, ou lancer « Synchroniser ». Dans la section « À surveiller », un motif NON_TRANSMISE indique que le destinataire n'a pas d'adresse active : vérifier l'adresse de routage (annuaire) et contacter le client.

« Erreur technique » sur une facture

La PA a refusé le dépôt (voir « Commentaires de validation » et le journal des appels). Corriger, « Régénérer », puis « Retransmettre ». Les encaissements ne sont pas déclarés tant que le dépôt n'est pas accepté.

« Cette facture a déjà été transmise … et ne peut plus être modifiée »

Comportement normal : émettre un avoir ou une facture rectificative, ou dupliquer la facture.

Impossible d'obtenir le jeton d'accès

Vérifier les identifiants (mode réel / test correspondant), le type d'authentification, et pour SuperPDP que l'application est de type « Confidentiel ». Le test en ligne de commande scripts/testconnect.php permet de diagnostiquer.

Aucune facture fournisseur n'arrive alors que la PA en affiche

Sur SuperPDP, vérifier le « Format de conversion AFNOR préféré » de l'application (doit être CII). Vérifier ensuite la file d'attente et le résumé de synchronisation : un flux bloqué (tiers ou produit inconnu) y est expliqué avec les actions à mener.

Facture fournisseur importée sur le mauvais tiers

Corriger les identifiants des tiers, puis utiliser « Réimporter le document de facture électronique » depuis la facture fournisseur (encore en brouillon) ou depuis la fiche du flux : l'en-tête, fournisseur compris, est relu et le brouillon reconstruit.

« Le montant total de cette facture ne correspond pas à celui indiqué sur la facture électronique »

Corriger la facture d'après le document (aperçu XML), ou refuser le document au fournisseur avec le motif adapté.

« Le document reçu … est incohérent : la somme de ses lignes s'élève à … »

Le fournisseur a envoyé un document dont les lignes ne correspondent pas au total qu'il annonce (BR-CO-10). La facture importée ne peut être ni validée ni approuvée : la refuser au fournisseur (motif « montant total incorrect » ou « erreur de calcul ») pour qu'il envoie un document corrigé.

« Facture … (flux …) : ses lignes sans produit n'ont pas encore été présentées dans la fenêtre de pré-import »

Avec le pré-import actif, la synchronisation s'arrête avant une facture que la fenêtre n'a pas affichée (document illisible lors de l'analyse, plus de 200 lignes à décider, facture arrivée entre-temps). Relancer la synchronisation : ses lignes seront proposées.

Le nom du fournisseur diffère du tiers trouvé

Le rapprochement s'est fait sur le SIREN / la TVA : vérifier et mettre à jour la fiche tiers si nécessaire.

L'e-mail de notification n'arrive pas

Vérifier MAIN_MAIL_EMAIL_FROM, les adresses saisies, puis utiliser le bouton « Envoyer un e-mail de test ». Un relais SMTP peut réécrire l'expéditeur.

« Envoi impossible : la fonction PHP mail() est désactivée sur ce serveur… »

Configurer un envoi SMTP dans Accueil > Configuration > E-mails, puis utiliser le bouton « Envoyer un e-mail de test » de l'onglet « Options avancées ».

« Les fichiers du module de facturation électronique ont été mis à jour vers la version …, mais le module a été activé pour la dernière fois avec la version … »

Comme après toute mise à jour d'un module, le désactiver puis le réactiver dans Accueil > Configuration > Modules/Applications, afin de mettre à niveau sa base de données. Les réglages sont conservés.

Besoin d'aide du support

Activer le mode débogage, reproduire, puis exporter les flux ou appels concernés en archive ZIP (chapitres 10 et 11) et joindre le journal du module (onglet Débogage).

Relire l'archive avant envoi : elle contient les données des documents.

Manuel d'utilisation du module EInvoicing — Facturation électronique française pour Dolibarr — Chapitre 18

Glossaire

Termes et sigles

Terme

Définition

AFNOR XP Z12-012 / 013 / 014

Normes françaises : modèle sémantique et statuts, annuaire, cas d'usage.

BT-xx / BG-xx

Identifiants des données de la norme EN 16931 (BT = terme, BG = groupe).

BR-xx

Règles métier de la norme (BR-CO calculs, BR-FR règles françaises, BR-AE autoliquidation).

CDAR

Message d'accusé et de réponse portant un statut de cycle de vie.

CII

Syntaxe XML UN/CEFACT Cross Industry Invoice.

EN 16931

Norme européenne de la facture électronique.

Factur-X

PDF/A-3 avec XML CII embarqué.

Flux

Un échange unitaire avec la PA.

KYB / KYC

Vérification d'identité de l'entreprise / de l'utilisateur par la PA.

OAuth

Protocole d'authentification par jetons.

PA / PDP

Plateforme Agréée / Plateforme de Dématérialisation Partenaire (ancien nom).

Peppol

Réseau international d'échange, utilisé par certaines PA.

SIREN / SIRET

Identifiants d'entreprise (9 chiffres) et d'établissement (14 chiffres).

VATEX

Liste des codes de motif d'exonération de TVA.

VIES

Service européen de vérification des numéros de TVA intracommunautaires.

Principaux identifiants BT cités dans ce manuel

Identifiant

Donnée

BT-1

Numéro de facture

BT-8

Code de date d'exigibilité de la TVA

BT-10

Référence acheteur

BT-13

Référence de commande

BT-34 / BT-49

Adresses électroniques vendeur / acheteur

BT-121

Code d'exonération