Экспорт неоплаченных начислений
Участники (Портал, Кредитная организация) при обращении к ИС УНП могут экспортировать неоплаченные начисления или статусы оплаты начислений указав в запросе экспорта «ExportRequest» значения атрибута kind = «CHARGE» или «CHARGESTATUS».
Поставщик услуги (АН, ГАН) могут запросить статусы своих начислений (атрибут kind = «CHARGESTATUS»).
Начисления могут экспортироваться или из ИС УНП или из ГИС ГМП. Чтобы различать эти два обращения в запросе экспорта в атрибуте «RequestMessage/Id» определен признак выбора системы, к которой направлен запрос:
Если первый символ идентификатора «U» - запрос выполняется только по сущностям сохраненным в ИС УНП;
Если первый символ идентификатора = <буква [A-Z]> не «U» запрос выполняется только в для сущностей отправленных в ГИС ГМП (т.е. запрос транслируется в ГИС ГМП и обрабатывается по правилам ГИС ГМП).
Если Поставщик будет использовать способ оплаты своих начислений по идентификатору плательщика, то запрос экспорта начислений будет осуществляться с использованием тега ExportRequest/ Filter/ Conditions/ Payers / PayerIdentifier, в котором будет указываться уникальный или альтернативный идентификатор плательщика – схема запроса экспорта данных сохраненных в ИС УНП (рис. 6).
Если Поставщик будет использовать способ оплаты своих начислений по уникальному идентификатору начисления (УИН), то в запросе экспорта начислений должны заполняться поля УИН: ExportRequest/ Filter/ Conditions/ ChargesIdentifiers/ SupplierBillID (рис. 6.). В состав УИН (с 9 по 24 разряда согласно п. 3.1 Форматов ИС УНП) может входить значение, известное плательщику (например, номер квитанции или номера договора), по которому может запрашиваться начисление.
В запросе экспорта данных из ИС УНП могут использоваться также данные предварительно загруженного в ИС УНП каталога услуг Поставщика: Поставщик в Каталоге услуг в блоке DescriptionSimpleParameter или блоке DescriptionComplexParameter может определить формат идентификатора плательщика, по которому в дальнейшем будет запрашиваться начисление из ИС УНП - рис.6.
Рисунок 6. «Параметры используемые в схеме запроса экспорта данных из УНП»
Если в качестве идентификатора плательщика Поставщик будет использовать номер лицевого счета, номер договора и т.п. (идентификаторы, не входящие в состав основных идентификаторов плательщика), то запрос начислений осуществляется с использованием блока ExportRequest/ Filter/ Conditions/ Payers / PayerIdentification (рис. 6).
В этом блоке указываются данные услуги и соответствующие данные простого или сложного параметра услуги в которых передается наименование и значение идентификатора плательщика. Соответствующие наименования и значения должны находятся в блоке AdditionalData начислений, загружаемых этим Поставщиком.
Таким образом, возможны три альтернативных варианта экспорта начислений:
С использованием Уникального идентификатора начисления (SupplierBillID);
С использованием Единого/альтернативного идентификатора плательщика (PayerIdentifier);
С использованием Каталога услуг Поставщика по идентификаторам, определённым в параметрах услуги, если наименование и значение этих параметров передано в составе блока AdditionalData начисления.
В запросе экспорта начислений также могут использоваться дополнительные ограничения - рис. 7.
Рисунок 7. «Схема дополнительных параметров – ограничений запроса начислений»
Timeslot – интервал даты/времени (startDate, endDate) за которую выгружаются данные (имеет смысл при указании в запросе списка идентификаторов плательщика – блок «Payers»);
SubordinateIdList - список идентификаторов участников косвенного взаимодействия. Позволяет выгрузить не все начисления ГАН (удовлетворяющие условиям запроса) а только начисления тех Поставщиков – подведомственных организаций этого ГАН, коды регистрации которых, указаны в данном списке;
KBKClassifier – список КБК, позволяет выгрузить только те начисления, реквизит КБК которых указан в данном списке;
OKTMOClassifier – список ОКТМО, позволяет выгрузить только те начисления, реквизит ОКТМО которых указан в данном списке;
Замечание: Ограничение Exclude - признак, исключения нулевых УИН используется при экспорте платежей, как способ отсеивать авансовые платежи (у которых УИН = «0»).
.
Запрос начисления по идентификатору начисления (SupplierBillID)
Для возможности запроса по уникальному идентификатору начисления (УИН) поставщик услуг, сформировавший начисления, должен довести до плательщика информацию о номере идентификатора начисления. Плательщик, используя возможности оплаты через РПГУ или способы оплаты (например, платежные терминалы либо электронные платежи), предоставляемые кредитными организациями, в интерфейсе указывает значение УИН.
В ИС УНП поступает запрос (тип запроса kind="CHARGE), содержащий значение идентификатора начисления (введенный плательщиком идентификатор). В результате ИС УНП экспортирует информацию по конкретному начислению, сформированному поставщиком в адрес плательщика (запрос на экспорт начислений из ИС УНП в этом случае осуществляется по уникальному идентификатору начисления).
Пример запроса начисления по SupplierBillID=0000000711110415521548825 с наложенной подписью (ЭП-ОВ) приведен в Приложении1 к настоящему документу.
Запрос начисления по идентификатору плательщика (PayerIdentifier)
Для возможности запроса по идентификатору плательщика, являющегося физическим лицом, в начислениях, передаваемых поставщиком услуг в ИС УНП, должен быть указан идентификатор плательщика, сформированный с использованием СНИЛС или реквизитов документов, удостоверяющих личность.
В случае, когда плательщик является юридическим лицом, в начислениях, передаваемых поставщиком услуг в ИС УНП, должен быть указан альтернативный идентификатор плательщика, значением которого является ИНН, КПП юридического лица.
Плательщик, являющийся физическим лицом, вводит значение номера документа, удостоверяющего личность или СНИЛС, плательщик, являющийся юридическим лицом, вводит значение ИНН, КПП. На основании введенной информации формируется запрос на экспорт начислений из ИС УНП по идентификатору плательщика (тип запроса kind="CHARGE). В результате плательщик получает информацию по всем неоплаченным начислениям, сформированным поставщиками в его адрес, у которых в состав значения идентификатора плательщика входит указанное плательщиком значение. Если при этом в запросе указан блок Timeslot (startDate, endDate), то начисления будут отфильтрованы по дате/времени регистрации в Системе согласно указанному диапазону.
Пример запроса начисления по PayerIdentifier=0100000000002514258963643 с наложенной подписью (ЭП-ОВ) приведен в Приложении1 к настоящему документу.
Запросы начисления с использованием каталога услуг (com:PayerIdentification)
Запрос начислений по com:PayerIdentification (каталогу услуг) осуществляется в случае, когда в качестве идентификатора плательщика поставщик будет использовать номер лицевого счета, номер договора и т.п. (идентификаторы, не входящие в состав уникальных идентификаторов плательщика). Значения указанных идентификаторов находятся в реквизитах AdditionalData начисления.
Для возможности поиска начислений по Каталогу услуг поставщика, (в частности ГУП ГорБТИ идентификаторами поставщика являются «номер заказа», «номер квитанции»), в Каталоге услуг поставщика, передаваемом поставщиком в ИС УНП, необходимо указать наименование ключевых идентификаторов (кодовое наименование реквизитов услуг – например, NUM_ZUK, в случае, если его значение, будет указано в AdditionalData начисления), определить параметры ввода этих значений плательщиком (маску идентификатора), а также наименование параметров услуги, по которому будет запрашиваться начисление (Примеры заполнения Каталога услуг представлены в п.2).
Плательщик выбирает поставщика услуг (для возможности выбора плательщиком конкретного поставщика и услуги, требуется, чтобы в Каталоге услуг содержалась вся необходимая информация для классификации и идентификации поставщика и его услуг), выбирает интересующую его услугу и вводит известное ему значение идентификатора поставщика услуг (например, номер заказа). В результате направляется запрос экспорта начислений из ИС УНП идентификации плательщика по каталогу услуг (PayerIdentification).
Пример запроса начисления по параметрам услуги с использованием идентификаторов плательщика переданных в составе блока AdditionalData начисления:
Поставщик услуг в DescriptionSimpleParameter Каталога услуг поставщика, передаваемого в ИС УНП, указывает значения параметра для поиска конкретного начисления, выставленного в адрес плательщика - «номер заказа» и/или «номер услуги», определяет параметры ввода его значения плательщиком (маску идентификатора), а также наименование параметра услуги NUM_ZUK (NUM_KV), по которому следует запрашивать начисление. В таком случае, в передаваемом в ИС УНП начислении соответствующими значениями name и value в AdditionalData будут NUM_ZUK и/или NUM_KV и 2297300483 и/или 229730048364.
Плательщик, используя возможности оплаты через РПГУ или способы оплаты (например, платежные терминалы либо электронные платежи), предоставляемые кредитными организациями, в интерфейсе указывает значение номера заказа 2297300483
Пример запроса начисления по параметру услуги NUM_ZUK = 2298300483 с наложенной подписью (ЭП-ОВ) приведен в Приложении1 к настоящему документу.
Приложение 1
Контрольные примеры и ответные сообщения ИС УНП для различных вариантов взаимодействия приведены в архиве:
При использовании примеров запросов необходио учитывать следующее:
Данные запросы были направлены на тестовый (предпромышленный) сервис ИС УНП и в ответ были получены сообщения актуальные на момент запроса (приведены в файлах–ответах);
Повторный запук импорта приведет к ошибке, так как импортируемые данные уже были загружены ранее (согласно п.1), т.е. примеры могут рассматриваться только как шаблоны для формирования Участником собственных запросов;
Изменение данных в запросе приведет к нарушению ЭП-ОВ / ЭП-СП, т.е при формировании запроса на основе данных примеров необходимо переподписать подписать запрос.
При использовании данных примеров, идентификаторы Участника, начисления, платежа, услуг, ИНН, КПП Участника в запросах дожны быть заменены на фактические данные, используемые данным Участником, зарегистрированым в ИС УНП / ГИС ГМП.
Для правильной обработки нескольких запросов требуется соблюдать порядок их запуска:
А) Импорт исходного каталога в ИС УНП;
Б) Импорт изменений каталога в ИС УНП;
Импорт начисления по услуге из ранее загруженного каталога в ИС УНП;
А) Экспорт статуса ранее загруженного начисления в ИС УНП;
Б) Экспорт факта оплаты, ранее импортированного в ИС УНП;
В) Экспорт квитанций после выполения процедуры квитирования для ранее импортированных начислений и фактов оплаты.
Ниже в табл. 8 приведено описание контрольных примеров, входящих в данный архив
Таблица 8 «Описание контрольных примеров»
Название xml-файла - запроса
|
Название xml-файла -ответа
|
Описание запроса
|
Импорт каталога
|
Ответ импорта каталога
|
Пример импорта исходного каталога Поставщика с 2 услугами, в составе которых используются простые и сложные праметры: в том числе параметры идентифицирующие плательщика, Номер договора, КБК, и содержащие признак дублирования данных в ГИС ГМП
|
Импорт начисления
|
Ответ импорта начисления
|
Пример: Импорт начисления и ответ об успешном завершении форматных проверок с указанием идентификатора пакета принятого в обработку
|
Запрос статуса пакета
|
Ответ со статусом пакета
|
Пример запроса статуса обработки ранее загруженного пакета импорта начислений, направляется с задержкой необходимой для завершения обработки. Если пакет еще не обработан - возвращается код ошибки = 50 «Обработка пакета не завершена», если пакет обработан неуспешно возращается код ошибки логического контроля (как вариант – сообщение о недоступности ГИС ГМП).
|
Экспорт статуса начислений
|
Ответ экспорта статуса начислений
|
Пример запроса экспорта статуса ранее загруженного начисления. В запросе указывается УИН начисления. В ответном сообщении получаем начисления (в том числе аннулированные) с указанием статуса квитирования начисления.
|
Экспорт платежей
|
Ответ экспорта платежей
|
Пример экспорта платежей, которые ранее были загружены по данному начислению. В запросе указывается УИН начисления. В ответном сообщении получаем факты оплаты, зарегисрированные в Системе по данному начислению.
|
Экспорт квитанций
|
Ответ экспорта квитанций
|
Пример экспорта квитанций по итогу выполнения процедуры квитирования фактов оплаты с ранее загруженным начислением. В запросе указывается УИН начисления. В ответном сообщении получаем результаты квитирования (возвращается результат квитирования с последним полученным платежом). В квитанции передается статус квитирования начисления со всеми платежами, но отражается результат квитирования только с последним полученным платежом.
|
|
