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

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

2. Номер версии настоящего формата 4.01, часть 230_23.

3. Имя файла обмена должно иметь следующий вид:

R_T_P_O_GGGGMMDD_N, где:

R_T - префикс, принимающий значение: VO_MATKAP23;

Р - идентификатор получателя информации, принимает значение 0000;

О - идентификатор отправителя информации представляется в виде девятнадцатиразрядного кода (идентификационный номер налогоплательщика (ИНН) и код причины постановки на учет (КПП));

GGGG - год формирования передаваемого файла, ММ - месяц, DD - день;

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

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

Параметры первой строки файла обмена

Первая строка XML-файла должна иметь следующий вид:

<?xml version="1.0" encoding = "windows-1251"?>

Имя файла, содержащего XML-схему файла обмена, должно иметь следующий вид:

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

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

XML- схема файла обмена приводится отдельным файлом.

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

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

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

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

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

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

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

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

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

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

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

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

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