Optimizador de D&B [EN DESUSO]
D&B Optimizer es un servicio de datos fundamentales de Dun & Bradstreet que mejora la calidad de los datos empresariales mediante la identificación, limpieza e inserción de inteligencia firme en registros dentro de su entorno de aplicación de Microsoft.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Metadatos del conector | |
|---|---|
| Publicador | Dun & Bradstreet |
D&B Optimizer requiere que los usuarios tengan acceso a un entorno de Common Data Service y una suscripción activa para los servicios de Dun & Bradstreet.
Obtenga más información aquí y cómo empezar aquí.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Limpiar coincidencia y anexar [EN DESUSO] |
La resolución de identidades de D&B usa criterios de entrada para encontrar los mejores candidatos en su amplia base de datos de entidades. Usa algoritmos propietarios para identificar las mejores coincidencias y devuelve esas coincidencias con información detallada sobre los criterios que se usaron para encontrar la coincidencia. |
| Recuperar datos en una entidad específica [EN DESUSO] |
Data Products API devuelve datos sobre una DUNS solicitada. Los datos devueltos son específicos del producto solicitado. |
Limpiar coincidencia y anexar [EN DESUSO]
La resolución de identidades de D&B usa criterios de entrada para encontrar los mejores candidatos en su amplia base de datos de entidades. Usa algoritmos propietarios para identificar las mejores coincidencias y devuelve esas coincidencias con información detallada sobre los criterios que se usaron para encontrar la coincidencia.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de producto
|
productId | True | string |
Id. de producto proporcionado por D&B que identifica el producto que se va a devolver. |
|
Id. de versión
|
versionId | True | string |
Identificador de versión (por ejemplo, v1) que identifica la versión del producto que se va a devolver. |
|
Nombre
|
name | string |
Hasta 240 caracteres usados para buscar la entidad por su nombre principal, nombres de estilo de comercio o nombres anteriores. |
|
|
Línea 1 de dirección postal
|
streetAddressLine1 | string |
Hasta 70 caracteres de la primera línea de la dirección postal de la entidad. |
|
|
Línea 2 de dirección postal
|
streetAddressLine2 | string |
Hasta 70 caracteres de la segunda línea de la dirección postal de la entidad |
|
|
Código alfa ISO de país
|
countryISOAlpha2Code | True | string |
El código de país de 2 letras, definido por el esquema ISO 3166-1 de la Organización Internacional de Normalización (ISO) que identifica el país de la entidad. |
|
Código postal
|
postalCode | string |
Hasta 10 caracteres del identificador utilizado por la autoridad postal del país local para identificar dónde se encuentra la dirección. |
|
|
Localidad de dirección
|
addressLocality | string |
De 1 a 50 caracteres que identifican la ciudad, la ciudad, la localidad, el pueblo, el municipio, etc. donde se encuentra la entidad. |
|
|
Región de direcciones
|
addressRegion | string |
Nombre del área regulada localmente que forma parte de una nación controlada centralmente para identificar dónde se encuentra la dirección. |
|
|
Número de teléfono
|
telephoneNumber | string |
Hasta 32 caracteres del número de teléfono: la secuencia de dígitos usados para la comunicación de voz con la entidad. Esta secuencia de dígitos incluye el código de área o el código de ciudad y el código de marcado nacional. |
|
|
URL
|
url | string |
Dirección URL usada para identificar una entidad por su dominio de correo electrónico. |
|
|
Correo Electrónico
|
string |
Una dirección de correo electrónico que se usa para identificar una entidad por su dominio de correo electrónico. |
||
|
Matrícula
|
registrationNumber | string |
Número asignado por un cuerpo externo o por D&B que identifica de forma única o ayuda a identificar una organización. |
|
|
Tipo de número de registro
|
registrationNumberType | string |
Un código único asignado por D&B para identificar el tipo de número de registro. |
|
|
Nivel inferior de confianza
|
confidenceLowerLevelThresholdValue | string |
Nivel de confianza más bajo para las entidades devueltas en la respuesta. Los valores válidos son de 1 a 10, si no se especifica el valor predeterminado de 4. |
|
|
Criterios de exclusión
|
exclusionCriteria | string |
Proporciona la capacidad de excluir entidades basadas en varias propiedades. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número DUNS
|
duns | string |
El número D-U-N-S es un número de identificación asignado por D&B que identifica de forma única la entidad de acuerdo con el sistema de numeración universal de datos (D-U-N-S). |
|
Nombre de negocio principal
|
primary_name | string |
Nombre único por el que la entidad se conoce o identifica principalmente. |
|
Nombre del estilo comercial
|
trade_style | string |
El nombre en el que la entidad opera con fines comerciales, aunque su nombre legal registrado utilizado para contratos y otras situaciones formales puede ser otro nombre. |
|
Dirección de la calle
|
address.streetline1 | string |
Primera línea de la dirección donde se encuentra la entidad. |
|
Dirección postal (2)
|
address.streetline2 | string |
Segunda línea de la dirección donde se encuentra la entidad. |
|
Ciudad de dirección
|
address.city | string |
Nombre de la ciudad, ciudad, localidad, pueblo, municipio, etc. en el que se encuentra esta dirección. |
|
Código de territorio
|
address.territory_code | string |
El código estándar del área regulada localmente que forma parte de una nación controlada centralmente para identificar dónde se encuentra esta dirección. |
|
Nombre del territorio
|
address.territory_name | string |
Nombre del área regulada localmente que forma parte de una nación controlada centralmente para identificar dónde se encuentra esta dirección. |
|
Código postal
|
address.postal_code | string |
Identificador utilizado por la autoridad postal del país local para identificar dónde se encuentra la empresa. |
|
Código de país ISO
|
address.isoalpha2code | string |
El código de país de dos letras, definido por el esquema ISO 3166-1 de la Organización Internacional de Normalización (ISO) que identifica el país de la entidad empresarial. |
|
Nombre de país ISO
|
address.country_name | string |
El código de país, definido por el esquema ISO 3166-1 de la Organización Internacional de Normalización (ISO) que identifica el país de la entidad empresarial. |
|
Código DE ISD telefónico
|
phone.international_code | string |
Esta secuencia de dígitos contiene el código de marcado de suscriptor internacional (ISD). |
|
Número de teléfono
|
phone.number | string |
Secuencia de dígitos usados para la comunicación de voz con la entidad. Esta secuencia de dígitos incluye el código de área o el código de ciudad y el código de marcado nacional. |
|
Código del sector
|
primary_sic | string |
Código que identifica la actividad empresarial en la que está comprometida la entidad. |
|
Descripción del código del sector
|
industrycode.description | string |
Descripción del código industrial correspondiente. |
|
Detalles de cantidad de empleados (local)
|
employees.local | integer |
Número total de personas comprometidas por la entidad para realizar sus operaciones. El ámbito de esta figura de empleado se identifica en informationScopeDescription. |
|
Detalles de cantidad de empleados (total)
|
employees.global | integer |
Número total de personas comprometidas por la entidad para realizar sus operaciones. El ámbito de esta figura de empleado se identifica en informationScopeDescription. |
|
Estado financiero hasta la fecha
|
financials.todate | date-time |
Fecha en que finalizó el período contable. Si el Código de confiabilidad indica que las cifras se proyectan (futuras), esta es la fecha en que finalizará el período contable. |
|
Importe de ingresos de ventas en USD
|
financials_global.value | integer |
Valor monetario de los ingresos recibidos de los clientes de la venta de bienes o servicios de la entidad en USD. Se trata de las ventas brutas menos cualquier devolución, reembolsos/descuentos, asignaciones por daños o escasez, gastos de envío pasados al cliente. |
|
Importe de ingresos de ventas en la moneda local
|
financials_local.value | integer |
Valor monetario de los ingresos recibidos de los clientes de la venta de bienes o servicios de la entidad en moneda local. Se trata de las ventas brutas menos cualquier devolución, reembolsos/descuentos, asignaciones por daños o escasez, gastos de envío pasados al cliente. |
|
Código de moneda local
|
financials_local.currency | string |
Código de moneda local para esta entidad. |
|
Tipos de ubicación
|
location_types | string |
Lista delimitada por punto y coma de tipos de ubicación para esta entidad. |
|
Indicador de ubicación única
|
is_single_location | boolean |
Indica si la entidad es una ubicación única o no. |
|
Número de D-U-N-S primario
|
parent.duns | string |
Número D-U-N-S de la entidad primaria. Un padre es una corporación que posee más de 50% de las acciones de capital de otra corporación; estas empresas propiedad son subsidiarias de la entidad matriz. |
|
Nombre de empresa principal
|
parent.name | string |
Nombre empresarial de la entidad primaria. Un padre es una corporación que posee más de 50% de la bolsa de capital de otra corporación. |
|
Número nacional de D-U-N-S
|
domestic_ultimate.duns | string |
Número D-U-N-S del principal de nivel más alto dentro de un árbol familiar corporativo que está domiciliado en el mismo país que la entidad solicitada. Un padre es una corporación que posee más de 50% de la bolsa de capital de otra corporación. Un sujeto puede ser su propio final interno. |
|
Nombre final nacional
|
domestic_ultimate.name | string |
Nombre del negocio más alto del árbol familiar que se encuentra en el mismo país que el sujeto. |
|
Número global de D-U-N-S
|
global_ultimate.duns | string |
El número D-U-N-S del elemento primario de nivel más alto dentro de un árbol de familia corporativa. Un padre es una corporación que posee más de 50% de la bolsa de capital de otra corporación. Un sujeto puede ser su propio fin global. |
|
Nombre final global
|
global_ultimate.name | string |
Nombre principal de la empresa definitiva global. |
|
Estructura legal empresarial
|
entity_type | integer |
El código de D&B para la estructura legal comercial correspondiente |
|
Descripción de la estructura legal empresarial
|
entity_type.description | string |
Nombre de la forma legal o estructura de la entidad registrada con las autoridades gubernamentales (por ejemplo, asociación, corporación, empresa limitada privada, departamento gubernamental, titular). Un código único asignado por D&B para identificar la forma legal o estructura de la entidad como registrada con las autoridades gubernamentales |
|
Coincidencia de confianza
|
match.confidence | integer |
Los códigos de confianza se basan en las cadenas MatchGrade detalladas™; Más de 4 millones de combinaciones de cadenas se asignan a 10 códigos de confianza, lo que permite una categorización amplia de registros coincidentes. Cuanto mayor sea el número, mayor será la confianza de que es una coincidencia precisa. |
|
Perfil de coincidencia
|
match.profile | string |
Coincidencia de códigos de perfil de datos (MDP) indica si y cómo se ha coinciden cada tipo de componente en el candidato devuelto. |
|
Grado de coincidencia
|
match.grade | string |
Las cadenas MatchGrade proporcionan evaluaciones cualitativas entre los componentes de consulta y referencia. A - Considerado igual, B - Cierta similiaridad, F - Considerado diferente, Z - Información que falta, no puede concluir. |
|
Indicador deslistado
|
is_delisted | boolean |
Indicador sobre si la entidad ha pedido o no que sus datos no se incluyan en el archivo de marketing de D&B para la prospección. |
|
Estado de funcionamiento
|
operating_status | integer |
El código D&B para el estado operativo correspondiente |
|
Descripción del estado operativo
|
operating_status.description | string |
Estado funcional o estado comercial de la entidad (por ejemplo, activo, fuera de negocio). Un código único asignado por D&B para identificar el estado funcional o el estado comercial de la entidad. |
|
Grado de coincidencia: nombre de la organización
|
match_grade.name | string |
Grado de coincidencia: nombre de la organización |
|
Grado de coincidencia: número de calle
|
match_grade.street_number | string |
Grado de coincidencia: número de calle |
|
Grado de coincidencia: nombre de calle
|
match_grade.street_name | string |
Grado de coincidencia: nombre de calle |
|
Grado de coincidencia- Ciudad/Ciudad
|
match_grade.city | string |
Grado de coincidencia- Ciudad/Ciudad |
|
Grado de coincidencia: estado o región
|
match_grade.state | string |
Grado de coincidencia: estado o región |
|
Grado de coincidencia: cuadro de pedido de compra
|
match_grade.po_box | string |
Grado de coincidencia: cuadro de pedido de compra |
|
Grado de coincidencia: número de teléfono
|
match_grade.phone | string |
Grado de coincidencia: número de teléfono |
|
Grado de coincidencia: código postal
|
match_grade.postal_code | string |
Grado de coincidencia: código postal |
|
Grado de coincidencia: densidad
|
match_grade.density | string |
Grado de coincidencia: densidad |
|
Grado de coincidencia: unicidad
|
match_grade.uniqueness | string |
Grado de coincidencia: unicidad |
|
Grado de coincidencia: código SIC
|
match_grade.industry | string |
Grado de coincidencia: código SIC |
Recuperar datos en una entidad específica [EN DESUSO]
Data Products API devuelve datos sobre una DUNS solicitada. Los datos devueltos son específicos del producto solicitado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de D-U-N-S
|
duns | True | string |
El número D-U-N-S es un número de identificación asignado por D&B que identifica de forma única la entidad de acuerdo con el sistema de numeración universal de datos (D-U-N-S). |
|
Id. de producto
|
productId | True | string |
Id. de producto proporcionado por D&B que identifica el producto que se va a devolver. |
|
Id. de versión
|
versionId | True | string |
Identificador de versión (por ejemplo, v1) que identifica la versión del producto que se va a devolver. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número DUNS
|
duns | string |
El número D-U-N-S es un número de identificación asignado por D&B que identifica de forma única la entidad de acuerdo con el sistema de numeración universal de datos (D-U-N-S). |
|
Nombre de negocio principal
|
primary_name | string |
Nombre único por el que la entidad se conoce o identifica principalmente. |
|
Nombre del estilo comercial
|
trade_style | string |
El nombre en el que la entidad opera con fines comerciales, aunque su nombre legal registrado utilizado para contratos y otras situaciones formales puede ser otro nombre. |
|
Dirección de la calle
|
address.streetline1 | string |
Primera línea de la dirección donde se encuentra la entidad. |
|
Dirección postal (2)
|
address.streetline2 | string |
Segunda línea de la dirección donde se encuentra la entidad. |
|
Ciudad de dirección
|
address.city | string |
Nombre de la ciudad, ciudad, localidad, pueblo, municipio, etc. en el que se encuentra esta dirección. |
|
Código de territorio
|
address.territory_code | string |
El código estándar del área regulada localmente que forma parte de una nación controlada centralmente para identificar dónde se encuentra esta dirección. |
|
Nombre del territorio
|
address.territory_name | string |
Nombre del área regulada localmente que forma parte de una nación controlada centralmente para identificar dónde se encuentra esta dirección. |
|
Código postal
|
address.postal_code | string |
Identificador utilizado por la autoridad postal del país local para identificar dónde se encuentra la empresa. |
|
Código de país ISO
|
address.isoalpha2code | string |
El código de país de dos letras, definido por el esquema ISO 3166-1 de la Organización Internacional de Normalización (ISO) que identifica el país de la entidad empresarial. |
|
Nombre de país ISO
|
address.country_name | string |
El código de país, definido por el esquema ISO 3166-1 de la Organización Internacional de Normalización (ISO) que identifica el país de la entidad empresarial. |
|
Código DE ISD telefónico
|
phone.international_code | string |
Esta secuencia de dígitos contiene el código de marcado de suscriptor internacional (ISD). |
|
Número de teléfono
|
phone.number | string |
Secuencia de dígitos usados para la comunicación de voz con la entidad. Esta secuencia de dígitos incluye el código de área o el código de ciudad y el código de marcado nacional. |
|
Código del sector
|
primary_sic | string |
Código que identifica la actividad empresarial en la que está comprometida la entidad. |
|
Descripción del código del sector
|
industrycode.description | string |
Descripción del código industrial correspondiente. |
|
Detalles de cantidad de empleados (local)
|
employees.local | integer |
Número total de personas comprometidas por la entidad para realizar sus operaciones. El ámbito de esta figura de empleado se identifica en informationScopeDescription. |
|
Detalles de cantidad de empleados (total)
|
employees.global | integer |
Número total de personas comprometidas por la entidad para realizar sus operaciones. El ámbito de esta figura de empleado se identifica en informationScopeDescription. |
|
Estado financiero hasta la fecha
|
financials.todate | date-time |
Fecha en que finalizó el período contable. Si el Código de confiabilidad indica que las cifras se proyectan (futuras), esta es la fecha en que finalizará el período contable. |
|
Importe de ingresos de ventas en USD
|
financials_global.value | integer |
Valor monetario de los ingresos recibidos de los clientes de la venta de bienes o servicios de la entidad en USD. Se trata de las ventas brutas menos cualquier devolución, reembolsos/descuentos, asignaciones por daños o escasez, gastos de envío pasados al cliente. |
|
Importe de ingresos de ventas en la moneda local
|
financials_local.value | integer |
Valor monetario de los ingresos recibidos de los clientes de la venta de bienes o servicios de la entidad en moneda local. Se trata de las ventas brutas menos cualquier devolución, reembolsos/descuentos, asignaciones por daños o escasez, gastos de envío pasados al cliente. |
|
Código de moneda local
|
financials_local.currency | string |
Código de moneda local para esta entidad. |
|
Tipos de ubicación
|
location_types | string |
Lista delimitada por punto y coma de tipos de ubicación para esta entidad. |
|
Indicador de ubicación única
|
is_single_location | boolean |
Indica si la entidad es una ubicación única o no. |
|
Número de D-U-N-S primario
|
parent.duns | string |
Número D-U-N-S de la entidad primaria. Un padre es una corporación que posee más de 50% de las acciones de capital de otra corporación; estas empresas propiedad son subsidiarias de la entidad matriz. |
|
Nombre de empresa principal
|
parent.name | string |
Nombre empresarial de la entidad primaria. Un padre es una corporación que posee más de 50% de la bolsa de capital de otra corporación. |
|
Número nacional de D-U-N-S
|
domestic_ultimate.duns | string |
Número D-U-N-S del principal de nivel más alto dentro de un árbol familiar corporativo que está domiciliado en el mismo país que la entidad solicitada. Un padre es una corporación que posee más de 50% de la bolsa de capital de otra corporación. Un sujeto puede ser su propio final interno. |
|
Nombre final nacional
|
domestic_ultimate.name | string |
Nombre del negocio más alto del árbol familiar que se encuentra en el mismo país que el sujeto. |
|
Número global de D-U-N-S
|
global_ultimate.duns | string |
El número D-U-N-S del elemento primario de nivel más alto dentro de un árbol de familia corporativa. Un padre es una corporación que posee más de 50% de la bolsa de capital de otra corporación. Un sujeto puede ser su propio fin global. |
|
Nombre final global
|
global_ultimate.name | string |
Nombre principal de la empresa definitiva global. |
|
Estructura legal empresarial
|
entity_type | integer |
El código de D&B para la estructura legal comercial correspondiente |
|
Descripción de la estructura legal empresarial
|
entity_type.description | string |
Nombre de la forma legal o estructura de la entidad registrada con las autoridades gubernamentales (por ejemplo, asociación, corporación, empresa limitada privada, departamento gubernamental, titular). Un código único asignado por D&B para identificar la forma legal o estructura de la entidad como registrada con las autoridades gubernamentales |
|
Indicador deslistado
|
is_delisted | boolean |
Indicador sobre si la entidad ha pedido o no que sus datos no se incluyan en el archivo de marketing de D&B para la prospección. |
|
Estado de funcionamiento
|
operating_status | integer |
El código D&B para el estado operativo correspondiente |
|
Descripción del estado operativo
|
operating_status.description | string |
Estado funcional o estado comercial de la entidad (por ejemplo, activo, fuera de negocio). Un código único asignado por D&B para identificar el estado funcional o el estado comercial de la entidad. |