Profile Bundle chuyên dùng cho gửi hồ sơ thanh toán BHYT lên Cổng giám định BHXH. Bundle này thuộc lớp liên thông hồ sơ thanh toán BHYT, tách biệt với các Bundle FHIR nội bộ. Căn cứ: Luật 25/2008/QH12 ngày 14/11/2008 về BHYT; Luật 51/2024/QH15 ngày 27/11/2024 sửa đổi Luật BHYT; NĐ 188/2025/NĐ-CP ban hành 01/07/2025, hiệu lực 15/08/2025 hướng dẫn Luật BHYT; QĐ 3176/QĐ-BYT ngày 29/10/2024 về chuẩn dữ liệu đầu ra KCB; QĐ 697/QĐ-BYT ngày 19/03/2026 về mẫu bảng kê chi phí KCB. Nguồn TVPL NĐ 188/2025/NĐ-CP: https://thuvienphapluat.vn/van-ban/Bao-hiem/Nghi-dinh-188-2025-ND-CP-huong-dan-Luat-Bao-hiem-y-te-641049.aspx

Profile DiagnosticReport chẩn đoán hình ảnh cho Việt Nam, áp dụng cho X-quang, CT, MRI, siêu âm, DSA và các báo cáo CĐHA khác. Kế thừa VNCoreDiagnosticReport và siết category theo HL7 v2-0074 RAD cùng nhóm chi phí CĐHA theo QĐ 697/QĐ-BYT. Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — nhóm Điện quang/CĐHA 1.240 mã; TT 23/2024/TT-BYT — danh mục kỹ thuật hiện hành; TT 13/2025/TT-BYT Điều 1, 3 — bệnh án điện tử, lưu trữ và xác nhận điện tử; TT 38/2024/TT-BYT — Hệ thống thông tin khám bệnh, chữa bệnh; QĐ 3176/QĐ-BYT (29/10/2024) — XML3/XML6: MA_DICH_VU, KET_QUA, MA_LOAI_DVKT; QĐ 697/QĐ-BYT (19/3/2026) — nhóm chi phí 4 Chẩn đoán hình ảnh.

Profile DiagnosticReport cho Việt Nam. Nhóm kết quả cận lâm sàng (xét nghiệm, CĐHA, TDCN). Liên kết với VNCoreObservationLab (kết quả chi tiết) và VNCoreEncounter (lượt khám). Kết quả chi tiết có thể là Observation chuyên biệt theo từng loại báo cáo; child profiles sẽ siết lại loại Observation khi cần. Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — 2.964 mã CLS thuộc 5 nhóm: Huyết học-Truyền máu 1.022, Hóa sinh 447, Vi sinh 174, Giải phẫu bệnh 81, Điện quang/CĐHA 1.240; TT 23/2024/TT-BYT (01/10/2024) — danh mục kỹ thuật hiện hành thay TT 43/2013/TT-BYT (đã hết hiệu lực) từ 18/10/2024; TT 13/2025/TT-BYT Điều 1, 3 — bệnh án điện tử, lưu trữ/khai thác và ký/xác nhận điện tử; TT 38/2024/TT-BYT — Hệ thống thông tin khám bệnh, chữa bệnh; QĐ 3176/QĐ-BYT (29/10/2024) — XML3/XML6: MA_DICH_VU, KET_QUA, MA_LOAI_DVKT; QĐ 697/QĐ-BYT (19/3/2026) — nhóm chi phí 3 (XN), 4 (CĐHA), 5 (TDCN). Deferred v0.5: VNCoreDiagnosticReportFunctional cho Thăm dò chức năng do QĐ 1227 chưa có nhóm mã TDCN riêng. Nguồn thiết kế: OHP Data Processor (DiagnosticReport mapper — XML 4750).

Profile DiagnosticReport giải phẫu bệnh cho Việt Nam, áp dụng cho mô bệnh học, tế bào học và báo cáo GPB liên quan mẫu bệnh phẩm. Kế thừa VNCoreDiagnosticReport và siết category theo HL7 v2-0074 PAT cùng nhóm chi phí XN vì QĐ 697/QĐ-BYT gộp GPB vào nhóm xét nghiệm. Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — nhóm Giải phẫu bệnh 81 mã; QĐ 2427/QĐ-BYT (25/7/2025) — SNOMED CT VN Body Structure phục vụ bodySite; QĐ 2493/QĐ-BYT (08/2025) — SNOMED CT VN Morphologic Abnormality phục vụ conclusionCode với binding extensible; TT 23/2024/TT-BYT — danh mục kỹ thuật hiện hành; TT 13/2025/TT-BYT Điều 1, 3 — bệnh án điện tử, lưu trữ và xác nhận điện tử; TT 38/2024/TT-BYT — Hệ thống thông tin khám bệnh, chữa bệnh; QĐ 3176/QĐ-BYT (29/10/2024) — XML3/XML6: MA_DICH_VU, KET_QUA, MA_LOAI_DVKT; QĐ 697/QĐ-BYT (19/3/2026) — nhóm chi phí 3 Xét nghiệm.

Profile DiagnosticReport xét nghiệm cho Việt Nam, áp dụng cho các báo cáo huyết học-truyền máu, hóa sinh và vi sinh. Kế thừa VNCoreDiagnosticReport và siết category theo HL7 v2-0074 LAB cùng nhóm chi phí XN theo QĐ 697/QĐ-BYT. Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — 2.964 mã CLS, trong đó Huyết học-Truyền máu 1.022 mã, Hóa sinh 447 mã, Vi sinh 174 mã; QĐ 3148/QĐ-BYT (2017) — liên thông, công nhận kết quả xét nghiệm giữa các cơ sở y tế; TT 23/2024/TT-BYT — danh mục kỹ thuật hiện hành; TT 13/2025/TT-BYT Điều 1, 3 — bệnh án điện tử, lưu trữ và xác nhận điện tử; TT 38/2024/TT-BYT — Hệ thống thông tin khám bệnh, chữa bệnh; QĐ 3176/QĐ-BYT (29/10/2024) — XML3/XML6: MA_DICH_VU, KET_QUA, MA_LOAI_DVKT; QĐ 697/QĐ-BYT (19/3/2026) — nhóm chi phí 3 Xét nghiệm.

Profile Patient cho Việt Nam. Bao gồm identifier slicing (CCCD, BHYT, MRN), extensions dân tộc/nghề nghiệp, các extension chuẩn của HL7 cho nơi sinh/quốc tịch/tôn giáo, và ràng buộc địa chỉ theo VNCoreAddress. Căn cứ:

• TT 13/2025/TT-BYT — 06/6/2025 — bệnh án điện tử phải gắn số định danh cá nhân
• NĐ 102/2025/NĐ-CP — 13/5/2025, hiệu lực 01/7/2025 — Điều 6 quy định số định danh cá nhân là mã định danh y tế của cá nhân (áp dụng cho cả Patient và nhân lực y tế)
• Luật 91/2025/QH15 — 26/6/2025 — dữ liệu định danh và dữ liệu y tế là dữ liệu cá nhân cần bảo vệ
• Luật Căn cước 2023 (Luật 26/2023/QH15) — Điều 12: số định danh cá nhân là dãy 12 chữ số tự nhiên do CSDL quốc gia về dân cư xác lập
• Luật Hộ tịch 2014 (Luật 60/2014/QH13) — Điều 14 Khoản 1: số định danh cá nhân được gắn vào giấy khai sinh khi đăng ký khai sinh (từ 01/01/2016, trẻ em VN sinh từ 2016 trở đi đã có số định danh cá nhân từ giấy khai sinh)
• Luật 25/2008/QH12 — 14/11/2008 — Luật Bảo hiểm y tế
• Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, nền tảng dữ liệu thẻ BHYT.

Pattern identifier cho các trường hợp đặc biệt:

• Trẻ em sinh từ 2016: số định danh cá nhân từ giấy khai sinh = CCCD trong tương lai → dùng identifier[CCCD]
• Trẻ em sinh trước 2016 chưa cấp số định danh: dùng identifier[GKS] (Giấy khai sinh) làm primary, kèm data-absent-reason cho identifier[CCCD]
• Người nước ngoài: dùng identifier[passport]
• Người bệnh cấp cứu chưa rõ thân nhân: data-absent-reason + vn-ext-force-majeure-reason

Profile Composition cho bệnh án điện tử (EMR) Việt Nam. Cấu trúc tài liệu y tế có phân mục: tiền sử, chẩn đoán, xét nghiệm, điều trị, ra viện. Căn cứ:

• TT 13/2025/TT-BYT — 06/6/2025 — bệnh án điện tử, hiệu lực 21/7/2025
• TT 38/2024/TT-BYT — 16/11/2024 — hệ thống thông tin quản lý hoạt động KCB
• NĐ 102/2025/NĐ-CP — 13/5/2025 — quản lý dữ liệu y tế số
• NĐ 278/2025/NĐ-CP — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — kết nối, chia sẻ dữ liệu bắt buộc giữa cơ quan thuộc hệ thống chính trị; mốc chuẩn hóa/kết nối thống nhất chậm nhất 31/12/2026
• QĐ 11/2026/QĐ-TTg — 28/3/2026 — danh mục CSDL quốc gia, bao gồm CSDL quốc gia về y tế
• NĐ 137/2024/NĐ-CP — 23/10/2024 — giao dịch điện tử, chữ ký số
• Luật KCB 2023 — hồ sơ bệnh án.

Profile Observation chiều cao cơ thể cho Việt Nam, dùng LOINC 8302-2 và đơn vị UCUM cm. Phục vụ ghi nhận sinh hiệu, tính BMI, theo dõi tăng trưởng và bệnh án điện tử theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.

Profile con của VNCoreCondition cho chẩn đoán được ghi nhận trong một lượt khám/điều trị tại Việt Nam. ICD-10 VN là coding bắt buộc theo QĐ 4469/QĐ-BYT (28/10/2020), bổ sung mã COVID-19 theo QĐ 98/QĐ-BYT (14/01/2022) và hướng dẫn mã hóa theo TT 06/2026/TT-BYT (ban hành 02/04/2026, hiệu lực 01/07/2026 — future-effective). Category được cố định là encounter-diagnosis để phù hợp ghi nhận chẩn đoán trong hồ sơ KCB và dữ liệu đầu ra theo QĐ 3176/QĐ-BYT (29/10/2024), trường MA_BENH/MA_BENHKHAC.

Profile Condition cho chẩn đoán tại Việt Nam. Hỗ trợ mã hóa chẩn đoán bằng ICD-10 (bắt buộc theo QĐ 4469/QĐ-BYT) và/hoặc SNOMED CT IPS Terminology. Căn cứ: QĐ 4469/QĐ-BYT (28/10/2020) — ICD-10-VN, QĐ 98/QĐ-BYT (14/01/2022) — bổ sung COVID-19, QĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024). Tham chiếu bổ sung: TT 06/2026/TT-BYT (ban hành 02/04/2026, hiệu lực 01/07/2026 — future-effective) — Quy định về mã hóa bệnh tật, nguyên nhân tử vong theo ICD-10.

Profile Observation cân nặng cơ thể cho Việt Nam, dùng LOINC 29463-7 và đơn vị UCUM kg. Phục vụ ghi nhận sinh hiệu, tính BMI, kê đơn theo cân nặng và bệnh án điện tử theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.

Profile Organization cho cơ sở y tế Việt Nam. Bao gồm identifier mã CSKCB, extensions loại hình/cấp quản lý/phân hạng/cấp KCB hiện hành, và địa chỉ theo VNCoreAddress. Căn cứ:

• Luật KCB 2023 — Điều 47-48 — hình thức tổ chức cơ sở KCB
• NĐ 96/2023/NĐ-CP — 30/12/2023 — hướng dẫn Luật KCB
• NĐ 102/2025/NĐ-CP — 13/5/2025 — CSDL quốc gia về y tế, dữ liệu cơ sở y tế
• QĐ 11/2026/QĐ-TTg — 28/3/2026 — danh mục CSDL quốc gia, bao gồm CSDL quốc gia về y tế
• TT 06/2024/TT-BYT — 16/5/2024 — phân hạng cơ sở KCB
• TT 35/2024/TT-BYT — 16/11/2024 — tiêu chuẩn chất lượng cơ bản đối với bệnh viện.

Profile MedicationDispense cho Việt Nam. Dùng để ghi nhận cấp phát thuốc trong chu trình đơn thuốc điện tử, điều trị nội trú/ngoại trú, bệnh án điện tử, và dữ liệu phục vụ thanh toán BHYT. Căn cứ pháp lý hiện hành:

• Luật Dược 105/2016/QH13 ngày 06/4/2016 Điều 74 — nguyên tắc kê đơn/cấp phát thuốc
• Luật 44/2024/QH15 ngày 21/11/2024 Điều 1 khoản 36 — sửa đổi Điều 74 Luật Dược, giao Bộ Y tế quy định chi tiết đơn thuốc, ứng dụng CNTT, liên thông CSDL quốc gia về y tế
• NĐ 163/2025/NĐ-CP ngày 29/6/2025 — hướng dẫn Luật Dược, thay thế hoàn toàn NĐ 54/2017/NĐ-CP từ 01/7/2025 theo Điều 129
• TT 26/2025/TT-BYT — kê đơn thuốc ngoại trú: Điều 5 về kê đơn ngoại trú và sau điều trị nội trú; Điều 10 về giá trị pháp lý của đơn thuốc điện tử; Điều 12 về liên thông Hệ thống đơn thuốc quốc gia và lĩnh thuốc trong 05 ngày từ ngày kê
• TT 20/2022/TT-BYT + TT 37/2024/TT-BYT — danh mục, tỷ lệ và điều kiện thanh toán thuốc hóa dược, sinh phẩm, thuốc phóng xạ và chất đánh dấu thuộc phạm vi BHYT
• TT 27/2025/TT-BYT — thuốc y học cổ truyền thuộc phạm vi BHYT, hiệu lực 01/9/2025
• QĐ 3176/QĐ-BYT (29/10/2024) — XML3: MA_THUOC, SO_DANG_KY, NGAY_YL
• QĐ 697/QĐ-BYT (19/3/2026) — mẫu bảng kê chi phí KCB, danh mục chi phí thuốc là 1/12 nhóm
• NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — thanh toán BHYT thuốc
• NĐ 164/2025/NĐ-CP (29/6/2025) — giao dịch điện tử/API Cổng BHXH
• TT 13/2025/TT-BYT (06/6/2025) — bệnh án điện tử ghi nhận thông tin cấp phát thuốc. Ghi chú: NĐ 54/2017/NĐ-CP chỉ là legacy reference và không được dùng làm current basis sau 01/7/2025. / VN Core MedicationDispense profile for recording medication dispensing events in Vietnamese EMR, ePrescription, inpatient/outpatient, and BHYT reimbursement workflows.

Profile AllergyIntolerance cho ghi nhận dị ứng và bất dung nạp tại Việt Nam. Sử dụng SNOMED CT IPS Terminology (miễn phí, CC-BY-4.0) cho mã hóa chất gây dị ứng. Việt Nam không có bộ mã dị ứng quốc gia — SNOMED CT IPS cung cấp ~15.000+ concepts bao gồm substances, pharmaceutical products, allergens. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), Luật KCB 2023.

Profile HealthcareService cho dịch vụ y tế tại cơ sở y tế Việt Nam, đặc biệt cho Trạm Y tế cấp xã/phường/đặc khu trong mô hình chính quyền 2 cấp. Căn cứ:

• VBHN 06/2026/VBHN-BYT (01/2026) — hợp nhất TT 43/2025/TT-BYT + TT 53/2025/TT-BYT, Điều 3-4 quy định phạm vi 5 nhóm dịch vụ TYT cấp xã (phòng bệnh, KCB ban đầu + PHCN, chăm sóc bà mẹ trẻ em + người cao tuổi + khuyết tật, dân số + ATTP, dược + TBYT cơ sở);
• Luật KCB 2023 (15/2023/QH15) — Điều 47-48;
• Luật 72/2025/QH15 — Luật Tổ chức chính quyền địa phương (mô hình 2 cấp). HealthcareService.type binding extensible với VNHealthcareServiceTypeVS — cho phép codes ngoài cho dịch vụ chuyên sâu của tuyến tỉnh/trung ương.

