Profile Bundle type=collection làm PAYLOAD cho chứng nhận sức khỏe số xác minh được (verifiable health credential) — đóng gói TỐI THIỂU để in QR. Vận chuyển/QR theo chuẩn SMART Health Cards (SHC) cho credential nhỏ static offline-verifiable, hoặc SMART Health Links (SHL) cho hồ sơ lớn (KHÔNG nhúng IPS đầy đủ vào QR — IPS là data model/payload, không phải chuẩn QR transport). An toàn: payload tối thiểu hoá (chỉ trường cần thiết); QR có expiry ngắn, ký số issuer (JWKS + key rotation), revocation/status endpoint cho online verify; thẻ vật lý chỉ chứa pointer/credential rất hẹp, KHÔNG full Sổ SKĐT. Use case: chứng nhận đủ điều kiện sức khỏe (lái xe/thuyền viên/học sinh) từ dữ liệu KSK; chứng nhận tiêm chủng. Căn cứ: QĐ 1923/QĐ-BYT (HL7 FHIR); NĐ 137/2024/NĐ-CP (chữ ký số).

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 (ban hành 18/10/2024, hiệu lực 18/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/QĐ-BYT 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 trước hết cho mô bệnh học/surgical pathology 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 SP (Surgical Pathology, active) 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 — Điều 1 khoản 3 yêu cầu kết nối thông tin bệnh án điện tử với số định danh cá nhân của công dân Việt Nam và người nước ngoài đã được cấp tài khoản định danh điện tử; VN Core dùng số định danh cá nhân/CCCD làm khóa lõi ổn định khi có và mô hình hóa trường hợp chưa có bằng data-absent-reason cùng định danh thay thế
• 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[HC]
• 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. Profile này yêu cầu một coding ICD-10 VN để hỗ trợ chẩn đoán lượt khám, mã hóa bệnh tật và ánh xạ dữ liệu đầu ra KCB trong phạm vi áp dụng; không suy rộng thành yêu cầu cho mọi Condition ngoài workflow đó. Danh mục dựa trên 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). 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 bằng ICD-10 Việt Nam, SNOMED CT trong phạm vi sản phẩm/giấy phép áp dụng và mã YHCT. Profile nền không bắt buộc một coding ICD-10; profile con hoặc workflow báo cáo/KCB có thể siết yêu cầu đó. 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) — Quy định về mã hóa bệnh tật, nguyên nhân tử vong theo ICD-10.

Profile Appointment cho Việt Nam. Dùng cho đặt lịch khám trực tiếp, khám tại nhà và khám bệnh, chữa bệnh từ xa. Extension phương thức cung cấp dịch vụ cho biết buổi hẹn là trực tiếp hay từ xa — thông tin người bệnh phải biết ngay khi đặt. Khám bệnh, chữa bệnh từ xa, hỗ trợ khám bệnh, chữa bệnh từ xa và khám bệnh, chữa bệnh tại nhà thuộc phạm vi hưởng bảo hiểm y tế từ 01/07/2026 theo Luật 114/2025/QH15 Điều 44 khoản 1; mức hưởng và quy trình thanh toán cụ thể chờ hướng dẫn của Chính phủ. Căn cứ: Luật 15/2023/QH15 Điều 80 (khám bệnh, chữa bệnh từ xa) và Điều 60 (trách nhiệm cơ sở); Luật 114/2025/QH15 Điều 44 khoản 1; TT 13/2025/TT-BYT (bệnh án điện tử); NĐ 102/2025/NĐ-CP (dữ liệu y tế số). Giới hạn có chủ ý: profile này không mô tả hàng đợi khám trong ngày (số thứ tự phòng khám) — đó là điều phối nội bộ của cơ sở, không cần chuẩn hóa liên thông. / VN Core Appointment profile for in-person, home-visit and telehealth bookings, carrying the care delivery mode so the patient knows the modality at booking time.

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 Task cho Việt Nam. Theo dõi việc thực hiện một yêu cầu đã phát hành trong hai luồng đã có trong IG: điều phối chuyển người bệnh giữa hai cơ sở khám bệnh, chữa bệnh (dựa trên VNCoreServiceRequest) và điều phối cấp phát, bán thuốc theo đơn (dựa trên VNCoreMedicationRequest và các profile đơn dẫn xuất). Task.status mô tả vòng đời kỹ thuật của công việc; Task.businessStatus mang trạng thái nghiệp vụ Việt Nam (đã tiếp nhận, người bệnh đã đến, quá thời hạn lĩnh thuốc) theo VNTaskBusinessStatusVS. Căn cứ: Luật 15/2023/QH15 Điều 60 khoản 10 (giới thiệu, chuyển người bệnh) và Điều 61 (cấp cứu); TT 26/2025/TT-BYT Điều 12 (trách nhiệm cơ sở bán lẻ và thời hạn lĩnh thuốc 05 ngày); TT 13/2025/TT-BYT (bệnh án điện tử); NĐ 102/2025/NĐ-CP (quản lý dữ liệu y tế số). Giới hạn có chủ ý: profile này KHÔNG mô tả hàng đợi công việc nội bộ của một cơ sở (phân công điều dưỡng, lịch trực) — phạm vi đó do phần mềm quản lý bệnh viện tự quyết, không cần chuẩn hóa liên thông. / VN Core Task profile tracking fulfillment of issued requests in two workflows: inter-facility patient referral (based on VNCoreServiceRequest) and prescription dispensing (based on VNCoreMedicationRequest). Task.businessStatus carries Vietnam-specific business states per VNTaskBusinessStatusVS. Internal intra-facility work queues are deliberately out of scope.

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. Vòng đời mã cơ sở (identifier.period + extension orgLifecycleRelation) hỗ trợ biểu diễn sáp nhập/chia tách/đổi mã cơ sở y tế — generic cho mọi cơ sở, đặc biệt khi sắp xếp đơn vị hành chính. 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ế, vòng đời dữ liệu
• NQ 202/2025/QH15 — sắp xếp ĐVHC cấp tỉnh → cơ sở y tế sáp nhập/chia tách (driver vòng đời mã)
• 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 Bundle type=document đóng gói tài liệu khám sức khỏe định kỳ / Sổ SKĐT (theo pattern FHIR Document, IPS, CH Core Document, JP eCheckup). Composition KSK là entry đầu tiên; các resource tham chiếu (Patient, Practitioner, Organization, Observation…) là entry kế tiếp. Đây là đơn vị đóng gói khi đồng bộ lên CSDL sức khỏe cá nhân (payload data base64 trong VNHealthCheckupDataSyncEnvelopeLM — Phụ lục 02). Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026, sửa đổi, bổ sung QĐ 1551/QĐ-BYT); TT 25/2026/TT-BYT (mẫu KSK tâm thần); QĐ 1923/QĐ-BYT (chuẩn hóa HL7 FHIR).

Profile Bundle type=document đóng gói Sổ Sức khỏe điện tử (Patient Summary) hiển thị trên VNeID, theo pattern HL7 IPS Bundle. VNCoreCompositionHealthRecordSummary là entry đầu tiên; các resource tham chiếu (Patient, AllergyIntolerance, Condition, MedicationRequest, Immunization, Observation, Procedure…) là entry kế tiếp. Căn cứ: QĐ 1332/QĐ-BYT (Sổ SKĐT VNeID — CSKCB tạo lập, ký số); QĐ 2062/QĐ-BYT (dữ liệu KSK hiện hành, sửa đổi, bổ sung QĐ 1551/QĐ-BYT); QĐ 1923/QĐ-BYT (HL7 FHIR).

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 riêng, nhưng QĐ 2805/QĐ-BYT (04/9/2025) đã ban hành danh mục 1.327 mã SNOMED CT nhánh dị ứng kèm tên tiếng Việt chính thức — xem VNTranslatedAllergyCodeVS. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), Luật 15/2023/QH15, QĐ 2805/QĐ-BYT (Đợt 3 — nhánh dị ứng).

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 một địa chỉ tích hợp dùng trong luồng gửi/nhận dữ liệu giám định, thanh toán và quyết toán chi phí KCB BHYT. TT 12/2026/TT-BTC Điều 2 xác định Cổng tiếp nhận dữ liệu thuộc Hệ thống thông tin giám định BHYT tại https://gdbhyt.baohiemxahoi.gov.vn; Thông tư không công bố trong profile này một FHIR API path, header hay cơ chế xác thực cụ thể. Địa chỉ kỹ thuật phải lấy từ cấu hình/hợp đồng trao đổi hiện hành do bên nhận cung cấp. 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 dẫn xuất biểu diễn cùng ledger bảng kê 13 cột sau giám định. Mỗi dòng liên kết với một giai đoạn hưởng; thành tiền BH đủ điều kiện dùng adjudication eligible, quỹ BHYT dùng benefit, người bệnh cùng trả dùng copay, còn nguồn khác và người bệnh tự trả dùng các mã VN Core hiện hữu other-fund và patient-self-pay. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [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.

This derived ExplanationOfBenefit profile represents the same 13-column ledger after payer adjudication. Every item references a benefit stage. Eligible amount, BHYT fund payment, and patient co-payment use the existing HL7 adjudication codes eligible, benefit, and copay; other-source payment and patient self-pay use the existing VN Core codes other-fund and patient-self-pay.

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Đ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT). 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 — đang áp dụng) — 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 Composition cho tài liệu khám sức khỏe định kỳ / khám sàng lọc (Sổ Sức khỏe điện tử) — KHÁC với bệnh án điện tử (xem VNCoreComposition). Đại diện cho tài liệu được lập từ bộ mẫu KSK hiện hành: ba mẫu theo nhóm tuổi (dưới 06 tuổi; từ đủ 06 đến dưới 18 tuổi; từ đủ 18 tuổi trở lên) theo QĐ 2062/QĐ-BYT và một mẫu KSK tâm thần theo TT 25/2026/TT-BYT. Nội dung gồm thông tin hành chính (trên Patient), tiền sử bệnh/tiêm chủng, khám thể lực và khám theo cơ quan, kết luận và phân loại sức khỏe. Căn cứ:

• QĐ 2062/QĐ-BYT — 07/7/2026 — sửa đổi, bổ sung QĐ 1551/QĐ-BYT; quy định ba mẫu KSK theo nhóm tuổi hiện hành
• TT 25/2026/TT-BYT — mẫu hồ sơ KSK tâm thần hiện hành
• QĐ 1332/QĐ-BYT — Sổ sức khỏe điện tử trên VNeID
• QĐ 3176/QĐ-BYT — chuẩn dữ liệu (đặc tả trường)
• NĐ 137/2024/NĐ-CP — chữ ký số (kết luận khám)

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).

Bundle tài liệu (document) chứa bản tóm tắt người bệnh quốc tế (IPS) xuất khẩu từ Sổ SKĐT nội địa. Dẫn xuất Bundle-uv-ips: type = document, entry[composition] (1..1) là VNCoreCompositionIPS, entry[patient] (1..1), kèm các resource lâm sàng (dị ứng, bệnh, thuốc…) tham chiếu từ Composition. Đây là dạng kết quả của operation $summary (projection nội địa → IPS, ánh xạ mã sang SNOMED CT). Căn cứ pháp lý:

• QĐ 1332/QĐ-BYT (2024) — Sổ sức khỏe điện tử VNeID (nguồn dữ liệu nội địa).
• TT 13/2025/TT-BYT — bệnh án điện tử (liên thông). / VN Core IPS document Bundle, derived from Bundle-uv-ips; the output shape of the $summary projection.

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. CHÍNH SÁCH VN (0.8.0 — tuyên bố tường minh, không phải 'align base'): cả hai component tâm thu và tâm trương BẮT BUỘC hiện diện (1..1 — khớp hành vi HL7 base bp profile dù profile này không kế thừa trực tiếp bp); giá trị được phép vắng bằng dataAbsentReason trên từng component (đo thất bại vẫn phải ghi nhận có đo).

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à phân loại khoa chuyên ngành. THIẾT KẾ LẠI 0.8.0 (D4 — hậu kiểm toán Codex): trục phân loại khoa chuyển từ identifier sang Organization.type — slice type[deptClass] bind vn-department-vs là nơi mang mã khoa BYT (vai trò MA_KHOA của QĐ 3176/QĐ-BYT đọc từ type[deptClass].coding.code); slice identifier[departmentCode] cũ đã GỠ vì trộn Identifier.system với Coding.system (dùng CodeSystem URL làm Identifier.system là sai mô hình R4). Identifier chỉ còn mã khoa CỤC BỘ per-facility (identifier[localCode]). Căn cứ pháp lý và nghiệp vụ:

• QĐ 1804/QĐ-BYT (19/6/2026) Phụ lục 02 — Danh mục mã khoa hiện hành, 61 mã (K01–K60, K99), áp dụng chậm nhất từ 01/8/2026; bãi bỏ Phụ lục 6 QĐ 2010/QĐ-BYT từ 01/8/2026
• QĐ 2010/QĐ-BYT (19/6/2025) Phụ lục 6 — tiền nhiệm (54 mã); QĐ 5937/QĐ-BYT (2021) Phụ lục 5 — tiền nhiệm xa hơn
• 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. Redesigned in 0.8.0: department classification moved to Organization.type (slice deptClass bound to vn-department-vs); the former departmentCode identifier slice was removed because it used a CodeSystem URL as Identifier.system.

Profile Slot cho Việt Nam. Một khung giờ cụ thể trên lịch cung cấp dịch vụ (VNCoreSchedule) kèm trạng thái đặt được hay không. Slot công bố ra ngoài chỉ mang thông tin về khả năng phục vụ, không mang dữ liệu người bệnh — đây là ranh giới quan trọng khi cơ sở mở cổng đặt lịch công khai, vì dữ liệu y tế là dữ liệu cá nhân nhạy cảm theo Luật 91/2025/QH15 và NĐ 356/2025/NĐ-CP. Căn cứ: Luật 15/2023/QH15 Điều 80 (khám bệnh, chữa bệnh từ xa); Luật 91/2025/QH15 (bảo vệ dữ liệu cá nhân); TT 13/2025/TT-BYT. / VN Core Slot profile: a bookable time window on a VN Core Schedule. Slots carry availability only, never patient data — the boundary that lets facilities publish open booking without disclosing personal data.

Profile CarePlan ghi nhận kế hoạch chăm sóc/điều trị của người bệnh: kế hoạch điều trị ngoại trú, quản lý bệnh mạn tính, hướng dẫn chăm sóc/điều dưỡng. Thường gắn với một đợt chăm sóc (EpisodeOfCare) hoặc lượt khám. Căn cứ pháp lý:

• TT 13/2025/TT-BYT — bệnh án điện tử (kế hoạch điều trị/chăm sóc). / VN Core CarePlan for treatment/nursing care plans.

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 — đang áp dụng) — 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 QuestionnaireResponse ghi nhận dữ liệu đã điền của một mẫu phiếu khám sức khỏe (VNCoreQuestionnaire / QĐ 2062/QĐ-BYT Phụ lục 01 — 3 mẫu theo nhóm tuổi, thay 17 mẫu QĐ 1551/QĐ-BYT). Mỗi item.linkId khớp mã trường của mẫu phiếu; giá trị thu thập được sau đó tổng hợp/ánh xạ vào VNCoreCompositionHealthCheckup, Observation (sinh hiệu, phân loại sức khỏe) và liên thông lên Cơ sở dữ liệu sức khỏe cá nhân. Dẫn xuất từ HL7 SDC sdc-questionnaireresponse (hl7.fhir.uv.sdc#4.0.0). Căn cứ pháp lý:

• QĐ 2062/QĐ-BYT (07/7/2026) — đặc tả dữ liệu mẫu phiếu KSK (Phụ lục 01, thay QĐ 1551/QĐ-BYT).
• TT 13/2025/TT-BYT — bệnh án điện tử. / VN Core QuestionnaireResponse for a completed health-checkup form (SDC).

Profile CoverageEligibilityResponse — phản hồi từ Cổng giám định BHYT cho yêu cầu tra cứu thẻ: hiệu lực thẻ tại thời điểm tra cứu (insurance.inforce), quyền lợi và mức hưởng. Cặp với VNCoreCoverageEligibilityRequest. 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 — quyền lợi và mức hưởng BHYT
• NĐ 164/2025/NĐ-CP — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH
• QĐ 3176/QĐ-BYT — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH

Profile MeasureReport cho Việt Nam. Ghi kết quả một kỳ đánh giá theo định nghĩa chỉ tiêu (VNCoreMeasure). Dùng cho kết quả tự đánh giá tiêu chuẩn chất lượng cơ bản của bệnh viện theo TT 35/2024/TT-BYT — mỗi năm một lần, thực hiện trong Quý I của năm liền kề tiếp theo (Điều 1 khoản 3 điểm a, b), và cho báo cáo chỉ tiêu tiêm chủng, sàng lọc. Kết quả đánh giá theo TT 35/2024/TT-BYT là NHỊ PHÂN: đạt khi toàn bộ tiêu chuẩn đều Có. Khi báo cáo, ghi kết luận đó ở MeasureReport.group.measureScore hoặc evaluatedResource theo cách đã thống nhất trong hệ thống báo cáo — không để người đọc tự suy từ tỷ lệ phần trăm. Căn cứ: TT 35/2024/TT-BYT; Luật 15/2023/QH15 Điều 58 (tự đánh giá và công khai kết quả); Luật 114/2025/QH15. / VN Core MeasureReport profile recording one evaluation period against a VN Core Measure, including the annual hospital basic-quality self-assessment under Circular 35/2024/TT-BYT.

Profile Encounter cho Việt Nam. Bao gồm extension loại KCB BHYT legacy của VN Core (từ trường MA_LYDO_VVIEN), 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Đ 4210/QĐ-BYT — 20/09/2017 — nguồn legacy cho trường MA_LYDO_VVIEN (4 mã); chuẩn hiện hành QĐ 3176/QĐ-BYT dùng MA_DOI_TUONG_KCB với danh mục 27 mã theo QĐ 3276/QĐ-BYT
• 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 Schedule cho Việt Nam. Mô tả lịch cung cấp dịch vụ khám bệnh, chữa bệnh của người hành nghề, dịch vụ hoặc địa điểm — nền để sinh các khung giờ đặt được (VNCoreSlot) và nhận cuộc hẹn (VNCoreAppointment). FHIR R4 không cho phép trỏ thẳng Organization ở actor; lịch của một khoa phòng gắn qua VNCoreLocation hoặc VNCoreHealthcareService. Extension phương thức cung cấp dịch vụ cho biết lịch này dành cho khám trực tiếp, khám tại nhà hay khám từ xa; đây là thông tin người bệnh cần trước khi đặt. Căn cứ: Luật 15/2023/QH15 Điều 80 (khám bệnh, chữa bệnh từ xa), Điều 60 (trách nhiệm cơ sở); TT 32/2023/TT-BYT (phạm vi hành nghề — lịch phải nằm trong phạm vi hành nghề của người hành nghề); TT 13/2025/TT-BYT (bệnh án điện tử). / VN Core Schedule profile describing service availability of a practitioner, healthcare service or location, as the basis for bookable slots and appointments.

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 Goal ghi nhận mục tiêu điều trị/chăm sóc của người bệnh (vd kiểm soát huyết áp, đường huyết mục tiêu). Thường gắn với CarePlan/EpisodeOfCare trong quản lý bệnh mạn tính. Căn cứ pháp lý:

• TT 13/2025/TT-BYT — bệnh án điện tử (mục tiêu điều trị). / VN Core Goal for treatment/care goals.

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 (theo NĐ 102/2025/NĐ-CP Điều 6) — primary key
• identifier[GPHN] = số Giấy phép hành nghề (NĐ 96/2023/NĐ-CP 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 CareTeam ghi nhận nhóm/đội ngũ chăm sóc người bệnh (bác sĩ điều trị, điều dưỡng chính, chuyên khoa phối hợp) trong quản lý bệnh mạn tính, chăm sóc đa chuyên khoa, hoặc một đợt chăm sóc (EpisodeOfCare). Khép bộ ba care-management: CarePlan → Goal → CareTeam. Căn cứ pháp lý:

• TT 13/2025/TT-BYT — bệnh án điện tử (đội ngũ điều trị, chăm sóc).
• Luật Khám bệnh, chữa bệnh 15/2023/QH15 — tổ chức KCB, vai trò người hành nghề. / VN Core CareTeam for the multidisciplinary care team caring for a patient.

Profile Group cho Việt Nam. Dùng cho ba tình huống: đoàn đối tượng của chiến dịch tiêm chủng hoặc sàng lọc, mẫu số của một chỉ tiêu chất lượng (VNCoreMeasureReport), và nhóm đích của một lần rút trích dữ liệu theo lô. Group có hai kiểu định nghĩa loại trừ nhau theo FHIR: liệt kê thành viên (member) hoặc mô tả tiêu chí (characteristic với actual = false). Với chiến dịch tiêm chủng, nên dùng tiêu chí thay vì liệt kê danh sách người bệnh — danh sách cụ thể là dữ liệu cá nhân, còn tiêu chí thì không. Căn cứ: Luật 114/2025/QH15 (phòng bệnh — đối tượng tiêm chủng, sàng lọc); TT 35/2024/TT-BYT (đánh giá chất lượng bệnh viện); Luật 91/2025/QH15 (dữ liệu cá nhân — lý do ưu tiên tiêu chí hơn danh sách). / VN Core Group profile for immunization or screening cohorts, quality-measure denominators, and bulk-export targets. Prefer criteria-based definition over member enumeration: a member list is personal data, a criterion is not.

Profile ClinicalImpression ghi nhận hợp lý/nhận định lâm sàng của bác sĩ trong một lượt khám (đánh giá tổng hợp, biện luận chẩn đoán, tiên lượng). Bổ trợ cho Condition (chẩn đoán) bằng phần biện luận. Căn cứ pháp lý:

• TT 13/2025/TT-BYT — bệnh án điện tử (nhận định/biện luận lâm sàng). / VN Core ClinicalImpression for clinical reasoning/assessment.

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; thông báo vi phạm cho cơ quan chuyên trách chậm nhất 72 giờ kể từ khi phát hiện, KHI vi phạm có thể gây tổn hại (Điều 23 khoản 1); cơ chế giám sát xử lý không cần đồng ý (Điều 19 khoản 2)
• NĐ 356/2025/NĐ-CP — 31/12/2025 — hướng dẫn BVDLCN; nội dung thông báo vi phạm (Điều 28, Mẫu số 08); riêng dữ liệu vị trí/sinh trắc học: thông báo cho CHỦ THỂ trong 72 giờ và lưu hồ sơ vi phạm tối thiểu 5 năm (Điều 29 khoản 1)
• Luật 116/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — đang áp dụng, thay Luật 24/2018/QH14) — 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 Questionnaire biểu diễn các mẫu phiếu khám sức khỏe định kỳ/sàng lọc theo QĐ 2062/QĐ-BYT Phụ lục 01 — 3 mẫu theo nhóm tuổi (<6 / 6–18 / ≥18, thay 17 mẫu QĐ 1551/QĐ-BYT), kèm mẫu khám sức khỏe tâm thần theo TT 25/2026/TT-BYT Mẫu 04. Mỗi item.linkId ánh xạ tới một trường dữ liệu của Phụ lục 01 (vd HO_TEN, CHIEU_CAO, PHAN_LOAI_SK); các trường có mã trả lời (vd giới tính, đối tượng khám) dùng answerValueSet. Kết quả thu thập biểu diễn bằng QuestionnaireResponse, sau đó tổng hợp vào VNCoreCompositionHealthCheckup để liên thông. Dẫn xuất từ HL7 SDC sdc-questionnaire (Structured Data Capture, hl7.fhir.uv.sdc#4.0.0); các trường có mã trả lời dùng answerValueSet trỏ tới ValueSet KSK chính thức, trường bắt buộc đánh dấu required. Căn cứ pháp lý:

• QĐ 2062/QĐ-BYT (07/7/2026) — đặc tả dữ liệu mẫu phiếu KSK (Phụ lục 01), THAY Phụ lục 01 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất.
• TT 25/2026/TT-BYT — mẫu khám sức khỏe tâm thần (Mẫu 04).
• QĐ 1332/QĐ-BYT (2024) — Sổ sức khỏe điện tử VNeID.
• QĐ 3176/QĐ-BYT (2024) — kiểu/định dạng các trường dữ liệu dùng chung. / VN Core Questionnaire for the periodic/screening health-checkup forms (SDC).

Profile Observation ghi nhận phân loại sức khỏe (Loại I–V) trong kết luận khám sức khỏe định kỳ — trường PHAN_LOAI_SK. Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 01 (gốc phân loại sức khỏe theo TT 14/2013/TT-BYT).

Profile Observation ghi nhận mức độ ưu tiên phân loại người bệnh tại khoa Cấp cứu. Thang 5 cấp độ là thang ĐỀ XUẤT của VN Core (proposed/local, tham chiếu thực hành 5 mức quốc tế/ATS) — QĐ 01/2008/QĐ-BYT chỉ là căn cứ NGUYÊN TẮC ưu tiên người bệnh cấp cứu, văn bản KHÔNG quy định số mức hay mốc thời gian cụ thể. Dùng trong lượt cấp cứu (Encounter.class=EMER) để ghi mức ưu tiên triage do điều dưỡng/bác sĩ phân loại. Căn cứ pháp lý:

• QĐ 01/2008/QĐ-BYT (21/01/2008) — Quy chế Cấp cứu, Hồi sức tích cực và Chống độc (phân loại ưu tiên người bệnh cấp cứu)
• TT 13/2025/TT-BYT — bệnh án điện tử ghi nhận diễn biến cấp cứu. / VN Core triage acuity Observation for emergency department patient prioritization (5-level scale).

Profile AuditEvent ghi quyết định CHO PHÉP hoặc TỪ CHỐI xử lý dữ liệu cá nhân dựa trên một căn cứ pháp lý không qua sự đồng ý của chủ thể. Mô hình tách quyết định khỏi truy cập/tiết lộ thực tế theo pattern IHE BALP: quyết định này phải có căn cứ Điều 19, mục đích sử dụng, requester, authorizer/PDP, controller, URI điều luật/chính sách có phiên bản và bằng chứng; mỗi lần truy cập/tiết lộ tiếp theo được ghi bằng AuditEvent riêng. Extension căn cứ pháp lý là extension thường, không phải modifierExtension. Căn cứ pháp lý: Luật 91/2025/QH15 Điều 19. NĐ 356/2025/NĐ-CP Điều 19 cung cấp lớp trách nhiệm giải trình qua hồ sơ đánh giá tác động, mục đích, luồng dữ liệu, biện pháp bảo vệ và rủi ro; không đặt cùng một nghĩa vụ chứng minh trực tiếp cho cả năm điểm Điều 19 khoản 1 của Luật. / AuditEvent profile recording a PERMIT or DENY decision for personal-data processing under a legal basis that does not rely on the data subject's consent. Following the IHE BALP pattern, it separates the authorization decision from each subsequent actual access or disclosure. The decision carries the Article 19 basis, purpose of use, requester, authorizer/PDP, controller, versioned statute and local-policy URIs, and supporting evidence. The legal-basis extension is an ordinary extension, not a modifierExtension.

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.

Bản XUẤT KHẨU QUỐC TẾ của Sổ Sức khỏe điện tử theo chuẩn International Patient Summary (IPS) — kế thừa trực tiếp Composition-uv-ips. Dùng cho tình huống người Việt khám/chữa bệnh ở nước ngoài (du lịch, du học, lao động): hệ thống FHIR nước ngoài có thể đọc bản tóm tắt này vì nó tuân thủ IPS toàn cầu.

Kiến trúc dual-profile (mô hình JP Core):

• VNCoreCompositionHealthRecordSummary = bản nội địa hiển thị trên VNeID (shape QĐ 1332/QĐ-BYT, mã VN).
• VNCoreCompositionIPS (profile này) = bản quốc tế sinh từ bản nội địa qua operation $summary (projection sang resource IPS-profiled, mã SNOMED CT — sẵn có qua VNSNOMEDSubsetCS 77.393 concept).

Căn cứ pháp lý:

• QĐ 1332/QĐ-BYT — Sổ SKĐT VNeID.
• QĐ 2062/QĐ-BYT — dữ liệu khám sức khỏe hiện hành; sửa đổi, bổ sung QĐ 1551/QĐ-BYT.
• HL7 International Patient Summary (IPS) — chuẩn quốc tế bản tóm tắt người bệnh. / VN Core IPS-conformant Composition: the international export view of the Sổ SKĐT, derived from Composition-uv-ips, generated from the domestic summary via the $summary operation.

Profile Composition cho Sổ Sức khỏe điện tử tích hợp trên VNeID — bản tóm tắt sức khỏe tổng hợp (longitudinal) của người dân, theo pattern International Patient Summary (IPS). Khác với VNCoreCompositionHealthCheckup (1 đợt KSK) và VNCoreComposition (bệnh án EMR): đây là VIEW tổng hợp hiển thị cho người dân trên VNeID, ánh xạ trực tiếp cấu trúc Sổ SKĐT của QĐ 1332/QĐ-BYT (Mục A: Hành chính + Tiền sử + Thông tin đợt KCB). Các mục QĐ 1332/QĐ-BYT → section IPS:

• Tiền sử dị ứng → allergies (LOINC 48765-2)
• Tiền sử bệnh tật / chẩn đoán → problems (11450-4)
• Tiền sử tiêm chủng → immunizations (11369-6)
• Chỉ số theo dõi (nhóm máu, chiều cao, cân nặng, sinh hiệu) → vitalSigns (8716-3)
• Kết quả xét nghiệm / CĐHA → results (30954-2)
• Thuốc đã điều trị → medications (10160-0)
• Phẫu thuật, thủ thuật → procedures (47519-4) Căn cứ: QĐ 1332/QĐ-BYT (21/5/2024 — Sổ SKĐT VNeID); QĐ 2062/QĐ-BYT (sửa đổi, bổ sung QĐ 1551/QĐ-BYT về dữ liệu KSK); QĐ 1923/QĐ-BYT (chuẩn hóa HL7 FHIR); HL7 IPS làm khung tham chiếu quốc tế.

Profile MedicationAdministration cho Việt Nam. Ghi nhận sự kiện cho người bệnh dùng thuốc thực tế (điều dưỡng thực hiện y lệnh) — khép chuỗi kê đơn → cấp phát → sử dụng trong điều trị nội trú và bệnh án điện tử. Bổ sung mắt xích còn thiếu so với VNCoreMedicationRequest (y lệnh) và VNCoreMedicationDispense (cấp phát). Căn cứ pháp lý hiện hành:

• TT 13/2025/TT-BYT (06/6/2025) — bệnh án điện tử ghi nhận diễn biến dùng thuốc nội trú
• Luật Dược 105/2016/QH13 Điều 74 + Luật 44/2024/QH15 — nguyên tắc kê đơn/sử dụng thuốc
• NĐ 163/2025/NĐ-CP (29/6/2025) — hướng dẫn Luật Dược (thay NĐ 54/2017/NĐ-CP từ 01/7/2025)
• QĐ 3176/QĐ-BYT (29/10/2024) — XML: NGAY_TH_YL (ngày thực hiện y lệnh), MA_THUOC, SO_DANG_KY
• TT 26/2025/TT-BYT — kê đơn/sử dụng thuốc ngoại trú và sau điều trị nội trú
• NĐ 188/2025/NĐ-CP — thanh toán BHYT thuốc đã sử dụng. / VN Core MedicationAdministration profile records the actual administration of medication to a patient, completing the prescribe → dispense → administer chain in inpatient EMR workflows.

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Đ-CP + NĐ 07/2023/NĐ-CP + NĐ 04/2025/NĐ-CP) đượ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 — ban hành 01/7/2025, hiệu lực 01/9/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 hỗ trợ biểu diễn có cấu trúc 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. NĐ 356/2025/NĐ-CP không quy định FHIR là định dạng nộp; phù hợp với profile này không tự chứng minh tính hợp lệ, thời điểm gửi, chữ ký/đóng dấu hoặc việc cơ quan có thẩm quyền đã tiếp nhận. 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) — ánh xạ phần ký, ghi rõ họ tên và đóng dấu của Mẫu 08; bằng chứng chữ ký giấy hoặc chữ ký điện tử/số được quản lý theo kênh nộp và quy định áp dụng

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); Điều 23 khoản 1 — chỉ khi vi phạm có thể gây các loại tổn hại được liệt kê, thông báo cơ quan chuyên trách chậm nhất 72 giờ kể từ khi phát hiện
• Luật 116/2025/QH15 — Luật An ninh mạng sửa đổi (lưu vết, log) — đang áp dụng từ 01/07/2026, thay Luật 24/2018/QH14

