THIS SPACE IS UNDER CONSTRUCTION

Used Documentation

CookbookVersionLocation
Therapeutic Link WS Cookbook1.6https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealth-therapeutic-links

General Information

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 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 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 relation). A therapeutic link is a relation between a patient and a HC party for a certain type of therapeutic
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:

PutTherapeuticLinkUsed to declare the therapeutic links. Its main purpose is to allow one to
declare a therapeutic link.
RevokeTherapeuticLinkUsed to revoke the therapeutic links. Its main purpose is to allow one to “end”
the (declaration of a) therapeutic link.
GetTherapeuticLinkUsed 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
HasTherapeuticLinkUsed 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/PutRevokeConsult (Get)Has
Citizen (patient, parent, mandatary)YesYesYesYes
Authorized HC Parties (HC professionals)YesYesYesYes
Authorized HC organizationsNoNoYesYes



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.

Basic Flow

FlowSpecifications

IDUC-249-BF
NameRevoke Therapeutic Link - HC Professional within a pharmacy – e-ID - Referral
Description

Revoke Therapeutic Link is a service used to revoke a therapeutic link between a patient and a HC party.

HC Professional within a pharmacy acts as author of the referral Therapeutic Link. The given proof is the e-ID reading with PIN code of the patient. Certificate used to access the WS Therapeutic Link is the eHealth Certificate of the pharmacy

Actor(s)
  • HC Professional within a pharmacy
Requirements
  • End-user is a HC professional within a pharmacy
  • End-user manages the therapeutic links throughout his usual software
  • Valid eHealth Certificate of the pharmacy
  • e-ID card of concerned patient 
  • HC professional that performs the operations (end-user) is different from the healthcare professional concerned by the therapeutic link
  • Identification HC professional

     °Identifier pharmacy: NIHII, HC party category

     °Identifier pharmacy holder: SSIN, NIHII (if available), HC party category

  • Information therapeutic link

     °Identification concerned patient: SSIN, support card number (optional), first and family name (optional)

     °Identification concerned HC party: NIHII (8digits), HC party category, name of the organization (optional)

  • Type of therapeutic link: referral
  • Inclusive start date: optional
  • Exclusive end date: optional
  • Comment to justify the declaration (optional)
  • Type of proof: e-ID reading with pincode
TriggerThe user wants to revoke a therapeutic link 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth WS Therapeutic Link
  2. The user needs to request a SAML Token by using it's personal eHealth Certificate
  3. A request for a SAML Token is sent to the Secure Token Service (STS)
  4. The STS responds with a SAML Token
  5. The user has access to the eHealth WS Therapeutic Link
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the WS Therapeutic Link
  8. The given therapeutic link, if found, is revoked in the eHealth Database & All overlapped period of validity of the same relation are revoked
  9. The request is logged
  10. The WS Consent responds with a Revoke Therapeutic Link Response
Post condition(s)
  • The given therapeutic link, if found, is revoked in the eHealth Database
  • All overlapped period of validity of the same relation are revoked
Test Data
End point(s)Therapeutic Links Database
Remarks
  • 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, hcparty, therapeutic relation type
  • End date: (must be interpreted as 'revocation date' and not the end date of the relation)
Additional Information
  • If the support card number is provided, then they must be valid and compliant
  • For the overlapped relations, the start date of the new period must be greater or equal to the start date of the period to extended and the end-date of the new period must be greater than the end-date of the period to be extended

Alternative Flow

FlowSpecifications

