DaData: подключение подсказок и стандартизации данных

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

DaData: подключение подсказок и стандартизации данных

DaData помогает подбирать организации и адреса при вводе, а также обрабатывать готовые адресные строки. Для этого используются две разные функции: «Подсказки» и «Стандартизация».

На некоторых серверах подключение уже предоставлено в составе лицензии TesLab. Собственные ключи настраивает администратор. Если вы используете кабинет своей организации, сначала проверьте его условия: стандартизация оплачивается отдельно от подписки на подсказки.

В этой статье

Подготовить ключи

  1. Откройте личный кабинет DaData своей организации и подтвердите адрес электронной почты.
  2. Получите API-ключ. Если нужна стандартизация, подготовьте также секретный ключ этого же кабинета.
  3. Проверьте доступные услуги, дневной лимит подсказок и баланс для стандартизации.
  4. Подготовьте известную организацию или адрес для небольшой проверки. Массовый импорт для проверки подключения не нужен.

Подсказки могут обращаться к DaData из браузера или через сервер TesLab. Поэтому три поля в конфигурации имеют разные назначения:

Поле TesLabДля чего используется
«Публичный API-ключ DaData»Подсказки с прямым обращением из приложения, например при выборе адреса в КЛАДР.
«API-ключ DaData»Серверные подсказки, например в форме контрагента, и серверная стандартизация.
«Секрет DaData»Дополнительный ключ для серверной стандартизации. Подсказкам он не требуется.

Если обе функции подключены к одному кабинету, один API-ключ можно указать в двух полях API-ключа. В поле «Секрет DaData» введите отдельный секрет этого же кабинета. Публичный ключ доступен приложению для прямых запросов. Секрет в публичное поле не вставляйте.

Подключить свой кабинет

  1. Проверьте, что вошли администратором на нужный сервер.
  2. В группе «Компания» откройте «Конфигурация», вкладку «TesLab» и панель «Внешние сервисы».
  3. Введите ключ в нужное поле. Завершите ввод и перейдите в другое поле.
  4. Дождитесь сообщения «Ключи сохранены». Затем заполните следующее необходимое поле.
  5. Нажмите «Обновить» в блоке ключей и проверьте сохранённое состояние.
Три поля подключения DaData
1: публичный ключ прямых подсказок. 2: серверный API-ключ. 3: секрет для стандартизации.

Публичный ключ остаётся видимым. Серверный API-ключ и секрет после записи показываются пустыми полями с подсказкой «сохранён · введите новый, чтобы заменить». Повторно вводить их при обычном просмотре не нужно.

Сохранение подтверждает запись настройки, но не проверяет ключ во внешнем сервисе. Если блок предлагает обновить сервер и не даёт редактировать поля, обратитесь к ответственному за обновление TesLab.

Заменить или удалить сохранённое значение

  1. Для замены введите новый ключ или секрет и перейдите в другое поле. Не вставляйте маску сохранённого значения.
  2. Дождитесь подтверждения сохранения. При смене кабинета замените и серверный API-ключ, и секрет до проверки стандартизации.
  3. Для удаления закрытого значения нажмите крестик у соответствующего поля и подтвердите «Удалить». Публичный ключ удаляется очисткой его поля.
  4. Нажмите «Обновить» и проверьте результат.
Признак сохранённого ключа и кнопка его удаления
1: признак сохранённого значения. 2: удаление собственного серверного API-ключа. У секрета есть такая же кнопка.

Удаление собственного значения не обязательно отключает DaData: сервер может использовать ключи из лицензии или своей конфигурации. Если нужно полностью прекратить обращение к сервису, согласуйте это с ответственным за сервер.

Если результат не подтверждён или ключ изменил другой администратор, не повторяйте запись вслепую. Нажмите «Обновить», проверьте фактическое состояние и только затем повторите нужное изменение. До подтверждения не запускайте рабочую обработку.

Проверить подсказки

  1. Дождитесь сохранения и обновления конфигурации. Заново откройте проверочную форму.
  2. Для проверки серверных подсказок откройте добавление контрагента и начните вводить известное название или ИНН организации.
  3. Для проверки прямых адресных подсказок откройте добавление обычного российского адреса в КЛАДР и начните вводить известный адрес.
  4. Дождитесь вариантов, выберите подходящий и сверьте реквизиты или адрес.
  5. Если цель только проверка подключения, закройте несохранённую форму.

Работа подсказок в одной форме не подтверждает работу другого канала или стандартизации. Выбор внешних сведений также не назначает роль организации в TesLab. Для рабочего добавления используйте инструкцию по добавлению контрагента.

Проверить стандартизацию

  1. Проверьте сохранение серверного API-ключа и секрета одного кабинета.
  2. Убедитесь, что с сервера доступен сервис DaData и в кабинете есть средства для обработки.
  3. В согласованной операции импорта запросов проверьте одну адресную строку, для которой ожидается распознавание. Проверка стандартизации может расходовать средства кабинета.
  4. Сверьте распознанный адрес и результат операции. Успешные подсказки сами по себе этого не подтверждают.

Начинайте новую проверочную операцию после изменения ключей. Уже выполняющийся импорт может продолжать использовать прежнюю пару до завершения. Если адрес распознан неверно, проверьте исходную строку: замена ключа не исправляет содержание адреса.

Разобрать отказ сервиса

  • Нет вариантов без сообщения об ошибке. Уточните запрос и поддерживаемый вид поиска. Проверьте подключение для этой формы: публичный ключ для прямых подсказок или серверный API-ключ для серверных.
  • DaData отклонила подсказки. Проверьте API-ключ, подтверждение почты и дневной лимит кабинета. Причины приведены в официальном разборе отказа подсказок.
  • DaData отклонила стандартизацию. Проверьте серверную пару, подтверждение почты и баланс отдельной услуги. Используйте разбор отказа стандартизации.
  • Ограничена частота запросов. Подождите и повторите небольшую проверку.
  • Сервис не ответил. Проверьте связь с DaData со стороны браузера или сервера, в зависимости от формы.

При сохранении ошибки передайте ответственному название формы или операции, время и сообщение. Ключи и секреты в обращение не включайте.

Официальные материалы DaData