POST_work_contract.php 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341
  1. <?php
  2. /**
  3. * Endpoint pour créer un contrat de travail (work-contract) Lucca
  4. *
  5. * Méthode : POST
  6. * Body JSON minimum requis : {
  7. * "ownerId": 416,
  8. * "typeId": 1,
  9. * "startsOn": "2025-01-01",
  10. * "establishmentId": 13,
  11. * // Champs requis mais peuvent être null :
  12. * "endsOn": null,
  13. * "externalId": null,
  14. * "spcId": null,
  15. * "hiringTypeId": null,
  16. * "trialPeriodDays": null,
  17. * "renewedTrialPeriodDays": null,
  18. * "trialPeriodEndDate": null,
  19. * "trialPeriodEndDate2": null,
  20. * "temporaryContractGroundId": null,
  21. * "internshipSupervisorId": null,
  22. * "terminationReasonId": null
  23. * }
  24. *
  25. * Champs optionnels (selon le typeId du contrat) :
  26. * - externalId: Identifiant externe (peut ne pas être unique)
  27. * - spcId: ID de la catégorie socio-professionnelle
  28. * - hiringTypeId: ID du type d'embauche
  29. * - trialPeriodDays: Nombre de jours de période d'essai initiale
  30. * - renewedTrialPeriodDays: Nombre de jours de période d'essai renouvelée
  31. * - trialPeriodEndDate: Date de fin de période d'essai (YYYY-MM-DD)
  32. * - trialPeriodEndDate2: Date de fin de période d'essai renouvelée (YYYY-MM-DD)
  33. * - temporaryContractGroundId: ID du motif de contrat temporaire
  34. * - internshipSupervisorId: ID du superviseur de stage
  35. * - endsOn: Date de fin du contrat (YYYY-MM-DD), null si indéterminé
  36. * - terminationReasonId: ID de la raison de fin de contrat
  37. *
  38. * Vérifications automatiques :
  39. * - Vérifie si l'utilisateur (ownerId) existe
  40. * - Vérifie qu'il n'y a pas déjà un contrat applicable pour cet utilisateur (optionnel)
  41. *
  42. * Réponse : {"success": true, "work_contract": {...}}
  43. * Erreur 409 : {"error": "Un contrat applicable existe déjà pour cet utilisateur", "existing_contract": {...}}
  44. */
  45. // Activation du débogage
  46. ini_set('display_errors', 1);
  47. ini_set('display_startup_errors', 1);
  48. error_reporting(E_ALL);
  49. // ⚙️ CONFIGURATION - Activer/désactiver le bouchon de test
  50. define('USE_TEST_DATA', false); // Mettre à true pour utiliser les données de test, false pour les vraies requêtes
  51. function json_response(int $statusCode, array $payload): void {
  52. http_response_code($statusCode);
  53. header('Content-Type: application/json; charset=utf-8');
  54. echo json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
  55. exit;
  56. }
  57. // Charge le client API Lucca
  58. require_once __DIR__ . '/lucca_client.php';
  59. // Récupère le JSON en entrée
  60. $input = json_decode(file_get_contents("php://input"), true);
  61. // BOUCHON POUR TEST - Contrôlé par la constante USE_TEST_DATA
  62. if (USE_TEST_DATA) {
  63. $input = [
  64. // Champs vraiment obligatoires (non-null)
  65. "ownerId" => 416, // ⚠️ Remplacez par un ID utilisateur valide
  66. "typeId" => 1, // ⚠️ Remplacez par un ID de type de contrat valide
  67. "startsOn" => "2025-01-01", // Format YYYY-MM-DD
  68. "establishmentId" => 13, // ⚠️ Remplacez par un ID d'établissement valide
  69. // Champs requis mais peuvent être null
  70. "endsOn" => null, // Date de fin, null si indéterminé
  71. "externalId" => null,
  72. "spcId" => null,
  73. "hiringTypeId" => null,
  74. "trialPeriodDays" => 120,
  75. "renewedTrialPeriodDays" => null,
  76. "trialPeriodEndDate" => "2025-05-01",
  77. "trialPeriodEndDate2" => null,
  78. "temporaryContractGroundId" => null,
  79. "internshipSupervisorId" => null,
  80. "terminationReasonId" => null
  81. ];
  82. }
  83. // Vérification que le JSON est valide
  84. if (!is_array($input)) {
  85. json_response(400, [
  86. "error" => "JSON invalide ou vide",
  87. "message" => "Le corps de la requête doit contenir un JSON valide"
  88. ]);
  89. }
  90. // Validation des champs vraiment obligatoires (non-nullable)
  91. $required_non_null_fields = [
  92. 'ownerId', 'typeId', 'startsOn', 'establishmentId'
  93. ];
  94. // Validation des champs qui doivent être présents (mais peuvent être null)
  95. $required_nullable_fields = [
  96. 'endsOn', 'externalId', 'spcId', 'hiringTypeId', 'trialPeriodDays',
  97. 'renewedTrialPeriodDays', 'trialPeriodEndDate', 'trialPeriodEndDate2',
  98. 'temporaryContractGroundId', 'internshipSupervisorId', 'terminationReasonId'
  99. ];
  100. $missing_fields = [];
  101. $empty_required_fields = [];
  102. // Vérifie les champs non-null
  103. foreach ($required_non_null_fields as $field) {
  104. if (!array_key_exists($field, $input)) {
  105. $missing_fields[] = $field;
  106. } elseif (empty($input[$field]) && $input[$field] !== 0) {
  107. $empty_required_fields[] = $field;
  108. }
  109. }
  110. // Vérifie que les champs nullable sont au moins présents
  111. foreach ($required_nullable_fields as $field) {
  112. if (!array_key_exists($field, $input)) {
  113. $missing_fields[] = $field;
  114. }
  115. }
  116. if (!empty($missing_fields)) {
  117. json_response(400, [
  118. "error" => "Champs requis manquants",
  119. "missing_fields" => $missing_fields,
  120. "required_non_null" => $required_non_null_fields,
  121. "required_nullable" => $required_nullable_fields
  122. ]);
  123. }
  124. if (!empty($empty_required_fields)) {
  125. json_response(400, [
  126. "error" => "Champs requis vides",
  127. "empty_fields" => $empty_required_fields
  128. ]);
  129. }
  130. // Validation du format des dates
  131. $date_fields = ['startsOn', 'endsOn', 'trialPeriodEndDate', 'trialPeriodEndDate2'];
  132. foreach ($date_fields as $field) {
  133. if (isset($input[$field]) && $input[$field] !== null) {
  134. // Vérifie le format YYYY-MM-DD
  135. if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $input[$field])) {
  136. json_response(400, [
  137. "error" => "Format de date invalide pour le champ '$field'",
  138. "expected_format" => "YYYY-MM-DD",
  139. "received" => $input[$field]
  140. ]);
  141. }
  142. }
  143. }
  144. // ✅ Vérification si l'utilisateur existe
  145. $check_user_result = lucca_request('GET', '/api/v3/users/' . $input['ownerId'], [
  146. 'fields' => 'id,name,login'
  147. ], null, 60, false);
  148. // Si l'utilisateur n'existe pas
  149. if ($check_user_result['code'] === 404) {
  150. json_response(404, [
  151. "error" => "L'utilisateur spécifié n'existe pas",
  152. "ownerId" => $input['ownerId'],
  153. "message" => "Vérifiez que l'ID utilisateur est correct"
  154. ]);
  155. }
  156. // Si la vérification a échoué (timeout, erreur réseau, etc.)
  157. if (!empty($check_user_result['error']) || $check_user_result['code'] === 0) {
  158. json_response(503, [
  159. "error" => "Impossible de vérifier si l'utilisateur existe",
  160. "message" => "Erreur de connexion à l'API Lucca lors de la vérification",
  161. "details" => $check_user_result['error'] ?? "Aucune réponse du serveur",
  162. "curl_info" => $check_user_result['curl_info'] ?? null
  163. ]);
  164. }
  165. // ✅ Vérification optionnelle : contrat applicable existant
  166. // Note: Cette vérification peut être désactivée si on veut permettre plusieurs contrats applicables
  167. $check_contracts_result = lucca_request('GET', '/directory/api/4.0/work-contracts', [
  168. 'ownerId' => $input['ownerId'],
  169. 'isApplicable' => 'true',
  170. 'limit' => 1
  171. ], null, 60, false);
  172. if ($check_contracts_result['code'] === 200 &&
  173. isset($check_contracts_result['data']['items']) &&
  174. is_array($check_contracts_result['data']['items']) &&
  175. count($check_contracts_result['data']['items']) > 0) {
  176. $existing_contract = $check_contracts_result['data']['items'][0];
  177. json_response(409, [
  178. "error" => "Un contrat applicable existe déjà pour cet utilisateur",
  179. "existing_contract" => [
  180. "id" => $existing_contract['id'] ?? null,
  181. "ownerId" => $existing_contract['ownerId'] ?? null,
  182. "startsOn" => $existing_contract['startsOn'] ?? null,
  183. "endsOn" => $existing_contract['endsOn'] ?? null,
  184. "typeId" => $existing_contract['typeId'] ?? null,
  185. "establishmentId" => $existing_contract['establishmentId'] ?? null
  186. ],
  187. "suggestion" => "Pour créer un nouveau contrat, vous pouvez soit terminer le contrat existant (en définissant une endsOn), soit créer un contrat avec une date de début future"
  188. ]);
  189. }
  190. // Prépare le body pour la requête POST
  191. $body = [
  192. "ownerId" => (int)$input["ownerId"],
  193. "typeId" => (int)$input["typeId"],
  194. "startsOn" => $input["startsOn"],
  195. "establishmentId" => (int)$input["establishmentId"],
  196. "endsOn" => $input["endsOn"],
  197. "externalId" => $input["externalId"],
  198. "spcId" => $input["spcId"] !== null ? (int)$input["spcId"] : null,
  199. "hiringTypeId" => $input["hiringTypeId"] !== null ? (int)$input["hiringTypeId"] : null,
  200. "trialPeriodDays" => $input["trialPeriodDays"] !== null ? (int)$input["trialPeriodDays"] : null,
  201. "renewedTrialPeriodDays" => $input["renewedTrialPeriodDays"] !== null ? (int)$input["renewedTrialPeriodDays"] : null,
  202. "trialPeriodEndDate" => $input["trialPeriodEndDate"],
  203. "trialPeriodEndDate2" => $input["trialPeriodEndDate2"],
  204. "temporaryContractGroundId" => $input["temporaryContractGroundId"] !== null ? (int)$input["temporaryContractGroundId"] : null,
  205. "internshipSupervisorId" => $input["internshipSupervisorId"] !== null ? (int)$input["internshipSupervisorId"] : null,
  206. "terminationReasonId" => $input["terminationReasonId"] !== null ? (int)$input["terminationReasonId"] : null
  207. ];
  208. // Requête POST vers l'API Lucca pour créer un work-contract
  209. // Documentation: https://developers.lucca.fr/api-reference/directory/create-a-work-contract
  210. $result = lucca_request('POST', '/directory/api/4.0/work-contracts', [], $body, 60, false);
  211. // ✅ Gestion unifiée des erreurs
  212. if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) ||
  213. ($result['code'] !== 200 && $result['code'] !== 201)) {
  214. $error_response = [
  215. "error" => "Erreur lors de la création du contrat de travail",
  216. "http_code" => $result['code']
  217. ];
  218. // Déterminer le message d'erreur le plus pertinent
  219. if (!empty($result['error'])) {
  220. $error_response['message'] = $result['error'];
  221. } elseif (!empty($result['lucca_error'])) {
  222. $error_response['message'] = $result['lucca_error'];
  223. } elseif (!empty($result['error_message'])) {
  224. $error_response['message'] = $result['error_message'];
  225. } elseif (isset($result['data']['title'])) {
  226. $error_response['message'] = $result['data']['title'];
  227. } elseif (isset($result['data']['message'])) {
  228. $error_response['message'] = $result['data']['message'];
  229. } else {
  230. $error_response['message'] = "Erreur inconnue";
  231. }
  232. // Ajouter tous les détails disponibles de l'erreur Lucca
  233. if (!empty($result['lucca_error'])) {
  234. $error_response['lucca_error_header'] = $result['lucca_error'];
  235. }
  236. // Ajouter tous les headers de réponse pour diagnostic complet
  237. if (!empty($result['headers'])) {
  238. $error_response['response_headers'] = $result['headers'];
  239. }
  240. // Ajouter les détails complets de la réponse si disponibles
  241. if (!empty($result['data'])) {
  242. $error_response['lucca_response'] = $result['data'];
  243. }
  244. // Ajouter le body brut pour diagnostic
  245. if (!empty($result['body'])) {
  246. $error_response['raw_response_body'] = $result['body'];
  247. }
  248. // Ajouter les informations curl pour diagnostic
  249. if (!empty($result['curl_info'])) {
  250. $error_response['curl_info'] = $result['curl_info'];
  251. }
  252. // Ajouter l'URL complète de la requête pour diagnostic
  253. if (!empty($result['curl_info']['url'])) {
  254. $error_response['request_url'] = $result['curl_info']['url'];
  255. }
  256. // Ajouter le body envoyé pour diagnostic
  257. $error_response['request_body_sent'] = $body;
  258. // Suggestion pour les erreurs 403 (problème de permissions)
  259. if ($result['code'] === 403) {
  260. $error_response['suggestion'] = "Erreur 403 Forbidden : Le token API n'a pas les permissions nécessaires pour créer des contrats de travail.";
  261. $error_response['solution'] = [
  262. "1" => "Vérifiez que le token API a les droits d'écriture sur les contrats de travail",
  263. "2" => "Dans Lucca, allez dans : Configuration > API > Applications tierces",
  264. "3" => "Vérifiez les permissions accordées au token",
  265. "4" => "Le token doit avoir au minimum les permissions : 'Work Contracts - Write' ou 'Admin'"
  266. ];
  267. }
  268. // Suggestion pour les erreurs 400 (probablement des champs manquants ou invalides)
  269. if ($result['code'] === 400) {
  270. $error_response['suggestion'] = "Une erreur 400 peut indiquer des champs manquants, invalides ou des IDs inexistants.";
  271. $error_response['fields_sent'] = $body;
  272. $error_response['check'] = [
  273. "typeId" => "Vérifiez que ce type de contrat existe dans votre instance Lucca",
  274. "establishmentId" => "Vérifiez que cet établissement existe",
  275. "dates" => "Vérifiez que les dates sont au format YYYY-MM-DD et cohérentes",
  276. "required_fields" => "Certains champs peuvent être requis selon le typeId du contrat"
  277. ];
  278. }
  279. // Suggestion pour les erreurs 500 (probablement des IDs invalides)
  280. if ($result['code'] === 500) {
  281. $error_response['suggestion'] = "Une erreur 500 peut indiquer des IDs invalides. Vérifiez que les IDs suivants existent dans votre instance Lucca :";
  282. $error_response['ids_to_verify'] = [
  283. "ownerId" => $body['ownerId'] ?? null,
  284. "typeId" => $body['typeId'] ?? null,
  285. "establishmentId" => $body['establishmentId'] ?? null,
  286. "spcId" => $body['spcId'] ?? null,
  287. "hiringTypeId" => $body['hiringTypeId'] ?? null,
  288. "internshipSupervisorId" => $body['internshipSupervisorId'] ?? null
  289. ];
  290. }
  291. json_response($result['code'] ?: 500, $error_response);
  292. }
  293. // Récupère le contrat créé depuis le data déjà parsé
  294. $work_contract = $result['data'] ?? null;
  295. // Réponse finale
  296. json_response(201, [
  297. "success" => true,
  298. "message" => "Contrat de travail créé avec succès",
  299. "work_contract" => $work_contract
  300. ]);