Nous contacter

Documentation API EnsoBtoB

Comment intégrer notre solution LIVE ENSOB2B

Historique 

Date

Numéro de version

Description

28/02/2022

1.0

Version 1 – lancement de l’API EnsoB2B

10/05/2022

1.1

Version 1.1 – intégration Endpoint Autosuggest

17/05/2022

1.2

Version 1.2 – intégration Endpoint Autosuggest_zip

26/08/2022

1.3

Version 1.3 – ajout du champ IsActive

La solution EnsoB2B vous met à disposition l’ensemble de données entreprises qui vous permettront de compléter rapidement le profil de vos prospects avec des données consolidées et vérifiées auprès des répertoires entreprises disponibles dans les pays couverts.

  • La vérification en temps réel de l’existence d’une société
  • La récupération des données entreprises (en synchrone ou asynchrone)
  • Une normalisation internationale des données
  • Un moteur de recherche modulable selon vos besoins

Authentification

Afin d’accéder à nos services, il est indispensable de s’authentifier via une clé unique sécurisé (ou token) qui vous est fourni par Data Enso. Votre token doit être intégré dans le header sous le paramètre « api_key » et présent lors de chaque appel à l’API EnsoPhone.

Appels sur les serveurs

Les appels au service EnsoB2B doivent être réalisés sur l’URL suivante :

				
					https://api.dataenso.com/b2b

Faire un appel à l’API ENSOB2B SEARCH 

Intégré dans les formulaires online, ce service permet d’enrichir de façon asynchrone les informations de l’entreprise via un couple de données réduit.

L’URL de cet Endpoint est la suivante : https://api.dataenso.com/b2b/

Afin de récupérer les informations société en temps réel et obtenir des résultats fiables, voici la liste des champs nécessaires pour composer votre recherche

Champ Statut Type Example Commentaires
Api_key Required String your-api-key Token généré par Data Enso
Name Required String Fermatic Nom de la société recherchée
country Optional String FRA country code au format ISO 3166-1 alpha-3
ZIP Optional Integer 92160 Code postal de la société recherchée

Réponse de l’appel API ENSOB2B SEARCH

Après avoir réalisé l’appel à nos services, voici les champs disponibles en retour

Champ

Type

Exemple

Commentaires

DUNSNumber

String

26XXXXX78

Numéro à 9 chiffres attribué par D&B entreprise.

CompanyName

String

FERMATIC SAS

Nom officiel de l’entreprise

CompanySecondaryName

String

FERMATIC

Nom secondaire, nom commercial ou marque de l’entreprise, le cas échéant.

AddressStreetLine1

String

ROUTE NATIONALE 190

Adresse de l’entreprise

AddressStreetLine2

String

RUE DE MANTES

Complément d’adresse

PostalCode

String

78440

Code postal de l’entreprise

City

String

GUITRANCOURT

Ville où se situe l’entreprise

StateProvince

String

YVELINES

Nom de l’état, du département de l’entreprise

Country

String

FRANCE

Pays de l’entreprise

NationalId

String

79XXXXXXX00019

Numéro d’identification de l’entreprise (SIRET, CNPJ,KWK…)

SICCode

String

1796

code de classification industrielle standard qui catégorise les entreprises selon le type d’activité

Industry

String

C

Code de la division SIC

Activity

String

 

Secteur d’activité principal

EstablishmentOfOwnership

String

2013

Date de création de l’entreprise

SalesEUR

Double

12060819

Chiffre d’affaires de l’année précédente

EmployeesNumber

String

50

Nombre de salariés de l’entreprise

IsActive

String

A

Indique si la société est active (A) ou activité est cessée (C)

EnsoId

String

H-FR01XXXXX230

Identifiant unique de la société

Exemple de requête ENSOB2B SEARCH

				
					https://api.dataenso.com/b2b/?name=ferma&zip=78440&country=FRA \
-h "api_key:your-token"

