FHIR in Vietnam: a timeline from 2010 to today
This timeline organizes public milestones into four orientation slices: public traces of HL7 v2 implementations (2010-2017), the BHXH XML chain (Decisions 4210 → 130 → 4750 → 3176), the draft VN Core IG R4 (2024-2025), and legal changes from 2025 onward. It is not a nationwide adoption survey.
This page serves general readers who need historical context, hospital CIOs preparing an integration roadmap, and regulators researching legacy systems. Legal milestones should be checked against the original instruments in the HL7 Vietnam Legal Framework; implementation statements are limited to the public evidence reviewed.
TL;DR
- 2010-2017: public materials show HL7 v2 in some HIS/LIS/RIS integration contexts; the evidence is insufficient to rank first movers or quantify adoption.
- 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 Omi HealthTech initiative launches
hl7.org.vn, laying the groundwork for an HL7 Vietnam Affiliate path and a trial-use VN Core IG under an open Working Group-oriented model.
On this page
- The four phases at a glance
- 2010-2017 — Public traces of HL7 v2
- 2017-2024 — The BHYT healthcare-data XML chain
- 2024 — The first draft VN Core IG
- 2025 — The big-bang regulatory year
- 2026 — The open Working Group-oriented 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 traces | 2010-2017 | Some public materials record HL7 v2 integrations; no nationwide adoption metric is available. |
| 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+ | Legal requirements create an interoperability need; open artifacts are prepared for Working Group review. |
The four slices do not have crisp boundaries and do not represent a nationwide implementation survey. The BHYT healthcare-data XML chain and HL7 v2 interfaces may coexist with FHIR implementations; the actual architecture must be confirmed for each institution and integration contract.
2. 2010-2017 — Public traces of HL7 v2
Some public materials from this period mention HL7 v2 in HIS/LIS/RIS integration contexts, commonly involving laboratory, imaging, and hospital-core systems. The reviewed corpus is not sufficient to identify the first implementing institution, the origin of its vendor, or the scale of adoption.
The available sources are also insufficient to compare public and private providers, vendor compatibility, or integration costs. The project corpus does support the narrower observation that no national Implementation Guide from this period has been identified; stronger conclusions require institution-level contracts, configurations, and acceptance records.
International milestones provide technical context: HL7 International published FHIR DSTU 1 in 2014 and FHIR R4 (4.0.1) in 2019. Those dates do not establish when FHIR became known or implemented in Vietnam.
Historical note: Several "first in Vietnam" claims from this period do not have strong public primary-source coverage. This article uses scattered public sources to build an orientation timeline; these milestones should not be cited as exclusive first-mover conclusions.
3. 2017-2024 — The BHYT healthcare-data XML chain
Decision 4210/QĐ-BYT established an output-data standard and format for the management, assessment, and payment of BHYT healthcare costs. It is not an HL7 standard. Its mandatory scope and implementation responsibilities must be read from the decision and its amendments; they should not be generalized to every health system or every software vendor.
Decision 4210/QĐ-BYT established the legacy schema, where MA_LYDO_VVIEN has four codes (1–4). Decision 130/QĐ-BYT (2023) succeeded it and broadened the scope, Decision 4750/QĐ-BYT made further adjustments, and Decision 3176/QĐ-BYT of 29 October 2024 updated the current standard with fields such as MA_DOI_TUONG_KCB, KET_QUA_DTRI, and MA_LOAI_RV. Decision 3276/QĐ-BYT supplies the current 27-code list for MA_DOI_TUONG_KCB. The VN Core technical name MALYDO is not a field defined by the current standard.
| 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 public corpus confirms the repository, package, and builds described above, but does not provide reliable measures of hospital adoption, vendor support, Connectathons, or sandboxes. VN Core 1.0.0 should therefore be described as a technical publication; whether a particular authority or contract accepts or mandates it must be established from a separate source.
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) — rules on data connection and sharing within the decree's scope. |
| 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). |
Two important 2025 drivers are Circular 13/2025 and Law 91/2025: electronic-medical-record information must be linked to the personal identification number of Vietnamese citizens and of foreign nationals who have been issued an electronic identification account, while health data falls within sensitive-personal-data rules under the applicable legal conditions. Resolution 202/2025 and the 2025 Law on Local Government Organization change the administrative geography, requiring review of the division CodeSystem and FHIR Address design. The SNOMED CT and TVM/YHCT decisions add shared terminology sources for Vietnam.
6. 2026 — The open Working Group-oriented 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; clinical AI systems within scope must assess their applicable obligations. |
| 03/2026 | Decision 697/QĐ-BYT (19/3) — the new BHYT inpatient/outpatient billing summary template (effective 19/3/2026; the transition window closed on 01/7/2026 and it is now the sole template). |
| 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 initiative; the knowledge hub at /kien-thuc/ goes live. |
An important public change was the April 2026 launch of hl7.org.vn, an Omi HealthTech initiative for a trial-use VN Core IG and bilingual knowledge hub. Its project canonical is http://fhir.hl7.org.vn/core/, distinct from http://fhir.ehealth.gov.vn/core/ in the repository published by a Ministry of Health unit. Any convergence, transfer, or Affiliate model requires consultation and authorized governance.
7. Maturity gates after v0.9.0
The project assigns no committed date or version to recognition, an Affiliate, or a mandate. The sequence below lists evidence gates; dates should be published only when authorized parties and implementation evidence support them.
| Stage | Completion condition |
|---|---|
| 1. Stabilize contracts | Pin packages, actors, CapabilityStatements, terminology, and compatibility policy for a piloted subset. |
| 2. Demonstrate interoperability | Publish representative fixtures, test suites, issue logs, and multi-system reports; BHYT mappings are complete only within tested scope. |
| 3. Establish governance | A multi-stakeholder Working Group publishes its charter, decision rights, terminology governance, and conflict-of-interest rules. |
| 4. Consult externally | Compare canonicals, intake mechanisms, and technical-steward options with competent authorities and relevant communities. |
| 5. Policy decision | Recognition, mandates, transition plans, or an Affiliate application require separate decisions and do not arise automatically from a trial-use build. |
Success requires authorized governance, technical capacity across vendors and healthcare organizations, and a multi-stakeholder Working Group with transparent change control. A technical-steward or Affiliate model, if selected, also needs an approved operating and funding mechanism; this website does not presume that outcome.
8. Ten milestones worth remembering
- 2010+ — Public materials begin to record HL7 v2 in some HIS/LIS/RIS contexts; the evidence is insufficient to identify first movers.
- 2017 — Decision 4210/QĐ-BYT establishes an output-data standard and format for BHYT healthcare management, assessment, and payment within its stated scope.
- 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 — Article 1(3) of Circular 13/2025 on electronic medical records requires EMR information to be linked to the personal identification number of Vietnamese citizens and of foreign nationals who have been issued an electronic identification account.
- 06/2025 — Law 91/2025/QH15 places health data within sensitive-personal-data rules under the applicable definitions and conditions.
- 07/2025 — Decision 2427/QĐ-BYT launches the SNOMED CT Vietnam program (with batches 2 and 3 following).
- 12/2025 — Law 134/2025/QH15 establishes a general AI framework; healthcare AI must determine its scope and risk classification under the law.
- 04/2026 —
hl7.org.vnlaunches; Omi HealthTech kicks off a Working Group-oriented trial-use initiative and the bilingual knowledge hub.
9. Frequently asked questions
Why is Vietnam behind Japan and Korea?
There is no single public metric for ranking national adoption speed. JP Core is developed by a JAMI working group, and the reviewed latest branch states that it is not approved by HL7 Japan; KR Core 2.0.0 is published by HL7 Korea. Vietnam should compare governance, published packages, test suites, and implementation evidence rather than project age.
Will the Ministry of Health accept the community VN Core?
No public announcement has formally recognized the draft yet. The version started by Omi HealthTech uses the fhir.hl7.org.vn canonical, which is independent of the fhir.ehealth.gov.vn canonical maintained by the MOH IT Department. Once an official Working Group or MOU exists, the two streams can be compared through a technical matrix and handled under the agreed governance decision.
Is the hl7vn/vn-core-ig repository still being maintained?
No new public commit appears after Q3/2024. When using that repository as a technical reference, treat it as a historical VN Core R4 milestone and verify with official channels before using it for production implementation.
When will FHIR fully replace the XML 4210/3176 chain?
No official decision or roadmap has set a date for FHIR to replace the current KCB/BHYT XML chain in full. An implementation may use FHIR internally and convert to the exact XML version required by the receiving party, or operate both interfaces during a transition. Adapters, mappings, and reconciliation must be tested against each flow's contract; an end-to-end standardized ConceptMap must not be assumed. The XML interface should be retired only when the competent authority and receiving party publish the applicable basis and transition criteria.
10. Read next
This page is a living reference. Send data contributions, edits, and critiques to [email protected]; the public tracker will be published from the governance page once the Working Group stabilizes.