Consulter un contrat
Renvoie le contrat {contractId}, quels que soient son statut et ses dates.
Avec matchingBy, {contractId} désigne un collaborateur : Puncto renvoie son contrat en vigueur à matchingDate, au format ApiContractFull (données personnelles et manager inclus ; managerImageKey toujours null). C’est ainsi qu’on passe de votre identifiant à celui de Puncto : seul l’identifiant Puncto du contrat sert ensuite à le modifier, le supprimer ou agir sur sa période d’essai.
https://api.puncto.fr/public/v1/contracts/{contractId}Authentification
Path parameters
Query parameters
- matchingByoptionnelBY_COLLABORATOR_FOREIGN_ERP_IDouBY_PUNCTO_COLLABORATOR_IDouBY_PUNCTO_CONTRACT_ID
Facultatif : nature de la valeur du chemin, pour chercher le contrat en vigueur d’un collaborateur. Ne pas combiner avec
referenceDate.BY_COLLABORATOR_FOREIGN_ERP_ID:foreignErpIddu collaborateurBY_PUNCTO_COLLABORATOR_ID: identifiant Puncto du collaborateurBY_PUNCTO_CONTRACT_ID: déprécié : identifiant Puncto d’un contrat, dont le collaborateur est retenu. Renvoie son contrat en vigueur, qui peut en être un autre ; pour ce contrat-là, n’envoyez pasmatchingBy
Retour
200
Contrat : PublicApiContract sans matchingBy, ApiContractFull avec
One of the following:
- PublicApiContract
- contractIdstringrequis
Identifiant Puncto du contrat
- collaboratorIdstringrequis
Identifiant Puncto du collaborateur
- collaboratorForeignErpIdstring | nullrequis
Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné
- dsnContractNumberstringrequis
Numéro du contrat déclaré en DSN (S21.G00.40.009)
- workerTyperequis
Type de contrat, null pour un contrat en cours de création
}One of the following:
- WorkerType
- null
- activationStatusC_INVITATION_SENTouA_TO_BE_REALIZEDouB_ACTION_NEEDEDouE_ARCHIVEDouD_ACTIVEouF_TO_CLOSE+1 de plusrequis
Statut du contrat dans Puncto
- startDaterequis
Date de début du contrat, null pour un contrat en cours de création
}One of the following:
- string
- null
- endDaterequis
Date de fin du contrat : terme prévu (CDD, stage, alternance, mandat), remplacé par la date de fin effective une fois le contrat clôturé. Null pour un contrat sans terme.
}One of the following:
- string
- null
- cddMotifRecoursrequis
CDD : motif de recours déclaré en DSN (S21.G00.40.021)
}One of the following:
- DsnMotifRecours
- null
- dpaeDoneByPunctobooleanrequis
La DPAE du contrat est effectuée par Puncto
- hasMutuelleDispensebooleanrequis
Le salarié est dispensé d'adhésion à la mutuelle
- corporateOfficerSalaryMaintenancebooleanrequis
Mandataire social : rémunération maintenue pendant les arrêts, sous déduction des IJSS
- publicTransportEmployerRatenumber | nullrequis
Taux de prise en charge employeur (%) des abonnements de transport en commun propre au contrat, null quand les taux de l'établissement s'appliquent
- internshipStudiesstring | nullrequis
Stage : formation suivie
- internshipSchoolstring | nullrequis
Stage : établissement d'enseignement
- internshipPaidLeaveDaysnumber | nullrequis
Stage : forfait de jours de congés payés accordés, null s'il n'est pas accordé
- apprenticeshipFormationLevelrequis
Alternance : niveau du diplôme préparé
}One of the following:
- ApprenticeshipFormationLevel
- null
- apprenticeshipFormationYearsPeriodsrequis
Alternance : périodes des années de formation
}One of the following:
- ApprenticeshipFormationYearsPeriods
- null
- referenceDatestringrequis
Date à laquelle
currentAmendmentetestablishmentIdsont résolus : la date demandée, sinon la date du jour (la date de début pour un contrat qui n'a pas encore commencé)format: date - establishmentIdstringrequis
Établissement de rattachement en vigueur à
referenceDate(avant le premier avenant : celui du premier avenant) - currentAmendmentrequis
Avenant en vigueur à
referenceDate, null avant le premier avenant}One of the following:
- ApiContractAmendment
- null
- amendmentstableau deobjectrequis
Tous les avenants du contrat, avenants à venir compris, du plus ancien au plus récent
- remunerationBasisANNUALouHOURLYouSMOOTHED_MONTHLYouPERCENTAGErequis
- grossAnnualSalarynumber | nullrequis
ANNUAL: salaire brut annuel. - hourlyRatenumber | nullrequis
HOURLY: taux horaire brut.SMOOTHED_MONTHLY: taux horaire contractuel, figé au début de la période de lissage. - smoothedMonthlyAmountnumber | nullrequis
SMOOTHED_MONTHLY: montant mensuel lissé. - smoothingPlannedHoursnumber | nullrequis
SMOOTHED_MONTHLY: heures prévues de la période de lissage, figées à son début. - remunerationPercentagenumber | nullrequis
PERCENTAGE: pourcentage de la référence, ex.53pour 53 %. - remunerationReferencerequis
PERCENTAGE: référence du pourcentage.}One of the following:
- RemunerationReference
- null
- idstringrequis
Identifiant Puncto
- companyRoleIdrequis}
One of the following:
- string
- null
- companyTeamIdrequis}
One of the following:
- string
- null
- establishmentIdstringrequis
Identifiant Puncto
- startDatestringrequisformat: date
- renewsCddTermbooleanrequis
- postponesCddTermbooleanrequis
- previousCddEndDaterequis}
One of the following:
- string
- null
- isCadrebooleanrequis
- mealVoucherStatusDEFAULTouDISABLEDrequis
- remoteWorkAllowanceStatusDEFAULTouDISABLEDrequis
- remoteWorkWeeklyDaysnumber | nullrequis
Nombre de jours de télétravail par semaine prévus au contrat.
- mealAllowanceTyperequis
Type de prime de panier versée au titre du contrat.
null= pas de prime de panier.}One of the following:
- MealAllowanceType
- null
- quotityrequis}
One of the following:
- object
- object
- object
- object
- workerOutsideFranceStatus01ou02ou03ou99requis
- workPlacerequis
Lieu de travail effectif, quand il diffère de l'établissement de rattachement.
}One of the following:
- ContractWorkPlace
- null
- workTerritoryMETROPOLEouALSACE_MOSELLEouGUADELOUPEouMARTINIQUEouGUYANEouREUNION+1 de plusrequis
Territoire du lieu de travail effectif, déduit de
workPlaceou à défaut de l'adresse de l'établissement : il détermine les jours fériés applicables. - conventionalWorkerStatus01ou02ou03ou04ou05ou06+4 de plusrequis
- conventionalPositionrequis}
One of the following:
- SyntecPosition
- null
- weekDaysWorkednumberrequis
Bitset des jours travaillés, dérivé de
workSchedule(voirweek_days.ts). - workScheduleobjectrequis
Planning type de l'avenant : jours seuls ou horaire (voir
work_schedule.ts).- versionnumberrequis
- daysobjectrequis
Un jour absent de la carte n'est pas travaillé.
- MONDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- TUESDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- WEDNESDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- THURSDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- FRIDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- SATURDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- SUNDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- codePcsEserequis}
One of the following:
- CodePcsEse
- null
- applyJeiExonerationbooleanrequis
- applyAcreExonerationbooleanrequis
ACRE du dirigeant assimilé salarié : exonération salariale et patronale 12 mois.
- apprenticeshipFormationYearrequis
Année de formation couverte par l'avenant (alternance uniquement).
}One of the following:
- ApprenticeshipFormationYear
- null
- trialPeriodstableau deobjectrequis
Périodes d'essai (initiale puis renouvellement), par date de fin croissante
- idstringrequis
Identifiant Puncto de la période d'essai
- typeinitialourenewalrequis
Période initiale ou renouvellement
- initialEndDatestringrequis
Fin nominale : celle prévue au contrat, ou choisie au renouvellement
format: date - recalculatedEndDaterequis
Fin prolongée des absences validées, ou date de la validation anticipée ; null avant le premier recalcul
}One of the following:
- string
- null
- recalculationDaterequis
Date du dernier recalcul de la fin
}One of the following:
- string
- null
- validationDaterequis
Date de validation anticipée par l'employeur, null tant que la période n'est pas validée.
}One of the following:
- string
- null
- notificationSentAtrequis
Date d'envoi du rappel de fin de période d'essai à l'entreprise
}One of the following:
- string
- null
- createdAtstringrequis
Date d'enregistrement de la période dans Puncto
format: date-time
- endOfContractrequis
Clôture du contrat, null tant que le contrat n'est pas clôturé
}One of the following:
- PublicApiEndOfContract
- null
- ocAffiliationstableau deobjectrequis
Affiliations mutuelle et prévoyance du contrat, par date de début croissante
- ocAffiliationIdstringrequis
Identifiant Puncto de l'affiliation
- ocContractIdstringrequis
Contrat de mutuelle ou de prévoyance de l'entreprise auquel le salarié est affilié
- typeMUTUELLEouPREVOYANCErequis
Mutuelle ou prévoyance
- ocContractLabelstringrequis
Libellé du contrat de mutuelle ou de prévoyance
- startDatestringrequis
Date de début de l'affiliation
format: date - endDaterequis
Date de fin de l'affiliation, null si elle n'a pas de fin prévue
}One of the following:
- string
- null
- affiliationChoicestring | nullrequis
Formule de mutuelle choisie parmi celles du contrat :
UNIQUE,OPTION_<code>,CONDITION_<code>ou, quand plusieurs forfaits partagent une option,TIER_<code>__<libellé>. Null sans formule (prévoyance notamment). - forfaitLabelstring | nullrequis
Libellé de la formule choisie (à défaut, son code), null sans formule
- createdAtstringrequis
Date de création du contrat dans Puncto
format: date-time - updatedAtstringrequis
Date de dernière modification du contrat (hors avenants, périodes d'essai et clôture)
format: date-time
- ApiContractFull
- contractIdstringrequis
Identifiant Puncto
- collaboratorIdstringrequis
Identifiant Puncto
- firstNamestringrequis
- lastNamestringrequis
- usageFirstNamestring | nullrequis
- usageLastNamestring | nullrequis
- birthDatestringrequisformat: date
- skipRemunerationMinimumCheckbooleanrequis
Réglé par Puncto dans le backoffice : aucun contrôle de salaire minimum pour cette personne.
- endDaterequis}
One of the following:
- string
- null
- activationStatusC_INVITATION_SENTouA_TO_BE_REALIZEDouB_ACTION_NEEDEDouE_ARCHIVEDouD_ACTIVEouF_TO_CLOSE+1 de plusrequis
- grossAnnualSalarynumber | nullrequis
active amendment informations
- hourlyRatenumber | nullrequis
- weekDaysWorkednumber | nullrequis
- workSchedulerequis
planning type de l'avenant en vigueur, jours seuls ou horaire
}One of the following:
- WorkSchedule
- null
- frontendGrossAnnualSalarynumber | nullrequis
active or upcoming amendment informations
- frontendHourlyRatenumber | nullrequis
- frontendWeekDaysWorkednumber | nullrequis
- frontendWorkSchedulerequis}
One of the following:
- WorkSchedule
- null
- applyJeiExonerationbooleanrequis
- applyAcreExonerationbooleanrequis
ACRE du dirigeant assimilé salarié : exonération salariale et patronale 12 mois.
- trialPeriodstableau deobjectrequis
- idstringrequis
Identifiant Puncto de la période d'essai
- typeinitialourenewalrequis
Période initiale ou renouvellement
- initialEndDatestringrequis
Fin nominale : celle prévue au contrat, ou choisie au renouvellement
format: date - recalculatedEndDaterequis
Fin prolongée des absences validées, ou date de la validation anticipée ; null avant le premier recalcul
}One of the following:
- string
- null
- recalculationDaterequis
Date du dernier recalcul de la fin
}One of the following:
- string
- null
- validationDaterequis
Date de validation anticipée par l'employeur, null tant que la période n'est pas validée.
}One of the following:
- string
- null
- notificationSentAtrequis
Date d'envoi du rappel de fin de période d'essai à l'entreprise
}One of the following:
- string
- null
- createdAtstringrequis
Date d'enregistrement de la période dans Puncto
format: date-time
- companyRoleIdrequis}
One of the following:
- string
- null
- companyTeamIdrequis}
One of the following:
- string
- null
- managerrequis}
One of the following:
- ApiManagerInfos
- null
- imageKeystring | nullrequis
- foreignErpIdstring | nullrequis
- seniorityDaterequis}
One of the following:
- string
- null
- emailProstring | nullrequis
- addressstringrequis
- addressDetailsstring | nullrequis
- postalCodestringrequis
- citystringrequis
- countryCodeFRouGPouBLouMFouMQouGF+199 de plusrequis
- addressFullstringrequis
- phoneNumberstring | nullrequis
- dependentChildrenCountnumberrequis
- disabledDependentChildrenCountnumberrequis
Counted in
dependentChildrenCount. - maritalStatusrequis}
One of the following:
- MaritalStatus
- null
- birthCitystringrequis
- birthCountryCodeFRouGPouBLouMFouMQouGF+199 de plusrequis
- birthDepartmentCodestringrequis
- nationalityFRouGPouBLouMFouMQouGF+199 de plusrequis
- workPermitTyperequis
Titre valant autorisation de travail des salariés étrangers.
}One of the following:
- WorkPermitType
- null
- workPermitNumberstring | nullrequis
- workPermitExpirationDaterequis}
One of the following:
- string
- null
- socialSecurityNumberstring | nullrequis
- nttstring | nullrequis
- identityTyperequis}
One of the following:
- CollaboratorIdentityType
- null
- identityStartDaterequis}
One of the following:
- string
- null
- nextOpenPayrollMonthrequis}
One of the following:
- object
- null
- startDatestringrequisformat: date
- workerTyperequis}
One of the following:
- WorkerType
- null
- paymentOptionrequis}
One of the following:
- VirementPaymentOption
- CheckPaymentOption
- CashPaymentOption
- conventionalPositionrequis}
One of the following:
- SyntecPosition
- null
- quotityrequis}
One of the following:
- object
- object
- object
- object
- isCadrebooleanrequis
- conventionalWorkerStatusrequis}
One of the following:
- ConventionalWorkerStatus
- null
- codePcsEserequis}
One of the following:
- CodePcsEse
- null
- establishmentIdstringrequis
Identifiant Puncto
- endOfContractIdrequis}
One of the following:
- string
- null
- internshipStudiesstring | nullrequis
- internshipSchoolstring | nullrequis
- internshipTutorNamestring | nullrequis
Nom et prénoms du tuteur du stagiaire.
- remunerationrequis
Rémunération de l'avenant en vigueur.
}One of the following:
- AmendmentRemuneration
- null
- internshipPaidLeaveDaysnumber | nullrequis
Forfait de jours de congés payés stage accordés à la création du contrat.
- hasMutuelleDispensebooleanrequis
- corporateOfficerSalaryMaintenancebooleanrequis
Mandataire social uniquement : rémunération maintenue pendant les arrêts (maladie, accident, paternité), sous déduction des IJSS.
- publicTransportEmployerRatenumber | nullrequis
Taux de prise en charge employeur (%) des transports en commun propre au contrat,
null= taux de l'établissement. - mealVoucherStatusDEFAULTouDISABLEDrequis
- remoteWorkAllowanceStatusDEFAULTouDISABLEDrequis
- remoteWorkWeeklyDaysnumber | nullrequis
Nombre de jours de télétravail par semaine prévus au contrat.
- mealAllowanceTyperequis
Type de prime de panier versée au titre du contrat.
null= pas de prime de panier.}One of the following:
- MealAllowanceType
- null
- workPlacerequis
Lieu de travail effectif de l'avenant en vigueur, s'il diffère de l'établissement.
}One of the following:
- ContractWorkPlace
- null
- workTerritoryMETROPOLEouALSACE_MOSELLEouGUADELOUPEouMARTINIQUEouGUYANEouREUNION+1 de plusrequis
Territoire du lieu de travail effectif de l'avenant en vigueur.
- apprenticeshipFormationLevelrequis
Niveau de diplôme préparé (alternance uniquement).
}One of the following:
- ApprenticeshipFormationLevel
- null
- apprenticeshipFormationYearsPeriodsrequis
Périodes des années de formation (alternance uniquement).
}One of the following:
- ApprenticeshipFormationYearsPeriods
- null
- amendmentstableau deobjectrequis
- remunerationBasisANNUALouHOURLYouSMOOTHED_MONTHLYouPERCENTAGErequis
- grossAnnualSalarynumber | nullrequis
ANNUAL: salaire brut annuel. - hourlyRatenumber | nullrequis
HOURLY: taux horaire brut.SMOOTHED_MONTHLY: taux horaire contractuel, figé au début de la période de lissage. - smoothedMonthlyAmountnumber | nullrequis
SMOOTHED_MONTHLY: montant mensuel lissé. - smoothingPlannedHoursnumber | nullrequis
SMOOTHED_MONTHLY: heures prévues de la période de lissage, figées à son début. - remunerationPercentagenumber | nullrequis
PERCENTAGE: pourcentage de la référence, ex.53pour 53 %. - remunerationReferencerequis
PERCENTAGE: référence du pourcentage.}One of the following:
- RemunerationReference
- null
- idstringrequis
Identifiant Puncto
- companyRoleIdrequis}
One of the following:
- string
- null
- companyTeamIdrequis}
One of the following:
- string
- null
- establishmentIdstringrequis
Identifiant Puncto
- startDatestringrequisformat: date
- renewsCddTermbooleanrequis
- postponesCddTermbooleanrequis
- previousCddEndDaterequis}
One of the following:
- string
- null
- isCadrebooleanrequis
- mealVoucherStatusDEFAULTouDISABLEDrequis
- remoteWorkAllowanceStatusDEFAULTouDISABLEDrequis
- remoteWorkWeeklyDaysnumber | nullrequis
Nombre de jours de télétravail par semaine prévus au contrat.
- mealAllowanceTyperequis
Type de prime de panier versée au titre du contrat.
null= pas de prime de panier.}One of the following:
- MealAllowanceType
- null
- quotityrequis}
One of the following:
- object
- object
- object
- object
- workerOutsideFranceStatus01ou02ou03ou99requis
- workPlacerequis
Lieu de travail effectif, quand il diffère de l'établissement de rattachement.
}One of the following:
- ContractWorkPlace
- null
- workTerritoryMETROPOLEouALSACE_MOSELLEouGUADELOUPEouMARTINIQUEouGUYANEouREUNION+1 de plusrequis
Territoire du lieu de travail effectif, déduit de
workPlaceou à défaut de l'adresse de l'établissement : il détermine les jours fériés applicables. - conventionalWorkerStatus01ou02ou03ou04ou05ou06+4 de plusrequis
- conventionalPositionrequis}
One of the following:
- SyntecPosition
- null
- weekDaysWorkednumberrequis
Bitset des jours travaillés, dérivé de
workSchedule(voirweek_days.ts). - workScheduleobjectrequis
Planning type de l'avenant : jours seuls ou horaire (voir
work_schedule.ts).- versionnumberrequis
- daysobjectrequis
Un jour absent de la carte n'est pas travaillé.
- MONDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- TUESDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- WEDNESDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- THURSDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- FRIDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- SATURDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- SUNDAYoptionnelobject
- morningrequis}
One of the following:
- WorkScheduleTimeRange
- null
- afternoonrequis}
One of the following:
- WorkScheduleTimeRange
- null
- codePcsEserequis}
One of the following:
- CodePcsEse
- null
- applyJeiExonerationbooleanrequis
- applyAcreExonerationbooleanrequis
ACRE du dirigeant assimilé salarié : exonération salariale et patronale 12 mois.
- apprenticeshipFormationYearrequis
Année de formation couverte par l'avenant (alternance uniquement).
}One of the following:
- ApprenticeshipFormationYear
- null