Réponse :

				
					[
    {
        "DUNSNumber": "26XXXXX78",
        "CompanyName": "FERMATIC SAS",
        "CompanySecondaryName": "",
        "AddressStreetLine1": "ROUTE NATIONALE 190",
        "AddressStreetLine2": "RUE DE MANTES",
        "PostalCode": "78440",
        "City": "GUITRANCOURT",
        "StateProvince": "YVELINES",
        "Country": "FRANCE",
        "NationalId": "79XXXXXXX00019",
        "SICCode": "1796",
        "Industry": "C",
        "EstablishmentOfOwnership": 2013,
        "SalesEUR": 1XXXXX19,
        "EmployeesNumber": 50
        "IsActive": "A",
        "EnsoId": "123456789",
    }
]

PS : afin de réduire la liste des réponses disponibles (recherche « stricte »), il est conseillé d’ajouter des « double quote » avant et après le terme recherché dans le champ name :

Ex : https://api.dataenso.com/b2b/?name= « fermatic »&country=FRA&zip=78440

Faire un appel à l’API ENSOB2B SUGGEST sans param Code Postal

Cet Endpoint est dédié aux usages de suggestion, saisie semi-automatique de société dans les formulaires online (intégrée généralement en liste déroulante de choix).

Il est optimisé pour permettre la recherche d’entreprises à l’aide uniquement du nom d’entreprise.

L’URL de cet Endpoint spécifique est la suivante : https://api.dataenso.com/b2bsuggest/

Champ

Statut

Type

Example

Commentaires

Api_key

Required

String

your-api-key

Token généré par Data Enso

name

Required

String

Fermatic

Nom de la société recherchée

country    

 

Required

String

FRA

country code au format ISO 3166-1 alpha-3

Réponse de l’appel API ENSOB2B SUGGEST sans param Code Postal

Après avoir réalisé l’appel à ce service dédié, voici les champs disponibles en retour :

Champ

Type

Exemple

Commentaires

CompanyName

String

SYND COPR DU 4 6 RUE FERMAT 75014 PARIS

Nom officiel de l’entreprise

PostalCode

String

75014

Code postal de l’entreprise

StateProvince

String

PARIS

Nom de l’état, du département de l’entreprise

NationalId

String

039XXXXXXXX015

Numéro d’identification de l’entreprise (SIRET, KWK…)

IsActive

String

A

Indique si la société est active (A) ou activité est cessée (C)

EnsoId

String

H-FR01XXXXX230

Identifiant unique de la société

 

Exemple de requête ENSOB2B SUGGEST sans param Code Postal

				
					https://api.dataenso.com/b2bsuggest/?name=ferma&country=FRA \
-h "api_key:your-token"

Réponse :

				
					[
    {
        "CompanyName": "FERMATIC SAS",
        "PostalCode": "78440",
        "StateProvince": "YVELINES",
        "NationalId": "79XXXXXXXXX019"
        "IsActive": "A",
        "EnsoId": "H-FR0024293040",

    },
    {
        "CompanyName": "FERMATIC AGENCE NORMANDIE",
        "PostalCode": "76160",
        "StateProvince": "SEINE MARITIME",
        "NationalId": "33XXXXXXXXX042"
        "IsActive": "A",
        "EnsoId": "H-FR0089886615",

    },
{
        "CompanyName": "SYND COPR DU 4 6 RUE FERMAT 75014 PARIS",
        "PostalCode": "75014",
        "StateProvince": "PARIS",
        "NationalId": "03XXXXXXXXX015"
                "IsActive": "A",
                "EnsoId": "H-FR0100703230",

    },
]

Faire un appel à l’API ENSOB2B SUGGEST avec param Code Postal

Ce second Endpoint dédié à l’auto-suggestion, permet, lorsque la valeur est présente dans le formulaire, d’effectuer une recherche géolocalisée de l’entreprise via le code postal.

