Compartilhar via


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
Email 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