Руководство пользования фиас

Предложите, как улучшить StudyLib

(Для жалоб на нарушения авторских прав, используйте

другую форму
)

ФИАС с человеческим лицом

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

О внутреннем устройстве таблиц ФИАС, будет другая статья.

К счастью мне не пришлось во всём разбираться самому, потому что на Хабре есть хорошая серия статей о ФИАС (Адреса ФИАС в среде PostgreSQL), и у этих статей не менее ценные коменты. На их основе у меня получилось написать скрипты и написать Докер образ, всё опубликовано на ГитХабе.

Спасибо товарищам @gladkov @QuickJoey @amakarov @ploop без вас я бы не справился..

Как работать с образом описано в README.md, здесь я распишу всё тоже самое но более подробно.

Требования

Для работы на базе Linux нужны:

• docker

• docker-compose

Для работы на базе Windows нужны:

• WSL2

• Docker Desktop

Не менее 200 гигабайт постоянной памяти: 8 + 90 Гигабайт для бэкапа базы ФИАС, и 80 гигабайт на собственно базу (без Земельных участков и без Документов).

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

Как установить

Что бы развернуть базу надо иметь бэкап этой базы. Идём на сайт ФИАСа и выкачиваем полную базу в формате DBF (8 Гб).

Выбираем директорию для установки базы (в том числе набора скриптов для обслуживания базы), в этой директории разворачиваем гит репозиторий:

git clone https://github.com/SbWereWolf/fias.git

Теперь надо извлечь файлы из архива в директорию ./fias/fs/home/fias/base/, где ./ — это директория в которой мы развернули репозиторий (родительская для fias):

# извлечь файлы из архива
unzip /opt/fias_dbf.zip -d ./fias/fs/home/fias/base/
# удаляем "лишние" файлы
find ./fias/fs/home/fias/base/ -type f -regextype posix-awk \
    -regex ".*\/(STEAD|NORDOC)([0-9]{2}|[0-9]{4})\.DBF$" -exec rm {} \;

Для моего проекта нужны только Здания (HOUSE) и Помещения (ROOM), земельные участки (STEAD) и документы (NORDOC), мне не нужны, поэтому я их удаляю. Если вам в вашем проекте не нужны Помещения, то можно добавить их в маску поиска файлов для удаления: (STEAD|NORDOC|ROOM)

Переходим в директорию приложения

cd fias
# Делаем скрипт install.sh исполняемым и выполняем установку
chmod +x ./install.sh && ./install.sh

Все скрипты будут сделаны исполняемыми, будет создан docker-compose.yml

Открываем docker-compose.yml , изменяем параметры контейнера на свой вкус (можно поменять порт, можно установить пароль для пользователя postgres, можно сделать мапинг скриптов на директорию хостовой машины, что бы менять эти скрипты по ходу дела на свой вкус и тому подобное)

Образ разработан на основе официального, поэтому доступные опции пожалуйста смотрите в документации по ссылке.

Теперь всё готово к сборке образа и запуска контейнера:

# Выполняем сборку и запуск контейнера
bash ./run.sh
# Разворачиваем базу
bash ./deploy.sh

База установлена. Выполнение процесса журналируется в ./docker/run.log и ./docker/deploy.log

Скрипты написаны с условием логина пользователя postgres без пароля, если вы установите пароль, то надо переписать все места запуска psql, убрать ключ -w добавить ключ с указанием пароля.

База развёрнута, можно пользоваться.

