Руководство пользователя электронного сервиса ГАС «Управление» (стр. 6 )

2.2.1  Общие сведения

Таблица 7. Сведения об операции «Получение информации, опубликованной в ГАСУ»

Код операции:	Query
Наименование операции:	Получение информации, опубликованной в ГАС «Управление».
Назначение операции:	Операция предназначена для получения ИС Потребителем информации, опубликованной ранее в ГАС «Управление».

2.2.2  Описание входных параметров

Единственным входящим параметром метода query является сообщение типа GasuQueryMessage, которое содержит запрос для получения информации опубликованной в ГАС «Управление». Структура типа GasuQueryMessage реализована в соответствие с форматом, описанным в методических рекомендациях по разработке электронных сервисов. Детальная информация о составе блока структурированных сведений AppQueryMessage типа AppQueryMessageType представлена в таблице 8.

Таблица 8. Описание типа AppQueryMessageType

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	AppHeader	Заголовок блока	+	smev:AppHeaderType	Более подробная информация представлена в разделе 4.2.3 Прикладной тип AppHeaderType
2	Query	Тело блока, содержащее запрос	+	smev:QueryType	Более подробная информация представлена в разделе 4.2.28 Прикладной тип QueryType

2.2.3  Описание выходных параметров

При успешном выполнении запроса, поступившего в сообщении GasuQueryMessage, единственным исходящим параметром метода query является сообщение типа GasuTicket, которое содержит информацию о результатах выполнения запроса и информацию из ГАС «Управление», сформированную в соответствии с данным запросом. Структура типа GasuTicket реализована в соответствие с форматом, описанным в методических рекомендациях по разработке электронных сервисов. Детальная информация о составе блока структурированных сведений GasuResponse, входящего в состав GasuTicket (GasuTicket/MessageData/AppData/GasuResponse), типа GasuResponseType представлена в таблице 9.

Таблица 9. Описание типа GasuResponseType

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	RequestID	Идентификатор сообщения, в ответ на которое сформирован данный ответ	+	UIDType	Соответствует ID (подробнее 4.2.3 Прикладной тип AppHeaderType) входного сообщения сформированного поставщиком
2	GasuResponseCode	Код ответа, определяющий результаты обработки запроса в ГАС «Управление».	+	string	Возможные на данный момент коды возврата приведены в разделе 2.2.4 Коды возвратов
3	GasuResponseMessage	Текстовое сообщение, которое может содержать дополнительную информацию о результатах обработки сообщения		string
4	QueryResponse	Блок структурированных сведений может быть использован для передачи различных данных.		QueryResponseType	Более подробная информация представлена в разделе 4.2.29 Прикладной тип QueryResponseType

В случае если поступивший в сообщении GasuQueryMessage запрос на получение информации не может быть выполнен методом query, например, по причинам невыполнения условий форматно-логического контроля для поступившего запроса, метод query возвращает сообщение типа GasuTicket, содержащее информацию об ошибке. Детальная информация о составе блока структурированных сведений GasuResponse, входящего в состав GasuTicket (GasuTicket/MessageData/AppData/GasuResponse), типа GasuResponseType представлена в таблице 10.

Таблица 10. Описание типа GasuResponseType

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	RequestID	Идентификатор сообщения, в ответ на которое сформирован данный ответ	+	smev:UIDType	Соответствует ID (подробнее 4.2.3 Прикладной тип AppHeaderType) входного сообщения сформированного поставщиком
2	ResponseCode	Код ответа, определяющий результаты обработки запроса в ГАС «Управление».	+	String	Возможные на данный момент коды возврата приведены в разделе 2.2.4 Коды возвратов
3	GasuMessage	Текстовое сообщение, которое может содержать дополнительную информацию о результатах обработки сообщения		String

2.2.4  Коды возвратов

Таблица 11. Коды возрвата

