Вы можете открыть актуальную версию документа прямо сейчас.
Если вы являетесь пользователем интернет-версии системы ГАРАНТ, вы можете открыть этот документ прямо сейчас или запросить по Горячей линии в системе.
Приказом Минтруда России от 20 декабря 2012 г. N 612 приложение изложено в новой редакции
Приложение
к требованиям к формату предоставления заключений
о привлечении и об использовании иностранных
работников в форме электронных документов,
утвержденным приказом Министерства труда
и социальной защиты РФ
от 19 октября 2012 г. N 327
Описание
формата информационного взаимодействия при подготовке заключения о привлечении и об использовании иностранных работников
20 декабря 2012 г.
Изменения
Версия |
Дата |
Автор |
Изменения |
1.0 |
27.01.2012 |
|
Создан впервые |
2.0 |
09.02.2012 |
|
Устранение замечаний |
3.0 |
04.04.2012 |
|
Сервис изменен в соответствии с методическими рекомендациями 2.4.4. |
4.0 |
24.10.2012 |
|
Внесены изменения в схему |
5.0 |
24.10.2012 |
|
Внесены изменения в схему |
|
|
|
|
|
|
|
|
|
|
|
|
Термины/сокращения
Термин/сокращение |
Описание |
СМЭВ |
Система межведомственного электронного взаимодействия |
Поставщик |
Организация-владелец электронного сервиса |
ИС |
Информационная система поставщика информации |
WSDL |
Web Services Description Language - язык описания веб-сервисов. |
XSD |
XML Schema definition - язык описания структуры XML документа. |
SOAP |
Simple Object Access Protocol - протокол обмена структурированными сообщениями в распределённой вычислительной среде. |
XML |
eXtensible Markup Language - расширяемый язык разметки. |
Методические рекомендации |
Методические рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии, версия 2.4.5. |
1. Общие сведения
1.1. Руководящие документы
Основанием для разработки данного документа является требование п. 48 приказа Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. N 190 "Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия" в соответствии с которым, для подключения информационной системы к системе межведомственного электронного взаимодействия Поставщик предоставляет Оператору СМЭВ следующие документы:
паспорт электронного сервиса, регистрируемого в системе взаимодействия;
методику испытаний электронного сервиса, регистрируемого в системе взаимодействия, включая контрольный пример обращения к электронному сервису;
руководство пользователя электронного сервиса, регистрируемого в системе взаимодействия.
Основанием для создания и использования электронного сервиса являются следующие документы.
а) нормативные правовые документы:
постановление Правительства Российской Федерации от 8 сентября 2010 г. N 697 "О единой системе межведомственного электронного взаимодействия";
приказ Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. N 190 "Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия";
б) технологические стандарты:
методические рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии, версия 2.4.5., одобренные Правительственной комиссией по внедрению информационных технологий в деятельность государственных органов и органов местного самоуправления (протокол заседания от 22 ноября 2012 г. N 10) (далее - Методические рекомендации).
1.2. Описание электронного сервиса
Наименование: |
Веб-сервис обработки запросов на предоставление сведений о заключениях о привлечении и об использовании иностранных работников |
Назначение: |
Веб-сервис предназначен для приема запросов через СМЭВ, возвращения статусов обработки запросов и результата обработки запросов сведений о заключениях о привлечении и об использовании иностранных работников. |
Поставщик данных: |
Органы государственной власти субъекта Российской Федерации в области содействия занятости населения |
Потребитель данных: |
Федеральная миграционная служба или ее территориальные органы |
Область применения: |
Межведомственное взаимодействие |
1.3. Операции (методы) электронного сервиса
Метод |
Назначение |
Код: processCanonicalService Наименование: Запрос на регистрацию задачи и получение результата. |
Метод предназначен как для регистрации запроса, так и для получения результата у Поставщика данных. |
1.4. Сценарии использования
Данный сценарий описывает ситуацию, когда Потребитель данных вызывает Поставщика данных с целью получения сведений о заключениях о привлечении и об использовании иностранных работников.
Запрос направляется на адрес маршрутизатора ФСМЭВ с указанием кода ОКТМО, посредством которого осуществляется динамическая маршрутизация вызова в целевой региональный орган исполнительной власти или муниципальное образование.
Сценарий предполагает асинхронный режим работы. Первый вызов осуществляет Потребитель данных. Последующие вызовы через определенные промежутки времени опрашивают Поставщика данных на предмет готовности ответных данных. В случае успешного получения данных работы по запросу прекращаются.
В случае каких-либо ошибок при обработке запроса ответ от ИС Поставщика данных будет содержать соответствующий код ошибки в поле errorCode, а также исчерпывающую текстовую информацию по ошибке в поле errorDescription.
1.5. Схема взаимодействия
Взаимодействие с СМЭВ осуществляется через интерфейсы web-сервисов подсистемы путем приема soap-запросов и выполнения запрашиваемой процедуры.
Потребитель данных должен вызвать метод processCanonicalService сервиса Поставщика данных, при этом поле BinaryData блока MessageData\AppDocument заполняется закодированной по Base64 строкой. Закодированная информация представляет собой zip-архив с XML-документом запроса в кодировке UTF-8, подготовленного по XSD-схемам запроса, приложенным в Приложении 2.
В унифицированном блоке СМЭВ в поле smev:Recipient/smev:Code Потребитель (федеральный) указывает мнемонику ИС маршрутизатора ФСМЭВ (ISMV01001), т.к. получателем сообщения является сервис-маршрутизатор, располагающийся на федеральном узле СМЭВ. В поле smev:Recipient/smev:Name Потребитель данных указывает значение "Маршрутизатор типовых сведений единой системы межведомственного электронного взаимодействия".
В блоке Message заполняется поле ОКТМО кодом целевого муниципального образования.
В ответ Поставщик данных, успешно зарегистрировав запрос, вернет уникальный номер заявки в блоке MessageData \ AppData, в поле taskld.
После этого Потребитель данных должен периодически опрашивать Поставщика данных на предмет готовности сведений о заключениях о привлечении и об использовании иностранных работников (далее - Результат), заполняя унифицированное поле smev:Status значением "PING", и ранее полученным номером запроса в блоке MessageData \ AppData, в поле taskld. Далее возможны два варианта:
в случае, если Результат еще не сформирован, в ответе вернется блок smev:Status со значением "PROCESS", при этом блок MessageData \ AppDocument \ BinaryData заполнен не будет;
в случае готовности Результата в ответе вернет блок smev:Status со значением "RESULT", а в блоке MessageData \ AppDocument поле BinaryData будет заполнено закодированной по Base64 строкой. Закодированная информация представляет собой zip-архив с XML-документом ответа в кодировке UTF-8, подготовленный по XSD-схемам ответа, приложенным в подразделе 4.2. "Приложении 2: Описание общих структур данных".
В случае каких-либо ошибок при обработке запроса ответ должен содержать соответствующий код ошибки в поле errorCode, а также исчерпывающую текстовую информацию по ошибке в поле errorDescription.
1.6. Связи с другими электронными сервисами
Данный сервис не имеет связей с другими сервисами.
2. Руководство пользователя
2.1. Операция "processCanonicalService"
2.1.1. Общие сведения
Метод: |
processCanonicalService |
Наименование: |
Получение сведений из заключения о привлечении и об использовании иностранных работников. |
Назначение: |
Метод предназначен как для регистрации запроса, так и для получения результата у Поставщика данных - органы государственной власти субъекта Российской Федерации в области содействия занятости населения. |
Здесь и далее пространства имен расшифровываются следующим образом:
smev - http://smev.gosuslugi.ru/rev111111
impl - http://impl.canonicalRequests.gov.ru
2.1.2. Описание входных параметров
Инициирующий запрос
Следует отметить, что ключевой сущностью является отдельный документ запроса, сформированный в соответствии с XSD-схемой запроса соответствующей услуги и переданный в разделе AppDocument.
При формировании инициирующего запроса необходимо указывать следующую информацию:
N |
Код параметра |
Описание параметра |
Обязательно |
Способ заполнения/Тип |
1 |
smev:AppDocument |
Блок вложения СМЭВ - заполняется в соответствии с подразделом 2.1.4. "Формирование вложения". |
+ |
smev:AppDocumentType |
Периодический запрос результата
При формировании периодического запроса результата необходимо указывать следующую информацию:
N |
Код параметра |
Описание параметра |
Обязательно |
Способ заполнения/Тип |
1 |
impl:taskld |
Идентификатор запроса в ИС РОИВ, полученный в ответе на инициирующий запрос |
+ |
xs:string |
2.1.3. Описание выходных параметров
Ответ на инициирующий запрос
Ответ на инициирующий запрос содержит следующую информацию:
N |
Код параметра |
Описание параметра |
Обязательно |
Способ заполнения/Тип |
1 |
impl:taskld |
Идентификатор вновь зарегистрированного запроса в Поставщике данных. |
+ |
xs:string |
2 |
impl:errorCode |
Код ответа - отличие его от 0 говорит о произошедшей в ИС Поставщика данных ошибке при инициации запроса |
+ |
xs:int |
3 |
impl:errorDescription |
В случае возникновения ошибки - ее описание |
- |
xs:string |
Ответ на периодический запрос результата
Конечным ответом является отдельный документ, сформированный в соответствии с XSD-схемой ответа соответствующей услуги и переданный в разделе AppDocument.
N |
Код параметра |
Описание параметра |
Обязательно |
Способ заполнения/Тип |
1 |
smev: AppDocument |
В случае готовности результата (получено значение smev:Status "RESULT") - блок будет заполнен вложением с результатом обработки запроса в соответствии с правилами, описанными в подразделе 2.1.4. "Формирование вложения". В случае, если результат еще не готов - блок заполнен не будет. |
|
smev:AppDocumenfType |
2 |
impl:errorCode |
Код ответа - отличие его от 0 говорит о произошедшей в ИС Поставщика данных ошибке |
+ |
xs:int |
3 |
impl:errorDescription |
В случае возникновения ошибки - ее описание |
- |
xs:string |
2.1.4. Формирование вложения
Порядок формирования вложения следующий:
генерация GUID по маске хххххххх-хххх-хххх-хххх-хххххххххххх, где х описывается регулярным выражением [a-z0-9];
формирование обращения в формате XML с именем req_GUID.xml. XSD-схема вложений запроса и ответа предлагается в подразделе 4.2. "Приложение 2: Описание общих структур данных";
подпись XML-запроса по стандарту PKCS#7 и получение файла подписи req_GUID.xml.sig;
XML-заявление, его подпись, а также все вложения и их подписи архивируются в zip-файл с наименованием req_GUID.zip;
код заявления req_GUID проставляется в элемент smev:RequestCode;
архив req_GUID.zip кодируется в Base64 и полученный код становится содержимым элемента smev:BinaryData в электронном сообщении СМЭВ.
Более подробная информация по формированию вложения содержится в Методических рекомендациях.
3. Методика испытаний
3.1. Общие условия
Проведение контрольных испытаний при регистрации электронного сервиса регламентировано приказом Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. N 190 "Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия".
Порядок проведения типовых испытаний предполагает следующие этапы:
проверка комплектности предоставленной документации;
проверка сетевой связности между узлом СМЭВ и точкой размещения электронного сервиса;
регистрация сервиса и тестирование сервиса на контрольном примере.
3.2. Параметры испытаний на тестовой среде
Проведение испытаний на тестовой среде перед регистрацией электронного сервиса в продуктивной среде СМЭВ является необходимым действием, обеспечивающим повышение качества и эффективности процесса и позволяющим выявлять ошибки и несоответствия разработанного сервиса заранее, а не в продуктивном контуре.
Адрес тестового экземпляра:_________________________________________
Режим функционирования тестовой среды: ______________. Особых условий доступности не определено.
Для того чтоб протестировать сервис, необходимо протестировать все операции на основании контрольных примеров.
3.3. Особые условия
Особые условия и правила проведения контрольных испытаний не предусмотрены.
4. Приложения
4.1. Приложение 1: Описание сервиса (WSDL и XSD)
Ниже приведено WSDL-описание электронного сервиса
4.1.1. Ссылки
Приведенный WSDL содержит ссылку (import) на файл форматов данных smevMessageData.xsd
4.1.2. Ссылки
Приведенный XSD содержит ссылку (import) на следующие файлы форматов данных: xoplnclude.xsd
customMessageTypes.xsd
xmldsig-core-schema.xsd
Приведенный XSD содержит ссылку (import) на стандартизованный файл форматов данных ЭП xmldsig-core-schema.xsd
4.1.2.1. XSD-описание форматов вложений
Ниже приведены XSD-схемы данных запроса и ответа, предназначенных для вложения в блок AppDocument и непосредственно представляющих собой значимую информативную часть сервиса.
4.1.2.1.1. XSD-схема, по которой должен быть сформирован документ запроса
4.1.2.1.2. XSD-схема, по которой должен быть сформирован документ ответа
4.1.2.1.3. Обе схемы ссылаются на общую схему данных
4.2. Приложение 2: Описание общих структур данных
Пространства имен в таблицах приняты следующим:
xs - http://www.w3.org/200I/XMLSchema
ds - http://www.w3.Org/2000/09/xmldsig#
smev - http://srnev.gosuslugi.ru/rev111111
impl - http://impl.canonicalRequests.gov.ru
req - http://foreignWorker.messageTypes
resp - http://foreignWorker.responseTypes
ct - http://foreignWorker.commonTvpes
impeprocessCanonicalServiceMessageType
Данный комплексный тип раскрывает содержимое блока smev: AppData в составе запроса.
Блок smev:AppData в рамках концепции имеет смысл заполнять на втором этапе схемы взаимодействия - в момент периодического опроса состояния заявки.
N |
Код параметра |
Описание параметра |
Обязательно |
Способ заполнения/ Тип |
Комментарий |
1 |
ds:Signature |
ЭП-СП - заполняется в случае, если опрос состояния производится конкретным сотрудником Потребителя. |
- |
ds.Signature |
Содержимое блока стандартизовано спецификацией xmldsig |
2 |
impl:taskld |
Уникальный идентификатор запроса, по которому производится опрос состояния |
- |
xs:string |
|
4.2.1. impl: processCanonicalServiceResponseMessageType
Данный комплексный тип раскрывает содержимое блока smev:AppData в составе ответа на запрос.
N |
Код параметра |
Описание параметра |
Обязательно |
Способ заполнения/ Тип |
Комментарий |
1 |
ds: Signature |
ЭП-СП - заполняется в случае, если ответ формируется конкретным сотрудником Поставщика. |
- |
ds:Signature |
Содержимое блока стандартизовано спецификацией xmldsig |
2 |
impl.taskld |
Уникальный идентификатор запроса, по которому производится опрос состояния |
- |
xs:string |
Заполняется в случае ответа на инициирующий запрос |
3 |
impl:errorCode |
Код ответа - см. Приложение 5. |
+ |
xs:int |
В случае ошибки - заполняется отличным от 0 значением |
4 |
impl.errorDescription |
Текстовое описание ошибки |
- |
xs:string |
Заполняется в случае, если при обработке запроса произошла какая-либо ошибка |
4.2.2. req:foreignWorkerRequest
Данный комплексный тип раскрывает содержимое xml-документа, предназначенного для вложения в блок AppDocument и непосредственно представляющий собой значимую информативную часть запроса.
N |
Код параметра |
Описание параметра |
Обязательно |
Способ заполнения/Тип |
Комментарий |
1 |
req:requestDate |
Дата обращения в УФМС |
+ |
xs:date |
|
2 |
req:employeeType |
Тип работодателя: ЮЛ / ИП / ИЮЛ |
+ |
ct:cemployeeType |
Словарь "Тип работодателя" |
3 |
reqmame |
Наименование юридического лица / ФИО ИП |
+ |
xs:string |
|
4 |
req:OGRN |
ОГРН / ОГРИП для ИП |
+* |
ct:OGRN |
Не обязательно для иностранных ЮЛ; в случае ФЛ - длина 15 символов, в остальных - 13. |
5 |
req:INN |
ИНН |
+ |
ct:INN |
В случае ФЛ - длина 10, в остальных - 12. |
6 |
req:OKVED |
Вид экономической деятельности |
+ |
ct:OKVED |
Словарь "ОКВЭД" |
7 |
req:staffAmount |
Штатная численность работников |
+ |
xs:nonNegativeInteger |
|
8 |
req:foreignStaffAmount |
Количество иностранных работников |
+ |
xs:nonNegativeInteger |
|
9 |
req:workRegion |
Сведения о территории, на которой планируется привлечение и использование иностранных работников и роде деятельности Код субъекта федерации (4 первых цифры кода ОКАТО) |
Y |
ct:regionCode |
|
10 |
req:workTerritory |
Код адмииистративно-территориальной единицы (Полный код ОКАТО) |
- |
ct:OKATO |
Словарь "Регионы ОКАТО" |
11 |
req:workFiasld |
Код ФИАС |
- |
ct:fiasId |
|
12 |
req:workOKVED |
Вид экономической деятельности |
+ |
ct:OKVED |
Словарь "ОКВЭД" |
13 |
req:employeeServiceRequests |
Сведения по подбору работников для замещения свободных рабочих мест (вакантных должностей) российскими гражданами |
- |
Последовательность req:employmentServiceR equest |
Минимальное кол-во записей = 0 |
14 |
req:plannedPositions |
Сведения о планируемом привлечении и использовании иностранных работников |
- |
Последовательность req:position |
Минимальное кол-во записей - 1 |
4.2.3. req:empioymentServiceRequest
Тип описывает сведения по подбору работников для замещения свободных рабочих мест (вакантных должностей) российскими гражданами.
|
Код параметра |
Описание параметра |
Обязательно |
Способ заполнения/Тип |
Комментарий |
1 |
req:employmentServiceName |
Наименование государственного учреждения службы занятости, куда обращался работодатель |
+ |
ct:string200 |
|
2 |
req:requestId |
Номер обращения в государственное учреждение службы занятости |
+ |
xs:string |
|
3 |
req:requestDate |
Дата обращения в государственное учреждение службы занятости |
+ |
xs:dste |
|
4.2.4. req:position
Тип описывает сведения о планируемом привлечении и использовании иностранных работников. Расширяет рассмотренный далее тип ct:attraction следующими полями:
|
Код параметра |
Описание параметра |
Обязательно |
Способ заполнения/Тип |
Комментарий |
1 |
req:salary |
Размер заработной платы по профессии, специальности, должности, руб. |
+ |
xs:nonNegativeInteger |
|
2 |
req:spec |
Если вы являетесь пользователем интернет-версии системы ГАРАНТ, вы можете открыть этот документ прямо сейчас или запросить по Горячей линии в системе.