# Translate Code

 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.

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.

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.

| Workflow Maturity             | <p><img src="https://lh5.googleusercontent.com/Vp6XBRGu-U_Dmd5EKNpCZvEEum0CxOcHOj9NgHh8UMMNLMlXHmLcUE_YWueDRr4uqWLzpPfzSBLJ2k33XQIelLypjQ4wyrD17-t33GtLa8fFxW9AYDvXhiJmBl4VaLgKDg" alt=""></p><p>   <strong>Mature</strong></p> | <p></p><ul><li><strong>One or more OpenHIE implementations of this workflow exist  in one or more countries</strong></li><li><strong>Workflow is defined and ARB approved</strong></li><li><strong>Workflow is supported by mature standards</strong></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Standards\*                   |                                                                                                                                                                                                                                 | <p>The FHIR ConceptMap translate operation: <a href="http://build.fhir.org/conceptmap-operation-translate.html"><http://build.fhir.org/conceptmap-operation-translate.html></a>. 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.</p><p>This workflow implements the IHE IT Infrastructure Technical Framework Supplement - Sharing Valuesets, Codes, and Maps (SVCM) Transaction: Translate Code ITI-Y7.</p> |
| Assumptions and Prerequisites |                                                                                                                                                                                                                                 | The required ConceptMap and associated CodeSystem(s) have been preloaded into the Terminology Service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Actors                        |                                                                                                                                                                                                                                 | <p></p><ul><li>PoS - The point-of-service system  or other HIE component that is requesting the translation.  </li><li>TS - Stores the curated, official version of the ConceptMap for the health system.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## **Interaction Description**

The following is a description of the interaction steps.&#x20;

![](https://lh3.googleusercontent.com/EthDly9fk9f2CNixr1QkJS3-iufEkWRZmH_4K0p0yYETwD4OukltPQ0-gxiblSB-Oz-jsJvEAcAfljVxWhQUmShBpwDnKwsi_sEoAEbFn64xobObbBf2jU9C5moGvxvjZA)

| # | Interaction                   | Data                                                                                                                                                                       | Transaction Options                            |
| - | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| 1 | ConceptMap translate request  | <p>The translate request is triggered by a PoS or other HIE component.</p><p>Input: The ConceptMap name and source Code and CodeSystem.</p>                                | FHIR ConceptMap Resource, $translate operation |
| 2 | ConceptMap translate response | <p>The response is sent back to the requesting system.</p><p>Output: a set of parameters including a Boolean 'result, and a list of, possibly qualified, Code matches.</p> | FHIR ConceptMap Resource, $translate operation |

##


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.ohie.org/arch-spec/main-1/introduction/terminology-service-workflow/translate-code.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.