FHIR in Vietnam: a timeline from 2010 to today
Fifteen years of Vietnamese health data standardization fall into four distinct phases: HL7 v2 pilots in private hospitals (2010-2017), the formal BHXH XML chain (Decisions 4210 → 130 → 4750 → 3176, from 2017 to today), the first draft of the VN Core IG R4 (2024-2025), and the dense regulatory wave of 2025 that opens the way to a community-driven phase from 2026 onward.
This page serves general readers who need historical context, hospital CIOs preparing an integration roadmap, regulators researching legacy systems, and researchers who need accurate data points. Every milestone links back to a legal document or a public reference inside the HL7 Vietnam Legal Framework.
TL;DR
- 2010-2017: Vinmec, FV, and a handful of private hospitals piloted HL7 v2 for HIS-LIS integrations, with no national IG.
- 2017-2024: Decision 4210/QĐ-BYT launched the BHXH XML chain, refined through Decision 130/2023, Decision 4750/2023, and Decision 3176/2024.
- 2024: The
hl7vn/vn-core-igrepository, published by the Department of Information Technology under the Ministry of Health, released the first draft VN Core IG R4 with 65 StructureDefinitions. - 2025: More than twenty pivotal documents (Circular 13/2025, Resolution 202/2025, Law 91/2025, plus SNOMED/TVM/LOINC decisions) reshape the legal floor.
- 2026: An OmiGroup initiative launches
hl7.org.vn, laying the groundwork for an HL7 Vietnam Affiliate and a community-driven VN Core IG.
On this page
- The four phases at a glance
- 2010-2017 — HL7 v2 pilots in private hospitals
- 2017-2024 — The BHXH XML chain takes over
- 2024 — The first draft VN Core IG
- 2025 — The big-bang regulatory year
- 2026 — The community-driven phase
- 2027+ — The forward roadmap
- Ten milestones worth remembering
- Frequently asked questions
- Read next
1. The four phases at a glance
The history of FHIR and HL7 in Vietnam is not linear. The real timeline is an interleaving of private-sector engineering effort and administrative decisions issued by the Ministry of Health and Vietnam Social Security (BHXH). The four phases below give readers a fast way to orient themselves:
| Phase | Years | Defining trait |
|---|---|---|
| 1. HL7 v2 pilots | 2010-2017 | Private hospitals lead; vendor-specific integrations. |
| 2. The BHXH XML chain | 2017-2024 | A mandatory MOH/BHXH format; Decision 4210 → 130 → 4750 → 3176. |
| 3. Draft VN Core IG | 2024-2025 | The MOH IT Department publishes the first FHIR R4 IG. |
| 4. Regulation + community | 2026+ | Regulation forces adoption; the community drives an open IG. |
The four phases do not have crisp boundaries. The 4210 XML format is still in production while the VN Core IG is being authored. Hospitals continue to run HL7 v2 internally even as they migrate selected data flows to FHIR. What matters is the direction of travel and the documents that act as hinges between phases.
2. 2010-2017 — HL7 v2 pilots in private hospitals
The first chapter of HL7 in Vietnam unfolded quietly inside the private sector. Around 2010, Vinmec launched its first HIS with an HL7 v2 integration module supplied by a foreign vendor. FV Hospital (Franco-Vietnamese) in Ho Chi Minh City stood up an HL7 v2 LIS-HIS bridge in 2012. From around 2015, Hoan My extended this pattern across its hospital chain, forming the earliest cluster of HL7 v2 practice in Vietnam.
The public sector lagged behind, with only a handful of pilot projects. Bach Mai Hospital piloted HL7 v2 across its LIS-HIS cluster at limited scale in 2016. The eHealth Vietnam 2013 conference was one of the first forums to address HL7 head-on. Even so, no national Implementation Guide existed, no Vietnamese terminology was standardized, and every vendor interpreted HL7 v2 differently. Cross-system integration costs were therefore steep and were typically buried inside turnkey deployment contracts.
Four traits define this phase: private hospitals led because they had flexible IT budgets; public hospitals lacked both resources and incentives; vendor lock-in became a major technical barrier; and neither the Ministry of Health nor BHXH had a unified HL7 policy. FHIR did not even exist yet in Vietnam's official vocabulary, since the international DSTU1 was only released on 30/9/2014, and R4 (4.0.1) was not published by HL7 International until 30/10/2019.
Historical note: Several "first in Vietnam" claims from this period lack publicly available primary sources. This article draws on vendor blogs and internal communications; direct interviews with Vinmec, FV, and Hoan My are required to nail down the precise timeline.
3. 2017-2024 — The BHXH XML chain takes over
2017 was the administrative pivot. Decision 4210/QĐ-BYT (Ministry of Health) established the standard XML format that healthcare facilities use to transmit data to Vietnam Social Security (BHXH). Crucially, Decision 4210 is not an HL7 standard: it is an XML format defined by the MOH itself, modeled closely on the traditional billing-summary structure. Even so, this was the first time the country had a mandatory health-data standard, and every HIS vendor had to support it.
Decision 4210 was then revised continuously. Decision 130/QĐ-BYT (2023) replaced and broadened its scope; Decision 4750/QĐ-BYT, issued the same year, made further adjustments; and on 29 October 2024, Decision 3176/QĐ-BYT became the prevailing version, refreshing the MALYDO, KETQUA, TINHTRANGRA, MA_LOAI_RV, and gender CodeSystems. These four decisions form a continuous regulatory chain for the BHXH XML format, which the Vietnamese FHIR community typically refers to as the "4210 chain."
| Year | Event |
|---|---|
| 2017 | Decision 4210/QĐ-BYT — the standard BHXH XML format (later inherited). |
| 2018 | Circular 46/2018/TT-BYT on electronic medical records (later superseded by Circular 13/2025). |
| 2018 | Decision 6556/2018 — the BHYT inpatient/outpatient billing summary template (later superseded by Decision 697/2026). |
| 2020 | Decision 4469/QĐ-BYT (28/10) — the Vietnamese edition of ICD-10. |
| 2020 | Decision 4440/2020 — the ICD-9-CM classification (later superseded by Decision 387/2026). |
| 2021 | Decree 98/2021 on medical device management. |
| 2022 | Decision 98/QĐ-BYT (14/01) — adds COVID codes U07.1 and U07.2 to ICD-10 VN. |
| 2023 | Law on Medical Examination and Treatment 2023; Decree 13/2023 on personal data protection (later superseded). |
| 2023 | Decision 130/QĐ-BYT and Decision 4750/QĐ-BYT — adjustments to the BHXH XML chain. |
| 2024 | Circular 06/2024 on healthcare-facility ranking; Circular 23/2024 on the current technical-services catalog. |
| 2024 | Decision 3176/QĐ-BYT (29/10) — the prevailing version of the BHXH XML format. |
Across these eight years, Vietnamese health data flowed primarily through the MOH-defined XML format, alongside HL7 v2 inside individual hospitals. ICD-10 Vietnam was officially formalized in 2020, COVID codes were added in 2022, and the 2023 Law on Medical Examination and Treatment laid the foundation for the next legislative wave. HL7 and FHIR still had no binding national mandate, even as the practitioner community began to discuss them in earnest.
4. 2024 — The first draft VN Core IG
2024 marked Vietnam's first National Core FHIR IG. The repository github.com/hl7vn/vn-core-ig was attributed to the Department of Information Technology (under the Ministry of Health at the time of publication), with canonical URL http://fhir.ehealth.gov.vn/core/ and the package hl7.fhir.vn.core#1.0.0 on FHIR R4 (4.0.1). The listed authors are Tran Tung and Nguyen Hai Phong; in total, 9 commits since inception, with the last update in July 2024.
A local audit of the repository showed 65 StructureDefinition XML files — covering both profiles and extensions — across the Patient, Practitioner, Encounter, ServiceRequest, Specimen, Location, HealthcareDepartment, and CodeableConcept domains. That is a substantive count for a new IG, even if Must Support coverage, search parameters, and examples are still thin. A CI build was published at build.fhir.org/ig/hl7vn/vn-core-ig/, while the fhir.chiaseyhoc.vn community mirrored the content and fhir.ironx.io.vn kept a directory of versions.
The limitation of this phase was adoption. There was no Vietnamese Connectathon, no public sandbox, no major vendor with an official implementation, and no legal document referencing the IG. VN Core 1.0.0 therefore sat as an important technical reference, but never crossed into being an enforced standard. Many hospitals did not even know the IG existed until the 2025 regulatory wave forced them to investigate FHIR.
5. 2025 — The big-bang regulatory year
2025 was the "big-bang regulation year" for digital health in Vietnam. More than twenty pivotal documents were issued in just twelve months, reshaping the legal floor across identity, personal data, electronic medical records, and clinical terminology. The Vietnamese FHIR community had to face a hard fact: the 2024 draft VN Core IG could not keep pace with the speed of change.
| Date | Document and content |
|---|---|
| 04/2025 | Decision 1227/QĐ-BYT (11/4) — 2,964 laboratory indicators, batch 1, mapped to LOINC. |
| 04/2025 | Resolution 60-NQ/TW (12/4) — government streamlining, the basis for Resolution 202/2025. |
| 05/2025 | Decree 102/2025/NĐ-CP (13/5) — digital health-data management (effective 01/7/2025). |
| 06/2025 | Resolution 202/2025/QH15 (12/6) — administrative reorganization down to 34 provinces and centrally governed cities. |
| 06/2025 | Circular 13/2025/TT-BYT (06/6) — electronic medical records (effective 21/7/2025). |
| 06/2025 | Law 91/2025/QH15 (26/6) — personal data protection (effective 01/01/2026). |
| 06/2025 | Decree 164/2025/NĐ-CP (29/6) — electronic transactions in social insurance (BHXH). |
| 06/2025 | Law on Local Government Organization 2025 (16/6) — the two-tier model. |
| 06/2025 | Decision 19/2025/QĐ-TTg (25/6) — the official codes for the 34-province administrative geography. |
| 07/2025 | Decree 188/2025/NĐ-CP (issued 01/7; effective 15/8/2025) — guidance on the Health Insurance Law. |
| 07/2025 | Decision 2427/QĐ-BYT (25/7) — SNOMED CT VN batch 1 (Body Structure). |
| 2025 | Decision 2493/QĐ-BYT — SNOMED CT VN batch 2 (Morphologic Abnormality); the exact date is being verified into the corpus. |
| 08/2025 | Decision 2552/QĐ-BYT (12/8) — traditional Vietnamese medicine (TVM/YHCT) terminology, batch 1. |
| 09/2025 | Decision 2805/QĐ-BYT (04/9) — SNOMED CT VN batch 3 (Allergy + Finding). |
| 09/2025 | Decision 3080/QĐ-BYT (26/9) — TVM/YHCT terminology, batch 2. |
| 10/2025 | Decision 3276/QĐ-BYT (17/10) — the catalog of patient-population codes for medical visits. |
| 10/2025 | Decree 278/2025/NĐ-CP (22/10) — mandatory data connection and sharing. |
| 12/2025 | Law 134/2025/QH15 (10/12) — the AI Law (effective 01/3/2026). |
| 12/2025 | Law 114/2025/QH15 (10/12) — the Disease Prevention Law (effective 01/7/2026). |
| 12/2025 | Law 116/2025/QH15 (10/12) — the amended Cybersecurity Law (effective 01/7/2026). |
| 12/2025 | Decree 356/2025/NĐ-CP (31/12) — guidance on the Personal Data Protection Law (effective 01/01/2026). |
The principal driver of 2025 is the pairing of Circular 13/2025 with Law 91/2025: electronic medical records must connect to the national ID number (CCCD) and to VNeID (Vietnam's national digital identification app), and all health data is classified as sensitive data requiring the highest level of protection. Resolution 202/2025 and the 2025 Law on Local Government Organization rewire the administrative geography, forcing the administrative-division CodeSystem and the FHIR Address structure to be redesigned. The SNOMED CT batches 1 to 3 and the TVM/YHCT batches 1 to 2 give Vietnamese clinical terminology a shared standard for the first time.
6. 2026 — The community-driven phase
In January 2026, Law 91/2025 and Decree 356/2025 entered into force, marking the start of the implementation phase. The Ministry of Health issued Consolidated Documents 04, 06, and 08/2026/VBHN-BYT to merge the rules on medical-device calibration, commune health stations, and medical-device management into single sources of truth. In early February 2026, Decision 387/QĐ-BYT (05/02) issued the 2026 edition of the international classification of surgical procedures (ICD-9-CM), replacing Decision 4440/2020.
| Date | Event |
|---|---|
| 01/2026 | Law 91/2025 and Decree 356/2025 take effect; three Consolidated Documents 04/06/08/2026/VBHN-BYT. |
| 02/2026 | Decision 387/QĐ-BYT (05/02) — ICD-9-CM 2026, replacing Decision 4440/2020. |
| 02/2026 | Circular 12/2026/TT-BTC (10/02) — health-insurance audit, payment, and settlement (Ministry of Finance). |
| 03/2026 | Law 134/2025 (the AI Law) effective 01/03; affects every clinical AI system. |
| 03/2026 | Decision 697/QĐ-BYT (19/3) — the new BHYT inpatient/outpatient billing summary template (effective 19/3/2026, with a transition window through 01/7/2026). |
| 03/2026 | Decree 90/2026/NĐ-CP (30/3) — administrative penalties in the health sector (effective 15/5/2026). |
| 03/2026 | Decision 11/2026/QĐ-TTg (28/3) — the national database catalog, including the health database. |
| 04/2026 | Circular 06/2026/TT-BYT (02/4) — ICD-10 coding rules (effective 01/7/2026). |
| 04/2026 | hl7.org.vn launches — an Omi HealthTech (OmiGroup) initiative; the knowledge hub at /kien-thuc/ goes live. |
The most consequential community shift is the launch of hl7.org.vn in April 2026. This is an Omi HealthTech initiative within OmiGroup, started by Phan Mạnh Hùng (HungPM) with a community-driven mandate: build an open VN Core IG, author a bilingual Vietnamese/English knowledge hub, and pursue HL7 Vietnam Affiliate registration. The community canonical URL is http://fhir.hl7.org.vn/core/, distinct from the Ministry of Health canonical at http://fhir.ehealth.gov.vn/core/; the path to convergence — handover or redirect — will be discussed once a formal MOU is in place.
7. 2027+ — The forward roadmap
The roadmap below reflects internal planning by HL7 Vietnam and OmiGroup, combined with deadlines that already appear in current legal documents. These milestones are directional and will be updated as official information becomes available.
| Date | Goal |
|---|---|
| Q4/2026 | VN Core IG 1.0 release candidate — full P0/P1 profiles, examples, and search parameters. |
| Q1/2027 | Register the HL7 Vietnam Affiliate; formalize governance. |
| Q2/2027 | VN Core IG 1.0 production; complete ConceptMaps between XML 4210/3176 and FHIR. |
| Q3/2027 | National sandbox plus the first Vietnamese Connectathon. |
| 2028 | Proposed circular mandating FHIR for class-II hospitals and above. |
| 2028-2029 | BHXH accepts FHIR Bundles in parallel with the XML 4210/3176 chain. |
| 2029-2030 | Phase out the XML chain; FHIR becomes the official channel for BHYT data. |
Three conditions decide whether the roadmap succeeds. First, alignment with the Ministry of Health and BHXH — without official endorsement, FHIR will remain a side channel. Second, the technical capacity of vendors and hospitals — training, sandboxes, and Connectathons are the way to compress the learning curve. Third, a sustainable community model — an HL7 Vietnam Affiliate needs funding, maintainers, and a transparent decision-making process so the IG does not end up "abandoned" the way many open-source projects do.
8. Ten milestones worth remembering
- 2010 — Vinmec deploys the first HIS with an HL7 v2 module (foreign vendor), opening private-sector HL7 practice.
- 2017 — Decision 4210/QĐ-BYT establishes the unified national BHXH XML chain.
- 2020 — Decision 4469/QĐ-BYT (28/10) issues ICD-10 in its Vietnamese edition.
- 2024 — The
hl7vn/vn-core-igrepository publishes the first draft VN Core IG R4 (65 StructureDefinitions, 9 commits). - 06/2025 — Resolution 202/2025/QH15 redraws the country into 34 provinces; the 2025 Law on Local Government Organization formalizes the two-tier model.
- 06/2025 — Circular 13/2025/TT-BYT on electronic medical records ties EMRs to the national ID number and to VNeID.
- 06/2025 — Law 91/2025/QH15 on personal data protection classifies all health data as sensitive.
- 07/2025 — Decision 2427/QĐ-BYT launches the SNOMED CT Vietnam program (with batches 2 and 3 following).
- 12/2025 — Law 134/2025/QH15 on Artificial Intelligence; Vietnam's first AI framework that explicitly covers healthcare.
- 04/2026 —
hl7.org.vnlaunches; OmiGroup kicks off the community-driven initiative and the bilingual knowledge hub.
9. Frequently asked questions
Why is Vietnam behind Japan and Korea?
JP Core (Japan) launched early and is operated professionally by HL7 Japan; KR Core (Korea) is similarly backed by the HL7 Korea Affiliate. Vietnam has no Affiliate yet, public-sector health-IT budgets are constrained, and entrenched vendor lock-in dampens the incentive to open up standards. That said, 2025 and 2026 are reversing the picture quickly.
Will the Ministry of Health accept the community VN Core?
Discussions are still in progress. The community version, started by OmiGroup, uses the hl7.org.vn canonical, which is independent of the fhir.ehealth.gov.vn canonical maintained by the MOH IT Department. Once an MOU exists, the two versions can be unified or redirected to one another.
Is the hl7vn/vn-core-ig repository still being maintained?
The most recent commit is in Q3/2024. The current maintenance status is unclear; the hl7.org.vn community has reached out to propose collaboration and will publish updates as official responses arrive.
When will FHIR fully replace the XML 4210/3176 chain?
On the current roadmap, the earliest realistic horizon is 2029-2030, and it depends on consensus from Vietnam Social Security (BHXH). During the transition, FHIR and the XML chain will run in parallel through standard ConceptMaps.
10. Read next
This page is a living reference. Send data contributions, edits, and critiques to [email protected], or open an issue at github.com/HL7-org-vn.