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