Mô tả khả năng tối thiểu của một máy chủ FHIR tuân thủ VN Core IG. Bao gồm 20 loại resource với các tương tác read, search-type, create, và update. / Minimum capabilities for a FHIR server conforming to VN Core IG. Covers 20 resource types with read, search-type, create, and update interactions.

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 Practitioner theo số Chứng chỉ hành nghề (CCHN). Căn cứ: Luật KCB 2023 (15/2023/QH15), Điều 19-26 — CCHN là bắt buộc cho mọi NVYT. Ví dụ: GET [base]/Practitioner?vn-cchn=012345

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

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

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

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

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

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). Căn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — 2.964 chỉ số CLS, QĐ 3176/QĐ-BYT — trường MA_DICH_VU, KET_QUA trong XML3/XML6. Nguồn thiết kế: OHP Data Processor (DiagnosticReport mapper — XML 4750).

Profile Patient cho Việt Nam. Bao gồm identifier slicing (CCCD, BHYT, MRN), extensions dân tộc/tôn giáo, và ràng buộc địa chỉ theo VNCoreAddress. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), Luật Căn cước 2023, Luật BHYT.

Profile Condition cho chẩn đoán tại Việt Nam. Hỗ trợ mã hóa chẩn đoán bằng ICD-10 (bắt buộc theo QĐ 4469/QĐ-BYT) và/hoặc SNOMED CT IPS Terminology. Căn cứ: QĐ 4469/QĐ-BYT (28/10/2020) — ICD-10-VN, QĐ 98/QĐ-BYT (2022) — bổ sung COVID-19, QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024).

Profile Organization cho cơ sở y tế Việt Nam. Bao gồm identifier mã CSKCB, extensions loại hình/tuyến/hạng, và địa chỉ theo VNCoreAddress. Căn cứ: Luật KCB 2023 Điều 47-48, TT 06/2024/TT-BYT (phân hạng).

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

Profile DeviceUseStatement cho Việt Nam. Ghi nhận việc sử dụng vật tư y tế (VTYT) 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).

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 (XML 4210 → QĐ 130 → QĐ 3176). Bảng kê chi phí theo QĐ 697/QĐ-BYT (19/3/2026) — 12 danh mục, 14 mã. Căn cứ:

• QĐ 3176/QĐ-BYT (29/10/2024) — Chuẩn dữ liệu đầu ra phục vụ BHXH
• QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB
• NĐ 188/2025/NĐ-CP — Hướng dẫn thi hành Luật BHYT
• Luật BHYT 2008 sửa đổi 2014

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ả. Căn cứ:

• QĐ 130/QĐ-BYT → QĐ 4750 → QĐ 3176 (chuẩn dữ liệu BHXH)
• QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB
• NĐ 188/2025/NĐ-CP — Hướng dẫn Luật BHYT Nguồn thiết kế: OHP Data Processor (ClaimResponse adjudication mapping).

Profile Encounter cho Việt Nam. Bao gồm extension loại KCB BHYT (trường MALYDO), thông tin chẩn đoán, cơ sở y tế, và kết quả điều trị/tình trạng ra viện. Căn cứ: QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024), TT 13/2025/TT-BYT, Luật BHYT 2008 sửa đổi 2014.

Profile Practitioner cho Việt Nam. Bao gồm identifier slicing (CCCD, CCHN), thông tin trình độ chuyên môn (qualification). Căn cứ: Luật KCB 2023 Điều 19-27 (CCHN), TT 13/2025/TT-BYT.

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 (bệnh án điện tử — phần sinh hiệu).

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 Dược 2016, Dược điển VN, QĐ 3176/QĐ-BYT (trường MA_THUOC, TEN_THUOC). Nguồn thiết kế: OHP Data Processor (Medication mapper).

Profile Coverage đại diện thẻ bảo hiểm y tế Việt Nam. Bao gồm extensions loại đối tượng BHYT và nơi ĐKKCB ban đầu, hỗ trợ cả 3 format số thẻ. Căn cứ: Luật BHYT 2008 sửa đổi 2014, QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024).

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

Profile 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
• 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, 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 Device cho vật tư y tế tiêu hao (VTYT) tại Việt Nam. Dùng trong thanh toán BHYT: mã VTYT, nhóm VTYT, phạm vi BHYT. Liên kết với Claim.item (chi phí VTYT) và DeviceUseStatement (ghi nhận sử dụng). Căn cứ: QĐ 3176/QĐ-BYT (trường MA_VAT_TU, TEN_VAT_TU), NĐ 74/2025/NĐ-CP. Nguồn thiết kế: OHP Data Processor (Device mapper).

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

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

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

• QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu đầu ra phục vụ BHXH
• QĐ 4750/QĐ-BYT (2023) — Sửa đổi QĐ 130
• QĐ 3176/QĐ-BYT (29/10/2024) — Sửa đổi QĐ 4750
• QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB (thay QĐ 6556)
• NĐ 188/2025/NĐ-CP — Hướng dẫn thi hành Luật BHYT
• Luật BHYT 2008 sửa đổi 2014

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

Profile MedicationRequest cho Việt Nam. Dùng cho đơn thuốc điện tử (ePrescription). Hỗ trợ đơn thuốc ngoại trú, nội trú, cấp cứu. Liên kết với BHYT qua Coverage/Claim. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 130/QĐ-BYT sửa đổi bởi QĐ 3176/QĐ-BYT (trường MA_THUOC trong chuẩn dữ liệu BHXH), Luật Dược 2016 Điều 74 (kê đơn thuốc). / VN Core MedicationRequest profile for electronic prescriptions (ePrescription). Supports outpatient, inpatient, and emergency prescriptions. Links to insurance via Coverage/Claim. Per TT 13/2025/TT-BYT (EMR), QĐ 3176/QĐ-BYT (BHXH data standard — MA_THUOC field), Pharmaceutical Law 2016 Art.74 (prescription rules).

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

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 hạng (phân hạng) của cơ sở khám bệnh, chữa bệnh theo hệ thống phân hạng 4 bậc của Bộ Y tế. Căn cứ: TT 06/2024/TT-BYT về phân hạng CSKCB.

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

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

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

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

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

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

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

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

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

Số đăng ký lưu hành thuốc (Visa) do Cục Quản lý Dược – BYT cấp. Mapping XML 3176: SO_DANG_KY. Nguồn thiết kế: OHP Data Processor (medication-registration-number).

Extension tái sử dụng cho thông tin chi phí BHYT trên từng item (thuốc/DVKT/VTYT). Bao gồm: phạm vi BHYT (PHAM_VI), tỷ lệ thanh toán (TYLE_TT), mức hưởng (MUC_HUONG). Dùng trên: MedicationRequest, Procedure, DeviceUseStatement, Claim.item. Mapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG. Nguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level).

Mở rộng ghi nhận tuyến y tế của cơ sở (Trung ương, Tỉnh, Xã). Sau NQ 202/2025, mô hình chính quyền 2 cấp → tuyến huyện cũ chỉ còn ở trạng thái legacy. Căn cứ: Luật KCB 2023, NQ 202/2025/QH15.

Mở rộng ghi nhận tôn giáo của bệnh nhân theo danh mục 16 tôn giáo được Nhà nước Việt Nam công nhận (CV 6955/BNV-TGCP, 28/12/2020). Căn cứ: Hiến pháp 2013 Điều 24, Luật Tín ngưỡng tôn giáo 2016 (02/2016/QH14).

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

Extension tổng hợp chi phí KCB theo từng nhóm nguồn chi trả. Mapping từ XML 3176: T_THUOC, T_VTYT, T_BNCCT, T_BNTT, T_BHTT, T_NGUONKHAC, T_NGOAIDS. Căn cứ: QĐ 130/QĐ-BYT → QĐ 3176, QĐ 697/QĐ-BYT. Nguồn thiết kế: OHP Data Processor (Claim extensions production mapping).

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.

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. 135 Mã U từ QĐ 2552/QĐ-BYT (12/8/2025). Mã U KHÔNG PHẢI ICD-10 — đây là hệ thống mã quốc gia riêng cho YHCT. Mỗi Mã U có ánh xạ đến ICD-10 tương ứng.

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

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

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

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

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

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

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

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

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ị mã khoa trong cơ sở KCB. Căn cứ: QĐ 2010/QĐ-BYT (19/6/2025).

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ị 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 giá trị phân hạng cơ sở KCB theo TT 06/2024/TT-BYT.

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

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

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

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

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

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

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 giá trị mã chẩn đoán cho VN Core, bao gồm:

