II. ОПИСАНИЕ ДОКУМЕНТА ОБМЕНА

3. Параметры первой строки документа обмена.

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

<?xml version="1.0" encoding="UTF-8"?>.

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

fns-esiaingr-ru-root.xsd, где xsd - расширение имени файла.

Целевое пространство имен XML-схемы имеет вид:

targetNamespace="urn://x-artefacts-fns-esiaingr/root/314-51/4.0.0",

где:

префикс fns-esiaingr определяет вид передаваемой информации;

значение 314-51 определяет номер формата;

значение 4.0.0 определяет версию настоящего формата.

XML-схема документа обмена включает описание двух корневых элементов:

ESIAINGRRequest - Сведения из Единой системы идентификации и аутентификации об иностранном гражданине или лице без гражданства, прошедшем проверку;

ESIAINGRResponse - Ответ на запрос, содержащий сведения из Единой системы идентификации и аутентификации об иностранном гражданине или лице без гражданства, прошедшем проверку.

XML-схема документа обмена приводится отдельным файлом. Обязательным приложением к XML-схеме документа обмена является XML-схема (fns-esiaingr-types.xsd), содержащая описание используемых типовых элементов.

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

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

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

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

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

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

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

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

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

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

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

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

Таблица 4.1.1

Сведения из Единой системы идентификации

и аутентификации об иностранном гражданине или лице

без гражданства, прошедшем проверку (ESIAINGRRequest)

Таблица 4.1.2

Сведения об иностранном гражданине или лице

без гражданства (СвФЛ)

Таблица 4.1.3

Фамилия, имя, отчество иностранного гражданина или лица

без гражданства (ФИОПрТип)

Таблица 4.1.4

Сведения о документе, удостоверяющем личность (УдЛичнФЛТип)