Приложение 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	Документ не принят к обработке	Другая ошибка обработки. Дополнительные сведения смотрите в поле с подробным комментарием
IncomingNumberAssoti ated	Документу присвоен входящий номер
Reportlnvalid	Документ не принят к обработке	Не найдены необходимые поля в документе
InvalidScheme	Документ не принят к обработке	Документ не соответствует структуре отчета
InvalidSignature	Ошибка проверки ЭП	ЭП не легитимна

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

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

var ws = new ReportsService();

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

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

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

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

WebClient wc = new WebClient();

string notificationURL =

            string.Format("http://Ik.fcsm.ru/Home/Notification/{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 от Сигнал-КОМ.