Profile Endpoint biểu diễn cổng tiếp nhận hồ sơ giám định, thanh toán, quyết toán chi phí KCB BHYT (https://gdbhyt.baohiemxahoi.gov.vn) — endpoint điện tử của Bảo hiểm Xã hội Việt Nam mà cơ sở KCB ký hợp đồng BHXH phải gửi hồ sơ qua đó. Căn cứ:

• TT 12/2026/TT-BTC (Bộ Tài chính, 03/2026), Điều 2 — CSKCB gửi hồ sơ giám định/quyết toán BHYT qua cổng gdbhyt;
• NĐ 164/2025/NĐ-CP (29/06/2025) — giao dịch điện tử BHXH/BHYT;
• QĐ 3176/QĐ-BYT (29/10/2024) — chuẩn dữ liệu đầu ra KCB phục vụ BHXH (XML 4210).

Profile DeviceUseStatement cho Việt Nam. Ghi nhận việc sử dụng vật tư y tế (VTYT) hoặc thiết bị cho bệnh nhân. Liên kết với VNCoreDevice (thông tin VTYT) và VNCoreEncounter (lượt khám). Dùng cho theo dõi VTYT tiêu hao (catheter, kim, băng…) và VTYT lâu bền (implant, stent…). Căn cứ: QĐ 3176/QĐ-BYT (trường MA_VAT_TU trong chuẩn dữ liệu BHXH). Thông tin thanh toán BHYT theo dòng chi phí như PHAM_VI, TYLE_TT và MUC_HUONG phải đặt ở Claim.item/ClaimResponse/EOB; DeviceUseStatement chỉ giữ dữ liệu sử dụng lâm sàng.

Profile ExplanationOfBenefit cho Việt Nam. Giải trình quyền lợi BHYT — kết quả giám định và thanh toán. Mapping từ chuẩn dữ liệu đầu ra phục vụ BHXH hiện hành (QĐ 130 → QĐ 4750 → QĐ 3176). Bảng kê chi phí theo QĐ 697/QĐ-BYT (19/3/2026) — 12 danh mục, 14 mã. Căn cứ:

• QĐ 3176/QĐ-BYT (29/10/2024) — Chuẩn dữ liệu đầu ra phục vụ BHXH
• QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB
• Luật 51/2024/QH15 (27/11/2024) — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — Hướng dẫn thi hành Luật BHYT
• NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — xử phạt VPHC y tế, tham chiếu khi hồ sơ thanh toán/giải trình sai lệch
• Luật BHYT 2008 sửa đổi 2014

Profile Bundle cho Việt Nam — gói trao đổi dữ liệu FHIR phục vụ liên thông y tế. Hỗ trợ các use case: gửi dữ liệu BHXH (transaction), phản hồi tìm kiếm (searchset), bệnh án điện tử trọn bộ (document), và tập hợp resources (collection). Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 3176/QĐ-BYT (dữ liệu BHXH), NĐ 164/2025/NĐ-CP (giao dịch điện tử BHXH).

Profile Observation huyết áp cho Việt Nam, dùng LOINC 85354-9 và hai component LOINC cho huyết áp tâm thu/tâm trương. Phục vụ ghi nhận sinh hiệu trong khám chữa bệnh, bệnh án điện tử và liên thông dữ liệu lâm sàng theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.

Profile Organization cho khoa/phòng chuyên môn trong cơ sở khám bệnh, chữa bệnh tại Việt Nam. Profile này intentionally kế thừa trực tiếp từ FHIR Organization, không kế thừa VNCoreOrganization, để biểu diễn đơn vị trực thuộc với partOf bắt buộc và mã khoa chuyên ngành. Căn cứ pháp lý và nghiệp vụ:

• QĐ 2010/QĐ-BYT ngày 19/6/2025 Phụ lục 6 — Danh mục mã khoa hiện hành, 54 mã (K01-K53 + K99)
• QĐ 5937/QĐ-BYT (2021) — tiền nhiệm, bị bãi bỏ phần Phụ lục 5 bởi QĐ 2010/QĐ-BYT Điều 2
• QĐ 3176/QĐ-BYT (29/10/2024) — trường MA_KHOA trong XML đầu ra KCB
• TT 32/2023/TT-BYT Chương VIII Điều 44-45 — operational reference cho trực khoa, giao ban; không phải văn bản ban hành taxonomy khoa/phòng
• TT 13/2025/TT-BYT (06/6/2025) — bệnh án điện tử cần ghi nhận khoa điều trị. / VN Core OrganizationDepartment profile for clinical/operational departments within Vietnamese healthcare facilities. This profile inherits directly from FHIR Organization, separate from VNCoreOrganization, to keep department semantics explicit through mandatory partOf and department-code identifiers.

Profile ClaimResponse cho Việt Nam. Kết quả xử lý yêu cầu thanh toán BHYT. Bao gồm adjudication chi tiết: tổng đề nghị, đủ điều kiện, cùng chi trả, BHYT thanh toán. Cặp đôi với VNCoreClaim — Claim là yêu cầu, ClaimResponse là kết quả. Mã phản hồi gateway như XML1_ID được biểu diễn bằng identifier slice riêng; không thay thế MA_LK của Claim/Bundle. Căn cứ:

• QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT (chuẩn dữ liệu BHXH hiện hành)
• QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB
• Luật 51/2024/QH15 (27/11/2024) — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — Hướng dẫn Luật BHYT
• NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — xử phạt VPHC y tế, tham chiếu khi hồ sơ giám định/thanh toán sai lệch Nguồn thiết kế: OHP Data Processor (ClaimResponse adjudication mapping).

Profile Encounter cho Việt Nam. Bao gồm extension loại KCB BHYT (trường MALYDO), thông tin chẩn đoán, cơ sở y tế, và kết quả điều trị/tình trạng ra viện. Căn cứ:

• NĐ 102/2025/NĐ-CP — 13/5/2025 — quản lý dữ liệu y tế số và CSDL quốc gia về y tế
• TT 13/2025/TT-BYT — 06/6/2025 — bệnh án điện tử
• TT 30/2023/TT-BYT — 30/12/2023 — khám bệnh, chữa bệnh từ xa khi Encounter.class = VR/virtual
• Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• QĐ 130/QĐ-BYT — 18/01/2023; QĐ 4750/QĐ-BYT — 29/12/2023; QĐ 3176/QĐ-BYT — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH.

Profile Observation mạch/nhịp tim cho Việt Nam, dùng LOINC 8867-4 và đơn vị UCUM /min. Phục vụ ghi nhận sinh hiệu trong bệnh án điện tử, khám chữa bệnh ngoại trú/nội trú và liên thông dữ liệu lâm sàng theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.

Profile Specimen cho Việt Nam. Dùng để mô tả chuỗi lấy mẫu, tiếp nhận mẫu, xử lý mẫu và liên kết mẫu bệnh phẩm với chỉ định, kết quả xét nghiệm, và báo cáo cận lâm sàng. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 1227/QĐ-BYT (chỉ số cận lâm sàng), Luật KCB 2023. / VN Core Specimen profile for laboratory workflow linking orders, specimen collection, processing, observations, and diagnostic reports.

Profile ImagingStudy cho Việt Nam. Dùng để trao đổi metadata DICOM của nghiên cứu chẩn đoán hình ảnh, liên kết với chỉ định ServiceRequest, bệnh nhân, bác sĩ chỉ định, bác sĩ đọc kết quả và báo cáo cận lâm sàng. Căn cứ pháp lý và thuật ngữ:

• QĐ 1227/QĐ-BYT (11/4/2025) — nhóm Điện quang/Chẩn đoán hình ảnh, 1.240 mã CLS trong tổng 2.964 chỉ số cận lâm sàng
• QĐ 2427/QĐ-BYT (25/7/2025) — SNOMED CT VN Body Structure, dùng cho bodySite
• QĐ 4469/QĐ-BYT (28/10/2020) + QĐ 98/QĐ-BYT (14/01/2022) — ICD-10 VN cho reasonCode
• TT 13/2025/TT-BYT (06/6/2025) — bệnh án điện tử và dữ liệu DICOM/kết quả cận lâm sàng
• QĐ 3176/QĐ-BYT (29/10/2024) — XML MA_DICH_VU nhóm CĐHA. / VN Core ImagingStudy profile for diagnostic imaging metadata in Vietnamese EMR and clinical data exchange workflows.

Profile Provenance cho Việt Nam. Dùng để ghi nhận nguồn gốc tài liệu/hồ sơ y tế, tác nhân tạo lập/xác nhận, và chữ ký số. Căn cứ:

• TT 13/2025/TT-BYT — 06/6/2025 — bệnh án điện tử
• NĐ 137/2024/NĐ-CP — 23/10/2024 — giao dịch điện tử và chữ ký số trong hồ sơ điện tử
• NĐ 102/2025/NĐ-CP — 13/5/2025 — quản trị, xử lý dữ liệu y tế số
• NĐ 278/2025/NĐ-CP — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — chia sẻ dữ liệu bắt buộc; yêu cầu chuẩn hóa và thống nhất kết nối qua Nền tảng chia sẻ, điều phối dữ liệu chậm nhất 31/12/2026; provenance hỗ trợ truy xuất nguồn khi chia sẻ
• Luật 91/2025/QH15 — 26/6/2025 — bảo vệ dữ liệu cá nhân.

Profile RelatedPerson cho Việt Nam. Dùng cho cha, mẹ, người giám hộ, người đại diện hợp pháp hoặc người liên hệ của bệnh nhân. Áp dụng cho ca trẻ em, sơ sinh, consent qua cha/mẹ, và liên thông BHYT/EMR. Thiết kế theo hướng chuẩn hóa của US Core, JP Core, CH Core: dùng base RelatedPerson thay vì extension tùy biến.

Căn cứ pháp lý:

• Luật KCB 2023 (Luật 15/2023/QH15) — Điều 8, 27, 41 — quyền và đại diện hợp pháp của người bệnh
• NĐ 96/2023/NĐ-CP (30/12/2023) — hướng dẫn Luật KCB
• TT 32/2023/TT-BYT (31/12/2023) — phạm vi hành nghề KCB liên quan đại diện
• Bộ luật Dân sự 2015 (Luật 91/2015/QH13) — Điều 21, 47, 53-58 — người giám hộ, người đại diện theo pháp luật
• Luật Trẻ em 2016 (Luật 102/2016/QH13) — Điều 76 — quyền đại diện cho trẻ em chưa thành niên
• Luật 91/2025/QH15 (Bảo vệ DLCN, hiệu lực 01/01/2026) — đại diện ký Consent xử lý DLCN cho người chưa thành niên/mất năng lực hành vi
• NĐ 356/2025/NĐ-CP (31/12/2025) — hướng dẫn BVDLCN, lưu bằng chứng đồng ý qua người đại diện.

Profile Observation nhiệt độ cơ thể cho Việt Nam, dùng LOINC 8310-5 và đơn vị UCUM Cel. Phục vụ ghi nhận sinh hiệu, sàng lọc sốt và theo dõi lâm sàng trong bệnh án điện tử theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.

Profile Practitioner cho Việt Nam. Bao gồm identifier slicing (CCCD, GPHN hiện hành, CCHN lịch sử), thông tin trình độ chuyên môn (qualification). Căn cứ:

• Luật KCB 2023 — Điều 19-27 — hành nghề KCB
• NĐ 96/2023/NĐ-CP — 30/12/2023 — hướng dẫn Luật KCB
• TT 32/2023/TT-BYT — 31/12/2023 — hướng dẫn phạm vi hành nghề và chuyên môn KCB
• NĐ 102/2025/NĐ-CP — 13/5/2025, hiệu lực 01/7/2025 — Điều 6 quy định số định danh cá nhân (CCCD 12 số) là mã định danh y tế của cá nhân, áp dụng cho cả Patient và nhân lực y tế
• TT 13/2025/TT-BYT — 06/6/2025 — bệnh án điện tử.

Pattern identifier:

• identifier[CCCD] = mã định danh y tế của nhân lực (per NĐ 102/2025 Điều 6) — primary key
• identifier[GPHN] = số Giấy phép hành nghề (NĐ 96/2023 Mẫu 11 Phụ lục I) — professional license
• identifier[CCHN] = số Chứng chỉ hành nghề (legacy trước Luật KCB 2023) — backward compat

Profile AuditEvent cho Việt Nam. Dùng để ghi nhận truy cập, chỉnh sửa, chia sẻ, và xuất dữ liệu y tế/định danh nhạy cảm. Căn cứ:

• Luật 91/2025/QH15 — 26/6/2025 — bảo vệ dữ liệu cá nhân, dữ liệu y tế là dữ liệu nhạy cảm
• NĐ 356/2025/NĐ-CP — 31/12/2025 — hướng dẫn BVDLCN; Điều 42 về thông báo vi phạm dữ liệu trong 72 giờ
• Luật 116/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật An ninh mạng mới; yêu cầu baseline an ninh mạng và lưu vết/log
• NĐ 102/2025/NĐ-CP — 13/5/2025 — bảo vệ, quản trị, xử lý dữ liệu y tế số
• Luật KCB 2023 — hồ sơ bệnh án và trách nhiệm cơ sở KCB.

Profile Observation nhịp thở cho Việt Nam, dùng LOINC 9279-1 và đơn vị UCUM /min. Phục vụ ghi nhận sinh hiệu trong bệnh án điện tử, cấp cứu, hồi sức và khám chữa bệnh theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.

Profile PaymentReconciliation cho biên bản quyết toán/thanh toán chi phí KCB BHYT giữa cơ sở KCB và cơ quan BHXH (biểu mẫu 06/BH). Mỗi PaymentReconciliation tổng hợp kết quả giám định cho một chu kỳ quyết toán (thông thường theo tháng/quý) và liệt kê các Claim được duyệt/từ chối/tranh chấp. Căn cứ:

• TT 12/2026/TT-BTC — Bộ Tài chính, hướng dẫn giám định, thanh toán, quyết toán chi phí KCB BHYT điện tử; Điều 6 và Phụ lục biểu mẫu 06/BH.
• NĐ 188/2025/NĐ-CP (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT.
• NĐ 164/2025/NĐ-CP (29/06/2025) — Giao dịch điện tử trong lĩnh vực BHXH.
• Luật 51/2024/QH15 — Luật BHYT sửa đổi.

Profile Observation Vital Signs cho Việt Nam, kế thừa từ FHIR core vitalsigns profile. Hỗ trợ: huyết áp, mạch, nhiệt độ, nhịp thở, SpO2, cân nặng, chiều cao. Căn cứ: TT 13/2025/TT-BYT (06/06/2025) về hồ sơ bệnh án điện tử — phần sinh hiệu; QĐ 1227/QĐ-BYT (11/04/2025) ban hành danh mục mã dùng chung đối với kỹ thuật, thuật ngữ chỉ số cận lâm sàng, làm cơ sở chuẩn hóa mã CLS và ánh xạ LOINC.

Profile Observation bão hòa oxy ngoại vi/SpO2 cho Việt Nam, dùng LOINC 2708-6 và đơn vị UCUM %. Phục vụ ghi nhận sinh hiệu trong cấp cứu, hồi sức, hô hấp và bệnh án điện tử theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.

Profile Device chuyên cho thiết bị cấy ghép gắn với người bệnh tại Việt Nam. Kế thừa VNCoreDevice nhưng siết các điểm tối thiểu theo thông lệ US Core Implantable Device: patient-bound, type bắt buộc, status bắt buộc, UDI/lifecycle/safety là Must Support. UDI carrier là best practice quốc tế của HL7/FHIR và TCVN về UDI; pháp luật Việt Nam hiện chưa được model như yêu cầu UDI bắt buộc cho mọi thiết bị, nên profile chỉ cảnh báo khi UDI carrier thiếu nội dung HRF/AIDC. QĐ 847/QĐ-BYT (2025) và QĐ 3107/QĐ-BYT (2024) là nguồn terminology/provenance ứng viên cho danh pháp thiết bị (package hl7.fhir.vn.device), không phải required binding trong profile này. Căn cứ pháp lý cập nhật: NĐ 98/2021/NĐ-CP đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP; TT 05/2022/TT-BYT đã được sửa đổi, bổ sung bởi TT 59/2025/TT-BYT.

Profile Device cho thiết bị y tế (TBYT), bao gồm vật tư tiêu hao, thiết bị dùng trong chăm sóc và thiết bị cấy ghép tại Việt Nam. Giữ định danh thiết bị/vật tư (MA_VAT_TU khi legacy cần trao đổi như identifier), UDI, thông tin nhận dạng và vòng đời thiết bị. Thông tin thanh toán BHYT theo từng dòng chi phí như nhóm TBYT, phạm vi, tỷ lệ thanh toán và mức hưởng phải ưu tiên đặt tại Claim.item; Device chỉ giữ dữ liệu thiết bị hoặc fallback legacy khi chưa có Claim. Liên kết với Claim.item (chi phí TBYT) và DeviceUseStatement (ghi nhận sử dụng lâm sàng). Căn cứ pháp lý Việt Nam:

• VBHN 08/2026/VBHN-BYT (01/2026) — Văn bản hợp nhất chính thức NĐ 98/2021/NĐ-CP (08/11/2021) + NĐ 07/2023/NĐ-CP (03/03/2023) + NĐ 04/2025/NĐ-CP (hiệu lực 01/01/2025) về quản lý thiết bị y tế (bao gồm phân biệt TBYT thông thường và TBYT IVD chẩn đoán in vitro)
• VBHN 04/2026/VBHN-BYT (01/2026) — Văn bản hợp nhất TT 05/2022/TT-BYT (01/03/2022) + TT 59/2025/TT-BYT về phân loại TBYT và kiểm định
• TT 04/2017/TT-BYT (14/4/2017) Phụ lục 01 — 9 nhóm TBYT BHYT
• TT 24/2025/TT-BYT (30/6/2025, hiệu lực 01/9/2025) — sửa đổi TT 04/2017/TT-BYT, thống nhất thuật ngữ VTYT → TBYT
• VBHN 14/VBHN-BYT năm 2025 hợp nhất TT 04/2017/TT-BYT + TT 24/2025/TT-BYT: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Van-ban-hop-nhat-14-VBHN-BYT-2025-Thong-tu-dieu-kien-thanh-toan-doi-voi-vat-tu-y-te-thuoc-bao-hiem-y-te-670262.aspx
• QĐ 3176/QĐ-BYT — trường MA_VAT_TU trong XML dữ liệu đầu ra KCB
• QĐ 5086/QĐ-BYT, QĐ 637/QĐ-BYT (2022), QĐ 1844/QĐ-BYT (2022), QĐ 3181/QĐ-BYT (2022) — mã hãng sản xuất VTYT/TBYT, không phải danh mục mã hàng đầy đủ
• QĐ 3107/QĐ-BYT (2024) và QĐ 847/QĐ-BYT (2025) — danh pháp TBYT, package hl7.fhir.vn.device tách riêng, dùng tham chiếu tùy chọn khi cần chuẩn hóa tên gọi. Ghi chú:
• UDI carrier là best practice quốc tế của HL7/FHIR, không được trình bày như căn cứ bắt buộc trong pháp luật Việt Nam.
• Phân loại rủi ro A/B/C/D theo VBHN 08/2026/VBHN-BYT (hợp nhất NĐ 98/2021 + NĐ 07/2023 + NĐ 04/2025) được hỗ trợ bằng extension tùy chọn, không bắt buộc cho mọi Device.
• Cờ IVD (vn-ext-device-ivd) phân biệt TBYT chẩn đoán in vitro với TBYT thông thường theo VBHN 08/2026/VBHN-BYT, là dimension regulatory tùy chọn ở mức sản phẩm/model.
• TT 57/2025/TT-BYT (31/12/2025, hiệu lực 15/02/2026, triển khai 01/01/2027) phân nhóm TBYT theo tiêu chuẩn kỹ thuật/chất lượng phục vụ đấu thầu (căn cứ NĐ 214/2025/NĐ-CP về Luật Đấu thầu) là dimension procurement độc lập, không thuộc VN Core; nếu cần, dùng package hl7.fhir.vn.procurement riêng.

Profile Medication cho Việt Nam. Thông tin chi tiết thuốc: mã, tên, dạng bào chế, hàm lượng, số đăng ký. Liên kết với MedicationRequest (đơn thuốc) và Claim (thanh toán BHYT). Căn cứ:

• Luật 44/2024/QH15 — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025
• Luật Dược 2016 — nền tảng quản lý thuốc
• TT 37/2024/TT-BYT — 16/11/2024 — danh mục thuốc hóa dược/sinh phẩm thuộc phạm vi BHYT
• TT 27/2025/TT-BYT — 01/7/2025 — thuốc dược liệu, thuốc cổ truyền thuộc phạm vi BHYT
• Dược điển VN — chuẩn chất lượng thuốc
• QĐ 3176/QĐ-BYT — 29/10/2024 — trường MA_THUOC, TEN_THUOC trong dữ liệu BHXH
• NĐ 102/2025/NĐ-CP — 13/5/2025 — dữ liệu thuốc trong CSDL quốc gia về y tế. Nguồn thiết kế: OHP Data Processor (Medication mapper).

Profile Composition cho thông báo vi phạm quy định bảo vệ dữ liệu cá nhân theo Mẫu số 08 NĐ 356/2025/NĐ-CP. Cấu trúc 4 sections phản ánh trực tiếp Mẫu 08:

1. Thông tin tổ chức/doanh nghiệp (organization-info) — bao gồm DPO contact
2. Mô tả hành vi vi phạm (breach-description) — thời gian, địa điểm, hành vi, loại + số lượng DLCN, hậu quả, biện pháp
3. Tài liệu kèm theo (attachments) — DocumentReference list
4. Cam kết (commitment) — chữ ký số per NĐ 137/2024

Căn cứ pháp lý:

• NĐ 356/2025/NĐ-CP Điều 28 — Nội dung thông báo vi phạm (4 nhóm: tính chất vi phạm, liên lạc DPO, hậu quả, biện pháp)
• NĐ 356/2025/NĐ-CP Điều 29 — Đặc thù dữ liệu vị trí + sinh trắc học: thông báo chủ thể trong 72 giờ, lưu hồ sơ tối thiểu 5 năm
• NĐ 356/2025/NĐ-CP Phụ lục Mẫu 08 — Schema biểu mẫu thông báo
• Luật 91/2025/QH15 — Luật Bảo vệ dữ liệu cá nhân (nền tảng)
• Luật 116/2025/QH15 — Luật An ninh mạng sửa đổi (lưu vết, log) — future-effective 01/07/2026

Quy trình submit:

1. Tạo Composition này như structured form
2. Wrap trong Bundle type=document
3. Gửi đến Cơ quan chuyên trách BVDLCN (Bộ Công an) hoặc Cổng thông tin quốc gia về BVDLCN
4. Optional: dùng MessageHeader nếu cần messaging pattern

Lý do chọn Composition (không phải Communication):

• Mẫu 08 là biểu mẫu document có cấu trúc 4 phần rõ ràng → Composition.section pattern
• Composition phù hợp với 'persistent legal record' — Communication chỉ cho healthcare interaction
• DPO ký tên + đóng dấu ở phần 4 → Composition.attester pattern fit

Profile Coverage đại diện thẻ bảo hiểm y tế Việt Nam. Bao gồm extensions loại đối tượng BHYT và nơi ĐKKCB ban đầu, hỗ trợ cả 3 format số thẻ. Căn cứ:

• Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT, quyền lợi và định danh thẻ BHYT
• NĐ 164/2025/NĐ-CP — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH
• QĐ 130/QĐ-BYT — 18/01/2023; QĐ 4750/QĐ-BYT — 29/12/2023; QĐ 3176/QĐ-BYT — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH
• Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.

Profile Procedure cho thủ thuật và dịch vụ kỹ thuật y tế tại Việt Nam. Hỗ trợ mã hóa bằng SNOMED CT IPS Terminology (miễn phí) và danh mục DVKT VN. Căn cứ: TT 20/2014/TT-BYT, TT 39/2018/TT-BYT (danh mục DVKT), QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 3176/QĐ-BYT (2024) — trường MA_DVKT/MA_PTTT trong chuẩn dữ liệu BHXH, QĐ 387/QĐ-BYT (05/02/2026) — ICD-9-CM mới nhất, QĐ 4466/QĐ-BYT (2020) — ánh xạ DVKT ↔ ICD-9-CM.

Profile Immunization cho Việt Nam. Hỗ trợ mã loại vaccine theo danh mục VN, CVX cho interoperability quốc tế, loại chương trình tiêm chủng (TCMR/dịch vụ/chiến dịch), nguồn chi trả, lô vaccine và thông tin người/cơ sở thực hiện. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh (thay thế Luật Phòng, chống bệnh truyền nhiễm 03/2007/QH12 từ 01/07/2026), QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028, TT 13/2025/TT-BYT ngày 06/06/2025 về hồ sơ bệnh án điện tử. Nguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx

Profile DocumentReference cho Việt Nam. Dùng cho tham chiếu bệnh án điện tử, phiếu kết quả xét nghiệm, phim ảnh CĐHA, đơn thuốc điện tử, giấy chuyển viện, v.v. Căn cứ:

• TT 13/2025/TT-BYT (06/6/2025) — Bệnh án điện tử, hiệu lực 21/7/2025
• NĐ 102/2025/NĐ-CP (13/5/2025) — Quản lý dữ liệu y tế số
• NĐ 278/2025/NĐ-CP — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — Kết nối, chia sẻ dữ liệu bắt buộc; chuẩn hóa và thống nhất kết nối qua Nền tảng chia sẻ, điều phối dữ liệu chậm nhất 31/12/2026
• QĐ 11/2026/QĐ-TTg (28/3/2026) — Danh mục CSDL quốc gia, gồm CSDL quốc gia về y tế
• Luật KCB 2023 (15/2023/QH15) — Hồ sơ bệnh án
• NĐ 137/2024/NĐ-CP — Giao dịch điện tử, chữ ký số
• QĐ 1332/QĐ-BYT — Sổ sức khỏe điện tử trên VNeID
• Luật 91/2025/QH15 — BVDLCN: dữ liệu y tế = DLCN nhạy cảm

Profile PractitionerRole cho Việt Nam. Liên kết Practitioner với Organization và Location, ghi nhận chức danh nghề nghiệp (mã V.08) và chuyên khoa hành nghề. Căn cứ: Luật KCB 2023 Điều 42 (phạm vi hoạt động chuyên môn), TT 41/2025/TT-BYT (chức danh bác sĩ), TT 02/2025/TT-BYT (chức danh điều dưỡng), TT 32/2023/TT-BYT Điều 11 (phạm vi hành nghề theo chuyên khoa).

Profile Observation cho kết quả xét nghiệm lâm sàng tại Việt Nam. Sử dụng LOINC làm mã xét nghiệm (66.077 mã unique, bản dịch tiếng Việt do BYT phát hành). BYT đã ban hành bộ mã CLS quốc gia ánh xạ sang LOINC (QĐ 1227/QĐ-BYT 11/04/2025). Căn cứ: QĐ 1227/QĐ-BYT (2025), TT 13/2025/TT-BYT, QĐ 130/QĐ-BYT sửa đổi bởi QĐ 3176/QĐ-BYT (2024).

Profile ServiceRequest cho Việt Nam. Dùng cho yêu cầu xét nghiệm, chẩn đoán hình ảnh, thăm dò chức năng, thủ thuật, phẫu thuật, khám chuyên khoa, phục hồi chức năng, YHCT. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), TT 20/2014/TT-BYT + TT 39/2018/TT-BYT (danh mục DVKT), QĐ 3176/QĐ-BYT (chuẩn dữ liệu BHXH — trường MA_DVKT). Mã hóa dịch vụ bằng ICD-9-CM (QĐ 387/2026), SNOMED CT, hoặc mã DVKT VN. / VN Core ServiceRequest profile for medical service orders: lab tests, diagnostic imaging, functional diagnostics, procedures, surgery, specialist consultations, rehabilitation, traditional medicine. Per TT 13/2025/TT-BYT (EMR), TT 20/2014 + TT 39/2018 (DVKT catalog), QĐ 3176/QĐ-BYT (BHXH data — MA_DVKT field).

Profile Claim cho Việt Nam. Dùng cho yêu cầu thanh toán chi phí khám chữa bệnh BHYT. Mapping từ chuẩn dữ liệu đầu ra phục vụ BHXH hiện hành (QĐ 130 → QĐ 4750 → QĐ 3176). Bảng kê chi phí theo QĐ 697/QĐ-BYT (19/3/2026) — 12 danh mục, 14 mã. Căn cứ:

• QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu đầu ra phục vụ BHXH
• QĐ 4750/QĐ-BYT (2023) — Sửa đổi QĐ 130
• QĐ 3176/QĐ-BYT (29/10/2024) — Sửa đổi QĐ 4750
• QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB (thay QĐ 6556)
• NĐ 188/2025/NĐ-CP — ban hành 01/07/2025, hiệu lực 15/08/2025 — Hướng dẫn thi hành Luật BHYT, Điều 15 về giá trị sử dụng thẻ và Điều 22 về nhiều thẻ BHYT
• NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — Xử phạt vi phạm hành chính trong lĩnh vực y tế khi hồ sơ/chứng từ BHYT sai quy định
• Luật BHYT 2008 sửa đổi 2014
• Luật 25/2008/QH12 ngày 14/11/2008 về BHYT; Luật 51/2024/QH15 ngày 27/11/2024 sửa đổi Luật BHYT Nguồn TVPL: NĐ 188/2025/NĐ-CP https://thuvienphapluat.vn/van-ban/Bao-hiem/Nghi-dinh-188-2025-ND-CP-huong-dan-Luat-Bao-hiem-y-te-641049.aspx; NĐ 90/2026/NĐ-CP https://thuvienphapluat.vn/van-ban/Vi-pham-hanh-chinh/Nghi-dinh-sua-doi-Nghi-dinh-117-2020-ND-CP-xu-phat-vi-pham-hanh-chinh-trong-linh-vuc-y-te-639959.aspx

Profile Observation cho đánh giá Y học cổ truyền (YHCT) tại Việt Nam. Dùng cho các phương pháp tứ chẩn: Vọng (nhìn — lưỡi, sắc mặt), Văn (nghe/ngửi), Vấn (hỏi — triệu chứng), Thiết (bắt mạch). Liên kết với VNCoreCondition (chẩn đoán YHCT) và VNCoreProcedure (kỹ thuật YHCT). Căn cứ: QĐ 2552/QĐ-BYT (12/8/2025) — Đợt 1 mã YHCT, QĐ 3080/QĐ-BYT (26/9/2025) — Đợt 2 mã YHCT.

Profile MedicationRequest cho Việt Nam. Dùng cho đơn thuốc điện tử (ePrescription). Hỗ trợ đơn thuốc ngoại trú, nội trú, cấp cứu. Liên kết với BHYT qua Coverage/Claim. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 130/QĐ-BYT sửa đổi bởi QĐ 3176/QĐ-BYT (trường MA_THUOC trong chuẩn dữ liệu BHXH), Luật Dược 2016 Điều 74 (kê đơn thuốc). Căn cứ bổ sung:

• Luật 44/2024/QH15 — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025
• TT 26/2025/TT-BYT — 30/6/2025 — kê đơn thuốc hóa dược, sinh phẩm trong điều trị ngoại trú; hiệu lực 01/7/2025
• NĐ 102/2025/NĐ-CP — 13/5/2025 — quản lý dữ liệu y tế số và dữ liệu đơn thuốc trong CSDL quốc gia về y tế. / VN Core MedicationRequest profile for electronic prescriptions (ePrescription). Supports outpatient, inpatient, and emergency prescriptions. Links to insurance via Coverage/Claim. Per TT 13/2025/TT-BYT (EMR), QĐ 3176/QĐ-BYT (BHXH data standard — MA_THUOC field), Pharmaceutical Law 2016 Art.74 and amended by Law 44/2024/QH15; TT 26/2025/TT-BYT for outpatient/electronic prescribing.

Profile Address cho Việt Nam, hỗ trợ ĐVHC mới theo NQ 202/2025 (34 tỉnh, 3.321 xã). Bổ sung extension mã hóa tỉnh/TP và xã/phường. Cấp huyện (district) giữ lại cho backward-compatible nhưng KHÔNG Must Support — khuyến khích dùng extension:province + extension:ward. Căn cứ:

• NQ 202/2025/QH15 — 12/6/2025 — sắp xếp ĐVHC cấp tỉnh, mô hình 2 cấp từ 01/7/2025
• QĐ 19/2025/QĐ-TTg — 2025 — danh mục mã tỉnh/xã mới dùng cho địa chỉ.

Profile Location cho khoa, phòng, buồng khám, buồng bệnh hoặc khu vực chuyên môn trực thuộc cơ sở y tế Việt Nam. Dùng để tách rõ địa điểm cung cấp dịch vụ khỏi Organization và hỗ trợ liên kết PractitionerRole, ServiceRequest, DiagnosticReport cùng các use case EMR nội bộ. Căn cứ: TT 13/2025/TT-BYT, Luật KCB 2023, định hướng chuẩn hóa FHIR-native theo JP Core và CH Core.

Profile Consent cho Việt Nam, tuân thủ Luật 91/2025/QH15 (Bảo vệ dữ liệu cá nhân) và NĐ 356/2025/NĐ-CP. Ghi nhận sự đồng ý/từ chối xử lý dữ liệu y tế cá nhân, bao gồm mục đích xử lý, phạm vi, thời hạn, và quyền rút lại đồng ý. Dữ liệu y tế = dữ liệu cá nhân nhạy cảm (Luật 91/2025 Điều 3 khoản 4). Căn cứ:

• Luật 91/2025/QH15 — 26/6/2025 — quyền chủ thể dữ liệu tại Điều 13-17, đồng ý/rút lại đồng ý và xử lý dữ liệu nhạy cảm
• NĐ 356/2025/NĐ-CP — 31/12/2025 — hướng dẫn BVDLCN, hồ sơ đánh giá tác động và lưu bằng chứng đồng ý
• NĐ 278/2025/NĐ-CP — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — chia sẻ dữ liệu bắt buộc, cần kiểm soát bằng Consent/policy khi chia sẻ ngoài cơ sở KCB; mốc chuẩn hóa/kết nối thống nhất chậm nhất 31/12/2026
• NĐ 102/2025/NĐ-CP — 13/5/2025 — quản lý dữ liệu y tế số.

Tham chiếu structured tới văn bản pháp luật làm căn cứ cho profile/element/invariant. Mỗi extension trỏ đến 1 concept trong VNLegalDocumentRefCS — ưu tiên hơn citation inline ở Description, vì:

• Truy xuất được issuanceDate, effectiveDate, status (in-force/current-as-amended/transition/superseded) qua concept lookup
• Tooling có thể validate citation hết hiệu lực
• 1 nguồn truth duy nhất khi văn bản thay đổi Có thể dùng nhiều extension trên cùng artifact để tham chiếu chain (ví dụ NĐ 98/2021 + NĐ 07/2023 + NĐ 04/2025). Context: ElementDefinition (cho element-level) và StructureDefinition (cho artifact-level).

Mở rộng tham chiếu Cơ quan hướng dẫn chuyên môn kỹ thuật của một cơ sở y tế khi cơ quan này khác với đơn vị quản lý hành chính (Organization.partOf). Trường hợp điển hình: Trạm Y tế (TYT) cấp xã — về quản lý hành chính trực thuộc UBND cấp xã (đặt tại Organization.partOf), nhưng về chuyên môn kỹ thuật chịu sự hướng dẫn, kiểm tra của Sở Y tế cấp tỉnh (đặt tại extension này). Tách biệt 2 chiều quản lý này phản ánh đúng mô hình chính quyền 2 cấp sau Luật 72/2025/QH15 và VBHN 06/2026/VBHN-BYT (hợp nhất TT 43/2025 + TT 53/2025 về Trạm Y tế xã/phường). Căn cứ:

• Luật 72/2025/QH15 — 16/6/2025 — Luật Tổ chức chính quyền địa phương (hiệu lực 01/7/2025)
• VBHN 06/2026/VBHN-BYT — 01/2026 — hợp nhất TT 43/2025 + TT 53/2025 về tổ chức và hoạt động của Trạm Y tế xã/phường/đặc khu.

Mở rộng ghi nhận cấp khám bệnh, chữa bệnh hiện hành của cơ sở hoặc địa điểm cung cấp dịch vụ theo Luật KCB 2023 và NĐ 96/2023/NĐ-CP. Có thể được dùng trong nghiệp vụ BHYT theo NĐ 188/2025/NĐ-CP.

Mở rộng ghi nhận cấp quản lý hành chính của cơ sở y tế trong mô hình hiện hành sau NQ 202/2025/QH15. Không dùng extension này để biểu diễn tuyến chuyên môn kỹ thuật lịch sử.

Mở rộng ghi nhận dân tộc của bệnh nhân theo danh mục 54 dân tộc Việt Nam (Tổng cục Thống kê). FHIR base chỉ có US Race/Ethnicity — không phù hợp cho Việt Nam. Căn cứ: Hiến pháp 2013 Điều 5, Luật Căn cước 2023.

Mở rộng ghi nhận dải điểm chất lượng cơ sở khám chữa bệnh phục vụ nghiệp vụ BHYT theo NĐ 188/2025/NĐ-CP.

Flag nghiệp vụ theo dòng chi phí BHYT cho XML2/XML3 trường VET_THUONG_TP. Chỉ dùng khi dòng thuốc, DVKT hoặc VTYT có quy định tỷ lệ thanh toán BHYT được dùng để điều trị vết thương tái phát hoặc bệnh tật tái phát cho thương binh, người hưởng chính sách như thương binh, bệnh binh theo field text của QĐ 130/QĐ-BYT và QĐ 3176/QĐ-BYT; field text này viện dẫn NĐ 131/2021/NĐ-CP. Đây không phải mã chẩn đoán tái phát và không phải thuộc tính cố định của thuốc, DVKT hoặc thiết bị.

Hình thức đến khám chữa bệnh (trường HTCHUYEN per QĐ 3176/QĐ-BYT). Bổ sung cho MALYDO (VNCoreExtInsuranceVisitType): MALYDO xác định mức hưởng BHYT, HTCHUYEN ghi nhận nguồn gốc chuyển bệnh (tự đến, chuyển lên, chuyển xuống, chuyển ngang, cấp cứu). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024), NĐ 188/2025/NĐ-CP.

