| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189 |
- <?php
- /**
- * Endpoint pour supprimer un contrat de travail (work-contract) par son ID
- *
- * Méthode : DELETE
- * Paramètre Query requis :
- * - id: ID du contrat de travail à supprimer
- *
- * Exemple d'URL :
- * - DELETE_work_contract.php?id=514
- *
- * Restrictions :
- * - Vous ne pouvez pas supprimer un contrat de travail s'il est le seul contrat d'un employé
- *
- * Réponse 204 : Contrat supprimé avec succès (pas de body)
- * Réponse 400 : Erreur de validation (ex: ID invalide)
- * Réponse 404 : Contrat non trouvé
- * Réponse 409 : Impossible de supprimer (ex: seul contrat de l'employé)
- */
- // Activation du débogage
- ini_set('display_errors', 1);
- ini_set('display_startup_errors', 1);
- error_reporting(E_ALL);
- function json_response(int $statusCode, array $payload): void {
- http_response_code($statusCode);
- header('Content-Type: application/json; charset=utf-8');
- echo json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
- exit;
- }
- // Charge le client API Lucca
- require_once __DIR__ . '/../lucca_client.php';
- // Vérification du paramètre ID
- if (!isset($_GET['id']) || empty($_GET['id'])) {
- json_response(400, [
- "error" => "Paramètre 'id' manquant",
- "message" => "Vous devez fournir l'ID du contrat de travail à supprimer",
- "usage" => "DELETE_work_contract.php?id=514"
- ]);
- }
- $workContractId = (int)$_GET['id'];
- if ($workContractId <= 0) {
- json_response(400, [
- "error" => "ID invalide",
- "message" => "L'ID doit être un nombre entier positif (x >= 1)",
- "received" => $_GET['id']
- ]);
- }
- // ✅ Vérification que le contrat existe avant de tenter la suppression
- $check_result = lucca_request('GET', '/directory/api/4.0/work-contracts/' . $workContractId, [], null, 60, false);
- if ($check_result['code'] === 404) {
- json_response(404, [
- "error" => "Le contrat de travail spécifié n'existe pas",
- "work_contract_id" => $workContractId,
- "message" => "Impossible de supprimer un contrat qui n'existe pas"
- ]);
- }
- if (!empty($check_result['error']) || $check_result['code'] === 0) {
- json_response(503, [
- "error" => "Impossible de vérifier si le contrat de travail existe",
- "message" => "Erreur de connexion à l'API Lucca",
- "details" => $check_result['error'] ?? "Aucune réponse du serveur",
- "curl_info" => $check_result['curl_info'] ?? null
- ]);
- }
- // Récupère les informations du contrat pour les messages d'erreur
- $workContract = $check_result['data'] ?? null;
- $ownerId = $workContract['ownerId'] ?? null;
- // Requête DELETE vers l'API Lucca
- // Documentation: https://developers.lucca.fr/api-reference/directory/delete-a-work-contract
- $result = lucca_request('DELETE', '/directory/api/4.0/work-contracts/' . $workContractId, [], null, 60, false);
- // ✅ Gestion unifiée des erreurs
- if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) ||
- ($result['code'] !== 200 && $result['code'] !== 204)) {
-
- $error_response = [
- "error" => "Erreur lors de la suppression du contrat de travail",
- "http_code" => $result['code'],
- "work_contract_id" => $workContractId
- ];
-
- // Déterminer le message d'erreur le plus pertinent
- if (!empty($result['error'])) {
- $error_response['message'] = $result['error'];
- } elseif (!empty($result['lucca_error'])) {
- $error_response['message'] = $result['lucca_error'];
- } elseif (!empty($result['error_message'])) {
- $error_response['message'] = $result['error_message'];
- } elseif (isset($result['data']['title'])) {
- $error_response['message'] = $result['data']['title'];
- } elseif (isset($result['data']['message'])) {
- $error_response['message'] = $result['data']['message'];
- } else {
- $error_response['message'] = "Erreur inconnue";
- }
-
- // Ajouter les détails disponibles
- if (!empty($result['lucca_error'])) {
- $error_response['lucca_error_header'] = $result['lucca_error'];
- }
-
- if (!empty($result['error_message'])) {
- $error_response['lucca_error_message'] = $result['error_message'];
- }
-
- if (!empty($result['headers'])) {
- $error_response['response_headers'] = $result['headers'];
- }
-
- if (!empty($result['data'])) {
- $error_response['lucca_response'] = $result['data'];
- }
-
- if (!empty($result['body'])) {
- $error_response['raw_response_body'] = $result['body'];
- }
-
- if (!empty($result['curl_info'])) {
- $error_response['curl_info'] = $result['curl_info'];
- }
-
- // Suggestions selon le code d'erreur
- if ($result['code'] === 403) {
- $error_response['suggestion'] = "Erreur 403 Forbidden : Le token API n'a pas les permissions nécessaires pour supprimer les contrats de travail.";
- $error_response['solution'] = [
- "1" => "Vérifiez que le token API a les droits d'écriture/suppression sur les contrats de travail",
- "2" => "Dans Lucca, allez dans : Configuration > API > Applications tierces",
- "3" => "Le token doit avoir au minimum les permissions : 'Work Contracts - Write' ou 'Admin'"
- ];
- }
-
- if ($result['code'] === 404) {
- $error_response['suggestion'] = "Le contrat de travail avec l'ID $workContractId n'existe pas ou a déjà été supprimé.";
- }
-
- if ($result['code'] === 409) {
- $error_response['suggestion'] = "Impossible de supprimer ce contrat de travail car il est probablement le seul contrat de l'employé.";
- $error_response['message'] = "Vous ne pouvez pas supprimer un contrat de travail s'il est le seul contrat d'un employé";
- if ($ownerId) {
- $error_response['owner_id'] = $ownerId;
- $error_response['solution'] = [
- "1" => "Vérifiez que l'employé (ownerId: $ownerId) a d'autres contrats de travail",
- "2" => "Créez un nouveau contrat pour cet employé avant de supprimer celui-ci",
- "3" => "Ou terminez ce contrat en définissant une date de fin (endsOn) au lieu de le supprimer"
- ];
- }
- }
-
- if ($result['code'] === 400) {
- $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.";
- }
-
- if ($result['code'] === 500) {
- $error_response['suggestion'] = "Une erreur 500 peut indiquer un problème côté serveur Lucca.";
- }
-
- json_response($result['code'] ?: 500, $error_response);
- }
- // Succès : code 204 (No Content) ou 200
- // Selon la documentation Lucca, DELETE retourne 204, mais on gère aussi 200 au cas où
- if ($result['code'] === 204 || $result['code'] === 200) {
- // Pour un code 204, on peut retourner une réponse vide ou un message de succès
- json_response(200, [
- "success" => true,
- "message" => "Contrat de travail supprimé avec succès",
- "work_contract_id" => $workContractId,
- "deleted_at" => date('Y-m-d\TH:i:s\Z')
- ]);
- }
- // Cas par défaut (ne devrait pas arriver)
- json_response($result['code'] ?: 500, [
- "error" => "Réponse inattendue du serveur",
- "http_code" => $result['code'],
- "work_contract_id" => $workContractId
- ]);
|