Emplois

Un emploi est le lien durable entre un employé et un employeur. Un employé peut avoir plusieurs emplois (multi-employeurs ou successifs). Module requis : MaCarteDeMembre.

Liste / recherche des emplois

GET /b2b/v1/emploi
GET /b2b/v2/emploi

Les deux versions acceptent les mêmes filtres en query string. La V2 retourne un DTO légèrement enrichi.

Filtres disponibles

Nom	Type	Description
idExterneSyndicat	string	Filtre par syndicat (via l'employeur)
idExterneEmployeur	string	Filtre par employeur
idExterneEmploye	string	Filtre par employé
matricule	string	Recherche par matricule (égalité stricte)
actif	bool	true pour les emplois actifs (DateFin null)

Réponse

[
  {
    "identifiantExterne": "EMPLOI-001",
    "idUnique": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "identifiantExterneEmploye": "EMP-001",
    "identifiantExterneEmployeur": "EMPL-001",
    "nomEmployeur": "Entreprise ABC",
    "matricule": "M12345",
    "dateDebut": "2020-01-15T00:00:00Z",
    "dateFin": null
  }
]

Exemple

curl -X GET "https://api.macartedemembre.com/b2b/v2/emploi?idExterneEmployeur=EMPL-001&actif=true" \
  -H "X-Api-Key: votre-cle-api"

---

Obtenir un emploi

GET /b2b/v1/emploi/{idExterne}

Paramètres

Nom	Emplacement	Type	Description
idExterne	Path	string	Identifiant externe de l'emploi

---

Créer un emploi

POST /b2b/v1/emploi

Corps de la requête

{
  "identifiantExterne": "EMPLOI-001",
  "identifiantExterneEmploye": "EMP-001",
  "identifiantExterneEmployeur": "EMPL-001",
  "matricule": "M12345",
  "dateDebut": "2020-01-15T00:00:00Z",
  "dateFin": null
}

Erreurs possibles

Code	HTTP	Signification
Emploi.DejaExistant	409	Un emploi existe déjà pour ce couple (employé, employeur)
Emploi.IdExterneDejaUtilise	409	L'identifiant externe est déjà utilisé
Emploi.DateFinAvantDateDebut	400	dateFin antérieure à dateDebut
Employeur.NotFound	404	L'employeur cible n'existe pas
Employe.NotFound	404	L'employé cible n'existe pas

---

Modifier un emploi

PUT /b2b/v1/emploi

L'identifiantExterne identifie l'emploi à modifier.

Erreurs possibles

Code	HTTP	Signification
Emploi.NotFoundByIdExterne	404	L'emploi n'existe pas
Emploi.EmployeurImmutable	400	L'employeur ne peut pas être modifié — créez un nouvel emploi
Emploi.EmployeImmutable	400	L'employé ne peut pas être modifié

Pour terminer un emploi, mettez à jour dateFin plutôt que de supprimer — l'historique des adhésions reste auditable.

---

Supprimer un emploi

DELETE /b2b/v1/emploi/{idExterne}

---

Voir aussi

• IEmploisClient — client SDK .NET
• Guide — données maîtres
• Guide — synchronisation des employés