Quy trình triển khai gợi ý (không phải giao thức nộp do pháp luật quy định):

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

Lý do IG chọn Composition:

• 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 bản ghi tài liệu bền vững; Communication vẫn có thể dùng trong một số exchange pattern khác và không bị giới hạn tuyệt đối ở tương tác lâm sàng
• Composition.attester ánh xạ danh tính/chế độ xác nhận; không thay thế bằng chứng chữ ký và đóng dấu thực tế

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; mã số BHYT nhận 2 format (10 số hiện hành + 15 ký tự legacy — CCCD không thuộc sid/bhyt, xem vn-bhyt-ns). 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 23/2024/TT-BYT (danh mục kỹ thuật KCB hiện hành, thay TT 43/2013/TT-BYT + TT 21/2017/TT-BYT từ 18/10/2024), QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 3176/QĐ-BYT (2024) — trường MA_DVKT/MA_PTTT_QT 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 — đang áp dụng) — 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), TT 13/2026/TT-BYT (hiệu lực 01/07/2026) — hoạt động tiêm chủng, danh mục 14 bệnh tiêm chủng bắt buộc (thay thế TT 52/2025/TT-BYT), 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 MedicationStatement ghi nhận tiền sử/đang dùng thuốc của người bệnh (khai thác bệnh sử khi tiếp nhận ngoại trú/nội trú). Khác MedicationRequest (y lệnh mới) và MedicationDispense (cấp phát) — đây là ghi nhận thuốc người bệnh khai/đang dùng. Căn cứ pháp lý:

• TT 13/2025/TT-BYT — bệnh án điện tử (tiền sử dùng thuốc)
• Luật Dược 105/2016/QH13 + Luật 44/2024/QH15 — quản lý thông tin thuốc. / VN Core MedicationStatement for recording patient-reported/current medication history.

Profile FamilyMemberHistory ghi nhận tiền sử bệnh gia đình của người bệnh (bố, mẹ, anh/chị/em ruột mắc bệnh mạn tính, ung thư, bệnh di truyền…). Dùng trong khám sức khỏe định kỳ (mục tiền sử gia đình của phiếu KSK) và bệnh án điện tử. Căn cứ pháp lý:

• QĐ 1551/QĐ-BYT (2026) — phiếu khám sức khỏe (mục tiền sử gia đình).
• TT 13/2025/TT-BYT — bệnh án điện tử (tiền sử gia đình). / VN Core FamilyMemberHistory for family medical history captured in periodic health checkups and EMR.

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 (system = http://loinc.org; 104.054 mã LOINC 2.78, bản dịch tiếng Việt do BYT phát hành qua supplement vn-loinc-cs). 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 Claim dẫn xuất cho bảng kê chi phí khám bệnh, chữa bệnh chi tiết gồm 13 cột và hỗ trợ nhiều giai đoạn hưởng trong cùng một đợt KCB, kể cả một thẻ BHYT đổi mức hưởng. Mỗi item liên kết tường minh với một benefit stage và phân bổ thành tiền bệnh viện vào bốn nguồn thanh toán. Dòng chi tiết bên trong gói thiết bị được biểu diễn bằng item.detail; theo ngoại lệ của văn bản, allocation chỉ bắt buộc ở item tổng gói, không bắt buộc ở detail. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [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.

This derived Claim profile represents the 13-column itemized healthcare-cost statement and supports multiple benefit stages within one episode, including a benefit-level change on the same BHYT coverage. Every item explicitly identifies its benefit stage and allocates the hospital line amount across four payment sources. Detail rows inside a medical-device package are represented by item.detail; under the legal exception, allocation is required only at the package item level and not on detail rows.

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 23/2024/TT-BYT (danh mục kỹ thuật KCB hiện hành), 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/QĐ-BYT), 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. Based on TT 13/2025/TT-BYT (EMR), TT 23/2024/TT-BYT (medical technical service catalog), and QĐ 3176/QĐ-BYT (BHXH output 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Đ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT). 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Đ-BYT
• QĐ 3176/QĐ-BYT (29/10/2024) — Sửa đổi QĐ 4750/QĐ-BYT
• QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB (thay QĐ 6556/QĐ-BYT)
• 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 — đang áp dụng) — 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 CoverageEligibilityRequest cho luồng tra cứu/kiểm tra hiệu lực và quyền lợi thẻ BHYT tại cơ sở KCB (khâu tiếp đón), gửi tới Cổng giám định BHYT của cơ quan BHXH. Đây là mắt xích ĐẦU của luồng BHYT (eligibility → Coverage → Claim → ClaimResponse → EOB → PaymentReconciliation). 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 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 (liên thông API Cổng BHXH, tra cứu thẻ BHYT)
• QĐ 3176/QĐ-BYT — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH

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 cho đơn thuốc cổ truyền, thuốc dược liệu và đơn kết hợp thuốc cổ truyền với thuốc hóa dược kê trong điều trị ngoại trú, theo TT 55/2025/TT-BYT. Khác biệt so với đơn ngoại trú hóa dược (VNCoreOutpatientPrescription): mã đơn thuốc quốc gia mang hậu tố T; bài thuốc cổ truyền mã hóa bằng VNYHCTPrescriptionCS và vị thuốc bằng VNYHCTHerbCS; phương pháp chế biến vị thuốc ghi ở extension processingMethod. Với đơn kết hợp, mỗi dòng thuốc vẫn là một MedicationRequest riêng dùng chung groupIdentifier: dòng thuốc cổ truyền theo profile này, dòng thuốc hóa dược theo VNCoreOutpatientPrescription. / Traditional-medicine outpatient prescription profile per Circular 55/2025/TT-BYT; the national prescription code carries the T suffix.

Profile cho đơn thuốc hóa dược, sinh phẩm kê trong điều trị ngoại trú và liên thông Hệ thống đơn thuốc quốc gia, theo TT 26/2025/TT-BYT (ban hành 30/06/2025, hiệu lực 01/07/2025). Khác biệt so với profile nền VNCoreMedicationRequest: mã đơn thuốc quốc gia là BẮT BUỘC và có ràng buộc định dạng; intent cố định order; category giới hạn ở bối cảnh ngoại trú hoặc ra viện; đơn phải đã phát hành (không dùng cho bản nháp). Đơn thuốc cổ truyền và thuốc dược liệu dùng profile riêng VNCoreYHCTOutpatientPrescription theo TT 55/2025/TT-BYT. / Outpatient prescription profile per Circular 26/2025/TT-BYT: the national prescription code is mandatory and format-constrained, intent is fixed to order, and the category is limited to outpatient or discharge contexts.

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. Based on TT 13/2025/TT-BYT (EMR), QĐ 3176/QĐ-BYT (BHXH data standard — MA_THUOC field), Pharmaceutical Law 2016 Art.74 as amended by Law 44/2024/QH15, and TT 26/2025/TT-BYT for outpatient/electronic prescribing.

Profile Address cho Việt Nam, hỗ trợ ĐVHC mới theo NQ 202/2025/QH15 (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 Measure cho Việt Nam. Dùng để định nghĩa chỉ tiêu đánh giá chất lượng cơ sở khám bệnh, chữa bệnh và chỉ tiêu hoạt động y tế công cộng (tỷ lệ tiêm chủng, tỷ lệ sàng lọc). Trường hợp dùng đã có căn cứ: tiêu chuẩn chất lượng cơ bản đối với bệnh viện theo TT 35/2024/TT-BYT — năm nhóm tiêu chuẩn tại Phụ lục, đánh giá một lần mỗi năm, thực hiện trong Quý I của năm liền kề (Điều 1 khoản 3). LƯU Ý VỀ CÁCH TÍNH: TT 35/2024/TT-BYT xếp loại NHỊ PHÂN — đạt khi và chỉ khi toàn bộ tiêu chuẩn đều Có; chỉ cần một tiêu chuẩn Không là không đạt. Tỷ lệ phần trăm tiêu chuẩn đạt KHÔNG có giá trị pháp lý, chỉ dùng theo dõi nội bộ. Quy tắc này diễn đạt được bằng chính FHIR: scoring = composite kèm compositeScoring = all-or-nothing; guidance chỉ giải thích thêm chứ không thay thế phần khai máy-đọc-được. NGUỒN DỮ LIỆU cho chỉ tiêu dạng checklist: khi tiêu chuẩn là điều kiện về cơ sở vật chất, tổ chức hoặc quy chế — không tính được từ dữ liệu lâm sàng — thì nguồn đúng là QuestionnaireResponse của phiếu tự đánh giá, và criteria viết bằng FHIRPath trên chính bản ghi đó. Không dùng CQL cho loại này: CQL sinh ra để truy vấn dữ liệu lâm sàng theo quần thể, ở đây không có gì để truy vấn. Căn cứ: TT 35/2024/TT-BYT (tiêu chuẩn chất lượng cơ bản bệnh viện); Luật 15/2023/QH15 Điều 58 (đánh giá và công khai chất lượng); Luật 114/2025/QH15 (chỉ tiêu phòng bệnh). / VN Core Measure profile for facility quality standards and public-health indicators. Note that Circular 35/2024/TT-BYT scores hospitals as pass/fail on the conjunction of all standards; a percentage is not a legal result.

Profile PaymentReconciliation cho thông báo chuyển tiền/remittance và phân bổ một khoản thanh toán BHYT tổng hợp về các yêu cầu hoặc giao dịch thành phần theo semantics FHIR R4. Resource này có thể tham chiếu kỳ nghiệp vụ và các Claim liên quan, nhưng không phải carrier chuẩn của Biên bản quyết toán Mẫu 06/BH. Dữ liệu 5 phần A–E và bộ chỉ tiêu quyết toán quý phải dùng LogicalModel VNCoreQuarterlyHealthcareCostSettlement; nếu cần văn bản ký, render LogicalModel rồi đóng gói bằng Composition/DocumentReference. Slice formNumber được giữ để tương thích dữ liệu cũ, không biến PaymentReconciliation thành biểu mẫu 06/BH. Căn cứ: [TT 12/2026/TT-BTC] (ban hành 10/02/2026, hiệu lực 10/02/2026) — Giám định, thanh toán và quyết toán chi phí KCB BHYT; [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] (ban hành 29/06/2025, hiệu lực 01/07/2025) — Giao dịch điện tử trong lĩnh vực BHXH; [Luật 51/2024/QH15] (ban hành 27/11/2024, hiệu lực 01/07/2025) — Luật BHYT sửa đổi.

English summary: This profile represents a BHYT remittance or bulk payment and allocates that payment to underlying requests or transactions in accordance with FHIR R4 PaymentReconciliation semantics. It is not the canonical carrier for quarterly Form 06/BH; use VNCoreQuarterlyHealthcareCostSettlement for the five-section quarterly settlement dataset and render/package that model separately when a signed document is required. The formNumber slice remains only for backward compatibility.

Profile Consent cho Việt Nam CHỈ biểu diễn lựa chọn của chủ thể dữ liệu: đồng ý, từ chối, rút lại hoặc giới hạn xử lý/chia sẻ dữ liệu y tế cá nhân. Xử lý không cần đồng ý theo Luật 91/2025/QH15 Điều 19 khoản 1 không được authoring bằng Consent trong 0.9; dùng VNCoreAuditEventLegalBasisDecision cho quyết định, AuditEvent tiếp theo cho truy cập/tiết lộ thực tế, và Provenance nếu tạo/sửa/dẫn xuất dữ liệu. Context extension trên Consent được giữ tạm để đọc legacy 0.8 và dự kiến gỡ ở 1.0.

Profile hỗ trợ biểu diễn sự đồng ý/từ chối xử lý dữ liệu y tế cá nhân theo các yêu cầu được tham chiếu từ Luật 91/2025/QH15 (Bảo vệ dữ liệu cá nhân) và NĐ 356/2025/NĐ-CP, bao gồm mục đích xử lý, phạm vi, thời hạn, và quyền rút lại đồng ý. Phù hợp với profile này chỉ xác nhận cấu trúc FHIR; không tự chứng minh sự đồng ý hợp lệ hoặc việc tuân thủ pháp luật. Bên triển khai phải đánh giá vai trò, căn cứ, bằng chứng và quy trình thực tế. Dữ liệu y tế = dữ liệu cá nhân nhạy cảm (Luật 91/2025/QH15 Điều 2 khoản 3; danh mục tại NĐ 356/2025/NĐ-CP Điều 4 khoản 1 điểm d — tình trạng sức khỏe). Căn cứ (theo bản BAN HÀNH — ma trận điều khoản: governance/legal-article-map.json):

• Luật 91/2025/QH15 — thông qua 26/6/2025, hiệu lực 01/01/2026 — quyền chủ thể dữ liệu (Điều 4), sự đồng ý (Điều 9), rút lại/hạn chế xử lý (Điều 10), xử lý không cần đồng ý (Điều 19 — dùng VNCoreAuditEventLegalBasisDecision), chuyển xuyên biên giới (Điều 20), trẻ em/người mất năng lực hành vi dân sự (Điều 24), thông tin sức khỏe (Điều 26)
• NĐ 356/2025/NĐ-CP — 31/12/2025, hiệu lực 01/01/2026 — phương thức đồng ý (Điều 6), hồ sơ đánh giá tác động (Điều 19) và lưu bằng chứng đồng ý (Điều 6 khoản 2)
• NĐ 278/2025/NĐ-CP — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — nghĩa vụ chia sẻ, chuẩn hóa hoặc kết nối chỉ áp dụng theo đúng phạm vi của từng quy định; Consent/policy là lựa chọn biểu diễn của IG cho kiểm soát chia sẻ, không phải định dạng do Nghị định quy định
• NĐ 102/2025/NĐ-CP — 13/5/2025 — quản lý dữ liệu y tế số.

Ánh xạ trạng thái của IG (dựa trên các quyền/nghĩa vụ tại Luật 91/2025/QH15 Điều 4/9/10; Luật không quy định mã trạng thái FHIR R4):

• Từ chối đang hiệu lực (chủ thể chủ động không cho phép một phạm vi xử lý) = status=active + rule nested provision.provision.type=deny;
• rejected = đề nghị đồng ý bị TỪ CHỐI ngay từ đầu, chưa từng có hiệu lực;
• inactive = đồng ý đã CHẤM DỨT hiệu lực: rút lại theo Điều 10, hết thời hạn, hoặc bị thay bằng bản mới. Yêu cầu rút lại không áp dụng hồi tố (Điều 10 khoản 4) — hoạt động xử lý trước thời điểm rút không bị tác động bởi YÊU CẦU RÚT; tính hợp pháp của xử lý trước đó được đánh giá độc lập theo căn cứ tại thời điểm xử lý. / This profile represents only the data subject's choices: consent, refusal, withdrawal, or limits on processing and sharing. Processing without consent under Article 19(1) SHALL NOT be newly authored as Consent in 0.9. Use VNCoreAuditEventLegalBasisDecision for the authorization decision, a subsequent AuditEvent for actual access/disclosure, and Provenance when data is created, updated, or derived. The Consent extension context is retained only for legacy 0.8 reads during the 0.9 line and is planned for removal in 1.0. Conformance to this profile validates FHIR structure only and does not itself prove valid consent or legal compliance.

Profile EpisodeOfCare gom nhiều Encounter thành một đợt điều trị/chương trình: quản lý bệnh mạn tính BHYT (ĐTĐ/THA/COPD/ung thư), chương trình DOTS lao, quản lý thai sản, hoặc nối lượt cấp cứu → nội trú trong cùng đợt. Giúp theo dõi liên tục (longitudinal) thay vì rời rạc theo từng lượt. Căn cứ pháp lý:

• TT 13/2025/TT-BYT — bệnh án điện tử (theo dõi đợt điều trị)
• QĐ 3176/QĐ-BYT (29/10/2024) — chuẩn dữ liệu đầu ra KCB (đợt KCB). / VN Core EpisodeOfCare grouping multiple encounters into a treatment episode/program.

Extension phức hợp tách chi tiết 4 thành phần của trường T_NGUONKHAC (nguồn tài chính khác hỗ trợ chi phí KCB) theo từng dòng chi phí BHYT (XML2 thuốc, XML3 DVKT/VTYT). Mapping QĐ 3176/QĐ-BYT: T_NGUONKHAC_NSNN, T_NGUONKHAC_VTNN, T_NGUONKHAC_VTTN, T_NGUONKHAC_CL (Bảng 2 STT 22–26 đối với thuốc; Bảng 3 các trường tương ứng đối với DVKT/VTYT). Công thức tổng: T_NGUONKHAC = T_NGUONKHAC_NSNN + T_NGUONKHAC_VTNN + T_NGUONKHAC_VTTN + T_NGUONKHAC_CL. Quy tắc khấu trừ (QĐ 3176/QĐ-BYT, sửa đổi toàn bộ diễn giải trường T_NGUONKHAC): là số tiền do nguồn khác chi trả; khi T_NGUONKHAC > 0 thì giảm trừ lần lượt vào các khoản T_BNTT → T_BNCCT → T_BHTT cho đến khi hết số tiền T_NGUONKHAC. Extension này chỉ mang số tiền từng nguồn, không encode công thức khấu trừ (do StructureMap của exporter/adjudication xử lý). Complex extension breaking down the four components of the QĐ 3176/QĐ-BYT T_NGUONKHAC field (other funding sources) at claim line level: state budget, foreign aid, domestic aid, and remaining other sources. Căn cứ: QĐ 130/QĐ-BYT, được sửa đổi, bổ sung bởi QĐ 4750/QĐ-BYT và QĐ 3176/QĐ-BYT (29/10/2024) — đọc hợp nhất cả chuỗi.

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 VNLegalDocumentRefVS — ư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Đ-CP + NĐ 07/2023/NĐ-CP + NĐ 04/2025/NĐ-CP). Từ 0.9.0, giá trị có thể là mã ngoại lệ trong VNLegalBasisExceptionCS (#local-design, #technical-infrastructure, #example-only, #pending-source) khi artifact cố ý không viện dẫn văn bản. LƯU Ý TƯƠNG THÍCH: mở rộng context ở 0.9.0 là tương thích MỘT CHIỀU — instance cũ vẫn hợp lệ, nhưng artifact mới gắn extension trên 5 loại resource mới sẽ không validate được bằng package 0.8.x; hệ thống tiêu thụ cần nâng package ≥ 0.9.0. Context: ElementDefinition (cho element-level), StructureDefinition (cho artifact-level), CodeSystem, ValueSet, CapabilityStatement, ConceptMap, NamingSystem, SearchParameter, Questionnaire, StructureMap, OperationDefinition.

Căn cứ pháp lý khi xử lý dữ liệu cá nhân KHÔNG cần sự đồng ý của chủ thể dữ liệu, theo Luật 91/2025/QH15 Điều 19 khoản 1 (a/b/c/d/đ). Carrier chính: (1) AuditEvent cho quyết định cho phép/từ chối và cho truy cập/tiết lộ thực tế; (2) Provenance khi căn cứ đó đi cùng việc tạo, sửa hoặc dẫn xuất dữ liệu. Context Consent được GIỮ tạm trong dòng 0.9 chỉ để consumer đọc dữ liệu legacy 0.8; VNCoreConsent cấm authoring mới và context Consent sẽ được gỡ ở 1.0. PurposeOfUse mô tả mục đích nghiệp vụ, không thay thế căn cứ pháp lý. Căn cứ: Luật 91/2025/QH15 Điều 19; NĐ 356/2025/NĐ-CP bổ sung lớp trách nhiệm giải trình, đánh giá tác động và biện pháp bảo vệ, không đặt nghĩa vụ chứng minh trực tiếp như nhau cho cả 5 điểm. / Legal basis for processing personal data without the data subject's consent under Article 19(1). AuditEvent is the primary carrier for authorization decisions and actual access/disclosure; Provenance carries the basis when data is created, updated, or derived. Consent remains an allowed extension context only for legacy 0.8 reads during the 0.9 line; new VNCoreConsent authoring is prohibited and the Consent context is planned for removal in 1.0. PurposeOfUse is operational purpose, not legal basis.

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-BYT + TT 53/2025/TT-BYT 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-BYT + TT 53/2025/TT-BYT 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ị.

Giai đoạn áp dụng một mức hưởng BHYT cụ thể trong một đợt khám bệnh, chữa bệnh. Extension mang khóa giai đoạn, khoảng thời gian và mức hưởng để một Claim hoặc ExplanationOfBenefit có thể biểu diễn trường hợp cùng một thẻ BHYT đổi mức hưởng trong đợt điều trị. Mỗi insurance vẫn đại diện cho một Coverage thực và có thể mang nhiều extension này; không lặp lại Coverage hoặc dùng focal = false chỉ để biểu diễn giai đoạn. Khóa sequence của extension độc lập với Claim.insurance.sequence, vốn chỉ giữ nghĩa thứ tự phối hợp quyền lợi (COB). Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [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.

A benefit stage identifies the period during which one BHYT benefit percentage applies within a healthcare episode. Each insurance entry continues to represent one real Coverage and may carry multiple instances of this extension; implementations do not repeat a Coverage or use focal = false merely to represent a stage. The extension sequence is independent from Claim.insurance.sequence, which retains its base coordination-of-benefits (COB) meaning.

Hình thức đến khám chữa bệnh (trường HTCHUYEN theo QĐ 3176/QĐ-BYT). Bổ sung cho danh mục loại KCB legacy của VNCoreExtInsuranceVisitType: loại KCB 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 KET_QUA_DTRI) 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 (loại ra viện — MA_LOAI_RV). KET_QUA_DTRI đánh giá kết quả y khoa; MA_LOAI_RV ghi nhận loại 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).

Khóa liên kết một dòng chi phí Claim hoặc ExplanationOfBenefit với đúng giai đoạn hưởng bảo hiểm được khai báo trên insurance. Giá trị là positiveInt và phải khớp sequence trong VNCoreExtCoverageBenefitStage. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [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.

This extension links a Claim or ExplanationOfBenefit cost line to the exact insurance benefit stage declared on insurance. Its positive integer value must match the sequence carried by VNCoreExtCoverageBenefitStage.

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) — 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 legacy trên lượt khám. Danh mục legacy theo trường MA_LYDO_VVIEN — QĐ 4210/QĐ-BYT (2017), gồm bốn mã nguồn 1–4; mã 5 là mở rộng dự án chờ nguồn. Chuẩn hiện hành QĐ 3176/QĐ-BYT dùng MA_DOI_TUONG_KCB với danh mục 27 mã theo QĐ 3276/QĐ-BYT (xem VNPatientVisitTypeCS).

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ở 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 (26/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 bổ thành tiền bệnh viện của một dòng Claim vào bốn nguồn thanh toán trên bảng kê chi phí KCB: quỹ BHYT, người bệnh cùng chi trả, nguồn khác và người bệnh tự trả. Mỗi khoản bắt buộc có giá trị không âm và tiền tệ VND. Dòng chi tiết bên trong gói thiết bị được biểu diễn bằng Claim.item.detail và không mang extension này; phân bổ chỉ bắt buộc ở item tổng gói. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB.

This extension allocates a Claim line's hospital amount across the four payment sources in the itemized healthcare-cost statement: the BHYT fund, patient co-payment, other sources, and patient self-pay. Every component is required, non-negative, and denominated in VND. Device-package detail rows are represented by Claim.item.detail and do not carry this extension; allocation is required only on the package-level item.

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/QĐ-BYT, QĐ 847/QĐ-BYT) → 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.

Phương pháp chế biến vị thuốc, dược liệu hoặc thuốc y học cổ truyền — mang trường MA_PP_CHEBIEN của dữ liệu BHYT/KCB. Từ bản 0.9.0 đã có danh mục mã chính thức: vn-tcm-processing-method-vs (Phụ lục 3 QĐ 824/QĐ-BYT, 40 mã). Ưu tiên ghi valueCodeableConcept theo danh mục này. Vẫn cho phép valueString vì hai lý do thực tế: TT 14/2024/TT-BYT bổ sung ba phương pháp phức chế (chưng, tôi, rán dầu) mà bộ mã dùng chung chưa cấp mã riêng, và Điều 4 khoản 2 TT 14/2024/TT-BYT cho phép cơ sở tự xây dựng phương pháp chế biến khi phương pháp đó chưa được quy định.

Mã phương pháp vô cảm được sử dụng trong phẫu thuật, thủ thuật. Mapping QĐ 3176/QĐ-BYT: PP_VO_CAM (Bảng 3 STT 42 — Chỉ tiêu chi tiết DVKT và VTYT): 1=Gây mê, 2=Gây tê, 3=Châm tê, 4=Các phương pháp vô cảm khác. Trường thông tin này chỉ bắt buộc khi thực hiện phẫu thuật, thủ thuật có sử dụng phương pháp vô cảm. Extension host cho CodeSystem/ValueSet phương pháp vô cảm đã tạo trong đợt terminology (VNAnesthesiaMethodCS / VNAnesthesiaMethodVS). Anesthesia method used in a surgery/procedure per QĐ 3176/QĐ-BYT field PP_VO_CAM. Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024).

Phương thức cung cấp dịch vụ khám bệnh, chữa bệnh của một buổi hẹn, khung giờ hoặc lịch cung cấp dịch vụ: trực tiếp, tại nhà, từ xa, hoặc hỗ trợ từ xa giữa hai cơ sở. Vì sao cần extension: Appointment, Slot và Schedule của FHIR R4 không có element mang được phương thức cung cấp dịch vụ, trong khi người bệnh phải biết ngay khi đặt lịch là đến cơ sở hay chờ cuộc gọi. KHÔNG dùng cho Encounter: lượt khám từ xa biểu diễn bằng Encounter.class = VR theo chuẩn FHIR, thêm extension ở đó là lặp thông tin. Căn cứ: Luật 15/2023/QH15 Điều 80 (khám bệnh, chữa bệnh từ xa và hỗ trợ khám bệnh, chữa bệnh từ xa); Luật 114/2025/QH15 Điều 44 khoản 1 (đưa các hình thức này vào phạm vi hưởng bảo hiểm y tế từ 01/07/2026).

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 (Bảng 2 STT 36, Bảng 3 STT 40). 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 — nhóm các phương thức thể hiện sự đồng ý tại các điểm 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 hoặc Consent.provision để ghi phương thức mà hệ thống tuyên bố đã sử dụng. Extension hỗ trợ truy vết nhưng không tự chứng minh sự đồng ý hợp lệ, khả năng kiểm chứng hay tuân thủ NĐ 356/2025/NĐ-CP. Required binding giữ một taxonomy ổn định cho IG; other-verifiable chỉ dùng khi phương thức khác vẫn đáp ứng yêu cầu kiểm chứng và phải được mô tả trong hợp đồng/chứng cứ triển khai.

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].

Extension ghi nhận quan hệ vòng đời giữa cơ sở y tế hiện tại và một cơ sở khác khi mã/định danh cơ sở thay đổi do sáp nhập, chia tách, đổi tên hoặc thay mã (vd hệ quả của sắp xếp đơn vị hành chính theo NQ 202/2025/QH15). Generic cho mọi cơ sở y tế VN. Mỗi lần lặp mô tả MỘT quan hệ: loại quan hệ (relationType), cơ sở liên quan (target), thời điểm hiệu lực (period), căn cứ pháp lý (legalBasis) và các hạng mục được kế thừa (carryOver). Khi cơ sở tiền nhiệm đã giải thể và không còn Organization resource phân giải được, target có thể dùng Reference.identifier để tham chiếu logic theo mã CSKCB cũ. Căn cứ: NQ 202/2025/QH15 (sắp xếp ĐVHC) + NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế).

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/NĐ-CP Đ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 cho từng thiết bị cụ thể

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

