View source for Odoo Payroll FR

<div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;">
<div style="width:100%;">
<h1>Odoo Payroll — Paie pour Dolibarr</h1>
<p><strong>Résumé :</strong> gestion des règles et structures salariales, contrats de paie et bulletins pour les utilisateurs internes de Dolibarr.<br><strong>Version du module :</strong> 1.0.0<br><strong>Version minimale de Dolibarr déclarée :</strong> 18.0<br><strong>Version minimale de PHP déclarée :</strong> 7.4<br><strong>Versions effectivement vérifiées :</strong> aucune version de Dolibarr ou PHP n’a été testée pendant cette vérification documentaire.<br><strong>Dernière vérification :</strong> 2026-09-29</p>
<p><strong>Site officiel de l’éditeur :</strong> [https://01consulting.eu 01 Consulting]</p>
<p><strong>Vidéo de démonstration :</strong></p>
<youtube width="560" height="315">aeqG94iA8yQ</youtube>

<h2>1. Présentation</h2>
<p>Odoo Payroll est un module de paie natif pour Dolibarr, développé par 01 Consulting. Malgré son nom, il s’installe dans Dolibarr et ne nécessite pas d’instance Odoo. Il permet de configurer les catégories et règles de salaire, de les réunir dans des structures, de rattacher ces structures à des contrats d’employés et de calculer des bulletins de paie.</p>
<p>Le moteur fournit un cadre de calcul configurable ; il ne fournit pas une garantie de conformité à une législation, à une convention collective ou à un barème fiscal ou social. Les règles CNAS, IRG et autres obligations applicables doivent être conçues et approuvées par un spécialiste de la paie avant utilisation en production.</p>

<h2>2. Fonctionnalités</h2>
<ul>
<li>Catégories de règles salariales, éventuellement hiérarchisées.</li>
<li>Structures salariales composées de règles et pouvant hériter d’une structure parente.</li>
<li>Règles conditionnelles à montant fixe, en pourcentage ou exprimées par une formule arithmétique contrôlée.</li>
<li>Contrats associés aux utilisateurs Dolibarr, avec salaire, heures hebdomadaires, période, type et département.</li>
<li>Calcul des lignes de bulletin, du brut et du net, avec validation et états de suivi.</li>
<li>Création individuelle de bulletins et génération en série à partir d’un lot.</li>
<li>Retour d’un bulletin validé au brouillon, annulation des bulletins validés et actions de masse, selon les permissions et réglages.</li>
<li>Génération d’un PDF de bulletin et association avec le paiement de salaire natif de Dolibarr.</li>
<li>Onglet Paie dans la fiche utilisateur, profils d’import et filtrage des données par entité active.</li>
</ul>

<h2>3. Prérequis et compatibilité</h2>
<ul>
<li><strong>Dolibarr :</strong> le descripteur déclare Dolibarr 18.0 comme version minimale. La version réellement vérifiée dans le cadre de ce wiki est « aucune ».</li>
<li><strong>PHP :</strong> le descripteur déclare PHP 7.4 comme version minimale ; aucune exécution n’a été testée pendant la rédaction.</li>
<li><strong>Modules Dolibarr requis :</strong> Utilisateurs (<code>modUser</code>) et Salaires (<code>modSalaries</code>).</li>
<li><strong>Base de données :</strong> l’initialisation crée des triggers avec une syntaxe MySQL/MariaDB. La compatibilité des triggers avec d’autres moteurs SQL n’est pas établie. Le compte de base de données doit pouvoir créer et supprimer des triggers.</li>
<li><strong>Documents :</strong> le processus de génération doit pouvoir créer des fichiers dans le répertoire de sortie du module sous les documents Dolibarr.</li>
</ul>

<h2>4. Installation, mise à jour et désactivation</h2>
<h3>4.1. Installation et activation</h3>
<ol>
<li>Vérifier que les modules Dolibarr <strong>Utilisateurs</strong> et <strong>Salaires</strong> sont disponibles.</li>
<li>Installer le dossier du module dans <code>htdocs/custom/payroll</code> ou dans le répertoire personnalisé configuré pour les modules externes.</li>
<li>Dans Dolibarr, ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>, rechercher <strong>Payroll</strong> ou <strong>Paie</strong>, puis activer le module.</li>
<li>À l’activation, le module charge ses tables SQL, complète certaines colonnes de contrat manquantes, ajoute le champ supplémentaire de liaison bulletin-salaire et tente de créer trois triggers sur les tables de salaires.</li>
<li>Vérifier que le menu <strong>RH &gt; Paie</strong> apparaît et que la page de configuration s’ouvre. Avant un traitement réel, réaliser un calcul complet avec des données de test et vérifier les PDF ainsi que les triggers de paiement.</li>
</ol>
<p>L’activation met également en place les menus, les droits et les profils d’import. Si la création des triggers échoue, les changements d’état automatiques liés au paiement ne fonctionneront pas correctement ; consulter l’erreur de base de données et les journaux Dolibarr.</p>

<h3>4.2. Mise à jour</h3>
<ol>
<li>Sauvegarder la base Dolibarr et les documents avant de remplacer les fichiers du module.</li>
<li>Installer les fichiers de la nouvelle version. Réactiver le module si l’initialisation des tables, des colonnes supplémentaires ou des triggers doit être rejouée.</li>
<li>Contrôler les catégories, règles, contrats et bulletins existants ainsi que les triggers sur les tables de salaires.</li>
<li>Générer un bulletin de test, ouvrir son PDF et vérifier le chemin d’enregistrement et les permissions utilisateur.</li>
</ol>
<p>Le script d’activation vérifie et ajoute certaines colonnes de contrat et rend obligatoire la catégorie des règles après avoir essayé d’affecter une catégorie aux règles orphelines. Les migrations détaillées dépendent de la version précédente et du schéma déjà installé ; une sauvegarde est nécessaire avant l’opération.</p>

<h3>4.3. Désactivation et suppression</h3>
<p>La désactivation masque le champ supplémentaire de liaison sur les salaires et supprime les trois triggers créés par le module. Le traitement de désactivation ne supprime pas les tables de paie. Le comportement d’une suppression manuelle des tables ou du dossier du module n’est pas établi ; ne pas supprimer ces données sans sauvegarde et procédure de migration définie.</p>

<h2>5. Configuration</h2>
<p>Ouvrir la page <strong>Configuration</strong> du module depuis Dolibarr. L’accès est réservé aux administrateurs ou aux utilisateurs disposant du droit <code>payroll-&gt;setup</code>. Les valeurs indiquées ci-dessous sont les valeurs initiales déclarées par le module ou les replis utilisés par l’écran ; une valeur déjà enregistrée dans une entité peut être différente.</p>
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;">
<tr><th style="padding:8px;border:1px solid #dee2e6;">Réglage</th><th style="padding:8px;border:1px solid #dee2e6;">Initialisation ou repli</th><th style="padding:8px;border:1px solid #dee2e6;">Effet</th></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Numérotation des bulletins</td><td style="padding:8px;border:1px solid #dee2e6;">Modèle standard ; masque déclaré <code>PSL{00000}</code>. L’écran utilise <code>PAY{00000}</code> comme valeur de repli si aucun masque n’est enregistré.</td><td style="padding:8px;border:1px solid #dee2e6;">Définit la référence générée pour les bulletins. Contrôler la valeur dans l’écran après installation.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Numérotation des contrats</td><td style="padding:8px;border:1px solid #dee2e6;">Modèle standard, masque <code>CTR{00000}</code>.</td><td style="padding:8px;border:1px solid #dee2e6;">Définit la référence des contrats.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_ALLOW_CANCEL_CONFIRMED_PAYSLIPS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Désactivé (<code>0</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Autorise le retour au brouillon et l’annulation d’un bulletin validé.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_CONFIRM_PAYSLIPS_WITHOUT_RECOMPUTING</code></td><td style="padding:8px;border:1px solid #dee2e6;">Activé (<code>1</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Empêche le recalcul automatique lors de la validation. Quand l’option est désactivée, la validation recalcule le bulletin.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_ALLOW_EDIT_PAYSLIP_LINES</code></td><td style="padding:8px;border:1px solid #dee2e6;">Désactivé (<code>0</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Autorise, si activé, la modification manuelle de certains champs des lignes d’un brouillon.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Compte bancaire par défaut</td><td style="padding:8px;border:1px solid #dee2e6;">Aucun.</td><td style="padding:8px;border:1px solid #dee2e6;">Valeur proposée dans le parcours de paiement ; le réglage est affiché si le module Banque est activé.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Mode de paiement par défaut</td><td style="padding:8px;border:1px solid #dee2e6;">Aucun.</td><td style="padding:8px;border:1px solid #dee2e6;">Mode proposé dans le parcours de paiement des salaires.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Types de contrat et départements</td><td style="padding:8px;border:1px solid #dee2e6;">Dictionnaires gérés dans la configuration.</td><td style="padding:8px;border:1px solid #dee2e6;">Ajoutez des codes et libellés actifs ; une entrée utilisée par un contrat ne peut pas être supprimée.</td></tr>
</table>
<p>Les masques de référence doivent contenir au moins quatre zéros entre accolades, par exemple <code>PAY{00000}</code>. Les modèles de numérotation disponibles peuvent être sélectionnés dans l’écran. Les constantes de configuration sont enregistrées pour l’entité Dolibarr courante.</p>

<h2>6. Préparer la configuration de paie</h2>
<h3>6.1. Catégories</h3>
<ol>
<li>Dans <strong>RH &gt; Paie &gt; Catégories de règles salariales</strong>, créer une catégorie avec un code et un libellé.</li>
<li>Choisir éventuellement une catégorie parente pour organiser la hiérarchie.</li>
<li>Activer ou désactiver la catégorie selon son usage.</li>
</ol>
<p>Les codes sont utilisés dans les formules comme des variables de total préfixées par <code>CAT_</code>, par exemple <code>CAT_BASIC</code>. Un code utilisable dans une formule doit suivre les caractères acceptés par l’écran et les profils d’import.</p>

<h3>6.2. Structures salariales</h3>
<ol>
<li>Dans <strong>Structures</strong>, créer une structure avec une référence et un libellé.</li>
<li>Associer les règles à la structure et définir leur ordre de séquence.</li>
<li>Si nécessaire, choisir une structure parente. Le moteur récupère les règles liées à la structure et à sa chaîne de structures parentes.</li>
<li>Enregistrer la structure, puis l’affecter à un contrat.</li>
</ol>
<p>Une structure référencée par un contrat ou par une structure enfant est protégée contre la suppression par les contrôles du module.</p>

<h3>6.3. Règles de salaire et calcul</h3>
<p>Une règle possède un code, un libellé, une catégorie, un numéro de séquence, une condition et un type de calcul. Seules les règles actives liées à la structure sont chargées. Le calcul s’effectue par séquence croissante ; les règles déjà calculées sont accessibles sous leur code dans les règles suivantes.</p>
<ul>
<li><strong>Condition toujours vraie :</strong> applique la règle sans condition supplémentaire.</li>
<li><strong>Plage :</strong> compare le salaire aux bornes minimale et maximale configurées ; les bornes sont inclusives.</li>
<li><strong>Expression :</strong> évalue une condition comme <code>WAGE &gt;= 90000</code>.</li>
<li><strong>Montant fixe :</strong> montant configuré multiplié par l’expression de quantité ; la quantité par défaut dans les données du modèle est <code>1</code>.</li>
<li><strong>Pourcentage :</strong> applique un taux à une expression de base ; un pourcentage négatif peut représenter une retenue.</li>
<li><strong>Formule :</strong> évalue une expression arithmétique configurée.</li>
<li><strong>Afficher sur le bulletin :</strong> détermine si la ligne correspondante apparaît sur le PDF.</li>
</ul>
<p>Le moteur accepte les nombres, variables, parenthèses et opérateurs <code>+ - * /</code>. Les opérateurs de comparaison <code>&gt;</code>, <code>&gt;=</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>==</code> et <code>!=</code> sont acceptés dans une condition. Il n’exécute ni PHP ni Python ni des fonctions arbitraires. Une variable inconnue, un opérateur invalide ou une division par zéro interrompt le calcul avec une erreur.</p>
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;">
<tr><th style="padding:8px;border:1px solid #dee2e6;">Variable</th><th style="padding:8px;border:1px solid #dee2e6;">Valeur utilisée</th><th style="padding:8px;border:1px solid #dee2e6;">Exemple</th></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE</code></td><td style="padding:8px;border:1px solid #dee2e6;">Salaire du contrat associé au bulletin.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE</code></td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WORK_HOURS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Heures hebdomadaires du contrat.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE / WORK_HOURS</code></td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WORKED_DAYS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Nombre de jours travaillés indiqué sur le bulletin.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE * WORKED_DAYS / MONTH_DAYS</code></td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>MONTH_DAYS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Nombre de jours du lundi au vendredi dans la période du bulletin.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WORKED_DAYS / MONTH_DAYS</code></td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Codes de règles antérieures</td><td style="padding:8px;border:1px solid #dee2e6;">Montant calculé par une règle précédente dans l’ordre de séquence.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>BASIC + PRIME</code></td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>CAT_CODE</code></td><td style="padding:8px;border:1px solid #dee2e6;">Total calculé pour une catégorie ; un total vide commence à zéro.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>CAT_BASIC + CAT_ALW + CAT_DED</code></td></tr>
</table>
<p><code>MONTH_DAYS</code> ne retire pas les jours fériés : seuls les samedis et dimanches sont exclus. Les exemples de formules sont des exemples de syntaxe et ne constituent pas des recommandations de barème.</p>
<p>Le brut et le net sont alimentés à partir des règles portant les codes <code>GROSS</code> et <code>NET</code>. Si ces règles ne fournissent pas les totaux, le moteur utilise les catégories portant ces codes comme solution de repli.</p>

<h3>6.4. Contrats</h3>
<ol>
<li>Dans <strong>Contrats</strong>, créer un contrat pour un utilisateur interne Dolibarr.</li>
<li>Renseigner la structure, le salaire, le nombre d’heures hebdomadaires, la date de début et, si applicable, la date de fin.</li>
<li>Choisir éventuellement un type de contrat et un département dans les dictionnaires configurés.</li>
<li>Enregistrer et activer le contrat lorsqu’il doit être proposé pour la génération d’un lot.</li>
</ol>
<p>Un contrat doit avoir un employé et une date de début. Les formulaires et classes du module empêchent de supprimer certains objets encore référencés, notamment un contrat associé à des bulletins.</p>

<h2>7. Gérer les bulletins de paie</h2>
<h3>7.1. Créer et calculer un bulletin individuel</h3>
<ol>
<li>Ouvrir <strong>RH &gt; Paie &gt; Bulletins salariés</strong>, puis créer un bulletin.</li>
<li>Sélectionner l’employé, son contrat, la période et le nombre de jours travaillés. La création d’un bulletin nécessite le droit <code>payroll-&gt;write</code>.</li>
<li>Enregistrer le bulletin ; il commence au statut <strong>Brouillon</strong>.</li>
<li>Cliquer sur <strong>Calculer</strong>. Le calcul exige un contrat et une structure salariale disponible. Si la structure n’est pas encore enregistrée sur le bulletin, celle du contrat lui est affectée.</li>
<li>Contrôler les lignes, le brut et le net. Tant que le bulletin est brouillon, corriger la configuration ou les données, puis recalculer.</li>
<li>Valider avec un utilisateur disposant du droit <code>payroll-&gt;validate</code>. Vérifier le résultat avant validation, car le réglage initial empêche le recalcul pendant cette étape.</li>
</ol>
<p>En cas de période inversée, de contrat ou structure manquant, de variable inconnue ou d’expression invalide, le calcul affiche une erreur et ne doit pas être considéré comme terminé.</p>

<h3>7.2. Générer des bulletins par lot</h3>
<ol>
<li>Ouvrir <strong>RH &gt; Paie &gt; Lots de bulletins</strong> et créer un lot avec un libellé et une période valide.</li>
<li>Sur la fiche du lot, lancer <strong>Générer</strong>. Le module sélectionne les contrats actifs ayant une structure, dont les dates couvrent tout ou partie de la période du lot, et pour lesquels le lot ne contient pas encore de bulletin.</li>
<li>Le module crée un brouillon par contrat éligible avec <strong>22 jours travaillés</strong>, puis tente de calculer les bulletins brouillons du lot. Vérifier et corriger les jours travaillés lorsque la situation réelle diffère.</li>
<li>Examiner les erreurs de calcul et corriger les contrats, structures ou règles concernés avant de valider.</li>
<li>Valider les bulletins du lot. L’action est refusée si aucun brouillon n’est présent ou si un brouillon n’a aucune ligne calculée. Lorsque la validation réussit, le lot passe à l’état fermé.</li>
</ol>
<p>Une génération répétée dans le même lot n’ajoute pas un second bulletin pour un contrat déjà présent dans ce lot. Cette vérification porte sur le contrat et le lot ; elle ne constitue pas une protection générale contre deux lots couvrant la même période.</p>

<h3>7.3. États, retour au brouillon et annulation</h3>
<ul>
<li><strong>Brouillon (0) :</strong> calculable et supprimable individuellement ; les lignes peuvent être modifiées si <code>PAYROLL_ALLOW_EDIT_PAYSLIP_LINES</code> est activé.</li>
<li><strong>Validé (1) :</strong> état obtenu après validation. L’action de validation peut recalculer ou non selon le réglage mentionné ci-dessus.</li>
<li><strong>Payé (2) :</strong> état associé au paiement Dolibarr lorsque le bulletin est relié au salaire correspondant.</li>
<li><strong>Annulé (9) :</strong> état de bulletin annulé.</li>
</ul>
<p>Avec <code>PAYROLL_ALLOW_CANCEL_CONFIRMED_PAYSLIPS</code> activé, un utilisateur ayant le droit de validation peut ramener un bulletin validé au brouillon, l’annuler, et utiliser l’action de masse <strong>Retourner au brouillon</strong> dans la liste des bulletins. L’action de masse ne traite que les bulletins validés sélectionnés. Le code de l’action individuelle ne vérifie que le droit et le réglage avant de changer l’état ; contrôler le bulletin et son éventuel salaire lié avant de l’utiliser.</p>
<p>Un bulletin payé ne doit pas être traité comme un bulletin validé ordinaire : la synchronisation du salaire peut modifier son état et le lot ne peut pas être rouvert ou supprimé s’il contient des bulletins payés. La suppression individuelle d’un bulletin est réservée aux brouillons et supprime aussi ses lignes de calcul.</p>

<h3>7.4. Rouvrir ou supprimer un lot</h3>
<p>Un lot fermé peut être rouvert par un utilisateur ayant le droit de validation si aucun de ses bulletins n’est payé. La réouverture remet les bulletins validés du lot au brouillon. La suppression d’un lot par un utilisateur ayant le droit de suppression supprime le lot, ses bulletins et leurs lignes ; elle est refusée en présence d’un bulletin payé. Cette suppression est définitive : vérifier la liste affichée dans la confirmation avant de poursuivre.</p>

<h2>8. Fiche employé, paiement et PDF</h2>
<h3>8.1. Onglet Paie de l’employé</h3>
<p>Le module ajoute un onglet <strong>Paie</strong> à la fiche utilisateur. Un utilisateur ayant le droit de lecture Paie peut consulter l’onglet ; l’employé peut également ouvrir sa propre fiche. L’onglet liste ses contrats et bulletins. Les boutons de création sont conditionnés par le droit d’écriture <code>payroll-&gt;write</code>. La page applique le filtrage de l’entité Dolibarr courante.</p>

<h3>8.2. Lier un bulletin au paiement natif Dolibarr</h3>
<p>Lors de l’activation, le module ajoute un champ supplémentaire au salaire Dolibarr pour sélectionner un bulletin payé du même employé. Une contrainte empêche de rattacher le même bulletin à plusieurs salaires. Le trigger SQL synchronise l’état du bulletin lié lorsque la valeur « payé » du salaire change : il passe le bulletin validé à payé lorsque le salaire est marqué payé, et le remet à validé lorsque le salaire est marqué non payé.</p>
<p>Le trigger Dolibarr associé à la création d’un paiement de salaire met également le bulletin lié au statut payé. Ces automatismes dépendent de la présence du champ supplémentaire, du lien sélectionné et des triggers installés avec succès.</p>

<h3>8.3. Générer et consulter le PDF</h3>
<ol>
<li>Ouvrir la fiche du bulletin et lancer la génération du document.</li>
<li>Le module produit un PDF A4 qui présente la société, l’employé, le statut, le contrat, la structure, la période, les jours travaillés, les lignes visibles et les totaux brut/net.</li>
<li>Les règles marquées « afficher sur le bulletin » sont incluses ; les autres règles sont omises du tableau détaillé.</li>
<li>Le PDF est enregistré sous le répertoire de sortie du module pour l’entité courante, ou, à défaut, dans <code>DOL_DATA_ROOT/payroll</code>, dans un dossier portant la référence du bulletin. La fiche permet ensuite de l’afficher ou de le télécharger.</li>
</ol>
<p>Une nouvelle génération écrit le PDF à la même référence de bulletin. Les documents existants ne sont pas automatiquement supprimés lors des changements d’état.</p>

<h2>9. Menus, permissions et visibilité</h2>
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;">
<tr><th style="padding:8px;border:1px solid #dee2e6;">Droit Dolibarr</th><th style="padding:8px;border:1px solid #dee2e6;">Usage</th></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;read</code></td><td style="padding:8px;border:1px solid #dee2e6;">Consulter le tableau de bord, les bulletins, lots et documents, accéder à l’aide ; permet l’accès en lecture à plusieurs listes.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;setup</code></td><td style="padding:8px;border:1px solid #dee2e6;">Configurer les catégories, règles, structures, contrats et paramètres. Les administrateurs ont également accès à la configuration.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;write</code></td><td style="padding:8px;border:1px solid #dee2e6;">Créer et modifier les bulletins, contrats et lots selon les contrôles de chaque écran ; lancer des calculs.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;validate</code></td><td style="padding:8px;border:1px solid #dee2e6;">Valider les bulletins ; selon le réglage, remettre en brouillon ou annuler les bulletins validés ; valider/réouvrir les lots.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;delete</code></td><td style="padding:8px;border:1px solid #dee2e6;">Supprimer les enregistrements autorisés par leur état et leurs dépendances.</td></tr>
</table>
<p>Les menus de catégories, règles, structures et contrats sont rattachés au menu <strong>RH &gt; Paie</strong> et conditionnés au droit de configuration. Les accès aux bulletins et lots requièrent la lecture ; la création est réservée aux droits correspondants. Les droits natifs Dolibarr sur les utilisateurs et salaires restent également pertinents.</p>

<h2>10. Données, imports, triggers et journaux</h2>
<ul>
<li><strong>Données stockées :</strong> catégories, règles, structures, associations entre structures et règles, contrats, bulletins, lignes de calcul et lots dans des tables propres au module ; liaison du bulletin sur l’extrafield de l’objet Salaire.</li>
<li><strong>Imports :</strong> des profils d’import sont déclarés pour les catégories, règles, structures et associations structure-règle. Les contrats et bulletins ne figurent pas parmi les profils déclarés dans le descripteur.</li>
<li><strong>Triggers SQL :</strong> un trigger synchronise certains changements de statut entre le salaire payé et le bulletin lié. Deux autres triggers empêchent l’affectation d’un même bulletin à des salaires différents.</li>
<li><strong>Trigger Dolibarr :</strong> à la création du paiement d’un salaire, le module met le bulletin relié au statut payé.</li>
<li><strong>Journal technique observé :</strong> le trigger de paiement écrit dans <code>/tmp/payroll_debug.log</code> des horodatages, identifiants de salaires, résultats SQL et messages d’erreur. La rotation, la durée de conservation et les permissions de ce fichier ne sont pas gérées par le module ; l’administrateur du serveur doit les contrôler.</li>
<li><strong>Fichiers :</strong> les PDF générés sont écrits sous le répertoire de documents de sortie du module décrit dans la section PDF. Aucune tâche planifiée ou règle de purge des PDF et données de paie n’est déclarée par le module.</li>
<li><strong>Multi-entité :</strong> les opérations et listes sont filtrées sur l’entité Dolibarr active ; les constantes de configuration sont enregistrées avec cette entité.</li>
</ul>

<h2>11. Dépannage</h2>
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;">
<tr><th style="padding:8px;border:1px solid #dee2e6;">Symptôme</th><th style="padding:8px;border:1px solid #dee2e6;">Vérifications</th></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le menu ou une page Paie n’est pas accessible.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier que le module est activé, que le rôle possède le droit Paie requis et que les modules Dolibarr Utilisateurs et Salaires sont activés.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le calcul ne démarre pas ou retourne une erreur.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier l’employé, le contrat, la structure, les dates, les règles actives, les séquences et la syntaxe des expressions. Une variable inconnue ou une division par zéro interrompt le calcul.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">La validation ne met pas à jour les montants.</td><td style="padding:8px;border:1px solid #dee2e6;">Le réglage initial désactive le recalcul lors de la validation. Recalculer le brouillon avant validation ou modifier cette option selon la procédure de paie.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le lot ne génère aucun bulletin.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier la période du lot et l’existence de contrats actifs, associés à une structure et chevauchant la période. Vérifier aussi si un bulletin du contrat existe déjà dans ce lot.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">La validation du lot est refusée.</td><td style="padding:8px;border:1px solid #dee2e6;">Chaque brouillon doit avoir au moins une ligne de calcul. Recalculer ou corriger les bulletins signalés avant de relancer la validation.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le champ de sélection du bulletin est absent du salaire.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier l’activation du module et l’existence/activation de l’extrafield ajouté à l’objet Salaire. Réactiver le module si nécessaire, avec les droits SQL adéquats.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le statut payé ne suit pas le paiement Dolibarr.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier que le bulletin est lié au bon salaire, que les triggers sont installés et consulter les journaux Dolibarr ainsi que <code>/tmp/payroll_debug.log</code>.</td></tr>
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le PDF est absent ou ne peut pas être ouvert.</td><td style="padding:8px;border:1px solid #dee2e6;">Contrôler les droits d’écriture du serveur sur le répertoire de sortie et l’existence du document. Examiner le message d’erreur et les journaux Dolibarr.</td></tr>
</table>

<h2>12. Limites et précautions</h2>
<ul>
<li>Faire valider toutes les formules de paie par un spécialiste connaissant la législation applicable avant de traiter des salaires réels.</li>
<li>Le calcul de <code>MONTH_DAYS</code> exclut les samedis et dimanches mais conserve les jours fériés ; il ne lit pas un calendrier de congés.</li>
<li>La validation d’un bulletin ne recalcule pas les montants avec la configuration initiale. Vérifier les lignes et recalculer explicitement avant confirmation si les données ont changé.</li>
<li>La génération par lot utilise initialement 22 jours travaillés pour chaque bulletin créé. Adapter cette valeur à la situation réelle avant validation.</li>
<li>Le retour au brouillon et l’annulation dépendent d’un réglage désactivé par défaut. Une modification d’état d’un bulletin relié à un salaire doit être coordonnée avec le suivi comptable et le paiement Dolibarr.</li>
<li>La suppression d’un lot supprime les bulletins et calculs qu’il contient, sauf si la présence d’un bulletin payé bloque la suppression. Cette opération doit être vérifiée avant confirmation.</li>
<li>La synchronisation automatique des statuts dépend de triggers MySQL/MariaDB et des permissions de création de triggers ; la compatibilité avec les autres moteurs de base de données reste à confirmer.</li>
</ul>

<h2>13. Assistance</h2>
<p>Pour signaler un problème, fournir la version du module, les versions de Dolibarr et PHP, l’entité concernée, les étapes de reproduction et le message d’erreur expurgé des noms, salaires et autres données personnelles. Le module est édité par [https://01consulting.eu 01 Consulting]. Aucun courriel de support n’est indiqué dans les fichiers du module consultés.</p>
</div></div>
[[en:Odoo_Payroll]]