Partilhar via


Otimizador D&B [DEPRECATED]

O D&B Optimizer é um serviço de dados fundamental da Dun & Bradstreet que melhora a qualidade dos dados da sua empresa, identificando, limpando e inserindo corretamente inteligência firmográfica em registros dentro do seu ambiente de aplicativos Microsoft.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Standard Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Metadados do conector
Editora Dun & Bradstreet

O D&B Optimizer exige que os usuários tenham acesso a um ambiente Common Data Service e uma assinatura ativa para os serviços Dun & Bradstreet.
Encontre mais informações aqui, e como começar aqui.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Limpar correspondência e acrescentar [DEPRECATED]

A D&B Identity Resolution usa critérios de entrada para encontrar os melhores candidatos em seu extenso 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 encontrar a correspondência.

Recuperar dados sobre uma entidade específica [DEPRECATED]

A API de Produtos de Dados retorna dados sobre um DUNS solicitado. Os dados devolvidos são específicos do produto solicitado.

Limpar correspondência e acrescentar [DEPRECATED]

A D&B Identity Resolution usa critérios de entrada para encontrar os melhores candidatos em seu extenso 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 encontrar a correspondência.

Parâmetros

Name Chave Necessário Tipo Description
ID do Produto
productId True string

O ID do produto fornecido pela D&B que identifica o produto a ser devolvido.

ID da versão
versionId True string

O 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 encontrar a entidade por seu nome principal, nomes de estilo comercial ou nomes antigos.

Endereço Linha 1
streetAddressLine1 string

Até 70 caracteres da primeira linha do endereço da entidade.

Endereço Linha 2
streetAddressLine2 string

Até 70 caracteres da segunda linha do endereço da entidade

Código alfa ISO do país
countryISOAlpha2Code True string

O código de país de 2 letras, definido pelo esquema ISO 3166-1 da Organização Internacional de Normalização (ISO) 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.

Endereço Localidade
addressLocality string

1 a 50 caracteres que identificam a cidade, vila, município, aldeia, bairro, etc. onde a entidade está localizada.

Região de 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 de telefone
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. Esta sequência de dígitos inclui o código de área ou código da cidade e o código de discagem nacional.

URL
url string

Um URL usado para identificar uma entidade por seu domínio de e-mail.

Email
email string

Um endereço de e-mail usado para identificar uma entidade pelo seu domínio de e-mail.

Número de registo
registrationNumber string

O número atribuído por um órgão externo ou por D&B que identifica exclusivamente ou ajuda a identificar uma organização.

Tipo de Número de Registo
registrationNumberType string

Um código único atribuído pela D&B para identificar o tipo de número de registo.

Nível de confiança mais baixo
confidenceLowerLevelThresholdValue string

O nível de confiança mais baixo para as entidades retornou 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.

Devoluções

Name Caminho Tipo Description
Número DUNS
duns string

O D-U-N-S Number é um número de identificação atribuído pela D&B que identifica exclusivamente a entidade de acordo com o Data Universal Numbering System (D-U-N-S).

Nome comercial principal
primary_name string

O nome único pelo qual a entidade é principalmente conhecida ou identificada.

Nome do estilo comercial
trade_style string

O nome sob o qual a entidade negocia para fins comerciais, embora o seu nome legal registado utilizado para contratos e outras situações formais possa ser outro nome.

Endereço
address.streetline1 string

A primeira linha do endereço onde a entidade está localizada.

Endereço (2)
address.streetline2 string

A segunda linha do endereço onde a entidade está localizada.

Endereço Cidade
address.city string

O nome da cidade, vila, município, aldeia, bairro, etc. em que este endereço está localizado.

Código do 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 ISO do país
address.isoalpha2code string

O código de país de duas letras, definido pelo esquema ISO 3166-1 da Organização Internacional de Normalização (ISO) 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 3166-1 da Organização Internacional de Normalização (ISO), que identifica o país da entidade empresarial.

Código ISD telefónico
phone.international_code string

Esta sequência de dígitos contém o código ISD (International Subscriber Dialling).

