Aller au contenu

Paie

À quoi ça sert

Le module Paie (/dashboard/admin/accounting/payroll) gère les cycles de paie mensuels : calcul automatique des salaires et cotisations, validation, génération des bulletins, marquage du paiement, clôture, et génération des fichiers de virement (CSV / SEPA). Chaque salarié peut par ailleurs consulter et télécharger ses propres bulletins via un espace self-service, indépendamment de son rôle.

Prérequis

Prérequis

  • Modules sous licence : ACCOUNTING
  • Permissions : accounting.read, accounting.manage
  • Rôles : EMPLOYEE, MANAGER, HR_MANAGER, ACCOUNTANT, CFO, ORG_ADMIN

Comment ça marche

Créer un cycle de paie

  1. Depuis Comptabilité → Paie, cliquez sur + Nouveau cycle.
  2. Renseignez la période (mois/année) et une note optionnelle, puis validez.
  3. Le cycle est créé au statut Brouillon, avec zéro salarié tant qu'aucun calcul n'a été lancé.

Calculer, valider, payer, clôturer

Depuis la fiche détail d'un cycle (/dashboard/accounting/payroll/{id}), les actions disponibles changent selon le statut :

  1. Brouillon : bouton Calculer — déclenche le calcul des salaires bruts, cotisations salariales/patronales et impôt sur le revenu pour tous les salariés éligibles ; un bouton Valider (actif uniquement si au moins une ligne existe) fige les montants ; un bouton Supprimer permet d'annuler le cycle avant validation.
  2. Validée : bouton Générer bulletins produit les bulletins de paie PDF individuels ; bouton Marquer payé ouvre une boîte de dialogue pour saisir la date de paiement et confirmer.
  3. Payée : bouton Clôturer verrouille définitivement le cycle.
  4. Dès que le cycle quitte le statut Brouillon, deux boutons Virements CSV et Virements SEPA deviennent disponibles pour télécharger le fichier de virement bancaire correspondant.
  5. Le tableau des lignes de paie affiche, par salarié : brut ajusté, cotisations salariales, impôt sur le revenu, net à payer, et un lien de téléchargement du bulletin dès qu'il est généré.
  6. Un bouton Afficher l'écriture comptable révèle l'écriture de journal générée automatiquement pour le cycle (compte, libellé, débit, crédit), consultable dès que le cycle n'est plus en Brouillon.

Cycle de vie (strictement à sens unique, aucun retour en arrière) : Brouillon → Validée → Payée → Clôturée.

Consulter ses propres bulletins (tout salarié)

Tout utilisateur authentifié peut consulter ses bulletins de paie personnels et les télécharger en PDF, indépendamment de son rôle ou de ses permissions comptables — cette fonctionnalité est distincte de l'administration des cycles décrite ci-dessus.

Qui peut faire quoi

Permission requise Rôles concernés
accounting.read EMPLOYEE, MANAGER, HR_MANAGER, ACCOUNTANT, CFO, ORG_ADMIN
accounting.manage EMPLOYEE, MANAGER, HR_MANAGER, ACCOUNTANT, CFO, ORG_ADMIN
Action Permission requise
Consulter ses propres bulletins de paie Authentification simple (aucune permission comptable requise)
Consulter la liste des cycles, le détail, les lignes, les entrées variables, l'écriture comptable accounting.read
Créer un cycle, calculer, valider, supprimer, générer les bulletins, marquer payé, clôturer, générer les fichiers de virement, gérer les entrées variables accounting.manage

ACCOUNTANT et CFO ne peuvent pas gérer les cycles de paie

Contrairement aux autres fonctions comptables, la gestion de la paie est verrouillée derrière accounting.manage — une permission distincte de accounting.write/accounting.validate que la matrice V185 attribue à ACCOUNTANT. Ni ACCOUNTANT ni CFO ne détiennent accounting.manage : sur le tenant standard, seuls ADMIN et le rôle système HR_MANAGER (qui reçoit accounting.read + accounting.manage spécifiquement, cf. migration V160) peuvent créer, calculer, valider, payer ou clôturer un cycle de paie. Un ACCOUNTANT peut uniquement consulter les cycles en lecture seule.

Détails techniques

Détails techniques
  • Enum PayrollStatus (app.jigi.accounting.payroll.domain) : DRAFT, VALIDATED, PAID, CLOSED — transitions strictement séquentielles.
  • Endpoints (PayrollAdminController, base /accounting/payroll) :
    • GET (liste, filtre status), GET /{runId} (accounting.read)
    • POST (création), DELETE /{runId} (accounting.manage)
    • POST /{runId}/compute, /validate, /pay (avec paymentDate), /close (accounting.manage)
    • GET/PUT /{runId}/variable-inputs (accounting.read / accounting.manage)
    • GET /{runId}/transfer-file/csv et /sepa (accounting.manage) via PayrollTransferFileService
    • POST /{runId}/generate-payslips (accounting.manage), GET /{runId}/entries/{entryId}/payslip (accounting.read)
    • GET /{runId}/journal (accounting.read) via PayrollJournalService
  • Endpoints self-service (PayslipSelfController, base /accounting/payroll/my-payslips) : accessibles à tout utilisateur authentifié, sans permission comptable.
  • Taux de cotisations sociales/patronales configurés par pays (SN, FR…) dans la table admin.payroll_contribution_rules (migration V160), avec distinction EMPLOYEE/EMPLOYER.
  • Écriture comptable générée automatiquement à chaque cycle via PayrollJournalService, table accounting.journal_entries (source PAYROLL).

Cas d'erreur et FAQ

Je suis comptable (ACCOUNTANT) mais je ne vois aucun bouton pour valider ou payer un cycle, pourquoi ? La gestion de la paie nécessite accounting.manage, une permission que le rôle ACCOUNTANT ne détient pas dans la matrice standard. Seuls ADMIN et le rôle RH (HR_MANAGER) peuvent piloter les cycles ; ACCOUNTANT est en lecture seule sur ce module.

Puis-je revenir en arrière après avoir validé un cycle par erreur ? Non, le cycle de vie est strictement à sens unique (Brouillon → Validée → Payée → Clôturée). Un cycle en Brouillon peut en revanche être supprimé avant validation.

Comment récupérer le fichier de virement bancaire pour payer les salaires ? Depuis la fiche du cycle, une fois qu'il n'est plus en Brouillon, utilisez le bouton Virements CSV ou Virements SEPA selon le format attendu par votre banque.

Un salarié peut-il voir le bulletin de paie d'un collègue ? Non, l'espace self-service ne donne accès qu'aux bulletins de l'utilisateur connecté.

Faut-il valider le cycle avant de générer les bulletins ? Oui — la génération des bulletins n'est proposée qu'à partir du statut Validée, jamais sur un cycle encore en Brouillon.

Voir aussi