Передача сведений о среднемесячных платежах (ССП) по Указанию Банка России от 11.01.2021 № 5704-У «О порядке и форме предоставления сведений о среднемесячных платежах субъекта кредитной истории, о порядке и форме запроса и предоставления квалифицированным бюро кредитных историй сведений, необходимых для подготовки сведений о среднемесячных платежах субъекта кредитной истории, а также о порядке предоставления данных, необходимых для формирования и предоставления пользователям кредитных историй сведений о среднемесячных платежах субъекта кредитной истории».
«Порядок взаимодействия пользователей кредитных историй, бюро кредитных историй, в том числе квалифицированных бюро кредитных историй, с квалифицированными бюро кредитных историй с использованием программного интерфейса приложения (API) в целях предоставления сведений о среднемесячных платежах» публикуется в соответствии с пунктом 1.2 Указания Банка России № 5704-У:
https://cbr.ru/ckki/transfer_inform/
По этой ссылке важно отслеживать вступление в силу новых версий форматов. Так, версия 1.3 вступает в силу с 10.07.2024.
Адрес базового URL API тестовой системы: https://reports.demo.nbki.ru/qbch/
Адрес базового URL API тестовой системы, планируемой к выпуску: https://reports.test-alfa.nbki.ru/qbch/
Адрес базового URL API промышленной системы: https://reports.nbki.ru/qbch/ (до 15.07.2024) https://ssp.nbki.ru/qbch/
Для подключения требуется зарегистрированный через ЛК сертификат и зачастую дополнительная привязка через Службу поддержки.
Для небольшого использования по подготовке и учету сделанных запросов
прилагается файл Microsoft Excel с макросами Api5704.xslm
в папке
XSLM.
Как альтернативу Excel можно рассмотреть другой проект по составлению шаблонных XML-запросов - https://github.com/diev/ReplForms. Для этой программы положен файл шаблона в папку Templates.
Разница между тем, запрашивает клиент ССП только в БКИ или в режиме
одного окна определяется значением параметра ТипЗапроса
:
- ТипЗапроса="
1
" – запрашивает только в БКИ (до 01.07.2024); - ТипЗапроса="
2
" – запрашивает одно окно КБКИ.
СНИЛС требуется указывать по формату \d\d\d-\d\d\d-\d\d\d \d\d
.
ХэшКод требуется переводить в нижний регистр [\da-f]{64}
.
С 10.07.2024 вступает в силу версия формата 1.3
.
При первом запуске будет создан файл настроек Api5704.config.json
(в папке с программой) с параметрами по умолчанию.
Откорректируйте его перед новым запуском:
MyThumbprint
= отпечаток вашего сертификата (прописанного в КБКИ для подключения к их серверу), который должен быть в Хранилище сертификатов и у вас должен быть ключ (и PIN, если назначен);VerboseClient
= отображать содержимое вашего сертификата (для наглядности);ServerAddress
= url сервера для подключения;ServerThumbprint
= отпечаток сертификата сервера (опционально);ValidateTls
= проверять действительность сертификатов TLS (по срокам действия, цепочки и т.п.);ValidateThumbprint
= проверять отпечаток сервера (отключите, если не знаетеServerThumbprint
);VerboseServer
= отображать содержимое сертификата сервера (для наглядности);UseProxy
= использовать прокси;ProxyAddress
= url прокси-сервера (опционально);SignFile
= подписывать запросы в программе (если СКЗИ для подписывания и доступ в Интернет для обмена совмещены на одном АРМ);CleanSign
= удалять подписи ответов в программе (на диске будут сохранены оба файла -.xml
и.xml.sig
);MaxRetries
= число попыток с предписанным интервалом в 1 сек., чтобы получить сведения по запросу;DirSource
= папка и маска файлов с исходными запросами для пакетной обработки (должна существовать, чтобы при запуске без параметров, файлы брались оттуда). Пример:OUT\*.xml
(не забывайте об удвоении\\
в файлах формата JSON);DirRequest
= папка+файл для отправленных запросов, где папка+файл - это путь к создаваемому файлу, где могут быть сделаны автоподстановки (в любом порядке и количестве - и в имени папки, и в имени файла):{name}
= имя исходного файла без расширения;{date}
= текущая дата в форматеГГГГ-ММ-ДД
;{guid}
= ИдентификаторЗапроса из исходного XML;
DirResult
= папка+файл для полученных квитанций;DirAnswer
= папка+файл для полученных сведений;CspTest
= путь к программе КриптоПроcsptest.exe
(опционально);CspTestSignFile
= команда с параметрами для подписи запросов в программе, где:%1
= исходный файл XML;%2
= подписанный файл XML.sig для отправки;%3
= будет подставлено значениеMyThumbprint
для выбора сертификата в Хранилище для подписи.
Предоставление сведений о среднемесячных платежах субъектов кредитных историй:
Api5704 запрос параметры
Регистр командной строки неважен. Ниже запросы (команды) для удобства указаны в верхнем регистре, а файлы - в нижнем.
Обычно программе нужен только первый файл (или guid), а последующие в параметрах она создает с указанными именами и полученной информацией.
dlput – передача от КБКИ данных, необходимых для формирования и предоставления пользователям кредитных историй сведений о среднемесячных платежах Субъекта.
Api5704 DLPUT qcb_put.xml result.xml
dlrequest – запрос сведений о среднемесячных платежах Субъекта.
Параметры: request.xml[.sig] result.xml
(result.xml
будет создан с результатом операции).
Api5704 DLREQUEST request.xml result.xml
dlanswer – получение сведений о среднемесячных платежах Субъекта по идентификатору ответа.
Api5704 DLANSWER n6c80c1c8-f620-491c-994a-6886706d85dc answer.xml
Api5704 DLANSWER result.xml answer.xml
dlputanswer – получение информации о результатах загрузки данных,
необходимых для формирования и предоставления пользователям кредитных
историй сведений о среднемесячных платежах Субъекта, в базу данных КБКИ.
Параметры: id answer.xml
(вместо id
можно подставить result.xml
с ним из предыдущей операции, answer.xml
будет создан с ответом).
Api5704 DLPUTANSWER 945cb186-0d50-45ff-8823-797942987638 answer.xml
Api5704 DLPUTANSWER result.xml answer.xml
certadd – добавление нового сертификата абонента.
Api5704 CERTADD A6563526-A3F3-4D4E-A923-E41E93F1D921 cert.cer cert.cer.sig result.xml
certrevoke – отзыв сертификата абонента.
Параметры: id cert.cer sign.sig result.xml
(result.xml
будет создан с результатом операции).
Api5704 CERTREVOKE A6563526-A3F3-4D4E-A923-E41E93F1D921 cert.cer cert.cer.sig result.xml
Получить новый GUID (пусть в данном примере
6d20a9fd-7bce-4480-bf56-a66932876bf7
).
Подготовить файл запроса request.xml
, где будет этот
ИдентификаторЗапроса="6d20a9fd-7bce-4480-bf56-a66932876bf7"
.
Отправить файл командой dlrequest
:
Api5704 DLREQUEST request.xml result.xml
Посмотреть полученный (в случае успеха передачи) файл result.xml
.
Там будет строка вида (одной строкой) с ответом на наш запрос:
<ИдентификаторОтвета
ИдентификаторЗапроса="6d20a9fd-7bce-4480-bf56-a66932876bf7">
b17c7a39-359e-4e7c-941d-668e2e957a7c
</ИдентификаторОтвета>
Вот этот идентификатор ответа надо через некоторое время отправить командой для получения ответного файла с ССП:
Api5704 DLANSWER b17c7a39-359e-4e7c-941d-668e2e957a7c answer.xml
Другой вариант проще - запустить запрос с файлом из предыдущего этапа - программа возьмет ИдентификаторОтвета из него сама:
Api5704 DLANSWER result.xml answer.xml
Или еще проще - использовать расширение API (см.ниже).
Полученный файл answer.xml
содержит искомую информацию с ССП.
Отправка запроса (dlrequest
), получение квитанции и сведений
(dlanswer
) за один запуск - команда auto
:
Api5704 AUTO request.xml result.xml answer.xml
Пакетная обработка запросов (auto
) из папки за один запуск -
команда dir
(это и действие по умолчанию, если параметров не указано
вовсе, но есть папка DirSource
в конфиге, а также там указаны папки
DirRequest
, DirResult
, DirAnswer
):
Api5704 DIR source request result answer
Api5704
где:
source
- папка с исходными запросами*.xml
(имена файлов любые - рекомендуется использовать ФИО);request
- папка, куда будут сложены копии исходных файлов, переименованные по маскеФИО.yyyy-MM-dd.guid.request.xml
:ФИО
- исходное имя файла (например, ФИО),yyyy-MM-dd
- текущая дата,guid
- ИдентификаторЗапроса из XML;
result
- папка, куда будут сложены полученные квитанции, переименованные по аналогичной маскеФИО.yyyy-MM-dd.guid.result.xml
;answer
- папка, куда будут сложены полученные сведения, переименованные по аналогичной маскеФИО.yyyy-MM-dd.guid.answer.xml
.
После получения файла в папке answer
, соответствующий ему исходный
файл будет считаться обработанным и удален из папки source
, при этом
он всегда может быть позже найден в папке request
с датой и guid.
Для вычисления ХэшКода служит утилита из состава КриптоПро:
"C:\Program Files (x86)\Crypto Pro\CSP\cpverify.exe" -mk -alg GR3411_2012_256 file.pdf
A36D628486A17D934BE027C9CAF79B27D7CD9E4E49469D97312B40AD6228D26F
Для удобства добавлены макрос CalcHash
в Api5704.xlsm (указать файл в
диалоге и скопипастить из окна ввода.
Также добавлен hash.cmd
, которому можно указать файл параметром,
и он запишет рядом с исходным файл .txt
, с кодом уже в нижнем регистре.
https://www.gosuslugi.ru/pgu/eds
- .NET 8
Номер версии программы указывается по нарастающему принципу:
- Требуемая версия .NET (8);
- Год текущей разработки (2024);
- Месяц без первого нуля и день редакции (624 - 24.06.2024);
- Номер билда - просто нарастающее число для внутренних отличий. Если настроен сервис AppVeyor, то это его автоинкремент.
Продукт развивается для собственных нужд, и поэтому Breaking Changes могут случаться чаще, чем это в SemVer.
Licensed under the Apache License, Version 2.0.