HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

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.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Lịch sử thay đổi

Lịch sử thay đổi — Changelog

Lịch sử thay đổi theo từng phiên bản.

Cách dùng changelog

  • Nếu bạn đang nâng phiên bản, hãy đọc từ phiên bản mới nhất trở xuống và tập trung vào các thay đổi có khả năng ảnh hưởng đến ánh xạ dữ liệu, validation, package dependency và hành vi tìm kiếm.
  • Nếu bạn là người rà soát hoặc thành viên cộng đồng, hãy dùng changelog để theo dõi hướng trưởng thành của IG, không dùng nó thay cho tài liệu hướng dẫn triển khai.
  • Nếu bạn cần quyết định có nên nâng phiên bản ngay hay chưa, hãy đọc thêm Ổn định và tuân thủ và Phát hành và quản trị.

Phiên bản 0.9.0 — Bản nháp để cộng đồng rà soát (2026-07)

Bản minor có thay đổi phá vỡ tương thích, tập trung vào trục thanh toán BHYT và độ chính xác của chính bộ artifact: bảng kê chi phí chi tiết theo QĐ 697/QĐ-BYT, biên bản quyết toán quý Mẫu số 06/BH theo TT 12/2026/TT-BTC, nhật ký truy cập khẩn cấp theo mô hình BALP, phạm vi hưởng BHYT mở rộng theo Luật 114/2025/QH15 Điều 44 và ba cổng kiểm ngữ nghĩa mới. 0.8.0 đóng băng nguyên trạng. Không đổi canonical URL/package id. Quy mô: 86 profiles, 56 extensions (53 cục bộ + 3 chuẩn HL7), 165 CodeSystems, 168 ValueSets, 17 ConceptMaps, 15 StructureMaps; kho pháp lý 209 văn bản; 100% artifact mang căn cứ pháp lý máy-đọc-được (618/618) với cổng ratchet chống tái diễn.

Thay đổi phá vỡ tương thích chính (chi tiết + migration: CHANGELOG repo, mục 0.9.0):

  • Ranh giới package (ADR-0020): IG phát hành 8 gói thay vì 6. Hai gói mới cắt ra khỏi hl7.fhir.vn.core.base: hl7.fhir.vn.pharmacy (đơn thuốc điện tử, cấp phát, liên thông Cơ sở dữ liệu về dược) và hl7.fhir.vn.patient-access (Sổ sức khỏe điện tử VNeID, khám sức khỏe định kỳ, chứng nhận sức khỏe). Bên nào đang phụ thuộc core.base và dùng hai trục này phải thêm dependency tương ứng; bên dùng gói tổng hợp hl7.fhir.vn.core không phải làm gì. Xem Kiến trúc gói phát hành.

  • Gỡ hẳn extension vn-ext-encounter-code (retired từ 0.7.0, giữ trọn 0.8.0 làm cửa sổ migration) — dữ liệu chuyển sang Encounter.identifier[maLuotKcb].
  • Mã VNInsuranceVisitTypeCS#5 (không có trong QĐ 4210/QĐ-BYT) chuyển deprecated; mọi ví dụ đã chuyển sang mã 1 (đúng tuyến).

Thêm mới — Điều phối, đặt lịch khám từ xa và ánh xạ y học cổ truyền

  • VNCoreTask: công việc điều phối cho hai luồng đã có trong IG — tiếp nhận chuyển người bệnh và cấp phát, bán thuốc theo đơn. Task.businessStatus mang trạng thái nghiệp vụ Việt Nam theo VNTaskBusinessStatusVS (11 mã, do dự án tự đặt vì chưa có danh mục quốc gia), tách khỏi Task.status vốn chỉ mô tả vòng đời kỹ thuật.
  • VNCoreAppointment, VNCoreSchedule, VNCoreSlot: khép chuỗi đặt lịch → khám từ xa. Encounter.appointment nay trỏ về VNCoreAppointment. Extension phương thức cung cấp dịch vụ cho biết buổi hẹn là trực tiếp, tại nhà hay từ xa — thông tin người bệnh cần ngay khi đặt, mà FHIR R4 không có element nào mang được trên Appointment/Slot/Schedule.
  • ConceptMap vn-cm-yhct-disease-to-icd10: ánh xạ đủ 228 mã bệnh danh và thể lâm sàng y học cổ truyền sang 25 mã ICD-10 theo QĐ 2552/QĐ-BYT Phụ lục I, hiệu chỉnh nhánh Hạ trĩ từ I84 sang K64 theo QĐ 1978/QĐ-BYT. Nhánh chẩn đoán y học cổ truyền chưa ánh xạ vì phụ lục nguồn không có cột ICD-10.
  • vn-translated-allergy-code-vs: 1.327 mã dị ứng SNOMED CT đã có tên tiếng Việt chính thức theo QĐ 2805/QĐ-BYT — dùng để kiểm tra bản dịch, không dùng làm binding bắt buộc.

Thêm mới — Danh mục mã bệnh Y học cổ truyền của bộ mã dùng chung

  • vn-yhct-disease-catalog-cs: 4.142 mã bệnh thuộc 18 chương theo Phụ lục 07.1 QĐ 7603/QĐ-BYT, kèm tên bệnh y học hiện đại và tên trên bảng kê chi phí. Dùng cho trường MA_BENH khi gửi dữ liệu bảo hiểm y tế cho ca điều trị y học cổ truyền.
  • vn-cm-yhct-disease-catalog-to-icd10: 4.141 ánh xạ sang ICD-10. Một mã bệnh có thể ứng với nhiều mã ICD-10 — giữ đủ, không ép một-một.
  • Đừng nhầm với vn-yhct-disease-cs: bộ đó là 228 bệnh danh và thể lâm sàng theo QĐ 2552/QĐ-BYT dùng để ghi nhận lâm sàng. Hai danh mục khác mục đích, không thay thế nhau.
  • Phụ lục 07.1 tuy ban hành 2018 nhưng vẫn hiện hành: QĐ 1978/QĐ-BYT (01/7/2026) chỉ sửa đổi, bổ sung và ghi rõ các nội dung khác giữ nguyên. Bản này đã áp cả sửa đổi của QĐ 1978/QĐ-BYT lẫn phần sửa/hủy trong chính phụ lục nguồn.

Cập nhật — ICD-10 theo QĐ 1849/QĐ-BYT

  • vn-icd10-cs: 15.026 → 15.617 mã (+549 mã bệnh, +42 nhóm bệnh 3 ký tự). Bộ nền đã hấp thụ phần lớn Phụ lục 5 từ trước; delta thực tế nhỏ hơn số dòng phụ lục.
  • 7 mã bị hủy chuyển inactive thay vì xóa — dữ liệu lịch sử vẫn tra cứu được, terminology server biết không cho dùng ở bản ghi mới.
  • Bổ sung 1.027 cờ sử dụng WHO 2019 mà bản trước không có: 884 mã không được dùng làm bệnh chính, 67 mã không khuyến khích, 48 mã đã có mã cụ thể hơn, 66 mã chỉ áp dụng cho nữ, 10 mã chỉ cho nam, cùng 129 mã có hướng dẫn mã hóa bổ sung. Nhờ đó validator chặn được việc gán mã asterisk làm chẩn đoán chính hoặc gán mã sản khoa cho người bệnh nam.

Thêm mới — Chất lượng, nhóm đối tượng và quản trị dữ liệu

  • VNCoreGroup, VNCoreMeasure, VNCoreMeasureReport cùng VNQualityStandardGroupVS theo TT 35/2024/TT-BYT. Xếp loại theo thông tư này là nhị phân — mã hóa bằng scoring = composite kèm compositeScoring = all-or-nothing, không để người đọc suy từ tỷ lệ phần trăm.
  • Phiếu tự đánh giá tiêu chuẩn chất lượng cơ bản: đủ 43 câu hỏi boolean theo năm Mục của Phụ lục TT 35/2024/TT-BYT, linkId bám số hiệu phụ lục. Chỉ tiêu chất lượng tính trực tiếp từ phiếu này bằng FHIRPath — không dùng CQL, vì 43 tiêu chuẩn là điều kiện về cơ sở vật chất và quy chế, không tính được từ dữ liệu lâm sàng.
  • Ba trang hướng dẫn mới: Khử định danh và dữ liệu dùng cho AI, SMART on FHIR — nghĩa vụ và scope, Rút trích dữ liệu theo lô. Cả ba giữ giọng conformance — mô tả nghĩa vụ của bên triển khai, không tuyên bố năng lực máy chủ mà IG không có.
  • Ba quyết định kiến trúc tồn đọng được viết chính thức: canonical URL và publication surface, địa chỉ theo mô hình chính quyền hai cấp, và chuẩn XML gửi bảo hiểm y tế là lớp ánh xạ chứ không phải mô hình lõi.

Changed — Consent/legal-basis D7 theo IHE BALP (BREAKING so với 0.8.0)

  • VNCoreConsent chỉ còn biểu diễn lựa chọn của chủ thể (đồng ý/từ chối/rút lại/giới hạn); slice processingLegalBasis chuyển 0..0. Context Consent của extension chỉ giữ để đọc legacy 0.8 trong dòng 0.9 và dự kiến gỡ ở 1.0.
  • Thêm VNCoreAuditEventLegalBasisDecision, VNAuditEventSubtypeCS/VS, VNAuditPurposeOfUseVS, PDP Device example và cặp AuditEvent: quyết định permit/deny (legal-basis-authorization) → truy cập thực tế (legal-basis-access). ValueSet purpose riêng hợp toàn bộ VNConsentPurposeVS với BTG/ETREAT/ERTREAT, tránh đưa purpose kiểm soát truy cập vào vocabulary Consent. Provenance nhận context extension khi tạo/sửa/dẫn xuất; SecurityLabel chỉ mô tả độ nhạy/nghĩa vụ; PurposeOfUse không phải căn cứ pháp lý.
  • Migration dual-read/single-write: writer 0.9 không tạo Consent cho Điều 19. Record runtime 0.8 chỉ chuyển entered-in-error sau khi có AuditEvent thay thế và Provenance liên kết, vẫn giữ lịch sử. Fixture source sai carrier được thay vì example không có canonical/lifecycle retire; package 0.8 đã phát hành không bị viết lại.
  • BTG chỉ dùng cho override thật; ETREAT là mục đích điều trị khẩn cấp và ERTREAT là quyền thường trực khoa cấp cứu. Nghĩa vụ chứng minh trực tiếp chỉ thuộc điểm a Điều 19(1); các điểm còn lại chịu lớp accountability/DPIA khi áp dụng, giám sát và safeguards.

