DELETE_work_contract.php 7.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189
  1. <?php
  2. /**
  3. * Endpoint pour supprimer un contrat de travail (work-contract) par son ID
  4. *
  5. * Méthode : DELETE
  6. * Paramètre Query requis :
  7. * - id: ID du contrat de travail à supprimer
  8. *
  9. * Exemple d'URL :
  10. * - DELETE_work_contract.php?id=514
  11. *
  12. * Restrictions :
  13. * - Vous ne pouvez pas supprimer un contrat de travail s'il est le seul contrat d'un employé
  14. *
  15. * Réponse 204 : Contrat supprimé avec succès (pas de body)
  16. * Réponse 400 : Erreur de validation (ex: ID invalide)
  17. * Réponse 404 : Contrat non trouvé
  18. * Réponse 409 : Impossible de supprimer (ex: seul contrat de l'employé)
  19. */
  20. // Activation du débogage
  21. ini_set('display_errors', 1);
  22. ini_set('display_startup_errors', 1);
  23. error_reporting(E_ALL);
  24. function json_response(int $statusCode, array $payload): void {
  25. http_response_code($statusCode);
  26. header('Content-Type: application/json; charset=utf-8');
  27. echo json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
  28. exit;
  29. }
  30. // Charge le client API Lucca
  31. require_once __DIR__ . '/../lucca_client.php';
  32. // Vérification du paramètre ID
  33. if (!isset($_GET['id']) || empty($_GET['id'])) {
  34. json_response(400, [
  35. "error" => "Paramètre 'id' manquant",
  36. "message" => "Vous devez fournir l'ID du contrat de travail à supprimer",
  37. "usage" => "DELETE_work_contract.php?id=514"
  38. ]);
  39. }
  40. $workContractId = (int)$_GET['id'];
  41. if ($workContractId <= 0) {
  42. json_response(400, [
  43. "error" => "ID invalide",
  44. "message" => "L'ID doit être un nombre entier positif (x >= 1)",
  45. "received" => $_GET['id']
  46. ]);
  47. }
  48. // ✅ Vérification que le contrat existe avant de tenter la suppression
  49. $check_result = lucca_request('GET', '/directory/api/4.0/work-contracts/' . $workContractId, [], null, 60, false);
  50. if ($check_result['code'] === 404) {
  51. json_response(404, [
  52. "error" => "Le contrat de travail spécifié n'existe pas",
  53. "work_contract_id" => $workContractId,
  54. "message" => "Impossible de supprimer un contrat qui n'existe pas"
  55. ]);
  56. }
  57. if (!empty($check_result['error']) || $check_result['code'] === 0) {
  58. json_response(503, [
  59. "error" => "Impossible de vérifier si le contrat de travail existe",
  60. "message" => "Erreur de connexion à l'API Lucca",
  61. "details" => $check_result['error'] ?? "Aucune réponse du serveur",
  62. "curl_info" => $check_result['curl_info'] ?? null
  63. ]);
  64. }
  65. // Récupère les informations du contrat pour les messages d'erreur
  66. $workContract = $check_result['data'] ?? null;
  67. $ownerId = $workContract['ownerId'] ?? null;
  68. // Requête DELETE vers l'API Lucca
  69. // Documentation: https://developers.lucca.fr/api-reference/directory/delete-a-work-contract
  70. $result = lucca_request('DELETE', '/directory/api/4.0/work-contracts/' . $workContractId, [], null, 60, false);
  71. // ✅ Gestion unifiée des erreurs
  72. if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) ||
  73. ($result['code'] !== 200 && $result['code'] !== 204)) {
  74. $error_response = [
  75. "error" => "Erreur lors de la suppression du contrat de travail",
  76. "http_code" => $result['code'],
  77. "work_contract_id" => $workContractId
  78. ];
  79. // Déterminer le message d'erreur le plus pertinent
  80. if (!empty($result['error'])) {
  81. $error_response['message'] = $result['error'];
  82. } elseif (!empty($result['lucca_error'])) {
  83. $error_response['message'] = $result['lucca_error'];
  84. } elseif (!empty($result['error_message'])) {
  85. $error_response['message'] = $result['error_message'];
  86. } elseif (isset($result['data']['title'])) {
  87. $error_response['message'] = $result['data']['title'];
  88. } elseif (isset($result['data']['message'])) {
  89. $error_response['message'] = $result['data']['message'];
  90. } else {
  91. $error_response['message'] = "Erreur inconnue";
  92. }
  93. // Ajouter les détails disponibles
  94. if (!empty($result['lucca_error'])) {
  95. $error_response['lucca_error_header'] = $result['lucca_error'];
  96. }
  97. if (!empty($result['error_message'])) {
  98. $error_response['lucca_error_message'] = $result['error_message'];
  99. }
  100. if (!empty($result['headers'])) {
  101. $error_response['response_headers'] = $result['headers'];
  102. }
  103. if (!empty($result['data'])) {
  104. $error_response['lucca_response'] = $result['data'];
  105. }
  106. if (!empty($result['body'])) {
  107. $error_response['raw_response_body'] = $result['body'];
  108. }
  109. if (!empty($result['curl_info'])) {
  110. $error_response['curl_info'] = $result['curl_info'];
  111. }
  112. // Suggestions selon le code d'erreur
  113. if ($result['code'] === 403) {
  114. $error_response['suggestion'] = "Erreur 403 Forbidden : Le token API n'a pas les permissions nécessaires pour supprimer les contrats de travail.";
  115. $error_response['solution'] = [
  116. "1" => "Vérifiez que le token API a les droits d'écriture/suppression sur les contrats de travail",
  117. "2" => "Dans Lucca, allez dans : Configuration > API > Applications tierces",
  118. "3" => "Le token doit avoir au minimum les permissions : 'Work Contracts - Write' ou 'Admin'"
  119. ];
  120. }
  121. if ($result['code'] === 404) {
  122. $error_response['suggestion'] = "Le contrat de travail avec l'ID $workContractId n'existe pas ou a déjà été supprimé.";
  123. }
  124. if ($result['code'] === 409) {
  125. $error_response['suggestion'] = "Impossible de supprimer ce contrat de travail car il est probablement le seul contrat de l'employé.";
  126. $error_response['message'] = "Vous ne pouvez pas supprimer un contrat de travail s'il est le seul contrat d'un employé";
  127. if ($ownerId) {
  128. $error_response['owner_id'] = $ownerId;
  129. $error_response['solution'] = [
  130. "1" => "Vérifiez que l'employé (ownerId: $ownerId) a d'autres contrats de travail",
  131. "2" => "Créez un nouveau contrat pour cet employé avant de supprimer celui-ci",
  132. "3" => "Ou terminez ce contrat en définissant une date de fin (endsOn) au lieu de le supprimer"
  133. ];
  134. }
  135. }
  136. if ($result['code'] === 400) {
  137. $error_response['suggestion'] = "Une erreur 400 peut indiquer que l'ID est invalide ou que la suppression n'est pas autorisée pour ce contrat.";
  138. }
  139. if ($result['code'] === 500) {
  140. $error_response['suggestion'] = "Une erreur 500 peut indiquer un problème côté serveur Lucca.";
  141. }
  142. json_response($result['code'] ?: 500, $error_response);
  143. }
  144. // Succès : code 204 (No Content) ou 200
  145. // Selon la documentation Lucca, DELETE retourne 204, mais on gère aussi 200 au cas où
  146. if ($result['code'] === 204 || $result['code'] === 200) {
  147. // Pour un code 204, on peut retourner une réponse vide ou un message de succès
  148. json_response(200, [
  149. "success" => true,
  150. "message" => "Contrat de travail supprimé avec succès",
  151. "work_contract_id" => $workContractId,
  152. "deleted_at" => date('Y-m-d\TH:i:s\Z')
  153. ]);
  154. }
  155. // Cas par défaut (ne devrait pas arriver)
  156. json_response($result['code'] ?: 500, [
  157. "error" => "Réponse inattendue du serveur",
  158. "http_code" => $result['code'],
  159. "work_contract_id" => $workContractId
  160. ]);