• ICD-10 WHO (bắt buộc theo QĐ 4469/QĐ-BYT 28/10/2020, bổ sung bởi QĐ 98/QĐ-BYT 14/01/2022) — 15.026 mã
• SNOMED CT IPS Terminology — Clinical Findings (tùy chọn, miễn phí theo CC-BY-4.0) — 36.349 mã trong VN subset
• YHCT Mã U — Bệnh danh y học cổ truyền (QĐ 2552/QĐ-BYT 12/8/2025, QĐ 3080/QĐ-BYT 26/9/2025) Binding extensible — cho phép dual/triple coding: ICD-10 + SNOMED CT + YHCT. Lưu ý: Mã U YHCT KHÔNG PHẢI ICD-10, là hệ thống mã quốc gia riêng. ICD-11 đang trong Phase II lộ trình 2026, chưa thay thế ICD-10 tại Việt Nam.

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

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

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

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

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

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

Tập 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ả (NGUON_CTRA). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024).

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.

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

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ị 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ị 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ị 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ị tuyến y tế Việt Nam (chỉ bao gồm tuyến đang hoạt động).

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

Tập giá trị 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.

Bộ mã bài thuốc theo thể lâm sàng Y học cổ truyền Việt Nam. Bao gồm 522 bài thuốc. Mỗi bài thuốc gắn với thể lâm sàng và bệnh danh YHCT (Mã U). Căn cứ theo Quyết định 3080/QĐ-BYT ngày 26/9/2025 — Phụ lục VI. / Vietnamese Traditional Medicine (YHCT) prescription catalog organized by clinical patterns. Contains 522 traditional prescriptions, each linked to YHCT clinical syndromes and Mã U disease codes. Per QĐ 3080/QĐ-BYT (26/9/2025) — Appendix VI.

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). Bao gồm 15.026 mã (2.043 types + 12.983 diseases), song ngữ Việt-Anh.

Căn cứ pháp lý:

• QĐ 4469/QĐ-BYT (28/10/2020) — Bảng phân loại quốc tế ICD-10 và Hướng dẫn mã hóa
• QĐ 4400/QĐ-BYT (23/10/2020) — Bảng phân loại ICD-10 tại CSKCB
• QĐ 98/QĐ-BYT (14/01/2022) — Bổ sung mã ICD-10 liên quan COVID-19 (U07.1, U07.2)
• TT 01/2025/TT-BYT — Hướng dẫn thực hiện BHYT, Phụ lục danh mục ICD-10

Vietnam localization of WHO ICD-10, published by Ministry of Health. Contains 15,026 codes (2,043 types + 12,983 diseases), bilingual Vietnamese-English. Source: https://icd.kcb.vn (Cục Khám Chữa Bệnh). Note: ICD-11 is in Phase II roadmap for 2026, not yet replacing ICD-10 in Vietnam.

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 Cục KCB — BYT Việt Nam phát hành. Dựa trên CMS ICD-9-CM V32.

Căn cứ pháp lý:

• QĐ 387/QĐ-BYT (05/02/2026) — Bảng phân loại quốc tế ICD-9-CM mới nhất (thay thế QĐ 4440/QĐ-BYT 2020)
• QĐ 4466/QĐ-BYT (28/10/2020) — Ánh xạ Danh mục DVKT VN ↔ ICD-9-CM
• QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu BHXH, trường MA_PTTT (mã phẫu thuật thủ thuật)

Vietnam localization of ICD-9-CM Volume 3, published by Ministry of Health. Contains 3,882 procedure codes, bilingual Vietnamese-English. Source: https://icd.kcb.vn (Cục Khám Chữa Bệnh) + CMS V32. Used in conjunction with VN Medical Service catalog (TT 20/2014, TT 39/2018) for BHYT claims.

Bộ mã bệnh danh Y học cổ truyền Việt Nam và các thể lâm sàng, sử dụng hệ thống Mã U. Bao gồm 38 bệnh danh với 228 mã (bệnh danh + thể lâm sàng). Mỗi bệnh danh YHCT có ánh xạ đến ICD-10 tương ứng. Mỗi thể lâm sàng có mã hóa riêng (VD: U62.392.5.01 = Yêu thống — Thể hàn thấp). Căn cứ: QĐ 2552/QĐ-BYT (12/8/2025) — Phụ lục I. / Vietnamese Traditional Medicine (YHCT) disease and clinical syndrome classification using Mã U codes. Contains 38 diseases with 228 codes (diseases + clinical syndromes). Each YHCT disease maps to ICD-10 codes. Each clinical syndrome has a unique encoded value. Per QĐ 2552/QĐ-BYT (12/8/2025) — Appendix I.