Changed — Terminology identity D5/D6 (BREAKING so với 0.8.0)

  • Bỏ versionNeeded trên vn-province-cs và vn-health-checkup-subject-cs: canonical current/-legacy là ranh giới identity duy nhất. Coding.version tùy chọn; nếu có phải khớp business version của canonical.
  • Với 16 mã tỉnh tái sử dụng cùng tên nhưng khác địa giới, display của canonical hiện hành thêm hậu tố (từ 01/07/2025); canonical legacy và semantic hash giữ nguyên. Điều này làm khác biệt hai nghĩa hiển thị được mà không sửa lịch sử.
  • Đổi danh mục 696 huyện trước 01/07/2025 sang vn-district-legacy-cs/-vs ở trạng thái retired theo tiền lệ Province/KSK legacy. Canonical vn-district-cs/-vs cũ cũng retired nhưng giữ đủ nội dung; ConceptMap identity vn-cm-district-rename phủ 696/696.
  • Thay waiver pin diện rộng bằng 5 gate identity, pin SHA-256 semantic content cho ba legacy CodeSystem và thêm CI test offline scripts/test_terminology_semantics.py. Không thay release metrics 0.8.0.

Changed — Đồng bộ $summary với contract HL7 IPS 2.0.1 (BREAKING so với 0.8.0)

  • VNGenerateIPSSummary: khớp OperationDefinition/summary của hl7.fhir.uv.ips#2.0.1 — type = true (gọi được ở type-level Patient/$summary), parameter identifier chuyển Identifier → string (searchType = token), thêm parameter profile (canonical), return nới 1..1 → 0..1. Client 0.8.0 dùng contract cũ cần cập nhật khi nâng cấp.
  • VNCoreServer khai $summary ở type-level tương ứng; siết lại mô tả bảo mật/tài liệu REST theo hướng không tuyên bố vượt phạm vi conformance.

Changed — Đợt "chống suy diễn pháp lý" trên bề mặt tài liệu (hậu kiểm chứng rawtext)

  • Sửa 2 viện dẫn sai đang published: căn cứ xóa/khử nhận dạng dữ liệu chuyển về đúng Luật 91/2025/QH15 Điều 14 (trước dẫn nhầm điều khác); mốc "30 ngày" đơn nhất → đúng bộ mốc 02/10/15/20/30 ngày (kèm gia hạn tối đa 01 lần không quá 15 ngày) theo NĐ 356/2025/NĐ-CP Điều 5.
  • Tái phạm vi mức phạt 5% doanh thu về đúng Điều 8 khoản 4 Luật 91/2025/QH15 (chỉ vi phạm chuyển dữ liệu xuyên biên giới; vi phạm khác trần 3 tỷ đồng).
  • Đọc lại đúng TT 13/2025/TT-BYT Điều 1 khoản 3 trên ~15 trang (cụm "tài khoản định danh điện tử" chỉ định nhóm người nước ngoài).
  • Ma trận điều khoản mở rộng lên 55 claims:
    • Bổ sung theo Luật 91/2025/QH15 các claim về Điều 8 khoản 4, Điều 14 và Điều 33 khoản 2.
    • Bổ sung theo NĐ 356/2025/NĐ-CP các claim về Điều 5, Điều 13, Điều 17 khoản 3, Điều 20 và quy định mã hóa khi dùng dịch vụ đám mây.
  • Mô tả các profile Consent/Breach/Claim/Condition/Endpoint hạ giọng về đúng phạm vi conformance; ví dụ Endpoint BHYT chuyển sandbox example.org.

Phiên bản 0.8.0 — Bản nháp để cộng đồng rà soát (2026-07)

Bản minor có thay đổi phá vỡ tương thích, gộp: tái cấu trúc dữ liệu khám sức khỏe (KSK) theo QĐ 2062/QĐ-BYT, đợt rà soát văn bản pháp lý 07/2026 (corpus 172), và đợt remediation toàn diện hậu kiểm toán độc lập (16–17/07/2026). 0.7.0 đóng băng nguyên trạng và thay thế (superseded). Không đổi canonical URL/package id. Quy mô: 74 profiles, 53 extensions, 153 CodeSystems, 156 ValueSets, 12 ConceptMaps.

Thay đổi phá vỡ tương thích chính (chi tiết + migration: CHANGELOG repo, mục 0.8.0):

  • KSK theo QĐ 2062/QĐ-BYT: 17 mẫu phiếu QĐ 1551/QĐ-BYT chuyển retired, thay bằng 3 mẫu theo nhóm tuổi + mẫu tâm thần (TT 25/2026/TT-BYT Mẫu 04); DOI_TUONG 14→16 mã (mã 14 ĐỔI NGHĨA — dữ liệu cũ mang mã 14 ánh xạ mặc định sang 16); giai đoạn hiệu lực cũ tách vn-health-checkup-subject-legacy-cs + ConceptMap chuyển đổi; transport envelope theo Phụ lục 02/03 QĐ 2062/QĐ-BYT.
  • Consent theo R4 + Luật 91/2025/QH15 bản ban hành: mọi rule permit/deny chuyển xuống provision.provision[*] (root không mang type); viện dẫn toàn cụm về đúng số điều bản ban hành, có ma trận điều khoản máy-kiểm-chứng (governance/legal-article-map.json); tách căn cứ "không cần đồng ý" (Điều 19) thành vn-processing-legal-basis-cs qua extension riêng; xóa invariant bắt buộc period.end (mâu thuẫn Điều 9 khoản 4 điểm c).
  • RepresentationAuthority: xóa sub-extension restrictedSensitivity — hạn chế truy cập theo lớp biểu diễn bằng Consent.provision deny + securityLabel; xem Bảo mật.
  • Patient identifier: slicing theo Identifier.type (type 1..1); MRN dùng URI per-facility. Migration: điền type từ system cũ cho dữ liệu 0.7.0.
  • Mã số BHYT: sid/bhyt chỉ nhận 10 số (trùng mã số BHXH) hoặc 15 ký tự legacy — CCCD 12 số chuyển về sid/cccd (NĐ 188/2025/NĐ-CP Mẫu số 3).
  • Địa giới hành chính: vn-province-cs = 34 mã hiện hành; 63 mã cũ tách vn-province-legacy-cs; ConceptMap 63/63 build từ nguyên văn NQ 202/2025/QH15.
  • Đổi tên theo chính sách ADR-0017 (tên artifact không mang số văn bản): vn-qd3176-cost-group-* → vn-bhyt-claim-cost-group-* (canonical cũ retired đủ mã + ConceptMap identity).

Gia cố chất lượng: đóng lỗ hổng data-absent-reason (invariant hasValue() + bộ negative-fixtures có oracle chạy trong CI); hàng chục file extension bắt buộc value[x] 1..1; Bundle BHYT self-contained; thông báo vi phạm Mẫu 08 chuyển sang QuestionnaireResponse machine-readable; 2 gate CI mới (ma trận điều khoản pháp lý + chính sách terminology).

Số liệu phát hành lưu tại governance/release-metrics/0.8.0.json.

Phiên bản 0.7.0 — ĐÃ THAY THẾ (superseded 2026-07-16) — Bản gia cố sau kiểm toán hậu phát hành (2026-07-13)

0.7.0 được đóng băng nguyên trạng và thay thế (superseded) bởi 0.8.0 sau kiểm toán độc lập 16/07/2026 — nội dung đã gắn thẻ giữ nguyên, assets phát hành không bổ sung thêm; người triển khai dùng 0.8.0. Khác với 0.6.1 (rút lại — withdrawn), 0.7.0 vẫn là mốc phát hành hợp lệ trong lịch sử.

Bản gia cố sau kiểm toán độc lập hậu phát hành 0.6.1; 0.6.1 được đánh dấu rút lại (withdrawn) — người triển khai dùng 0.7.0 thay bản đó. Không đổi canonical URL, package id.

Thay đổi phá vỡ tương thích (tồn đọng từ dòng 0.6.x, nay công bố đúng SemVer kèm migration):

  • VNCoreEncounter.serviceProvider 0..1 → 1..1: mọi lượt khám phải gắn cơ sở KCB chịu trách nhiệm. Migration: bổ sung serviceProvider trỏ VNCoreOrganization cho Encounter hiện có; ca cấp cứu/draft trỏ tổ chức tiếp nhận.
  • VNCoreMedicationRequest.requester loại Organization (chỉ còn Practitioner/PractitionerRole theo TT 26/2025/TT-BYT). Migration: chuyển requester Organization sang PractitionerRole của người kê; cơ sở KCB thể hiện qua Encounter.serviceProvider.
  • vn-ext-encounter-code chuyển trạng thái retired (0.6.x đã xóa thẳng không qua giai đoạn retired; 0.7.0 khôi phục đúng quy trình). Migration: MA_LUOT_KCB dùng Encounter.identifier slice maLuotKcb. Extension đã được gỡ hẳn ở v0.9.0 nên mục này không còn liên kết tới trang artifact.

