[Пошаговая инструкция] Как с помощью API «Стандартизации» понять, что по адресу доедут курьеры и посылки

Для статьи мы выбрали популярную задачу: проверить адреса в готовой базе и понять, какие из них подходят для курьеров и посылок. Условия два: адрес указан до дома или квартиры и существует. То есть «Г. Москва» не подойдет, а вот «Москва, Сухонская, д. 5, кв. 3» — вполне.

Чтобы проверить адреса, мы прогоним их через API «Стандартизации» «Дадаты». Для каждого адреса сервис вернет четыре кода качества. С их помощью мы последовательно выберем полные и существующие адреса, которые подходят для посылок и курьеров.

Коды качества в ответе API «Стандартизации» по адресу «г. Москва, ул. Сухонская, д. 11, кв. 89»

1. Устранить адреса, которые «Стандартизация» разобрала неуверенно

«Стандартизация» разбирает адреса — приводит их к единому формату и исправляет ошибки:

Бывает, что уверенно распознать адрес у сервиса не получается: в исходных данных много ошибок или недостаточно информации.

Человек ввел «мск суская». Это может быть и «Сухонская», и «Сумская».

Отсечь адреса, в которых «Стандартизация» сомневается,  поможет специальный код проверки. API возвращает этот код в поле qc

Код проверки не гарантирует, что адрес существует. Сервис лишь формально проверяет, похожи ли данные на настоящий адрес.

Адрес «республика Саха, Москва, Питер» не похож на настоящий, а вот «Москва, ул Пушкина-Колотушкина, д. 4» — вполне. 

Когда с кодом проверки qc проблема, проверять остальные три бессмысленно: с адресом точно что-то не так. Если с qc порядок, но нужна уверенность в существовании адреса, проверяют и другие коды качества.

Кода проверки qc хватит, если нужно лишь привести адреса в базе к одному формату и исправить ошибки. При этом предполагается, что для пользователя не важно, существуют ли адреса.

Код проверки 0 — «Стандартизация» уверенно распознала адрес. Точность — не ниже, чем 1 ошибка на 10 000 проверок. Если qc = 0, можно проверять адрес по другим, более строгим, кодам качества.

1 — в адресе остались лишние части, либо данных недостаточно для уверенного разбора. 

Человек в поле адреса ввел «109341 Тверская область Москва Верхние Поля 15, 5». Улица Верхние Поля находится в Москве. А вот Москва в Тверской области не находится.

Или же ввел «Пушкина 13, д. 4» без города и региона. Таких адресов много по России: в Москве, Санкт-Петербурге, Иркутске, Энгельсе и т.д.

В этом случае полезно уточнить адрес у клиента и еще раз прогнать через «Стандартизацию»

2 — адрес пустой или заведомо мусорный, их мы исключим. 

Человек ничего не ввел в поле адреса или заполнил набором букв «eomwmv».

3 — у адреса есть альтернативные варианты. Чтобы уточнить, придется позвонить клиенту. 

Человек ввел «Москва Тверская-Ямская». В Москве четыре Тверских-Ямских улицы. Непонятно, какую именно имели в виду.

Qc = 0 — «Стандартизация» уверенно распознала адрес «г. Москва, ул. Сухонская, д. 11, кв. 89». Переходим к следующим этапам проверки

2. Проверить адреса на полноту, отсечь неполные

Итак, мы оставили в списке уверенно распознанные адреса — с кодом проверки qc = 0. Следующий шаг — проверить адреса на полноту.

Отсечь адреса без региона, города, улицы, дома или квартиры поможет код пригодности к рассылке. API «Стандартизации» возвращает его в поле qc_complete

Этот код тоже не гарантирует, что адрес существует. Здесь «Дадата» формально проверяет, насколько адрес полный. Существование же адреса мы проверим позже, по другим кодами качества.

Адрес «г. Москва, ул. Сухонская» формально неполный: не хватает дома и квартиры. А вот «г. Несуществуюск, ул. Отсутствующая, д. 4, кв. 3» выглядит формально полным.

Код пригодности 0 или 10 — адрес заполнили с точностью до квартиры. Например, «г. Москва, ул. Сухонская, д. 5, кв. 1». В теории курьер доедет по такому адресу, точно выясним на следующем шаге.

5 — адрес заполнили с точностью до дома. Такие адреса бывают у частных домов и юрлиц. Если доставляете товары в частный сектор или отправляете документы контрагентам, оставляйте такие адреса и проверяйте по следующим кодам качества. Если доставляете только по Москве, надежней отбирать адреса с точностью до квартиры. 

1—4, 6 — адрес неполный: нет города, региона, улицы или дома. Курьер не доедет по неполному адресу, придется позвонить клиенту и уточнить.  

7 — иностранный адрес. «Стандартизация» разбирает иностранные адреса на части, но не проверяет на действительность. Если окажется, что разобранного адреса не существует, посылка не дойдет. Поэтому, прежде чем отправить посылку, лучше поискать адрес на карте.

Qc_comlete = 0. Адрес «г. Москва, ул. Сухонская, д. 11, кв. 89» полный, пора проверять его на действительность

3. Отделить существующие адреса от подозрительных

Порой люди вводят адреса, которых не существует.

Покупатель ввел «Мск Пупкинская 16, кв. 1». Адрес полный, «Стандартизация» уверенно его разобрала. Но отправлять курьера сюда нельзя: нет такого адреса.

