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

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 numéro SIREN. 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 à la récupération des informations liées au SIREN (événements BODACC, liste des représentants légaux et des bénéficiares…) et 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	5a145d6765cc642c9a07
`siren`	String (nombre composé de 9 chiffres)	siren de la personne morale qui va être créée ou mise à jour	802314435

Exemple de body

CODE

{
  "name": "UNIVERSITY",
  "oriasId": "12345678",
  "naf": "B06_10Z",
  "postalAddress": {
    "address": "1 rue Marie Curie",
    "zipCode": "75000",
    "city": "PARIS",
    "country": "France",
    "building": "Appartement 01"
  },
  "creationDate": "2019-10-23",
  "registrationDate": "2020-11-24",
  "issuingOffice": "issuingOffice",
  "contract": {
    "startDate": "2024-01-23T13:16:32.432Z",
    "endDate": "2024-01-23T13:16:32.433Z"
  }
}

Réponse synchrone

Exemple de réponse obtenue quand la personne morale a été créée :

CODE

{
  "id": "65b111ab014e6b2f61df6da6",
  "externalRefId": "5a145d6765cc642c9a07",
  "riskStatus": "NO_RISK_FOUND",
  "version": "2024-01-24T13:33:31.301Z",
  "name": "UNIVERSITY",
  "naf": "B06_10Z",
  "oriasId": "12345678",
  "postalAddress": {
    "address": "1 rue Marie Curie",
    "zipCode": "75000",
    "city": "PARIS",
    "country": "France"
  },
  "creationDate": "2019-10-23",
  "registrationDate": "2020-11-24",
  "issuingOffice": "issuingOffice",
  "contract": {
    "startDate": "2024-01-23T13:16:32.432Z",
    "endDate": "2024-01-23T13:16:32.433Z",
    "legalEntityRef": {}
  }
}

Exemple de réponse obtenue quand la personne morale a été modifiée :

CODE

{
  "id": "65b111ab014e6b2f61df6da6",
  "externalRefId": "5a145d6765cc642c9a07",
  "riskStatus": "NO_RISK_FOUND",
  "version": "2024-01-24T13:33:31.407Z",
  "lastControlDate": "2024-01-24T13:34:19.203Z",
  "name": "UNIVERSITY",
  "naf": "B06_10Z",
  "oriasId": "12345678",
  "postalAddress": {
    "address": "1 rue Marie Curie",
    "zipCode": "75000",
    "city": "PARIS",
    "country": "France"
  },
  "creationDate": "2019-10-23",
  "registrationDate": "2020-11-24",
  "issuingOffice": "issuingOffice",
  "contract": {
    "startDate": "2024-01-23T13:16:32.432Z",
    "endDate": "2024-01-23T13:16:32.433Z",
    "legalEntityRef": {}
  }
}

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 ainsi qu’un numéro ORIAS non trouvé :

CODE