Sửa lỗi tài chính BHYT (blocker kiểm toán):

  • Exporter round-trip xuất đủ T_NGUONKHAC_NSNN/VTNN/VTTN/CL + T_NGUONKHAC theo dòng XML2/XML3 từ VNCoreExtOtherFundBreakdown, áp quy tắc giảm trừ tuần tự T_BNTT → T_BNCCT → T_BHTT; rule phân bổ quỹ theo dòng cộng T_NGUONKHAC — hồ sơ hợp lệ có nguồn khác không còn bị từ chối.
  • TYLE_TT_DV vắng mặt xuất 100 (không còn gán nhầm bằng TYLE_TT_BH); THANH_TIEN_BH dùng công thức đầy đủ Bảng 3 khi có DON_GIA_BH; thêm rule cảnh báo khi MA_THE_BHYT mang định danh thay thế (CCCD 12 số/mã BHXH 10 số theo NĐ 188/2025/NĐ-CP).
  • MA_TTDV (Bảng 13/14) xuất theo người đứng đầu CSKCB/người được ủy quyền ký giấy — bỏ fallback về bác sĩ chỉ định; ví dụ chuyển tuyến bổ sung giấy chuyển có người ký.

Sửa lỗi conformance:

  • Invariant vn-gestational-age-range (TUOI_THAI 1–42 tuần) dùng $this trên valueInteger — giá trị hợp lệ validate được (trước đây mọi giá trị đều fail do so sánh string với integer).
  • 4 operation khai đúng scope resource-level trên cả 3 CapabilityStatement: Bundle/$validate-bhyt-claim, Bundle/$submit-bhyt-claim, Claim/$reverse-bhyt-claim, Patient/[id]/$summary — client đọc CapabilityStatement gọi đúng URL.

Terminology & pháp lý:

  • Thêm VNTBTreatmentTypeCS (LOAI_DTRI_LAO 0–3) và VNTBRegimenCS (PHACDO_DTRI_LAO 1–27, Bảng 15 QĐ 3176/QĐ-BYT) kèm ValueSet.
  • Property status của VNLegalDocumentRefCS chuyển sang Coding (hệ VNLegalDocumentStatusCS) đúng FHIR R4; rollover trạng thái 8 văn bản chạm mốc hiệu lực 01/07/2026 (Luật 113/114/116/2025, TT 06/2026/TT-BYT, TT 11/2026/TT-BYT → in-force; Luật 24/2018/QH14, QĐ 6556/QĐ-BYT → superseded; QĐ 697/QĐ-BYT → in-force); corpus +3 văn bản (TT 56/2017/TT-BYT, TT 18/2022/TT-BYT, TT 30/2020/TT-BYT) và +8 văn bản đợt hiệu lực 01/07/2026 (TT 13/2026/TT-BYT tiêm chủng; NĐ 165/2026/NĐ-CP hướng dẫn Luật Phòng bệnh; TT 12/2026/TT-BYT sàng lọc trước sinh/sơ sinh; NĐ 168/2026/NĐ-CP hướng dẫn Luật Dân số; TT 16/2026/TT-BYT hỗ trợ thuốc miễn phí; NĐ 161/2026/NĐ-CP lương cơ sở; NQ 21/2026/NQ-CP phân cấp GPHN; Luật 148/2025/QH15 Chuyển đổi số) → tổng 145 văn bản.

Quản trị gói & versioning:

  • Gói hl7.fhir.vn.bhyt.submission nhận đủ delta 0.6.x (3 logical model XML13–15, 6 bundle ví dụ, eligibility profiles + examples, các bộ mã giấy tờ và điều trị lao); các extension chứa bởi VNCoreClaim giữ ở core.base có chủ ý để đúng chiều dependency.
  • Đồng bộ last-changed versioning cho 186 file artifact; hoàn tác 3 bump khống; dependencies nâng hl7.terminology.r4 7.2.0 và hl7.fhir.uv.ips 2.0.1.
  • Số liệu (theo release metrics 0.7.0): profiles 73, extensions 52, CodeSystems 143→145, ValueSets 148→150, ConceptMaps 7, Logical Models 19, example files 213.

Phiên bản 0.6.1 — ĐÃ RÚT LẠI (withdrawn 2026-07-13) — Bản vá nháp để cộng đồng rà soát (2026-07-10)

Bản này đã rút lại ngày 13/07/2026 sau kiểm toán độc lập hậu phát hành (lỗi ánh xạ tài chính BHYT, invariant tuổi thai, scope operations, gói thiếu delta, 3 breaking change không công bố). Nội dung được sửa và phát hành lại thành 0.7.0 — xem mục 0.7.0 ở trên.

Bản vá chuyên đề hoàn thiện chuẩn hóa dữ liệu đầu ra BHYT theo QĐ 3176/QĐ-BYT, đối chiếu nguyên văn toàn bộ 16 bảng phụ lục (~479 chỉ tiêu, dữ liệu đối chiếu tại analysis/qd3176-appendix/). Không đổi canonical URL, package id hoặc ngữ nghĩa lõi.

  • Logical model: thêm BHYTXML13ReferralLM (giấy chuyển tuyến/chuyển cơ sở KBCB, 37 chỉ tiêu), BHYTXML14FollowUpAppointmentLM (giấy hẹn khám lại, 22) và BHYTXML15TuberculosisLM (quản lý điều trị lao, 20); mở rộng BHYTCheckInLM 7→26 trường; vá 39 trường thiếu + 84 ánh xạ vn-fhir cho XML1–XML12 (mỗi bảng phủ 100% chỉ tiêu); sửa mô tả sai MA_PTTT_QT (mã phẫu thuật thủ thuật ICD-9-CM, không phải phương thức thanh toán).
  • Terminology: thêm VNAnesthesiaMethodCS (PP_VO_CAM, 4 mã), VNDocumentFormCS (MAU_SO — mã biểu mẫu CT07, không phải mẫu số thẻ BHYT), VNCareTransferReasonCS (MA_LYDO_CT, 3 mã), VNGenderCS (GIOI_TINH 1/2/3) kèm ValueSet tương ứng và ConceptMap CMVNGenderToAdministrativeGender.
  • Extensions: thêm VNCoreExtOtherFundBreakdown (T_NGUONKHAC_* theo dòng chi phí), VNCoreExtGestationalAge (TUOI_THAI 1–42 tuần), VNCoreExtAnesthesiaMethod; bổ sung sub-extension paymentCeiling (T_TRANTT — trần thanh toán theo NĐ 188/2025/NĐ-CP) vào VNCoreExtInsuranceCostInfo, totalInsuranceFeeForService (T_BHTT_GDV) vào VNCoreExtClaimCostSummary, và 3 sub-extension tiền BHYT per-line servicePaymentRatio (TYLE_TT_DV), insuranceUnitPrice (DON_GIA_BH), insuranceLineAmount (THANH_TIEN_BH) vào VNCoreExtInsuranceCostInfo.
  • Validation & round-trip: 3 invariant công thức tài chính (bhyt-xml1-bhtt-formula, bhyt-xml1-so-ngay-dtri-formula, bhyt-xml10-so-ngay-formula); sửa 2 adapter rule EXPORT-005/006 thiếu thừa số tỷ lệ, thêm 4 rule EXPORT-031..034 (định danh phân bổ quỹ per-line và cấp hồ sơ); exporter round-trip xuất GIOI_TINH/GIOI_TINH_CON theo mã 1/2/3 (trước đây rò rỉ enum FHIR male/female), bổ sung seed + adapter rules cho XML13/14/15.
  • Examples: sửa ExampleClaimBHYT tách dòng thuốc ngoài danh mục (Parecoxib 1.770.000đ, PHAM_VI = 2) để T_TONGCHI_BH thỏa công thức Bảng 1 STT 51; thêm cặp ví dụ ngoại trú ExampleClaimOutpatient ↔ ExampleClaimResponsePartialDeny minh họa đề nghị ex-ante và kết quả giám định ex-post (từ chối một phần — thuốc ngoài danh mục); chuẩn lại costSummary ExampleClaimMultiService.
  • Số liệu phát hành của bản này lưu tại governance/release-metrics/0.6.1.json (bản đã rút lại — số liệu đang áp dụng xem mục 0.7.0 ở trên).

Phiên bản 0.6.0 — Bản nháp để cộng đồng rà soát (2026-06-04)

Trạng thái: Bản phát hành lịch sử — bản phát hành phụ trên nền 0.5.3 (số liệu theo release metrics v0.6.0). Chưa đổi canonical URL/package id.

Thêm mới — Quản lý chăm sóc (care management)

  • VNCoreCarePlan, VNCoreCareTeam, VNCoreGoal, VNCoreEpisodeOfCare, VNCoreClinicalImpression — bộ profile quản lý chăm sóc/điều trị (TT 13/2025/TT-BYT), khép bộ ba CarePlan → Goal → CareTeam.
  • VNCoreMedicationStatement, VNCoreMedicationAdministration — tiền sử dùng thuốc + cho dùng thuốc nội trú, khép chuỗi kê đơn → cấp phát → sử dụng.
  • VNCoreObservationTriageAcuity + VNTriageAcuityCS/VNTriageAcuityVS — thang phân loại ưu tiên cấp cứu 5 mức (thang đề xuất nội bộ tham chiếu ATS; QĐ 01/2008/QĐ-BYT làm căn cứ nguyên tắc ưu tiên — xem ADR-0014). Thêm VNValidationRuleCS, VNPrescriptionCodeNS.

