Skip to content
Navigation

Consulter un bulletin de paie

Renvoie les lignes du bulletin telles qu’imprimées sur le PDF du collaborateur : revenus bruts, cotisations regroupées, indemnités non soumises, autres retenues et totaux.

  • Dans les revenus bruts, une retenue est un montant négatif.
  • Un mois de paie rouvert puis clôturé de nouveau remplace ses bulletins par de nouveaux identifiants : les anciens renvoient 404.
GET
https://api.puncto.fr/public/v1/payslips/{payslipId}

Authentification

  • bearerAuth
    HTTP
    requis

Path parameters

  • payslipId
    string
    requis

    Identifiant Puncto du bulletin.

Retour

200

Bulletin de paie

JSON
  • payslipId
    string
    requis

    Identifiant Puncto

  • collaboratorId
    string
    requis

    Identifiant Puncto

  • collaboratorForeignErpId
    string | null
    requis

    Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné

  • contractId
    string
    requis

    Identifiant Puncto

  • year
    number
    requis
  • month
    number
    requis

    1-12, 1 = janvier

  • paymentDate
    string
    requis

    Date de paiement du salaire imprimée sur le bulletin

    format: date
  • createdAt
    string
    requis
    format: date-time
  • projection
    object
    requis

    Projection du bulletin : exactement les lignes que le template imprime, en données pures. Le rendu (payslip.tsx, gross-salary-rows.tsx) est construit à partir d'elle, donc ce que relit un lecteur externe — LLM de contrôle, agent de diagnostic — est ce que le salarié a sous les yeux, sans réimplémenter la moindre règle d'affichage.

    • period
      object
      requis
      • year
        number
        requis
      • month
        number
        requis
    • collaborator
      object
      requis
      • firstName
        string
        requis
      • lastName
        string
        requis
      • matriculeRh
        string | null
        requis
    • grossSalary
      tableau de
      object
      requis

      Bloc « Éléments de revenus bruts » ; les retenues y sont négatives.

      • name
        string
        requis

        Libellé imprimé

      • base
        optionnel
        number

        Base : montant en euros pour une cotisation, heures ou jours pour une ligne de rémunération

      • employeeRate
        optionnel
        number

        Taux salarial : en % pour une cotisation (3.68 = 3,68 %), en €/h pour le salaire de base et les heures supplémentaires

      • employeeCharge
        optionnel
        number

        Montant salarié, en euros

      • employerCharge
        optionnel
        number

        Montant patronal, en euros

      • isTaxFreeIndemnity
        optionnel
        boolean

        Ligne des indemnités non soumises

    • charges
      tableau de
      requis

      Bloc « Cotisations et contributions sociales ».

      One of the following:

      • object
      • object
    • taxFreeIndemnitiesAndDeductions
      tableau de
      requis

      Blocs « Indemnités non soumises », « Intéressement » et « Autres retenues ».

      One of the following:

      • object
      • object
    • priorPeriodRegularisations
      tableau de
      object
      requis

      Blocs « Régularisation MM/AAAA », entre les cotisations et les indemnités non soumises.

      • sourceYear
        number
        requis
      • sourceMonth
        number
        requis
      • title
        string
        requis

        « Régularisation 02/2026 »

      • grossLines
        tableau de
        object
        requis

        Écarts des lignes de revenus bruts, signés comme dans le bloc des revenus bruts

        • name
          string
          requis

          Libellé imprimé

        • base
          optionnel
          number

          Base : montant en euros pour une cotisation, heures ou jours pour une ligne de rémunération

        • employeeRate
          optionnel
          number

          Taux salarial : en % pour une cotisation (3.68 = 3,68 %), en €/h pour le salaire de base et les heures supplémentaires

        • employeeCharge
          optionnel
          number

          Montant salarié, en euros

        • employerCharge
          optionnel
          number

          Montant patronal, en euros

        • isTaxFreeIndemnity
          optionnel
          boolean

          Ligne des indemnités non soumises

      • charges
        tableau de
        requis

        Écarts des cotisations, groupés et libellés comme le bloc des cotisations

        One of the following:

        • object
        • object
      • netItems
        tableau de
        object
        requis

        Écarts des indemnités non soumises et des retenues : employeeCharge est l'effet signé sur le net

        • name
          string
          requis

          Libellé imprimé

        • base
          optionnel
          number

          Base : montant en euros pour une cotisation, heures ou jours pour une ligne de rémunération

        • employeeRate
          optionnel
          number

          Taux salarial : en % pour une cotisation (3.68 = 3,68 %), en €/h pour le salaire de base et les heures supplémentaires

        • employeeCharge
          optionnel
          number

          Montant salarié, en euros

        • employerCharge
          optionnel
          number

          Montant patronal, en euros

        • isTaxFreeIndemnity
          optionnel
          boolean

          Ligne des indemnités non soumises

      • totals
        object
        requis
        • gross
          number
          requis
        • collaboratorContributions
          number
          requis
        • employerContributions
          number
          requis
        • netBeforeTaxes
          number
          requis
    • totals
      object
      requis
      • subTotalGrossSalary
        number
        requis
      • totalCotisationsCollaborator
        number
        requis
      • totalCotisationsEmployer
        number
        requis
      • netSocial
        number
        requis
      • netBeforeTaxes
        number
        requis
      • netAfterTaxes
        number
        requis
      • netImposable
        number | null
        requis

        Net imposable du mois — distinct de la base PAS, qui peut être nulle (taux nul).

      • pas
        object
        requis
        • base
          number
          requis
        • rate
          number
          requis
        • amount
          number
          requis

401

Clé d’API absente, invalide ou révoquée
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

403

Opération hors de l’accès de la clé d’API
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

404

Bulletin introuvable, non validé ou remplacé
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

422

Paramètres invalides
JSON
  • errors
    tableau de
    object
    requis
    • message
      string
      requis
    • rule
      string
      requis

      Règle de validation en échec.

    • field
      string
      requis

      Chemin du champ, par exemple absences.0.type.

Type to search…

↑↓ navigate↵ selectEsc close