rp_RSID20134

Руководство пользователя сервиса предоставления документа-основания о передаче имущества
Комитет по управлению городским имуществом Санкт-Петербурга
ОПИСАНИЕ ФОРМАТА
ЭЛЕКТРОННОГО СЕРВИСА СМЭВ
И
РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
ЭЛЕКТРОННОГО СЕРВИСА СМЭВ
Сервис предоставления документа-основания
о передаче имущества
Дата: 17.05.2012
Версия: 1.1.
Листов: 15
1
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
СОДЕРЖАНИЕ
ОБЩИЕ СВЕДЕНИЯ ......................................................................................................................4
1.1 Руководящие документы .................................................................................................................. 4
1.2 Описание электронного сервиса ...................................................................................................... 4
1.3 Операции (методы) электронного сервиса ..................................................................................... 4
1.4 Схема взаимодействия...................................................................................................................... 6
2
РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ.............................................................................................7
2.1 Операция «Регистрация запроса о предоставлении документа-основания о передаче
имущества» .............................................................................................................................................. 7
2.1.1 Общие сведения ......................................................................................................................... 7
1
2.1.2 Описание входных параметров ................................................................................................ 7
2.1.3 Описание выходных параметров .............................................................................................. 7
2.2 Операция «Проверка статуса выполнения запроса предоставления документа-основания о
передаче имущества».............................................................................................................................. 7
2.2.1 Общие сведения ......................................................................................................................... 7
2.2.2 Описание входных параметров ................................................................................................ 8
2.2.3 Описание выходных параметров .............................................................................................. 8
2.3 Операция «Получение результата запроса предоставления документа-основания о передаче
имущества» .............................................................................................................................................. 8
2.3.1 Общие сведения ......................................................................................................................... 8
2.3.2 Описание входных параметров ................................................................................................ 8
2.3.3 Описание выходных параметров .............................................................................................. 8
3
ПРИЛОЖЕНИЯ.............................................................................................................................10
3.1 Описание сервиса (WSDL) ............................................................................................................. 10
3.2 Описание общих структур данных................................................................................................ 14
3.3 Описания справочников ................................................................................................................. 15
2
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
ИЗМЕНЕНИЯ
Версия
Дата
Автор
Изменения
ТЕРМИНЫ/СОКРАЩЕНИЯ
Термин/сокращение
СМЭВ
Поставщик
WSDL
XSD
SOAP
XML
Описание
Система межведомственного электронного взаимодействия
Организация-владелец электронного сервиса
Web Services Description Language — язык описания веб-сервисов.
XML Schema definition - язык описания структуры XML
документа.
Simple
Object
Access
Protocol
протокол
обмена
структурированными
сообщениями
в
распределённой
вычислительной среде.
eXtensible Markup Language — расширяемый язык разметки.
3
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
1 ОБЩИЕ СВЕДЕНИЯ
1.1 Руководящие документы
Основанием для разработки данного документа является требование п. 48 Приказа
Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г.
№ 190 «Об утверждении технических требований к взаимодействию информационных систем в
единой системе межведомственного электронного взаимодействия» в соответствии с которым, для
подключения информационной системы к системе межведомственного электронного
взаимодействия Поставщик предоставляет Оператору СМЭВ следующие документы:
паспорт электронного сервиса, регистрируемого в системе взаимодействия;
методику испытаний электронного сервиса, регистрируемого в системе взаимодействия, включая
контрольный пример обращения к электронному сервису;
руководство пользователя электронного сервиса, регистрируемого в системе взаимодействия.
Основанием для создания и использования электронного сервиса являются перечисленные
ниже документы.
Нормативно-правовые документы:
Постановление Правительства Российской Федерации от 8 сентября 2010 г. № 697 «О единой
системе межведомственного электронного взаимодействия»;
Приказ Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010
г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в
единой системе межведомственного электронного взаимодействия»;
Постановление Правительства Санкт-Петербурга от 21.09.2004 № 1589 «О Комитете по
управлению городским имуществом».
 Технологические стандарты:
