API Références

Gestion des Salariés

API pour créer et gérer les salariés dans un dossier.

Introduction

L'API de gestion des salariés vous permet de créer un salarié dans un dossier. Cette API est conçue pour s'intégrer facilement avec différents systèmes et applications.

Toutes les requêtes à cette API nécessitent une authentification. Consultez la documentation d'authentification pour plus de détails.
POST
/api/salaries/nouveau

Créer un nouveau salarié

Cet endpoint permet de créer un nouveau salarié dans un dossier spécifié.

Utilisation

Corps de la requête
{
  "codeDossier": "string",
  "donneesStatiques": {
    "matriculeAutomatique": true,
    "matricule": "string",
    "civilite": "string",
    "nom": "string",
    "prenom": "string",
    "dateNaissance": "2025-03-28T10:26:26.005Z",
    "dateEmbauche": "2025-03-28T10:26:26.005Z",
    "nationalite": "string",
    "paysResidence": "string",
    "villeNaissance": "string",
    "numCnps": "string",
    "numCmu": "string",
    "nomMarital": "string",
    "telephone": "string",
    "email": "string",
    "nombreDePart": "0.5",
    "nombreEnfantCharge": "string",
    "quartier": "string",
    "boitePostale": "string",
    "commune": "string",
    "typeSalarie": "string"
  },
  "donneesEvolutives": {
    "contrat": {
      "dateEffet": "2025-03-28T10:26:26.005Z",
      "dateFin": "2025-03-28T10:26:26.005Z",
      "type": "string",
      "nature": "string"
    },
    "emploi": {
      "dateEffet": "2025-03-28T10:26:26.005Z",
      "fonction": "string",
      "departement": "string",
      "service": "string"
    },
    "situationMatrimoniale": {
      "dateEffet": "2025-03-28T10:26:26.005Z",
      "situation": "string"
    }
  }
}
Paramètres principaux
codeDossier
Code identifiant le dossier dans lequel créer le salarié
Requis
Données statiques
matriculeAutomatique
Si true, le matricule sera généré automatiquement
Requis
matricule
Matricule du salarié (si matriculeAutomatique est false)
Conditionnel
civilite
Civilité du salarié (M., Mme, Mlle)
Requis
nom
Nom de famille du salarié
Requis
prenom
Prénom du salarié
Requis
dateNaissance
Date de naissance au format ISO 8601
Requis
dateEmbauche
Date d'embauche au format ISO 8601
Requis
email
Adresse email du salarié
Optionnel
telephone
Numéro de téléphone du salarié
Optionnel
nombreDePart
Nombre de part du salarié
Optionnel
nombreEnfantCharge
Numéro d'enfants à charge du salarié
Optionnel
quartier
Numéro de téléphone du salarié
Optionnel
boitePostale
Boîte postale du salarié
Optionnel
commune
Commune du salarié
Optionnel
typeSalarie
Type de salarié
Optionnel
adresseBulletin
Adresse sur le bulletin du salarié
Optionnel
Données évolutives
contrat.dateEffet
Date d'effet du contrat
Requis
contrat.dateFin
Date de fin du contrat (pour CDD)
Conditionnel
contrat.type
Type de contrat (CDI, CDD, etc.)
Requis
emploi.fonction
Fonction ou poste occupé par le salarié
Requis
situationMatrimoniale.situation
Situation matrimoniale (Célibataire, Marié(e), Divoircé(e))
Requis

Réponses

Réponse réussie
Code: 200 Created
{
                        "id": "123456",
                        "Matricule": "EMP001",
                        "NomComplet": "Dupont Jean",
                        "DateCreation": "2025-03-28T10:30:45.123Z"
                      }

Exemples d'intégration

JavaScript (Fetch API)
// Importation des fonctions d'authentification
import { generateAuthHeaders } from './auth.js';

// Fonction pour créer un salarié
async function createEmployee(employeeData) {
  try {
    const response = await fetch('https://apicloudpaiev3.cloudpaietest.net/v1/api/salaries/nouveau', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        ...generateAuthHeaders() // Ajoute les headers d'authentification
      },
      body: JSON.stringify(employeeData)
    });
    
    const data = await response.json();
    
    if (!response.ok) {
      throw new Error(data.error?.message || 'Une erreur est survenue');
    }
    
    return data;
  } catch (error) {
    console.error('Erreur lors de la création du salarié:', error);
    throw error;
  }
}

// Exemple d'utilisation
const employeeData = {
  codeDossier: "DOS123",
  donneesStatiques: {
    matriculeAutomatique: true,
    civilite: "M.",
    nom: "Dupont",
    prenom: "Jean",
    dateNaissance: "1985-05-15T00:00:00.000Z",
    dateEmbauche: "2023-01-10T00:00:00.000Z",
    email: "jean.dupont@example.com",
    telephone: "0123456789"
    "nombreDePart": 0,
    "nombreEnfantCharge": 0,
    "quartier": "string",
    "boitePostale": "string",
    "commune": "string",
    "typeSalarie": "Salarié",
    "adresseBulletin": "string"
  },
  donneesEvolutives: {
    contrat: {
      dateEffet: "2023-01-10T00:00:00.000Z",
      type: "CDI",
      nature: "Temps plein"
    },
    emploi: {
      dateEffet: "2023-01-10T00:00:00.000Z",
      fonction: "Développeur",
      departement: "IT",
      service: "Développement"
    },
    situationMatrimoniale: {
      dateEffet: "2023-01-10T00:00:00.000Z",
      situation: "Célibataire"
    }
  }
};

createEmployee(employeeData)
  .then(result => {
    console.log('Salarié créé avec succès:', result);
  })
  .catch(error => {
    console.error('Échec de la création du salarié:', error);
  });