Проверить адреса и выбрать из них существующие поможет код наличия дома в справочнике ФИАС. Этот код показывает, включен ли дом в базу адресов ФНС — самую полную в России.

Чтобы сигнализировать, найден ли дом в ФИАС, API «Стандартизации» использует поле qc_house.

Код наличия дома в ФИАС равен 2 — дом есть в ФИАС. Если и с предыдущими кодами качества все в порядке, пора заканчивать проверку и отправлять курьера. Вы можете подумать: «А зачем вообще смотреть на другие коды, если есть такой строгий qc_house? Проверяем только его, и дело с концом». Увы, так делать опасно.

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

Или в адресе могут остаться лишние части. Например, в адресе «Тверская область, Москва, Верхние Поля, 5» кодом qc «Стандартизация» отметит лишнюю Тверскую область. А затем проверит «Москва, Верхние Поля, 5» и констатирует, что дом есть в ФИАС. Но вдруг клиент ошибся и на самом деле живет в Тверской области? Если смотреть только на qc_house, игнорируя qc, упустишь возможную ошибку.

Код наличия дома 10 — дома нет в ФИАС. Это подозрительно, но пока ни о чем не говорит: в ФИАС действительно не хватает изрядной части адресов. Уточним действительность адреса в следующем разделе.

Qc_house = 2. Дом 11 на улице Сухонской в Москве есть в ФИАС. Курьер доставит заказ

4. Проверить подозрительные адреса на действительность, отсечь несуществующие

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

Поэтому мы ищем адреса, которых нет в ФИАС, на картах «Яндекса» и «2Гиса». На картах тоже бывают ошибки, но более точного способа проверить адреса нет.

Адреса, которых нет в справочнике налоговой, присылают нам в поддержку. Мы перепроверяем их вручную по картам, добавляем в «Дадату» и привязываем координаты.

Результат проверки по картам API «Стандартизации» показывает в коде точности координат — поле qc_geo

Код точности координат 0 — дом есть на картах. Курьера можно отправлять.

1 — дома нет в ФИАС, но есть похожий на картах. Скорее всего, курьера можно отправлять, но безопасней позвонить клиенту и все прояснить.

Обычно так происходит с «литерными» домами.

Человек ввёл «Ставрополь, ул. Мира, д.3». Такого в ФИАС нет, зато на картах есть «…д.3, корпус 1». Наверняка это один и тот же дом. 

≥2 — дома нет в ФИАС и на картах. Скорее всего, дома не существует. Адрес можно дополнительно проверить на картах и отсеять, если дома там нет.

Qc_geo = 0. Дома нет в ФИАС, но есть на картах. Курьер довезет заказ

Смело отправляйте курьера по адресу в 2 случаях

1. «Стандартизация» однозначно распознала адрес, он полный, а дом есть в ФИАС.

  • qc = 0,
  • qc_complete = 0 (или 5: для частных владений или юрлиц),
  • qc_house = 2.

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

  • qc = 0,
  • qc_complete = 10, (или 5: для частных владений или юрлиц),
  • qc_house = 10,
  • qc_geo = 0.

Блог DaData.ru — пишем о клиентских данных, делимся новостями и кейсами

Подпишитесь на рассылку, чтобы не пропустить новые статьи в блоге
Узнавайте о новых статьях, как только они выйдут

Статьи по теме

[Пошаговая инструкция] Как с помощью API «Стандартизации» понять, что по адресу доедут курьеры и посылки

Основы

[Пошаговая инструкция] Как с помощью API «Стандартизации» понять, что по адресу доедут курьеры и посылки

Для статьи мы выбрали популярную задачу: проверить адреса в готовой базе и понять, какие из них подходят для курьеров и посылок. Условия два: адрес указан до дома или квартиры и существует. То есть «Г. Москва» не подойдет, а вот «Москва, Сухонская, д. 5, кв. 3» — вполне.

КПП организации. Где его найти и как использовать

Основы

КПП организации. Где его найти и как использовать

КПП — код причины постановки на учет в налоговую. Его выдают только юрлицам, у ИП такого реквизита нет. КПП помогает отличить филиал от головной организации, оценить риски от работы с контрагентом и дает документам юридическую силу. Давайте разбираться по порядку.

Новинки «Дадаты» в марте

Основы

Новинки «Дадаты» в марте

Теперь жители Московской области правильно заполняют адрес, даже если в ФИАС его больше нет, клиенты «Дадаты» оперативно узнаю́т о новостях, а партнеры получают 30% нашей выручки.

Что быстро проверить у контрагента, чтобы не нарваться на мошенника

Основы

Что быстро проверить у контрагента, чтобы не нарваться на мошенника

Сложность проверки в том, что информацию о партнере собирают из множества источников: ЕГРЮЛ, сервиса проверки массовых адресов ФНС, реестра дисквалифицированных лиц, федерального реестра сведений о банкротстве, реестра субъектов малого и среднего предпринимательства и тд. Банки даже организуют для этого специальные отделы. Быстро проверить контрагента поможет наш API-метод «Организация по ИНН или ОГРН». Компании посылают запрос на API «Дадаты», а в ответ получают 200 строк информации о партнере. Мы выбрали те реквизиты, на которые полезно обратить внимание.Эти же данные можно получить вручную из открытых справочников, но с «Дадатой» быстрее. Код ОКВЭД Код ОКВЭД обозначает вид деятельности, на которую организация имеет право. Юрлица вносят код в заявление о регистрации. Налоговая штрафует организации, если они занимаются видами деятельности, которые не указали в заявлении.