Used Documentation
Cookbook | Version | Location |
---|---|---|
Therapeutic Link |
WS Cookbook | 1. |
6 | https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealth-therapeutic-links |
General Information
Therapeutic Links
Management of the Therapeutic Links:
- The eHealth consent WA will allow both patients (incl. patient's parents or mandataries) and authorized HC parties to manage the therapeutic links (declaration, revocation and consultation)
- The authorized HC parties, citizin (incl. concerned patients, parents of patients or patient's mandataries) are also able to perform the same operations throughout their usual software by calling the eHealth therapeutic link WS.
- The authorized HC organizations are only authorized to verify the existence of the therapeutic links before allowing the HC parties ti access the medical data of the patients by calling the therapeutic link consultation WS through their application.
The existence of a therapeutic relationship relation is one of the fundamental prerequisites for the healthcare (HC) providers to access a patient’s medical data. Therefore, the eHealth platform makes available to the actors
involved in the exchange, storage or referencing personal data, a relay service to manage those therapeutic relationships relations and associated means of evidence.
This relay service is obviously limited to kinds of therapeutic links made available at the eHealth platform level by the ‘owner’ of this therapeutic link (such as the HC party declaring a therapeutic link or the actor responsible
of a recognized specific database, e.g. for Global Medical File relationshiprelation). A therapeutic link is a relationship relation between a patient and a HC party for a certain type of therapeutic
relationship relation over a period of validity depending on the given evidence. It is not possible to update an existing the therapeutic link; to update information you first need to revoke the existing therapeutic link.
However, the period of validity of an active therapeutic link could be extended on the condition that
- The start date of the new period is greater or equal to the start date of the period to be extended
- The end date of the new period is greater than the end date of the period to be extended (overlap of period of validity)
The following operations (request-response operation type) will support the management of these links:
PutTherapeuticLink | Used to declare the therapeutic links. Its main purpose is to allow one to declare a therapeutic link. |
RevokeTherapeuticLink | Used to revoke the therapeutic links. Its main purpose is to allow one to “end” the (declaration of a) therapeutic link. |
GetTherapeuticLink | Used to consult therapeutic links according to basic search parameters. Its main purpose is to allow one to check the existence of the therapeutic links when executing a consultation process |
HasTherapeuticLink | Used to check the existence of a therapeutic link |
The therapeutic links are managed according to the rules corresponding to the type of therapeutic link through:
- Specific webservices (WS) by HC professionals as end-users through their usual software or through an authorized organization
- A dedicated web application (WA), currently called eHealth Consent with following end-users: Patients and HC professionals/ HC professionals within an organization
Declare/Put | Revoke | Consult (Get) | Has | |
---|---|---|---|---|
Citizen (patient, parent, mandatary) | Yes | Yes | Yes | Yes |
Authorized HC Parties (HC professionals) | Yes | Yes | Yes | Yes |
Authorized HC organizations | No | No | Yes | Yes |
KMEHR
This service is a ‘KMEHR-based’ WS. We thus strongly recommend consulting the documentation related to the KMEHR normative elements. The KMEHR site aims to offer a central point for the documentation of the KMEHR normative elements.
https://www.ehealth.fgov.be/standards/kmehr/en
The three following generic elements are, in particular, essentials to build the request and the reply of the therapeutic link WS.
- cd : This is the key element used to code information: this section is completely based on the description from the KMEHR standard, as can be found on: https://www.ehealth.fgov.be/standards/kmehr/en/page/key-elements#cd
- id: This element is used to uniquely identify key elements like request, response of the WS, patient, HCParty. It can also be used to specify any unique identifier: this section is completely based on the description from the KMEHR standard, as can be found on: https://www.ehealth.fgov.be/standards/kmehr/en/page/key-elements#id
- HC Party: The hcparty element is a generic element that aims to represent any kind of healthcare party: organization, physician, medical specialty, or even IT systems: this section is entirely based on the description from the KMEHR standard, as can be found on: https://www.ehealth.fgov.be/standards/kmehr/en/page/hcparty
Basic Flow
- HC professionalFlow | Specifications | |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Alternative Flow
Flow | Specifications | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Exception Flow 1
Flow | Specifications | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Exception Flow 2
Flow | Specifications | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Exception Flow 3
Flow | Specifications | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
° The request is logged
° The Therapeutic link is created in eHealth Database
- The request is logged
- The given therapeutic link, if found, is revoked in the database
- All overlapped period of validity of the same relation are revoked
- *Applied only when the author is a healthcare party, the concept of proof is not applied (not mandatory) when the author is citizen or the concerned patient is a new born (0<patient < 3 months). If the proof is provided then the SSIN support card number must be provided accordingly: case of the author is citizen then the provided card number is discarded (not submitted to compliant validation) else the provided card number must be valid and compliant.
- Start date: If provided then the start date must be equal to the start date of the active relation else the request is rejected (not found) else (not provided) then the revocation is applied on any active therapeutic relation corresponding to the input criteria i.e. patient, hc party, the therapeutic relation type
- End date: must be interpreted as 'revocation date' and not the end date of the relation. If active therapeutic relation is found, the revocation date (provided or not) is set to the date when the revocation request is processed (current date)
- Identification of patient by his SSIN number
- Identification of HC party:
° The HC professional is identified by the SSIN number, the NIHII number (if available) and the HC party category)
° The HC organization is identified by the NIHII nuumber and the HC party category
Identification of the therapeutic link by the identifier of the concerned patient, the identifier of the concerned HC party, the type and the period of the validity of the therapeutic link