Как бизнесу получать адреса в муниципальном формате
Адреса в России существуют в двух форматах — административно-территориальном и муниципальном.
Первый мы привычно используем для решения бытовых и коммерческих задач: отправить письмо, заказать товар с маркетплейса или построить аналитику продаж по городам.
Второй помогает государству определить место адреса в системе управления. В статье разберем, зачем знать муниципальный формат адреса и как его получить для целей бизнеса.
Зачем бизнесу муниципальный формат адреса
Муниципальный адрес используют государственные организации, поэтому бизнес должен применять его в официальной отчетности. Если указать в отчете административный адрес, госорганы могут попросту не принять документы.
Муниципальное деление понадобится в следующих случаях.
Отчетность по налогам. Если компания подает отчетность в ФНС, например заполняет налоговую декларацию на прибыль, адрес придется писать в муниципальном делении.
Отчетность перед Банком России. Банки обязаны сдавать отчетность о месте нахождения своих банкоматов. Для каждого банкомата указывают адрес в муниципальном делении.
Регистрация кассовых терминалов. В заявлении о регистрации компания обязана указывать адрес установки кассы в муниципальном делении.
Как сразу получать адреса в муниципальном делении
Ситуация: нужны адреса в муниципальном делении, но в компании нет ни единого стандарта хранения адресов, ни даже единой базы. Данные об адресах клиентов хранятся в разных информационных системах (CRM, тикет-системе, бухучете) и имеют разный формат, например по количеству и содержанию полей.
В этом случае, чтобы привести адреса к нужному стандарту, придется вручную искать каждый адрес на сайте налоговой. Это долго и неудобно.
Чтобы сразу получать адреса в муниципальном делении, воспользуйтесь инструментом «Подсказки по адресам» от «Дадаты».
Рассмотрим два сценария, как это сделать.
Если вы раньше не работали с «Подсказками», сначала подключите сервис «Дадаты» к форме ввода адресов. Подробности в инструкции, раздел «Подсказки».
Если уже используете «Подсказки». Передайте разработчику, который отвечает за интеграцию «Подсказок по адресам», что в запросе к API кроме самого адреса нужно также указать параметр division: municipal.
В ответе API появятся новые поля, они начинаются с приписки sub_area (муниципальное поселение). Поля административного деления city_district (административный район города), напротив, исчезнут. А поля area отобразят новый тип деления (административный район региона → муниципальный район).
Если у разработчика появятся вопросы, обращайтесь в службу поддержки.
Как найти муниципальный адрес, если уже знаете административный
Ситуация: в компании большая база адресов в административном формате. Нужно найти способ получить для этих адресов из административного деления муниципальное.
Рассмотрим два варианта, как это сделать автоматически. Выбор будет зависеть от того, храните ли вы вместе с адресом его ФИАС-код.
Если сохраняете ФИАС-коды адресов. В этом случае получить муниципальный формат адресов можно с их помощью:
1. Попросите разработчика написать сервис для поиска адреса по ФИАС-коду. Для этого пригодится API «Дадаты». Оно отдает детальную информацию об адресе — от индекса до квартиры — по ФИАС-коду.
2. Чтобы ответ API содержал элементы муниципального деления (городской округ, муниципальный район), в запросе своего сервиса укажите параметр division: municipal.
3. С помощью сервиса обработайте ФИАС-коды из базы данных и получите адреса в муниципальном формате. Дальше их можно использовать как пожелаете.
Если не сохраняете ФИАС-коды адресов. В этом случае сначала нужно достать из адреса его код:
1. Попросите разработчика написать сервис для поиска ФИАС-кода по административному адресу. С этим поможет наше API «Стандартизация». Оно достает информацию из адреса, например индекс, координаты или код ФИАС (поле fias_id).
2. Прогоните административные адреса через сервис.
3. Из полученной базы адресов отберите те, у которых в ответе API в поле qc стоит значение 0.
Qc, или код проверки, — это один из кодов качества сервисов «Дадаты». Он показывает, насколько точно сервис распознал адрес и нужно ли проверять его дополнительно.
У поля qc бывает несколько значений — от 0 (адрес распознан уверенно) до 3 (есть альтернативные варианты, требуется проверка). Для дальнейшей работы нам понадобятся адреса с кодом проверки qc, равным 0.
4. Возьмите ФИАС-коды выбранных адресов и повторите для них алгоритм из раздела «Если сохраняете ФИАС-коды…».
В результате получите муниципальный формат для адресов, которые «Дадата» распознала уверенно.
Теперь разберемся с адресами, которым требуется дополнительная проверка (qc ≠ 0):
1. Проверьте каждый адрес вручную. Дополните или исправьте, если необходимо.
Например, в Москве есть улица Нагатинская и набережная Нагатинская. Если отправить в API запрос «Москва, Нагатинская, 10», «Дадата» выдаст адрес «Москва, улица Нагатинская, 10». Но при этом и код проверки выставит в 3 — «есть альтернативные варианты».
Если вас устраивает вариант с улицей, что выдал сервис, — оставляйте его. Если нет, хорошая идея — уточнить исходный адрес (добавить, что имелась в виду набережная).
Дальше для дополненных адресов повторите алгоритм из начала раздела «Если не сохраняете ФИАС-коды адресов»:
2. Обработайте адрес через API для поиска ФИАС-кода по адресу. В результате появятся новые адреса с кодом проверки qc: 0.
3. У новых адресов с qc: 0 возьмите ФИАС-код из поля fias_id и обработайте через API «Адрес по коду ФИАС». Чтобы получить адрес в муниципальном формате, в запросе к API укажите параметр division: municipal.
Как проверить, что вы действительно получаете адреса в муниципальном формате
Отправьте код 0f7981e6-65c6-4513-b771-f5db3bfafe60 в сервис поиска адреса по ФИАС-коду, который написал разработчик. В запросе к API вместе с кодом не забудьте указать параметр division: municipal.
Если все работает правильно, в ответе API в поле area_with_type появятся элементы муниципального деления:
