Небанковская кредитная организация
акционерное общество
«НАЦИОНАЛЬНЫЙ РАСЧЕТНЫЙ ДЕПОЗИТАРИЙ»
Инструкция по взаимодействию с НРД
через Web-сервис
в рамках обмена платежными документами по стандарту ISO20022
Москва, 2017
Аннотация
Настоящая инструкция по взаимодействию с НРД через Web-сервис в рамках обмена платежными документами по стандарту ISO20022 (далее – Инструкция) является техническим документом Небанковской кредитной организации акционерного общества «Национальный расчетный депозитарий» (далее - НРД) и описывают порядок обеспечения электронного документооборота с использованием Web-сервиса НРД ONYX (далее Web-сервис).
© Небанковская кредитная организация акционерное общество «Национальный расчетный депозитарий», 2017
Оглавление
1. Используемые термины и определения 5
2. Порядок работы 6
2.1. Общие положения 6
2.2. Требования к рабочему месту при использовании СКЗИ 6
2.3. Допустимые операционные системы 7
2.4. Допустимые типы электронных документов 7
2.5. Подключение к Web-сервису 7
Общие сведения 7
Web-сервис (ONYX) 7
3. Обмен пакетами документов 8
3.1. Общие сведения 8
3.2. Правила формирования пакета ЭД для обмена платежными документами 8
4. Интерфейс взаимодействия с Web-сервисом 9
4.1. Общие сведения 9
4.2. Аутентификация 10
4.3. Технология MIME 10
4.4. Нарезка и прием/отправка пакетов 12
4.5. Формирование запросов к Web-сервису 13
4.6. Ответ Web-сервиса 14
5. Функции (методы), предоставляемые Web-сервисом 15
5.1. Общая информация 15
5.2. Спецификации 15
InitTransferIn – начало отправки пакета документов 15
Входные параметры: 15
Выходные параметры: 15
PutPackage - отправка пакета документов 16
Входные параметры: 16
Выходные параметры: отсутствуют 16
GetTransferResult – завершение отправки пакета документов 16
Входные параметры: 16
Выходные параметры: отсутствуют 17
GetPackageList – получение списка пакетов из НРД 17
Входные параметры: 17
Выходные параметры: 17
Формат XML package_list 17
GetPackage – получение пакета документов из НРД 18
Входные параметры: 18
Выходные параметры: 18
GetPackageListExt – получение списка пакетов из НРД (расширенный) 18
Входные параметры: 18
Выходные параметры: 19
Формат package_list.xml 19
6. Коды возврата и описания ошибок, возвращаемых Web-сервисом 20
7. Пример SOAP запроса PutPackage 21
8. Примеры пакетов электронных документов в СЭД НРД 23
8.1. Инициирование перевода денежных средств клиентом 23
Структура пакета документов с поручением на перевод денежных средств клиентом/отмену перевода денежных средств 23
Структура папки для Файлового шлюза 23
8.2. Примеры уведомлений о получении Пакета электронных документов 24
9. Типы электронных документов, применяемых в рамках обмена платежными документами, по стандарту ISO20022 25
1.Используемые термины и определения
Base64 - обратимое кодирование с возможностью восстановления, основанное на позиционной системе счисления с основанием 64. Используется, например, в электронной почте для представления бинарных файлов в тексте письма (транспортное кодирование).
MIME (Multipurpose Internet Mail Extensions) – механизм для передачи через Интернет разнородных данных в одном сообщении. Данные, не являющиеся текстовыми, передаются как вложения. Описание механизма MIME для протокола SOAP см. http://www.w3.org/TR/SOAP-attachments.
SOAP (Simple Object Access Protocol) – протокол для обмена произвольными сообщениями в формате XML. Является одним из стандартов, на которых базируются технологии веб-служб. Описание протокола см. http://www.w3.org/TR/2007/REC-soap12-part0-20070427/.
Валидата CSP - средство криптографической защиты информации, представляющее собой программное обеспечение - криптографический провайдер, который в числе прочих функций поддерживает вычисление и проверку электронной подписи (далее - ЭП) в соответствии с ГОСТ Р 34.10-2001. Подробнее см. http://www.x509.ru/vdcsp.shtml.
Депозитарный код – депозитарный код, присвоенный клиенту в НРД.
Доверенность ЭДО - доверенность на подписание электронных документов в СЭД НРД в соответствии с Правилами ЭДО НРД.
Каноникализация – приведение текста XML к жестко определенному каноническому виду (подробное описание алгоритмов см. http://www.w3.org/TR/xml-c14n#NoXMLDecl).
Канонизированный текст - текст XML, прошедший процедуру каноникализации.
КБ RSA - криптографическая библиотека, использующая асимметричный криптографический алгоритм RSA. Пример: Microsoft CSP.
Квалифицированный сертификат – определение см. в Правилах ЭДО. В WEB-сервисе НРД могут использоваться квалифицированные СКПЭП на основе КБ «Валидата CSP» (КБ «КриптоПро CSP»).
Неквалифицированный сертификат - СКПЭП на основе КБ RSA, выданный удостоверяющим центром, не являющимся аккредитованным в соответствии с действующим законодательством Российской Федерации. В WEB-сервисе НРД могут использоваться неквалифицированные СКПЭП на основе КБ RSA, выданные удостоверяющим центром ОАО Московская Биржа в соответствии с Правилами ЭДО ОАО Московская Биржа.
ОС – операционная система.
Пакет электронных документов (пакет ЭД) - файл, сформированный в соответствии с Правилами ЭДО и заключающий в себе содержимое файлов (файла) ЭД. Пакеты электронных документов формируются только при электронном взаимодействии с использованием WEB-сервиса.
Правила ЭДО – Правила электронного документооборота НРД (приложение 1 к Договору об обмене электронными документами), с которыми можно ознакомиться на официальном сайте НРД http://www.nsd.ru/ru/documents/workflow/.
Сетевые справочники сертификатов (LDAP) - реестры СКПЭП Организатора СЭД (отдельный LDAP для квалифицированных сертификатов и отдельный LDAP для неквалифицированных сертификатов).
СКПЭП - сертификат ключа проверки электронной подписи, определение см. в Правилах ЭДО.
Файловый шлюз (ФШ) – программное обеспечение для автоматического обмена заранее подготовленными сообщениями с НКО АО НРД.
Хэш-код – результат преобразования массива данных в битовую строку. Используется для построения уникальных идентификаторов наборов данных и контрольного суммирования с целью обнаружения ошибок передачи данных.
ЭД – электронный документ, сформированный в соответствии с правилами ЭДО НРД, определение см. в Правилах ЭДО.
ЭП – электронная подпись, определение см. в Правилах ЭДО.
Термины и определения, не установленные в настоящем разделе и используемые в настоящих Технических рекомендациях, должны пониматься в соответствии с терминами и определениями, приведенными в Правилах ЭДО НРД.
|
