augustin.podvin 1 år sedan
förälder
incheckning
87317457f9

+ 117 - 0
api/contract/GET_work_contract.php

@@ -0,0 +1,117 @@
+<?php
+/**
+ * Endpoint pour récupérer un contrat de travail (work-contract) spécifique par son ID
+ * 
+ * Méthode : GET
+ * Paramètre Query requis :
+ * - id: ID du contrat de travail
+ * 
+ * Exemple d'URL :
+ * - get_work_contract.php?id=514
+ * 
+ * Réponse : {
+ *   "id": 514,
+ *   "ownerId": 416,
+ *   "startsOn": "2021-01-01",
+ *   "endsOn": null,
+ *   ...
+ * }
+ */
+
+// 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",
+        "usage" => "get_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",
+        "received" => $_GET['id']
+    ]);
+}
+
+// Requête GET vers l'API Lucca
+// Documentation: https://developers.lucca.fr/api-reference/directory/get-a-work-contract
+$result = lucca_request('GET', '/directory/api/4.0/work-contracts/' . $workContractId, [], null, 60, false);
+
+// Gestion des erreurs
+if (!empty($result['error']) || !empty($result['lucca_error']) || 
+    ($result['code'] !== 200 && $result['code'] !== 201)) {
+    
+    $error_response = [
+        "error" => "Erreur lors de la récupération du contrat de travail",
+        "http_code" => $result['code'],
+        "work_contract_id" => $workContractId
+    ];
+    
+    // Message d'erreur
+    if (!empty($result['error'])) {
+        $error_response['message'] = $result['error'];
+    } elseif (!empty($result['lucca_error'])) {
+        $error_response['message'] = $result['lucca_error'];
+    } 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";
+    }
+    
+    // Détails pour diagnostic
+    if (!empty($result['data'])) {
+        $error_response['lucca_response'] = $result['data'];
+    }
+    
+    if (!empty($result['headers'])) {
+        $error_response['response_headers'] = $result['headers'];
+    }
+    
+    if (!empty($result['curl_info'])) {
+        $error_response['curl_info'] = $result['curl_info'];
+    }
+    
+    // Suggestions selon le code d'erreur
+    if ($result['code'] === 404) {
+        $error_response['suggestion'] = "Le contrat de travail avec l'ID $workContractId n'existe pas";
+    } elseif ($result['code'] === 403) {
+        $error_response['suggestion'] = "Vérifiez que le token API a les permissions de lecture sur les contrats de travail";
+    }
+    
+    json_response($result['code'] ?: 500, $error_response);
+}
+
+// Extraction des données
+$workContract = $result['data'] ?? null;
+
+if (!$workContract) {
+    json_response(404, [
+        "error" => "Contrat de travail non trouvé",
+        "work_contract_id" => $workContractId
+    ]);
+}
+
+// Réponse
+json_response(200, $workContract);
+

+ 204 - 0
api/contract/GET_work_contracts.php

@@ -0,0 +1,204 @@
+<?php
+/**
+ * Endpoint pour récupérer les contrats de travail (work-contracts) Lucca
+ * 
+ * Méthode : GET
+ * Paramètres de query optionnels :
+ * - page: Index de la page à récupérer (commence à 1)
+ * - limit: Nombre d'items par page (max 1000)
+ * - fields.root: "count" pour récupérer le nombre total d'items
+ * - ownerId: ID(s) de l'employé (peut être un array, ex: ownerId=1,2,3)
+ * - isApplicable: true/false pour filtrer les contrats applicables
+ * - isArchived: true/false pour filtrer les contrats archivés
+ * - typeId: ID(s) du type de contrat (peut être un array, ex: typeId=1,2)
+ * - establishmentId: ID(s) de l'établissement (peut être un array, ex: establishmentId=13,14)
+ * 
+ * Exemples d'utilisation :
+ * - GET /get_work_contracts.php
+ * - GET /get_work_contracts.php?ownerId=416
+ * - GET /get_work_contracts.php?ownerId=416&isApplicable=true
+ * - GET /get_work_contracts.php?limit=50&page=2
+ * - GET /get_work_contracts.php?establishmentId=13&typeId=1
+ * 
+ * Réponse : {"success": true, "work_contracts": [...], "count": 1}
+ */
+
+// 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';
+
+// Récupère les paramètres de query
+$query_params = [];
+
+// Pagination
+if (isset($_GET['page'])) {
+    $page = (int)$_GET['page'];
+    if ($page >= 1) {
+        $query_params['page'] = $page;
+    }
+}
+
+if (isset($_GET['limit'])) {
+    $limit = (int)$_GET['limit'];
+    if ($limit >= 0 && $limit <= 1000) {
+        $query_params['limit'] = $limit;
+    }
+}
+
+// Count total
+if (isset($_GET['fields.root']) && $_GET['fields.root'] === 'count') {
+    $query_params['fields.root'] = 'count';
+}
+
+// Filtres
+if (isset($_GET['ownerId'])) {
+    // Peut être un seul ID ou une liste séparée par des virgules
+    $query_params['ownerId'] = $_GET['ownerId'];
+}
+
+if (isset($_GET['isApplicable'])) {
+    // Convertir en booléen string pour l'API
+    $isApplicable = filter_var($_GET['isApplicable'], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
+    if ($isApplicable !== null) {
+        $query_params['isApplicable'] = $isApplicable ? 'true' : 'false';
+    }
+}
+
+if (isset($_GET['isArchived'])) {
+    // Convertir en booléen string pour l'API
+    $isArchived = filter_var($_GET['isArchived'], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
+    if ($isArchived !== null) {
+        $query_params['isArchived'] = $isArchived ? 'true' : 'false';
+    }
+}
+
+if (isset($_GET['typeId'])) {
+    // Peut être un seul ID ou une liste séparée par des virgules
+    $query_params['typeId'] = $_GET['typeId'];
+}
+
+if (isset($_GET['establishmentId'])) {
+    // Peut être un seul ID ou une liste séparée par des virgules
+    $query_params['establishmentId'] = $_GET['establishmentId'];
+}
+
+// Requête GET vers l'API Lucca pour récupérer les work-contracts
+// Documentation: https://developers.lucca.fr/api-reference/directory/list-work-contracts
+$result = lucca_request('GET', '/directory/api/4.0/work-contracts', $query_params, null, 60, false);
+
+// ✅ Gestion unifiée des erreurs
+if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) || 
+    $result['code'] !== 200) {
+    
+    $error_response = [
+        "error" => "Erreur lors de la récupération des contrats de travail",
+        "http_code" => $result['code']
+    ];
+    
+    // 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 tous les détails disponibles de l'erreur Lucca
+    if (!empty($result['lucca_error'])) {
+        $error_response['lucca_error_header'] = $result['lucca_error'];
+    }
+    
+    // Ajouter tous les headers de réponse pour diagnostic complet
+    if (!empty($result['headers'])) {
+        $error_response['response_headers'] = $result['headers'];
+    }
+    
+    // Ajouter les détails complets de la réponse si disponibles
+    if (!empty($result['data'])) {
+        $error_response['lucca_response'] = $result['data'];
+    }
+    
+    // Ajouter le body brut pour diagnostic
+    if (!empty($result['body'])) {
+        $error_response['raw_response_body'] = $result['body'];
+    }
+    
+    // Ajouter les informations curl pour diagnostic
+    if (!empty($result['curl_info'])) {
+        $error_response['curl_info'] = $result['curl_info'];
+    }
+    
+    // Ajouter l'URL complète de la requête pour diagnostic
+    if (!empty($result['curl_info']['url'])) {
+        $error_response['request_url'] = $result['curl_info']['url'];
+    }
+    
+    // Ajouter les paramètres de query pour diagnostic
+    $error_response['query_params_sent'] = $query_params;
+    
+    // Suggestion pour les erreurs 401 (problème d'authentification)
+    if ($result['code'] === 401) {
+        $error_response['suggestion'] = "Erreur 401 Unauthorized : Le token API est invalide ou a expiré.";
+        $error_response['solution'] = [
+            "1" => "Vérifiez que le token API est correct dans lucca_client.php",
+            "2" => "Vérifiez que le token n'a pas expiré",
+            "3" => "Dans Lucca, allez dans : Configuration > API > Applications tierces"
+        ];
+    }
+    
+    // Suggestion pour les erreurs 403 (problème de permissions)
+    if ($result['code'] === 403) {
+        $error_response['suggestion'] = "Erreur 403 Forbidden : Le token API n'a pas les permissions nécessaires pour lire les contrats de travail.";
+        $error_response['solution'] = [
+            "1" => "Vérifiez que le token API a les droits de lecture sur les contrats de travail",
+            "2" => "Dans Lucca, allez dans : Configuration > API > Applications tierces",
+            "3" => "Vérifiez les permissions accordées au token",
+            "4" => "Le token doit avoir au minimum les permissions : 'Work Contracts - Read' ou 'Admin'"
+        ];
+    }
+    
+    // Suggestion pour les erreurs 400 (probablement des paramètres invalides)
+    if ($result['code'] === 400) {
+        $error_response['suggestion'] = "Une erreur 400 peut indiquer des paramètres de requête invalides.";
+        $error_response['params_sent'] = $query_params;
+        $error_response['check'] = [
+            "page" => "Doit être >= 1",
+            "limit" => "Doit être entre 0 et 1000",
+            "isApplicable" => "Doit être un booléen (true/false)",
+            "isArchived" => "Doit être un booléen (true/false)"
+        ];
+    }
+    
+    json_response($result['code'] ?: 500, $error_response);
+}
+
+// Récupère les work-contracts depuis le data déjà parsé
+$work_contracts = $result['data']['items'] ?? [];
+$count = $result['data']['count'] ?? count($work_contracts);
+
+// Réponse finale
+json_response(200, [
+    "success" => true,
+    "message" => "Contrats de travail récupérés avec succès",
+    "work_contracts" => $work_contracts,
+    "count" => $count,
+    "query_params" => $query_params
+]);

