Министерство иностранных дел Российской Федерации
Руководство пользователя
ВИДА СВЕДЕНИЙ В ЕДИНОЙ СИСТЕМЕ МЕЖВЕДОМСТВЕННОГО ЭЛЕКТРОННОГО ВЗАИМОДЕЙСТВИЯ Сведение «Электронная виза для посещения свободного порта Владивосток»
Дата: 20.02.2017
Версия: 1.0.1
АННОТАЦИЯ Данный документ является шаблоном руководства пользователя вида сведений СМЭВ, которое в соответствии с пунктом 48 приказа Министерства связи и массовых коммуникаций Российской Федерации от 27.12.2010 № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» является обязательным для предоставления поставщиком в адрес оператора СМЭВ.
Инструкция по использованию:
• Текст, выделенный курсивом, является примером заполнения раздела, либо является руководством по заполнению разделов шаблона и при формировании документа должен быть удален.
• Текст без специальных выделений является обязательным для использования в документе и не подлежит удалению.
Заполнение разделов необходимо выполнять согласно приведенной инструкции. Полное и корректное заполнение разделов позволит избежать многоитерационной процедуры редактирования документа. Предоставленные сведения необходимы потребителям информации для успешной интеграции с видом сведений и оператору СМЭВ для организации эффективной эксплуатации вида сведений и поддержки его работоспособности. Заполнение шаблона при разработке вида сведений СМЭВ по ранее утвержденному формату На момент подачи на регистрацию разработанного вида сведений поставщик обязан заполнить полностью все разделы документа.
В момент подачи на регистрацию в СМЭВ вида сведений поставщика, подготовленное руководство пользователя предоставляется оператору СМЭВ в zip-архиве специальной структуры, содержащем помимо данного руководства:
– заявку на регистрацию вида сведений;
– XSD-схема(ы) вида сведений, если схема вида сведений содержит вложенные схемы, необходимо предоставлять zip-архив, со следующей структурой: в корневой папке находится целевая схема и папка, в этой папке – все импортируемые схемы;
– эталонный(е) запрос(ы) и ответ(ы), эталонные запросы и ответы для вида сведений необходимо именовать Request.xml и Response.xml соответственно (если эталонных запросов и ответов не одна пара, а несколько, тогда они должны быть заархивированы в zip-архив, причем каждая пара запрос-ответ в отдельной папке):
– описание тестового сценария и XSL-схема(ы) тестового(ых) сценария(ев).
Формат zip-архива должен быть следующей структуры:
\Руководство пользователя
\Заявка на регистрацию вида сведений
\Схема.zip
\Эталоны.zip
\Тестовый сценарий.zip СОДЕРЖАНИЕ
1.Общие сведения 5
1.1.Руководящие документы 5
1.2.Описание вида сведения 6
2.Схема вида сведений и эталонные запросы и ответы 7
2.1Схема вида сведений 7
2.2Эталонные запросы и ответы 11
3.Тестовые сценарии 12
3.1Тестовый сценарий 12
4.Состав передаваемой информации 13
4.1Описание полей запроса 13
4.2Описание полей ответа на запрос 13
4.3Описание комплексных типов полей (при наличии) 14
4.3.1. Описание комплексного типа VisaPassportType 14
Тип, описывающий персональные данные человека и его документ, удостоверяющий личность 14
4.3.2. Описание комплексного типа VisaType 15
4.3.3 Описание комплексного типа ComplexDateType 17
4.4Описание проверок запроса на стороне поставщика 17
4.5Описание кодов возвратов при ошибках и неуспешных проверок 17
4.6Описание вложений 18
5.Дополнительная информация 19
5.1Состав справочной информации 19
Справочники в виде сведений не используются 19
5.2Контактная информация 19
5.3Примечания 19
изменения
-
Версия
| Дата
| Автор
| Изменения
| 1.0.1
| 14.03.2017
| Мишин С.А.
| Переработаны схема и пример запроса: добавлен элемент для табличной маршрутизации. Исправлена ошибка в идентификаторе сценария в пункте 3.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
термины/СОКРАЩЕНИя
-
Термин/сокращение
| Описание
| СМЭВ
| Система межведомственного электронного взаимодействия
| Поставщик
| Организация – владелец вида сведений
| WSDL
| Web Services Description Language — язык описания веб- сервисов.
| XSD
| XML Schema definition - язык описания структуры XML документа.
| SOAP
| Simple Object Access Protocol - протокол обмена структурированными сообщениями в распределённой вычислительной среде.
| XML
| extensible Markup Language — расширяемый язык разметки.
| ЭВ
| Электронная виза для посещения свободного порта Владивосток
|
Общие сведения
Руководящие документы
Федеральный закон от 15 августа 1996 г. N 114-ФЗ "О порядке выезда из РФ и въезда в РФ".
Федеральный закон от 25 июля 2002 г. N 115-ФЗ "О правовом положении иностранных граждан в Российской Федерации".
Федеральный закон Российской Федерации от 13 июля 2015 г. N 212-ФЗ «О свободном порте Владивосток».
Описание вида сведения
Наименование
| Электронная виза для посещения свободного порта Владивосток
| ID вида сведений в ФРГУ
|
| Содержание
| Электронная виза для посещения свободного порта Владивосток
| Поставщик
| Министерство иностранных дел Российской Федерации
| Потребители
| Министерство связи и массовых коммуникаций Российской Федерации
| Назначение
| Передача сведений о выданных МИД России электронных визах для посещения свободного порта Владивосток
| Область применения
| Межведомственное взаимодействие
| Тип запроса
| Запрос
| Тип маршрутизации
| Табличная
| Версия ВС*
| 1.0.0
| Версия МР
| 3.0
| *Примечание: при разработке новой версии ВС в новой версии руководства пользователя обязательно необходимо отмечать (с комментариями) по тексту руководства сделанные изменения XSD-схем, XML-сообщений, тестовых сценариев и т.д.
Схема вида сведений и эталонные запросы и ответы
Схема вида сведений
Основная схема «visa-xs-gosniias-1.0.0.xsd»:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ct="urn://visa.xs.gosniias/1.0.0" targetNamespace="urn://visa.xs.gosniias/1.0.0" elementFormDefault="qualified">
<xs:complexType name="EVisaType">
<xs:annotation>
<xs:documentation xml:lang="ru">Данные об оформленной визе, выданной в форме электронного документа (ВЭД)xs:documentation>
xs:annotation>
<xs:sequence>
<xs:element name="RecipientCode" type="xs:string">
<xs:annotation>
<xs:documentation xml:lang="ru">Код получателя сообщенияxs:documentation>
xs:annotation>
xs:element>
<xs:element name="Passport" type="ct:VisaPassportType"/>
<xs:element name="Visa" type="ct:VisaType"/>
<xs:element name="HolderPhoto" type="xs:base64Binary"/>
xs:sequence>
<xs:attribute name="Id" type="xs:string" use="required" fixed="PERSONAL_SIGNATURE"/>
xs:complexType>
<xs:complexType name="VisaPassportType">
<xs:annotation>
<xs:documentation xml:lang="ru">Данные документа, удостоверяющего личность владельца визыxs:documentation>
xs:annotation>
<xs:sequence>
<xs:element name="CitizenCode" type="ct:CitizenCodeType"/>
<xs:element name="SurnameLat" type="ct:SurnameLatType"/>
<xs:element name="NamesLat" type="ct:NamesLatType"/>
<xs:element name="SurnameRus" type="ct:SurnameRusType"/>
<xs:element name="NamesRus" type="ct:NamesRusType"/>
<xs:element name="BirthDate" type="ct:ComplexDateType"/>
<xs:element name="Sex" type="ct:SexType"/>
<xs:element name="PassNum" type="ct:PassNumType"/>
xs:sequence>
xs:complexType>
<xs:simpleType name="CitizenCodeType">
<xs:annotation>
<xs:documentation xml:lang="ru">Гражданство владельца визы в виде буквенного кода страны по ИКАОxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z]{1,3}"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="SurnameLatType">
<xs:annotation>
<xs:documentation xml:lang="ru">Фамилия латинскими символами согласно документу, удостоверяющему личностьxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z \-]{1,30}"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="NamesLatType">
<xs:annotation>
<xs:documentation xml:lang="ru">Имя, другие имена, отчество латинскими символами согласно документу, удостоверяющему личностьxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z \-]{1,60}"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="SurnameRusType">
<xs:annotation>
<xs:documentation xml:lang="ru">Фамилия кириллическими символамиxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[А-ЯЁ \-]{1,30}"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="NamesRusType">
<xs:annotation>
<xs:documentation xml:lang="ru">Имя, другие имена, отчество кириллическими символамиxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[А-ЯЁ \-]{1,60}"/>
xs:restriction>
xs:simpleType>
<xs:complexType name="ComplexDateType">
<xs:annotation>
<xs:documentation xml:lang="ru">Дата рожденияxs:documentation>
xs:annotation>
<xs:sequence>
<xs:element name="year">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1900"/>
<xs:maxInclusive value="2099"/>
xs:restriction>
xs:simpleType>
xs:element>
<xs:element name="month">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1"/>
<xs:maxInclusive value="12"/>
xs:restriction>
xs:simpleType>
xs:element>
<xs:element name="day">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1"/>
<xs:maxInclusive value="31"/>
xs:restriction>
xs:simpleType>
xs:element>
xs:sequence>
xs:complexType>
<xs:simpleType name="SexType">
<xs:annotation>
<xs:documentation xml:lang="ru">Пол владельца визы на русском языке. Задаётся одной буквой.xs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:length value="1"/>
<xs:enumeration value="М">
<xs:annotation>
<xs:documentation>мужской полxs:documentation>
xs:annotation>
xs:enumeration>
<xs:enumeration value="Ж">
<xs:annotation>
<xs:documentation>женский полxs:documentation>
xs:annotation>
xs:enumeration>
xs:restriction>
xs:simpleType>
<xs:simpleType name="PassNumType">
<xs:annotation>
<xs:documentation xml:lang="ru">Номер документа, удостоверяющего личность заявителяxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[\dA-Z]{1,20}"/>
xs:restriction>
xs:simpleType>
<xs:complexType name="VisaType">
<xs:annotation>
<xs:documentation xml:lang="ru">Данные визы, выданной в форме электронного документа (ВЭД)xs:documentation>
xs:annotation>
<xs:sequence>
<xs:element name="IdentVisa" type="ct:IdentVisaType"/>
<xs:element name="StartValidDate" type="ct:CommonDateType"/>
<xs:element name="EndValidDate" type="ct:CommonDateType"/>
<xs:element name="Days" type="ct:DaysType"/>
<xs:element name="Kind" type="ct:VisaKindType"/>
<xs:element name="Multiplicity" type="ct:VisaMultiplicityType"/>
<xs:element name="Purpose" type="ct:VisaPurposeType"/>
<xs:element name="DecisionNum" type="ct:UUID"/>
<xs:element name="DecisionDate" type="ct:DecisionDateType"/>
xs:sequence>
xs:complexType>
<xs:simpleType name="IdentVisaType">
<xs:annotation>
<xs:documentation xml:lang="ru">Идентификационный номер выданной ВЭДxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[А-ЯЁ]{3}[\d]{1,6}"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="DaysType">
<xs:annotation>
<xs:documentation xml:lang="ru">Разрешенный срок пребывания (в днях)xs:documentation>
xs:annotation>
<xs:restriction base="xs:unsignedShort">
<xs:minInclusive value="8"/>
<xs:maxInclusive value="8"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="VisaKindType">
<xs:annotation>
<xs:documentation xml:lang="ru">Вид визыxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[\d А-ЯЁ]{1,71}"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="VisaMultiplicityType">
<xs:annotation>
<xs:documentation xml:lang="ru">Кратность визыxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[А-ЯЁ]{1,30}"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="VisaPurposeType">
<xs:annotation>
<xs:documentation xml:lang="ru">Цельxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[\d \-/,А-ЯЁ]{1,65}"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="CommonDateType">
<xs:annotation>
<xs:documentation xml:lang="ru">Общий тип для ограничения диапазона датxs:documentation>
xs:annotation>
<xs:restriction base="xs:date">
<xs:minInclusive value="1900-01-01"/>
<xs:maxInclusive value="2099-12-31"/>
xs:restriction>
xs:simpleType>
<xs:simpleType name="UUID">
<xs:annotation>
<xs:documentation>Строковое представление UUIDxs:documentation>
xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"/>
xs:restriction>
xs:simpleType>
<xs:complexType name="EVisaConfirmationType">
<xs:sequence>
<xs:element name="DecisionNum" type="ct:UUID"/>
<xs:element name="ProcessingDate" type="xs:dateTime"/>
xs:sequence>
xs:complexType>
<xs:simpleType name="DecisionDateType">
<xs:annotation>
<xs:documentation xml:lang="ru">Дата решенияxs:documentation>
xs:annotation>
<xs:restriction base="xs:dateTime">
<xs:minInclusive value="2017-07-01T00:00:00"/>
<xs:maxInclusive value="2099-12-31T00:00:00"/>
xs:restriction>
xs:simpleType>
<xs:element name="EVisa" type="ct:EVisaType"/>
<xs:element name="EVisaConfirmation" type="ct:EVisaConfirmationType"/>
xs:schema>
|
|