Intégration de la recherche avancée de sociétés

Cette page de documentation décrit la capacité de recherche avancée de l’API Sis Inside. Les détails des objets sont disponibles dans la documentation API.

A propos

La capacité d’identification des entreprises utilisée dans les produits Sis ID pour les contrôles ou les invitations est étendue par des paramètres de recherche supplémentaires et optionnels.

Ces paramètres sont utilisés par Sis ID afin d’améliorer le taux de succès de l’identification des entreprises auprès de fournisseurs de données tiers. Ils sont particulièrement pertinents pour les vérifications de tiers dans des pays tels que les États-Unis, le Canada ou l’Allemagne (liste non exhaustive), afin de contourner les limitations documentées dans :

• Spécificités par pays et solutions de contournement

• Les spécificités de l'identification de société aux Etats-Unis, Les spécificités de l'identification de société en Allemagne ou Les spécificités de l'identification de société au Canada

Quand utiliser la fonctionnalité de recherche avancée

La fonctionnalité de recherche avancée s’applique à l’identification des entreprises dans tous les pays et doit être utilisée :

• Lorsque l’identification de l’entreprise échoue avec des raisons explicites telles que Company unknown ou Too many companies found

• Sans limitation liée à des pays spécifiques

• Pour améliorer les contrôles utilisant un registration ID
  (elle ne s’applique pas aux contrôles basés uniquement sur le nom)

L’utilisation de cette capacité ne nécessite aucune option, aucune permission ni aucune augmentation tarifaire.

Comportement de recherche et logique de matching

Le mécanisme de recherche repose sur un matching par proximité. Les résultats sont sélectionnés en fonction du degré d’alignement entre les paramètres de recherche fournis et les données d’entreprise enregistrées.

L’ajout de paramètres pertinents améliore la précision du matching, tandis que l’ajout de paramètres incorrects ou contradictoires dégrade l’efficacité du matching et peut empêcher le retour d’un résultat.

Certains identifiants (comme le registrationId) n’étant pas uniques au sein d’un pays, des critères de recherche avancés peuvent être nécessaires pour identifier une entreprise de manière univoque.

Exemple

Société existante

country: US
registrationId: 123456789
city: Mandeville
zipCode: 70471
state: Louisiana (LA)

Étant donné que registrationId = 123456789 n’est pas unique parmi les entreprises américaines, des paramètres supplémentaires sont requis pour identifier correctement cette entreprise.

Recherches abouties

Les recherches suivantes retournent l’entreprise car les paramètres sont suffisamment proches des données enregistrées :

registrationId = 123456789, country = US, city = Mandeville

registrationId = 123456789, country = US, city = Mandeville, zipCode = 99999

registrationId = 123456789, country = US, city = Damneville
(une légère variation du nom de la ville est toujours acceptée par le matching de proximité)

Recherches non abouties

Les recherches suivantes ne retournent pas l’entreprise en raison d’une faible proximité ou de paramètres contradictoires :

registrationId = 123456789, country = US, city = AnyCityName

registrationId = 123456789, country = US, city = Mandeville, zipCode = 99999, companyName = AnyName
(un nom d’entreprise incorrect fait chuter le score global de matching en dessous du seuil requis)

Critères de recherche avancée

Les critères de recherche suivants peuvent être ajoutés aux objets entity / company pour la vérification d’une entité légale :

• name

• streetAddress

• postalCode

• city

ℹ️ Les noms des propriétés de critères de recherche peuvent varier d’une API à l’autre en raison de contraintes de pré-existence des propriétés. Veuillez vous référer aux sections DTO de la documentation API pour plus de détails.

Ce qui est nouveau

{
    "entity": {
        "company": {
            "countryCode": "string",
            "registrationId": "string",
            "name": "string",  //EXISTING
            "address": {
                "streetAddress": "string",      //NEW
                "postalCode": "string",  //EXISTING
                "city": "string"         //NEW
            },
        },
        "paymentIdentity": {
            "bban": "string",
            "bic": "string",
            "countryCode": "string",
            "iban": "string",
            "routingCode": "string"
        },
        "reference": "MYCOMPANY-REF-123456",
        "tags": [
            "string"
        ]
    }
}

  "input": {
        "paymentIdentity": {
            "iban": "string"
        },
        "company": {
            "countryCode": "string",
            "registrationId": "string",
            "name" : "string",
            "address": {
                "streetAddress": "string",
                "postalCode": "string",
                "city": "string"
            }
        }

{
    "company": {
        "countryCode": "FR",
        "companyId": "010742391",
        "name": "NVIDIA Corporation",
        "address": {
            "streetAddress": "90 STATE ST, STE 700",
            "postalCode": "12207-1707",
            "city": "ALBANY"
    }
}