Introduction
Vous pouvez créer des salariés dans l'application même si ils n'ont pas encore ou plus de contrat.
Si vous avez créé vos établissements via chargement DSN, les salariés dans l'effectif lors de la génération de ces DSN et leur contrat ont été automatiquement créés dans l'application
Création d'un employé
Données en entrée
- Données d'état civil de l'employé à créer
- Le code du département de naissance à fournir peut être récupéré depuis l'API
- Identifiant de l'établissement sur lequel rattacher l'employé
Récupérer l'identifiant d'un établissement
Exemple de création
curl --location --request POST '<Environnement>/api/employees' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"prenom": "<Prénom employé>",
"nomNaissance": "<Nom employé>",
"numeroSecuriteSociale": "<Numéro de sécurité sociale employée>,"
"etablissement": "/api/etablissements/<ID Etablissement>",
"genre": "MALE",
"dateNaissance": "<Date de naissance au format AAAA-MM-JJ>",
"lieuNaissance": "<Ville de naissance>",
"departementNaissance": "/api/departements/<Code du département de naissance sur 2 à 3 caractères>",
"codificationUE": "01", "#01 pour un ressortissant français, 02 pour UE, 03 pour EEE, 04 sinon",
"adresse": {
"adresse": "<Adresse de résidence>",
"codePostal": "<Code postal>",
"ville": "<Ville>"
},
"coordonneesBancaires": {
"methodePaiement": "VIREMENT", "#VIREMENT, VIREMENT_INDIVIDUEL ou CHEQUE",
"jourVirement": 31, "#jour usuel de virement du salaire",
"moisVirement": "MOIS_COURANT", "#
"iban": <IBAN pour les paiments>,
"bic": <BIC pour les paiments>,
}
}'
Retour
{
"matricule": "!Matricule!",
"id": "ID de l'employé!"
}
Si vous ne mettez pas de matricule, alors un matricule sera automatiquement généré pour votre employé. De plus il y a une contrainte d'unicité sur le matricule, vous ne pouvez pas créer un employé avec un matricule déjà existant.
Donnée à conserver
- Identifiant technique du salarié pour pouvoir lui ajouter un contrat
Retrouver les ID d'employés créés
Modification d'un salarié
La modification nécessite la connaissance de l'ID du salarié.
curl --location --request PUT '<Environnement>/api/employees/<ID employé à modifier>' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data-raw '{
<Attributs et valeurs à mettre à jour>
}'