Configuration

Accédez à la configuration via Accueil > Configuration > Modules/Applications, puis cliquez sur l'icône d'engrenage du module Facturx. Vous arrivez sur l'onglet Réglages.

Écran de configuration du module Facturx avec l'ensemble des paramètres

Paramètres généraux

Créer un nouveau fichier PDF suffixé

Paramètre FACTURX_SUFFIX_ENABLE
Type Oui / Non
Défaut Non

Par défaut, le module remplace le PDF original de la facture par le PDF contenant les métadonnées Factur-X. Si vous activez cette option, le module conserve le PDF original et crée un second fichier avec le suffixe _facturx. Par exemple : FA2202-2003_facturx.pdf.

Astuce : Si vous souhaitez un suffixe différent, vous pouvez définir la constante cachée FACTURX_SUFFIX_CUSTOM dans Accueil > Configuration > Divers.

Regrouper les documents PDF

Paramètre FACTURX_CONCAT_BEFORE
Type Oui / Non
Défaut Non

Lorsque cette option est active, le module concatène tous les documents PDF liés à la facture (commandes, bons de livraison, etc.) avant d'y intégrer les métadonnées Factur-X. Le PDF final contient ainsi l'ensemble des pièces justificatives.

Deux moteurs de fusion sont utilisés : FPDI d'abord, parce qu'il conserve les liens cliquables des pages reprises, puis TCPDI (celui de Dolibarr) en secours. Ce second passage sert aux pièces jointes produites par d'autres logiciels : à partir de la version 1.5 du format PDF, la table de références croisées peut être compressée, ce que l'analyseur libre livré avec FPDI ne sait pas lire. Il émet alors l'erreur suivante dans le journal, avant que le module ne relance la fusion avec TCPDI :

This PDF document probably uses a compression technique which is not supported by the free parser shipped with FPDI.

La fusion aboutit dans les deux cas ; avec TCPDI, seuls les liens cliquables des pages reprises sont perdus.

Astuce : pour éviter la double tentative quand vous savez que toutes vos pièces jointes sont dans ce cas, forcez le moteur avec la constante cachée FACTURX_CONCAT_ENGINE (valeurs tcpdi ou fpdi) dans Accueil > Configuration > Divers.

Désactiver Chorus

Paramètre FACTURX_DISABLE_CHORUS_EXTRAFIELDS
Type Oui / Non
Défaut Non

