Использование единого формата адресных данных является обязательным требованием при взаимодействии с Федеральной налоговой службой (ФНС России). Независимо от того‚ регистрируете вы юридическое лицо‚ сдаете отчетность‚ работаете с онлайн-кассами (ККТ) или обмениваетесь данными по ЭДО, адрес должен быть структурирован в соответствии с Федеральной информационной адресной системой (ФИАС) и Государственным адресным реестром (ГАР).
Ниже представлена подробная статья‚ охватывающая нормативную базу‚ техническую структуру‚ форматы обмена (XML/JSON) и практические нюансы заполнения адресов в формате ФНС.
Нормативная правовая база
Основным документом‚ регламентирующим состав и структуру адресных данных‚ является Приказ ФНС России от № ЕД-7-14/820@ «Об утверждении формата электронного сообщения‚ адресата электронного сообщения‚ порядка и срока направления электронного сообщения в Федеральную налоговую службу» (в ред. от и более поздних редакций).
Ключевые акты‚ на которые ссылается ФНС:
- ФЗ № 149-ФЗ «Об информации‚ информационных технологиях и о защите информации» (база для ФИАС).
- ФЗ № 218-ФЗ «О государственной регистрации недвижимости» (переход к ГАР).
- Постановление Правительства РФ № 1103 «Об утверждении Правил формирования и ведения Федеральной информационной адресной системы».
- Приказ Минэкономразвития № 443 «Об утверждении административного регламента ведения ФИАС».
- Приказ ФНС № ММВ-7-14/547@ (форматы для ККТ/ФФД 1.2).
Важно: С 2022 года ФИАС интегрирован в ГАР (Государственный адресный реестр). Официальным источником актуальных адресных данных является портал ФИАС/ГАР на сайте ФНС. Использование устаревших баз (например‚ КЛАДР) недопустимо для отчетности.
Иерархическая структура адресного объекта (АО)
В формате ФНС адрес представляет собой набор адресных объектов (АО)‚ выстроенных в иерархию от региона до помещения. Каждый объект имеет уникальный идентификатор и набор атрибутов.
Уровни иерархии (Основные):
- Уровень 1: Регион (Область‚ Край‚ Республика‚ Город федерального значения‚ Автономная область/округ).
- Уровень 2: Район (внутри региона)‚ Город (подчиненный региону)‚ Внутригородская территория.
- Уровень 3: Населенный пункт (Город‚ Поселок городского типа‚ Село‚ Деревня и т.д.).
- Уровень 4: Элементы планировочной структуры (Район в городе‚ Округ‚ Микрорайон).
- Уровень 5: Элементы улично-дорожной сети (Улица‚ Проспект‚ Переулок‚ Площадь‚ Шоссе и др.).
- Уровень 6: Здания/Сооружения (Дом‚ Корпус‚ Строение‚ Владение).
- Уровень 7: Помещения (Квартира‚ Офис‚ Помещение‚ Бокс).
Ключевые атрибуты адресного объекта (Структура записи)
Каждый АО в формате обмена (XML/JSON) содержит стандартный набор полей. Ниже приведены наиболее критичные для заполнения деклараций‚ регистрации и ККТ.
| Атрибут (XML/JSON) | Назначение | Тип/Пример | Обязательность |
|---|---|---|---|
| AOID / objectId | Уникальный идентификатор записи в ФИАС/ГАР (UUID/GUID). Основной ключ ссылки. | GUID Пример: 0c5b2444-70a0-4932-980c-b4dc0d3f02b5 | Да (для машинного обмена) |
| FORMALNAME | Официальное наименование объекта. | String Пример: Москва‚ Ленина | Да |
| SHORTNAME / TYPENAME | Краткое наименование типа объекта (сокращение). | String Пример: г‚ ул‚ д‚ кв | Да |
| AOLEVEL / level | Уровень адресного объекта (1–7). | Integer (1-7) | Да |
| PARENTGUID / parentId | Идентификатор родительского объекта (ссылка на уровень выше). | GUID | Да (кроме уровня 1) |
| HOUSENUM / houseNum | Номер дома (для АО уровня 6). | String Пример: 10‚ 15А | Для уровня 6 |
| BUILDNUM / buildNum | Номер корпуса/строения/владения. | String Пример: 2‚ Стр. 3 | Если есть |
| FLATNUM / flatNum | Номер помещения (квартиры‚ офиса). | String Пример: 5‚ 101-А | Для уровня 7 |
| POSTALCODE / postalCode | Почтовый индекс. | String (6 цифр) | Рекомендуется |
| OKATO / OKTMO | Коды классификаторов территорий (для налоговой отчетности). | String (8/11 знаков) | Для юрлиц/ИП |
| UPDATEDATE / updateDate | Дата актуальности версии записи. | Date (YYYY-MM-DD) | Системное |
| ACTSTATUS / isActive | Статус актуальности (1 — актуальный‚ 0, неактуальный/исторический). | Boolean / Int | Только ACTSTATUS=1 |
Форматы обмена данными: XML и JSON
ФНС принимает данные в двух основных форматах в зависимости от сервиса.
XML-формат (Классический обмен‚ ЕГРЮЛ/ЕГРИП‚ некоторые отчетности)
Используется в схемах xsd‚ публикуемых на сайте ФНС (например‚ для форм Р11001‚ Р21001‚ деклараций). Структура вложенная.
<Address>
<AddressObject AOID="0c5b2444-70a0-4932-980c-b4dc0d3f02b5"
FORMALNAME="Москва"
SHORTNAME="г"
AOLEVEL="1"
PARENTGUID=""
OKATO="45000000000"
OKTMO="45000000"
POSTALCODE="101000"
ACTSTATUS="1" />
<AddressObject AOID="1a2b3c4d-..."
FORMALNAME="Тверская"
SHORTNAME="ул"
AOLEVEL="5"
PARENTGUID="0c5b2444-70a0-4932-980c-b4dc0d3f02b5" />
<AddressObject AOID="5e6f7g8h-..."
FORMALNAME="10"
SHORTNAME="д"
AOLEVEL="6"
PARENTGUID="1a2b3c4d-..."
HOUSENUM="10" />
<AddressObject AOID="9i0j1k2l-..."
FORMALNAME="5"
SHORTNAME="кв"
AOLEVEL="7"
PARENTGUID="5e6f7g8h-..."
FLATNUM="5" />
</Address>
JSON-формат (API ФНС‚ ГАР‚ ККТ ФФД 1.2‚ ЭДО)
Современный стандарт для REST API (например‚ api.nalog.ru‚ сервис «Прозрачный бизнес»‚ фискализация). Часто используется плоская структура или массив объектов.
{
"address": {
"kladrId": "###00"‚
"fiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5"‚
"fiasLevel": "1"‚
"region": "Москва"‚
"regionType": "г"‚
"city": null‚
"settlement": null‚
"street": "Тверская"‚
"streetType": "ул"‚
"house": "10"‚
"block": "2"‚
"flat": "5"‚
"postalCode": "125009"‚
"okato": "45000000000"‚
"oktmo": "45000000"‚
"coordinates": { "lat": 55.759‚ "lon": 37.611 }
}
}
Особенность ФФД 1.2 (Тег 1272 / 1273): При регистрации ККТ и передаче данных в ОФД адрес места расчетов передается в теге 1272 (Адрес места расчетов) в виде строки‚ но строго по ФИАС. Рекомендуемый шаблон строки:
г Москва‚ ул Тверская‚ д 10‚ кв 5(типы через пробел‚ без точек).
Специфика заполнения для разных задач
Регистрация юрлиц и ИП (Формы Р11001‚ Р21001)
- Адрес должен быть достоверным и соответствовать документу на право собственности/аренде.
- Обязательно указание ОКТМО (для налогового учета) и ОКАТО (если требуется статистикой).
- Для ИП — адрес места жительства (по паспорту/виде на жительство). Для юрлиц — адрес места нахождения (юридический адрес).
- В XML-схеме регистрации используется комплексный тип
AddressTypeс вложеннымиAddressItem.
Онлайн-кассы (ККТ) и ФФД 1.2
- При регистрации ККТ (форма 1-РК) адрес места установки ККТ передается в ФНС.
- В фискальном накопителе (ФН) и при отправке чеков в ОФД используется тег 1272 (Адрес места расчетов).
- Формат строки:
Субъект РФ‚ Район‚ Нас.пункт‚ Улица‚ Дом‚ Корпус‚ Строение‚ Помещение. Пустые уровни пропускаются. - Недопустимо использование аббревиатур‚ не входящих в Классификатор адресных объектов (например‚ «просп.» вместо «пр-кт»‚ «м-н» вместо «мкр»).
Электронный документооборот (ЭДО) и СБИС/Диадок/Контур
- Операторы ЭДО валидируют адреса через API ФИАС/ГАР (Дадата‚ ФНС API) перед отправкой.
- Требуется передача FIAS ID (GUID) для каждого уровня адреса (region‚ city‚ street‚ house).
- Если адрес не найден в ФИАС (новостройка)‚ необходимо обратиться в МФЦ/ФНС для присвоения адреса и внесения в ГАР.
Работа с API ФИАС / ГАР (Получение актуальных данных)
Для автоматизации систем учета (1С‚ CRM‚ ERP) используется официальное API ФНС.
Основные эндпоинты (Примеры):
- Поиск по строке:
https://fias.nalog.ru/WebServices/Public/FindAddr?query=Москва Тверская 10 - Получение объекта по GUID:
https://fias.nalog.ru/WebServices/Public/GetAddrObject?guid=0c5b2444-70a0-4932-980c-b4dc0d3f02b5 - Получение детей (иерархия):
https://fias.nalog.ru/WebServices/Public/GetChildren?guid=PARENT_GUID - Скачивание полной базы (XML/DBF): Доступно в личном кабинете на
fias.nalog.ru-> «Выгрузки данных» (требует авторизации ЕСИА/Ключом).
Типы выгрузок на портале ФИАС:
- Полная выгрузка (Full): Весь реестр (несколько ГБ)‚ для первичной загрузки.
- Дельта-выгрузка (Delta): Ежедневные изменения (новые дома‚ переименования‚ удаления). Критично для актуальности.
- Адреса в формате JSON/CSV: Упрощенные выгрузки для веб-сервисов.
Типичные ошибки и как их избежать
| Ошибка | Последствие | Решение |
|---|---|---|
| Использование кодов КЛАДР вместо ФИАС/ГАР | Отказ в приеме отчетности/регистрации (КЛАДР устарел с 2014 г.‚ полностью исключен из 2022 г.) | Перейти на GUID (AOID) ФИАС. КЛАДР код (13/17 знаков) не является идентификатором в ФНС. |
| Указание неактуального (исторического) адреса (ACTSTATUS=0) | Ошибка валидации схемы XSD/JSON‚ отказ ФНС. | Проверять флаг ACTSTATUS=1 перед отправкой. Использовать дельта-выгрузки. |
| Несоответствие иерархии (ParentGUID не совпадает с родителем) | Логическая ошибка адреса‚ невозможность определения налогового органа. | Строить дерево строго по ParentGUID от региона к дому. |
| Отсутствие ОКТМО для юрлица/ИП | Невозможность сдачи деклараций‚ ошибки в налоговом учете. | Брать ОКТМО из атрибутов АО уровня «Населенный пункт» или «Район». |
| Ручное написание строки адреса без привязки к ФИАС (опечатки‚ архаичные названия) | Проблемы с доставкой почты‚ отказ банков/контрагентов‚ ошибки ККТ. | Использовать подсказки (DaData‚ ФНС API) при вводе пользователем. |
| Игнорирование корпусов/строений (теги BUILDNUM‚ STRUCNUM) | Дубликаты адресов‚ ошибки идентификации объекта недвижимости. | Обязательно заполнять отдельными полями/АО уровня 6‚ если они есть в документах на недвижимость. |
Инструменты проверки и валидации
- Сервис «Найти адрес» на fias.nalog.ru — ручная проверка по строке или GUID.
- API «Прозрачный бизнес» (pb.nalog.ru) — проверка контрагентов‚ в т.ч. адреса регистрации.
- Сервисы подсказок (DaData‚ Кладр в облаке‚ Яндекс.Справочник API) — для фронтенда при вводе пользователями.
- Валидаторы схем XSD (XMLSpy‚ Notepad++ с плагином‚ онлайн-валидаторы) — перед отправкой отчетности.
Актуальные изменения 2024–2026 гг.
- Полный переход на ГАР: ФИАС как самостоятельная система перестал пополняться‚ все актуальные данные только в ГАР. Форматы выгрузок изменены (новые атрибуты:
GAR_ID‚OBJECT_GUID). - Уточнение типов адресных объектов: Внедрены новые типы (например‚ «территория»‚ «парк»‚ «территория садоводческого товарищества») — обновите справочники
SOCRBASE(классификатор сокращений). - Требования к ККТ (ФФД 1.2): Жесткий контроль соответствия адреса в ФН и адреса в чеке данным ГАР.
- ЕГРЮЛ/ЕГРИП: При подаче документов в электронном виде через сервис «Регистрация юрлиц/ИП» на nalog.ru происходит автоматическая валидация адреса по ГАР в реальном времени.
Резюме: Чек-лист для разработчика/бухгалтера
- [ ] Используете ли вы GUID (AOID) из ФИАС/ГАР как первичный ключ?
- [ ] Обновляете ли вы локальную базу адресов ежедневно (дельта-выгрузки)?
- [ ] Проверяете ли вы флаг ACTSTATUS = 1 (актуальность)?
- [ ] Соответствует ли структура адреса иерархии Регион → Нас.пункт → Улица → Дом → Помещение?
- [ ] Заполнены ли ОКТМО/ОКАТО для налоговых целей?
- [ ] Для ККТ: соответствует ли строка адреса (тег 1272) формату ФИАС без лишних символов?
- [ ] Используете ли вы официальный Сокращения типов (SOCRBASE) (г‚ ул‚ д‚ кв‚ корп‚ стр)?
Формат адреса ФНС, это не просто набор строк‚ а строго типизированная иерархическая модель данных‚ основанная на ФИАС/ГАР. Ключевым элементом является глобальный уникальный идентификатор (GUID/AOID)‚ связывающий каждый элемент адреса в единую цепочку. Несоблюдение формата ведет к отказам в регистрации‚ штрафам за несдачу отчетности‚ проблемам с фискализацией и ошибкам в ЭДО.
Рекомендация: Внедрите в свои информационные системы модуль автоматической синхронизации с дельта-выгрузками ГАР (портал fias.nalog.ru) и используйте API подсказок на этапе ввода данных пользователем. Это гарантирует 100% прохождение валидации на стороне ФНС.