Danh mục chuyên khoa y tế Việt Nam sử dụng trong hệ thống khám chữa bệnh. Dựa trên phân tuyến chuyên môn kỹ thuật tại TT 43/2013/TT-BYT (28 chuyên khoa), bổ sung theo TT 21/2017/TT-BYT, phạm vi hành nghề tại TT 32/2023/TT-BYT (Điều 11, Phụ lục V — 19 nhóm hệ cơ quan, Phụ lục VI–XVII — phạm vi hành nghề chuyên biệt) và thực tế tổ chức khoa phòng tại các bệnh viện Việt Nam. Căn cứ: Luật KCB 2023 Điều 42, TT 43/2013/TT-BYT, TT 21/2017/TT-BYT, TT 32/2023/TT-BYT. / Vietnamese medical specialty list for healthcare practice scope classification. Based on TT 43/2013/TT-BYT (28 technical specialty chapters), TT 21/2017/TT-BYT (amendments), TT 32/2023/TT-BYT (Art.11, Appendix V–XVII) and hospital department organization. Per Medical Examination and Treatment Law 2023 Art.42.

Bộ mã chẩn đoán trong Y học cổ truyền Việt Nam, bao gồm bát cương, nguyên nhân gây bệnh, vệ khí dinh huyết, tạng phủ, phủ kỷ hằng, kinh chính, kinh cân, kinh biệt, bì bộ, bát mạch kỳ kinh và biệt lạc. Căn cứ theo Quyết định 2552/QĐ-BYT ngày 12/8/2025 — Phụ lục II. / CodeSystem for diagnostic categories in Vietnamese Traditional Medicine (YHCT), covering Eight Principles, etiology, Wei-Qi-Ying-Xue, Zang-Fu organs, extraordinary organs, 12 primary meridians, 12 sinew meridians, 12 divergent meridians, 12 cutaneous regions, 8 extraordinary vessels, and 15 collaterals. Per QĐ 2552/QĐ-BYT (12/8/2025) — Appendix II.

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. 2.964 chỉ số chia thành 5 nhóm:

• PL01: Huyết học — Truyền máu (1.022 chỉ số, mã 1000001–1001022)
• PL02: Sinh hóa (447 chỉ số, mã 1010001–1010447)
• PL03: Vi sinh (174 chỉ số, mã 1020001–1020174)
• PL04: Giải phẫu bệnh (81 chỉ số, mã 1060001–1060081)
• PL05: Chẩn đoán hình ảnh (1.240 chỉ số, mã 1070001–1071240)