Методические рекомендации по разработке электронных сервисов и применению технологии
электронной подписи при межведомственном электронном взаимодействии. Версия 2.3.4. 2011.
1.2 Описание электронного сервиса
Наименование:
Предоставление документа-основания о передаче имущества
Назначение:
Сервис предназначен для предоставления документа-основания о передаче
имущества.
Поставщик:
Комитет по управлению городским имуществом Санкт-Петербурга
Область
применения:
Межведомственное взаимодействие
1.3 Операции (методы) электронного сервиса
Метод
Назначение
Код: registerRequest
Принимает
4
электронное
сообщение
с
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
Наименование:
регистрация
запроса
предоставлении
документа-основания
передаче имущества
о описанием органа, направляющего запрос, и
о содержанием запроса и возвращает номер
зарегистрированного
запроса.
Номер
зарегистрированного запроса используется в
методах сервиса для получения статуса
обработки запроса и результатов обработки
запроса.
Принимает на вход номер запроса и возвращает
Код: getStatus
Наименование: проверка статуса выполнения код статуса выполнения запроса.
запроса предоставления документа-основания о
передаче имущества
Принимает на вход номер запроса и возвращает
Код: getExcerpt
Наименование: получение результата запроса содержимое ответа на запрос.
предоставления
документа-основания
передаче имущества
о
5
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
1.4 Схема взаимодействия
Системапотребитель
Системапоставщик
Создание заявки
Ответ-квитанция, содержащий идентификационный номер, присвоенный заявлению. Либо
сообщение об ошибке
СМЭВ
Получение статуса заявки
Ответ, содержащий код актуального статуса.
Получение результата
Ответ, содержащий результат выполнения заявления
Рисунок 1
Процесс взаимодействия состоит из следующих шагов:
1. Система-потребитель вызывает метод Error! Reference source not found. и передает пакет
заявления;
a. В ответ на вызов метода система-потребитель получает код запроса, созданного в
системе-поставщик.
b. В случае сбоя, в ответ на вызов метода придет сообщение об ошибке.
2. После получение кода запроса, система-потребитель может неограниченное количество
раз вызывать метод Error! Reference source not found. для получения текущего статуса
заявления.
a. В ответ на вызов метода система-потребитель получает код статуса запроса.
b. В случае сбоя, в ответ на вызов метода придет сообщение об ошибке.
3. После получение кода окончательного статуса заявления (заявление выполнено или
отказано в выполнении), система-потребитель может неограниченное количество раз
вызывать метод Error! Reference source not found. для получения результата обработки
заявления.
6
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
a. В ответ на вызов метода система-потребитель получает результат выполнения
заявления.
b. В случае сбоя, в ответ на вызов метода придет сообщение об ошибке.
2 РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
2.1 Операция «Регистрация запроса о предоставлении документаоснования о передаче имущества»
2.1.1 Общие сведения
Код операции:
registerRequest
Наименование
операции:
Регистрация запроса о предоставлении документа-основания о
передаче имущества
Назначение операции:
Принимает электронное сообщение с описанием органа,
направляющего запрос, и содержанием запроса и возвращает номер
зарегистрированного запроса. Номер зарегистрированного запроса
используется в методах сервиса для получения статуса обработки
запроса и результатов обработки запроса.
2.1.2 Описание входных параметров
Входные данные: tns:registerRequest
№
1
Код параметра
arg
Описание
параметра
Запрос
Обязательность
Способ
заполнения/Тип
+
Root
Комментарий
Параметры комплексного типа описаны в приложении «Описание общих структур
данных».
2.1.3 Описание выходных параметров
Выходные данные: tns:registerRequestResponse
№
Код параметра
return
1
Описание
параметра
Идентификатор
принятого
Обязательность
Способ
заполнения/Тип
+
String
Комментарий
для
обработки запроса
Параметры комплексного типа описаны в приложении «Описание общих структур
данных».
7
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
2.2 Операция
«Проверка
статуса
выполнения
запроса
предоставления документа-основания о передаче имущества»
2.2.1 Общие сведения
Код операции:
getStatus
Наименование
операции:
Проверка статуса выполнения запроса предоставления документаоснования о передаче имущества
Назначение операции:
Принимает на вход номер запроса и возвращает код статуса
выполнения запроса.
2.2.2 Описание входных параметров
Входные данные: tns:getStatus
№
1
Описание
параметра
Код параметра
arg0
Идентификатор
Обязательность
Способ
заполнения/Тип
+
String
Комментарий
до 255 символов
запроса
2.2.3 Описание выходных параметров
Выходные данные: tns:getStatusResponse
№
1
Описание
параметра
Код параметра
return
Код
статуса
Обязательность
Способ
заполнения/Тип
+
Int
Комментарий
документа
2.3 Операция «Получение результата запроса
документа-основания о передаче имущества»
предоставления
2.3.1 Общие сведения
Код операции:
getExcerpt
Наименование
Получение результата запроса предоставления документа-основания о
операции:
передаче имущества
Назначение операции:
Принимает на вход номер запроса и возвращает содержимое ответа на
запрос.
2.3.2 Описание входных параметров
Входные данные: tns:getExcerpt
№
1
Код параметра
arg0
Описание
параметра
Идентификатор
Обязательность
Способ
заполнения/Тип
+
String
8
Комментарий
до 255 символов
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
запроса
2.3.3 Описание выходных параметров
Выходные данные: tns:getExcerptResponse
№
1
Код параметра
return
Описание
параметра
Результат
Обязательность
Способ
заполнения/Тип
+
Document
Комментарий
обработки запроса
Параметры комплексного типа описаны в приложении «Описание общих структур
данных».
9
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
3 ПРИЛОЖЕНИЯ
3.1 Описание сервиса (WSDL)
<?xml version='1.0' encoding='UTF-8'?>
<definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://wrapper/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://schemas.xmlsoap.org/wsdl/"
targetNamespace="http://wrapper/"
name="RegionEServiceWrapper_0003Service">
<types>
<xsd:schema>
<xsd:import namespace="http://wrapper/"
schemaLocation="http://10.128.176.10:8001/KUGI_RES_0003/RegionEServiceW
rapper_0003?xsd=1"/>
</xsd:schema>
<xsd:schema>
<xsd:import namespace="http://registerrequest.client/"
schemaLocation="http://10.128.176.10:8001/KUGI_RES_0003/RegionEServiceW
rapper_0003?xsd=2"/>
</xsd:schema>
<xsd:schema>
<xsd:import namespace="http://excerpt.client/"
schemaLocation="http://10.128.176.10:8001/KUGI_RES_0003/RegionEServiceW
rapper_0003?xsd=3"/>
</xsd:schema>
</types>
<message name="getStatus">
<part name="parameters" element="tns:getStatus"/>
</message>
<message name="getStatusResponse">
<part name="parameters" element="tns:getStatusResponse"/>
</message>
<message name="getExcerpt">
<part name="parameters" element="tns:getExcerpt"/>
</message>
<message name="getExcerptResponse">
<part name="parameters" element="tns:getExcerptResponse"/>
</message>
<message name="registerRequest">
<part name="parameters" element="tns:registerRequest"/>
</message>
<message name="registerRequestResponse">
<part name="parameters" element="tns:registerRequestResponse"/>
</message>
<portType name="RegionEServiceWrapper_0003">
<operation name="getStatus">
<input message="tns:getStatus"/>
<output message="tns:getStatusResponse"/>
</operation>
<operation name="getExcerpt">
<input message="tns:getExcerpt"/>
<output message="tns:getExcerptResponse"/>
</operation>
<operation name="registerRequest">
<input message="tns:registerRequest"/>
<output message="tns:registerRequestResponse"/>
10
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
</operation>
</portType>
<binding name="RegionEServiceWrapper_0003PortBinding"
type="tns:RegionEServiceWrapper_0003">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http"
style="document"/>
<operation name="getStatus">
<soap:operation soapAction=""/>
<input>
<soap:body use="literal"/>
</input>
<output>
<soap:body use="literal"/>
</output>
</operation>
<operation name="getExcerpt">
<soap:operation soapAction=""/>
<input>
<soap:body use="literal"/>
</input>
<output>
<soap:body use="literal"/>
</output>
</operation>
<operation name="registerRequest">
<soap:operation soapAction=""/>
<input>
<soap:body use="literal"/>
</input>
<output>
<soap:body use="literal"/>
</output>
</operation>
</binding>
<service name="RegionEServiceWrapper_0003Service">
<port name="RegionEServiceWrapper_0003Port"
binding="tns:RegionEServiceWrapper_0003PortBinding">
<soap:address
location="http://10.128.176.10:8001/KUGI_RES_0003/RegionEServiceWrapper
_0003"/>
</port>
</service>
</definitions>
http://10.128.176.10:8001/KUGI_RES_0003/RegionEServiceWrapper_000
3?xsd=1
<?xml version='1.0' encoding='UTF-8'?><!-- Published by JAX-WS RI at
http://jax-ws.dev.java.net. RI's version is Oracle JAX-WS 2.1.5. -><xs:schema xmlns:tns="http://wrapper/"
xmlns:ns2="http://excerpt.client/"
xmlns:ns1="http://registerrequest.client/"
xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0"
targetNamespace="http://wrapper/">
<xs:import namespace="http://registerrequest.client/"
schemaLocation="http://10.128.176.10:8001/KUGI_RES_0003/RegionEServiceW
rapper_0003?xsd=2"/>
11
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
<xs:import namespace="http://excerpt.client/"
schemaLocation="http://10.128.176.10:8001/KUGI_RES_0003/RegionEServiceW
rapper_0003?xsd=3"/>
<xs:element name="getExcerpt" type="tns:getExcerpt"/>
<xs:element name="getExcerptResponse" type="tns:getExcerptResponse"/>
<xs:element name="getStatus" type="tns:getStatus"/>
<xs:element name="getStatusResponse" type="tns:getStatusResponse"/>
<xs:element name="registerRequest" type="tns:registerRequest"/>
<xs:element name="registerRequestResponse"
type="tns:registerRequestResponse"/>
<xs:complexType name="registerRequest">
<xs:sequence>
<xs:element name="arg0" type="ns1:Root" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="registerRequestResponse">
<xs:sequence>
<xs:element name="return" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="getExcerpt">
<xs:sequence>
<xs:element name="arg0" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="getExcerptResponse">
<xs:sequence>
<xs:element name="return" type="ns2:Root" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="getStatus">
<xs:sequence>
<xs:element name="arg0" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="getStatusResponse">
<xs:sequence>
<xs:element name="return" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
http://10.128.176.10:8001/KUGI_RES_0003/RegionEServiceWrapper_000
3?xsd=2
<?xml version='1.0' encoding='UTF-8'?><!-- Published by JAX-WS RI at
12
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
http://jax-ws.dev.java.net. RI's version is Oracle JAX-WS 2.1.5. -><xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified" version="1.0"
targetNamespace="http://registerrequest.client/">
<xs:complexType name="Root">
<xs:sequence>
<xs:element name="INN" type="xs:string" nillable="true"/>
<xs:element name="requestCopyingNote" type="xs:string"
nillable="true"/>
<xs:element name="OGRN" type="xs:string" nillable="true"/>
<xs:element name="incomingDate" type="xs:dateTime" nillable="true"/>
<xs:element name="agency" type="xs:integer" nillable="true"/>
<xs:element name="declarantName" type="xs:string" nillable="true"/>
<xs:element name="incomingNumber" type="xs:string" nillable="true"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
http://10.128.176.10:8001/KUGI_RES_0003/RegionEServiceWrapper_000
3?xsd=3
<?xml version='1.0' encoding='UTF-8'?><!-- Published by JAX-WS RI at
http://jax-ws.dev.java.net. RI's version is Oracle JAX-WS 2.1.5. -><xs:schema xmlns:tns="http://excerpt.client/"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified" version="1.0"
targetNamespace="http://excerpt.client/">
<xs:complexType name="Root">
<xs:sequence>
<xs:element name="document" type="tns:Document" nillable="true"
minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Document">
<xs:sequence>
<xs:element name="fileExtension" type="xs:string" nillable="true"/>
<xs:element name="signs" type="tns:Signs" nillable="true"/>
<xs:element name="body" type="xs:base64Binary" nillable="true"/>
<xs:element name="name" type="xs:string" nillable="true"/>
<xs:element name="fileName" type="xs:string" nillable="true"/>
<xs:element name="number" type="xs:string" nillable="true"/>
<xs:element name="date" type="xs:dateTime" nillable="true"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Signs">
<xs:sequence>
<xs:element name="sign" type="tns:Sign" nillable="true" minOccurs="0"
maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Sign">
<xs:sequence>
13
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
<xs:element name="fileExtension" type="xs:string" nillable="true"/>
<xs:element name="body" type="xs:base64Binary" nillable="true"/>
<xs:element name="fileName" type="xs:string" nillable="true"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
3.2 Описание общих структур данных
1.
Root
№
Код параметра
1
2
3
4
5
6
7
INN
requestCopyingNote
OGRN
incomingDate
agency
declarantName
incomingNumber
2.
Document
№
Код параметра
1
fileExtension
signs
body
name
fileName
number
date
3.
Signs
№
Код параметра
1
Sign
Описание
параметра
Обязательность
Способ
заполнения/Тип
ИНН контрагента
Текст запроса
ОГРН
контрагента
Дата исходящего
запроса
Код агентства
+
+
+
xs:string
xs:string
xs:string
+
xs:dateTime
+
xs:integer
Наименование
контрагента
Номер исходящего
запроса
+
xs:string
+
xs:string
Обязательность
Способ
заполнения/Тип
+
+
+
xs:string
tns:Signs
xs:base64Binary
+
xs:string
+
+
+
xs:string
xs:string
xs:dateTime
Обязательность
Способ
заполнения/Тип
+
tns:Sign
Описание
параметра
Расширение файла
ЭЦП
Содержание
ответа
Наименование
ответа
Имя файла
Номер
Дата ответа
Описание
параметра
ЭЦП
Комментарий
Не используется.
Передавать 1
Комментарий
Комментарий
Множество
элементов
4.
Sign
№
Код параметра
1
fileExtension
Описание
параметра
Расширение файла
Обязательность
Способ
заполнения/Тип
+
Xs:string
+
xs:base64Binary
ЭЦП
2
body
Содержимое ЭЦП
14
Комментарий
Руководство пользователя сервиса предоставления документа-основания о передаче имущества
3
fileName
Имя файла ЭЦП
+
xs:string
3.3 Описания справочников
Статусы запросов:
Код
Наименование
3
4
5
7
9
Запрос отклонен
Информация предоставлена заявителю
Сформированные документы запроса находятся в ожидании подписания их цифровой подписью
Запрос возвращен заявителю
Запросу назначен исполнитель
15