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