+30
На рассмотрении

Быть в курсе изменений

Антон Жиянов 5 лет назад обновлен 1 месяц назад 128

Чтобы не пропустить изменения в сервисах «Дадаты», подписывайтесь на эту тему и получайте новости по электронной почте.

Добавили в Стандартизацию по адресам поле «федеральный округ» (federal_district). Пока оно не заполняется, но очень скоро начнёт ツ

В подсказках и стандартизации по адресам добавили новое поле — федеральный округ. Его удобно использовать для маркетинговой сегментации клиентов (федеральных округов всего 8, а регионов аж 85).

Раньше API Стандартизации возвращало HTTP-код ответа 402, если закончились деньги на балансе. Теперь возвращает 403 Forbidden. См. также: все возможные коды ответа.

Подключили реестр малых и средних предприятий (МСП) налоговой службы. Теперь можно «пробить» контрагента по реестру и понять, к какому типу он относится: микро-, малое или среднее предприятие. Это покажет уровень оборотов фирмы и количество сотрудников в организации.

Сведения возвращаются только на тарифном плане «Максимальный».

В период с 19:28 до 19:30 МСК начались сетевые проблемы, «Дадата» частично переключена на резервный контур. Все сервисы работают.

Город и страна телефона

Раньше «Дадата» знала часовой пояс только для российских телефонов. А теперь возвращает в API Стандартизации часовой пояс, страну и город для телефонов по всему миру.

Страна определяется для всех номеров, а город — только для стационарных. Часовой пояс определяется по стране, так что если у страны их несколько — возвращается минимальный и максимальный через слеш. Например, для Австралии: «UTC+8/UTC+11».

Название региона для стационарных телефонов

Для стационарных телефонов в России область (поле region) теперь возвращается вместе с типом:

  • не «Самарская», а «Самарская область»;
  • не «Карелия», а «Республика Карелия».

У «Дадаты» добавился ещё один IP-адрес: 185.178.208.144. Вам в связи с этим ничего делать не требуется ツ 


Единственное исключение — если вы специально настраивали «белые списки» IP-адресов, в которые может резолвиться домен dadata.ru и его поддомены (если не уверены — уточните у сетевого администратора). Тогда добавьте 185.178.208.144 в белый список.

И ещё один IP-адрес добавили: 186.2.163.83. Если используете «белые списки», пропишите его у себя.

Простите, что зачастили с этими IP-адресами. Больше не планируем пока ツ

Добавили пару новых возможностей: (1) идентификатор города в Boxberry и DPD и (2) город банка для платёжки.

Идентификатор города в Boxberry и DPD

Службы доставки часто используют собственные идентификаторы городов, и требуют от магазина указывать их в заказе. Поэтому «Дадата» умеет определять идентификатор города в службе доставке на основании КЛАДР-кода города. Раньше поддерживалась только служба доставки СДЭК, а теперь добавили ещё Boxberry и DPD:

Доступно для всех тарифов, работает через API и в браузере.

Город банка для платёжки

В платёжных поручениях кроме наименования указывают и город банка. В большинстве случаев он совпадает с городом адреса банка, но не всегда. Например, Главное управление Банка России по ЦФО находится в Москве, но город для платёжки у него содержит номерную часть — «г. Москва 35». Раньше подсказки по банкам это игнорировали, а теперь возвращают платёжный город в специальном поле payment_city.

Количество сотрудников, система налогообложения и дисквалифицированный руководитель

В подсказки по компаниям добавили поля, которые помогут со скорингом и маркетинговой сегментацией контрагентов:

  • среднесписочная численность работников;
  • система налогообложения (УСН, ЕСХН, ЕНВД, СРП);
  • доходы и расходы по данным бухгалтерской отчетности;
  • недоимки по налогам;
  • налоговые штрафы;
  • наличие дисквалифицированных лиц в составе исполнительных органов организации.

Доходы, расходы, долги и штрафы актуальны на на 31 декабря 2017 года (это самые новые данные от налоговой). Количество сотрудников и система налогообложения — на 31 декабря 2018 года. Наличие дисквалифицированных лиц актуализируется еженедельно.

Численность сотрудников и система налогообложения доступны на тарифе «Расширенный» и выше, остальные поля — только «Максимальный».

ISO-коды стран и регионов

В России в качестве идентификатора адреса принято использовать КЛАДР- или ФИАС-код. В мире же более распространены ISO-коды. Они заданы стандартом ISO 3166 для стран и регионов в странах.