Si vous ne travaillez pas avec le secteur public français, activez cette option pour masquer les champs complémentaires Chorus (code service, numéro de marché, numéro d'engagement) sur les factures et les commandes. Consultez la page Chorus pour plus de détails sur ces champs.

*Attention -- ne désactivez cette option que si vous êtes sûr de ne jamais avoir besoin des codes BT- avancés. Les trois champs Chorus servent aussi à renseigner les codes BT-10 (référence acheteur), BT-12 (n° de marché / contrat) et BT-13 (n° d'engagement / bon de commande) du XML Factur-X. Ces codes sont de plus en plus exigés par des clients privés B2B (grands comptes, centrales d'achat, etc.), pas uniquement par le secteur public. Si un client vous demande une "référence acheteur" ou un "n° de commande" dans la facture électronique, laissez Chorus activé**, sans quoi vous ne pourrez plus saisir ces valeurs dans Dolibarr.

Identifiants et contacts

Désactiver l'ID global

Paramètre FACTURX_GLOBAL_IDENTIFIER_DISABLE
Type Oui / Non
Défaut Non

Désactive l'inclusion de l'identifiant global de votre société (schéma d'identification ISO 6523) dans le XML Factur-X. Utile si votre identifiant n'est pas reconnu ou si vous rencontrez des erreurs de validation liées à ce champ.

Identifiant global personnalisé

Paramètre FACTURX_GLOBAL_IDENTIFIER_CUSTOM
Type Texte
Défaut vide

Permet de forcer un identifiant global spécifique au format type:id. Par exemple : 0060:84443123900020 pour un code DUNS. Laissez vide pour utiliser l'identifiant calculé automatiquement à partir des informations de votre société.

Adresse de facturation électronique de votre société (BT-34)

Paramètre FACTURX_AP_SENDER_ID
Type Texte
Défaut vide
Emplacement onglet Point d'accès

Identifiant sous lequel votre société est connue de votre plateforme de dématérialisation. Il est repris dans chaque XML généré, pour que le destinataire et les plateformes sachent d'où vient la facture. Deux formats sont acceptés : 494895360:0225 (identifiant puis code de schéma, usage français) ou 0208:1234567890 (code de schéma puis identifiant, usage Peppol). Ce champ reste accessible même si vous n'avez sélectionné aucun point d'accès dans le module, car la plupart des utilisateurs transmettent leurs factures via une plateforme tierce qui se contente de lire le XML.

L'adresse du client, elle, se saisit sur la fiche de chaque tiers, dans le champ "Identifiant Peppol/FacturX spécifique (BT-49)".

Si ces champs sont vides, le module utilise les adresses e-mail correspondantes, ce qui reste conforme mais n'active pas le routage. Si une valeur est renseignée sans respecter l'un des deux formats, un message d'avertissement le signale à la génération du PDF. Voir la FAQ pour le détail des cas.

Désactiver le contact vendeur (BG-6)

Paramètre FACTURX_GLOBAL_TRADECONTACT_DISABLE
Type Oui / Non
Défaut Non

Désactive l'ajout du bloc "DefinedTradeContact" (BG-6) dans le XML. Ce bloc contient les informations de contact de l'auteur de la facture (nom, adresse e-mail, numéro de téléphone). Désactivez-le si ces informations ne sont pas pertinentes ou posent des problèmes de validation.

Export XML

Créer le XML à part

Paramètre FACTURX_XML_STANDALONE
Type Oui / Non
Défaut Non

Génère le fichier XML Factur-X en tant que fichier séparé plutôt que de l'embarquer dans le PDF. Utile si vous devez transmettre le XML seul à un système tiers.

Profil Factur-X

Paramètre FACTURX_PROFILE
Type Liste déroulante
Défaut PROFILE_EN16931

Choisissez le profil Factur-X à utiliser pour la génération des métadonnées XML. Consultez la page Profils pour une description détaillée de chaque profil.

Profil Description
PROFILE_EN16931 Profil standard européen. Recommandé pour la plupart des usages
PROFILE_EXTENDED (CTC-FR) Profil étendu, nécessaire pour le tiers payeur et certains cas Chorus
PROFILE_XRECHNUNG_3 Profil allemand X-Rechnung 3. Expérimental

Période de facturation

Utiliser min/max des dates de lignes

Paramètre FACTURX_BILLING_PERIOD_MIN_MAX
Type Oui / Non
Défaut Non

Par défaut, la période de facturation au niveau du document (BT-73/BT-74) n'est renseignée que si toutes les lignes de la facture ont les mêmes dates de début et de fin. Activez cette option pour utiliser la date de début la plus ancienne et la date de fin la plus récente parmi toutes les lignes.

Paramètres expérimentaux

Utiliser le trigger

Paramètre FACTURX_USE_TRIGGER
Type Oui / Non
Défaut Non

Le module utilise par défaut le mécanisme de hook de Dolibarr pour intégrer les métadonnées Factur-X dans le PDF. Ce mécanisme permet d'afficher des messages d'alerte à l'utilisateur en cas de problème. Si vous activez cette option, le hook est remplacé par un trigger, qui ne peut pas afficher de messages utilisateur. Déconseillé sauf cas particulier.

Forcer tous les types de factures

Paramètre FACTURX_FORCE_ALL_INVOICE_TYPE
Type Oui / Non
Défaut Non

Force le traitement Factur-X même si le type de document a été modifié par un autre module intermédiaire. Utile en cas de conflit avec d'autres modules qui altèrent le type de document lors de la génération PDF.