• UDI (định danh cho từng thiết bị cụ thể theo thông lệ HL7)
• MA_VAT_TU (mã nghiệp vụ BHYT theo QĐ 3176/QĐ-BYT)
• Serial number (số sê-ri vật lý của từng thiết bị)
• Mã tài sản BV (mã nội bộ của cơ sở)

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 theo 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Đ-CP + NĐ 07/2023/NĐ-CP + NĐ 04/2025/NĐ-CP). 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 BHYT (TYLE_TT/TYLE_TT_BH), mức hưởng (MUC_HUONG), mức trần thanh toán BHYT (T_TRANTT), tỷ lệ thanh toán dịch vụ (TYLE_TT_DV), đơn giá BHYT (DON_GIA_BH) và thành tiền BHYT (THANH_TIEN_BH). Dùng trên: MedicationRequest, MedicationAdministration, Procedure, Claim.item, Claim.item.detail, ExplanationOfBenefit.item, ExplanationOfBenefit.item.detail, 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 hoặc item.detail; không dùng trên DeviceUseStatement vì DeviceUseStatement là ghi nhận sử dụng lâm sàng. Theo QĐ 697/QĐ-BYT (các dòng hướng dẫn khoảng 389 và 407), component trong gói TBYT mang lossless các cột 5/6/8/9; chỉ các cột 10–13 được tính ở item tổng gói. Mapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG; DON_GIA_BH (Bảng 3 STT 15), TYLE_TT_DV (Bảng 3 STT 17), THANH_TIEN_BH (Bảng 2 STT 21, Bảng 3 STT 20), T_TRANTT (Bảng 3 STT 21). Nguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level). Căn cứ: [QĐ 3176/QĐ-BYT] (ban hành 29/10/2024, hiệu lực 29/10/2024) — Chuẩn dữ liệu đầu ra KCB phục vụ BHXH; [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. English summary: Reusable line-level BHYT cost information for medication, procedure, service, Claim, EOB, and medication-administration data. On a medical-device package, each Claim/EOB item detail carries columns 5/6/8/9 losslessly, while columns 10–13 remain on the package item. insuranceLineAmount represents the insurance-eligible line amount (THANH_TIEN_BH/column 9), not the final BHYT fund allocation; on an EOB it aligns with adjudication eligible, while the fund allocation uses adjudication benefit.

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.

Extension ghi nhận THẨM QUYỀN PHÁP LÝ để một người đại diện/giám hộ/được uỷ quyền truy cập dữ liệu y tế thay người khác (vd cha/mẹ xem Sổ SKĐT của con qua VNeID). Mô hình hoá 'token đại diện' phục vụ Policy Decision Point (PDP): loại thẩm quyền, nguồn xác minh, thời điểm xác minh, thời hạn. PDP deny-by-default khi quan hệ mâu thuẫn/hết hạn. THAY ĐỔI 0.8.0 (breaking — hậu kiểm toán Codex): sub-extension restrictedSensitivity đã XÓA — ngữ nghĩa hạn chế truy cập là QUYẾT ĐỊNH CHÍNH SÁCH, không phải thuộc tính token: biểu diễn bằng VNCoreConsent.provision (type=deny + securityLabel theo vn-data-sensitivity-class-vs + actor[representative] gắn chính extension này để link token↔consent — PDP resolve một chiều qua Consent). Căn cứ: Bộ luật Dân sự 2015 (đại diện/giám hộ/uỷ quyền); Luật Căn cước 2023 (quan hệ nhân thân CSDLQGDC); Luật 91/2025/QH15 Điều 24 (đại diện theo pháp luật) + Luật Trẻ em 2016 (dữ liệu trẻ em, lớp nhạy cảm).

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.

Tuần tuổi thai thực tế tại thời điểm thực hiện thủ thuật/ghi nhận trên giấy tờ KCB, tính bằng số nguyên tuần (1–42 tuần). Mapping QĐ 3176/QĐ-BYT: TUOI_THAI (Bảng 7 STT 10 — Giấy ra viện; Bảng 11 STT 12 — Giấy chứng nhận nghỉ việc hưởng BHXH). Trường TUOI_THAI bắt buộc theo điều kiện khi MA_DINH_CHI_THAI='1' (đình chỉ thai nghén). Quan hệ điều kiện này được ràng buộc ở tầng logical model qua invariant bhyt-xml7-abortion-fields-required (Bảng 7) và bhyt-xml11-abortion-fields-required (Bảng 11); extension chỉ mang giá trị số tuần, không tự enforce điều kiện bắt buộc. Actual gestational age in whole weeks (1–42) at the time of the procedure or when recorded on the KCB document; FHIR R4 base has no gestational-age element on Procedure/DocumentReference. Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024).

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. Giai đoạn hiệu lực: bản ghi MỚI dùng vn-province-cs (34 mã, business version 20250701); địa chỉ tồn đọng ghi trước 01/07/2025 dùng vn-province-legacy-cs (63 mã) — binding extensible nên cả hai hợp lệ, hệ thống phân biệt giai đoạn hiệu lực qua Coding.system (hai canonical khác nhau, ADR-0017 Điều 6). Chuyển đổi: ConceptMap vn-cm-province-legacy-to-new. 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, T_BHTT_GDV. Căn cứ: QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT (29/10/2024), 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ản tin (envelope) đồng bộ tự động tập dữ liệu khám sức khỏe định kỳ từ cơ sở KCB lên Cổng/Trục dữ liệu sức khỏe Bộ Y tế (api.emrhub.vn). API: POST /api/platform/data-sync/push. Xác thực: OAuth2 + Bearer Token (lấy từ /api/auth/login). Định dạng JSON (UTF-8). KHÁC với luồng BHYT Gateway (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface liên thông KSK quốc gia. INFORMATIVE / non-normative: đây là mô hình ánh xạ transport envelope (không phải FHIR resource normative). Các National Core IG (KR/JP) chỉ chuẩn hóa profile/search/capability RESTful; envelope được giữ làm mapping aid để implementer ánh xạ payload FHIR ↔ bản tin đồng bộ. Môi trường (PL02 mục 2): Cổng dữ liệu sức khỏe BYT — admin https://csdlksk.vn (sandbox https://sandbox.csdlksk.vn); Trục dữ liệu BYT — admin https://admin.emrhub.vn (sandbox https://admin-sandbox.emrhub.vn), API https://api.emrhub.vn (sandbox https://api-sandbox.emrhub.vn). Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 02 (Hướng dẫn kết nối, liên thông dữ liệu) — THAY Phụ lục 02 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất. API OAuth2 + Bearer, POST /api/platform/data-sync/push (service-type=100, msg_type=101/102, txn_type=sync_checkup), checksum RSASHA256. ĐÃ ĐỐI CHIẾU TOÀN VĂN PL02 ngày 23/07/2026 (file 'Phu luc 2-5.pdf' nhúng trong bản docx user cung cấp).

Logical model cho bản tin (envelope) đồng bộ tập dữ liệu hồ sơ sức khỏe từ Bảo hiểm xã hội Việt Nam (bên phát tin, ví dụ sender_id = G12/VSS) về Cơ sở dữ liệu sức khỏe cá nhân của Bộ Y tế qua Trục dữ liệu Bộ Y tế (api.emrhub.vn). API: POST /api/platform/resource-sync/push. Xác thực: OAuth2 + Bearer Token (lấy từ /api/auth/login, role=department). Định dạng JSON (UTF-8). service-type=100. Payload XML tuân theo mẫu QĐ 3176/QĐ-BYT (GIAMDINHHS). KHÁC với luồng BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ hồ sơ sức khỏe BHXH → CSDL sức khỏe cá nhân. INFORMATIVE / non-normative: mô hình ánh xạ transport envelope resource-sync (không phải FHIR resource normative) — mapping aid cho implementer. Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 03 (Đặc tả API tiếp nhận dữ liệu từ BHXH Việt Nam) — THAY Phụ lục 03 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất. API OAuth2 + Bearer, POST /api/platform/resource-sync/push (service-type=100, txn_type=sync_ehr, msg_type=101/102), checksum RSASHA256. ĐÃ ĐỐI CHIẾU TOÀN VĂN PL03 ngày 23/07/2026: mô hình kết nối trong PL03 là BHXH VN ↔ Trục dữ liệu BYT TRỰC TIẾP (PL03 không nhắc NDOP/Trung tâm Dữ liệu quốc gia hay TT 08/2025/TT-BCA — các tầng đó thuộc phát biểu thân QĐ 1551/QĐ-BYT mục 4.b, đọc song song).

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. Mẫu giấy nguồn: GCN nghỉ việc hưởng BHXH theo mẫu TT 56/2017/TT-BYT (sửa đổi bởi TT 18/2022/TT-BYT).

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

Logical model cho Bảng 13 QĐ 3176/QĐ-BYT: dữ liệu giấy chuyển tuyến/chuyển cơ sở khám bệnh, chữa bệnh BHYT. Bảng này chỉ được trích chuyển khi có chuyển tuyến/chuyển cơ sở KCB (MA_LOAI_RV là 2 hoặc 5). Đã loại 2 trường bị bãi bỏ theo QĐ 3176/QĐ-BYT (TEN_DICH_VU, TEN_THUOC), còn 37 trường.

Logical model cho Bảng 14 QĐ 3176/QĐ-BYT: dữ liệu giấy hẹn khám lại. Bảng này chỉ được trích chuyển khi cơ sở KBCB có hẹn khám lại cho người bệnh. Trường hợp Bảng đã được ký số và giấy hẹn khám lại hiển thị trên ứng dụng định danh điện tử Quốc gia (VNeID) thì có giá trị tương đương giấy hẹn khám lại bản giấy. Đích lâm sàng chính là ServiceRequest (yêu cầu khám lại)/DocumentReference (giấy hẹn); IG hiện chưa có VNCoreAppointment nên Appointment.start chỉ nêu như đích tương lai.

Logical model cho Bảng 15 QĐ 3176/QĐ-BYT: chỉ tiêu thông tin quản lý điều trị bệnh lao (bao gồm lao tiềm ẩn, lao kháng thuốc và đồng nhiễm HIV/lao). Dữ liệu này chứa thông tin y tế đặc biệt nhạy cảm (HIV/lao); mọi mapping triển khai phải đi kèm chính sách Consent, SecurityLabel và Audit. Bảng này được gửi về Cổng tiếp nhận Hệ thống thông tin giám định BHYT của BHXH Việt Nam và Chương trình Chống lao Quốc gia khi có điều trị bệnh nhân lao.

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. Mẫu giấy nguồn: Giấy ra viện theo mẫu TT 56/2017/TT-BYT (sửa đổi bởi TT 18/2022/TT-BYT).

Logical model cho Bảng 8 QĐ 3176/QĐ-BYT: dữ liệu tóm tắt hồ sơ bệnh án. Mẫu giấy nguồn: Tóm tắt hồ sơ bệnh án theo mẫu TT 56/2017/TT-BYT (sửa đổi bởi TT 18/2022/TT-BYT).

Logical model cho Bảng 9 giấy chứng sinh. Lưu ý lineage: Bảng 9 (Chỉ tiêu Giấy chứng sinh) đã được TÁCH khỏi chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT và chuyển sang chuẩn dữ liệu điện tử riêng QĐ 2919/QĐ-BYT (15/9/2025) (bãi bỏ Bảng 9 của QĐ 130/QĐ-BYT + bãi bỏ QĐ 1898/QĐ-BYT). LM giữ cấu trúc Bảng 9 để tương thích dữ liệu; căn cứ hiện hành là QĐ 2919/QĐ-BYT.

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

Logical model cho bản ghi thuốc trong danh mục quốc gia của Hệ thống cơ sở dữ liệu về dược (api.csdlduoc.com.vn/v2, GET /master/drugs). Nguồn: Tài liệu kỹ thuật đặc tả API v1.1 mục 5.3, ban hành theo QĐ 232/QĐ-TTYQG (17/7/2026). Đây là danh mục do TTYQG cấp phát (read-only đối với cơ sở); phần mềm HIS/nhà thuốc đồng bộ tăng dần bằng last_update_from/last_update_to.

Logical model mô tả GÓI DỮ LIỆU trao đổi hồ sơ bệnh án điện tử (HSBAĐT) theo Phụ lục 'Mô tả dữ liệu trao đổi hồ sơ bệnh án điện tử' ban hành kèm Công văn 365/TTYQG-GPQLCL ngày 06/06/2025 của Trung tâm Thông tin y tế Quốc gia (TTYQG) - Bộ Y tế. Văn bản là HƯỚNG DẪN KỸ THUẬT cho phần mềm HSBAĐT thực thi Thông tư 13/2025/TT-BYT; mang tính KHUYẾN KHÍCH/hướng dẫn — Bộ Y tế CHƯA áp đặt chuẩn trao đổi bắt buộc. Định dạng kết xuất là tệp XML hoặc JSON với tên trường tiếng Việt KHÔNG DẤU (giữ nguyên trong short theo dạng 'ma_goc — Diễn giải'). Định hướng tương lai theo QĐ 2146/QĐ-BYT (Khung kiến trúc chuyển đổi số y tế) là HL7 FHIR R4; logical model này là CẦU ÁNH XẠ hiện trạng CV 365 → FHIR, KHÔNG phải profile bắt buộc. Hạ tầng trục trao đổi EMR HUB (api.emrhub.vn) CHƯA có đặc tả API công khai tại thời điểm lập mô hình — do đó LM chỉ mô hình hóa GÓI DỮ LIỆU kết xuất theo CV 365, KHÔNG mô hình hóa API/giao thức của trục. Phạm vi: 11 nhóm dữ liệu I-XI (ThongTinBenhNhan, ThongTinVaoVien, ThongTinDieuTri, YLenhThuocVatTu, PhieuChiDinh, KetQuaChanDoanHinhAnh, KetQuaXetNghiem, GiayChuyenVien, HoSoCapCuu, PhieuThuThuat, PhieuPhauThuat). RÚT GỌN CÓ CHỦ Ý: nhánh khám chuyên khoa sâu (mắt phải/trái, phụ khoa khám ngoài/trong, sản khoa) trong nhóm II và các nhánh chẩn đoán lặp {maicd/tenicd/motabenh} trong nhóm IX/X/XI được gộp về khuôn dùng chung (khamCoQuan, chanDoan) và xử lý chi tiết ở tầng adapter.

Logical model đặc tả 20 trường dữ liệu do người dân TỰ KHAI khi khởi tạo Sổ sức khỏe điện tử trên ứng dụng VNeID, theo Quyết định 2062/QĐ-BYT (07/07/2026) Phụ lục 05 mục 5. Ba nhóm: thông tin chung (13 trường), người giám hộ hoặc người chăm sóc chính (4 trường, chỉ khi có), và thông tin y tế cơ bản (5 trường — tổng 22 mục dữ liệu trên 20 dòng danh mục vì phần cư trú gồm ba cấp).

CẢNH BÁO SỬ DỤNG — nguồn dữ liệu và mức tin cậy: phần hành chính được đối soát với Cơ sở dữ liệu quốc gia về dân cư, còn năm trường y tế (nhóm máu ABO, chiều cao, cân nặng, tiền sử bản thân, tiền sử gia đình) KHÔNG qua bất kỳ xác thực y khoa nào. Riêng nhóm máu tự khai TUYỆT ĐỐI không được dùng làm căn cứ cho quyết định lâm sàng hoặc truyền máu — phải xét nghiệm định nhóm máu tại cơ sở KCB. Mọi resource sinh ra từ nhóm dữ liệu này bắt buộc kèm Provenance đánh dấu nguồn tự khai (Provenance.agent.type = informant hoặc Observation.performer = Patient), và Observation phải mang status = preliminary cho tới khi được xác nhận bởi cơ sở y tế.

Người khai là chủ thể dữ liệu; cơ sở KCB chỉ hỗ trợ cập nhật, không thay thế vai trò khai báo. / Logical model for the 20 self-declared fields used to initialise the VNeID electronic health book per Appendix 05 of Decision 2062/QĐ-BYT. The five clinical fields carry no medical verification; self-declared ABO blood group must never drive clinical or transfusion decisions.

Logical model cho payload phiếu kiểm kho gửi lên Hệ thống cơ sở dữ liệu về dược (POST /transactions/stock-taking, API v1.1 mục 5.4.7): đối chiếu tồn hệ thống (system_quantity) và tồn thực tế (actual_quantity) theo từng lô thuốc. LƯU Ý FHIR: R4 KHÔNG có resource kiểm kê tồn kho (InventoryReport chỉ có từ R5) — logical model này là carrier chuẩn duy nhất trong VN Core; KHÔNG khuyến nghị ép sang Observation hay Basic.

Logical model cho payload phiếu nhập hàng gửi lên Hệ thống cơ sở dữ liệu về dược (POST /transactions/stock-in, API v1.1 mục 5.4.1). Áp dụng cho nhà thuốc/quầy thuốc (kể cả nhà thuốc bệnh viện), chuỗi nhà thuốc, cơ sở bán buôn, xuất/nhập khẩu. Xử lý bất đồng bộ: hệ thống trả transaction_id, phần mềm poll GET /transactions/stock-in/{id}/status (enum mục 6.2: accepted/processing/completed/error/rejected). Ràng buộc onboarding: cơ sở phải khai báo phiếu nhập tồn đầu kỳ (reason=opening-balance) trước khi liên thông giao dịch khác.

Logical model cho payload phiếu xuất hàng gửi lên Hệ thống cơ sở dữ liệu về dược (POST /transactions/stock-out, API v1.1 mục 5.4.4). Bao trùm cả nghiệp vụ BÁN LẺ THUỐC (reason=sale-retail — v1.1 đã bỏ nhóm API hóa đơn /invoices của v1.0, bán lẻ chỉ còn liên thông qua stock-out): với bán lẻ theo đơn, đích FHIR chủ đạo là VNCoreMedicationDispense; với các nghiệp vụ kho khác là SupplyDelivery. reason=recall gắn trực tiếp quy trình thu hồi thuốc theo TT 30/2025/TT-BYT.

Profile QuestionnaireResponse cho bản trả lời cấu trúc Mẫu số 08 NĐ 356/2025/NĐ-CP. CỐ ĐỊNH questionnaire = vn-breach-notification-questionnaire (Điều 28 khoản 1 a-d + 2 mốc thời gian 72 giờ) — QR trả lời questionnaire khác không thỏa profile này; các trường bắt buộc (THOI_DIEM_PHAT_HIEN, THOI_DIEM_THONG_BAO, HANH_VI, LOAI_DLCN, SO_LUONG, HAU_QUA, BIEN_PHAP, CAM_KET…) do chính Questionnaire enforce khi validate với status = completed. Section 2 của VNCoreCompositionBreachNotification bắt buộc tham chiếu profile này (0.8.0, hậu review chéo Codex).

Mô hình logic chuẩn cho Biên bản quyết toán, thanh toán chi phí khám bệnh, chữa bệnh BHYT theo quý (Mẫu số 06/BH), gồm định danh biên bản, đúng một quý, bên chi trả, cơ sở KCB, hợp đồng, bộ 55 chỉ tiêu hiện hành với hai cột trong quý/lũy kế, ý kiến hai bên và người ký xác nhận. LogicalModel là carrier dữ liệu của biểu mẫu; PaymentReconciliation tiếp tục mang semantics remittance/phân bổ khoản thanh toán bulk, còn tài liệu ký có thể render từ instance này và đóng gói bằng Composition/DocumentReference. Căn cứ: [TT 12/2026/TT-BTC] (ban hành 10/02/2026, hiệu lực 10/02/2026) — Giám định, thanh toán, quyết toán chi phí KCB BHYT; [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.

This logical model is the canonical data carrier for the quarterly BHYT healthcare-cost settlement and payment record (Form 06/BH). It contains the settlement identifiers, exactly one calendar quarter, payer, provider, contract, the current 55-indicator set with quarter and year-to-date columns, both parties' opinions, and attestations. PaymentReconciliation retains its FHIR remittance and bulk-payment allocation semantics; a signed document may be rendered from this model and packaged using Composition or DocumentReference.

Logical model đặc tả 46 trường nội dung Sổ sức khỏe điện tử tích hợp trên ứng dụng VNeID theo Quyết định 1332/QĐ-BYT (21/05/2024, ban hành thí điểm) và Hướng dẫn liên thông theo Quyết định 2733/QĐ-BYT (17/09/2024). Quy trình liên thông gồm 7 bước qua Cổng tiếp nhận dữ liệu Hệ thống thông tin giám định BHYT của cơ quan Bảo hiểm xã hội Việt Nam; sau khi CSKCB ký số và liên thông dữ liệu (khi kết thúc đợt KCB), cơ quan BHXH Việt Nam trích xuất và chia sẻ dữ liệu hiển thị lên ứng dụng VNeID trong vòng 24 giờ kể từ khi nhận được dữ liệu. Chuẩn dữ liệu nguồn = chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT (đọc hợp nhất với QĐ 3176/QĐ-BYT theo chính sách repo); Phụ lục 02 QĐ 2733/QĐ-BYT ánh xạ 46 STT trường Sổ SKĐT sang mã trường của các Bảng 1 (chỉ tiêu tổng hợp KCB), Bảng 2 (thuốc), Bảng 3 (dịch vụ kỹ thuật/VTYT), Bảng 4 (cận lâm sàng chi tiết) và Bảng 8 (tóm tắt hồ sơ bệnh án). LƯU Ý PHẠM VI: đây KHÔNG phải một API hay định dạng dữ liệu mới — dữ liệu Sổ SKĐT là một phần của dữ liệu thanh quyết toán chi phí KCB BHYT, đi qua đúng kênh liên thông XML KCB/BHYT hiện có. Cột (6) của Phụ lục 02 đánh dấu 'x' nghĩa là trường bổ sung chưa có trong chuẩn dữ liệu QĐ 130/QĐ-BYT và QĐ 4750/QĐ-BYT. Cờ hiển thị trên VNeID lấy theo Phần B QĐ 1332/QĐ-BYT ('+' là có hiển thị, '-' là không hiển thị).

Logical model cho tập dữ liệu mẫu phiếu khám sức khỏe định kỳ / khám sàng lọc (Phụ lục 01, QĐ 2062/QĐ-BYT). Mô hình hóa các trường DÙNG CHUNG (hành chính, thông tin lần khám, dấu hiệu sinh tồn, dinh dưỡng, thể lực, tiền sử, kết luận) cho 3 mẫu phiếu theo nhóm tuổi (Phụ lục 01 QĐ 2062/QĐ-BYT thay 17 mẫu QĐ 1551/QĐ-BYT):

1. Người dưới 6 tuổi (= VNKSKQuestionnaireU06) | 2. Người từ đủ 6 đến dưới 18 tuổi (= VNKSKQuestionnaire06to18) | 3. Người từ đủ 18 tuổi trở lên (= VNKSKQuestionnaire18Plus). Ngoài ra mẫu khám sức khỏe tâm thần theo TT 25/2026/TT-BYT Mẫu 04 (= VNKSKQuestionnaireMental). Các trường khám theo cơ quan/độ tuổi (dinh dưỡng, phát triển tâm thần vận động, nội khoa, chuyên khoa…) khác nhau theo từng mẫu — mô hình dạng mở rộng; biến thể theo từng mẫu thể hiện qua các Questionnaire tương ứng. Phần lớn trường 'ghi theo QĐ 3176/QĐ-BYT'. ConceptMap/StructureMap export phải bảo toàn tên trường nguồn. Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 01 (Đặc tả dữ liệu các mẫu phiếu KSK — 3 mẫu theo nhóm tuổi <6 / 6–18 / ≥18) — THAY Phụ lục 01 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất. QĐ 3176/QĐ-BYT (đặc tả trường). Xem Questionnaire VNKSKQuestionnaireU06/06to18/18Plus + VNKSKQuestionnaireMental.

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), cập nhật theo QĐ 1849/QĐ-BYT (23/6/2026). Artifact công bố trên IG này là metadata wrapper cho tập dữ liệu ICD-10 VN gồm 15.617 mã.

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.

Canonical vn-district-cs đã được supersede bởi vn-district-legacy-cs từ bản 0.9.0 để đồng nhất mô hình đặt tên -legacy cho danh mục giai đoạn trước 01/07/2025. Artifact retired này vẫn giữ nguyên đầy đủ 696 concept để resolve dữ liệu đã công bố; mọi dữ liệu lịch sử mới trao đổi phải dùng vn-district-legacy-cs. Nguồn danh mục là Tổng cục Thống kê trước sắp xếp, không phải QĐ 19/2025/QĐ-TTg Phụ lục II; NQ 202/2025/QH15 và QĐ 19/2025/QĐ-TTg Phụ lục I chỉ là căn cứ cho crosswalk tỉnh. English: This retired canonical was superseded by vn-district-legacy-cs in release 0.9.0. It retains all 696 concepts solely to resolve previously published data; new exchanges of historical district data must use the replacement legacy canonical.

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/TT-BYT + 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/TT-BYT and TT 21/2017/TT-BYT 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.

Bộ mã đầy đủ 55 chỉ tiêu của Mẫu số 06/BH dùng trong biên bản quyết toán, thanh toán chi phí khám bệnh, chữa bệnh bảo hiểm y tế theo quý. Mỗi mã ghi nhận phần A–E, mã cha, trạng thái tính toán, công thức nội tại và cột áp dụng. Có 23 công thức nội tại. DSL công thức phiên bản vn-settlement-dsl/1.0: grammar formula := code '=' expression ('|when:' condition)?; toán tử được phép là +, -, dấu ngoặc và so sánh trong condition; formulaAppliesTo nhận quarter hoặc both; mỗi concept có công thức khai formulaLanguage = vn-settlement-dsl/1.0. Căn cứ: [TT 12/2026/TT-BTC] (ban hành 10/02/2026, hiệu lực 10/02/2026) — Giám định, thanh toán và quyết toán chi phí KCB BHYT. / Complete CodeSystem for the 55 indicators in Form 06/BH, used for quarterly health-insurance healthcare cost settlement and payment minutes. Each code carries its section A–E, parent code, calculated flag, internal formula, and applicable column. There are 23 internal formulas. Formula DSL version vn-settlement-dsl/1.0 uses grammar formula := code '=' expression ('|when:' condition)?; permitted operators are +, -, parentheses, and comparisons in condition; formulaAppliesTo is quarter or both; every concept with a formula declares formulaLanguage = vn-settlement-dsl/1.0. Legal basis: Circular 12/2026/TT-BTC (issued 10/02/2026, effective 10/02/2026) — health-insurance healthcare cost assessment, payment, and settlement.

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. Theo TT 41/2025/TT-BYT, TT 02/2025/TT-BYT.

Danh mục căn cứ pháp lý cho xử lý dữ liệu cá nhân KHÔNG cần sự đồng ý của chủ thể dữ liệu, ánh xạ Luật 91/2025/QH15 Điều 19 khoản 1 (điểm a tách 2 nhánh: cấp bách + bảo vệ lợi ích chính đáng; b/c/d/đ mỗi điểm 1 mã). Tách khỏi VNConsentCategoryCS (mã #emergency, #legal-obligation cũ — nay deprecated) vì đây là CĂN CỨ XỬ LÝ (processing legal basis), không phải LOẠI ĐỒNG Ý (consent directive): khi viện dẫn các căn cứ này, việc xử lý không dựa trên sự đồng ý — trộn hai trục trong một CodeSystem làm sai mô hình Consent. Đây là ánh xạ thuật ngữ của IG; chọn một mã không tự xác lập rằng điều kiện pháp lý tương ứng đã được đáp ứng. LƯU Ý nghĩa vụ đi kèm: bên kiểm soát dữ liệu cá nhân, bên xử lý dữ liệu cá nhân, bên kiểm soát và xử lý dữ liệu cá nhân, bên thứ ba phải CHỨNG MINH trường hợp thuộc điểm a (Điều 19 khoản 1 điểm a câu 2); mọi trường hợp không cần đồng ý phải có cơ chế GIÁM SÁT (Điều 19 khoản 2). Luật không quy định AuditEvent, Provenance hay một representation FHIR cụ thể; các resource này chỉ là lựa chọn triển khai để liên kết với bằng chứng và hồ sơ giám sát phù hợp.

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. VNLegacyTechnicalLineCS và VNCoreExtLegacyTechnicalLine chỉ bảo toàn phân loại tuyến chuyên môn kỹ thuật lịch sử; không được dùng để ánh xạ hoặc suy diễn cấp hành chính huyện. English: Administrative health-management levels under the current two-tier local-government model. Historical technical-line codes preserve a former technical classification only and SHALL NOT be used as a mapping or proxy for the former district administrative level.

Danh mục bệnh truyền nhiễm thuộc các nhóm bệnh truyền nhiễm (nhóm A đặc biệt nguy hiểm, nhóm B nguy hiểm, nhóm C ít nguy hiểm) theo khoản 4 Điều 15 Luật Phòng bệnh. Căn cứ: QĐ 1965/QĐ-BYT (01/7/2026), ban hành theo Luật 114/2025/QH15 (Luật Phòng bệnh) và TT 15/2026/TT-BYT. Gồm 81 bệnh: 15 bệnh nhóm A, 47 bệnh nhóm B, 19 bệnh nhóm C. Mỗi concept có property group (A/B/C) xác định nhóm bệnh truyền nhiễm. Mã VN-specific dạng {A|B|C}{số thứ tự 2 chữ số} theo thứ tự trong Phụ lục QĐ 1965/QĐ-BYT — dùng cho phân loại bệnh truyền nhiễm phải khai báo/giám sát; chưa ánh xạ ICD-10 (dự kiến ConceptMap ở chu kỳ sau). QĐ 1965/QĐ-BYT thay thế QĐ 1988/QĐ-BYT (2013), QĐ 2369/QĐ-BYT (2015), QĐ 740/QĐ-BYT (2016), QĐ 3896/QĐ-BYT (2023), QĐ 3044/QĐ-BYT (2022), QĐ 3644/QĐ-BYT (2025).

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, nội dung gói dịch vụ y tế cơ bản do Trạm Y tế xã/phường/đặc khu thực hiện. Căn cứ: TT 30/2024/TT-BYT (ban hành 04/11/2024, hiệu lực 19/12/2024) — Phụ lục Danh mục, nội dung gói dịch vụ y tế cơ bản. Cấu trúc 3 cấp: 15 nhóm gói (số La Mã I–XV ↔ group_code a–p) chứa 39 dịch vụ và 20 dịch vụ con. Quan hệ cha-con biểu diễn bằng nested concept (hierarchyMeaning = grouped-by), KHÔNG mã hóa phân cấp vào ký tự mã. LƯU Ý GOVERNANCE: TT 30/2024/TT-BYT mô tả dịch vụ dạng tường thuật, KHÔNG gán mã ngắn cho từng dịch vụ. Mã tt30-gNN / tt30-sNNN / tt30-sN-M ở đây do dự án gán để phục vụ interoperability; GIỮ ^experimental = true tới khi có chính sách code-assignment và cơ quan quản lý cấp quốc gia (xem release-governance). Seed máy đọc: catalog TT30 (groups[].services[].service_id) do OmiCHC cung cấp.

Danh mục kỹ thuật khám bệnh, chữa bệnh Việt Nam theo TT 23/2024/TT-BYT, Phụ lục 1 (19438 kỹ thuật, 28 chương). Artifact công bố trên IG này là metadata wrapper; dữ liệu concept đầy đủ nằm ở release download surface (CodeSystem-vn-dvkt-cs.full.json, xem trang tải xuống). Dùng làm mã kỹ thuật/thủ thuật trong VNCoreProcedure; ánh xạ sang Phụ lục 2 qua ConceptMap/vn-cm-dvkt-pl1-to-pl2. Nguồn: dmkt.kcb.vn.

Bộ mã kỹ thuật Phụ lục 2 của TT 23/2024/TT-BYT (7974 mã), đích ánh xạ cho ConceptMap/vn-cm-dvkt-pl1-to-pl2. Artifact IG này là metadata wrapper; concept đầy đủ ở release download surface (CodeSystem-vn-dvkt-pl2-cs.full.json, xem trang tải xuống). Nguồn: dmkt.kcb.vn.

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à nhóm vaccine dịch vụ/chiến dịch phổ biến — nhóm này do VN Core tự đặt mã (property codeSource = project-assigned) vì chưa có danh mục mã quốc gia, không suy diễn là mã do Bộ Y tế ban hành. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026) — 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; TT 13/2026/TT-BYT (ban hành 16/05/2026, hiệu lực 01/07/2026) — hoạt động tiêm chủng, danh mục 14 bệnh tiêm chủng bắt buộc. 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ã bệnh Y học cổ truyền theo Phụ lục 07.1 QĐ 7603/QĐ-BYT — 4142 mã thuộc 18 chương, là trường MA_BENH của bộ mã dùng chung phục vụ quản lý khám bệnh, chữa bệnh và thanh toán bảo hiểm y tế.

PHÂN BIỆT với vn-yhct-disease-cs: bộ đó là 228 bệnh danh và thể lâm sàng theo QĐ 2552/QĐ-BYT Phụ lục I, dùng để ghi nhận lâm sàng y học cổ truyền. Hai danh mục có mục đích khác nhau và không thay thế nhau; hệ thống gửi dữ liệu bảo hiểm y tế dùng danh mục này.

HIỆU LỰC: văn bản gốc từ 2018 nhưng danh mục vẫn hiện hành — QĐ 1978/QĐ-BYT (01/7/2026) chỉ SỬA ĐỔI, BỔ SUNG Phụ lục 07.1 và ghi rõ các nội dung khác giữ nguyên. Bản này đã áp 28 mã sửa theo QĐ 1978/QĐ-BYT, cùng phần sửa đổi và hủy bỏ trong chính phụ lục nguồn (07.3 sửa mã U67.221, 07.4 hủy mã U67.222).

Ánh xạ sang ICD-10 công bố riêng ở ConceptMap vn-cm-yhct-disease-catalog-to-icd10.

Danh mục mã khoa trong cơ sở khám bệnh, chữa bệnh (trường MA_KHOA). Căn cứ hiện hành: QĐ 1804/QĐ-BYT (19/6/2026) Phụ lục 02 — Danh mục mã khoa (61 mã khoa K01–K60, K99), áp dụng chậm nhất từ 01/8/2026. QĐ 1804/QĐ-BYT bãi bỏ Phụ lục 6 (danh mục mã khoa) QĐ 2010/QĐ-BYT (19/6/2025) từ 01/8/2026. Tiền nhiệm: QĐ 2010/QĐ-BYT (19/6/2025) Phụ lục 6 → QĐ 5937/QĐ-BYT (2021) Phụ lục 5. Tham chiếu thêm: QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT (trường MA_KHOA). Quy tắc mã hóa (QĐ 1804/QĐ-BYT): liên chuyên khoa ghi Kxxyyzz (xx/yy/zz là số thứ tự khoa); chuyên khoa sâu ghi KXY.Z (Z từ 1 đến n); đơn nguyên ghi mã khoa + '.D' + 02 ký tự phần số mã khoa gốc (ví dụ Đơn nguyên Thận nhân tạo thuộc Khoa Hồi sức cấp cứu = K02.D35). Nguồn dữ liệu: QĐ 1804/QĐ-BYT Phụ lục 02 + OHP Data Processor (production mapping).

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 under 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 đầy đủ 696 đơn vị hành chính cấp huyện của GIAI ĐOẠN TRƯỚC 01/07/2025, khi Việt Nam còn tổ chức cấp quận/huyện. Dataset nguồn: Danh mục đơn vị hành chính cấp huyện — Tổng cục Thống kê, ấn bản trước 01/07/2025 (three-tier model); KHÔNG phải QĐ 19/2025/QĐ-TTg Phụ lục II. Ghi chú edition/URL best-effort: cổng TCTK được liên kết tại https://tdtnn2025.gso.gov.vn/Blog/Detail/don-vi-hanh-chinh-viet-nam (đăng 26/12/2024); repo chưa lưu raw export/checksum nên chưa xác minh được edition chính xác của snapshot 696 mã. NQ 202/2025/QH15 xác lập mô hình chính quyền địa phương hai cấp và bỏ cấp huyện từ 01/07/2025; property province là crosswalk sang mã tỉnh hiện hành theo NQ 202/2025/QH15 và QĐ 19/2025/QĐ-TTg Phụ lục I. CodeSystem giữ trạng thái retired theo tiền lệ Province/KSK legacy, còn mọi concept tiếp tục mang status=deprecated. Chỉ dùng canonical này để resolve, validate hoặc chuyển đổi dữ liệu lịch sử; không tạo Coding mới và không dùng để mã hóa đơn vị hành chính hiện hành. English: Complete catalogue of 696 former district-level administrative units for the period before 01 July 2025, sourced from the pre-reorganisation General Statistics Office administrative catalogue. It is not sourced from Appendix II of Decision 19/2025/QD-TTg. The province property is a crosswalk to current province codes; this retired canonical is retained only to resolve, validate, and migrate legacy data.

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 63 tỉnh/thành phố GIAI ĐOẠN HIỆU LỰC CŨ — trạng thái đến hết 30/06/2025, trước sắp xếp đơn vị hành chính theo NQ 202/2025/QH15. Artifact IMMUTABLE (ADR-0017 Điều 6, phương án B): tách khỏi vn-province-cs để chấm dứt identity-collision (vd mã 79 = TP.HCM địa giới cũ ≠ TP.HCM sau hợp nhất với Bình Dương + Bà Rịa - Vũng Tàu). Dữ liệu địa chỉ ghi trước 01/07/2025 dùng CodeSystem này; dữ liệu MỚI bắt buộc dùng vn-province-cs (34 mã). Quan hệ hợp nhất build từ nguyên văn NQ 202/2025/QH15 Điều 1 — xem ConceptMap vn-cm-province-legacy-to-new. Bản 0.8.0 sửa 4 lỗi tên mã cũ của bản ≤0.7.0 (cụm Mekong bị lệch: 45=Quảng Trị, 84=Trà Vinh, 87=Đồng Tháp, 89=An Giang theo danh mục TCTK cũ). Trạng thái #retired: cấm dùng cho bản ghi mới; dữ liệu tồn đọng vẫn giải nghĩa/validate được (binding vn-ext-province là extensible).

Danh mục 34 tỉnh/thành phố Việt Nam GIAI ĐOẠN HIỆU LỰC HIỆN HÀNH theo NQ 202/2025/QH15 và QĐ 19/2025/QĐ-TTg Phụ lục I. Mã số 2 chữ số, hiệu lực từ 01/7/2025. Business version = 20250701 (ADR-0017 Điều 4). Một số mã được TÁI SỬ DỤNG với địa giới khác giữa hai giai đoạn hiệu lực (vd 79 = TP.HCM cũ ≠ TP.HCM sau hợp nhất Bình Dương + Bà Rịa - Vũng Tàu); canonical current/legacy là ranh giới identity duy nhất, còn Coding.version là tùy chọn và phải khớp business version nếu có. Giai đoạn hiệu lực cũ (63 mã, đến hết 30/06/2025) TÁCH sang vn-province-legacy-cs (0.8.0 — hậu kiểm toán Codex, chấm dứt identity-collision khi hai nghĩa dùng chung một canonical); ánh xạ đầy đủ 63→34: ConceptMap vn-cm-province-legacy-to-new (build từ nguyên văn NQ 202/2025/QH15 Điều 1). 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 — ban hành 30/06/2025 — mã ĐVHC cấp tỉnh (Phụ lục I).

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.

Danh mục mã giới tính theo QĐ 3176/QĐ-BYT (29/10/2024) — trường GIOI_TINH (STT 7, Bảng 1) và trường GIOI_TINH_CON (STT 18, Bảng 9, cùng danh mục). Dùng làm bộ mã nguồn cho dữ liệu BHYT/HIS trong nước; ánh xạ sang administrative-gender của FHIR qua ConceptMap vn-cm-gender-to-administrative-gender.

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 theo QĐ 3176/QĐ-BYT). Bổ sung cho danh mục loại KCB legacy — loại KCB 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.