+ 341 - 0
api/contract/POST_work_contract.php

@@ -0,0 +1,341 @@
+<?php
+/**
+ * Endpoint pour créer un contrat de travail (work-contract) Lucca
+ * 
+ * Méthode : POST
+ * Body JSON minimum requis : {
+ *   "ownerId": 416,
+ *   "typeId": 1,
+ *   "startsOn": "2025-01-01",
+ *   "establishmentId": 13,
+ *   // Champs requis mais peuvent être null :
+ *   "endsOn": null,
+ *   "externalId": null,
+ *   "spcId": null,
+ *   "hiringTypeId": null,
+ *   "trialPeriodDays": null,
+ *   "renewedTrialPeriodDays": null,
+ *   "trialPeriodEndDate": null,
+ *   "trialPeriodEndDate2": null,
+ *   "temporaryContractGroundId": null,
+ *   "internshipSupervisorId": null,
+ *   "terminationReasonId": null
+ * }
+ * 
+ * Champs optionnels (selon le typeId du contrat) :
+ * - externalId: Identifiant externe (peut ne pas être unique)
+ * - spcId: ID de la catégorie socio-professionnelle
+ * - hiringTypeId: ID du type d'embauche
+ * - trialPeriodDays: Nombre de jours de période d'essai initiale
+ * - renewedTrialPeriodDays: Nombre de jours de période d'essai renouvelée
+ * - trialPeriodEndDate: Date de fin de période d'essai (YYYY-MM-DD)
+ * - trialPeriodEndDate2: Date de fin de période d'essai renouvelée (YYYY-MM-DD)
+ * - temporaryContractGroundId: ID du motif de contrat temporaire
+ * - internshipSupervisorId: ID du superviseur de stage
+ * - endsOn: Date de fin du contrat (YYYY-MM-DD), null si indéterminé
+ * - terminationReasonId: ID de la raison de fin de contrat
+ * 
+ * Vérifications automatiques :
+ * - Vérifie si l'utilisateur (ownerId) existe
+ * - Vérifie qu'il n'y a pas déjà un contrat applicable pour cet utilisateur (optionnel)
+ * 
+ * Réponse : {"success": true, "work_contract": {...}}
+ * Erreur 409 : {"error": "Un contrat applicable existe déjà pour cet utilisateur", "existing_contract": {...}}
+ */
+
+// Activation du débogage
+ini_set('display_errors', 1);
+ini_set('display_startup_errors', 1);
+error_reporting(E_ALL);
+
+// ⚙️ CONFIGURATION - Activer/désactiver le bouchon de test
+define('USE_TEST_DATA', false); // Mettre à true pour utiliser les données de test, false pour les vraies requêtes
+
+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';
+
+// Récupère le JSON en entrée
+$input = json_decode(file_get_contents("php://input"), true);
+
+// BOUCHON POUR TEST - Contrôlé par la constante USE_TEST_DATA
+if (USE_TEST_DATA) {
+    $input = [
+        // Champs vraiment obligatoires (non-null)
+        "ownerId" => 416,              // ⚠️ Remplacez par un ID utilisateur valide
+        "typeId" => 1,                 // ⚠️ Remplacez par un ID de type de contrat valide
+        "startsOn" => "2025-01-01",    // Format YYYY-MM-DD
+        "establishmentId" => 13,        // ⚠️ Remplacez par un ID d'établissement valide
+        
+        // Champs requis mais peuvent être null
+        "endsOn" => null,              // Date de fin, null si indéterminé
+        "externalId" => null,
+        "spcId" => null,
+        "hiringTypeId" => null,
+        "trialPeriodDays" => 120,
+        "renewedTrialPeriodDays" => null,
+        "trialPeriodEndDate" => "2025-05-01",
+        "trialPeriodEndDate2" => null,
+        "temporaryContractGroundId" => null,
+        "internshipSupervisorId" => null,
+        "terminationReasonId" => null
+    ];
+}
+
+// Vérification que le JSON est valide
+if (!is_array($input)) {
+    json_response(400, [
+        "error" => "JSON invalide ou vide",
+        "message" => "Le corps de la requête doit contenir un JSON valide"
+    ]);
+}
+
+// Validation des champs vraiment obligatoires (non-nullable)
+$required_non_null_fields = [
+    'ownerId', 'typeId', 'startsOn', 'establishmentId'
+];
+
+// Validation des champs qui doivent être présents (mais peuvent être null)
+$required_nullable_fields = [
+    'endsOn', 'externalId', 'spcId', 'hiringTypeId', 'trialPeriodDays',
+    'renewedTrialPeriodDays', 'trialPeriodEndDate', 'trialPeriodEndDate2',
+    'temporaryContractGroundId', 'internshipSupervisorId', 'terminationReasonId'
+];
+
+$missing_fields = [];
+$empty_required_fields = [];
+
+// Vérifie les champs non-null
+foreach ($required_non_null_fields as $field) {
+    if (!array_key_exists($field, $input)) {
+        $missing_fields[] = $field;
+    } elseif (empty($input[$field]) && $input[$field] !== 0) {
+        $empty_required_fields[] = $field;
+    }
+}
+
+// Vérifie que les champs nullable sont au moins présents
+foreach ($required_nullable_fields as $field) {
+    if (!array_key_exists($field, $input)) {
+        $missing_fields[] = $field;
+    }
+}
+
+if (!empty($missing_fields)) {
+    json_response(400, [
+        "error" => "Champs requis manquants",
+        "missing_fields" => $missing_fields,
+        "required_non_null" => $required_non_null_fields,
+        "required_nullable" => $required_nullable_fields
+    ]);
+}
+
+if (!empty($empty_required_fields)) {
+    json_response(400, [
+        "error" => "Champs requis vides",
+        "empty_fields" => $empty_required_fields
+    ]);
+}
+
+// Validation du format des dates
+$date_fields = ['startsOn', 'endsOn', 'trialPeriodEndDate', 'trialPeriodEndDate2'];
+foreach ($date_fields as $field) {
+    if (isset($input[$field]) && $input[$field] !== null) {
+        // Vérifie le format YYYY-MM-DD
+        if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $input[$field])) {
+            json_response(400, [
+                "error" => "Format de date invalide pour le champ '$field'",
+                "expected_format" => "YYYY-MM-DD",
+                "received" => $input[$field]
+            ]);
+        }
+    }
+}
+
+// ✅ Vérification si l'utilisateur existe
+$check_user_result = lucca_request('GET', '/api/v3/users/' . $input['ownerId'], [
+    'fields' => 'id,name,login'
+], null, 60, false);
+
+// Si l'utilisateur n'existe pas
+if ($check_user_result['code'] === 404) {
+    json_response(404, [
+        "error" => "L'utilisateur spécifié n'existe pas",
+        "ownerId" => $input['ownerId'],
+        "message" => "Vérifiez que l'ID utilisateur est correct"
+    ]);
+}
+
+// Si la vérification a échoué (timeout, erreur réseau, etc.)
+if (!empty($check_user_result['error']) || $check_user_result['code'] === 0) {
+    json_response(503, [
+        "error" => "Impossible de vérifier si l'utilisateur existe",
+        "message" => "Erreur de connexion à l'API Lucca lors de la vérification",
+        "details" => $check_user_result['error'] ?? "Aucune réponse du serveur",
+        "curl_info" => $check_user_result['curl_info'] ?? null
+    ]);
+}
+
+// ✅ Vérification optionnelle : contrat applicable existant
+// Note: Cette vérification peut être désactivée si on veut permettre plusieurs contrats applicables
+$check_contracts_result = lucca_request('GET', '/directory/api/4.0/work-contracts', [
+    'ownerId' => $input['ownerId'],
+    'isApplicable' => 'true',
+    'limit' => 1
+], null, 60, false);
+
+if ($check_contracts_result['code'] === 200 && 
+    isset($check_contracts_result['data']['items']) && 
+    is_array($check_contracts_result['data']['items']) && 
+    count($check_contracts_result['data']['items']) > 0) {
+    
+    $existing_contract = $check_contracts_result['data']['items'][0];
+    json_response(409, [
+        "error" => "Un contrat applicable existe déjà pour cet utilisateur",
+        "existing_contract" => [
+            "id" => $existing_contract['id'] ?? null,
+            "ownerId" => $existing_contract['ownerId'] ?? null,
+            "startsOn" => $existing_contract['startsOn'] ?? null,
+            "endsOn" => $existing_contract['endsOn'] ?? null,
+            "typeId" => $existing_contract['typeId'] ?? null,
+            "establishmentId" => $existing_contract['establishmentId'] ?? null
+        ],
+        "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"
+    ]);
+}
+
+// Prépare le body pour la requête POST
+$body = [
+    "ownerId" => (int)$input["ownerId"],
+    "typeId" => (int)$input["typeId"],
+    "startsOn" => $input["startsOn"],
+    "establishmentId" => (int)$input["establishmentId"],
+    "endsOn" => $input["endsOn"],
+    "externalId" => $input["externalId"],
+    "spcId" => $input["spcId"] !== null ? (int)$input["spcId"] : null,
+    "hiringTypeId" => $input["hiringTypeId"] !== null ? (int)$input["hiringTypeId"] : null,
+    "trialPeriodDays" => $input["trialPeriodDays"] !== null ? (int)$input["trialPeriodDays"] : null,
+    "renewedTrialPeriodDays" => $input["renewedTrialPeriodDays"] !== null ? (int)$input["renewedTrialPeriodDays"] : null,
+    "trialPeriodEndDate" => $input["trialPeriodEndDate"],
+    "trialPeriodEndDate2" => $input["trialPeriodEndDate2"],
+    "temporaryContractGroundId" => $input["temporaryContractGroundId"] !== null ? (int)$input["temporaryContractGroundId"] : null,
+    "internshipSupervisorId" => $input["internshipSupervisorId"] !== null ? (int)$input["internshipSupervisorId"] : null,
+    "terminationReasonId" => $input["terminationReasonId"] !== null ? (int)$input["terminationReasonId"] : null
+];
+
+// Requête POST vers l'API Lucca pour créer un work-contract
+// Documentation: https://developers.lucca.fr/api-reference/directory/create-a-work-contract
+$result = lucca_request('POST', '/directory/api/4.0/work-contracts', [], $body, 60, false);
+
+// ✅ Gestion unifiée des erreurs
+if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) || 
+    ($result['code'] !== 200 && $result['code'] !== 201)) {
+    
+    $error_response = [
+        "error" => "Erreur lors de la création du contrat de travail",
+        "http_code" => $result['code']
+    ];
+    
+    // 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 tous les détails disponibles de l'erreur Lucca
+    if (!empty($result['lucca_error'])) {
+        $error_response['lucca_error_header'] = $result['lucca_error'];
+    }
+    
+    // Ajouter tous les headers de réponse pour diagnostic complet
+    if (!empty($result['headers'])) {
+        $error_response['response_headers'] = $result['headers'];
+    }
+    
+    // Ajouter les détails complets de la réponse si disponibles
+    if (!empty($result['data'])) {
+        $error_response['lucca_response'] = $result['data'];
+    }
+    
+    // Ajouter le body brut pour diagnostic
+    if (!empty($result['body'])) {
+        $error_response['raw_response_body'] = $result['body'];
+    }
+    
+    // Ajouter les informations curl pour diagnostic
+    if (!empty($result['curl_info'])) {
+        $error_response['curl_info'] = $result['curl_info'];
+    }
+    
+    // Ajouter l'URL complète de la requête pour diagnostic
+    if (!empty($result['curl_info']['url'])) {
+        $error_response['request_url'] = $result['curl_info']['url'];
+    }
+    
+    // Ajouter le body envoyé pour diagnostic
+    $error_response['request_body_sent'] = $body;
+    
+    // Suggestion pour les erreurs 403 (problème de permissions)
+    if ($result['code'] === 403) {
+        $error_response['suggestion'] = "Erreur 403 Forbidden : Le token API n'a pas les permissions nécessaires pour créer des contrats de travail.";
+        $error_response['solution'] = [
+            "1" => "Vérifiez que le token API a les droits d'écriture sur les contrats de travail",
+            "2" => "Dans Lucca, allez dans : Configuration > API > Applications tierces",
+            "3" => "Vérifiez les permissions accordées au token",
+            "4" => "Le token doit avoir au minimum les permissions : 'Work Contracts - Write' ou 'Admin'"
+        ];
+    }
+    
+    // Suggestion pour les erreurs 400 (probablement des champs manquants ou invalides)
+    if ($result['code'] === 400) {
+        $error_response['suggestion'] = "Une erreur 400 peut indiquer des champs manquants, invalides ou des IDs inexistants.";
+        $error_response['fields_sent'] = $body;
+        $error_response['check'] = [
+            "typeId" => "Vérifiez que ce type de contrat existe dans votre instance Lucca",
+            "establishmentId" => "Vérifiez que cet établissement existe",
+            "dates" => "Vérifiez que les dates sont au format YYYY-MM-DD et cohérentes",
+            "required_fields" => "Certains champs peuvent être requis selon le typeId du contrat"
+        ];
+    }
+    
+    // Suggestion pour les erreurs 500 (probablement des IDs invalides)
+    if ($result['code'] === 500) {
+        $error_response['suggestion'] = "Une erreur 500 peut indiquer des IDs invalides. Vérifiez que les IDs suivants existent dans votre instance Lucca :";
+        $error_response['ids_to_verify'] = [
+            "ownerId" => $body['ownerId'] ?? null,
+            "typeId" => $body['typeId'] ?? null,
+            "establishmentId" => $body['establishmentId'] ?? null,
+            "spcId" => $body['spcId'] ?? null,
+            "hiringTypeId" => $body['hiringTypeId'] ?? null,
+            "internshipSupervisorId" => $body['internshipSupervisorId'] ?? null
+        ];
+    }
+    
+    json_response($result['code'] ?: 500, $error_response);
+}
+
+// Récupère le contrat créé depuis le data déjà parsé
+$work_contract = $result['data'] ?? null;
+
+// Réponse finale
+json_response(201, [
+    "success" => true,
+    "message" => "Contrat de travail créé avec succès",
+    "work_contract" => $work_contract
+]);
+