Thêm mới — KSK liên thông (Structured Data Capture)

  • VNCoreQuestionnaire + VNCoreQuestionnaireResponse (HL7 SDC) + 17 mẫu phiếu VNKSKQuestionnaire01–17 theo QĐ 1551/QĐ-BYT Phụ lục 01 (linkId = mã trường). Xem ADR-0015.
  • VNCoreFamilyMemberHistory — tiền sử gia đình (mục III.A phiếu KSK).

Thêm mới — Tương tác quốc tế (IPS profile kép)

  • VNCoreCompositionIPS (kế thừa Composition-uv-ips) + thao tác $summary (vn-generate-ips-summary, chuyển chiếu Sổ SKĐT nội địa → IPS Bundle). Phụ thuộc hl7.fhir.uv.ips#2.0.1; cầu thuật ngữ SNOMED CT qua VNSNOMEDSubsetCS. Xem ADR-0016.

Thay đổi — Tuân thủ và tập căn cứ

  • VNCoreServer khai báo thêm 8 tài nguyên (EpisodeOfCare, CarePlan, CareTeam, Goal, ClinicalImpression, MedicationStatement, MedicationDispense, MedicationAdministration) + $summary.
  • VNLegalDocumentRefCS: + QĐ 2919/QĐ-BYT (chuẩn dữ liệu Giấy chứng sinh, tách Bảng 9 khỏi chuỗi QĐ 130/QĐ-BYT → 4750 → 3176) → 132 concept; danh mục pháp lý công khai phản chiếu đủ 132 mục có nguồn đối chiếu; độ phủ trích dẫn pháp lý có tác động kỹ thuật 83/83 (100%).
  • Số liệu (sau gia cố): profiles 52→73, CodeSystems 75→139, ValueSets 81→144, extensions 48 (gồm 45 cục bộ + 3 HL7), NamingSystems 25→32, ConceptMaps 5→6.

Gia cố — độ chín SDC/IPS/SNOMED (rà soát độc lập)

  • KSK = HL7 SDC thật: dependency hl7.fhir.uv.sdc#4.0.0; profile dẫn xuất sdc-questionnaire/sdc-questionnaireresponse; formal-hoá toàn bộ 5.523 answer code (285 hệ ad-hoc → 56 CodeSystem chính thức theo QĐ 1551/QĐ-BYT), 707 trường → answerValueSet, thêm required, 17 Questionnaire khai báo artifact-versionAlgorithm=semver. Xem ADR-0015.
  • IPS đầu-cuối: VNCoreBundleIPS (type=document) + ví dụ document Bundle hợp lệ + hợp đồng $summary. Xem ADR-0016.
  • Cầu SNOMED: ConceptMap ICD-10 VN → SNOMED CT.
  • Số liệu sau gia cố: profiles 73, CodeSystems 139, ValueSets 144, ConceptMaps 6.

Phiên bản 0.5.3 — Bản vá nháp để cộng đồng rà soát (2026-05-30)

Trạng thái: Bản vá trước đó — bổ sung thuộc phạm vi lõi trên nền 0.5.2

Ảnh chụp phát hành

  • 52 hồ sơ, 45 phần mở rộng cục bộ + 3 chuẩn HL7, 75 CodeSystems, 81 ValueSets, 5 ConceptMaps
  • 19 SearchParameters, 25 NamingSystems, 13 mô hình logic, 3 OperationDefinitions, 5 CapabilityStatements
  • 157 tệp ví dụ / 159 thực thể ví dụ, 302 thực thể tổng, 496 artifact JSON xuất ra
  • VNLegalDocumentRefCS mở rộng lên 117 concept (danh mục máy đọc); danh mục công khai giai đoạn v0.5 có 101 mục nguồn TVPL khớp chính xác; trạng thái công khai hiện hành của v0.6.0 là 132 nguồn; độ phủ trích dẫn pháp lý có tác động kỹ thuật đạt 74/74 văn bản kỹ thuật trực tiếp (100%)

Nội dung bản vá

  • Thêm TT-30-2024 (TT 30/2024/TT-BYT — danh mục kỹ thuật, dịch vụ y tế cơ bản tại Trạm Y tế xã/phường) vào VNLegalDocumentRefCS, đưa danh mục máy đọc từ 116 → 117 mục và độ phủ có tác động kỹ thuật 73/73 → 74/74.
  • Bổ sung VNBasicHealthServiceCS (74 concept lồng nhau) và VNBasicHealthServiceVS — danh mục dịch vụ y tế cơ bản tuyến xã theo TT 30/2024/TT-BYT, phục vụ IG phái sinh chăm sóc sức khỏe ban đầu (CHC).
  • Bổ sung VNServiceDeliverySettingCS (6 mã) và VNServiceDeliverySettingVS — phân loại bối cảnh cung cấp dịch vụ (tại trạm, tại nhà, lưu động, trường học…).
  • Bổ sung vòng đời mã cơ sở trên VNCoreOrganization: extension VNCoreExtOrgLifecycleRelation cùng VNOrgLifecycleRelationCS (4 mã) và VNOrgCarryOverItemCS (5 mã), thêm identifier.period và ví dụ ExampleOrganizationMergedStation — mô hình hóa sáp nhập/chia tách/đổi mã cơ sở KCB theo NQ 202/2025/QH15 và NĐ 102/2025/NĐ-CP.
  • Đồng bộ bề mặt quản trị (release-manifest, roadmap, release-metrics 0.5.3, content-facts, wiki inventory, legal-corpus, package-architecture) theo 0.5.3.

Tác động nâng cấp

  • Không đổi canonical URL, package id hoặc ngữ nghĩa lõi của Patient, Encounter, Condition, Observation.
  • Bản vá thuần bổ sung: bên triển khai đang dùng 0.5.2 chỉ cần làm mới package/download artifact; không có chuyển đổi dữ liệu bắt buộc.
  • Toàn bộ 10 artifact thuộc phạm vi lõi mới (4 CodeSystems + 4 ValueSets + 1 extension + 1 ví dụ) nằm trong hl7.fhir.vn.core.base; các gói mô-đun phái sinh (bhyt, terminology.clinical, traditional-medicine, device) không đổi số lượng.
  • VNCoreExtOrgLifecycleRelation và terminology kèm theo là phần mở rộng tùy chọn (0..*), không phá vỡ instance Organization hiện hành.

Phiên bản 0.5.2 — Bản vá nháp để cộng đồng rà soát (2026-05-29)

Trạng thái: Lịch sử — bản vá bổ sung tập căn cứ pháp lý trên nền 0.5.1

Ảnh chụp phát hành

  • 52 hồ sơ, 44 phần mở rộng cục bộ + 3 chuẩn HL7, 71 CodeSystems, 77 ValueSets, 5 ConceptMaps
  • 19 SearchParameters, 25 NamingSystems, 13 mô hình logic, 3 OperationDefinitions, 5 CapabilityStatements
  • 156 tệp ví dụ / 158 thực thể ví dụ, 301 thực thể tổng, 486 artifact JSON xuất ra
  • VNLegalDocumentRefCS mở rộng lên 116 concept (danh mục máy đọc); danh mục công khai giai đoạn v0.5 có 101 mục nguồn TVPL khớp chính xác; trạng thái công khai hiện hành của v0.6.0 là 132 nguồn; độ phủ trích dẫn pháp lý có tác động kỹ thuật giữ 73/73 văn bản kỹ thuật trực tiếp (100%)

Nội dung bản vá

  • Mở rộng VNLegalDocumentRefCS lên 116 concept: thêm Luật Dân số 113/2025/QH15 (future-effective 01/07/2026), TT 11/2026/TT-BYT, nhóm QĐ triển khai EMR/Sổ sức khỏe điện tử (QĐ 31/QĐ-BYT, QĐ 586/QĐ-BYT, QĐ 965/QĐ-BYT), cặp thay thế dự kiến chi BHYT (QĐ 582/QĐ-BYT thay QĐ 32/QĐ-BYT) và TTHC KCB (QĐ 966/QĐ-BYT thay QĐ 658/QĐ-BYT), quy trình kỹ thuật (QĐ 486/QĐ-BYT YHCT, QĐ 622/QĐ-BYT điện quang) và các VBHN hợp nhất.
  • Thêm VNFetalSexDisclosureDiseaseVS — 137 dòng STT / 136 mã ICD-10 duy nhất danh mục bệnh được phép tiết lộ giới tính thai nhi theo khoản 3 Điều 6 Luật Dân số 113/2025 và Danh mục TT 11/2026/TT-BYT, gắn căn cứ pháp lý qua VNCoreExtLegalBasis.
  • Bổ sung bộ ba bằng chứng trạng thái (statusReviewedAt/statusEvidenceUrl/statusEvidenceNote) cho QĐ 4905/QĐ-BYT và QĐ 5937/QĐ-BYT; làm rõ relationshipNote của QĐ 486/QĐ-BYT (quy trình kỹ thuật YHCT).
  • Đồng bộ bề mặt quản trị (release-manifest, roadmap, release-metrics, content-facts, wiki inventory, legal-corpus) theo 0.5.2.

Tác động nâng cấp

  • Không đổi canonical URL, package id hoặc ngữ nghĩa lõi của Patient, Encounter, Condition, Observation.
  • Bản vá thuần bổ sung: bên triển khai đang dùng 0.5.1 chỉ cần làm mới package/download artifact; không có chuyển đổi dữ liệu bắt buộc.
  • VNFetalSexDisclosureDiseaseVS là terminology công bố độc lập (chưa bind vào element profile), dùng để tham chiếu và ràng buộc theo nhu cầu triển khai.

Phiên bản 0.5.1 — Bản vá nháp để cộng đồng rà soát (2026-05-10)

Trạng thái: Lịch sử — bản vá đồng bộ/quản trị trên nền 0.5.0

