Lister les variables de paie
Liste paginée des variables de paie de l’entreprise, toutes origines confondues (saisie, import, feuilles de temps, astreintes, intéressement, page Primes), du mois de paie le plus récent au plus ancien.
Les variables récurrentes (abonnements annuels de transport, primes et avantages récurrents) n’y figurent pas : lisez-les avec GET /public/v1/recurring-variables.
https://api.puncto.fr/public/v1/payroll-variablesAuthentification
Query parameters
Retour
200
Page de variables de paie
- datatableau deobjectrequis
- datarequis
Contenu de la variable
}One of the following:
- PublicApiPayrollVariablePrimeData
- typestringrequis
Prime
- namestringrequis
Libellé imprimé sur le bulletin
- amountnumberrequis
Montant brut, en euros
- primeTypeHOLIDAY_BONUSouEND_OF_CONTRACT_BONUSouLEGAL_DISMISSAL_BONUSouSYNTEC_DISMISSAL_BONUSouPPVouJNT_COMPENSATION_BONUS+14 de plusrequis
Type de prime, qui détermine sa déclaration en DSN
- isAbsenceSensitivebooleanrequis
La prime est proratisée en fonction des absences du mois
- baseoptionnelnumber
Base imprimée sur le bulletin, quand la prime en a une (jours d'une indemnité de fin de contrat, par exemple)
- attachmentPeriodoptionnelobject
Période de rattachement DSN, quand elle ne se déduit pas du mois de paie (régularisation du dixième des congés payés)
- startDatestringrequis
Premier jour de la période
format: date - endDatestringrequis
Dernier jour de la période
format: date
- PublicApiPayrollVariableSalaryDeductionData
- typestringrequis
Retenue sur salaire
- namestringrequis
Libellé imprimé sur le bulletin
- amountnumberrequis
Montant retenu, en euros
- deductionTypeLAST_MONTH_NEGATIVE_PAY_ADVANCEouNET_REDUCTIONouBRUT_REDUCTIONrequis
Nature de la retenue : sur le net, sur le brut, ou avance de salaire négative du mois précédent
- PublicApiPayrollVariableInKindBenefitData
- typestringrequis
Avantage en nature
- namestringrequis
Libellé imprimé sur le bulletin
- amountnumberrequis
Valeur de l'avantage, en euros
- benefitTypeMEALSouHOUSINGouVEHICLEouNTICouOTHERrequis
Nature de l'avantage
- actualExpensesVehicleoptionnelobject
Véhicule évalué aux dépenses réelles :
amountest alors l'usage personnel évalué, avant abattement et participation- isElectricbooleanrequis
Véhicule électrique
- employeeMonthlyContributionnumberrequis
Participation mensuelle du salarié, en euros, déduite de l'avantage après l'abattement
- contributionWithheldFromPaybooleanrequis
La participation du salarié est retenue sur son net à payer
- retainedDuringLeavebooleanrequis
L'avantage est conservé pendant les congés
- assignedOnoptionnelstring
Date de mise à disposition (
AAAA-MM-JJ), requise pour un véhicule électrique - isEcoScoreEligibleoptionnelboolean
Éco-score requis pour l'abattement des véhicules électriques mis à disposition depuis le 1er février 2025
- PublicApiPayrollVariableOvertimeData
- typestringrequis
Heures supplémentaires
- namestringrequis
Libellé imprimé sur le bulletin
- hoursnumberrequis
Nombre d'heures supplémentaires
- overtimeDatestringrequis
Jour où les heures ont été effectuées : il détermine leur semaine, donc leur taux de majoration
format: date
- PublicApiPayrollVariableMonthlyOvertimeData
- typestringrequis
Heures supplémentaires
- namestringrequis
Libellé imprimé sur le bulletin
- hoursnumberrequis
Nombre d'heures supplémentaires
- majorationRate25ou50ou100requis
Taux de majoration, en % : 25, 50 ou 100 (dimanche, jour férié, nuit)
- PublicApiPayrollVariableRemoteWorkDayData
- typestringrequis
Jours de télétravail
- namestringrequis
Libellé fixe
- daysnumberrequis
Nombre de jours, par demi-journée, négatif pour retirer des jours au décompte automatique
- PublicApiPayrollVariableMealAllowanceAdjustmentData
- typestringrequis
Ajustement des primes de panier
- namestringrequis
Libellé fixe
- mealAllowanceTypeON_SITEouOFF_SITEouTRAVEL_RESTAURANTrequis
Situation du repas, qui fixe la limite d'exonération par repas
- countnumberrequis
Nombre de repas, négatif pour en retirer
- labeloptionnelstring
Libellé de la ligne du bulletin (60 caractères au plus), « Régularisation prime de panier » par défaut
- PublicApiPayrollVariableMealVoucherAdjustmentData
- typestringrequis
Ajustement des titres restaurant
- namestringrequis
Libellé fixe
- countnumberrequis
Nombre de titres, négatif pour en retirer
- labeloptionnelstring
Libellé de la ligne du bulletin (60 caractères au plus), « Régularisation titres restaurant » par défaut
- PublicApiPayrollVariableSalaryAdvanceData
- typestringrequis
Acompte sur salaire
- namestringrequis
Libellé fixe
- amountnumberrequis
Montant versé, en euros
- paymentDatestringrequis
Date de versement de l'acompte, dans le mois de paie
format: date
- PublicApiPayrollVariableProfitSharingData
- typestringrequis
Intéressement
- namestringrequis
Libellé imprimé sur le bulletin
- amountnumberrequis
Montant attribué, en euros
- paidAmountnumberrequis
Part versée sur la paie, en euros
- peeAmountnumberrequis
Part placée sur le plan d'épargne entreprise (PEE), en euros
- perAmountnumberrequis
Part placée sur le plan d'épargne retraite (PER), en euros
- PublicApiPayrollVariableHolidayVoucherData
- typestringrequis
Chèques-vacances
- namestringrequis
Libellé imprimé sur le bulletin
- voucherValuenumberrequis
Valeur des titres remis, en euros
- employerAmountnumberrequis
Participation de l'employeur, en euros
- employeeAmountnumberrequis
Part payée par le salarié, en euros
- exemptAmountnumberrequis
Part de la participation employeur exonérée de cotisations sociales, en euros
- taxableExemptAmountnumberrequis
Part de
exemptAmountau-delà de l'exonération annuelle d'impôt sur le revenu, en euros - subjectAmountnumberrequis
Part de la participation employeur soumise à cotisations sociales, en euros
- taxExemptSubjectAmountnumberrequis
Part de
subjectAmountsous l'exonération annuelle d'impôt sur le revenu, en euros
- PublicApiPayrollVariablePrevoyanceIjData
- typestringrequis
IJ de prévoyance
- namestringrequis
Libellé
- startDatestringrequis
Premier jour indemnisé du mois
format: date - endDatestringrequis
Dernier jour indemnisé du mois
format: date - grossAmountnumberrequis
IJ brute de ces jours, en euros
- employerRatenumberrequis
Part de l'IJ financée par l'employeur, en % : elle est soumise à cotisations comme du salaire
- PublicApiPayrollVariableOnCallData
- typestringrequis
Astreinte
- namestringrequis
Libellé du type d'astreinte à la saisie
- onCallTypeIdstringrequis
Type d'astreinte de l'entreprise
- startstringrequis
Début, heure légale française
YYYY-MM-DDTHH:mm - endstringrequis
Fin, heure légale française
YYYY-MM-DDTHH:mm - unitsnumberrequis
Nombre d'unités indemnisées : heures de la période (unité
HOUR) ou nombre de périodes (unitéPERIOD) - compensationobjectrequis
Contrepartie de l'astreinte
- modestringrequis
Montant fixe par unité
- unitPERIODouHOURrequis
Unité indemnisée : la période entière ou l'heure
- amountnumberrequis
Montant brut par unité, en euros
- interventionstableau deobjectrequis
Interventions pendant la période
- startstringrequis
Début, heure légale française
YYYY-MM-DDTHH:mm, temps de déplacement compris - endstringrequis
Fin, heure légale française
YYYY-MM-DDTHH:mm - locationREMOTEouON_SITErequis
Intervention à distance ou sur site
- dayCountoptionnelNONEouHALF_DAYouFULL_DAY
Décompte au forfait jours, absent pour un contrat en heures où l'intervention est payée en heures supplémentaires
- compensationModeoptionnelPAYMENTouREST
Contrat en heures :
RESTquand l'intervention est compensée en repos (compteur RCR, majoration comprise) au lieu d'être payée
- PublicApiPayrollVariableExpenseNoteData
- typestringrequis
Indemnité non soumise à cotisations
- namestringrequis
Libellé imprimé sur le bulletin
- amountTotalnumberrequis
Montant TTC de la dépense, en euros
- amountReimbursednumberrequis
Montant remboursé au salarié, en euros
- indemnityTypestringrequis
Note de frais
- expenseDatestringrequis
Date de la dépense
format: date - expenseTypeHOTEL_LOGEMENTouMEALSouKILOMETRIC_INDEMNITIESouTRANSPORTouEQUIPMENTouSERVICES+1 de plusrequis
Nature de la dépense
- vatAmountsobjectrequis
Montants de TVA de la dépense
- vatAmount2_1numberrequis
TVA à 2,1 %
- vatAmount5_5numberrequis
TVA à 5,5 %
- vatAmount10numberrequis
TVA à 10 %
- vatAmount20numberrequis
TVA à 20 %
- kilometricoptionnelobject
Trajet des indemnités kilométriques
- vehicleCategoryCARouMOTORCYCLEouSCOOTERrequis
Catégorie du véhicule
- energyTypeTHERMIC_HYDROGEN_HYBRIDouELECTRICrequis
Énergie du véhicule
- fiscalPowernumber | nullrequis
Puissance fiscale du véhicule, en chevaux fiscaux
- departureAddressstringrequis
Adresse de départ
- arrivalAddressstringrequis
Adresse d'arrivée
- distancenumberrequis
Distance du trajet, en kilomètres
- isRoundTripbooleanrequis
Aller-retour : la distance compte deux fois
- PublicApiPayrollVariablePersonalTransportData
- typestringrequis
Indemnité non soumise à cotisations
- namestringrequis
Libellé imprimé sur le bulletin
- amountTotalnumberrequis
Montant total des frais, en euros
- amountReimbursednumberrequis
Montant pris en charge par l'employeur, en euros
- indemnityTypestringrequis
Transport personnel
- personalTransportTypeFORFAIT_MOBILITES_DURABLESouPRIME_TRANSPORTrequis
Forfait mobilités durables ou prime de transport
- primeTransportTypeoptionnelFUELouELECTRIC_VEHICLE_CHARGING
Nature de la prime de transport, présente quand
personalTransportTypevautPRIME_TRANSPORT - fmdTransportTypeoptionnelPERSONAL_BIKEouCARPOOLINGouRENTED_OR_SHARED_VEHICLESouLOW_EMISSION_CAR_SHARINGouMOTORIZED_PERSONAL_TRANSPORT_DEVICESouPUBLIC_TRANSPORT_WITHOUT_SUBSCRIPTION
Mode de transport du forfait, présent quand
personalTransportTypevautFORFAIT_MOBILITES_DURABLES
- PublicApiPayrollVariableOtherTaxFreeIndemnityData
- typestringrequis
Indemnité non soumise à cotisations
- namestringrequis
Libellé imprimé sur le bulletin
- amountTotalnumberrequis
Montant total des frais, en euros
- amountReimbursednumberrequis
Montant pris en charge par l'employeur, en euros
- indemnityTypePUBLIC_TRANSPORTouPERSONAL_TRANSPORTouSPORT_SUBSCRIPTIONouOTHERrequis
Nature de l'indemnité
- titleTypeoptionnelNAVIGOouIMAGINE_RouVELIBouTER_SNCFouOTHER
Titre de transport public, qui fixe le taux de prise en charge de l'employeur
- periodicityoptionnelMONTHLYouANNUAL
Mensuelle sur une variable de paie : un abonnement annuel est une variable récurrente
- startMonthoptionnelstring
Premier mois d'un abonnement annuel,
YYYY-MM
- originENTRYouVARIABLE_BATCHouTIMESHEETouON_CALL_PERIODouPROFIT_SHARINGouHOLIDAY_BONUS+3 de plusrequis
Parcours de Puncto qui a créé la variable :
ENTRY: saisie dans Puncto ou importée par l'API ; aussi les indemnités générées par la clôture d'un contrat (celles du mois du solde de tout compte se modifient depuis la clôture) et le report d'un net négatif, généré à la clôture du mois sur le mois suivant (retenueLAST_MONTH_NEGATIVE_PAY_ADVANCE) ;VARIABLE_BATCH: import d'un fichier de variables dans Puncto, modifiable comme une saisie ;TIMESHEET: heures supplémentaires payées d'une feuille de temps validée, modifiables seulement depuis la feuille ;ON_CALL_PERIOD: période d'astreinte, modifiable par l'import des périodes d'astreinte ;PROFIT_SHARING: versement d'intéressement, modifiable seulement depuis ce versement ;HOLIDAY_BONUS,HOLIDAY_VOUCHER_ATTRIBUTION: prime de vacances ou chèques-vacances de la page Primes, modifiables seulement depuis cette page ;VALUE_SHARING_BONUS: versement de prime de partage de la valeur (PPV) de la page Primes ; comme dans l'application, la variable peut changer de statut ou être supprimée ;PREVOYANCE_IJ_SLIP: part d'un bordereau de paiement prévoyance, modifiable seulement depuis ce bordereau.