Mở rộng ghi nhận hạng pháp lý của cơ sở khám bệnh, chữa bệnh theo TT 06/2024/TT-BYT. Chỉ áp dụng cho cơ sở KCB; không dùng để biểu diễn trường hợp chưa xếp hạng hoặc hạng của đơn vị y tế không phải cơ sở KCB.

Mở rộng ghi nhận hạng pháp lý của đơn vị sự nghiệp y tế không phải cơ sở khám bệnh, chữa bệnh theo TT 06/2024/TT-BYT. Áp dụng cho cơ sở y tế dự phòng, trung tâm y tế, cơ sở kiểm nghiệm và kiểm định.

Mã khoa thực hiện dịch vụ/thuốc trên từng dòng chi phí. Mapping XML 3176: MA_KHOA. Nguồn thiết kế: OHP Data Processor (claim-item-department).

Mở rộng ghi nhận kết quả điều trị (trường KETQUA) cho lượt khám/điều trị. Căn cứ: QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024). 5 giá trị: Khỏi, Đỡ, Không thay đổi, Nặng hơn, Tử vong. Lưu ý: Khác với dischargeDisposition (tình trạng ra viện — TINHTRANGRA). KETQUA đánh giá kết quả y khoa, TINHTRANGRA ghi nhận hình thức ra viện.

Năm và tháng thanh toán BHYT. Mapping XML 3176: NAM_QT (năm), THANG_QT (tháng). Nguồn thiết kế: OHP Data Processor (claim-payment-year, claim-payment-month).

Mở rộng ghi nhận loại chương trình tiêm chủng trên Immunization: TCMR, dịch vụ hoặc chiến dịch. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028. Nguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx

Mở rộng ghi nhận loại hình cơ sở y tế (bệnh viện, phòng khám, trạm y tế…). FHIR Organization.type dùng mã quốc tế — extension này bổ sung phân loại theo y tế Việt Nam. Căn cứ: Luật KCB 2023 (15/2023/QH15), Điều 47-48.

Mở rộng ghi nhận loại khám chữa bệnh BHYT trên lượt khám (đúng tuyến, trái tuyến, thông tuyến, cấp cứu, KCB ban đầu). Tương ứng trường MALYDO trong QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024). Căn cứ: QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024), Luật BHYT 2008 sửa đổi 2014.

Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo). FHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp. Dùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã. Căn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15.

Mở rộng ghi nhận loại đối tượng bảo hiểm y tế (DN, HC, HN, TE, BT…). Xác định mức quyền lợi và tỷ lệ đồng chi trả. Tương ứng trường MATHE (2 ký tự đầu) trong QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024). Căn cứ: Luật BHYT 2008 sửa đổi 2014, BHXH Việt Nam.

Mở rộng ghi nhận lý do bất khả kháng khi chưa thu thập được số CCCD/số định danh cá nhân trong hồ sơ BHYT. Dùng cho các ca đặc biệt như trẻ sơ sinh hoặc người bệnh mất ý thức.

Mã lượt khám chữa bệnh (trường MA_LUOT_KCB per QĐ 3176/QĐ-BYT). Được mô hình hóa như Identifier để giữ nhất quán system / value / type khi đối soát BHXH. Khác với Encounter.identifier — MA_LUOT_KCB là mã nội bộ cho từng lượt khám và dùng NamingSystem khuyến nghị riêng.

Mở rộng ghi nhận nghề nghiệp của bệnh nhân theo Danh mục Nghề nghiệp Việt Nam (VSCO 2020). Căn cứ: QĐ 34/2020/QĐ-TTg (20/11/2020) — Ban hành Danh mục nghề nghiệp Việt Nam. 1.516 mã, 5 cấp phân loại, tương thích ISCO-08 (ILO). FHIR base Patient không có element nghề nghiệp chuẩn — cần extension. Nghề nghiệp ảnh hưởng đánh giá nguy cơ sức khỏe nghề nghiệp (TT 28/2016/TT-BYT).

Nguồn chi trả cho dòng chi phí KCB, đặc biệt dùng cho XML2 thuốc (NGUON_CTRA) theo QĐ 3176/QĐ-BYT. Biểu diễn nguồn chi trả ở mức item thay vì gán vào Coverage.type hoặc payment method tổng thể. Nguồn thiết kế: QĐ 3176/QĐ-BYT và terminology VNPaymentSourceCS/VS.

Ngày y lệnh chỉ định dịch vụ/thuốc (NGAY_YL). Mapping XML 3176: NGAY_YL. Nguồn thiết kế: OHP Data Processor (procedure-order-date).

Nhóm thiết bị y tế theo danh mục BHYT N01-N09. Căn cứ: TT 04/2017/TT-BYT (14/4/2017) Phụ lục 01 — 9 nhóm TBYT BHYT; TT 24/2025/TT-BYT (30/6/2025, hiệu lực 01/9/2025) sửa đổi TT 04/2017/TT-BYT và thống nhất thuật ngữ VTYT → TBYT; VBHN 14/VBHN-BYT năm 2025 hợp nhất TT 04/2017/TT-BYT và TT 24/2025/TT-BYT. Ưu tiên dùng trên Claim.item khi nhóm N01-N09 phục vụ dòng chi phí/thanh toán BHYT. Context Device chỉ giữ để hỗ trợ dữ liệu legacy hoặc trường hợp hệ thống cần gắn nhóm thanh toán vào device instance khi chưa có Claim.

Mở rộng ghi nhận cơ sở KCB ban đầu trên thẻ BHYT. Tương ứng trường MA_DKBD trong QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024). Tham chiếu đến Organization có mã CSKCB (5 chữ số do BHXH VN cấp). Căn cứ: QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024), Luật BHYT 2008 sửa đổi 2014.

Phân loại rủi ro thiết bị y tế A/B/C/D theo NĐ 98/2021/NĐ-CP Điều 4 (đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP) và TT 05/2022/TT-BYT (đã được sửa đổi, bổ sung bởi TT 59/2025/TT-BYT). Extension này là tùy chọn trên Device vì risk class là thuộc tính pháp lý ở mức sản phẩm/model/regulatory context; không bắt buộc cho mọi Device instance trong trao đổi lâm sàng hoặc BHYT. Phân biệt rõ với các dimension độc lập KHÔNG dùng extension này:

• Nhóm TBYT BHYT N01-N09 (TT 04/2017/TT-BYT Phụ lục 01) → dùng VNCoreExtDeviceGroup;
• Danh pháp thiết bị y tế (QĐ 3107/2024, QĐ 847/2025) → dùng Device.type với hệ danh pháp;
• 6 nhóm phân loại tiêu chuẩn kỹ thuật/chất lượng phục vụ đấu thầu theo TT 57/2025/TT-BYT (31/12/2025, hiệu lực 15/02/2026, triển khai 01/01/2027, căn cứ NĐ 214/2025/NĐ-CP về Luật Đấu thầu) → nếu cần biểu diễn, dùng extension riêng trong package procurement, KHÔNG dùng extension này.

Raw gateway carrier cho XML2 MA_PP_CHEBIEN trong dữ liệu BHYT/KCB đối với vị thuốc, dược liệu hoặc thuốc YHCT có thông tin chế biến. QĐ 3176/QĐ-BYT vẫn tham chiếu bộ mã qua nền pháp lý cũ; hiện hành, Thông tư 14/2024/TT-BYT là nguồn mô tả phương pháp chế biến các vị thuốc cổ truyền. Do repo chưa ingest được một CodeSystem FHIR-ready có provenance đầy đủ từ nguồn hiện hành, extension này giữ nguyên chuỗi nghiệp vụ/raw legal string thay vì công bố mã chính thức sớm.

Phương thức thanh toán KCB BHYT: phí dịch vụ (FFS), định suất (Capitation), hoặc theo trường hợp bệnh (DRG). Mapping XML 3176: MA_PTTT_QT. Nguồn thiết kế: OHP Data Processor (encounter-payment-method).

Phương thức (cách thức) chủ thể dữ liệu cá nhân thể hiện sự đồng ý xử lý DLCN. Căn cứ: NĐ 356/2025/NĐ-CP Điều 6 khoản 1 — quy định 5 phương thức exhaustive (a/b/c/d/đ). Mỗi phương thức phải bảo đảm khả năng kiểm chứng (verifiable) về xác định chủ thể, thời điểm, và nội dung đồng ý. Đặt extension này trên Consent.provision (mức quy tắc đồng ý chi tiết) — giúp audit + chứng minh tuân thủ NĐ 356. Required binding — không cho phép code ngoài VS vì NĐ 356 đã liệt kê đầy đủ với điểm đ là catch-all other-verifiable.

Phạm vi hưởng BHYT cho vật tư y tế (PHAM_VI cho VTYT). Mapping XML 3176: PHAM_VI trong XML3. Nguồn thiết kế: OHP Data Processor (pham-vi-bhyt-vtyt). Extension này không còn dùng trực tiếp trên Device hoặc DeviceUseStatement trong dữ liệu mới vì PHAM_VI là thuộc tính theo dòng chi phí/lượt thanh toán, không phải thuộc tính cố định của device instance hoặc ghi nhận sử dụng lâm sàng. Ưu tiên dùng Claim.item.extension[insuranceCostInfo].extension[scope].

Số hiệu biên bản quyết toán/thanh toán chi phí KCB BHYT (biểu mẫu 06/BH) giữa cơ sở KCB và cơ quan BHXH. Căn cứ:

• TT 12/2026/TT-BTC — Bộ Tài chính, Điều 6 và Phụ lục biểu mẫu 06/BH (Biên bản quyết toán chi phí KCB BHYT).

Số lưu hành (registration number) của thiết bị y tế tại Việt Nam.

Căn cứ pháp lý: NĐ 98/2021/NĐ-CP Điều 21 (Phân nhóm số lưu hành), Chương III (Điều 17-33) về đăng ký lưu hành TBYT, đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP (03/03/2023) và NĐ 04/2025/NĐ-CP (hiệu lực 01/01/2025).

Phân nhóm theo NĐ 98/2021 Điều 21:

1. Loại A & B — Số công bố tiêu chuẩn áp dụng (Sở Y tế tỉnh/TP tiếp nhận):
   • Format: [STT tiếp nhận]/[Năm tiếp nhận 2 số]/[Mã ký hiệu Sở Y tế]-PCBA (loại A)
   • Format: [STT tiếp nhận]/[Năm tiếp nhận 2 số]/[Mã ký hiệu Sở Y tế]-PCBB (loại B)
   • PCBA/PCBB = Phiếu công bố loại A / loại B
   • Ví dụ: 2300001/23/HN-PCBA (Hồ sơ số 1 năm 2023, Sở Y tế Hà Nội tiếp nhận)
2. Loại C & D — Số Giấy chứng nhận đăng ký lưu hành (Bộ Y tế cấp):
   • Format chuẩn: [STT cấp]/[Năm cấp 2 số]/BYT-ĐKLH
   • Format rút gọn: [STT cấp]/BYT-ĐKLH
   • ĐKLH = Đăng ký lưu hành
   • Ví dụ: 2300055/BYT-ĐKLH hoặc 2300055/23/BYT-ĐKLH

Phạm vi:

• Bắt buộc cho loại B/C/D trước khi đưa ra thị trường
• Loại A chỉ công bố tiêu chuẩn áp dụng (vẫn dùng PCBA format)
• Đây là định danh ở mức sản phẩm/model/regulatory context, KHÔNG phải định danh per-instance

Lưu ý phân biệt: Extension này độc lập với:

• UDI (định danh per-instance theo HL7 best practice)
• MA_VAT_TU (mã nghiệp vụ BHYT theo QĐ 3176)
• Serial number (per-instance physical)
• Mã tài sản BV (internal facility code)

Số đăng ký lưu hành thuốc (Visa) do Cục Quản lý Dược — Bộ Y tế cấp. Trường SO_DANG_KY per QĐ 3176/QĐ-BYT (29/10/2024). Bắt buộc khi gửi dữ liệu chi phí thuốc cho BHXH. Căn cứ bổ sung:

• Luật 44/2024/QH15 — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025
• Luật Dược 2016 — đăng ký lưu hành thuốc
• NĐ 102/2025/NĐ-CP — 13/5/2025 — dữ liệu thuốc trong CSDL quốc gia về y tế.

Cờ boolean phân biệt TBYT chẩn đoán in vitro (IVD — In Vitro Diagnostic) với TBYT thông thường, theo VBHN 08/2026/VBHN-BYT (hợp nhất NĐ 98/2021 + NĐ 07/2023 + NĐ 04/2025). TBYT IVD có quy định riêng về phân loại rủi ro, đăng ký lưu hành, kiểm định và quản lý chất lượng so với TBYT thông thường. Đây là cờ regulatory ở mức sản phẩm/model, không bắt buộc cho mọi Device instance trong trao đổi lâm sàng/BHYT. Khi có giá trị true: Device là sinh phẩm/thuốc thử/máy phân tích chẩn đoán in vitro (vd: máy xét nghiệm sinh hóa, test nhanh COVID-19, sinh phẩm xét nghiệm). Khi false hoặc không có: Device là TBYT thông thường (non-IVD).

Extension tái sử dụng cho thông tin chi phí BHYT trên từng item (thuốc/DVKT/VTYT). Bao gồm: phạm vi BHYT (PHAM_VI), tỷ lệ thanh toán (TYLE_TT), mức hưởng (MUC_HUONG). Dùng trên: MedicationRequest, Procedure, Claim.item, ServiceRequest và MedicationDispense khi các resource đó đang đóng vai trò nguồn dữ liệu cho dòng chi phí. Với thiết bị/vật tư, ưu tiên đặt trên Claim.item; không dùng trên DeviceUseStatement vì DeviceUseStatement là ghi nhận sử dụng lâm sàng. Mapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG. Nguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level).

Thông tin thầu của dòng thuốc/vật tư/thiết bị trong dữ liệu KCB/BHYT, đặc biệt dùng cho XML2/XML3 trường TT_THAU theo QĐ 130/QĐ-BYT và QĐ 3176/QĐ-BYT. Đây là chuỗi nghiệp vụ phục vụ thanh toán/gateway, không phải procurement package đầy đủ và không thay thế hồ sơ đấu thầu riêng.

Thời hạn lưu trữ bắt buộc của log audit liên quan đến vi phạm DLCN. Căn cứ: NĐ 356/2025/NĐ-CP Điều 29 khoản 1 điểm c — 'Tổ chức phải lưu hồ sơ vi phạm trong thời gian tối thiểu 5 năm kể từ ngày khắc phục xong sự cố' (đối với dữ liệu vị trí + sinh trắc học). Đặt extension này trên AuditEvent để ghi nhận điểm bắt đầu retention period (typically từ ngày khắc phục xong sự cố vi phạm) và end date dự kiến. Khuyến nghị mặc định 5 năm cho mọi loại DLCN nhạy cảm; có thể dài hơn nếu doanh nghiệp/quy chế nội bộ yêu cầu.

Trạng thái giám định, quyết toán hồ sơ thanh toán BHYT điện tử theo quy trình TT 12/2026/TT-BTC: tiếp nhận → giám định → duyệt/từ chối/tranh chấp. Đặt trên PaymentReconciliation hoặc Task workflow BHYT. Bổ sung cho PaymentReconciliation.outcome chuẩn FHIR (queued | complete | error | partial) để map đúng vòng đời giám định BHYT Việt Nam. Căn cứ:

• TT 12/2026/TT-BTC — Bộ Tài chính, Điều 6 và Điều 10 (tranh chấp).
• NĐ 188/2025/NĐ-CP.

Mở rộng ghi nhận tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT cho dữ liệu cũ hoặc bài toán chuyển đổi. Không dùng để biểu diễn mô hình hiện hành.

Mở rộng ghi nhận trạng thái xếp hạng của cơ sở y tế nhằm biểu diễn các trường hợp đã xếp hạng, chưa xếp hạng hoặc không áp dụng mà không làm sai bộ mã hạng pháp lý.

Mở rộng ghi nhận mã tỉnh/thành phố theo QĐ 19/2025/QĐ-TTg trên Address. FHIR Address.state chỉ là text — extension này bổ sung mã hóa (Coding) để tra cứu chính xác. Căn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg.

Extension tổng hợp chi phí KCB theo từng nhóm nguồn chi trả. Mapping từ XML 3176: T_THUOC, T_VTYT, T_BNCCT, T_BNTT, T_BHTT, T_NGUONKHAC, T_NGOAIDS. Căn cứ: QĐ 130/QĐ-BYT → QĐ 3176, QĐ 697/QĐ-BYT. Các field tổng tiền này được chuẩn hóa thêm qua VNBHYTFinancialFieldCS và ConceptMap vn-cm-bhyt-financial-field-to-adjudication; extension chỉ giữ số tiền tổng hợp, không encode công thức adjudication của payer. Nguồn thiết kế: OHP Data Processor (Claim extensions production mapping).

Tổng số tiền cùng chi trả (co-payment) BHYT lũy kế trong năm dương lịch của người tham gia BHYT, dùng để xác định khi nào đạt trần cùng chi trả và được hưởng quyền lợi không phải cùng chi trả tiếp. Căn cứ:

• NĐ 188/2025/NĐ-CP — Điều 10 (trần cùng chi trả tích lũy năm). Khi tổng cùng chi trả trong năm dương lịch vượt trần quy định, người tham gia BHYT được cấp Giấy chứng nhận không cùng chi trả và không phải cùng chi trả các lần KCB tiếp theo trong năm đó.
• Luật 51/2024/QH15 — Sửa đổi Luật BHYT, hiệu lực 01/07/2025.

Mở rộng ghi nhận mã xã/phường/thị trấn theo QĐ 19/2025/QĐ-TTg trên Address. FHIR Address không có trường cho cấp xã (ward/commune) — extension này bổ sung. Mã 5 chữ số (00001–99999) theo danh mục 3.321 đơn vị cấp xã. Căn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg.

Logical model cho bảng 1 dữ liệu tổng hợp hồ sơ khám chữa bệnh BHYT theo QĐ 3176/QĐ-BYT.

Logical model cho Bảng 10 QĐ 3176/QĐ-BYT: dữ liệu giấy chứng nhận nghỉ dưỡng thai.

Logical model cho Bảng 11 QĐ 3176/QĐ-BYT: dữ liệu giấy chứng nhận nghỉ việc hưởng bảo hiểm xã hội.

Logical model cho Bảng 12 QĐ 3176/QĐ-BYT: dữ liệu giám định y khoa.

Logical model cho bảng 2 chi tiết thuốc và dịch truyền theo QĐ 3176/QĐ-BYT.

Logical model cho bảng 3 dịch vụ kỹ thuật và vật tư y tế theo QĐ 3176/QĐ-BYT.

Logical model cho bảng 4 kết quả xét nghiệm, chẩn đoán hình ảnh và thăm dò chức năng.

