PUT CREATE CHECK PM ref et name - Création/Update et contrôle d'une personne morale à partir d'une référence et d'un nom

Ce endpoint de l'API permet de créer ou mettre à jour les informations d'une personne morale et d'effectuer des contrôles sur cette personne à partir d'une référence et d'un nom. Le filtrage peut donner lieu à la création ou la mise à jour de dossiers de risques associés.

Une réponse synchrone est reçue suite à la création de la personne morale.
Une réponse asynchrone (webhook) est reçue sur une url suite aux contrôles de la personne morale.

Description

Les descriptions complètes de l’appel et de la réponse asynchrone sont accessibles sur notre swagger

Méthode

PUT

Paramètres

Param	Type	Description	Exemple
`sourceName`	String	Nom technique de la source sur laquelle la personne morale va être créée	CLIENTS
`externalRefId`	String	La référence de la personne morale qui va être créée ou mise à jour	440726289
`name`	String	Nom de la personne morale qui va être créée ou mise à jour	UNIVERSITY

Exemple de body

CODE

{
    "externalRefId": "440726289",
    "oriasId" : "13004246",
    "name" : "UNIVERSITY", 
    "naf": "G45_20A",
    "legalCategory": "SAS - société par actions simplifiée",
    "postalAddress": 
    {
        "address": "4 rue Marie Curie",
        "zipCode": "75000",
        "city": "PARIS",
        "country": "France",
        "building": "Mairie"
    }, 
    "creationDate": "2019-10-23",
    "registrationDate": "2020-11-24",
    "issuingOffice": "Administration émettrice",
    "contract": 
    {
        "startDate": "2022-07-21T04:03:22.941906286Z",
            "endDate": "2022-07-26T04:03:22.941910166Z"
    }
}

Réponse synchrone

Exemple de réponse obtenue quand la personne morale a été créée/mise à jour :

CODE

{
  "id": "65b0e2c0d7cf680e1d355b5d",
  "externalRefId": "440726289",
  "riskStatus": "NO_RISK_FOUND",
  "version": "2024-01-24T13:03:20.241Z",
  "lastControlDate": "2024-01-24T13:02:35.217Z",
  "name": "UNIVERSITY",
  "naf": "G45_20A",
  "oriasId": "13004246",
  "postalAddress": {
    "address": "4 rue Marie Curie",
    "zipCode": "75000",
    "city": "PARIS",
    "country": "France"
  },
  "creationDate": "2019-10-23",
  "registrationDate": "2020-11-24",
  "issuingOffice": "Administration émettrice",
  "contract": {
    "startDate": "2022-07-21T04:03:22.941Z",
    "endDate": "2022-07-26T04:03:22.941Z",
    "legalEntityRef": {}
  },
  "legalCategory": "SAS - société par actions simplifiée"
}

Réponse asynchrone

Détails sur le swagger

Exemple de réponse obtenue si la personne morale a matché avec des correspondances pendant le filtrage, ce qui a conduit a un dossier de risque GDA.

CODE