Número de telefone
phone.number string

Uma sequência de dígitos usada para comunicação de voz com a entidade. Esta sequência de dígitos inclui o código de área ou código da cidade e o código de discagem nacional.

Código da Indústria
primary_sic string

O código que identifica a atividade comercial na qual a entidade está envolvida.

Descrição do Código da Indústria
industrycode.description string

A descrição do Código da Indústria correspondente.

Detalhes da quantidade do funcionário (local)
employees.local integer

O número total de pessoas contratadas pela entidade para realizar as 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 contratadas pela entidade para realizar as suas operações. O escopo dessa figura de funcionário é identificado em informationScopeDescription.

Demonstrações financeiras até à data
financials.todate date-time

A data em que o período contabilístico terminou.  Se o Código de Fiabilidade indicar que os valores são projetados (futuros), então esta é a data em que o período contabilístico terminará.

Valor da receita de vendas em USD
financials_global.value integer

O valor monetário dos rendimentos recebidos dos clientes da venda dos bens e/ou serviços da entidade em USD.  Trata-se das vendas brutas menos quaisquer devoluções, abatimentos/descontos, subsídios por danos ou escassez, despesas de envio repercutidas no cliente.

Valor da receita de vendas na moeda local
financials_local.value integer

O valor monetário dos rendimentos recebidos dos clientes da venda dos bens e/ou serviços da entidade em moeda local.  Trata-se das vendas brutas menos quaisquer devoluções, abatimentos/descontos, subsídios por danos ou escassez, despesas de envio repercutidas no cliente.

Código da moeda local
financials_local.currency string

O código de moeda local para esta entidade.

Tipos de localização
location_types string

Uma lista delimitada por ponto-e-vírgula de Tipos de Localização para esta entidade.

Indicador de localização única
is_single_location boolean

Indica se a entidade é um único local ou não.

Número pai D-U-N-S
parent.duns string

O número D-U-N-S da entidade-mãe. Uma empresa-mãe é uma sociedade que possui mais de 50% do capital social de outra sociedade; Estas empresas detidas são subsidiárias da entidade-mãe. 

Nome da empresa-mãe
parent.name string

O nome comercial da entidade-mãe. Uma empresa-mãe é uma sociedade que possui mais de 50% do capital social de outra sociedade.

Número final doméstico D-U-N-S
domestic_ultimate.duns string

O Número D-U-N-S da empresa-mãe de nível mais alto dentro de uma árvore genealógica corporativa domiciliada no mesmo país que a entidade solicitada. Uma empresa-mãe é uma sociedade que possui mais de 50% do capital social de outra sociedade. Um sujeito pode ser o seu próprio final doméstico.

Nome final doméstico
domestic_ultimate.name string

O nome do negócio mais alto na árvore genealógica que está no mesmo país que o sujeito.

Número Global Ultimate D-U-N-S
global_ultimate.duns string

O número D-U-N-S da empresa-mãe de nível mais alto dentro de uma árvore genealógica corporativa. Uma empresa-mãe é uma sociedade que possui mais de 50% do capital social de outra sociedade. Um assunto pode ser o seu próprio final global. 

Nome Final Global
global_ultimate.name string

O principal nome do negócio final global.

Estrutura Jurídica Empresarial
entity_type integer

O Código D&B para a Estrutura Jurídica Empresarial correspondente

Descrição da Estrutura Jurídica do Negócio
entity_type.description string

O nome da forma jurídica ou estrutura da entidade tal como registada junto das autoridades governamentais (por exemplo, sociedade, sociedade, sociedade por quotas, departamento da administração pública, propriedade). Um código único atribuído pela D&B para identificar a forma jurídica ou a estrutura da entidade tal como registada junto das autoridades governamentais

Confiança no jogo
match.confidence integer

Os códigos de confiança são baseados nas Strings MatchGrade detalhadas™; mais de 4 milhões de combinações de cadeias de caracteres são mapeadas para 10 códigos de confiança, permitindo uma ampla categorização de registros correspondentes. Quanto maior o número, maior a confiança de que se trata de uma correspondência precisa.