Logical model cho bảng 5 diễn biến bệnh và xử trí lâm sàng.

Logical model cho Bảng 6 QĐ 3176/QĐ-BYT: hồ sơ bệnh án chăm sóc và điều trị HIV/AIDS. Dữ liệu này là dữ liệu y tế đặc biệt nhạy cảm; mọi mapping triển khai phải đi kèm chính sách Consent, SecurityLabel và Audit.

Logical model cho Bảng 7 QĐ 3176/QĐ-BYT: dữ liệu giấy ra viện.

Logical model cho Bảng 8 QĐ 3176/QĐ-BYT: dữ liệu tóm tắt hồ sơ bệnh án.

Logical model cho Bảng 9 QĐ 3176/QĐ-BYT: dữ liệu giấy chứng sinh.

Logical model cho dữ liệu tiếp nhận/check-in trước khi gửi hồ sơ thanh toán BHYT.

Bộ mã bài thuốc Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục VI. FHIR concept code sử dụng cột Mã dùng chung; cột Mã bài thuốc và thành phần được bảo toàn dưới concept properties.

Bảng phân loại quốc tế bệnh tật ICD-10 phiên bản Việt Nam, ban hành theo QĐ 4469/QĐ-BYT (28/10/2020), bổ sung theo QĐ 98/QĐ-BYT (14/01/2022). Artifact công bố trên IG này là metadata wrapper cho tập dữ liệu ICD-10 VN gồm 15.026 mã (2.043 type + 12.983 disease).

Dữ liệu hiện có trong lớp chuẩn hóa

• Cấu trúc phân cấp type -> disease
• display tiếng Việt và designation tiếng Anh cho từng mã khi có
• Concept property cho level, chapter-id, chapter-code, section-id, type-code, leaf, child-count

Cách dùng trong VN Core

• Khi coding trong resource FHIR, vẫn ưu tiên system = http://hl7.org/fhir/sid/icd-10
• Dùng metadata wrapper này để biết phạm vi dữ liệu ICD-10 VN đã được chuẩn hóa trong release hiện hành
• Khi cần tra cứu hoặc import toàn bộ dữ liệu FHIR JSON, dùng release download surface thay vì public IG page

Cách lấy artifact

• Validator/FHIR server: dùng file FHIR JSON đầy đủ CodeSystem-vn-icd10-cs.full.json trên release download surface
• Xem trang tải xuống để lấy liên kết tải trực tiếp
• Các serialization XML/TTL trên public IG chỉ phản ánh metadata wrapper hiện hành; riêng route canonical .json được trỏ sang full JSON download

Bảng phân loại quốc tế mã hóa thủ thuật y tế ICD-9-CM (Volume 3) phiên bản Việt Nam. 3.882 mã thủ thuật/phẫu thuật, song ngữ Việt-Anh, do Bộ Y tế Việt Nam phát hành theo QĐ 387/QĐ-BYT (05/02/2026). Được dùng cho hồ sơ KCB, BHYT và ánh xạ danh mục DVKT theo QĐ 4466/QĐ-BYT (2020).

Bộ mã bệnh danh Y học cổ truyền Việt Nam và các thể lâm sàng theo QĐ 2552/QĐ-BYT Phụ lục I. FHIR concept code sử dụng cột Mã U / Mã hóa chính thức; cột Mã dùng chung, tên bệnh theo Y học hiện đại và mã ICD-10 được bảo toàn dưới concept properties.

Danh mục chuyên khoa y tế Việt Nam sử dụng trong hệ thống khám chữa bệnh. Căn cứ hiện hành: TT 32/2023/TT-BYT Điều 11, Phụ lục V–XVII (phạm vi hành nghề theo 19 nhóm hệ cơ quan) và Luật KCB 2023 Điều 42. TT 43/2013/TT-BYT và TT 21/2017/TT-BYT đã hết hiệu lực từ 18/10/2024 (thay bởi TT 23/2024/TT-BYT); content của CodeSystem này kế thừa phân loại chuyên khoa gốc nhưng căn cứ pháp lý chính thức hiện hành là TT 32/2023 + Luật KCB 2023. / Vietnamese medical specialty list for healthcare practice scope classification. Current legal basis: TT 32/2023/TT-BYT (Art.11, Appendix V–XVII) and Medical Examination and Treatment Law 2023 Art.42. Legacy references TT 43/2013 and TT 21/2017 are superseded as of 18/10/2024.

Bộ mã chẩn đoán Y học cổ truyền Việt Nam theo QĐ 2552/QĐ-BYT Phụ lục II. FHIR concept code sử dụng cột Mã dùng chung; cột Mã chuyên môn và nhóm chẩn đoán được bảo toàn dưới concept properties.

Danh mục mã dùng chung chỉ số cận lâm sàng Đợt 1, ban hành theo QĐ 1227/QĐ-BYT ngày 11/04/2025. FHIR concept code sử dụng chính cột mã CLS chính thức trong phụ lục nguồn; bản công bố giữ các thuộc tính tối thiểu phục vụ đối chiếu TT23, ánh xạ LOINC và truy vết phụ lục/trang nguồn. Dữ liệu phân tích chi tiết hơn được lưu trong dữ liệu nguồn của repo và ConceptMap liên quan. / Vietnam Clinical Lab Indicator CodeSystem (Batch 1) per QĐ 1227/QĐ-BYT dated 11/04/2025. FHIR concept code uses the official CLS code from the source appendix; the published CodeSystem keeps the minimum properties required for TT23 alignment, LOINC linkage, and appendix/page audit tracing. Richer analytical metadata remains in the repository source data and related ConceptMap artifacts.

Mã số chức danh nghề nghiệp viên chức ngành y tế Việt Nam (hệ V.08). Bao gồm 32 mã cho 11 nhóm chức danh: bác sĩ, BS YHDP, y sĩ, y tế công cộng, điều dưỡng, hộ sinh, kỹ thuật y, dược, dinh dưỡng, dân số, khúc xạ nhãn khoa. Căn cứ: TT 41/2025/TT-BYT (bác sĩ, BS YHDP, y sĩ), TT 02/2025/TT-BYT (điều dưỡng, hộ sinh, KTV), TTLT 27/2015/TTLT-BYT-BNV (dược). / Vietnamese healthcare civil service position codes (V.08 series) covering 32 codes across 11 professional groups. Per TT 41/2025/TT-BYT, TT 02/2025/TT-BYT.

Danh mục cấp khám bệnh, chữa bệnh hiện hành theo mô hình 3 cấp của Luật Khám bệnh, chữa bệnh 2023 và NĐ 96/2023/NĐ-CP. Bộ mã này có thể được tái sử dụng trong nghiệp vụ BHYT nhưng không phải là khái niệm payer-only. Căn cứ bổ sung:

• Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn Luật BHYT và quyền lợi theo cấp KCB.

Danh mục cấp quản lý hành chính của cơ sở y tế trong mô hình chính quyền địa phương 2 cấp sau NQ 202/2025/QH15 và Luật 72/2025/QH15. Bộ mã này không dùng để biểu diễn tuyến chuyên môn kỹ thuật lịch sử. Lưu ý: Cấp Huyện đã chính thức bị bãi bỏ từ 01/7/2025 theo NQ 202/2025/QH15 + Luật 72/2025/QH15 — KHÔNG còn code huyen trong bộ mã hiện hành. Dữ liệu lịch sử có cấp Huyện dùng VNLegacyTechnicalLineCS (#TUYEN_3) hoặc VNCoreExtLegacyTechnicalLine.

12 nhóm danh mục chi phí khám bệnh, chữa bệnh (14 mã, nhóm giường bệnh tách 3 loại) theo QĐ 697/QĐ-BYT (19/3/2026), thay thế QĐ 6556/QĐ-BYT (30/10/2018). Dùng để phân loại chi phí trong Claim/ExplanationOfBenefit.

Danh mục 54 dân tộc Việt Nam theo Tổng cục Thống kê (121/TCTK-PPCĐ), bổ sung mã 55 (Người nước ngoài) và 99 (Không rõ). Tái sử dụng dữ liệu từ hl7vn/vn-core-ig (CodeSystem vn-core-race v1.0). Nguồn: Tổng cục Thống kê — Danh mục các dân tộc Việt Nam (121/TCTK-PPCĐ).

Danh mục cục bộ tối thiểu chỉ dùng cho example/round-trip seed BHYT của repo này. Phạm vi hiện tại chỉ gồm 2 mã example-only được giữ ngoài scope terminology chính thức. Một dòng là workflow tiếp nhận/xử trí cấp cứu ban đầu chưa tìm được mã khám hoặc mã dịch vụ official đủ sạch. Một dòng là chăm sóc sơ sinh gần với danh mục kỹ thuật hộ sinh nhưng không phải exam code và chưa có mã official phù hợp để publish. KHÔNG PHẢI danh mục DVKT hoặc danh mục dịch vụ khám chữa bệnh chính thức của Bộ Y tế/BHXH.

Danh mục loại vaccine theo bệnh/nhóm bệnh phục vụ VNCoreImmunization. Bao gồm các bệnh trong Chương trình Tiêm chủng mở rộng (TCMR) theo QĐ 2780/QĐ-BYT ngày 29/08/2025 giai đoạn 2026-2028 và các vaccine dịch vụ/chiến dịch phổ biến. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028. Nguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx

Danh mục mã khoa trong cơ sở khám bệnh, chữa bệnh. Căn cứ hiện hành: QĐ 2010/QĐ-BYT (19/6/2025) Phụ lục 6 — Danh mục mã khoa trong cơ sở khám bệnh, chữa bệnh. Tiền nhiệm: QĐ 5937/QĐ-BYT (2021) Phụ lục 5, đã bị QĐ 2010/QĐ-BYT bãi bỏ phần danh mục mã khoa. Tham chiếu thêm: QĐ 130/QĐ-BYT → QĐ 4750 → QĐ 3176 (trường MA_KHOA). Nguồn dữ liệu: OHP Data Processor (production mapping, verified with QĐ 2010).

Slice chính thức có provenance từ Phụ lục 2 Quyết định 2010/QĐ-BYT (19/6/2025): Danh mục mã khám bệnh. Artifact này hiện chỉ publish fragment gồm 2 mã khám bệnh đang được dùng an toàn trong BHYT XML3 round-trip seed. Không phải toàn bộ phụ lục; sẽ mở rộng khi có thêm mapping 1:1 đủ sạch về ngữ nghĩa.

Slice chính thức có provenance từ Phụ lục 3 Quyết định 2010/QĐ-BYT (19/6/2025): Danh mục mã tiền giường. Artifact này hiện chỉ publish fragment gồm 2 mã ngày giường đang được dùng trong BHYT XML3 round-trip seed. Không phải toàn bộ phụ lục; sẽ mở rộng khi seed chính thức cần thêm mã ngày giường.

Danh mục nghề nghiệp Việt Nam ban hành kèm theo QĐ 34/2020/QĐ-TTg. 5 cấp phân loại: Cấp 1 (kỹ năng) + Cấp 2-5 (chuyên môn). Tương thích ISCO-08 ở Cấp 1-4, Cấp 5 là chi tiết riêng của Việt Nam. / Vietnam Standard Classification of Occupations (VSCO 2020), issued per QĐ 34/2020/QĐ-TTg. 5-level hierarchy: Level 1 (skill level) + Levels 2-5 (specialization). ISCO-08 compatible at Levels 1-4; Level 5 is Vietnam-specific detail.

Danh mục 696 quận/huyện theo hệ thống cũ (trước NQ 202/2025). Bộ mã này chỉ dùng cho tương thích ngược với dữ liệu lịch sử. Mỗi mã có property status để phản ánh trạng thái mã cũ và property province trỏ về mã tỉnh mới theo QĐ 19/2025.

16 tôn giáo được Nhà nước Việt Nam công nhận theo Công văn số 6955/BNV-TGCP ngày 28/12/2020 của Bộ Nội vụ (Ban Tôn giáo Chính phủ). Bổ sung mã 00 (Không tôn giáo) và 99 (Không rõ) cho mục đích kỹ thuật.

Danh mục 34 tỉnh/thành phố Việt Nam theo NQ 202/2025/QH15 và QĐ 19/2025/QĐ-TTg. Mã số 2 chữ số, hiệu lực từ 01/7/2025. Bổ sung mã cũ (trạng thái inactive) cho tương thích ngược với dữ liệu trước sáp nhập. Căn cứ:

• NQ 202/2025/QH15 — 12/6/2025 — 34 đơn vị cấp tỉnh từ 01/7/2025
• QĐ 19/2025/QĐ-TTg — 2025 — mã ĐVHC cấp tỉnh.

Danh mục 3.321 xã/phường/thị trấn Việt Nam theo QĐ 19/2025/QĐ-TTg (Phụ lục II). Mã số 5 chữ số (00001–99999), hiệu lực từ 01/7/2025. Mỗi đơn vị có property "province" trỏ về mã tỉnh/TP (2 chữ số) theo Phụ lục I.

Bộ mã danh pháp thiết bị y tế Việt Nam tổng hợp từ QĐ-3107/QĐ-BYT-2024 và QĐ-847/QĐ-BYT-2025. Display/definition chính dùng tiếng Việt; tên tiếng Anh được đưa vào designation, định nghĩa tiếng Anh được giữ trong property definitionEn. Bộ mã thuộc package hl7.fhir.vn.device và không là required binding cho VN Core Device.type.

Bộ mã dược liệu và vị thuốc Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục V. FHIR concept code sử dụng cột Mã dùng chung; cột Mã dược liệu, vị thuốc, tên khoa học và nguồn gốc được bảo toàn dưới concept properties.

Danh mục dải điểm chất lượng cơ sở KCB dùng cho xác định một số trường hợp mức hưởng BHYT theo NĐ 188/2025/NĐ-CP.

Bộ mã huyệt châm cứu theo Y học cổ truyền Việt Nam theo QĐ 2552/QĐ-BYT Phụ lục III. FHIR concept code sử dụng cột Mã dùng chung; cột mã quốc tế, tên quốc tế, tham chiếu SNOMED CT và thông tin đường kinh được bảo toàn dưới concept properties.

Danh mục hình thức đến khám chữa bệnh (trường HTCHUYEN per QĐ 3176/QĐ-BYT). Bổ sung cho MALYDO — MALYDO xác định mức hưởng BHYT, HTCHUYEN ghi nhận nguồn gốc chuyển bệnh. Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024), NĐ 188/2025/NĐ-CP, TT 01/2025/TT-BYT.

Phân hạng cơ sở khám chữa bệnh theo TT 06/2024/TT-BYT. 4 hạng: Đặc biệt, Hạng I, Hạng II, Hạng III. Căn cứ:

• TT 06/2024/TT-BYT — 16/5/2024 — phân hạng cơ sở khám bệnh, chữa bệnh
• TT 35/2024/TT-BYT — 16/11/2024 — tiêu chuẩn chất lượng cơ bản đối với bệnh viện, tham chiếu bổ trợ khi đánh giá chất lượng.

Phân hạng đơn vị sự nghiệp y tế không phải cơ sở khám bệnh, chữa bệnh theo TT 06/2024/TT-BYT. Áp dụng cho cơ sở y tế dự phòng, trung tâm y tế, cơ sở kiểm nghiệm và kiểm định.

Danh mục kết quả điều trị theo QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024) (trường KETQUA).

Bộ mã kỹ thuật Y học cổ truyền Việt Nam theo QĐ 2552/QĐ-BYT Phụ lục IV. FHIR concept code sử dụng cột Mã dùng chung; cột Mã kỹ thuật và STT trong TT 23/2024/TT-BYT được bảo toàn dưới concept properties.

Bảng mã xét nghiệm quốc tế LOINC (Logical Observation Identifiers Names and Codes) phiên bản Việt Nam. 66.077 mã LOINC unique với bản dịch tên thành phần (component) tiếng Việt. Trong đó ~59.000 mã có bản dịch tiếng Việt, ~7.000 mã chỉ có tên tiếng Anh.

Căn cứ pháp lý:

• QĐ 1227/QĐ-BYT (11/04/2025) — Ban hành bộ mã CLS (cận lâm sàng) quốc gia, ánh xạ mã CLS VN ↔ LOINC. VN có bộ mã CLS riêng, MAPPING sang LOINC.
• QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu BHXH, trường MA_XN (mã xét nghiệm)

Vietnam LOINC translation, published by Cục KCB — MOH in collaboration with Regenstrief Institute (USA). Contains 66,077 unique LOINC codes with Vietnamese component translations. Source: https://loinc.whiteneuron.com (Deduplicated from original 108,526 entries which included duplicates, CLS VN codes, and EMR form field entries.)

Dữ liệu hiện có trong lớp chuẩn hóa: number (mã LOINC chuẩn), long_common_name (tên tiếng Anh đầy đủ), component (bản dịch tiếng Việt khi có), shortname, property, time_aspect, system, scale_type, method_type, và common_test_rank để hỗ trợ ưu tiên các mã dùng nhiều. Dataset đã loại bỏ bản ghi trùng, mã CLS VN nội bộ, và các field biểu mẫu không phải mã LOINC chuẩn.

Nhóm dữ liệu thường gặp: mã xét nghiệm và chỉ số định lượng/định tính; panel/order set phục vụ chỉ định và trả kết quả; report/document identifiers dùng trong Composition/DocumentReference khi phù hợp; survey/questionnaire items có trong LOINC gốc nhưng không phải mọi triển khai VN Core đều cần nạp toàn bộ.

Cách dùng trong VN Core: Khi coding trong FHIR, dùng system = http://loinc.org. Với xét nghiệm cận lâm sàng trong nước, dùng cùng vn-cls-cs và ConceptMap/vn-cm-cls-to-loinc. Dùng artifact này khi cần biết lớp dữ liệu LOINC VN đã được chuẩn hóa đến mức nào trước khi import vào terminology server nội bộ.

Cách lấy artifact: Validator/FHIR server dùng file FHIR JSON đầy đủ CodeSystem-vn-loinc-cs.full.json trên release download surface khi cần preload toàn bộ mã. Bộ tải xuống phát hành: xem trang tải xuống để lấy liên kết trực tiếp và gói hl7.fhir.vn.terminology.clinical-0.3.0.tgz. Public IG page này là metadata wrapper; dữ liệu chi tiết được tiêu thụ thông qua package/download surface và nguồn chuẩn hóa đi kèm. Các serialization XML/TTL trên public IG chỉ phản ánh metadata wrapper hiện hành; riêng route canonical .json được trỏ sang full JSON download.

Note: MOH publishes a separate national lab code system (QĐ 1227/2025) that MAPS to LOINC. When coding in FHIR, use system = http://loinc.org with LOINC number from the mapping table.

Danh mục loại chương trình tiêm chủng tại Việt Nam: tiêm chủng mở rộng, tiêm chủng dịch vụ và tiêm chủng chiến dịch. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028. Nguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx

Bộ mã loại hình dịch vụ y tế cung cấp tại tuyến cơ sở (đặc biệt Trạm Y tế cấp xã/phường/đặc khu). Căn cứ:

• VBHN 06/2026/VBHN-BYT (01/2026) — hợp nhất TT 43/2025/TT-BYT và TT 53/2025/TT-BYT, Điều 3-4 quy định phạm vi dịch vụ TYT cấp xã. Phạm vi dịch vụ gồm 5 nhóm chính:
  1. Phòng bệnh (tiêm chủng, HIV, bệnh không lây nhiễm)
  2. KCB ban đầu + phục hồi chức năng
  3. Quản lý sức khỏe bà mẹ trẻ em, người cao tuổi, khuyết tật
  4. Dân số, an toàn thực phẩm
  5. Dược, TBYT tại cơ sở. Dùng cho HealthcareService.type của VNCoreHealthcareService (binding extensible — vẫn cho phép codes ngoài cho dịch vụ chuyên sâu).

Phân loại yêu cầu dịch vụ y tế theo nhóm chức năng tại các cơ sở KCB Việt Nam. Dựa trên phân loại khoa phòng bệnh viện và danh mục DVKT (TT 20/2014/TT-BYT, TT 39/2018/TT-BYT). Tương ứng với các nhóm chi phí trong QĐ 697/QĐ-BYT (19/3/2026). / Vietnamese medical service request category classification. Based on hospital department structure and DVKT catalog (TT 20/2014, TT 39/2018). Corresponds to cost categories in QĐ 697/QĐ-BYT (19/3/2026).

Danh mục loại hình cơ sở y tế dùng trong VN Core, tổng hợp từ Luật KCB 2023, TT 06/2024/TT-BYT và VBHN 06/2026/VBHN-BYT (hợp nhất TT 43/2025 + TT 53/2025 về Trạm Y tế xã/phường).

Danh mục loại khám chữa bệnh BHYT theo QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024). Phân loại mục đích đến khám theo chế độ BHYT.

Danh mục mã loại khám chữa bệnh (trường MA_LOAI_KCB). Căn cứ: QĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024). Tham chiếu bổ sung:

• TT 30/2023/TT-BYT — 30/12/2023 — khám bệnh, chữa bệnh từ xa; chưa tạo mã MA_LOAI_KCB riêng, dùng Encounter.class = VR khi cần
• NĐ 102/2025/NĐ-CP — 13/5/2025 — dữ liệu KCB trong CSDL quốc gia về y tế. Nguồn dữ liệu: OHP Data Processor (production mapping).

Danh mục bổ sung cho các loại tổng hợp tài chính BHYT không có mã tương đương chính xác trong HL7 Terminology adjudication. Các mã này dùng chủ yếu cho ClaimResponse.total, ExplanationOfBenefit.total hoặc cost summary, không thay thế adjudication logic của payer.

Danh mục 3 loại đơn vị hành chính cấp xã theo Luật 72/2025/QH15 (Luật Tổ chức chính quyền địa phương, hiệu lực 01/7/2025) và NQ 202/2025/QH15. Mô hình chính quyền địa phương 2 cấp (tỉnh + xã) chính thức xác lập 3 loại đơn vị cấp cơ sở: xã (nông thôn), phường (đô thị), đặc khu (hải đảo đặc biệt).

Danh mục các loại định danh sử dụng trong hệ thống y tế Việt Nam. Bổ sung cho HL7 v2 Table 0203 (Identifier Type) với các loại định danh riêng của Việt Nam.

Danh mục mã đối tượng tham gia BHYT (2 ký tự) ghi trên thẻ bảo hiểm y tế. Căn cứ: QĐ 1351/QĐ-BHXH (16/11/2015), QĐ 1697/QĐ-BHXH (27/11/2023), QĐ 1018/QĐ-BHXH (24/7/2024), NĐ 146/2018/NĐ-CP, NĐ 75/2023/NĐ-CP. Cập nhật nền pháp lý:

• Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT; các trích dẫn NĐ 146/2018 trong từng mã được giữ để truy xuất nguồn danh mục lịch sử.

Phân loại loại đồng ý xử lý dữ liệu cá nhân trong y tế Việt Nam. Căn cứ: Luật 91/2025/QH15 Điều 11 (sự đồng ý), Điều 17 (miễn trừ đồng ý).

Danh mục mã cục bộ phục vụ triển khai VN Core để ghi nhận lý do bất khả kháng khi chưa thu thập được số CCCD/số định danh cá nhân trong hồ sơ BHYT. Danh mục này chỉ dùng cho các ca bất khả kháng thực sự; không dùng để thay cho trường hợp người bệnh đã có định danh thay thế hợp lệ như hộ chiếu hoặc giấy khai sinh.

Danh mục mã 3 chữ số của Bộ Công an dùng ở ba chữ số đầu của số định danh cá nhân/CCCD 12 số để biểu thị tỉnh, thành phố trực thuộc Trung ương hoặc mã quốc gia nơi công dân đăng ký khai sinh. CodeSystem này chỉ phục vụ validation-support cho định danh cá nhân/CCCD đã cấp; KHÔNG thay thế danh mục đơn vị hành chính hiện hành trong VNProvinceCS. Căn cứ quy chiếu nghiệp vụ: Thông tư 17/2024/TT-BCA về thi hành Luật Căn cước và hệ mã prefix BCA đang được duy trì trên các số định danh/CCCD đã cấp.

Danh mục MA_NHOM dùng trong XML2/XML3 chuẩn dữ liệu đầu ra KCB theo QĐ 3176/QĐ-BYT. Đây là mã nguồn legacy/export, không đồng nhất trực tiếp với vn-cost-category-cs theo QĐ 697.

