Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов (версия 2.4.3)»
Федеральная служба по надзору в сфере защиты прав потребителей и благополучия человека
Руководство пользователя
электронного сервиса смэв SID0003399 Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов (версия 2.4.3)
Дата: 06-03-2013
Версия: 1.4 (9)
Листов: 15 СОДЕРЖАНИЕ
1 Общие сведения 5
Руководящие документы 5
Описание электронного сервиса 5
Операции (методы) электронного сервиса 6
Сценарии использования 6
Схема взаимодействия 6
Связи с другими электронными сервисами 6
2 Руководство пользователя 7
Операция «Получение сведений из СЭЗ Т» 7
Общие сведения 7
Описание входных параметров 7
Рекомендуется обеспечить наличие значения как минимум у одного параметра из перечисленных в п. 1.1-1.7 9
Маска номера документа (СЭЗ Т) 10
99.XX.99.999.Т.999999.99.99 10
где: 10
«9» - любой числовой символ от «0» до «9» 10
«X» - любой символ от «0» до «9» и от «А» до «Я» (русский алфавит) 10
«Т» - русская буква «Т» 10
Описание выходных параметров 10
Коды возвратов (контейнер status атрибут code-error) 13
Контрольные примеры 14
3 Методика испытаний 14
Общие условия 14
Параметры испытаний на тестовой среде 14
Параметры испытаний на продуктивной среде 14
4 Приложения 15
Описание сервиса (WSDL и XSD) 15
15
Описание общих структур данных 15
изменения
Версия
| Дата
| Автор
| Изменения
| Все документации под-версий 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)
| 10-02-2013
|
| Обновлен архив КП (КП переподписаны)
| 1.4 (9)
| 06-03-2013
|
| Откорректированы описания входных параметров firmget_full и firmget_short
| термины/СОКРАЩЕНИя
Термин/сокращение
| Описание
| СМЭВ
| Система межведомственного электронного взаимодействия
| Поставщик
| Организация-владелец электронного сервиса
| WSDL
| Web Services Description Language — язык описания веб-сервисов.
| XSD
| XML Schema definition - язык описания структуры XML документа.
| SOAP
| Simple Object Access Protocol - протокол обмена структурированными сообщениями в распределённой вычислительной среде.
| XML
| eXtensible Markup Language — расширяемый язык разметки.
| СЭЗ Т
| Санитарно-эпидемиологическое заключение о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов
| 1Общие сведения Руководящие документы Основанием для разработки данного документа является требование п. 48 Приказа Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» в соответствии с которым, для подключения информационной системы к системе межведомственного электронного взаимодействия Поставщик предоставляет Оператору СМЭВ следующие документы:
паспорт электронного сервиса, регистрируемого в системе взаимодействия;
методику испытаний электронного сервиса, регистрируемого в системе взаимодействия, включая контрольный пример обращения к электронному сервису;
руководство пользователя электронного сервиса, регистрируемого в системе взаимодействия.
Основанием для создания и использования электронного сервиса являются перечисленные ниже документы.
Нормативно-правовые документы:
Постановление Правительства Российской Федерации от 8 сентября 2010 г. № 697 «О единой системе межведомственного электронного взаимодействия»;
Приказ Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия».
Описание электронного сервиса Наименование:
| Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов (версия 2.4.3)
| Назначение:
| Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов
| Поставщик:
| Федеральная служба по надзору в сфере защиты прав потребителей и благополучия человека
| Область применения:
| Межведомственное взаимодействие
| Операции (методы) электронного сервиса Электронный сервис «Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов» обеспечивает получение сведений из СЭЗ Т по ряду параметров.
Электронный сервис включает методы, обеспечивающие:
Получение сведений из СЭЗ Т.
Метод
| Назначение
| Код: getsez
Наименование: Получение сведений из СЭЗ Т
| Принимает параметры для поиска СЭЗ Т в реестре, возвращает сведения из найденных по параметрам СЭЗ Т
| Сценарии использования Информационная система ведомства вызывает сервис и передает параметры для поиска СЭЗ Т.
Взаимодействие организовано в синхронной схеме.
Схема взаимодействия В рамках взаимодействия информационная система ведомства направляет в адрес сервиса сообщение запрос с информацией о фирме-получателе и (или) реквизитах документа в унифицированном виде.
Полученный запрос сервис обрабатывает, обращаясь к реестру санитарно-эпидемиологических экспертиз и синхронно возвращает результат по запросу.
Схема взаимодействия представлена на рисунке 1.
Рисунок 1 «Схема взаимодействия»
Связи с другими электронными сервисами Данный сервис не имеет связей с другими сервисами.
2Руководство пользователя Операция «Получение сведений из СЭЗ Т» Общие сведения Код операции:
| getsez
| Наименование операции:
| Получение сведений из санитарно-эпидемиологических заключений о соответствии (несоответствии) проектной документации требованиям государственных санитарно-эпидемиологических правил и нормативов
| Назначение операции:
| Получение сведений из сан-эпид заключений на проектную документацию
| Описание входных параметров Входные данные: getsez
№
| Код параметра
| Описание параметра
| Обязательность
«*» — 0 или 1 значение
«***» — 0, 1 или более значений
«+» — 1 значение
| Способ заполнения/Тип
| Комментарий
| 1.1
| ogrn
| ОГРН фирмы-получателя
| *
| s:string
| 13 или 15 цифр доступен для поиска СЭЗ Т, выданных полсе 1 августа 2011
| 1.2
| inn
| ИНН фирмы- получателя
| *
| s:string
| 10 или 12 цифр доступен для поиска СЭЗ Т, выданных полсе 1 августа 2011
| 1.3
| serialnumb
| типографский номер бланка
| *
| s: s:unsignedLong
| цифры
| 1.4
| numb
| Номер документа
| *
| s:string
| До 30 символов
(описание ниже)
| 1.5
| firmget_full
| Полное наименование фирмы- получателя
| *
| s:string
| Указанные в наименовании фирмы знаки препинания при поиске игнорируются
| 1.6
| firmget_short
| Краткое наименование фирмы- получателя
| *
| s:string
| Указанные в наименовании фирмы знаки препинания при поиске игнорируются
| 1.7
| firmget
| Часть названия фирмы- получателя
| *
| s:string
| Например: для поиска ООО «Титан» по части названия можно указать - Титан
Для уточнения поиска можно указать – ООО Титан Все знаки препинания (с одной из сторон которых стоят пробелы) удаляются. Слова, разделенные пробелами, объединяются при поиске логическим «И».
| 1.8
| mode
| Режим поиска
| +
| s:string
Значения:
«and»
«serial»
| Значение «and» указывает, что все переданные параметры для поиска требуется объединить в единое условие логической операцией «И» Значение «serial» указывает, что поиск осуществляется сначала по ОГРН (если найден хотя бы один СЭЗ Т поиск прекращается), потом по ИНН (условие прекращения поиска аналогично ОГРН), потом по типографскому номеру бланка (условие прекращения поиска аналогично ОГРН), потом по номеру документа (условие прекращения поиска аналогично ОГРН), потом по полному названию фирмы-заявителя (условие прекращения поиска аналогично ОГРН), потом по короткому названию фирмы-заявителя (условие прекращения поиска аналогично ОГРН), потом по части названия фирмы-заявителя
| Рекомендуется обеспечить наличие значения как минимум у одного параметра из перечисленных в п. 1.1-1.7
Маска номера документа (СЭЗ Т) 99.XX.99.999.Т.999999.99.99 где: «9» - любой числовой символ от «0» до «9» «X» - любой символ от «0» до «9» и от «А» до «Я» (русский алфавит) «Т» - русская буква «Т»
Описание выходных параметров Выходные данные: rpnsezt2:Response
№
| Код параметра
| Описание параметра
| Обязательность
«*» — 0 или 1 значение
«***» — 0, 1 или более значений
«+» — 1 значение
| Способ заполнения/Тип
| Комментарий
| 1.
| sezt2-info
|
| +
|
| общая информация
|
| date
| дата и время ответа
| +
| s:string
|
|
| version
| версия модуля
| +
| s:string
|
|
| subversion
| подверсия модуля
| +
| s:string
|
| 1.1
| status
| неформализованный текстовый комментарий к результату запроса
| +
|
|
|
| type
| тип ответа на запрос
| +
| s:string
«OK» или «ERROR»
| OK - не было ошибки в запросе | ERROR - ошибка в запросе
|
| code-error
| код ошибки
| +
| s:integer
| См. раздел 2.1.4
|
| flag-found
| найдены данные или нет
| +
| s:integer «0» или «1»
| 1 – данные найдены
0 – данные не найдены
| 1.2
| rows
| документы
| *
|
| присутствует в ответе только при условии, что данные найдены
|
| count
| количество найденных документов, переданных в ответе
| +
| s:integer
|
|
| overflow
| признак того, что переданы не все из найденных документов
| *
| s:integer «1»
| присутствует в ответе только при условии, что найдено данных больше лимита по количеству
| 1.2.1
| row
| документ
| ***
|
|
| 1.2.1.1
| numb
| номер документа
| +
|
|
|
| value
| значение
| +
| s:string
| номер документа
| 1.2.1.2
| date
| дата документа
| +
|
|
|
| value
| значение
| +
| s:string
| дата документа
| 1.2.1.3
| serialnumb
| типографский номер бланка
| +
|
|
|
| value
| значение
| +
| s: unsignedLong
| номер бланка указывается без лидирующих нулей
| 1.2.1.4
| prodnm
| неформализованное название проектной документации
| +
| s:string
|
| 1.2.1.5
| enableuse
| Соответствует или не соответствует государственным санитарно-эпидемиологическим правилам и нормативам
| +
|
|
|
| value
| значение
| +
| s:integer «1» или «0»
| 1 – соответствует
0 – не соответствует
| 1.2.1.6
| firmget
| Фирма-получатель
| +
|
|
|
| inn
| ИНН
| +
| s:string
| если таковой был указан при заполнении документа, иначе пусто
|
| ogrn
| ОГРН
| +
| s:string
| если таковой был указан при заполнении документа, иначе пусто
| 1.2.1.6.1
| info
| Название фирмы-получателя, включая юридический адрес (если таковой был указан при заполнении документа).
| +
| s:string
| Данное поле полностью соответствует информации, которая была напечатана на бланке в соответствующем разделе.
| 1.2.1.7
| protocol
|
| +
| s:string
|
| 1.2.1.7.1
| info
| неформализованный текст с указанием основания для признания представленных документов соответствующими (не соответствующими) государственным санитарно-эпидемиологическим правилам и нормативам
| +
| s:string
|
| 1.2.1.8
| org
| территориальный орган Роспотребнадзора, выдавший документ
| +
|
|
| 1.2.1.8.1
| info
| Название территориального органа Роспотребнадзора
| +
| s:string
|
| 1.2.1.9
| pril
| приложение к документу
| +
|
|
|
| is_pril
| признак: передается или нет в ответе приложение
| +
| s:string «on» или «off»
| on – в ответе на запрос передается текст приложения off – в ответе не передается текст приложения
| 1.2.1.9.1
| info
| текст приложения
| +
| s:string
|
|
Коды возвратов (контейнер status атрибут code-error) №
| Код возврата
| Описание кода возврата
| Условия возникновения
| Комментарий
| 1
| 1
| ошибка в параметре serialnumb
| неверно сформирован запрос
| указано «нечисло»
| 2
| 2
| ошибка в параметре numb
| неверно сформирован запрос
| указан номер документа не соответствующий следующей маске номера документа (см. описание маски выше)
| 3
| 3
| отсутствуют какие либо параметры запроса (пустой запрос)
| неверно сформирован запрос
|
| 4
| 5
| технический сбой (например, отсутствие доступа к БД)
| техническая или программная ошибка на стороне ЭС
| Например, отсутствие доступа модуля, обеспечивающего работу ЭС, к БД Реестра
| 5
| 6
| ошибка в других (не описанных отдельно в данном списке ошибок) параметрах запроса
| неверно сформирован запрос
|
| 6
| 7
| ошибка в ИНН
| неверно сформирован запрос
| указан неверный ИНН, например: 1234567890
| 7
| 8
| ошибка в ОГРН
| неверно сформирован запрос
| указан неверный ОГРН, например: 1234567890123
| 8
| 999
| У системы, сформировавшей запрос, отсутствует доступ к ЭС
| отсутствие доступа
| Используется при работе в тестовой среде
| 9
| 0
| Ошибок нет.
| всё верно
|
|
Контрольные примеры Запросы и ответы на запросы
3Методика испытаний Общие условия Проведение контрольных испытаний при регистрации электронного сервиса регламентировано Приказом Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия».
Порядок проведения типовых испытаний предполагает следующие этапы:
Проверка комплектности предоставленной документации;
Проверка сетевой связности между узлом СМЭВ и точкой размещения электронного сервиса;
Регистрация сервиса и тестирование сервиса на контрольном примере.
Параметры испытаний на тестовой среде Контактное лицо: Аксенов Глеб Владимирович, 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
Параметры испытаний на продуктивной среде Контактное лицо: Аксенов Глеб Владимирович, 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
4Приложения Описание сервиса (WSDL и XSD)
Описание общих структур данных №
| Код параметра
| Описание параметра
| Обязательность
| Способ заполнения/Тип
| Комментарий
| -
| -
| -
| -
| -
| -
|
|