Verify Code Membership
Last updated
Last updated
This transaction allows a PoS, or any OHIE component, to access terminological information in the terminology service to verify that a code is a member of defined value set. A typical example would be to validate that the codes contained in an incoming patient data message are, in fact, from a required value set, e.g. the HIV ValueSet.
Both external systems and systems inside the HIE may perform this transaction directly with the TS. The sequence diagram below shows the steps that occur for a system using this transaction.
Membership: Is a Concept Code present in a specified Value Set, e.g., is Code '123XYZ' from ICD-10 a member of the HIV ValueSet?
The following is a description of the interaction steps.
#
Interaction
Data
Transaction Options
1
Code verification request
The validate-code request is triggered by a PoS or other HIE component.
Input: A Concept Code, associated Code System and target ValueSet.
FHIR ValueSet Resource, $validate-code operation
2
Code verification response
The response is sent back to the requesting system.
Output: a True or False response.
FHIR ValueSet Resource, $validate-code operation
Workflow Maturity
Mature
One or more OpenHIE implementations of this workflow exist in one or more countries
Workflow is defined and ARB approved
Workflow is supported by mature standards
Standards
The FHIR ValueSet validate-code operation: http://build.fhir.org/valueset-operation-validate-code.html. HL7 FHIR Specifications v3.0 or higher support validate-code. The response is a Boolean (true or false) based on whether the code is a member of the specified ValueSet.
This workflow implements the IHE IT Infrastructure Technical Framework Supplement - Sharing Valuesets, Codes, and Maps (SVCM) Transaction: Validate Code ITI-Y5 for Value Sets.
Assumptions and Prerequisites
The required ValueSets and associated CodeSystems have been preloaded into the Terminology Service.
Actors
PoS - The point-of-service system or other HIE component that is requesting to verify a code.
TS - Stores the curated, official version of the Value Set for the health system.