Версия от 29.08.2017 Инструкция по подключению кредитных организаций, платежных агентов, платежно-банковских агентов к ИС РНиП по форматам взаимодействия версии 1.16.4 Версия от 29.08.2017 Аннотация В документе описан порядок подключения и прохождения предварительных проверочных тестов, проводимых с целью проверки взаимодействия информационных систем в роли кредитная организация, платежный агент, банковский платежный агент с государственной информационной системой, обеспечивающей в городе Москве регистрацию начислений и платежей (далее - ИС РНиП). Список терминов, определений и сокращений КО - кредитная организация, платежный агент, банковский платежный агент СТП - служба технической поддержки ИС РНиП ИС КО – информационная система кредитной организации, проходящей тестирование на тестовом стенде ИС РНиП. ГИС ГМП – Государственная информационная система о государственных и муниципальных платежах СМЭВ – система межведомственного электронного взаимодействия РСМЭВ – региональная система межведомственного электронного взаимодействия ГУП МСР - Государственное унитарное предприятие города Москвы «Московский социальный регистр» является Оператором государственной информационной системы, обеспечивающей в городе Москве регистрацию начислений и платежей в соответствии с постановлением Правительства Москвы от 28.08.2014 № 497-ПП «О внесении изменений в постановление Правительства Москвы от 09 октября 2012 года № 544» (далее - Оператор ИС РНиП). Контакты Руководитель проектов по подключению КО информационно-сервисного Оператора ИС РНиП – Амирханян Светлана Альбертовна [email protected] 8 (499) 755-06-50 (доб. 240) Адрес СТП – [email protected] Версия от 29.08.2017 Подготовительные действия Перед регистрацией в ИС РНиП КО необходимо обеспечить наличие технологической электронной подписи (ТЭП) в любом уполномоченном удостоверяющем центре. Более подробную консультацию по ТЭП можно получить у руководителя проектов по подключению КО информационно-сервисного Оператора ИС РНиП. Регистрация в ИС РНиП осуществляется путем направления в адрес руководителя проектов по подключению КО информационно-сервисного Оператора ИС РНиП заявки на подключение и иных документов (далее – пакет документов), предусмотренных в Порядке функционирования ИС РНиП. Более подробную информацию о порядке подачи пакета документов на участие в ИС РНиП можно получить у руководителя проектов по подключению КО информационносервисного Оператора ИС РНиП. После регистрации в ИС РНиП, организации будет присвоен уникальный регистрационный номер (далее - УРН), который необходимо использовать в запросах к ИС РНиП, указывая его значение в элементе RequestMessage в атрибуте SenderIdentifier. Если ИС КО была зарегистрирована ранее в ИС РНиП по форматам взаимодействия ИС РНиП 15.х версий, то требуется пройти перерегистрацию путем направления в СТП ИС РНиП для получения нового 6-ти символьного УРН, для этого нужно направить в адрес руководителя проектов по подключению КО информационно-сервисного Оператора ИС РНиП УРН организации, полученный в ГИС ГМП (в случае если УРН ГИС ГМП на промышленной и тестовой/предпромышленной среде отличаются, то необходимо указать оба). В элементе RequestMessage в атрибуте SenderIdentifier используется 6-ти символьный УРН, полученный при регистрации в ИС РНиП версии форматов версии 1.16. Участнику необходимо убедиться, в доступности веб-сервиса ИС РНиП по адресу: http://test.rnip.mos.ru/UnifoSecProxy_WAR/RsmevRnipService, используя любой удобный способ, например WEB-браузер. Для успешного тестирования необходимо выполнить запросы к ИС РНиП по всем 5 обязательным шагам тестирования (описаны ниже). После прохождения всех этапов тестирования необходимо предоставить на проверку логи (запрос и ответ по каждому из пройденных шагов тестирования) Оператору ИС РНиП на адрес Версия от 29.08.2017 СТП в виде архива, а также направить копию письма руководителю проектов по подключению КО информационно-сервисного Оператора ИС РНиП. Версия от 29.08.2017 Рекомендации по заполнению контейнера Message Описание элементов, представленных в контейнере Message можно найти в п. 5.1 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» версии 1.16.4. Мнемоника ИС РНиП в СМЭВ - 105805771. При отсутствии мнемоники отправителя, во время тестирования допускается использовать значение (9 символов, согласно xsd-схеме) в теге Sender/Code – 000000001 или УРН (переведенный в десятеричную систему) и дополненный слева символом ноль до 9 символов. В промышленном контуре РНиП необходимо использовать, при работе в среде СМЭВ присвоенную мнемонику СМЭВ или при работе через среду интернет УРН (переведенный в десятеричную систему) и дополненный слева символом ноль до 9 символов. Информацию о мнемонике системы в СМЭВ можно уточнить в службе технической поддержки СМЭВ по электронной почте: [email protected] или на портале СМЭВ: Электронные сервисы http://smev.gosuslugi.ru/portal/services.jsp#!/F Шаблон заполненного контейнера: <rev:Message xmlns:rev="http://smev.gosuslugi.ru/rev120315" > <rev:Sender> <rev:Code>000000001</rev:Code> <rev:Name>Наименование_Участника</rev:Name> </rev:Sender> <rev:Recipient> <rev:Code>105805771</rev:Code> <rev:Name>ИС_РНиП</rev:Name> </rev:Recipient> <rev:ServiceName>105805771</rev:ServiceName> <rev:TypeCode>GFNC</rev:TypeCode> <rev:Status>REQUEST</rev:Status> <rev:Date>2015-07-14T00:00:01.000Z</rev:Date> <rev:ExchangeType>0</rev:ExchangeType> </rev:Message> Для систем, взаимодействующих через закрытый канал СМЭВ, требования и ограничения на значения в элементах контейнера Message накладывает СМЭВ, и они отражены в документе «Методические рекомендации по работе с Единой системой межведомственного электронного взаимодействия - версия 2.5.6». Согласно МР СМЭВ-2.х.х п.7.7.9. «Правила формирования мнемоник точек подключения» - блоки, содержащие Версия от 29.08.2017 информацию об Участниках информационного межведомственного взаимодействия (Sender,Recipient,Originator), заполняются следующим образом: 1) Мнемоника точки подключения информационной системы(Code) формируется по следующему шаблону: XXXXNNRRM, где XXXX – четырехсимвольная мнемоника участника; NN – двухзначный номер информационной системы ведомства; RR – двузначный код региона, к которому относится точка подключения; M – однозначный номер экземпляра точки подключения в регионе. 2) Наименование участника(Name) заполняется в текстовом формате, т.е. прописывается участник межведомственного обмена, являющийся владельцем информационной системы. Для примера: ИС "Информационная система регистрации начислений и платежей" Департамента информационных технологий города Москвы - 9-значная мнемоника ИС будет следующей: 105805771 Версия от 29.08.2017 Версия от 29.08.2017 План тестирования Версия от 29.08.2017 Обязательные шаги тестирования: Шаг 1. Экспорт каталога; Шаг 2. Экспорт начисления; Шаг 3. Импорт авансового платежа; Шаг 4. Проверка импорта авансового платежа и по начислению; Шаг 5. Запрос статуса обработки импортируемого пакета. Версия от 29.08.2017 Шаг 1. Экспорт каталога Варианты экспорта каталога: Экспорт полного каталога Экспорт изменений каталога Для осуществления теста необходимо наличие в ИС РНиП загруженного каталога. Тестовые примеры в Приложении 1 (предоставляются по запросу от КО оператором СТП). ИС КО осуществляет запрос экспорта каталога (по любому варианту экспорта каталога), структура запроса описана в п. 5.4 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» версии 1.16.4 и п.2.4 документа «Методические рекомендации по заполнению каталога услуг и реализации запросов экспорта и импорта сущностей из ИС РНиП версии 1.16.4». Внимание! В элементе RequestMessage атрибут ID должен иметь уникальное значение для каждого запроса, значение идентификатора формируется в соответствии с п. 1.9 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» версии 1.16.4. ИС РНиП направляет в ИС КО ответ на запрос экспорта каталога. Примеры запроса и ответа приведены в разделе «Примеры запросов» настоящей инструкции. Версия от 29.08.2017 Шаг 2. Экспорт начисления В ИС РНиП реализованы несколько способов запроса информации по начислениям, подробнее в п. 5.4.2 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» (версия 1.16.4) и п.3.2 документа «Методические рекомендации по заполнению каталога услуг и реализации запросов экспорта и импорта сущностей из ИС РНиП версии 1.16.4». Начисления по муниципальным и государственным услугам1 можно запросить, указав один из параметров поиска: Уникальный идентификатор начисления (далее УИН) (SupplierBillID) Идентификатор плательщика (PayerIdentifier) Начисления по коммерческим услугам1 можно запросить, указав один из параметров поиска: Уникальный идентификатор начисления (далее УИН) (SupplierBillID) Идентификатор плательщика (PayerIdentifier) Код услуги и простой параметр с использованием AdditionalData Код услуги и сложный параметр с использованием AdditionalData Для осуществления теста необходимо наличие в ИС РНиП загруженного начисления (предоставляются по запросу от КО оператором СТП). Участник сообщает в СТП о готовности провести тест, уточнив, по какому параметру будет произведен экспорт начисления (параметры описаны выше). Оператор СТП сообщает участнику данные для поиска. ИС КО осуществляет запрос экспорта начисления (kind="CHARGESTATUS" с выбранным параметром поиска), структура запроса описана в пункте 5.4 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» версии 1.16.4. Внимание! В элементе RequestMessage атрибут ID должен иметь уникальное значение для каждого запроса, значение идентификатора формируется в соответствии с п. 1.9 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» (Версия 1.16.4).При использовании параметра постраничной выдачи Paging (при больших объемах экспортируемых данных). В рамках одной серии запросов должны соблюдаться следующие правила: Все запросы одной серии должны иметь одинаковый идентификатор сообщения (RequestMessage/id). Версия от 29.08.2017 ИС РНиП направляет в ИС КО ответ на запрос экспорта начислений. Примеры запроса и ответа приведены в разделе «Примеры запросов» настоящей инструкции. Шаг 3. Импорт авансового платежа и по начислению (коммерческая услуга) Для осуществления теста необходимо наличие в ИС РНиП загруженного каталога с авансовыми услугами и загруженного начисления. Тестовые данные предоставляются по запросу от КО оператором СТП. ИС КО осуществляет запрос импорт авансового платежа и платежа по начислению по коммерческой услуге в ИС РНиП, используя данные из каталога услуг ИС РНиП. Структура запроса описана в пункте 5.2 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» версии 1.16.4. и п.4 документа «Методические рекомендации по заполнению каталога услуг и реализации запросов экспорта и импорта сущностей из ИС РНиП версии 1.16.4». Внимание! В элементе RequestMessage атрибут ID и в элементе FinalPayment атрибут ID должны иметь уникальное значение для каждого запроса, значение идентификатора формируется в соответствии с п. 1.9 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» версии 1.16.4. Запрос на импорт платежа обрабатывается в асинхронном режиме. В результате выполнения запроса импорта обеспечивается предварительный прием в ИС РНиП платежа. Для получения информации о статусе обработки пакета и о принятии / отклонении платежа на стороне ИС РНиП, необходимо выполнить «Шаг 5. Запрос статуса обработки импортируемого пакета». Примеры запроса и ответа приведены в разделе «Примеры запросов» настоящей инструкции. Версия от 29.08.2017 Шаг 4. Проверка импорта авансового платежа и по начислению в ГИС ГМП по государственным услугам участников ИС РНиП Для осуществления теста необходимо наличие в ИС РНиП загруженного каталога с авансовыми услугами и загруженного начисления. Тестовые данные предоставляются по запросу от КО оператором СТП. Импорт платежей по государственным услугам осуществляются напрямую в ГИС ГМП. По результатам тестов проверятся корректность получения данных ПУ и наличие в платежах по государственным услугам контейнера AdditionalData. Внимание! В элементе RequestMessage атрибут ID и в элементе FinalPayment атрибут ID должны иметь уникальное значение для каждого запроса, значение идентификатора формируется в соответствии с п. 1.9 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» версии 1.16.4. Примеры запроса и ответа приведены в разделе «Примеры запросов» настоящей инструкции. Версия от 29.08.2017 Шаг 5. Запрос статуса обработки импортируемого пакета В результате выполнения запросов импорта обеспечивается предварительный прием в ИС РНиП пакета сущностей. Для того, чтобы получить информацию о статусе обработки пакета и о принятии / отклонении начислений, платежей, зачислений на стороне ИС РНиП, необходимо отправить запрос на получение протокола обработки пакета, структура запроса описана в пункте 5.3 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» версии 1.16.4. Внимание! В элементе RequestMessage атрибут ID должен иметь уникальное значение для каждого запроса, значение идентификатора формируется в соответствии с п. 1.9 документа «Форматы взаимодействия ИС РНиП с внешними информационными системами» версии 1.16.4. Примеры запроса и ответа приведены в разделе «Примеры запросов» настоящей инструкции. п. 1.8 Форматов взаимодействия Версия от 29.08.2017 Примеры запросов Примеры запросов КО.rar