Danh mục mã tai nạn thương tích (trường MA_TAI_NAN). Căn cứ: QĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024), Bảng 8. Nguồn dữ liệu: OHP Data Processor (production mapping).

Danh mục mã đối tượng đến khám bệnh, chữa bệnh (trường MA_DOITUONG_KCB) phục vụ việc gửi dữ liệu điện tử chi phí KCB BHYT. Căn cứ: QĐ 3276/QĐ-BYT ngày 17/10/2025. Thay thế Phụ lục 5 QĐ 824/QĐ-BYT (15/02/2023) và Phụ lục 5 QĐ 2010/QĐ-BYT (19/6/2025). Căn cứ pháp lý nền: Luật BHYT, Luật 51/2024/QH15 sửa đổi Luật BHYT (27/11/2024, hiệu lực 01/7/2025), NĐ 42/2025/NĐ-CP, NĐ 188/2025/NĐ-CP, TT 48/2017/TT-BYT, TT 01/2025/TT-BYT. Mã được xác định sau khi kết thúc KCB hoặc kết thúc điều trị.

Danh mục mục đích xử lý dữ liệu cá nhân trong y tế Việt Nam. Căn cứ: Luật 91/2025/QH15 — Bảo vệ dữ liệu cá nhân (hiệu lực 01/01/2026), NĐ 356/2025/NĐ-CP — Hướng dẫn chi tiết.

Danh mục nguồn chi trả cho tiêm chủng tại Việt Nam, dùng cho Immunization.fundingSource. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028. Nguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx

Danh mục nguồn chi trả chi phí KCB (trường NGUON_CTRA). Căn cứ: QĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024). Nguồn dữ liệu: OHP Data Processor (production mapping).

Danh mục nhóm issue cục bộ dùng để ghi nhận phản hồi giám định/từ chối/yêu cầu điều chỉnh trong ClaimResponse.error và OperationOutcome.issue.details. Danh mục này được rút gọn từ các nhóm tình huống xuất hiện trong TT 12/2026/TT-BTC, đặc biệt phần biên bản giám định, bảng kê chi phí từ chối thanh toán và yêu cầu điều chỉnh dữ liệu qua Cổng tiếp nhận. Đây KHÔNG PHẢI catalog payer/gateway chính thức đầy đủ; chỉ là taxonomy baseline ở mức profile/example để tránh mã hóa tự do khi pilot.

Danh mục 9 nhóm thiết bị y tế thuộc phạm vi danh mục BHYT theo TT 04/2017/TT-BYT Phụ lục 01. TT 24/2025/TT-BYT (30/6/2025, hiệu lực 01/9/2025) sửa đổi TT 04/2017/TT-BYT và thống nhất thuật ngữ từ vật tư y tế (VTYT) sang thiết bị y tế (TBYT). VBHN 14/VBHN-BYT năm 2025 là văn bản hợp nhất hiện hành để tra cứu cùng TT 04/2017/TT-BYT và TT 24/2025/TT-BYT. Nguồn TVPL TT 04/2017/TT-BYT: https://thuvienphapluat.vn/van-ban/Bao-hiem/Thong-tu-04-2017-TT-BYT-Danh-muc-ty-le-dieu-kien-thanh-toan-vat-tu-y-te-nguoi-tham-gia-bao-hiem-y-te-290390.aspx

Bộ mã pháp điều trị Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục IV. FHIR concept code sử dụng cột Mã dùng chung; cột Mã chuyên môn được bảo toàn dưới concept property.

Bộ mã phân loại thiết bị y tế theo mức độ rủi ro A/B/C/D. Căn cứ:

• NĐ 98/2021/NĐ-CP (08/11/2021) Điều 4 quy định 4 loại thiết bị y tế dựa trên mức độ rủi ro;
• NĐ 07/2023/NĐ-CP (03/03/2023) sửa đổi, bổ sung NĐ 98/2021;
• NĐ 04/2025/NĐ-CP (01/01/2025) sửa đổi, bổ sung NĐ 98/2021 và NĐ 07/2023;
• TT 05/2022/TT-BYT (01/03/2022) hướng dẫn quy tắc phân loại chi tiết;
• TT 59/2025/TT-BYT sửa đổi, bổ sung TT 05/2022/TT-BYT về kiểm định thiết bị y tế. Lưu ý: Đây là thuộc tính pháp lý ở mức sản phẩm/model/regulatory context, không phải nhóm BHYT N01-N09 (TT 04/2017) và không phải danh pháp thiết bị (QĐ 3107/2024, QĐ 847/2025). TT 57/2025/TT-BYT (31/12/2025, hiệu lực 15/02/2026, triển khai phân nhóm 01/01/2027) có 6 nhóm phân loại theo tiêu chuẩn kỹ thuật/chất lượng phục vụ đấu thầu (căn cứ NĐ 214/2025/NĐ-CP) — đây là dimension độc lập, KHÔNG nhập nhằng với A/B/C/D của NĐ 98/2021.

Phương thức thanh toán KCB BHYT. Mapping XML 3176: MA_PTTT_QT. Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024) — Bảng 14: Phương thức thanh toán.

5 phương thức thể hiện sự đồng ý của chủ thể dữ liệu cá nhân theo NĐ 356/2025/NĐ-CP Điều 6 khoản 1 (verified text gốc). Mỗi phương thức phải bảo đảm khả năng kiểm chứng được về việc xác định chủ thể dữ liệu cá nhân đã thực hiện sự đồng ý, thời điểm và nội dung được đồng ý. Bộ mã exhaustive — 5 codes a/b/c/d/đ ánh xạ trực tiếp 5 điểm trong NĐ 356/2025 Điều 6 khoản 1. Code other-verifiable (điểm đ) là catch-all cho phương thức khác phù hợp có thể in/sao chép, bao gồm dạng điện tử/định dạng kiểm chứng được.

Danh mục phạm vi hưởng bảo hiểm y tế (trường PHAM_VI). Xác định thuốc/DVKT/VTYT nằm trong hay ngoài danh mục do quỹ BHYT chi trả. Căn cứ: QĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024). Tham chiếu:

• Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT
• NĐ 74/2025/NĐ-CP — 31/3/2025 — sửa đổi quy định thanh toán TBYT/đối tượng đặc biệt
• NĐ 70/2015/NĐ-CP — nền tảng lịch sử cho đối tượng quân đội, công an, cơ yếu. Nguồn dữ liệu: OHP Data Processor (production mapping).

Bộ mã SNOMED CT phiên bản Việt Nam — subset chính thức do Bộ Y tế ban hành. 77.393 concepts với bản dịch tiếng Việt, song ngữ Việt-Anh, chia thành 3 đợt:

• Đợt 1 (QĐ 2427/QĐ-BYT, 25/7/2025): Body Structures — 35.889 concepts Cấu trúc giải phẫu cơ thể người
• Đợt 2 (QĐ 2493/QĐ-BYT, ~08/2025): Morphologic Abnormality — 5.155 concepts Bất thường hình thái (mô bệnh học, khối u…)
• Đợt 3 (QĐ 2805/QĐ-BYT, 04/9/2025): Clinical Finding + Allergy — 36.349 concepts Phát hiện lâm sàng (35.022) + Dị ứng (1.327)

Căn cứ nền tảng: QĐ 1928/QĐ-BYT (2023) — Kiến trúc Chính phủ điện tử Y tế v2.1, xác lập SNOMED CT là bộ mã thuật ngữ y tế chuẩn quốc gia.

Vietnam national SNOMED CT subset, published by Ministry of Health in 3 batches. Contains 77,393 concepts with Vietnamese translations, bilingual VI-EN. Each concept has: vn_code (national code), snomed_ct_id (international), name_vn, name_en. For international interoperability: system = http://snomed.info/sct, code = snomed_ct_id.

Dữ liệu hiện có trong lớp chuẩn hóa: vn_code (mã quốc gia do BYT công bố), snomed_ct_id (mã SNOMED CT quốc tế dùng cho coding/interoperability), name_vn, name_en (tên song ngữ), và category (nhóm thuật ngữ gốc trong dữ liệu tích hợp).

Các nhóm dữ liệu trong artifact: body structure cho vị trí giải phẫu; morphologic abnormality cho bất thường hình thái/mô bệnh học; clinical finding cho phát hiện/chẩn đoán lâm sàng; allergy cho các khái niệm dị ứng và chất liên quan.

Cách dùng trong VN Core: Dùng snomed_ct_id làm code khi gửi FHIR resource quốc tế hóa. Dùng cùng các companion ValueSet như vn-body-site-vs, vn-condition-code-vs, vn-allergy-code-vs tùy ca sử dụng. Khi cần rà soát sai lệch bản dịch, xem trang đính chính SNOMED CT VN.

Cách lấy artifact: Validator/FHIR server dùng file FHIR JSON đầy đủ CodeSystem-vn-snomed-subset-cs.full.json trên release download surface khi cần preload toàn bộ mã. Bộ tải xuống phát hành: xem trang tải xuống để lấy liên kết trực tiếp và gói hl7.fhir.vn.terminology.clinical-0.3.0.tgz. Public IG page này là metadata wrapper; dữ liệu chi tiết được tiêu thụ qua package/download surface và bộ nguồn chuẩn hóa nội bộ. Các serialization XML/TTL trên public IG chỉ phản ánh metadata wrapper hiện hành; riêng route canonical .json được trỏ sang full JSON download.

Implementation note: this IG publishes the VN SNOMED subset on the public HTML surface as metadata only (content = not-present). The 77,393 concepts are distributed as a separate full FHIR JSON artifact on the release download surface, and the canonical .json route is redirected there for machine access.

Bộ mã triệu chứng lưỡi theo Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục II. FHIR concept code sử dụng cột Mã dùng chung; cột Mã chuyên môn được bảo toàn dưới concept property.

Bộ mã triệu chứng mạch theo Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục III. FHIR concept code sử dụng cột Mã dùng chung; cột Mã chuyên môn được bảo toàn dưới concept property.

Bộ mã triệu chứng theo thể lâm sàng Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục I. FHIR concept code sử dụng cột Mã dùng chung; cột Mã hóa triệu chứng và tên thể lâm sàng được bảo toàn dưới concept properties.

Danh mục trình độ chuyên môn của nhân viên y tế Việt Nam. Bao gồm các học vị, chức danh chuyên môn phổ biến trong hệ thống khám chữa bệnh. Căn cứ: Luật KCB 2023 Điều 19-27 (Giấy phép hành nghề), Nghị định 96/2023/NĐ-CP. / Vietnamese healthcare professional qualification levels covering medical degrees, specialist certifications, and academic titles used in the healthcare system. Per Medical Examination and Treatment Law 2023 Art.19-27, Decree 96/2023/NĐ-CP.

Danh mục trường tổng tiền trong chuẩn dữ liệu đầu ra KCB/BHYT dùng để ánh xạ sang Claim.total, ClaimResponse.total, ExplanationOfBenefit.total và VNCoreExtClaimCostSummary. Đây là CodeSystem nguồn cho trường XML/export, không phải danh mục kết quả giám định.

Trạng thái quy trình giám định, quyết toán hồ sơ thanh toán BHYT điện tử giữa cơ sở KCB và cơ quan BHXH. Dùng cho PaymentReconciliation.outcome (VNCorePaymentReconciliation) và các trường trạng thái xử lý hồ sơ tương đương trong workflow BHYT. Căn cứ:

• TT 12/2026/TT-BTC — Bộ Tài chính, hướng dẫn giám định, thanh toán, quyết toán chi phí KCB BHYT điện tử; quy trình tiếp nhận hồ sơ → giám định → quyết toán/từ chối/tranh chấp.
• NĐ 188/2025/NĐ-CP (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT.
• Biểu mẫu 06/BH (Biên bản quyết toán/thanh toán chi phí KCB BHYT).

Danh mục tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT. Bộ mã này chỉ dùng cho dữ liệu lịch sử hoặc chuyển đổi từ HIS cũ. TT 43/2013/TT-BYT đã bị bãi bỏ bởi TT 23/2024/TT-BYT từ ngày 18/10/2024.

Danh mục tình trạng ra viện theo QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024) (trường MA_LOAI_RV, STT 42 Bảng 1).

Tình trạng vận hành của thuộc tính xếp hạng cơ sở y tế. Bộ mã này giúp biểu diễn trường hợp chưa xếp hạng hoặc không áp dụng mà không làm sai ngữ nghĩa của hạng pháp lý.

Bộ mã structured cho các văn bản pháp luật Việt Nam được tham chiếu trong VN Core FHIR IG. Mỗi concept là một văn bản pháp luật với property issuanceDate, effectiveDate, status, supersedes, supersededBy, issuingAuthority, officialUrl, shortName, relationshipNote, statusReviewedAt, statusEvidenceUrl, statusEvidenceNote. officialUrl được giữ để tương thích tooling hiện có; giá trị public ưu tiên trang thông tin văn bản exact tại Thư Viện Pháp Luật. Mục tiêu: 1 nguồn truth duy nhất cho citation, hỗ trợ tooling validate citation hết hiệu lực, render bảng status theo date. Phân loại status:

• in-force: đã hiệu lực, đang áp dụng
• future-effective: đã ban hành, chưa hiệu lực
• transition: đang trong giai đoạn chuyển tiếp
• superseded: đã bị thay thế
• expired: hết hiệu lực không có thay thế

Danh mục đường dùng thuốc theo quy định của Bộ Y tế Việt Nam. Phân loại 7 nhóm: uống, tiêm, bôi ngoài, đặt, hô hấp, mắt/tai, khác. Căn cứ: Dược điển Việt Nam, Luật Dược 2016, thực hành lâm sàng BV. Nguồn dữ liệu: OHP Data Processor (production mapping).

Tập giá trị bài thuốc theo thể lâm sàng y học cổ truyền. 522 bài thuốc. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL VI.

Tập giá trị bệnh danh Y học cổ truyền và các thể lâm sàng theo QĐ 2552/QĐ-BYT Phụ lục I. Bao gồm 228 mã (38 bệnh danh + 190 thể lâm sàng). FHIR code sử dụng Mã U / Mã hóa chính thức; Mã dùng chung được bảo toàn ở concept property ma-dung-chung của CodeSystem.

Tập giá trị chuyên khoa y tế Việt Nam. / ValueSet of Vietnamese medical specialties.

Tập giá trị chẩn đoán y học cổ truyền bao gồm bát cương, tạng phủ biện chứng, lục kinh biện chứng, vệ khí dinh huyết biện chứng, tam tiêu biện chứng. 106 thuật ngữ từ QĐ 2552/QĐ-BYT (12/8/2025).

Tập giá trị chỉ số cận lâm sàng Đợt 1. 2.964 chỉ số từ QĐ 1227/QĐ-BYT (11/04/2025). Mỗi chỉ số có ánh xạ LOINC (100%). / ValueSet for Vietnam Clinical Lab Indicators (Batch 1), 2,964 codes per QĐ 1227/QĐ-BYT. Each maps to LOINC.

Tập giá trị chức danh nghề nghiệp viên chức ngành y tế Việt Nam (hệ V.08). / ValueSet of Vietnamese healthcare civil service position codes (V.08 series).

Tập giá trị cấp khám bệnh, chữa bệnh hiện hành theo Luật KCB 2023 và NĐ 96/2023/NĐ-CP; có thể dùng trong các bài toán BHYT theo NĐ 188/2025/NĐ-CP.

Tập giá trị cấp quản lý hành chính y tế hiện hành. Không dùng thay cho tuyến chuyên môn kỹ thuật lịch sử.

ValueSet chứa 14 mã danh mục chi phí KCB theo QĐ 697/QĐ-BYT (19/3/2026). Dùng để phân loại chi phí trong Claim/ExplanationOfBenefit.

Tập giá trị bao gồm tất cả mã dân tộc từ Danh mục Dân tộc Việt Nam (TCTK).

Tập giá trị mã dịch vụ BHYT ví dụ cục bộ dùng để làm sạch XML3 round-trip seed cho 2 dòng khám/chăm sóc đang chưa có mapping chính thức tương ứng. Hai dòng này hiện được giữ example-only theo quyết định governance vì chưa có nguồn mã official đúng loại để publish. Chỉ phục vụ example trong repo, không phải binding cho danh mục dịch vụ chính thức.

Tập giá trị mã khoa trong cơ sở KCB. Căn cứ: QĐ 2010/QĐ-BYT (19/6/2025).

Tập giá trị bao gồm tất cả 696 quận/huyện cũ (trước NQ 202/2025). Dùng cho backward-compatibility khi cần tra cứu hoặc chuyển đổi dữ liệu địa chỉ cũ.

Tập giá trị bao gồm tất cả mã tôn giáo từ Danh mục Tôn giáo Việt Nam.

Tập giá trị chỉ bao gồm 34 tỉnh/thành phố đang hoạt động theo NQ 202/2025. Không bao gồm mã cũ (inactive).

Tập giá trị bao gồm tất cả xã/phường/thị trấn theo NQ 202/2025.

Toàn bộ mã danh pháp thiết bị y tế Việt Nam trong VNMedicalDeviceNomenclatureCS. ValueSet này thuộc package hl7.fhir.vn.device và dùng cho lookup/coverage, không tự định nghĩa binding policy.

Tập giá trị dược liệu và vật tư cổ truyền. 442 vị thuốc với tên khoa học. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL V.

Tập giá trị dải điểm chất lượng cơ sở KCB theo NĐ 188/2025/NĐ-CP.

Tập giá trị huyệt châm cứu theo y học cổ truyền. 466 huyệt với tên quốc tế và ánh xạ SNOMED CT. Từ QĐ 2552/QĐ-BYT (12/8/2025) — PL III.

Tập mã hình thức đến khám chữa bệnh (HTCHUYEN per QĐ 3176/QĐ-BYT).

Tập giá trị phân hạng cơ sở KCB theo TT 06/2024/TT-BYT.

Tập giá trị phân hạng đơn vị sự nghiệp y tế không phải cơ sở khám bệnh, chữa bệnh theo TT 06/2024/TT-BYT.

Tập giá trị mã chẩn đoán ICD-10 Việt Nam dùng cho chẩn đoán bắt buộc trong VN Core. Căn cứ: QĐ 4469/QĐ-BYT (28/10/2020), QĐ 98/QĐ-BYT (14/01/2022) và TT 06/2026/TT-BYT (ban hành 02/04/2026, hiệu lực 01/07/2026 — future-effective) về mã hóa bệnh tật, nguyên nhân tử vong theo ICD-10.

Tập giá trị kết quả điều trị theo QĐ 130/QĐ-BYT (thay thế QĐ 4210), sửa đổi bổ sung bởi QĐ 3176/QĐ-BYT (2024).

Tập giá trị kỹ thuật y học cổ truyền. 925 kỹ thuật tham chiếu TT 23/2024/TT-BYT. Từ QĐ 2552/QĐ-BYT (12/8/2025) — PL IV.

ValueSet gộp mã adjudication chuẩn HL7 và mã bổ sung của VN Core cho tổng hợp tài chính BHYT. Binding dùng extensible để giữ tương thích với FHIR R4 và cho phép payer-specific codes khi pilot có căn cứ.

Tập giá trị loại chương trình tiêm chủng tại Việt Nam: TCMR, dịch vụ, chiến dịch. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.

Tập giá trị loại hình dịch vụ y tế tuyến cơ sở (đặc biệt cho TYT cấp xã/phường/đặc khu) theo VBHN 06/2026/VBHN-BYT Điều 3-4. Dùng cho HealthcareService.type với binding extensible.

Tập giá trị phân loại yêu cầu dịch vụ y tế Việt Nam. / ValueSet of Vietnamese medical service request categories.

Tập giá trị loại hình cơ sở y tế theo Luật KCB 2023.

Tập giá trị loại khám chữa bệnh BHYT theo QĐ 130/QĐ-BYT (thay thế QĐ 4210), sửa đổi bổ sung bởi QĐ 3176/QĐ-BYT (2024).

Tập giá trị mã loại KCB (MA_LOAI_KCB). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024).

ValueSet dùng làm binding preferred cho Device.type hoặc DeviceDefinition.type trong package hl7.fhir.vn.device. Hiện include toàn bộ danh pháp Việt Nam; các phiên bản sau có thể chuyển thành subset curated hoặc bổ sung hệ quốc tế khi license/provenance đủ. VN Core không required-bind Device.type vào ValueSet này.

Tập giá trị loại vaccine theo bệnh/nhóm bệnh cho VNCoreImmunization, bao gồm TCMR và các vaccine dịch vụ/chiến dịch phổ biến. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.

Tập giá trị 3 loại đơn vị hành chính cấp xã theo Luật 72/2025/QH15: xã, phường, đặc khu.

Tập giá trị bao gồm tất cả loại định danh Việt Nam, kết hợp với HL7 v2 Table 0203.

Tập giá trị loại đối tượng tham gia BHYT.

Tập mã loại đồng ý xử lý dữ liệu cá nhân trong y tế Việt Nam. Căn cứ: Luật 91/2025/QH15.

Tập giá trị lý do bất khả kháng cho phép tạm thời để trống CCCD trong hồ sơ BHYT. Không dùng ValueSet này cho trường hợp đã có định danh thay thế hợp lệ như hộ chiếu hoặc giấy khai sinh.

Tập giá trị lý do không thực hiện tiêm chủng trong VNCoreImmunization. Bao gồm các lý do tối thiểu phục vụ vận hành TCMR, tiêm chủng dịch vụ và chiến dịch. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.

Tập giá trị bất thường hình thái dựa trên SNOMED CT Morphologically abnormal structure. Bộ Y tế Việt Nam đã ban hành subset SNOMED CT VN Đợt 2 cho Morphologic Abnormality theo QĐ 2493/QĐ-BYT (08/2025), gồm khoảng 5.155 concepts. ValueSet này dùng cho VNCoreDiagnosticReportPathology.conclusionCode với binding extensible.

ValueSet toàn bộ các mã prefix BCA hợp lệ dùng để kiểm tra ba chữ số đầu của số định danh cá nhân/CCCD 12 số.

Tập giá trị mã chẩn đoán cho VN Core, bao gồm:

• ICD-10 WHO (bắt buộc theo QĐ 4469/QĐ-BYT 28/10/2020, bổ sung bởi QĐ 98/QĐ-BYT 14/01/2022) — 15.026 mã
• SNOMED CT IPS Terminology — Clinical Findings (tùy chọn, miễn phí theo CC-BY-4.0) — 36.349 mã trong VN subset
• YHCT Mã U — 228 bệnh danh và thể lâm sàng y học cổ truyền theo QĐ 2552/QĐ-BYT Phụ lục I Binding extensible — cho phép dual/triple coding: ICD-10 + SNOMED CT + YHCT. Lưu ý: Mã U YHCT KHÔNG PHẢI ICD-10, là hệ thống mã quốc gia riêng; FHIR code dùng Mã U/Mã hóa chính thức, còn Mã dùng chung được bảo toàn trong CodeSystem property. ICD-11 đang trong Phase II lộ trình 2026, chưa thay thế ICD-10 tại Việt Nam.

Tập giá trị mã dị ứng/bất dung nạp cho VN Core, dựa trên SNOMED CT IPS Terminology. Việt Nam không có bộ mã dị ứng quốc gia — sử dụng SNOMED CT IPS (miễn phí, CC-BY-4.0). VN subset Đợt 3 (QĐ 2805/QĐ-BYT 2025): 1.327 Allergy concepts có bản dịch tiếng Việt. Binding extensible — cho phép text mô tả nếu không có mã SNOMED phù hợp.

Tập giá trị LOINC cho sinh hiệu VN Core, bao gồm huyết áp, mạch, nhịp thở, SpO2, nhiệt độ, chiều cao, cân nặng và BMI. Căn cứ triển khai: TT 13/2025/TT-BYT (06/06/2025) về bệnh án điện tử; QĐ 1227/QĐ-BYT (11/04/2025) ban hành danh mục mã dùng chung đối với kỹ thuật, thuật ngữ chỉ số cận lâm sàng và phục vụ ánh xạ LOINC.

Tập giá trị MA_NHOM dùng trong XML2/XML3 chuẩn dữ liệu đầu ra KCB theo QĐ 3176/QĐ-BYT.

Tập giá trị mã tai nạn (MA_TAI_NAN). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024), Bảng 8.

Tập giá trị mã thủ thuật/phẫu thuật ICD-9-CM phiên bản Việt Nam. 3.882 mã từ QĐ 387/QĐ-BYT (05/02/2026), dựa trên CMS V32. Ánh xạ với danh mục DVKT VN theo QĐ 4466/QĐ-BYT (2020). Binding extensible — cho phép mã DVKT VN hoặc SNOMED CT khi cần.

