Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» Федеральная служба по надзору в сфере защиты прав потребителей и благополучия человека РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ ЭЛЕКТРОННОГО СЕРВИСА СМЭВ SID0003399 Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарноэпидемиологических правил и нормативов (версия 2.4.3) Дата: 06-03-2013 Версия: 1.4 (9) Листов: 15 1 Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» СОДЕРЖАНИЕ ОБЩИЕ СВЕДЕНИЯ ......................................................................................................................5 1.1 Руководящие документы .................................................................................................................. 5 1.2 Описание электронного сервиса ...................................................................................................... 5 1.3 Операции (методы) электронного сервиса ..................................................................................... 6 1.4 Сценарии использования .................................................................................................................. 6 1.5 Схема взаимодействия...................................................................................................................... 6 1.6 Связи с другими электронными сервисами .................................................................................... 7 2 РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ.............................................................................................7 2.1 Операция «Получение сведений из СЭЗ Т» ................................................................................... 7 1 2.1.1 Общие сведения ......................................................................................................................... 7 2.1.2 Описание входных параметров ................................................................................................ 7 2.1.3 Описание выходных параметров ............................................................................................ 10 2.1.4 Коды возвратов (контейнер status атрибут code-error) ......................................................... 13 2.1.5 Контрольные примеры ............................................................................................................ 14 3 МЕТОДИКА ИСПЫТАНИЙ .......................................................................................................14 3.1 Общие условия ................................................................................................................................ 14 3.2 Параметры испытаний на тестовой среде .................................................................................... 14 3.3 Параметры испытаний на продуктивной среде ........................................................................... 14 4 ПРИЛОЖЕНИЯ.............................................................................................................................15 4.1 Описание сервиса (WSDL и XSD)................................................................................................. 15 4.2 Описание общих структур данных................................................................................................ 15 2 Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» ИЗМЕНЕНИЯ Версия Дата Автор Изменения Все документации под-версий 1.5.* аналогичны документации по ЭС SID0003365 версии 1.4 от 28-02-2012 (соответствие МР 2.3.4) 1.4 11-03-2012 В данной документации заменены архивы контрольных примеров, WSDL и XSD в соответствии с МР 2.4.3 1.4 (1) 19-03-2012 В данной документации заменены архивы контрольных примеров, WSDL и XSD (исправлена ошибка с ЭП в КП) 1.4 (2) 21-03-2012 В данной документации заменен архив WSDL (исправлены ошибки с адресом в WSDL) 1.4 (3) 20-04-2012 Добавлен код возврата «999» — «ip-адрес системы, сформировавшей запрос, отсутствует в списке зарегистрированных ip-адресов» 1.4 (4) 25-04-2012 Откорректировано пояснение для кода возврата «999» Указан присвоенный новый адрес тестового ЭС 1.4 (5) 21-06-2012 Обновлены КП (в т.ч. - откорректированы мнемоники Роспотребнадзора в КП). Расширено описание ошибок. Добавлено описание маски номера СЭЗ Т 1.4 (6) 24-08-2012 Откорректировано в xsd: Откорректированы тип элементов и атрибутов Исправлен порядок элементов удален элемент dateup Откорректировано в документации: признаки обязательности параметров Добавлено описание «org» Откорректированы описания ошибок удален элемент dateup Обновлены архивы КП и WSDL/XSD. 1.4 (7) 28-08-2012 В ответ ЭС добавлен OriginRequestIdRef Обновлены архивы КП и WSDL/XSD. 1.4 (8) 1.4 (9) 10-02-2013 06-03-2013 Обновлен архив КП (КП переподписаны) Откорректированы описания входных параметров firmget_full и firmget_short 3 Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» ТЕРМИНЫ/СОКРАЩЕНИЯ Термин/сокращение СМЭВ Поставщик WSDL XSD SOAP XML СЭЗ Т Описание Система межведомственного электронного взаимодействия Организация-владелец электронного сервиса Web Services Description Language — язык описания веб-сервисов. XML Schema definition - язык описания структуры XML документа. Simple Object Access Protocol протокол обмена структурированными сообщениями в распределённой вычислительной среде. eXtensible Markup Language — расширяемый язык разметки. Санитарно-эпидемиологическое заключение о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов 4 Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» 1 ОБЩИЕ СВЕДЕНИЯ 1.1 Руководящие документы Основанием для разработки данного документа является требование п. 48 Приказа Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» в соответствии с которым, для подключения информационной системы к системе межведомственного электронного взаимодействия Поставщик предоставляет Оператору СМЭВ следующие документы: паспорт электронного сервиса, регистрируемого в системе взаимодействия; методику испытаний электронного сервиса, регистрируемого в системе взаимодействия, включая контрольный пример обращения к электронному сервису; руководство пользователя взаимодействия. электронного сервиса, регистрируемого в системе Основанием для создания и использования электронного сервиса являются перечисленные ниже документы. Нормативно-правовые документы: Постановление Правительства Российской Федерации от 8 сентября 2010 г. № 697 «О единой системе межведомственного электронного взаимодействия»; Приказ Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия». 1.2 Описание электронного сервиса Наименование: Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов (версия 2.4.3) Назначение: Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов Поставщик: Федеральная служба по надзору в сфере защиты прав потребителей и благополучия человека Область применения: Межведомственное взаимодействие 5 Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» 1.3 Операции (методы) электронного сервиса Электронный сервис «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов» обеспечивает получение сведений из СЭЗ Т по ряду параметров. Электронный сервис включает методы, обеспечивающие: Получение сведений из СЭЗ Т. Метод Назначение Код: getsez Наименование: Получение сведений из СЭЗ Т Принимает параметры для поиска СЭЗ Т в реестре, возвращает сведения из найденных по параметрам СЭЗ Т 1.4 Сценарии использования Информационная система ведомства вызывает сервис и передает параметры для поиска СЭЗ Т. Взаимодействие организовано в синхронной схеме. 1.5 Схема взаимодействия 1) В рамках взаимодействия информационная система ведомства направляет в адрес сервиса сообщение запрос с информацией о фирме-получателе и (или) реквизитах документа в унифицированном виде. 2) Полученный запрос сервис обрабатывает, обращаясь к реестру санитарноэпидемиологических экспертиз и синхронно возвращает результат по запросу. Схема взаимодействия представлена на рисунке 1. СМЭВ ИС ведомства заявителя Сервис приема заявок от ФОИВ Запрос Сервис приема заявок от СМЭВ Заявка 2 5 1 9 Ответ РосПотребНадзор Ответ Рисунок 1 «Схема взаимодействия» 6 Реестр СЭЗ Заявка 3 4 Ответ Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» 1.6 Связи с другими электронными сервисами Данный сервис не имеет связей с другими сервисами. 2 РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ 2.1 Операция «Получение сведений из СЭЗ Т» 2.1.1 Общие сведения Код операции: getsez Наименование операции: Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных нормативов Назначение операции: Получение санитарно-эпидемиологических сведений из сан-эпид заключений правил на и проектную документацию 2.1.2 Описание входных параметров Входные данные: getsez Обя зате льн ость № Код параметра Описание параметра «*» — 0 или 1 значен ие «***» — 0, 1 или более значен ий Способ заполнен ия/Тип Комментарий s:string 13 или 15 цифр «+» — 1 значен ие ogrn ОГРН фирмы- * получателя 1.1 доступен для поиска СЭЗ Т, выданных полсе 1 августа 2011 inn ИНН фирмы- получателя * s:string 1.2 1.3 10 или 12 цифр доступен для поиска СЭЗ Т, выданных полсе 1 августа 2011 serialnumb типографский номер бланка * s: s:unsigned 7 цифры Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» Long 1.4 numb Номер документа * s:string До 30 символов (описание ниже) firmget_full Полное наименование фирмы- получателя * s:string Указанные в наименовании фирмы знаки препинания при поиске игнорируются firmget_short Краткое наименование фирмы- получателя * s:string Указанные в наименовании фирмы знаки препинания при поиске игнорируются firmget Часть названия фирмы- * s:string Например: для поиска ООО 1.5 1.6 получателя «Титан» по части названия можно указать - Титан Для уточнения поиска можно указать – ООО Титан 1.7 Все знаки препинания (с одной из сторон которых стоят пробелы) удаляются. Слова, разделенные пробелами, объединяются при поиске логическим «И». mode Режим поиска + s:string Значения: «and» «serial» Значение «and» указывает, что все переданные параметры для поиска требуется объединить в единое условие логической операцией «И» Значение «serial» указывает, что поиск осуществляется сначала по ОГРН (если найден 1.8 хотя бы один СЭЗ Т поиск прекращается), потом по ИНН (условие прекращения поиска аналогично ОГРН), потом по типографскому номеру бланка (условие прекращения поиска аналогично ОГРН), потом по номеру документа (условие прекращения поиска 8 Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» аналогично ОГРН), потом по полному названию фирмызаявителя (условие прекращения поиска аналогично ОГРН), потом по короткому названию фирмызаявителя (условие прекращения поиска аналогично ОГРН), потом по части названия фирмызаявителя Рекомендуется обеспечить наличие значения как минимум у одного параметра из перечисленных в п. 1.1-1.7 9 Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» Маска номера документа (СЭЗ Т) 99.XX.99.999.Т.999999.99.99 где: «9» - любой числовой символ от «0» до «9» «X» - любой символ от «0» до «9» и от «А» до «Я» (русский алфавит) «Т» - русская буква «Т» 2.1.3 Описание выходных параметров Выходные данные: rpnsezt2:Response Обязате льность № Код параметра Описание параметра «*» — 0 или 1 значение «***» — 0, 1 или более значений Способ заполнения/Ти п Комментари й «+» — 1 значение 1. общая информация + sezt2-info date дата и время ответа + s:string version версия модуля + s:string subversion подверсия модуля + s:string status неформализованный текстовый комментарий к результату запроса + type тип ответа на запрос + 1.1 s:string «OK» или «ERROR» code-error код ошибки + s:integer flag-found найдены данные или нет + s:integer «0» или «1» 10 OK - не было ошибки в запросе | ERROR ошибка в запросе См. раздел 2.1.4 1 – данные найдены 0 – данные не найдены Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» присутствует в ответе только при условии, что данные найдены rows документы * count количество найденных документов, переданных в ответе + s:integer overflow признак того, что переданы не все из найденных документов * s:integer 1.2 «1» 1.2.1 row документ *** 1.2.1.1 numb номер документа + value значение + date дата документа + value значение + serialnumb типографский номер бланка + value значение + 1.2.1.2 1.2.1.3 присутствует в ответе только при условии, что найдено данных больше лимита по количеству s:string номер документа s:string дата документа s: unsignedLong номер бланка указывается без лидирующих нулей prodnm неформализованное название проектной документации + enableuse Соответствует или не соответствует государственным санитарноэпидемиологическим правилам и нормативам + value значение + 1.2.1.4 1.2.1.5 s:string s:integer «1» или «0» 11 1– соответствует 0 – не соответствует Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» 1.2.1.6 firmget Фирма-получатель + inn ИНН + s:string ogrn ОГРН + s:string info Название фирмыполучателя, включая юридический адрес (если таковой был указан при заполнении документа). + s:string + s:string + s:string 1.2.1.6.1 1.2.1.7 protocol info для признания представленных документов соответствующими (не соответствующими) государственным санитарноэпидемиологическим правилам и нормативам 1.2.1.7.1 org территориальный орган + Роспотребнадзора, выдавший документ 1.2.1.8 info Название территориального органа Роспотребнадзора + pril приложение к документу + is_pril признак: передается или нет в ответе приложение + 1.2.1.8.1 1.2.1.9 неформализованный текст с указанием основания если таковой был указан при заполнении документа, иначе пусто если таковой был указан при заполнении документа, иначе пусто Данное поле полностью соответствует информации, которая была напечатана на бланке в соответствую щем разделе. s:string s:string «on» или «off» 12 on – в ответе на запрос передается текст Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» приложения off – в ответе не передается текст приложения 1.2.1.9.1 info текст приложения + s:string 2.1.4 Коды возвратов (контейнер status атрибут code-error) № Код возврата Описание кода возврата 1 1 ошибка в параметре serialnumb Условия возникновения неверно сформирован запрос Комментарий указано «нечисло» указан номер документа не 2 2 неверно ошибка в параметре numb сформирован запрос соответствующий следующей маске номера документа (см. описание маски выше) отсутствуют какие либо 3 3 неверно параметры запроса (пустой сформирован запрос запрос) технический сбой (например, 4 5 отсутствие доступа к БД) ошибка в других (не описанных 5 6 отдельно в данном списке ошибок) параметрах запроса 6 7 ошибка в ИНН 7 8 ошибка в ОГРН 8 999 9 0 У системы, сформировавшей запрос, отсутствует доступ к ЭС Ошибок нет. техническая или Например, отсутствие программная доступа модуля, ошибка на стороне обеспечивающего работу ЭС ЭС, к БД Реестра неверно сформирован запрос неверно указан неверный ИНН, сформирован запрос например: 1234567890 неверно указан неверный ОГРН, сформирован запрос например: 1234567890123 отсутствие доступа всё верно 13 Используется при работе в тестовой среде Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» 2.1.5 Контрольные примеры Запросы и ответы на запросы 3 МЕТОДИКА ИСПЫТАНИЙ 3.1 Общие условия Проведение контрольных испытаний при регистрации электронного сервиса регламентировано Приказом Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия». Порядок проведения типовых испытаний предполагает следующие этапы: Проверка комплектности предоставленной документации; Проверка сетевой связности между узлом СМЭВ и точкой размещения электронного сервиса; Регистрация сервиса и тестирование сервиса на контрольном примере. 3.2 Параметры испытаний на тестовой среде Контактное лицо: Аксенов Глеб Владимирович, e-mail: gleb@crc.ru, тел: (495) 364-79-66 Адрес: http://188.254.16.92:7777/gateway/services/SID0003233?wsdl Режим функционирования тестовой среды: 19/365, c 00:00 до 19:00 3.3 Параметры испытаний на продуктивной среде Контактное лицо: Аксенов Глеб Владимирович, e-mail: gleb@crc.ru, тел: (495) 364-79-66 Адрес: http://oraas.rt.ru:7777/gateway/services/SID0003399?wsdl Режим функционирования тестовой среды: 19/365, c 00:00 до 19:00 14 Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно- эпидемиологических правил и нормативов (версия 2.4.3)» 4 ПРИЛОЖЕНИЯ 4.1 Описание сервиса (WSDL и XSD) 4.2 Описание общих структур данных № Код параметра Описание параметра Обязательность Способ заполнения/Тип Комментарий - - - - - - 15