Skip to content
Navigation

Créer une variable récurrente

Crée une variable récurrente : prime (indemnité d’occupation du domicile ou autre), avantage en nature, véhicule de fonction dont Puncto calcule l’avantage chaque mois, ou abonnement annuel de transport public. Les brouillons de bulletin des mois concernés sont recalculés.

Elle se crée sur des mois encore ouverts, dans les dates du contrat. Son contenu ne se modifie plus : pour changer un montant, supprimez-la (tant qu’aucun mois verrouillé ne l’a versée) ou fixez son dernier mois de versement, puis créez-en une nouvelle.

Justificatifs : envoyez la requête en multipart/form-data avec des fichiers proofFiles[i] (pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip).

POST
https://api.puncto.fr/public/v1/recurring-variables

Authentification

  • bearerAuth
    HTTP
    requis

Corps de la requête JSON requis

  • contractMatching
    object
    requis

    Contrat qui verse la variable. Désigné par le collaborateur : son contrat actif à eventDate, à défaut à la fin puis au début du premier mois de versement, et pour un abonnement annuel commencé avant l’embauche, son contrat actuel.

    • type
      BY_PUNCTO_COLLABORATOR_ID
      ou
      BY_PUNCTO_CONTRACT_ID
      requis

      Clé de correspondance utilisée par value.

      • BY_PUNCTO_COLLABORATOR_ID : value est l’identifiant Puncto du collaborateur
      • BY_PUNCTO_CONTRACT_ID : value est l’identifiant Puncto du contrat (GET /public/v1/contracts), eventDate est ignorée
    • value
      string
      requis

      Identifiant Puncto du collaborateur, ou du contrat avec BY_PUNCTO_CONTRACT_ID. Depuis votre foreignErpId, retrouvez-le avec GET /public/v1/collaborators?collaboratorForeignErpId=….

      minLength: 1
    • eventDate
      optionnel
      string

      Date de l’événement, pour choisir le contrat quand le collaborateur en a plusieurs sur le mois.

      format: date
  • data
    requis

    Ce que la variable verse chaque mois.

    One of the following:

    • Prime
    • Avantage en nature
    • Véhicule de fonction évalué au forfait
    • Abonnement annuel de transport public
  • foreignErpId
    optionnel
    string

    Identifiant de l’élément dans votre système, unique dans l’entreprise pour les variables de paie, astreintes et variables récurrentes réunies : un foreignErpId déjà utilisé renvoie 409.

    maxLength: 255 · minLength: 1
  • status
    optionnel
    PENDING
    ou
    VALIDATED
    ou
    REJECTED

    Par défaut VALIDATED. Seule une variable VALIDATED est versée.

    • PENDING : En attente
    • VALIDATED : Accepté
    • REJECTED : Refusé
  • frequency
    optionnel
    MONTHLY

    Périodicité des versements. Requise, sauf pour un abonnement annuel.

    • MONTHLY : Mensuelle
  • startYear
    optionnel
    integer

    Année du premier mois de versement. Requise, sauf pour un abonnement annuel.

    maximum: 2100 · minimum: 2000
  • startMonth
    optionnel
    integer

    Premier mois de versement. Requis, sauf pour un abonnement annuel.

    maximum: 12 · minimum: 1
  • endYear
    optionnel
    integer | null

    Année du dernier mois de versement, avec endMonth.

    maximum: 2100 · minimum: 2000
  • endMonth
    optionnel
    integer | null

    Dernier mois de versement inclus, avec endYear. Omis, la variable court sans fin.

    maximum: 12 · minimum: 1

Retour

201

Variable récurrente créée