Tập giá trị mã thủ thuật và dịch vụ kỹ thuật y tế cho VN Core, bao gồm:

• ICD-9-CM (Volume 3) — 3.882 mã thủ thuật VN (QĐ 387/QĐ-BYT 05/02/2026, CMS V32)
• SNOMED CT IPS Terminology — Procedures (miễn phí, CC-BY-4.0) Binding extensible — cho phép mã danh mục DVKT VN (TT 20/2014, TT 39/2018). Ánh xạ DVKT VN ↔ ICD-9-CM theo QĐ 4466/QĐ-BYT (2020).

Tập giá trị mã đối tượng đến khám bệnh, chữa bệnh (MA_DOITUONG_KCB) theo QĐ 3276/QĐ-BYT (17/10/2025). 27 mã, chia 5 nhóm: KCB BHYT (nhóm 1), Cấp cứu (nhóm 2), Trái tuyến (nhóm 3), Lĩnh thuốc (nhóm 7), Khác (nhóm 8-10).

Tập mã mục đích xử lý dữ liệu cá nhân trong y tế Việt Nam. Căn cứ: Luật 91/2025/QH15 — Bảo vệ dữ liệu cá nhân.

Tập giá trị nghề nghiệp theo VSCO 2020 (QĐ 34/2020/QĐ-TTg). Bao gồm tất cả 1.516 mã nghề nghiệp 5 cấp.

All occupation codes from VSCO 2020, covering 5 hierarchical levels. ISCO-08 compatible at Levels 1-4.

Tập giá trị nguồn chi trả cho Immunization.fundingSource trong bối cảnh Việt Nam. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.

Tập giá trị nguồn chi trả (NGUON_CTRA). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024).

Tập mã nhóm issue cục bộ dùng cho ClaimResponse.error và OperationOutcome.issue.details trong pilot BHYT. Giữ ở mức baseline taxonomy, không đại diện cho catalog mã lỗi payer/gateway chính thức đầy đủ.

Tập giá trị 9 nhóm thiết bị y tế theo TT 04/2017/TT-BYT Phụ lục 01, được sửa đổi bởi TT 24/2025/TT-BYT và hợp nhất trong VBHN 14/VBHN-BYT năm 2025.

Tập giá trị pháp điều trị y học cổ truyền. 77 pháp trị. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL IV.

Tập giá trị phân loại rủi ro thiết bị y tế A/B/C/D theo NĐ 98/2021/NĐ-CP Điều 4 và TT 05/2022/TT-BYT.

Phương thức thanh toán KCB BHYT: FFS, Capitation, DRG. Mapping XML 3176: MA_PTTT_QT.

Tập giá trị phương thức thể hiện sự đồng ý của chủ thể dữ liệu cá nhân theo NĐ 356/2025/NĐ-CP Điều 6. Dùng required cho VNCoreExtConsentMethod trên Consent.provision.

Tập giá trị phạm vi hưởng BHYT (PHAM_VI). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024).

Tập giá trị quốc tịch dùng cho extension chuẩn patient-citizenship. Sử dụng hệ mã ISO 3166-1 alpha-2 (urn:iso:std:iso:3166) để thay thế binding mặc định tới http://hl7.org/fhir/ValueSet/country, giúp validator và implementer trong VN Core có một canonical ổn định hơn.

Tập giá trị triệu chứng lưỡi theo y học cổ truyền. 39 triệu chứng. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL II.

Tập giá trị triệu chứng mạch theo y học cổ truyền. 18 loại mạch. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL III.

Tập giá trị triệu chứng theo thể lâm sàng y học cổ truyền. 1451 triệu chứng. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL I.

Tập giá trị trình độ chuyên môn của nhân viên y tế Việt Nam. / ValueSet of Vietnamese healthcare professional qualification levels.

Tập giá trị trường tổng tiền BHYT dùng làm source cho ConceptMap tài chính/adjudication và traceability export XML.

Bộ giá trị trạng thái giám định, quyết toán hồ sơ thanh toán BHYT điện tử. Bind extensible cho VNCorePaymentReconciliation.outcome. Căn cứ TT 12/2026/TT-BTC; biểu mẫu 06/BH.

Tập giá trị tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT, chỉ dùng cho dữ liệu legacy.

Tập giá trị tình trạng ra viện theo QĐ 130/QĐ-BYT (thay thế QĐ 4210), sửa đổi bổ sung bởi QĐ 3176/QĐ-BYT (2024).

Tập giá trị trạng thái xếp hạng dùng để biểu diễn cơ sở đã xếp hạng, chưa xếp hạng hoặc không áp dụng.

Tập giá trị tham chiếu văn bản pháp luật Việt Nam, bao gồm Luật, Nghị quyết, Nghị định, Thông tư, Quyết định và Văn bản hợp nhất. Dùng cho extension VNCoreExtLegalBasis để tag legal basis structured trên artifact/element.

Tập giá trị vị trí giải phẫu (body site) dựa trên SNOMED CT Body Structures. BYT Việt Nam đã ban hành 35.889 concepts Body Structure tiếng Việt (QĐ 2427/QĐ-BYT 2025, Đợt 1). Kết hợp SNOMED CT IPS Terminology (miễn phí, CC-BY-4.0). Binding preferred — cho phép text mô tả nếu không có mã SNOMED phù hợp.

Tập giá trị đường dùng thuốc theo BYT. Dùng cho MedicationRequest.dosageInstruction.route.

ConceptMap NON-AUTHORITATIVE DRAFT chuyển đổi 63 mã tỉnh/thành cũ (trước 01/07/2025) sang 34 mã tỉnh/thành mới theo:

• NQ 202/2025/QH15 (Sắp xếp đơn vị hành chính cấp tỉnh) — hiệu lực 01/07/2025
• QĐ 19/2025/QĐ-TTg (Bảng danh mục và mã số ĐVHC) — Phụ lục I 34 tỉnh

Các trường hợp trong mapping:

• equivalent: 11 tỉnh/TP giữ nguyên (mã cũ = mã mới)
• narrower: tỉnh cũ thuộc nhóm sáp nhập, mã cũ nhỏ hơn (specific) so với tỉnh mới (broader)
• disjoint: trường hợp không xác định được mapping (nếu có)

Cảnh báo: TCTK và Bộ Nội vụ chưa publish ConceptMap chính thức 63→34. Bản này là draft research-based, dùng cho:

• Tham chiếu data legacy khi convert sang ĐVHC mới
• Backward compatibility cho dữ liệu BHYT trước 01/07/2025
• KHÔNG dùng cho thanh toán BHYT chính thức trước khi BHXH/Bộ Y tế xác nhận.

ConceptMap ánh xạ mã chỉ số cận lâm sàng Việt Nam (CLS VN) sang mã LOINC quốc tế. Căn cứ: QĐ 1227/QĐ-BYT (11/04/2025) — Danh mục mã dùng chung chỉ số cận lâm sàng (Đợt 1). 2.964 chỉ số, 100% coverage ánh xạ LOINC (Regenstrief Institute).

5 nhóm:

• PL01: Huyết học — Truyền máu (1.022 chỉ số)
• PL02: Sinh hóa (447 chỉ số)
• PL03: Vi sinh (174 chỉ số)
• PL04: Giải phẫu bệnh (81 chỉ số)
• PL05: Chẩn đoán hình ảnh (1.240 chỉ số)

Dữ liệu mapping đầy đủ tại: data/cls/qd1227_cls_loinc_mapping.json Ví dụ dưới đây chỉ bao gồm 5 mã đại diện (1 mã/nhóm).

ConceptMap ánh xạ mã MA_NHOM trong XML2/XML3 theo QĐ 3176/QĐ-BYT sang VNCostCategoryCS theo QĐ 697/QĐ-BYT. Dùng trong lớp export/import BHYT; không dùng trực tiếp mã nguồn QĐ 3176 như mã đích QĐ 697.

ConceptMap ánh xạ các trường tổng tiền BHYT từ QĐ 3176/QĐ-BYT và bối cảnh bảng kê/giám định sang category dùng trong ClaimResponse.total, ExplanationOfBenefit.total và VNCoreExtClaimCostSummary. ConceptMap này chỉ chuẩn hóa mã category; không encode công thức quyền lợi, tỷ lệ hưởng, trần thanh toán hoặc catalog lý do từ chối của payer. Các trường breakdown nguồn khác T_NGUONKHAC_NSNN, T_NGUONKHAC_VTNN, T_NGUONKHAC_VTTN, T_NGUONKHAC_CL hiện được giữ ở source terminology và chưa map ra target riêng.

ConceptMap ánh xạ một phần danh mục tôn giáo Việt Nam sang bộ mã v3-ReligiousAffiliation của HL7. Chỉ khai báo các ánh xạ có thể bảo vệ được về ngữ nghĩa. Các mã kỹ thuật như 00 = Không tôn giáo, 99 = Không rõ và các tôn giáo bản địa hoặc nhóm chuyên biệt chưa có tương đương rõ trong v3-ReligiousAffiliation sẽ không bị ép ánh xạ.

Hệ thống định danh endpoint điện tử để cơ sở khám chữa bệnh (CSKCB) gửi hồ sơ giám định, thanh toán, quyết toán chi phí KCB BHYT lên Bảo hiểm Xã hội Việt Nam. URI cổng: https://gdbhyt.baohiemxahoi.gov.vn Căn cứ:

• TT 12/2026/TT-BTC (Bộ Tài chính, 03/2026), Điều 2 — quy định CSKCB gửi hồ sơ giám định, quyết toán chi phí KCB BHYT qua cổng gdbhyt;
• NĐ 164/2025/NĐ-CP (29/06/2025) — giao dịch điện tử trong lĩnh vực BHXH/BHYT. Dùng cho Endpoint.address của VNCoreEndpointBHYT và Organization.endpoint của VNCoreOrganization (CSKCB ký hợp đồng BHXH).

Hệ định danh cục bộ dành cho mã mẫu bệnh phẩm và mã tiếp nhận mẫu trong LIS/HIS của từng cơ sở y tế. Dùng khi chưa có hệ định danh quốc gia thống nhất cho Specimen. / Local naming system for specimen identifiers and accession numbers assigned by a facility LIS/HIS.

Hệ thống mã bệnh nhân nội bộ (Medical Record Number), do từng cơ sở y tế tự quản lý. Format và quy tắc đánh mã do từng bệnh viện tự quy định. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), Luật KCB 2023 (15/2023/QH15).

Hệ thống mã cơ sở khám chữa bệnh (5 chữ số), do BHXH Việt Nam cấp. Dùng để định danh các cơ sở y tế trong hệ thống thanh toán BHYT. Căn cứ: Luật KCB 2023 (15/2023/QH15), BHXH Việt Nam.

Hệ thống định danh cho mã liên kết hồ sơ MA_LK, dùng để liên kết toàn bộ dữ liệu của cùng một đợt khám chữa bệnh trong lớp liên thông hồ sơ BHYT. Áp dụng cho Bundle.identifier và Claim.identifier.

Hệ thống định danh khuyến nghị cho mã lượt khám MA_LUOT_KCB của Encounter. Mã này dùng để đối soát một lượt khám cụ thể tại cơ sở khám chữa bệnh, khác với MA_LK là mã liên kết của hồ sơ thanh toán BHYT.

Hệ thống định danh cho mã phản hồi của Cổng tiếp nhận dữ liệu BHYT, ví dụ XML1_ID trong báo cáo/response gateway. Đây là mã phản hồi tiếp nhận/giám định, không phải MA_LK và không được dùng để thay thế mã liên kết hồ sơ.

Hệ thống định danh Mã số Bảo hiểm xã hội (10 chữ số), do BHXH Việt Nam cấp. Gắn với sổ BHXH, dùng để tra cứu quá trình tham gia BHXH/BHYT/BHTN. Liên thông với CCCD nhưng vẫn tồn tại song song per NĐ 164/2025/NĐ-CP. Căn cứ bổ sung:

• Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• NĐ 164/2025/NĐ-CP — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH.

Namespace khuyến nghị cho mã tài liệu lâm sàng nội bộ do cơ sở y tế phát sinh, dùng cho Composition.identifier và DocumentReference.identifier khi chưa có NamingSystem riêng của từng cơ sở.

Hệ thống mã vật tư/thiết bị y tế dùng trong dữ liệu KCB/BHYT hoặc dữ liệu lịch sử. Mã này phục vụ mapping trường MA_VAT_TU và dòng chi phí thiết bị/vật tư; không phải UDI, serial number, mã tài sản, số lưu hành hoặc định danh vật lý duy nhất của một thiết bị. Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024), TT 04/2017/TT-BYT, TT 24/2025/TT-BYT, QĐ 3514/QĐ-BYT (2024) và các quyết định mã hàng VTYT lịch sử như QĐ 2178/QĐ-BYT, QĐ 5086/QĐ-BYT, QĐ 637/QĐ-BYT, QĐ 1844/QĐ-BYT, QĐ 2807/QĐ-BYT, QĐ 3181/QĐ-BYT.

Hệ thống định danh cục bộ cho Organization khi chưa có mã dùng chung cấp quốc gia tương ứng với ngữ cảnh nghiệp vụ.

Hệ thống định danh cục bộ cho Location trong phạm vi từng cơ sở y tế hoặc từng hệ thống HIS/EMR.

Hệ thống định danh số accession cho nghiên cứu chẩn đoán hình ảnh trong RIS/PACS/HIS tại Việt Nam. Giá trị cụ thể do từng cơ sở hoặc hệ thống phát sinh và quản lý.

Hệ thống định danh Số Chứng chỉ hành nghề y được cấp theo khung pháp lý trước Luật KCB 2023. Giữ lại để chuyển đổi dữ liệu lịch sử và đối soát hồ sơ cũ. Format không cố định, tùy từng đợt cấp phép trước đây.

Hệ thống định danh Số Chứng minh nhân dân (9 hoặc 12 chữ số), do Bộ Công an cấp. Đã thay thế bởi CCCD (Căn cước công dân) per Luật Căn cước 2023. CMND vẫn hợp lệ cho mục đích backward-compatibility đến 2030. Lưu ý: CMND 9 số (cũ) và CMND 12 số (2012-2023) đều tồn tại trong hệ thống y tế.

Hệ thống định danh Số Căn cước công dân (12 chữ số), do Bộ Công an cấp. Là số định danh cá nhân duy nhất theo Luật Căn cước 2023 (26/2023/QH15). Từ 01/7/2025, thay thế mã số thuế cá nhân. Bắt buộc cho bệnh án điện tử theo TT 13/2025/TT-BYT. Liên kết với dữ liệu người bệnh trong CSDL quốc gia về y tế theo NĐ 102/2025/NĐ-CP (13/5/2025).

Hệ thống định danh Số Giấy khai sinh do UBND xã/phường/đặc khu cấp. Dùng cho trẻ em hoặc trường hợp chưa có số định danh cá nhân/CCCD nhưng cần liên thông hồ sơ BHYT và EMR.

Hệ thống định danh Số Giấy phép hành nghề khám bệnh, chữa bệnh theo Luật KCB 2023 và NĐ 96/2023/NĐ-CP. Đây là định danh hành nghề current của Practitioner trong dữ liệu mới.

Hệ thống định danh Số Hộ chiếu Việt Nam, do Bộ Công an (trong nước) hoặc Bộ Ngoại giao (ngoài nước) cấp. Dùng cho bệnh nhân nước ngoài hoặc công dân Việt Nam chưa có CCCD (Việt kiều, trẻ em). Hộ chiếu VN mới (từ 2022): mã quốc gia + 8 chữ số.

Hệ thống định danh số lưu hành (registration number) của thiết bị y tế tại Việt Nam. Số lưu hành do Bộ Y tế (Cục Hạ tầng và Thiết bị y tế) cấp cho thiết bị y tế thuộc loại B, C, D theo quy trình đăng ký lưu hành quy định tại NĐ 98/2021/NĐ-CP (08/11/2021), đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP (03/03/2023) và NĐ 04/2025/NĐ-CP (hiệu lực 01/01/2025). Đây là định danh ở mức sản phẩm/model/regulatory context (không phải định danh per-instance như UDI hoặc serial number); một số lưu hành áp dụng cho mọi thiết bị cùng model đã được đăng ký lưu hành. Lưu ý: Thiết bị y tế loại A theo NĐ 98/2021 thực hiện công bố tiêu chuẩn áp dụng (không cấp số lưu hành) — định danh khác.

Hệ thống định danh Số thẻ Bảo hiểm Y tế, do BHXH Việt Nam cấp. Hỗ trợ 3 format (hiện duy trì song song):

• CCCD 12 chữ số: hỗ trợ từ 15/8/2025 (NĐ 188/2025/NĐ-CP, hiệu lực 15/8/2025)
• Mã số BHXH 10 chữ số: từ 01/4/2021
• Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021 Bên triển khai cần xác minh chính sách BHXH hiện hành trước khi coi CCCD là mã BHYT duy nhất. Căn cứ:
• Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT, hỗ trợ định danh BHYT theo CCCD
• QĐ 3176/QĐ-BYT — 29/10/2024 — chuẩn dữ liệu đầu ra KCB phục vụ BHXH
• Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.

Hệ thống định danh cho tài khoản định danh điện tử VNeID do Bộ Công an quản lý. VNeID tích hợp hoặc hiển thị CCCD, BHYT và các giấy tờ điện tử khác trên ứng dụng/nền tảng định danh điện tử. Trong VN Core, URI này chỉ nên dùng cho lớp tích hợp tài khoản/xác thực khi có căn cứ nghiệp vụ rõ ràng; không model như patient identifier gốc song song với CCCD.

Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho HIS/EMR hoặc middleware đóng vai trò client trong lớp liên thông hồ sơ BHYT, chịu trách nhiệm gửi hồ sơ thanh toán BHYT. / Minimum conformance requirements for payer submission clients using the VN Core BHYT Submission layer.

Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho máy chủ/facade tiếp nhận hồ sơ thanh toán BHYT từ HIS/EMR. Tập trung vào lớp liên thông hồ sơ BHYT, MA_LK, các operation kiểm tra hợp lệ/gửi/thu hồi và các quy tắc định dạng xuất cổng. / Minimum conformance requirements for payer-facing BHYT submission servers.

Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho ứng dụng người dân/cổng công dân/kết nối VNeID. Tập trung vào truy cập hồ sơ cá nhân, giấy tờ lâm sàng, Consent và lịch sử truy cập. / Minimum conformance requirements for citizen-facing or VNeID-connected apps.

Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho máy chủ EMR/EHR nội bộ triển khai VN Core Base. Tập trung vào hồ sơ bệnh nhân, hồ sơ lâm sàng, tài liệu, Consent, AuditEvent và Provenance. / Minimum conformance requirements for internal EMR/EHR servers implementing VN Core Base.

Yêu cầu tuân thủ tối thiểu ở mức cơ sở mà một máy chủ FHIR PHẢI đáp ứng để tuân thủ VN Core IG. Bao gồm các tài nguyên cốt lõi hành chính, lâm sàng, tài chính, quản trị dữ liệu và lớp liên thông hồ sơ BHYT (BHYT Submission) với các tương tác read, search-type, create và update. Các vai trò triển khai cụ thể nên tham chiếu thêm các CapabilityStatement chuyên biệt cho EMR, cổng BHYT và ứng dụng người dân. / Minimum conformance requirements for a FHIR server implementing VN Core IG.

OperationDefinition cho phép đóng gói và gửi hồ sơ thanh toán BHYT lên Cổng giám định BHXH.

OperationDefinition cho phép thu hồi hoặc hủy hồ sơ BHYT đã gửi.

OperationDefinition cho phép kiểm tra hồ sơ BHYT trước khi gửi Cổng giám định BHXH.

SearchParameter cho phép tìm kiếm Patient theo số Giấy khai sinh để hỗ trợ hồ sơ trẻ em, sơ sinh và đối soát BHYT trước khi hoàn tất định danh số.

SearchParameter cho phép tìm kiếm Patient theo mã số BHXH 10 chữ số để hỗ trợ các workflow BHYT và đối soát dữ liệu legacy.

SearchParameter cho phép tìm kiếm Patient theo số CCCD (Căn cước công dân 12 chữ số). Ví dụ: GET [base]/Patient?vn-cccd=001099012345

SearchParameter cho phép tìm kiếm Patient theo số thẻ BHYT. Hỗ trợ cả 3 format (duy trì song song): CCCD 12 số (từ 15/8/2025 per NĐ 188/2025), BHXH 10 số, legacy 15 ký tự. Ví dụ: GET [base]/Patient?vn-bhyt=001099012345

SearchParameter cho phép tìm kiếm Condition theo mã bệnh ICD-10. Căn cứ: QĐ 4469/QĐ-BYT (28/10/2020) — Ban hành Bảng phân loại quốc tế bệnh tật ICD-10, bổ sung bởi QĐ 98/QĐ-BYT (14/01/2022) — COVID-19 codes U07.1, U07.2. Ví dụ: GET [base]/Condition?vn-icd10=http://hl7.org/fhir/sid/icd-10|J18.9

SearchParameter cho phép tìm kiếm Claim theo mã liên kết hồ sơ MA_LK. Ví dụ: GET [base]/Claim?vn-ma-lk=http://fhir.hl7.org.vn/core/sid/ma-lk|LK-2026-000123

SearchParameter cho phép tra cứu ClaimResponse theo XML1_ID hoặc mã phản hồi gateway tương đương. Ví dụ: GET [base]/ClaimResponse?vn-xml1-id=http://fhir.hl7.org.vn/core/sid/bhyt-gateway-response-id|XML1-20260322-000042

SearchParameter cho phép tìm kiếm Coverage theo mã nơi đăng ký KCB ban đầu MA_DKBD. Ví dụ: GET [base]/Coverage?vn-ma-dkbd=79001

SearchParameter cho phép tìm kiếm Organization theo mã cơ sở KCB (5 chữ số, BHXH cấp). Ví dụ: GET [base]/Organization?vn-cskcb=79001

SearchParameter cho phép tìm kiếm Device theo mã vật tư/thiết bị y tế (MA_VAT_TU) trong dữ liệu BHXH. Căn cứ: QĐ 3176/QĐ-BYT — trường MA_VAT_TU. Ví dụ: GET [base]/Device?vn-ma-vat-tu=VT-STENT-DES-001

SearchParameter cho phép tìm kiếm Device theo nhóm TBYT BHYT (N01-N09). Căn cứ: TT 04/2017/TT-BYT Phụ lục 01, TT 24/2025/TT-BYT, VBHN 14/VBHN-BYT. Ví dụ:

• GET [base]/Device?vn-device-group=N06.00.000 — tìm thiết bị cấy ghép
• GET [base]/Device?vn-device-group=N03.00.000 — tìm vật tư chăm sóc

SearchParameter cho phép tìm kiếm Device theo phân loại rủi ro A/B/C/D. Căn cứ: NĐ 98/2021/NĐ-CP Điều 4 (đã sửa NĐ 07/2023, NĐ 04/2025), TT 05/2022/TT-BYT (đã sửa TT 59/2025). Ví dụ:

• GET [base]/Device?vn-risk-class=D — tìm tất cả thiết bị loại D
• GET [base]/Device?vn-risk-class=C,D — tìm thiết bị C hoặc D

SearchParameter cho phép tìm kiếm Device theo số lưu hành TBYT do Cục Hạ tầng & Thiết bị y tế cấp. Căn cứ: NĐ 98/2021/NĐ-CP Chương III (đã sửa NĐ 07/2023, NĐ 04/2025) — đăng ký lưu hành TBYT. Ví dụ: GET [base]/Device?vn-registration-number=20255555/BYT-CCHTBYT

SearchParameter cho phép tìm kiếm Encounter theo mã lượt khám MA_LUOT_KCB. Ví dụ: GET [base]/Encounter?vn-ma-luot-kcb=http://fhir.hl7.org.vn/core/sid/ma-luot-kcb|LK-2026-04-05-0142

SearchParameter cho phép tìm kiếm Encounter theo loại KCB BHYT (trường MALYDO). Giá trị: 1=Đúng tuyến, 2=Cấp cứu, 3=Trái tuyến, 4=Thông tuyến, 5=KCB ban đầu. Căn cứ: QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024). Ví dụ: GET [base]/Encounter?vn-malydo=1