Ảnh chụp phát hành

  • 52 hồ sơ, 44 phần mở rộng cục bộ + 3 chuẩn HL7, 71 CodeSystems, 76 ValueSets, 5 ConceptMaps
  • 19 SearchParameters, 25 NamingSystems, 13 mô hình logic, 3 OperationDefinitions, 5 CapabilityStatements
  • 131 tệp ví dụ / 158 thực thể ví dụ, 298 thực thể tổng, 480 artifact JSON xuất ra
  • VNLegalDocumentRefCS giữ danh mục pháp lý v0.5 với 101 mục có cấu trúc; độ phủ trích dẫn pháp lý có tác động kỹ thuật đạt 72/72 văn bản kỹ thuật trực tiếp (100%)

Nội dung bản vá

  • Đồng bộ VERSION, sushi-config.yaml, publication-request.json, publication/package-list.json, tách gói, bề mặt tải xuống, lộ trình, tin tức và wiki theo 0.5.1.
  • Bổ sung quản trị manifests (release-manifest, roadmap) làm nguồn chuẩn cho các tệp tiêu thụ.
  • Bổ sung chốt kiểm soát và kiểm tra inventory wiki để giảm lệch khi nâng phiên bản.
  • Chuyển nhóm trích dẫn pháp lý còn thiếu để độ phủ kỹ thuật trực tiếp không còn mục có tác động kỹ thuật bị thiếu liên kết.
  • Bổ sung hoặc công khai các ví dụ cho PaymentReconciliation, EndpointBHYT, HealthcareService tuyến xã và thông báo vi phạm dữ liệu.

Tác động nâng cấp

  • Không đổi canonical URL, package id hoặc ngữ nghĩa lõi của Patient, Encounter, Condition, Observation.
  • Bên triển khai đang dùng 0.5.0 chỉ cần làm mới package/download artifact và đọc lại changelog; không có chuyển đổi dữ liệu bắt buộc.
  • Bên triển khai đang dùng 0.4.0 nên đọc cả mục 0.5.0 bên dưới vì các thay đổi bổ sung/gia cố chính nằm ở bản đó.

Phiên bản 0.5.0 — Bản nháp để cộng đồng rà soát (2026-05-01)

Trạng thái: Lịch sử — căn cứ pháp lý có cấu trúc, gia cố thiết bị/BHYT và mức sẵn sàng thí điểm

Ảnh chụp phát hành

  • 52 hồ sơ, 44 phần mở rộng cục bộ + 3 chuẩn HL7, 70 CodeSystems, 75 ValueSets, 5 ConceptMaps
  • 19 SearchParameters, 22 NamingSystems, 13 mô hình logic, 3 OperationDefinitions, 5 CapabilityStatements
  • 152 tệp ví dụ / 154 thực thể ví dụ, 294 thực thể tổng, 476 artifact JSON xuất ra
  • VNLegalDocumentRefCS công bố danh mục pháp lý v0.5 với 101 mục có cấu trúc theo 18 miền công khai, kèm trạng thái hiệu lực và quan hệ thay thế

Căn cứ pháp lý có cấu trúc

  • Thêm VNLegalDocumentRefCS và VNLegalDocumentRefVS làm danh mục pháp lý máy đọc được.
  • Thêm VNCoreExtLegalBasis để gắn căn cứ pháp lý ở mức artifact hoặc element.
  • Thêm công cụ kiểm toán trích dẫn: kiểm tra future-effective, văn bản đã bị thay thế, trích dẫn chỉ nằm inline và độ phủ theo artifact.
  • Mở rộng tập căn cứ pháp lý giai đoạn v0.5 lên 101 mục, bao gồm nhóm pháp lý 2026 như VBHN 04/06/08, TT 12/2026/TT-BTC/BTC, NĐ 233/2025/NĐ-CP và các luật/văn bản mới liên quan dữ liệu, an ninh mạng, phòng bệnh và y tế cơ sở.

Profiles mới hoặc được bề mặt công khai trong v0.5

  • VNCorePaymentReconciliation — quyết toán/thanh toán BHYT theo chu kỳ và biên bản 06/BH, dùng claimAuditStatus để biểu diễn vòng đời giám định nội địa.
  • VNCoreEndpointBHYT — endpoint cổng gdbhyt cho lớp gateway/facade BHYT.
  • VNCoreHealthcareService — dịch vụ y tế, đặc biệt cho TYT cấp xã/phường/đặc khu sau mô hình chính quyền 2 cấp.
  • VNCoreCompositionBreachNotification — Composition có cấu trúc cho Mẫu 08 NĐ 356/2025/NĐ-CP về thông báo vi phạm DLCN.

Gia cố cụm thiết bị

  • Thêm VNCoreExtDeviceRegistrationNumber và VNMedicalDeviceRegistrationNumberNS cho số lưu hành TBYT.
  • Gia cố VNCoreImplantableDevice: risk class, số lưu hành, UDI carrier và vòng đời được nâng mức kỳ vọng cho thiết bị cấy ghép C/D.
  • Bổ sung ví dụ thiết bị class A/B/C: ExampleDeviceVTYTN03Syringe, ExampleDeviceVTYTClassBThermometer, ExampleDeviceImplantDentalClassC.
  • Giữ danh pháp thiết bị trong package .device; Core không hard-bind Device.type vào một danh mục duy nhất khi quản trị danh pháp chưa ổn định.

Tác động nâng cấp

  • Bản 0.5.0 là bản phát hành bổ sung/gia cố: không đổi canonical URL, không đổi package id, không thay thế ngữ nghĩa lõi của Patient, Encounter, Condition, Observation.
  • Bên triển khai đang dùng 0.4.0 nên ưu tiên rà lại device identifiers, legal citation, BHYT reconciliation/gateway boundary và privacy incident/audit policy trước khi thí điểm.

Phiên bản 0.4.0 — Wave 2 (2026-04-14)

Trạng thái: Bản nháp để cộng đồng rà soát — bổ sung lớp CĐHA, Dược, Thiết bị và Khoa phòng

Ảnh chụp phát hành

  • 48 hồ sơ (thêm 7), 34 phần mở rộng cục bộ + 3 chuẩn HL7, 64 CodeSystems, 69 ValueSets, 4 ConceptMaps
  • 145 tệp ví dụ / 146 thực thể ví dụ, 274 thực thể tổng trong chỉ số phát hành; sushi . import 274 FSH instances

Profiles mới (7)

  • VNCoreOrganizationDepartment — Khoa/Phòng theo QĐ 2010/QĐ-BYT (19/6/2025) Phụ lục 6; identifier slicing departmentCode (K01-K53, K99) + localCode; type fixed dept; partOf bắt buộc tham chiếu CSYT chủ quản
  • VNCoreMedicationDispense — Cấp phát thuốc, liên thông BHYT chain qua authorizingPrescription → VNCoreMedicationRequest
  • VNCoreImagingStudy — Nghiên cứu CĐHA (DICOM StudyInstanceUID); procedureCode/reasonCode/bodySite bindings cho ICD-10 VN + SNOMED CT VN Body Structure
  • VNCoreDiagnosticReportLab, VNCoreDiagnosticReportImaging, VNCoreDiagnosticReportPathology — 3 sub-profiles kế thừa VNCoreDiagnosticReport theo pattern parent-child kiểu JP Core; category slice theo coding.code (LAB/RAD/PAT) + nhóm chi phí BHYT (QĐ 697 nhóm 3/4)
  • VNCoreImplantableDevice — Thiết bị cấy ghép patient-bound theo pattern US Core; patient/type/status 1..1, UDI/vòng đời/safety MS, không hard mandate UDI toàn Core

Refactor trọng tâm

  • VNCoreDevice: nâng từ 2 MS → 12+ MS với identifier slicing (medicalDeviceItemCode, serialNumber), UDI carrier theo FHIR base, full vòng đời (manufactureDate/expirationDate/lotNumber/serialNumber/modelNumber), extension VNCoreExtDeviceGroup phương án dự phòng và VNCoreExtDeviceRiskClass optional; dữ liệu thanh toán TBYT ưu tiên ở Claim.item; type được relax về 0..1 MS để không reject dữ liệu legacy/BHYT thiếu danh pháp chuẩn
  • VNCoreProcedure: bổ sung focalDevice Must Support cho thủ thuật đặt/tháo/thay/điều chỉnh thiết bị; example PCI đặt stent và tháo lưới lọc tĩnh mạch chủ dùng Procedure.focalDevice, còn theo dõi đang sử dụng dùng DeviceUseStatement
  • VNCoreDiagnosticReport: trở thành parent profile với category slicing open on coding.code; result relax xuống Observation base để children re-tighten
  • ExampleDeviceImplant đổi sang VNCoreImplantableDevice cho Stent mạch vành (SCT 360046005) + deviceGroup N06.00.000, có patient/vòng đời/UDI HRF; bổ sung ExampleDeviceImplantIVCFilter và ExampleProcedureIVCFilterRemoval cho ca explant hợp lý về mặt lâm sàng

Extensions mới (2)

  • VNCoreExtDeviceGroup — Nhóm thiết bị y tế theo danh mục BHYT (N01-N09); Context: Claim.item ưu tiên và Device legacy/phương án dự phòng; binding extensible VNDeviceGroupVS
  • VNCoreExtDeviceRiskClass — Phân loại rủi ro A/B/C/D theo NĐ 98/2021/NĐ-CP Điều 4 và TT 05/2022/TT-BYT; optional trên Device, không thay nhóm BHYT hoặc Device.type