L’URL de cet Endpoint spécifique est la suivante : https://api.dataenso.com/b2bsuggest_zipcode/

Champ

Statut

Type

Example

Commentaires

Api_key

Required

String

your-api-key

Token généré par Data Enso

name

Required

String

Fermatic

Nom de la société recherchée

country   

Required

String

FRA

country code au format ISO 3166-1 alpha-3

zip

Required

Integer

92160

Code postal de la société recherchée

Réponse de l’appel à l’API ENSOB2B SUGGEST avec param Code Postal

Après avoir réalisé l’appel à nos services, voici les champs disponibles en retour :

Champ

Type

Exemple

Commentaires

CompanyName

String

FERMATIC SAS

Nom officiel de l’entreprise

CompanySecondaryName

String

FERMATIC

Nom secondaire, nom commercial

AddressStreetLine1

String

ROUTE NATIONALE 190

Adresse de l’entreprise

AddressStreetLine2

String

RUE DE MANTES

Complément d’adresse

PostalCode

String

78440

Code postal de l’entreprise

City

String

GUITRANCOURT

Ville où se situe l’entreprise

IsActive

String

A

Indique si la société est active (A) ou activité est cessée (C)

EnsoId

String

H-FR01XXXXX230

Identifiant unique de la société

Exemple de requête ENSOB2B SUGGEST avec param Code postal

				
					https://api.dataenso.com/b2bsuggest_zipcode/?name=data&zip=92150&country=FRA \
-h "api_key:your-token"

Réponse :

				
					Champ	Type	Exemple	Commentaires
EnsoId	Integer	H-123456789	Identifiant unique de la société
E_DUNSNumber	Integer	26XXXXX78	Numéro à 9 chiffres attribué par D&B entreprise.
E_CompanyName	String	FERMATIC SAS	Nom officiel de l’entreprise
E_CompanySecondaryName	String	FERMATIC	Nom secondaire, nom commercial ou marque de l»entreprise, le cas échéant.
E_AddressStreetLine1	String	ROUTE NATIONALE 190	Adresse de l’entreprise
E_AddressStreetLine2	String	RUE DE MANTES	Complément d’adresse
E_PostalCode	String	78440	Code postal de l’entreprise
E_City	String	GUITRANCOURT	Ville où se situe l’entreprise
E_StateProvince	String	YVELINES	Nom de l’état, du département de l’entreprise
E_Country	String	FRANCE	Pays de l’entreprise
E_NationalId	String	79XXXXXXX00019	Numéro d’identification de l’entreprise (SIRET, CNPJ,KWK…)
E_NationalIdType	String	France SIRET Number	Source du National ID
E_IsActive	String	A	Indique si la société est active (A) ou activité est cessée (C)
E_SICText	String	Building equipment installation	Activité de la société dans la nomenclature internationale SIC
E_SICCode	String	1796	Code de classification industrielle standard qui catégorise les entreprises selon le type d’activité
E_Industry	String	C	Code de la division SIC
E_LocalActivityCode	Integer	4329B	Ce code représente le code d’activité utilisé localement. Exemples
incluent 1972 U.S. SIC, SBA, APE et NACE.
E_Activity	String		Secteur d’activité principal
E_EstablishmentOfOwnership	String	2013	Date de création de l’entreprise
E_last_year_turn_over	Double	12060819	Chiffre d’affaires de l’année précédente
E_last_year_turn_over_validity	Integer		
E_Employees	Integer	50	Le nombre d’employés dans l’entreprise.
E_Employees_Number_validity	string	0	Valeur qui décrit la fiabilité du nombre d’employés.
0 - réel
1 - peu fiable
2 - estimé ou non disponible lorsque le nombre d’employés
est zéro
3 - modélisé
vide - non disponible lorsque le champ E_Employees est égal à 0 ou est inconnu.
E_Employees_Number_Local	Integer	50	Le nombre d’employés à cette adresse.
E_Employees_Local_validity	string	0	Valeur qui décrit la fiabilité du nombre d’employés à cet endroit.
0 - réel
1 - peu fiable
2 - estimé ou non disponible lorsque le nombre d’employés
est zéro
3 - modélisé
vide - non disponible lorsque E_Employees_Number_Local est égal à 0 ou est inconnu.
E_Employees_Total	Integer	76	Le nombre total d’employés dans l’entreprise
E_Employees_Total_Validity	string	0	Valeur qui décrit la fiabilité du nombre d’employés à cet endroit.
0 - réel
1 - peu fiable
2 - estimé ou non disponible lorsque le nombre d’employés
est zéro
3 - modélisé
vide - non disponible lorsque E_Employees_Total est égal à 0 ou est inconnu.
E_Company_Type	String	private limited company		Statut juridique de la société
E_Location_Type	Integer	0	Ce code indique si l’entreprise est :
0 = unique - aucune autre entité ne lui rend compte
1 = Siège social/Parent : des succursales et/ou filiales rapportent à cette structure
2 = Succursale : emplacement secondaire à un siège social
Le code est vide lorsqu’il n’est pas disponible.
E_Websites	String	www.fermatic.fr	Liste de tous les sites web associés à la société
E_Website	String	www.fermatic.fr	Site web principal de la société