+ 285 - 0
api/contract/PUT_work_contract.php

@@ -0,0 +1,285 @@
+<?php
+/**
+ * Endpoint pour mettre à jour un contrat de travail (work-contract) Lucca
+ * 
+ * Méthode : PUT/PATCH
+ * Paramètre Query requis :
+ * - id: ID du contrat de travail à modifier
+ * 
+ * Body JSON : Seuls les champs à modifier doivent être envoyés
+ * {
+ *   "endsOn": "2025-12-31",
+ *   "terminationReasonId": 5
+ * }
+ * 
+ * Champs modifiables :
+ * - externalId: string|null
+ * - typeId: integer
+ * - startsOn: string (date YYYY-MM-DD)
+ * - endsOn: string|null (date YYYY-MM-DD)
+ * - establishmentId: integer
+ * - spcId: integer|null
+ * - hiringTypeId: integer|null
+ * - trialPeriodDays: integer|null
+ * - renewedTrialPeriodDays: integer|null
+ * - trialPeriodEndDate: string|null (date YYYY-MM-DD)
+ * - trialPeriodEndDate2: string|null (date YYYY-MM-DD)
+ * - temporaryContractGroundId: integer|null
+ * - internshipSupervisorId: integer|null
+ * - terminationReasonId: integer|null
+ * 
+ * Champs en lecture seule (non modifiables) :
+ * - id, ownerId, isApplicable, authorId, createdAt, lastModifierId, lastModifiedAt
+ * 
+ * Exemples d'URLs :
+ * - update_work_contract.php?id=514
+ * 
+ * Réponse : {
+ *   "success": true,
+ *   "message": "Contrat de travail mis à jour avec succès",
+ *   "work_contract": {...}
+ * }
+ */
+
+// Activation du débogage
+ini_set('display_errors', 1);
+ini_set('display_startup_errors', 1);
+error_reporting(E_ALL);
+
+// ⚙️ CONFIGURATION - Activer/désactiver le bouchon de test
+define('USE_TEST_DATA', false); // Mettre à true pour utiliser les données de test
+
+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 à modifier",
+        "usage" => "update_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",
+        "received" => $_GET['id']
+    ]);
+}
+
+// Récupère le JSON en entrée
+$input = json_decode(file_get_contents("php://input"), true);
+
+// BOUCHON POUR TEST
+if (USE_TEST_DATA) {
+    $input = [
+        "endsOn" => "2025-12-31",
+        "terminationReasonId" => 5
+    ];
+}
+
+// Vérification que le JSON est valide
+if (!is_array($input)) {
+    json_response(400, [
+        "error" => "JSON invalide ou vide",
+        "message" => "Le corps de la requête doit contenir un JSON valide"
+    ]);
+}
+
+// Vérification qu'au moins un champ est fourni
+if (empty($input)) {
+    json_response(400, [
+        "error" => "Aucun champ à modifier",
+        "message" => "Le corps de la requête doit contenir au moins un champ à modifier"
+    ]);
+}
+
+// Liste des champs modifiables
+$modifiable_fields = [
+    'externalId', 'typeId', 'startsOn', 'endsOn', 'establishmentId', 'spcId',
+    'hiringTypeId', 'trialPeriodDays', 'renewedTrialPeriodDays', 
+    'trialPeriodEndDate', 'trialPeriodEndDate2', 'temporaryContractGroundId',
+    'internshipSupervisorId', 'terminationReasonId'
+];
+
+// Liste des champs en lecture seule
+$readonly_fields = [
+    'id', 'ownerId', 'isApplicable', 'authorId', 'createdAt', 
+    'lastModifierId', 'lastModifiedAt'
+];
+
+// Vérifier si des champs en lecture seule sont présents
+$readonly_attempts = [];
+foreach ($readonly_fields as $field) {
+    if (array_key_exists($field, $input)) {
+        $readonly_attempts[] = $field;
+    }
+}
+
+if (!empty($readonly_attempts)) {
+    json_response(400, [
+        "error" => "Champs en lecture seule détectés",
+        "readonly_fields_attempted" => $readonly_attempts,
+        "message" => "Ces champs ne peuvent pas être modifiés",
+        "readonly_fields" => $readonly_fields,
+        "modifiable_fields" => $modifiable_fields
+    ]);
+}
+
+// Validation du format des dates
+$date_fields = ['startsOn', 'endsOn', 'trialPeriodEndDate', 'trialPeriodEndDate2'];
+foreach ($date_fields as $field) {
+    if (isset($input[$field]) && $input[$field] !== null) {
+        // Vérifie le format YYYY-MM-DD
+        if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $input[$field])) {
+            json_response(400, [
+                "error" => "Format de date invalide pour le champ '$field'",
+                "expected_format" => "YYYY-MM-DD",
+                "received" => $input[$field]
+            ]);
+        }
+    }
+}
+
+// ✅ Vérification que le contrat existe
+$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
+    ]);
+}
+
+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"
+    ]);
+}
+
+// Prépare le body pour la requête PUT/PATCH
+$body = [];
+
+// Ajout des champs modifiables présents dans l'input
+foreach ($modifiable_fields as $field) {
+    if (array_key_exists($field, $input)) {
+        // Conversion des types pour les IDs
+        if (in_array($field, ['typeId', 'establishmentId', 'spcId', 'hiringTypeId', 
+                               'trialPeriodDays', 'renewedTrialPeriodDays', 
+                               'temporaryContractGroundId', 'internshipSupervisorId', 
+                               'terminationReasonId'])) {
+            $body[$field] = $input[$field] !== null ? (int)$input[$field] : null;
+        } else {
+            $body[$field] = $input[$field];
+        }
+    }
+}
+
+// Requête PUT vers l'API Lucca pour mettre à jour le contrat
+// Documentation: https://developers.lucca.fr/api-reference/directory/update-a-work-contract
+$result = lucca_request('PUT', '/directory/api/4.0/work-contracts/' . $workContractId, [], $body, 60, false);
+
+// ✅ Gestion unifiée des erreurs
+if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) || 
+    ($result['code'] !== 200 && $result['code'] !== 201 && $result['code'] !== 204)) {
+    
+    $error_response = [
+        "error" => "Erreur lors de la mise à jour 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['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'];
+    }
+    
+    $error_response['request_body_sent'] = $body;
+    
+    // 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 modifier les contrats de travail.";
+        $error_response['solution'] = [
+            "1" => "Vérifiez que le token API a les droits d'écriture 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'] === 400) {
+        $error_response['suggestion'] = "Une erreur 400 peut indiquer des champs invalides ou des valeurs incohérentes.";
+        $error_response['fields_sent'] = $body;
+    }
+    
+    if ($result['code'] === 404) {
+        $error_response['suggestion'] = "Le contrat de travail avec l'ID $workContractId n'existe pas ou a été supprimé.";
+    }
+    
+    if ($result['code'] === 500) {
+        $error_response['suggestion'] = "Une erreur 500 peut indiquer des IDs invalides dans les champs de référence.";
+    }
+    
+    json_response($result['code'] ?: 500, $error_response);
+}
+
+// Récupère le contrat mis à jour
+// Si le code est 204 (No Content), on fait une requête GET pour récupérer l'état actuel
+if ($result['code'] === 204 || empty($result['data'])) {
+    $get_result = lucca_request('GET', '/directory/api/4.0/work-contracts/' . $workContractId, [], null, 60, false);
+    $work_contract = $get_result['data'] ?? null;
+} else {
+    $work_contract = $result['data'] ?? null;
+}
+
+// Réponse finale
+json_response(200, [
+    "success" => true,
+    "message" => "Contrat de travail mis à jour avec succès",
+    "work_contract" => $work_contract,
+    "fields_updated" => array_keys($body)
+]);
+

