Document 148904

Руководство пользователя сервиса «Получение сведений из санитарно-эпидемиологических заключений о
соответствии
(несоответствии)
проектной
документации
требованиям
государственных
санитарно-
эпидемиологических правил и нормативов (версия 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