INFRASFILES

• 01. PRÉSENTATION GÉNÉRALE
• Présentation du module
• 02. INSTALLATION ET ACTIVATION
• Installation et activation
• 03. PERMISSIONS ET DROITS D'ACCÈS
• Permissions
• 04. CONFIGURATION DU MODULE
• Paramètres du module
• 05. BONS DE PRÉLÈVEMENT ET DE VIREMENT
• Bordereau de prélèvement / virement
• 06. INVENTAIRES
• Feuille de comptage d'inventaire
• 07. UTILISATION SUR LES FICHES
• Génération et onglet Fichiers joints
• 08. ENVOI PAR EMAIL
• Envoi par email
• 09. SAUVEGARDE ET RESTAURATION
• Sauvegarde et restauration
• 10. COMPATIBILITÉ ET MODULES TIERS
• Compatibilité
• 11. DÉPANNAGE
• Dépannage
• 12. CHANGELOG ET SUPPORT
• Changelog et support

01. PRÉSENTATION GÉNÉRALE

Présentation du module

InfraSFiles est un module optionnel de Dolibarr ERP & CRM (versions 18 à 24) qui apporte, aux objets qui n'en disposent pas nativement, les trois fonctions habituelles des documents Dolibarr : la génération de PDF, l'onglet « Fichiers joints » et l'envoi par email.

Dans Dolibarr, un devis, une commande ou une facture disposent d'une section « Fichiers joints » en bas de fiche pour générer un PDF, d'un onglet dédié aux fichiers et d'un bouton « Envoyer par email ». D'autres objets, pourtant très utilisés, n'ont rien de tout cela : c'est le cas des bons de prélèvement / virement et des inventaires. InfraSFiles comble ce manque sans modifier Dolibarr.

1.OBJECTIF

Le module ajoute, sur la fiche native de chaque objet pris en charge :

• La génération de documents PDF : une section « Fichiers joints » en bas de la fiche, avec le choix du modèle et de la langue, exactement comme sur une facture.
• L'onglet « Fichiers joints » en haut de la fiche : fichiers générés ou déposés à la main, fichiers liés (URL), compteur affiché sur l'onglet.
• L'envoi par email depuis la fiche : dernier PDF pré-attaché, modèles de mails dédiés, destinataires proposés, événement enregistré dans l'agenda.

2.DOCUMENTS PRIS EN CHARGE

Objet	Module natif requis	Modèle PDF fourni	Contenu
Bons de prélèvement et de virement	Prélèvement ou Virement (paiement par virement)	« bordereau »	Créancier / donneur d'ordre, débiteur / bénéficiaire (tiers ou sa maison mère), IBAN, BIC, RUM, factures ou salaires concernés avec date, échéance, tiers facturé, avoirs appliqués, statut de chaque ligne, total et montant rejeté
Inventaires	Stock	« comptage »	Feuille de comptage : informations de l'inventaire en en-tête, références regroupées par zone de stockage, case vide de relevé, colonne lot / série si besoin, quantité théorique masquée par défaut, zone « Compté par / Date / Signature »

Avec le module InfraSPackPlus, un second modèle est proposé pour chaque document (« InfraSPlus_Bon » et « InfraSPlus_INV ») : même contenu, mais avec la mise en page et les options d'InfraSPackPlus.

3.PRINCIPE DE FONCTIONNEMENT

InfraSFiles est un socle générique : chaque objet pris en charge est une simple déclaration dans un registre interne, accompagnée d'un modèle PDF. Les tables natives de Dolibarr ne sont jamais modifiées : le module mémorise dans sa propre table le dernier modèle utilisé et le dernier fichier généré pour chaque objet.

Toutes les fonctions sont optionnelles et indépendantes, document par document : on peut par exemple activer la génération PDF des bons de prélèvement sans l'envoi par email, et ne rien activer pour les inventaires.

Les fichiers produits sont stockés dans le répertoire de données du module et leur téléchargement est soumis au droit de lecture natif de l'objet concerné (droit de lecture des bons de prélèvement, droit de lecture des stocks).

4.AVANTAGES

• Aucune modification du cœur de Dolibarr : le module s'appuie uniquement sur les mécanismes natifs (hooks, modèles de documents, formulaire d'envoi d'email).
• Comportement identique aux documents natifs : mêmes écrans, mêmes boutons, mêmes habitudes pour les utilisateurs.
• Modulaire : chaque document et chaque fonction s'active séparément.
• Extensible : un module tiers peut déclarer ses propres objets et fournir ses propres modèles (voir le chapitre Compatibilité et modules tiers).
• Sauvegarde / restauration de l'ensemble des paramètres du module.

5.INFORMATIONS TECHNIQUES

Nom du module	InfraSFiles (libellé « Documents et emails »)
Numéro de module	550100
Compatibilité Dolibarr	18.0.0 à 24.x
Compatibilité PHP	7.4 à 8.4
Licence	GNU GPL v3 ou supérieure
Dépendance obligatoire	Aucune (l'extension PHP xml est nécessaire à l'affichage du changelog)
Langues	Français, anglais, espagnol, italien

Éditeur : InfraS - Sylvain Legrand   -   Contact : support@infras.fr   -   Site web : https://www.infras.fr

02. INSTALLATION ET ACTIVATION

Installation et activation

1.PRÉREQUIS

• Dolibarr version 18.0.0 minimum, jusqu'à la version 24. En dessous de la version 18, le module se désactive de lui-même ; au-delà de la version 24, un avertissement s'affiche à la connexion mais le module reste utilisable, sans garantie.
• PHP 7.4 à 8.4, avec l'extension xml chargée (nécessaire à la lecture du changelog).
• Au moins un des modules natifs concernés doit être activé pour que le document correspondant soit disponible : Prélèvement ou Virement (paiement par virement) pour les bons, Stock pour les inventaires. Sans le module natif, la ligne du document apparaît grisée dans les paramètres.

2.INSTALLATION

1. Téléchargez le module depuis le Dolistore ou le site InfraS
2. Décompressez l'archive dans le dossier « custom » de votre installation Dolibarr
   htdocs/custom/infrasfiles
