Приложение 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"];

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