Terminology mới và cập nhật

  • VNDeviceGroupCS + VNDeviceGroupVS — 9 codes N01.00.000..N09.00.000 theo TT 04/2017/TT-BYT Phụ lục 01 + TT 24/2025/TT-BYT (đổi thuật ngữ VTYT → TBYT) + VBHN 14/VBHN-BYT
  • VNDeviceRiskClassCS + VNDeviceRiskClassVS — 4 codes A..D theo NĐ 98/2021/NĐ-CP Điều 4; dùng cho risk class optional, không dùng làm danh pháp thiết bị
  • VNMedicalDeviceNomenclatureCS + VNMedicalDeviceNomenclatureVS + VNDeviceTypeVS — 956 concept danh pháp thiết bị trong package hl7.fhir.vn.device, tổng hợp QĐ-3107/QĐ-BYT-2024 và QĐ-847/QĐ-BYT-2025 theo provenance concept-level; Core không required-bind Device.type
  • VNExaminationCodeCS — fragment 2 mã khám bệnh dùng cho positive seed XML3, có provenance từ Phụ lục 2 QĐ 2010/QĐ-BYT; hiện cover 02.05 cho Nội tiêu hóa và 10.22 cho Ngoại tiêu hóa, còn 2 row consultation/care chưa đủ sạch vẫn giữ ở catalog ví dụ cục bộ riêng.
  • VNBedDayCodeCS — fragment 2 mã ngày giường dùng cho positive seed XML3, có provenance từ Phụ lục 3 QĐ 2010/QĐ-BYT; hiện cover K22.NG1 và K48.HSTC, trong khi 2 row consultation/care chưa đủ sạch vẫn giữ ở catalog ví dụ cục bộ riêng.
  • VNBHYTFinancialFieldCS + VNBHYTFinancialFieldVS — 14 trường tổng tiền BHYT (T_TONGCHI, T_BHTT, T_BNCCT, T_BNTT, T_NGUONKHAC*, T_NGOAIDS, T_THUOC, T_VTYT) làm source truy vết cho cost summary/adjudication.
  • VNBHYTAdjudicationCategoryCS + VNBHYTAdjudicationCategoryVS — 5 category cục bộ (patient-self-pay, other-fund, non-covered, medication-subtotal, supplies-subtotal) để bổ sung HL7 adjudication ở ClaimResponse.total/EOB.total.
  • ConceptMap/vn-cm-bhyt-financial-field-to-adjudication — ánh xạ trường tổng tiền BHYT sang HL7 adjudication và category cục bộ; không encode công thức quyền lợi hoặc catalog lý do từ chối của bên thanh toán.
  • VNMorphologyVS — Subset SNOMED CT filter concept is-a #49755003 (Morphologically abnormal structure) theo QĐ 2493/QĐ-BYT (08/2025) ~5.155 codes; dùng cho VNCoreDiagnosticReportPathology.conclusionCode extensible binding
  • VNDepartmentCS: 51 → 54 codes (thêm K51 Đột quỵ, K52 Phẫu thuật tạo hình thẩm mỹ, K53 Nam học) theo QĐ 2010/QĐ-BYT Phụ lục 6 (tiền nhiệm QĐ 5937/QĐ-BYT bị bãi bỏ phần Phụ lục 5)

Cơ sở pháp lý bổ sung

  • Thiết bị y tế: TT 04/2017/TT-BYT Phụ lục 01, TT 24/2025/TT-BYT (30/6/2025, HL 01/9/2025), VBHN 14/VBHN-BYT
  • Khoa/Phòng: QĐ 2010/QĐ-BYT (19/6/2025) Phụ lục 6, QĐ 3176/QĐ-BYT (MA_KHOA trong XML đầu ra KCB)
  • Dược: Luật 105/2016/QH13 Điều 74 (sửa đổi bởi Luật 44/2024/QH15 Điều 1 khoản 36), NĐ 163/2025/NĐ-CP (29/6/2025, thay NĐ 54/2017/NĐ-CP từ 01/7/2025), TT 26/2025/TT-BYT (Điều 5/10/12 — đơn điện tử, liên thông Hệ thống đơn thuốc QG), TT 27/2025/TT-BYT (thuốc YHCT BHYT)
  • Danh mục kỹ thuật và CĐHA/GPB: QĐ 1227/QĐ-BYT (11/4/2025) — 2.964 mã CLS 5 nhóm (HH-TM 1.022, Hóa sinh 447, Vi sinh 174, GPB 81, Điện quang 1.240); TT 23/2024/TT-BYT (thay TT 43/2013/TT-BYT từ 18/10/2024); TT 38/2024/TT-BYT — Hệ thống thông tin KCB; QĐ 697/QĐ-BYT (19/3/2026) — 12 nhóm chi phí; QĐ 2427/QĐ-BYT + QĐ 2493/QĐ-BYT — SNOMED CT VN Body Structure + Morphology; QĐ 3148/QĐ-BYT (2017) — liên thông công nhận KQXN

Văn bản đánh dấu legacy / hết hiệu lực

  • NĐ 54/2017/NĐ-CP — hết hiệu lực 01/7/2025 (thay bởi NĐ 163/2025/NĐ-CP Điều 129)
  • TT 43/2013/TT-BYT — hết hiệu lực 18/10/2024 (thay bởi TT 23/2024/TT-BYT); chapter ánh xạ chính xác cho backward audit: Ch. XVIII = CĐHA, Ch. XXI = TDCN, Ch. XXIV = Vi sinh, Ch. XXV = GPB

Quản trị thiết kế (Design Decisions v0.4)

  • DD-v04-05 — DiagnosticReport sub-profiles (pattern parent-child)
  • DD-v04-06 — Device refactor (identifier slicing + UDI + deviceGroup)
  • DD-v04-07 — Missing Profiles (OrgDept + MedDispense + ImagingStudy)
  • ADR-0005 — VNCoreDevice.type 0..1 MS, chưa ràng buộc mức required danh pháp thiết bị
  • ADR-0007 — thêm VNCoreImplantableDevice patient-bound
  • wave2-legal-consolidated — tổng hợp 3 Codex legal rà soát chéo (nguồn: governance/v0.4-decisions/)

Phiên bản 0.3.0 — Bản ổn định trước thí điểm (03/2026)

Trạng thái: Bản nháp để cộng đồng rà soát — bản lịch sử trước Wave 2

Ảnh chụp phát hành

  • 32 hồ sơ, 27 phần mở rộng cục bộ + 3 phần mở rộng Patient chuẩn HL7, 52 CodeSystems, 54 ValueSets
  • 14 SearchParameters, 19 NamingSystems, 13 mô hình logic, 3 OperationDefinitions
  • 122 tệp ví dụ / 123 thực thể ví dụ
  • 232 thực thể / 345 tài nguyên JSON xuất ra sau sushi .