Faire un appel à l’API ENSOB2B COMPANY DETAILS

Afin de récupérer les informations complémentaires, il faut réaliser une requête additionnelle en interrogeant le numéro d’identifiant EnsoId de la société (information disponible dans les résultats de la requête SEARCH ou SUGGEST).

Les appels au service EnsoB2B DETAILS doivent être réalisés sur l’url suivante : https://api.dataenso.com/b2bdetail/

Champ

Statut

Type

Example

Commentaires

Api_key

Required

String

your-api-key

Token généré par Data Enso

EnsoId

Required

Integer

H-123456789

Identifiant de la société recherchée dans l’appel Enso Search

Réponse de l’appel API ENSOB2B COMPANY DETAILS

Après avoir réalisé l’appel à nos services, voici les champs disponibles en retour :

Champ

Type

Exemple

Commentaires

EnsoId

Integer

H-123456789

Identifiant unique de la société

E_DUNSNumber

Integer

26XXXXX78

Numéro à 9 chiffres attribué par D&B entreprise.

E_CompanyName

String

FERMATIC SAS

Nom officiel de l’entreprise

E_CompanySecondaryName

String

FERMATIC

Nom secondaire, nom commercial ou marque de l»entreprise, le cas échéant.

E_AddressStreetLine1

String

ROUTE NATIONALE 190

Adresse de l’entreprise

E_AddressStreetLine2

String

RUE DE MANTES

Complément d’adresse

E_PostalCode

String

78440

Code postal de l’entreprise

E_City

String

GUITRANCOURT

Ville où se situe l’entreprise

E_StateProvince

String

YVELINES

Nom de l’état, du département de l’entreprise

E_Country

String

FRANCE

Pays de l’entreprise

E_NationalId

String

79XXXXXXX00019

Numéro d’identification de l’entreprise (SIRET, CNPJ,KWK…)

E_NationalIdType

String

France SIRET Number

Source du National ID

E_SICText

String

Building equipment installation

Activité de la société dans la nomenclature internationale SIC

E_SICCode

String

1796

Code de classification industrielle standard qui catégorise les entreprises selon le type d’activité

E_Industry

String

C

Code de la division SIC

E_LocalActivityCode

Integer

4329B

Ce code représente le code d’activité utilisé localement. Exemples

incluent 1972 U.S. SIC, SBA, APE et NACE.

E_Activity

String

 

Secteur d’activité principal

E_EstablishmentOfOwnership

String

2013

Date de création de l’entreprise

E_last_year_turn_over

Double

12060819

Chiffre d’affaires de l’année précédente