+ 0 - 233
api/create_user.php

@@ -1,233 +0,0 @@
-<?php
-/**
- * Endpoint pour créer un utilisateur Lucca
- * 
- * Méthode : POST
- * Body JSON minimum requis : {
- *   "firstName": "John",
- *   "lastName": "Doe",
- *   "login": "john.doe@example.com",
- *   "mail": "john.doe@example.com",
- *   "dtContractStart": "2025-01-01T00:00:00",
- *   "legalEntityId": 1,
- *   "departmentId": 1,
- *   "cultureID": 1036,
- *   "rolePrincipalId": 1,
- *   // Champs requis mais peuvent être null :
- *   "employeeNumber": null,
- *   "managerId": null,
- *   "birthDate": null,
- *   "calendarId": null,
- *   "habilitedRoles": []
- * }
- * 
- * Champs optionnels : 
- * - jobTitle, gender, address, personalEmail, phone
- * - picture: {"id": "uuid"} - Photo de profil
- * - userWorkCycles, etc.
- * 
- * Réponse : {"success": true, "lucca_user": {...}}
- */
-
-// 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';
-
-// Récupère le JSON en entrée
-$input = json_decode(file_get_contents("php://input"), true);
-
-// BOUCHON POUR TEST - À RETIRER EN PRODUCTION
-
-if (empty($input)) {
-    $input = [
-        // Champs vraiment obligatoires (non-null)
-        "firstName" => "Test",
-        "lastName" => "Utilisateur",
-        "login" => "test.utilisateur@sipa-automobiles.fr",
-        "mail" => "test.utilisateur@sipa-automobiles.fr",
-        "dtContractStart" => "2025-01-01T00:00:00",
-        "legalEntityId" => 1, // ⚠️ Remplacez par un ID valide (voir get_legal_entities.php)
-        "departmentId" => 1,  // ⚠️ Remplacez par un ID valide (voir get_departments.php)
-        "cultureID" => 1036,  // 1036 = Français (France), devrait être OK
-        "rolePrincipalId" => 1, // ⚠️ Remplacez par un ID valide (voir get_roles.php)
-        
-        // Champs requis mais peuvent être null
-        "employeeNumber" => "TEST001",
-        "managerId" => null,
-        "birthDate" => null,
-        "calendarId" => null, // ⚠️ Peut être null OU un ID valide (voir get_calendars.php)
-        "habilitedRoles" => [], // Tableau vide OK, ou [{"id": 59}, {"id": 63}] pour des rôles secondaires
-        
-        // Champs optionnels
-        // "picture" => ["id" => "74d381db-dd4d-4f64-bc1e-582d806e58a8"], // UUID du fichier uploadé via l'API Files
-        // "jobTitle" => "Employé",
-        // "gender" => "Male", // Male, Female, Misc, Undefined
-        // "personalEmail" => "test@example.com"
-    ];
-}
-
-// Validation des champs vraiment obligatoires (non-nullable)
-$required_non_null_fields = [
-    'firstName', 'lastName', 'login', 'mail', 'dtContractStart', 
-    'legalEntityId', 'departmentId', 'cultureID', 'rolePrincipalId'
-];
-
-// Validation des champs qui doivent être présents (mais peuvent être null)
-$required_nullable_fields = [
-    'employeeNumber', 'managerId', 'birthDate', 'calendarId', 'habilitedRoles'
-];
-
-$missing_fields = [];
-$empty_required_fields = [];
-
-// Vérifie les champs non-null
-foreach ($required_non_null_fields as $field) {
-    if (!array_key_exists($field, $input)) {
-        $missing_fields[] = $field;
-    } elseif (empty($input[$field]) && $input[$field] !== 0) {
-        $empty_required_fields[] = $field;
-    }
-}
-
-// Vérifie que les champs nullable sont au moins présents
-foreach ($required_nullable_fields as $field) {
-    if (!array_key_exists($field, $input)) {
-        $missing_fields[] = $field;
-    }
-}
-
-if (!empty($missing_fields)) {
-    json_response(400, [
-        "error" => "Champs requis manquants",
-        "missing_fields" => $missing_fields,
-        "required_non_null" => $required_non_null_fields,
-        "required_nullable" => $required_nullable_fields
-    ]);
-}
-
-if (!empty($empty_required_fields)) {
-    json_response(400, [
-        "error" => "Champs requis vides",
-        "empty_fields" => $empty_required_fields
-    ]);
-}
-
-// Validation de la structure de habilitedRoles
-if (!is_array($input['habilitedRoles'])) {
-    json_response(400, [
-        "error" => "Le champ 'habilitedRoles' doit être un tableau"
-    ]);
-}
-
-// Valider que chaque élément de habilitedRoles a un id
-foreach ($input['habilitedRoles'] as $idx => $role) {
-    if (!is_array($role) || !isset($role['id'])) {
-        json_response(400, [
-            "error" => "Chaque élément de 'habilitedRoles' doit être un objet avec une propriété 'id'",
-            "invalid_index" => $idx
-        ]);
-    }
-}
-
-// Prépare le body pour la requête POST
-$body = [
-    "firstName" => $input["firstName"],
-    "lastName" => $input["lastName"],
-    "login" => $input["login"],
-    "mail" => $input["mail"],
-    "dtContractStart" => $input["dtContractStart"],
-    "legalEntityId" => (int)$input["legalEntityId"],
-    "employeeNumber" => $input["employeeNumber"],
-    "departmentId" => (int)$input["departmentId"],
-    "managerId" => $input["managerId"] !== null ? (int)$input["managerId"] : null,
-    "birthDate" => $input["birthDate"],
-    "cultureID" => (int)$input["cultureID"],
-    "calendarId" => $input["calendarId"] !== null ? (int)$input["calendarId"] : null,
-    "rolePrincipalId" => (int)$input["rolePrincipalId"],
-    "habilitedRoles" => $input["habilitedRoles"]
-];
-
-// Ajoute les champs optionnels s'ils sont présents (selon doc API Lucca)
-$optional_fields = [
-    'dtContractEnd', 'cspId', 'nationalityId', 'seniorityDate', 'insuranceNumber',
-    'address', 'directLine', 'jobTitle', 'gender', 'personalEmail', 'personalMobile',
-    'professionalMobile', 'allowsElectronicPayslip', 'quote', 'personalCard', 
-    'corporateCard', 'bankName', 'rib', 'iban', 'bic', 'frenchCarTaxHorsePower',
-    'frenchMotocyclesTaxHorsePower', 'userWorkCycles', 'picture', 'manager2Id',
-    'unitSellPrice'
-];
-
-foreach ($optional_fields as $field) {
-    if (isset($input[$field])) {
-        $body[$field] = $input[$field];
-    }
-}
-
-// Requête POST vers l'API Lucca pour créer un utilisateur
-// Documentation: https://developers.lucca.fr/api-reference/legacy/directory/create-a-new-user
-$result = lucca_request('POST', '/api/v3/users', [], $body, 20, false); // debug désactivé - l'API Lucca ne supporte pas $debug sur /users
-
-// DEBUG: Afficher toutes les informations
-$debug_info = [
-    "url_construite" => rtrim(LUCCA_API_BASE, '/') . '/api/v3/users',
-    "body_envoye" => $body,
-    "curl_result" => $result
-];
-
-// ✅ Gestion des erreurs cURL
-if (!empty($result['error'])) {
-    json_response(500, array_merge(
-        ["error" => "Erreur de communication avec Lucca"],
-        lucca_format_error($result),
-        ["debug" => $debug_info]
-    ));
-}
-
-// ✅ Gestion des erreurs Lucca dans le header X-Lucca-ErrorMessage
-if (!empty($result['lucca_error'])) {
-    json_response(500, array_merge(
-        ["error" => "Erreur Lucca (header X-Lucca-ErrorMessage)"],
-        lucca_format_error($result),
-        ["debug" => $debug_info]
-    ));
-}
-
-// ✅ Gestion des erreurs Lucca dans le body ErrorMessage
-if (!empty($result['error_message'])) {
-    json_response(500, array_merge(
-        ["error" => "Erreur Lucca (body ErrorMessage)"],
-        lucca_format_error($result),
-        ["debug" => $debug_info]
-    ));
-}
-
-// ✅ Gestion des codes HTTP non-2xx
-if ($result['code'] !== 200 && $result['code'] !== 201) {
-    json_response($result['code'], array_merge(
-        lucca_format_error($result),
-        ["debug" => $debug_info]
-    ));
-}
-
-// Récupère l'utilisateur créé depuis le data déjà parsé
-$user = $result['data']['data'] ?? null;
-
-// Réponse finale
-json_response(200, [
-    "success" => true,
-    "message" => "Utilisateur créé avec succès",
-    "input" => $input,
-    "lucca_user" => $user
-]);
-

