как правильно заполнить адрес по кладру

Что такое КЛАДР: ответы на самые популярные вопросы

Деятельность в коммерческой, налоговой, государственной сфере связана с работой с большим количеством юридических адресов. Тут важно не только их быстро найти, но и правильно указать. В этом помогает классификатор адресов России КЛАДР. Подробно поговорим о том, что это такое, разберем особенности, рассмотрим, как пользоваться КЛАДР, в чем он может быть полезен.

Что такое КЛАДР?

Какова структура классификатора?

Что такое КЛАДР? Это объекты, разделенные на шесть уровней:

Как выглядит КЛАДР?

Можно выделить шесть разновидностей данных файлов:

Кодовые обозначения классификатора

Чтобы использовать КЛАДР адресов, необходимо различать его кодовые обозначения.

Структура из файлов типа Kladr.dbf представлена так: 11 222 333 444 55. Разберем ее:

Структура обозначений файлов Street.dbf несколько иная: 11 222 333 444 5555 66. Расшифруем:

Последнее значение (55 и 66) может быть представлено числом от 00 до 99. Притом, актуальное наименование означает только шифровка 00.

Также надо отметить следующие замечательные свойства классификатора:

Как использовать классификатор?

Что такое КЛАДР? Это классификатор, находящийся в свободном доступе. Найти его можно на официальном сайте ФГУП «ГНИВЦ» Федеральной налоговой службы РФ. Файлы формируются из базы данных ФИАС. Их обновление происходит каждую неделю.

Отметим, что в КЛАДР нельзя найти адрес, имеющий хоть какую-то степень секретности. Также здесь указаны только наименования закрытых административно-территориальных образований.

Хоть КЛАДР содержит почтовые индексы и коды ОКАТО для всего многообразия населенных пунктов, важно выделить, что эта информация содержит в себе массу неточностей. Возможна отметка реальных адресов, как несуществующих.

Функции КЛАДР

Отметим и важные функции классификатора адресов КЛАДР:

КЛАДР и ФИАС

Таким образом, сегодня ФИАС все же предпочитают КЛАДР. Однако старый классификатор по-прежнему актуален, регулярно обновляется и доступен для свободного скачивания. Некоторые особенности его структуры, градации, важные кодовые обозначения и частности, правила работы с КЛАДР вы уже узнали из этой статьи.

Источник

Как легко заполнить адрес без ошибок? Интеграция с сервисом kladr-api.ru

Опубликовано:
26 октября 2018 в 12:30

Довольно часто в организации приходится заполнять карточки организаций, контактных лиц или персон. И один из реквизитов, который должен быть заполнен – это почтовый или юридический адрес. От корректности и правильности заполнения адреса зависит, например, каким в итоге будет сформирован конверт для отправки корреспонденции в модуле Канцелярия.

Процесс заполнения адреса может быть довольно трудоемким. Дополнительно существует риск, что адрес будет внесен ошибочно в следствие человеческого фактора. Это обуславливается отсутствием централизованной базы адресов, вроде ФИАС или КЛАДР, в поставке DIRECTUM.

Интересным, на мой взгляд, показалась возможность возвращать данные по введенному почтовому индексу. В частности, по индексу может быть однозначно определен город, область или край, а также район, к которому относится индекс. А дальше – больше. Можно получить список улиц, относящихся к полученному населенному пункту, а также список строений.

Рисунок 1 Выбор улицы

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

Рисунок 2 Выбор номера строения

Бесплатная версия сервиса имеет ограничение – 100000 запросов в день. Разработчики объясняют это заботой о производительности системы. Помимо этого, в ходе работы над диалогом я выяснил, что в запросе возвращается не более 400 строк. Поэтому список номеров строений может быть не полным. В этом случае пользователь может ввести номер строения самостоятельно.

Рисунок 3 Результат работы.

Источник

КЛАДР 2016 – онлайн-классификатор адресов России

