Créer un collaborateur

Cette page décrit en détail le processus de création d’un collaborateur via l’API :
le point de terminaison, les règles de validation, et des exemples de réponse.

🔧 Point de terminaison

Appeler le point de terminaison POST

/HR/employees

✅ Champs avec règles de validation particulières

Champ	Type	Format	Description
has_timesheets	boolean	—	Obligatoire si is_consultant = true
timesheets_frequency_code	integer	int32	Obligatoire si has_timesheets = true
vehicle_type_code	string	—	Obligatoire si use_vehicle = true
vehicle_tax_horsepower_code	string	—	Obligatoire si use_vehicle = true
vehicle_registration_number	string	—	Obligatoire si use_vehicle = true
vehicle_price_per_km	number	double	Obligatoire si use_vehicle = true

📬 Réponses de l’API

✔️ 201 — Succès

{
  "guid_employee": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "id_employee": 42,
  "is_standby": true
}

La propriété is_standby indique que le collaborateur est en attente d'intégration.

❌ 401 — Non autorisé

{
  "error": "INCORRECT_DEPARTMENT",
  "details": "The department is incorrect.",
}

❌ 409 — Conflit

{
  "error": "BUSINESS_EMAIL_IN_USE",
  "details": "The business email is already used.",
}