Uzbekistan State Health Insurance Fund Core
0.9.0 - ci-build Uzbekistan flag

Uzbekistan State Health Insurance Fund Core - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Program budget report

Daily snapshots of program budgets of the State Health Insurance Fund as FHIR MeasureReport: what each report carries, how amounts are split and when a group has no amount, and how the server answers.

Reports

There are two reports, both of type summary, with amounts in UZS:

One report covers one program, carried in the extension shif-program as a code of SHIFSubprogramVS. The profiles and measures are shared by all programs.

Snapshots

  • A snapshot is taken once a day at 00:20 Tashkent time (UTC+5). MeasureReport.date is the moment of the snapshot, MeasureReport.period is the fiscal year.
  • A snapshot for a date never changes. There are no snapshots for dates before the reports were started and no report "as of now".
  • A report by organization exists for every organization that has an own budget or at least one reservation in the program in the fiscal year. An organization that left the program gets reports until the end of the fiscal year.

Indicators

Each group is one state of the money (ProgramBudgetIndicatorCS):

  • available-shared: free balance of the shared pools of the ICD-10 chapters in the current month, the month of the snapshot date. Amounts released from reservations and carried over from earlier months are included; allocations of future months are not. Only in the summary report.
  • available-own-budget: free balance of the own budgets of healthcare organizations in the current month. Only own budgets the organization is currently admitted to reserve from count: an own budget the organization is not currently admitted to reserve from is left out.
  • reserved: reservations from the regular pools (shared and own budgets), cumulative over the fiscal year.
  • reserved-budget-override: reservations the Fund granted beyond the available balance under a budget override rule (BudgetOverrideReasonCS). A reservation stays here until it is settled or released, also when the Fund covers the deficit later.
  • claimed: claims submitted without a decision yet, in programs without reservations.
  • payable: settlements and claims accepted for payment by the systems of the Fund; rejected ones are not included.

Rules:

  • The states do not overlap and add up. No state includes another.
  • A report carries a group for every indicator of its measure. A group without an amount (measureScore) means the program or the organization does not have this state. Zero means the state exists and its amount is zero.
  • The preferential planned inpatient care program (IC01) has amounts in available-shared, available-own-budget, reserved, reserved-budget-override and payable. Its claimed has no amount: the money of a settlement in progress is still in the reservation.
  • In a report by organization, available-own-budget has an amount only for an organization with an own budget it is currently admitted to reserve from. Other organizations have the group without an amount, not a zero: the shared pool of a chapter is not divided among organizations.

Stratification

In the summary report every group except available-own-budget has one stratifier with two components: the ICD-10 chapter (ICD10ChapterCS) and the age group (age-group-financing-binary-vs).

  • Reservations, reservations beyond the balance and payable amounts belong to the ICD-10 chapter and the age group of the claim (the diagnosis and the age of the patient), whatever pool financed them.
  • The amounts of the strata of a group add up to the amount of the group. A group without an amount has no strata.
  • available-own-budget carries only the total: the money of own budgets has no ICD-10 chapter.

Reports by organization are not stratified.

The age groups come from the package uz.shif.terminology.age-group of the age group catalog of the reference data service of the Fund: the code system https://terminology.shif.uz/fhir/core/CodeSystem/age-group-cs and the value set https://terminology.shif.uz/fhir/core/ValueSet/age-group-financing-binary-vs. The ICD-10 chapters are defined by this guide.

Server

The server is described by the capability statement shif-program-budget-report-server. Reports live at [base]/MeasureReport, the base URL is set by the environment. The server supports read and search-type and answers only application/fhir+json.

Search parameters:

  • date: equality with one date only, without prefixes. Without date the snapshot of the current date is returned.
  • subject:identifier: the organization by its tax number, https://dhp.uz/fhir/core/sid/org/uz/soliq|<INN>.
  • measure: canonical URL of the measure.
  • program: code of the program (shif-measure-report-program).
  • _count: up to the upper limit of the server; further pages follow the next link.

Unknown parameters, range prefixes, _include and _sort are rejected with 400, not ignored. An empty search result is 200 with an empty Bundle. A conditional request with If-None-Match gets 304 when the report did not change. A snapshot of a past date is served with Cache-Control: immutable and an ETag.

Errors

Errors are returned as OperationOutcome.

Status issue.code When
400 invalid Invalid value of a parameter; issue.expression names the parameter
400 not-supported Unsupported parameter or prefix
401 security No valid token; sent with WWW-Authenticate
403 forbidden The token lacks the scope program-budget-report:read
404 not-found read of an unknown id, including a snapshot not built yet
406 not-supported A format other than JSON requested
429 throttled Too many requests; sent with Retry-After
500 exception Internal error
503 transient Temporarily unavailable

Authorization

OAuth 2.0 client credentials. Each request carries a bearer token with the scope program-budget-report:read.