+ 2 - 1
api/get_roles.php

@@ -22,7 +22,8 @@ function json_response(int $statusCode, array $payload): void {
 require_once __DIR__ . '/lucca_client.php';
 
 // Requête GET vers l'API Lucca pour récupérer les rôles
-$result = lucca_request('GET', '/api/v3/roles', ['fields' => 'id,name,code'], null, 20, false);
+// Note: le champ 'code' n'existe pas sur le type Role, seulement 'id' et 'name'
+$result = lucca_request('GET', '/api/v3/roles', ['fields' => 'id,name'], null, 20, false);
 
 // Gestion des erreurs avec formatage amélioré
 if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) || $result['code'] !== 200) {

+ 2 - 2
api/lucca_client.php

@@ -57,8 +57,8 @@ define('LUCCA_API_TOKEN', getenv('LUCCA_API_TOKEN') ?: 'ed29a0a8-d394-4c93-b4f7-
             CURLOPT_RETURNTRANSFER => true,
             CURLOPT_HEADER         => true,  // ✅ Inclure les headers dans la réponse
             CURLOPT_HTTPHEADER     => $headers,
-            CURLOPT_TIMEOUT        => 30,
-            CURLOPT_CONNECTTIMEOUT => 10,
+            CURLOPT_TIMEOUT        => $timeout,  // Utilise le paramètre $timeout passé à la fonction
+            CURLOPT_CONNECTTIMEOUT => min(30, $timeout),  // Timeout de connexion augmenté à 30s max
             CURLOPT_SSL_VERIFYPEER => false, // Pour test local/sandbox
             CURLOPT_SSL_VERIFYHOST => false, // Pour test local/sandbox
             CURLOPT_FOLLOWLOCATION => true,

+ 1 - 0
api/request.txt

@@ -0,0 +1 @@
+curl.exe -X POST http://localhost:8000/create_user.php -H "Content-Type: application/json" -d "{\"firstName\":\"Marine\",\"lastName\":\"BONNIN\",\"login\":\"marine.bonnin@sipa-automobiles.fr\",\"mail\":\"marine.bonnin-sipa-automobiles.fr@factice.eu\",\"dtContractStart\":\"2021-09-20T00:00:00\",\"legalEntityId\":1,\"employeeNumber\":\"530140\",\"departmentId\":247,\"managerId\":313,\"birthDate\":null,\"cultureID\":1036,\"calendarId\":null,\"rolePrincipalId\":1,\"habilitedRoles\":[]}"

+ 0 - 0
api/get_user.php → api/user/user/GET_user.php


+ 392 - 0
api/user/user/POST_user.php

@@ -0,0 +1,392 @@
+<?php
+/**
+ * Endpoint pour créer un utilisateur Lucca
+ * 
+ * Méthode : POST
+ * Body JSON minimum requis : {
+ *   "firstName": "John",
+ *   "lastName": "Doe",
+ *   "login": "john.doe@example.com",
+ *   "mail": "john.doe@example.com",
+ *   "dtContractStart": "2025-01-01T00:00:00",
+ *   "legalEntityId": 1,
+ *   "departmentId": 1,
+ *   "cultureID": 1036,
+ *   "rolePrincipalId": 1,
+ *   // Champs requis mais peuvent être null :
+ *   "employeeNumber": null,
+ *   "managerId": null,
+ *   "birthDate": null,
+ *   "calendarId": null,
+ *   "habilitedRoles": []
+ * }
+ * 
+ * Champs optionnels : 
+ * - jobTitle, gender, address, personalEmail, phone
+ * - picture: {"id": "uuid"} - Photo de profil
+ * - userWorkCycles, etc.
+ * 
+ * Vérifications automatiques :
+ * - Vérifie si un utilisateur avec le même login existe déjà (erreur 409 si trouvé)
+ * - Vérifie si un utilisateur avec le même email existe déjà (erreur 409 si trouvé)
+ * 
+ * Réponse : {"success": true, "lucca_user": {...}}
+ * Erreur 409 : {"error": "Un utilisateur avec ce login/email existe déjà", "existing_user": {...}}
+ */
+
+// Activation du débogage
+ini_set('display_errors', 1);
+ini_set('display_startup_errors', 1);
+error_reporting(E_ALL);
+
+// ⚙️ CONFIGURATION - Activer/désactiver le bouchon de test
+define('USE_TEST_DATA', false); // Mettre à true pour utiliser les données de test, false pour les vraies requêtes
+
+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';
+
+// Récupère le JSON en entrée
+$input = json_decode(file_get_contents("php://input"), true);
+
+// BOUCHON POUR TEST - Contrôlé par la constante USE_TEST_DATA
+if (USE_TEST_DATA) {
+    $input = [
+        // Champs vraiment obligatoires (non-null)
+        "firstName" => "Test",
+        "lastName" => "Utilisateur",
+        "login" => "test.utilisateur2@sipa-automobiles.fr",
+        "mail" => "test.utilisateur1@sipa-automobiles.fr",
+        "dtContractStart" => "2025-01-01T00:00:00",
+        "departmentId" => 1,  // ⚠️ Remplacez par un ID valide (voir get_departments.php)
+        "cultureID" => 1036,  // 1036 = Français (France), devrait être OK        
+        // Champs requis mais peuvent être null
+        "legalEntityId" => 1, // ⚠️ Remplacez par un ID valide (voir get_legal_entities.php)
+        "rolePrincipalId" => 1, // ⚠️ Remplacez par un ID valide (voir get_roles.php)
+        "employeeNumber" => null,
+        "managerId" => null,
+        "birthDate" => null,
+        "calendarId" => null, // ⚠️ Peut être null OU un ID valide (voir get_calendars.php)
+        "habilitedRoles" => [], // Tableau vide OK, ou [{"id": 59}, {"id": 63}] pour des rôles secondaires
+        
+        // Champs optionnels
+        // "picture" => ["id" => "74d381db-dd4d-4f64-bc1e-582d806e58a8"], // UUID du fichier uploadé via l'API Files
+        // "jobTitle" => "Employé",
+        // "gender" => "Male", // Male, Female, Misc, Undefined
+        // "personalEmail" => "test@example.com"
+    ];
+}
+
+// Vérification que le JSON est valide
+if (!is_array($input)) {
+    json_response(400, [
+        "error" => "JSON invalide ou vide",
+        "message" => "Le corps de la requête doit contenir un JSON valide"
+    ]);
+}
+
+// Validation des champs vraiment obligatoires (non-nullable)
+$required_non_null_fields = [
+    'firstName', 'lastName', 'login', 'mail', 'dtContractStart', 
+    'legalEntityId', 'departmentId', 'cultureID', 'rolePrincipalId'
+];
+
+// Validation des champs qui doivent être présents (mais peuvent être null)
+$required_nullable_fields = [
+    'employeeNumber', 'managerId', 'birthDate', 'calendarId', 'habilitedRoles'
+];
+
+$missing_fields = [];
+$empty_required_fields = [];
+
+// Vérifie les champs non-null
+foreach ($required_non_null_fields as $field) {
+    if (!array_key_exists($field, $input)) {
+        $missing_fields[] = $field;
+    } elseif (empty($input[$field]) && $input[$field] !== 0) {
+        $empty_required_fields[] = $field;
+    }
+}
+
+// Vérifie que les champs nullable sont au moins présents
+foreach ($required_nullable_fields as $field) {
+    if (!array_key_exists($field, $input)) {
+        $missing_fields[] = $field;
+    }
+}
+
+if (!empty($missing_fields)) {
+    json_response(400, [
+        "error" => "Champs requis manquants",
+        "missing_fields" => $missing_fields,
+        "required_non_null" => $required_non_null_fields,
+        "required_nullable" => $required_nullable_fields
+    ]);
+}
+
+if (!empty($empty_required_fields)) {
+    json_response(400, [
+        "error" => "Champs requis vides",
+        "empty_fields" => $empty_required_fields
+    ]);
+}
+
+// Validation de la structure de habilitedRoles
+if (!is_array($input['habilitedRoles'])) {
+    json_response(400, [
+        "error" => "Le champ 'habilitedRoles' doit être un tableau"
+    ]);
+}
+
+// Valider que chaque élément de habilitedRoles a un id
+foreach ($input['habilitedRoles'] as $idx => $role) {
+    if (!is_array($role) || !isset($role['id'])) {
+        json_response(400, [
+            "error" => "Chaque élément de 'habilitedRoles' doit être un objet avec une propriété 'id'",
+            "invalid_index" => $idx
+        ]);
+    }
+}
+
+// ✅ Vérification si l'utilisateur existe déjà (par login)
+$check_result = lucca_request('GET', '/api/v3/users', [
+    'login' => $input['login'],
+    'fields' => 'id,name,login,mail',
+    'limit' => 1
+], null, 60, false); // Timeout augmenté à 60 secondes
+
+// DEBUG: Pour comprendre pourquoi la vérification ne fonctionne pas
+$debug_check = [
+    "check_login" => $input['login'],
+    "check_code" => $check_result['code'],
+    "check_items_count" => isset($check_result['data']['data']['items']) ? count($check_result['data']['data']['items']) : 0,
+    "check_items" => $check_result['data']['data']['items'] ?? null,
+    "check_error" => $check_result['error'] ?? null,
+    "check_curl_info" => $check_result['curl_info'] ?? null
+];
+
+// Si la vérification a échoué (timeout, erreur réseau, etc.)
+if (!empty($check_result['error']) || $check_result['code'] === 0) {
+    json_response(503, [
+        "error" => "Impossible de vérifier si l'utilisateur existe déjà",
+        "message" => "Erreur de connexion à l'API Lucca lors de la vérification",
+        "details" => $check_result['error'] ?? "Aucune réponse du serveur",
+        "curl_info" => $check_result['curl_info'] ?? null,
+        "suggestion" => "Vérifiez votre connexion réseau et que l'API Lucca est accessible"
+    ]);
+}
+
+// Si la requête de vérification a réussi et qu'un utilisateur existe
+if ($check_result['code'] === 200 && 
+    isset($check_result['data']['data']['items']) && 
+    is_array($check_result['data']['data']['items']) && 
+    count($check_result['data']['data']['items']) > 0) {
+    
+    $existing_user = $check_result['data']['data']['items'][0];
+    json_response(409, [
+        "error" => "Un utilisateur avec ce login existe déjà",
+        "existing_user" => [
+            "id" => $existing_user['id'] ?? null,
+            "name" => $existing_user['name'] ?? null,
+            "login" => $existing_user['login'] ?? null,
+            "mail" => $existing_user['mail'] ?? null
+        ],
+        "login" => $input['login']
+    ]);
+}
+
+// ✅ Vérification supplémentaire par email si différent du login
+if (isset($input['mail']) && $input['mail'] !== $input['login']) {
+    $check_mail_result = lucca_request('GET', '/api/v3/users', [
+        'mail' => $input['mail'],
+        'fields' => 'id,name,login,mail',
+        'limit' => 1
+    ], null, 60, false); // Timeout augmenté à 60 secondes
+    
+    // Si la vérification a échoué (timeout, erreur réseau, etc.)
+    if (!empty($check_mail_result['error']) || $check_mail_result['code'] === 0) {
+        json_response(503, [
+            "error" => "Impossible de vérifier si l'utilisateur existe déjà",
+            "message" => "Erreur de connexion à l'API Lucca lors de la vérification par email",
+            "details" => $check_mail_result['error'] ?? "Aucune réponse du serveur",
+            "curl_info" => $check_mail_result['curl_info'] ?? null,
+            "suggestion" => "Vérifiez votre connexion réseau et que l'API Lucca est accessible"
+        ]);
+    }
+    
+    if ($check_mail_result['code'] === 200 && 
+        isset($check_mail_result['data']['data']['items']) && 
+        is_array($check_mail_result['data']['data']['items']) && 
+        count($check_mail_result['data']['data']['items']) > 0) {
+        
+        $existing_user = $check_mail_result['data']['data']['items'][0];
+        json_response(409, [
+            "error" => "Un utilisateur avec cet email existe déjà",
+            "existing_user" => [
+                "id" => $existing_user['id'] ?? null,
+                "name" => $existing_user['name'] ?? null,
+                "login" => $existing_user['login'] ?? null,
+                "mail" => $existing_user['mail'] ?? null
+            ],
+            "mail" => $input['mail']
+        ]);
+    }
+}
+
+// Prépare le body pour la requête POST
+$body = [
+    "firstName" => $input["firstName"],
+    "lastName" => $input["lastName"],
+    "login" => $input["login"],
+    "mail" => $input["mail"],
+    "dtContractStart" => $input["dtContractStart"],
+    "legalEntityId" => (int)$input["legalEntityId"],
+    "employeeNumber" => $input["employeeNumber"],
+    "departmentId" => (int)$input["departmentId"],
+    "managerId" => $input["managerId"] !== null ? (int)$input["managerId"] : null,
+    "birthDate" => $input["birthDate"],
+    "cultureID" => (int)$input["cultureID"],
+    "calendarId" => $input["calendarId"] !== null ? (int)$input["calendarId"] : null,
+    "rolePrincipalId" => (int)$input["rolePrincipalId"],
+    "habilitedRoles" => $input["habilitedRoles"]
+];
+
+// Ajoute les champs optionnels s'ils sont présents (selon doc API Lucca)
+$optional_fields = [
+    'dtContractEnd', 'cspId', 'nationalityId', 'seniorityDate', 'insuranceNumber',
+    'address', 'directLine', 'jobTitle', 'gender', 'personalEmail', 'personalMobile',
+    'professionalMobile', 'allowsElectronicPayslip', 'quote', 'personalCard', 
+    'corporateCard', 'bankName', 'rib', 'iban', 'bic', 'frenchCarTaxHorsePower',
+    'frenchMotocyclesTaxHorsePower', 'userWorkCycles', 'picture', 'manager2Id',
+    'unitSellPrice'
+];
+
+foreach ($optional_fields as $field) {
+    if (isset($input[$field])) {
+        $body[$field] = $input[$field];
+    }
+}
+
+// Requête POST vers l'API Lucca pour créer un utilisateur
+// Documentation: https://developers.lucca.fr/api-reference/legacy/directory/create-a-new-user
+// Note: Le paramètre $debug ne peut pas être utilisé sur POST /api/v3/users (erreur 400)
+$result = lucca_request('POST', '/api/v3/users', [], $body, 60, false); // Timeout augmenté à 60 secondes - debug désactivé (non supporté sur POST /users)
+
+// ✅ Gestion unifiée des erreurs
+if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) || 
+    ($result['code'] !== 200 && $result['code'] !== 201)) {
+    
+    $error_response = [
+        "error" => "Erreur lors de la création de l'utilisateur",
+        "http_code" => $result['code']
+    ];
+    
+    // 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 tous les détails disponibles de l'erreur Lucca
+    if (!empty($result['lucca_error'])) {
+        $error_response['lucca_error_header'] = $result['lucca_error'];
+    }
+    
+    // Ajouter tous les headers de réponse pour diagnostic complet
+    if (!empty($result['headers'])) {
+        $error_response['response_headers'] = $result['headers'];
+    }
+    
+    // Ajouter les détails complets de la réponse si disponibles
+    if (!empty($result['data'])) {
+        $error_response['lucca_response'] = $result['data'];
+    }
+    
+    // Ajouter le body brut pour diagnostic
+    if (!empty($result['body'])) {
+        $error_response['raw_response_body'] = $result['body'];
+    }
+    
+    // Ajouter les informations curl pour diagnostic
+    if (!empty($result['curl_info'])) {
+        $error_response['curl_info'] = $result['curl_info'];
+    }
+    
+    // Ajouter l'URL complète de la requête pour diagnostic
+    if (!empty($result['curl_info']['url'])) {
+        $error_response['request_url'] = $result['curl_info']['url'];
+    }
+    
+    // Ajouter le body envoyé pour diagnostic (masquer les données sensibles si nécessaire)
+    $debug_body = $body;
+    // Optionnel : masquer certains champs sensibles dans le debug
+    // unset($debug_body['password']); // si jamais il y en a
+    $error_response['request_body_sent'] = $debug_body;
+    
+    // Ajouter le debug de la vérification si disponible
+    if (isset($debug_check)) {
+        $error_response['debug_verification'] = $debug_check;
+    }
+    
+    // Suggestion pour les erreurs 403 (problème de permissions)
+    if ($result['code'] === 403) {
+        $error_response['suggestion'] = "Erreur 403 Forbidden : Le token API n'a pas les permissions nécessaires pour créer des utilisateurs.";
+        $error_response['solution'] = [
+            "1" => "Vérifiez que le token API a les droits d'écriture sur les utilisateurs",
+            "2" => "Dans Lucca, allez dans : Configuration > API > Applications tierces",
+            "3" => "Vérifiez les permissions accordées au token : " . substr(LUCCA_API_TOKEN, 0, 8) . "...",
+            "4" => "Le token doit avoir au minimum les permissions : 'Users - Write' ou 'Admin'"
+        ];
+    }
+    
+    // Suggestion pour les erreurs 500 (probablement des IDs invalides)
+    if ($result['code'] === 500) {
+        $error_response['suggestion'] = "Une erreur 500 peut indiquer des IDs invalides. Vérifiez que les IDs suivants existent dans votre instance Lucca :";
+        $error_response['ids_to_verify'] = [
+            "legalEntityId" => $body['legalEntityId'] ?? null,
+            "departmentId" => $body['departmentId'] ?? null,
+            "rolePrincipalId" => $body['rolePrincipalId'] ?? null,
+            "calendarId" => $body['calendarId'] ?? null,
+            "managerId" => $body['managerId'] ?? null
+        ];
+        $error_response['endpoints_to_check'] = [
+            "legal_entities" => "GET http://localhost:8000/get_legal_entities.php",
+            "departments" => "GET http://localhost:8000/get_departments.php",
+            "roles" => "GET http://localhost:8000/get_roles.php",
+            "calendars" => "GET http://localhost:8000/get_calendars.php"
+        ];
+    }
+    
+    json_response($result['code'] ?: 500, $error_response);
+}
+
+// Récupère l'utilisateur créé depuis le data déjà parsé
+$user = $result['data']['data'] ?? null;
+
+// Réponse finale
+json_response(200, [
+    "success" => true,
+    "message" => "Utilisateur créé avec succès",
+    "lucca_user" => [
+        "id" => $user['id'] ?? null,
+        "name" => $user['name'] ?? null,
+        "login" => $user['login'] ?? null,
+        "mail" => $user['mail'] ?? null
+    ]
+]);
+