Tài nguyên mới hoặc bổ sung trọng tâm

  • Profiles: VNCoreBundle, VNCoreBHYTSubmissionBundle, VNCoreConsent, VNCoreComposition, VNCoreAuditEvent, VNCoreProvenance, VNCoreRelatedPerson
  • Gia cố lớp hành chính: thêm VNCoreLocation để tách khoa/phòng/địa điểm cung cấp dịch vụ khỏi Organization
  • Gia cố quy trình xét nghiệm: thêm VNCoreSpecimen, nối chuỗi ServiceRequest -> Specimen -> ObservationLab -> DiagnosticReport, bổ sung ví dụ mẫu huyết thanh, máu toàn phần, nước tiểu và tình huống xét nghiệm đầu-cuối
  • Hướng dẫn Must Support: thêm trang must-support-guidance.md, chốt cách diễn giải Must Support, bảng xử lý thiếu dữ liệu và cẩm nang HIS -> FHIR cho bệnh nhân, lượt khám, tài liệu, BHYT và hồ sơ thanh toán
  • Ma trận pháp lý theo miền: thêm mục Ma trận pháp lý theo hồ sơ trong legal-basis.md, tách lớp căn cứ hiện hành / lịch sử / quyết định thiết kế cho 4 nhóm hồ sơ chính: Patient/RelatedPerson, Practitioner/Organization/Location, tài liệu lâm sàng và lớp liên thông hồ sơ BHYT (BHYT Submission)
  • Kiến trúc gói phát hành: thêm trang package-architecture.md, chốt mô hình 4 gói mô-đun (core.base, bhyt.submission, terminology.clinical, terminology.traditional-medicine) và 1 gói tổng hợp
  • Tách gói phát hành: mở rộng cơ chế build để sinh hl7.fhir.vn.core, hl7.fhir.vn.core.base, hl7.fhir.vn.bhyt.submission, hl7.fhir.vn.terminology.clinical và hl7.fhir.vn.terminology.traditional-medicine từ cùng một kho mã nguồn biên soạn
  • Hồ sơ công bố mô-đun: bổ sung package-list.json, history.html, và trang đích công bố tối thiểu cho từng gói mô-đun ngay trong cùng website fhir.hl7.org.vn/core
  • Gia cố template phát hành: chuyển nền HTML build từ fhir.base.template sang fhir2.base.template theo thông báo bảo mật ngày 17/03/2026 của FHIR Foundation, loại bỏ phụ thuộc vào template cũ đã ngừng hỗ trợ
  • Chuẩn hóa Patient: VNCorePatient chuyển sang dùng các extension chuẩn patient-religion, patient-citizenship, patient-birthPlace; thêm các lát cắt BHXH, GKS, HC và contact cho luồng người giám hộ
  • Chuẩn hóa Coverage: thêm subscriber, relationship, invariant kiểm tra subscriberId khớp identifier[BHYT], và đưa Coverage.type về ngữ nghĩa chuẩn FHIR medical thay vì dùng cho NGUON_CTRA
  • Liên thông tôn giáo: thêm ConceptMap vn-cm-religion-to-v3-religious-affiliation và ví dụ mã kép cho patient-religion ở các trường hợp có ánh xạ 1-1
  • Gia cố Consent: thêm invariant yêu cầu provision.period.end khi đã khai báo consent có thời hạn
  • SearchParameters: vn-ma-lk, vn-ma-luot-kcb, vn-ma-dkbd, vn-bhxh, vn-gks, vn-gphn, cùng artifact lịch sử vn-vneid ở trạng thái retired
  • NamingSystems: thêm VNeID (integration-only / retired), GKS, GPHN, VNMaLuotKCB, mã phản hồi gateway BHYT, cùng các hệ CMND/BHXH/Hộ chiếu/Mã vật tư
  • Gia cố định danh Encounter: vn-ext-encounter-code chuyển từ string sang Identifier, gắn system riêng cho MA_LUOT_KCB và đổi vn-sp-encounter-ma-luot-kcb sang token để tìm kiếm nhất quán hơn trong gateway và validator
  • Ví dụ bệnh nhân nước ngoài dùng hộ chiếu: thêm ExamplePatientForeignPassport để minh họa bệnh nhân người nước ngoài dùng identifier[HC], giữ lát cắt CCCD với data-absent-reason, và không lạm dụng forceMajeureReason
  • Artifact gateway layer: Check-in + các logical model BHYT XML 1-12, $validate-bhyt-claim, $submit-bhyt-claim, $reverse-bhyt-claim
  • Gia cố ánh xạ BHYT: thêm chú thích ánh xạ nội tuyến cho toàn bộ logical model Check-in + XML1-12, chốt nguồn FHIR cho từng trường và tách rõ trường gốc với trường suy ra để xuất dữ liệu
  • Làm dày XML2 thuốc BHYT: thêm VNCoreExtPaymentSource cho NGUON_CTRA, sửa đúng ngữ nghĩa VNPaymentSourceCS theo QĐ 130/QĐ-BYT/QĐ 3176/QĐ-BYT (1 BHYT, 2 dự án/viện trợ, 3 chương trình mục tiêu quốc gia, 4 nguồn khác), và kéo thêm SO_DANG_KY/NGAY_YL vào round-trip/report từ carrier thuốc thực tế
  • Tự động hóa quản trị: thêm script kiểm tra mức bảo mật cơ sở, ảnh chụp/diff thuật ngữ và chuyển đổi khứ hồi BHYT JSON/XML
  • Hỗ trợ kiểm tra số định danh cá nhân: thêm VNCitizenIdBirthplacePrefixCS/VS, đóng gói bộ thuật ngữ hỗ trợ kiểm tra 3 số đầu CCCD và đưa TT 17/2024/TT-BCA vào tài liệu tham chiếu pháp lý
  • Báo cáo chuyển đổi khứ hồi: sinh thêm output/bhyt-roundtrip/README.md và output/bhyt-roundtrip/index.html để rà soát độ bao phủ theo bundle/bảng XML
  • Độ bao phủ bộ dữ liệu kiểm thử BHYT: bổ sung bundle dương tính HIV/AIDS và tử vong, làm giàu bundle nội trú và trẻ sơ sinh để round-trip mapper phủ thực tế xml4-12
  • Báo cáo triển khai: thêm trang implementation-reports.md để chuẩn hóa báo cáo thí điểm/ballot
  • Organization/Location legal alignment: tách riêng organizationRank, healthUnitRank, organizationRankStatus, facilityCareLevel, và legacyTechnicalLine; bổ sung trang organization-location-governance.md
  • YHCT terminology ngữ nghĩa: chuẩn hóa CodeSystem.property.uri cho toàn bộ 10 CodeSystem YHCT, giữ nguyên mã pháp lý nhưng làm rõ ngữ nghĩa property trong hệ sinh thái terminology và loại bỏ toàn bộ thông báo QA kiểu “property has only a code and not a URI”
  • Chiến lược biên soạn bộ mã lớn: chuyển các CodeSystem quy mô lớn như VNCLSCS, VNWardCS, VNOCCS và toàn bộ 10 CodeSystem Y học cổ truyền sang tài nguyên FHIR JSON sinh sẵn từ dữ liệu nguồn máy đọc được hoặc phụ lục pháp lý, giúp SUSHI ổn định và giữ nguyên provenance pháp lý
  • Tái cấu trúc định danh người hành nghề: chuyển VNCorePractitioner sang mô hình GPHN hiện hành / CCHN lịch sử, thêm NamingSystem VNGPHN và vn-sp-practitioner-gphn, đồng thời hạ CCHN xuống lớp tương tác liên thông dữ liệu lịch sử

Điều chỉnh sau rà soát lâm sàng

  • CCCD bắt buộc: identifier[CCCD] 0..1 → 1..1 theo TT 13/2025/TT-BYT
  • security.md: Cập nhật reference VNCoreConsent (thay thế interim guidance)
  • VNProvinceCS: Ghi rõ ^count = 63 (34 active + 29 deprecated)
  • Ví dụ Coverage: Dùng type có mã hóa thay vì chỉ dùng văn bản
  • Guardian modeling: thêm VNCoreRelatedPerson + example mẹ của bệnh nhi; tách riêng example quyền lợi BHYT cấp trực tiếp cho trẻ và example coverage liên kết người đại diện
  • Consent trẻ em: bổ sung thuật ngữ parental-proxy/guardian-consent và ví dụ ExampleConsentParentalProxy dùng RelatedPerson làm người thực hiện đồng ý

