HitHorizons
O HitHorizons permite que você trabalhe com dados de mais de 75 milhões de empresas europeias de 60 países diretamente em seus produtos da Microsoft. Enriqueça o software com dados da empresa de várias fontes para fornecer uma imagem mais completa e complexa do mercado, das empresas individuais e de sua evolução ao longo do tempo.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao HitHorizons |
| URL | https://www.hithorizons.com/services/api |
| support@hithorizons.com |
| Metadados do conector | |
|---|---|
| Publicador | FinStat, s. r. o. |
| Site | https://www.hithorizons.com/ |
| Política de privacidade | https://www.hithorizons.com/legal/privacy-policy |
| Categorias | Business Intelligence; Vendas e CRM |
O conector HitHorizons permite que você integre o banco de dados HitHorizons de empresas europeias em seus produtos da Microsoft. Ele permite que você pesquise em um banco de dados de mais de 75 milhões de empresas em 60 países e use os dados da empresa em sua solução.
Pré-requisitos
Você precisará do seguinte para continuar:
- Assinatura do HitHorizons.
- Tecla de API HitHorizons.
Como obter credenciais
https://www.hithorizons.com/services Visite para exibir o intervalo de serviços fornecidos pelo HitHorizons e comprar a assinatura do HitHorizons.
Introdução ao conector
- Use o Company-Search de ação para procurar uma empresa por nome e localização.
- Use Company-Get de ação para recuperar informações da empresa, incluindo dados básicos de registro, informações de vendas com análise e informações de número de funcionários com análise.
Problemas e limitações conhecidos
Há um limite de taxa para solicitações de API em vigor. A taxa máxima de 30 solicitações por minuto é permitida. Depois de exceder esse limite, uma resposta de 429 Solicitações Demais é retornada.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | A chave de API para esta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Pesquisar empresas usando a consulta estruturada |
Pesquise empresas usando a consulta estruturada. |
| Pesquisar empresas usando uma consulta não estruturada |
Pesquise empresas usando uma consulta não estruturada. |
| Recuperar dados de detalhes da empresa por ID |
Recuperar dados da empresa especificados por HitHorizonsId. |
Pesquisar empresas usando a consulta estruturada
Pesquise empresas usando a consulta estruturada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número duns para localizar
|
DUNSNumber | string |
A empresa com o número duns fornecido será retornada. |
|
|
Valor a ser pesquisado em nomes de empresa
|
CompanyName | string |
O nome da empresa e o nome secundário serão pesquisados para esse valor. |
|
|
Valor a ser pesquisado na ID Nacional da empresa
|
NationalId | string |
A ID nacional será pesquisada para esse valor. |
|
|
Valor a ser pesquisado no endereço da empresa
|
AddressUnstructured | string |
O endereço da empresa será pesquisado quanto a esse valor. Todos os campos de endereço serão pesquisados (endereço de rua, cep, cidade, estado/província). Quando o nome do país está presente neste campo, os resultados são limitados apenas ao país determinado. Qualquer um dos termos pode estar presente em qualquer um dos campos de endereço. |
|
|
Valor a ser pesquisado no endereço de rua da empresa
|
AddressStreet | string |
O endereço de rua da empresa será pesquisado quanto a esse valor. Todos os termos devem estar presentes em qualquer uma das linhas de endereço de rua. |
|
|
Valor a ser pesquisado na cidade da empresa
|
City | string |
A cidade da empresa será pesquisada quanto a esse valor. Todos os termos devem estar presentes no nome da cidade. |
|
|
Valor a ser pesquisado no estado/província da empresa
|
StateProvince | string |
O estado/província da empresa será pesquisado quanto a esse valor. Todos os termos devem estar presentes no nome do estado/província. |
|
|
País para limitar a pesquisa em
|
Country | string |
Somente as empresas no determinado país serão pesquisadas. |
|
|
Se deve incluir registros de ramificação nos resultados
|
ShowBranches | boolean |
Quando falso (padrão), somente escritórios principais e empresas de localização única são recuperados. Quando verdadeiro, também os registros marcados como filiais são incluídos nos resultados. |
|
|
Tipos de empresa a serem incluídos nos resultados
|
CompanyTypes | string |
Matriz de tipos de empresa a serem pesquisados. Esse valor pode ser fornecido como uma lista separada por vírgulas de valores, em vez de uma matriz de valores (ou seja, CompanyTypes=3,13 , em vez de CompanyTypes=3&CompanyTypes=13) Consulte a seguinte lista de códigos para obter valores disponíveis: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType . Quando não fornecidos, os seguintes valores são usados por padrão: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Número máximo de resultados a serem retornados
|
MaxResults | integer |
Número máximo de resultados a serem retornados. O valor padrão é 20. O valor máximo possível é 100. |
Retornos
Pesquisar empresas usando uma consulta não estruturada
Pesquise empresas usando uma consulta não estruturada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Valor a ser pesquisado em IDs da empresa: HitHorizonsId, DUNSNumber e NationalId
|
Ids | string |
Todas as IDs disponíveis serão pesquisadas para os valores neste campo: ID do HitHorizons, Número duns e ID nacional. Vários valores podem ser fornecidos, separados por espaço. |
|
|
Valor a ser pesquisado em nomes da empresa e IDs da empresa
|
Name | string |
O nome da empresa e o nome secundário serão pesquisados para esse valor. Além disso, a NationalId será pesquisada. Se o formato corresponder à HitHorizonsId (começa com H-), HitHorizonsId será pesquisado. Esse campo pode ser usado para pesquisa ampla usando nomes e IDs para conveniência do usuário. |
|
|
Valor a ser pesquisado no endereço da empresa
|
Address | string |
O endereço da empresa será pesquisado quanto a esse valor. Todos os campos de endereço serão pesquisados (endereço de rua, cep, cidade, estado/província). Quando o nome do país está presente neste campo, os resultados são limitados apenas ao país determinado. |
|
|
Se deve incluir registros de ramificação nos resultados
|
ShowBranches | boolean |
Quando falso (padrão), somente escritórios principais e empresas de localização única são recuperados. Quando verdadeiro, também os registros marcados como filiais são incluídos nos resultados. |
|
|
Tipos de empresa a serem incluídos nos resultados
|
CompanyTypes | string |
Matriz de tipos de empresa a serem pesquisados. Esse valor pode ser fornecido como uma lista separada por vírgulas de valores, em vez de uma matriz de valores (ou seja, CompanyTypes=3,13 , em vez de CompanyTypes=3&CompanyTypes=13) Consulte a seguinte lista de códigos para obter valores disponíveis: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType . Quando não fornecidos, os seguintes valores são usados por padrão: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Número máximo de resultados a serem retornados
|
MaxResults | integer |
Número máximo de resultados a serem retornados. O valor padrão é 20. O valor máximo possível é 100. |
Retornos
Recuperar dados de detalhes da empresa por ID
Recuperar dados da empresa especificados por HitHorizonsId.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da empresa a ser recuperada
|
HitHorizonsId | True | string |
ID do HitHorizons da empresa a ser recuperada. HitHorizonsId pode ser recuperado pesquisando a empresa usando operações de Company-Search ou Company-SearchUnstructured. |
Retornos
Definições
CompanyDetailResult
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Nome da Empresa
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Código Postal
|
PostalCode | string | |
|
City
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
País
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
NationalIdType
|
NationalIdType | string | |
|
SICText
|
SICText | string | |
|
SICCode
|
SICCode | string | |
|
Setor
|
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
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
Success | boolean | |
|
Erro
|
Error | string | |
|
Resultado
|
Result | CompanyDetailResult |
CompanySearchResult
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Nome da Empresa
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Código Postal
|
PostalCode | string | |
|
City
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
País
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
Setor
|
Industry | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesEUR
|
SalesEUR | double | |
|
EmployeesNumber
|
EmployeesNumber | integer | |
|
CompanyProfileURL
|
CompanyProfileURL | string |
CompanySearchResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Results
|
Results | array of CompanySearchResult | |
|
ResultsCount
|
ResultsCount | integer | |
|
TotalCount
|
TotalCount | integer |
CompanySearchResponseApiResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
Success | boolean | |
|
Erro
|
Error | string | |
|
Resultado
|
Result | CompanySearchResponse |