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

Приложение N 3
к Техническим рекомендациям

Описание
веб-сервиса передачи документов в ФСФР России

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

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

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

Submit:

SOAP-запрос;

формальное описание доступно по адресу: https://62.105.144.24/Accounts/ReportsService.asmx.

Описание:

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

Параметры:

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

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

Возврат:

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

Download Notification:

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

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

Возврат:

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

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

Значение статуса	Описание статуса
SignatureCorrect	ЭЦП корректна
SignatureError	Ошибка проверки ЭЦП
Accepted	Документ принят к обработке
DontAccepted	Документ не принят к обработке
IncomingNumberAssotiated	Документу присвоен входящий номер

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

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

var ws = new ReportsService();

ws.Url = "http://62.105.144.24/Accounts/ReportsService.asmx";

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

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

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

WebClient wc = new WebClient();

string notificationURL = ws.Url.Replace("ReportsService.asmx",

string.Format("Download/Notification/{0}", id));

byte[] n1 = 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 от Сигнал-КОМ.