Hạ tầng

  • Cloudflare Worker: ghi đè đường dẫn URL (không chuyển hướng) cho canonical FHIR URL
  • Định tuyến theo mẫu: tự nhận diện tất cả resource type
  • Bộ xử lý /core/*: package-list.json, qa.html được phục vụ đúng qua /core/
  • CI: Node.js 22 + runtime Node.js 24 bật theo lựa chọn
  • FHIR auto-ig-builder GitHub App cài đặt

Phiên bản 0.1.0 — Bản dự thảo đầu tiên (03/2026)

Trạng thái: Draft

Profiles (23)

  • VNCorePatient — Bệnh nhân Việt Nam (CCCD, tên tiếng Việt, dân tộc, tôn giáo, nghề nghiệp, địa chỉ 2 cấp)
  • VNCorePractitioner — Nhân viên y tế (CCHN, học vị)
  • VNCorePractitionerRole — Vai trò nhân viên y tế (chức danh V.08, chuyên khoa)
  • VNCoreOrganization — Cơ sở KCB (hạng BV, tuyến, loại hình)
  • VNCoreAddress — Địa chỉ Việt Nam (tỉnh + xã, backward-compatible huyện)
  • VNCoreEncounter — Lượt khám/điều trị (loại KCB BHYT, kết quả điều trị)
  • VNCoreCondition — Chẩn đoán (ICD-10 VN + YHCT)
  • VNCoreObservationLab — Kết quả xét nghiệm (LOINC VN)
  • VNCoreObservationVitalSigns — Sinh hiệu
  • VNCoreObservationYHCT — Quan sát YHCT (lưỡi, mạch, triệu chứng)
  • VNCoreAllergyIntolerance — Dị ứng (SNOMED CT VN)
  • VNCoreProcedure — Thủ thuật/phẫu thuật (ICD-9-CM)
  • VNCoreMedicationRequest — Đơn thuốc điện tử (ePrescription, TT 13/2025/TT-BYT, Luật Dược 2016, QĐ 3176/QĐ-BYT)
  • VNCoreMedication — Thuốc (ATC, SNOMED CT)
  • VNCoreServiceRequest — Yêu cầu DVKT/cận lâm sàng (TT 23/2024/TT-BYT, TT 39/2018/TT-BYT, QĐ 3176/QĐ-BYT)
  • VNCoreCoverage — Thẻ BHYT (3 format: CCCD/BHXH/cũ)
  • VNCoreClaim — Yêu cầu thanh toán KCB BHYT (QĐ 3176/QĐ-BYT → QĐ 697/QĐ-BYT, 14 nhóm chi phí)
  • VNCoreClaimResponse — Phản hồi thanh toán BHYT
  • VNCoreExplanationOfBenefit — Giải trình quyền lợi BHYT
  • VNCoreDocumentReference — Tài liệu y tế (bệnh án điện tử theo TT 13/2025/TT-BYT)
  • VNCoreDiagnosticReport — Kết quả CLS (XN, CĐHA, GPB)
  • VNCoreDevice — Trang thiết bị y tế
  • VNCoreDeviceUseStatement — Sử dụng TBYT cho bệnh nhân

Extensions (20)

  • vn-ext-ethnicity — Dân tộc (54 dân tộc, 121/TCTK-PPCĐ)
  • vn-ext-religion — Tôn giáo (16 tôn giáo, CV 6955/BNV-TGCP)
  • vn-ext-occupation — Nghề nghiệp (VSCO 2020, 1.516 mã, QĐ 34/2020/QĐ-TTg)
  • vn-ext-province — Tỉnh/TP (34 đơn vị, NQ 202/2025/QH15)
  • vn-ext-ward — Xã/Phường (~3.321 đơn vị, NQ 202/2025/QH15)
  • vn-ext-bhyt-card-type — Loại đối tượng BHYT (53 mã, NĐ 146/2018/NĐ-CP)
  • vn-ext-primary-care-facility — Nơi ĐKKCB ban đầu (Luật BHYT)
  • vn-ext-insurance-visit-type — Loại KCB BHYT; attribution được đính chính ở bản sau thành danh mục legacy MA_LYDO_VVIEN của QĐ 4210/QĐ-BYT (mã 1–4; mã 5 là mở rộng dự án chờ nguồn)
  • vn-ext-treatment-outcome — Kết quả điều trị (KET_QUA_DTRI, 8 mã, QĐ 3176/QĐ-BYT)
  • vn-ext-org-rank — Hạng bệnh viện (4 hạng, TT 06/2024/TT-BYT)
  • vn-ext-org-level — Tuyến KCB
  • vn-ext-org-type — Loại hình CSKCB (8 loại, Luật KCB 2023)
  • vn-ext-claim-cost-summary — Tổng hợp chi phí Claim (QĐ 697/QĐ-BYT)
  • vn-ext-claim-item-department — Khoa chỉ định dịch vụ
  • vn-ext-claim-payment-period — Thời gian thanh toán BHYT
  • vn-ext-insurance-cost-info — Thông tin chi phí BHYT
  • vn-ext-payment-method — Phương thức thanh toán
  • vn-ext-order-date — Ngày y lệnh
  • vn-ext-med-registration-number — Số đăng ký thuốc
  • vn-ext-device-insurance-scope — Phạm vi BH trang thiết bị y tế

CodeSystems (42) và ValueSets (43)

  • 17 CodeSystem quốc gia (dân tộc, tôn giáo, ĐVHC, BHYT 53 mã, KCB, chi phí 14 mã, kết quả điều trị 8 mã, ra viện 5 mã, mã đối tượng KCB 27 mã theo QĐ 3276/QĐ-BYT, loại dịch vụ y tế 8 mã theo TT 23/2024/TT-BYT + TT 39/2018/TT-BYT, trình độ chuyên môn, v.v.)
  • 2 CodeSystem nhân viên y tế:
    • Chức danh nghề nghiệp V.08 (32 mã — TT 41/2025/TT-BYT, TT 02/2025/TT-BYT)
    • Chuyên khoa y tế (47 mã, 8 nhóm — TT 43/2013/TT-BYT DMKT 28 chuyên khoa, TT 21/2017/TT-BYT, TT 32/2023/TT-BYT Điều 11 Phụ lục V–XVII)
  • 5 CodeSystem quốc tế bản địa hóa (ICD-10 VN 15.026, ICD-9-CM 3.882, SNOMED CT VN 77.393, LOINC VN 66.077, CLS VN 2.964)
  • 10 CodeSystem Y học cổ truyền (QĐ 2552/QĐ-BYT + QĐ 3080/QĐ-BYT) — bao gồm VNYHCTDiseaseCS 228 mã (38 bệnh danh + 190 thể lâm sàng)
  • 7 CodeSystem bảo hiểm/thanh toán (chi phí, phương thức TT, phạm vi BH TBYT, loại CLS, theo QĐ 697/QĐ-BYT)
  • 1 CodeSystem nghề nghiệp VSCO (1.516 mã, 5 cấp, ISCO-08 compatible — QĐ 34/2020/QĐ-TTg)

SearchParameters (11)

  • vn-sp-patient-cccd — Tìm Patient theo CCCD (Luật Căn cước 2023)
  • vn-sp-patient-bhyt — Tìm Patient theo BHYT (Luật BHYT)
  • vn-sp-organization-cskcb — Tìm Organization theo mã CSKCB (QĐ 3176/QĐ-BYT)
  • vn-sp-practitioner-cchn — Tìm Practitioner theo CCHN (Luật KCB 2023, Điều 19-26)
  • vn-sp-coverage-bhyt — Tìm Coverage theo số thẻ BHYT (NĐ 188/2025/NĐ-CP)
  • vn-sp-encounter-malydo — Tìm Encounter theo danh mục loại KCB; attribution được đính chính ở bản sau về legacy MA_LYDO_VVIEN của QĐ 4210/QĐ-BYT
  • vn-sp-condition-icd10 — Tìm Condition theo ICD-10 (QĐ 4469/QĐ-BYT, QĐ 98/QĐ-BYT)

ConceptMaps (2)

  • vn-cm-cls-to-loinc — Ánh xạ CLS VN → LOINC (2.964 chỉ số, 100% coverage, QĐ 1227/QĐ-BYT)
  • vn-cm-religion-to-v3-religious-affiliation — Ánh xạ một phần danh mục tôn giáo Việt Nam sang v3-ReligiousAffiliation cho các trường hợp tương đương rõ về ngữ nghĩa

CapabilityStatement (5)

  • VNCoreServer — CapabilityStatement mức cơ sở cho máy chủ FHIR tuân thủ VN Core
  • VNCoreEMRServer — CapabilityStatement mức cơ sở cho EMR/EHR nội bộ
  • VNBHYTGatewayClient — CapabilityStatement mức cơ sở cho client gửi hồ sơ thanh toán BHYT
  • VNBHYTGatewayServer — CapabilityStatement mức cơ sở cho server/facade tiếp nhận hồ sơ thanh toán BHYT
  • VNCitizenAppClient — CapabilityStatement mức cơ sở cho ứng dụng người dân/VNeID connector

NamingSystems (5)

  • CCCD, BHYT, CCHN, CSKCB, MRN

Examples (33)

  • Ít nhất 1 ví dụ cho mỗi profile
  • 2 ví dụ Patient (đầy đủ + tối thiểu)
  • 2 ví dụ Practitioner (BSCKII + tối thiểu) + 1 PractitionerRole
  • 2 ví dụ Organization (BV tuyến TW + Trạm y tế)
  • 2 ví dụ Coverage (BHYT mới + legacy)
  • 2 ví dụ Encounter (ngoại trú + nội trú)
  • 4 ví dụ Condition (Tây y + YHCT)
  • 1 ví dụ MedicationRequest + 1 Medication
  • 2 ví dụ ServiceRequest (xét nghiệm đường huyết + chụp X-quang ngực)
  • 1 ví dụ Claim + 1 ClaimResponse + 1 ExplanationOfBenefit
  • 1 ví dụ DocumentReference + 1 DiagnosticReport
  • 1 ví dụ Device + 1 DeviceUseStatement
  • Các ví dụ Observation (Lab, VitalSigns, YHCT), AllergyIntolerance, Procedure, Address

Cải tiến đáng chú ý

  • VNYHCTDiseaseCS — REBUILD HOÀN TOÀN từ Excel nguồn QĐ 2552/QĐ-BYT (sheet "DM ngay 2752025"):
    • Sửa lỗi nghiêm trọng: U50.101 trước đó ghi sai bệnh danh ("Hiếp thống" → đúng: "Hoàng đản")
    • Sửa format sub-code: từ .0, .1, .8, .9 (sai) → .01, .02, .03... (đúng QĐ 2552/QĐ-BYT)
    • Tăng từ 135 codes (sai, thiếu) → 228 codes (38 bệnh danh + 190 thể lâm sàng)
    • Bổ sung 12 bệnh danh thiếu: Hoàng đản, Si ngốc, Si chứng, Thất ngôn, Tọa cốt phong, Tọa điến phong, Kiên tý, Khái thấu, Chứng cam, Phong chẩn, Tầm ma chẩn, Hạ trĩ
    • 228/228 display duy nhất — không còn trùng lặp (trước đó 25 nhóm display giống hệt)
    • Display bệnh danh: "{YHCT} — {YHHĐ} [{ICD-10}]" (VD: "Yêu thống — Đau cột sống thắt lưng [M54.5]")
    • Display thể lâm sàng: "{YHCT}: {tên thể} [{ICD-10}]" (VD: "Yêu thống: Thể hàn thấp [M54.5]")
    • hierarchyMeaning sửa từ #grouped-by → #is-a (chuẩn FHIR)
    • Properties mới: icd10 (mã ICD-10), yhhd-name (tên bệnh YHHĐ), ma-dung-chung (mã dùng chung BYT)
    • English designations đầy đủ cho 228 codes (thuật ngữ TCM chuẩn quốc tế)
  • VNCoreServiceRequest — Bổ sung 3 elements:
    • identifier (0..* MS) — Mã phiếu chỉ định / Số yêu cầu
    • requisition (0..1) — Mã nhóm yêu cầu (gộp nhiều XN/DVKT cùng phiếu)
    • performerType (0..1) — Loại chuyên khoa thực hiện, bind VNSpecialtyVS
    • Cập nhật code description: ghi rõ LOINC cho XN (QĐ 1227/QĐ-BYT), ICD-9-CM cho PT/TT (QĐ 387/QĐ-BYT), SNOMED CT cho CĐHA
  • ExampleConditionYHCTYeuThong — Cập nhật dùng mã thể lâm sàng cụ thể U62.392.5.01 (Thể hàn thấp) thay vì base code U62.392.5

Trang nội dung (16)

  • Trang chủ, Giới thiệu (Omi HealthTech & OmiGroup), Bắt đầu nhanh
  • Cơ sở pháp lý, Hướng dẫn chung, Hướng dẫn thuật ngữ
  • Tình huống lâm sàng (khám ngoại trú + BHYT)
  • Profiles, Extensions, Thuật ngữ, Bảo mật
  • Validation, Ổn định & Conformance, SNOMED CT VN Đính chính
  • Tải xuống, Lịch sử thay đổi

Khung pháp lý tham chiếu

  • 28+ văn bản pháp lý và chiến lược liên quan (NQ 202/2025/QH15, TT 13/2025/TT-BYT, Luật 91/2025/QH15, NĐ 356/2025/NĐ-CP, QĐ 3516/QĐ-BYT, v.v.)
  • Tuân thủ mô hình ĐVHC 2 cấp mới (34 tỉnh + xã)
  • Tuân thủ Luật BVDLCN (dữ liệu y tế = DLCN nhạy cảm)

Liên hệ với các trang khác

Nếu cần Nên đọc tiếp
Tìm hiểu quy trình phát hành và quản trị của IG Phát hành và quản trị
Hiểu chiến lược ổn định và cam kết tương thích ngược Ổn định và tuân thủ
Tải xuống phiên bản hiện hành và các artifact liên quan Tải xuống

English Summary

This changelog records VN Core release deltas. For current implementation impact, read the 0.8.0 entry first, then review intervening releases back to the version being upgraded. Entries for 0.7.0 and earlier are historical.