Bangladesh Core FHIR Implementation Guide
0.3.0 - Published by DGHS, MoHFW Bangladesh flag

Bangladesh Core FHIR Implementation Guide - Published by Ministry of Health and Family Welfare. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Structures: Resource Profiles

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

Structures: Data Type Profiles

These define constraints on FHIR data types for systems conforming to this implementation guide.

Address for Bangladesh

Address for Bangladesh Standard

Structures: Extension Definitions

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

  • NC72.Z — stem: Fracture of femur, unspecified
  • XK8G — satellite: laterality
  • XJ7ZH — satellite: fracture subtype
  • XJ7YM — satellite: fracture open or closed

Usage rules:

  • SHALL only be present when the expression contains at least one satellite code joined by & or / operators.
  • Single stem codes SHALL be represented in Coding.code only and validated via OCL $validate-code. The cluster validator at https://icd11.dghs.gov.bd/cluster/validate explicitly rejects stem-only expressions.
  • The stem code in Coding.code SHALL match the leading stem code in this expression string.
  • Satellite codes in the cluster expression are exempt from the Diagnosis/Finding class restriction that applies to stem codes in Condition.code.
  • Cluster expressions SHALL be validated against the Bangladesh ICD-11 Cluster Validator at https://icd11.dghs.gov.bd/cluster/validate prior to submission to the HIE.

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

Terminology: Value Sets

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:

  • Diagnosis class (e.g. 1A00): accepted
  • Finding class: accepted
  • Device class (e.g. XD7EB1): rejected
  • Substance class (e.g. XM6RB2): rejected

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

Terminology: Code Systems

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 system= parameter, not url=):

  • $validate-code: https://tr.ocl.dghs.gov.bd/api/fhir/CodeSystem/$validate-code?system=http://id.who.int/icd/release/11/mms&code={code}
  • $lookup: https://tr.ocl.dghs.gov.bd/api/fhir/CodeSystem/$lookup?system=http://id.who.int/icd/release/11/mms&code={code}

$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

Terminology: Naming Systems

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 system= parameter, not url=):

  • $validate-code: https://tr.ocl.dghs.gov.bd/api/fhir/CodeSystem/$validate-code ?system=http://id.who.int/icd/release/11/mms&code={code}
  • $lookup: https://tr.ocl.dghs.gov.bd/api/fhir/CodeSystem/$lookup ?system=http://id.who.int/icd/release/11/mms&code={code}

$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.