PUT_work_contract.php 9.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285
  1. <?php
  2. /**
  3. * Endpoint pour mettre à jour un contrat de travail (work-contract) Lucca
  4. *
  5. * Méthode : PUT/PATCH
  6. * Paramètre Query requis :
  7. * - id: ID du contrat de travail à modifier
  8. *
  9. * Body JSON : Seuls les champs à modifier doivent être envoyés
  10. * {
  11. * "endsOn": "2025-12-31",
  12. * "terminationReasonId": 5
  13. * }
  14. *
  15. * Champs modifiables :
  16. * - externalId: string|null
  17. * - typeId: integer
  18. * - startsOn: string (date YYYY-MM-DD)
  19. * - endsOn: string|null (date YYYY-MM-DD)
  20. * - establishmentId: integer
  21. * - spcId: integer|null
  22. * - hiringTypeId: integer|null
  23. * - trialPeriodDays: integer|null
  24. * - renewedTrialPeriodDays: integer|null
  25. * - trialPeriodEndDate: string|null (date YYYY-MM-DD)
  26. * - trialPeriodEndDate2: string|null (date YYYY-MM-DD)
  27. * - temporaryContractGroundId: integer|null
  28. * - internshipSupervisorId: integer|null
  29. * - terminationReasonId: integer|null
  30. *
  31. * Champs en lecture seule (non modifiables) :
  32. * - id, ownerId, isApplicable, authorId, createdAt, lastModifierId, lastModifiedAt
  33. *
  34. * Exemples d'URLs :
  35. * - update_work_contract.php?id=514
  36. *
  37. * Réponse : {
  38. * "success": true,
  39. * "message": "Contrat de travail mis à jour avec succès",
  40. * "work_contract": {...}
  41. * }
  42. */
  43. // Activation du débogage
  44. ini_set('display_errors', 1);
  45. ini_set('display_startup_errors', 1);
  46. error_reporting(E_ALL);
  47. // ⚙️ CONFIGURATION - Activer/désactiver le bouchon de test
  48. define('USE_TEST_DATA', false); // Mettre à true pour utiliser les données de test
  49. function json_response(int $statusCode, array $payload): void {
  50. http_response_code($statusCode);
  51. header('Content-Type: application/json; charset=utf-8');
  52. echo json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
  53. exit;
  54. }
  55. // Charge le client API Lucca
  56. require_once __DIR__ . '/../lucca_client.php';
  57. // Vérification du paramètre ID
  58. if (!isset($_GET['id']) || empty($_GET['id'])) {
  59. json_response(400, [
  60. "error" => "Paramètre 'id' manquant",
  61. "message" => "Vous devez fournir l'ID du contrat de travail à modifier",
  62. "usage" => "update_work_contract.php?id=514"
  63. ]);
  64. }
  65. $workContractId = (int)$_GET['id'];
  66. if ($workContractId <= 0) {
  67. json_response(400, [
  68. "error" => "ID invalide",
  69. "message" => "L'ID doit être un nombre entier positif",
  70. "received" => $_GET['id']
  71. ]);
  72. }
  73. // Récupère le JSON en entrée
  74. $input = json_decode(file_get_contents("php://input"), true);
  75. // BOUCHON POUR TEST
  76. if (USE_TEST_DATA) {
  77. $input = [
  78. "endsOn" => "2025-12-31",
  79. "terminationReasonId" => 5
  80. ];
  81. }
  82. // Vérification que le JSON est valide
  83. if (!is_array($input)) {
  84. json_response(400, [
  85. "error" => "JSON invalide ou vide",
  86. "message" => "Le corps de la requête doit contenir un JSON valide"
  87. ]);
  88. }
  89. // Vérification qu'au moins un champ est fourni
  90. if (empty($input)) {
  91. json_response(400, [
  92. "error" => "Aucun champ à modifier",
  93. "message" => "Le corps de la requête doit contenir au moins un champ à modifier"
  94. ]);
  95. }
  96. // Liste des champs modifiables
  97. $modifiable_fields = [
  98. 'externalId', 'typeId', 'startsOn', 'endsOn', 'establishmentId', 'spcId',
  99. 'hiringTypeId', 'trialPeriodDays', 'renewedTrialPeriodDays',
  100. 'trialPeriodEndDate', 'trialPeriodEndDate2', 'temporaryContractGroundId',
  101. 'internshipSupervisorId', 'terminationReasonId'
  102. ];
  103. // Liste des champs en lecture seule
  104. $readonly_fields = [
  105. 'id', 'ownerId', 'isApplicable', 'authorId', 'createdAt',
  106. 'lastModifierId', 'lastModifiedAt'
  107. ];
  108. // Vérifier si des champs en lecture seule sont présents
  109. $readonly_attempts = [];
  110. foreach ($readonly_fields as $field) {
  111. if (array_key_exists($field, $input)) {
  112. $readonly_attempts[] = $field;
  113. }
  114. }
  115. if (!empty($readonly_attempts)) {
  116. json_response(400, [
  117. "error" => "Champs en lecture seule détectés",
  118. "readonly_fields_attempted" => $readonly_attempts,
  119. "message" => "Ces champs ne peuvent pas être modifiés",
  120. "readonly_fields" => $readonly_fields,
  121. "modifiable_fields" => $modifiable_fields
  122. ]);
  123. }
  124. // Validation du format des dates
  125. $date_fields = ['startsOn', 'endsOn', 'trialPeriodEndDate', 'trialPeriodEndDate2'];
  126. foreach ($date_fields as $field) {
  127. if (isset($input[$field]) && $input[$field] !== null) {
  128. // Vérifie le format YYYY-MM-DD
  129. if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $input[$field])) {
  130. json_response(400, [
  131. "error" => "Format de date invalide pour le champ '$field'",
  132. "expected_format" => "YYYY-MM-DD",
  133. "received" => $input[$field]
  134. ]);
  135. }
  136. }
  137. }
  138. // ✅ Vérification que le contrat existe
  139. $check_result = lucca_request('GET', '/directory/api/4.0/work-contracts/' . $workContractId, [], null, 60, false);
  140. if ($check_result['code'] === 404) {
  141. json_response(404, [
  142. "error" => "Le contrat de travail spécifié n'existe pas",
  143. "work_contract_id" => $workContractId
  144. ]);
  145. }
  146. if (!empty($check_result['error']) || $check_result['code'] === 0) {
  147. json_response(503, [
  148. "error" => "Impossible de vérifier si le contrat de travail existe",
  149. "message" => "Erreur de connexion à l'API Lucca",
  150. "details" => $check_result['error'] ?? "Aucune réponse du serveur"
  151. ]);
  152. }
  153. // Prépare le body pour la requête PUT/PATCH
  154. $body = [];
  155. // Ajout des champs modifiables présents dans l'input
  156. foreach ($modifiable_fields as $field) {
  157. if (array_key_exists($field, $input)) {
  158. // Conversion des types pour les IDs
  159. if (in_array($field, ['typeId', 'establishmentId', 'spcId', 'hiringTypeId',
  160. 'trialPeriodDays', 'renewedTrialPeriodDays',
  161. 'temporaryContractGroundId', 'internshipSupervisorId',
  162. 'terminationReasonId'])) {
  163. $body[$field] = $input[$field] !== null ? (int)$input[$field] : null;
  164. } else {
  165. $body[$field] = $input[$field];
  166. }
  167. }
  168. }
  169. // Requête PUT vers l'API Lucca pour mettre à jour le contrat
  170. // Documentation: https://developers.lucca.fr/api-reference/directory/update-a-work-contract
  171. $result = lucca_request('PUT', '/directory/api/4.0/work-contracts/' . $workContractId, [], $body, 60, false);
  172. // ✅ Gestion unifiée des erreurs
  173. if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) ||
  174. ($result['code'] !== 200 && $result['code'] !== 201 && $result['code'] !== 204)) {
  175. $error_response = [
  176. "error" => "Erreur lors de la mise à jour du contrat de travail",
  177. "http_code" => $result['code'],
  178. "work_contract_id" => $workContractId
  179. ];
  180. // Déterminer le message d'erreur le plus pertinent
  181. if (!empty($result['error'])) {
  182. $error_response['message'] = $result['error'];
  183. } elseif (!empty($result['lucca_error'])) {
  184. $error_response['message'] = $result['lucca_error'];
  185. } elseif (!empty($result['error_message'])) {
  186. $error_response['message'] = $result['error_message'];
  187. } elseif (isset($result['data']['title'])) {
  188. $error_response['message'] = $result['data']['title'];
  189. } elseif (isset($result['data']['message'])) {
  190. $error_response['message'] = $result['data']['message'];
  191. } else {
  192. $error_response['message'] = "Erreur inconnue";
  193. }
  194. // Ajouter les détails disponibles
  195. if (!empty($result['lucca_error'])) {
  196. $error_response['lucca_error_header'] = $result['lucca_error'];
  197. }
  198. if (!empty($result['headers'])) {
  199. $error_response['response_headers'] = $result['headers'];
  200. }
  201. if (!empty($result['data'])) {
  202. $error_response['lucca_response'] = $result['data'];
  203. }
  204. if (!empty($result['body'])) {
  205. $error_response['raw_response_body'] = $result['body'];
  206. }
  207. if (!empty($result['curl_info'])) {
  208. $error_response['curl_info'] = $result['curl_info'];
  209. }
  210. $error_response['request_body_sent'] = $body;
  211. // Suggestions selon le code d'erreur
  212. if ($result['code'] === 403) {
  213. $error_response['suggestion'] = "Erreur 403 Forbidden : Le token API n'a pas les permissions nécessaires pour modifier les contrats de travail.";
  214. $error_response['solution'] = [
  215. "1" => "Vérifiez que le token API a les droits d'écriture sur les contrats de travail",
  216. "2" => "Dans Lucca, allez dans : Configuration > API > Applications tierces",
  217. "3" => "Le token doit avoir au minimum les permissions : 'Work Contracts - Write' ou 'Admin'"
  218. ];
  219. }
  220. if ($result['code'] === 400) {
  221. $error_response['suggestion'] = "Une erreur 400 peut indiquer des champs invalides ou des valeurs incohérentes.";
  222. $error_response['fields_sent'] = $body;
  223. }
  224. if ($result['code'] === 404) {
  225. $error_response['suggestion'] = "Le contrat de travail avec l'ID $workContractId n'existe pas ou a été supprimé.";
  226. }
  227. if ($result['code'] === 500) {
  228. $error_response['suggestion'] = "Une erreur 500 peut indiquer des IDs invalides dans les champs de référence.";
  229. }
  230. json_response($result['code'] ?: 500, $error_response);
  231. }
  232. // Récupère le contrat mis à jour
  233. // Si le code est 204 (No Content), on fait une requête GET pour récupérer l'état actuel
  234. if ($result['code'] === 204 || empty($result['data'])) {
  235. $get_result = lucca_request('GET', '/directory/api/4.0/work-contracts/' . $workContractId, [], null, 60, false);
  236. $work_contract = $get_result['data'] ?? null;
  237. } else {
  238. $work_contract = $result['data'] ?? null;
  239. }
  240. // Réponse finale
  241. json_response(200, [
  242. "success" => true,
  243. "message" => "Contrat de travail mis à jour avec succès",
  244. "work_contract" => $work_contract,
  245. "fields_updated" => array_keys($body)
  246. ]);