Схема взаимодействия ЕМИАС с ЕАИС СОЦ
Взаимодействие проходит по следующей схеме:
- Для обработки заявления на получение ЛЗП ЕАИС СОЦ отправляет запрос сведений о нуждаемости в ЛЗП по СНИЛС в ЕМИАС.
- В ответ на запрос ЕМИАС передает сведения о нуждаемости в ЛЗП, признаки дорогостоящего лечения и дату проведения последнего ЛЗП.
- ЕАИС СОЦ в результате обработки полученных данных отправляет решение по подтверждению права на ЛЗП:
- В случае, если заявление одобрено, то ЕМИАС получает от ЕАИС СОЦ информацию о льготе и документе-основании, переводит статус заявки на включение пациента в регистр протезирования на «Включен» и сохраняет данную информацию в МИП.
- В случае, если в заявлении отказано, то ЕМИАС получает от ЕАИС СОЦ информацию об отказе в праве на ЛЗП по заявлению, переводит статус заявки на включение пациента в регистр протезирования на «Отказ» и сохраняет данную информацию в МИП.
В случае успешного выполнения вернётся статус 200 – ОК и объект в формате JSON. Пример ответа сервера при успешном выполнении операции: В случае возникновения ошибок вернётся объект ProblemDetails, Пример ответа сервера при возникновении ошибки: Код ответа сервера Сообщение Тип ошибки Справка Справка В случае успешного выполнения вернется статус 200 – ОК В случае возникновения ошибок вернётся объект ProblemDetails, Пример ответа сервера при возникновении ошибки: Код ответа сервера Сообщение Тип ошибки Неверно переданы параметры льготы в теле запросаМетод получения сведений о нуждаемости в ЛЗП и последней даты протезирования
Запрос
Адрес запроса
GET: {{url}}/dental-api/api/NeedLzp?snils={snils}&surname={surname}&name={name}&patronymic={patronymic}&birthday={birthday} Заголовки запроса
Параметр Описание Обязательный Комментарий Authorization Идентификатор приложения-клиента + Клиентское приложение = МИН СОЦ Параметры запроса
Параметр Тип Описание По умолчанию Обязательный Комментарий snils query СНИЛС пациента + surname query Фамилия пациента + name query Имя пациента + patronymic query Отчество пациента - birthday query Дата рождения пациента + Формат: yyyy-MM-dd
Пример запроса:curl --location --request GET 'https://mis.2dr.ru/test/api/dental-api/api/NeedLzp?surname=Петров&name=Петр&patronymic=Петрович&birthday=1984-06-01&snils=017-293-411 11' \
--header 'Authorization: b9577ef0-573c-4cc6-b8a9-8ccfdedb9b52'
Ответ сервера
Параметр Тип данных Описание Комментарий snils string СНИЛС пациента surname string Фамилия пациента name string Имя пациента patronymic string Отчество пациента birthday string Дата рождения пациента Формат: yyyy-MM-dd date string Дата последней услуги по протезированию Формат: yyyy-MM-dd isCostly bool Признак дорогостоящего протезирования isNeedLZP
bool Признак нуждаемости в ЛЗП определяется по включению пациента в "Регистр протезирования" mkabGuid string(Guid) Идентификатор пациента registerGuid string(Guid) Идентификатор записи в регистре {
"snils": "222-222-222 22",
"surname": "Петров",
"name": "Петр",
"patronymic": "Петрович",
"birthday": "2043-01-01",
"date": "2021-05-17",
"isCostly": false,
"isNeedLZP": true,
"mkabGuid": "ABE5ED62-99FF-4787-AA91-DFC304F3CBF7",
"registerGuid": "B6A040E4-8CFC-493D-845C-4A05D832458C"
}
где title – текст ошибки, status – код ошибки{
"title": "Неверно указаны параметры пациента",
"status": 400
}
Возможные ошибки
Вид ошибки 401 Не указан токен Системная ошибка выполнения запроса Error 401 Неверный формат токена Системная ошибка выполнения запроса Error 401 Указан неверный токен Системная ошибка выполнения запроса Error 400 Не найдена запись о пациенте в регистре Пациенту не положено ЛЗП Error 400 Не удалось найти пациента по указанным параметрам в ИЭМК Пациенту не положено ЛЗП Error 400 Не удалось найти пациента по указанным параметрам Пациенту не положено ЛЗП Error Метод приема сведений о подтверждении права на ЛЗП
Запрос
Адрес запроса
POST: {{url}}/dental-api/api/NeedLzp Заголовки запроса
Параметр Описание Обязательный Комментарий Authorization Идентификатор приложения-клиента + Content-Type application/json + Тело запроса
Параметр Тип Тип данных Описание По умолчанию Обязательный Комментарий snils query string СНИЛС пациента - mkabGuid query string(Guid) Идентификатор пациента + registerGuid query string(Guid) Идентификатор записи в регистре + statement query bool Статус заявления на ЛЗП + Если true то все поля ответа обязательны, если false то необязательны comment query string Причина отказа по заявлению - Комментарий с причиной отказа katlCode query string Код категории льготы +/- метод получения справочника категорий льгот katlDocumentSeries query string Серия документа, подтверждающего категорию льготы +/- katlDocumentNumber query string Номер документа, подтверждающего категорию льготы - katlDocumentIssuedBy query string Кем выдан документ, подтверждающий категорию льготы +/- katlDocumentDate query string Дата выдачи документа, подтверждающего категорию льготы +/- katlDocumentBase query string Тип документа, подтверждающего категорию льготы +/-
Документ
Удостоверение
Иной документkatlDateBegin query string Дата начала действия категории льготы +/- Формат: yyyy-MM-dd katlDateEnd query string Дата окончания действия категории льготы - Формат: yyyy-MM-dd lgCode query string Код льготы +/- Для ЛЗП необходимо передавать код "5" (Зубные протезы) lgDocumentSeries query string Серия документа, подтверждающего льготу +/- lgDocumentNumber query string Номер документа, подтверждающего льготу - lgDocumentIssuedBy query string Кем выдан документ, подтверждающий льготу +/- lgDocumentDate query string Дата выдачи документа, подтверждающего льготу +/- Формат: yyyy-MM-dd lgDocumentBase query string Тип документа, подтверждающего льготу +/-
Документ
Удостоверение
Иной документlgDateBegin query string Дата начала действия льготы +/- Формат: yyyy-MM-dd lgDateEnd query string Дата окончания действия льготы - Формат: yyyy-MM-dd Ответ сервера
где title – текст ошибки, status – код ошибки{
"title": "Неверно указаны параметры пациента",
"status": 400
}
Возможные ошибки
Описание ошибки 401 Не указан токен Системная ошибка выполнения запроса Error 401 Неверный формат токена Системная ошибка выполнения запроса Error 401 Указан неверный токен Системная ошибка выполнения запроса Error 400 Неверно указаны параметры пациента Неверно переданы параметры Snils, MkabGuid в теле запроса Error 400 Неверно указаны параметры записи о регистре Неверно передан RegisterGuid в теле запроса Error 400 Неверно указаны параметры льготы Error 400 Не найдена запись о пациенте в регистре По переданному идентификатору RegisterGuid пациент не найден в регистре Error 400 Пациент уже включен в регистр убрать (неактуально) Error 400 Не удалось найти пациента по указанным параметрам По переданному Snils, MkabGuid не найден пациент. Error 400 Указана некорректная категория льготы Переданная категория льготы не соответствует разрешенному списку категорий в НПА Error 500 Пациент уже имеет указанную льготу убрать (неактуально) Error 500 Не найдена запись о льготе пациента убрать (неактуально) Error 500 Не найдена мера соц. поддержки по льготе убрать (неактуально) Error 500 У пациента уже добавлена мера соц. поддержки по льготе с указанными данными убрать (неактуально) Error