Các hạng mục pháp lý/vận hành được KẾ THỪA (chuyển tiếp) khi một cơ sở y tế sáp nhập/chia tách/đổi mã sang cơ sở khác. Dùng để ghi nhận hợp đồng BHYT, đăng ký KCB ban đầu, giấy phép… có được chuyển tiếp hay không trong quá trình thay đổi vòng đời mã cơ sở. Căn cứ: NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế) và NĐ 188/2025/NĐ-CP (hướng dẫn Luật BHYT — hợp đồng KCB BHYT, đăng ký KCB ban đầu); giấy phép hoạt động KCB theo Luật KCB 2023 (Luật 15/2023/QH15) và NĐ 96/2023/NĐ-CP.

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 trường KET_QUA_DTRI — QĐ 3176/QĐ-BYT Bảng 1 STT 41, gồm 8 mã.

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.

CodeSystem supplement bổ sung bản dịch tiếng Việt (designation.language = vi) cho bảng mã xét nghiệm quốc tế LOINC (Logical Observation Identifiers Names and Codes). Đây KHÔNG phải một hệ mã độc lập — khi coding trong FHIR luôn dùng system = http://loinc.org; supplement này chỉ gắn thêm tên tiếng Việt cho các mã LOINC.

Phạm vi: 104.054 mã LOINC (khớp phiên bản LOINC 2.78; không phải LOINC hiện hành — LOINC 2.82 có 109.325 mã), trong đó 89.470 mã (86%) có bản dịch tên thành phần (component) tiếng Việt và được đưa vào supplement này dưới dạng designation[vi]. Nguồn bản dịch chính thức của Bộ Y tế, host trên website đối tác loinc.whiteneuron.com (đã lọc bỏ mã CLS VN nội bộ và field biểu mẫu EMR khỏi 108.527 bản ghi thô).

Căn cứ pháp lý (khung sử dụng LOINC tại VN):

• QĐ 1227/QĐ-BYT (11/04/2025) — Bộ mã chỉ số cận lâm sàng quốc gia, ánh xạ CLS VN ↔ LOINC (xem vn-cls-cs + ConceptMap/vn-cm-cls-to-loinc).
• QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu BHXH, trường MA_XN (mã xét nghiệm).

Cách dùng trong VN Core: Coding xét nghiệm dùng system = http://loinc.org, code = số LOINC. Terminology server nạp supplement này để hiển thị/tra cứu tên tiếng Việt của mã LOINC. Với chỉ số cận lâm sàng trong nước theo QĐ 1227/QĐ-BYT, dùng vn-cls-cs và ánh xạ sang LOINC qua ConceptMap/vn-cm-cls-to-loinc.

Cách lấy artifact: bản FHIR JSON đầy đủ CodeSystem-vn-loinc-cs.full.json (content = supplement, 89.470 designation tiếng Việt trên không gian 104.054 mã LOINC 2.78) trên release download surface — xem trang tải xuống. Public IG page này chỉ là metadata declaration của supplement; nội dung designation được tiêu thụ qua package/download surface.

English summary: A CodeSystem supplement adding 89,470 Vietnamese designations across the 104,054-code LOINC 2.78 namespace (supplements = http://loinc.org). Never used as Coding.system — code with http://loinc.org. Official MOH Vietnamese translation hosted on partner site loinc.whiteneuron.com.

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) — 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 kỹ thuật KCB (TT 23/2024/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 medical technical service catalog (TT 23/2024/TT-BYT). 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-BYT + TT 53/2025/TT-BYT về Trạm Y tế xã/phường). Các mã TYT và TTYT giữ ngữ nghĩa legacy của mô hình trước 01/07/2025 và được đánh dấu deprecated; dữ liệu hiện hành về trạm y tế cấp xã dùng health-station-commune. English: Vietnam healthcare organization types. TYT and TTYT retain pre-01 July 2025 legacy semantics and are deprecated; current commune-level health-station data uses health-station-commune.

Danh mục legacy theo trường MA_LYDO_VVIEN — QĐ 4210/QĐ-BYT (2017), gồm bốn mã nguồn 1–4 (codeSource = statutory); mã 5 do dự án tự đặt (codeSource = project-assigned) và đã deprecated — không dùng cho dữ liệu mới. Chuẩn hiện hành QĐ 3176/QĐ-BYT dùng MA_DOI_TUONG_KCB với danh mục 27 mã theo QĐ 3276/QĐ-BYT (xem VNPatientVisitTypeCS).

Danh mục mã loại hình khám bệnh, chữa bệnh (trường MA_LOAI_KCB). Căn cứ hiện hành: QĐ 1804/QĐ-BYT (19/6/2026) Phụ lục 01 — Danh mục mã loại hình khám bệnh, chữa bệnh (16 mã), áp dụng chậm nhất từ 01/8/2026. QĐ 1804/QĐ-BYT bãi bỏ Phụ lục 1 (mã loại hình KCB) QĐ 824/QĐ-BYT (15/02/2023) từ 01/8/2026. Tiền nhiệm: QĐ 130/QĐ-BYT (18/01/2023) → QĐ 4750/QĐ-BYT (29/12/2023) → QĐ 3176/QĐ-BYT (29/10/2024) định nghĩa trường MA_LOAI_KCB (STT 7, Bảng 1) trong chuẩn dữ liệu đầu ra — 10 mã, nay mở rộng thành 16 mã theo QĐ 1804/QĐ-BYT. Tham chiếu bổ sung:

• TT 25/2025/TT-BYT — 30/6/2025 — Phụ lục I danh mục bệnh cần chữa trị dài ngày, căn cứ cho mã 02/05/08.
• TT 30/2023/TT-BYT — 30/12/2023 — khám bệnh, chữa bệnh từ xa; nay có mã MA_LOAI_KCB riêng (mã 14) theo QĐ 1804/QĐ-BYT.
• 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: QĐ 1804/QĐ-BYT Phụ lục 01 + OHP Data Processor (production mapping).

Danh mục loại mẫu phiếu khám sức khỏe dùng cho Composition.type và tìm kiếm Composition?type=. Mã #18–#20 là ba mẫu theo nhóm tuổi hiện hành của QĐ 2062/QĐ-BYT; mã #21 là mẫu khám sức khỏe tâm thần theo TT 25/2026/TT-BYT. Mã #01–#17 của QĐ 1551/QĐ-BYT được giữ ở trạng thái deprecated để đọc và chuyển đổi dữ liệu lịch sử.

Loại quan hệ vòng đời giữa hai mã/định danh cơ sở y tế khi cơ sở được sáp nhập, chia tách, đổi tên hoặc thay mã (vd do sắp xếp đơn vị hành chính). Mỗi mã mô tả quan hệ TỪ Organization hiện tại ĐẾN tổ chức đích (target). Căn cứ: NQ 202/2025/QH15 (sắp xếp ĐVHC cấp tỉnh → cơ sở y tế sáp nhập/chia tách) và NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế — quản lý vòng đời dữ liệu cơ sở y tế). Generic cho mọi cơ sở y tế VN, không giới hạn tuyến.

Phân loại THẨM QUYỀN PHÁP LÝ để đại diện/truy cập dữ liệu y tế thay người khác (trục thẩm quyền, KHÁC trục quan hệ gia đình mother/father). Quan trọng: cha/mẹ là NGƯỜI ĐẠI DIỆN THEO PHÁP LUẬT (không phải 'người giám hộ' theo nghĩa hẹp Bộ luật Dân sự). Căn cứ: Bộ luật Dân sự 2015 (đại diện theo pháp luật Đ.136, giám hộ Đ.46–63, uỷ quyền Đ.138); Luật Trẻ em 2016; Luật KCB 2023; Luật 91/2025/QH15 (dữ liệu trẻ em).

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.

Mã loại điều trị lao theo trường LOAI_DTRI_LAO (Bảng 15 QĐ 3176/QĐ-BYT — quản lý điều trị bệnh lao). Vietnamese tuberculosis treatment type codes (LOAI_DTRI_LAO field, Table 15 of QĐ 3176/QĐ-BYT). Căn cứ: QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT (29/10/2024).

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. LƯU Ý 0.8.0 (hậu kiểm toán Codex): property historical-benefit-level trên TOÀN BỘ concepts là mức hưởng LỊCH SỬ theo khung NĐ 146/2018/NĐ-CP — chỉ để tra cứu, CẤM dùng làm đầu vào adjudication; mức hưởng thực tế do BHXH quyết định theo thời điểm/tuyến/nhóm ưu tiên và pháp luật hiện hành. 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/NĐ-CP trong từng mã được giữ để truy xuất nguồn danh mục lịch sử.

Phân loại chỉ thị đồng ý (consent directive) xử lý dữ liệu cá nhân trong y tế Việt Nam. Căn cứ: Luật 91/2025/QH15 Điều 9 (sự đồng ý), Điều 24 (đại diện theo pháp luật), Điều 26 (thông tin sức khỏe). LƯU Ý mô hình từ 0.8.0: các trường hợp xử lý KHÔNG cần đồng ý (Luật 91/2025/QH15 Điều 19) không phải loại đồng ý — mã #emergency và #legal-obligation deprecated, thay bằng CodeSystem vn-processing-legal-basis-cs qua extension vn-ext-processing-legal-basis. Hai mã giữ lại để dữ liệu đã ghi vẫn giải nghĩa được (concept permanence — ADR-0017 Điều 9).

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ã lý do chuyển tuyến/chuyển cơ sở khám bệnh, chữa bệnh BHYT (trường MA_LYDO_CT, Bảng 13 theo QĐ 3176/QĐ-BYT). Phân biệt với HTCHUYEN (VNReferralModeCS) — HTCHUYEN ghi nhận hình thức/nguồn gốc chuyển; MA_LYDO_CT ghi nhận LÝ DO pháp lý của việc chuyển (đủ điều kiện chuyên môn hay theo yêu cầu người bệnh). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024), Bảng 13 STT 32.

Phân lớp mức nhạy cảm của dữ liệu y tế phục vụ chính sách truy cập THEO LỚP DỮ LIỆU (không chỉ theo tuổi) — đặc biệt khi đại diện/giám hộ truy cập thay trẻ vị thành niên. Căn cứ: Luật 91/2025/QH15 (DLCN cơ bản vs nhạy cảm; quy định riêng dữ liệu trẻ em); Luật Trẻ em 2016 (bí mật đời sống riêng tư — từ đủ 7 tuổi cần ý kiến trẻ).

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 MÃ BIỂU MẪU GIẤY TỜ (document form code) do BYT/BHXH ban hành, dùng để xác định loại giấy tờ/biểu mẫu trong hồ sơ KCB điện tử gửi BHXH — trường MAU_SO (Bảng 11, QĐ 3176/QĐ-BYT). Mã ánh xạ về DocumentReference.type / Composition.type. LƯU Ý: đây KHÔNG phải "mẫu số thẻ BHYT" — mã này không liên quan đến cấu trúc/mẫu thẻ BHYT; nó chỉ định danh loại biểu mẫu giấy tờ (vd giấy chứng nhận nghỉ việc hưởng BHXH). Họ mã theo quy ước CTxx có thể mở rộng khi BYT/BHXH ban hành thêm biểu mẫu mới.

Mã định danh chỉ tiêu (what is observed) cho các Observation phái sinh từ mẫu phiếu KSK chưa có mã LOINC/SNOMED phù hợp về ngữ nghĩa. Dùng cho Observation.code (US Core/IPS yêu cầu code 1..1). ConceptMap sang LOINC/SNOMED chỉ khi match được 1:1 sạch. Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) — Phụ lục 01.

279 mã hoạt chất chế phẩm thuốc cổ truyền theo Phụ lục 06 QĐ 7603/QĐ-BYT — giá trị của trường MA_THUOC trong dữ liệu khám bệnh, chữa bệnh bảo hiểm y tế khi thuốc là chế phẩm y học cổ truyền (QĐ 3176/QĐ-BYT quy định ghi mã hoạt chất theo bộ mã danh mục dùng chung).

HIỆU LỰC: Phụ lục 06 còn hiệu lực. TT 12/2026/TT-BTC Điều 7 khoản 1 điểm a vẫn quy định mã hóa danh mục liên thông dữ liệu bảo hiểm y tế theo QĐ 7603/QĐ-BYT được sửa đổi, bổ sung bởi QĐ 4905/QĐ-BYT, QĐ 5937/QĐ-BYT, QĐ 824/QĐ-BYT, QĐ 2010/QĐ-BYT và QĐ 3276/QĐ-BYT; QĐ 2010/QĐ-BYT Điều 2 khoản 1 bãi bỏ đích danh Phụ lục 01–04 của QĐ 7603/QĐ-BYT và không có Phụ lục 06.

PHẠM VI: chỉ công bố MÃ HOẠT CHẤT. Phụ lục nguồn còn liệt kê 933 số đăng ký thuốc thương mại năm 2018 — 99,4% trong đó đã quá thời hạn hiệu lực 5 năm của giấy đăng ký lưu hành, nên không đưa vào danh mục.

DISPLAY: cột thành phần của phụ lục do từng cơ sở đăng ký tự ghi nên 141/279 mã có nhiều cách viết. Display chọn cách viết không kèm hàm lượng và phổ biến nhất; các cách viết còn lại giữ ở designation. Tên hoạt chất chuẩn nằm ở danh mục gốc TT 05/2015/TT-BYT kèm CV 908/BYT-BH — lưu ý các Điều 4, 5 và 6 của TT 05/2015/TT-BYT đã hết hiệu lực từ 01/9/2025 theo Điều 20 khoản 3 TT 27/2025/TT-BYT, trong khi Thông tư ban hành danh mục thay thế mà Điều 20 khoản 2 chờ vẫn chưa được ban hành.

29 mã đã được QĐ 5937/QĐ-BYT ánh xạ tạm thời sang mã thuốc hóa dược — xem ConceptMap vn-cm-yhct-medicine-to-chemical-drug.

Bộ mã CỤC BỘ của VN Core dùng cho extension vn-ext-legal-basis khi một artifact CỐ Ý không viện dẫn văn bản pháp luật. Các mã này KHÔNG phải văn bản pháp luật, KHÔNG thuộc sổ đăng ký VNLegalDocumentRefCS và KHÔNG được đếm vào corpus văn bản pháp lý; corpus giữ nguyên 206 concepts. Bộ mã phân biệt trường hợp không cần căn cứ với trường hợp chưa gắn căn cứ hoặc ngoại lệ.

Danh mục nhóm chi phí hồ sơ thanh toán BHYT — trường MA_NHOM trong XML2/XML3 chuẩn dữ liệu đầu ra KCB (hiện định nghĩa tại QĐ 3176/QĐ-BYT). Đây là mã nguồn export, không đồng nhất trực tiếp với vn-cost-category-cs (nhóm chi phí bảng kê theo QĐ 697/QĐ-BYT) — xem ConceptMap vn-cm-bhyt-claim-cost-group-to-cost-category. ĐỔI TÊN 0.8.0 (ADR-0017 Điều 1/Điều 15): thay canonical vn-qd3176-cost-group-cs — tên artifact không mang số văn bản vì văn bản định nghĩa MA_NHOM thay đổi theo thời gian (QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT) trong khi trục nghiệp vụ không đổi. Canonical cũ giữ ở #retired đủ mã (ConceptMap identity: vn-cm-bhyt-claim-cost-group-rename; registry: governance/terminology-supersession.json).

ĐÃ THAY THẾ (0.8.0, ADR-0017 Điều 15 — tên mang số văn bản vi phạm chính sách đặt tên): dùng vn-bhyt-claim-cost-group-cs. Canonical này giữ nguyên ĐỦ 15 mã (không stub rỗng — ADR-0017 Điều 11) để dữ liệu đã ghi ở ≤0.7.0 tiếp tục giải nghĩa được; ánh xạ identity: ConceptMap vn-cm-bhyt-claim-cost-group-rename. Nội dung gốc: danh mục MA_NHOM dùng trong XML2/XML3 chuẩn dữ liệu đầu ra KCB theo QĐ 3176/QĐ-BYT.

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).

296 mã thuốc hóa dược tạm thời (HD.*) do Phụ lục 2 QĐ 5937/QĐ-BYT cấp — cột Mã ánh xạ mới tạm thời (Thuốc hóa dược) của danh mục mã thành phần chế phẩm thuốc đông y, thuốc từ dược liệu theo TT 05/2015/TT-BYT chuyển đổi, ánh xạ tạm thời sang mã thuốc hóa dược. Mỗi mã HD.x giữ nguyên phần số của mã thành phần 05C.x tương ứng, chỉ đổi tiền tố.

METADATA-ONLY: IG không công bố nội dung danh mục này (content = not-present) — CodeSystem chỉ làm đích cho ConceptMap vn-cm-yhct-medicine-to-chemical-drug; tra mã trực tiếp tại Phụ lục 2 QĐ 5937/QĐ-BYT. Trong IG hiện chỉ 29/296 cặp ánh xạ xuất hiện — phần giao với mã hoạt chất của Phụ lục 06 QĐ 7603/QĐ-BYT.

HIỆU LỰC: QĐ 5937/QĐ-BYT còn hiệu lực trong chuỗi mã hóa liên thông dữ liệu bảo hiểm y tế — TT 12/2026/TT-BTC Điều 7 khoản 1 điểm a vẫn liệt kê trong chuỗi sửa đổi, bổ sung QĐ 7603/QĐ-BYT. Chính văn bản gọi đây là mã ánh xạ TẠM THỜI, dùng chờ danh mục thay thế.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường (không nhợt), Không bình thường (Nhợt).

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Bất thường bên phải, Bất thường bên trái.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Giới hạn.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Hai mắt xa nhau.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Hạn chế.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Không bình thường.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Không bình thường.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Lưỡi to bè.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Mù màu toàn bộ, Mù màu đỏ, Mù màu xanh lá cây, Mù màu vàng.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Mũi to/dày, Bất sản xương mũi.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Nhanh.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Rộng, Hẹp, Thóp phồng.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Rụng tóc.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Suy dinh dưỡng, Thừa cân béo phì.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Sưng/đỏ, Chảy ghèn/mủ.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Sốt, Hạ thân nhiệt.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Sứt môi/chẻ vòm.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Tai đóng thấp.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Thở nhanh, Thở chậm.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Trật khớp háng.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Tăng, Giảm.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Đầu to, Đầu nhỏ.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bú mẹ hoàn toàn, Bú mẹ + sữa công thức, Sữa công thức hoàn toàn.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bắt rõ, Mạch nhẹ, Không bắt được.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Cha, Mẹ, Ông/Bà, Anh/Chị, Họ hàng, Khác.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Chưa, Có.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Có (bình thường), Không (bất thường).

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Có, Không.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Có, Không, Không nhớ rõ.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Da kề da và nằm với mẹ đến khi ra viện, Điều trị tại Khoa sơ sinh.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Gù, Ưỡn.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Hình chữ S, Hình chữ C.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Hạn chế, Bình thường.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Hồng hào, Nhợt, Tím, Vàng, Sạm da.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không bất thường, Có bất thường.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không bệnh, Hen, Động kinh, Dị ứng, Tim bẩm sinh.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không nhợt (bình thường), Nhợt.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không thử, Bình thường, Mù mầu, Hạn chế.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không tiêm loại khác, Có tiêm loại khác.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không được tiêm, Được tiêm, Không nhớ rõ.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không đều, Đều.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không đủ sức khỏe học tập/làm việc, Đủ sức khỏe học tập/làm việc.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không đủ, Đủ.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không, Bình thường.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không, Có cơn ngưng thở >5 giây.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không, Xuất huyết, Bóng nước, Khác.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Máu gót chân, Thính lực, Tim bẩm sinh, Không có thông tin.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Sinh thường, Sinh mổ.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Toàn vẹn/cân đối, Hở cột sống, Vẹo cột sống.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Trong nước, Quốc tế.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Tốt, Trung bình, Kém.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Đẻ thiếu tháng, Đẻ thừa cân, Đẻ có can thiệp, Đẻ ngạt, Mẹ bị bệnh trong thời kỳ mang thai.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Đẻ thiếu tháng, Đẻ thừa tháng, Đẻ có can thiệp, Đẻ ngạt.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Đều/rõ/không âm thổi, Không đều, Tiếng tim bất thường, Âm thổi, Rung miêu.

Bộ mã trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Đủ 2 bên, Bất thường.

349 mã vị thuốc y học cổ truyền theo Phụ lục 06.3 QĐ 7603/QĐ-BYT.

DÙNG CHO DỮ LIỆU CŨ. Danh mục NÊN DÙNG cho bản ghi mới là vn-yhct-herb-cs — bộ mã dùng chung thuật ngữ y học cổ truyền theo Phụ lục V QĐ 3080/QĐ-BYT (26/9/2025), rộng hơn (442 mã) và là bản hiện hành cho ghi nhận lâm sàng cũng như liên thông dữ liệu.

Danh mục này vẫn được công bố vì QĐ 3080/QĐ-BYT KHÔNG có điều khoản bãi bỏ Phụ lục 06.3, và hệ thống còn dữ liệu lịch sử dùng mã 05V cần đọc và chuyển đổi được.

336/349 mã được QĐ 3080/QĐ-BYT kế thừa — xem ConceptMap vn-cm-yhct-herb-legacy-to-common. 13 mã còn lại chưa có mã tương ứng trong bộ mã mới (phần lớn là biến thể của một vị đã có, ví dụ Nhân trần tía so với Nhân trần); các mã này mang property no-successor để việc chuyển đổi dữ liệu không bỏ sót chúng trong im lặng.

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.

Thang phân loại mức độ ưu tiên người bệnh tại khoa Cấp cứu (5 cấp độ) — thang đề xuất nội bộ VN Core (proposed/local), tham chiếu thực hành phân loại cấp cứu 5 mức quốc tế (mốc tiếp cận tối đa theo kiểu Australasian Triage Scale: ngay/10/30/60/120 phút). Căn cứ nguyên tắc: QĐ 01/2008/QĐ-BYT (Quy chế Cấp cứu, HSTC & Chống độc) yêu cầu xử trí người bệnh cấp cứu theo mức độ ưu tiên — văn bản KHÔNG quy định cụ thể số mức hay các mốc thời gian; số mức và mốc giờ ở đây theo thông lệ quốc tế. Dùng cho VNCoreObservationTriageAcuity.value. / Proposed VN Core five-level emergency triage acuity scale, aligned with international 5-level triage practice (ATS-style time targets). QĐ 01/2008/QĐ-BYT provides the underlying mandate to handle emergencies by priority; it does not itself define the five levels or time thresholds.

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) — 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 nguồn kinh phí cho đợt khám sức khỏe định kỳ / khám sàng lọc (trường NGUON_CHI_TRA). Lưu ý: KHÁC với VNPaymentSourceCS (NGUON_CTRA — nguồn chi trả thuốc/chi phí KCB theo QĐ 3176/QĐ-BYT) và VNImmunizationFundingSourceCS. CodeSystem này dành riêng cho nguồn kinh phí tổ chức đợt khám sức khỏe. Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) — Phụ lục 01 đặc tả dữ liệu mẫu phiếu khám sức khỏe.

Nguồn xác minh quan hệ/thẩm quyền đại diện — quyết định mức độ tin cậy của PDP khi cho phép truy cập thay (deny-by-default nếu mâu thuẫn/hết hạn). Ưu tiên nguồn AUTHORITATIVE (CSDLQG dân cư) thay vì tự khai báo. Căn cứ: Luật Căn cước 2023 (quan hệ nhân thân trong CSDLQGDC); Bộ luật Dân sự 2015.

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

Năm nhóm tiêu chuẩn chất lượng cơ bản đối với bệnh viện theo Phụ lục TT 35/2024/TT-BYT (ban hành 16/11/2024, hiệu lực 01/01/2025): cơ sở vật chất, quy mô và cơ cấu tổ chức, nhân sự, thiết bị y tế, chuyên môn. Phạm vi áp dụng theo Điều 1 khoản 2: chỉ áp dụng với cơ sở khám bệnh, chữa bệnh được cấp giấy phép hoạt động theo hình thức tổ chức là BỆNH VIỆN — không áp dụng cho phòng khám, trạm y tế. Mã I–V là ký hiệu Mục trong Phụ lục gốc (codeSource = statutory); mã KL là nhóm cấu trúc của IG mang kết luận xếp loại nhị phân theo Điều 1 khoản 3 điểm c (codeSource = project-assigned, KHÔNG thuộc 5 nhóm tiêu chuẩn của Phụ lục). / The five basic hospital quality standard groups per the Appendix of Circular 35/2024/TT-BYT, applicable only to facilities licensed as hospitals.

Mã phác đồ điều trị lao theo trường PHACDO_DTRI_LAO (Bảng 15 QĐ 3176/QĐ-BYT, cột sửa đổi toàn bộ — danh mục mở rộng 1–27): nhóm lao nhạy cảm thuốc (1–8), lao kháng thuốc (9–19), lao tiềm ẩn (20–27). Vietnamese tuberculosis treatment regimen codes (PHACDO_DTRI_LAO field, Table 15 of QĐ 3176/QĐ-BYT). Căn cứ: QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT (29/10/2024).

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ã VN Core phân biệt sự kiện QUYẾT ĐỊNH cho phép/từ chối xử lý theo căn cứ pháp lý với sự kiện TRUY CẬP hoặc TIẾT LỘ dữ liệu thực tế. Bộ mã hỗ trợ hồ sơ giám sát theo Luật 91/2025/QH15 Điều 19. NĐ 356/2025/NĐ-CP Điều 19 bổ sung lớp trách nhiệm giải trình, đánh giá tác động và biện pháp bảo vệ. Đây là lựa chọn mô hình hóa FHIR của VN Core; các văn bản không quy định CodeSystem hoặc AuditEvent cụ thể. / VN Core codes distinguishing a legal-basis authorization decision from the subsequent actual data access or disclosure event. The codes support Article 19 oversight and the accountability, impact-assessment, and safeguard layer under Decree 356/2025/NĐ-CP. This is a VN Core FHIR modeling choice; the cited instruments do not prescribe this CodeSystem or a specific AuditEvent representation.

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Đ-CP;
• NĐ 04/2025/NĐ-CP (01/01/2025) sửa đổi, bổ sung NĐ 98/2021/NĐ-CP và NĐ 07/2023/NĐ-CP;
• TT 05/2022/TT-BYT (01/03/2022) hướng dẫn quy tắc phân loại chi tiết;
• TT 24/2026/TT-BYT (hiệu lực 01/07/2026) — xác định mức độ rủi ro, biện pháp quản lý thiết bị y tế; sửa đổi, bổ sung TT 05/2022/TT-BYT (TT 59/2025/TT-BYT hết hiệu lực từ 01/07/2026 theo Điều 4 khoản 2). 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/TT-BYT) và không phải danh pháp thiết bị (QĐ 3107/QĐ-BYT, QĐ 847/QĐ-BYT). 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/NĐ-CP.

Phân loại sức khỏe theo 5 mức (Loại I–V) dùng trong kết luận khám sức khỏe định kỳ (trường PHAN_LOAI_SK). Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) — Phụ lục 01 đặc tả dữ liệu mẫu phiếu khám sức khỏe (gốc phân loại sức khỏe theo TT 14/2013/TT-BYT).

40 mã phương pháp chế biến vị thuốc cổ truyền theo Phụ lục 3 QĐ 824/QĐ-BYT — nguồn mã cho trường MA_PP_CHEBIEN trong dữ liệu khám bệnh, chữa bệnh bảo hiểm y tế. Gồm 7 mã nhóm (level = group) và 33 mã phương pháp cụ thể, chia hai nhóm sơ chế (SC) và phức chế (PC).

NGUỒN MÃ và NGUỒN ĐỊNH NGHĨA là hai văn bản khác nhau. TT 14/2024/TT-BYT (06/9/2024, hiệu lực 28/10/2024) đã thay TT 30/2017/TT-BYT về nội dung phương pháp chế biến, nhưng KHÔNG ban hành mã — toàn văn không chứa mã SC/PC nào. Vì vậy mã vẫn lấy theo QĐ 824/QĐ-BYT (còn hiệu lực: TT 12/2026/TT-BTC Điều 7 khoản 1 điểm a liệt kê trong chuỗi sửa đổi, bổ sung QĐ 7603/QĐ-BYT), còn định nghĩa nội dung tra theo Điều tương ứng của Phụ lục I TT 14/2024/TT-BYT — property tt14-2024-article, phủ 29/40 mã.

