Ответ на запрос в случае успешного исполнения. Министерство связи и массовых коммуникаций Российской Федерации
Министерство связи и массовых коммуникаций Российской Федерации
ТИПОВОЕ ОПИСАНИЕ ФОРМАТА
ЭЛЕКТРОННОГО СЕРВИСА СМЭВ
И
Руководство пользователя
электронного сервиса смэв
Сервис взаимодействия с организациями через которые осуществляется внесение платы за жилое помещение и коммунальные услуги
Дата: 11.05.16
Версия: 1.0
Листов: 80
СОДЕРЖАНИЕ
1. Общие сведения.. 4
1.1. Руководящие документы.. 4
1.2. Описание электронного сервиса. 5
1.3. Операции (методы) электронного сервиса. 5
1.4. Сценарии использования. 6
1.5. Схема взаимодействия. 7
1.6. Связи с другими электронными сервисами. 9
2. Руководство пользователя.. 9
2.1. Операция «передать пакет извещений о принятии к исполнению распоряжений». 9
2.1.1. Общие сведения. 9
2.1.2. Описание входных параметров. 9
2.1.3. Описание выходных параметров. 9
2.1.4. Контрольные примеры.. 10
2.2. Операция «передать пакет сведений об аннулировании извещений о принятии к распоряжения к исполнению». 10
2.2.1. Общие сведения. 10
2.2.2. Описание входных параметров. 10
2.2.3. Описание выходных параметров. 11
2.2.4. Контрольные примеры.. 11
2.3. Операция «Получение статуса обработки запроса». 12
2.3.1. Общие сведения. 12
2.3.2. Описание входных параметров. 12
2.3.3. Описание выходных параметров. 12
2.3.4. Коды возвратов. 12
2.3.5. Контрольные примеры.. 15
3. Методика испытаний.. 17
3.1. Общие условия. 17
3.2. Параметры испытаний на тестовой среде. 17
|
|
|
3.3. Особые условия. 17
4. Приложения.. 18
4.1. Описание сервиса (WSDL) 18
4.2. Описание общих структур данных. 18
4.3. Описания справочников. 80
изменения
| Версия | Дата | Автор | Изменения |
| 1.0 | 30.03.2016 | Малютин В. | Первая версия |
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
|
термины/СОКРАЩЕНИя
| Термин/сокращение | Описание |
| СМЭВ | Система межведомственного электронного взаимодействия |
| Поставщик | Организация-владелец электронного сервиса |
| WSDL | Web Services Description Language — язык описания веб-сервисов. |
| XSD | XML Schema definition - язык описания структуры XML документа. |
| SOAP | Simple Object Access Protocol - протокол обмена структурированными сообщениями в распределённой вычислительной среде. |
| XML | eXtensible Markup Language — расширяемый язык разметки. |
| ЖКУ | Жилищно-коммунальные сулуги |
1. Общие сведения
1.1. Руководящие документы
Основанием для разработки данного документа является требование пункта 48 приказа Министерства связи и массовых коммуникаций Российской Федерации
от 27.12.2010 № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» в соответствии с которым, для подключения информационной системы к системе межведомственного электронного взаимодействия поставщик предоставляет оператору СМЭВ следующие документы:
|
|
|
паспорт электронного сервиса, регистрируемого в системе взаимодействия;
методику испытаний электронного сервиса, регистрируемого в системе взаимодействия, включая контрольный пример обращения к электронному сервису;
руководство пользователя электронного сервиса, регистрируемого в системе взаимодействия.
Основанием для создания и использования электронного сервиса являются перечисленные ниже документы.
Нормативно-правовые документы:
· постановление Правительства Российской Федерации от 8 сентября 2010 г.
№ 697 «О единой системе межведомственного электронного взаимодействия»;
· приказ Министерства связи и массовых коммуникаций Российской Федерации от 27.12.2010 № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия»;
· федеральный закон от 21.07.2014 N 209-ФЗ "О государственной информационной системе жилищно-коммунального хозяйства".
|
|
|
· приказ от 28.12.2015 № 589/944/пр "Об утверждении Порядка и способов размещения информации, ведения реестров в государственной информационной системе жилищно-коммунального хозяйства, доступа к системе и к информации, размещенной в ней» (далее – Приказ).
Электронный сервис создается согласно технологическим стандартам СМЭВ, приведенным в документе «Методические рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии» версии 2.6.
Доступ к сервису предоставляется на основании:
· заявки на предоставление доступа к электронному сервису СМЭВ
· заявки на использование принадлежащей им ИС и соглашении об информационном взаимодействии с ГИС ЖКХ (необходимая информация о подключении размещена на портале ГИС ЖКХ).
1.2. Описание электронного сервиса
| Наименование: | Сведения о внесении платы кредитными организациями |
| Назначение: | Сервис используется организациями, через которые производится внесение платы за жилищно-коммунальные услуги, для размещения в ГИС ЖКХ информации о внесении такой платы. |
| Поставщик: | Федеральное государственное унитарное предприятие "Почта России" |
| Область применения: | Другое (передача фактов оплаты в ГИС ЖКХ кредитными организациями) |
1.3. Операции (методы) электронного сервиса
|
|
|
Электронный сервис взаимодействия с организациями, через которые осуществляется внесение платы за жилое помещение и коммунальные услуги, должен обеспечивать обмен данными в рамках интеграции ГИС ЖКХ с внешними системами кредитных организаций, передающие данные о платежах за ЖКУ в ГИС ЖКХ. Электронный сервис содержит методы, обеспечивающие:
- передачу перечня документов "Извещение о принятии к исполнению распоряжения";
- передачу перечня документов "Извещение об аннулировании извещения о принятии к исполнению распоряжения" состояния заявки;
- получение статуса обработки запроса.
| Метод | Назначение |
| Код операции: async_getId_import_notifications_of_order_execution Наименование: передать пакет извещений о принятии к исполнению распоряжений | Принимает электронное сообщение с описанием перечня извещений о принятии к исполнению распоряжений формате XML и возвращает номер зарегистрированной заявки. |
| Код операции: async_getId_import_notifications_of_order_execution_cancellation Наименование: Передать пакет сведений об аннулировании извещений о принятии к исполнению распоряжений | Принимает электронное сообщение с описанием перечня аннулированных извещений о принятии к исполнению распоряжений формате XML и возвращает номер зарегистрированной заявки. |
| Код операции: async_getResult Наименование: получение статуса обработки запроса | Принимает на вход номер заявки и возвращает состояние заявки и список ошибок. |
1.4. Сценарии использования
В соответствии с Приказом, кредитная организация размещает сведения об оплате с использованием имеющейся у нее информационной системы. Схема взаимодействия ГИС ЖКХ с исполнителями услуг, плательщиками и кредитными организациями приведена на рисунке 1.
 |