JSON
  • recurringVariableId
    string
    requis

    Identifiant Puncto de la variable récurrente

  • foreignErpId
    string | null
    requis

    Identifiant de la variable récurrente dans votre système, null si elle n'a pas été importée

  • contractId
    string
    requis

    Contrat qui verse la variable

  • collaboratorId
    string
    requis

    Collaborateur titulaire du contrat

  • collaboratorForeignErpId
    string | null
    requis

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

  • data
    requis

    Ce que la variable verse chaque mois

    One of the following:

    • PublicApiRecurringPrimeData
      • type
        string
        requis

        Prime

      • name
        string
        requis

        Libellé imprimé sur le bulletin

      • amount
        number
        requis

        Montant brut mensuel, en euros

      • primeType
        HOLIDAY_BONUS
        ou
        END_OF_CONTRACT_BONUS
        ou
        LEGAL_DISMISSAL_BONUS
        ou
        SYNTEC_DISMISSAL_BONUS
        ou
        PPV
        ou
        JNT_COMPENSATION_BONUS
        +14 de plus
        requis

        Type de prime : HOME_OCCUPATION_ALLOWANCE (indemnité d'occupation du domicile) ou OTHER, seuls types qu'un échéancier verse

      • isAbsenceSensitive
        boolean
        requis

        La prime est proratisée selon les absences du mois

    • PublicApiRecurringInKindBenefitData
      • type
        string
        requis

        Avantage en nature

      • name
        string
        requis

        Libellé imprimé sur le bulletin

      • amount
        number
        requis

        Valeur mensuelle de l'avantage, en euros. Pour un véhicule au forfait, valeur calculée par Puncto pour le premier mois de versement : chaque bulletin la recalcule pour son mois. Pour un véhicule aux dépenses réelles, usage personnel évalué avant abattement et participation

      • benefitType
        MEALS
        ou
        HOUSING
        ou
        VEHICLE
        ou
        NTIC
        ou
        OTHER
        requis

        Nature de l'avantage

      • vehicle
        requis

        Véhicule évalué au forfait, null pour les autres avantages

        One of the following:

        • PublicApiVehicleBenefit
        • null
      • actualExpensesVehicle
        requis

        Véhicule évalué aux dépenses réelles, null pour les autres avantages

        One of the following:

        • PublicApiActualExpensesVehicle
        • null
    • PublicApiAnnualPublicTransportData
      • type
        string
        requis

        Indemnité non soumise

      • name
        string
        requis

        Libellé imprimé sur le bulletin

      • amountTotal
        number
        requis

        Prix de l'abonnement sur l'année, en euros

      • amountReimbursed
        number
        requis

        Prise en charge de l'employeur sur l'année, en euros

      • indemnityType
        string
        requis

        Transport public

      • titleType
        requis

        Titre de transport, null si non renseigné

        One of the following:

        • TransportTitleType
        • null
      • periodicity
        string
        requis

        Abonnement annuel

      • startMonth
        string
        requis

        Premier mois réel de l'abonnement, YYYY-MM

  • frequency
    string
    requis

    Périodicité des versements

  • status
    PENDING
    ou
    VALIDATED
    ou
    REJECTED
    requis

    Seule une variable validée (VALIDATED) est versée ; une variable en attente (PENDING) attend un administrateur

  • startYear
    number
    requis

    Année du premier mois de versement

  • startMonth
    number
    requis

    Premier mois de versement, de 1 à 12

  • endYear
    number | null
    requis

    Année du dernier mois de versement, null tant que la variable court sans fin

  • endMonth
    number | null
    requis

    Dernier mois de versement inclus, de 1 à 12, null tant que la variable court sans fin

  • lockedThrough
    requis

    Dernier mois de la période déjà verrouillé (paie clôturée ou bulletin validé), null si aucun ou si la variable n'est pas validée. Une variable verrouillée ne se supprime plus et ne se modifie plus : seul son dernier mois de versement peut encore être fixé, après ce mois

    One of the following:

    • PublicApiYearMonth
      • year
        number
        requis

        Année

      • month
        number
        requis

        Mois, de 1 (janvier) à 12

    • null
  • proofFiles
    tableau de
    object
    requis

    Justificatifs joints dans Puncto

    • documentId
      string
      requis

      Identifiant Puncto du document

    • displayFileName
      string
      requis

      Nom du document affiché dans Puncto

    • fileType
      PAYSLIP
      ou
      PAYSLIP_ARCHIVED
      ou
      DSN_MONTHLY
      ou
      DSN_WORK_STOPPAGE
      ou
      DSN_WORK_STOPPAGE_RESUMPTION
      ou
      DSN_FCTU
      +40 de plus
      requis

      Type de document

    • mimeType
      requis

      Type MIME du fichier

      One of the following:

      • ImageMimeType
      • OtherMimeType
    • createdAt
      string
      requis

      Date d'enregistrement du document dans Puncto

      format: date-time
  • createdAt
    string
    requis

    Date de création dans Puncto

    format: date-time
  • updatedAt
    string
    requis

    Date de dernière modification dans Puncto

    format: date-time

400

Saisie refusée : mois verrouillé, hors du contrat, abonnement annuel chevauchant un autre
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

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

Collaborateur ou contrat introuvable
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

409

foreignErpId déjà utilisé par une variable récurrente ou de paie
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