API Documentation

Go back

KPI Calculators (1.0)

Download OpenAPI specification:Download

Niels Vermaut: niels.vermaut@teamntime.com License: Proprietary

The Calidos Teamntime KPI Calculator endpoints are responsible for the fast compute of the KPIs required for Team'n'Time 2

Describes the KPI Compute APIs for TeamnTime

Authentication

API Key

Security Scheme Type API Key
Query parameter name: API Key

operational

Fetch implementation details, not implemented yet

Returns some implementation details that allows developers to estimate how to use the API

Responses

Response samples

Content type
application/json
{
  • "timeout_in_seconds": 0,
  • "avg_processed_events_per_second": 0
}

kpis

Request Patient Nurse Ratio

This endpoint allows you to request the Patient Nurse Ratio KPI.

Request Body schema: application/json
object
object

Responses

Request samples

Content type
application/json
{
  • "parent_kpis": {
    },
  • "cached_parent_kpis": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Patient Care Ratio

This endpoint allows you to request the Patient Care Ratio KPI.

Request Body schema: application/json
object
object

Responses

Request samples

Content type
application/json
{
  • "parent_kpis": {
    },
  • "cached_parent_kpis": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Bed occupation

This endpoint allows you to request the Patient Care Ratio KPI.

Request Body schema: application/json
object
object

Responses

Request samples

Content type
application/json
{
  • "parent_kpis": {
    },
  • "cached_parent_kpis": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Absolute Care Weight

Request Body schema: application/json

Based off of CombinedKPIRequest

object or null
object
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "parent_kpis": {
    },
  • "cached_parent_kpis": {
    },
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Get Relative Care Weight KPI

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Get Historic Care Weight KPI

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Number of patients

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Number of admissions

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Number of discharges

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Number of absent patients

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Number of interventions

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Care Demand

This endpoint allows you to request the Care Demand KPI.

What will be returned here:

  • The Care Demand Sum (CareDemandSum) over 24 hours from the events being sent. Since Care Demand usually has equal ranges to eachother (like the range of a day part), the graphing information will only change when a new patient arrives on the department.
  • The Care Demand Remaining (CareDemandRemaining): The Care Demand - (the Care Demand * the percentage completed)
  • The Total Percentage Complete (TotalPercentageComplete): 1 - (Care Demand Remaining / Care Demand)
Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request Actual Staffing

This endpoint allows you to request the Actual Staffing KPI.

The number of staff that is actually working at the Department. It may be staff that was planned at the Unit, or staff that is transferred to the Department from another Department where it was planned. The KPI will not receive events that correlate with Adoptions, but will only return events that describe the planning of the requested Department. For the transfers, another KPI will be used.

What will be returned here

  • The Actual Staffing in FTE (ActualStaffingFTE): This means how many actual people were working at the department
  • The Actual Staffing in CTE (ActualStaffingCTE): CTE = Care Time Equivalent, which expresses how efficient a certain staff member is in a certain department.

The CTE will only be calculated for one Capability. This capability will be sent in the context by cte_requested_capability_id. e.g.

The Staff Member has 5 capability efficiencies, but only the one in the request will be used. If the Staff Member does not have the capaibility efficiency, nor is it set on its Staff Function, the cte_default_capability_efficiency in the context should be used.

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request number of planned staff

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request number of roaming staff

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request number of ideal staff

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request number of beds

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

Request number of support questions

Request Body schema: application/json
object (KPIRequest)
object (Context)

Context body

object (ImplementationConcerns)

Responses

Request samples

Content type
application/json
{
  • "request": {
    },
  • "context": {
    },
  • "implementation_concerns": {
    }
}

Response samples

Content type
application/json
{
  • "result": {
    },
  • "state": {
    }
}

external

Store KPI Result

Is implemented on common-backend, not to be implemented on the calculator.

path Parameters
id
required
string
query Parameters
is_for_cache
boolean
Request Body schema: application/json

Any request body sent as JSON will be cached.

object

Responses

Request samples

Content type
application/json
{ }