|
@@ -0,0 +1,189 @@
|
|
|
|
|
+<?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
|
|
|
|
|
+]);
|
|
|
|
|
+
|