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.

Profile for laboratory panel (order-level) Observations in Bangladesh. Represents an ordered laboratory test panel (e.g. CBC, LFT, RFT) as the parent Observation in a hasMember hierarchy.

Usage:

• Observation.code is the panel/order code (from BD LOINC Lab Panels ValueSet)
• Observation.hasMember references individual result Observations (bd-lab-result-observation) for each component
• Observation.value[x] is prohibited — panels do not carry a direct result value
• Observation.category is fixed to 'laboratory'

FHIR hasMember pattern: DiagnosticReport.result –> bd-lab-panel-observation └── hasMember –> bd-lab-result-observation (x N)

Profile for laboratory DiagnosticReport in Bangladesh, aligned with IPS (International Patient Summary) DiagnosticReport pattern.

Usage:

• Represents a complete laboratory report for a patient encounter
• DiagnosticReport.result references panel-level Observations (bd-lab-panel-observation) or standalone result Observations (bd-lab-result-observation) where no panel grouping exists
• DiagnosticReport.code is fixed to LOINC 11502-2 (Laboratory report)
• specimen is SHOULD (MS, 0..*)

Report structure: bd-lab-report (DiagnosticReport) ├── result –> bd-lab-panel-observation │ └── hasMember –> bd-lab-result-observation (x N) └── result –> bd-lab-result-observation (standalone, no panel)

Profile for individual laboratory result (component-level) Observations in Bangladesh. Represents a single test result within a laboratory panel (e.g. Haemoglobin within a CBC panel).

Usage:

• Observation.code is the result/component code (from BD LOINC Lab Results ValueSet)
• Observation.value[x] is required — every leaf result must carry a value
• Observation.hasMember is prohibited — leaf results cannot group further
• Observation.derivedFrom references the parent panel Observation
• Observation.category is fixed to 'laboratory'

FHIR hasMember pattern: bd-lab-panel-observation └── hasMember –> bd-lab-result-observation (this profile)

Coded results (Ord/Nom scale): Use valueCodeableConcept with codes from BD LOINC Answer Lists ValueSet.

Base observation profile for Bangladesh. This is an abstract-style base profile from which all BD-Core observation profiles are derived. It is not intended to be used directly in clinical resources — use a derived profile instead.

Derived profiles (v0.4.0):

• bd-lab-panel-observation : Laboratory panel/order (hasMember pattern)
• bd-lab-result-observation : Laboratory leaf result (child of hasMember)

Planned derived profiles (future versions):

• bd-vital-signs-observation
• bd-exam-observation

Profile of Encounter Bangladesh Standard

Bangladesh Immunization Profile

Address for Bangladesh Standard

Profile of the Medication resource for the Bangladesh National Health Information Exchange (HIE). Drug products are coded using the DGDA Drug Registry maintained by the Drug Registration Authority of Bangladesh and served via the national OCL terminology server at https://tr.ocl.dghs.gov.bd.

Ingredient coding uses ICD-11 MMS substance codes (XM-prefix) to support International Patient Summary (IPS) generation and cross-border data exchange. Ingredient data is system-populated from OCL Has-active-ingredient mappings and is not required to be entered manually by clinicians.

Combination drugs are supported via the repeating ingredient element. Ingredients are derived from the DGDA drug concept in the national OCL terminology server through its Has-active-ingredient mappings to ICD-11 MMS substance codes (one mapping per ingredient). Newly registered drugs can take time to appear in the DGDA data, so the ingredient elements are Must Support: systems that hold ingredient data may populate them in the meantime.

Dose form is optional and should be coded using EDQM Standard Terms when populated. Dose form is derivable from the DGDA drug concept via OCL lookup, where DGDA dose forms are mapped to EDQM Standard Terms codes.

Profile of the MedicationRequest resource for the Bangladesh National Health Information Exchange (HIE). Prescriptions must reference a BDMedication resource coded against the DGDA Drug Registry, ensuring all prescribed medications are traceable to DGDA-registered drug products.

This profile constrains medication references to BDMedication only. Inline medicationCodeableConcept is not permitted — all medication data must be carried in a referenced BDMedication resource to support ingredient coding for IPS and cross-border data exchange.

Route of administration is coded using HL7 v3 RouteOfAdministration served via the national OCL terminology server.

Organization for Bangladesh Standard

Bangladesh Patient Profile

Practitioner for Bangladesh Standard

Profile for RelatedPerson in Bangladesh. Used to represent father, mother, or guardian of a patient.

