HitHorizons
HitHorizons vous permet d’utiliser des données de 75 M+ entreprises européennes provenant de 60 pays directement dans vos produits Microsoft. Enrichissez vos logiciels avec des données d’entreprise provenant de différentes sources pour vous fournir une image plus complète et complexe du marché, des entreprises individuelles et de leur évolution au fil du temps.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge de HitHorizons |
| URL | https://www.hithorizons.com/services/api |
| Messagerie électronique | support@hithorizons.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | FinStat, s. r. o. |
| Site internet | https://www.hithorizons.com/ |
| Politique de confidentialité | https://www.hithorizons.com/legal/privacy-policy |
| Catégories | Informatique décisionnelle; Ventes et CRM |
Le connecteur HitHorizons vous permet d’intégrer la base de données HitHorizons d’entreprises européennes dans vos produits Microsoft. Il vous permet de rechercher dans une base de données de plus de 75 millions d’entreprises dans 60 pays et d’utiliser les données de l’entreprise dans votre solution.
Prerequisites
Vous devez procéder comme suit :
- Abonnement HitHorizons.
- Clé API HitHorizons.
Comment obtenir des informations d’identification
Veuillez consulter https://www.hithorizons.com/services la gamme de services fournis par HitHorizons et acheter l’abonnement HitHorizons.
Prise en main de votre connecteur
- Utilisez l’action Company-Search pour rechercher une société par nom et par emplacement.
- Utilisez l’action Company-Get pour récupérer les informations de l’entreprise, notamment les données d’inscription de base, les informations de vente avec l’analytique et les informations de numéro d’employé avec l’analytique.
Problèmes connus et limitations
Il existe une limite de débit pour les requêtes d’API en place. Le taux maximal de 30 requêtes par minute est autorisé. Après avoir dépassé cette limite, une réponse 429 Trop de requêtes est retournée.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé d’API | securestring | Clé API pour cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Rechercher des entreprises à l’aide d’une requête non structurée |
Recherchez des entreprises à l’aide d’une requête non structurée. |
| Rechercher des entreprises à l’aide d’une requête structurée |
Recherchez des entreprises à l’aide d’une requête structurée. |
| Récupérer les données détaillées de l’entreprise par ID |
Récupérer les données de l’entreprise spécifiées par HitHorizonsId. |
Rechercher des entreprises à l’aide d’une requête non structurée
Recherchez des entreprises à l’aide d’une requête non structurée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Valeur à rechercher dans les ID d’entreprise : HitHorizonsId, DUNSNumber et NationalId
|
Ids | string |
Tous les ID disponibles seront recherchés pour les valeurs de ce champ : ID HitHorizons, DUNS Number et NATIONAL ID. Plusieurs valeurs peuvent être fournies, séparées par espace. |
|
|
Valeur à rechercher dans les noms d’entreprise et les ID d’entreprise
|
Name | string |
Le nom de la société et le nom secondaire sont recherchés pour cette valeur. De plus, NationalId sera recherché. Si le format correspond au HitHorizonsId (commence par H-), HitHorizonsId est recherché. Ce champ peut être utilisé pour une recherche étendue à l’aide de noms et d’ID pour des raisons pratiques pour l’utilisateur. |
|
|
Valeur à rechercher dans l’adresse de l’entreprise
|
Address | string |
L’adresse de l’entreprise sera recherchée pour cette valeur. Tous les champs d’adresse seront recherchés (adresse postale, code postal, ville, état/province). Lorsque le nom du pays est présent dans ce champ, les résultats sont limités uniquement au pays donné. |
|
|
Indique s’il faut inclure des enregistrements de branche dans les résultats
|
ShowBranches | boolean |
Lorsque la valeur est false (valeur par défaut), seuls les bureaux principaux et les entreprises à emplacement unique sont récupérés. Lorsque la valeur est true, les enregistrements marqués comme succursales sont également inclus dans les résultats. |
|
|
Types d’entreprise à inclure dans les résultats
|
CompanyTypes | string |
Tableau de types d’entreprise à rechercher. Cette valeur peut être fournie sous la forme d’une liste séparée par des virgules de valeurs, au lieu d’un tableau de valeurs (par exemple, CompanyTypes=3,13 , au lieu de CompanyTypes=3&CompanyTypes=13) Reportez-vous à la liste de codes suivante pour les valeurs disponibles : https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType Lorsqu’elles ne sont pas fournies, les valeurs suivantes sont utilisées par défaut : 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Nombre maximal de résultats à retourner
|
MaxResults | integer |
Nombre maximal de résultats à retourner. La valeur par défaut est 20. La valeur maximale possible est 100. |
Retours
Rechercher des entreprises à l’aide d’une requête structurée
Recherchez des entreprises à l’aide d’une requête structurée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Numéro DUNS à rechercher
|
DUNSNumber | string |
L’entreprise avec le numéro DUNS fourni est retournée. |
|
|
Valeur à rechercher dans les noms d’entreprise
|
CompanyName | string |
Le nom de la société et le nom secondaire sont recherchés pour cette valeur. |
|
|
Valeur à rechercher dans l’ID national de l’entreprise
|
NationalId | string |
L’ID national sera recherché pour cette valeur. |
|
|
Valeur à rechercher dans l’adresse de l’entreprise
|
AddressUnstructured | string |
L’adresse de l’entreprise sera recherchée pour cette valeur. Tous les champs d’adresse seront recherchés (adresse postale, code postal, ville, état/province). Lorsque le nom du pays est présent dans ce champ, les résultats sont limités uniquement au pays donné. Tous les termes peuvent être présents dans l’un des champs d’adresse. |
|
|
Valeur à rechercher dans l’adresse postale de l’entreprise
|
AddressStreet | string |
L’adresse postale de l’entreprise sera recherchée pour cette valeur. Tous les termes doivent être présents dans l’une des lignes d’adresse postale. |
|
|
Valeur à rechercher dans la ville de l’entreprise
|
City | string |
La ville de l’entreprise sera recherchée pour cette valeur. Tous les termes doivent être présents dans le nom de la ville. |
|
|
Valeur à rechercher dans l’état/la province de l’entreprise
|
StateProvince | string |
L’état/la province de l’entreprise sera recherché pour cette valeur. Tous les termes doivent être présents dans le nom de l’état/de la province. |
|
|
Pays pour limiter la recherche dans
|
Country | string |
Seules les entreprises du pays donné seront recherchées. |
|
|
Indique s’il faut inclure des enregistrements de branche dans les résultats
|
ShowBranches | boolean |
Lorsque la valeur est false (valeur par défaut), seuls les bureaux principaux et les entreprises à emplacement unique sont récupérés. Lorsque la valeur est true, les enregistrements marqués comme succursales sont également inclus dans les résultats. |
|
|
Types d’entreprise à inclure dans les résultats
|
CompanyTypes | string |
Tableau de types d’entreprise à rechercher. Cette valeur peut être fournie sous la forme d’une liste séparée par des virgules de valeurs, au lieu d’un tableau de valeurs (par exemple, CompanyTypes=3,13 , au lieu de CompanyTypes=3&CompanyTypes=13) Reportez-vous à la liste de codes suivante pour les valeurs disponibles : https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType Lorsqu’elles ne sont pas fournies, les valeurs suivantes sont utilisées par défaut : 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Nombre maximal de résultats à retourner
|
MaxResults | integer |
Nombre maximal de résultats à retourner. La valeur par défaut est 20. La valeur maximale possible est 100. |
Retours
Récupérer les données détaillées de l’entreprise par ID
Récupérer les données de l’entreprise spécifiées par HitHorizonsId.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’entreprise à récupérer
|
HitHorizonsId | True | string |
ID HitHorizons de l’entreprise à récupérer. HitHorizonsId peut être récupéré en recherchant l’entreprise à l’aide de Company-Search ou d’opérations de Company-SearchUnstructured. |
Retours
Définitions
CompanyDetailResult
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
CompanyName
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Code postal
|
PostalCode | string | |
|
Ville
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Pays
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
NationalIdType
|
NationalIdType | string | |
|
SICText
|
SICText | string | |
|
SICCode
|
SICCode | string | |
|
Secteur d’activité
|
Industry | string | |
|
LocalActivityCode
|
LocalActivityCode | string | |
|
LocalActivityCodeType
|
LocalActivityCodeType | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesLocal
|
SalesLocal | double | |
|
LocalCurrency
|
LocalCurrency | string | |
|
SalesAccuracyIndicator
|
SalesAccuracyIndicator | string | |
|
SalesUSD
|
SalesUSD | double | |
|
SalesEUR
|
SalesEUR | double | |
|
HitHorizonsSalesAnalysis
|
HitHorizonsSalesAnalysis | object | |
|
EmployeesNumber
|
EmployeesNumber | integer | |
|
EmployeesNumberAccuracyIndicator
|
EmployeesNumberAccuracyIndicator | string | |
|
EmployeesNumberTotal
|
EmployeesNumberTotal | integer | |
|
EmployeesNumberTotalAccuracyIndicator
|
EmployeesNumberTotalAccuracyIndicator | string | |
|
HitHorizonsEmployeesAnalysis
|
HitHorizonsEmployeesAnalysis | object | |
|
CompanyType
|
CompanyType | integer | |
|
LocationType
|
LocationType | integer | |
|
HitHorizonsCompanyProfileURL
|
HitHorizonsCompanyProfileURL | string |
CompanyDetailResultApiResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Erreur
|
Error | string | |
|
Résultat
|
Result | CompanyDetailResult |
CompanySearchResult
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
CompanyName
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Code postal
|
PostalCode | string | |
|
Ville
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Pays
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
Secteur d’activité
|
Industry | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesEUR
|
SalesEUR | double | |
|
EmployeesNumber
|
EmployeesNumber | integer | |
|
CompanyProfileURL
|
CompanyProfileURL | string |
CompanySearchResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Results
|
Results | array of CompanySearchResult | |
|
ResultsCount
|
ResultsCount | integer | |
|
TotalCount
|
TotalCount | integer |
CompanySearchResponseApiResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Erreur
|
Error | string | |
|
Résultat
|
Result | CompanySearchResponse |