Подсистема обработки заявок в Ветис.API
Общая информация
В целях обеспечения эффективного информационного обмена между учетной системой предприятия и ИС «Меркурий» взаимодействие организуется по асинхронной схеме. Для данной схемы действуют следующие правила:
1. Взаимодействие реализуется посредством запросов ИС предприятий к ИС «Меркурий». ИС «Меркурий» не может выступать в роли инициатора запроса к системе предприятия. Передача информации из ИС «Меркурий» осуществляется в виде ответа на запрос ИС предприятия.
2. Любая операция в рамках информационного взаимодействия с ИС «Меркурий» представляет собой заявку на осуществление некоторых действий. По каждой заявке ИС «Меркурий» формирует ответ, который может быть запрошен учетной системой предприятия. Процесс направления и обработки заявки представлен на следующей схеме:
3. Любой запрос в рамках информационного взаимодействия с ИС «Меркурий» должен содержать идентификационные данные хозяйствующего субъекта, производственной площадки, на которой осуществляется бизнес-операция, а также персональные аутентификационные данные сотрудника организации в ИС «Меркурий», осуществляющего действия в ИС предприятия, инициирующие операции по информационному обмену. Таким образом, важным условием осуществления информационного взаимодействия является предварительная регистрация хозяйствующего субъекта, его производственной площадки и ответственных лиц в ИС «Меркурий».
Возможные сценарии
При обработке запроса возможны следующие сценарии.
2.1 Запрос успешно обработан.
2.1.1 Заявка требует обработки.
2.1.2 Результат сформирован в рамках запроса(cтатус заявки-completed).
2.2 Произошла ошибка при обработке запроса.
2.2.1 Некорректный запрос.
2.2.2 Запрос не прошёл проверку на бизнес-правила.
2.2.3 Внутренняя ошибка системы.
Данные запроса
Структура данных запроса в формате ХML.
<ws:submitApplicationRequest>
<ws:apiKey>ZmUyMGM3M2EyMThhMTFlMmE2OWJiNDk5YmFiYWU3ZWHQodGAINGP0L3QsiAxNCAxMjoxOTo1NyBNU0sgMjAxNQ==</ws:apiKey>
<app:application>
<app:serviceId>mercury-g2b.service</app:serviceId>
<app:issuerId>fc479683-26f8-49b3-a76c-f35a289eadcd</app:issuerId>
<app:issueDate>2015-01-10T17:03:00</app:issueDate>
<app:data>
<…>
</app:data>
</app:application>
</ws:submitApplicationRequest>
Объект submitApplicationRequest
Заявка в заявочной системе, определяет пользователя, который инициирует запрос и сам запрос.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
apiKey | Специальный код, который идентифицирует вашу учетную запись и позволяет веб-сервису получить доступ к информации о хозяйствующем субъекте и обслуживаемых предприятиях. | 1 | |
application | Сведения о заявке. | 1 |
Объект application
Поле | Описание | Тип | Обязательность |
---|---|---|---|
apiKey | Специальный код, который идентифицирует вашу учетную запись и позволяет веб-сервису получить доступ к информации о хозяйствующем субъекте и обслуживаемых предприятиях. | 1 | |
application | Сведения о заявке. | argc:User | 1 |
Данные ответа
Структура данных запроса в формате ХML.
<submitApplicationResponse xmlns="http://api.vetrf.ru/schema/cdm/application/ws-definitions">
<application xmlns="http://api.vetrf.ru/schema/cdm/application">
<applicationId>433551e9-8077-431c-9a0f-80eec7fd6fb3</applicationId>
<status>ACCEPTED</status>
<serviceId>mercury-g2b.service</serviceId>
<issuerId>fc479683-26f8-49b3-a76c-f35a289eadcd</issuerId>
<issueDate>2015-04-20T08:29:28</issueDate>
<rcvDate>2015-05-05T15:41:00</rcvDate>
</application>
</submitApplicationResponse>