{
  "eventId": "05adbd03-77ca-476c-8207-2e99017f27e9",
  "type": "ASYNC_RESPONSE",
  "data": {
    "legalEntityData": {
      "legalEntity": {
        "id": "65b0e2c0d7cf680e1d355b5d",
        "externalRefId": "440726289",
        "riskStatus": "NO_RISK_FOUND",
        "version": "2024-01-24T13:03:20.241Z",
        "lastControlDate": "2024-01-24T13:03:21.143Z",
        "name": "UNIVERSITY",
        "naf": "G45_20A",
        "oriasId": "13004246",
        "postalAddress": {
          "address": "4 rue Marie Curie",
          "zipCode": "75000",
          "city": "PARIS",
          "country": "France"
        },
        "creationDate": "2019-10-23",
        "registrationDate": "2020-11-24",
        "issuingOffice": "Administration émettrice",
        "contract": {
          "startDate": "2022-07-21T04:03:22.941Z",
          "endDate": "2022-07-26T04:03:22.941Z",
          "legalEntityRef": {}
        },
        "legalCategory": "SAS - société par actions simplifiée"
      },
      "bodaccEvents": [],
      "beneficialOwners": [],
      "representatives": [],
      "sirenData": {}
    },
    "controlResults": {
      "BODACC_EVENTS": {
        "type": "BODACC_EVENTS",
        "controlResults": {
          "AccountFilingBodaccEventControl": {
            "controlType": "AccountFilingBodaccEventControl",
            "date": "2024-01-24T13:03:21.134Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "CollectiveBodaccEventControl": {
            "controlType": "CollectiveBodaccEventControl",
            "date": "2024-01-24T13:03:21.136Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "CreationBodaccEventControl": {
            "controlType": "CreationBodaccEventControl",
            "date": "2024-01-24T13:03:21.137Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "ModificationBodaccEventControl": {
            "controlType": "ModificationBodaccEventControl",
            "date": "2024-01-24T13:03:21.139Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "RegistrationBodaccEventControl": {
            "controlType": "RegistrationBodaccEventControl",
            "date": "2024-01-24T13:03:21.140Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "SalesBodaccEventControl": {
            "controlType": "SalesBodaccEventControl",
            "date": "2024-01-24T13:03:21.141Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "WriteOffBodaccEventControl": {
            "controlType": "WriteOffBodaccEventControl",
            "date": "2024-01-24T13:03:21.143Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          }
        },
        "completenessRatio": 0,
        "vigilanceRatio": 0
      },
      "LEGAL_ENTITY": {
        "type": "LEGAL_ENTITY",
        "controlResults": {
          "BlacklistControl": {
            "personDataSourceName": "CLIENTS",
            "externalRefId": "440726289",
            "controlType": "BlacklistControl",
            "date": "2024-01-24T13:03:20.989Z",
            "score": 100,
            "blacklistPepStatus": "POTENTIAL_RISK",
            "riskFolderId": "65b1081ef11b8e4e54c414b5",
            "blacklistPepControlResultSnapshot": {
              "personControlResultId": "2024-01-24T13:03:20.989Z-BLACKLIST-c40b3a38-f3bd-4446-887e-488bcd69f22e",
              "type": "BLACKLIST",
              "date": "2024-01-24T13:03:20.989Z",
              "controlListImports": [
                {
                  "dataImportId": "658178eb0c6a3018810cb281",
                  "source": "SANCTIONS_RUSSIE_Morales",
                  "totalEntries": 86,
                  "date": "2023-12-19T11:05:15.725Z"
                },
                {
                  "dataImportId": "65ae805f95f84261e7e4581c",
                  "source": "FR_Morales",
                  "totalEntries": 969,
                  "date": "2024-01-22T14:48:30.669Z"
                },
                {
                  "dataImportId": "65aff88a32b7f57f1defd8dc",
                  "source": "UE_Morales",
                  "totalEntries": 960,
                  "date": "2024-01-23T17:33:56.754Z"
                },
                {
                  "dataImportId": "65b057b332b7f57f1df0187e",
                  "source": "ONU_Morales",
                  "totalEntries": 193,
                  "date": "2024-01-24T00:19:47.563Z"
                }
              ],
              "trigger": {
                "type": "MODULE",
                "login": "userapi@beclm.com"
              }
            },
            "status": "POTENTIAL_RISK"
          },
          "CoBrokerControl": {
            "controlType": "CoBrokerControl",
            "date": "2024-01-24T13:03:21.127Z",
            "score": 100,
            "status": "RISK"
          },
          "HeadcountRangeControl": {
            "controlType": "HeadcountRangeControl",
            "date": "2024-01-24T13:03:21.132Z",
            "score": 100,
            "status": "RISK"
          },
          "LegalEntityGafiControl": {
            "controlType": "LegalEntityGafiControl",
            "date": "2024-01-24T13:03:21.122Z",
            "score": 100,
            "status": "HIGH_RISK"
          },
          "LegalEntityNafControl": {
            "controlType": "LegalEntityNafControl",
            "date": "2024-01-24T13:03:21.125Z",
            "score": 0,
            "status": "NO_RISK"
          },
          "OriasControl": {
            "controlType": "OriasControl",
            "date": "2024-01-24T13:03:21.125Z",
            "score": 0,
            "oriasRegistration": {
              "number": "13004246",
              "status": "REGISTERED",
              "dateChecked": "2024-01-24T13:02:34.517Z"
            },
            "status": "REGISTERED"
          },
          "SirenControl": {
            "controlType": "SirenControl",
            "date": "2024-01-24T13:03:21.126Z",
            "score": 100,
            "status": "RISK"
          }
        },
        "completenessRatio": 86,
        "vigilanceRatio": 71
      },
      "LEGAL_ENTITY_OVERVIEW": {
        "type": "LEGAL_ENTITY_OVERVIEW",
        "controlResults": {},
        "completenessRatio": 43,
        "vigilanceRatio": 35
      }
    },
    "riskStatus": "NO_RISK_FOUND"
  }
}

Exemple si aucun risque GDA n’est détecté :

CODE

{
  "eventId": "b65bda50-2a85-4b33-ac1a-1185707e0507",
  "type": "ASYNC_RESPONSE",
  "data": {
    "legalEntityData": {
      "legalEntity": {
        "id": "65b10c39014e6b2f61df6d97",
        "externalRefId": "92158028",
        "riskStatus": "NO_RISK_FOUND",
        "version": "2024-01-24T13:10:17.866Z",
        "lastControlDate": "2024-01-24T13:10:18.826Z",
        "name": "AVOCAT",
        "naf": "G45_20A",
        "oriasId": "13004246",
        "postalAddress": {
          "address": "4 rue Marie Curie",
          "zipCode": "75000",
          "city": "PARIS",
          "country": "France"
        },
        "creationDate": "2019-10-23",
        "registrationDate": "2020-11-24",
        "issuingOffice": "Administration émettrice",
        "contract": {
          "startDate": "2022-07-21T04:03:22.941Z",
          "endDate": "2022-07-26T04:03:22.941Z",
          "legalEntityRef": {}
        },
        "legalCategory": "SAS - société par actions simplifiée"
      },
      "bodaccEvents": [],
      "beneficialOwners": [],
      "representatives": [],
      "sirenData": {}
    },
    "controlResults": {
      "BODACC_EVENTS": {
        "type": "BODACC_EVENTS",
        "controlResults": {
          "AccountFilingBodaccEventControl": {
            "controlType": "AccountFilingBodaccEventControl",
            "date": "2024-01-24T13:10:18.815Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "CollectiveBodaccEventControl": {
            "controlType": "CollectiveBodaccEventControl",
            "date": "2024-01-24T13:10:18.817Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "CreationBodaccEventControl": {
            "controlType": "CreationBodaccEventControl",
            "date": "2024-01-24T13:10:18.819Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "ModificationBodaccEventControl": {
            "controlType": "ModificationBodaccEventControl",
            "date": "2024-01-24T13:10:18.820Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "RegistrationBodaccEventControl": {
            "controlType": "RegistrationBodaccEventControl",
            "date": "2024-01-24T13:10:18.822Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "SalesBodaccEventControl": {
            "controlType": "SalesBodaccEventControl",
            "date": "2024-01-24T13:10:18.824Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "WriteOffBodaccEventControl": {
            "controlType": "WriteOffBodaccEventControl",
            "date": "2024-01-24T13:10:18.826Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          }
        },
        "completenessRatio": 0,
        "vigilanceRatio": 0
      },
      "LEGAL_ENTITY": {
        "type": "LEGAL_ENTITY",
        "controlResults": {
          "BlacklistControl": {
            "personDataSourceName": "CLIENTS",
            "externalRefId": "92158028",
            "controlType": "BlacklistControl",
            "date": "2024-01-24T13:10:18.580Z",
            "score": 0,
            "blacklistPepStatus": "NO_RISK_FOUND",
            "blacklistPepControlResultSnapshot": {
              "personControlResultId": "2024-01-24T13:10:18.580Z-BLACKLIST-d7a69e60-61c1-473a-b36d-fd70c74c54c5",
              "type": "BLACKLIST",
              "date": "2024-01-24T13:10:18.580Z",
              "controlListImports": [
                {
                  "dataImportId": "658178eb0c6a3018810cb281",
                  "source": "SANCTIONS_RUSSIE_Morales",
                  "totalEntries": 86,
                  "date": "2023-12-19T11:05:15.725Z"
                },
                {
                  "dataImportId": "65ae805f95f84261e7e4581c",
                  "source": "FR_Morales",
                  "totalEntries": 969,
                  "date": "2024-01-22T14:48:30.669Z"
                },
                {
                  "dataImportId": "65aff88a32b7f57f1defd8dc",
                  "source": "UE_Morales",
                  "totalEntries": 960,
                  "date": "2024-01-23T17:33:56.754Z"
                },
                {
                  "dataImportId": "65b057b332b7f57f1df0187e",
                  "source": "ONU_Morales",
                  "totalEntries": 193,
                  "date": "2024-01-24T00:19:47.563Z"
                }
              ],
              "trigger": {
                "type": "MODULE",
                "login": "userapi@beclm.com"
              }
            },
            "status": "NO_RISK_FOUND"
          },
          "CoBrokerControl": {
            "controlType": "CoBrokerControl",
            "date": "2024-01-24T13:10:18.808Z",
            "score": 100,
            "status": "RISK"
          },
          "HeadcountRangeControl": {
            "controlType": "HeadcountRangeControl",
            "date": "2024-01-24T13:10:18.814Z",
            "score": 100,
            "status": "RISK"
          },
          "LegalEntityGafiControl": {
            "controlType": "LegalEntityGafiControl",
            "date": "2024-01-24T13:10:18.803Z",
            "score": 100,
            "status": "HIGH_RISK"
          },
          "LegalEntityNafControl": {
            "controlType": "LegalEntityNafControl",
            "date": "2024-01-24T13:10:18.806Z",
            "score": 0,
            "status": "NO_RISK"
          },
          "OriasControl": {
            "controlType": "OriasControl",
            "date": "2024-01-24T13:10:18.806Z",
            "score": 100,
            "status": "null"
          },
          "SirenControl": {
            "controlType": "SirenControl",
            "date": "2024-01-24T13:10:18.807Z",
            "score": 100,
            "status": "RISK"
          }
        },
        "completenessRatio": 86,
        "vigilanceRatio": 71
      },
      "LEGAL_ENTITY_OVERVIEW": {
        "type": "LEGAL_ENTITY_OVERVIEW",
        "controlResults": {},
        "completenessRatio": 43,
        "vigilanceRatio": 35
      }
    },
    "riskStatus": "NO_RISK_FOUND"
  }
}