{
  "eventId": "38096814-76e8-4948-a9ac-a2d040006222",
  "type": "ASYNC_RESPONSE",
  "data": {
    "legalEntityData": {
      "legalEntity": {
        "id": "65b111ab014e6b2f61df6da6",
        "externalRefId": "5a145d6765cc642c9a07",
        "riskStatus": "NO_RISK_FOUND",
        "version": "2024-01-24T13:33:31.407Z",
        "lastControlDate": "2024-01-24T13:35:51.849Z",
        "name": "UNIVERSITY",
        "naf": "B06_10Z",
        "oriasId": "12345678",
        "postalAddress": {
          "address": "1 rue Marie Curie",
          "zipCode": "75000",
          "city": "PARIS",
          "country": "France"
        },
        "creationDate": "2019-10-23",
        "registrationDate": "2020-11-24",
        "issuingOffice": "issuingOffice",
        "contract": {
          "startDate": "2024-01-23T13:16:32.432Z",
          "endDate": "2024-01-23T13:16:32.433Z",
          "legalEntityRef": {}
        },
        "legalCategory": "SAS - société par actions simplifiée"
      },
      "bodaccEvents": [],
      "beneficialOwners": [
        {
          "externalRef": "MORTHA_DHARMANAND_RAO_1976-12",
          "sourceName": "BENEFICIAL_OWNER",
          "lastName": "MORTHA",
          "firstName": "DHARMANAND RAO"
        },
        {
          "externalRef": "ANTHONY_EDWIN_GREGORY_DANRAJ_A/L_1978-12",
          "sourceName": "BENEFICIAL_OWNER",
          "lastName": "ANTHONY EDWIN",
          "firstName": "GREGORY DANRAJ A/L"
        },
        {
          "externalRef": "BIN_ZAMRI_ABDUL_RAZAK_1969-02",
          "sourceName": "BENEFICIAL_OWNER",
          "lastName": "BIN ZAMRI",
          "firstName": "ABDUL RAZAK"
        }
      ],
      "representatives": [
        {
          "externalRef": "BIN_ZAMRI_ABDUL_RAZAK_1969-02",
          "sourceName": "REPRESENTATIVE",
          "lastName": "Bin Zamri",
          "firstName": "ABDUL, RAZAK"
        },
        {
          "externalRef": "ANTHONY_EDWIN_GREGORY_DANRAJ_A/L_1978-12",
          "sourceName": "REPRESENTATIVE",
          "lastName": "Anthony Edwin",
          "firstName": "GREGORY, DANRAJ, A/L"
        },
        {
          "externalRef": "GAGNEUX_MARTIAL_1962-10",
          "sourceName": "REPRESENTATIVE",
          "lastName": "Gagneux",
          "firstName": "MARTIAL"
        },
        {
          "externalRef": "MORTHA_DHARMANAND_RAO_1976-12",
          "sourceName": "REPRESENTATIVE",
          "lastName": "Mortha",
          "firstName": "DHARMANAND, RAO"
        }
      ],
      "sirenData": {
        "personCompanyInfo": {
          "organizationName": "ALZETTE UNIVERSITY",
          "creationDate": "2020-12-03",
          "active": true,
          "mainActivity": "70.22Z",
          "companyCategory": "PME",
          "legalCategory": "5710"
        },
        "personCompanyOffice": {
          "siret": "89231276000010",
          "mainActivity": "70.22Z",
          "address": {
            "address": "25 PL DE LA MADELEINE",
            "zipCode": "75008",
            "city": "PARIS 8",
            "country": "FRA"
          },
          "establishmentsSiret": [
            "89231276000010"
          ]
        },
        "publicationStatus": true
      }
    },
    "controlResults": {
      "BODACC_EVENTS": {
        "type": "BODACC_EVENTS",
        "controlResults": {
          "AccountFilingBodaccEventControl": {
            "controlType": "AccountFilingBodaccEventControl",
            "date": "2024-01-24T13:35:51.795Z",
            "score": 100,
            "nbOfPastYearEvents": 0
          },
          "CollectiveBodaccEventControl": {
            "controlType": "CollectiveBodaccEventControl",
            "date": "2024-01-24T13:35:51.804Z",
            "score": 0,
            "nbOfPastYearEvents": 0
          },
          "CreationBodaccEventControl": {
            "controlType": "CreationBodaccEventControl",
            "date": "2024-01-24T13:35:51.812Z",
            "score": 0,
            "nbOfPastYearEvents": 0
          },
          "ModificationBodaccEventControl": {
            "controlType": "ModificationBodaccEventControl",
            "date": "2024-01-24T13:35:51.820Z",
            "score": 0,
            "nbOfPastYearEvents": 0
          },
          "RegistrationBodaccEventControl": {
            "controlType": "RegistrationBodaccEventControl",
            "date": "2024-01-24T13:35:51.827Z",
            "score": 0,
            "nbOfPastYearEvents": 0
          },
          "SalesBodaccEventControl": {
            "controlType": "SalesBodaccEventControl",
            "date": "2024-01-24T13:35:51.835Z",
            "score": 0,
            "nbOfPastYearEvents": 0
          },
          "WriteOffBodaccEventControl": {
            "controlType": "WriteOffBodaccEventControl",
            "date": "2024-01-24T13:35:51.843Z",
            "score": 0,
            "nbOfPastYearEvents": 0
          }
        },
        "completenessRatio": 0,
        "vigilanceRatio": 14
      },
      "LEGAL_ENTITY": {
        "type": "LEGAL_ENTITY",
        "controlResults": {
          "BlacklistControl": {
            "personDataSourceName": "CLIENTS",
            "externalRefId": "5a145d6765cc642c9a07",
            "controlType": "BlacklistControl",
            "date": "2024-01-24T13:35:51.529Z",
            "score": 100,
            "blacklistPepStatus": "POTENTIAL_RISK",
            "riskFolderId": "65b111db2cd8567661531cf1",
            "blacklistPepControlResultSnapshot": {
              "personControlResultId": "2024-01-24T13:35:51.529Z-BLACKLIST-eeedd6b7-e544-4100-9481-312a77879e5b",
              "type": "BLACKLIST",
              "date": "2024-01-24T13:35:51.529Z",
              "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:35:51.767Z",
            "score": 100,
            "status": "RISK"
          },
          "HeadcountRangeControl": {
            "controlType": "HeadcountRangeControl",
            "date": "2024-01-24T13:35:51.776Z",
            "score": 100,
            "status": "RISK"
          },
          "LegalEntityGafiControl": {
            "controlType": "LegalEntityGafiControl",
            "date": "2024-01-24T13:35:51.761Z",
            "score": 100,
            "status": "HIGH_RISK"
          },
          "LegalEntityNafControl": {
            "controlType": "LegalEntityNafControl",
            "date": "2024-01-24T13:35:51.764Z",
            "score": 0,
            "status": "NO_RISK"
          },
          "OriasControl": {
            "controlType": "OriasControl",
            "date": "2024-01-24T13:35:51.765Z",
            "score": 100,
            "oriasRegistration": {
              "number": "12345678",
              "status": "UNREGISTERED",
              "dateChecked": "2024-01-24T13:34:18.598Z"
            },
            "status": "UNREGISTERED"
          },
          "SirenControl": {
            "controlType": "SirenControl",
            "date": "2024-01-24T13:35:51.765Z",
            "score": 0,
            "status": "NO_RISK"
          }
        },
        "completenessRatio": 90,
        "vigilanceRatio": 71
      },
      "LEGAL_ENTITY_OVERVIEW": {
        "type": "LEGAL_ENTITY_OVERVIEW",
        "controlResults": {},
        "completenessRatio": 45,
        "vigilanceRatio": 42
      }
    },
    "riskStatus": "NO_RISK_FOUND"
  }
}