Créer un collaborateur et son premier contrat
Crée le collaborateur, son compte et son premier contrat, en tout ou rien.
Ensuite, Puncto invite le collaborateur (email personnel) si le contrat commence sous 2 jours ou a commencé, et dépose la DPAE si dpaeDoneByPuncto est true et que le contrat commence sous 8 jours. Un échec de ces envois n’annule pas la création.
Collaborateur déjà connu (même foreignErpId ou numéro de sécurité sociale) : 409 avec son collaboratorId. Créez alors son contrat avec POST /public/v1/contracts. Voir le guide des contrats.
https://api.puncto.fr/public/v1/collaboratorsAuthentification
Corps de la requête JSON requis
- contractobjectrequis
Premier contrat, mêmes champs que
POST /public/v1/contracts.- workerTypeEMPLOYEE_CDIouEMPLOYEE_CDDouAPPRENTICESHIP_CONTRACTouINTERNouCORPORATE_OFFICERrequis
Type de contrat. Le contrat de professionnalisation n’est pas encore pris en charge.
EMPLOYEE_CDI: Salarié - CDIEMPLOYEE_CDD: Salarié - CDDAPPRENTICESHIP_CONTRACT: Alternant - ApprentissageINTERN: StagiaireCORPORATE_OFFICER: Dirigeant (Mandat social)
- dpaeDoneByPunctobooleanrequis
true: Puncto dépose la DPAE (CDI, CDD, apprentissage), à la création si le contrat commence sous 8 jours ou a commencé, sinon 8 jours avant. Exige un NIR ou NIA à la date de début : sans numéro (NTT),truerenvoie400.false: vous la déposez. Sans effet pour un stage ou un mandat social. - cddMotifoptionnel01ou02ou03ou04ou05ou06+9 de plus
Motif de recours, obligatoire pour un CDD.
01: 01 - Remplacement d'un salarié02: 02 - Accroissement temporaire de l'activité de l'entreprise03: 03 - Emplois à caractère saisonnier04: 04 - Contrat vendanges05: 05 - Contrat d'usage06: 06 - Contrat à durée déterminée à objet défini07: 07 - Remplacement d'un chef d'entreprise08: 08 - Remplacement du chef d'une exploitation agricole09: 09 - Recrutement de personnes sans emploi rencontrant des difficultés sociales et professionnelles particulières10: 10 - Complément de formation professionnelle au salarié11: 11 - Formation professionnelle au salarié par la voie de l'apprentissage, en vue de l'obtention d'une qualification professionnelle sanctionnée par un diplôme ou un titre à finalité professionnelle enregistré au répertoire national des certifications professionnelles12: 12 - Remplacement d'un salarié passé provisoirement à temps partiel13: 13 - Attente de la suppression définitive du poste du salarié ayant quitté définitivement l'entreprise14: 14 - Contrat de voyage15: 15 - Recrutement d'un intérimaire en sa qualité de BOETH
- trialPeriodEndDateoptionnelstring
Fin de la période d’essai initiale, au plus tôt la date de début et, avec une position conventionnelle, au plus tard le maximum conventionnel. Apprentissage : sa présence suffit, la fin est calculée (45 jours en entreprise). Refusée pour un stage et un mandat social.
format: date - amendmentoptionnelobject
Conditions du contrat à sa date de début. Obligatoire, sauf en apprentissage (voir
amendments). Rémunération :grossAnnualSalary(CDI, CDD, mandat social) ouhourlyRate/smoothedMonthlyAmount(stage).- conventionalWorkerStatus01ou02ou03ou04ou05ou06+4 de plusrequis
Statut conventionnel DSN, en général
04cadre,03cadre dirigeant ou mandataire social,07stagiaire,05sinon.03et04exigent"isCadre": true;05à07,false.01: 01 - agriculteur salarié de son exploitation02: 02 - artisan ou commerçant salarié de son entreprise03: 03 - cadre dirigeant (votant au collège employeur des élections prud'homales)04: 04 - autres cadres au sens de la convention collective (ou du statut pour les régimes spéciaux)05: 05 - profession intermédiaire (technicien, contremaître, agent de maîtrise, clergé)06: 06 - employé administratif d'entreprise, de commerce, agent de service07: 07 - ouvriers qualifiés et non qualifiés y compris ouvriers agricoles08: 08 - agent de la fonction publique d'Etat09: 09 - agent de la fonction publique hospitalière10: 10 - agent de la fonction publique territoriale
- apprenticeshipFormationLeveloptionnel03ou04ou05ou06ou07ou08
Contrat d’apprentissage uniquement : niveau du diplôme préparé, obligatoire.
03: 03 - Niveau de formation équivalent au CAP (certificat d'aptitude professionnelle) ou au BEP (brevet d'études professionnelles)04: 04 - Formation de niveau du bac (général, technologique ou professionnel), du brevet de technicien (BT) ou du brevet professionnel05: 05 - Formation de niveau bac+2 : licence 2, BTS (brevet de technicien supérieur), DUT (diplôme universitaire de technologie), etc.06: 06 - Formation de niveau bac+3 et bac+4 : licence 3, licence professionnelle, master 1, etc.07: 07 - Formation de niveau bac+5 : master 2, diplôme d'études approfondies, diplôme d'études supérieures spécialisées, diplôme d'ingénieur, etc.08: 08 - Formation de niveau bac+8 : doctorat, habilitation à diriger des recherches, etc.
- amendmentsoptionneltableau deobject
Apprentissage uniquement, obligatoire : un avenant par année de
apprenticeshipFormationYearsPeriods, commençant au début de cette année.- conventionalWorkerStatus01ou02ou03ou04ou05ou06+4 de plusrequis
Statut conventionnel DSN, en général
04cadre,03cadre dirigeant ou mandataire social,07stagiaire,05sinon.03et04exigent"isCadre": true;05à07,false.01: 01 - agriculteur salarié de son exploitation02: 02 - artisan ou commerçant salarié de son entreprise03: 03 - cadre dirigeant (votant au collège employeur des élections prud'homales)04: 04 - autres cadres au sens de la convention collective (ou du statut pour les régimes spéciaux)05: 05 - profession intermédiaire (technicien, contremaître, agent de maîtrise, clergé)06: 06 - employé administratif d'entreprise, de commerce, agent de service07: 07 - ouvriers qualifiés et non qualifiés y compris ouvriers agricoles08: 08 - agent de la fonction publique d'Etat09: 09 - agent de la fonction publique hospitalière10: 10 - agent de la fonction publique territoriale
- maritalStatusoptionnelSINGLEouMARRIEDouCIVIL_PARTNERSHIPouCOHABITINGouSEPARATEDouDIVORCED+1 de plus
Situation matrimoniale, facultative. Puncto la conserve sans encore s’en servir dans la paie.
SINGLE: CélibataireMARRIED: Marié(e)CIVIL_PARTNERSHIP: Pacsé(e)COHABITING: En concubinageSEPARATED: Séparé(e)DIVORCED: Divorcé(e)WIDOWED: Veuf ou veuve
Retour
201
Collaborateur et contrat créés
- collaboratorobjectrequis
Collaborateur créé
- identityrequis
Identité sociale en vigueur (NIR, NIA ou NTT). Pour un collaborateur dont l'embauche n'a pas encore commencé, sa première identité, qui prend effet le 1er du mois de son entrée.
}One of the following:
- ApiCollaboratorIdentity
- typeNTTouNIAouNIRrequis
- numerostringrequis
- startDatestringrequisformat: date
- null
- contractobjectrequis
Premier contrat du collaborateur, ses valeurs en vigueur résolues à sa date de début
- currentAmendmentrequis
Avenant en vigueur à
referenceDate, null avant le premier avenant}One of the following:
- ApiContractAmendment
- 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
- null
- amendmentstableau deobjectrequis
Tous les avenants du contrat, avenants à venir compris, du plus ancien au plus récent
- workPlacerequis
Lieu de travail effectif, quand il diffère de l'établissement de rattachement.
}One of the following:
- ContractWorkPlace
- addressstringrequis
- addressDetailsstring | nullrequis
- postalCodestringrequis
- citystringrequis
- countryCodeFRouGPouBLouMFouMQouGF+199 de plusrequis
- inseeCodestring | nullrequis
- null
- workScheduleobjectrequis
Planning type de l'avenant : jours seuls ou horaire (voir
work_schedule.ts).
- endOfContractrequis
Clôture du contrat, null tant que le contrat n'est pas clôturé
}One of the following:
- PublicApiEndOfContract
- endOfContractIdstringrequis
Identifiant Puncto de la clôture
- endDatestringrequis
Date de fin du contrat déclarée en DSN (S21.G00.62.001), préavis compris
format: date - lastWorkedDayrequis
Dernier jour travaillé, antérieur à la date de fin quand le préavis n'est pas effectué
}One of the following:
- string
- null
- finalSettlementPayrollDatestringrequis
Date du mois de paie qui porte le solde de tout compte
format: date - terminationReason011ou012ou014ou015ou020ou025+43 de plusrequis
Motif de la rupture déclaré en DSN (S21.G00.62.002)
- terminationInitiatorCOMPANYouCOLLABORATORouMUTUAL_AGREEMENTrequis
Initiative de la rupture
- notificationDaterequis
Date de notification de la rupture (S21.G00.62.003)
}One of the following:
- string
- null
- layoffProcedureStartDaterequis
Licenciement : date de l'entretien préalable
}One of the following:
- string
- null
- terminationAgreementSignatureDaterequis
Rupture conventionnelle : date de signature de la convention (S21.G00.62.004)
}One of the following:
- string
- null
- plannedEndDaterequis
CDD : terme prévu au moment de la clôture, null hors CDD
}One of the following:
- string
- null
- noticePeriodTyperequis
Type de préavis déclaré en DSN (bloc S21.G00.63)
}One of the following:
- DsnPreavisType
- null
- noticeSituationrequis
Aménagement du préavis : dispense, raccourcissement, prolongation ou refus
}One of the following:
- NoticePeriodSituation
- null
- noticePeriodStartDaterequis
Date de début du préavis
}One of the following:
- string
- null
- noticePeriodEndDaterequis
Date de fin du préavis déclarée en DSN
}One of the following:
- string
- null
- permanentContractOutcomeNONEouCONTINUEDouREFUSEDrequis
CDD : issue de la proposition de CDI au terme
- precarityBonusDuebooleanrequis
CDD : la clôture ouvre droit à l'indemnité de fin de contrat (prime de précarité)
- leaveCarriedOverbooleanrequis
CDD poursuivi en CDI : les compteurs de congés sont repris par le CDI au lieu d'être soldés
- dismissalIndemnityAmountnumber | nullrequis
Indemnité de licenciement calculée, en euros : le plus favorable du montant légal et du montant Syntec. Null quand aucun calcul n'a été fait.
- finalSettlementPaymentDaterequis
Date de paiement du solde de tout compte
}One of the following:
- string
- null
- mutuellePortabilitybooleanrequis
Portabilité de la mutuelle activée
- prevoyancePortabilitybooleanrequis
Portabilité de la prévoyance activée
- finalSettlementPayslipIdrequis
Bulletin de paie du solde de tout compte, null tant qu'il n'existe pas
}One of the following:
- string
- null
- finalSettlementReceiptFileIdrequis
Document du reçu pour solde de tout compte, null tant qu'il n'est pas généré
}One of the following:
- string
- null
- workCertificateFileIdrequis
Document du certificat de travail, null tant qu'il n'est pas généré
}One of the following:
- string
- null
- createdAtstringrequis
Date d'enregistrement de la clôture dans Puncto
format: date-time - updatedAtstringrequis
Date de dernière modification de la clôture
format: date-time
- null