Теперь «Дадата» умеет возвращать эти ISO-коды:

ISO-код пригодится, если вы хотите интегрировать «подсказки» или «стандартизацию» с программами и сервисами, которые ожидают ISO-коды.

Сегодня не работает телефон — проблемы у нашего оператора. Все вопросы принимаем в службе поддержки.

Изменения в работе с DaData.ru

В сентябре мы внесем в «Дадату» изменения, чтобы укрепить защиту от внешних атак. Возможно, эти изменения потребуют реакции с вашей стороны.

Если в вашей компании за работу «Дадаты» отвечает кто-то другой, пожалуйста, перешлите ему это письмо. Подойдет любой айтишник: программист или системный администратор.

По ссылкам — суть изменений и действия, которые могут потребоваться:

Если что-то непонятно, задайте вопрос в службу поддержки — поможем разобраться.

С 27 августа налоговая перестала выгружать данные по организациям — у них что-то сломалось. Ждём, пока починят 🤷‍♂️

Налоговая возобновила выгрузку организаций, так что и в «Дадате» они снова обновляются 👌

У части пользователей могут наблюдаться проблемы со Стандартизацией и обогащением Подсказок. Уже чиним.

Проблема со стандартизацией наблюдалась в 7:44–7:45. Проблема с отсутствием квартир и координат в подсказках наблюдалась у небольшого числа пользователей с 7:45 до 8:20 и с 8:50 до 9:00. После 9:00 проблем нет.

Страна в виджете подсказок

В виджете подсказок теперь можно включить ограничение по ISO-коду страны, а также использовать страну в гранулярных подсказках.

Поиск до дома в сервисе «Адрес по ФИАС-коду»

Раньше адрес по ФИАС-коду искался только до улицы включительно, а по коду дома возвращался пустой ответ. Так было сделано намеренно: ФИАС-коды домов иногда изменяются, поэтому хранить их ненадежно.

Но получалось, что если у человека из всей информации об адресе есть только ФИАС-код дома, то восстановить адрес не получится. Поэтому мы включили поиск до дома:

{"query": "5ee84ac0-eb9a-4b42-b814-2f5f7c27c255"}
↓ ↓ ↓
{
  "suggestions": [
    {
      "value": "г Москва, ул Сухонская, д 11",
      "unrestricted_value": "г Москва, р-н Северное Медведково, ул Сухонская, д 11",
      "data": { ... }
    }
  ]
}

Метод по-прежнему ищет только по актуальным ФИАС-кодам. Поэтому мы рекомендуем помимо ФИАС-кода дома сохранять адрес одной строкой — иначе не получится восстановить адрес, когда ФИАС-код изменится.

Статус «ликвидирован» в банках

Банк России пишет статус банка на сайте, но не выгружает его в открытых данных. Поэтому «Подсказкам» приходится выводить его по косвенным признакам.

Раньше статус «ликвидирован» устанавливался в том случае, если принято решение о ликвидации банка — даже если дата окончательной ликвидации находится в будущем. Это похоже на то, что ЦБ пишет на сайте, но оказалось неудобно для клиентов — ведь безналичный перевод в такие банки разрешён (пока не наступила дата окончательной ликвидации).

Поэтому теперь такие банки и филиалы получают статус «ликвидируется» (state.status = LIQUIDATING), а в поле «дата ликвидации» (state.liquidation_date) пишется будущая дата окончательной ликвидации.

Поскольку Банк России удаляет банк из справочника сразу после даты окончательной ликвидации, шансы встретить в подсказках статус «Ликвидирован» теперь примерно равны нулю.

Давно ликвидированные компании

Обязательный срок хранения большинства данных о контрагентах не превышает 5 лет. Поэтому мы подумываем убрать из «подсказок» все организации, ликвидированные более 5 лет назад. Если у вас есть бизнес-задача, для которой требуются давно ликвидированные компании — дайте знать.

-1

В ФИАС от 14 октября Кемеровскую область переименовали в «Кемеровская область - Кузбасс». Мы пока зафиксировали справочник адресов на предыдущей версии и анализируем возможные последствия.

Загрузили ФИАС с Кузбассом («Кемеровская обл» → «Кемеровская область - Кузбасс»).

+2

Почтовый индекс в unrestricted_value

В ближайшем обновлении «Дадаты» (на этой неделе) в поле data.unrestricted_value у адресов появится индекс. Пишем заранее, чтобы это не стало неожиданностью.

