Приложение N 19. Состав и структура файла со сведениями по иерархии в административном делении, выгружаемых из базы данных Федеральной информационной адресной системы

Приложение N 19
к приказу ФНС России
от "___" _______ 2020 г.
N _________

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

I. Общие сведения

1. Настоящий формат описывает требования к XML файлам выгрузки из базы данных Федеральной информационной адресной системы (далее - ФИАС) информации по иерархии в административном делении (далее - файл выгрузки).

2. Номер версии настоящего формата 4.01, часть 251_04 (указывается в пространстве имен).

II. Описание файла выгрузки

3. Имя файла выгрузки должно иметь следующий вид:

R_Т_GGGGMMDD_N, где:

R_Т - префикс, принимающий значение AS_ADM.HIERARCHY;

GGGG - год формирования файла выгрузки, MM - месяц, DD - день;

N - идентификационный номер файла. (Длина - от 1 до 36 знаков. Идентификационный номер файла должен обеспечивать уникальность файла).

Расширение имени файла - xml. Расширение имени файла может указываться как строчными, так и прописными буквами.

Имя файла, содержащего схему файла выгрузки

Имя файла, содержащего XSD схему файла выгрузки, должно иметь следующий вид:

AS_ADM.HIERARCHY_2_251_04_04_01_хх, где хх - номер версии схемы.

Расширение имени файла - xsd.

4. Логическая модель файла выгрузки представлена в виде диаграммы структуры файла выгрузки на рисунке 1 настоящего формата. Элементами логической модели файла выгрузки являются элементы и атрибуты XML файла. Перечень структурных элементов логической модели файла выгрузки и сведения о них приведены в таблицах 4.1-4.2 настоящего формата.

Для каждого структурного элемента логической модели файла выгрузки приводятся следующие сведения:

наименование элемента. Приводится полное наименование элемента ¹;

сокращенное наименование (код) элемента. Приводится сокращенное наименование элемента. Синтаксис сокращенного наименования должен удовлетворять спецификации XML;

признак типа элемента. Может принимать следующие значения: "С" - сложный элемент логической модели (содержит вложенные элементы), "П" - простой элемент логической модели, реализованный в виде элемента XML файла, "А" - простой элемент логической модели, реализованный в виде атрибута элемента XML файла. Простой элемент логической модели не содержит вложенные элементы;

формат элемента. Формат элемента представляется следующими условными обозначениями: Т - символьная строка; N - числовое значение (целое или дробное).

Формат символьной строки указывается в виде Т(n-k) или T(=k), где: n - минимальное количество знаков, k - максимальное количество знаков, символ "-" - разделитель, символ "=" означает фиксированное количество знаков в строке. В случае, если минимальное количество знаков равно 0, формат имеет вид Т(0-k). В случае, если максимальное количество знаков не ограничено, формат имеет вид Т(n-).

Формат числового значения указывается в виде N(m.k), где: m - максимальное количество знаков в числе, включая знак (для отрицательного числа), целую и дробную часть числа без разделяющей десятичной точки, k - максимальное число знаков дробной части числа. Если число знаков дробной части числа равно 0 (то есть число целое), то формат числового значения имеет вид N(m).

Для простых элементов, являющихся базовыми в XML, например, элемент с типом "date", поле "Формат элемента" не заполняется. Для таких элементов в поле "Дополнительная информация" указывается тип базового элемента;

признак обязательности элемента определяет обязательность наличия элемента (совокупности наименования элемента и его значения) в файле выгрузки. Признак обязательности элемента может принимать следующие значения: "О" - наличие элемента в файле выгрузки обязательно; "Н" - наличие элемента в файле выгрузки необязательно, то есть элемент может отсутствовать. Если элемент принимает ограниченный перечень значений (по классификатору, кодовому словарю и тому подобному), то признак обязательности элемента дополняется символом "К". Например, "ОК". В случае, если количество реализаций элемента может быть более одной, то признак обязательности элемента дополняется символом "М". Например, "НМ" или "ОКМ".

К вышеперечисленным признакам обязательности элемента может добавляться значение "У" в случае описания в XML схеме условий, предъявляемых к элементу в файле выгрузки, описанных в графе "Дополнительная информация". Например, "НУ" или "ОКУ";

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

Рисунок 1. Диаграмма структуры файла выгрузки

Таблица 4.1

Состав и структура файла со сведениями по иерархии в административном делении (ITEMS)

Наименование элемента	Сокращенное наименование (код) элемента	Признак типа элемента	Формат элемента	Признак обязательности элемента	Дополнительная информация
Сведения по иерархии в административном делении	ITEM	С		ОМ	Состав элемента представлен в табл. 4.2

Таблица 4.2

Сведения по иерархии в административном делении (ITEM)

Наименование элемента	Сокращенное наименование (код) элемента	Признак типа элемента	Формат элемента	Признак обязательности элемента	Дополнительная информация
Уникальный идентификатор записи. Ключевое поле.	ID	A	N(19)	О
Глобальный уникальный идентификатор объекта	OBJECTID	A	N(19)	О
Идентификатор родительского объекта	PARENTOBJID	A	N(19)	Н
ID изменившей транзакции	CHANGEID	A	N(19)	О
Код региона	REGIONCODE	A	Т(1-4)	Н
Код района	AREACODE	A	Т(1-4)	Н
Код города	CITYCODE	A	Т(1-4)	Н
Код населенного пункта	PLACECODE	A	Т(1-4)	Н
Код ЭПС	PLANCODE	A	Т(1-4)	Н
Код улицы	STREETCODE	A	Т(1-4)	Н
Идентификатор записи связывания с предыдущей исторической записью	PREVID	A	N(19)	Н
Идентификатор записи связывания с последующей исторической записью	NEXTID	A	N(19)	Н
Дата внесения (обновления) записи	UPDATEDATE	A		О	Типовой элемент <date>
Начало действия записи	STARTDATE	A		О	Типовой элемент <date>
Окончание действия записи	ENDDATE	A		О	Типовой элемент <date>
Признак действующего адресного объекта	ISACTIVE	А	N(=1)	ОК	Принимает значение:  0 - недействующий адресный объект | 1 - действующий

------------------------------

*(1) В строке таблицы могут быть описаны несколько элементов, наименования которых разделены символом "|". Такая форма записи применяется при наличии в файле выгрузки только одного элемента из описанных в этой строке.

------------------------------