Рисунок 1 «Схема взаимодействия»
Приказом утвержден следующий перечень информации, необходимой для размещения сведений об оплате в ГИС ЖКХ:
1) сумма средств, внесенных в качестве платы;
2) дата внесения платы;
3) сведения об исполнителе:
3.1) идентификационный номер налогоплательщика (ИНН),
3.2) код причины постановки на учет в налоговом органе (КПП) (для юридического лица),
3.3) наименование (для юридического лица),
3.4) фамилия, имя, отчество (для индивидуального предпринимателя),
3.5) платежные реквизиты исполнителя, по которым внесена плата;
4) идентификатор организации, через которую производится внесение платы, присвоенный данной организации в системе;
5) назначение платежа (при указании данной информации при внесении платы лицом, которым внесена плата);
6) уникальный номер платежа (идентификатор операции), присвоенный такому платежу организацией, через которую внесена плата;
7) информацию в составе сведений, указанных не менее чем в одном из следующих вариантов:
7.1) идентификатор платежного документа;
7.2) идентификатор жилищно-коммунальных услуг, по которому внесена плата, а также период оплаты (при указании лицом, которым внесена плата, периода оплаты);
7.3) единый лицевой счет, а также период оплаты (при указании лицом, которым внесена плата, периода оплаты);
7.4) номер платежного документа, по которому внесена плата, присвоенный такому документу исполнителем в целях осуществления расчетов по внесению платы;
7.5) лицевой счет, присвоенный исполнителем, или иной идентификатор потребителя, присвоенный ему исполнителем в целях осуществления расчетов по внесению платы, а также период оплаты (при указании лицом, которым внесена плата, периода оплаты);
7.6) адрес помещения, в отношении которого внесена плата, а также фамилия, имя, отчество потребителя (для физического лица, не являющегося индивидуальным предпринимателем), ИНН (для индивидуального предпринимателя и для юридического лица) и период оплаты (при указании лицом, которым внесена плата, периода оплаты).
1.5. Схема взаимодействия
Информационная система кредитной организации вызывает сервис и передает электронное сообщение с перечнем сведений о принятии к исполнению распоряжений и/или сведений об аннулированных извещениях о принятии к исполнению распоряжений. Вызывающая сторона формирует и передает один пакет с помощью вызова методов async_getId_import_accomodation_registered, async_getId_import_notifications_of_order_execution_cancellation или async_getResult.
Взаимодействие в этом режиме реализовано по асинхронной схеме. Указанные методы возвращают управление сразу, не дожидаясь обработки переданных данных. Вызывающей стороне сообщается код заявки. Далее для получения результата вызывающая система может запросить состояние заявки с помощью метода async_getResult.Во взаимодействии внешних информационных систем с ГИС ЖКХ участвуют следующие типы сообщений:
- Пакет извещений о принятии к исполнению распоряжений;
- Пакет извещений об аннулировании извещений о принятии распоряжения к исполнению;
- Квитанция;
- Запрос статуса или результата обработки;
- Статус или результат обработки.
Диаграмма последовательности передачи сообщений представлена на рисунке 2.
Рисунок 2 «Диаграмма последовательности»
1.6. Связи с другими электронными сервисами
В случае, если плательщик не предоставил необходимые сведения об оплате, следует использовать сервис СМЭВ для экспорта информации, необходимой для внесения платы за ЖКУ через кредитные организации.
2. Руководство пользователя
2.1. Операция «передать пакет извещений о принятии к исполнению распоряжений»
2.1.1. Общие сведения
| Код операции: | async_getId_import_notifications_of_order_execution |
| Наименование операции: | Передать пакет извещений о принятии к исполнению распоряжений |
| Назначение операции: | Операция предназначена для передачи электронных сообщений с описанием перечня сведений о количестве зарегистрированных и проживающих лиц для дальнейшей их обработки в ГИС ЖКХ. |
2.1.2. Описание входных параметров
Входные данные: importNotificationsOfOrderExecutionRequest
| № | Код параметра | Описание параметра | Обязательность | Способ заполнения/Тип | Комментарий |
| 1 | smev:Message | Служебный заголовок СМЭВ | + | smev:Message | |
| 2 | tns:importNotificationsOfOrderExecutionRequest/tns:MessageData/tns:AppData/tns:importNotificationsOfOrderExecution | Перечень извещений о принятии к исполнению распоряжений. | + | business: importNotificationsOfOrderExecution | Множественный |
2.1.3. Описание выходных параметров
Выходные данные: acknowledgeID
| № | Код параметра | Описание параметра | Обязательность | Способ заполнения/Тип | Комментарий |
| 1 | smev:Message | Служебный заголовок СМЭВ | + | smev:Message | |
| 2 | business:MessageData | Квитанция приема сообщения | + | business:StateResultType | Код обработки сведений - business:getStateResult/business:MessageData/business:AppData/business:CommonResult Код ошибки обработки сообщения - business:getStateResult/business:MessageData/business:AppData/business:ErrorMessage |
Параметры комплексного типа описаны в приложении «Описание общих структур данных».
2.1.4. Контрольные примеры
Запрос
|
Ответ на запрос в случае успешного исполнения
|
|
2.2. Операция «передать пакет сведений об аннулировании извещений о принятии к распоряжения к исполнению»
2.2.1. Общие сведения
| Код операции: | async_getId_import_notifications_of_order_execution |
| Наименование операции: | Передать пакет извещений о принятии к исполнению распоряжений |
| Назначение операции: | Операция предназначена для передачи электронных сообщений с описанием перечня сведений о количестве зарегистрированных и проживающих лиц для дальнейшей их обработки в ГИС ЖКХ. |
2.2.2. Описание входных параметров
Входные данные: importNotificationsOfOrderExecutionCancellationRequest
| № | Код параметра | Описание параметра | Обязательность | Способ заполнения/Тип | Комментарий |
| 1 | smev:Message | Служебный заголовок СМЭВ | + | smev:Message | |
| 2 | tns:importNotificationsOfOrderExecutionCancellationRequest/tns:MessageData/tns:AppData/tns:importNotificationsOfOrderExecutionCancellation | Перечень извещений о принятии к исполнению распоряжений. | + | business: importNotificationsOfOrderExecutionCancellation | Множественный |
2.2.3. Описание выходных параметров
Выходные данные: acknowledgeID
| № | Код параметра | Описание параметра | Обязательность | Способ заполнения/Тип | Комментарий |
| 1 | smev:Message | Служебный заголовок СМЭВ | + | smev:Message | |
| 2 | business:MessageData | Квитанция приема сообщения | + | business:StateResultType | Код обработки сведений - business:getStateResult/business:MessageData/business:AppData/business:CommonResult Код ошибки обработки сообщения - business:getStateResult/business:MessageData/business:AppData/business:ErrorMessage |
Параметры комплексного типа описаны в приложении «Описание общих структур данных».
2.2.4. Контрольные примеры
Запрос
Дата добавления: 2018-02-28; просмотров: 203; Мы поможем в написании вашей работы! |
Мы поможем в написании ваших работ!