Служба поддержки пользователей ФГИС ЕИАС (информационно-технический центр ФАС России)

Поиск по базе знаний:


Знание#114: Методы АРМ

Использование API для отправки форм в ЕИАС.

Для работы участников, предоставляющих данные в ЕИАС, помимо стандартных средств отправки отчетных форм («ЕИАС Мониторинг :: АРМ Специалиста» или тонкий клиент «ЕИАС.ВЕБ»), можно использовать подключение непосредственно к SOAP API. Обмен данными осуществляется через WCF сервис, расположенный по адресу ​http://reporting.eias.ru/service/mex. Для получения XML описания методов протокола вы можете использовать адрес ​http://reporting.eias.ru/service/mex?wsdl.

 

Порядок работы с API ЕИАС для получения актуальных запросов и отправки отчетных форм.

  1. Авторизоваться и получить ключ сессии при помощи метода IServiceManager.Login
  2. Получить XML с обновлениями запросов и ответов при помощи метода ITemplateManager.GetUpdates
  3. Извлечь из полученного XML информацию о текущих активных запросах и статусах обработки ответов.
  4. Получить идентификатор (GUID) запроса.
  5. Подготовить во внешней системе отчетную форму. Сформировать файл открепленной подписи.
  6. Создать новый ответ при помощи метода ITemplateManager.SaveResponse и получить в ответ временнУю метку.
  7. Инициализировать отправку файла ответа методом ITemplateManager.StartTransferToServer
  8. Архивировать отчетную форму алгоритмом gzip.
  9. Разбить архивированный файл на части не более 100 Кб.
  10. Поочередно, синхронно отправить каждый кусок файла методом IFileTransferingProxy.ITemplateManager_AppendPart
  11. Завершить отправку файла и передать его подпись для проверки методом ITemplateManager.EndTransferToServer
  12. Для получения статуса обработки необходимо просто получить обновления, указав временную метку, полученную при отправке ответа.

 

Структура и описание SOAP методов:

Метод Параметры    Тип параметра Возврат (тип)  Описание модуля
IServiceManager.
Login		 Login string 
UserSessionInfo
 Получаем ключ сессии из поля UserSessionInfo.SessionKey
PasswordHash1 byte[]
auxiliaryParams2 Dictionary<string, string>
ITemplateManager.
GetUpdates		 sessionKey Guid TemplateInfo Получаем актуальный перечень запросов и информацию о них из поля TemplateInfo.XmlUpdatesCompressedStream
initialTimestamp long
Отправка ответа на запрос
ITemplateManager.
SaveResponse		 sessionKey Guid long Сохраняем ответ, чтобы впоследствии туда крепить файлы. Получаем временную метку.
responseInfo ResponseInfo
ITemplateManager.
StartTransferToServer		 sessionKey Guid StartTransferInfo Начинаем отправку, создаем тикет (StartTransferInfo.Ticket)
responseFileInfo ResponseFileInfo
fileHash byte[]
IFileTransferingProxy.
ITemplateManager_AppendPart		 sessionKey Guid Void  Отправляем кусок файла
ticket Ticket
data byte[]
ITemplateManager.
EndTransferToServer		 sessionKey Guid Tuple<byte[], byte[]>3 Если все ушло нормально – приходит Квитанция о приеме и ее подпись
ticket Ticket
signature byte[]

 

               Описание структур (типов)

 ResponseInfo

Guid ResponseId – формируется клиентом

Guid RequestId – берется из xml, Пришедшего с сервера

string Comments

bool Expired – знак того, что ответ отправляется с опозданием

ResponseFileInfo

Guid ResponseId – формируется клиентом
Guid TemplateId - берется из xml, Пришедшего с сервера
string FileType – тип файла “EXCL” или  “OTHR”
string FileName
long FileDate
string MimeType
int Version – порядковый номер версии файла при его переотправке в рамках того же ответа
string Comments
Guid ResponseFileId - формируется клиентом
Guid FileId

UserSessionInfo

Guid SessionKey
string ServiceInfo – XML описание сессии

TemplateInfo

       byte[] XmlUpdatesCompressedStream – сжатый XML со структурой запросов, шаблонов и ответов

StartTransferInfo

long TimestampResponseFile
long TimestampFile
Ticket Ticket

 

При возникновении ошибок/вопросов по работе функционала, просьба обращаться на sp.eias.ru

_______________________

1 MD5 хеш подписи

2 auxiliaryParams – дополнительные параметры авторизации, д.б указано {"TargetServerId", “00000000-0000-0000-0000-000000000000”}

3 Возвращается сжатая XML квитанция – в первом параметре и ее сжатая подпись – во втором.

 


 

Детали знания

ID знания: 114
Категория: Регулирующим органам
Дата добавления: 23.09.2020 12:26:04
Просмотры: 2564

 
<< Назад