THIS SPACE IS UNDER CONSTRUCTION

Used Documentation

General Information

MetaHub

The ‘MetaHub’ component is introduced to support the interconnection between ‘Hubs’. This component is accessible to ‘recognized’ hubs. The word ‘hub’ denotes the kernel of a ‘recognized’ regional or sub regional health network.

The main purpose of the MetaHub is to allow a hub to know where it can find information about a patient outside of its network. More precisely, the MetaHub simply provides the list of hubs that have information about a patient. It is not the MetaHub’s role to know where, within a (sub)regional health network, the information is stored.

The MetaHub is thus more a ‘locator service’ than a ‘routing component’: there are no ‘document’ exchanges transiting throughout the component. MetaHub v2 also allows the hubs to consult and manage the registration of patient consents and exclusions1. A major feature is that the hubs themselves feed the MetaHub. See figure below.


It is not the task of the MetaHub to store or to manage any data regarding ‘therapeutic links’ nor is it the purpose of the MetaHub to register or verify the therapeutic links.
However, for some types of therapeutic links for which an authentic source is defined and available, the MetaHub will offer a ‘relay’ service to the hubs to check the existence of such a therapeutic link.
Again, the interface of the services is more ‘generic’ (in order to be aligned with the specifications defined at the hub level and to potentially support other kinds of therapeutic links if required). For more information on
the methods to use, please refer to the WS TherapeuticLink cookbook. 


PutTherapeuticLink Allows a hub to declare the therapeutic links. Its main purpose is to allow one to declare a therapeutic link.
RevokeTherapeuticLinkAllows a hub to revoke the therapeutic links. Its main purpose is to allow one to “end” the (declaration of a) therapeutic link.
GetTherapeuticLinkAllows a hub 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.
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 MetaHub WS.

Basic Flow

FlowSpecifications

IDUC-611-BF
NameRevoke Therapeutic Link - Hub as author of the request - Referral - Support card number- Information concerned Health care professional
Description

Hub acts as author of the Revoke Therapeutic Link Request. The hub does the request for the Revoke therapeutic link (Referral therapeutic link). Certificate used to access the MetaHub WS is the eHealth Certificate of the Hub. Only following HC professional end-users are supported:

Physician, Nurse, Dentist, Midwife, Audician, Physiotherapist, Occupational therapist, Practical nurse, Dietician, Audiologist, Podologist, Truss maker, Logopedist, Orthopedist, Lab technologist, Imaging technologist

Actor(s)Health care professional through a Hub (Physician, Nurse, Dentist, Midwife, Audician, Physiotherapist, Occupational therapist, Practical nurse, Dietician, Audiologist, Podologist, Truss maker, Logopedist, Orthopedist, Lab technologist, Imaging technologist)
Requirements
  • End-user does the request through a Hub (Hub acts as author of the request)
  • End-user only following HC professionals: Physician, Nurse, Dentist, Midwife, Audician, Physiotherapist, Occupational therapist, Practical nurse, Dietician, Audiologist, Podologist, Truss maker, Logopedist, Orthopedist, Lab technologist, Imaging technologist
  • Valid eHealth certificate of the Hub
  • Identification Hub: Hub ID, Organization category, Hub name (optional)
  • Identification HC professional end-user: INSS, NIHII (if available), HC Professional category
  • Criteria relative to therapeutic link: 

     °Information concerned patient: patient INSS, support card number

     °Therapeutic Link type: referral

    °Period of validity: 3 months

  • Information related to concerned HC professional

     °SSIN number or NIHII (if available)

     °HC professional category

     °First and last name (optional)

TriggerThe user wants to revoke a Therapeutic Link
Precondition
  • The user has an account for the application
  • The user is logged out
Flow
  1. The user attempts to access to the eHealth MetaHub WS
  2. The user needs to request a SAML Token by using the eHealth Certificate of the Hub
  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 MetaHub
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the MetaHub WS
  8. The Therapeutic Link is revoked in the MetaHub  & All overlapped period of validity of the same relation are revoked
  9. The request is logged 
  10. The MetaHub WS responds with a Revoke Therapeutic Link Response
Post condition(s)
  • Request is logged
  • The therapeutic link is revoked in the MetaHub Database
  • All overlapped period of validity of the same relation are revoked
Test Data
End point(s)WS MetaHub Database

Exception Flow 1

FlowSpecifications

IDUC-611-EF01
NameRevoke Therapeutic Link - Hub as author of the request -Referral - Support card number- Information concerned Health care professional - HC party performing the revocation is excluded by the concerned patient
Description