Perfil da correspondência
match.profile string

Os códigos MDP (Match Data Profile) indicam se e como cada tipo de componente foi correspondido no candidato retornado.

Grau de correspondência
match.grade string

As Strings MatchGrade fornecem avaliações qualitativas entre os componentes de consulta e de referência. A - Considerado o mesmo, B - Alguma similiaridade, F - Considerado diferente, Z - Falta de informação, não se pode tirar conclusão.

Indicador retirado da lista
is_delisted boolean

Indicador sobre se a entidade solicitou ou não que seus dados não fossem incluídos no arquivo de marketing da D&B para prospeção.

Estado Operacional
operating_status integer

O código D&B para o status operacional correspondente

Descrição do estado de funcionamento
operating_status.description string

O estado funcional ou o status comercial da entidade (por exemplo, ativo, fora do negócio). Um código exclusivo atribuído pela D&B para identificar o estado funcional ou o status de negociação da entidade.

Match Grade - Nome da Organização
match_grade.name string

Match Grade - Nome da Organização

Match Grade - Número da Rua
match_grade.street_number string

Match Grade - Número da Rua

Match Grade - Nome da Rua
match_grade.street_name string

Match Grade - Nome da Rua

Match Grade - Cidade
match_grade.city string

Match Grade - Cidade

Match Grade - Estado/Região
match_grade.state string

Match Grade - Estado/Região

Grau de correspondência - Caixa Postal
match_grade.po_box string

Grau de correspondência - Caixa Postal

Match Grade - Número de Telefone
match_grade.phone string

Match Grade - Número de Telefone

Match Grade - Código Postal
match_grade.postal_code string

Match Grade - Código Postal

Match Grade - Densidade
match_grade.density string

Match Grade - Densidade

Match Grade - Exclusividade
match_grade.uniqueness string

Match Grade - Exclusividade

Match Grade - Código SIC
match_grade.industry string

Match Grade - Código SIC

Recuperar dados sobre uma entidade específica [DEPRECATED]

A API de Produtos de Dados retorna dados sobre um DUNS solicitado. Os dados devolvidos são específicos do produto solicitado.

Parâmetros

Name Chave Necessário Tipo Description
Número D-U-N-S
duns True string

O D-U-N-S Number é um número de identificação atribuído pela D&B que identifica exclusivamente a entidade de acordo com o Data Universal Numbering System (D-U-N-S).

ID do Produto
productId True string

O ID do produto fornecido pela D&B que identifica o produto a ser devolvido.

ID da versão
versionId True string

O ID da versão (por exemplo, v1) que identifica a versão do produto a ser retornada.

Devoluções

Name Caminho Tipo Description
Número DUNS
duns string

O D-U-N-S Number é um número de identificação atribuído pela D&B que identifica exclusivamente a entidade de acordo com o Data Universal Numbering System (D-U-N-S).

Nome comercial principal
primary_name string

O nome único pelo qual a entidade é principalmente conhecida ou identificada.

Nome do estilo comercial
trade_style string

O nome sob o qual a entidade negocia para fins comerciais, embora o seu nome legal registado utilizado para contratos e outras situações formais possa ser outro nome.

Endereço
address.streetline1 string

A primeira linha do endereço onde a entidade está localizada.

Endereço (2)
address.streetline2 string

A segunda linha do endereço onde a entidade está localizada.

Endereço Cidade
address.city string

O nome da cidade, vila, município, aldeia, bairro, etc. em que este endereço está localizado.

Código do 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 ISO do país
address.isoalpha2code string

O código de país de duas letras, definido pelo esquema ISO 3166-1 da Organização Internacional de Normalização (ISO) 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 3166-1 da Organização Internacional de Normalização (ISO), que identifica o país da entidade empresarial.

Código ISD telefónico
phone.international_code string

Esta sequência de dígitos contém o código ISD (International Subscriber Dialling).

Número de telefone
phone.number string

Uma sequência de dígitos usada para comunicação de voz com a entidade. Esta sequência de dígitos inclui o código de área ou código da cidade e o código de discagem nacional.

