THIS SPACE IS UNDER CONSTRUCTION

Used Documentation

Cookbook / Materials

Version

Location

Consent WS1.9https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealthconsent

General Information

Informed Consent 

The existence of an active ‘informed patient consent’ is one of the fundamental prerequisites for the healthcare providers to access patient’s medical data. Therefore, the eHealth platform makes available to the concerned patients and the health care actors involved in the exchange,

storage or referencing personal data a service to manage the ‘informed patient consent’ as defined by the deliberation 12/047 of the CSSSS/SCSZG1.

Technically, we identify the following attributes for an ‘informed patient consent’:

  • The SSIN of the patient.
  • The date of the consent registration (at the end-user side).
  • The “type” of the consent If the consent is only valuable for data posterior to the signing date, it is called ‘prospective’ and ‘retrospective’ in the other case . According to the rules defined now, the only possible value for this attribute is ‘retrospective’. The attribute is present for backwards compatibility.
  • The identity of the HCParty acting in the patient’s name (if applicable).


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 eHealth Consent 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 

    FlowSpecifications

    IDUC-128-BF
    NameRevoke Patient Consent - Pharmacy holder
    DescriptionRevoke Patient consent allows end-users to revoke an active consent of the concerned patient. Request Revoke consent is done by a pharmacy holder.
    Actor(s)Pharmacy holder
    Requirements
    • End-user is a pharmacy holder
    • Informed patient consent is managed in a recognized pharmacy throughout its usual software
    • Valid eHeatlh Certificate of the pharmacy
    • Consent WS is integrated in the software of the end-user
    • Identification pharmacy: NIHII, organization category
    • Identification pharmacy holder: SSIN number, NIHII (if available), professional category
    • Information about the consent to revoke

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

         °Type of consent: retrospective

         °Date of revocation

    TriggerThe user wants to revoke a Patient Consent 
    Precondition(s)
    • The user has an account for the application
    • The user is logged out
    Flow
    1. The user attempts to access the eHealth Consent WS
    2. The user needs to request a SAML Token by using his eID 
    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 Consent
    6. The user does a request for Revoke Patient Consent 
    7. The Revoke Patient Consent Request is sent to the WS Consent
    8. The revoked consent is stored in eHealth Database
    9. The request is logged 
    10. The WS Consent responds with a Revoke Patient Consent Response
    Post Condition(s)
    • The request is logged 
    • The revoked consent is stored in eHealth Database with following information

             °SSIN of concerned patient 

             °Initial signing date of the consent

             °Consent type

             °Author of the request

             °Revocation date

    Test Data
    End point(s)
    • WS Consent
    • eHealth Database
    RemarksIf concerned patient is a new-born (0 < patient < 3 months) the support card number is not mandatory
    Additional InformationDate of revocation of an active consent must be equal or anterior to the request date. If so, it must be also anterior to the current date. 

Alternative Flow

FlowSpecifications

IDUC-128-AF01
NameRevoke Patient Consent - Pharmacist isn't the pharmacy holder
DescriptionRevoke Patient consent allows end-users to revoke an active consent of the concerned patient. Request Revoke consent is done by a pharmacist who isn't the pharmacy holder.
Actor(s)Pharmacist isn't the pharmacy holder
Requirements
  • End-user is a pharmacist who isn't the pharmacy holder
  • Informed patient consent is managed in a recognized pharmacy throughout its usual software
  • Valid eHeatlh Certificate of the pharmacy
  • Consent WS is integrated in the software of the end-user
  • Identification pharmacy: NIHII, organization category
  • Identification pharmacy holder: SSIN number, NIHII (if available), professional category
  • Identification pharmacist: SSIN number, NIHII (if available), professional category
  • Information about the consent to revoke

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

     °Type of consent: retrospective

     °Date of revocation

TriggerThe user wants to revoke a Patient Consent 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth Consent WS
  2. The user needs to request a SAML Token by using his eID 
  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 Consent
  6. The user does a request for Revoke Patient Consent 
  7. The Revoke Patient Consent Request is sent to the WS Consent
  8. The revoked consent is stored in eHealth Database
  9. The request is logged 
  10. The WS Consent responds with a Revoke Patient Consent Response
Post Condition(s)
  • The request is logged 
  • The revoked consent is stored in eHealth Database with following information

         °SSIN of concerned patient 

         °Initial signing date of the consent

         °Consent type

         °Author of the request

         °Revocation date