Регфорум предлагает вам актуальный КЛАДР 2016 года. С его помощью вы можете быстро узнать почтовый индекс, номер территориальной налоговой инспекции, регистрирующего органа, к которому прикреплен адрес, а также выяснить коды ОКТМО и ОКАТО. Предоставляем вам КЛАДР бесплатно и без дополнительных условий. Просто начните использовать его прямо сейчас!

Инструкция по использованию КЛАДР

Вы можете использовать наш классификатор КЛАДР для нахождения требуемой информации двумя способами: через «Выбор» и «Поиск». В нем нет адресов, имеющих любую степень секретности. У закрытых административно-территориальных образований в КЛАДР России указывается только их наименование. Файлы классификатора создаются из базы данных Федеральной информационной адресной системы.

Чтобы выбрать адрес и получить желаемый код КЛАДР, кликните по первой строке, где указано «Москва», если вам нужен другой регион. В открывшемся окне найдите субъект РФ в списке или начните набирать его в поисковой строке. Таким же образом выберите город и улицу. И вы получите искомые данные, для которых наш КЛАДР предоставит вам список домов и другую информацию.

Чтобы найти адрес по названию, нажмите на вкладку «Поиск», укажите регион, если это не «Москва». Затем выберите что искать: улицы или другие объекты. Введите название объекта или его часть, нажмите «Искать», и выберите улицу из представленного списка. В зависимости от объекта наш справочник КЛАДР предоставляет вам возможность выбрать дом или просмотреть все адреса с информацией по ним. Если кликнуть по индексу, то отобразятся адрес почтового отделения и его телефоны.

О КЛАДР

Чтобы распределить территории между налоговыми инспекциями и автоматизировать рассылку корреспонденции был создан классификатор адресов КЛАДР для ведомственного использования в ФНС. В нашем сервисе всегда актуальный КЛАДР адресов 2016 года для всех регионов РФ, включая Крым. Используя вкладку «Выбор», вы можете найти адрес в конкретном населенном пункте. Если воспользоваться вкладкой «Поиск», то можно найти объект с определенным наименованием в одном или всех субъектах РФ.

Мы постарались сделать этот инструмент удобным и интуитивно понятным для вас. Нам бы хотелось совершенствовать наш онлайн-сервис КЛАДР, поэтому будем признательны вам за отзыв о его работе.

10 фактов о КЛАДР

Текущая версия датирована 18 февраля 2016 года. КЛАДР на Регфоруме обновляться не будет. Сервис будет заменен на ФИАС.

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

В нашем онлайн-сервисе вы можете узнать: 1) адрес объекта по названию, 2) номер регистрирующего органа, 3) номер территориальной налоговой инспекции, 4) код ОКТМО, 5) индекс, адрес и телефоны почтового отделения. Надеемся, что наш удобный и быстрый сервис будет вам полезен.

Источник

Как перейти от КЛАДР к ФИАС и ничего себе не сломать

ГНИВЦ ФНС сообщает, что с начала 2018 года КЛАДР перестанет существовать и скачать его будет нельзя.

Дисклеймер:
Если вы совсем не поняли, что означают эти наборы букв, ничего страшного. Ниже мы расскажем о реалиях работы с адресами в России. Если вам это неинтересно, почитайте про топографические каламбуры.

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

Зачем нужны классификаторы адресов

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

Как вы думаете, какой государственный орган наиболее заинтересован в том, чтобы вы получали от него письма? Правильно! Налоговая. Поэтому ФНС России много лет разрабатывает и поддерживает ведомственные общероссийские классификаторы адресов. И так как более полных справочников нет, их стали использовать повсеместно.

Сначала был КЛАДР, и было в нем 6 уровней:

Регион → Район → Город → Населенный пункт → Улица → Дом со строениями и корпусами

С 2012 года в эксплуатацию ввели новый классификатор — ФИАС. Про основные отличия мы писали три года назад в статье «ФИАС или КЛАДР: выбираем справочник адресов». В ФНС к разработке нового классификатора подошли основательнее и постарались учесть все грабли минусы КЛАДР. Из интересного добавили дату начала и окончания записи, ввели фиксированный ID для каждого дома (предполагается, что он не будет меняться).

