Aller au contenu principal

Employeurs

Endpoints CRUD pour la gestion des employeurs. Module requis : MaCarteDeMembre.

Préférez la V2 pour les nouvelles intégrations

En V2, les employeurs sont imbriqués dans les syndicats et synchronisés via ISyncClient.Sync. Les endpoints V1 ci-dessous restent disponibles pour les opérations unitaires et les intégrations existantes.

Liste des employeurs​

GET /b2b/v1/employeur

Réponse​

[
  {
    "identifiantExterne": "EMPL-001",
    "nom": "Entreprise ABC Inc.",
    "syndicatIdExterne": "SYND001"
  }
]

Exemple​

curl -X GET "https://api.macartedemembre.com/b2b/v1/employeur" \
  -H "X-Api-Key: votre-cle-api"

Obtenir un employeur​

GET /b2b/v1/employeur/{idExterne}

Paramètres​

NomEmplacementTypeDescription
idExternePathstringIdentifiant externe de l'employeur

Erreurs possibles​

CodeHTTPSignification
Employeur.NotFound404Aucun employeur n'existe avec cet identifiant externe

Créer un employeur​

POST /b2b/v1/employeur

Corps de la requête​

{
  "identifiantExterne": "EMPL-001",
  "nom": "Entreprise ABC Inc."
}

Erreurs possibles​

CodeHTTPSignification
Employeur.NomRequis400Le nom de l'employeur est requis
Employeur.Existing409Un employeur avec cet identifiantExterne existe déjà
Employeur.NomDuplique409Un employeur avec ce nom existe déjà

Modifier un employeur​

PUT /b2b/v1/employeur

Même structure que POST. L'identifiantExterne identifie l'employeur à modifier.

Erreurs possibles​

CodeHTTPSignification
Employeur.NotFound404Aucun employeur n'existe avec cet identifiantExterne
Employeur.NomDuplique409Le nouveau nom est déjà utilisé par un autre employeur

Supprimer un employeur​

DELETE /b2b/v1/employeur/{idExterne}

Opération destructrice. La suppression échouera au niveau de la base de données si l'employeur a encore des emplois (Emploi) ou des employés rattachés ; supprimez-les ou réaffectez-les au préalable.

Erreurs possibles​

CodeHTTPSignification
Employeur.NotFound404Aucun employeur n'existe avec cet identifiantExterne

Voir aussi​