Mỗi chỉ số có ánh xạ LOINC (100% coverage) để đảm bảo interoperability quốc tế. Khi coding trong FHIR Observation, ưu tiên sử dụng LOINC code (system = http://loinc.org) và sử dụng mã CLS VN làm identifier bổ sung.

Vietnam National Clinical Lab Indicator Code List (Batch 1), per QĐ 1227/QĐ-BYT (11/04/2025). 2,964 indicators across 5 categories: Hematology (1,022), Biochemistry (447), Microbiology (174), Pathology (81), Diagnostic Imaging (1,240). Each indicator maps to LOINC (100% coverage). For FHIR coding, prefer LOINC (system = http://loinc.org); use CLS code as supplementary identifier.

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

Danh mục 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 696 quận/huyện theo hệ thống cũ (trước NQ 202/2025). Tất cả mã đều có status = deprecated. Dùng cho backward-compatibility với dữ liệu cũ. Mỗi mã có property province trỏ về mã tỉnh mới theo QĐ 19/2025.

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

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

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.

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 mã khoa trong cơ sở khám bệnh, chữa bệnh. Căn cứ: QĐ 2010/QĐ-BYT (19/6/2025) — Danh mục mã tạm thời dùng chung. Tham chiếu thêm: QĐ 130/QĐ-BYT → QĐ 4750 → QĐ 3176 (trường MA_KHOA). Nguồn dữ liệu: OHP Data Processor (production mapping, verified with QĐ 2010).

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. Hiệu lực từ 15/01/2021.

Vietnam Standard Classification of Occupations (VSCO 2020), issued per QĐ 34/2020/QĐ-TTg. 5-level hierarchy: Level 1 (skill level) + Levels 2-5 (specialization). ISCO-08 compatible at Levels 1-4; Level 5 is Vietnam-specific detail. Effective from 15 January 2021.

Bộ mã dược liệu và vật tư cổ truyền (DL, VTCT) Việt Nam. Bao gồm 442 vị thuốc. Bao gồm tên khoa học, nguồn gốc thực vật/động vật/khoáng vật. Căn cứ theo Quyết định 3080/QĐ-BYT ngày 26/9/2025 — Phụ lục V. / Vietnamese Traditional Medicine (YHCT) herbal medicine and traditional material catalog. Contains 442 medicinal substances including scientific names and plant/animal/mineral origins. Per QĐ 3080/QĐ-BYT (26/9/2025) — Appendix V.

Bộ mã huyệt châm cứu theo Y học cổ truyền Việt Nam. Bao gồm 466 huyệt với tên quốc tế. Có ánh xạ SNOMED CT (395 mã tham chiếu). Mỗi huyệt thuộc một đường kinh (Lung Meridian, Heart Meridian, v.v.). Căn cứ theo Quyết định 2552/QĐ-BYT ngày 12/8/2025 — Phụ lục III. / Vietnamese Traditional Medicine (YHCT) acupuncture point catalog. Contains 466 acupoints with international nomenclature. Includes SNOMED CT cross-references (395 reference codes). Each point belongs to a meridian channel. Per QĐ 2552/QĐ-BYT (12/8/2025) — Appendix III.

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ứ: Thông tư 06/2024/TT-BYT ngày 16/5/2024.

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

Bộ mã kỹ thuật Y học cổ truyền Việt Nam. Bao gồm 925 kỹ thuật, tham chiếu TT 23/2024/TT-BYT (danh mục dịch vụ kỹ thuật). Bao gồm: châm cứu, xoa bóp bấm huyệt, thuốc thang, và các kỹ thuật khác. Căn cứ theo Quyết định 2552/QĐ-BYT ngày 12/8/2025 — Phụ lục IV. / Vietnamese Traditional Medicine (YHCT) technique catalog. Contains 925 techniques cross-referenced with TT 23/2024/TT-BYT (medical service catalog). Includes acupuncture, massage/acupressure, herbal decoctions, and other traditional techniques. Per QĐ 2552/QĐ-BYT (12/8/2025) — Appendix IV.

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

Căn cứ pháp lý:

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

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

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

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

Danh mục loại hình cơ sở y tế theo Luật KCB 2023 (15/2023/QH15).

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

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

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.

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

Danh mục mã đối tượng đến khám bệnh, chữa bệnh (trường MA_DOITUONG_KCB) phục vụ việc gửi dữ liệu điện tử chi phí KCB BHYT. Căn cứ: QĐ 3276/QĐ-BYT ngày 17/10/2025. Thay thế Phụ lục 5 QĐ 824/QĐ-BYT (15/02/2023) và Phụ lục 5 QĐ 2010/QĐ-BYT (19/6/2025). Căn cứ pháp lý nền: Luật BHYT, 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 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).

Bộ mã pháp điều trị trong Y học cổ truyền Việt Nam. Bao gồm 77 pháp trị. Căn cứ theo Quyết định 3080/QĐ-BYT ngày 26/9/2025 — Phụ lục IV. / CodeSystem for treatment methods (therapeutic principles) in Vietnamese Traditional Medicine (YHCT). Contains 77 treatment methods. Per QĐ 3080/QĐ-BYT (26/9/2025) — Appendix IV.

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

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: NĐ 70/2015/NĐ-CP, NĐ 74/2025/NĐ-CP. Nguồn dữ liệu: OHP Data Processor (production mapping).

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

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

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

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

Bộ mã triệu chứng theo thể lâm sàng Y học cổ truyền Việt Nam. Bao gồm 1451 triệu chứng. Mỗi triệu chứng gắn với thể lâm sàng YHCT (hàn, nhiệt, hư, thực, v.v.). Căn cứ theo Quyết định 3080/QĐ-BYT ngày 26/9/2025 — Phụ lục I. / Vietnamese Traditional Medicine (YHCT) symptom catalog organized by clinical patterns. Contains 1451 symptoms, each linked to YHCT clinical syndromes (cold/hàn, heat/nhiệt, deficiency/hư, excess/thực, etc.). Per QĐ 3080/QĐ-BYT (26/9/2025) — Appendix I.

Bộ mã triệu chứng vọng chẩn lưỡi trong Y học cổ truyền Việt Nam, bao gồm hình thể lưỡi, chất lưỡi và rêu lưỡi. Căn cứ theo Quyết định 3080/QĐ-BYT ngày 26/9/2025 — Phụ lục II. / CodeSystem for tongue diagnosis observations in Vietnamese Traditional Medicine (YHCT), covering tongue body, tongue substance, and tongue coating. Per QĐ 3080/QĐ-BYT (26/9/2025) — Appendix II.

Bộ mã triệu chứng thiết chẩn mạch trong Y học cổ truyền Việt Nam. Căn cứ theo Quyết định 3080/QĐ-BYT ngày 26/9/2025 — Phụ lục III. / CodeSystem for pulse diagnosis types in Vietnamese Traditional Medicine (YHCT). Per QĐ 3080/QĐ-BYT (26/9/2025) — Appendix III.

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 (CCHN), Nghị định 96/2023/NĐ-CP. / Vietnamese healthcare professional qualification levels covering medical degrees, specialist certifications, and academic titles used in the healthcare system. Per Medical Examination and Treatment Law 2023 Art.19-27, Decree 96/2023/NĐ-CP.

Danh mục tuyến y tế Việt Nam theo mô hình 2 cấp mới (NQ 202/2025/QH15). Tuyến Huyện giữ lại ở trạng thái inactive cho dữ liệu legacy.

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

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

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

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

Hệ thống mã vật tư y tế, dùng để định danh các vật tư tiêu hao và thiết bị y tế trong hệ thống thanh toán BHYT. Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024), NĐ 74/2025/NĐ-CP.

