"Технические рекомендации по представлению электронных документов в Службу Банка России по финансовым рынкам" (утв. Банком России)

Приложение N 3. Описание веб-сервиса передачи документов в Службу Банка России по финансовым рынкам

Приложение N 3

к Техническим рекомендациям

ОПИСАНИЕ

ВЕБ-СЕРВИСА ПЕРЕДАЧИ ДОКУМЕНТОВ В СЛУЖБУ БАНКА РОССИИ

ПО ФИНАНСОВЫМ РЫНКАМ

1. Описание сервиса:

Веб-сервис передачи электронных документов обеспечивает передачу документов с ЭП в Службу и получение уведомлений (статусов обработки) для переданных пакетов документов. Технически веб-сервис реализован с использованием протокола HTTPS в качестве транспорта.

2. Описание операций:

Submit:

SOAP-запрос;

формальное описание доступно по адресу: https://lk.fcsm.ru:8080/ReportService.asmx

Описание:

Передать документ в Корпоративную информационную автоматизированную систему Службы банка России по финансовым рынкам (далее - КИАС).

Параметры:

name: имя документа для отображения в Личном кабинете. После обработки документа в КИАС, имя документа в Личном кабинете изменится на наименование, извлеченное из тела документа.

signedDocument: тело подписанного пакета документов в кодировке base64.

Возврат:

Идентификатор пакета.

Download Notification:

GET-запрос, возвращающий уведомление для данного идентификатора.

Запрос выполняется по URL http://lk.fcsm.ru/Home/Notification/{id} или https://lk.fcsm.ru/Home/Notification/{id}, где id - идентификатор пакета, возвращаемый операцией Submit.

Возврат:

тело ответа - файл уведомления.

FFMS-notification-status (http-заголовок ответа)---статус обработки:

Значение статуса

Описание статуса в личном кабинете

Подробное описание

Processing

Документ загружен в систему

SignatureCorrect

ЭП корректна

SignatureError

Ошибка проверки ЭП

PackageCorrupted

Документ не принят к обработке

Нарушена целостность документа

Accepted

Документ принят к обработке

Документ принят к обработке

PackageNotRegistered

Документ не принят к обработке

Другая ошибка обработки.

Дополнительные сведения смотрите в поле с подробным комментарием

IncomingNumberAssotiated

Документу присвоен входящий номер

ReportInvalid

Документ не принят к обработке

Не найдены необходимые поля в документе

InvalidScheme

Документ не принят к обработке

Документ не соответствует структуре отчета

InvalidSignature

Ошибка проверки ЭП

ЭП не легитимна

Пример использования:

Ниже представлен пример передачи пакета документов и получения уведомления. Реализован под .NET Framework (C#):

var ws = new ReportsService();

ws.Url = "http://lk.fcsm.ru:8080/ReportService.asmx";

// передать отчетность

string id = ws.Submit(ReportName, buffer);

// получить уведомление

WebClient wc = new WebClient();

string notificationURL =

string.Format("http://lk.fcsm.ru/Home/Notificatior/{0}",

id));

byte[] nl = wc.DownloadData(notificationURL);

string status = wc.ResponseHeaders["FFMS-notification-status"];

Формат подписанного пакета документов:

Подписанный пакет документов представляет собой zip-архив, содержащий передаваемый файл и ЭП в отдельном файле.

Формат для СКЗИ Крипто-Про и СКЗИ Крипто-Ком в режиме совместимости с Крипто-Про:

Архив верхнего уровня должен содержать передаваемый файл и ЭП:

Package.zip

\

|--Document.xtdd

|--Document.xtdd.[Расширение_подписи]]

[Расширение_подписи] должно быть одним из: "SIG", "SGN", "SIGN" (нечувствительно к регистру):

Формат ЭП:

ЭП должна быть сохранена в формате CMS в кодировке DER. Подпись обязательно должна включать сертификат подписавшего лица.

Формат для СКЗИ ИнтерПро (Сигнал-КОМ):

Архив не должен содержать папок; файлы должны лежать в корне Архива; наименование файлов должно быть следующим:

1. [ИмяФайла_формы].[Расширение_формы] - передаваемая http-форма; например, DATA_312389.txt

2. [ИмяФайла_формы].[Расширение_формы].IPRO_SIG - файл с ЭП например, DATA_312389.txt.ipro_sig

Формат ЭП:

ЭП должна соответствовать формату, понятному утилите fverify от Сигнал-КОМ.

Приложение N 2. Описание АРМа "Отправка электронных документов"