Otimizador D&B [PRETERIDO]
O Otimizador D&B é um serviço de dados básico da Dun &Bradstreet que melhora a qualidade dos dados de negócios identificando, limpando e inserindo inteligência firmográfica corretamente em registros em seu ambiente de aplicativo da Microsoft.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | 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 | Standard | 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 | Standard | 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) |
| Metadados do conector | |
|---|---|
| Publicador | Dun &Bradstreet |
O Otimizador D&B exige que os usuários tenham acesso a um ambiente do Common Data Service e a uma assinatura ativa para os serviços Dun &Bradstreet.
Encontre mais informações aqui e como começar aqui.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Limpar correspondência e acrescentar [PRETERIDO] |
A Resolução de Identidade D&B usa critérios de entrada para encontrar os melhores candidatos em seu amplo banco de dados de entidades. Ele usa algoritmos proprietários para identificar as melhores correspondências e retorna essas correspondências com informações detalhadas sobre quais critérios foram usados para localizar a correspondência. |
| Recuperar dados em uma entidade específica [PRETERIDO] |
A API de Produtos de Dados retorna dados sobre um DUNS solicitado. Os dados retornados são específicos para o produto solicitado. |
Limpar correspondência e acrescentar [PRETERIDO]
A Resolução de Identidade D&B usa critérios de entrada para encontrar os melhores candidatos em seu amplo banco de dados de entidades. Ele usa algoritmos proprietários para identificar as melhores correspondências e retorna essas correspondências com informações detalhadas sobre quais critérios foram usados para localizar a correspondência.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do produto
|
productId | True | string |
A ID do produto fornecida pela D&B que identifica o produto a ser retornado. |
|
ID da versão
|
versionId | True | string |
A ID da versão (por exemplo, v1) que identifica a versão do produto a ser retornada. |
|
Nome
|
name | string |
Até 240 caracteres usados para localizar a entidade por seu nome principal, nomes de estilo comercial ou nomes antigos. |
|
|
Linha de Endereço de Rua 1
|
streetAddressLine1 | string |
Até 70 caracteres da primeira linha do endereço de rua da entidade. |
|
|
Linha de Endereço de Rua 2
|
streetAddressLine2 | string |
Até 70 caracteres da segunda linha do endereço de rua da entidade |
|
|
Código alfa ISO do país
|
countryISOAlpha2Code | True | string |
O código de país de duas letras, definido pelo esquema ISO (Organização Internacional para Padronização) ISO 3166-1 que identifica o país da entidade. |
|
Código postal
|
postalCode | string |
Até 10 caracteres do identificador usado pela autoridade postal do país local para identificar onde o endereço está localizado. |
|
|
Localidade do Endereço
|
addressLocality | string |
1 a 50 caracteres que identificam a cidade, a cidade, o município, a vila, o bairro etc. onde a entidade está localizada. |
|
|
Região do Endereço
|
addressRegion | string |
O nome da área governada localmente que faz parte de uma nação governada centralmente para identificar onde o endereço está localizado. |
|
|
Número telefônico
|
telephoneNumber | string |
Até 32 caracteres do número de telefone– a sequência de dígitos usada para comunicação de voz com a entidade. Essa sequência de dígitos inclui o código da área ou o código da cidade e o código de discagem doméstico. |
|
|
URL
|
url | string |
Uma URL usada para identificar uma entidade por seu domínio de email. |
|
|
Email
|
string |
Um endereço de email usado para identificar uma entidade por seu domínio de email. |
||
|
Número de Registro
|
registrationNumber | string |
O número atribuído por um corpo externo ou por D&B que identifica exclusivamente ou ajuda a identificar uma organização. |
|
|
Tipo de número de registro
|
registrationNumberType | string |
Um código exclusivo atribuído por D&B para identificar o tipo de número de registro. |
|
|
Nível inferior de confiança
|
confidenceLowerLevelThresholdValue | string |
O nível de confiança mais baixo para entidades retornadas na resposta. Os valores válidos são de 1 a 10, se não especificado, o padrão de 4 é usado. |
|
|
Critérios de exclusão
|
exclusionCriteria | string |
Fornece a capacidade de excluir entidades com base em várias propriedades. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Número duns
|
duns | string |
O número D-U-N-S é um número de identificação atribuído por D&B que identifica exclusivamente a entidade de acordo com o D-U-N-S (Sistema de Numeração Universal de Dados). |
|
Nome do negócio primário
|
primary_name | string |
O nome único pelo qual a entidade é conhecida ou identificada principalmente. |
|
Nome do estilo comercial
|
trade_style | string |
O nome em que a entidade negocia para fins comerciais, embora seu nome legal registrado usado para contratos e outras situações formais possa ser outro nome. |
|
Endereço
|
address.streetline1 | string |
A primeira linha do endereço em que a entidade está localizada. |
|
Endereço de rua (2)
|
address.streetline2 | string |
A segunda linha do endereço em que a entidade está localizada. |
|
Cidade do Endereço
|
address.city | string |
O nome da cidade, cidade, município, vila, bairro, etc. em que este endereço está localizado. |
|
Código de território
|
address.territory_code | string |
O código padrão da área governada localmente que faz parte de uma nação governada centralmente para identificar onde esse endereço está localizado. |
|
Nome do território
|
address.territory_name | string |
O nome da área governada localmente que faz parte de uma nação governada centralmente para identificar onde esse endereço está localizado. |
|
Código postal
|
address.postal_code | string |
Um identificador usado pela Autoridade Postal do país local para identificar onde a empresa está localizada. |
|
Código do país ISO
|
address.isoalpha2code | string |
O código de país de duas letras, definido pelo esquema ISO (Organização Internacional para Padronização) ISO 3166-1 que identifica o país da entidade empresarial. |
|
Nome do país ISO
|
address.country_name | string |
O código do país, definido pelo esquema ISO (Organização Internacional para Padronização) ISO 3166-1 que identifica o país da entidade empresarial. |
|
Código ISD de telefone
|
phone.international_code | string |
Essa sequência de dígitos contém o código ISD (Discagem de Assinante Internacional). |
|
Número telefônico
|
phone.number | string |
Uma sequência de dígitos usados para comunicação de voz com a entidade. Essa sequência de dígitos inclui o código da área ou o código da cidade e o código de discagem doméstico. |
|
Código do setor
|
primary_sic | string |
O código que identifica a atividade de negócios na qual a entidade está envolvida. |
|
Descrição do código do setor
|
industrycode.description | string |
A descrição do código do setor correspondente. |
|
Detalhes da quantidade de funcionários (local)
|
employees.local | integer |
O número total de pessoas envolvidas pela entidade para executar suas operações. O escopo dessa figura de funcionário é identificado em informationScopeDescription. |
|
Detalhes da quantidade de funcionários (total)
|
employees.global | integer |
O número total de pessoas envolvidas pela entidade para executar suas operações. O escopo dessa figura de funcionário é identificado em informationScopeDescription. |
|
Demonstração financeira até a data
|
financials.todate | date-time |
A data em que o período contábil terminou. Se o Código de Confiabilidade indicar que os números são projetados (futuro), essa será a data em que o período contábil terminará. |
|
Valor da receita de vendas em USD
|
financials_global.value | integer |
O valor monetário da renda recebida dos clientes da venda de bens e/ou serviços da entidade em USD. Esta é a venda bruta menos quaisquer retornos, descontos/descontos, subsídios por danos ou escassez, despesas de envio repassadas ao cliente. |
|
Valor da Receita de Vendas na moeda local
|
financials_local.value | integer |
O valor monetário da renda recebida dos clientes da venda de bens e/ou serviços da entidade em moeda local. Esta é a venda bruta menos quaisquer retornos, descontos/descontos, subsídios por danos ou escassez, despesas de envio repassadas ao cliente. |
|
Código de moeda local
|
financials_local.currency | string |
O código de moeda local dessa entidade. |
|
Tipos de localização
|
location_types | string |
Uma lista delimitada por ponto e vírgula de Tipos de Localização para essa entidade. |
|
Indicador de Localização Única
|
is_single_location | boolean |
Indica se a entidade é um único local ou não. |
|
Número de D-U-N-S pai
|
parent.duns | string |
O número D-U-N-S da entidade pai. Um pai é uma empresa que possui mais de 50% de capital de outra empresa; essas empresas de propriedade são subsidiárias da entidade pai. |
|
Nome comercial pai
|
parent.name | string |
O nome comercial da entidade pai. Um pai é uma empresa que possui mais de 50% de capital de outra corporação. |
|
Número de D-U-N-S final doméstico
|
domestic_ultimate.duns | string |
O número D-U-N-S do pai de nível mais alto dentro de uma árvore familiar corporativa que é domiciliada no mesmo país que a entidade solicitada. Um pai é uma empresa que possui mais de 50% de capital de outra corporação. Um assunto pode ser seu próprio final doméstico. |
|
Nome final doméstico
|
domestic_ultimate.name | string |
O nome do negócio mais alto da árvore genealógica que está no mesmo país que o assunto. |
|
Número global de D-U-N-S
|
global_ultimate.duns | string |
O número D-U-N-S do pai de nível mais alto dentro de uma árvore genealógica corporativa. Um pai é uma empresa que possui mais de 50% de capital de outra corporação. Um assunto pode ser seu próprio final global. |
|
Nome final global
|
global_ultimate.name | string |
O nome principal do negócio final global. |
|
Estrutura jurídica de negócios
|
entity_type | integer |
O código D&B para a estrutura jurídica comercial correspondente |
|
Descrição da estrutura jurídica empresarial
|
entity_type.description | string |
O nome da forma legal ou estrutura da entidade conforme registrado com autoridades governamentais (por exemplo, parceria, corporação, empresa privada limitada, departamento governamental, propriedade). Um código exclusivo atribuído por D&B para identificar o formulário legal ou a estrutura da entidade conforme registrado com autoridades governamentais |
|
Corresponder confiança
|
match.confidence | integer |
Os códigos de confiança são baseados nas cadeias de caracteres matchgrade detalhadas™; mais de 4 milhões de combinações de cadeia de caracteres são mapeadas para 10 Códigos de Confiança, permitindo uma categorização ampla de registros correspondentes. Quanto maior o número, maior a confiança de que ele é uma correspondência precisa. |
|
Perfil de correspondência
|
match.profile | string |
Códigos de MDP (Perfil de Dados de Correspondência) indicam se e como cada tipo de componente foi correspondido no candidato retornado. |
|
Grau de Correspondência
|
match.grade | string |
As cadeias de caracteres MatchGrade fornecem avaliações qualitativas entre componentes de consulta e referência. R - Considerado o mesmo, B - Alguma similiaridade, F - Considerado diferente, Z - Informações ausentes, não podem concluir. |
|
Indicador deslistado
|
is_delisted | boolean |
Indicador sobre se a entidade solicitou ou não que seus dados não sejam incluídos no arquivo de marketing do D&B para prospecção. |
|
Status operacional
|
operating_status | integer |
O código D&B para o status operacional correspondente |
|
Descrição do status de operação
|
operating_status.description | string |
O estado funcional da entidade ou o status de negociação (por exemplo, ativo, fora do negócio). Um código exclusivo atribuído por D&B para identificar o estado funcional ou o status de negociação da entidade. |
|
Grau de Correspondência – Nome da Organização
|
match_grade.name | string |
Grau de Correspondência – Nome da Organização |
|
Grau de Correspondência – Número da Rua
|
match_grade.street_number | string |
Grau de Correspondência – Número da Rua |
|
Grau de Correspondência – Nome da Rua
|
match_grade.street_name | string |
Grau de Correspondência – Nome da Rua |
|
Grau de Correspondência - Cidade/Cidade
|
match_grade.city | string |
Grau de Correspondência - Cidade/Cidade |
|
Grau de Correspondência – Estado/Região
|
match_grade.state | string |
Grau de Correspondência – Estado/Região |
|
Grau de Correspondência – Caixa de Po
|
match_grade.po_box | string |
Grau de Correspondência – Caixa de Po |
|
Nota de Correspondência – Número de Telefone
|
match_grade.phone | string |
Nota de Correspondência – Número de Telefone |
|
Grau de Correspondência – Cep
|
match_grade.postal_code | string |
Grau de Correspondência – Cep |
|
Grau de Correspondência – Densidade
|
match_grade.density | string |
Grau de Correspondência – Densidade |
|
Grau de Correspondência – Exclusividade
|
match_grade.uniqueness | string |
Grau de Correspondência – Exclusividade |
|
Grau de Correspondência – Código SIC
|
match_grade.industry | string |
Grau de Correspondência – Código SIC |
Recuperar dados em uma entidade específica [PRETERIDO]
A API de Produtos de Dados retorna dados sobre um DUNS solicitado. Os dados retornados são específicos para o produto solicitado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número D-U-N-S
|
duns | True | string |
O número D-U-N-S é um número de identificação atribuído por D&B que identifica exclusivamente a entidade de acordo com o D-U-N-S (Sistema de Numeração Universal de Dados). |
|
ID do produto
|
productId | True | string |
A ID do produto fornecida pela D&B que identifica o produto a ser retornado. |
|
ID da versão
|
versionId | True | string |
A ID da versão (por exemplo, v1) que identifica a versão do produto a ser retornada. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Número duns
|
duns | string |
O número D-U-N-S é um número de identificação atribuído por D&B que identifica exclusivamente a entidade de acordo com o D-U-N-S (Sistema de Numeração Universal de Dados). |
|
Nome do negócio primário
|
primary_name | string |
O nome único pelo qual a entidade é conhecida ou identificada principalmente. |
|
Nome do estilo comercial
|
trade_style | string |
O nome em que a entidade negocia para fins comerciais, embora seu nome legal registrado usado para contratos e outras situações formais possa ser outro nome. |
|
Endereço
|
address.streetline1 | string |
A primeira linha do endereço em que a entidade está localizada. |
|
Endereço de rua (2)
|
address.streetline2 | string |
A segunda linha do endereço em que a entidade está localizada. |
|
Cidade do Endereço
|
address.city | string |
O nome da cidade, cidade, município, vila, bairro, etc. em que este endereço está localizado. |
|
Código de território
|
address.territory_code | string |
O código padrão da área governada localmente que faz parte de uma nação governada centralmente para identificar onde esse endereço está localizado. |
|
Nome do território
|
address.territory_name | string |
O nome da área governada localmente que faz parte de uma nação governada centralmente para identificar onde esse endereço está localizado. |
|
Código postal
|
address.postal_code | string |
Um identificador usado pela Autoridade Postal do país local para identificar onde a empresa está localizada. |
|
Código do país ISO
|
address.isoalpha2code | string |
O código de país de duas letras, definido pelo esquema ISO (Organização Internacional para Padronização) ISO 3166-1 que identifica o país da entidade empresarial. |
|
Nome do país ISO
|
address.country_name | string |
O código do país, definido pelo esquema ISO (Organização Internacional para Padronização) ISO 3166-1 que identifica o país da entidade empresarial. |
|
Código ISD de telefone
|
phone.international_code | string |
Essa sequência de dígitos contém o código ISD (Discagem de Assinante Internacional). |
|
Número telefônico
|
phone.number | string |
Uma sequência de dígitos usados para comunicação de voz com a entidade. Essa sequência de dígitos inclui o código da área ou o código da cidade e o código de discagem doméstico. |
|
Código do setor
|
primary_sic | string |
O código que identifica a atividade de negócios na qual a entidade está envolvida. |
|
Descrição do código do setor
|
industrycode.description | string |
A descrição do código do setor correspondente. |
|
Detalhes da quantidade de funcionários (local)
|
employees.local | integer |
O número total de pessoas envolvidas pela entidade para executar suas operações. O escopo dessa figura de funcionário é identificado em informationScopeDescription. |
|
Detalhes da quantidade de funcionários (total)
|
employees.global | integer |
O número total de pessoas envolvidas pela entidade para executar suas operações. O escopo dessa figura de funcionário é identificado em informationScopeDescription. |
|
Demonstração financeira até a data
|
financials.todate | date-time |
A data em que o período contábil terminou. Se o Código de Confiabilidade indicar que os números são projetados (futuro), essa será a data em que o período contábil terminará. |
|
Valor da receita de vendas em USD
|
financials_global.value | integer |
O valor monetário da renda recebida dos clientes da venda de bens e/ou serviços da entidade em USD. Esta é a venda bruta menos quaisquer retornos, descontos/descontos, subsídios por danos ou escassez, despesas de envio repassadas ao cliente. |
|
Valor da Receita de Vendas na moeda local
|
financials_local.value | integer |
O valor monetário da renda recebida dos clientes da venda de bens e/ou serviços da entidade em moeda local. Esta é a venda bruta menos quaisquer retornos, descontos/descontos, subsídios por danos ou escassez, despesas de envio repassadas ao cliente. |
|
Código de moeda local
|
financials_local.currency | string |
O código de moeda local dessa entidade. |
|
Tipos de localização
|
location_types | string |
Uma lista delimitada por ponto e vírgula de Tipos de Localização para essa entidade. |
|
Indicador de Localização Única
|
is_single_location | boolean |
Indica se a entidade é um único local ou não. |
|
Número de D-U-N-S pai
|
parent.duns | string |
O número D-U-N-S da entidade pai. Um pai é uma empresa que possui mais de 50% de capital de outra empresa; essas empresas de propriedade são subsidiárias da entidade pai. |
|
Nome comercial pai
|
parent.name | string |
O nome comercial da entidade pai. Um pai é uma empresa que possui mais de 50% de capital de outra corporação. |
|
Número de D-U-N-S final doméstico
|
domestic_ultimate.duns | string |
O número D-U-N-S do pai de nível mais alto dentro de uma árvore familiar corporativa que é domiciliada no mesmo país que a entidade solicitada. Um pai é uma empresa que possui mais de 50% de capital de outra corporação. Um assunto pode ser seu próprio final doméstico. |
|
Nome final doméstico
|
domestic_ultimate.name | string |
O nome do negócio mais alto da árvore genealógica que está no mesmo país que o assunto. |
|
Número global de D-U-N-S
|
global_ultimate.duns | string |
O número D-U-N-S do pai de nível mais alto dentro de uma árvore genealógica corporativa. Um pai é uma empresa que possui mais de 50% de capital de outra corporação. Um assunto pode ser seu próprio final global. |
|
Nome final global
|
global_ultimate.name | string |
O nome principal do negócio final global. |
|
Estrutura jurídica de negócios
|
entity_type | integer |
O código D&B para a estrutura jurídica comercial correspondente |
|
Descrição da estrutura jurídica empresarial
|
entity_type.description | string |
O nome da forma legal ou estrutura da entidade conforme registrado com autoridades governamentais (por exemplo, parceria, corporação, empresa privada limitada, departamento governamental, propriedade). Um código exclusivo atribuído por D&B para identificar o formulário legal ou a estrutura da entidade conforme registrado com autoridades governamentais |
|
Indicador deslistado
|
is_delisted | boolean |
Indicador sobre se a entidade solicitou ou não que seus dados não sejam incluídos no arquivo de marketing do D&B para prospecção. |
|
Status operacional
|
operating_status | integer |
O código D&B para o status operacional correspondente |
|
Descrição do status de operação
|
operating_status.description | string |
O estado funcional da entidade ou o status de negociação (por exemplo, ativo, fora do negócio). Um código exclusivo atribuído por D&B para identificar o estado funcional ou o status de negociação da entidade. |