SearchParameter cho phép tìm kiếm Practitioner theo số Chứng chỉ hành nghề (CCHN) lịch sử. Dùng cho chuyển đổi và tra cứu hồ sơ được lập theo khung pháp lý trước Luật KCB 2023. Ví dụ: GET [base]/Practitioner?vn-cchn=012345

SearchParameter cho phép tìm kiếm Practitioner theo số Giấy phép hành nghề khám bệnh, chữa bệnh. Căn cứ: Luật KCB 2023 (15/2023/QH15), NĐ 96/2023/NĐ-CP. Ví dụ: GET [base]/Practitioner?vn-gphn=79/GPHN-BYT-0001234

SearchParameter lịch sử cho phép tìm kiếm Patient theo tài khoản định danh điện tử VNeID. Artifact này được giữ lại để ghi nhận quyết định thiết kế cũ, nhưng không còn được khuyến nghị công bố trong CapabilityStatement core vì VNeID không được coi là định danh bệnh nhân gốc song song với CCCD.

SearchParameter cho phép tìm kiếm Coverage theo số thẻ BHYT (trường identifier). Hỗ trợ cả 3 format (duy trì song song): CCCD 12 số (từ 15/8/2025 per NĐ 188/2025), BHXH 10 số, legacy 15 ký tự. Căn cứ: Luật BHYT 2008 sửa đổi 2014, NĐ 188/2025/NĐ-CP (hiệu lực 15/8/2025). Ví dụ: GET [base]/Coverage?vn-bhyt-card=http://fhir.hl7.org.vn/core/sid/bhyt|001085012345

Ví dụ bundle dùng cho validation âm tính. Bundle thiếu identifier MA_LK ở cấp bundle nên phải bị từ chối khi validate theo VNCoreBHYTSubmissionBundle.

Ví dụ parameters dùng cho validation âm tính. exportDateTime đang ở format ISO 8601 thay vì yyyyMMddHHmm.

Bệnh nhân bất tỉnh nhập cấp cứu BV Chợ Rẫy, chưa có giấy tờ tùy thân. Minh họa: data-absent-reason trên birthDate và identifier[CCCD].value, gender = #unknown, chỉ có MRN tạm thời. Danh tính cần cập nhật sau khi bệnh nhân tỉnh hoặc thân nhân xác nhận.

Chẩn đoán ban đầu K35.8 (viêm ruột thừa cấp) bị bác bỏ sau CT scan bụng. verificationStatus = #refuted, clinicalStatus = #inactive. Chẩn đoán xác định: I88.0 (viêm hạch mạc treo — ghi trong Condition riêng). Minh họa: audit trail y khoa — giữ lại chẩn đoán sai với lý do bác bỏ.

Bệnh nhân xác nhận KHÔNG có tiền sử dị ứng thuốc, thực phẩm hay các chất khác. SNOMED CT 716186003 = 'No known allergy' — mã chuẩn cho NKA. verificationStatus = #confirmed: bác sĩ đã khai thác kỹ và bệnh nhân xác nhận rõ ràng. Minh họa: phân biệt 'NKA đã xác nhận' với 'chưa hỏi về dị ứng'.

Tiếp nhận nhầm bệnh nhân do trùng tên — phát hiện sau 10 phút khi kiểm tra CCCD. status = #entered-in-error: lượt khám vô hiệu, giữ lại để audit trail. Minh họa: cách xử lý nhập sai theo chuẩn FHIR R4 — không xóa, chỉ đánh dấu sai.

Thẻ BHYT đối tượng HN (hộ nghèo) đã hết hạn 31/01/2026 (hết hạn 2 tháng tính đến 20/3/2026). status = #cancelled. Minh họa: cách ghi nhận thẻ hết hiệu lực, hỗ trợ hệ thống phát hiện và cảnh báo tự động.

Xét nghiệm glucose máu lúc đói bị hủy vì mẫu máu bị vỡ hồng cầu (hemolysis). status = #cancelled, không có valueQuantity. dataAbsentReason = #error với mô tả nguyên nhân kỹ thuật. Minh họa: cách ghi nhận lỗi kỹ thuật bệnh phẩm theo chuẩn FHIR R4.

Chẩn đoán 3/3 trong kịch bản đa bệnh: Bệnh thận mãn tính stage 3 (eGFR 30-59). Là hậu quả của HTN (I10) và ĐTĐ type 2 (E11.9) kiểm soát chưa tốt. Cùng bệnh nhân và lượt khám với ExampleConditionMultiHTN và ExampleConditionMultiDM.

Chẩn đoán 1/3 trong kịch bản đa bệnh: Tăng huyết áp nguyên phát. Là nguyên nhân góp phần gây bệnh thận mãn. Cùng bệnh nhân và lượt khám với ExampleConditionMultiDM và ExampleConditionMultiCKD.

Chẩn đoán 2/3 trong kịch bản đa bệnh: Đái tháo đường type 2. Là yếu tố nguy cơ độc lập gây CKD (nefropathy do đái tháo đường). Cùng bệnh nhân và lượt khám với ExampleConditionMultiHTN và ExampleConditionMultiCKD.

Ví dụ tối giản — chỉ gồm các element bắt buộc và Must Support của VNCoreConditionDiagnosis. Không có encounter, không có note, không có onset, không có bodySite. Mục tiêu: cho thấy mức tối thiểu hợp lệ theo VN Core profile.

Bài thuốc cổ phương Độc hoạt ký sinh thang — trị yêu thống thể thận hư, bổ thận, cường cân cốt, khu phong trừ thấp. Dạng thuốc sắc (decoction). Liệt kê 5 vị dược liệu đại diện. Per QĐ 3080/QĐ-BYT (YHCT Đợt 2 — Danh mục Dược liệu và Bài thuốc cổ truyền).

Đơn kê thuốc YHCT ngoại trú: Bài thuốc Độc hoạt ký sinh thang cho bệnh nhân yêu thống thể thận hư. Pháp điều trị: Bổ thận, cường cân cốt, khu phong trừ thấp. Liệu trình 14 thang. Hướng dẫn sắc: sắc 3 lần nước, hợp lại chia 2 lần uống/ngày.

Bệnh án điện tử ngoại trú cho bệnh nhân Nguyễn Văn An khám tăng huyết áp tại BV Chợ Rẫy. Per TT 13/2025/TT-BYT.

Lượt khám kết hợp YHCT + Y học hiện đại: bệnh nhân đau lưng. Chẩn đoán song song: Tây y (ICD-10: M54.5) + YHCT (Yêu thống thể hàn thấp). Điều trị: châm cứu + xoa bóp bấm huyệt + thuốc Tây y giảm đau. Per TT 13/2025/TT-BYT, QĐ 2552/QĐ-BYT (YHCT Đợt 1).

Amlodipine besylate 5mg viên nén — điều trị tăng huyết áp. Nhóm chẹn kênh calci. ATC: C08CA01. BHYT thanh toán.

Đơn thuốc điện tử (ePrescription): Amlodipine 5mg x 1 viên/ngày, uống sáng, 30 ngày. BHYT thanh toán. Per TT 13/2025/TT-BYT, Luật Dược 2016.

Bệnh nhân Nguyễn Văn An đồng ý cho BV Bạch Mai xử lý dữ liệu y tế phục vụ khám chữa bệnh và thanh toán BHYT, thời hạn 5 năm. Per Luật 91/2025/QH15, NĐ 356/2025/NĐ-CP.

Kết quả ALT (SGPT) = 28 U/L — trong giới hạn bình thường, không gợi ý tổn thương tế bào gan. LOINC: 1742-6 (Alanine aminotransferase [Enzymatic activity/volume] in Serum or Plasma). Ví dụ này minh họa kết quả xét nghiệm bình thường — quan trọng để theo dõi thuốc và tầm soát gan. Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — chỉ số CLS nhóm Sinh hóa — Chức năng gan.

Ghi nhận bác sĩ truy cập bệnh án điện tử của bệnh nhân Nguyễn Văn An phục vụ điều trị nội trú.

Document Bundle — bệnh án điện tử nội trú hoàn chỉnh per TT 13/2025/TT-BYT. Nguyễn Văn An nhập cấp cứu viêm ruột thừa cấp K35.8, phẫu thuật nội soi, nằm viện 3 ngày, Ceftriaxone 2g IV hậu phẫu, xuất viện ổn định. Composition có 5 sections chuẩn: lý do, chẩn đoán, thủ thuật, thuốc, ra viện.

Bundle workflow chuyển tuyến — kịch bản đặc thù hệ thống y tế VN. Trần Thị Mai (nữ, 62 tuổi) khám tại trạm y tế xã, nghi nhồi máu cơ tim cấp I21.9, sơ cứu Aspirin 300mg rồi chuyển tuyến lên BV tỉnh Đồng Nai. Bao gồm: giấy chuyển viện (ServiceRequest), ECG bất thường, scan PDF giấy giới thiệu. Mapping: HTCHUYEN=2 (chuyển lên), MALYDO=5 (KCB ban đầu tại trạm y tế).

Bundle BHYT example-only cho VET_THUONG_TP. Flag được đặt trên từng dòng Claim.item và export adapter chỉ xuất literal 1 khi dòng thuốc/DVKT/VTYT thật sự được đánh dấu điều trị vết thương hoặc bệnh tật tái phát cho nhóm người có công/thương binh theo QĐ 130/QĐ-BYT, QĐ 3176/QĐ-BYT.

Bundle hồ sơ BHYT minh họa trường hợp có hai Coverage cùng tồn tại nhưng chỉ một insurance được đánh dấu focal=true theo NĐ 188/2025.

Bundle minh họa ca cấp cứu chưa xác định danh tính nhưng vẫn có hồ sơ BHYT tạm thời.

Bundle hồ sơ thanh toán BHYT minh họa hồ sơ đặc thù HIV/AIDS để phủ bảng 6 trong lớp liên thông hồ sơ BHYT theo QĐ 3176/QĐ-BYT.

Bundle hồ sơ thanh toán BHYT ngoại trú tối thiểu, dùng MA_LK làm khóa liên kết.

Bundle hồ sơ thanh toán BHYT nội trú dùng thêm DiagnosticReport, Composition, DocumentReference và Observation để phủ các bảng BHYT 4-8 và 12 trong lớp liên thông hồ sơ BHYT.

Bundle minh họa ca trẻ sơ sinh chưa có CCCD nhưng có lý do bất khả kháng hợp lệ, đồng thời kèm giấy chứng sinh, giấy nghỉ dưỡng thai và giấy nghỉ việc hưởng BHXH.

Bundle hồ sơ thanh toán BHYT minh họa ca tử vong ở mức FHIR workflow. Không dùng ví dụ này để phủ XML10 QĐ 3176/QĐ-BYT; XML10 hiện là giấy chứng nhận nghỉ dưỡng thai.

Bundle BHYT YHCT bổ sung positive seed cho XML2 MA_PP_CHEBIEN. Ví dụ này giữ MA_PP_CHEBIEN dưới dạng raw legal string (Chích rượu) thay vì công bố CodeSystem chính thức, vì nguồn hiện hành cho phương pháp chế biến vị thuốc cổ truyền chưa được ingest thành danh mục FHIR-ready có provenance đầy đủ.

Bundle workflow khám ngoại trú BHYT đầy đủ — kịch bản phổ biến nhất trong y tế VN. Bệnh nhân Nguyễn Văn An (DN, 80%) khám đúng tuyến tại BV Chợ Rẫy, chẩn đoán viêm dạ dày mạn tính K29.5, XN glucose bình thường, kê đơn Omeprazole 20mg × 14 ngày. BHYT thanh toán 318.400/398.000 VND. Mapping: MALYDO=5, MA_DOITUONG_KCB=1.1, 3 nhóm chi phí per QĐ 697/QĐ-BYT.

Bundle workflow xét nghiệm cận lâm sàng đầy đủ: chỉ định → kết quả → chỉ định bổ sung. Bệnh nhân Nguyễn Văn An khám ngoại trú tại BV Chợ Rẫy với sốt 3 ngày. CBC: WBC = 15.2 ×10⁹/L (tăng cao — nghi nhiễm trùng vi khuẩn). RBC/Hgb/PLT bình thường. Sinh hóa: Glucose 5.4 mmol/L, Creatinine 85 µmol/L, ALT 32 U/L — bình thường. BS chỉ định bổ sung CRP do WBC cao. Căn cứ: QĐ 1227/QĐ-BYT (2.964 chỉ số CLS chuẩn hóa), LOINC per WHO.

Bundle workflow Y học cổ truyền đầy đủ: tứ chẩn + biện chứng + điều trị. Kịch bản: Nguyễn Văn An (41 tuổi) khám YHCT tại BV Chợ Rẫy — đau lưng mạn tính 3 tháng. Minh họa toàn bộ 10 VN YHCT CodeSystem (QĐ 2552 + QĐ 3080/QĐ-BYT): VNYHCTPulseCS: Mạch trầm (6581102), Mạch trì (6581103) VNYHCTTongueCS: Chất nhợt (6581007), Rêu trắng (6581027), Rêu dày (6581026) VNYHCTSymptomCS: Đau thắt lưng (6541000), Đau tăng lạnh (6541001), Sợ lạnh (6541004) VNYHCTDiseaseCS: Yêu thống thể hàn thấp (U62.392.5.01) VNYHCTDiagnosisCS: Hàn chứng (6535004) VNYHCTTreatmentMethodCS: Ôn thông kinh lạc (6581209), Trừ phong thấp (6581247) VNYHCTAcupointCS: Thận Du BL23 (6536596), Yêu Dương Quan GV3 (6537277), Uỷ Trung BL40 (6536664), Đại Trường Du BL25 (6536604), Hợp Cốc LI4 (6536059) VNYHCTTechniqueCS: Hào châm (3810018) VNYHCTHerbCS: Can khương (6581452), Thương truật (6581784) + 7 dược liệu khác VNYHCTPrescriptionCS: Can khương thương truật thang (6586400) Mapping BHXH: MALYDO=5, MA_DOITUONG_KCB=1.1, ICD-10=M54.5 per QĐ 3176/QĐ-BYT.

Bundle workflow đơn thuốc điện tử cho bệnh nhân đa bệnh lý. 3 thuốc: Amlodipine 5mg (hạ áp), Metformin 500mg (tiểu đường), Aspirin 81mg (phòng ngừa). Minh họa đơn thuốc ngoại trú 30 ngày, đầy đủ liều lượng, đường dùng, tần suất, số đăng ký. Per TT 13/2025/TT-BYT (bệnh án điện tử) + Luật Dược 2016 Điều 74 (kê đơn).

Bác sĩ chuyên khoa II — đầy đủ: CCCD, GPHN hiện hành, CCHN lịch sử, họ tên, giới tính, trình độ BS CKII Nội khoa.

Bác sĩ với thông tin tối thiểu: GPHN hiện hành và họ tên.

Bác sĩ chuyên khoa I Y học cổ truyền tại TP.HCM. Định danh: CCCD + GPHN hiện hành + CCHN lịch sử. Trình độ: BS CKI YHCT. Minh họa VNCorePractitioner cho nhân viên y tế YHCT.

Kết quả giải phẫu bệnh lý mô ruột thừa cắt bỏ. Kết luận: Viêm ruột thừa cấp mủ, chưa vỡ. Category: XN (Xét nghiệm — bao gồm giải phẫu bệnh). LOINC 60568-3 (Pathology synoptic report). Kết luận mã hóa bằng SNOMED CT Morphologic Abnormality per QĐ 2493/QĐ-BYT, kèm ICD-10 fallback trong cùng CodeableConcept.

Kết quả X-quang ngực hai tư thế bình thường — bệnh nhân Nguyễn Văn An. Category: CDHA (Chẩn đoán hình ảnh). LOINC 36643-5. Kèm file PDF kết quả. Per QĐ 1227/QĐ-BYT (chỉ số CLS) + QĐ 3176/QĐ-BYT.

Ví dụ báo cáo xét nghiệm sinh hóa máu — glucose, creatinine. Nhóm CLS: LAB (xét nghiệm). Liên kết Observation kết quả chi tiết. Căn cứ: QĐ 1227/QĐ-BYT — 2.964 chỉ số CLS, QĐ 3176/QĐ-BYT.

Ví dụ tổ chức: BHXH Việt Nam — cơ quan bảo hiểm xã hội quốc gia. Dùng làm insurer trong Claim/ClaimResponse/Coverage.

Ví dụ minh họa địa chỉ đầy đủ với cả text, line, state, extension province (mã hóa), extension ward (mã hóa), và district (lịch sử) để hỗ trợ tương thích ngược.

Ví dụ bệnh nhân đầy đủ: CCCD, BHYT (format mới), MRN, họ tên, giới tính, ngày sinh, địa chỉ với mã ĐVHC mới, dân tộc Kinh, Công giáo, quốc tịch Việt Nam và nơi sinh.

Ví dụ bệnh nhân người nước ngoài khám tại Việt Nam, không thuộc hệ CCCD nên dùng hộ chiếu làm định danh thay thế hợp lệ. Slice CCCD vẫn hiện diện với data-absent-reason; không dùng forceMajeureReason.

Ví dụ bệnh nhi dưới 6 tuổi theo hướng model chuẩn: Patient là bệnh nhi, contact ghi thông tin mẹ, và có thể liên kết thêm RelatedPerson để phục vụ BHYT/EMR mà không cần custom extension riêng cho người giám hộ.

Ví dụ bệnh nhân với thông tin tối thiểu bắt buộc: chỉ có CCCD, họ tên (text), và giới tính.

Bệnh viện Bạch Mai — bệnh viện đa khoa hạng Đặc biệt, tuyến Trung ương, công lập, tại Hà Nội. Sử dụng làm parent Organization cho các ví dụ khoa/phòng.

Bệnh viện Chợ Rẫy — bệnh viện đa khoa hạng Đặc biệt, tuyến Trung ương, công lập, tại TP. Hồ Chí Minh.

Ví dụ minh họa hồ sơ lịch sử của bệnh viện đa khoa tuyến huyện theo TT 43/2013/TT-BYT. Organization hiện vẫn có cấp quản lý tỉnh, nhưng tuyến chuyên môn kỹ thuật cũ được lưu riêng ở legacyTechnicalLine.

Bệnh án giấy ngoại trú được scan và lưu trữ dưới dạng PDF. Per TT 13/2025/TT-BYT Điều 5: CSYT phải chuyển đổi bệnh án giấy sang điện tử trước 31/12/2026. Lưu ý: đây là bước chuyển tiếp — bệnh án scan (DocumentReference) khác với bệnh án điện tử gốc (Composition).

Ví dụ tham chiếu bệnh án điện tử per TT 13/2025/TT-BYT. Bệnh án nội trú của bệnh nhân Nguyễn Văn An tại BV Chợ Rẫy.

Lịch tiêm TCMR chưa thực hiện vì điểm tiêm hết vaccine tại thời điểm hẹn.

Chẩn đoán viêm phổi không xác định — dual coding ICD-10 + SNOMED CT. ICD-10: J18.9 (tên VN từ icd.kcb.vn), SNOMED CT: 233604007 (từ QĐ 2805/QĐ-BYT).

Chẩn đoán viêm ruột thừa cấp — dual coding ICD-10 + SNOMED CT. ICD-10: K35.8, SNOMED CT: 85189001. Dùng kèm ExampleEncounterInpatient.

Chẩn đoán y học cổ truyền: Yêu thống thể hàn thấp. Triple coding: ICD-10 M54.5 + SNOMED CT 279039007 + YHCT Mã U U62.392.5.01 (thể hàn thấp). Minh họa khả năng mã hóa song song giữa y học hiện đại và y học cổ truyền, kèm mã thể lâm sàng cụ thể theo QĐ 2552/QĐ-BYT.

Kết quả Creatinine huyết thanh = 142 µmol/L — TĂNG CAO, gợi ý suy thận mạn giai đoạn 3a. eGFR ước tính ~52 mL/phút/1.73m² (CKD stage 3a per KDIGO 2024: eGFR 45–59). LOINC: 2160-0 (Creatinine [Mass/volume] in Serum or Plasma). Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — chỉ số CLS nhóm Sinh hóa — Chức năng thận.

Nghiên cứu DICOM CT lồng ngực ngoại trú cho bệnh nhân Nguyễn Văn An. Minh họa StudyInstanceUID, accession number, modality CT, reasonCode ICD-10 và bodySite SNOMED CT.

Kết quả xét nghiệm Công thức máu (CBC) — bạch cầu tăng cao 12.8 × 10^9/L, gợi ý nhiễm trùng cấp. Hồng cầu, Hemoglobin và Tiểu cầu trong giới hạn bình thường. LOINC: 58410-2 (CBC panel - Blood by Automated count). Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — bộ mã CLS quốc gia ánh xạ LOINC.

Lượt cấp cứu tai nạn giao thông tại BV Chợ Rẫy. Chẩn đoán: S72.0 Gãy cổ xương đùi. Cấp cứu qua đêm, chuyển sang Khoa Chấn thương. MALYDO=2 (cấp cứu) — hưởng BHYT như đúng tuyến per Điều 22 Luật BHYT.

Cấp phát Amlodipine 5mg x 30 viên cho bệnh nhân Nguyễn Văn An sau khám ngoại trú. Minh họa authorizingPrescription để nối chuỗi kê đơn → cấp phát → thanh toán BHYT, với mức hưởng BHYT 80%.

Cấp phát Cefotaxime tiêm tĩnh mạch cho người bệnh nội trú. Minh họa cấp phát thuốc kháng sinh trong bệnh án điện tử nội trú.

Dị ứng thuốc Penicillin (SNOMED CT: 91936005), mức độ nguy hiểm cao. Phản ứng: ban đỏ và phù nề. Minh họa VNCoreAllergyIntolerance.

Dị ứng trứng (SNOMED CT: 213020009 — Egg protein allergy). Mức độ nguy hiểm cao. Phản ứng: phù mạch dị ứng và ban đỏ sau khi ăn trứng — đã xảy ra 3 lần, xác nhận. Minh họa VNCoreAllergyIntolerance với category food, reaction.substance, reaction.manifestation.

Dị ứng với thông tin tối thiểu: chỉ code và patient và clinicalStatus. Minh họa VNCoreAllergyIntolerance với các trường Must Support tối giản.

Ghi nhận tối thiểu sử dụng VTYT (bơm tiêm 5ml) cho bệnh nhân. Chỉ ghi nhận: trạng thái, bệnh nhân, thiết bị. Minh họa mức tối thiểu cần thiết cho DeviceUseStatement per VNCoreDeviceUseStatement.

Ghi nhận sử dụng catheter tĩnh mạch ngoại vi 22G cho bệnh nhân nội trú. Liên kết với ExampleDeviceVTYT (catheter) và ExamplePatientNguyenVanAn. Minh họa cách ghi nhận VTYT tiêu hao trong lượt điều trị.

Giải trình quyền lợi BHYT cho lượt nội trú viêm ruột thừa tại BV Chợ Rẫy. Adjudication: đề nghị 14.370.000, đủ điều kiện 12.600.000, cùng chi trả 2.520.000, BHYT thanh toán 10.080.000, tự trả 1.770.000. Minh họa ConceptMap trường tổng tiền BHYT sang total category: submitted/eligible/copay/benefit và các category cục bộ patient-self-pay/other-fund/non-covered/medication-subtotal/supplies-subtotal. Liên kết với ExampleClaimBHYT (yêu cầu gốc) và ExampleClaimResponseBHYT (kết quả giám định).

Giải trình quyền lợi BHYT ngoại trú 3 dịch vụ: Khám (150.000) + XN (200.000) + Thuốc (350.000) = 700.000 VNĐ. BHYT thanh toán 80% = 560.000 VNĐ, cùng chi trả 20% = 140.000 VNĐ. Minh họa VNCoreExplanationOfBenefit với adjudication 3 mức: submitted/eligible/benefit. Per QĐ 697/QĐ-BYT (19/3/2026), NĐ 188/2025/NĐ-CP, QĐ 3176/QĐ-BYT.

Giải trình quyền lợi BHYT cho trẻ em dưới 6 tuổi Nguyễn Minh Khôi (3 tuổi). Khám nhi + Xét nghiệm + Thuốc = 450.000 VNĐ. BHYT thanh toán 100% (0% đồng chi trả). Đối tượng BHYT trẻ em dưới 6 tuổi hưởng 100% chi phí KCB per NĐ 188/2025/NĐ-CP. Liên kết Coverage: ExampleCoverageBHYTDependent (thẻ BHYT quyền lợi cấp trực tiếp cho trẻ).

