Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Bản nháp để cộng đồng rà soát:
0.10.0chưa mirror lênpackages.fhir.org— dùng.tgztừ website.
latestĐịnh danh gói hl7.fhir.vn.core đã từng được dùng cho một IG khác: bản hl7vn/vn-core-ig phát hành năm 2024 dưới phiên bản 1.0.0 và canonical http://fhir.ehealth.gov.vn/core/. Bản này dùng canonical riêng http://fhir.hl7.org.vn/core (lý do tại ADR-0002), nhưng giữ nguyên định danh gói.
Hệ quả kỹ thuật phải xử lý trước khi cài:
1.0.0 lớn hơn 0.10.0. Rủi ro nằm ở chỗ không ghim phiên bản: trình phân giải hỏi latest hoặc để trống sẽ chọn bản 2024 — bản chỉ có 8 profile dưới canonical khác. Ghim tường minh #0.10.0 thì không có chuyện lấy nhầm; nhưng vì bản này chưa lên packages.fhir.org, dạng ghim ấy sẽ không tìm thấy gói trên registry, nên hãy trỏ vào tệp .tgz đã tải.hl7.fhir.vn.core#0.10.0 tường minh trong mọi cấu hình (sushi-config.yaml, cache gói của máy chủ FHIR). Không dùng latest, không để trống phiên bản. Với validator, trỏ thẳng vào tệp .tgz đã tải cho tới khi bản này được mirror lên packages.fhir.org..tgz ngay sau khi tải và lưu trong hồ sơ triển khai, để lần cài sau đối chiếu được là cùng một tệp. Dự án chưa công bố bảng checksum chuẩn cho 0.10.0 — mốc đối chiếu là giá trị quý vị tự ghi ở lần tải đầu.http://fhir.ehealth.gov.vn/core/... không là resource conform bản này. Hai canonical là hai không gian tên khác nhau; cần chuyển đổi thì phải có bảng ánh xạ theo từng profile, không suy tương đương từ việc trùng tên gói.# Ghi lại checksum của tệp vừa tải, rồi trỏ validator vào CHÍNH tệp đó.
# `0.10.0` chưa mirror lên packages.fhir.org, nên dạng `-ig hl7.fhir.vn.core#0.10.0`
# sẽ khiến trình phân giải đi tìm trên registry và KHÔNG thấy gói. Dạng nguy hiểm hơn là
# bỏ phiên bản hoặc dùng `latest`: khi đó nó lấy bản 1.0.0 năm 2024 dưới canonical khác.
shasum -a 256 hl7.fhir.vn.core-0.10.0.tgz
java -jar validator_cli.jar patient.json -ig ./hl7.fhir.vn.core-0.10.0.tgz
| Gói | Tải | Mô tả |
|---|---|---|
hl7.fhir.vn.core |
package.tgz / tgz | Gói tổng hợp |
hl7.fhir.vn.core.base |
tgz | Lõi EMR/HIE/FHIR-native |
hl7.fhir.vn.pharmacy |
tgz | Dược: đơn thuốc điện tử, cấp phát, liên thông CSDL Dược (phụ thuộc core.base) |
hl7.fhir.vn.bhyt.submission |
tgz | Liên thông hồ sơ BHYT (phụ thuộc core.base) |
hl7.fhir.vn.patient-access |
tgz | Sổ SKĐT VNeID, khám sức khoẻ định kỳ, chứng nhận sức khoẻ (phụ thuộc core.base, pharmacy) |
hl7.fhir.vn.terminology.clinical |
tgz | ICD-10 VN, ICD-9-CM, SNOMED CT VN, CLS, LOINC |
hl7.fhir.vn.terminology.traditional-medicine |
tgz | Thuật ngữ Y học cổ truyền |
hl7.fhir.vn.device |
tgz | Thiết bị y tế: danh pháp, số lưu hành, kiểm định (phụ thuộc core.base) |
hl7.fhir.vn.legal |
tgz | Sổ đăng ký pháp lý: VNLegalDocumentRefCS + trạng thái hiệu lực + mã ngoại lệ căn cứ; trục phát hành riêng theo nhịp pháp luật (ADR-0022) |
Nâng cấp từ bản cũ: đọc Hướng dẫn di trú 0.7.0 → 0.10.0 trước khi thay gói.
vn-district-code-migration.json là bảng JSON độc lập gồm 696 dòng TMS / ghép tỉnh+huyện → mã nhà nước 3 chữ số, kèm scheme/edition và SHA-256 registry nguồn. Tệp được phân phối cùng trang IG, không cần bộ nguồn cục bộ hay API Python. Xem checksum tệp và hướng dẫn chọn bản nguồn trước khi tra mã. Chỉ đổi biểu diễn mã, không chứng nhận địa giới/pháp nhân; không tự chuyển hồ sơ lịch sử sang đơn vị hiện hành.
| Tệp | Liên kết |
|---|---|
| Full IG (HTML offline) | full-ig.zip |
| Expansions JSON | expansions.json / zip |
| Expansions XML | expansions.xml / zip |
| Tệp | Liên kết | Số mã |
|---|---|---|
| ICD-10 VN | CodeSystem JSON | 16.052 — edition 2026 (15.844 hiện hành theo bảng TT 06/2026/TT-BYT + 208 mã huỷ PL4 QĐ 1849/QĐ-BYT giữ inactive); business version 2026-07-01, đối soát ba chiều R1-R8. Bản edition 2020 đóng băng tại CodeSystem-vn-icd10-cs-2020-legacy.full.json |
| LOINC VN (supplement bản dịch VI, LOINC 2.78) | CodeSystem JSON | 89.470 designation vi / 104.054 mã |
| SNOMED CT VN (supplement bản dịch VI) | CodeSystem JSON | 76.066 mã (từ 77.393 concept 3 đợt) |
| DVKT Phụ lục 1 (TT 23/2024/TT-BYT) | CodeSystem JSON | 19.438 dòng — experimental/fragment; chưa bảo toàn 1.232 prefix BS_ và literal 19165, không phải bản chép nguyên văn đầy đủ |
| DVKT Phụ lục 2 | CodeSystem JSON | 9.124 identifier suy dẫn — experimental/fragment; phụ lục pháp lý có 9.128 dòng và không ban hành cột mã, không phải bộ mã chính thức/đầy đủ |
| Định dạng | Liên kết |
|---|---|
| JSON | definitions.json.zip |
| XML | definitions.xml.zip |
| Turtle (RDF) | definitions.ttl.zip |
| Định dạng | Liên kết |
|---|---|
| JSON | examples.json.zip |
| XML | examples.xml.zip |
curl -L https://github.com/hapifhir/org.hl7.fhir.core/releases/latest/download/validator_cli.jar -o validator_cli.jar
java -jar validator_cli.jar patient.json -ig ./package.tgz
Repo công khai và quy trình issue/PR sẽ được công bố sau khi quản trị và kênh đóng góp được chốt. Trong giai đoạn thí điểm, liên hệ [email protected] để nhận gói nguồn hoặc gửi phản hồi kỹ thuật.
This is an R4 IG. None of the features it uses are changed in R4B, so it can be used as is with R4B systems. Packages for both R4 (hl7.fhir.vn.core.r4) and R4B (hl7.fhir.vn.core.r4b) are available.
Package hl7.fhir.uv.extensions.r4#5.2.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00) |
Package hl7.fhir.uv.extensions.r4#5.3.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sat, May 16, 2026 18:32+1000+10:00) |
Package hl7.fhir.uv.ipa#1.1.0 This IG describes how an application acting on behalf of a patient can access information about the patient from an clinical records system using a FHIR based API. The clinical records system may be supporting a clinical care provider (e.g. a hospital, or a general practitioner), or a health data exchange, including a national health record system. (built Wed, Mar 19, 2025 14:34+0000+00:00) |
Package hl7.fhir.uv.xver-r5.r4#0.1.0 Extensions for Using Data Elements from FHIR R5 in FHIR R4 (built Fri, Mar 20, 2026 15:40+1100+11:00) |
Package hl7.fhir.uv.tools.r4#1.1.2 This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Tue, Mar 24, 2026 11:13+1100+11:00) |
Package hl7.fhir.uv.extensions.r4#5.3.0-ballot-tc1 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sun, Aug 3, 2025 06:28+1000+10:00) |
Package hl7.fhir.uv.sdc#4.0.0 The SDC specification provides an infrastructure to standardize the capture and expanded use of patient-level data collected within an EHR. (built Tue, Mar 24, 2026 16:16+1100+11:00) |
There are no Global profiles defined
This publication includes IP covered under the following statements.
KL
không phải nhóm tiêu chuẩn trong phụ lục — do VN Core thêm để mang kết luận Đạt/Không đạt nêu ở phần điều khoản.DB
là viết tắt do VN Core đặt cho hạng đặc biệt; ba mã còn lại lấy trực tiếp chữ số La Mã của văn bản.xa
/phuong
/dac-khu
do VN Core thiết kế.| Nếu cần | Nên đọc tiếp |
|---|---|
| Bắt đầu cài đặt và chạy thử các artifact đã tải | Bắt đầu nhanh |
| Hiểu quy trình phát hành và lộ trình phiên bản | Phát hành và quản trị |
| Xem lịch sử thay đổi giữa các phiên bản | Lịch sử thay đổi |
| Kiểm tra hợp lệ dữ liệu với package vừa tải | Hướng dẫn kiểm tra hợp lệ |
Release download surface for VN Core 0.10.0 (Draft for Community Review). Provides aggregate and modular packages, offline builds, definitions, examples, and large terminology artifacts. Until packages.fhir.org mirroring completes, use .tgz files from the canonical download surface.