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
- 02. MOTS CLÉS
- 03. ACTIVER LA FACTURATION ÉLECTRONIQUE
- ACTIVATION ET PRÉREQUIS
- Mode A : Inscription à HUBTIMIZE assisté via INFRAS
- Mode B : Inscription directe à SuperPDP
- 04. LA FACTURATION ÉLECTRONIQUE
- 05. UTILISATION DE LA FACTURATION ÉLECTRONIQUE
- 06. CONFIGURATION DU MODULE
- Constantes cachées
- Onglet « Débogage »
- Onglet « Options avancées »
- Onglet « Options d'envoi »
- Onglet « Options de réception »
- Onglet « Outils de développement »
- Onglet « Paramètres de la Plateforme Agréée »
- Permissions utilisateur
- Tâches planifiées
- 07. PRÉPARATION DES DONNÉES
- 08. TRAVAUX PLANIFIÉ
- 09. FICHE TIERS
- 10. FACTURES CLIENTS
- 11. FACTURES FOURNISSEURS
- 12. TABLEAUX DE BORD
- 13. PAGES DE FLUX
- 14. PAGES DE SYNCHRONISATION
- 15. STATUS
- 16. NOTIFICATIONS
- 17. DÉPANNAGE
01. PRÉSENTATION DU MODULE
Présentation du module
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
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 :
- CII : un fichier XML seul (
<ref>_cii.xml). Format recommandé. - Factur-X : un PDF/A-3 qui contient le PDF habituel de la facture et le XML CII embarqué (
<ref>_facturx.pdf). Exige que le format PDF de Dolibarr soit réglé sur PDF/A-3b (Accueil > Configuration > PDF).
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
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 :
- Si vous êtes utilisateur indépendant du logiciel de Dolibarr (si vous avez installé le logiciel par vous même):
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.
- Si vous êtes un utilisateur client d’InfraS (l’offre SaaS de Dolibarr LTS):
Une facture émise, une facture reçue ou un e-reporting : chaque document traité compte pour une unité, sans autres frais.
- Facturation à la consommation : seuls les documents effectivement traités sont facturés
- Aucun volume minimal, aucun abonnement imposé
- Périodicité de facturation trimestrielle ou annuelle, à votre convenance
- Sans engagement : résiliation possible à tout moment moyennant un préavis d'un mois
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 :
- Rendez-vous sur la page Accueil → Configuration → Modules/Applications.
- 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.
Mode A : Inscription à HUBTIMIZE assisté via INFRAS
Pourquoi opter pour la PA EsaLink (Hubtimize) ?
EsaLink est une société spécialisée dans l’EDI et la dématérialisation depuis plus de quinze ans, immatriculée officiellement comme Plateforme Agréée par la DGFiP en décembre 2025. Sa PA s’appelle Hubtimize e-Invoicing.
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 :
- Une interopérabilité démontrée avec Dolibarr — non pas des promesses commerciales, mais des flux réels éprouvés de bout en bout (émission, réception, e-reporting) avec le module communautaire conforme à la norme AFNOR XP Z12-013.
- L'absence de toute dépendance — API normalisée AFNOR, réversibilité contractuelle et archives restituables : vous demeurez libre de partir à tout moment.
- Une maîtrise durable des coûts — grâce à la mutualisation des volumes de la communauté open source au sein de l'association PDP Libre, dont InfraS est membre distributeur.
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 DolibarrNos experts :
| Mise en conformité Factur-X
| Formation et support continu
|
|---|
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.
- E-invoicing et e-reporting conformes à la réforme française
- Échanges avec toutes les autres PA et le portail public
- Cycle de vie complet de la facture (statuts, rejets, suivi)
- API normalisée AFNOR : pérennité et réversibilité garanties
- Module Dolibarr développé par la communauté, à laquelle InfraS contribue activement
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 :
- Extrait Kbis de moins de 3 mois (ou avis de situation SIRENE pour les artisans, professions libérales, associations et micro-entrepreneurs)
- Pièce d'identité en cours de validité du représentant légal (CNI ou passeport)
- Numéros SIREN / SIRET et TVA intracommunautaire
- RIB de l'entreprise et mandat de prélèvement SEPA
- Mandat de désignation de votre plateforme de réception (modèle fourni, signature du représentant légal)
- Délégation de pouvoir, uniquement lorsque le signataire n'est pas le représentant légal
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.
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.
3 - Une fois ces instructions suivies, vous obtiendrez un Client ID et un Client Secret :
4 - Renseignez ces informations dans les champs correspondants, puis cliquez sur Enregistrer :
5 - Cliquez ensuite sur le lien Se connecter (Générer le jeton d’accès).
✅ 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
À 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 :
- Il transforme les factures clients validées dans Dolibarr en factures électroniques (formats Factur-X ou CII) et les transmet au point d'accès choisi ;
- Il récupère les factures fournisseurs reçues via ce même point d'accès et les transforme automatiquement en factures fournisseurs dans Dolibarr ;
- Il suit le cycle de vie de chaque facture (accusés de réception, statuts d'acheminement, rejets, paiements) et le reporte à la plateforme.
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
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 :
- À 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).
- À 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.
- Vous pouvez à tout moment cliquer sur « Vérifier l'annuaire » pour confirmer que le destinataire est bien joignable électroniquement.
- 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.
- 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).
- 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 :
- l'adresse postale ;
- l'adresse e-mail ;
- le numéro de TVA intracommunautaire ;
- le numéro SIREN (ainsi que l'adresse de facturation électronique spécifique, si elle diffère du numéro SIREN — cas rare).
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.
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.
Une fois la facture transmise, vous pouvez suivre son statut dans le bloc Facturation électronique de la fiche de la facture client…
… ou via la colonne « État de la facture électronique » de la liste des factures clients.
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.
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
Exemple : vue de la liste des factures clients
Exemple : vue de la liste des factures fournisseurs
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.
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
Constantes cachées
Constante | Rôle |
|---|---|
| Active l'onglet Outils de développement et la plateforme TESTPDP. |
| 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). |
| Ne récupère pas le PDF lisible des factures reçues (gain de temps). |
| Liste des identifiants d'entités : ajoute un bouton « Changer d'entité » sur les factures fournisseurs reçues |
| Identifiant de l'entité principale dont la configuration et la réception sont partagées. |
(+ | Rapprochement tolérant de la référence fournisseur à l'import : la référence du XML est recherchée comme mot entier dans (ex. « FA202610 » retrouve « PAY123 - FA202610 - dinner »). Plusieurs candidats = ambiguïté, pas d'import. |
| Préfère le document original au document converti à l'import. |
| Nombre maximal d'enregistrements par export de support (archive ZIP). |
| Force le profil : MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, EXTENDEDFR. |
/
| 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. |
| 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. |
| 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 ». |
| 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. |
| Ajoute l'onglet « Événements liés à la facturation électronique » sur la fiche des factures clients (voir chapitre 10). |
| 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 ». |
| Dolibarr 18 à 23 : code VATEX pour un taux à 0 % (voir chapitre 07). |
Onglet « Débogage »
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é.
Onglet « Options avancées »
Réglages techniques communs à l'envoi et à la réception.
Section « Paramètres »
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 :
- la liste des nouvelles factures fournisseurs importées à chaque synchronisation
- une alerte quand une facture émise ou reçue passe en anomalie
- les rapports planifiés une fois leurs tâches activées. Vide = tout désactivé. Un bouton « Envoyer un e-mail de test » envoie immédiatement la liste des factures reçues sur 7 jours (ou un e-mail de confirmation vide). Ces e-mails partent par la configuration e-mail de Dolibarr : un envoi SMTP doit y être configuré si la fonction PHP mail() est désactivée sur le serveur.
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 ».
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) »
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
- Pas de validation.
- Validation manuelle : bouton « Vérifier le fichier » sur la facture.
- Validation automatique après génération.
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 :
- Non (défaut).
- Oui, bloquer un destinataire signalé injoignable.
- Oui, et bloquer aussi lorsque la disponibilité ne peut être confirmée.
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) :
- Mention de frais de recouvrement (défaut : indemnité forfaitaire 40 €) ;
- Mention de pénalités de retard (défaut : trois fois le taux légal) ;
- Mention concernant l'escompte (défaut : pas d'escompte).
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é.
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) »
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.
Onglet « Outils de développement »
Visible uniquement si la constante cachée EINVOICING_ALLOW_DEVTOOLS = 1.
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).
Onglet « Paramètres de la Plateforme Agréée »
Cet onglet établit la connexion avec votre PA.
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 :
- Contact d'un autre tiers (ex. siège distinct) : l'acheteur complet (nom, adresse, SIREN/SIRET, TVA, routage) est repris de ce tiers
- Contact du même tiers : seuls le nom et l'adresse changent.
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 |
|
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 :
- Une adresse d'envoi non enregistrée dans l'annuaire (les factures envoyées avec elle seraient refusées).
- Un numéro d'entreprise différent de celui de Dolibarr (erreur).
- Un nom ou une adresse différents (remarque).
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é.
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.
Tâches planifiées
Toutes sont créées DÉSACTIVÉES : il faut les activer explicitement.
Tâche | Fréquence | Rôle |
|---|---|---|
| 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. |
| Hebdomadaire | E-mail listant les fournisseurs français sans SIREN. Conseil : première exécution un lundi à 07 h 00. |
| Quotidien | E-mail d'état des factures envoyées, en mettant en évidence celles sans confirmation de réception (cycle de vie < 202). |
| 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
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 :
- Nom, adresse, code postal, ville, pays.
- Identifiant professionnel 1 (SIREN, 9 chiffres, clé de contrôle valide).
- Numéro de TVA intracommunautaire (FR + 2 caractères + 9 chiffres).
- Compte bancaire par défaut avec IBAN si le mode de règlement est le virement (configuration du module Factures ou compte de la facture).
- Régime de TVA (Taxes/TVA : sur les débits ou à l'encaissement).
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 :
- SIREN (Id. prof. 1) ou SIRET (Id. prof. 2) valides (clé de contrôle).
- Numéro de TVA (sinon il est calculé à partir du SIREN) ; s'il est saisi, il doit correspondre au SIREN.
- Nom, adresse, code postal, ville, pays.
- Type de tiers correctement renseigné (entreprise ou particulier) : le module s'appuie sur la détection Dolibarr pour exclure les B2C.
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 |
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 :
- 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.
- Si l'option est active : la même référence en comparaison tolérante.
- La référence acheteur de la ligne (BT-156), si elle est la référence d'un de vos produits.
- 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).
- Si l'option est active : le produit générique choisi dans l'onglet « Options de réception ».
- 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É
Pour aller plus loin
- Synchronisation automatique à l’aide des travaux planifiés : Vous pouvez programmer le lancement automatique de la synchronisation. Pour cela, assurez-vous que le module « Travaux planifiés » est activé, puis accédez à Accueil → Modules / Applications → Travaux planifiés et ouvrez l’onglet Travaux planifiés.
- Vous trouverez une tâche cron intitulée « Synchronisation de documents EInvoicing ». Vous pouvez l’activer. Par défaut, cette tâche est exécutée une fois par heure, mais vous pouvez modifier sa fréquence d’exécution selon vos besoins.
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
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 :
- « Tiers hors zone géographique (France uniquement) » ;
- « Tiers particulier (B2C) » ;
- « Tiers non soumis à la TVA » ;
- « Choix de l'utilisateur ».
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)
- « Notre identifiant fournisseur chez ce client » : code fournisseur que ce client vous a attribué, envoyé en BT-29 sur les factures électroniques qui lui sont adressées.
- « Référence acheteur par défaut » : référence que ce client demande de voir sur ses factures pour les acheminer en interne (service, unité…), envoyée en BT-10 lorsque la facture ne porte pas sa propre référence acheteur.
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
Factures clients : émettre une facture électronique
Cycle complet automatique (configuration par défaut)
- 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 »).
- Vous validez la facture. Dolibarr génère le PDF. Le module enchaîne :
- 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 ;
- Contrôle de joignabilité du destinataire dans l'annuaire (selon option) ;
- Génération du fichier
<ref>_cii.xmlou<ref>_facturx.pdfdans les fichiers joints de la facture, puis validation locale EN 16931 ; - Pré-validation à distance par la PA si réglée sur « automatique » ;
- Transmission à la PA si « Transmission automatique » = Oui.
ℹ 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.
- Sur une facture brouillon en devise de la société, le bouton « Convertir en remise globale (mise en conformité) » transforme ces lignes en remise globale Dolibarr, montants inchangés ; le XML émet alors une remise (allowance) conforme.
- Sur une facture validée : repasser en brouillon ou corriger par un avoir.
- Indisponible en devise étrangère.
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) :
- Le bouton « Modifier » est désactivé avec le message « Cette facture a été transmise au point d'accès et ne peut plus être modifiée. Veuillez émettre un avoir ou une facture rectificative ».
- La suppression, la dévalidation (retour en brouillon) et la modification des champs verrouillés (référence, dates, totaux, tiers, conditions et mode de règlement) sont refusées, y compris par l'API.
- Le renvoi et la régénération sont désactivés (sauf options de test).
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 »
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é :
- facture jamais transmise ;
- dépôt refusé par la PA (« Erreur technique » : corriger et renvoyer d'abord) ;
- régime de TVA sur les débits sans acompte ;
- envoi désactivé.
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 :
- « Générer les factures électroniques » .
- « Envoyer les factures électroniques au point d'accès » (les factures non encore générées sont ignorées : « Aucun fichier de facture électronique n'a encore été généré, rien à envoyer »).
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) » :
- Les factures aux tiers non français.
- Les factures aux particuliers (si l'option B2C est active).
- Les factures aux tiers non assujettis.
- Les factures issues des modules de point de vente listés.
Le statut « Ne pas générer de facture électronique (autre raison) » peut être choisi manuellement sur un brouillon.
11. FACTURES FOURNISSEURS
Factures fournisseurs : recevoir des factures électroniques
La synchronisation
Encadré de synchronisation
- Dernier flux synchronisé avec succès / date.
- Lancer la synchronisation depuis : date de départ (par défaut, dernière synchronisation moins le délai de recouvrement configuré), non postérieure au dernier flux synchronisé.
- Retour en arrière (heures) : 0 = aucun.
- Nombre maximal de nouveaux flux à traiter par exécution : 0 = sans limite.
- Bouton « Synchroniser » (demande confirmation).
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
- nombre total de flux disponibles, nouveaux flux synchronisés, flux ignorés (déjà traités), flux reportés (réessayés la prochaine fois) ;
- « Synchronisation interrompue sur le flux n° … » en cas d'erreur, avec la section « Dernière facture fournisseur qui n'a pas pu être synchronisée » : téléchargement de la facture originale, convertie et lisible, et « Actions à entreprendre » (créer le fournisseur, créer le produit / service, associer à un produit existant, définir un produit par défaut pour ce tiers, créer la facture fournisseur manquante référencée, corriger un montant…) ;
- journal de synchronisation détaillé si le mode débogage est actif.
ℹ 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 :
- Lit le document (XML CII ou Factur-X ; un document UBL n'est pas lisible et est réessayé à la prochaine synchronisation).
- Identifie ou crée le fournisseur (voir « Résolution du fournisseur ») et complète ses informations si l'option est active.
- 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 ».
- Joint le fichier XML reçu à la facture (et le PDF lisible fourni par la PA, sauf option contraire).
- Enregistre le flux, son accusé et les statuts déjà reçus.
- 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 :
- Création automatique si l'option est active, sinon l'import s'arrête sur ce flux (ou le flux est mis en file d'attente, voir ci-dessous) avec une action « Créer le fournisseur » ou « Associer à un tiers existant ».
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 :
- choix fait dans la fenêtre de pré-import, si l'option est active et que la synchronisation est lancée à la main (voir ci-dessous) ;
- sinon création automatique si l'option est active ;
- sinon ligne libre, seulement si l'ancienne option « Importer les lignes sans produit / service comme des lignes libres » est encore active (déconseillé, voir chapitre 06) ;
- sinon l'import de la facture s'arrête avec les actions « Créer le produit », « Créer le service », « Associer à un produit existant », « Définir un produit par défaut pour ce tiers ».
Pré-import des lignes sans produit
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 :
- « Liaison avec un produit existant » : rechercher et choisir le produit ; l'import crée ou met à jour son tarif fournisseur, dans la devise du document, pour que la ligne soit reconnue aux factures suivantes ;
- « Laisser en produit libre » : la ligne est importée sans produit (choix absent si les lignes libres sont désactivées dans Dolibarr) ;
- laisser vide : un produit ou un service (selon le « Type d'article ») est créé, avec pour référence la référence acheteur de la ligne, sinon la référence fournisseur précédée de « EI- » ; il est marqué « à l'achat » et non « en vente ».
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 »
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 »
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.
- Une ligne sans référence fournisseur ne peut pas être associée ici (créer le produit, définir un produit par défaut, ou utiliser la fenêtre de pré-import, qui enregistre le tarif sous le libellé de la ligne).
- Les lignes qui retomberaient sur le produit ou le service par défaut du fournisseur, ou sur le produit générique, sont signalées mais restent associables.
- Une fois toutes les lignes associées, relancer la synchronisation (« Retour à la synchronisation »).
ℹ 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 »
Liste toutes les références fournisseur enregistrées sur vos produits (fournisseur, référence, libellé fournisseur, produit Dolibarr). Actions :
- « Réaffecter cette référence à un autre produit » ;
- « Supprimer ce mappage » (individuel ou en masse) ;
- signalement d'un produit qui n'est plus « à l'achat » (à réactiver ou à remplacer) et d'un fournisseur supprimé (mappage obsolète).
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
- Facture classée « B2B international » par la PA : aucun statut de cycle de vie ne peut lui être envoyé (fournisseur français sans adresse dans l'annuaire : c'est à lui de corriger) ; elle ne peut qu'être payée.
- Avoir corrigeant une facture refusée : il ne peut qu'être refusé à son tour (une facture refusée est annulée, il n'y a rien à créditer).
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
- Contrôle des totaux : si le total de la facture ne correspond pas à celui du document reçu (TTC et TVA), la validation est bloquée : corriger la facture d'après le document, ou refuser le document au fournisseur.
- Contrôle de cohérence du document : si la somme des lignes du document reçu ne correspond pas au total des lignes qu'il annonce (BR-CO-10), la validation et l'approbation sont bloquées : refuser le document au fournisseur.
- Contrôle des acomptes : un document « déjà payé » dont l'acompte n'est pas lié bloque la validation : enregistrer la facture d'acompte référencée et la joindre en remise, ou refuser.
- La facture remplacée par une facture de remplacement est clôturée (« remplacée ») et ne peut plus être payée.
- Envoi du statut 205 si l'option est active.
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
Page d'accueil : tableau de bord de suivi
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)
- Encaissements déclarés (statut 212) avec montant encaissé et résultat de la plateforme (Accepté / En attente / Erreur) ;
- Autres statuts transmis (205, 210, 211) ;
- Factures clients envoyées.
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
Page « Flux échangés »
Liste des flux
Sous l'encadré de synchronisation, la liste de tous les flux :
Colonne | Contenu |
|---|---|
Date de synchronisation | Date d'enregistrement du flux dans Dolibarr |
Identifiant de flux | Identifiant unique ( |
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
Page « Journaux d'appels et de synchronisation »
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
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)
- destinataire non connecté.
- document justificatif manquant ou insuffisant.
- erreur de routage.
- erreur de coordonnées bancaires.
- contrat résilié.
- double facture.
- numéro de commande incorrect ou manquant.
- taux de TVA incorrect.
- montant total incorrect.
- erreur de calcul.
- mention légale manquante.
- facture en double.
- destinataire inconnu.
- erreur du destinataire.
- transaction inconnue.
- émetteur inconnu.
- contrôle antivirus.
- adresse de facturation électronique erronée.
- SIRET incorrect ou manquant.
- code de routage incorrect ou manquant.
- référence contractuelle manquante.
- référence incorrecte .
- prix unitaire incorrect.
- remise incorrecte.
- quantité facturée incorrecte.
- produit / service facturé incorrect.
- conditions de paiement incorrectes.
- qualité du produit / service livré incorrecte.
- livraison incomplète ou non conforme.
- autre.
Motifs de rejet technique (213) renvoyés par la PA
- erreur sémantique.
- contrôle d'unicité.
- cohérence des données.
- adressage.
- contrôles métier B2G.
- référence ou association de pièce jointe.
- fichiers vides
- type / extension / syntaxe / taille des fichiers et pièces jointes du flux.
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
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 |