№	Код возврата	Описание кода возврата	Условия возникновения
1	200	Запрос выполнен успешно
2	210	Запрос выполнен успешно, имеются предупреждения	Возникает, когда в процессе обработки сообщение проходит форматно-логический котроль без ошибок, но с предупреждениями.
3	100	Ошибка форматно-логического контроля	Возникает при наличии ошибок во входящем XML запросе
4	110	Некорректный запрос данных из ГАС «Управление»	Возникает при наличии логических ошибок в параметрах запроса на получение информации из ГАС «Управление»
5	403	Отказ в доступе к сервисам ГАС «Управление»	Возникает при запросах от ИС, не имеющих прав на работу с сервисами ГАСУ.
6	404	В ГАС «Управление» не найдена запрошенная информация	Возникает при попытке получения информации, не занесенной ранее в ГАС «Управление»
7	410	Нет доступа на получение запрошенных данных	Возникает при запросах от ИС, не имеющих прав на запрос данных по определенным объектам. Например: нерегиональная ИС пытается получить данные по показателю, данные по которому предоставляются только для региональных ИС.
8	500	Внутренняя ошибка ГАС «Управление»	Возникает при наличии ошибок при обработке сообщений по внутренним причинам, в том числе, не относящимся непосредственно к посылаемому запросу.
9	510	Внутренняя ошибка при работе с данными	Возникает при обращении к базе данных в результате некорректно составленного запроса.

2.2.5  Контрольные примеры

Запрос

