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

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);

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

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