Было:

unrestricted_value = г Москва, р-н Северное Медведково, ул Сухонская, д 11

Стало:

unrestricted_value = 127642, г Москва, р-н Северное Медведково, ул Сухонская, д 11

Значение с индексом лучше соответствует семантике поля (полный адрес одной строкой) и позволит различать улицы с одинаковым названием в пределах одного города (например, улица 8 марта в Москве).

Пара новых возможностей в «Подсказках» по компаниям:

Совмещённые налоговые режимы

У одной компании может одновременно использоваться два налоговых режима: УСН + ЕНВД или ЕНВД + ЕСХН. Теперь для таких случаев «Подсказки» вернут в поле tax_system значение USN_ENVD или ENVD_ESHN соответственно.

Поиск организаций по имени руководителя

Для некоторых компаний в ЕГРЮЛ указан не только генеральный директор, но и другие ключевые лица: например, заместитель директора или главный бухгалтер. Раньше «Подсказки» искали только по ФИО первого из руководителей, указанных в выписке. Теперь поиск работает по всем менеджерам.

Сломались Подсказки по международным адресам. Уже знаем о проблеме, планируем починить завтра. 

C 5:00 по Москве международные подсказки работают в полную силу. Проследим, чтобы в дальнейшем сбой не повторялся.

С 16:31 до 16:34 по Москве были перебои с доступностью сервисов, сейчас всё в норме.

Ближайшее почтовое отделение

Если интернет-магазин доставляет покупки почтой по России, хорошо бы подсказать человеку, где и когда он может забрать посылку. В этом поможет новый справочник почтовых отделений «Дадаты» — в нём есть точный адрес, координаты и часы работы отделения, а ещё отметка, если оно временно закрыто.

Получить информацию о почтовом отделении можно по индексу, или найти ближайшее отделение по координатам.

«Респ» с прописной буквы

Раньше «Подсказки» возвращали тип региона (поля region_type, region_with_type) в нижнем регистре («респ», «обл»). Это вызывало недоумение у пользователей, которые ожидают, что тип будет в точности соответствовать ФИАС. Поэтому теперь тип региона возвращается так, как он записан в справочнике налоговой («Респ», «обл»). Полный тип региона (region_type_full) по-прежнему возвращается в нижнем регистре.

region_with_type: "Респ Башкортостан"
region_type: "Респ"
region_type_full: "республика"

Изменение начнёт действовать с субботы 25 января.

Ограничение по ISO-коду региона

Если подключены подсказки по всем странам мира, а не только по России, то удобно использовать ISO-коды, чтобы сузить область поиска. Раньше «Подсказки» понимали только код страны, а теперь можно ограничить и регион.

Работает в плагине (версия 20.1+):

$el.suggestions({
    token: "***",
    type: "ADDRESS",
    constraints: {
        locations: {
            country_iso_code: "BY",
            region_iso_code: "BY-BR"
        }
    }
});

И через API:

{
    "query": "бр", 
    "locations": [
        {
            "country_iso_code": "BY",
            "region_iso_code": "BY-BR"
        }
    ]
}

Владение и домовладение как синонимы

В ФИАС есть некоторая путаница с домами, владениями и домовладениями. Большинство домов записаны просто как «дом», но иногда дом значится как «владение» или «домовладение». Конечно, люди не хотят вникать в такие нюансы, и обычно пишут свой адрес как «дом».

Раньше «Подсказки» строго ориентировались на ФИАС, и не находили «владение 4», если человек искал его как «дом 4». Теперь это исправили — приняли «дом», «владение» и «домовладение» за синонимы:

Сегодня с 11:07 до 11:17 наблюдались проблемы с «Подсказками» у части пользователей. Сейчас всё в порядке, «Подсказки» работают в штатном режиме. 

С 12-10 наблюдаются проблемы у части пользователей, решаем. 

С 12-38 Подсказки в порядке. 

+2

Открытые данные

В основном «Дадата» работает как сервис и не предоставляет исходные справочники. Но некоторые данные мы решили открыть — их можно свободно скачивать и использовать. Вот они:

  • Города России. Список городов из Википедии, дополненный полезными сведениями: КЛАДР- и ФИАС-коды, ОКАТО, ОКТМО, часовой пояс, координаты.
  • Регионы России. Список регионов из ФИАС, дополненный полезными сведениями: федеральный округ, ISO-код, часовой пояс.
  • Типы адресов в ФИАС. Содержимое таблицы SOCRBASE из ФИАС, чтобы не приходилось качать оригинальный многогигабайтный справочник.
  • Кем выдан паспорт. Самый полный список кодов подразделений и соответствующих им названий в творительном падеже.