До сих пор продолжают обновляться оба классификатора, но поддерживать совместимость становится сложнее. В прошлом году в ФИАС начали добавлять новые уровни. Например, планировочные структуры — это всякие дачные товарищества и микрорайоны, в классификаторе их уже больше 81 000. В конечном итоге в ФНС приняли логичное решение прекратить поддержку КЛАДР и удалить его в конце 2017 года.

Как адреса хранятся в ФИАС и КЛАДР

Мы видели много способов хранения адресов в структуре КЛАДР. В основном они сводятся к двум вариантам:

То есть задача миграции сводится к тому, чтобы перевести код или текстовый адрес в формате КЛАДР в код ФИАС.

Классификационные коды выглядят так:

Раскладываем адрес по уровням ФИАС и КЛАДР

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

Классификационный код отражает текущую структуру адреса, а она может измениться. Например, у Оккервиля изменится район и весь код станет недействительным, мы его уже не найдем.

Чтобы избавиться от этого, в ФИАС добавили еще идентификационный код ФИАС. Это глобальный идентификатор для каждого объекта: города, улицы, района и т. д. Выглядит он как набор букв и цифр, который формируется по стандарту GUID (Globally Unique Identifier). Типичный GUID в ФИАС выглядит так: f77948dc-7bc8-42cb-979e-2c958d162d63.

Код КЛАДР → идентификационный код ФИАС

Если адрес у вас хранится как код КЛАДР улицы + домовая часть («дом 1 строение 3 квартира 44»), то для него все относительно просто.

Таблица ADDROBJ хранит все адресные объекты с их идентификаторами

Для работы понадобится таблица ADDROBJ из выгрузки ФИАС в формате xml или dbf. В ней хранятся все объекты (города, улицы и т. д.) подряд с уникальными идентификаторами GUID.

Будем использовать следующие колонки:

Пример: Москва, ул Александра Солженицына. Код КЛАДР: 77000000000151900.

Шаг 1. Выделяем из кода КЛАДР код до улицы, то есть берем первые 15 цифр: 770000000001519 00.

Шаг 2. Ищем код КЛАДР в поле PlainCode. Если нашлась одна запись, то сохраняем значение поля AoGuid и пропускаем следующий пункт. Но по нашему коду 770000000001519 находится три записи, нужна дополнительная проверка.

Но можно поступить еще проще и воспользоваться готовым сервисом. DaData.ru умеет подсказывать адреса в конкретных регионах, районах, городах и населенных пунктах. Понимает названия («Петергоф»), коды КЛАДР («7800000800000») и ФИАС («8f238984-812b-4bb1-850b-49749fb5c56d»).

Строчный адрес КЛАДР → код ФИАС

Самый простой вариант — воспользоваться DaData.ru. Сервис сделает все за вас автоматически. Но можно и развлекаться самостоятельно.

Адреса одной строкой

Если адреса у вас хранятся одной строкой, вроде этой:
г Москва, улица Большая Коммунистическая, дом 3, то поздравляем, это самая интересная задача. Нужно писать свой адресный парсер, который будет разделять строку в формате КЛАДР на части, искать каждый ее компонент в ФИАС с учетом опечаток, сокращений, исторических названий и определять по ним ФИАС-код. Легче это сделать уже готовым адресным парсером. Как выбрать алгоритм для адресного фильтра, мы рассказывали раньше.

Адреса по КЛАДР

Примерно так выглядит адрес, разложенный по КЛАДР

Код ФИАС можно собрать, используя всё ту же таблицу ADDROBJ. Но в этом случае двигаться по уровням нужно от большего к меньшему.

Шаг 1. Берем название региона и ищем его в поле FormalName таблицы ADDROBJ.

FormalName = Москва →
AoGuid = 0c5b2444-70a0-4932-980c-b4dc0d3f02b5