KHOẢNG TRỐNG cần biết trước khi dùng: danh mục mã lập theo TT 30/2017/TT-BYT nên chưa có mã riêng cho 3 phương pháp phức chế mà TT 14/2024/TT-BYT bổ sung — Điều 29 phương pháp chưng; Điều 32 phương pháp tôi; Điều 33 phương pháp rán dầu. Ba phương pháp này tạm ghi bằng mã PCK (phương pháp khác) kèm mô tả văn xuôi, cho tới khi Bộ Y tế cập nhật bộ mã dùng chung. Điều 1 (phương pháp loại tạp) cũng chưa có mã tương ứng; SC0 mang nghĩa chưa sơ chế nên không dùng thay được.

Danh mục mã phương pháp vô cảm sử dụng trong phẫu thuật, thủ thuật theo QĐ 3176/QĐ-BYT (29/10/2024) (trường PP_VO_CAM, STT 42, Bảng 3 — Chỉ tiêu chi tiết DVKT và VTYT). Trường thông tin này chỉ bắt buộc khi thực hiện phẫu thuật, thủ thuật có sử dụng phương pháp vô cảm.

Phương thức cung cấp dịch vụ khám bệnh, chữa bệnh: trực tiếp, tại nhà, từ xa giữa người hành nghề với người bệnh, và hỗ trợ từ xa giữa hai cơ sở khám bệnh, chữa bệnh. Tên các hình thức lấy nguyên văn từ Luật 15/2023/QH15 Điều 80 (khám bệnh, chữa bệnh từ xa và hỗ trợ khám bệnh, chữa bệnh từ xa) và Luật 114/2025/QH15 Điều 44 khoản 1 — điều khoản này bổ sung khám bệnh, chữa bệnh từ xa, hỗ trợ khám bệnh, chữa bệnh từ xa và khám bệnh, chữa bệnh tại nhà vào phạm vi hưởng bảo hiểm y tế từ 01/07/2026. Mã ngắn do dự án tự đặt (property codeSource = project-assigned) vì các luật mô tả hình thức dạng tường thuật, không cấp mã. Trục này KHÔNG mã hóa địa điểm — địa điểm dùng VNServiceDeliverySettingCS. / Care delivery mode axis: in-person, home visit, telehealth between practitioner and patient, and inter-facility tele-support. Names taken verbatim from Law 15/2023/QH15 Art.80 and Law 114/2025/QH15 Art.44; short codes are project-assigned.

Phương thức thanh toán KCB BHYT. Mapping XML 3176: MA_PTTT. Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024) — Bảng 2 STT 36 và Bảng 3 STT 40.

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/NĐ-CP Đ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).

Danh mục mã quy tắc kiểm tra hợp lệ (rule code) của VN Core — registry machine-readable cho từng quy tắc validate, ánh xạ sang OperationOutcome.issue.details.coding khi máy chủ trả lỗi.

Thiết kế FHIR-native (CodeSystem có property) thay cho mô hình bảng tính phân tán: mỗi mã rule mang sẵn severity, tầng kiểm tra (tier), phân loại căn cứ, biểu thức FHIRPath/quy tắc, tên invariant (nếu có) và căn cứ pháp lý.

Cách dùng trong OperationOutcome:

• issue.details.coding.system = http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs
• issue.details.coding.code = mã rule (vd VN-RULE-ENC-001)
• issue.details.text = thông điệp (display)
• issue.expression = FHIR path vi phạm
• issue.severity = theo property severity của mã

Bổ trợ cho trang Hướng dẫn kiểm tra hợp lệ (chi tiết 3 tầng) và OperationOutcome & Registry quy tắc (quy ước phản hồi). / VN Core validation rule registry: a machine-readable CodeSystem mapping each validation rule to an OperationOutcome details coding, with severity, tier, category, FHIRPath expression, invariant name, and legal basis.

CodeSystem supplement bổ sung bản dịch tiếng Việt (designation.language = vi) cho SNOMED CT quốc tế. Đây KHÔNG phải một hệ mã độc lập — khi coding trong FHIR luôn dùng system = http://snomed.info/sct; supplement này chỉ gắn thêm tên tiếng Việt (và property vn-code — mã quốc gia BYT) cho các mã SNOMED CT.

Phạm vi: subset chính thức Bộ Y tế 77.393 concept từ 3 đợt ban hành, sau khử trùng snomed_ct_id còn 76.066 mã SNOMED riêng biệt (1.327 mã thuộc cả đợt dị ứng và phát hiện — giữ cả hai tên tiếng Việt làm designation):

• Đợt 1 (QĐ 2427/QĐ-BYT, 25/7/2025): Body Structures — 35.889 concepts
• Đợt 2 (QĐ 2493/QĐ-BYT, ~08/2025): Morphologic Abnormality — 5.155 concepts
• Đợt 3 (QĐ 2805/QĐ-BYT, 04/9/2025): Clinical Finding + Allergy — 36.349 concepts

Căn cứ pháp lý trực tiếp là 3 Quyết định nêu trên; khung kiến trúc số ngành y tế QĐ 4152/QĐ-BYT (2024).

Quan hệ với ValueSet: các ValueSet SNOMED (vn-body-site-vs, vn-morphology-vs, vn-allergy-code-vs, vn-condition-code-vs) định nghĩa intensional trực tiếp trên http://snomed.info/sct (concept is-a #X) — cần SNOMED terminology server để expand/validate. Supplement này bổ nghĩa tiếng Việt cho các mã đó, KHÔNG nằm trong định nghĩa ValueSet.

Cách dùng trong VN Core: Coding dùng system = http://snomed.info/sct, code = SNOMED CT ID. Terminology server nạp supplement này để hiển thị/tra cứu tên tiếng Việt. Property vn-code giữ mã quốc gia BYT để truy vết văn bản. 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: bản FHIR JSON đầy đủ CodeSystem-vn-snomed-subset-cs.full.json (content = supplement, 76.066 concept với designation tiếng Việt) trên release download surface — xem trang tải xuống. Public IG page này chỉ là metadata declaration của supplement.

English summary: A CodeSystem supplement adding Vietnamese designations (and a vn-code property) to international SNOMED CT (supplements = http://snomed.info/sct). Never used as Coding.system — code with http://snomed.info/sct. Covers the MOH 77,393-concept subset → 76,066 unique SCTIDs; official MOH Vietnamese translation (QĐ 2427/2493/2805).

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. Based on the Medical Examination and Treatment Law 2023 Art.19-27 and 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).

Trạng thái nghiệp vụ của công việc điều phối trong hai luồng đã có trong VN Core: tiếp nhận chuyển người bệnh (nhóm mã REF, theo Luật 15/2023/QH15 Điều 60 khoản 10) và cấp phát, bán thuốc theo đơn (nhóm mã RX, theo TT 26/2025/TT-BYT Điều 12). Toàn bộ mã do dự án tự đặt (property codeSource = project-assigned) vì chưa có danh mục mã quốc gia cho trạng thái nghiệp vụ điều phối; không suy diễn là mã do Bộ Y tế ban hành. Dùng ở Task.businessStatus, bổ sung cho Task.status vốn chỉ mô tả vòng đời kỹ thuật của công việc. / Business status of coordination tasks in two workflows already covered by VN Core: patient referral acceptance (REF codes, per Law 15/2023/QH15 Art.60.10) and prescription dispensing (RX codes, per Circular 26/2025/TT-BYT Art.12). All codes are project-assigned as no national code list exists for coordination business status.

Bộ mã trạng thái pháp lý của văn bản trong VNLegalDocumentRefCS. Dùng làm value-set binding cho property status trong CodeSystem VNLegalDocumentRefCS, giúp validator hiểu rằng các giá trị status thuộc một tập hữu hạn được định nghĩa rõ ràng. Phân loại 6 trạng thái:

• in-force: đang có hiệu lực, áp dụng hiện hành
• amended: đang có hiệu lực nhưng đã được sửa đổi, bổ sung MỘT PHẦN bởi văn bản khác — đọc hợp nhất với văn bản sửa đổi khi viện dẫn
• future-effective: đã ban hành nhưng chưa đến ngày hiệu lực
• transition: đang trong giai đoạn chuyển tiếp (có hiệu lực nhưng cho phép áp dụng song song với văn bản cũ)
• superseded: đã bị thay thế hoàn toàn bởi văn bản khác
• expired: hết hiệu lực và không có thay thế

Trục phân loại ĐỊA ĐIỂM nơi một dịch vụ y tế được cung cấp (independent của loại dịch vụ). Seed ban đầu lấy từ cột địa điểm của Phụ lục TT 30/2024/TT-BYT (gói dịch vụ y tế cơ bản tuyến xã): trạm y tế, tại nhà, điểm cộng đồng, cơ sở y tế khác, trường học, cơ sở kinh doanh thực phẩm. Mục đích: cung cấp tập mã trung lập để IG phái sinh binding ở HealthcareService.location / extension địa điểm cung cấp. KHÔNG mã hóa loại dịch vụ vào trục này. LƯU Ý GOVERNANCE: mã station/home/community-point/… do dự án gán (TT 30/2024/TT-BYT mô tả địa điểm dạng tường thuật, không cấp mã ngắn). GIỮ ^experimental = true tới khi có chính sách code-assignment quốc gia.

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ũ; các nhãn địa danh trong display mô tả tên tuyến kỹ thuật cũ, không phải cấp quản lý hành chính và không tạo ánh xạ sang mô hình chính quyền 2 cấp. TT 43/2013/TT-BYT đã bị bãi bỏ bởi TT 23/2024/TT-BYT từ ngày 18/10/2024. English: Historical technical-line classification under Circular 43/2013/TT-BYT. Geographic labels in code displays identify former technical lines only; they are not current administrative levels and must not be mapped to the two-tier local-government model.

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).

Danh mục đối tượng khám sức khỏe định kỳ / khám sàng lọc (trường DOI_TUONG) — GIAI ĐOẠN HIỆU LỰC LEGACY theo QĐ 1551/QĐ-BYT (31/5/2026) Phụ lục 01, hiệu lực 31/05/2026–07/07/2026 (bị QĐ 2062/QĐ-BYT thay thế). Artifact IMMUTABLE (ADR-0017 Điều 6, phương án B): giữ nguyên nghĩa 14 mã cũ để 17 mẫu phiếu retired (VNKSKQuestionnaire01–17) và dữ liệu đã ghi ở ≤0.7.0 không bị đổi nghĩa hồi tố — đặc biệt mã #14 = 'Các đối tượng khác' (giai đoạn hiệu lực hiện hành: #14 = 'Người lao động không chính thức'). Ánh xạ sang giai đoạn hiệu lực hiện hành: ConceptMap vn-cm-health-checkup-subject-legacy-to-current. Dữ liệu MỚI không dùng CodeSystem này — dùng vn-health-checkup-subject-cs.

Danh mục đối tượng khám sức khỏe định kỳ / khám sàng lọc (trường DOI_TUONG) — giai đoạn hiệu lực HIỆN HÀNH theo QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 01 (THAY Phụ lục 01 QĐ 1551/QĐ-BYT 31/5/2026; đọc hợp nhất). Business version = 20260707 (ngày hiệu lực QĐ 2062/QĐ-BYT — ADR-0017 Điều 4). Phân biệt ngữ nghĩa giữa hai giai đoạn hiệu lực bằng CANONICAL TÁCH (cặp vn-health-checkup-subject-cs / vn-health-checkup-subject-legacy-cs), không dựa vào Coding.version. Coding.version là tùy chọn; nếu có, giá trị phải khớp business version của canonical đã chọn. Mã #14 đã TÁI SỬ DỤNG với nghĩa khác giữa hai giai đoạn hiệu lực (QĐ 1551/QĐ-BYT: 'Các đối tượng khác' → QĐ 2062/QĐ-BYT: 'Người lao động không chính thức'). Giai đoạn hiệu lực cũ: vn-health-checkup-subject-legacy-cs (immutable); ánh xạ: ConceptMap vn-cm-health-checkup-subject-legacy-to-current; dữ liệu cũ mang mã 14 phải tái mã hóa (mặc định → 16). Lưu ý: một lần khám có thể có nhiều đối tượng — khi đó các mã được phân cách bằng dấu chấm phẩy ';' (ví dụ '13;15') — quy ước Ở TẦNG SERIALIZATION QĐ 2062/QĐ-BYT (LogicalModel envelope), không phải cú pháp mã FHIR. English: Current health-checkup subject catalogue under Decision 2062/QĐ-BYT. Semantic identity across the two effective periods is distinguished solely by split canonicals, not by Coding.version. Coding.version is optional and, when present, SHALL match the business version of the selected canonical.

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ị mã ICD-10 của các bệnh được phép thông báo, tiết lộ giới tính thai nhi để phục vụ chẩn đoán và điều trị. Căn cứ: TT 11/2026/TT-BYT (ban hành 15/05/2026, hiệu lực 01/07/2026) quy định Danh mục các bệnh được thông báo, tiết lộ giới tính thai nhi, theo khoản 3 Điều 6 Luật Dân số 113/2025/QH15. Danh mục gồm 137 dòng STT, dedupe mã H90 (xuất hiện 2 lần tại STT 2 và STT 59) còn 136 mã ICD-10 duy nhất. Mã được tham chiếu theo hệ thống ICD-10 chính tắc của FHIR; mã L99 và L99.0 là mã sao (*) theo quy ước dao găm/sao (dagger/asterisk) ICD-10. LƯU Ý PHÁP LÝ: việc tiết lộ giới tính thai nhi chỉ hợp pháp khi phục vụ chẩn đoán và điều trị các bệnh trong danh mục này; ngoài phạm vi đó vẫn bị cấm theo pháp luật về dân số.

Canonical vn-district-vs đã được supersede bởi vn-district-legacy-vs từ bản 0.9.0. ValueSet retired này chỉ được giữ để resolve dữ liệu đã công bố; mọi trao đổi dữ liệu huyện lịch sử mới phải dùng vn-district-legacy-vs. English: This retired canonical was superseded by vn-district-legacy-vs in release 0.9.0 and remains available only to resolve previously published data.

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 theo QĐ 1227/QĐ-BYT. Each maps to LOINC.

Tập giá trị gồm đủ 55 mã chỉ tiêu của Mẫu số 06/BH dùng cho biên bản quyết toán, thanh toán chi phí khám bệnh, chữa bệnh bảo hiểm y tế theo quý. Căn cứ: [TT 12/2026/TT-BTC] (ban hành 10/02/2026, hiệu lực 10/02/2026) — Giám định, thanh toán và quyết toán chi phí KCB BHYT. / ValueSet containing all 55 indicators from Form 06/BH for quarterly health-insurance healthcare cost settlement and payment minutes. Legal basis: Circular 12/2026/TT-BTC (issued 10/02/2026, effective 10/02/2026) — health-insurance healthcare cost assessment, payment, and settlement.

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ăn cứ pháp lý cho xử lý dữ liệu cá nhân không cần sự đồng ý của chủ thể dữ liệu, theo Luật 91/2025/QH15 Điều 19 khoản 1. Dùng cho extension vn-ext-processing-legal-basis trên AuditEvent (quyết định + truy cập/tiết lộ thực tế) và Provenance (tạo/sửa/dẫn xuất dữ liệu). Context Consent chỉ còn để đọc legacy 0.8 trong dòng 0.9; không dùng để authoring mới. / Value set for processing without consent under Article 19(1), used on AuditEvent for authorization decisions and actual access/disclosure, and on Provenance for data creation, update, or derivation. Consent is legacy-read only in the 0.9 line and must not be used for new authoring.

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ử.

Tập giá trị bệnh truyền nhiễm thuộc các nhóm A/B/C (81 bệnh) theo khoản 4 Điều 15 Luật Phòng bệnh. Căn cứ: QĐ 1965/QĐ-BYT (01/7/2026), Luật 114/2025/QH15 (Luật Phòng bệnh), TT 15/2026/TT-BYT. Dùng cho phân loại/khai báo bệnh truyền nhiễm (Condition). Lọc theo nhóm bằng property group (A/B/C).

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ị gồm toàn bộ concept của VNBasicHealthServiceCS (15 nhóm gói, 39 dịch vụ, 20 dịch vụ con theo TT 30/2024/TT-BYT). Mục đích: cung cấp tập mã để binding ở IG phái sinh (vd hl7.fhir.vn.chc — HealthcareService.type/category của tuyến xã). KHÔNG binding trong core; core chỉ publish terminology trung lập. Theo cùng cảnh báo governance của CodeSystem: experimental tới khi chốt chính sách code-assignment quốc gia.

Toàn bộ 4142 mã bệnh y học cổ truyền của bộ mã dùng chung (Phụ lục 07.1 QĐ 7603/QĐ-BYT, sửa đổi bởi QĐ 1978/QĐ-BYT). Dùng cho trường MA_BENH khi gửi dữ liệu khám bệnh, chữa bệnh bảo hiểm y tế cho ca điều trị y học cổ truyền.

Tập giá trị mã khoa trong cơ sở KCB (trường MA_KHOA, 67 mã gồm 61 mã khoa + 6 đơn nguyên). Căn cứ: QĐ 1804/QĐ-BYT (19/6/2026) Phụ lục 02; tiền nhiệm QĐ 2010/QĐ-BYT (19/6/2025) Phụ lục 6.

Tập giá trị gồm toàn bộ 696 quận/huyện của giai đoạn trước 01/07/2025; chỉ dùng để resolve, validate hoặc chuyển đổi dữ liệu lịch sử; không dùng cho Coding mới. Artifact ở trạng thái retired theo tiền lệ Province/KSK legacy. Nguồn là danh mục đơn vị hành chính do Tổng cục Thống kê công bố trước sắp xếp, không phải QĐ 19/2025/QĐ-TTg Phụ lục II. English: Complete value set of 696 former district-level units for historical data before 01 July 2025, sourced from the pre-reorganisation General Statistics Office catalogue and retained in retired status.

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ị 34 tỉnh/thành phố hiện hành theo NQ 202/2025/QH15 (business version 20250701). Dữ liệu địa chỉ tồn đọng ghi trước 01/07/2025 dùng vn-province-legacy-vs (63 mã) — binding vn-ext-province là extensible nên dữ liệu lịch sử vẫn hợp lệ.

Tập giá trị 63 tỉnh/thành phố giai đoạn hiệu lực trước 01/07/2025 (trước NQ 202/2025/QH15). Artifact IMMUTABLE — chỉ dùng validate dữ liệu địa chỉ tồn đọng ghi trước 01/07/2025. Dữ liệu mới dùng vn-province-vs (34 mã).

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

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ị mã giới tính theo QĐ 3176/QĐ-BYT (29/10/2024) — trường GIOI_TINH (Bảng 1) và GIOI_TINH_CON (Bảng 9). Là tập nguồn cho ConceptMap ánh xạ sang administrative-gender của FHIR.

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 theo 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 khi profile hoặc workflow VN Core áp dụng yêu cầu mã hóa ICD-10. Căn cứ: QĐ 4469/QĐ-BYT (28/10/2020), QĐ 98/QĐ-BYT (14/01/2022), TT 06/2026/TT-BYT (ban hành 02/04/2026, hiệu lực 01/07/2026) và tài liệu hướng dẫn kỹ thuật QĐ 1849/QĐ-BYT (23/6/2026) 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/QĐ-BYT), 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) — 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ị legacy theo trường MA_LYDO_VVIEN — QĐ 4210/QĐ-BYT (2017), gồm bốn mã nguồn 1–4 và mã 5 là mở rộng dự án chờ nguồn. Chuẩn hiện hành QĐ 3176/QĐ-BYT dùng MA_DOI_TUONG_KCB với danh mục 27 mã theo QĐ 3276/QĐ-BYT (xem VNPatientVisitTypeCS).

Tập giá trị mã loại hình khám bệnh, chữa bệnh (MA_LOAI_KCB, 16 mã). Căn cứ: QĐ 1804/QĐ-BYT (19/6/2026) Phụ lục 01; tiền nhiệm QĐ 3176/QĐ-BYT (29/10/2024).

Tập giá trị hiện hành cho Composition.type của hồ sơ khám sức khỏe: ba mẫu theo nhóm tuổi (#18–#20) theo QĐ 2062/QĐ-BYT và mẫu khám sức khỏe tâm thần (#21) theo TT 25/2026/TT-BYT. Các mã #01–#17 của QĐ 1551/QĐ-BYT chỉ còn dùng cho dữ liệu lịch sử và không thuộc tập giá trị này.

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 thẩm quyền đại diện (đại diện pháp luật / giám hộ / uỷ quyền / đại diện KCB). Căn cứ: Bộ luật Dân sự 2015, Luật Trẻ em 2016, Luật KCB 2023.

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) — 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.

ValueSet loại điều trị lao (LOAI_DTRI_LAO, Bảng 15 QĐ 3176/QĐ-BYT) dùng cho EpisodeOfCare.type trong hồ sơ quản lý điều trị lao.

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 chỉ thị đồ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 9, Điều 24, Điều 26. Từ 0.8.0 chỉ gồm 5 mã active — hai mã miễn trừ deprecated (#emergency, #legal-obligation) không còn trong tập giá trị: căn cứ xử lý không cần đồng ý (Điều 19) biểu diễn bằng vn-processing-legal-basis-vs qua extension vn-ext-processing-legal-basis. Dữ liệu ≤0.7.0 mang 2 mã cũ vẫn giải nghĩa được qua CodeSystem (concept permanence).

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ị mã lý do chuyển tuyến/chuyển cơ sở khám bệnh, chữa bệnh BHYT (trường MA_LYDO_CT) theo QĐ 3176/QĐ-BYT (29/10/2024), Bảng 13.

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) — 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ị lớp nhạy cảm dữ liệu (cơ bản / nhạy cảm / bảo vệ đặc biệt). Căn cứ: Luật 91/2025/QH15, Luật Trẻ em 2016.

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Ã BIỂU MẪU GIẤY TỜ (document form code) theo QĐ 3176/QĐ-BYT (29/10/2024) — trường MAU_SO (Bảng 11). Dùng cho DocumentReference.type / Composition.type. KHÔNG liên quan đến mẫu thẻ BHYT.

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

• ICD-10 Việt Nam theo QĐ 4469/QĐ-BYT 28/10/2020, bổ sung bởi QĐ 98/QĐ-BYT 14/01/2022 và cập nhật theo QĐ 1849/QĐ-BYT 23/6/2026 — 15.617 mã; profile/workflow áp dụng quyết định có bắt buộc slice này hay không
• SNOMED CT IPS Terminology — Clinical Findings (tùy chọn, miễn phí theo CC-BY-4.0) — 35.022 mã trong VN subset (VN subset gồm 36.349 mã Clinical Findings + Allergy; ValueSet này chỉ include nhánh Clinical Finding 404684003 và Events 272379006, không include nhánh Allergy)
• 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 — dùng mã trong tập khi có khái niệm phù hợp và cho phép mang nhiều coding khi quan hệ ngữ nghĩa đã được xác nhận; không tự chứng minh các coding là tương đương. 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ã chỉ tiêu Observation KSK (Observation.code). Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026).

Danh sách 1327 mã SNOMED CT thuộc nhánh dị ứng đã được Bộ Y tế ban hành kèm tên tiếng Việt chính thức (QĐ 2805/QĐ-BYT — Danh mục mã dùng chung thuật ngữ y học lâm sàng Đợt 3, nhánh dị ứng).

KHÁC VỚI VNAllergyCodeVS: vn-allergy-code-vs là binding của VNCoreAllergyIntolerance.code, định nghĩa intensional trên cây SNOMED quốc tế nên bao cả mã chưa có tên tiếng Việt. ValueSet này liệt kê đúng danh mục đã ban hành, dùng để trả lời câu hỏi khác: mã đang ghi đã có bản dịch chính thức chưa. KHÔNG dùng làm binding bắt buộc — danh mục Đợt 3 chưa phủ hết chất gây dị ứng gặp trong thực tế, ép required sẽ chặn ghi nhận ca dị ứng có thật.

LƯU Ý MÔ HÌNH HÓA: mã trong danh mục có dạng Allergy to penicillin (finding) — là khuynh hướng phản ứng, không phải chất gây dị ứng. Xem hướng dẫn chọn giữa hai cách mã hóa tại phần định nghĩa của VNCoreAllergyIntolerance.code.

Tên tiếng Việt đi kèm ở designation.language = vi; bản dịch đầy đủ cho toàn bộ subset SNOMED CT VN nằm ở CodeSystem supplement vn-snomed-subset-cs.

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.

Toàn bộ 279 mã hoạt chất chế phẩm thuốc cổ truyền của bộ mã dùng chung (Phụ lục 06 QĐ 7603/QĐ-BYT). Dùng cho Medication.code và MedicationRequest.medication[x] khi kê hoặc cấp phát chế phẩm y học cổ truyền, và cho trường MA_THUOC khi gửi dữ liệu bảo hiểm y tế.

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ị nhóm chi phí hồ sơ BHYT (MA_NHOM XML2/XML3 — hiện theo QĐ 3176/QĐ-BYT). Đổi tên 0.8.0 từ vn-qd3176-cost-group-vs (ADR-0017).

ĐÃ THAY THẾ (0.8.0, ADR-0017 Điều 15): dùng vn-bhyt-claim-cost-group-vs. Giữ nguyên compose trên canonical CS cũ để validate dữ liệu ≤0.7.0.

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)
• DVKT VN (TT 23/2024/TT-BYT, lộ trình sửa bởi TT 25/2026/TT-BYT Điều 3): Phụ lục 1 là danh mục đang thực hiện đến hết 31/12/2027; Phụ lục 2 áp dụng từ 01/01/2028 (mốc cũ PL1 đến 30/6/2026, PL2 từ 01/7/2026 đã bị dời). Binding extensible. Ánh xạ DVKT VN ↔ ICD-9-CM theo QĐ 4466/QĐ-BYT (2020).

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường (không nhợt), Không bình thường (Nhợt).

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Bất thường bên phải, Bất thường bên trái.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Giới hạn.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Hai mắt xa nhau.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Hạn chế.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Không bình thường.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Không bình thường.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Lưỡi to bè.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Mù màu toàn bộ, Mù màu đỏ, Mù màu xanh lá cây, Mù màu vàng.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Mũi to/dày, Bất sản xương mũi.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Nhanh.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Rộng, Hẹp, Thóp phồng.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Rụng tóc.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Suy dinh dưỡng, Thừa cân béo phì.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Sưng/đỏ, Chảy ghèn/mủ.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Sốt, Hạ thân nhiệt.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Sứt môi/chẻ vòm.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Tai đóng thấp.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Thở nhanh, Thở chậm.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Trật khớp háng.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Tăng, Giảm.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bình thường, Đầu to, Đầu nhỏ.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bú mẹ hoàn toàn, Bú mẹ + sữa công thức, Sữa công thức hoàn toàn.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Bắt rõ, Mạch nhẹ, Không bắt được.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Cha, Mẹ, Ông/Bà, Anh/Chị, Họ hàng, Khác.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Chưa, Có.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Có (bình thường), Không (bất thường).

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Có, Không.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Có, Không, Không nhớ rõ.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Da kề da và nằm với mẹ đến khi ra viện, Điều trị tại Khoa sơ sinh.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Gù, Ưỡn.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Hình chữ S, Hình chữ C.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Hạn chế, Bình thường.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Hồng hào, Nhợt, Tím, Vàng, Sạm da.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không bất thường, Có bất thường.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không bệnh, Hen, Động kinh, Dị ứng, Tim bẩm sinh.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không nhợt (bình thường), Nhợt.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không thử, Bình thường, Mù mầu, Hạn chế.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không tiêm loại khác, Có tiêm loại khác.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không được tiêm, Được tiêm, Không nhớ rõ.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không đều, Đều.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không đủ sức khỏe học tập/làm việc, Đủ sức khỏe học tập/làm việc.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không đủ, Đủ.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không, Bình thường.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không, Có cơn ngưng thở >5 giây.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Không, Xuất huyết, Bóng nước, Khác.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Máu gót chân, Thính lực, Tim bẩm sinh, Không có thông tin.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Sinh thường, Sinh mổ.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Toàn vẹn/cân đối, Hở cột sống, Vẹo cột sống.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Trong nước, Quốc tế.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Tốt, Trung bình, Kém.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Đẻ thiếu tháng, Đẻ thừa cân, Đẻ có can thiệp, Đẻ ngạt, Mẹ bị bệnh trong thời kỳ mang thai.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Đẻ thiếu tháng, Đẻ thừa tháng, Đẻ có can thiệp, Đẻ ngạt.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Đều/rõ/không âm thổi, Không đều, Tiếng tim bất thường, Âm thổi, Rung miêu.

ValueSet trả lời cho trường phiếu KSK (QĐ 2062/QĐ-BYT Phụ lục 01): Đủ 2 bên, Bất thường.

Toàn bộ 349 mã vị thuốc của Phụ lục 06.3 QĐ 7603/QĐ-BYT, phục vụ đọc và chuyển đổi dữ liệu lịch sử. Bản ghi mới dùng vn-yhct-herb-vs theo QĐ 3080/QĐ-BYT.

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 giá trị mục đích sử dụng cho AuditEvent quyết định theo căn cứ pháp lý. Tập này giữ toàn bộ mục đích xử lý hiện có của VNConsentPurposeVS và bổ sung ba mã HL7 v3-ActReason cho truy cập cấp cứu: BTG (break-glass thực sự), ETREAT (điều trị cấp cứu) và ERTREAT (quyền truy cập thường trực của khoa cấp cứu). Căn cứ pháp lý xử lý vẫn được ghi riêng bằng VNCoreExtProcessingLegalBasis. / Purpose-of-use values for legal-basis decision AuditEvents. This value set retains all existing VNConsentPurposeVS purposes and adds the HL7 v3-ActReason BTG, ETREAT, and ERTREAT emergency-access codes. The processing legal basis remains separate in VNCoreExtProcessingLegalBasis.

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ị 5 mức độ ưu tiên cấp cứu (thang đề xuất VN Core — proposed/local, tham chiếu thực hành 5 mức quốc tế/ATS), dùng cho VNCoreObservationTriageAcuity.value. Căn cứ nguyên tắc ưu tiên: QĐ 01/2008/QĐ-BYT — văn bản không quy định số mức/mốc thời gian cụ thể.

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) — 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 giá trị nguồn kinh phí khám sức khỏe định kỳ (NGUON_CHI_TRA). Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026).

Tập giá trị nguồn xác minh thẩm quyền đại diện (CSDLQGDC / Toà án / công chứng / CSYT khai báo). Căn cứ: Luật Căn cước 2023, Bộ luật Dân sự 2015.

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ị năm nhóm tiêu chuẩn chất lượng cơ bản đối với bệnh viện theo Phụ lục TT 35/2024/TT-BYT. / ValueSet of the five basic hospital quality standard groups per Circular 35/2024/TT-BYT.

ValueSet phác đồ điều trị lao (PHACDO_DTRI_LAO 1–27, Bảng 15 QĐ 3176/QĐ-BYT) dùng cho CarePlan.category trong hồ sơ quản lý điều trị lao.

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ị gồm hai subtype VN Core cho (1) quyết định xử lý theo căn cứ pháp lý không qua đồng ý và (2) truy cập/tiết lộ thực tế theo quyết định đó. / Value set containing the two VN Core subtypes for a legal-basis authorization decision and the subsequent actual access or disclosure.

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.

Tập giá trị phân loại sức khỏe Loại I–V (PHAN_LOAI_SK). Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026).

Toàn bộ 40 mã phương pháp chế biến vị thuốc cổ truyền của bộ mã dùng chung (Phụ lục 3 QĐ 824/QĐ-BYT). Dùng cho extension vn-ext-traditional-processing-method và cho trường MA_PP_CHEBIEN khi gửi dữ liệu bảo hiểm y tế. Binding để extensible vì TT 14/2024/TT-BYT có ba phương pháp chưa được cấp mã riêng.

