SCOPE API
Модуль реализует пять обязательных методов взаимодействия ИС СМО ↔ СИСЗЛ.
| # | Метод | Направление | Назначение |
|---|---|---|---|
| 1 | GET /api/smo/v3/plan-tasks |
СМО ← ГИС | Задачи на план мероприятий (ДН / ДОГВН) |
| 2 | GET /api/smo/v3/inform-tasks |
СМО ← ГИС | Список задач на информирование + история |
| 3 | GET /api/smo/v3/inform-tasks/{id} |
СМО ← ГИС | Одна задача на информирование |
| 4 | POST /api/smo/v3/inform-tasks/{id}/result |
СМО → ГИС | Единичный результат информирования |
| 5 | POST /api/smo/v3/inform-tasks/results |
СМО → ГИС | Пакет результатов (≤ 25) |
Путь метода №4. В методических материалах ФОМС встречаются варианты
result и results. В поставке по умолчанию используется
result (основной текст спецификации). При необходимости путь
настраивается в конфигурации после подтверждения ФОМС.
Пагинация
size— от 1 до 1000, по умолчанию 50plan-tasks— нумерация страниц с 1inform-tasks— нумерация страниц с 0
Модуль умеет автоматически обходить все страницы списка с учётом разной базы нумерации.
Фильтры plan-tasks
| Параметр | Описание |
|---|---|
eventType | Обязателен. ДН или ДОГВН (по умолчанию ДОГВН) |
startDate / endDate | Период; по умолчанию — текущий год. Максимум 365 дней |
page / size | Пагинация |
Фильтры inform-tasks
| Параметр | Описание |
|---|---|
getInformResult | Обязателен: без результатов / последний / все |
startPeriodDate / endPeriodDate | По сроку выполнения задачи (ведущий период) |
startCreatedDate / endCreatedDate | По дате создания; учитывается по правилам Таблицы 8 спецификации |
enp | Опциональный фильтр по ЕНП |
episodeType | ДН / диспансеризация; без значения — оба типа |
page / size | Пагинация |
Фильтрации по статусу задачи в API нет: подсистема возвращает список задач, требующих обработки СМО.
Пакетная отправка результатов
- Не более 25 результатов в одном запросе
- Лимит считается по результатам, а не по уникальным задачам
- В одной партии допускается несколько результатов по одной задаче
- Для пакетного метода в каждой записи обязателен
taskId - Пакет обрабатывается атомарно: при ошибке хотя бы одной записи ничего из набора не сохраняется в ГИС ОМС
Ограничение частоты (HTTP 429)
При превышении допустимого числа запросов сервер отвечает
429 Too Many Requests / TOO_MANY_REQUESTS.
Модуль выполняет ограниченный повтор запроса. Полноценный token-bucket
на стороне клиента не требуется со стороны интегратора.