Для экономии места можно удалить резервную копию базы: rm -rf ./fs/home/fias/base/* + rm /opt/fias_dbf.zip , экономия от 90+ Гб.

Как пользоваться

Можно пользоваться прямо в контейнере, подключаемся к терминалу:

cd /home/fias/
docker-compose -f ./docker/docker-compose.yml exec fias \
    psql -U postgres -d fias -w

Конечно можно подключиться любым клиентом (любой IDE, любым другим приложением):

Открываем на редактирование ./docker/docker-compose.yml, прописываем внешний порт и пароль пользователя postgres (переменная окружения контейнера POSTGRES_PASSWORD).

В приложении прописываем указанные ранее порт и пароль, пользователь postgres, сервер или 0.0.0.0 или localhost.

Запускаем контейнер: bash ./run.sh

Пользуемся и получаем удовольствие.

Как обновить

Выкачиваем со странички обновлений, архив с обновлениями в формате DBF.

Перед извлечением файлов из архива, чистим директорию обновлений в приложении: rm -rf ./fs/home/fias/update/*

Переходим в директорию репозитория (допустим репозиторий мы развернули в директории /home/): cd /home/fias/

Разворачиваем обновления в директорию репозитория: unzip /opt/fias_delta_dbf.zip -d ./fs/home/fias/update/

Удаляем «лишние» обновления:

find ./fs/home/fias/update/ -type f -regextype posix-awk \
    -regex ".*\/(STEAD|NORDOC)([0-9]{2}|[0-9]{4})\.DBF$" -exec rm {} \;

Запускаем контейнер: bash ./run.sh

Выполняем обновление: bash ./update.sh

Процесс обновления журналируется в файл ./docker/update.log

Have fun.

Производительность

На Pentium Gold + HDD под WSL база работает очень не спеша, разворачивание занимает до 4-х часов, большое обновление занимает до 8 часов.

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

10cpu | 18ram | 400hdd | nfs 10 раид из 16 sas дисков

На такой конфигурации затраты времени терпимые.

Разворачивание базы 1 час, обновление на 40 мегабайт (в архиве) раскатывается за полчаса, обновление на 400 мегабайт (в архиве) раскатывается около часа.

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

Применение разработки на практике, пока отложено, поэтому с составлением полного адреса я конечно разобрался, но оптимизаций не делал.

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

• ./docker/cmd/deploy/get-address-object-group.sql

• ./docker/cmd/deploy/get-address-object-name.sql

• ./docker/cmd/deploy/get-address-object-tree.sql

• ./docker/cmd/deploy/get-house-name.sql

И конечно читайте первоисточник — Адреса ФИАС в среде PostgreSQ

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

Дополнительно

Некоторые таблицы ФИАС в резервной копии разбиты на два файла, например HOUSE50.DBF и HOUSE5001.DBF, обработка дополнительного файла выполняется в ручную и является костылём, если какие то другие таблицы будут разбиты на два и более файлов, то вам самостоятельно придётся дописать код для импорта этих данных при разворачивании резервной копии.

Это тривиальный код, но кроме вас его ни кто не напишет, для примера:

insert into house50
select *
from house5001;

В целом, весь код лишён гибкости, и при добавлении новых регионов, код для их обработки, придётся дописывать самостоятельно.

Для выполнения VACUUM в СУБД, написан скрипт ./refresh.sh (если вам кажется что скрипты выполняются не адекватно долго, то возможно надо пересчитать статистику таблиц, по которой работает планировщик выполнения запросов, для этого выполняется VACUUM).

Что бы открыть консоль PostgreSQL можно запустить ./terminal.sh

Для ещё большего экономии места, колонки ID и GUID при импорте из DBF подтянутые как varchar(36), можно изменить на uuid, экономия до 5% от размера базы. Я сам не проверял, но в коментах несколько человек это подтвердили.

С конца 2022 года при создании нового юрлица и смене местонахождения организации ФНС стала требовать указывать юридический адрес в соответствии с официальным справочником — ГАР (Государственным адресным реестром). Он формируется, ведется и используется с помощью ФИАС — Федеральной информационной адресной системы.

Отличие ГАР в том, что в нем адреса представлены в соответствии не только с административным, но и с муниципальным делением. Если в форме Р13014 или Р11001 адрес будет указан не по ГАР, то в регистрации могут отказать. Одна из частых причин такой ситуации заключается в том, что помещения просто нет в ФИАС. В таком случае его необходимо добавить в систему. В статье разберемся, как внести адрес в ФИАС.

Что нужно сделать для внесения адреса в ФИАС

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

Важно знать! Перечень необходимых документов зависит от региона, поэтому их лучше уточнить в администрации и у местных органов Росреестра.

Заявление о том, что вам нужно внести адрес в ФИАС, можно подать не только лично, но и онлайн через официальный сайт системы — fias.nalog.ru. Для этого нужно зарегистрироваться на платформе, а еще получить усиленную квалифицированную электронную подпись. Если у вас есть КЭП, то подать заявку можно следующим образом:

• Войти в личный кабинет на сайте ФИАС и нажать «Заявка в ФИАС».

• Выбрать «Добавление адреса в ФИАС».

• Указать способ получения ответа: почтой, по email или в личном кабинете на сайте. Выбрать тип объекта (здание, участок, машино-место, помещение, сооружение) и причину, в связи с которой ему нужно присвоить адрес. Добавить ОКТМО объекта и тип вещного права на него. Указать, что сведения подаются юридическим лицом.

• Ввести данные о юридическом лице: полное название, почтовый адрес, населенный пункт, индекс, ИНН и КПП, страну, номер и дату регистрации, контактный email и номер телефона.

• Подтвердить согласие на обработку персональных данных и достоверность сведений, поставив флажок напротив соответствующих пунктов, и нажать «Далее».

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

• Подписать заявку электронной подписью и отправить.

Полезно знать! Перед тем как добавить адрес в ФИАС, стоит проверить, действительно ли информация об объекте отсутствует в системе. Для этого на сайте реестра достаточно ввести в поисковую строку адрес с точностью до номера дома, а в отображенных результатах перейти на вкладку «Помещения» и посмотреть, есть ли там ваш объект.

В ФИАС рассмотрят заявку и сообщат о своем решении, отправив вам уведомление способом, который был выбран вами на третьем шаге заполнения заявки. После этого можно приступать к регистрации адреса в налоговой, подав форму Р13014 или Р11001 в зависимости от того, переезжает ли компания или создается новое юрлицо.

Если вы меняете адрес, то не забудьте оповестить своих партнеров об этом, подав уведомление на Федресурс. Это легко сделать с помощью онлайн-сервиса «Федресурс 24», который позволяет опубликовать уведомления без электронной подписи и регистрации на сайте Федерального ресурса. Просто подайте заявку, и наш менеджер-юрист перезвонит вам в течение 9 минут, чтобы рассказать о ходе процедуры, необходимых документах и других нюансах.

Эта страница является черновиком статьи.

Введение

Вопросы/пожелания/замечания — форум

Адреса официальной публикации:

1. Федеральная информационная адресная система
2. Банк данных федеральной информационной адресной системы

Оба источника предлагают идентичные данные.

Федеральная информационная адресная система (ФИАС) создана Распоряжением Правительства Российской Федерации от 10.06.2011 №1011-р. С целью…

Статья «КЛАДР: Настоящее, прошлое и будущее» (примерно 2004 г.)

Замена КЛАДР… Тем не менее классификатор КЛАДР продолжает публиковаться и обновляться — версия 4.0 от 24.12.2012.

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

//ToDo — понятие «адрес» из докум. «Перечень типовых вопросов и предложений по использованию ПО «ФИАС»» // Секретность

Загрузка данных

Процесс импорта данных из файлов XML в реляционную базу данных дается на примере PostgreSQL. Все применяемые инструменты являются кросплатформенными. Для других БД (MySQL, Oracle и т.п.) процедура потребует незначительной доработки. См. также гл. 2.3, в которой приводятся ссылки на сторонние проекты, предоставляющие подготовленные данные в других форматах.

Создание таблиц

На сайте ФИАС представлены схемы XSD, описывающие структуру данных. Для преобразования схемы в формат SQL (CREATE TABLE…) применим XSL Transformation (XSLT). В зависимости от БД может потребоваться изменить типы данных колонок.

Схема подходит для всех таблиц ФИАС. Для работы требуется процессор, поддерживающий XSLT 2.0. Например, Saxon XSLT Processor (MPL). Тогда обработка файлов принимает вид (версии .NET, Windows):

Далее, полученные файлы SQL желательно откорректировать, чтобы явно назначить ключи (primary keys).

//// Ссылка на готовые файлы

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

Для работы с большими файлами XML предпочтительнее применять потоковые парсеры: используется фиксированное количество оперативной памяти (в приведенном скрипте — порядка 80 Мб) на протяжении всего процесса работы.

Ниже приводится скрипт ETL Scriptella (Apache License) на базе парсера SAX. Он подходит для любой реляционной БД, для которой есть java-драйвер.

Скрипт для ETL Scriptella

Примечания:

1. Паттерн ###TABLE### следует заменить на имя файла/таблицы (например, ADDROBJ);
2. Да работы требуются дополнительные библиотеки: Janino, PostgreSQL JDBC Driver;
3. Выполняется простейшее экранирование значений (одиночная кавычка ‘). //ToDo: пустые > null

Другие источники

Данные ФИАС также распространяются в формате DBF. Для работы с ними рекомендуются утилиты типа PgDBF (импорт ФИАС).

• BasicData.ru — WebAPI и файлы для импорта в БД MySQL. Также может быть интересна БД «Почтовые отделения».
• Классификаторы России (rus-ref)
• zXML Parser — «Парсинг баз ФИАС в MySQL (потоковый XML парсер)». Программа из данных XML создает файл с sql-запросами.

Структура данных ФИАС (описание таблиц)

Для понимания структуры данных ФИАС требуются следующие документы:

1. Сведения о составе информации Федеральной информационной адресной системы (DOC);
2. Описание структуры наборов данных ФИАС (DOC);
3. Описание Классификатора адресов российской федерации (КЛАДР) (в архиве DOCUM.ARJ)

Таблицы

Основные

• ADDROBJ — Классификатор адресообразующих элементов (край > область > город > район > улица)
• HOUSE — Сведения по номерам домов улиц городов и населенных пунктов, номера земельных участков и т.п
• HOUSEINT — Интервалы домов
• LANDMARK — Описание мест расположения имущественных объектов
• NORMDOC — Сведения по нормативному документу, являющемуся основанием присвоения адресному элементу наименования

Справочники

• ACTSTAT — Статус актуальности ФИАС
• CENTERST — Статус центра
• CURENTST — Статус актуальности КЛАДР 4.0
• ESTSTAT — Признак владения
• HSTSTAT — Статус состояния объектов недвижимости
• INTVSTAT — Статус интервала домов
• NDOCTYPE — Тип нормативного документа (закон, приказ, справка) // не упоминается в официальной документации
• OPERSTAT — Статус действия
• SOCRBASE — Типы адресных объектов (условные сокращения и уровни подчинения)
• STRSTAT — Признак строения

ADDROBJ

Текстовые элементы адреса

• OFFNAME — Официальное наименование
• FORMALNAME — то же что и OFFNAME, но оптимизированная для поиска
• SHORTNAME — Тип объекта: обл, р-н, г, ул. Расшифровку сокращений см. по табл. SOCRBASE.

Поле FORMALNAME создано специально для поиска: из него исключены все нестандартные символы и знаки пунктуации, буква «ё» заменена на «е» и т.п. Все записи удовлетворяют запросу:

SELECT * FROM addrobj WHERE formalname !~ '[0-9А-Яа-я ]'

Иерархия административных единиц

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

• AOGUID — Глобальный уникальный идентификатор адресного объекта. Не смотря на название, уникальным в пределах таблицы он не является. Могут существовать несколько исторический версий и одна единственная актуальная для данного объекта. Подробнее см. раздел «Статус актуальности».
• PARENTGUID — Идентификатор объекта родительского объекта. Содержит ссылку на AOGUID родительского элемента.
• AOLEVEL — Уровень адресного объекта. Условные названия уровней (подробнее см. табл. SOCRBASE):

  1 — регион

  2 — зарезервирован

  3 — район

  4 — город

  5 — внутригородская территория

  6 — населенный пункт

  7 — улицы

  8 — зарезервирован

  90 — дополнительная территория (ГСК, СНТ, лагери отдыха и т.п.)

  91 — улицы на дополнительной территории (улицы, линии, проезды)

Получение полного адреса (от младшего к старшему):

WITH RECURSIVE child_to_parents AS (
  SELECT addrobj.* FROM addrobj
      WHERE aoid = '51f21baa-c804-4737-9d5f-9da7a3bb1598'
  UNION ALL
  SELECT addrobj.* FROM addrobj, child_to_parents
      WHERE addrobj.aoguid = child_to_parents.parentguid
        AND addrobj.currstatus = 0
)
SELECT * FROM child_to_parents ORDER BY aolevel;

AOLEVEL отражает административно-правовое подчинение, поэтому одни и те же текстовые элементы адреса могут располагаться на разных уровнях. Например, в снт. «Волжанка» (AOLEVEL=90) улицы имеют уровень 91 (против более распространенного 7):

(1) обл. Самарская

(3) р-н Сызранский

(90) снт Волжанка

(91) ул. Ягодная

(91) ул. Дачная

(91) ул. Рябиновая

Аналогично, существуют населенные пункты без улиц. Например, в пос. Лужки иерархия заканчивается на уровне 6:

(1) обл. Орловская

(3) р-н Мценский

(6) п. Лужки

Таким образом, построение таблицы полных адресов следует начинать от верхних элементов (AOLEVEL=1) к нижним (AOLEVEL=91), как правило, запрос оформляется в виде множества подзапросов (subquery). Или рекурсивно подниматься от нижних, не имеющих дочерних элементов. Рассмотрим для примера второй вариант. Поскольку число полей в обоих случаях не определено, то полный адрес будет формироваться единой строкой:

Функция получения полного адреса (аналогично предыдущему примеру)

-- сбор всех parentguid
WITH all_parents AS (
  SELECT DISTINCT parentguid
    FROM addrobj
   WHERE (currstatus = 0) AND (parentguid IS NOT NULL)
)
-- выбор элементов самого нижнего уровня (не входящих в список all_parents)
-- и получение полного адреса
SELECT (make_full(aoid)).*
  FROM addrobj
 WHERE (currstatus = 0) AND (aoguid NOT IN (SELECT parentguid FROM all_parents))

Образцы результатов:

<addr type="обл">Волгоградская</addr> <addr type="г">Волгоград</addr> <addr type="ул">Лавровая</addr>
<addr type="обл">Орловская</addr> <addr type="р-н">Мценский</addr> <addr type="п">Лужки</addr>
<addr type="обл">Челябинская</addr> <addr type="г">Челябинск</addr> <addr type="ул">Балтийская</addr>
<addr type="край">Приморский</addr> <addr type="г">Артем</addr> <addr type="ул">Григорьева</addr>
<addr type="обл">Калужская</addr> <addr type="р-н">Ульяновский</addr> <addr type="д">Бродок</addr>
<addr type="обл">Свердловская</addr> <addr type="г">Екатеринбург</addr> <addr type="ул">Окраинная</addr>
<addr type="Респ">Тыва</addr> <addr type="р-н">Чаа-Хольский</addr> <addr type="м">Сесеге</addr>

Примечания:

1. На настоящий момент существует 10 уровней (AOLEVEL). Но могут быть введены дополнительные. Например, ранее все ГСК и СНТ вносились на уровень 7 (улицы). Позднее, для них был выделен уровень 90 (дополнительные территории).
2. На зарезервированных уровнях (2 и не содержится записей, в том числе и исторических.

Статус актуальности

Из базы ФИАС почти никогда не удаляются элементы. Они могут быть только переведены в разряд «отключенных» (устаревшие, измененные и т.п.), что аналогично работе КЛАДР.

Примечание. Но информация о некоторых адресных объектах всё же может удаляться из БД ФИАС. См документ СВЕДЕНИЯ О СОСТАВЕ ИНФОРМАЦИИ ФЕДЕРАЛЬНОЙ ИНФОРМАЦИОННОЙ АДРЕСНОЙ СИСТЕМЫ, цитирую:

«Технологически удалённые из БД ФИАС записи с адресными сведениями… включают удалённые администратором ФИАС по заявке операторов ФИАС (ошибочно введённые, дубли адресных сведений) адресные сведения».

Т.е. дубли и ошибочно введённые данные могут быть физически удалены. Большинство из них приобретают статус актуальности КЛАДР (CURRSTATUS) равный 99, т.е. «несуществующий», а после этого уже становятся «технологически удалёнными». Если их нужно найти, то надо скачать т.н. «дельты данных», которые используются для обновления БД ФИАС, это архивы fias_delta_dbf.rar на сайте ФИАС. В некоторых из них имеются таблицы DADDROBJ, DHOUSE, и пр., содержащие технологически удалённые записи, попавшие в «дельту». На дату 15.12.2014 всего технологически удалено 793 записи, из них: 363 актуальных (т.е. ACTSTATUS = 1), 1 с CURRSTATUS != 99, и 1 с LIVESTATUS = 1.

Рассмотрим поля, определяющие действительность объекта:

Для выбора актуальных записей рекомендуется ориентироваться на поля CURRSTATUS и LIVESTATUS.

Рассмотрим подробнее:

• LIVESTATUS — Признак действующего адресного объекта. Принимает значения: 0 — не действующий, 1 — действующий (см. прим. 1).
• CURRSTATUS — Статус актуальности КЛАДР 4. Принимает значения: 0 — актуальный, 1-50 — исторический, 51 — переподчиненный (см. табл. CURENTST и гл. 1.2. «Коды адресных объектов» документации КЛАДР).
• OPERSTATUS — Статус действия. Принимает значения: 1 — Инициация, 10 — Добавление, 20 — Изменение и др (см. табл. OPERSTAT).
• ACTSTATUS — Статус актуальности адресного объекта ФИАС. Принимает значения: 1 — актуальный, 0 – не актуальный (см. табл. ACTSTAT). Отвечает непосредственно за актуальность «имени». Если объект был переименован (чаще это исправление опечаток), то старая запись получает CURRSTATUS=1 и ACTSTATUS=0. Если же административная единица была ликвидирована или переподчинена, то имя останется по-прежнему актуальным: CURRSTATUS=99/51 и ACTSTATUS=1. В тоже время, при внесении изменений, не касающихся непосредственно адресной части, признак актуальности все равно сбрасывается (ACTSTATUS=0).

Также, в категорию актуальности можно отнести поля STARTDATE, ENDDATE, UPDATEDATE. Но, на данный момент (декабрь 2012 г.) значения этих полей редко бывают заполнены правильно.

Покажем на примере выбор актуальных и исторический записей. «Пермский край» был образован 01.12.2005 объединением «Пермской области» и «Коми-Пермяцкого АО». В базе ФИАС это отразилось следующим образом (см. табл. 1):

1. Создана новая запись «Пермский край» (1-й столбец);
2. Запись «Пермская область» (2-й столбец) сохранена, причем AOGUID обеих записей идентичен (для связи с дочерними объектами);
3. Запись «Коми-Пермяцкий АО» (3-й столбец) также сохранена.

Таблица 1

Значения полей:

1. ACTSTATUS для Коми-Пермяцкого АО сохранен в значении «Актуальный»;
2. OPERSTATUS не изменился — ошибочно(?);
3. CURRSTATUS правильный (0 — актуальный, 1 — исторический, 51 — переподчиненный);
4. LIVESTATUS показывает единственную актуальную запись, но значения инвертированы (см. прим. 1).

//ToDo — изменения в подчиненных объектах

Примечания:

1. Все актуальные записи (CURRSTATUS = 0) имеют значение (LIVESTATUS = 1) и наоборот. Очевидно, что поведение LIVESTATUS не соответствует описанному в документации. Поле можно использовать для выбора актуальных записей, но с осторожностью до выяснения ситуации в будущем.

Исторические названия

Поля AOID, PREVID, NEXTID в совокупности составляют цепочку от современного к устаревшим наименованиям объекта. Хотя, если имеется два прямых предка (как в примере про «Пермский край»), то наследование невозможно отразить полностью однозначно.

В общем виде получение исторических вариантов наименований объекта имеет вид:

WITH RECURSIVE old_names AS (
    SELECT *
        FROM addrobj
        -- вариации отдельной записи:
        WHERE aoid = '002ff6b9-c2db-46e5-99da-8cf30d239b27'
        -- полный список:
        -- WHERE currstatus = 0 AND previd IS NOT NULL
    UNION
    SELECT addrobj.*
        FROM old_names, addrobj
        WHERE (addrobj.nextid = old_names.aoid)
)
SELECT * FROM old_names

Примеры:

// ToDo:

Примечания:

1. Наблюдение (в документации не разъяснено): при внесении изменений, предыдущая историческая запись получает значение (CURRSTATUS = 1). Если вносится повторное изменение, то аннулируемая запись принимает значение (CURRSTATUS = 2). Таким образом, цепочка от современного названия к самому старому принимает вид: актуальное (0), предыдущее (3), более раннее (2), самое старое (1).

Адресные классификаторы

Записи в БД ФИАС содержат ссылки на другие российские адресные классификаторы:

• OKATO — код объекта административно-территориального деления (ОКАТО)
• OKTMO — код муниципального образования (ОКТМО)
• CODE — код КЛАДР
• PLAINCODE — код КЛАДР без признака актуальности (последних двух цифр), см. также CURRSTATUS

ФИАС предлагает собственный «классификационный код», который хранится, разбитым на отдельные элементы: REGIONCODE, AUTOCODE, AREACODE, CITYCODE, CTARCODE, PLACECODE, STREETCODE, EXTRCODE, SEXTCODE.

В целом, код является расширенным вариантом КЛАДР:

       СС А РРР ГГГ ВВВ ППП УУУУ ЭЭЭЭ ЦЦЦ
 ФИАС: 74 0 026 000 000 032 0021 0000 000
КЛАДР: 74   026 000     032 0021

Другой пример:

       СС А РРР ГГГ ВВВ ППП УУУУ ЭЭЭЭ ЦЦЦ
 ФИАС: 33 0 003 001 000 000 0000 0303 000, "Владимирская обл, Вязниковский р-н, г Вязники, снт Коллективный сад Рябинушка-1"
КЛАДР: 33   003 001     000 0303

Могут быть случаи, когда адресному объекту в БД ФИАС не соответствует никакой КЛАДР-код, например:

       СС А РРР ГГГ ВВВ ППП УУУУ ЭЭЭЭ ЦЦЦ
 ФИАС: 23 0 000 002 000 000 0000 0383 009, "Краснодарский край, г Армавир, мкр Северный жилой район микрорайон 8, ул Спортивная"

Подробное описание см. в документе «Сведения о составе информации Федеральной информационной адресной системы».

Прочие поля

• Ведомственные классификаторы ФНС России: СОНО — IFNSFL, IFNSUL; СОУН — TERRIFNSFL, TERRIFNSUL.
• CENTSTATUS — статус центра; ненулевое значение присвоено столицам, административным центрам и центральным районам регионов (подробнее см. табл. CENTERST).
• NORMDOC — нормативный документ (табл. NORMDOC).

Обновление БД ФИАС

Привожу текст из документа СВЕДЕНИЯ О СОСТАВЕ ИНФОРМАЦИИ ФЕДЕРАЛЬНОЙ ИНФОРМАЦИОННОЙ АДРЕСНОЙ СИСТЕМЫ.

На портал ФИАС выгружаются актуальные и исторические сведения ФИАС, а так же технологически удалённые из БД ФИАС адресные сведения.

Актуальные и исторические сведения ФИАС выгружается в виде файлов (таблиц) DBF и файлов XML.

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

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

Наличие таких «дельт» позволяет быстро обновить БД ФИАС, не скачивая полный архив (на 2014.12.01 его размер составляет 1.8 Гб). Алгоритм обнобления, действительно, довольно прост. Привожу текст процедуры обновления для MySQL на примере таблицы ADDROBJ:

-- предположим, что дельту "залили" в схему "delta", а обновляемый ФИАС находится в схеме "fias"
use delta;
 
update
  fias.ADDROBJ f
  inner join ADDROBJ d on d.AOID = f.AOID
set
  f.actstatus=d.actstatus,f.aoguid=d.aoguid,f.aoid=d.aoid,f.aolevel=d.aolevel,f.areacode=d.areacode,f.autocode=d.autocode,f.centstatus=d.centstatus,f.citycode=d.citycode,f.code=d.code,f.currstatus=d.currstatus,f.enddate=d.enddate,f.formalname=d.formalname,f.ifnsfl=d.ifnsfl,f.ifnsul=d.ifnsul,f.nextid=d.nextid,f.offname=d.offname,f.okato=d.okato,f.oktmo=d.oktmo,f.operstatus=d.operstatus,f.parentguid=d.parentguid,f.placecode=d.placecode,f.plaincode=d.plaincode,f.postalcode=d.postalcode,f.previd=d.previd,f.regioncode=d.regioncode,f.shortname=d.shortname,f.startdate=d.startdate,f.streetcode=d.streetcode,f.ctarcode=d.ctarcode,f.extrcode=d.extrcode,f.sextcode=d.sextcode,f.livestatus=d.livestatus,f.normdoc=d.normdoc,f.terrifnsfl=d.terrifnsfl,f.terrifnsul=d.terrifnsul,f.updatedate=d.updatedate;
 
insert into fias.ADDROBJ (actstatus,aoguid,aoid,aolevel,areacode,autocode,centstatus,citycode,code,currstatus,enddate,formalname,ifnsfl,ifnsul,nextid,offname,okato,oktmo,operstatus,parentguid,placecode,plaincode,postalcode,previd,regioncode,shortname,startdate,streetcode,ctarcode,extrcode,sextcode,livestatus,normdoc,terrifnsfl,terrifnsul,updatedate)
select
  d.actstatus,d.aoguid,d.aoid,d.aolevel,d.areacode,d.autocode,d.centstatus,d.citycode,d.code,d.currstatus,d.enddate,d.formalname,d.ifnsfl,d.ifnsul,d.nextid,d.offname,d.okato,d.oktmo,d.operstatus,d.parentguid,d.placecode,d.plaincode,d.postalcode,d.previd,d.regioncode,d.shortname,d.startdate,d.streetcode,d.ctarcode,d.extrcode,d.sextcode,d.livestatus,d.normdoc,d.terrifnsfl,d.terrifnsul,d.updatedate
from
  ADDROBJ d
  left join fias.ADDROBJ f on d.AOID = f.AOID
where f.AOID is null;
 
delete from fias.ADDROBJ where aoid in (select aoid from DADDROBJ);

Иногда может изменятся структура самих таблиц, что требует ручного контроля. Например, колонка «oktmo» сначала содержала 8 символов, а потом была расширена до 11 символов.

Тем не менне, несмотря на удобство обновления через дельты, я рекомендую для обновления заменять БД ФИАС целиком (а после этого объединять её с таблицами технологически удалённых данных, при необходимости). Дело в том, что дельты могут содержать неполную информацию, проще говоря oldfias + delta != newfias. Например, я обновлял БД ФИАС от 2012.07.01 через дельты до состояния на 2012.09.24. Если в дельте была информация о переподчинении или об изменении адресного объекта, то предыдущая версия адресного объекта не обновлялась, т.е. не проставлялось (NEXTID = ид_нового, LIVESTATUS = 0, ACTSTATUS = 0). В результате в БД ФИАС были объекты с одинаковым AOGUID, но имеющие ACTSTATUS = 1. Некоторые новые данные просто отсутствовали в дельте. Возможно, что разработчики ФИАС уже исправили эти ошибки, и более свежие дельты следующие за 2012.09.24 содержат полную информацию, но это требует проверки.

Ошибки БД ФИАС

БД ФИАС может содержать ошибки в данных, а) связанные с нарушением целостности двунаправленных списков PREVID/NEXTID, б) ошибки, когда запись об адресном объекте имеет OPERSTATUS = 1, а в действительности произошла другая операция (переименование, переподчинение, слияние, или дробление), и в) ошибки, когда отсутствуют исторические сведения (вызванные тем, что администраторы БД ФИАС, видимо, выполняли прямое изменение данных с помощью SQL-запросов).

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

Для иллюстрации ситуации, когда отсутствуют исторические сведения можно рассмотреть адресный объект с AOGUID=»df84b14c-6006-46d1-8ce3-3a6ddf8643bd». В БД ФИАС от 2012.08.06 этот объект имел КЛАДР код равный 24000001101000100. В какой-то момент произошло переподчинение родительского объекта, и в итоге у него изменился уровень AOLEVEL с 6 на 90. Соответственно, уровень AOLEVEL дочернего объекта изменился с 7 на 91. Если взять БД ФИАС от 2014.12.01, то в ней нельзя обнаружить исторической записи с КЛАДР кодом равным 24000001101000100. Нет этой записи и в таблицах DADDROBJ.

Ошибки с неправильным OPERSTATUS слишком многочисленны, их классифицирование выходит за рамки данной статьи.

С конца 2022 года при создании нового юрлица и смене местонахождения организации ФНС стала требовать указывать юридический адрес в соответствии с официальным справочником — ГАР (Государственным адресным реестром). Он формируется, ведется и используется с помощью ФИАС — Федеральной информационной адресной системы.

Отличие ГАР в том, что в нем адреса представлены в соответствии не только с административным, но и с муниципальным делением. Если в форме Р13014 или Р11001 адрес будет указан не по ГАР, то в регистрационных действиях могут отказать. Одна из частых причин отказа заключается в том, что помещения просто нет в ФИАС. В таком случае его необходимо добавить в систему. В статье разберемся, как внести адрес в ФИАС.

Что нужно сделать для внесения адреса в ФИАС

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

Важно знать! Перечень необходимых документов зависит от региона, поэтому их лучше уточнить в администрации и у местных органов Росреестра.

Заявление о том, что вам нужно внести адрес в ФИАС, можно подать не только лично, но и онлайн через официальный сайт системы — fias.nalog.ru. Для этого нужно зарегистрироваться на платформе и сделать следующее:

• На главной странице сайта нажать «Присвоение/аннулирование адреса».

• На открывшейся странице чуть пролистать вниз и выбрать «на портале ФИАС».

• Подтвердить вход в личный кабинет.

• Перейти в раздел «Новое заявление или запрос».

• Выбрать, кто обращается за услугой — заявитель или представитель.

• Заполнить сведения о заявителе: Ф. И. О., данные документа, удостоверяющего личность, ИНН, телефон и email.

• Выбрать «Присвоение или аннулирование адреса объекта адресации».

• Указать тип права на объект адресации.

• Выбрать тип объекта: здание, участок, помещение, машино-место.

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

• Ввести данные об объекте.

• Прикрепить документы, удостоверяющие право на объект адресации.

• Подтвердить согласие на обработку данных.

• Выбрать способ получения результатов: в личном кабинете на сайте ФИАС или по email.

• Отправить заявку.

Полезно знать! Перед тем как добавить адрес в ФИАС, стоит проверить, действительно ли информация об объекте отсутствует в системе. Для этого на сайте реестра достаточно ввести в поисковую строку адрес с точностью до номера дома, а в отображенных результатах перейти на вкладку «Помещения» и посмотреть, есть ли там ваш объект.

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

Если вы меняете адрес, то не забудьте оповестить своих партнеров об этом, подав уведомление на Федресурс. Это легко сделать с помощью онлайн-сервиса «Федресурс 24», который позволяет опубликовать уведомления без электронной подписи и регистрации на сайте Федерального ресурса. Просто подайте заявку, и наш менеджер-юрист перезвонит вам в течение 9 минут, чтобы рассказать о ходе процедуры, необходимых документах и других нюансах.