+ 154 - 0
api/user/user/PUT_user.php

@@ -0,0 +1,154 @@
+<?php
+/**
+ * Endpoint pour mettre à jour un utilisateur Lucca
+ * 
+ * Méthode : PUT
+ * URL : /update_user.php?id=123
+ * 
+ * Body JSON : Envoyez uniquement les champs que vous souhaitez modifier
+ * Exemple minimal : {
+ *   "firstName": "Jean",
+ *   "lastName": "Dupont",
+ *   "jobTitle": "Développeur Senior"
+ * }
+ * 
+ * Exemple complet basé sur la doc Lucca :
+ * {
+ *   "firstName": "John",
+ *   "lastName": "Doe",
+ *   "mail": "jdoe@corp.com",
+ *   "login": "jdoe",
+ *   "legalEntityId": 1,
+ *   "dtContractStart": "2025-01-01T00:00:00",
+ *   "cspId": 2,
+ *   "calendarId": null,
+ *   "employeeNumber": "000000452",
+ *   "birthDate": "1989-12-22T00:00:00",
+ *   "departmentId": 14,
+ *   "managerId": 455,
+ *   "rolePrincipalId": 55,
+ *   "habilitedRoles": [{"id": 59}, {"id": 81}],
+ *   "cultureID": 1040,
+ *   "address": "13, rue Martin Bernard, 75 Paris",
+ *   "directLine": "0123456789",
+ *   "jobTitle": "Developer",
+ *   "gender": "Male",
+ *   "personalEmail": "email@test.fr",
+ *   "personalMobile": "0612345678",
+ *   "professionalMobile": "0612345678"
+ * }
+ * 
+ * Réponse : {"success": true, "lucca_user": {...}}
+ */
+
+// 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';
+
+// Récupère l'ID de l'utilisateur depuis l'URL
+$user_id = $_GET['id'] ?? null;
+
+if (!$user_id) {
+    json_response(400, [
+        "error" => "ID utilisateur manquant",
+        "message" => "Vous devez fournir l'ID de l'utilisateur dans l'URL : /update_user.php?id=123"
+    ]);
+}
+
+// Vérifie que l'ID est un nombre
+if (!is_numeric($user_id)) {
+    json_response(400, [
+        "error" => "ID utilisateur invalide",
+        "message" => "L'ID doit être un nombre entier"
+    ]);
+}
+
+// Récupère le JSON en entrée
+$input = json_decode(file_get_contents("php://input"), true);
+
+// Vérification que le JSON est valide
+if (!is_array($input) || empty($input)) {
+    json_response(400, [
+        "error" => "JSON invalide ou vide",
+        "message" => "Le corps de la requête doit contenir un JSON valide avec au moins un champ à mettre à jour"
+    ]);
+}
+
+// Requête PUT vers l'API Lucca pour mettre à jour l'utilisateur
+// Documentation: https://developers.lucca.fr/api-reference/legacy/directory/update-a-user-by-id
+$result = lucca_request('PUT', '/api/v3/users/' . $user_id, [], $input, 60, false);
+
+// Gestion des erreurs
+if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) || 
+    ($result['code'] !== 200 && $result['code'] !== 201)) {
+    
+    $error_response = [
+        "error" => "Erreur lors de la mise à jour de l'utilisateur",
+        "http_code" => $result['code'],
+        "user_id" => $user_id
+    ];
+    
+    // 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 de l'erreur pour le diagnostic
+    if (!empty($result['lucca_error'])) {
+        $error_response['lucca_error_header'] = $result['lucca_error'];
+    }
+    
+    if (!empty($result['data'])) {
+        $error_response['lucca_response'] = $result['data'];
+    }
+    
+    if (!empty($result['body'])) {
+        $error_response['raw_response_body'] = $result['body'];
+    }
+    
+    // Ajouter le body envoyé pour diagnostic
+    $error_response['request_body_sent'] = $input;
+    
+    // Suggestions pour les erreurs courantes
+    if ($result['code'] === 404) {
+        $error_response['suggestion'] = "Erreur 404 : L'utilisateur avec l'ID {$user_id} n'existe pas.";
+    } elseif ($result['code'] === 403) {
+        $error_response['suggestion'] = "Erreur 403 : Le token API n'a pas les permissions nécessaires pour modifier des utilisateurs.";
+    } elseif ($result['code'] === 500) {
+        $error_response['suggestion'] = "Erreur 500 : Vérifiez que tous les IDs fournis (departmentId, legalEntityId, etc.) sont valides.";
+    }
+    
+    json_response($result['code'] ?: 500, $error_response);
+}
+
+// Récupère l'utilisateur mis à jour
+$user = $result['data']['data'] ?? null;
+
+// Réponse finale
+json_response(200, [
+    "success" => true,
+    "message" => "Utilisateur mis à jour avec succès",
+    "lucca_user" => $user
+]);
+

+ 0 - 0
api/get_all_users.php → api/user/users/GET_all_users.php