Оптимизатор D&B [DEPRECATED]
Оптимизатор D&B — это базовая служба данных из Dun & Bradstreet, которая улучшает качество бизнес-данных путем правильной идентификации, очистки и вставки твердой аналитики в записи в среде приложений Майкрософт.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Стандарт | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Метаданные соединителя | |
|---|---|
| Publisher | Dun и Bradstreet |
Оптимизатор D&B требует, чтобы пользователи имели доступ к среде Common Data Service и активной подписке для служб Dun & Bradstreet.
Дополнительные сведения см. здесь и как приступить к работе.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Очистка соответствия и добавления [не рекомендуется] |
Разрешение удостоверений D&B использует критерии ввода для поиска лучших кандидатов в своей обширной базе данных сущностей. Он использует собственные алгоритмы для определения лучших совпадений и возврата этих совпадений с подробными сведениями о том, какие критерии использовались для поиска соответствия. |
| Получение данных для определенной сущности [DEPRECATED] |
API продуктов данных возвращает данные о запрошенном DUNS. Возвращаемые данные зависят от запрошенного продукта. |
Очистка соответствия и добавления [не рекомендуется]
Разрешение удостоверений D&B использует критерии ввода для поиска лучших кандидатов в своей обширной базе данных сущностей. Он использует собственные алгоритмы для определения лучших совпадений и возврата этих совпадений с подробными сведениями о том, какие критерии использовались для поиска соответствия.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор продукта
|
productId | True | string |
Идентификатор продукта, предоставленный D&B, идентифицирующий возвращаемый продукт. |
|
Идентификатор версии
|
versionId | True | string |
Идентификатор версии (например, версия 1), определяющий возвращаемую версию продукта. |
|
Имя
|
name | string |
До 240 символов, используемых для поиска сущности по его основному имени, именам торговых стилей или бывшим именам. |
|
|
Адрес улицы 1
|
streetAddressLine1 | string |
До 70 символов первой строки адреса улицы сущности. |
|
|
Адрес улицы 2
|
streetAddressLine2 | string |
До 70 символов второй строки адреса улицы сущности |
|
|
Альфа-код страны ISO
|
countryISOAlpha2Code | True | string |
2-буквенный код страны, определенный международной организацией по стандартизации (ISO) ISO 3166-1, определяющей страну сущности. |
|
Почтовый индекс
|
postalCode | string |
До 10 символов идентификатора, используемого почтовым органом локальной страны для определения расположения адреса. |
|
|
Локализация адресов
|
addressLocality | string |
От 1 до 50 символов, определяющих город, город, город, деревню, район и т. д., где находится сущность. |
|
|
Адресный регион
|
addressRegion | string |
Имя локально управляемой области, которая является частью централизованно управляемой страны, чтобы определить, где находится адрес. |
|
|
Номер телефона
|
telephoneNumber | string |
До 32 символов телефонного номера — последовательность цифр, используемых для голосового взаимодействия с сущностью. Эта последовательность цифр включает код области или код города и внутренний телефонный код. |
|
|
URL
|
url | string |
URL-адрес, используемый для идентификации сущности по его домену электронной почты. |
|
|
Адрес электронной почты
|
string |
Адрес электронной почты, используемый для идентификации сущности по своему домену электронной почты. |
||
|
Номер регистрации
|
registrationNumber | string |
Номер, назначенный внешним телом или D&B, который однозначно идентифицирует или помогает определить организацию. |
|
|
Тип номера регистрации
|
registrationNumberType | string |
Уникальный код, назначенный D&B для определения типа номера регистрации. |
|
|
Уровень достоверности ниже
|
confidenceLowerLevelThresholdValue | string |
Самый низкий уровень достоверности для сущностей, возвращаемых в ответе. Допустимые значения — от 1 до 10, если не указано значение по умолчанию 4. |
|
|
Критерии исключения
|
exclusionCriteria | string |
Предоставляет возможность исключения сущностей на основе нескольких свойств. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Число DUNS
|
duns | string |
Номер D-U-N-S — это идентификационный номер, назначенный D&B, который однозначно идентифицирует сущность в соответствии с системой универсального нумерирования данных (D-U-N-S). |
|
Основное название бизнеса
|
primary_name | string |
Единственное имя, по которому сущность в основном известна или определена. |
|
Название стиля торговли
|
trade_style | string |
Имя, которое сущность торгует в коммерческих целях, хотя зарегистрированное юридическое имя, используемое для контрактов и других формальных ситуаций, может быть другим именем. |
|
Адрес улицы
|
address.streetline1 | string |
Первая строка адреса, в которой находится сущность. |
|
Адрес улицы (2)
|
address.streetline2 | string |
Вторая строка адреса, в которой находится сущность. |
|
Адрес города
|
address.city | string |
Имя города, города, поселка, деревни, района и т. д., в котором находится этот адрес. |
|
Код территории
|
address.territory_code | string |
Стандартный код локально управляемой области, которая является частью централизованно управляемой страны, чтобы определить, где находится этот адрес. |
|
Имя территории
|
address.territory_name | string |
Имя локально управляемой области, которая является частью централизованно управляемой страны, чтобы определить, где находится этот адрес. |
|
Почтовый индекс
|
address.postal_code | string |
Идентификатор, используемый почтовым органом локальной страны для определения расположения предприятия. |
|
Код страны ISO
|
address.isoalpha2code | string |
Двухбуквенный код страны, определенный международной организацией по стандартизации (ISO) ISO 3166-1, определяющей страну бизнес-сущности. |
|
Имя страны ISO
|
address.country_name | string |
Код страны, определенный международной организацией по стандартизации (ISO) ISO 3166-1, определяющий страну бизнес-сущности. |
|
Код ISD телефона
|
phone.international_code | string |
Эта последовательность цифр содержит код международного абонентского набора (ISD). |
|
Номер телефона
|
phone.number | string |
Последовательность цифр, используемых для голосового взаимодействия с сущностью. Эта последовательность цифр включает код области или код города и внутренний телефонный код. |
|
Отраслевый код
|
primary_sic | string |
Код, определяющий бизнес-активность, в которой занята сущность. |
|
Описание отраслевого кода
|
industrycode.description | string |
Описание соответствующего отраслевого кода. |
|
Сведения о количестве сотрудников (локальный)
|
employees.local | integer |
Общее количество людей, задействованных сущностью для выполнения своих операций. Область этого рисунка сотрудника определяется в informationScopeDescription. |
|
Сведения о количестве сотрудников (всего)
|
employees.global | integer |
Общее количество людей, задействованных сущностью для выполнения своих операций. Область этого рисунка сотрудника определяется в informationScopeDescription. |
|
Финансовый отчет на сегодняшний день
|
financials.todate | date-time |
Дата окончания периода учета. Если код надежности указывает, что цифры проецируются (в будущем), то это дата окончания учетного периода. |
|
Сумма выручки от продаж в USD
|
financials_global.value | integer |
Денежный доход, полученный от клиентов от продажи товаров и/или услуг сущности в долларах США. Это валовые продажи минус любые возвраты, скидки или скидки, пособия по ущербу или нехватке, расходы на доставку, переданные клиенту. |
|
Сумма выручки от продаж в локальной валюте
|
financials_local.value | integer |
Денежный доход, полученный от клиентов от продажи товаров и /или услуг сущности в локальной валюте. Это валовые продажи минус любые возвраты, скидки или скидки, пособия по ущербу или нехватке, расходы на доставку, переданные клиенту. |
|
Код локальной валюты
|
financials_local.currency | string |
Код локальной валюты для этой сущности. |
|
Типы расположений
|
location_types | string |
Список типов расположений для этой сущности с разделителями с запятой. |
|
Индикатор единого расположения
|
is_single_location | boolean |
Указывает, является ли сущность одним расположением или нет. |
|
Родительский номер D-U-N-S
|
parent.duns | string |
Номер D-U-N-S родительской сущности. Родитель является корпорацией, которая владеет более чем 50% акций другой корпорации; эти принадлежащие компании являются дочерними компаниями родительской сущности. |
|
Родительская бизнес-имя
|
parent.name | string |
Бизнес-имя родительской сущности. Родитель является корпорацией, которая владеет более чем 50% капитала другой корпорации. |
|
Внутреннее число D-U-N-S
|
domestic_ultimate.duns | string |
Номер D-U-N-S родительского уровня высшего уровня в корпоративном дереве семьи, который находится в той же стране, что и запрошенная сущность. Родитель является корпорацией, которая владеет более чем 50% капитала другой корпорации. Тема может быть собственной внутренней конечной. |
|
Внутреннее конечное имя
|
domestic_ultimate.name | string |
Имя самого высокого бизнеса в дереве семьи, которое находится в той же стране, что и тема. |
|
Глобальный номер D-U-N-S
|
global_ultimate.duns | string |
Число D-U-N-S самого высокого уровня родителя в корпоративном дереве семьи. Родитель является корпорацией, которая владеет более чем 50% капитала другой корпорации. Тема может быть собственной глобальной конечной. |
|
Глобальное конечное имя
|
global_ultimate.name | string |
Основное имя глобального конечного бизнеса. |
|
Юридическая структура бизнеса
|
entity_type | integer |
Код D&B для соответствующей юридической структуры бизнеса |
|
Описание бизнес-юридической структуры
|
entity_type.description | string |
Название юридической формы или структуры сущности, зарегистрированной в государственных органах (например, партнерство, корпорация, частная ограниченная компания, правительственный департамент, собственность). Уникальный код, назначенный D&B для идентификации юридической формы или структуры сущности, зарегистрированной в государственных органах. |
|
Достоверность соответствия
|
match.confidence | integer |
Коды достоверности основаны на подробных строках™ MatchGrade; Более 4 миллионов сочетаний строк сопоставляются с 10 кодами достоверности, что позволяет обеспечить широкую классификацию сопоставленных записей. Чем выше число, тем выше уверенность в том, что это точное совпадение. |
|
Профиль сопоставления
|
match.profile | string |
Коды сопоставления профилей данных (MDP) указывают, соответствует ли каждый тип компонента в возвращаемом кандидате. |
|
Оценка соответствия
|
match.grade | string |
Строки MatchGrade предоставляют качественные оценки между запросами и эталонными компонентами. A - Считается таким же, B - Некоторые симиляритности, F - считается разными, Z - Отсутствующие сведения, не могут сделать вывод. |
|
Нелистый индикатор
|
is_delisted | boolean |
Индикатор о том, запрашивает ли сущность, что их данные не будут включены в маркетинговый файл D&B для поиска. |
|
Состояние работы
|
operating_status | integer |
Код D&B для соответствующего состояния операционной системы |
|
Описание состояния работы
|
operating_status.description | string |
Функциональное состояние сущности или состояние торговли (например, активный, вне бизнеса). Уникальный код, назначенный D&B для идентификации функционального состояния или торгового состояния сущности. |
|
Оценка соответствия — название организации
|
match_grade.name | string |
Оценка соответствия — название организации |
|
Совпадение оценка - номер улицы
|
match_grade.street_number | string |
Совпадение оценка - номер улицы |
|
Match Grade - Street Name
|
match_grade.street_name | string |
Match Grade - Street Name |
|
Match Grade - City/City
|
match_grade.city | string |
Match Grade - City/City |
|
Оценка соответствия — состояние или регион
|
match_grade.state | string |
Оценка соответствия — состояние или регион |
|
Оценка соответствия — PO Box
|
match_grade.po_box | string |
Оценка соответствия — PO Box |
|
Оценка соответствия — номер телефона
|
match_grade.phone | string |
Оценка соответствия — номер телефона |
|
Оценка соответствия — почтовый индекс
|
match_grade.postal_code | string |
Оценка соответствия — почтовый индекс |
|
Оценка соответствия — плотность
|
match_grade.density | string |
Оценка соответствия — плотность |
|
Оценка соответствия — уникальность
|
match_grade.uniqueness | string |
Оценка соответствия — уникальность |
|
Оценка соответствия — код SIC
|
match_grade.industry | string |
Оценка соответствия — код SIC |
Получение данных для определенной сущности [DEPRECATED]
API продуктов данных возвращает данные о запрошенном DUNS. Возвращаемые данные зависят от запрошенного продукта.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Номер D-U-N-S
|
duns | True | string |
Номер D-U-N-S — это идентификационный номер, назначенный D&B, который однозначно идентифицирует сущность в соответствии с системой универсального нумерирования данных (D-U-N-S). |
|
Идентификатор продукта
|
productId | True | string |
Идентификатор продукта, предоставленный D&B, идентифицирующий возвращаемый продукт. |
|
Идентификатор версии
|
versionId | True | string |
Идентификатор версии (например, версия 1), определяющий возвращаемую версию продукта. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Число DUNS
|
duns | string |
Номер D-U-N-S — это идентификационный номер, назначенный D&B, который однозначно идентифицирует сущность в соответствии с системой универсального нумерирования данных (D-U-N-S). |
|
Основное название бизнеса
|
primary_name | string |
Единственное имя, по которому сущность в основном известна или определена. |
|
Название стиля торговли
|
trade_style | string |
Имя, которое сущность торгует в коммерческих целях, хотя зарегистрированное юридическое имя, используемое для контрактов и других формальных ситуаций, может быть другим именем. |
|
Адрес улицы
|
address.streetline1 | string |
Первая строка адреса, в которой находится сущность. |
|
Адрес улицы (2)
|
address.streetline2 | string |
Вторая строка адреса, в которой находится сущность. |
|
Адрес города
|
address.city | string |
Имя города, города, поселка, деревни, района и т. д., в котором находится этот адрес. |
|
Код территории
|
address.territory_code | string |
Стандартный код локально управляемой области, которая является частью централизованно управляемой страны, чтобы определить, где находится этот адрес. |
|
Имя территории
|
address.territory_name | string |
Имя локально управляемой области, которая является частью централизованно управляемой страны, чтобы определить, где находится этот адрес. |
|
Почтовый индекс
|
address.postal_code | string |
Идентификатор, используемый почтовым органом локальной страны для определения расположения предприятия. |
|
Код страны ISO
|
address.isoalpha2code | string |
Двухбуквенный код страны, определенный международной организацией по стандартизации (ISO) ISO 3166-1, определяющей страну бизнес-сущности. |
|
Имя страны ISO
|
address.country_name | string |
Код страны, определенный международной организацией по стандартизации (ISO) ISO 3166-1, определяющий страну бизнес-сущности. |
|
Код ISD телефона
|
phone.international_code | string |
Эта последовательность цифр содержит код международного абонентского набора (ISD). |
|
Номер телефона
|
phone.number | string |
Последовательность цифр, используемых для голосового взаимодействия с сущностью. Эта последовательность цифр включает код области или код города и внутренний телефонный код. |
|
Отраслевый код
|
primary_sic | string |
Код, определяющий бизнес-активность, в которой занята сущность. |
|
Описание отраслевого кода
|
industrycode.description | string |
Описание соответствующего отраслевого кода. |
|
Сведения о количестве сотрудников (локальный)
|
employees.local | integer |
Общее количество людей, задействованных сущностью для выполнения своих операций. Область этого рисунка сотрудника определяется в informationScopeDescription. |
|
Сведения о количестве сотрудников (всего)
|
employees.global | integer |
Общее количество людей, задействованных сущностью для выполнения своих операций. Область этого рисунка сотрудника определяется в informationScopeDescription. |
|
Финансовый отчет на сегодняшний день
|
financials.todate | date-time |
Дата окончания периода учета. Если код надежности указывает, что цифры проецируются (в будущем), то это дата окончания учетного периода. |
|
Сумма выручки от продаж в USD
|
financials_global.value | integer |
Денежный доход, полученный от клиентов от продажи товаров и/или услуг сущности в долларах США. Это валовые продажи минус любые возвраты, скидки или скидки, пособия по ущербу или нехватке, расходы на доставку, переданные клиенту. |
|
Сумма выручки от продаж в локальной валюте
|
financials_local.value | integer |
Денежный доход, полученный от клиентов от продажи товаров и /или услуг сущности в локальной валюте. Это валовые продажи минус любые возвраты, скидки или скидки, пособия по ущербу или нехватке, расходы на доставку, переданные клиенту. |
|
Код локальной валюты
|
financials_local.currency | string |
Код локальной валюты для этой сущности. |
|
Типы расположений
|
location_types | string |
Список типов расположений для этой сущности с разделителями с запятой. |
|
Индикатор единого расположения
|
is_single_location | boolean |
Указывает, является ли сущность одним расположением или нет. |
|
Родительский номер D-U-N-S
|
parent.duns | string |
Номер D-U-N-S родительской сущности. Родитель является корпорацией, которая владеет более чем 50% акций другой корпорации; эти принадлежащие компании являются дочерними компаниями родительской сущности. |
|
Родительская бизнес-имя
|
parent.name | string |
Бизнес-имя родительской сущности. Родитель является корпорацией, которая владеет более чем 50% капитала другой корпорации. |
|
Внутреннее число D-U-N-S
|
domestic_ultimate.duns | string |
Номер D-U-N-S родительского уровня высшего уровня в корпоративном дереве семьи, который находится в той же стране, что и запрошенная сущность. Родитель является корпорацией, которая владеет более чем 50% капитала другой корпорации. Тема может быть собственной внутренней конечной. |
|
Внутреннее конечное имя
|
domestic_ultimate.name | string |
Имя самого высокого бизнеса в дереве семьи, которое находится в той же стране, что и тема. |
|
Глобальный номер D-U-N-S
|
global_ultimate.duns | string |
Число D-U-N-S самого высокого уровня родителя в корпоративном дереве семьи. Родитель является корпорацией, которая владеет более чем 50% капитала другой корпорации. Тема может быть собственной глобальной конечной. |
|
Глобальное конечное имя
|
global_ultimate.name | string |
Основное имя глобального конечного бизнеса. |
|
Юридическая структура бизнеса
|
entity_type | integer |
Код D&B для соответствующей юридической структуры бизнеса |
|
Описание бизнес-юридической структуры
|
entity_type.description | string |
Название юридической формы или структуры сущности, зарегистрированной в государственных органах (например, партнерство, корпорация, частная ограниченная компания, правительственный департамент, собственность). Уникальный код, назначенный D&B для идентификации юридической формы или структуры сущности, зарегистрированной в государственных органах. |
|
Нелистый индикатор
|
is_delisted | boolean |
Индикатор о том, запрашивает ли сущность, что их данные не будут включены в маркетинговый файл D&B для поиска. |
|
Состояние работы
|
operating_status | integer |
Код D&B для соответствующего состояния операционной системы |
|
Описание состояния работы
|
operating_status.description | string |
Функциональное состояние сущности или состояние торговли (например, активный, вне бизнеса). Уникальный код, назначенный D&B для идентификации функционального состояния или торгового состояния сущности. |