Bangladesh Core FHIR Implementation Guide
0.3.0 - Published by DGHS, MoHFW
Bangladesh Core FHIR Implementation Guide - Published by Ministry of Health and Family Welfare. See the Directory of published versions
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
These define constraints on FHIR resources for systems conforming to this implementation guide.
| BD Core Condition Profile (ICD-11) |
Condition resource coded with ICD-11 MMS, restricted to Diagnosis and Finding class concepts. Defined in the Bangladesh Core FHIR Implementation Guide (BD-Core-FHIR-IG) published by DGHS/MoHFW. |
| Bangladesh Observation Profile |
Bangladesh Observation Profile |
| Encounter Profile for Bangladesh |
Profile of Encounter Bangladesh Standard |
| Immunization Profile for Bangladesh |
Bangladesh Immunization Profile |
| Location of Immunization for Bangladesh |
Address for Bangladesh Standard |
| Medication Profile for Bangladesh-V2 |
Profile of Medication Bangladesh Standard V2 |
| Medication Request Profile for Bangladesh-V2 |
Profile of MedicationRequest Bangladesh Standard V2 |
| Organization for Bangladesh |
Organization for Bangladesh Standard |
| Patient Profile for Bangladesh |
Banlgladesh Patient Profile |
| Practitioner for Bangladesh |
Practitioner for Bangladesh Standard |
These define constraints on FHIR data types for systems conforming to this implementation guide.
| Address for Bangladesh |
Address for Bangladesh Standard |
These define constraints on FHIR data types for systems conforming to this implementation guide.
| Bangladesh Occupations |
Occupation |
| Division |
BD Division |
| ICD-11 Cluster Expression |
Carries a postcoordinated ICD-11 cluster expression as a single string on a Coding element where the stem code alone is insufficient to fully represent the clinical concept. A cluster expression combines a stem code with one or more satellite codes using the & operator (combination) or / operator (specificity). Example: NC72.Z&XK8G&XJ7ZH&XJ7YM
Usage rules:
Cluster validator endpoint: POST https://icd11.dghs.gov.bd/cluster/validate Body: { "expression": "NC72.Z&XK8G&XJ7ZH&XJ7YM" } This extension is not MustSupport and is not mandatory. It is present only when postcoordination is clinically required. Cluster expressions are typically sourced from the WHO Electronic Coding Tool (ECT) at the point of care. |
| Language Extension |
Language |
| Patient Blood Group |
Blood group of the patient according to CCDS guideline |
| Patient Nationality |
Nationality of the patient based on Bangladesh country list. |
| Upazilla |
BD Upazilla |
These define sets of codes used by systems conforming to this implementation guide.
| Allowed Languages |
Only English and Bengali are allowed |
| BD Encounter Class Subset |
Subset of EncounterClass limited to inpatient, ambulatory, and emergency. |
| BD Encounter Status Subset |
Subset of EncounterStatus limited to planned, in-progress, finished, and cancelled. |
| Bangladesh Blood Group ValueSet |
Blood group value set according to CCDS guideline |
| Bangladesh City Corperation ValueSet |
Bangladesh City Corperation Codes (only two-digit codes) |
| Bangladesh Division ValueSet |
Bangladesh Division Codes (only two-digit codes) |
| Bangladesh ICD-11 MMS Condition ValueSet (Diagnosis and Finding) |
ICD-11 MMS concepts restricted to the Diagnosis (14,071) and Finding (5,590) concept classes, totalling 19,661 concepts as of version 2025-01. This ValueSet is the binding target for Condition.code in the BD-Core Condition profile. Substance, Organism, Device, Anatomy, and Misc class concepts are excluded and SHALL NOT appear as standalone stem codes in Condition.code. This restriction applies to stem codes only — satellite codes carried in the icd11-cluster-expression extension are exempt. This ValueSet is an empty stub. No compose block is declared because $expand is not supported by the national OCL terminology server and no machine-executable filter for concept_class is available at the IG layer. The compose would be nominal only and is omitted to avoid misrepresenting machine-executable semantics. The ValueSet is hosted in OCL as a collection with 19,661 explicit concept references (Diagnosis and Finding classes only). Runtime enforcement is via OCL ValueSet $validate-code: GET https://tr.ocl.dghs.gov.bd/api/fhir/ValueSet/$validate-code ?url=https://fhir.dghs.gov.bd/core/ValueSet/bd-condition-icd11-diagnosis-valueset &system=http://id.who.int/icd/release/11/mms &code={code} Confirmed behaviour:
At the HAPI FHIR layer, enforcement is via RemoteTerminologyServiceValidationSupport configured to call OCL. HAPI FHIR deployment is a known gap to be closed before vendor onboarding. VERSION UPGRADES: Upgrading to a new ICD-11 MMS release requires re-running populate_condition_valueset.py. Automated via version_upgrade.py. |
| Bangladesh Identifier Type |
Bangladesh Standard Identifier type |
| Bangladesh Immunization Reaction Value Set |
Allowed vaccine reactions for immunization in Bangladesh. |
| Bangladesh Immunization Route Value Set |
Allowed administration routes for vaccines in Bangladesh. |
| Bangladesh Immunization Site Value Set |
Allowed administration sites for vaccines in Bangladesh. |
| Bangladesh Medication Dose Form ValueSet |
Medication dose form value set according to CCDS guideline |
| Bangladesh Medication ValueSet |
Bangladesh Medication ValueSet |
| Bangladesh Municipalities ValueSet |
Bangladesh Municipalities Codes (only two-digit codes) |
| Bangladesh Occupations ValueSet |
Occupations value set according to CCDS guideline |
| Bangladesh Religions ValueSet |
Religions value set according to CCDS guideline |
| Bangladesh Upazila ValueSet |
Bangladesh Upazila Codes (only two-digit codes) |
| Bangladesh Vaccine Value Set |
Allowed vaccines for immunization in Bangladesh. |
| Bangladesh district ValueSet |
Bangladesh district Codes (only two-digit codes) |
| Nationality ValueSet |
Nationality value set |
These define new code systems used by systems conforming to this implementation guide.
| Bangladesh Blood Group CodeSystem |
Blood group codes according to CCDS guideline |
| Bangladesh GeoCodes CodeSystem |
Bangladesh GeoCodes |
| Bangladesh Identifier Types |
Codes identifying the type of identifiers used in Bangladesh. |
| Bangladesh Immunization Reaction Code System |
Codes for adverse reactions after vaccination in Bangladesh. |
| Bangladesh Immunization Route Code System |
Codes for routes of vaccine administration in Bangladesh. |
| Bangladesh Immunization Site Code System |
Codes for anatomical site of vaccine administration in Bangladesh. |
| Bangladesh Medication Codes |
Bangladesh Medication Codes |
| Bangladesh Medication Dose Form CodeSystem |
Medication dose form codes according to CCDS guideline |
| Bangladesh Occupations |
Occupations code system according to CCDS guideline |
| Bangladesh Religions | |
| Bangladesh Vaccine Code System |
Vaccine codes used in Bangladesh EPI and immunization program. |
| ICD-11 Mortality and Morbidity Statistics (MMS) |
WHO ICD-11 Mortality and Morbidity Statistics linearization. Canonical system URI: http://id.who.int/icd/release/11/mms This CodeSystem is declared as a stub (content = #not-present). The authoritative content is maintained by the World Health Organization. In Bangladesh, runtime code validation and lookup are delegated to the national OCL terminology server at https://tr.ocl.dghs.gov.bd. Supported operations (use
$expand is not supported — known OCL limitation. Expansion must not be attempted at build time or by IG Publisher. Preferred code form: short stem codes (e.g. 1A00, NC72.Z). Linearization URIs are not used as code identifiers in this IG. Version 2025-01 is imported into OCL with 36,941 concepts across the following concept classes: Diagnosis, Finding, Substance, Organism, Device, Anatomy, Misc. |
| Nationality List |
These define identifier and/or code system identities used by systems conforming to this implementation guide.
| ICD11MMSBangladesh |
Declares the ICD-11 Mortality and Morbidity Statistics (MMS) coding system as a known and supported terminology within the Bangladesh national health information infrastructure. Canonical system URI: http://id.who.int/icd/release/11/mms Canonical authority: World Health Organization (WHO) Preferred code form: short stem codes (e.g. 1A00, NC72.Z). Linearization URIs are not used as code identifiers in this IG. National terminology resolver (OCL): https://tr.ocl.dghs.gov.bd Supported OCL operations (use
$expand is not supported — known OCL limitation. Version 2025-01 is active in the national OCL instance with 36,941 imported concepts. The OCL resolver is an internal national service; vendors do not interact with it directly. All vendor submissions are validated at the HIE boundary via the Bangladesh ICD-11 Cluster Validator at https://icd11.dghs.gov.bd/cluster/validate. |