description:The AGB of the institution, if the customer is a care group or other institute, otherwise omitted. One of practiceAgb or institutionAgb is always present.
description:The AGB of the institution, if the customer is a care group or other institute, otherwise omitted. One of practiceAgb or institutionAgb is always present.
$ref:../schemas/agb.yaml
$ref:../schemas/agb.yaml
gpisMethod:
gpisMethod:
description:The current EPD type and how medical dossiers are transferred to Zorg op Orde.
description:The current GPIS type and how medical dossiers are transferred to Zorg op Orde.
summary:Download one CSV table from an available export
summary:Download one CSV table from an available export
parameters:
parameters:
- name:agb
- name:agb
@ -27,7 +27,7 @@ get:
responses:
responses:
'200':
'200':
description:|-
description:|-
Fetches the requested table from the EPD export.
Fetches the requested table from the GPIS export.
Note that the response will have the content type of the request resource (usually `text/csv`) even if the requester's `Accept` header does not indicate this mime type is supported.
Note that the response will have the content type of the request resource (usually `text/csv`) even if the requester's `Accept` header does not indicate this mime type is supported.
A comma separated list of patUnid values, as provided by other API endpoints.
A comma separated list of patUnid values, as provided by other API endpoints.
For each patUnid the contact details are in the response. If sending lots of patUnids, we suggest you call this API in a POST (which is also allowed, though the semantic intent of this method is GET:It only queries and makes no changes) to avoid HTTP limits on query length.
For each patUnid the contact details are in the response. If sending lots of patUnids, we suggest you call this API in a POST (which is also allowed, though the semantic intent of this method is GET:It only queries and makes no changes) to avoid HTTP limits on query length.
@ -18,27 +18,9 @@ get:
example:"1234,5678"
example:"1234,5678"
- name:fields
- name:fields
in:query
in:query
required:true
mandatory:true
schema:
type:array
items:
type:string
enum:
- bsn
- patPubId
- patUnid
- gender
- displayName
- fullName
- addressLine
- postcode
- city
- tel
- email
- dob
explode:false
description:|-
description:|-
Comma separated list of data fields that should be returned in the response. Available options are:
Comma separated list of data fields that shold be returned in the response. Available options are:
which will be logged and reviewed for the _Principle of Least Privilege_ policy.
which will be logged and reviewed for the _Principle of Least Privilege_ policy.
Known design parameters:
Known design parameters:
- send along the date on which the result is based (EPD snapshot date)
- send along the date on which the result is based (GPIS snapshot date)
- Sender must send a key (or list of keys) representing the context, such as 'DM', 'Obesitas', 'Dietetiek', etc. We combine the targeted data (the GP or zorggroep) with these keys to know precisely what we filter (we do not just return all medical dossier data).
- Sender must send a key (or list of keys) representing the context, such as 'DM', 'Obesitas', 'Dietetiek', etc. We combine the targeted data (the GP or zorggroep) with these keys to know precisely what we filter (we do not just return all medical dossier data).
- uptime is important; these API calls are done live as patients show.
- uptime is important; these API calls are done live as patients show.
- q - edit it a bit, can be for example 'dm' or even 'dm/dietetiek'. Send all relevant parts in one response.
- q - edit it a bit, can be for example 'dm' or even 'dm/dietetiek'. Send all relevant parts in one response.
description:Summaries the performance of employees expressed in feat count and turnover amounts. Only contract and national tariffs are used. Tariffs imported from any EPD are ignored. Contract tariffs as registered by Zorg op Orde or, if not present, national tariffs as published by the government are used. Only to most recent years of national tariffs are available.
description:Summaries the performance of employees expressed in feat count and turnover amounts. Only contract and national tariffs are used. Tariffs imported from any GPIS are ignored. Contract tariffs as registered by Zorg op Orde or, if not present, national tariffs as published by the government are used. Only to most recent years of national tariffs are available.
Restricts to the GP's which were medical responsible for the feat. Uses the GP at the time of the feat, or if not available, the GP responsible for the patient at the time of the EPD import. The GP at the time of the feat is the most accurate.
Restricts to the GP's which were medical responsible for the feat. Uses the GP at the time of the feat, or if not available, the GP responsible for the patient at the time of the GPIS-import. The GP at the time of the feat is the most accurate.
The responsible GP is not written in the response, due the structure of the agreggation.
The responsible GP is not written in the response, due the structure of the agreggation.
patient EPD ids. One of `bsns` or `patIds` must be provided (but not both).
patient GPIS ids. One of `bsns` or `patIds` must be provided (but not both).
required:
required:
- careprogram
- careprogram
- callUpStatus
- callUpStatus
@ -65,7 +65,7 @@ post:
responses:
responses:
'200':
'200':
description:|-
description:|-
BSNs or patIds whose status has actually updated. BSNs or patIds which were not known in the EPD are ignored and not returned here.
BSNs or patIds whose status has actually updated. BSNs or patIds which were not known in the GPIS are ignored and not returned here.
The caller should determine the difference between the two sets to get the ignored patients. If a BSN matched more than one patient, all these patients were updated.
The caller should determine the difference between the two sets to get the ignored patients. If a BSN matched more than one patient, all these patients were updated.
The effect of this policy is to modify the 'callup state' for that patient/indicator combination. For example, the amputee would receive a `-` state for 'foot inspection' (indicating: Foot inspection is not relevant for this patient) instead of a `0` (indicating:Foot inspection must be done this quarter). Naturally, any policy that expires _before_ the `refDate` of a callup list you're asking for doesn't apply.</dd>
The effect of this policy is to modify the 'callup state' for that patient/indicator combination. For example, the amputee would receive a `-` state for 'foot inspection' (indicating: Foot inspection is not relevant for this patient) instead of a `0` (indicating:Foot inspection must be done this quarter). Naturally, any policy that expires _before_ the `refDate` of a callup list you're asking for doesn't apply.</dd>
<dt><code>PatientSnoozed</code></dt>
<dt><code>PatientSnoozed</code></dt>
<dd>A policy that applies to a specific patient for a certain care program type (e.g. `COPD`), and indicates that providing chronic care at the GP level is not possible for a limited time. For longer 'snoozing' the advice is generally to set the EPD based registration of chronic care participation (i.e. the value 'COKZ' (COPD chronic care participation) to 'No'), but when the situation is temporary and a medical operator knows when the situation ends, this policy can be used instead, which has the advantage of restoring the patient to chronic care reporting automatically when the policy is expires. `expiry` is mandatory for this type of policy.
<dd>A policy that applies to a specific patient for a certain care program type (e.g. `COPD`), and indicates that providing chronic care at the GP level is not possible for a limited time. For longer 'snoozing' the advice is generally to set the GPIS based registration of chronic care participation (i.e. the value 'COKZ' (COPD chronic care participation) to 'No'), but when the situation is temporary and a medical operator knows when the situation ends, this policy can be used instead, which has the advantage of restoring the patient to chronic care reporting automatically when the policy is expires. `expiry` is mandatory for this type of policy.
The effect of this policy is to default the patient's call up plan (the `chosenStatus` is `byPolicy`) to `doNotCallup` until the policy expires.</dd>
The effect of this policy is to default the patient's call up plan (the `chosenStatus` is `byPolicy`) to `doNotCallup` until the policy expires.</dd>
The source of the medical data used to produce this report:which general practitioner information system was used, and when the data was provided. Omitted if no EPD database was imported (yet).
The source of the medical data used to produce this report:which general practitioner information system was used, and when the data was provided. Omitted if no GPIS database was imported (yet).
If true, the indicator was retrieved from the API cache. The indicator is only retrieved from the cache if there is no recent calculation available in the database and if the indicator won't change anymore. This is the case when it was calculated with a reference date in the past and for which a certain period no new EPD data is provided. The cached indicator reflects the indicator definition on the reference date. A cached indicator is not updated when the definition changes.
If true, the indicator was retrieved from the API cache. The indicator is only retrieved from the cache if there is no recent calculation available in the database and if the indicator won't change anymore. This is the case when it was calculated with a reference date in the past and for which a certain period no new GPIS-data is provided. The cached indicator reflects the indicator definition on the reference date. A cached indicator is not updated when the definition changes.
description:If true, the indicator set was retrieved from the API cache. The set is only retrieved from the cache if there is no recent calculation available in the database and if the set won't change anymore. This is the case for all indicator sets which were calculated with a reference date in the past and for which a certain period no new EPD data is provided. The cached indicator set reflects the indicator definitions of the reference date. Cached indicators are not updated with new definitions.
description:If true, the indicator set was retrieved from the API cache. The set is only retrieved from the cache if there is no recent calculation available in the database and if the set won't change anymore. This is the case for all indicator sets which were calculated with a reference date in the past and for which a certain period no new GPIS-data is provided. The cached indicator set reflects the indicator definitions of the reference date. Cached indicators are not updated with new definitions.
Details about specifically the left eye. Only present if a left eye retinopathy measurement is available.
Details about specifically the left eye.
type:object
type:object
required:
required:
- lastEval
- lastEval
@ -143,8 +147,16 @@ properties:
description:Same as previous level, specifically for left eye.
description:Same as previous level, specifically for left eye.
type:integer
type:integer
format:int32
format:int32
minimum:0
minimum:-1
maximum:3
maximum:3
note:
description:|-
If present, describes why this measurement is missing, unclear, or suboptimal.
For example, might mention that the result from the lab is likely available, but has not
been properly registered in the medical dossier, or that a result is available but only after
the provided `refDate`. In dutch, and human readable.
type:string
nhgCode:
nhgCode:
description:|-
description:|-
If present, the NHG memocode used to register the retinopathy level. Will be in the terms dictionary.
If present, the NHG memocode used to register the retinopathy level. Will be in the terms dictionary.
@ -169,8 +181,10 @@ properties:
retinoVal:
retinoVal:
type:integer
type:integer
format:int32
format:int32
minimum:0
minimum:-1
maximum:3
maximum:3
note:
type:string
nhgCode:
nhgCode:
type:string
type:string
nhgResult:
nhgResult:
@ -178,10 +192,7 @@ properties:
format:int32
format:int32
followup:
followup:
type:object
type:object
description:Contains information about advice given to patient about scheduling future fundus inspections (aka fundus followup). Only present if a followup decision is registered.
description:Contains information about advice given to patient about scheduling future fundus inspections (aka fundus followup).
required:
- nhgResult
- timestamp
properties:
properties:
nhgResult:
nhgResult:
description:|-
description:|-
@ -216,11 +227,3 @@ properties:
advice, is provided (e.g. if on April 5th the followup advice is 'within one month', this value will be 'May 5th').
advice, is provided (e.g. if on April 5th the followup advice is 'within one month', this value will be 'May 5th').
Will be the sentinel value 'Jan 1st, 9999' if no followup advice is needed.
Will be the sentinel value 'Jan 1st, 9999' if no followup advice is needed.
note:
description:|-
If present, describes why this measurement is missing, unclear, or suboptimal.
For example, might mention that the result from the lab is likely available, but has not
been properly registered in the medical dossier, or that a result is available but only after
the provided `refDate`. In dutch, and human readable.
As well as a 'config' view where they see _all_ care programs that could possibly be relevant for that customer, where the customer can preview the report (essentially, run the report as normal), favourite something they don't get by default, or unfavourite something they get by default.
As well as a 'config' view where they see _all_ care programs that could possibly be relevant for that customer, where the customer can preview the report (essentially, run the report as normal), favourite something they don't get by default, or unfavourite something they get by default.
- name:Customer management
- name:Customer management
- name:GPIS exports
description:|-
description:|-
Update and query properties of ZOO customers (such as who is the contact person and which care programs they participate in).
List and download exported parts of GPIS dossiers.
- name:EPD exports
description:|-
List and download exported parts of EPD (General Practioner Information Systems) dossiers.
paths:
paths:
/patient/dossier:
/patient/dossier:
$ref:'paths/patient_dossier.yaml'
$ref:'paths/patient_dossier.yaml'
@ -164,7 +162,7 @@ components:
GpCodes:
GpCodes:
name:gpCodes
name:gpCodes
in:query
in:query
description:Code of the GP as known in the EPD.
description:Code of the GP as known in the GPIS.
example:AA,BZP,RZ,ECH
example:AA,BZP,RZ,ECH
schema:
schema:
type:array
type:array
@ -240,6 +238,7 @@ components:
description:Indicated practice is known but has not authorized ZOO to share this information with signer.
description:Indicated practice is known but has not authorized ZOO to share this information with signer.