Código da Indústria
primary_sic string

O código que identifica a atividade comercial na qual a entidade está envolvida.

Descrição do Código da Indústria
industrycode.description string

A descrição do Código da Indústria correspondente.

Detalhes da quantidade do funcionário (local)
employees.local integer

O número total de pessoas contratadas pela entidade para realizar as 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 contratadas pela entidade para realizar as suas operações. O escopo dessa figura de funcionário é identificado em informationScopeDescription.

Demonstrações financeiras até à data
financials.todate date-time

A data em que o período contabilístico terminou.  Se o Código de Fiabilidade indicar que os valores são projetados (futuros), então esta é a data em que o período contabilístico terminará.

Valor da receita de vendas em USD
financials_global.value integer

O valor monetário dos rendimentos recebidos dos clientes da venda dos bens e/ou serviços da entidade em USD.  Trata-se das vendas brutas menos quaisquer devoluções, abatimentos/descontos, subsídios por danos ou escassez, despesas de envio repercutidas no cliente.

Valor da receita de vendas na moeda local
financials_local.value integer

O valor monetário dos rendimentos recebidos dos clientes da venda dos bens e/ou serviços da entidade em moeda local.  Trata-se das vendas brutas menos quaisquer devoluções, abatimentos/descontos, subsídios por danos ou escassez, despesas de envio repercutidas no cliente.

Código da moeda local
financials_local.currency string

O código de moeda local para esta entidade.

Tipos de localização
location_types string

Uma lista delimitada por ponto-e-vírgula de Tipos de Localização para esta entidade.

Indicador de localização única
is_single_location boolean

Indica se a entidade é um único local ou não.

Número pai D-U-N-S
parent.duns string

O número D-U-N-S da entidade-mãe. Uma empresa-mãe é uma sociedade que possui mais de 50% do capital social de outra sociedade; Estas empresas detidas são subsidiárias da entidade-mãe. 

Nome da empresa-mãe
parent.name string

O nome comercial da entidade-mãe. Uma empresa-mãe é uma sociedade que possui mais de 50% do capital social de outra sociedade.

Número final doméstico D-U-N-S
domestic_ultimate.duns string

O Número D-U-N-S da empresa-mãe de nível mais alto dentro de uma árvore genealógica corporativa domiciliada no mesmo país que a entidade solicitada. Uma empresa-mãe é uma sociedade que possui mais de 50% do capital social de outra sociedade. Um sujeito pode ser o seu próprio final doméstico.

Nome final doméstico
domestic_ultimate.name string

O nome do negócio mais alto na árvore genealógica que está no mesmo país que o sujeito.

Número Global Ultimate D-U-N-S
global_ultimate.duns string

O número D-U-N-S da empresa-mãe de nível mais alto dentro de uma árvore genealógica corporativa. Uma empresa-mãe é uma sociedade que possui mais de 50% do capital social de outra sociedade. Um assunto pode ser o seu próprio final global. 

Nome Final Global
global_ultimate.name string

O principal nome do negócio final global.

Estrutura Jurídica Empresarial
entity_type integer

O Código D&B para a Estrutura Jurídica Empresarial correspondente

Descrição da Estrutura Jurídica do Negócio
entity_type.description string

O nome da forma jurídica ou estrutura da entidade tal como registada junto das autoridades governamentais (por exemplo, sociedade, sociedade, sociedade por quotas, departamento da administração pública, propriedade). Um código único atribuído pela D&B para identificar a forma jurídica ou a estrutura da entidade tal como registada junto das autoridades governamentais

Indicador retirado da lista
is_delisted boolean

Indicador sobre se a entidade solicitou ou não que seus dados não fossem incluídos no arquivo de marketing da D&B para prospeção.

Estado Operacional
operating_status integer

O código D&B para o status operacional correspondente

Descrição do estado de funcionamento
operating_status.description string

O estado funcional ou o status comercial da entidade (por exemplo, ativo, fora do negócio). Um código exclusivo atribuído pela D&B para identificar o estado funcional ou o status de negociação da entidade.