• Identifier is mandatory and must use BD identifier systems (NID, BRN, UHID)
• Relationship is mandatory
• Name is mandatory

Address for Bangladesh Standard

Bangla translation of the patient name

Occupation

BD Division

English translation of the patient name

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

Blood group of the patient according to CCDS guideline

Nationality of the patient based on Bangladesh country list.

BD Upazilla

Only English and Bengali are allowed

Subset of EncounterClass limited to inpatient, ambulatory, and emergency.

Subset of EncounterStatus limited to planned, in-progress, finished, and cancelled.

Blood group value set according to CCDS guideline

Bangladesh City Corperation Codes (only two-digit codes)

Bangladesh Division Codes (only two-digit codes)

ICD-11 MMS concepts restricted to the Diagnosis (13,389) and Finding (5,119) concept classes, totalling 18,508 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 of explicit concept references covering 18,508 concepts (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, which is deployed.

VERSION UPGRADES: Upgrading to a new ICD-11 MMS release requires re-running populate_condition_valueset.py. Automated via version_upgrade.py.

Bangladesh Standard Identifier type

Allowed vaccine reactions for immunization in Bangladesh.

Allowed administration routes for vaccines in Bangladesh.

Allowed administration sites for vaccines in Bangladesh.

LOINC answer codes (LA-prefixed, property Answer) and answer lists (LL-prefixed, property AnswerList) for coded laboratory results. Used as Observation.valueCodeableConcept in bd-lab-result-observation for ordinal and nominal scale results.

This value set is the guide's broad definition. It is expressed with LOINC filters, so no codes are enumerated here. The curated national list is the value set loinc-answer-lists on the national terminology server, which enforces membership at runtime through $validate-code. Bindings to this value set are extensible.

LOINC laboratory panel (order) codes for Bangladesh: LOINC codes of the laboratory class (CLASSTYPE 1) that are orders (ORDER_OBS = Order) and of panel type (PanelType = Panel). Used as Observation.code in bd-lab-panel-observation.

This value set is the guide's broad definition. It is expressed with LOINC filters, so no codes are enumerated here. The curated national list is the value set loinc-lab-panels on the national terminology server, which enforces membership at runtime through $validate-code. Bindings to this value set are extensible.

LOINC laboratory result (observation) codes for Bangladesh: LOINC codes of the laboratory class (CLASSTYPE 1) that can be reported as observations (ORDER_OBS = Observation, or Both). Panel-only order codes are not included. Used as Observation.code in bd-lab-result-observation.

This value set is the guide's broad definition. It is expressed with LOINC filters, so no codes are enumerated here. The curated national list is the value set loinc-lab-results on the national terminology server, which enforces membership at runtime through $validate-code. Bindings to this value set are extensible.

Marital status value set according to CCDS guideline

Bangladesh Medication ValueSet

Bangladesh Municipalities Codes (only two-digit codes)

Occupations value set according to CCDS guideline

Religions value set according to CCDS guideline

Bangladesh Upazila Codes (only two-digit codes)

Allowed vaccines for immunization in Bangladesh.

Bangladesh district Codes (only two-digit codes)

Value set containing all registered drug products from the drug registry of the Directorate General of Drug Administration (DGDA) of Bangladesh, curated by DGHS. This value set includes 39,196 finished pharmaceutical drug product concepts maintained in the national OCL terminology server at https://tr.ocl.dghs.gov.bd.

This value set is the normative binding for BDMedication.code and represents the only permitted drug coding vocabulary for medication resources in the Bangladesh national health information exchange.

Validation is performed via $validate-code and $lookup against the national OCL terminology server. $expand is not supported for this value set due to its size.

Source collection: dgda-registered-drugs-valueset (MoHFW organisation, OCL) OCL collection canonical: https://fhir.dghs.gov.bd/core/ValueSet/dgda-registered-drugs Since v2.0.0 the canonical is in the DGHS namespace; the former v1.0.0 canonical https://dgda.gov.bd/fhir/ValueSet/registered-drugs was a logical identifier that did not resolve. OCL FHIR endpoint: https://tr.ocl.dghs.gov.bd/orgs/MoHFW/collections/dgda-registered-drugs-valueset/

Value set containing all ICD-11 MMS substance and medicament concepts (XM-prefix concept class: Substance) maintained in the national OCL terminology server at https://tr.ocl.dghs.gov.bd.

This value set contains 7,776 substance concepts and is used for coding active pharmaceutical ingredients in the BDMedication.ingredient element to support IPS generation and cross-border data exchange.

This value set is defined and maintained in OCL. It is declared here as a minimal stub to allow IG publisher binding resolution only.

OCL collection canonical: https://fhir.dghs.gov.bd/core/ValueSet/icd11-substances-valueset OCL FHIR endpoint: https://tr.ocl.dghs.gov.bd/orgs/MoHFW/collections/icd11-substances-valueset/

Value set containing pharmaceutical dose form concepts from the European Directorate for the Quality of Medicines (EDQM) Standard Terms, domain: Pharmaceutical Dose Forms (PDF).

This value set is used to code the physical form of a medication product in BDMedication.form. EDQM Standard Terms are maintained and versioned by the Council of Europe and are the WHO-recommended international standard for pharmaceutical dose form coding.

Concepts are loaded into the national OCL terminology server at https://tr.ocl.dghs.gov.bd under the MoHFW organisation as source EDQM-PDF.

Binding: preferred on BDMedication.form — systems should use EDQM codes when populating dose form, but omission is permitted. DGDA plain text dose forms are mapped to EDQM codes in the national terminology server.

Code system canonical: http://standardterms.edqm.eu OCL source: https://tr.ocl.dghs.gov.bd/#/orgs/MoHFW/sources/EDQM-PDF/

Nationality value set

Value set containing route of administration concepts from the HL7 Version 3 RouteOfAdministration code system.

This value set is used to code the route by which a medication is administered in MedicationRequest.dosageInstruction.route. HL7 v3 RouteOfAdministration is a license-free, internationally recognised vocabulary already embedded in the FHIR ecosystem.

Concepts are loaded into the national OCL terminology server at https://tr.ocl.dghs.gov.bd under the MoHFW organisation.

Code system canonical: http://terminology.hl7.org/CodeSystem/v3-RouteOfAdministration Binding: required on BDMedicationRequest.dosageInstruction.route

Blood group codes according to CCDS guideline

Bangladesh GeoCodes

Codes identifying the type of identifiers used in Bangladesh.

Codes for adverse reactions after vaccination in Bangladesh.

Codes for routes of vaccine administration in Bangladesh.

Codes for anatomical site of vaccine administration in Bangladesh.

Bangladesh Medication Codes

Medication dose form codes according to CCDS guideline

Occupations code system according to CCDS guideline

Vaccine codes used in Bangladesh EPI and immunization program.

Code system built on the drug registry of the Directorate General of Drug Administration (DGDA) of Bangladesh. The registration data is owned by DGDA; the concepts are curated, mapped to ICD-11 and maintained by DGHS in the national OCL terminology server at https://tr.ocl.dghs.gov.bd and are not enumerated within this Implementation Guide.

This code system contains two concept classes:

• Drug: Finished pharmaceutical drug products (identified by DAR number and trade name)
• Ingredient: Raw material / active pharmaceutical ingredients

Concept IDs follow the format: {DAR-number}–{trade-name-slug} Example: 353-0026-039–marvelous-fe

Canonical URL note: since version v2.0.0 the canonical URL is in the DGHS namespace. The former identifier https://dgda.gov.bd/drug-registry (v1.0.0) was a logical identifier only, did not resolve to a web endpoint and is not published by DGDA; it is kept as a legacy alias in the NamingSystem dgda-drug-registry-bd.

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 ($validate-code takes url=, $lookup takes system=):

• $validate-code: https://tr.ocl.dghs.gov.bd/api/fhir/CodeSystem/$validate-code?url=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 26,284 concepts in the following concept classes: Diagnosis (13,389), Finding (5,119) and Substance (7,776).

Declares the national drug registry code system and records its identifiers.

Registration data owner: Directorate General of Drug Administration (DGDA), Government of Bangladesh. Definition steward and terminology maintainer: DGHS (national OCL terminology server, https://tr.ocl.dghs.gov.bd).

Concept codes follow the format {DAR-number}–{trade-name-slug} (example: 353-0026-039–marvelous-fe).

Canonical system URI since v2.0.0: https://fhir.dghs.gov.bd/core/CodeSystem/dgda-drug-registry

The identifier https://dgda.gov.bd/drug-registry was used in v1.0.0. It was a logical identifier that DGDA does not publish or resolve. It is kept only so that data coded with the v1.0.0 identifier can be recognised; new data SHALL use the canonical system URI above.

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 ($validate-code takes url=, $lookup takes system=):

• $validate-code: https://tr.ocl.dghs.gov.bd/api/fhir/CodeSystem/$validate-code ?url=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 26,284 imported concepts (Diagnosis, Finding and Substance classes). 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.