Bản scan giấy cam kết đồng ý phẫu thuật cắt ruột thừa nội soi. BN Nguyễn Văn An ký ngày 10/4/2026 trước khi phẫu thuật. Người thân ký tên đồng ý (vợ bệnh nhân). Per Luật KCB 2023 Điều 15: quyền được thông tin và đồng ý điều trị. Per Luật 91/2025/QH15: đây là xử lý DLCN nhạy cảm — cần lưu giữ bằng chứng đồng ý.

Giấy chuyển viện từ Trạm Y tế Bình Thạnh gửi lên BV Chợ Rẫy. Chẩn đoán sơ bộ: Nghi STEMI cấp (I21.9). Per Luật KCB 2023, NĐ 188/2025/NĐ-CP.

Giấy chuyển tuyến cấp cứu từ Trạm Y tế phường Ngọc Hà đến Bệnh viện Chợ Rẫy. Lý do: nghi viêm cơ tim cấp (I40.9), vượt khả năng tuyến xã. Minh họa VNCoreServiceRequest với extension referralMode (HTCHUYEN=2: Chuyển đến từ tuyến dưới). Per QĐ 3176/QĐ-BYT (trường HTCHUYEN), Luật KCB 2023 (chuyển người bệnh).

Kết quả HbA1c = 7.2% — CAO, kiểm soát đường huyết chưa đạt mục tiêu điều trị. Theo ADA Standards of Care 2026: mục tiêu HbA1c < 7.0% cho phần lớn BN ĐTĐ type 2. LOINC: 4548-4 (Hemoglobin A1c/Hemoglobin.total in Blood). Phản ánh mức đường huyết trung bình trong 2–3 tháng trước, không bị ảnh hưởng bởi tình trạng nhịn ăn. Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — chỉ số CLS nhóm Sinh hóa — Nội tiết.

TEST FIXTURE — Thiết bị cấy ghép class C/D legacy thiếu số lưu hành (registration number).

Đây là ví dụ INTENTIONAL FAIL invariant vn-implant-regnum-class-cd ở mức warning.

Use case:

• Dữ liệu legacy từ trước thời điểm hiệu lực NĐ 98/2021/NĐ-CP
• Thiết bị nhập khẩu trước 2022 chưa có quy định số lưu hành
• Hoặc data migration từ HIS cũ chưa thu thập trường registrationNumber

Behavior:

• Invariant vn-implant-regnum-class-cd fires warning (KHÔNG block validation)
• Bệnh viện tiếp nhận warning + có 90 ngày bổ sung registration per workflow nội bộ
• Sau hiệu lực NĐ 90/2026 (15/05/2026): warning có thể nâng lên error theo policy nội bộ

Disclaimer: KHÔNG dùng pattern này cho thiết bị cấy ghép mới sau 2022.

Trụ implant nha khoa titanium grade 4, đường kính 4.0mm, dài 10mm. Phân loại rủi ro loại C theo NĐ 98/2021/NĐ-CP đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP (cấy ghép dài hạn, tiếp xúc xương). Có số lưu hành do Cục Hạ tầng và Thiết bị y tế cấp, có UDI để truy xuất sau cấy ghép. Nhóm BHYT N06 (TT 04/2017/TT-BYT).

Insulin hỗn hợp Mixtard 30 (70% NPH + 30% Regular) — bút tiêm prefilled 3mL, 100 IU/mL. Dây chuyền lạnh: bảo quản 2-8°C (chưa mở), sau mở dùng trong 28 ngày ở nhiệt độ phòng ≤ 25°C. Dual coding: SNOMED CT 67866001 + ATC A10AB01.

Khoa Chẩn đoán hình ảnh (K39) của bệnh viện tuyến tỉnh. Minh họa OrganizationDepartment liên kết với VNCoreOrganization hiện có.

Khoa Nội Tim mạch (K04) trực thuộc Bệnh viện Bạch Mai. Minh họa OrganizationDepartment dùng mã khoa BYT theo QĐ 2010/QĐ-BYT Phụ lục 6.

Khoa Tim mạch trực thuộc Bệnh viện Chợ Rẫy. Minh họa Location cấp khoa dùng cho EMR, phân công nhân sự và định vị nơi cung cấp dịch vụ.

Khu khám ngoại trú trực thuộc Trạm Y tế phường Ngọc Hà. Minh họa Location cấp khu vực chuyên môn trong cơ sở tuyến xã.

Lượt tái khám từ xa qua video call cho bệnh nhân Nguyễn Văn An — tăng huyết áp I10. Thời gian: 22/4/2026, 09:00-09:30 (30 phút). Kê đơn Amlodipine tiếp tục. Lưu ý: Thanh toán BHYT cho telehealth chưa có hướng dẫn chính thức (03/2026).

BHXH phê duyệt một phần: Khám (approved 100%), XN (approved 100%), Thuốc (partial — 1 thuốc ngoài DM BHYT). Thuốc XYZ ngoài danh mục: 800,000đ bị trừ, bệnh nhân tự chi trả phần này. Per NĐ 188/2025/NĐ-CP, danh mục thuốc BHYT hiện hành.

Ví dụ kết quả giải quyết BHYT cho lượt nội trú viêm ruột thừa tại BV Chợ Rẫy. Adjudication: đề nghị 14.370.000, đủ ĐK 12.600.000, cùng chi trả 2.520.000, BHYT thanh toán 10.080.000. Mapping OHP ClaimResponse: submitted/eligible/copay/benefit.

Kết quả thanh toán cho bệnh nhân nước ngoài John Smith, tự chi trả toàn bộ. Không có BHYT → không qua giám định BHXH → BV thu trực tiếp 550.000 VNĐ. Khám tổng quát (300.000) + Thuốc (250.000). outcome = complete. Per QĐ 697/QĐ-BYT, QĐ 3276/QĐ-BYT mã đối tượng 9 (Không có BHYT).

Lượt khám ngoại trú BHYT đúng tuyến tại BV Chợ Rẫy. Bệnh nhân Nguyễn Văn An, chẩn đoán viêm phổi.

Lượt nhập viện nội trú, chuyển tuyến, ra viện với tình trạng khỏi.

Ví dụ đầy đủ cho mẫu huyết thanh dùng trong chuỗi xét nghiệm sinh hóa: glucose, creatinine, ALT. Minh họa liên kết giữa chỉ định, lấy mẫu, tiếp nhận mẫu, vật chứa mẫu và báo cáo cận lâm sàng.

Ví dụ tối thiểu cho mẫu máu toàn phần chống đông EDTA dùng trong công thức máu.

Ví dụ tối thiểu cho mẫu mô ruột thừa sau phẫu thuật, dùng trong báo cáo giải phẫu bệnh.

Ví dụ tối thiểu cho mẫu nước tiểu giữa dòng, dùng trong tổng phân tích nước tiểu thường quy.

Ví dụ OperationOutcome cho hồ sơ BHYT có một dòng chi phí bị từ chối do không đúng quy định và một cảnh báo cần điều chỉnh dữ liệu trước khi gửi lại.

Phòng khám cụ thể thuộc khu khám ngoại trú Trạm Y tế phường Ngọc Hà. Minh họa cấu trúc partOf giữa các Location.

Phòng khám đa khoa tư nhân Hoàng Long — tại Hà Nội. Chưa xếp hạng, cấp quản lý tỉnh (tư nhân hợp đồng BHYT). Loại hình: tư nhân. Có đăng ký khám BHYT ban đầu, mã CSKCB: 01-958. Minh họa Organization tư nhân — đối chiếu với BV công lập (Chợ Rẫy), CSKCB nhà nước (Trạm Y tế).

Phẫu thuật cắt ruột thừa nội soi (SNOMED CT: 6025007). Minh họa VNCoreProcedure với mã SNOMED CT IPS.

Ghi nhận nguồn gốc và chữ ký số của bệnh án điện tử nội trú theo TT 13/2025/TT-BYT và NĐ 137/2024/NĐ-CP.

Ví dụ RelatedPerson theo hướng JP Core/US Core: hồ sơ mẹ của bệnh nhi được model bằng resource riêng thay vì custom extension.

Chỉ số khối cơ thể (BMI) = 26.3 kg/m² — béo phì độ I theo tiêu chuẩn WHO khu vực Châu Á-Thái Bình Dương (ngưỡng VN: ≥ 25). LOINC 39156-5. Per TT 13/2025/TT-BYT.

Chiều cao 168 cm, LOINC 8302-2, đơn vị UCUM cm. Per TT 13/2025/TT-BYT.

Cân nặng 65 kg, LOINC 29463-7, đơn vị UCUM kg. Per TT 13/2025/TT-BYT.

Sinh hiệu huyết áp tâm thu 120 mmHg, tâm trương 80 mmHg.

Huyết áp tâm thu 145 mmHg, tâm trương 92 mmHg — tăng huyết áp độ 1 theo ESC 2023. Kèm interpretation cao (H) và referenceRange cho từng component. Per TT 13/2025/TT-BYT.

Mạch 80 lần/phút, LOINC 8867-4, đơn vị UCUM /min. Per TT 13/2025/TT-BYT.

Nhiệt độ cơ thể = 38.5°C — sốt vừa. Interpretation High (#H). LOINC 8310-5 (Body temperature). Cần tìm nguyên nhân: nhiễm trùng, viêm. Kết hợp XN WBC, CRP. Per TT 13/2025/TT-BYT.

Nhịp thở 16 lần/phút, LOINC 9279-1, đơn vị UCUM /min. Per TT 13/2025/TT-BYT.

Bão hòa oxy mao mạch (SpO2) = 94% — dưới ngưỡng bình thường 95–100%. Interpretation Low (#L). Cần theo dõi sát và cân nhắc thở oxy nếu SpO2 tiếp tục giảm dưới 92%. Per TT 13/2025/TT-BYT.

Nghiên cứu DICOM siêu âm bụng tổng quát. Minh họa modality US, mã thủ thuật ICD-9-CM VN và bodySite SNOMED CT.

Minh họa dual coding SNOMED CT + ICD-10 cho chẩn đoán đái tháo đường type 2. SNOMED CT (44054006) từ QĐ 2805/QĐ-BYT (Đợt 3 — Finding), ICD-10 (E11.9) cho báo cáo BHXH. Mục tiêu: SNOMED CT cho trao đổi quốc tế, ICD-10 cho hệ thống nội địa.

Ghi nhận tình trạng sử dụng stent mạch vành phủ thuốc sau thủ thuật PCI cho bệnh nhân Nguyễn Văn An. Thủ thuật đặt stent được minh họa bằng ExampleProcedurePCIStentPlacement qua Procedure.focalDevice. Stent XIENCE Sierra 3.0mm x 18mm (Abbott). Thông tin chi phí/BHYT được biểu diễn trên Claim.item khi lập hồ sơ thanh toán, không nằm trong DeviceUseStatement. Liên kết: ExampleDeviceImplant (stent), ExamplePatientNguyenVanAn (bệnh nhân). Per NĐ 74/2025/NĐ-CP, QĐ 3176/QĐ-BYT.

Lưới lọc tĩnh mạch chủ dưới tạm thời đã được tháo sau giai đoạn dự phòng thuyên tắc phổi. Ví dụ này minh họa thiết bị cấy ghép có trạng thái sau explant và được Procedure.focalDevice tham chiếu khi thực hiện thủ thuật tháo.

Stent mạch vành phủ thuốc (drug-eluting stent) — TBYT cấy ghép cao giá. Ghi nhận đầy đủ: mã TBYT, manufacturer, lot, model, serial number. Nhóm BHYT tham khảo: N06.00.000 — vật liệu thay thế, vật liệu cấy ghép nhân tạo. Phạm vi và giá BHYT thuộc dòng Claim.item khi lập hồ sơ thanh toán. Per TT 04/2017/TT-BYT Phụ lục 01, TT 24/2025/TT-BYT, QĐ 3176/QĐ-BYT.

Ví dụ thiết bị y tế tiêu hao (TBYT) — kim luồn tĩnh mạch 22G. Dùng trong thanh toán BHYT: mã TBYT và nhóm TBYT có thể được tham chiếu từ dòng Claim.item; Device chỉ giữ dữ liệu thiết bị/legacy identifier. Mapping OHP: MA_VAT_TU, TEN_VAT_TU per QĐ 3176/QĐ-BYT, NĐ 74/2025/NĐ-CP.

Nhiệt kế điện tử hồng ngoại đo trán, dùng cho khám sàng lọc và theo dõi sinh hiệu tại bệnh viện. Phân loại rủi ro loại B (rủi ro trung bình thấp) theo NĐ 98/2021/NĐ-CP đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP — tiếp xúc với cơ thể nhưng không xâm lấn, không cấy ghép. TBYT loại B yêu cầu cấp số lưu hành theo NĐ 98/2021 Chương III. Nhóm BHYT N08 (TT 04/2017/TT-BYT — thiết bị chẩn đoán/điều trị).

Ví dụ thuốc Amoxicillin 500mg viên nang — kháng sinh phổ rộng. Mã ATC: J01CA04. Số đăng ký: VD-12345-20. Mapping OHP: MA_THUOC, TEN_THUOC, SO_DANG_KY per QĐ 3176/QĐ-BYT.

Thẻ BHYT định dạng lịch sử — 15 ký tự (2 chữ mã đối tượng + 13 số). Đối tượng: Hưu trí (HT). Minh họa tương thích ngược.

Thẻ BHYT format mới — số thẻ = số CCCD 12 chữ số. Đối tượng: Doanh nghiệp (DN). Nơi ĐKKCB ban đầu: BV Chợ Rẫy.

Thẻ BHYT của Nguyễn Minh Khôi, 3 tuổi — đối tượng TE (trẻ em dưới 6 tuổi). Ví dụ này minh họa quyền lợi BHYT được cấp trực tiếp cho chính trẻ, do ngân sách nhà nước đóng. Per NĐ 188/2025/NĐ-CP — mức hưởng 100% cho trẻ em dưới 6 tuổi. Ví dụ guardian-linked riêng xem ExampleCoverageBHYTGuardianLinked.

Ví dụ minh họa beneficiary là bệnh nhi Nguyễn Minh Khôi, còn subscriber tham chiếu hồ sơ RelatedPerson của mẹ là Trần Thị Mai. Ví dụ này dùng để minh họa cách liên kết người đại diện theo mô hình Coverage + RelatedPerson, không thay thế nghiệp vụ quyền lợi do NSNN chi trả cho trẻ em dưới 6 tuổi.

Châm cứu hào châm 5 huyệt điều trị đau thắt lưng (M54.5 / Yêu thống). Minh họa VNCoreProcedure với mã YHCT Kỹ thuật (QĐ 2552/QĐ-BYT) và Huyệt châm cứu (QĐ 2552/QĐ-BYT). Performer: BS CKII Nguyễn Thị Lan. Encounter: ExampleEncounterYHCT.

Thủ thuật tháo lưới lọc tĩnh mạch chủ dưới tạm thời. Minh họa pattern Procedure.focalDevice cho explant/removal thiết bị cấy ghép; ongoing tracking vẫn dùng Device/DeviceUseStatement, chi phí dùng Claim/EOB.

Thủ thuật với thông tin tối thiểu: chỉ status, code và subject. Minh họa VNCoreProcedure với các trường bắt buộc và Must Support.

Can thiệp mạch vành qua da (PCI) đặt stent mạch vành phủ thuốc cho bệnh nhân Nguyễn Văn An. Minh họa pattern Procedure.focalDevice cho thủ thuật cấy/đặt thiết bị; DeviceUseStatement dùng để ghi nhận đang sử dụng theo thời gian, Claim/EOB dùng cho chi phí.

Người lớn tiêm vaccine cúm mùa theo hình thức tiêm chủng dịch vụ và tự chi trả.

Trẻ em được tiêm mũi 1 vaccine phối hợp DPT-VGB-Hib trong Chương trình Tiêm chủng mở rộng.

Trung tâm Kiểm soát bệnh tật tỉnh Quảng Ninh — ví dụ cơ sở y tế dự phòng, sử dụng hạng đơn vị y tế không phải cơ sở KCB.

Trung tâm y tế khu vực An Phú — ví dụ đơn vị sự nghiệp y tế không phải bệnh viện, có hạng IV theo TT 06/2024/TT-BYT, đồng thời lưu tuyến chuyên môn kỹ thuật lịch sử để phục vụ chuyển đổi dữ liệu cũ.

Trạm y tế phường — cấp quản lý xã, cấp KCB ban đầu, không áp dụng phân hạng pháp lý.

Tóm tắt xuất viện cho bệnh nhân Nguyễn Văn An điều trị viêm phổi nội trú tại BV Chợ Rẫy. Loại tài liệu: Discharge Summary (LOINC 18842-5). Per TT 13/2025/TT-BYT.

Kết quả tổng phân tích nước tiểu (TPTNT) — tất cả thông số trong giới hạn bình thường. LOINC: 24356-8 (Urinalysis panel). Sử dụng component[] cho các thông số định tính và định lượng. Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — chỉ số CLS nhóm Vi sinh/Nước tiểu.

Bệnh nhân Nguyễn Văn An từ chối sử dụng dữ liệu y tế cho mục đích tiếp thị và nghiên cứu. Per Luật 91/2025/QH15 Điều 12 — quyền rút lại đồng ý. NĐ 356/2025/NĐ-CP.

Vai trò bác sĩ CKII Nguyễn Thị Lan tại Bệnh viện Chợ Rẫy, chức danh Bác sĩ chính (V.08.01.02), chuyên khoa Nội — Tim mạch, đang hoạt động.

Vai trò BS CKII Nguyễn Thị Lan tại Khoa Tim mạch BV Chợ Rẫy. Chức danh: Bác sĩ chính hạng II (V.08.01.02). Chuyên khoa: Tim mạch. Minh họa VNCorePractitionerRole đầy đủ per TT 41/2025/TT-BYT, TT 32/2023/TT-BYT.

Vai trò nhân viên y tế với thông tin tối thiểu: chỉ practitioner, organization và active. Minh họa VNCorePractitionerRole với các trường bắt buộc và Must Support tối giản.

Bơm tiêm nhựa 5ml dùng một lần, có gắn kim 23G x 1". Vật tư tiêu hao thuộc nhóm BHYT N03 (TT 04/2017/TT-BYT). Phân loại rủi ro loại A theo NĐ 98/2021/NĐ-CP đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP. TBYT loại A thực hiện công bố tiêu chuẩn áp dụng (không cấp số lưu hành) — không có extension registrationNumber.

Ví dụ Condition dạng problem-list-item dùng VNCoreCondition nền tảng, không phải chẩn đoán lượt khám. Mã hóa bằng SNOMED CT 38341003 và trạng thái lâm sàng active.

Ví dụ VTYT tối thiểu — chỉ ghi nhận mã VTYT, loại, trạng thái. Bơm tiêm 5ml dùng 1 lần. Không có thông tin manufacturer/lot (vật tư phổ thông). Minh họa mức tối thiểu cần thiết khi nhập VTYT vào hệ thống HIS.

Kết quả xét nghiệm Glucose máu lúc đói = 6.8 mmol/L (cao). LOINC: 14771-0 (Fasting glucose [Moles/volume] in Serum or Plasma — đơn vị mmol/L).

Yêu cầu chụp X-quang ngực thẳng cho bệnh nhân Nguyễn Văn An. Chỉ định bởi BS CKII Nguyễn Thị Lan, BV Chợ Rẫy. Lý do: ho kéo dài, loại trừ viêm phổi.

Yêu cầu chụp CT lồng ngực ngoại trú cho bệnh nhân Nguyễn Văn An. Chỉ định bởi BS CKII Nguyễn Thị Lan. Lý do: ho kéo dài, loại trừ tổn thương phổi.

Yêu cầu siêu âm bụng tổng quát cho bệnh nhân Nguyễn Văn An. Chỉ định bởi BS CKII Nguyễn Thị Lan. Lý do: đau bụng chưa rõ nguyên nhân.

Ví dụ yêu cầu thanh toán BHYT cho lượt nội trú viêm ruột thừa tại BV Chợ Rẫy. Mapping từ XML 3176: MA_BN, MA_THE, MA_BENH=K35.8, T_TONGCHI. Chi phí theo 5 nhóm per QĐ 697/QĐ-BYT (19/3/2026), gồm một dòng thiết bị y tế để minh họa deviceGroup trên Claim.item.

Yêu cầu thanh toán BHYT cho BN Nguyễn Văn An — viêm ruột thừa cấp K35.8, phẫu thuật nội soi. 6 nhóm chi phí per QĐ 697/QĐ-BYT: Khám(1), Giường(2.2), XN(3), CĐHA(4), Phẫu thuật(6), Thuốc(8). Tổng: 15.720.000 VND.

Yêu cầu thanh toán tự chi trả cho bệnh nhân nước ngoài John Smith. Không có BHYT Việt Nam — toàn bộ chi phí tự chi trả. Áp dụng giá dịch vụ theo yêu cầu. Chẩn đoán: J06.9 (Nhiễm trùng đường hô hấp trên cấp tính). Per QĐ 3276/QĐ-BYT mã đối tượng 9.

Yêu cầu xét nghiệm Glucose máu lúc đói cho bệnh nhân Nguyễn Văn An. Chỉ định bởi BS CKII Nguyễn Thị Lan, BV Chợ Rẫy. Lý do: nghi ngờ đái tháo đường.

Chẩn đoán đái tháo đường type 2 với cả ICD-10 coding (E11.9) và SNOMED CT coding (44054006). Minh họa dual coding theo khuyến nghị VN Core.

Đánh giá YHCT cho bệnh nhân Yêu thống thể hàn thấp. Tứ chẩn: Vọng (lưỡi nhợt — hàn thấp), Thiết (mạch trầm — hàn). Liên kết với ExampleConditionYHCTYeuThong (chẩn đoán YHCT). Minh họa cách dùng component cho đánh giá đa chiều theo QĐ 3080/QĐ-BYT.

Vấn chẩn triệu chứng YHCT: đau lưng vùng thắt lưng (#6541000), đau tăng khi lạnh ẩm (#6541001), sợ lạnh (#6541004). Kết luận thể hàn thấp — phù hợp biện chứng Yêu thống. Per QĐ 2552/QĐ-BYT (12/8/2025) — Đợt 1 mã YHCT.

Vọng chẩn lưỡi trong khám YHCT: chất lưỡi nhợt (#6581007), rêu trắng (#6581027), rêu dày (#6581026). Kết luận hàn thấp nội tích — phù hợp biện chứng Yêu thống thể hàn thấp. Per QĐ 3080/QĐ-BYT (26/9/2025) — Phụ lục II.

Đơn thuốc ngoại trú: Amoxicillin 500mg, uống 3 lần/ngày, sau ăn, 7 ngày. Bệnh nhân Nguyễn Văn An, BHYT. Bác sĩ CKII Nguyễn Thị Lan kê đơn tại BV Chợ Rẫy.

Mẹ của bệnh nhi Nguyễn Minh Khôi ký đồng ý cho cơ sở khám chữa bệnh xử lý dữ liệu y tế của trẻ phục vụ khám chữa bệnh, bệnh án điện tử và thanh toán BHYT. Ví dụ này minh họa category parental-proxy và performer là VNCoreRelatedPerson.

Bệnh nhân đồng ý cho BV Chợ Rẫy sử dụng dữ liệu y tế cho nghiên cứu khoa học. Dữ liệu ẩn danh hóa per Luật 91/2025 + NĐ 356/2025. Thời hạn: 04/2026 — 04/2027.

Generated StructureMap scaffold for Bảng 1 tổng hợp KCB BHYT — Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML1SummaryLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 10 giấy chứng nhận nghỉ dưỡng thai — XML10 Maternity Leave Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML10MaternityLeaveLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 11 giấy chứng nhận nghỉ việc hưởng BHXH — XML11 Sick Leave Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML11SickLeaveLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML12MedicalAssessmentLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 2 thuốc BHYT — Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML2MedicationLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 3 DVKT và vật tư BHYT — Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML3ServiceLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 4 cận lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML4CLSLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 5 diễn biến lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML5ClinicalCourseLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 6 hồ sơ HIV/AIDS — XML6 HIV/AIDS Care Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML6HIVCareLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 7 giấy ra viện — XML7 Discharge Paper Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML7DischargePaperLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 8 tóm tắt hồ sơ bệnh án — XML8 Treatment Summary Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML8TreatmentSummaryLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 9 giấy chứng sinh — XML9 Birth Certificate Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML9BirthCertificateLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Ví dụ bệnh nhân dùng cho validation âm tính. Thiếu CCCD và không có force majeure reason.