E_last_year_turn_over_validity

Integer

 

 

E_Employees

Integer

50

Le nombre d’employés dans l’entreprise.

E_Employees_Number_validity

string

0

Valeur qui décrit la fiabilité du nombre d’employés.

0 – réel

1 – peu fiable

2 – estimé ou non disponible lorsque le nombre d’employés

est zéro

3 – modélisé

vide – non disponible lorsque le champ E_Employees est égal à 0 ou est inconnu.

E_Employees_Number_Local

Integer

50

Le nombre d’employés à cette adresse.

E_Employees_Local_validity

string

0

Valeur qui décrit la fiabilité du nombre d’employés à cet endroit.

0 – réel

1 – peu fiable

2 – estimé ou non disponible lorsque le nombre d’employés

est zéro

3 – modélisé

vide – non disponible lorsque E_Employees_Number_Local est égal à 0 ou est inconnu.

E_Employees_Total

Integer

76

Le nombre total d’employés dans l’entreprise

E_Employees_Total_Validity

string

0

Valeur qui décrit la fiabilité du nombre d’employés à cet endroit.

0 – réel

1 – peu fiable

2 – estimé ou non disponible lorsque le nombre d’employés

est zéro

3 – modélisé

vide – non disponible lorsque E_Employees_Total est égal à 0 ou est inconnu.

E_Company_Type

String

private limited company        

Statut juridique de la société

E_Location_Type

Integer

0

Ce code indique si l’entreprise est :

0 = unique – aucune autre entité ne lui rend compte

1 = Siège social/Parent : des succursales et/ou filiales rapportent à cette structure

2 = Succursale : emplacement secondaire à un siège social

Le code est vide lorsqu’il n’est pas disponible.

E_Websites

String

www.fermatic.fr

Liste de tous les sites web associés à la société

E_Website

String

www.fermatic.fr

Site web principal de la société

Exemple de requête COMPANY DETAILS

Réponse :

				
					https://api.dataenso.com/ /b2bdetail/?EnsoId=H-FR0024293040
-h "api_key:your-token"
				
			
				
					[EnsoId: «H-FR0024293040»,
  E_DUNSNumber: «264995778»,
  E_CompanyName: «FERMATIC SAS»,
  E_CompanySecondaryName: « »,
  E_AddressStreetLine1: «ROUTE NATIONALE 190»,
  E_AddressStreetLine2: «RUE DE MANTES»,
  E_PostalCode: «78440»,
  E_City: «GUITRANCOURT»,
  E_StateProvince: «YVELINES»,
  E_Country: «FRANCE»,
  E_NationalId: «79219347600019»,
  E_NationalIdType: «France SIRET Number»,
  E_Isactive : «A»,
  E_SICText: «Building equipment installation»,
  E_SICCode: «1796»,
  E_Industry: «C»,
  E_Local_Activity_Code: «4329B»,
  E_Local_Activity_Code_repository: "NAF2 (NOMENCLATURE D»ACTIVITE FRANCAISE ver 2)",
  E_EstablishmentOfOwnership: 2013,
  E_last_year_turn_over: 12060819,
  E_last_year_turn_over_validity: «0»,
  E_Employees: 50,
  E_Employees_Number_validity: «0»,
  E_Employees_Number_Local: 50,
  E_Employees_Local_validity: «0»,
  E_Employees_Total: 67,
  E_Employees_Total_Validity: «0»,
  E_Company_Type: «corporation»,
  E_Location_Type: 1,
  E_Websites: [ «www.fermatic.fr» ],
  E_Website: «www.fermatic.fr»
}
]

Pour recevoir par mail nos différentes Doc API merci de remplir le formulaire ci-dessous

Le Blog de la data quality

Contact

+33 (0)1 47 72 79 61

Je prends Rendez-vous
Newsletters
Veuillez activer JavaScript dans votre navigateur pour remplir ce formulaire.