Hub acts as author of the Revoke Therapeutic Link Request. The hub does the request for the Revoke therapeutic link (Referral therapeutic link). Certificate used to access the MetaHub WS is the eHealth Certificate of the Hub. HC party performing the revocation is excluded by the concerned patient. Authorized HC party as end-user. Support card number - Information concerned HC professional.

Actor(s)Authorized HC party as end-user
Requirements
  • End-user does the request through a Hub (Hub acts as author of the request)
  • Authorized HC party as end-user
  • Valid eHealth certificate of the Hub
  • Identification Hub: Hub ID, Organization category, Hub name (optional)
  • Identification HC party
  • Criteria relative to therapeutic link: 

     °Information concerned patient: patient INSS, support card number

     °Therapeutic Link type: referral

    °Period of validity: 3 months

  • Information related to concerned HC professional

     °SSIN number or NIHII (if available)

     °HC professional category

     °First and last name (optional)

  • HC party performing the revocation is excluded by 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 to the eHealth MetaHub WS
  2. The user needs to request a SAML Token by using the eHealth Certificate of the Hub
  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 MetaHub
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the MetaHub WS
  8. The MetaHub WS responds with a Revoke Therapeutic Link Response: error message  
Post Condition(s)

Error message

Test Data
End point(s)WS MetaHub Database

Exception Flow 2

FlowSpecifications

IDUC-611-EF02
NameRevoke Therapeutic Link - Hub as author of the request -Referral - Support card number- Information concerned Health care professional - Active therapeutic link does not exist between the HC party performing the revocation and the concerned patient
DescriptionHub acts as author of the Revoke Therapeutic Link Request. The hub does the request for the Revoke therapeutic link (Referral therapeutic link). Certificate used to access the MetaHub WS is the eHealth Certificate of the Hub. Active therapeutic link does not exist between the HC party performing the revocation and the concerned patientAuthorized HC party as end-user. Support card number - Information concerned HC professional.
Actor(s)Authorized HC party as end-user
Requirements
  • End-user does the request through a Hub (Hub acts as author of the request)
  • Authorized HC party as end-user
  • Valid eHealth certificate of the Hub
  • Identification Hub: Hub ID, Organization category, Hub name (optional)
  • Identification HC party
  • Criteria relative to therapeutic link: 

     °Information concerned patient: patient INSS, support card number

     °Therapeutic Link type: referral

    °Period of validity: 3 months

  • Information related to concerned HC professional

     °SSIN number or NIHII (if available)

     °HC professional category

     °First and last name (optional)

  • 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 to the eHealth MetaHub WS
  2. The user needs to request a SAML Token by using the eHealth Certificate of the Hub
  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 MetaHub
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the MetaHub WS
  8. The MetaHub WS responds with a Revoke Therapeutic Link Response: error message  
Post Condition(s)Error message
Test Data
End point(s)WS MetaHub Database

Exception Flow 3

FlowSpecifications

IDUC-611-EF03
NameRevoke Therapeutic Link - Hub as author of the request -Referral - Support card number- Information concerned Health care professional - No active therapeutic link of this type for the given HC party
DescriptionHub acts as author of the Revoke Therapeutic Link Request. The hub does the request for the Revoke therapeutic link (Referral therapeutic link). Certificate used to access the MetaHub WS is the eHealth Certificate of the Hub. No active therapeutic link of this type for the given HC partyAuthorized HC party as end-user. Support card number - Information concerned HC professional.
Actor(s)Authorized HC party as end-user
Requirements
  • End-user does the request through a Hub (Hub acts as author of the request)
  • Authorized HC party as end-user
  • Valid eHealth certificate of the Hub
  • Identification Hub: Hub ID, Organization category, Hub name (optional)
  • Identification HC party
  • Criteria relative to therapeutic link: 

     °Information concerned patient: patient INSS, support card number

     °Therapeutic Link type: referral

    °Period of validity: 3 months

  • Information related to concerned HC professional

     °SSIN number or NIHII (if available)

     °HC professional category

     °First and last name (optional)

  • 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 to the eHealth MetaHub WS
  2. The user needs to request a SAML Token by using the eHealth Certificate of the Hub
  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 MetaHub
  6. The user does a request for Revoke Therapeutic Link
  7. The Revoke Therapeutic Link Request is sent to the MetaHub WS
  8. The MetaHub WS responds with a Revoke Therapeutic Link Response: error message 
Post Condition(s)Error message
Test Data
End point(s)WS MetaHub Database
  • No labels