Skip to content
Navigation

Lister les bulletins de paie

Liste paginée des bulletins validés (remis aux collaborateurs), du mois le plus récent au plus ancien puis par nom, avec leurs totaux. Les lignes se lisent avec GET /public/v1/payslips/{payslipId}, le PDF avec GET /public/v1/payslips/{payslipId}/pdf.

Un filtre sans correspondance renvoie une liste vide.

GET
https://api.puncto.fr/public/v1/payslips

Authentification

  • bearerAuth
    HTTP
    requis

Query parameters

  • page
    optionnel
    integer

    Numéro de page, à partir de 1.

    minimum: 1 · default: 1
  • perPage
    optionnel
    integer

    Nombre d’éléments par page, 200 au plus.

    maximum: 200 · minimum: 1 · default: 50
  • year
    optionnel
    integer

    Année de la période de paie.

    maximum: 2100 · minimum: 2000
  • month
    optionnel
    integer

    Mois de la période de paie, de 1 (janvier) à 12.

    maximum: 12 · minimum: 1
  • contractId
    optionnel
    string

    Identifiant Puncto du contrat.

  • collaboratorId
    optionnel
    string

    Identifiant Puncto du collaborateur. Ne pas combiner avec collaboratorForeignErpId.

  • collaboratorForeignErpId
    optionnel
    string

    Identifiant du collaborateur dans votre système (foreignErpId). Ne pas combiner avec collaboratorId.

Retour

200

Page de bulletins

JSON
  • data
    tableau de
    object
    requis
    • 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
    • totals
      object
      requis

      Totaux imprimés en pied de bulletin

      • 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
  • meta
    object
    requis
    • total
      integer
      requis

      Nombre total d’éléments.

    • page
      integer
      requis

      Page renvoyée.

    • perPage
      integer
      requis
    • currentPage
      integer
      requis
    • firstPage
      integer
      requis
    • lastPage
      integer
      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.

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