SAVE THE DATE - #OHIE19 Nov 4-8, 2019 in Addis Ababa, Ethiopia - CLICK HERE

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.



Description: This transaction allows a PoS, or any OHIE component, to access terminological information in the terminology service and retrieve the translation, or "mapping" of a Concept in one Code System to a Concept in another Code System. Mapping is frequently required when patient data is collected using Concepts/Codes from one Code System but the data must be reported or aggregated, say for decision support, in a different Code System. The set of such associated Concepts, usually for a specific use-case, are stored in the Terminology Service in a FHIR Resource called a ConceptMap.


  1. Mapping: Using the ConceptMap 'ICD-10 to SNOMED CT Diseases', retrieve the SNOMED CT Concept Code(s) that is associated with '123XYZ' in ICD-10.

Sponsor:  Jack Bowie (in collaboration with the Terminology Services Community)

Status:  This operation has been extensively tested in FHIR Connectathons. 


  • The FHIR ConceptMap translate operation: HL7 FHIR Specifications v3.0 or higher support translate. The response is a set of FHIR Parameter objects that include a 'result' (whether there is an acceptable match) and a list of possible matches. The list of matches may include notes of Codes for which mappings are specifically excluded, and qualifications on the applicability of matches..

Assumptions and Prerequisites