Uzbekistan State Health Insurance Fund Core
0.9.0 - ci-build Uzbekistan флаг

Uzbekistan State Health Insurance Fund Core - Локальная сборка (v0.9.0), построенная FHIR (HL7® FHIR®) стандартным инструментам сборки. Смотрите каталог опубликованных версий

Program budget report

На этой странице представлены переводы с языка оригинала, на котором былонаписано руководство. Информацию об этих переводах и инструкции попредоставлению отзывов о переводах можно найти здесь.

Ежедневные срезы бюджетов программ Фонда государственного медицинского страхования в виде FHIR MeasureReport: что несёт каждый отчёт, как делятся суммы и когда у группы нет суммы, как отвечает сервер.

Отчёты

Отчётов два, оба типа summary, суммы в UZS:

Один отчёт — одна программа, она передаётся в расширении shif-program кодом из SHIFSubprogramVS. Профили и меры общие для всех программ.

Срезы

  • Срез делается раз в сутки в 00:20 по Ташкенту (UTC+5). MeasureReport.date — момент среза, MeasureReport.period — финансовый год.
  • Срез за дату не меняется. Срезов за даты до запуска отчётов нет, отчёта "на текущий момент" нет.
  • Отчёт по организации строится для каждой организации, у которой в финансовом году есть собственный бюджет или хотя бы одна бронь по программе. Организация, выбывшая из программы, получает отчёты до конца финансового года.

Показатели

Каждая группа — одно состояние денег (ProgramBudgetIndicatorCS):

  • available-shared: свободный остаток общих пулов классов МКБ-10 в текущем месяце, месяце даты среза. Освобождённое от броней и перенесённое с прошлых месяцев входит, выделения будущих месяцев не входят. Только в сводном отчёте.
  • available-own-budget: свободный остаток собственных бюджетов медицинских организаций в текущем месяце. Учитываются только собственные бюджеты, из которых организация сейчас допущена бронировать; остальные не входят.
  • reserved: брони из обычных пулов (общих и собственных бюджетов), накопленно за финансовый год.
  • reserved-budget-override: брони, выданные Фондом сверх доступного остатка по правилу перерасхода (BudgetOverrideReasonCS). Бронь остаётся здесь, пока не погашена актом или не снята, даже если Фонд позже покрыл дефицит.
  • claimed: поданные требования без решения, в программах без брони.
  • payable: акты и требования, принятые к оплате системами Фонда; отклонённые не входят.

Правила:

  • Состояния не пересекаются и складываются. Ни одно состояние не включает другое.
  • Отчёт несёт группу на каждый показатель своей меры. Группа без суммы (measureScore) означает, что у программы или организации нет этого состояния. Ноль означает, что состояние есть и сумма нулевая.
  • У программы льготной плановой стационарной помощи (IC01) суммы есть в available-shared, available-own-budget, reserved, reserved-budget-override и payable. У claimed суммы нет: деньги акта в пути ещё в брони.
  • В отчёте по организации available-own-budget имеет сумму только у организации с собственным бюджетом, из которого она сейчас допущена бронировать. У остальных организаций эта группа без суммы, а не ноль: общий пул класса между организациями не делится.

Стратификация

В сводном отчёте у каждой группы, кроме available-own-budget, один стратификатор с двумя компонентами: класс МКБ-10 (ICD10ChapterCS) и возрастная группа (age-group-financing-binary-vs).

  • Брони, брони сверх остатка и суммы к выплате относятся к классу МКБ-10 и возрастной группе заявки (диагноз и возраст пациента), из какого бы пула они ни были профинансированы.
  • Суммы страт группы складываются в сумму группы. У группы без суммы страт нет.
  • available-own-budget несёт только итог: у денег собственных бюджетов нет класса МКБ-10.

Отчёты по организациям не стратифицируются.

Возрастные группы берутся из пакета uz.shif.terminology.age-group каталога возрастных групп справочной службы Фонда: кодовая система https://terminology.shif.uz/fhir/core/CodeSystem/age-group-cs и набор значений https://terminology.shif.uz/fhir/core/ValueSet/age-group-financing-binary-vs. Классы МКБ-10 определены этим руководством.

Сервер

Сервер описан CapabilityStatement shif-program-budget-report-server. Отчёты лежат по адресу [base]/MeasureReport, базовый адрес задаётся окружением. Сервер поддерживает read и search-type и отвечает только в application/fhir+json.

Параметры поиска:

  • date: равенство одной дате, без префиксов. Без date возвращается срез текущей даты.
  • subject:identifier: организация по ИНН, https://dhp.uz/fhir/core/sid/org/uz/soliq|<ИНН>.
  • measure: канонический адрес меры.
  • program: код программы (shif-measure-report-program).
  • _count: до верхней границы сервера; следующие страницы — по ссылке next.

Неизвестные параметры, префиксы диапазона, _include и _sort отклоняются с 400, а не игнорируются. Пустой результат поиска — 200 с пустым Bundle. Условный запрос с If-None-Match получает 304, если отчёт не менялся. Срез прошедшей даты отдаётся с Cache-Control: immutable и ETag.

Ошибки

Ошибки возвращаются в виде OperationOutcome.

Статус issue.code Когда
400 invalid Недопустимое значение параметра; issue.expression указывает параметр
400 not-supported Неподдерживаемый параметр или префикс
401 security Нет действительного токена; вместе с WWW-Authenticate
403 forbidden У токена нет scope program-budget-report:read
404 not-found read по неизвестному id, в том числе ещё не построенный срез
406 not-supported Запрошен формат, отличный от JSON
429 throttled Слишком много запросов; вместе с Retry-After
500 exception Внутренняя ошибка
503 transient Временно недоступен

Авторизация

OAuth 2.0 client credentials. Каждый запрос несёт bearer-токен со scope program-budget-report:read.