Test Data
End point(s)
  • WS Consent
  • eHealth Database
RemarksIf concerned patient is a new-born (0 < patient < 3 months) the support card number is not mandatory
Additional InformationDate of revocation of an active consent must be equal or anterior to the request date. If so, it must be also anterior to the current date. 

Exception Flow 1

FlowSpecifications

IDUC-128-EF01
NameRevoke Patient Consent - Pharmacy holder - Deceased patient
DescriptionRevoke Patient consent allows end-users to revoke an active consent of the concerned patient. Request Revoke consent is done by a pharmacy holderDeceased patient
Actor(s)Pharmacy holder
Requirements
  • End-user is a pharmacy holder
  • Informed patient consent is managed in a recognized pharmacy throughout its usual software
  • Valid eHeatlh Certificate of the pharmacy
  • Consent WS is integrated in the software of the end-user
  • Identification pharmacy: NIHII, organization category
  • Identification pharmacy holder: SSIN number, NIHII (if available), professional category
  • Information about the consent to revoke

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

     °Type of consent: retrospective

     °Date of revocation

  • Concerned patient is deceased
TriggerThe user wants to revoke a Patient Consent 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth Consent WS
  2. The user needs to request a SAML Token by using a 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 Consent
  6. The user does a request for Revoke Patient Consent 
  7. The Revoke Patient Consent Request is sent to the WS Consent 
  8. The WS Consent responds with a Revoke Patient Consent Response: error message
Post Condition(s)Error message
Test Data
End point(s)
  • WS Consent
  • eHealth Database

Exception Flow 2

FlowSpecifications

IDUC-128-EF02
NameRevoke Patient Consent - Pharmacy holder - The consent of the concerned patient is already revoked
DescriptionRevoke Patient consent allows end-users to revoke an active consent of the concerned patient. Request Revoke consent is done by a pharmacy holderThe consent of the concerned patient is already revoked
Actor(s)Pharmacy holder
Requirements
  • End-user is a pharmacy holder
  • Informed patient consent is managed in a recognized pharmacy throughout its usual software
  • Valid eHeatlh Certificate of the pharmacy
  • Consent WS is integrated in the software of the end-user
  • Identification pharmacy: NIHII, organization category
  • Identification pharmacy holder: SSIN number, NIHII (if available), professional category
  • Information about the consent to revoke

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

     °Type of consent: retrospective

     °Date of revocation

  • The consent of the concerned patient is already revoked
TriggerThe user wants to revoke a Patient Consent 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth Consent WS
  2. The user needs to request a SAML Token by using a 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 Consent
  6. The user does a request for Revoke Patient Consent 
  7. The Revoke Patient Consent Request is sent to the WS Consent 
  8. The WS Consent responds with a Revoke Patient Consent Response: error message
Post Condition(s)Error message
Test Data
End point(s)
  • WS Consent
  • eHealth Database

Exception Flow 3

FlowSpecifications

IDUC-128-EF03
NameRevoke Patient Consent - Pharmacy holder - The consent of the concerned patient does not exist
DescriptionRevoke Patient consent allows end-users to revoke an active consent of the concerned patient. Request Revoke consent is done by a pharmacy holderThe consent of the concerned patient does not exist
Actor(s)Pharmacy holder
Requirements
  • End-user is a pharmacy holder
  • Informed patient consent is managed in a recognized pharmacy throughout its usual software
  • Valid eHeatlh Certificate of the pharmacy
  • Consent WS is integrated in the software of the end-user
  • Identification pharmacy: NIHII, organization category
  • Identification pharmacy holder: SSIN number, NIHII (if available), professional category
  • Information about the consent to revoke

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

     °Type of consent: retrospective

     °Date of revocation

  • The consent of the concerned patient does not exist
TriggerThe user wants to revoke a Patient Consent 
Precondition(s)
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access the eHealth Consent WS
  2. The user needs to request a SAML Token by using a 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 Consent
  6. The user does a request for Revoke Patient Consent 
  7. The Revoke Patient Consent Request is sent to the WS Consent 
  8. The WS Consent responds with a Revoke Patient Consent Response: error message
Post Condition(s)Error message
Test Data
End point(s)
  • WS Consent
  • eHealth Database
  • No labels