Hệ thống định danh Số Chứng chỉ hành nghề y, do Bộ Y tế cấp. Format không cố định, tùy từng đợt cấp phép. Căn cứ: Luật KCB 2023 (15/2023/QH15), Điều 19-27.

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.

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

• CCCD 12 chữ số: hỗ trợ từ 15/8/2025 (NĐ 188/2025/NĐ-CP, hiệu lực 15/8/2025)
• Mã số BHXH 10 chữ số: từ 01/4/2021
• Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021 Bên triển khai cần xác minh chính sách BHXH hiện hành trước khi coi CCCD là mã BHYT duy nhất. Căn cứ: Luật BHYT 2008 sửa đổi 2014, NĐ 188/2025/NĐ-CP, QĐ 3176/QĐ-BYT (29/10/2024).

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

5 nhóm:

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

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

Danh gia YHCT cho benh nhan Yeu thong the han thap. Tu chan: Vong (luoi nhot — han thap), Thiet (mach tram — han). Lien ket voi ExampleConditionYHCTYeuThong (chan doan YHCT). Minh hoa cach dung component cho danh gia da chieu per QD 3080/QD-BYT.

Ghi nhan su dung catheter tinh mach ngoai vi 22G cho benh nhan noi tru. Lien ket voi ExampleDeviceVTYT (catheter) va ExamplePatientNguyenVanAn. Minh hoa cach ghi nhan VTYT tieu hao trong luot dieu tri.

Giai trinh quyen loi BHYT cho luot noi tru viem ruot thua tai BV Cho Ray. Adjudication: de nghi 14.370.000, du DK 12.600.000, cung chi tra 2.520.000, BHYT thanh toan 10.080.000. Mapping OHP ExplanationOfBenefit: submitted/eligible/copay/benefit. Lien ket voi ExampleClaimBHYT (yeu cau goc) va ExampleClaimResponseBHYT (ket qua giam dinh).

Bác sĩ chuyên khoa II — đầy đủ: CCCD, CCHN, 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: chỉ có CCHN và họ tên.

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

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

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

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 (legacy) cho backward-compatible.

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

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.

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.

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.

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

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

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

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.

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

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

Thẻ BHYT format legacy — 15 ký tự (2 chữ mã đối tượng + 13 số). Đối tượng: Hưu trí (HT). Minh họa backward-compatible.

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

Trạm y tế phường — tuyến xã, công lập, không phân hạng.

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.

Ví dụ vật tư y tế tiêu hao (VTYT) — kim luồn tĩnh mạch 22G. Dùng trong thanh toán BHYT: mã VTYT, nhóm VTYT. Mapping OHP: MA_VAT_TU, TEN_VAT_TU per QĐ 3176/QĐ-BYT, NĐ 74/2025/NĐ-CP.

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

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

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 4 nhóm per QĐ 697/QĐ-BYT (19/3/2026).

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

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

Đơ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.