Cet endpoint de l'API permet de créer ou mettre à jour les informations d'une personne morale, et de lancer le filtrage.
Une réponse synchrone est reçue suite à la création ou mise à jour de la personne morale.
Une réponse asynchrone est reçue suite à l’exécution des contrôles sur la personne, contenant les résultats de ces contrôles
Description
Les descriptions complètes de l’appel et de la réponse asynchrone sont accessibles sur notre swagger
Méthode
PUT
Paramètres d’entrée
|
Param |
Type |
Description |
Exemple |
|---|---|---|---|
|
|
String |
Nom technique de la source sur laquelle la personne morale va être créée |
CLIENTS |
|
|
String |
La référence de la personne morale qui va être créée ou mise à jour |
134679852 |
Exemple de body
{{
"contracts": [
{
"type": "type",
"number": "123456",
"insurer": "insurer",
"startDate": "2024-10-23",
"endDate": "2025-10-23"
}
],
"personAdditionalInformation": {
"personType": "personType",
"genderCode": "genderCode",
"birthYear": "birthYear",
"birthMonth": "birthMonth",
"birthPlace": "birthPlace",
"legalForm": "legalForm",
"iban": "truncatedIban"
},
"personMetaData": {
"entities": [
"entity"
],
"subEntities": [
"subEntity"
]
},
"personCustomFields": [
{
"personCustomFieldDescriptorId": "personCustomFieldDescriptorId",
"value": "1500.58"
}
],
"sirenCode": "123456789",
"name": "Example Legal Entity",
"creationDate": "2019-10-23",
"oriasId": "12345678",
"naf": "B06_10Z",
"postalAddress": {
"address": "1 rue du test",
"zipCode": "40500",
"city": "COUDURES",
"country": "FRA",
"building": "Appartement 01"
},
"registrationDate": "2020-11-24",
"issuingOffice": "issuingOffice",
"contract": {
"startDate": "2025-03-01T10:00:00Z",
"endDate": "2026-03-01T10:00:00Z",
"legalEntityRef": {
"sourceName": "sourceName",
"externalRefId": "externalRefId"
}
},
"siret": "12345678901234",
"legalCategory": "legalCategory",
"personType": "personType",
"headcount": 11,
"headcountRange": "R010_049",
"legalEntityExtraData": {
"occupation": "occupation"
}
}
}
Réponse synchrone
Sortie immédiate :
|
Champ |
Type |
Description fonctionnelle |
Exemple |
|---|---|---|---|
|
|
String |
Raison sociale |
|
|
|
String |
Numéro SIREN, alimente les contrôles SIREN, BODACC et sectoriels |
|
|
|
String |
Numéro SIRET, contrôlé par cohérence avec le SIREN |
|
|
|
String |
Catégorie juridique |
|
|
|
String |
Sous-type de personne |
|
|
|
Enum |
Code APE/NAF, alimente le contrôle "secteur d'activité à risque" |
|
|
|
Date |
Date de création de la société |
|
|
|
Date |
Date d'immatriculation |
|
|
|
String |
Office / greffe d'immatriculation |
|
|
|
String |
Numéro ORIAS, alimente le contrôle ORIAS et le co-courtage |
|
|
|
Integer |
Effectif exact |
|
|
|
Enum |
Tranche d'effectif, alimente le contrôle de risque taille |
|
|
|
Objet |
Adresse postale |
|
|
|
Enum (code pays) |
Pays de rattachement, alimente les contrôles de risque pays |
|
|
|
Objet |
Contrat de rattachement à une autre entité |
du |
|
|
Liste |
Contrats d'assurance |
|
|
|
Objet |
Informations complémentaires, partagées avec le modèle PP |
|
|
|
Objet |
Rattachements internes |
|
|
|
Liste |
Champs personnalisés paramétrés par société |
|
|
|
String |
Activité déclarée |
|
|
|
Date |
Date de fin de relation commerciale, peut servir à la radiation automatique selon votre configuration. |
|
Réponse asynchrone
|
Champ |
Type |
Description fonctionnelle |
Exemple |
|---|---|---|---|
|
|
String (UUID) |
Identifiant unique de cet évènement de callback |
|
|
|
String |
Constante |
|
|
|
Objet |
Référence de la personne morale contrôlée, à rapprocher de votre système |
|
|
Pour chaque contrôle actif sur votre source : |
|||
|
|
Enum |
Statut global du dossier de risque suite à l'ensemble des contrôles |
|
|
|
Date-heure |
Date du dernier contrôle exécuté |
|
|
|
String |
Identifiant de la trace de contrôle immuable (PCR), à conserver si vous devez faire référence à ce contrôle auprès du support BeCLM |
|
|
|
String |
Famille fonctionnelle du contrôle (ex. "Risques LCB-FT", "Risques Bodacc") |
|
|
|
Integer / String |
Identifiant et nom technique du contrôle exécuté |
|
|
|
Date-heure |
Date d'exécution de ce contrôle précis |
|
|
|
Boolean |
Indique si le contrôle a effectivement été calculé (données suffisantes) |
|
|
|
Integer (0-100) |
Score de risque du contrôle |
|
|
|
Enum |
Résultat du contrôle |
|
|
|
String |
Libellé métier du contrôle |
|
|
|
String |
Donnée client ayant servi de base au calcul du contrôle |
|
|
|
Enum |
Type de contrôle : détermine les champs additionnels présents ci-dessous (discriminant) |
|
|
|
String |
Référence du dossier de risque associé dans le module GDA/PPE/AM |
|
|
|
Objet |
Détail de l'immatriculation ORIAS trouvée (catégorie, statut, activités bancaires, mandants) |
|
|
|
Integer |
Nombre d'évènements de ce type publiés au BODACC sur les 12 derniers mois |
|
|
|
Liste |
Résultats de screening (GDA/PEP/AM) sur chaque personne liée |
|
|
|
Liste |
Résultats de vigilance sur chaque personne liée |
|
|
|
String |
Nom de la combinaison de vigilance déclenchée |
|
|
|
Enum |
Niveau de vigilance calculé |
|