Tập giá trị mã phương pháp vô cảm trong phẫu thuật, thủ thuật theo QĐ 3176/QĐ-BYT (29/10/2024) (trường PP_VO_CAM, STT 42, Bảng 3). Chỉ bắt buộc khi phẫu thuật, thủ thuật có sử dụng phương pháp vô cảm.

Tập giá trị phương thức cung cấp dịch vụ khám bệnh, chữa bệnh dùng cho đặt lịch (Appointment, Slot, Schedule) và mô tả dịch vụ (HealthcareService). / ValueSet of care delivery modes used for scheduling resources and service descriptions.

Phương thức thanh toán KCB BHYT: FFS, Capitation, DRG. Mapping XML 3176: MA_PTTT (Bảng 2 STT 36, Bảng 3 STT 40).

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ị trạng thái nghiệp vụ của công việc điều phối chuyển người bệnh và cấp phát thuốc theo đơn. Binding extensible: cơ sở có luồng điều phối khác (ví dụ điều phối mẫu bệnh phẩm) được bổ sung mã riêng. / ValueSet of coordination task business statuses for patient referral and prescription dispensing.

Tập giá trị bind cho property status trong VNLegalDocumentRefCS. 5 trạng thái: in-force | future-effective | transition | superseded | expired.

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/QĐ-BYT), 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ị gồm toàn bộ concept của VNOrgCarryOverItemCS (license, bhyt-contract, primary-care-registration, price-list, seal-code). Dùng cho binding ở sub-extension carryOver của VNCoreExtOrgLifecycleRelation.

Tập giá trị gồm toàn bộ concept của VNOrgLifecycleRelationCS (predecessor, successor, merged-into, split-from). Dùng cho binding ở sub-extension relationType của VNCoreExtOrgLifecycleRelation.

Tập giá trị gồm toàn bộ concept của VNServiceDeliverySettingCS (6 địa điểm cung cấp dịch vụ: trạm y tế, tại nhà, điểm cộng đồng, cơ sở y tế khác, trường học, cơ sở kinh doanh thực phẩm). Mục đích: cung cấp tập mã để binding ở IG phái sinh (vd hl7.fhir.vn.chc — HealthcareService.location của tuyến xã). KHÔNG binding trong core. Theo cùng cảnh báo governance của CodeSystem: experimental tới khi chốt chính sách code-assignment quốc gia.

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. Ngoài toàn bộ văn bản trong VNLegalDocumentRefCS, ValueSet này còn bao gồm các mã ngoại lệ cục bộ trong VNLegalBasisExceptionCS để khai báo tường minh trường hợp cố ý không có căn cứ.

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.

Tập giá trị đối tượng khám sức khỏe định kỳ (DOI_TUONG) — GIAI ĐOẠN HIỆU LỰC LEGACY theo QĐ 1551/QĐ-BYT (31/5/2026), hiệu lực 31/05/2026–07/07/2026. Artifact IMMUTABLE (ADR-0017 Điều 6): chỉ dùng cho 17 mẫu phiếu retired (VNKSKQuestionnaire01–17) và validate dữ liệu đã ghi ở ≤0.7.0. Dữ liệu mới dùng vn-health-checkup-subject-vs (giai đoạn hiệu lực QĐ 2062/QĐ-BYT).

Tập giá trị đối tượng khám sức khỏe định kỳ (DOI_TUONG) — giai đoạn hiệu lực hiện hành QĐ 2062/QĐ-BYT (07/7/2026). Business version = 20260707 (ADR-0017 Điều 4). Giai đoạn hiệu lực cũ (17 mẫu phiếu retired): vn-health-checkup-subject-legacy-vs.

ConceptMap ánh xạ bệnh danh và thể lâm sàng Y học cổ truyền (mã U) sang ICD-10.

PHẠM VI: 228/228 mã của VNYHCTDiseaseCS — gồm 38 bệnh danh gốc và 190 thể lâm sàng, trỏ tới 25 mã ICD-10 riêng biệt.

HAI TẦNG NGUỒN GỐC — đọc kỹ trước khi dùng: 38 bệnh danh gốc lấy TRỰC TIẾP từ cột ICD-10 của QĐ 2552/QĐ-BYT Phụ lục I. 190 thể lâm sàng KẾ THỪA mã ICD-10 của bệnh danh cha theo quy tắc của dự án — phụ lục nguồn gán mã ở cấp bệnh danh, không gán riêng cho từng thể. Nguồn gốc của từng ánh xạ ghi ở target.comment.

NGOÀI PHẠM VI: nhánh chẩn đoán YHCT (VNYHCTDiagnosisCS, 106 mã theo QĐ 3080/QĐ-BYT) chưa được ánh xạ vì phụ lục nguồn của nhánh đó không có cột ICD-10; ánh xạ nhánh này cần hội đồng chuyên môn quyết định, không sinh tự động được. Bảy nhóm thuật ngữ YHCT còn lại (huyệt, kỹ thuật, triệu chứng, lưỡi, mạch, pháp điều trị, dược liệu, bài thuốc) không có khái niệm ICD-10 tương ứng nên không thuộc phạm vi ánh xạ này.

HIỆU CHỈNH THEO VĂN BẢN MỚI: QĐ 2552/QĐ-BYT ban hành 12/8/2025, trước khi TT 06/2026/TT-BYT chuẩn hóa lại mã ICD-10. Ánh xạ dưới đây đã cập nhật theo QĐ 1978/QĐ-BYT (01/7/2026) cho nhánh bệnh danh bị đổi mã (U58.762: I84 → K64); 6 concept chịu ảnh hưởng. Các mã còn lại của QĐ 2552/QĐ-BYT không nằm trong danh sách sửa đổi của QĐ 1978/QĐ-BYT.

EQUIVALENCE: toàn bộ ánh xạ dùng relatedto. Y học cổ truyền và ICD-10 là hai hệ thống chẩn đoán khác nhau; phụ lục gán mã ICD-10 để phục vụ thống kê và thanh toán chứ không tuyên bố hai khái niệm đồng nghĩa, nên ConceptMap này KHÔNG khẳng định equivalent hay wider. Nâng cấp equivalence chỉ sau khi hội đồng chuyên môn thẩm định từng cặp; đến lúc đó artifact giữ experimental = true.

Số mã chưa ánh xạ trong VNYHCTDiseaseCS: 0.

ConceptMap cầu danh mục bệnh truyền nhiễm nhóm A/B/C (QĐ 1965/QĐ-BYT, khoản 4 Điều 15 Luật Phòng bệnh 114/2025/QH15) sang ICD-10 (WHO 2019 / bản VN QĐ 4469/QĐ-BYT + TT 06/2026/TT-BYT), phục vụ liên thông Condition/khai báo bệnh truyền nhiễm. Nguyên tắc mô hình hóa (đã đối chiếu Codex GPT-5.6 Sol + xác nhận chủ dự án):

• Bệnh trải nhiều mã ICD-10 (Lao, HIV, Sốt rét, Viêm não virus, Rickettsia, Giang mai) → ánh xạ 1 mã 'không đặc hiệu' đại diện, equivalence=wider.
• Bệnh chỉ có mã 'tác nhân gây bệnh' B95–B97 (Haemophilus, phế cầu, RSV, HPV, liên cầu lợn) → equivalence=relatedto (mã tác nhân bổ sung, không phải chẩn đoán chính).
• Sốt xuất huyết Dengue → A97 (WHO 2019 đã xóa A90/A91; khớp TT 06/2026/TT-BYT + QĐ 1978/QĐ-BYT).
• A15 (bệnh truyền nhiễm đặc biệt nguy hiểm mới phát sinh, chưa rõ tác nhân) KHÔNG ánh xạ — không có mã ICD-10 phù hợp (unmatched). Căn cứ:
• QĐ 1965/QĐ-BYT (01/7/2026) — danh mục bệnh truyền nhiễm nhóm A/B/C (nguồn).
• QĐ 4469/QĐ-BYT (28/10/2020) + TT 06/2026/TT-BYT — ICD-10 VN (đích). / ConceptMap bridging Vietnam notifiable communicable diseases (groups A/B/C, Decision 1965/QĐ-BYT) to ICD-10; A15 (novel unknown-agent disease) left unmatched by design.

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): 2964 chỉ số, 100% có mã LOINC, ánh xạ tới 1981 mã LOINC riêng biệt.

5 phụ lục nguồn: PL01 Huyết học–Truyền máu (1.022), PL02 Sinh hóa (447), PL03 Vi sinh (174), PL04 Giải phẫu bệnh (81), PL05 Chẩn đoán hình ảnh (1.240).

Equivalence: 1404 ánh xạ equivalent (LOINC chỉ được 1 CLS trỏ tới) + 1560 ánh xạ wider (nhiều CLS chi tiết theo TT 23/2024/TT-BYT cùng trỏ 1 mã LOINC — mã LOINC rộng hơn). Phân loại equivalence là heuristic, cần chuyên gia rà soát từng ca.

ConceptMap ánh xạ chính thức mã kỹ thuật Phụ lục 1 → Phụ lục 2 theo TT 23/2024/TT-BYT (9116 mã PL1 có ánh xạ, 12775 cặp). equivalence = relatedto vì một kỹ thuật Phụ lục 1 thường tương ứng nhiều kỹ thuật Phụ lục 2 chi tiết hơn. Nguồn: dmkt.kcb.vn.

ConceptMap ánh xạ danh mục mã giới tính QĐ 3176/QĐ-BYT (trường GIOI_TINH / GIOI_TINH_CON) sang bộ mã administrative-gender của FHIR R4. Chiều ánh xạ: mã trong nước 1/2/3 → mã FHIR male/female/unknown. Dùng khi chuyển đổi dữ liệu BHYT/HIS (logical model BHYT XML) sang VNCorePatient.gender. Lưu ý: FHIR có thêm mã other nhưng danh mục QĐ 3176/QĐ-BYT không có mã tương ứng nên không ánh xạ ngược.

ConceptMap cầu thuật ngữ chẩn đoán Việt Nam (ICD-10 VN) sang SNOMED CT quốc tế, phục vụ projection của operation $summary (Sổ SKĐT nội địa mã ICD-10 → IPS dùng SNOMED CT). 143 chẩn đoán phổ biến (bệnh mạn tính, lý do nhập viện, bệnh truyền nhiễm thường gặp); mở rộng dần theo nhu cầu liên thông.

Lưu ý phạm vi: đích là mã SNOMED CT International (http://snomed.info/sct) cho xuất khẩu IPS — KHÔNG phải subset SNOMED CT VN (subset VN không chứa concept bệnh/disorder). Mọi mã đích đã được đối chiếu FSN với trình duyệt SNOMED CT quốc tế; equivalence là gần đúng ở cấp khái niệm (một số mã ICD-10 3 ký tự rộng hơn khái niệm SNOMED cụ thể).

Căn cứ:

• QĐ 4469/QĐ-BYT (28/10/2020) — Bảng phân loại quốc tế bệnh tật ICD-10 VN (nguồn mã chẩn đoán).
• SNOMED CT International (đích ánh xạ cho IPS). / Expanded ICD-10 VN to international SNOMED CT bridge supporting the $summary IPS projection; 143 common diagnoses, SNOMED targets FSN-verified.

Ánh xạ identity đầy đủ 696 mã từ canonical retired vn-district-cs sang canonical retired vn-district-legacy-cs. Đây là pure rename: code, display và định nghĩa concept không đổi. Nguồn danh mục là Tổng cục Thống kê trước sắp xếp; không gán 696 mã huyện cho QĐ 19/2025/QĐ-TTg Phụ lục II. Chỉ canonical thay đổi để biểu đạt rõ giai đoạn trước 01/07/2025. English: Complete 696-code identity map from the retired vn-district-cs canonical to the retired vn-district-legacy-cs canonical. Codes and meanings are unchanged; only the canonical is renamed to identify the pre-01 July 2025 effective period.

Ánh xạ identity 15 mã từ canonical cũ vn-qd3176-cost-group-cs (tên mang số văn bản — vi phạm ADR-0017 Điều 1, retired ở 0.8.0) sang canonical mới vn-bhyt-claim-cost-group-cs. Pure rename: mã, display, định nghĩa giữ nguyên.

ĐÃ THAY THẾ (0.8.0, ADR-0017 Điều 15): dùng vn-cm-bhyt-claim-cost-group-to-cost-category. Giữ nguyên nội dung để tra cứu lịch sử.

4141 ánh xạ từ mã bệnh y học cổ truyền sang ICD-10, lấy nguyên cột ICD-10 của Phụ lục 07.1 QĐ 7603/QĐ-BYT và đã cập nhật theo QĐ 1978/QĐ-BYT.

4137/4142 mã có ánh xạ; phần còn lại là mã mà QĐ 1978/QĐ-BYT xác định KHÔNG sử dụng mã ICD-10. Một mã bệnh có thể ứng với nhiều mã ICD-10 (ví dụ U50.781 Trùng tích ứng với cả B70 và B70.0) — giữ đủ, không ép một-một.

Equivalence dùng relatedto cho toàn bộ: phụ lục gán mã ICD-10 để thống kê và thanh toán chứ không tuyên bố hai khái niệm đồng nghĩa.

KHÁC với vn-cm-yhct-disease-to-icd10: bản đó ánh xạ 228 bệnh danh và thể lâm sàng của QĐ 2552/QĐ-BYT; bản này ánh xạ danh mục mã bệnh dùng cho hồ sơ bảo hiểm y tế.

29 ánh xạ từ mã hoạt chất chế phẩm thuốc cổ truyền sang mã thuốc hóa dược, theo Phụ lục 2 QĐ 5937/QĐ-BYT — Danh mục mã thành phần chế phẩm thuốc đông y, thuốc từ dược liệu theo Thông tư số 05/2015/TT-BYT chuyển đổi, ánh xạ tạm thời sang mã thuốc hóa dược.

Văn bản tự gọi đây là ánh xạ TẠM THỜI, nên equivalence dùng relatedto cho toàn bộ. Phụ lục 2 QĐ 5937/QĐ-BYT liệt kê rộng hơn danh mục này (296 cặp mã thành phần theo CV 908/BYT-BH); bản ánh xạ ở đây chỉ giữ phần giao với mã có trong Phụ lục 06 QĐ 7603/QĐ-BYT. Hệ mã đích là CodeSystem metadata-only vn-chemical-drug-interim-cs — IG không công bố nội dung danh mục mã hóa dược tạm thời.

336 ánh xạ từ mã vị thuốc 05V của Phụ lục 06.3 QĐ 7603/QĐ-BYT sang mã dùng chung của Phụ lục V QĐ 3080/QĐ-BYT, phục vụ chuyển đổi dữ liệu lịch sử sang bộ mã hiện hành.

Equivalence dùng equivalent vì QĐ 3080/QĐ-BYT ghi đích danh mã 05V ở cột mã dược liệu của từng vị — đây là quan hệ đồng nhất do văn bản tuyên bố, không phải ánh xạ suy diễn.

13/349 mã không có ánh xạ vì QĐ 3080/QĐ-BYT chưa kế thừa; chúng mang property no-successor trong vn-yhct-herb-legacy-cs và phải được xử lý thủ công khi chuyển đổi dữ liệu.

ConceptMap ánh xạ nhóm chi phí hồ sơ BHYT (MA_NHOM XML2/XML3 — vn-bhyt-claim-cost-group-cs) sang nhóm chi phí bảng kê (vn-cost-category-cs, QĐ 697/QĐ-BYT). Dùng trong lớp export/import BHYT. Đổi tên 0.8.0 từ vn-cm-qd3176-cost-group-to-q697-cost-category (ADR-0017).

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ạ.

Ánh xạ ĐẦY ĐỦ 63 mã tỉnh/thành giai đoạn hiệu lực trước 01/07/2025 sang 34 mã sau sắp xếp theo NQ 202/2025/QH15. 11 đơn vị giữ nguyên: equivalent. 52 đơn vị thuộc 23 nhóm hợp nhất: wider (đơn vị mới rộng hơn đơn vị cũ — kể cả đơn vị giữ mã nhưng mở rộng địa giới, vd 79 TP.HCM). Bản 0.8.0 thay bản MẪU MINH HỌA 21/63 entry của ≤0.7.0 (thiếu 42 entry, equivalence ngược chiều, thiếu source/target version).

Ánh xạ 14 mã DOI_TUONG giai đoạn hiệu lực QĐ 1551/QĐ-BYT (31/5/2026, legacy) sang 16 mã giai đoạn hiệu lực QĐ 2062/QĐ-BYT (07/7/2026, hiện hành). Mã 1–13 giữ nguyên nghĩa (equivalent). Mã 14 cũ 'Các đối tượng khác' KHÔNG tương đương mã 14 mới: nghĩa cũ phủ rộng — tách thành 3 đích hẹp hơn (#narrower): 14 'Người lao động không chính thức', 15 'Người chưa có BHYT', 16 'Các đối tượng khác'. Dữ liệu cũ mang mã 14 mặc định ánh xạ sang 16; chỉ chuyển sang 14/15 mới khi xác minh lại được đối tượng thực tế.

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ệ thống định danh Giấy chứng nhận đủ điều kiện kinh doanh dược cấp cho cơ sở kinh doanh dược (nhà thuốc, quầy thuốc, cơ sở bán buôn, cơ sở sản xuất) — dùng để định danh CƠ SỞ trong chuỗi cung ứng thuốc, phân biệt với mã cơ sở khám bệnh, chữa bệnh do BHXH cấp. Định danh này là mắt xích để liên thông với Hệ thống cơ sở dữ liệu quốc gia về dược: một cơ sở kinh doanh dược có thể không có mã CSKCB, nên Organization.identifier[CSKCB] không dùng được cho nhóm này. Căn cứ:

• Luật 105/2016/QH13 Điều 33 và Điều 34 — điều kiện kinh doanh dược và thẩm quyền cấp Giấy chứng nhận (đọc hợp nhất theo VBHN 76/VBHN-VPQH)
• NĐ 163/2025/NĐ-CP — quy định chi tiết và biện pháp tổ chức thi hành Luật Dược
• TT 11/2025/TT-BYT — thực hành tốt cơ sở bán lẻ, bán buôn, bảo quản thuốc (GPP/GDP/GSP) và nghĩa vụ liên thông dữ liệu
• QĐ 1867/QĐ-BYT (24/06/2026) — kế hoạch triển khai hệ thống cơ sở dữ liệu về dược quốc gia, định danh cơ sở dược.

SCHEME DÙNG TẠM per-facility — 0.8.0 hạ cấp (hậu kiểm toán Codex): định danh này do TỪNG cơ sở tự quản lý nên khóa uniqueness là system+value; một URI quốc gia dùng chung KHÔNG bảo đảm uniqueness. Khuyến nghị chính: mỗi cơ sở tự công bố URI riêng; URI scheme này chỉ dùng khi chưa có URI riêng, khi đó assigner là bắt buộc nghiệp vụ (khuyến nghị bổ sung, không phải cơ chế uniqueness chính). 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.

SCHEME DÙNG TẠM cho mã bệnh nhân nội bộ (MRN) — 0.8.0 hạ cấp (hậu kiểm toán Codex): MRN do TỪNG cơ sở tự quản lý nên khóa uniqueness là system+value — một URI quốc gia dùng chung cho MRN mọi cơ sở KHÔNG bảo đảm uniqueness (2 bệnh viện có thể trùng value). Khuyến nghị chính: mỗi cơ sở TỰ CÔNG BỐ URI riêng (vd https://benhvien.example.vn/sid/mrn). URI scheme này chỉ dùng khi cơ sở chưa công bố URI riêng — khi đó assigner là BẮT BUỘC nghiệp vụ để phân biệt cơ sở (khuyến nghị bổ sung, không phải cơ chế uniqueness chính). Phân loại MRN trong profile dựa trên Identifier.type (vn-identifier-type-cs#MRN), không dựa system. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), Luật KCB 2023 (15/2023/QH15).

Hệ thống định danh cho Bundle chứng nhận sức khỏe rút gọn dùng trong QR/SMART Health Cards hoặc SMART Health Links. Dùng cho Bundle.identifier trong payload chứng nhận, không phải mã bệnh nhân hay mã hồ sơ KCB.

Hệ thống mã cơ sở khám chữa bệnh (5 chữ số): 2 ký tự đầu là mã tỉnh/TP, 3 ký tự sau là số thứ tự cơ sở trong tỉnh (mã 97 = cơ sở thuộc Bộ Quốc phòng, 98 = Bộ Công an). Cấp mã: Sở Y tế (địa phương) / Cục Quân y (BQP) / Cục Y tế (BCA) theo nguyên tắc tại QĐ 384/QĐ-BYT (30/01/2019); Cục Quản lý Khám, chữa bệnh — Bộ Y tế là đầu mối tổng hợp, công bố danh mục. Dùng để định danh cơ sở y tế trong giám định/thanh toán BHYT (Cổng tiếp nhận dữ liệu giám định BHXH) và liên thông Sổ SKĐT VNeID (QĐ 2733/QĐ-BYT Phụ lục 01 Điều 3). Đính chính 23/07/2026: trước ghi 'do BHXH Việt Nam cấp' — không đúng cơ quan cấp mã theo QĐ 384/QĐ-BYT. Căn cứ: QĐ 384/QĐ-BYT (30/01/2019, hiệu lực 01/02/2019 — lưu ý QĐ 2733/QĐ-BYT trích là 'ngày 01/02/2019'), Luật KCB 2023 (15/2023/QH15). Lưu ý giai đoạn: mã tỉnh 2 ký tự đặt theo danh mục hành chính trước 01/07/2025; sau sáp nhập 34 tỉnh CHƯA có văn bản cấp lại hệ mã (xác minh 23/07/2026) — nguyên tắc chuyển tiếp: cơ sở giữ mã cũ đến khi được cấp mã mới (TT 53/2025/TT-BYT sửa TT 43/2025/TT-BYT về Trạm Y tế xã; NĐ 188/2025/NĐ-CP Điều 69 khoản 8 điểm đ cho thẻ/thông tin tiếp tục sử dụng); theo dõi watch-list.

Hệ thống định danh cho instance Endpoint cấu hình cổng tiếp nhận hồ sơ giám định BHYT (gdbhyt.baohiemxahoi.gov.vn). Mỗi cơ sở KCB ký hợp đồng BHXH cấu hình một Endpoint với mã định danh nội bộ theo phân hệ HIS/EMR. Đây là identifier nội bộ cho Endpoint resource — KHÔNG phải URL của cổng (đó là Endpoint.address).

Hệ thống định danh cho Endpoint cấu hình dịch vụ G12 của Trung tâm Dữ liệu Quốc gia tiếp nhận dữ liệu khám bệnh từ BHXH. Endpoint.address giữ URL kỹ thuật thực tế.

Hệ thống định danh cho Endpoint cấu hình API đồng bộ dữ liệu khám sức khỏe định kỳ lên trục dữ liệu sức khỏe cá nhân của Bộ Y tế. Endpoint.address giữ URL kỹ thuật thực tế.

Hệ thống định danh cho Bundle tài liệu International Patient Summary (IPS) được sinh từ Sổ Sức khỏe điện tử nội địa để trao đổi quốc tế.

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 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 theo TT 12/2026/TT-BTC (biểu mẫu 06/BH). Mỗi PaymentReconciliation instance có một mã định danh nội bộ (vd: PR-BHYT-2026-03-001) phân biệt các kỳ quyết toán theo tháng/quý. Căn cứ: TT 12/2026/TT-BTC; NĐ 188/2025/NĐ-CP.

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 theo NĐ 164/2025/NĐ-CP. QUAN HỆ VỚI sid/bhyt: mã số BHYT 10 chữ số TRÙNG GIÁ TRỊ mã số BHXH — chọn namespace theo NGỮ CẢNH NGHIỆP VỤ: sổ/quá trình BHXH dùng sid/bhxh; số thẻ/quyền lợi BHYT (Coverage, Patient.identifier[BHYT]) dùng sid/bhyt (xem vn-bhyt-ns). Cùng giá trị xuất hiện ở cả hai namespace là HỢP LỆ và không phải trùng lặp dữ liệu. 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.

Hệ thống định danh cho Bundle hoặc tài liệu đại diện Sổ Sức khỏe điện tử nội địa của công dân, dùng trong luồng hiển thị trên VNeID theo QĐ 1332/QĐ-BYT.

Hệ thống định danh cho mã giao dịch thanh toán do BHXH Việt Nam cấp khi quyết toán chi phí KCB BHYT cho cơ sở y tế. Mã này được trả về trong PaymentReconciliation.paymentIdentifier sau khi BHXH duyệt và chuyển khoản. Căn cứ: TT 12/2026/TT-BTC Điều 7 (thanh toán chi phí KCB BHYT điện tử); NĐ 164/2025/NĐ-CP (giao dịch điện tử BHXH).

SCHEME DÙNG TẠM per-facility — 0.8.0 hạ cấp (hậu kiểm toán Codex): định danh này do TỪNG cơ sở tự quản lý nên khóa uniqueness là system+value; một URI quốc gia dùng chung KHÔNG bảo đảm uniqueness. Khuyến nghị chính: mỗi cơ sở tự công bố URI riêng; URI scheme này chỉ dùng khi chưa có URI riêng, khi đó assigner là bắt buộc nghiệp vụ (khuyến nghị bổ sung, không phải cơ chế uniqueness chính). 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 Mã đơn thuốc điện tử do Hệ thống đơn thuốc quốc gia (donthuocquocgia.vn) sinh tự động — 14 ký tự, từ mã cơ sở KCB + mã đơn + loại đơn. Cơ sở bán lẻ thuốc bán theo mã đơn và báo cáo về donthuocquocgia.vn. Căn cứ:

• TT 26/2025/TT-BYT — kê đơn thuốc hóa dược, sinh phẩm ngoại trú; Điều 12 (liên thông đơn thuốc quốc gia, lĩnh thuốc trong 05 ngày kể từ ngày kê), Phụ lục I (cấu trúc mã đơn thuốc điện tử 14 ký tự); bãi bỏ TT 27/2021/TT-BYT từ 01/07/2025
• QĐ 808/QĐ-BYT (01/4/2022) — hướng dẫn kết nối Hệ thống đơn thuốc quốc gia; cấu trúc mã đơn 14 ký tự
• QĐ 425/QĐ-BYT (05/02/2025) — Quy chế quản lý, vận hành, sử dụng Hệ thống thông tin Quốc gia về quản lý kê đơn thuốc và bán thuốc theo đơn.

Hệ thống mã định danh cơ sở khám bệnh, chữa bệnh — 13 ký tự, do cơ quan có thẩm quyền cấp khi đăng ký trên Hệ thống Quản lý Quốc gia về hành nghề và hoạt động khám bệnh, chữa bệnh (qlhanhnghekcb.gov.vn). Trường nguồn: MA_GTIN_CSKCB. QĐ 1551/QĐ-BYT mô tả mã 'theo chuẩn GLN'. LƯU Ý: chưa xác minh đây là GS1 GLN đăng ký toàn cầu (có issuer + check digit GS1) hay mã 13 chữ số do BYT cấp theo cấu trúc GLN. NamingSystem này giữ trung lập — chỉ ràng buộc độ dài 13 ký tự số; không khẳng định là GTIN hàng hóa. Khác với Mã CSKCB 5 chữ số do BHXH cấp ($vn-sid-cskcb) — đây là định danh quốc gia của cơ sở, dùng cho liên thông dữ liệu khám sức khỏe + Sổ SKĐT. Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026); Luật KCB 2023 (15/2023/QH15).

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.

SCHEME DÙNG TẠM per-facility — 0.8.0 hạ cấp (hậu kiểm toán Codex): định danh này do TỪNG cơ sở tự quản lý nên khóa uniqueness là system+value; một URI quốc gia dùng chung KHÔNG bảo đảm uniqueness. Khuyến nghị chính: mỗi cơ sở tự công bố URI riêng; URI scheme này chỉ dùng khi chưa có URI riêng, khi đó assigner là bắt buộc nghiệp vụ (khuyến nghị bổ sung, không phải cơ chế uniqueness chính). 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) theo Luật Căn cước 2023. CMND HẾT GIÁ TRỊ SỬ DỤNG sau ngày 31/12/2024 theo Luật Căn cước 2023 Điều 46 khoản 2 — identifier này chỉ dùng để khớp nối dữ liệu lịch sử (giấy tờ pháp lý đã phát hành có thông tin CMND vẫn giữ nguyên giá trị theo Điều 46 khoản 3), KHÔNG dùng cho định danh mới. 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. Căn cứ khai sinh hệ định danh: Luật Hộ tịch 60/2014/QH13 (Điều 14 — số định danh cá nhân gắn vào giấy khai sinh) — đã nạp vào sổ đăng ký văn bản 30/07/2026.

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ố. Căn cứ khai sinh hệ định danh: Luật Xuất cảnh, nhập cảnh của công dân Việt Nam 49/2019/QH14 — đã nạp vào sổ đăng ký văn bản 30/07/2026.

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 cho từng thiết bị cụ thể 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/NĐ-CP 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 MÃ SỐ Bảo hiểm Y tế, do BHXH Việt Nam cấp. Namespace này nhận đúng 2 format THẺ (0.8.0 — hậu kiểm toán Codex, thu hẹp từ 3):

• Mã số BHYT 10 chữ số (hiện hành, từ 01/4/2021) — TRÙNG GIÁ TRỊ với mã số BHXH
• Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021 (legacy) CCCD/số định danh cá nhân KHÔNG thuộc namespace này: NĐ 188/2025/NĐ-CP (Mẫu số 3) tách cột 'Mã số BHYT' và 'Số CCCD' riêng — CCCD chỉ là KHÓA TRA CỨU/XUẤT TRÌNH thay thẻ khi KCB, biểu diễn bằng Patient.identifier[CCCD] (sid/cccd); trộn CCCD vào sid/bhyt gây nguy cơ matching sai giữa hai trục định danh. QUAN HỆ VỚI sid/bhxh: giá trị 10 chữ số của mã số BHYT trùng mã số BHXH — hai namespace tồn tại song song theo NGỮ CẢNH NGHIỆP VỤ: số thẻ/quyền lợi BHYT (Coverage) dùng sid/bhyt; sổ/quá trình tham gia BHXH dùng sid/bhxh (xem vn-bhxh-ns). Không suy diễn tự động hai chiều khi chưa xác minh qua Cổng BHXH (NĐ 164/2025/NĐ-CP). 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; Mẫu số 3 tách cột Mã số BHYT / Số CCCD
• NĐ 164/2025/NĐ-CP — 29/6/2025 — giao dịch điện tử BHXH, tra cứu thẻ 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 số đăng ký lưu hành (giấy phép lưu hành, GPLH) của thuốc và nguyên liệu làm thuốc tại Việt Nam — tầng 1 trong mô hình định danh thuốc của VN Core (analysis/62 #3). Hai định dạng cùng tồn tại:

• Định dạng hiện hành: 12 chữ số theo TT 12/2025/TT-BYT.
• Định dạng legacy: dạng chữ-số như VD-12345-15, VN-12345-16, QLĐB-123-45 — tiếp tục có giá trị theo quy tắc chuyển tiếp của TT 12/2025/TT-BYT cho tới khi được cấp lại. Số đăng ký là ĐỊNH DANH của một sản phẩm được cấp phép, không phải mã phân loại: dùng ở Medication.identifier, KHÔNG dùng làm Medication.code. Căn cứ:
• TT 12/2025/TT-BYT (ban hành 16/05/2025, hiệu lực 01/07/2025) — đăng ký lưu hành thuốc, nguyên liệu làm thuốc; cấu trúc số đăng ký 12 chữ số và quy tắc chuyển tiếp số cũ
• Luật 105/2016/QH13 — Luật Dược (đọc hợp nhất theo VBHN 76/VBHN-VPQH)
• QĐ 3176/QĐ-BYT — trường SO_DANG_KY trong dữ liệu đầu ra KCB; QĐ 1931/QĐ-BYT bổ sung quy ước UBND.YYYY.X.S cho thuốc hiếm được UBND cấp tỉnh cấp phép nhập khẩu.

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.

Hệ thống định danh VN Core cho biên bản quyết toán, thanh toán chi phí khám bệnh, chữa bệnh BHYT theo quý. Giá trị định danh phải duy nhất trong phạm vi thỏa thuận trao đổi hoặc cơ quan cấp mã; NamingSystem này không khẳng định mã có tính duy nhất trên toàn quốc. / VN Core identifier system for quarterly BHYT healthcare-cost settlement and payment reports. Identifier values SHALL be unique within the applicable exchange agreement or assigning authority; this NamingSystem does not assert nationwide uniqueness.

Hệ thống định danh VN Core cho hợp đồng khám bệnh, chữa bệnh BHYT giữa cơ quan BHXH và cơ sở KCB. Giá trị định danh phải duy nhất trong phạm vi thỏa thuận giữa các bên hoặc cơ quan cấp mã; NamingSystem này không khẳng định mã hợp đồng có tính duy nhất trên toàn quốc. / VN Core identifier system for BHYT healthcare contracts between a social-insurance authority and a healthcare provider. Identifier values SHALL be unique within the parties' agreement or assigning authority; this NamingSystem does not assert nationwide contract-number uniqueness.

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. THỜI HẠN GỬI DỮ LIỆU (TT 48/2017/TT-BYT): dữ liệu KCB gửi NGAY sau khi kết thúc lần khám/đợt điều trị (Điều 6); dữ liệu đề nghị thanh toán trong 07 ngày làm việc, dữ liệu cuối tháng/quý/năm trước ngày 05 tháng kế tiếp (Điều 7; TT 12/2026/TT-BTC Điều 9.1 dẫn chiếu). Mốc 24 giờ hiển thị VNeID là SLA downstream của BHXH (QĐ 2733/QĐ-BYT), không phải thời hạn gửi của CSKCB.

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. THỜI HẠN GỬI DỮ LIỆU (TT 48/2017/TT-BYT): dữ liệu KCB gửi NGAY sau khi kết thúc lần khám/đợt điều trị (Điều 6); dữ liệu đề nghị thanh toán trong 07 ngày làm việc, dữ liệu cuối tháng/quý/năm trước ngày 05 tháng kế tiếp (Điều 7; TT 12/2026/TT-BTC Điều 9.1 dẫn chiếu). Mốc 24 giờ hiển thị VNeID là SLA downstream của BHXH (QĐ 2733/QĐ-BYT), không phải thời hạn gửi của CSKCB.

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.

Operation $summary trả về một IPS document Bundle cho một người bệnh từ dữ liệu mà máy chủ có quyền sử dụng, có thể bao gồm resource VN Core hoặc dữ liệu đã đồng bộ cho Sổ SKĐT. Đây là phép chuyển chiếu có kiểm soát sang profile IPS, không phải phép đổi mã tự động: mỗi mapping thuật ngữ và quy tắc chọn dữ liệu phải được version hóa, kiểm thử và công bố. OperationDefinition cục bộ này giữ code, hai URL và parameter contract của HL7 IPS $summary; canonical VN Core cho phép công bố thêm yêu cầu của triển khai Việt Nam.

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ợ 2 format: mã số BHYT hiện hành 10 chữ số (trùng giá trị mã số BHXH của cùng bệnh nhân), hoặc số thẻ legacy 15 ký tự (2 chữ hoa + 13 chữ số). CCCD 12 chữ số chỉ là khóa tra cứu/xuất trình, không thuộc namespace sid/bhyt. Ví dụ: GET [base]/Patient?vn-bhyt=1099012345

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Đ-CP, NĐ 04/2025/NĐ-CP), TT 05/2022/TT-BYT (đã sửa TT 59/2025/TT-BYT). 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Đ-CP, NĐ 04/2025/NĐ-CP) — đă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. Đây là identifier convention của VN Core cho lượt KCB (cộng đồng định nghĩa); khi trao đổi BHYT giữ tương thích với khóa liên kết MA_LK của QĐ 3176/QĐ-BYT — mã lượt KCB này không phải trường do văn bản quy định. 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 legacy; tên kỹ thuật vn-malydo được giữ để tương thích VN Core. Danh mục legacy theo trường MA_LYDO_VVIEN — QĐ 4210/QĐ-BYT (2017): mã 1–4; mã 5 là mở rộng dự án, không có trong QĐ 4210/QĐ-BYT và đang chờ nguồn. Chuẩn hiện hành QĐ 3176/QĐ-BYT dùng MA_DOI_TUONG_KCB với danh mục 27 mã theo QĐ 3276/QĐ-BYT (xem VNPatientVisitTypeCS). 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ợ 2 format: mã số BHYT hiện hành 10 chữ số (trùng giá trị mã số BHXH của cùng bệnh nhân), hoặc số thẻ legacy 15 ký tự (2 chữ hoa + 13 chữ số). CCCD 12 chữ số chỉ là khóa tra cứu/xuất trình, không thuộc namespace sid/bhyt. 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|0791234567

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ỏ.

