--- title: "Configuration" weight: 20 description: "Paramétrage du module Facturx après installation." --- # 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](screenshots/page-configuration.webp) ## 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](/facturx/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](/facturx/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](/facturx/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.