# HL7 Vietnam - hl7.org.vn > Public-facing overview for VN Core FHIR Implementation Guide and Vietnam healthcare data standardization. > For deeper machine-readable extract see: `https://hl7.org.vn/llms-full.txt` HL7 Vietnam (`https://hl7.org.vn`) is the public website for the VN Core FHIR initiative. It explains why the guide exists, what the current public draft contains, which Vietnam-specific legal and operational constraints shape the design, and where to find the canonical technical specification. The initiative is developed by Omi HealthTech. ## Current public release - Package: `hl7.fhir.vn.core@0.9.0` - Status: public trial-use draft (Draft for Community Review), synchronized on 18/07/2026 with governed release metrics, legal registry and BHYT mapping wiki - FHIR version: R4 (4.0.1) - License: CC-BY-4.0 - Scope snapshot: 86 Profiles, 56 total Extensions (53 local + 3 official Patient extensions), 165 CodeSystems, 168 ValueSets, 36 NamingSystems, 19 SearchParameters, 27 Logical Models, 4 OperationDefinitions, 5 CapabilityStatements, 17 ConceptMaps, 249 example files, 227 example instances, 428 total instances, 850 exported JSON artifacts - Legal coverage: 209 source-linked public legal references across 18 domains: 168 in force, 16 amended (consolidated reading), 2 future-effective and 20 superseded; all 209 entries are represented in registry CodeSystem VNLegalDocumentRefCS - Split release model: 6 packages - `hl7.fhir.vn.core` - `hl7.fhir.vn.core.base` - `hl7.fhir.vn.bhyt.submission` - `hl7.fhir.vn.terminology.clinical` - `hl7.fhir.vn.terminology.traditional-medicine` - `hl7.fhir.vn.device` ## What this website covers - Home: `https://hl7.org.vn/` Why Vietnam needs HL7 FHIR now, centered on data-first governance, VNeID, EMR/HSSK, LGSP-facing integration, administrative restructuring, BHYT submission, personal data protection, and AI governance. - About: `https://hl7.org.vn/about/` Project context, strategic design decisions, package split, current release value, and implementation direction. - Implementation playbook: `https://hl7.org.vn/implementation/` Three role-based playbooks for hospitals, vendors, and government agencies. - Roadmap: `https://hl7.org.vn/roadmap/` Product milestones (v0.1 → v1.0), parallel legal milestones, and release rules. - Governance: `https://hl7.org.vn/governance/` Operating principles, role structure, contribution process, and the path to HL7 Affiliate. - Community: `https://hl7.org.vn/community/` Adoption KPI dashboard, pilot tracker, and the five contributor roles currently open. - News: `https://hl7.org.vn/news/` and `https://hl7.org.vn/rss.xml` Changelog of releases, legal updates, and site changes; RSS 2.0 feed available. - Legal framework: `https://hl7.org.vn/legal-framework/` Searchable registry of 209 legal references across 18 legal domains, with exact `thuvienphapluat.vn/van-ban/... .aspx` source links for every listed document. - Citation: `https://hl7.org.vn/cite/` BibTeX, APA 7, Vancouver, and CITATION.cff for academic and policy reference. - Brand: `https://hl7.org.vn/brand/` Wordmark, palette, typography, and asset downloads with trademark guidelines. - Reuse notice: `https://hl7.org.vn/NOTICE.txt` Short machine-readable attribution, no-endorsement and third-party-rights notice. - Contact: `https://hl7.org.vn/contact/` Feedback channel and contribution entry points. - English pages: `https://hl7.org.vn/en/` plus corresponding public and Knowledge Hub routes, including `/en/legal-framework/` (full 209-reference parity), `/en/roadmap/`, `/en/governance/`, `/en/community/`, `/en/cite/`, `/en/brand/`, `/en/news/`, `/en/contact/`, `/en/about/`, `/en/getting-started/`, `/en/privacy-policy/`, `/en/terms/`. Bilingual via single source `src/data/legal-docs.ts` and `src/config/i18nRoutes.ts`. - Canonical IG: `https://fhir.hl7.org.vn` Authoritative technical artifacts, profiles, terminology, examples, and implementation guidance. ## Key implementation themes - URI-first identifiers and separate NamingSystems for CCCD, BHYT, BHXH, GPHN, CCHN, CSKCB, MA_LK, and MA_LUOT_KCB - Unicode-first storage and transparent search behavior for Vietnamese text - Actor-based Must Support guidance and use of Data Absent Reason instead of pseudo-values - Data governance boundary for business data, shared data, and future secondary-use data - Clean separation between FHIR-native core exchange and payer-specific `BHYT Submission` - Vietnam-specific terminology, including ICD-10 VN, CLS VN, SNOMED CT VN subsets, and 10 traditional medicine code systems ## Vietnam-specific strategic, legal, and operational focus - Digital strategy and architecture: `QĐ 3516/QĐ-BYT` and `QĐ 4152/QĐ-BYT` move the project toward data governance, shared data, VNeID, EMR/HSSK, LGSP/API facade, and security-first pilot preparation - Administrative model: 34 provinces/cities and commune-level addressing, with backward compatibility for legacy district data - EMR and identity: TT 13/2025/TT-BYT, citizen ID / VNeID, and implementable patient, encounter, and document workflows - Privacy and security: Law 91/2025/QH15, Decree 356/2025/ND-CP, consent, audit, provenance, and data residency concerns - BHYT and submission: separation of core exchange from insurance submission and cost-summary workflows - Clinical terminology: legally grounded Vietnamese terminologies for diagnosis, lab, SNOMED subsets, and traditional medicine ## Recommended technical entry points - IG home: `https://fhir.hl7.org.vn` - Legal basis: `https://fhir.hl7.org.vn/legal-basis.html` - Identifier registry: `https://fhir.hl7.org.vn/identifier-registry.html` - URI/OID mapping: `https://fhir.hl7.org.vn/identifier-and-oid-mapping.html` - String search and Unicode: `https://fhir.hl7.org.vn/string-search-guidance.html` - Search behavior: `https://fhir.hl7.org.vn/search-behavior.html` - Must Support guidance: `https://fhir.hl7.org.vn/must-support-guidance.html` - General guidance: `https://fhir.hl7.org.vn/general-guidance.html` - Release governance: `https://fhir.hl7.org.vn/release-governance.html` - Package architecture: `https://fhir.hl7.org.vn/package-architecture.html` ## Reuse, attribution and rights boundaries - VN Core-authored content is published under CC-BY-4.0. Suggested attribution: `VN Core FHIR Implementation Guide v0.9.0 — Omi HealthTech / VN Core FHIR Community Initiative — https://hl7.org.vn`. - Commercial use, internal redistribution and derivative implementation guides are allowed with attribution and change notices. - Do not imply endorsement by Omi HealthTech, the VN Core community, HL7 International or any Vietnamese state agency. - HL7(R) and FHIR(R) are trademarks of Health Level Seven International. - LOINC, SNOMED CT, HL7 base specifications, Vietnamese legal documents and Thư Viện Pháp Luật source pages remain subject to their own rights, licences and citation requirements. ## Contact - Website: `https://hl7.org.vn` - FHIR IG: `https://fhir.hl7.org.vn` - Email: `info@hl7.org.vn` - Omi HealthTech: `https://omihealthtech.vn`