Описание веб-сервиса обработки статусов электронного заявления на портале государственных услуг
Оглавление
1. Назначение веб-сервиса. 3
2. Ссылка на веб-сервис в СМЭВ.. 3
3. Передаваемые параметры веб-сервиса. 3
4. Возвращаемые значения веб-сервиса. 4
5. Пример вызова веб-сервиса. 5
6. Пример ответа веб-сервиса. 5
1. Назначение веб-сервиса
Веб-сервис предназначен для обновление статусов электронного заявления в процессе обработки.
2. Ссылка на веб-сервис в СМЭВ
При работе по открытому каналу, сервис доступен по адресу:
URL: http://109.207.1.113:7777/gateway/services/SID0003046
URL WSDL: http://109.207.1.113:7777/gateway/services/SID0003046?wsdl
При работе по защищенному каналу связи, сервис доступен по адресу:
URL: http://172.16.90.14:7777/gateway/services/SID0003046
URL WSDL: http://172.16.90.14:7777/gateway/services/SID0003046?wsdl
3. Передаваемые параметры веб-сервиса
- org_id: xsd:string - ID ФОИВ (предоставляется разработчиками ПГУ) form_id: xsd:string – ID формы (для каждой формы предоставляется разработчиками ПГУ) app_id: xsd:long - ID заявки в ПГУ status_code: xsd:string - код статуса в ИС ФОИВ (см. Таблицу 1) status_title: xsd:string – название статуса в ИС ФОИВ (обязательный параметр) status_date: xsd:string - дата и время обновления статуса (14.04.2010 23:03:46) status_pgu: xsd:string – значение статуса для ПГУ. Может принимать следующие значения:
- ОК_CANCEL_ALLOWED. Заявление на оказание услуги получено ИС ФОИВ. Заявление на оказание услуги может быть отменено. CANCELED. ИС ПГУ произвела отмену заявления на оказание услуги по запросу ПГУ, т. е. если веб-сервис ИС ФОИВ получил запрос на отмену заявления и ИС ФОИВ исполнила отмену заявления, то веб-сервис ИС ФОИВ должен передать веб-сервису ПГУ значение CANCELED. ОК_CANCEL_NOT_ALLOWED. Заявление на оказание услуги получено ИС ФОИВ. Заявление на оказание услуги не может быть отменено. OK_FINISHED. В ИС ФОИВ зарегистрировано выполнение услуги по заявлению. Пользователь может получить результат выполнения заявления на оказание услуги.
Таблица 1 Примерный список статусов заявлений для передачи от ИС ФОИВ на ПГУ
Код статуса для передачи в ПГУ (status_code) | Название статуса для передачи в ПГУ (status_title) | Описание статуса | Комментарий для вывода в Личный кабинет пользователя | Показывать пользователю |
020 | Черновик | Состояние, когда пользователь ещё не отправил заявление | В процессе заполнения | Да |
025 | Инициирована передача в ведомство | Заявление послано, но ФОИВ ещё не вернул ответ | Заявление находится в процессе передачи в ведомство | Да |
005 | Ошибка передачи | Произошла техническая ошибка при передаче в ИС ФОИВ, например тайм-аут. | Ошибка доставки формы. Попробуйте подать заявление повторно | Да |
030 | В очереди | ФОИВ получил заявление, но ещё не прошёл контроль целостности | Заявление получено ведомством | Да |
010 | Возврат | ИС ФОИВ может вернуть заявление по многим причинам некорректного заполнения полей формы. | Обращение не зарегистрировано, проверьте введенные данные | Да |
040 | Подано | ИС ФОИВ (сервер) принял заявление | Успешно зарегистрировано | Да |
000 | Удалено | Заявление, удалённое пользователем. Только из состояний Черновик и Возврат. | - | Нет |
110 | Принято | ФОИВ принял заявление к рассмотрению | Заявление передано на рассмотрение исполнителю. + <указать дальнейшие действия и контакты исполнителя> | Да |
200 | Готово | Результат готов. Приглашение на получение результата. | Приглашаем Вас получить запрашиваемую услугу. + <Указать адрес и время, получения результата услуги> | Да |
300 | Закрыто | Пользователь получил результат | Услуга оказана | Да |
4. Возвращаемые значения веб-сервиса
return
- 1 - статус обновлён 0 - не обновлён (переданы неверное ведомство либо ID заявления)
return_info
информация о выполнении операции
return_code
код результата выполнении операции
5. Пример вызова веб-сервиса
<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:uri="uri:processWS">
<soapenv:Header/>
<soapenv:Body>
<uri:update_process>
<org_id>smev</org_id>
<form_id>fms.01a</form_id>
<app_id>8932</app_id>
<status_code>010</status_code>
<status_title>Возврат</status_title>
<status_date>13.09.2010 13:00:42</status_date>
<status_pgu>OK_FINISHED</status_pgu>
</uri:update_process>
</soapenv:Body>
</soapenv:Envelope>
6. Пример ответа веб-сервиса
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas. xmlsoap. org/soap/envelope/" xmlns:xsd="http://www. w3.org/2001/XMLSchema" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas. xmlsoap. org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:update_processResponse xmlns:ns1="uri:processWS">
<return>1</return>
<return_info>Контрольный пример</return_info>
<return_code>OK</return_code>
</ns1:update_processResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>