Новый модуль для Vue.js

Появился новый модуль «Подсказок» для одного из самых популярных фронтенд-фреймворков — Vue.js. В отличие от старого модуля, он поддерживает все справочники «Дадаты» и более удобен в настройке.

Модуль сделан и поддерживается сторонним разработчиком.

Обновили оферту, изменения в пунктах 6.2 и 6.4.

Интеграция с PrestaShop 1.7

Нас часто спрашивали об интеграции «Подсказок» с современной версией движка интернет-магазинов PrestaShop. Теперь такая интеграция наконец появилась, подключить её можно в магазине дополнений PrestaShop.

Модуль сделан и поддерживается сторонним разработчиком.

Определить ИНН по паспортным данным человека

В поддержку «Дадаты» часто обращаются с вопросом «как получить ИНН по паспортным данным». Налоговая служба предоставляет такой сервис, но без API.

В интернете есть несколько сайтов, которые предоставляют сервис «узнать ИНН» через API. Насколько нам известно, все они используют «неофициальный» интерфейс взаимодействия с налоговой, потому что ни официального API, ни открытых данных по ИНН не существует.

Мы в «Дадате» не хотим подключать неофициальное API налоговой: оно не отличается стабильностью работы и имеет непонятные перспективы. Если вы очень хотите получать ИНН через API — вызывайте API налоговой напрямую. Мы подготовили примеры, как это сделать на самых популярных языках — Python, PHP и JavaScript.

API налоговой бесплатное, но используете его вы на свой страх и риск.

Примеры кода для определения ИНН по паспортным данным

+1

Марки автомобилей

Добавили «подсказки» по маркам автомобилей. Понимают оригинальные названия (Hyundai) и кириллицу (Хендай). Работают через виджет и API — удобно встроить как на сайт, так и в мобильное приложение.

Как обычно, бесплатно до 10 тыс. запросов в день, больше — в составе годовой подписки.

Станции метро

Добавили «подсказки» по станциям метро. Знают о метро в семи городах России (Москва, Санкт-Петербург, Казань, Нижний Новгород, Новосибирск, Самара и Екатеринбург), подскажут название станции, координаты, ветку метро и даже её цвет.

Работают через виджет и API. Бесплатно до 10 тыс. запросов в день, больше — в составе годовой подписки.

+1

Остановили обновление ФИАС

В январе-феврале налоговая служба не обновляла свой справочник адресов (ФИАС). В марте начались обновления, но что-то пошло не так: в справочнике нарушена ссылочная целостность, а часть адресов «потеряла» уровни. Пока налоговая продолжает выкладывать «битые» справочники, мы остановили обновление ФИАС.

«Дадата» работает на последней стабильной версии ФИАС — от 26.12.2019.

Возобновим обновление после того, как будет беспроблемная версия справочника. Напишем об этом отдельно.

Личные, корпоративные и ролевые адреса эл. почты

Адрес эл. почты может быть личным (vika2020@yandex.ru, serega.ivnv@mail.ru) или корпоративным (sergey.ivanov@myshop.ru). Для маркетолога ценность личного адреса выше — работу человек может сменить, а персональная почта остаётся долгие годы.

Хуже корпоративной почты только «ролевая» корпоративная почта (info@mysite.ru, sales@mycompany.ru) — на такие адреса часто лучше вообще ничего не отправлять.

Раньше «Дадата» сваливала эти три категории емейлов (личные, корпоративные и ролевые) в одну кучу. Теперь научилась разделять — в поле «тип емейла» (type):

  • PERSONAL — личный ящик на mail.ru, yandex.ru и аналогичных;
  • CORPORATE — корпоративный ящик;
  • ROLE — ролевой корпоративный ящик;
  • DISPOSABLE — одноразовый ящик.

Конечно, такая классификация может давать огрехи. Например, небольшие компании иногда заводят ролевой ящик, который выглядит как личный (mylovelyflower@mail.ru), а некоторые люди заводят личный ящик на отдельном домене (sergey@ivanov.ru). Такие ситуации «Дадата» не распознает, но более типичные случаи отнесёт к нужной категории.

Заодно добавили отдельные поля для домена и локальной части эл. почты:

  • домен (domain): vika2020@yandex.ru → yandex.ru
  • локальная часть (local): vika2020@yandex.ru → vika2020

