| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285 |
- <?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)
- ]);
|