IDUC-249-AF
NameRevoke Therapeutic Link - HC Professional within a pharmacy (Pharmacist isn't pharmacy holder) – e-ID - Referral
Description

Revoke Therapeutic Link is a service used to revoke a therapeutic link between a patient and a HC party.

HC Professional within a pharmacy, who isn't the pharmacy holder, acts as author of the referral Therapeutic Link. The given proof is the e-ID reading with PIN code of the patient. Certificate used to access the WS Therapeutic Link is the eHealth Certificate of the pharmacy. 

Actor(s)
  • HC Professional within a pharmacy who isn't the pharmacy holder
Requirements
  • End-user is a HC professional within a pharmacy who isn't the pharmacy holder
  • End-user manages the therapeutic links throughout his usual software
  • Valid eHealth Certificate of the pharmacy
  • e-ID card of concerned patient 
  • HC professional that performs the operations (end-user) is different from the healthcare professional concerned by the therapeutic link
  • Identification HC professional

     °Identifier pharmacy: NIHII, HC party category

     °Identifier pharmacy holder: SSIN, NIHII (if available), HC party category

     °Identification end-user: SSIN, NIHII (if available), HC party category

  • Information therapeutic link

     °Identification concerned patient: SSIN, support card number (optional), first and family name (optional)

     °Identification concerned HC party: NIHII (8digits), HC party category, name of the organization (optional)

  • Type of therapeutic link: referral
  • Inclusive start date: optional
  • Exclusive end date: optional
  • Comment to justify the declaration (optional)
  • Type of proof: e-ID reading with pincode
TriggerThe user wants to revoke a therapeutic link 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth WS Therapeutic Link
  2. The user needs to request a SAML Token by using it's personal eHealth Certificate
  3. A request for a SAML Token is sent to the Secure Token Service (STS)
  4. The STS responds with a SAML Token
  5. The user has access to the eHealth WS Therapeutic Link
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the WS Therapeutic Link 
  8. The given therapeutic link, if found, is revoked in the eHealth Database & All overlapped period of validity of the same relation are revoked
  9. The request is logged
  10. The WS Consent responds with a Revoke Therapeutic Link Response
Post Condition(s)
  • The given therapeutic link, if found, is revoked in the eHealth Database
  • All overlapped period of validity of the same relation are revoked
Test Data
End point(s)Therapeutic Links Database
Remarks
  • 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, hcparty, therapeutic relation type
  • End date: (must be interpreted as 'revocation date' and not the end date of the relation)
Additional Information
  • If the support card number is provided, then they must be valid and compliant
  • For the overlapped relations, the start date of the new period must be greater or equal to the start date of the period to extended and the end-date of the new period must be greater than the end-date of the period to be extended

Exception Flow 1

FlowSpecifications

IDUC-249-EF01
NameRevoke Therapeutic Link - HC Professional within a pharmacy – e-ID - Referral - HC party performing the revocation is excluded by the concerned patient 
Description

Revoke Therapeutic Link is a service used to revoke a therapeutic link between a patient and a HC party.

HC Professional within a pharmacy acts as author of the referral Therapeutic Link. The given proof is the e-ID reading with PIN code of the patient. Certificate used to access the WS Therapeutic Link is the eHealth Certificate of the pharmacy. HC party performing the revocation is excluded by the concerned patient 

Actor(s)

HC Professional within a pharmacy (HC party performing the revocation is excluded by the concerned patient)

Requirements
  • End-user is a HC professional within a pharmacy (HC party performing the revocation is excluded by the concerned patient)
  • End-user manages the therapeutic links throughout his usual software
  • Valid eHealth Certificate of the pharmacy
  • e-ID card of concerned patient 
  • HC professional that performs the operations (end-user) is different from the healthcare professional concerned by the therapeutic link
  • Identification HC professional

     °Identifier pharmacy: NIHII, HC party category

     °Identifier pharmacy holder: SSIN, NIHII (if available), HC party category

  • Information therapeutic link

     °Identification concerned patient: SSIN, support card number (optional), first and family name (optional)

     °Identification concerned HC party: NIHII (8digits), HC party category, name of the organization (optional)

  • Type of therapeutic link: referral
  • Inclusive start date: optional
  • Exclusive end date: optional
  • Comment to justify the declaration (optional)
  • Type of proof: e-ID reading with pincode
TriggerThe user wants to revoke a therapeutic link 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth WS Therapeutic Link
  2. The user needs to request a SAML Token by using it's personal eHealth Certificate
  3. A request for a SAML Token is sent to the Secure Token Service (STS)
  4. The STS responds with a SAML Token
  5. The user has access to the eHealth WS Therapeutic Link
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the WS Therapeutic Link 
  8. The WS Consent responds with a Revoke Therapeutic Link Response: error message
Post Condition(s)Error message
Test Data
End point(s)Therapeutic Links Database

Exception Flow 2

FlowSpecifications

IDUC-249-EF02
NameRevoke Therapeutic Link - HC Professional within a pharmacy – e-ID - Referral - Active therapeutic link does not exist between the HC party performing the revocation and the concerned patient
Description

Revoke Therapeutic Link is a service used to revoke a therapeutic link between a patient and a HC party.

HC Professional within a pharmacy acts as author of the referral Therapeutic Link. The given proof is the e-ID reading with PIN code of the patient. Certificate used to access the WS Therapeutic Link is the eHealth Certificate of the pharmacy. Active therapeutic link does not exist between the HC party performing the revocation and the concerned patient

Actor(s)
  • HC Professional within a pharmacy
Requirements
  • End-user is a HC professional within a pharmacy
  • End-user manages the therapeutic links throughout his usual software
  • Valid eHealth Certificate of the pharmacy
  • e-ID card of concerned patient 
  • HC professional that performs the operations (end-user) is different from the healthcare professional concerned by the therapeutic link
  • Identification HC professional

     °Identifier pharmacy: NIHII, HC party category

     °Identifier pharmacy holder: SSIN, NIHII (if available), HC party category

  • Information therapeutic link

     °Identification concerned patient: SSIN, support card number (optional), first and family name (optional)

     °Identification concerned HC party: NIHII (8digits), HC party category, name of the organization (optional)

  • Type of therapeutic link: referral
  • Inclusive start date: optional
  • Exclusive end date: optional
  • Comment to justify the declaration (optional)
  • Type of proof: e-ID reading with pincode
  • Active therapeutic link does not exist between the HC party performing the revocation and the concerned patient
TriggerThe user wants to revoke a therapeutic link 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth WS Therapeutic Link
  2. The user needs to request a SAML Token by using it's personal eHealth Certificate
  3. A request for a SAML Token is sent to the Secure Token Service (STS)
  4. The STS responds with a SAML Token
  5. The user has access to the eHealth WS Therapeutic Link
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the WS Therapeutic Link 
  8. The WS Consent responds with a Revoke Therapeutic Link Response: error message
Post Condition(s)Error message
Test Data
End point(s)Therapeutic Links Database

Exception Flow 3

FlowSpecifications

IDUC-249-EF03
NameRevoke Therapeutic Link - HC Professional within a pharmacy – e-ID - Referral - No active therapeutic link of this type for the given HC party
Description

Revoke Therapeutic Link is a service used to revoke a therapeutic link between a patient and a HC party.

HC Professional within a pharmacy acts as author of the referral Therapeutic Link. The given proof is the e-ID reading with PIN code of the patient. Certificate used to access the WS Therapeutic Link is the eHealth Certificate of the pharmacy. No active therapeutic link of this type for the given HC party

Actor(s)
  • HC Professional within a pharmacy
Requirements
  • End-user is a HC professional within a pharmacy
  • End-user manages the therapeutic links throughout his usual software
  • Valid eHealth Certificate of the pharmacy
  • e-ID card of concerned patient 
  • HC professional that performs the operations (end-user) is different from the healthcare professional concerned by the therapeutic link
  • Identification HC professional

     °Identifier pharmacy: NIHII, HC party category

     °Identifier pharmacy holder: SSIN, NIHII (if available), HC party category

  • Information therapeutic link

     °Identification concerned patient: SSIN, support card number (optional), first and family name (optional)

     °Identification concerned HC party: NIHII (8digits), HC party category, name of the organization (optional)

  • Type of therapeutic link: referral
  • Inclusive start date: optional
  • Exclusive end date: optional
  • Comment to justify the declaration (optional)
  • Type of proof: e-ID reading with pincode
  • No active therapeutic link of this type for the given HC party
TriggerThe user wants to revoke a therapeutic link 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth WS Therapeutic Link
  2. The user needs to request a SAML Token by using it's personal eHealth Certificate
  3. A request for a SAML Token is sent to the Secure Token Service (STS)
  4. The STS responds with a SAML Token
  5. The user has access to the eHealth WS Therapeutic Link
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the WS Therapeutic Link 
  8. The WS Consent responds with a Revoke Therapeutic Link Response: error message
Post Condition(s)Error message
Test Data
End point(s)Therapeutic Links Database

Exception Flow 4

FlowSpecifications

IDUC-249-EF04
NameRevoke Therapeutic Link - HC Professional within a pharmacy – e-ID - Referral -Sender is not allowed to perform the revocation
Description

Revoke Therapeutic Link is a service used to revoke a therapeutic link between a patient and a HC party.

HC Professional within a pharmacy acts as author of the referral Therapeutic Link. The given proof is the e-ID reading with PIN code of the patient. Certificate used to access the WS Therapeutic Link is the eHealth Certificate of the pharmacy. The sender is not allowed to perform the revocation according to the predefined rules e.g. validation on the author (NIHII valid, SSIN valid,...?)

Actor(s)
  • HC Professional within a pharmacy
Requirements
  • End-user is a HC professional within a pharmacy
  • End-user manages the therapeutic links throughout his usual software
  • Valid eHealth Certificate of the pharmacy
  • e-ID card of concerned patient 
  • HC professional that performs the operations (end-user) is different from the healthcare professional concerned by the therapeutic link
  • Identification HC professional

     °Identifier pharmacy: NIHII, HC party category

     °Identifier pharmacy holder: SSIN, NIHII (if available), HC party category

  • Information therapeutic link

     °Identification concerned patient: SSIN, support card number (optional), first and family name (optional)

     °Identification concerned HC party: NIHII (8digits), HC party category, name of the organization (optional)

  • Type of therapeutic link: referral
  • Inclusive start date: optional
  • Exclusive end date: optional
  • Comment to justify the declaration (optional)
  • Type of proof: e-ID reading with pincode
  • The sender is not allowed to perform the revocation according to the predefined rules e.g. validation on the author (NIHII valid, SSIN valid,...?)
TriggerThe user wants to revoke a therapeutic link 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth WS Therapeutic Link
  2. The user needs to request a SAML Token by using it's personal eHealth Certificate
  3. A request for a SAML Token is sent to the Secure Token Service (STS)
  4. The STS responds with a SAML Token
  5. The user has access to the eHealth WS Therapeutic Link
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the WS Therapeutic Link 
  8. The WS Consent responds with a Revoke Therapeutic Link Response: error message
Post Condition(s)Error message
Test Data
End point(s)Therapeutic Links Database
  • No labels