3. OU utilisez l'outil de déploiement des modules externes de Dolibarr (Accueil > Configuration > Modules/Applications > Déployer un module externe)

3.ACTIVATION

1. Connectez-vous en tant qu'administrateur
2. Allez dans : Accueil > Configuration > Modules/Applications
3. Recherchez « Documents et emails » (famille Modules InfraS)
4. Cliquez sur le bouton « Activer » (ON/OFF)
5. Cliquez ensuite sur l'icône de configuration pour ouvrir la page des paramètres

Ce que fait l'activation

Lors de l'activation, le module prépare automatiquement tout ce dont il a besoin, sans rien modifier aux tables natives :

• Création de sa table de suivi documentaire (dernier modèle et dernier fichier générés par objet).
• Création des répertoires de données documents/infrasfiles/widthdraw et documents/infrasfiles/inventory.
• Création, sur les fiches tiers, de l'attribut supplémentaire « Adresser les bordereaux de prélèvement / virement à la maison mère » (case à cocher, visible tant que le module est actif). Il sert au découpage des PDF par maison mère (voir le chapitre Bons de prélèvement et de virement).
• Création d'un modèle d'email par défaut pour chaque document (visible dans Configuration > Emails > Modèles d'emails), dans la langue de l'utilisateur qui active le module. Un modèle déjà présent n'est jamais écrasé.
• Déclaration des événements automatiques d'agenda « Bon de prélèvement / virement envoyé par email » et « Inventaire envoyé par email ».
• Restauration automatique des paramètres sauvegardés lors d'une précédente désactivation.

IMPÉRATIF : Après toute mise à jour du module, vous DEVEZ : Désactiver le module / Réactiver le module.

Cette opération est nécessaire pour appliquer les modifications de structure (table, attribut, modèles de mails, événements) nécessaires au bon fonctionnement de la nouvelle version. Les paramètres sont sauvegardés automatiquement à la désactivation et restaurés à la réactivation : rien n'est perdu.

4.DÉSACTIVATION

À la désactivation, le module sauvegarde l'ensemble de ses paramètres puis les retire de la configuration. Les fichiers PDF déjà générés, l'attribut « maison mère » des tiers et les modèles d'emails sont conservés : ils seront de nouveau utilisables dès la réactivation.

5.ACCÈS AU MODULE

Une fois activé, le module est accessible depuis deux endroits :

• Accueil > Configuration > Modules/Applications > Documents et emails > icône Configurer
• Outils > InfraS > InfraSFiles, avec deux entrées : Changelog / Support et Paramètres InfraS

La page d'administration comporte trois onglets : Paramètres InfraS, À propos et Changelog / Support.

03. PERMISSIONS ET DROITS D'ACCÈS

Permissions

InfraSFiles définit quatre permissions propres. Elles ne concernent que l'administration du module : l'utilisation quotidienne (générer un PDF, ouvrir l'onglet, envoyer un email) repose sur les droits natifs de chaque objet, décrits au point 5.

1.PERMISSION « VOIR LE MENU DES PARAMÈTRES »

Code	paramMenu
Description	Affiche l'entrée InfraSFiles dans le menu Outils > InfraS et donne accès aux pages Changelog / Support et À propos
Par défaut	✓ OUI (permission par défaut)

2.PERMISSION « MODIFIER LES PARAMÈTRES DU MODULE »

Code	paramInfraSFiles
Description	Permet d'ouvrir la page Paramètres InfraS et de modifier la configuration : activation des documents, options, modèles de documents
Par défaut	✗ NON

3.PERMISSION « SAUVEGARDER / RESTAURER LES PARAMÈTRES DU MODULE »

Code	paramBkpRest
Description	Affiche le bloc Sauvegarder / Restaurer en haut de la page des paramètres
Par défaut	✗ NON

4.PERMISSION « TÉLÉCHARGER TOUS LES FICHIERS DU MODULE »

Code	read
Description	Autorise le téléchargement de tous les fichiers produits par le module (bons de prélèvement, inventaires…) sans le droit de lecture natif de chaque objet. Donne aussi accès au fichier de sauvegarde des paramètres
Par défaut	✗ NON

À réserver aux administrateurs. Sans cette permission, chaque fichier exige le droit de lecture natif de son objet : c'est le fonctionnement normal et recommandé. Cette permission ne sert qu'à un profil technique qui doit pouvoir tout consulter.

5.DROITS NATIFS UTILISÉS AU QUOTIDIEN

Pour les utilisateurs, InfraSFiles ne crée aucun droit supplémentaire : il applique les droits que Dolibarr définit déjà pour chaque objet.

Document	Voir l'onglet, télécharger les fichiers	Générer / supprimer un PDF, envoyer par email
Bons de prélèvement et de virement	Prélèvements > Lire les bons de prélèvement	Prélèvements > Créer / modifier les bons de prélèvement
Inventaires	Stocks > Lire les stocks	Stocks > Créer / modifier les stocks

Concrètement : un utilisateur qui peut consulter un bon de prélèvement peut voir et télécharger ses bordereaux ; un utilisateur qui peut le créer ou le modifier peut aussi générer, supprimer et envoyer les bordereaux. Un fichier est toujours protégé par le droit de son objet : le droit d'écriture sur les bons ne permet pas de supprimer une feuille de comptage d'inventaire, et inversement.

6.CONFIGURATION DES PERMISSIONS

Accès : Accueil > Utilisateurs & Groupes > [Utilisateur ou Groupe] > Permissions

Rechercher « Documents et emails » (ou « InfraSFiles ») dans la liste des modules.

04. CONFIGURATION DU MODULE

Paramètres du module

1.ACCÉDER À LA PAGE DE CONFIGURATION

La configuration du module se fait depuis :

Accueil > Configuration > Modules/Applications > Documents et emails > Configurer

ou depuis le menu Outils > InfraS > InfraSFiles > Paramètres InfraS (permissions Voir le menu des paramètres et Modifier les paramètres du module requises).

La page est organisée en trois blocs, décrits ci-dessous : Sauvegarde / Restauration, Documents pris en charge et Modèles de documents.

2.SAUVEGARDE / RESTAURATION

Ce bloc n'apparaît que pour les utilisateurs disposant de la permission Sauvegarder / Restaurer les paramètres du module. Il permet d'enregistrer l'ensemble des réglages dans un fichier et de les remettre en place plus tard. Le fonctionnement détaillé est décrit dans le chapitre Sauvegarde et restauration.

3.DOCUMENTS PRIS EN CHARGE

Ce bloc liste chaque document que le module sait produire, sous la forme d'un bandeau par document (Bons de prélèvement et de virement, Inventaires) suivi de ses réglages. Les réglages s'affichent de manière hiérarchique : tant qu'un document n'est pas activé, seule sa ligne « Activé » est visible.

Ligne « Activé »

Interrupteur général du document (icône verte = activé, grise = désactivé). Un clic recharge immédiatement la page et fait apparaître, ou disparaître, les lignes de réglage qui en dépendent. Désactivé, le document ne se manifeste nulle part dans Dolibarr : ni section, ni onglet, ni bouton d'envoi.

Si le module natif nécessaire n'est pas activé (Prélèvement ou Virement pour les bons, Stock pour les inventaires), la ligne est grisée avec la mention « Nécessite l'activation d'un de ces modules : … ». Activez d'abord le module natif.

Ligne « Génération PDF + Fichiers joints »

Active la section « Fichiers joints » en bas de la fiche native (choix du modèle, bouton Générer, liste des fichiers) et l'onglet « Fichiers joints » en haut de la fiche. Désactivée, l'onglet reste accessible mais sans l'encadré de génération, et le bloc Modèles de documents ne propose plus ce document.

Ligne « Envoi par email »

Active le bouton « Envoyer par email » sur la fiche native et l'écran d'envoi associé (voir le chapitre Envoi par email).

Options propres à chaque document

Sous ces trois lignes, chaque document propose ses propres options. Les options saisies (liste déroulante, texte) ne sont enregistrées qu'après un clic sur le bouton « Modifier » situé en haut à droite du bloc ; les interrupteurs, eux, s'enregistrent immédiatement.

Document	Option	Type	Rôle
Bons de prélèvement et de virement	Découpage des PDF	Liste	Un PDF par tiers (regroupe ses factures) ou un PDF par maison mère (regroupe ses tiers ayant coché l'option), sinon un PDF par tiers. Une icône d'aide détaille la règle. Voir le chapitre Bons de prélèvement et de virement
Bons de prélèvement et de virement	Texte libre en pied de page	Texte multiligne	Texte imprimé en pied de chaque page du bordereau (vide = aucun)
Bons de prélèvement et de virement	Filigrane sur les documents brouillon	Texte	Filigrane imprimé en travers des pages tant que le bon est au statut brouillon (vide = aucun)
Inventaires	Afficher la quantité théorique sur la feuille de comptage	Interrupteur	Ajoute la colonne « Stock physique » (quantité connue de Dolibarr) sur la feuille. Masquée par défaut pour un comptage à l'aveugle
Inventaires	Texte libre en pied de page	Texte multiligne	Texte imprimé en pied de chaque page de la feuille (vide = aucun)
Inventaires	Filigrane sur les documents brouillon	Texte	Filigrane imprimé tant que l'inventaire est au statut brouillon (vide = aucun)

Le regroupement par zone de stockage de la feuille de comptage ne se règle pas ici : il suit la configuration de la colonne « Zone » du module InfraSWorkflow (voir le chapitre Inventaires).

4.MODÈLES DE DOCUMENTS

Ce bloc affiche un tableau par document dont la « Génération PDF + Fichiers joints » est active. Chaque tableau liste les modèles PDF disponibles pour ce document, y compris ceux fournis par d'autres modules (InfraSPackPlus par exemple).

Colonne	Contenu
Nom	Nom du modèle (« bordereau », « comptage », « InfraSPlus_Bon », « InfraSPlus_INV »…)
Description	Ce que produit le modèle
Type	Toujours « pdf »
Statut	Interrupteur : un modèle activé est proposé dans la liste déroulante de la section « Fichiers joints » de la fiche
Défaut	Modèle présélectionné à la génération. Le choisir l'active automatiquement si besoin
Aperçu	Icône PDF : ouvre dans un nouvel onglet un document SPÉCIMEN (objet fictif, rien n'est enregistré) pour juger de la mise en page, du texte libre et du filigrane

Tant qu'aucun modèle par défaut n'est choisi, la section « Fichiers joints » de la fiche affiche le message « Aucun modèle de document sélectionné : choisissez un modèle par défaut dans les paramètres du module » et la génération est impossible.

Si aucun document n'a sa génération PDF activée, le bloc affiche simplement « Aucun document avec la génération PDF activée ».

5.RÉSUMÉ DE LA CASCADE DES RÉGLAGES

Réglage	Effet quand il est désactivé
Activé	Rien n'apparaît sur la fiche native (ni section, ni onglet, ni bouton)
Génération PDF + Fichiers joints	Onglet accessible mais sans encadré de génération ; document absent du bloc Modèles de documents
Envoi par email	Pas de bouton « Envoyer par email »

05. BONS DE PRÉLÈVEMENT ET DE VIREMENT

Bordereau de prélèvement / virement

Les bons de prélèvement (module Prélèvement) et les bons de virement (module Virement, paiement par virement) partagent la même fiche dans Dolibarr : Banque | Caisse > Prélèvements (ou Virements) > Bons de prélèvement. InfraSFiles y ajoute la génération d'un bordereau, document récapitulatif à transmettre au tiers prélevé ou au bénéficiaire du virement.

1.CONTENU DU BORDEREAU (MODÈLE « bordereau »)

En-tête

• Logo ou raison sociale de votre société, titre « Bordereau de prélèvement » ou « Bordereau de virement » selon la nature du bon.
• Référence du bon, date, nombre de lignes.

Blocs d'identification

Bon de prélèvement	Bon de virement
Créancier : votre société	Donneur d'ordre : votre société
Débiteur : le tiers prélevé (ou sa maison mère, voir le point 2)	Bénéficiaire : le tiers payé (ou sa maison mère)

Le bloc débiteur / bénéficiaire reprend le nom, le code, l'adresse et les coordonnées bancaires : IBAN, BIC et RUM (référence unique de mandat). Le RIB imprimé est celui réellement utilisé par la ligne du bon, à défaut le RIB par défaut du tiers. Quand le PDF n'est pas adressé à la maison mère mais que le tiers en a une, la mention « Maison mère : X » est ajoutée.

Tableau des lignes

Colonne	Contenu
Document	Référence de la facture client, de la facture fournisseur ou du salaire concerné
Date	Date du document
Échéance	Date d'échéance du document
Tiers	Tiers facturé (utile quand le PDF regroupe plusieurs tiers sous une maison mère). Si les lignes d'un même PDF utilisent des IBAN différents, l'IBAN de chaque ligne est imprimé sous le nom du tiers
Statut	Statut natif de la ligne : En attente, Débité (ou Crédité pour un virement), Rejeté. Les lignes rejetées sont imprimées en rouge
Montant	Montant prélevé ou viré

Sous chaque facture, une sous-ligne grise « Avoir XXX : -montant » est ajoutée pour chaque avoir appliqué à cette facture.

Pied du tableau

• Total du bon.
• Si des lignes ont été rejetées : mention « dont N ligne(s) rejetée(s) : montant » sous le total.
• Texte libre de pied de page et filigrane « brouillon » si configurés (voir le chapitre Configuration du module).

2.DÉCOUPAGE DES PDF : UN PDF PAR TIERS OU PAR MAISON MÈRE

Un bon de prélèvement contient généralement des lignes de plusieurs tiers. Le module ne produit donc pas un seul PDF pour le bon, mais un PDF par destinataire, selon l'option « Découpage des PDF » des paramètres :

Valeur	Comportement
Un PDF par tiers (valeur par défaut)	Chaque tiers reçoit un PDF regroupant toutes ses factures présentes dans le bon. Sa maison mère éventuelle n'est mentionnée qu'à titre d'information
Un PDF par maison mère	Les tiers qui ont une maison mère renseignée sur leur fiche et l'attribut « Adresser les bordereaux de prélèvement / virement à la maison mère » coché sont regroupés dans un seul PDF adressé à la maison mère (une facture par ligne, avec le nom du tiers facturé). Tout autre tiers garde son propre PDF. Une maison mère qui a elle-même des factures dans le bon obtient un seul PDF

Exemple

Un bon contient les factures de 10 tiers rattachés à la même maison mère, dont 8 ont coché l'attribut. En mode « Un PDF par maison mère », le module produit 3 PDF : un pour la maison mère (avec les factures des 8 tiers), plus un pour chacun des 2 tiers restants.

L'attribut « Adresser les bordereaux à la maison mère »

Cet attribut supplémentaire (case à cocher) est créé automatiquement sur les fiches tiers à l'activation du module. Il est visible tant que le module est actif et n'est jamais supprimé à la désactivation, pour conserver les choix faits. Il se coche sur la fiche du tiers, à côté du champ natif Maison mère. Sans maison mère renseignée, l'attribut est sans effet.

Le regroupement ne se fait que sur un niveau : la maison mère directe du tiers. Une maison mère de maison mère n'est pas prise en compte.

3.NOMS DES FICHIERS

Chaque PDF est nommé <référence du bon>-<code client ou fournisseur du destinataire>.pdf, par exemple PREL2609-00012-CU2401-0042.pdf. Si le destinataire n'a pas de code, le suffixe ID<identifiant> est utilisé. Tous les PDF d'un bon apparaissent dans la section « Fichiers joints » de sa fiche et sont conservés dans le répertoire documents/infrasfiles/widthdraw/<référence du bon>/.

4.GÉNÉRER UN BORDEREAU

1. Ouvrez la fiche du bon de prélèvement ou de virement
2. Descendez jusqu'à la section « Fichiers joints », placée sous les boutons d'action
3. Choisissez le modèle (« bordereau », ou « InfraSPlus_Bon » avec InfraSPackPlus) et la langue
4. Cliquez sur « Générer » : un PDF par tiers ou par maison mère est créé et listé dans la section

Le détail de la section, de l'onglet « Fichiers joints » et de l'envoi par email est décrit dans les chapitres suivants.

5.MODÈLE « InfraSPlus_Bon »

Quand le module InfraSPackPlus est installé, un second modèle « InfraSPlus_Bon » apparaît dans le bloc Modèles de documents. Il imprime exactement le même contenu que « bordereau » mais avec la mise en page, les couleurs et les options d'InfraSPackPlus (en-têtes, adresses, mentions, pied de page…), pour une présentation homogène avec vos autres documents. Il se choisit et se met par défaut depuis la page des paramètres d'InfraSFiles.

06. INVENTAIRES

Feuille de comptage d'inventaire

Les inventaires du module Stock (Produits | Services > Inventaires) n'ont pas de document natif. InfraSFiles y ajoute une feuille de comptage : un document à imprimer pour relever les quantités physiquement en stock, zone par zone, avant de saisir le résultat dans Dolibarr.

1.CONTENU DE LA FEUILLE DE COMPTAGE (MODÈLE « comptage »)

En-tête

• Logo ou raison sociale, titre « Feuille de comptage ».
• Référence et libellé de l'inventaire, entrepôt, date, statut.
• Filtres de l'inventaire repris tels quels : catégories de produits et produit, s'ils ont été renseignés à la création de l'inventaire.

Corps : les références regroupées par zone

Les lignes de l'inventaire sont regroupées sous une bande par zone de stockage, qui indique le nom de la zone et le nombre de références qu'elle contient. À l'intérieur d'une zone, les lignes sont triées par référence produit puis par lot. Les produits sans zone sont regroupés en fin de feuille sous la bande « Sans zone ».

Colonne	Affichée	Contenu
Référence	Toujours	Référence du produit
Libellé	Toujours	Libellé du produit
Entrepôt	Seulement si l'inventaire porte sur plusieurs entrepôts	Entrepôt de la ligne
Lot / série	Seulement si des produits à lots ou numéros de série sont présents	Numéro de lot ou de série
Stock physique	Seulement si l'option « Afficher la quantité théorique » est activée	Quantité connue de Dolibarr au moment de la génération
Quantité relevée	Toujours	Case vide à remplir à la main lors du comptage

La quantité théorique est masquée par défaut pour favoriser un comptage « à l'aveugle » : la personne qui compte n'est pas influencée par la valeur attendue.

Fin de feuille

• Zone « Compté par / Date / Signature » pour tracer qui a réalisé le comptage.
• Texte libre de pied de page et filigrane « brouillon » si configurés.

2.LES ZONES DE STOCKAGE : LIEN AVEC INFRASWORKFLOW

Le regroupement par zone n'est pas une option d'InfraSFiles : la feuille de comptage suit la configuration de la colonne « Zone » de la page de saisie des inventaires, fournie par le module InfraSWorkflow (section Gestion des inventaires de ses paramètres). Ainsi, la feuille imprimée et l'écran de saisie montrent toujours les mêmes zones, dans le même ordre.

Source de la zone (réglage InfraSWorkflow)	Ordre des zones sur la feuille
Attribut supplémentaire du produit (de type liste)	Ordre des valeurs de la liste, tel que défini dans l'attribut
Sous-catégories d'une catégorie de localisation	Ordre de création des sous-catégories (ordre chronologique)

Les valeurs inconnues (par exemple un attribut de type texte, ou une valeur retirée de la liste) sont placées après les zones connues, par ordre alphabétique ; les lignes sans zone viennent en dernier.

Sans le module InfraSWorkflow, ou si la colonne « Zone » y est désactivée, la feuille de comptage est générée sans regroupement : toutes les références sont listées à la suite, sans erreur.

3.GÉNÉRER UNE FEUILLE DE COMPTAGE

La section « Fichiers joints » est disponible sur deux pages de l'inventaire :

• la fiche de l'inventaire (onglet principal) ;
• la page de saisie des lignes (onglet Inventaire), sous le tableau des lignes : pratique pour imprimer la feuille puis saisir les quantités relevées au même endroit.

1. Ouvrez l'inventaire
2. Descendez jusqu'à la section « Fichiers joints »
3. Choisissez le modèle (« comptage », ou « InfraSPlus_INV » avec InfraSPackPlus) et la langue
4. Cliquez sur « Générer »
5. Imprimez la feuille, effectuez le comptage, puis saisissez les quantités relevées dans l'onglet Inventaire

Le fichier est nommé <référence de l'inventaire>.pdf et conservé dans documents/infrasfiles/inventory/<référence>/. Regénérer la feuille remplace le fichier précédent.

4.MODÈLE « InfraSPlus_INV »

Avec InfraSPackPlus, un second modèle « InfraSPlus_INV » propose le même contenu avec la mise en page et les options d'InfraSPackPlus. Il se choisit depuis le bloc Modèles de documents des paramètres d'InfraSFiles.

07. UTILISATION SUR LES FICHES

Génération et onglet Fichiers joints

Ce chapitre décrit ce que voit l'utilisateur sur la fiche native d'un objet pris en charge, une fois le document activé avec la « Génération PDF + Fichiers joints » dans les paramètres. Le fonctionnement est volontairement identique à celui des factures ou des devis de Dolibarr.

1.LA SECTION « FICHIERS JOINTS » EN BAS DE FICHE

Elle est insérée juste sous les boutons d'action de la fiche (Valider, Modifier, Supprimer…). Elle contient :

• une liste déroulante des modèles activés dans les paramètres, avec le modèle par défaut présélectionné ;
• une liste déroulante de la langue du document ;
• le bouton « Générer » ;
• la liste des fichiers déjà présents pour cet objet : nom, taille, date, icône de téléchargement et icône de suppression (corbeille).

Un clic sur « Générer » crée le ou les PDF (un par tiers ou par maison mère pour un bon de prélèvement, un seul pour un inventaire) et les ajoute à la liste. Générer de nouveau avec le même modèle remplace les fichiers portant le même nom.

La section n'apparaît que si l'utilisateur dispose du droit de lecture natif de l'objet. Le bouton « Générer » et la corbeille exigent le droit de création / modification natif.

Documents brouillon

Tant que l'objet est au statut brouillon, le PDF porte le filigrane configuré dans les paramètres (s'il est renseigné). Une fois l'objet validé, il suffit de regénérer le document pour obtenir une version sans filigrane.

2.L'ONGLET « FICHIERS JOINTS »

Un onglet « Fichiers joints » est ajouté en haut de la fiche, avec un badge indiquant le nombre de fichiers. Il est visible si le document est activé dans les paramètres et si l'utilisateur a le droit de lecture natif de l'objet. Il se comporte comme l'onglet des factures :

• rappel de la référence, du nombre de fichiers et de leur taille totale ;
• encadré de génération (modèle, langue, Générer), sauf si la « Génération PDF + Fichiers joints » est désactivée ;
• ajout manuel d'un fichier (déposer un scan, un justificatif…) ;
• ajout d'un lien (URL externe) ;
• liste de tous les fichiers et liens, avec téléchargement et suppression.

Les fichiers déposés à la main sont stockés au même endroit que les PDF générés et sont proposés en pièce jointe lors de l'envoi par email.

3.TÉLÉCHARGEMENT ET SÉCURITÉ DES FICHIERS

Chaque fichier est servi avec le contrôle d'accès natif de Dolibarr : le téléchargement exige le droit de lecture de l'objet auquel il appartient (bons de prélèvement ou stocks). Un lien de téléchargement copié et transmis à un utilisateur qui n'a pas ce droit répond « accès refusé ». Seule la permission « Télécharger TOUS les fichiers du module » (réservée aux administrateurs) passe outre.

4.EMPLACEMENT DES FICHIERS SUR LE SERVEUR

Document	Répertoire (sous le répertoire documents de Dolibarr)
Bons de prélèvement et de virement	infrasfiles/widthdraw/<référence du bon>/
Inventaires	infrasfiles/inventory/<référence de l'inventaire>/

Ces fichiers sont indexés dans le gestionnaire de documents (ECM) de Dolibarr comme les documents natifs, et suivent donc les sauvegardes habituelles du répertoire documents.

08. ENVOI PAR EMAIL

Envoi par email

Quand la ligne « Envoi par email » d'un document est activée dans les paramètres, InfraSFiles ajoute à la fiche native le bouton « Envoyer par email », avec l'écran d'envoi standard de Dolibarr.

1.LE BOUTON « ENVOYER PAR EMAIL »

Il apparaît parmi les boutons d'action de la fiche, pour les utilisateurs disposant du droit de création / modification natif de l'objet. Il ouvre l'écran d'envoi, positionné directement sur le formulaire.

2.L'ÉCRAN D'ENVOI

C'est le formulaire d'envoi natif de Dolibarr (le même que pour une facture), avec quelques comportements propres au module :

Élément	Comportement
Pièces jointes	Le dernier PDF généré est pré-attaché. Pour un bon de prélèvement découpé en plusieurs PDF (par tiers ou par maison mère), tous les PDF du bon sont attachés. Les fichiers déposés à la main peuvent être ajoutés depuis la liste
Destinataires proposés (bons)	La liste « Destinataires » propose les contacts des tiers présents dans les lignes du bon. Rien n'est pré-rempli dans le champ de saisie libre : l'utilisateur choisit
Destinataires proposés (inventaires)	Un inventaire n'a pas de tiers : la liste propose les utilisateurs de Dolibarr (si l'option « Autoriser l'envoi aux utilisateurs » est active dans la configuration des emails), sinon la saisie libre
Modèle de mail	La liste propose les modèles du type propre au document (« Bons de prélèvement et de virement » ou « Inventaires ») ainsi que les modèles « Tous ». Le modèle par défaut du type est présélectionné
Sujet	Pré-rempli par le modèle, par exemple « Bordereau de prélèvement / virement PREL2609-00012 »
Annuler	Retour à la page « Fichiers joints » de l'objet

Après l'envoi, Dolibarr affiche la confirmation habituelle et revient sur la fiche.

3.LES MODÈLES DE MAILS

À l'activation, le module crée un modèle d'email par document, dans la langue de l'utilisateur qui active le module :

Document	Libellé du modèle	Sujet	Contenu
Bons de prélèvement et de virement	Envoi d'un bordereau de prélèvement / virement	Bordereau de prélèvement / virement __REF__	Bonjour, Veuillez trouver ci-joint le bordereau de prélèvement / virement __REF__. Cordialement, __MYCOMPANY_NAME__
Inventaires	Envoi d'une feuille de comptage d'inventaire	Feuille de comptage d'inventaire __REF__	Bonjour, Veuillez trouver ci-joint la feuille de comptage de l'inventaire __REF__. Cordialement, __MYCOMPANY_NAME__

Ces modèles se modifient, se traduisent et se complètent dans :

Accueil > Configuration > Emails > Modèles d'emails

Les types « Bons de prélèvement et de virement » et « Inventaires » y sont ajoutés par le module dans la liste des types de modèles. Un modèle existant n'est jamais écrasé par une réactivation du module. Les substitutions habituelles de Dolibarr sont disponibles (__REF__, __MYCOMPANY_NAME__, __USER_FULLNAME__…).

4.L'ÉVÉNEMENT DANS L'AGENDA

Chaque envoi crée automatiquement un événement dans l'agenda de Dolibarr, rattaché à l'objet, comme pour l'envoi d'une facture :

• « Bon de prélèvement / virement envoyé par email »
• « Inventaire envoyé par email »

Ces événements automatiques peuvent être désactivés individuellement dans :

Accueil > Configuration > Agenda > Événements automatiques

5.VÉRIFIER QU'UN ENVOI A BIEN EU LIEU

• L'événement d'agenda est créé sur l'objet (onglet Événements de la fiche).
• En cas de doute sur les pièces jointes, le journal de Dolibarr (dolibarr.log en niveau DEBUG) trace chaque fichier attaché à l'envoi.

09. SAUVEGARDE ET RESTAURATION

Sauvegarde et restauration

Le bloc Sauvegarde / Restauration, en haut de la page Paramètres InfraS, permet d'enregistrer l'ensemble de la configuration d'InfraSFiles et de la remettre en place plus tard. Il n'est visible que pour les utilisateurs disposant de la permission Sauvegarder / Restaurer les paramètres du module.

1.SAUVEGARDE

1. Accédez à l'onglet Paramètres InfraS
2. Cliquez sur le bouton « Sauvegarder », en haut de la page
3. Une confirmation s'affiche indiquant que la sauvegarde est effectuée

Sauvegarde automatique

Une sauvegarde automatique est effectuée lors de la désactivation du module. Cela permet de conserver votre configuration même si vous désactivez temporairement le module, par exemple lors d'une mise à jour.

Éléments sauvegardés

• L'activation de chaque document et de ses fonctions (génération PDF, envoi par email)
• Les options de chaque document : découpage des PDF, texte libre, filigrane, affichage de la quantité théorique
• Le modèle de document par défaut de chaque document

Le fichier de sauvegarde est stocké dans le répertoire de données du module (documents/infrasfiles/sql/), un fichier par entité. Le lien du bloc permet de le télécharger pour le conserver ailleurs.

2.RESTAURATION

1. Accédez à l'onglet Paramètres InfraS
2. Cliquez sur le bouton « Restaurer », en haut de la page
3. Les paramètres sauvegardés sont restaurés
4. Rechargez la page (F5) pour voir le résultat

Restauration automatique

Une restauration automatique est effectuée lors de l'activation du module. Si le module a été désactivé puis réactivé, vos paramètres sont automatiquement remis en place.

Important : La restauration écrase les paramètres actuels par ceux de la sauvegarde.

3.CE QUI N'EST PAS CONCERNÉ

• Les fichiers PDF générés : ils restent dans le répertoire documents quoi qu'il arrive.
• Les modèles d'emails : gérés dans la configuration des emails de Dolibarr, jamais supprimés par le module.
• L'attribut « Adresser les bordereaux à la maison mère » et les valeurs cochées sur les tiers.
• La liste des modèles de documents activés (table native des modèles), conservée par Dolibarr lui-même.

4.RECOMMANDATIONS

• Effectuez une sauvegarde avant toute modification importante
• Effectuez une sauvegarde avant toute mise à jour du module
• Testez vos modifications sur un environnement de test si possible

10. COMPATIBILITÉ ET MODULES TIERS

Compatibilité

1.VERSIONS SUPPORTÉES

Dolibarr	18.0.0 à 24.x — la structure des fiches sur laquelle le module s'appuie a été vérifiée identique de la version 18 à la version 24
PHP	7.4 à 8.4
Base de données	MySQL / MariaDB / PostgreSQL (aucune syntaxe SQL propriétaire)
Multi-entités	Oui : paramètres, modèles par défaut, attribut tiers et fichiers sont propres à chaque entité

2.MODULES NATIFS

Module natif	Rôle pour InfraSFiles
Prélèvement ou Virement (paiement par virement)	Nécessaire au document « Bons de prélèvement et de virement ». L'un des deux suffit
Stock	Nécessaire au document « Inventaires »
Agenda	Enregistrement des événements « envoyé par email »
Emails (configuration)	Modèles d'emails et envoi
ECM / GED	Indexation des fichiers produits, comme pour les documents natifs

3.MODULES INFRAS COMPLÉMENTAIRES

InfraSPackPlus

Fournit deux modèles supplémentaires, listés et activables depuis la page des paramètres d'InfraSFiles :

• InfraSPlus_Bon : bordereau de prélèvement / virement avec la mise en page et les options d'InfraSPackPlus
• InfraSPlus_INV : feuille de comptage d'inventaire avec la mise en page et les options d'InfraSPackPlus

Documentation : wiki InfraSPackPlus

InfraSWorkflow

Détermine la zone de stockage utilisée pour regrouper les références sur la feuille de comptage (section Gestion des inventaires : colonne « Zone » alimentée par un attribut supplémentaire du produit ou par les sous-catégories d'une catégorie de localisation). Dépendance optionnelle : sans InfraSWorkflow, pas de regroupement, sans erreur.

Documentation : wiki InfraSWorkflow

4.POUR LES DÉVELOPPEURS : AJOUTER SES PROPRES OBJETS

InfraSFiles est conçu comme un socle. Un module tiers peut déclarer un nouvel objet à documenter, sans modifier InfraSFiles, grâce au hook infrasFilesRegisterObjects (contexte infrasfilesregistry). Le hook retourne, dans $this->results, une définition par objet avec notamment :

Clé	Rôle
label, picto	Libellé (clé de traduction) et picto affichés dans les paramètres
class, classpath	Classe fille de l'objet natif ajoutant la génération de document
parentclass, parentpath, table	Classe et table natives de l'objet
modelspath, docpart, dirout	Répertoire des modèles PDF, type de modèle, sous-répertoire de sortie des fichiers
tabcontext, hookcontext, cardurl	Accrochage de l'onglet et de la section sur la fiche native
needmodule	Modules natifs dont au moins un doit être actif
permread, permwrite	Droits natifs de lecture et d'écriture
mailtype, mailtopic, mailtemplate, trigger	Type de modèle de mail, sujet, modèle par défaut, déclencheur d'agenda
options	Options propres à l'objet, affichées automatiquement dans les paramètres (liste, texte, texte multiligne, interrupteur)

Un module tiers peut aussi se contenter de fournir un modèle PDF supplémentaire pour un objet déjà pris en charge : il suffit de déclarer models dans son descripteur et de placer le modèle dans core/modules/infrasfiles/<objet>/doc/ de son propre répertoire, comme le fait InfraSPackPlus. Le modèle est alors listé automatiquement dans les paramètres d'InfraSFiles.

Les tables natives de Dolibarr ne sont jamais modifiées : l'état documentaire (dernier modèle, dernier fichier) est mémorisé dans la table llx_infrasfiles_document, une ligne par objet et par entité.

11. DÉPANNAGE

Dépannage

1.LA SECTION « FICHIERS JOINTS » N'APPARAÎT PAS SUR LA FICHE

Causes possibles :

✓ Le document n'est pas activé

→ Vérifiez la ligne « Activé » puis la ligne « Génération PDF + Fichiers joints » du document dans Paramètres InfraS

✓ Le module natif n'est pas activé

→ La ligne du document est grisée avec « Nécessite l'activation d'un de ces modules » : activez Prélèvement ou Virement (bons), Stock (inventaires)

✓ L'utilisateur n'a pas le droit de lecture natif

→ Vérifiez les droits « Lire les bons de prélèvement » ou « Lire les stocks » de l'utilisateur

✓ Le module vient d'être mis à jour

→ Désactivez puis réactivez le module

2.MESSAGE « AUCUN MODÈLE DE DOCUMENT SÉLECTIONNÉ »

Causes possibles :

✓ Aucun modèle par défaut n'est défini

→ Dans Paramètres InfraS, bloc Modèles de documents, cliquez sur la colonne « Défaut » du modèle souhaité (il est activé automatiquement)

3.LE BOUTON « GÉNÉRER » OU LA CORBEILLE SONT ABSENTS

Causes possibles :

✓ L'utilisateur n'a pas le droit d'écriture natif

→ Le droit « Créer / modifier les bons de prélèvement » ou « Créer / modifier les stocks » est nécessaire pour générer et supprimer

4.« ACCÈS REFUSÉ » AU TÉLÉCHARGEMENT D'UN FICHIER

Causes possibles :

✓ L'utilisateur n'a pas le droit de lecture natif de l'objet

→ Chaque fichier est protégé par le droit de lecture de son objet (bons de prélèvement ou stocks). Attribuez ce droit, ou, pour un profil technique uniquement, la permission « Télécharger TOUS les fichiers du module »

5.LE BON DE PRÉLÈVEMENT NE PRODUIT PAS LE NOMBRE DE PDF ATTENDU

Causes possibles :

✓ Le découpage est réglé sur « Un PDF par tiers »

→ Chaque tiers reçoit son PDF, la maison mère n'est qu'une mention. Passez sur « Un PDF par maison mère » puis cliquez sur « Modifier »

✓ Le tiers n'a pas de maison mère renseignée, ou l'attribut n'est pas coché

→ Sur la fiche du tiers, renseignez le champ Maison mère et cochez « Adresser les bordereaux de prélèvement / virement à la maison mère ». Les deux conditions sont nécessaires

✓ Le regroupement attendu porte sur plusieurs niveaux

→ Seule la maison mère directe est prise en compte

6.LA FEUILLE DE COMPTAGE N'EST PAS REGROUPÉE PAR ZONE

Causes possibles :

✓ Le module InfraSWorkflow n'est pas activé, ou sa colonne « Zone » est désactivée

→ Activez InfraSWorkflow et configurez la colonne « Zone » dans sa section Gestion des inventaires (attribut produit ou catégorie de localisation)

✓ Les produits n'ont pas de zone renseignée

→ Ils sont listés sous la bande « Sans zone ». Renseignez l'attribut ou la sous-catégorie sur les fiches produits

7.LA QUANTITÉ THÉORIQUE N'APPARAÎT PAS SUR LA FEUILLE

Causes possibles :

✓ C'est le comportement par défaut

→ Activez l'option « Afficher la quantité théorique sur la feuille de comptage » dans les paramètres du document Inventaires, puis regénérez la feuille

8.L'EMAIL PART SANS PIÈCE JOINTE, OU SANS LE MODÈLE ATTENDU

Causes possibles :

✓ Aucun PDF n'a encore été généré

→ Générez le document depuis la section « Fichiers joints » avant de cliquer sur « Envoyer par email »

✓ Le modèle de mail n'a pas l'option « Joindre les fichiers »

→ Dans Configuration > Emails > Modèles d'emails, vérifiez l'option de jonction des fichiers du modèle utilisé

✓ Le modèle par défaut a été supprimé

→ Le module ne le recrée qu'à l'activation : désactivez / réactivez le module, ou recréez un modèle du type « Bons de prélèvement et de virement » ou « Inventaires »

9.LE FILIGRANE RESTE SUR LE DOCUMENT

Causes possibles :

✓ Le document a été généré alors que l'objet était encore brouillon

→ Le filigrane ne s'applique qu'aux brouillons : validez l'objet puis regénérez le PDF

10.MESSAGE « ERREUR CHANGELOG.XML » OU AVERTISSEMENT SUR L'EXTENSION XML

Causes possibles :

✓ L'extension PHP xml n'est pas chargée

→ Faites installer / activer l'extension xml sur le serveur (php-xml). Le module fonctionne, mais le numéro de version et le changelog ne peuvent pas être lus

11.AVERTISSEMENT À LA CONNEXION SUR LA VERSION DE DOLIBARR

Causes possibles :

✓ La version de Dolibarr dépasse la version maximale supportée par le module

→ Le module reste utilisable, sans garantie. Vérifiez sur le Dolistore ou auprès du support qu'une version plus récente du module est disponible

12.INFORMATIONS UTILES POUR LE SUPPORT

• Onglet À propos du module : versions de Dolibarr, du module, de PHP et du serveur web
• Journal dolibarr.log (Configuration > Journalisation) en niveau DEBUG au moment de la reproduction du problème
• Capture d'écran de la page Paramètres InfraS

12. CHANGELOG ET SUPPORT

Changelog et support

1.CHANGELOG / HISTORIQUE DES VERSIONS

Pour consulter l'historique complet des versions :

1. Aller dans : Outils > InfraS > InfraSFiles > Changelog / Support (ou l'onglet Changelog / Support de la page de configuration du module)
2. La version installée et l'historique des modifications s'affichent
3. Cliquer sur « Nouveau Changelog » pour télécharger le changelog de la dernière version disponible et savoir si une mise à jour existe

Numérotation des versions

Les versions sont de la forme X.Y.Z : X = version minimale de Dolibarr supportée (18), Y = ajout de fonctionnalités ou d'options, Z = corrections et ajustements.

2.PRINCIPALES ÉVOLUTIONS

Version	Date	Contenu
18.0.0	2026-09	Version initiale : socle générique (registre des objets, table de suivi documentaire), génération PDF, section et onglet « Fichiers joints », modèle « bordereau » pour les bons de prélèvement / virement, modèle « comptage » pour les inventaires, aperçu spécimen, texte libre et filigrane, envoi par email avec modèles de mails dédiés et événements d'agenda, statut des lignes sur le bordereau
18.0.1	2026-09	Corrections : activation de modèle rejouée (double clic / F5), ajout manuel de fichier et de lien depuis l'onglet, suppression d'un PDF limitée à l'objet de la fiche, contrôle d'accès aux fichiers, fond de page PDF, avertissement PHP sur l'onglet des inventaires ; infobulles d'aide sur les options
18.1.0	2026-09	Bons de prélèvement : découpage « un PDF par maison mère » avec l'attribut tiers « Adresser les bordereaux à la maison mère » (le découpage « par ligne » est retiré) ; bordereau adressé à la maison mère, colonne Échéance, avoirs appliqués, RIB réellement utilisé par la ligne. Inventaires : zone de stockage suivant la colonne « Zone » d'InfraSWorkflow (l'ancienne option d'attribut produit est retirée), filtres de l'inventaire dans l'en-tête, remontée des erreurs SQL

Après toute mise à jour : désactiver puis réactiver le module pour appliquer les changements de structure. Les paramètres sont sauvegardés et restaurés automatiquement.

3.MISE À JOUR DU MODULE

1. Sauvegardez les paramètres depuis Paramètres InfraS (facultatif, la désactivation le fait aussi)
2. Désactivez le module dans Configuration > Modules/Applications
3. Remplacez le contenu du dossier htdocs/custom/infrasfiles par la nouvelle version (ou redéployez l'archive)
4. Réactivez le module : la table, l'attribut tiers, les modèles de mails et les événements sont mis à jour, et les paramètres restaurés
5. Vérifiez la page Paramètres InfraS et regénérez un document de test

4.DEMANDE DE SUPPORT

• Email : support@infras.fr
• Site web : https://www.infras.fr
• Boutique : https://infras.store

Informations à fournir dans votre demande :

• Version de Dolibarr
• Version du module InfraSFiles (onglet À propos)
• Version PHP
• Document concerné (bon de prélèvement / virement, inventaire) et réglages du document dans les paramètres
• Description détaillée du problème et étapes pour le reproduire
• Captures d'écran si possible
• Messages d'erreur complets (écran et dolibarr.log)