Người đại diện xác nhận bệnh nhi 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à người đại diệ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.

Negative fixture: Cổng giám định BHYT phản hồi thẻ KHÔNG còn hiệu lực tại thời điểm tra cứu (inforce = false). Cơ sở KCB phải xử lý như ca không được hưởng BHYT (thu phí dịch vụ hoặc yêu cầu cập nhật thẻ), KHÔNG coi đây là lỗi hệ thống. Cặp với ExampleCoverageEligibilityRequest.

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ụ kỹ thuật minh họa một Endpoint FHIR trong hợp đồng trao đổi hồ sơ BHYT. URL, header, payload và phương thức xác thực bên dưới là dữ liệu giả lập; không phải API do BHXH Việt Nam công bố và không được dùng cho môi trường thật. TT 12/2026/TT-BTC Điều 2 xác định cổng tiếp nhận công khai, nhưng không quy định FHIR API contract được minh họa ở đây.

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. Theo 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 viêm phổi tại BV Chợ Rẫy. Theo 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. Theo TT 13/2025/TT-BYT, QĐ 2552/QĐ-BYT (YHCT Đợt 1).

Cổng giám định BHYT phản hồi yêu cầu tra cứu: thẻ BHYT của bệnh nhân Nguyễn Văn An còn hiệu lực tại thời điểm tra cứu (inforce = true). Cặp với ExampleCoverageEligibilityRequest.

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.

Cơ sở KCB (BV Chợ Rẫy) gửi yêu cầu kiểm tra hiệu lực thẻ BHYT của bệnh nhân Nguyễn Văn An tới Cổng giám định BHYT (cơ quan BHXH) tại khâu tiếp đón, theo NĐ 164/2025/NĐ-CP.

Đơ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. Theo TT 13/2025/TT-BYT, Luật Dược 2016.

Bệnh nhân Nguyễn Văn An đồng ý cho BV Chợ Rẫy 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. Theo 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 theo 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. Convention tích hợp hiện có: HTCHUYEN=2 (chuyển lên); VNInsuranceVisitTypeCS#5 là mã mở rộng dự án chờ nguồn cho KCB ban đầu tại trạm y tế.

Bundle type=collection làm payload chứng nhận phân loại sức khỏe (đủ điều kiện) cho QR — đóng gói theo SMART Health Cards/Links. Tối thiểu hoá dữ liệu; không nhúng toàn bộ Sổ SKĐ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/NĐ-CP.

Bundle hồ sơ thanh toán BHYT minh họa giấy chuyển tuyến/chuyển cơ sở KBCB (Bảng 13 QĐ 3176/QĐ-BYT): ServiceRequest mang extension referralMode (HTCHUYEN), số hồ sơ/số giấy chuyển tuyến, mã lý do chuyển (MA_LYDO_CT) và Encounter có MA_LOAI_RV = 2.

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; kèm giấy hẹn khám lại (Bảng 14 QĐ 3176/QĐ-BYT) qua ServiceRequest.occurrenceDateTime.

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 hồ sơ thanh toán BHYT minh họa quản lý điều trị bệnh lao (Bảng 15 QĐ 3176/QĐ-BYT): EpisodeOfCare (loại điều trị lao), CarePlan (phác đồ), MedicationStatement ARV/CTX cho đồng nhiễm lao/HIV. Dữ liệu lao/HIV cần kiểm soát bảo mật phù hợp; căn cứ xử lý, authorization, nhãn bảo mật và sự kiện audit phải theo policy/hợp đồng áp dụng. Consent, SecurityLabel và AuditEvent chỉ được tạo khi semantics của directive, label hoặc event tương ứng thực sự tồn tại.

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. Convention VN Core legacy: insuranceVisitType #5 là mã mở rộng dự án chờ nguồn; mapping hiện hành: MA_DOITUONG_KCB=1.1 và 3 nhóm chi phí theo QĐ 697/QĐ-BYT.

Transaction Bundle nộp atomic chuỗi kê đơn → cấp phát thuốc BHYT theo quyết định kiến trúc VN Core. Ca tăng huyết áp Amlodipine 5mg của Nguyễn Văn An: Patient, Coverage, Encounter, MedicationRequest (y lệnh), MedicationDispense (cấp phát, authorizingPrescription trỏ về y lệnh) — nộp bằng PUT update-as-create. Căn cứ: TT 26/2025/TT-BYT (kê đơn/liên thông đơn thuốc quốc gia); QĐ 3176/QĐ-BYT; NĐ 164/2025/NĐ-CP.

Transaction Bundle nộp atomic 1 lượt cấp cứu theo quyết định kiến trúc VN Core (1 lượt khám = 1 transaction Bundle). Ca tai nạn giao thông gãy cổ xương đùi S72.0 của Nguyễn Văn An: Patient, Coverage, Encounter (EMER), Condition — nộp bằng PUT update-as-create. Cấp cứu hưởng BHYT như đúng tuyến theo Luật BHYT Điều 22; NĐ 188/2025/NĐ-CP. Căn cứ thêm: TT 13/2025/TT-BYT; QĐ 3176/QĐ-BYT.

Transaction Bundle nộp atomic 1 lượt khám ngoại trú BHYT theo quyết định kiến trúc VN Core (1 lượt khám = 1 transaction Bundle). Tái dùng ca viêm phổi J18.9 của Nguyễn Văn An: Patient, Coverage, Encounter (AMB), Condition, ServiceRequest, Specimen, Observation (Lab), MedicationRequest — nộp bằng PUT update-as-create. Căn cứ: TT 13/2025/TT-BYT; NĐ 164/2025/NĐ-CP.

Transaction Bundle nộp atomic toàn bộ 1 đợt nội trú lên FHIR server theo quyết định kiến trúc VN Core (1 lượt khám = 1 transaction Bundle). Tái dùng ca viêm ruột thừa cấp K35.8 của Nguyễn Văn An: dữ liệu chủ (Patient, Coverage, Practitioner, Organization) nộp bằng PUT update-as-create (idempotent khi nộp lại); resource lâm sàng (Encounter, Condition, Procedure, Specimen, DiagnosticReport, MedicationDispense, Composition) và hồ sơ thanh toán (Claim) nộp bằng PUT theo id do HIS gán. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), NĐ 164/2025/NĐ-CP (giao dịch điện tử BHXH).

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 theo 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Đ-BYT + 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: mã loại KCB legacy #5 là mở rộng dự án chờ nguồn; chuẩn hiện hành dùng MA_DOI_TUONG_KCB=1.1 và ICD-10=M54.5 theo 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ý. Theo 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.

Nhà thuốc Bệnh viện Chợ Rẫy bán 21 viên Amoxicillin 500mg cho bệnh nhân Nguyễn Văn An theo đơn thuốc điện tử (mã đơn quốc gia trên authorizingPrescription.identifier). Tương ứng payload POST /transactions/stock-out của Hệ thống CSDL về dược (QĐ 232/QĐ-TTYQG, v1.1): reason=sale-retail, items[0] = {drug_id theo số GPLH, gtin, quantity=21, unit=viên}. Từ v0.9.0 gap này đã đóng: medication[x] cho phép Reference(VNCoreMedication) nên số lô và hạn dùng (batch_no/expiry_date của payload) mang được ngay trong resource qua Medication.batch.

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 theo 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ả. Theo 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.

Bản ghi Patient đã khử nhận dạng để đưa vào tập dữ liệu nghiên cứu hoặc huấn luyện mô hình. Đã xóa: số định danh cá nhân (CCCD), mã số bảo hiểm xã hội, số thẻ bảo hiểm y tế, họ tên, số điện thoại, địa chỉ cấp phường/xã và ngày sinh đầy đủ. Đã giữ: năm sinh, giới tính, tỉnh cư trú trong 34 đơn vị hành chính, và một mã nghiên cứu không liên kết ngược được với bản ghi gốc. Nhãn meta.security công bố hai điều: mức mật là không hạn chế (U) và dữ liệu đã qua khử nhận dạng (ANONYED). Theo Luật 91/2025/QH15 Điều 2 khoản 1, dữ liệu ở trạng thái này không còn là dữ liệu cá nhân — với điều kiện khóa ánh xạ đã bị hủy. Nếu khóa còn tồn tại thì bản ghi là dữ liệu GIẢ DANH, phải gắn PSEUDED thay cho ANONYED và mọi nghĩa vụ bảo vệ dữ liệu cá nhân vẫn áp dụng.

Ví dụ hư cấu về một đợt KCB dùng cùng một thẻ BHYT nhưng có hai giai đoạn hưởng: 80% từ ngày 01–04/03/2026 và 100% từ ngày 05–07/03/2026. Bốn dòng chi phí liên kết tường minh với giai đoạn tương ứng; tổng 2.000.000 VND được phân bổ thành quỹ BHYT 1.800.000 VND, người bệnh cùng trả 100.000 VND, nguồn khác 50.000 VND và người bệnh tự trả 50.000 VND. English summary: Fictional single-encounter claim using the same BHYT coverage across two benefit stages, changing from 80% to 100% during the encounter. Four cost lines explicitly reference their applicable stage. The 2,000,000 VND total is allocated as 1,800,000 VND from the BHYT fund, 100,000 VND patient copay, 50,000 VND from another source, and 50,000 VND patient self-pay.

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. Đây là cơ quan chi trả, không phải cơ sở KCB; mã đơn vị bên dưới là dữ liệu minh họa và không phải mã CSKCB. English summary: Example of Viet Nam Social Security as the national social-insurance payer. It is a payer, not a healthcare provider; the organization-unit identifier below is fictional and is not a healthcare-facility code.

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, mã số BHYT hiện hành, 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. Theo 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ử theo 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.

Điều dưỡng cho người bệnh nội trú (Nguyễn Văn An) dùng liều Cefotaxime 1g tiêm tĩnh mạch đầu tiên hậu phẫu. Khép chuỗi y lệnh (ExampleMedicationRequestCefotaximeInpatient) → cấp phát (ExampleMedicationDispenseInpatientAntibiotic) → sử dụng trong bệnh án điện tử nội trú theo TT 13/2025/TT-BYT.

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 gãy cổ xương đùi trái do tai nạn giao thông, ghi nhận tại khoa Cấp cứu (lượt ExampleEncounterEmergency). ICD-10 VN S72.0 theo QĐ 4469/QĐ-BYT.

Chẩn đoán nhồi máu cơ tim cấp ST chênh lên (STEMI) thành trước, ghi nhận tại lượt nội trú tim mạch can thiệp (ExampleEncounterCardiacInpatient). ICD-10 VN I21.0 theo QĐ 4469/QĐ-BYT (28/10/2020).

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.

Định nghĩa chỉ tiêu tự đánh giá tiêu chuẩn chất lượng cơ bản đối với bệnh viện theo TT 35/2024/TT-BYT (ban hành 16/11/2024, hiệu lực 01/01/2025), gồm năm nhóm tiêu chuẩn tại Phụ lục: cơ sở vật chất, quy mô và cơ cấu tổ chức, nhân sự, thiết bị y tế, chuyên môn. Cách tính: đếm số tiêu chuẩn được đánh giá Có trên tổng số tiêu chuẩn áp dụng. Kết luận xếp loại là NHỊ PHÂN theo Điều 1 khoản 3 điểm c — chỉ đạt khi toàn bộ tiêu chuẩn đều Có; tỷ lệ phần trăm không có giá trị pháp lý. Phạm vi áp dụng theo Điều 1 khoản 2: chỉ cơ sở được cấp giấy phép hoạt động theo hình thức tổ chức là bệnh viện.

Ví dụ Consent biểu diễn sự đồng ý của người dân cho phép cơ sở KCB chia sẻ dữ liệu khám sức khỏe định kỳ lên Cơ sở dữ liệu sức khỏe cá nhân và hiển thị trên Sổ SKĐT trên VNeID. Theo QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 04/05 (thay QĐ 1551/QĐ-BYT) + Luật 91/2025/QH15 (Bảo vệ DLCN — dữ liệu y tế nhạy cảm).

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 theo 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.

Cuộc hẹn tái khám từ xa cho bệnh nhân Nguyễn Văn An, tăng huyết áp I10, với BS CKII Nguyễn Thị Lan lúc 09:00-09:30 ngày 22/04/2026. Đặt ngày 15/04/2026, giữ khung giờ ExampleSlotTelehealthBooked. status = fulfilled vì buổi khám đã diễn ra; lượt khám tương ứng là ExampleEncounterTelehealth. Phạm vi hưởng bảo hiểm y tế: buổi hẹn này diễn ra ngày 22/04/2026, TRƯỚC mốc 01/07/2026 khi Luật 114/2025/QH15 Điều 44 khoản 1 đưa khám bệnh, chữa bệnh từ xa vào phạm vi hưởng — người bệnh tự chi trả theo đề án thí điểm của cơ sở.

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.

Ví dụ Organization minh họa cơ sở khám bệnh, chữa bệnh tổ chức khám sức khỏe định kỳ, mang đồng thời hai định danh: mã CSKCB 5 chữ số (BHXH cấp) và mã định danh 13 ký tự (MA_GTIN_CSKCB) cấp qua Hệ thống Quản lý Quốc gia về hành nghề KCB. Theo QĐ 1551/QĐ-BYT (31/5/2026).

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 theo Đ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ú.

Bundle type=document đóng gói giấy khám sức khỏe định kỳ cho người đủ 18 tuổi trở lên: Composition KSK (entry đầu) + Patient + Practitioner + cơ sở KCB (mã 13 ký tự) + sinh hiệu + phân loại sức khỏe. Sử dụng mẫu và quy trình liên thông hiện hành theo QĐ 2062/QĐ-BYT (sửa đổi, bổ sung QĐ 1551/QĐ-BYT).

Bundle type=document đóng gói Sổ Sức khỏe điện tử (Patient Summary kiểu IPS) cho hiển thị trên VNeID: Composition Sổ SKĐT (entry đầu) + Patient + dị ứng + bệnh + thuốc + tiêm chủng + xét nghiệm + thủ thuật + sinh hiệu. Theo QĐ 1332/QĐ-BYT.

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.

Ví dụ HealthcareService cho dịch vụ KCB ban đầu + chăm sóc ban đầu của Trạm Y tế xã, theo VBHN 06/2026/VBHN-BYT Điều 3-4 (5 nhóm dịch vụ TYT cấp xã).

Ví dụ Endpoint biểu diễn API của Trung tâm Dữ liệu Quốc gia (NDOP/CP.NET) tiếp nhận dữ liệu khám bệnh từ BHXH Việt Nam. RESTful + API Key; XML đã ký số (Ban Cơ yếu) + base64; POST /api/integrate/v1/G12, header X-Service=G12. Theo QĐ 2062/QĐ-BYT Phụ lục 03 (Phương án đồng bộ dữ liệu từ BHXH Việt Nam — thay Phụ lục 03 QĐ 1551/QĐ-BYT; đọc hợp nhất). KHÁC cổng giám định BHYT (gdbhyt) và luồng XML 4210 thanh toán.

Ví dụ Endpoint biểu diễn API đồng bộ dữ liệu khám sức khỏe định kỳ lên Cơ sở dữ liệu sức khỏe cá nhân của Bộ Y tế. REST/JSON envelope riêng (KHÔNG phải FHIR REST) + OAuth2 Bearer; POST /api/platform/data-sync/push (service-type=100, msg_type=101 request/102 response, txn_type=sync_checkup). Theo QĐ 2062/QĐ-BYT Phụ lục 02 (thay Phụ lục 02 QĐ 1551/QĐ-BYT; đọc hợp nhất). KHÁC cổng giám định BHYT (gdbhyt).

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 theo 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 hư cấu tương ứng với ExampleClaimItemizedMultiStage. Hai giai đoạn hưởng và bốn dòng chi phí giữ nguyên khóa liên kết; adjudication từng dòng phản chiếu chính xác bốn nguồn tiền của Claim. Tổng đủ điều kiện là 1.900.000 VND; quỹ BHYT thanh toán 1.800.000 VND, người bệnh cùng trả 100.000 VND, nguồn khác 50.000 VND và người bệnh tự trả 50.000 VND. English summary: Fictional EOB corresponding to ExampleClaimItemizedMultiStage. It preserves both benefit-stage keys and all four line items, with line-level adjudication exactly mirroring the Claim allocation ledger. The eligible total is 1,900,000 VND; the full 2,000,000 VND ledger consists of a 1,800,000 VND BHYT-fund payment, 100,000 VND patient copay, 50,000 VND from another source, and 50,000 VND patient self-pay.

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.820.000, đủ điều kiện 11.600.000, cùng chi trả 2.320.000, BHYT thanh toán 9.280.000, người bệnh tự trả 2.220.000 (450.000 vật tư y tế + 1.770.000 Parecoxib ngoài phạm vi BHYT); 1.000.000 bị giám định trừ ở dòng phẫu thuật. Sáu dòng chi phí khớp 1-1 với ExampleClaimBHYT và ExampleClaimResponseBHYT; mọi total cộng đúng từ các item. 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. Theo 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 theo 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/3/2026 trước khi phẫu thuật. Người thân ký tên đồng ý (vợ bệnh nhân). Theo Luật KCB 2023 Điều 15: quyền được thông tin và đồng ý điều trị. Theo 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). Theo 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). Theo QĐ 3176/QĐ-BYT (trường HTCHUYEN), Luật KCB 2023 (chuyển người bệnh).

Ví dụ tài liệu khám sức khỏe định kỳ (Sổ SKĐT) cho người đủ 18 tuổi trở lên: mã đợt khám (MA_LK), cơ sở thực hiện mang mã 13 ký tự, phần khám thể lực tham chiếu sinh hiệu, kết luận kèm phân loại sức khỏe và chữ ký số người kết luận. Sử dụng mẫu hiện hành theo QĐ 2062/QĐ-BYT (sửa đổi, bổ sung QĐ 1551/QĐ-BYT).

Bản IPS document Bundle ĐẦY ĐỦ, hợp lệ (type=document) cho Nguyễn Văn An — kết quả của operation $summary (projection Sổ SKĐT nội địa → IPS). entry[0] là VNCoreCompositionIPS, kèm Patient, Organization và các resource lâm sàng (dị ứng trứng, tăng huyết áp, Amlodipine) mà Composition tham chiếu, dùng mã SNOMED CT/ICD-10. Minh hoạ end-to-end kiến trúc dual-profile (ADR-0016).

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.

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ó — mô hình 0.8.0: mã khoa BYT ở type[deptClass] (QĐ 1804/QĐ-BYT Phụ lục 02).

Khoa Nội Tim mạch (K04) trực thuộc Bệnh viện Bạch Mai. Minh họa OrganizationDepartment theo mô hình 0.8.0: mã khoa BYT nằm ở type[deptClass] (QĐ 1804/QĐ-BYT Phụ lục 02); identifier chỉ còn mã cục bộ.

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ã.

Khung giờ 09:30-10:00 ngày 22/04/2026 trên lịch khám từ xa chuyên khoa Tim mạch, trạng thái free — còn nhận đặt. Đây là hình thái dữ liệu mà cổng đặt lịch công khai truy vấn để hiển thị lịch trống; không cần và không được kèm dữ liệu người bệnh.

Khung giờ 09:00-09:30 ngày 22/04/2026 trên lịch khám từ xa chuyên khoa Tim mạch, trạng thái busy vì đã có người bệnh đặt (xem ExampleAppointmentTelehealthFollowUp). Bản thân khung giờ không mang thông tin định danh hay tình trạng sức khỏe của người bệnh — đây là ranh giới giữ cho lịch trống công bố được ra ngoài mà không vi phạm nghĩa vụ bảo vệ dữ liệu cá nhân nhạy cảm theo Luật 91/2025/QH15.

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. Phạm vi hưởng BHYT: từ 01/07/2026, Luật 114/2025/QH15 Điều 44 khoản 1 bổ sung khám bệnh, chữa bệnh TỪ XA và hỗ trợ khám bệnh, chữa bệnh từ xa vào điểm a khoản 1 Điều 21 Luật BHYT (đọc theo VBHN 40/VBHN-VPQH). Mức hưởng và quy trình thanh toán cụ thể chờ hướng dẫn của Chính phủ; danh mục mã đối tượng đến KCB (QĐ 3276/QĐ-BYT) cũng chưa có mã riêng cho loại hình này.

Kế hoạch quản lý tăng huyết áp cho Nguyễn Văn An: duy trì Amlodipine, theo dõi huyết áp, tái khám định kỳ, tư vấn chế độ ăn giảm muối. Lập tại lượt khám ngoại trú ExampleEncounterOutpatient.

BHXH giám định ExampleClaimOutpatient (ngoại trú, 3 dòng, đề nghị 4.200.000đ): phê duyệt toàn bộ Khám và Xét nghiệm; dòng thuốc gộp (itemSequence 3) bị trừ 800.000đ do 1 biệt dược ngoài danh mục BHYT — bệnh nhân tự chi trả phần này. Minh họa quan hệ đề nghị (ex-ante, costSummary của Claim) và kết quả giám định (ex-post, adjudication của ClaimResponse). Theo NĐ 188/2025/NĐ-CP, danh mục thuốc BHYT hiện hành.

Kết quả giám định hoàn tất cho ExampleClaimItemizedMultiStage. Cả bốn item sequence được adjudicate; tổng đề nghị là 2.000.000 VND, tổng đủ điều kiện 1.900.000 VND, người bệnh cùng chi trả 100.000 VND và quỹ BHYT thanh toán 1.800.000 VND. English summary: Complete adjudication response for ExampleClaimItemizedMultiStage. All four item sequences are adjudicated; submitted is 2,000,000 VND, eligible is 1,900,000 VND, patient copay is 100,000 VND, and the BHYT fund benefit is 1,800,000 VND.

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.820.000 (đủ 6 dòng của ExampleClaimBHYT), đủ ĐK 11.600.000 — giám định trừ 1.000.000 ở dòng phẫu thuật, vật tư 450.000 và Parecoxib 1.770.000 không thuộc phạm vi hưởng; cùng chi trả 2.320.000, BHYT thanh toán 9.280.000. Mọi total cộng đúng từ 6 item; mỗi dòng bị từ chối đều có adjudication riêng kèm lý do thay vì bị bỏ khỏi hồ sơ. Mapping OHP ClaimResponse: submitted/eligible/copay/benefit.

Dữ liệu đã điền của Mẫu giấy khám sức khỏe định kỳ cho người đủ 18 tuổi trở lên (QĐ 1551/QĐ-BYT Phụ lục 01, mẫu 02 = VNKSKQuestionnaire02) cho Nguyễn Văn An: hành chính, thể lực, sinh hiệu và kết luận phân loại sức khỏe Loại II. Cấu trúc item LỒNG theo nhóm I/IV/VII của mẫu phiếu (SDC: QuestionnaireResponse phản chiếu cây nhóm của Questionnaire); linkId khớp mã trường Phụ lục 01.

Dữ liệu đã điền của Mẫu phiếu khám sức khỏe định kỳ cho người đủ 18 tuổi trở lên theo QĐ 2062/QĐ-BYT Phụ lục 01 mục 3 (= VNKSKQuestionnaire18Plus, thay mẫu QĐ 1551/QĐ-BYT) cho Nguyễn Văn An: đầy đủ các trường bắt buộc (hành chính, thông tin lần khám), tiền sử, thể lực và kết luận phân loại sức khỏe Loại II. linkId khớp mã trường Phụ lục 01; trường mã dùng valueCoding trỏ ValueSet chính thức.

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. Theo QĐ 697/QĐ-BYT, QĐ 3276/QĐ-BYT mã đối tượng 9 (Không có BHYT).

Kết quả tự đánh giá tiêu chuẩn chất lượng cơ bản của Bệnh viện Chợ Rẫy cho năm 2025, lập ngày 15/03/2026 — trong Quý I của năm liền kề tiếp theo theo TT 35/2024/TT-BYT Điều 1 khoản 3 điểm b. Bốn trong năm nhóm tiêu chuẩn đạt trọn vẹn; nhóm thiết bị y tế còn 1 tiêu chuẩn chưa đạt trên tổng 5 (Phụ lục TT 35/2024/TT-BYT có 43 dòng đánh giá: 13 + 9 + 2 + 5 + 14). Đạt 42/43 tương đương 97,7%, nhưng theo Điều 1 khoản 3 điểm c chỉ cần một tiêu chuẩn Không là KHÔNG ĐẠT — kết luận nhị phân ghi ở nhóm tổng hợp cuối báo cáo, không suy từ tỷ lệ. Ví dụ này cố ý chọn một ca không đạt: nếu chỉ minh họa ca đạt trọn thì người đọc dễ hiểu nhầm chỉ tiêu này là thang tỷ lệ. Không có subject vì FHIR R4 không cho phép Organization ở element đó; cơ sở được đánh giá nêu ở reporter — hợp lý với hình thái tự đánh giá, và QuestionnaireResponse.subject được trỏ tới bằng evaluatedResource mang đúng cơ sở.

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 khám sức khỏe định kỳ của Nguyễn Văn An tại Bệnh viện Chợ Rẫy ngày 20/07/2026, loại hình MA_LOAI_KCB = 15 theo QĐ 1804/QĐ-BYT. Chi phí do quỹ BHYT chi trả 100% theo Luật 114/2025/QH15 Điều 44 khoản 1 — xem ExampleClaimHealthCheckupBHYT. / Periodic health check-up encounter (service type 15) fully covered by health insurance.

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

Lượt nhập viện nội trú khoa Tim mạch can thiệp: nhồi máu cơ tim cấp ST chênh lên (STEMI) thành trước, PCI đặt stent động mạch vành. Bệnh nhân Nguyễn Văn An (tiền sử tăng huyết áp, đái tháo đường type 2 — yếu tố nguy cơ tim mạch).

Lịch khám bệnh, chữa bệnh từ xa của BS CKII Nguyễn Thị Lan, chuyên khoa Tim mạch, Bệnh viện Chợ Rẫy, mở đặt cho quý II/2026 (01/04 đến 30/06/2026). Extension careDeliveryMode = telehealth cho biết mọi khung giờ sinh từ lịch này là khám từ xa, trừ khi khung giờ ghi khác. Căn cứ: Luật 15/2023/QH15 Điều 80 khoản 1 — khám bệnh, chữa bệnh từ xa phải thực hiện theo phạm vi hành nghề của người hành nghề.

Mã số BHYT hiện hành 10 chữ số, trùng mã số BHXH của người tham gia. Đối tượng: Doanh nghiệp (DN). Nơi ĐKKCB ban đầu: BV Chợ Rẫy.

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.

Mục tiêu điều trị cho Nguyễn Văn An: đưa huyết áp về dưới 140/90 mmHg trong 3 tháng. Gắn với kế hoạch quản lý tăng huyết áp ExampleCarePlanHypertension.

Ví dụ RelatedPerson minh hoạ TRỤC THẨM QUYỀN tách khỏi trục quan hệ: cha (relationship=father) có thẩm quyền = đại diện theo pháp luật, xác minh từ CSDLQG dân cư (C06). Hạn chế lớp dữ liệu 'bảo vệ đặc biệt' của con vị thành niên KHÔNG còn nằm trên token này (0.8.0) — xem provision deny + securityLabel trong ExampleConsentParentalProxy. Theo Bộ luật Dân sự 2015 + Luật 91/2025/QH15 Điều 24 + Luật Trẻ em 2016.