<?xml version="1.0" encoding="UTF-8"?><soap:Envelope xmlns:soap="http://schemas. xmlsoap. org/soap/envelope/" xmlns:ds="http://www. w3.org/2000/09/xmldsig#" xmlns:rev="http://smev. gosuslugi. ru/rev120315" xmlns:wsse="http://docs. oasis-open. org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs. oasis-open. org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> <soap:Header> <wsse:Security soap:actor="http://smev. gosuslugi. ru/actors/smev"> <wsse:BinarySecurityToken EncodingType="http://docs. oasis-open. org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary" ValueType="http://docs. oasis-open. org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3" wsu:Id="SenderCertificate">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 CQITCVNlcnZlciBDQTEgMB4GCSqGSIb3DQEJARYRdWNfZmtAcm9za2F6bmEucnUxHDAaBgNVBAgM Ezc3INCzLiDQnNC+0YHQutCy0LAxGjAYBggqhQMDgQMBARIMMDA3NzEwNTY4NzYwMRgwFgYFKoUD ZAESDTEwNDc3OTcwMTk4MzAxLDAqBgNVBAkMI9GD0LvQuNGG0LAg0JjQu9GM0LjQvdC60LAsINC0 0L7QvCA3MRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxCzAJBgNVBAYTAlJVMTgwNgYDVQQKDC/QpNC1 0LTQtdGA0LDQu9GM0L3QvtC1INC60LDQt9C90LDRh9C10LnRgdGC0LLQvjE/MD0GA1UEAww20KPQ piDQpNC10LTQtdGA0LDQu9GM0L3QvtCz0L4g0LrQsNC30L3QsNGH0LXQudGB0YLQstCwggEBMF4G A1UdHwRXMFUwKaAnoCWGI2h0dHA6Ly9jcmwucm9za2F6bmEucnUvY3JsL2ZrMDEuY3JsMCigJqAk hiJodHRwOi8vY3JsLmZzZmsubG9jYWwvY3JsL2ZrMDEuY3JsMB0GA1UdDgQWBBSwIlLNzLFGSy6Y sFP3czSOwUu1PjAIBgYqhQMCAgMDQQAuR7fHbaMwSwQDl6N0+kQeZOLKEEyN5PPA9zt/dzZ3BAM1 5+qix74aP8k9+RUBoYxc4ArNVQeCXcw7u2hLIOeE</wsse:BinarySecurityToken> <Signature xmlns="http://www. w3.org/2000/09/xmldsig#"><SignedInfo><CanonicalizationMethod Algorithm="http://www. w3.org/2001/10/xml-exc-c14n#"/><SignatureMethod Algorithm="http://www. w3.org/2001/04/xmldsig-more#gostr34102001-gostr3411"/><Reference URI="#body"><Transforms><Transform Algorithm="http://www. w3.org/2001/10/xml-exc-c14n#"/></Transforms><DigestMethod Algorithm="http://www. w3.org/2001/04/xmldsig-more#gostr3411"/><DigestValue>bE2Mb7n0XOCf58NDFsd0rcrGdlHDaiwIXqGu2SS4DV0=</DigestValue></Reference></SignedInfo><SignatureValue>dbMQVZD2I5qL1bzQ41lRbPTea9jyNTSKD71cyV/ZVlQ3y6qVh45P6rWvM8IWjfjf1Zk1/OeiAj+d YSDkaULoKg==</SignatureValue><KeyInfo><wsse:SecurityTokenReference><wsse:Reference URI="#SenderCertificate" ValueType="http://docs. oasis-open. org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3"/></wsse:SecurityTokenReference></KeyInfo></Signature></wsse:Security> </soap:Header> <soap:Body wsu:Id="body"> <smev:GasuQueryMessage xmlns:gasu="http://www. government. ru/gasu2" xmlns:smev="http://smev. gosuslugi. ru/rev120315" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://smev. gosuslugi. ru/rev120315 gasu2query. xsd "> <!-- Унифицированный служебный блок атрибутов сообщения СМЭВ. Подписывается ЭП ОВ информационной системы, отправляющей электронное сообщение --> <smev:Message> <smev:Sender> <!--Данные о системе-инициаторе взаимодействия (Потребителе) --> <smev:Code>RKZN03001</smev:Code> <smev:Name>Государственная автоматизированная система «Управление»</smev:Name> </smev:Sender> <smev:Recipient> <!--Данные о системе-получателе сообщения (Поставщике) --> <smev:Code>RKZN03001</smev:Code> <smev:Name>Государственная автоматизированная система «Управление»</smev:Name> </smev:Recipient> <smev:Originator> <!--Данные о системе, инициировавшей цепочку из нескольких запросов-ответов, объединенных единым процессом в рамках взаимодействия --> <smev:Code>RKZN03001</smev:Code> <smev:Name>Государственная автоматизированная система «Управление»</smev:Name> </smev:Originator> <smev:ServiceName/> <smev:TypeCode>GFNC</smev:TypeCode> <!--Тип сообщения по классификатору сообщений в СМЭВ --> <smev:Status>REQUEST</smev:Status> <!-- Статус электронного сообщения по классификатору статусов --> <!--Дата создания сообщения--> <smev:Date>2001-12-31T12:00:00</smev:Date> <smev:ExchangeType>2</smev:ExchangeType> <smev:ServiceCode> <!--Код государственной услуги указывается в соответствии с правилами кодификации, установленными в ИС Сводного реестра государственных услуг --> </smev:ServiceCode> <smev:CaseNumber> <!--Номер дела указывается в соответствии с правилами, установленными в информационной системы-отправителя. --> </smev:CaseNumber> <smev:TestMsg> <!--Признак тестового электронного сообщения: запроса или ответа. Не указывается при продуктивном взаимодействии. --> </smev:TestMsg> </smev:Message> <!-- Унифицированный служебный блок-обертка передаваемых данных сообщения СМЭВ. Данные электронного сообщения --> <smev:MessageData> <!-- Унифицированный блок-обертка для передачи информации в соответствии с требованиями поставщика --> <smev:AppData> <smev:AppQueryMessage> <smev:AppHeader> <smev:ID>12345</smev:ID> <smev:DataSourceRef>8765</smev:DataSourceRef> <smev:HeaderInfo/> </smev:AppHeader> <smev:Query pagingPageSize="10" pagingStartPage="1" returnType="classifier"> <smev:ClassifierQuery providerRef="8765">TEMP_ОКСМ</smev:ClassifierQuery> </smev:Query> </smev:AppQueryMessage> </smev:AppData> </smev:MessageData> </smev:GasuQueryMessage> </soap:Body> </soap:Envelope>

Ответ на запрос в случае успешного исполнения