Шаг 2. Идем дальше по уровням вниз и ищем по FormalName с фиксированным родителем — найденным AoGuid на предыдущем шаге. В нашем случае уровни «город» и «населенный пункт» пустые, а следующий непустой уровень — улица.

ParentGuid = 0c5b2444-70a0-4932-980c-b4dc0d3f02b5,
FormalName = Коммунистическая Б. → AoGuid=f77948dc-7bc8-42cb-979e-2c958d162d63

Шаг 3. Если дошли до улицы, то можно найти и дом. Для этого в таблице HOUSE ищем номер дома с фиксированным AoGuid улицы. ФИАС не полон домами, поэтому не расстраивайтесь, если нужный номер не найдется.

AoGuid = f77948dc-7bc8-42cb-979e-2c958d162d63,
дом номер 3 →
HouseGuid = bce8be1f-f2f7-4cce-836e-08daac0b931e

Подводные камни

Таблица SOCRBASE хранит полные и сокращенные типы объектов

Тип по КЛАДР может быть сокращенным и полным: «ул» — «Улица», «х» — «Хутор». В ФИАС в явном виде хранится только сокращенный тип (в поле ShortName). Полный тип в сокращенный можно превратить с помощью таблицы SOCRBASE, в ней для каждого уровня хранится соответствие сокращённых и полных типов.

И напоследок хорошая новость для тех, кому лень запариваться всем перечисленным. В ближайшее время мы планируем выпустить ФИАС в формате КЛАДР для тех, кто не успеет перейти на формат ФИАС до конца года. Следите за новостями 🙂

Источник

КЛАДРируем адреса произвольной формы (ч.1 — импорт)

Таким видом у нас в стране можно считать код по справочникам КЛАДР или ФИАС.

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

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

Получение справочника КЛАДР

База КЛАДР в настоящее время администрируется ФНС и представлена на сайте ГНИВЦ в виде периодически (примерно раз в неделю) обновляемого архива. Для начала мы научимся его скачивать, исправлять некоторые ошибки и преобразовывать в более подходящую для наших задач структуру.

Исходный архив

Чтобы не пытаться обрабатывать архив и обновлять данные в нашей базе повторно, будем сохранять в ней этот таймстамп для последующих сравнений.

Если же таймстамп файла не совпал с сохраненным, распакуем полученный архив:

Результатом будет 7 DBF-файлов в DOS-кодировке:

Переберем все эти файлы, формируя единый скрипт выгрузки данных через psql в COPY-формате:

По итогу мы получаем большой-большой SQL-файл примерно такого вида:

Импорт данных

Защита от параллельной загрузки

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

Соберем все вместе в единый скрипт:

Реквизиты доступа к базе и КЛАДР-источник в нашем случае будут храниться в app.conf :

Поисковая база

А зачем нам вообще нужна какая-то другая структура? Чем нас не устраивают таблицы в оригинальном КЛАДР-архиве?

хранение адресных объектов (улиц и населенных пунктов) в разных структурах

невозможность наложить эффективные для поиска индексы

Напомню, что оригинальный код КЛАДР, согласно документации имеет вид СС РРР ГГГ ППП УУУУ АА , где:

То есть если вынести признак актуальности в отдельное поле, то у кодов многих объектов (например, городов) в конце окажутся нули, которые стоит безболезненно отсечь. И тогда коды будут иметь строго ограниченный набор длин в соответствии с «уровнем» объекта:

При этом, как видим, коды «вышестоящих» объектов становятся префиксами кодов объектов вложенных.

Что же получилось по структуре?

Это основные таблицы, данные в которые импортируются непосредственно из соответствующих DBF по модели наложения «диффов», описанной в статье «DBA: грамотно организовываем синхронизации и импорты»:

Здесь регулярное выражение используется для отсечения «хвостовых» нулей по маске до необходимой нам длины. То есть нельзя просто так взять 76 000 010 000 и убрать все 4 последних ноля, поскольку 010 тут является значимым кодом города.

Здесь регулярными выражениями мы приводим форматы исходной базы в списки конкретных номеров домов:

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

Источник