Классификация email доступна через API стандартизации. В «подсказках» — нет.

Подсказки по ФИАС

Чтобы помочь человеку ввести адрес, прекрасно подходят «подсказки» по адресам. Они используют справочник налоговой (ФИАС), но стараются сглаживать существующие в нём нелогичности и несоответствия здравому смыслу.

Но в некоторых случаях требуется точное, побуквенное соответствие ФИАС. Специально для таких ситуаций мы добавили новый сервис подсказок по ФИАС


Сервис возвращает адреса в точности как они представлены у налоговой:

  • уровни, как в ФИАС, включая планировочные структуры;
  • литеры в СПб, нулевые дома;
  • здания и гаражи.

Дополнительные сведения — станции метро, координаты, ближайшие метро, квартиры и прочие данные, которых нет в ФИАС — не возвращаются.

Поскольку теперь есть «строгие» подсказки по ФИАС, с апреля мы продолжим улучшать подсказки по адресам: исправлять огрехи данных налоговой и делать их ближе к реальной жизни. Подсказки же по ФИАС навсегда останутся такими, как в налоговой.

ФИАС в 2020 году

Налоговая не спешит исправлять проблемы в ФИАС. Тем временем, с первого апреля начал действовать новый справочник ОКТМО, и часть кодов теперь не «бьётся» с ФИАС 2019 года.

Поэтому мы решили подключить ФИАС 2020 года, несмотря на его проблемы. До конца апреля обновим, напишем об этом отдельно.

Подсказки по адресам латиницей

«Подсказки» стали по-настоящему международными — теперь они умеют искать по адресам латиницей (samara metallurgov) и возвращать адреса в таком же виде (Russia, gorod Samara, prospekt Metallurgov). Пригодится интернет-магазинам и сервисам, которые принимают и доставляют заказы по всему миру.

Английский язык включается параметром language = en. Работает в виджете (версия 20.3+) и через API.

ИНН и КПП банка

Поскольку банки зарегистрированы в налоговой службе как обычные организации, у них есть ИНН и КПП — как у всех организаций. Раньше «подсказки» по банкам их не сообщали, а теперь научились:


Благодаря этому карточку банка в приложениях и сервисах можно заводить «в один заход», без необходимости дополнительно искать в ЕГРЮЛ. Всё, что для этого требуется — интегрироваться с «Дадатой».

Заодно научили «Дадату» искать банки и филиалы по ИНН / КПП через API.

+1

ФИАС в 2020 году, продолжение

Всё уже было готово к подключению свежего ФИАС, как вдруг налоговая потеряла Краснодарский край (справочник от 31.03). В свежайшей версии (от 13.04) край вернулся, но не полностью.

Пока подключили ФИАС от 23.03. Надеемся, что проблемы с Краснодаром налоговая всё же решит — после этого подключим актуальный справочник.

Есть один нюанс. В всех ФИАС 2020 года не заполняется поле «признак центра района или региона» (capital_marker). «Дадата» использует это поле для форматирования адреса одной строкой:

  • не пишет название области для областного центра («Нижний Новгород», а не «Нижегородская обл, г Нижний Новгород»);
  • не пишет название района для районного центра («Нижегородская обл, г Кстово», а не «Нижегородская обл, Кстовский р-н, г Кстово»).

К сожалению, с исчезновением capital_marker перестала работать и эта логика. Теперь в адресе одной строкой будет полное название — с регионом и районом.

Поиск аффилированных компаний

Часто учредитель или директор не ограничивается участием в одном юрлице, а фигурирует в нескольких. Порой — в десятках разных компаний. Знать об этом полезно как для оценки надёжности контрагента, так и для более эффективного маркетинга и продаж. Чтобы облегчить поиск аффилированных компаний, «Дадата» научилась искать организации по ИНН учредителей и руководителей.

ИНН: 7736207543
↓ ↓ ↓
ООО «ЯНДЕКС.ДРАЙВ»
ООО «ЯНДЕКС.ЗАПРАВКИ»
ООО «ЯНДЕКС.ОБЛАКО»
ООО «ЯНДЕКС.ОФД»
ООО «ЯНДЕКС.ПРОБКИ
...

Работает через специальный API-метод findAffiliated. Бесплатно до 10 тысяч запросов в день, больше — в составе годовой подписки.

Сервис поддержки клиентов работает на платформе UserEcho