Nhà thuốc bệnh viện (cơ sở bán lẻ thuốc) trực thuộc Bệnh viện Chợ Rẫy — minh họa đối tượng liên thông Hệ thống CSDL về dược: bệnh viện nào cũng có nhà thuốc/khoa dược nên hệ thống HIS cần sinh được payload nhập-xuất-kiểm kê theo QĐ 232/QĐ-TTYQG. Số GCN đủ điều kiện kinh doanh dược là dữ liệu hư cấu.

Nhóm chăm sóc quản lý tăng huyết áp cho Nguyễn Văn An: bác sĩ điều trị chính (BS CKII) + đơn vị điều dưỡng theo dõi, do BV Chợ Rẫy quản lý. Khép bộ ba care-management cùng ExampleCarePlanHypertension + ExampleGoalBloodPressureControl.

Biện luận lâm sàng của bác sĩ cho Nguyễn Văn An: tăng huyết áp kiểm soát chưa đạt mục tiêu, cân nhắc chỉnh liều. Lập tại lượt khám ngoại trú ExampleEncounterOutpatient.

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.

Nhà thuốc Bệnh viện Chợ Rẫy nhập 500 viên Amoxicillin 500mg (lô LOT2026031501, hạn dùng 15/03/2028) từ nhà cung cấp bán buôn. Tương ứng payload POST /transactions/stock-in của Hệ thống CSDL về dược (QĐ 232/QĐ-TTYQG, đặc tả API v1.1): reason=supplier, reference_number=PN-79001-20260715-001, items[0] = {drug_id/batch_no/expiry_date lấy từ Medication tham chiếu, quantity=500, unit=viên}. Ngày giờ FHIR mang offset +07:00; khi sinh payload, adapter bỏ offset theo định dạng GMT+7 của API (mục 6.3.1).

Kết quả tự đánh giá 43 tiêu chuẩn của Phụ lục TT 35/2024/TT-BYT cho năm 2025, lập ngày 15/03/2026 — trong Quý I của năm liền kề tiếp theo theo Điều 1 khoản 3 điểm b. 42 tiêu chuẩn trả lời Có; riêng IV.4 (thiết bị y tế thuộc danh mục phải kiểm định, hiệu chuẩn) trả lời Không. Theo Điều 1 khoản 3 điểm c, kết luận là KHÔNG ĐẠT tiêu chuẩn chất lượng cơ bản — tỷ lệ 42/43 không đổi được kết luận đó. Đây là bản ghi máy-đọc-được của phiếu tự đánh giá; ExampleMeasureReportHospitalBasicQuality tổng hợp lại theo năm nhóm tiêu chuẩn và trỏ ngược về bản ghi này qua evaluatedResource.

Ví dụ Observation ghi nhận phân loại sức khỏe trong kết luận khám sức khỏe định kỳ (PHAN_LOAI_SK = 2). Theo QĐ 1551/QĐ-BYT (31/5/2026).

Bác sĩ trực cấp cứu Nguyễn Thị Lan phân loại người bệnh Nguyễn Văn An sau tai nạn giao thông (gãy cổ xương đùi) ở mức Cấp độ 2 — Cấp cứu (đánh giá/xử trí trong ~10 phút) theo QĐ 01/2008/QĐ-BYT. Gắn lượt ExampleEncounterEmergency.

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.

Device logic đại diện dịch vụ Policy Decision Point (PDP) nội bộ của Bệnh viện Chợ Rẫy, dùng để đánh giá và ghi quyết định truy cập theo căn cứ pháp lý. Dùng Device thường vì đây là thành phần phần mềm kiểm soát truy cập, không phải thiết bị y tế thuộc ràng buộc VN Core TBYT. / Logical Device representing the hospital's internal Policy Decision Point. A base Device is used because this is access-control software, not a regulated medical device constrained by VN Core medical-device profiles.

Ví dụ metadata Provenance cho chữ ký số của bác sĩ kết luận trên tài liệu khám sức khỏe định kỳ (CKS_NGUOI_KET_LUAN), trong luồng hiện hành phải đọc QĐ 1551/QĐ-BYT hợp nhất với QĐ 2062/QĐ-BYT. Kiểu chữ ký XML dưới đây là lựa chọn minh họa; ví dụ không chứa Signature.data, không mô tả API envelope ký theo Phụ lục 02/03 và không phải chữ ký có thể xác minh.

Ví dụ metadata Provenance cho một lựa chọn triển khai chữ ký số trên bệnh án điện tử nội trú. PKCS#7/CMS là định dạng minh họa do hợp đồng tích hợp giả định lựa chọn, không phải định dạng được TT 13/2025/TT-BYT hoặc NĐ 137/2024/NĐ-CP ấn định. Ví dụ không có Signature.data nên không phải chữ ký có thể xác minh và không chứng minh giá trị pháp lý của tài liệu.

Bản trả lời cấu trúc của Mẫu số 08 NĐ 356/2025/NĐ-CP cho kịch bản truy cập trái phép HSBA 12 bệnh nhân. Máy đọc được: thời điểm phát hiện (mốc 72 giờ theo Luật 91/2025/QH15 Điều 23 khoản 1), thời điểm thông báo, loại DLCN (nhạy cảm — sức khỏe), số lượng chủ thể, hậu quả, biện pháp. Được tham chiếu từ section[breachDescription] của ExampleCompositionBreachNotification.

Ví dụ hư cấu về dữ liệu quyết toán chi phí KCB BHYT Quý I/2026 giữa Bảo hiểm xã hội Việt Nam và Bệnh viện Chợ Rẫy. Instance có đủ 55 mã chỉ tiêu hiện hành, không trùng và thỏa toàn bộ công thức nội tại công bố trong biểu mẫu. Mã 1, 2, 3 và 10 không có giá trị lũy kế; mã 30 và 43 không có giá trị ở cả hai cột. Mỗi ô không áp dụng giữ Money, bỏ value và mang data-absent-reason not-applicable; các ô áp dụng còn lại dùng số trong quý làm lũy kế cho ví dụ Quý I. English summary: Fictional Q1/2026 quarterly BHYT healthcare cost settlement between Viet Nam Social Security and Cho Ray Hospital. The instance contains all 55 current, unique indicator codes and satisfies every internally declared formula in the form. Indicators 1, 2, 3, and 10 have no year-to-date value; indicators 30 and 43 have no value in either column. Every non-applicable cell retains Money without value and carries data-absent-reason not-applicable; all other applicable first-quarter year-to-date values equal their quarter amounts.

Ví dụ hư cấu Quý II/2026 nối tiếp ExampleQuarterlySettlementQ1 trên cùng hợp đồng KCB BHYT. Sáu quan hệ liên quý đều thỏa: 3=10 kỳ trước, 13=27 kỳ trước, 31=44 kỳ trước, 32=45 kỳ trước, 47=50 kỳ trước và 52=55 kỳ trước. Toàn bộ 23 công thức nội tại và ma trận cột cũng được giữ nhất quán; mã 42 minh họa nhánh nghịch 35 < 23 bằng giá trị 0 trong quý. English summary: Fictional Q2/2026 continuation of ExampleQuarterlySettlementQ1 under the same BHYT healthcare contract. All six carry-forward relationships, all 23 internal formulas, and the column-applicability matrix are satisfied. Indicator 42 demonstrates the inactive 35 < 23 branch with a zero quarter value.

Bác sĩ trực Nguyễn Thị Lan thực sự override quyền truy cập thông thường để xem dữ liệu của bệnh nhân Nguyễn Văn An trong ca cấp cứu. PDP cho phép theo mã emergency-vital, ghi URI Điều 19(1)(a), policy nội bộ có version, controller và bằng chứng lâm sàng. BTG được dùng vì đây là override thật; ETREAT/ERTREAT không thay thế mã căn cứ pháp lý. / The on-call physician performs a real break-glass override during an emergency. The PDP permits access under emergency-vital and records the point-specific statute URI, versioned local policy, controller, and clinical evidence.

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.

Bundle type=searchset minh hoạ kết quả app VNeID tra cứu Sổ Sức khỏe điện tử của một công dân: Patient (match) + giấy khám sức khỏe định kỳ + thẻ BHYT + Consent chia sẻ + phân loại sức khỏe (include). Theo QĐ 2062/QĐ-BYT Phụ lục 04 (trường hiển thị VNeID) + Phụ lục 05 (quy trình chia sẻ BYT → CSDLQG dân cư → hiển thị VNeID, thay QĐ 1551/QĐ-BYT) và QĐ 1332/QĐ-BYT (Sổ SKĐT).

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. Theo TT 13/2025/TT-BYT.

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

Cân nặng 65 kg, LOINC 29463-7, đơn vị UCUM kg. Theo 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. Theo TT 13/2025/TT-BYT.

Mạch 80 lần/phút, LOINC 8867-4, đơn vị UCUM /min. Theo 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. Theo TT 13/2025/TT-BYT.

Nhịp thở 16 lần/phút, LOINC 9279-1, đơn vị UCUM /min. Theo 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%. Theo 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.

Bản tóm tắt người bệnh theo chuẩn International Patient Summary (IPS) cho Nguyễn Văn An — bản XUẤT KHẨU QUỐC TẾ sinh từ Sổ SKĐT nội địa qua $summary. Gồm 3 mục bắt buộc IPS: dị ứng, danh sách bệnh, thuốc (dùng mã SNOMED CT/ICD-10). Minh họa kiến trúc dual-profile (ADR-0016). Lưu ý: ví dụ minh họa ở mức Composition — entry các mục tham chiếu resource VN Core hiện có; bản IPS ĐẦY ĐỦ (resource IPS-profiled + document Bundle hợp lệ IPS) do operation $summary sinh tại server (projection nội địa → IPS, ánh xạ mã sang SNOMED CT).

Ví dụ Sổ Sức khỏe điện tử tổng hợp hiển thị trên VNeID cho người trưởng thành (THA + ĐTĐ): dị ứng, danh sách bệnh, thuốc, tiêm chủng, xét nghiệm, thủ thuật, sinh hiệu và liên kết giấy KSK định kỳ. Theo QĐ 1332/QĐ-BYT + pattern IPS.

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). Theo 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. Theo 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 theo 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/NĐ-CP 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 là coding phân loại; số đăng ký lưu hành VD-12345-20 đặt ở identifier. Quy cách: hộp 2 vỉ x 10 viên. Mapping OHP: MA_THUOC, TEN_THUOC, SO_DANG_KY theo QĐ 3176/QĐ-BYT.

Ví dụ Composition 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. Kịch bản giả định:

• Cơ sở y tế phát hiện vi phạm: 1 nhân viên truy cập trái phép HSBA của 12 bệnh nhân ngoài phạm vi nhiệm vụ.
• Thời gian phát hiện: 14:30 ngày 05/05/2026.
• Đã thực hiện: chặn access ngay, audit log, chủ động thông báo 12 chủ thể dữ liệu (thực hành tốt — nghĩa vụ thông báo CHỦ THỂ trong 72 giờ chỉ bắt buộc với dữ liệu vị trí/sinh trắc học theo NĐ 356/2025/NĐ-CP Điều 29 khoản 1 điểm a).
• Đánh giá khả năng tổn hại (điều kiện Điều 23 khoản 1): hồ sơ bị truy cập chứa chẩn đoán tâm thần và bệnh truyền nhiễm — nguy cơ xâm phạm danh dự, nhân phẩm của chủ thể nếu lộ lọt → THUỘC diện phải thông báo.
• Gửi thông báo theo kênh hiện hành đến Cơ quan chuyên trách bảo vệ dữ liệu cá nhân trong 72 giờ kể từ khi phát hiện — do kịch bản này được đánh giá thuộc ngưỡng tổn hại tại Luật 91/2025/QH15 Điều 23 khoản 1. Resource FHIR này chỉ mô tả kịch bản, không tự chứng minh việc gửi/tiếp nhận đúng hạn.

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 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. Theo 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.

Khai thác bệnh sử: người bệnh Nguyễn Văn An đang dùng Amlodipine 5mg/ngày điều trị tăng huyết áp từ tháng 01/2026. Minh họa MedicationStatement (tiền sử/đang dùng) khác với MedicationRequest (y lệnh mới).

Tiền sử gia đình của Nguyễn Văn An: bố ruột mắc tăng huyết áp và đái tháo đường type 2. Ghi nhận trong mục tiền sử gia đình của phiếu khám sức khỏe định kỳ (QĐ 1551/QĐ-BYT).

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ũ.

Sự kiện AuditEvent thứ hai ghi lần đọc bệnh án thực tế sau quyết định ExampleAuditEventEmergencyLegalBasisDecision. Subtype legal-basis-access, extension processingLegalBasis và entity liên kết quyết định giúp consumer không nhầm quyết định cho phép với hành vi truy cập đã xảy ra. / Second AuditEvent recording the actual record read after ExampleAuditEventEmergencyLegalBasisDecision. The subtype, legal-basis extension, and linked decision entity keep authorization separate from actual access.

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ý.

Trạm y tế xã được hình thành sau sắp xếp đơn vị hành chính (NQ 202/2025/QH15): mã CSKCB mới có hiệu lực từ 01/7/2025, kế nhiệm trạm y tế cũ (mã CSKCB cũ). Minh họa identifier.period và extension orgLifecycleRelation (quan hệ tiền nhiệm + hạng mục kế thừa: hợp đồng BHYT, đăng ký KCB ban đầu, giấy phép).

Tóm tắt xuất viện cho bệnh nhân Nguyễn Văn An sau phẫu thuật nội soi cắt ruột thừa, điều trị nội trú tại BV Chợ Rẫy. Loại tài liệu: Discharge Summary (LOINC 18842-5). Theo 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. Theo Luật 91/2025/QH15 Điều 4 khoản 1 điểm b (quyền không đồng ý) và Điều 10 (rút lại/hạn chế xử lý). Từ chối đang hiệu lực → status = active + rule nested deny. 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 đủ theo TT 41/2025/TT-BYT, TT 32/2023/TT-BYT.

Vai trò hư cấu của người đại diện cơ quan BHXH rà soát và xác nhận biên bản quyết toán theo quý. Dùng PractitionerRole nền vì cơ quan BHXH là bên chi trả, không phải cơ sở KCB thuộc phạm vi VNCoreOrganization. / Fictional role for a BHXH representative who reviews and attests a quarterly settlement. Base PractitionerRole is used because the BHXH authority is a payer rather than a healthcare provider in the scope of VNCoreOrganization.

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.

Nghiên cứu DICOM X-quang ngực thẳng cho bệnh nhân Nguyễn Văn An trong lượt khám ngoại trú 19/03/2026. Minh họa modality CR (Computed Radiography), StudyInstanceUID, accession number và liên kết basedOn → ServiceRequest. Đây là study được ExampleDiagnosticReportImaging tham chiếu. / DICOM study for a plain chest radiograph taken during the 19 Mar 2026 outpatient visit; referenced by ExampleDiagnosticReportImaging.

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 lệnh kháng sinh Cefotaxime 1g tiêm tĩnh mạch mỗi 8 giờ cho người bệnh nội trú hậu phẫu cắt ruột thừa (Nguyễn Văn An). Đầu chuỗi truy vết: y lệnh → cấp phát (ExampleMedicationDispenseInpatientAntibiotic) → sử dụng (ExampleMedicationAdministrationInpatient).

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.

Yêu cầu thanh toán BHYT ngoại trú cho BN Nguyễn Văn An — tái khám viêm dạ dày mạn K29.5 theo giấy hẹn 19/4/2026. 3 dòng chi phí: Khám (150.000), Xét nghiệm (850.000), Thuốc (3.200.000) — tổng 4.200.000 VND. Đề nghị ex-ante: toàn bộ trong phạm vi BHYT, mức hưởng 80%. Kết quả giám định ex-post xem ExampleClaimResponsePartialDeny (BHXH trừ 800.000đ một biệt dược ngoài danh mục trong dòng thuốc gộp).

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 theo 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. Minh họa dòng thuốc Parecoxib ngoài danh mục BHYT (PHAM_VI = 2, TYLE_TT_BH = 0) có nguồn khác hỗ trợ (T_NGUONKHAC = 770.000: NSNN 270.000 + viện trợ trong nước 500.000) giảm trừ vào T_BNTT theo quy tắc QĐ 3176/QĐ-BYT: T_BNTT = 1.770.000 − 770.000 = 1.000.000. T_TONGCHI_BH = 13.050.000; định danh Bảng 1: T_TONGCHI (14.820.000) = T_BHTT + T_BNCCT + T_BNTT + T_NGUONKHAC.

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í theo 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). Theo 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.

Công việc điều phối cấp phát đơn thuốc ngoại trú Amoxicillin 500mg (mã đơn quốc gia 790010000451-N) tại Nhà thuốc Bệnh viện Chợ Rẫy. Đơn kê 09:30 ngày 19/03/2026, bán đủ 21 viên lúc 14:20 cùng ngày. restriction.period.end = 24/03/2026 là mốc hết thời hạn lĩnh thuốc — tối đa 05 ngày kể từ ngày kê đơn theo TT 26/2025/TT-BYT Điều 12 khoản 9 điểm b; quá mốc này businessStatus chuyển sang RX-EXPIRED và cơ sở bán lẻ không được tiếp tục bán theo đơn. Không gắn Encounter: người bệnh mua thuốc sau khi lượt khám ngoại trú đã kết thúc.

Công việc điều phối phát sinh từ giấy chuyển tuyến cấp cứu ExampleServiceRequestReferral. Bệnh viện Chợ Rẫy nhận yêu cầu lúc 15:10 ngày 20/04/2026, đồng ý tiếp nhận, người bệnh đến lúc 20:30 và lượt cấp cứu kết thúc 06:00 ngày 21/04/2026. Task.status = completed là vòng đời kỹ thuật; Task.businessStatus = REF-COMPLETED là trạng thái nghiệp vụ. Không gắn Encounter vì công việc khởi tạo trước khi cơ sở tiếp nhận mở lượt khám — lượt khám đã mở nằm ở Task.output. Căn cứ: Luật 15/2023/QH15 Điều 60 khoản 10 (chuyển người bệnh), Điều 61 (cấp cứu).

Nhóm đối tượng của chiến dịch tiêm bổ sung vắc xin sởi tại Thành phố Hà Nội, quý III/2026: trẻ từ 1 đến 5 tuổi, loại trừ trẻ đã tiêm đủ hai mũi. Nhóm mô tả bằng tiêu chí (actual = false), không liệt kê thành viên — tiêu chí không phải dữ liệu cá nhân, danh sách trẻ thì có. Dùng làm mẫu số cho báo cáo tỷ lệ tiêm chủng và làm nhóm đích khi cần rút trích dữ liệu theo lô. Căn cứ: Luật 114/2025/QH15 (Luật Phòng bệnh) — đối tượng tiêm chủ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. Theo 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. Theo 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.

Yêu cầu thanh toán BHYT cho một lượt khám sức khỏe định kỳ của Nguyễn Văn An tại Bệnh viện Chợ Rẫy. Từ 01/07/2026, khám sức khỏe định kỳ và khám sàng lọc thuộc phạm vi hưởng BHYT với mức hưởng 100% theo Luật 114/2025/QH15 Điều 44 khoản 1 (sửa điểm a khoản 1 Điều 21, bổ sung khoản 5a Điều 22 và sửa khoản 3 Điều 23 của Luật BHYT). Hai dòng chi phí: khám lâm sàng 150.000 và xét nghiệm cơ bản 250.000; tổng 400.000 do quỹ BHYT chi trả toàn bộ, người bệnh không cùng chi trả. Mã hóa loại hình: lượt khám dùng MA_LOAI_KCB = 15 (khám sức khoẻ định kỳ) theo QĐ 1804/QĐ-BYT Phụ lục 01 — xem ExampleEncounterHealthCheckup. Điều kiện mà QĐ 1804/QĐ-BYT đặt ra cho mã 15 (chỉ áp dụng khi có quy định của cấp có thẩm quyền về thanh toán chi phí từ Quỹ BHYT) nay đã thỏa nhờ Luật 114/2025/QH15 Điều 44. Mã đối tượng đến KCB (MA_DOI_TUONG_KCB, QĐ 3276/QĐ-BYT) chưa có mã riêng cho lượt KSK hưởng BHYT — ví dụ dùng mã 1.1 (đúng nơi đăng ký KCB ban đầu); mức hưởng và quy trình thanh toán chi tiết chờ hướng dẫn của Chính phủ theo khoản 3 Điều 7a Luật BHYT. / Claim for an insured periodic health check-up: from 01 Jul 2026 periodic check-ups and screening are inside the insured benefit scope at 100% coverage.

Ví dụ PaymentReconciliation cho remittance/phân bổ khoản thanh toán giữa BV Đa khoa Tỉnh và BHXH tỉnh sau quyết toán quý theo [TT 12/2026/TT-BTC] (ban hành 10/02/2026, hiệu lực 10/02/2026) — Giám định, thanh toán và quyết toán chi phí KCB BHYT. Kỳ nghiệp vụ là Quý I/2026 (01/01–31/03/2026). Resource này không mang 55 chỉ tiêu Mẫu 06/BH; dữ liệu biểu mẫu dùng VNCoreQuarterlyHealthcareCostSettlement.

• Tổng số hồ sơ trong kỳ: 4 (đại diện)
• Tổng chi phí được duyệt: 27.300.000 VND
• Trạng thái: approved (đã được giám định và phê duyệt)
• Tham chiếu legacy đến quy trình 06/BH: 06/BH-Q1-2026

English summary: Example remittance and bulk-payment allocation between a provider and a BHXH payer after the Q1/2026 settlement under TT 12/2026/TT-BTC. This PaymentReconciliation allocates 27,300,000 VND across four representative transactions; it does not carry the 55 Form 06/BH indicators.

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, performer là VNCoreRelatedPerson, và mô hình D3 (0.8.0): provision permit chính + provision con type=deny với securityLabel special-protection cho actor[representative] (cha — người đại diện theo pháp luật, token thẩm quyền gắn NGAY TẠI actor) — người đại diện không được xem lớp bảo vệ đặc biệt của trẻ vị thành niên (SK sinh sản/tâm thần/HIV). PDP deny-by-default theo lớp dữ liệu.

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 theo Luật 91/2025/QH15 + NĐ 356/2025/NĐ-CP. Thời hạn: 04/2026 — 04/2027.

Đợt chăm sóc quản lý tăng huyết áp mạn tính của Nguyễn Văn An tại BV Chợ Rẫy — gom nhiều lượt tái khám/cấp thuốc BHYT theo chương trình quản lý bệnh không lây nhiễm. Gắn chẩn đoán ExampleConditionProblemHypertension.

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 13 giấy chuyển tuyến/chuyển cơ sở KCB BHYT — XML13 Referral Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML13ReferralLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 14 giấy hẹn khám lại — XML14 Follow-up Appointment Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML14FollowUpAppointmentLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Generated StructureMap scaffold for Bảng 15 quản lý điều trị bệnh lao — XML15 Tuberculosis Treatment Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML15TuberculosisLM.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.

Questionnaire cho Giấy khám sức khỏe tâm thần theo Mẫu số 04 Phụ lục XXIV ban hành kèm TT 25/2026/TT-BYT (sửa TT 32/2023/TT-BYT Điều 34/36). KHÔNG áp dụng cho khám sức khỏe định kỳ. / Mental-health checkup form per Circular 25/2026/TT-BYT Form 04. Đây là mẫu giấy khám dạng văn xuôi (không có mã chỉ tiêu chuẩn hóa); linkId đặt mô tả. Phần hành chính ghi theo QĐ 3176/QĐ-BYT.

Hệ thống nguồn tạo và gửi tài nguyên FHIR (HIS/EMR/LIS/RIS của cơ sở KCB, cổng gửi dữ liệu). Mang nghĩa vụ điền (populate) phần tử Must Support khi dữ liệu có thật.

Hệ thống tiếp nhận và xử lý tài nguyên FHIR (Kho dữ liệu y tế, Cổng giám định BHYT, ứng dụng người dân, hệ thống tuyến trên). Mang nghĩa vụ tiếp nhận/lưu/chuyển tiếp phần tử Must Support mà không gây lỗi và không mất ngữ nghĩa.

Questionnaire cho mẫu 01 (Mẫu giấy khám sức khỏe định kỳ dùng cho người từ đủ 6 tuổi đến dưới 18 tuổi) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 01.

Questionnaire cho mẫu 02 (Mẫu giấy khám sức khỏe định kỳ cho người đủ 18 tuổi trở lên) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 02.

Questionnaire cho mẫu 03 (Mẫu sổ khám sức khỏe định kỳ cho lái xe) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 03.

Questionnaire cho mẫu 04 (Mẫu sổ khám sức khỏe định kỳ cho nhân viên đường sắt) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 04.

Questionnaire cho mẫu 05 (Mẫu sổ khám sức khỏe định kỳ cho thuyền viên) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 05.

Questionnaire cho mẫu 06 (Mẫu Sổ Khám Sức Khỏe Định Kỳ Cho Trẻ 0 - Dưới 2 tháng) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 06.

Questionnaire cho mẫu 07 (Mẫu Sổ Khám Sức Khỏe Định Kỳ Cho Trẻ 2 - 3 tháng) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 07.

Questionnaire cấu trúc hóa Mẫu số 08 Phụ lục NĐ 356/2025/NĐ-CP theo Điều 28 khoản 1: tính chất vi phạm (thời gian, địa điểm, hành vi, loại DLCN, số lượng — điểm a), liên lạc bộ phận/nhân sự BVDLCN (điểm b), hậu quả/thiệt hại (điểm c), biện pháp khắc phục (điểm d). Kèm 2 mốc thời gian phục vụ đối soát thời hạn khi nghĩa vụ 72 giờ tại Luật 91/2025/QH15 Điều 23 khoản 1 thực sự áp dụng — tức vi phạm có thể gây các loại tổn hại được nêu tại khoản này; không phải mọi vi phạm đều chịu mốc 72 giờ đó. Thời hạn được tính từ THỜI ĐIỂM PHÁT HIỆN: thời điểm phát hiện và thời điểm thông báo. QuestionnaireResponse tương ứng được wrap trong VNCoreCompositionBreachNotification section[breachDescription]. Đây là representation FHIR của IG, không phải định dạng điện tử do NĐ 356/2025/NĐ-CP quy định và không tự chứng minh việc nộp đúng hạn.

Questionnaire cho mẫu 08 (Mẫu Sổ Khám Sức Khỏe Định Kỳ Cho Trẻ 4 - 6 tháng) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 08.

Questionnaire cho mẫu 09 (Mẫu sổ khám sức khỏe định kỳ cho trẻ 7 - 9 tháng) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 09.

Questionnaire cho mẫu 10 (Mẫu sổ khám sức khỏe định kỳ cho trẻ 10 - 12 tháng) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 10.

Questionnaire cho mẫu 11 (Mẫu sổ khám sức khỏe định kỳ cho trẻ 13 - 18 tháng) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 11.

Questionnaire cho mẫu 12 (Mẫu sổ khám sức khỏe định kỳ cho trẻ 19 - dưới 24 tháng) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 12.

Questionnaire cho mẫu 13 (Mẫu sổ khám sức khỏe định kỳ cho trẻ 2 - dưới 6 tuổi) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 13.

Questionnaire cho mẫu 14 (Mẫu sổ khám sức khỏe định kỳ cho học sinh từ 3 tháng - Dưới 6T) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 14.

Questionnaire cho mẫu 15 (Mẫu sổ khám sức khỏe định kỳ cho học sinh từ lớp 1 - lớp 5) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 15.

Questionnaire cho mẫu 16 (Mẫu sổ khám sức khỏe định kỳ cho học sinh từ lớp 6 - lớp 9) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 16.

Questionnaire cho mẫu 17 (Mẫu sổ khám sức khỏe định kỳ cho học sinh từ lớp 10 - lớp 12) theo QĐ 1551/QĐ-BYT Phụ lục 01. / Questionnaire for QD 1551 Appendix 01 form 17.

Questionnaire cho mẫu phiếu khám sức khỏe và khám sức khỏe định kỳ dùng cho người từ đủ 06 đến dưới 18 tuổi theo QĐ 2062/QĐ-BYT Phụ lục 01 mục 2 (thay Phụ lục 01 QĐ 1551/QĐ-BYT). 87 trường, nhóm I–VIII. / Health checkup Questionnaire for ages 6 to under 18 per Decision 2062/QĐ-BYT Appendix 01. Toàn bộ trường mã (#choice) bind answerValueSet chính thức (vn-ksk-yes-no-vs, vn-ksk-vaccinated-vs, vn-ksk-obstetric-history-vs, vn-health-checkup-funding-source-vs, vn-health-checkup-classification-vs).

Questionnaire cho mẫu phiếu khám sức khỏe và khám sức khỏe định kỳ dùng cho người đủ 18 tuổi trở lên theo QĐ 2062/QĐ-BYT Phụ lục 01 mục 3 (thay Phụ lục 01 QĐ 1551/QĐ-BYT). 123 trường, nhóm I–VIII. / Health checkup Questionnaire for ages 18 and over per Decision 2062/QĐ-BYT Appendix 01. Mã trả lời tái dùng ValueSet chính thức (vn-ksk-yes-no-vs, vn-health-checkup-funding-source-vs, vn-health-checkup-classification-vs). Trường 'Phân loại KQ khám' theo khoa dùng #integer (văn bản không liệt kê mã).

Questionnaire cho mẫu phiếu khám sức khỏe và khám sức khỏe định kỳ dùng cho trẻ em dưới 06 tuổi theo QĐ 2062/QĐ-BYT Phụ lục 01 mục 1 (thay Phụ lục 01 QĐ 1551/QĐ-BYT). 109 trường, nhóm I–IX. / Health checkup Questionnaire for children under 6 per Decision 2062/QĐ-BYT Appendix 01. Toàn bộ trường mã (#choice) bind answerValueSet chính thức (vn-ksk-yes-no-vs, vn-ksk-temperature-status-vs, vn-ksk-pulse-status-vs, vn-ksk-respiration-status-vs, vn-ksk-head-circumference-vs, vn-ksk-skin-color-vs, vn-ksk-fontanelle-vs, vn-ksk-eye-position-vs, vn-ksk-eyelid-conjunctiva-vs, vn-ksk-nose-shape-vs, vn-ksk-mouth-shape-vs, vn-ksk-tongue-shape-vs, vn-ksk-peripheral-pulse-vs, vn-ksk-muscle-tone-vs, vn-ksk-hip-joint-vs, vn-ksk-apnea-vs, vn-ksk-normal-abnormal-alt-vs, vn-ksk-pallor-vs, vn-ksk-family-relationship-vs, vn-health-checkup-funding-source-vs).

Ví dụ bệnh nhân dùng cho validation âm tính. CCCD dùng data-absent-reason trên value nhưng KHÔNG có lý do bất khả kháng (vn-ext-force-majeure-reason), không có hộ chiếu, không có giấy khai sinh — phải bị từ chối bởi invariant vn-patient-force-majeure-reason.

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

Questionnaire cấu trúc hóa toàn bộ 43 dòng đánh giá của Phụ lục TT 35/2024/TT-BYT (ban hành 16/11/2024, hiệu lực 01/01/2025), chia theo năm Mục: I cơ sở vật chất (13), II quy mô và cơ cấu tổ chức (9), III nhân sự (2), IV thiết bị y tế (5), V chuyên môn (14). Mỗi tiêu chuẩn là một câu hỏi boolean tương ứng cột Kết quả đánh giá Có/Không của phụ lục. Xếp loại theo Điều 1 khoản 3 điểm c: ĐẠT khi toàn bộ trả lời là Có; chỉ cần một câu Không là KHÔNG ĐẠT. Phạm vi áp dụng theo Điều 1 khoản 2: chỉ cơ sở khám bệnh, chữa bệnh được cấp giấy phép hoạt động theo hình thức tổ chức là bệnh viện. Chu kỳ theo Điều 1 khoản 3 điểm a, b: một lần mỗi năm, thực hiện trong Quý I của năm liền kề tiếp theo. Sáu tiêu chuẩn được phụ lục đánh dấu sao (I.1, I.2, I.3.1, I.3.2, I.4, I.5) chỉ phải cung cấp lại tài liệu chứng minh khi có thay đổi giữa hai lần đánh giá — ghi trong phần hướng dẫn của từng câu.