Profile Bundle type=collection làm PAYLOAD cho chứng nhận sức khoẻ 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 khoẻ (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Đ 23/2025/NĐ-CP (nhánh chữ ký điện tử chung); NĐ 68/2024/NĐ-CP (nhánh chữ ký số chuyên dùng công vụ khi issuer là cơ quan nhà nước/đơn vị sự nghiệp công lập). Chữ ký JWS/JWT của SHC/SHL là cơ chế kỹ thuật và không tự được coi là chữ ký điện tử hợp lệ theo pháp luật; NĐ 137/2024/NĐ-CP chỉ áp dụng thêm nếu giao dịch/hệ thống thuộc phạm vi cơ quan nhà nước.

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 (hiệu lực 01/01/2027, chưa áp dụng); 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. PROFILE CHA — bản 0.10.0 KHÔNG hỗ trợ authoring trực tiếp trên profile này. Dữ liệu thật phải conform một profile con theo miền: VNCoreDiagnosticReportLab (xét nghiệm), VNCoreDiagnosticReportImaging (chẩn đoán hình ảnh), VNCoreDiagnosticReportPathology (giải phẫu bệnh). Vì vậy profile này không có example trực tiếp. / PARENT PROFILE — direct authoring is not supported in 0.10.0; conform to a domain child profile instead. 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, Hoá 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 (hiệu lực 01/01/2027, chưa áp dụng); 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 (hiệu lực 01/01/2027, chưa áp dụng); 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, hoá 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ã, Hoá 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 (hiệu lực 01/01/2027, chưa áp dụng); 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.

Bản ghi cấu trúc cho các ô ký/xác nhận của bảng kê chi phí khám bệnh, chữa bệnh theo mẫu QĐ 697/QĐ-BYT.

Bảng kê là chứng từ do cơ sở khám bệnh, chữa bệnh lập và có ba ô ký: người lập bảng kê, xác nhận của người bệnh, và kế toán viện phí. Số liệu chi phí nằm ở Invoice (VNCoreCostStatementInvoice); profile này chỉ chịu trách nhiệm phần ai được ghi nhận là attester, thời điểm và đối tượng attestation — tách carrier dữ liệu khỏi chứng từ ký để một bên sửa không âm thầm làm sai bên kia (ADR-0021 quyết định D2).

Điều 2 khoản 2 QĐ 697/QĐ-BYT cho hai cách lưu: bản điện tử ký số, hoặc bản giấy ký tay rồi scan kèm ký số xác thực. Cách thứ hai dùng DocumentReference thay cho profile này — cả hai đều hợp lệ, chọn cách nào là quyết định của bên triển khai chứ không phải của bộ hướng dẫn.

Ba ô ký ánh xạ thành ba vai trò trên attester. Một attester có thể khai nhiều vai trò khi cùng một người xác nhận đảm nhiệm nhiều vai trò; vì vậy ba vai trò có thể nằm trên hai hoặc ba attester:

Các mã vai trò là mã kỹ thuật do VN Core đặt cho hợp đồng trao đổi, không phải mã do QĐ 697/QĐ-BYT ban hành. Ô billing-confirmation cũng dùng cho người phụ trách đơn vị ký thay tại Trạm y tế tuyến xã và tương đương chưa có kế toán viện phí, theo phần hướng dẫn mẫu. Profile không khẳng định ba vai trò phải do ba người khác nhau thực hiện. Mỗi khai báo vai trò có thể ghi thời điểm riêng tại attestedAt; nếu các lần xác nhận khác thời điểm thì không gộp vào attester.time.

Chữ ký số theo QĐ 697/QĐ-BYT và nhánh chung tại NĐ 23/2025/NĐ-CP không đặt trên Composition — FHIR R4 không có Composition.signature. Đặt ở Provenance.signature với target trỏ bản ký này (dùng khi lưu từng chứng từ rời), hoặc ở Bundle.signature khi đóng gói thành document bundle để gửi đi. attester chỉ ghi ai xác nhận và lúc nào, không chứa chữ ký; conformance với profile này không tự chứng minh ba chữ ký hợp lệ. NĐ 68/2024/NĐ-CP áp dụng khi cơ sở y tế công lập dùng chữ ký số chuyên dùng công vụ; NĐ 137/2024/NĐ-CP chỉ bổ sung khi giao dịch/hệ thống thuộc phạm vi cơ quan nhà nước. / The structured attestation record for the itemized healthcare cost statement of Decision 697/QĐ-BYT.

The statement is a document the facility issues, carrying three signature blocks: the preparer, the patient's confirmation, and the billing accountant. The monetary content lives on Invoice (VNCoreCostStatementInvoice); this profile records the declared attesters, time, and target — keeping the attestation record separate from the data carrier so that editing one cannot silently invalidate the other (ADR-0021, decision D2). Article 2(2) also permits a paper original signed by hand and scanned with an authenticating digital signature; that variant uses DocumentReference instead. Structural conformance does not by itself prove that any signature is legally valid.

Bản Giấy chứng sinh dạng tệp (PDF hoặc XML) đã ký số, dùng cho cả trường hợp sinh thường và mang thai hộ.

Quan hệ với Composition. VNCoreCompositionBirthCertificate giữ dữ liệu CÓ CẤU TRÚC để hệ thống đọc và liên thông; profile này giữ BẢN TÀI LIỆU để lưu trữ, đối chiếu và chứng minh chữ ký. Hai thứ không thay nhau: mất bản ký thì không chứng minh được tính toàn vẹn, mất bản cấu trúc thì không liên thông được sang Phần mềm dịch vụ công theo NĐ 63/2024/NĐ-CP.

Một profile cho cả hai trường hợp. Khác với lớp Composition, ở đây tệp đã ký là một khối nhị phân — cấu trúc bốn bên của mang thai hộ nằm bên trong nội dung tệp, không ảnh hưởng tới siêu dữ liệu tham chiếu. Tách hai profile chỉ để đổi một câu mô tả là bày vẽ không cần thiết.

Định danh dùng chung sid/gcs với Composition — cùng một giấy chứng sinh, cùng một mã.

Mức giá của một dịch vụ khám bệnh, chữa bệnh tại một cơ sở, kèm mốc hiệu lực và đường tra ngược về quyết định phê duyệt.

Vì sao tách khỏi ChargeItem. VNCoreChargeItem chỉ truy vết chi phí này thuộc đợt khám nào, do dịch vụ nào sinh ra. Giá là chuyện khác: cùng một dịch vụ có mức giá khác nhau giữa các cơ sở và thay đổi theo từng đợt phê duyệt. Gộp giá vào ChargeItem sẽ buộc mỗi dòng chi phí tự mang mức giá — không tra ngược được về quyết định, và hồ sơ đã quyết toán mất khả năng đối chiếu mức giá tại thời điểm phát sinh.

Không còn bảng giá quốc gia thống nhất theo hạng bệnh viện. Điều này quan trọng với bên đang triển khai: TT 21/2023/TT-BYT — thông tư từng ban hành khung giá của Nhà nước phân theo hạng bệnh viện — đã hết hiệu lực từ 01/01/2025 theo Điều 11 khoản 2 điểm b TT 21/2024/TT-BYT (cùng đợt với TT 13/2023/TT-BYT và TT 22/2023/TT-BYT). TT 21/2024/TT-BYT thay bằng phương pháp định giá: giá cụ thể do cấp có thẩm quyền phê duyệt cho từng cơ sở, cấu thành từ chi phí trực tiếp, tiền lương, chi phí quản lý và khấu hao. Vì vậy profile này không mô hình hoá trục 'hạng bệnh viện'; thứ phải lưu là cơ sở nào, mức nào, hiệu lực từ bao giờ, theo quyết định nào.

Phạm vi. Chuẩn hoá cách công bố một mức giá và điều kiện áp dụng. Bộ hướng dẫn không nạp bảng giá của bất kỳ cơ sở nào — mức giá do từng cơ sở được phê duyệt riêng và thay đổi theo đợt, nạp vào đây là sai chỗ và chắc chắn lạc hậu. Mỗi cơ sở tự công bố ChargeItemDefinition của mình.

Ranh giới pháp lý. Luật Giá 16/2023/QH15 (được sửa bởi Luật 140/2025/QH15, hợp nhất tại VBHN 25/VBHN-VPQH năm 2026) và NĐ 85/2024/NĐ-CP (được sửa bởi NĐ 128/2026/NĐ-CP) là khung quản trị, thẩm quyền và trình tự về giá. Chuỗi văn bản này không trực tiếp bắt buộc các cardinality FHIR derivedFromUri, effectivePeriod hay propertyGroup; các ràng buộc đó là lựa chọn thiết kế truy vết của VN Core. TT 21/2024/TT-BYT mới là nguồn chuyên ngành trực tiếp cho phương pháp định giá dịch vụ khám bệnh, chữa bệnh.

Cách dùng. ChargeItem.definitionCanonical trỏ tới bảng giá đã áp, nhờ đó từ một dòng chi phí tra ngược được đúng mức giá và đúng quyết định phê duyệt. / The price of a healthcare service at a given facility, with its effective period and a traceable link to the approving decision.

Important for implementers: Circular 21/2023/TT-BYT — which set a national price framework by hospital rank — was repealed effective 01 January 2025 by Article 11(2)(b) of Circular 21/2024/TT-BYT. There is no longer a single national price table by rank; prices are approved per facility using the costing method of Circular 21/2024/TT-BYT. This profile therefore models facility, amount, effective period and approving decision — not hospital rank. The guide ships no facility price list.

Bảng kê chi phí khám bệnh, chữa bệnh theo mẫu QĐ 697/QĐ-BYT: chứng từ do cơ sở khám bệnh, chữa bệnh lập cho một lượt khám chữa bệnh của một người bệnh, lưu cùng hồ sơ bệnh án và cung cấp cho người bệnh.

Vì sao là Invoice chứ không phải Claim. Bảng kê là chứng từ giữa cơ sở và người bệnh, không phải hồ sơ đề nghị thanh toán gửi cơ quan bảo hiểm; số tiền trên đó là số cơ sở tự tính, chưa qua giám định. Quyết định:

• issuer = cơ sở KCB, recipient = người bệnh — đúng cặp actor của văn bản.
• Không bắt buộc liên kết bảo hiểm, nên bảng kê của người không có thẻ BHYT (QĐ 697/QĐ-BYT Phần Hai) biểu diễn được tự nhiên. Claim.insurance là 1..* nên không làm được điều này mà không tạo Coverage giả.

Hồ sơ đề nghị thanh toán gửi cơ quan bảo hiểm dùng VNCoreClaim: một đợt KCB là một Claim với một MA_LK. Khi đổi thẻ giữa đợt hoặc có nhiều thẻ/quyền lợi đồng thời, Claim đó mang nhiều insurance, đúng một focal. Claim.related vẫn tuỳ chọn theo ngữ nghĩa FHIR; VN Core không đặt nghĩa vụ hỗ trợ tối thiểu, không dùng nó để hướng dẫn chia đợt hoặc sinh MA_LK mới, và chưa quy định mô hình FHIR cho hồ sơ điều chỉnh/bổ sung trong 0.10.0. Bản ký của bảng kê dùng Composition hoặc DocumentReference. Chi tiết: ADR-0021, sửa đổi 14/09/2026.

Cách biểu diễn 13 cột của mẫu:

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 khoá lõi ổn định khi có và mô hình hoá 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.

Quy tắc định danh tối thiểu (invariant vn-patient-identifier-minimum): mỗi Patient phải có ít nhất một định danh dùng được — số định danh cá nhân/CCCD, hộ chiếu, hoặc giấy khai sinh. Nếu không có định danh quốc gia nào thì phải có mã bệnh nhân của cơ sở kèm lý do.

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) — không cần khai identifier[CCCD] rỗng
• Người nước ngoài: dùng identifier[HC] — không cần khai identifier[CCCD] rỗng
• Người bệnh cấp cứu chưa rõ thân nhân: identifier[MRN] của cơ sở + vn-ext-force-majeure-reason. Có thể ghi thêm data-absent-reason trên CCCD để cho biết đã hỏi nhưng không có; riêng DAR không thay thế cặp MRN + lý do và không tự thoả invariant

Từ 0.10.0, identifier[CCCD] là 0..1 MS thay vì 1..1: nghĩa vụ ghi CCCD khi biết được giữ bằng Must Support và invariant trên, nhưng không còn buộc tạo Identifier rỗng cho người thực sự không thuộc hệ CCCD (kiểm toán 31/07/2026 — analysis/77 mục B4).

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ứ:

• Luật 20/2023/QH15 — Luật Giao dịch điện tử, đọc theo sửa đổi tại Luật 60/2024/QH15
• Luật 60/2024/QH15 — Luật Dữ liệu, nền tảng quản trị dữ liệu số
• 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 (hiệu lực 01/01/2027, chưa áp dụng) — 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 hoá/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Đ 23/2025/NĐ-CP — chữ ký điện tử và dịch vụ tin cậy
• NĐ 68/2024/NĐ-CP — áp dụng khi cơ sở y tế công lập dùng chữ ký số chuyên dùng công vụ
• NĐ 137/2024/NĐ-CP — chỉ khi giao dịch thuộc phạm vi cơ quan nhà nước/hệ thống thông tin phục vụ giao dịch điện tử
• 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 hoá 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ã hoá 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 đó. Căn cứ hiện hành là TT 06/2026/TT-BYT (hiệu lực 01/07/2026) và hướng dẫn kỹ thuật QĐ 1849/QĐ-BYT; QĐ 4469/QĐ-BYT và QĐ 98/QĐ-BYT chỉ còn là provenance của edition lịch sử. 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_CHINH (01 mã bệnh chính) và MA_BENH_KT (tối đa 12 mã bệnh kèm theo).

Profile Condition cho chẩn đoán tại Việt Nam. Hỗ trợ mã hoá 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ứ hiện hành: TT 06/2026/TT-BYT (hiệu lực 01/07/2026) và QĐ 1849/QĐ-BYT về mã hoá ICD-10; QĐ 130/QĐ-BYT, QĐ 4750/QĐ-BYT, QĐ 3176/QĐ-BYT và QĐ 1931/QĐ-BYT cho lớp dữ liệu đầu ra KCB. QĐ 4469/QĐ-BYT và QĐ 98/QĐ-BYT chỉ còn là provenance edition lịch sử.

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 hoá 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 hoá 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 hoá 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 dành riêng cho Organization đại diện một cơ sở khám bệnh, chữa bệnh thuộc phạm vi điều chỉnh của Luật 15/2023/QH15 Điều 48-56. Profile yêu cầu số giấy phép hoạt động và trạng thái pháp lý của giấy phép đó.

Vì sao tách profile con thay vì siết profile cha. Nghĩa vụ có giấy phép hoạt động (Điều 49 khoản 1) chỉ áp cho cơ sở KCB. VNCoreOrganization còn phục vụ nhà thuốc, cơ sở y tế dự phòng, đơn vị kiểm nghiệm, cơ quan quản lý, cơ quan BHXH và các tổ chức xuất hiện trong dữ liệu y tế nhưng không thuộc diện cấp giấy phép hoạt động KCB. Đưa identifier[OperatingLicense] 1..1 lên profile cha sẽ biến mọi Organization thành cơ sở KCB — sai pháp lý và phá dữ liệu hiện có.

Giấy phép gắn với địa điểm, không phải pháp nhân. Điều 50 khoản 1: mỗi cơ sở KCB có một giấy phép hoạt động; cơ sở có thêm địa điểm khác thì mỗi địa điểm phải có giấy phép riêng. Một pháp nhân nhiều địa điểm được biểu diễn bằng nhiều Organization conform profile này, mỗi Organization mang giấy phép của địa điểm mình.

Giấy phép không có thời hạn. Cũng tại Điều 50 khoản 1. Vì vậy hiệu lực KHÔNG suy được từ identifier.period — nó phụ thuộc quyết định đình chỉ (Điều 55) hoặc thu hồi (Điều 56), mang trong extension vn-ext-operating-license-status. Profile cố ý KHÔNG dùng Organization.active làm trạng thái pháp lý: active là cờ vận hành của bản ghi.

Chuyển tiếp. Cơ sở đang hoạt động theo giấy phép cấp theo Luật KCB 40/2009/QH12 được tiếp tục hoạt động theo giấy phép đã cấp mà không phải chuyển đổi hình thức tổ chức (NĐ 96/2023/NĐ-CP Điều 144 khoản 1). Những giấy phép đó conform profile này với trạng thái active.

Căn cứ:

• Luật 15/2023/QH15 — Điều 49 (điều kiện hoạt động), Điều 50 (giấy phép hoạt động), Điều 51 (thẩm quyền), Điều 55 (đình chỉ), Điều 56 (thu hồi)
• NĐ 96/2023/NĐ-CP — Điều 61 (thủ tục cấp mới, công bố), Điều 78 (đình chỉ, thu hồi), Điều 144 (chuyển tiếp giấy phép hoạt động)

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. Đây là profile CƠ SỞ CHUNG cho mọi tổ chức trong dữ liệu y tế. Cơ sở khám bệnh, chữa bệnh thuộc phạm vi Luật 15/2023/QH15 Điều 48-56 phải conform thêm profile con VNCoreKCBOrganization để mang số giấy phép hoạt động và trạng thái của giấy phép. 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 hoá 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.

Đơn vị bàn giao của bảng kê chi phí khám bệnh, chữa bệnh theo QĐ 697/QĐ-BYT: một Bundle kiểu document gói bản ghi attestation, bảng kê, các dòng chi phí và bằng chứng ký (nếu có) vào cùng một khối trao đổi.

Vì sao cần một Bundle riêng. Invoice mang số liệu, Composition mang ba ô ký — nhưng khi gửi sang cơ sở khác, sang cổng BHXH hoặc lưu vào bệnh án điện tử thì cái được ký và lưu phải là một khối duy nhất. FHIR R4 chỉ ký được ở mức Bundle (Bundle.signature) hoặc qua Provenance; ký từng resource rời rồi ghép lại không chứng minh được rằng đúng tập đó đã được ký cùng nhau.

Thứ tự entry. Composition là entry đầu tiên (ràng buộc vn-bundle-document-first kế thừa từ VNCoreBundle), sau đó là Invoice mà bản ký trỏ tới, rồi các ChargeItem, Account, Patient, Organization và Provenance.

Ranh giới chữ ký. Bundle.signature là carrier kỹ thuật tuỳ chọn cho chữ ký trên toàn khối; Composition.attester chỉ ghi nhận ai attested và không chứa bằng chứng chữ ký. QĐ 697/QĐ-BYT Điều 2 khoản 2 còn cho phép nhánh giấy ký tay rồi scan và ký số xác thực. Vì vậy, conformance với profile này không tự chứng minh chứng từ đã được ký hợp lệ. Exchange contract phải chỉ rõ nhánh áp dụng, byte scope, chứng thư, timestamp, revocation và bằng chứng verification theo NĐ 23/2025/NĐ-CP; NĐ 68/2024/NĐ-CP áp dụng cho nhánh chữ ký số chuyên dùng công vụ khi phù hợp, còn NĐ 137/2024/NĐ-CP chỉ áp dụng trong phạm vi giao dịch/hệ thống cơ quan nhà nước.

Profile Bundle type=document đóng gói tài liệu khám sức khoẻ đị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 khoẻ 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 hoá HL7 FHIR).

Profile Bundle type=document đóng gói Sổ Sức khoẻ đ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).

Một khoản chi phí phát sinh trong đợt khám bệnh, chữa bệnh, gắn với sự kiện lâm sàng sinh ra nó.

Vì sao cần. Invoice trong FHIR R4 không có phần tử nào trỏ về Encounter — bảng kê chi phí (VNCoreCostStatementInvoice) vì thế chỉ nối được với đợt khám bằng quy ước trùng MA_LK. Quy ước chuỗi không kiểm được bằng máy và mỗi hệ thống tự diễn giải một kiểu. ChargeItem.context là đường liên kết chính thức của FHIR từ dòng chi phí về sự kiện lâm sàng, còn ChargeItem.service trỏ thẳng tới y lệnh hoặc thủ thuật đã sinh ra khoản đó.

Vị trí trong vòng đời (ADR-0021, sửa đổi 13/09/2026): Encounter → ChargeItem → Invoice (bảng kê cho người bệnh) → Claim (đề nghị thanh toán; có thể mang nhiều insurance nối tiếp hoặc đồng thời, đúng một focal) → ClaimResponse (kết quả giám định) → PaymentReconciliation. Trước 0.10.0 mắt xích đầu tiên bỏ trống.

Phạm vi cố ý hẹp. Profile này chỉ chuẩn hoá phần truy vết: chi phí này thuộc đợt khám nào, do dịch vụ nào sinh ra, số lượng bao nhiêu. Việc định giá nằm ở VNCoreChargeItemDefinition: theo TT 21/2024/TT-BYT, giá cụ thể do cấp có thẩm quyền phê duyệt cho từng cơ sở — không còn khung giá quốc gia thống nhất theo hạng bệnh viện kể từ 01/01/2025.

ChargeItem là bước trung gian, không thay thế bảng kê: con số đối soát với cơ quan bảo hiểm xã hội vẫn nằm ở Invoice và Claim. / A charge arising during an episode of care, linked to the clinical event that produced it.

FHIR R4 Invoice has no element referencing an Encounter, so the cost statement can only be tied to the episode by a shared MA_LK string — a convention no validator can check. ChargeItem.context and .service provide the formal link. Scope is deliberately narrow: traceability only. Pricing lives on VNCoreChargeItemDefinition, following the per-facility costing method of Circular 21/2024/TT-BYT.

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ã hoá 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/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 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

Tài liệu Giấy chứng sinh cho trường hợp MANG THAI HỘ theo QĐ 2919/QĐ-BYT Phụ lục II (hiệu lực 01/10/2025).

Vì sao profile riêng chứ không dùng chung với sinh thường. Phụ lục II mô tả BỐN bên — vợ và chồng bên nhờ mang thai hộ, vợ và chồng bên mang thai hộ — thay vì một người mẹ. Người sinh con và người sẽ nuôi con là hai người khác nhau, nên RelatedPerson.relationship của họ với trẻ cũng khác nhau. Nhét cả hai tình huống vào một profile sẽ buộc phải nới lỏng đúng những ràng buộc khiến profile có ích.

CẢNH BÁO — không sinh XML từ mô hình này. Phụ lục II có sáu cặp chỉ tiêu trùng tên mang hai vai trò khác nhau (chi tiết trong VNSurrogacyBirthCertificateLM). Composition này ghi được dữ liệu ở dạng FHIR, nhưng KHÔNG được dùng để sinh tài liệu XML theo tên chỉ tiêu công bố: bên nhận sẽ không phân biệt được dân tộc của vợ với dân tộc của chồng, hay nơi cư trú của bên nào.

Thiếu sót của Phụ lục II so với Phụ lục I. Phụ lục II không công bố TINH_TRANG_CON (tình trạng trẻ — ở Phụ lục I là trường BẮT BUỘC, yêu cầu ghi cụ thể khi có dị dạng, dị tật) và không công bố NGAY_CS (ngày cấp) dù mẫu giấy vẫn có dòng ngày. Profile này vì vậy KHÔNG bắt buộc date như profile sinh thường — không có chỉ tiêu nguồn để lấy — nhưng vẫn giữ 1..1 theo ràng buộc của chính resource Composition trong R4, và ngày lấy từ thời điểm lập tài liệu.

Tài liệu Giấy chứng sinh do cơ sở khám bệnh, chữa bệnh cấp theo QĐ 2919/QĐ-BYT (hiệu lực 01/10/2025), trường hợp sinh thường.

Vì sao là Composition chứ không phải DocumentReference đơn thuần. Giấy chứng sinh là dữ liệu CÓ CẤU TRÚC được liên thông sang Phần mềm dịch vụ công theo NĐ 63/2024/NĐ-CP, không chỉ là một tệp đính kèm. Composition giữ phần đầu tài liệu và các tham chiếu có cấu trúc (trẻ, mẹ, cơ sở, người ký); bản PDF/XML đã ký số nằm ở VNCoreDocumentReferenceBirthCertificate.

Định danh dùng sid/gcs, KHÔNG dùng sid/gks. Giấy chứng sinh do cơ sở khám bệnh, chữa bệnh cấp ngay sau sinh; Giấy khai sinh do Uỷ ban nhân dân cấp sau đó theo thủ tục hộ tịch. Khác cơ quan cấp, khác thời điểm, khác cấu trúc số — xem VNGCSNS.

Chưa khoá mã loại tài liệu. type dùng text = "Giấy chứng sinh"; QĐ 2919/QĐ-BYT không ban hành mã loại tài liệu, và tự đặt một mã rồi trình bày như mã pháp định là điều IG này tránh. Phân biệt sinh thường với mang thai hộ dựa vào profile, không dựa vào mã.

Trường hợp mang thai hộ dùng profile riêng VNCoreCompositionSurrogacyBirthCertificate: schema Phụ lục II có bốn bên (vợ/chồng bên nhờ mang thai hộ, vợ/chồng bên mang thai hộ) chứ không phải một người mẹ, nên author/attester/tham chiếu chủ thể khác hẳn.

Profile Composition cho tài liệu khám sức khoẻ định kỳ / khám sàng lọc (Sổ Sức khoẻ đ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 khoẻ. 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 khoẻ điện tử trên VNeID
• QĐ 3176/QĐ-BYT — chuẩn dữ liệu (đặc tả trường)
• NĐ 23/2025/NĐ-CP — chữ ký điện tử và dịch vụ tin cậy nói chung
• NĐ 68/2024/NĐ-CP — chữ ký số chuyên dùng công vụ khi cơ sở y tế công lập sử dụng nhánh này
• NĐ 137/2024/NĐ-CP — chỉ bổ sung cho giao dịch/hệ thống thuộc phạm vi cơ quan nhà nước

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ứ khung: Luật 20/2023/QH15 (Giao dịch điện tử, đã được Luật 60/2024/QH15 sửa đổi); 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 khoẻ đ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 hoá 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, 67 mã liệt kê (61 dòng STT và sáu mã con), á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.

Theo dõi một kiến nghị của cơ sở khám bệnh, chữa bệnh đề nghị xem xét lại việc TỪ CHỐI THANH TOÁN hoặc việc THU HỒI chi phí khám bệnh, chữa bệnh bảo hiểm y tế.

Căn cứ pháp lý. NĐ 188/2025/NĐ-CP Điều 51 khoản 3: cơ sở khám bệnh, chữa bệnh "có quyền kiến nghị cơ quan bảo hiểm xã hội xem xét lại việc từ chối thanh toán … hoặc kiến nghị cơ quan có thẩm quyền xem xét, giải quyết theo quy định của pháp luật". Điều 52 khoản 4 lặp lại quyền đó cho việc thu hồi. Điều 53 quy định trách nhiệm các bên và nói tới kết quả giải quyết cuối cùng.

Vì sao profile riêng chứ không mở rộng VNCoreTask. VNCoreTask đã khoá focus vào VNCoreServiceRequest hoặc VNCoreMedicationRequest — hai luồng chuyển người bệnh và cấp phát thuốc. Kiến nghị chi phí nhắm vào ClaimResponse hoặc PaymentReconciliation, không nằm trong tập đó; kế thừa sẽ buộc phải nới focus của profile cha và làm loãng chính ràng buộc khiến nó hữu ích.

Vì sao dùng Task mà không phải resource khác. Đây là quyết định ánh xạ CỤC BỘ của VN Core: nghị định quy định quyền và trách nhiệm, không chỉ định resource FHIR nào. Task được chọn vì quy trình này là một công việc có vòng đời, có bên yêu cầu, bên thực hiện và kết quả — đúng ngữ nghĩa Task. Không nên hiểu là nghị định yêu cầu dùng Task.

Ranh giới. Profile theo dõi TIẾN TRÌNH kiến nghị; nó không phán xét kiến nghị đúng hay sai, và không thay thế biên bản giám định hay văn bản thu hồi — hai chứng từ đó nằm ở DocumentReference được focus hoặc input trỏ tới.

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.

Đây là nơi nhận kết quả giám định của cơ quan bảo hiểm xã hội (ADR-0021 quyết định D6). Cơ quan bảo hiểm xã hội trả kết quả giám định chứ không phát hành ExplanationOfBenefit; ClaimResponse.item.adjudication trong FHIR R4 vốn đã là 1..* nên chịu được toàn bộ kết quả theo từng dòng. ExplanationOfBenefit lùi về vai trò tuỳ chọn, hướng người bệnh — dùng khi cần trình bày lại chi phí trên Sổ sức khoẻ điện tử.

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ột đợt KCB được biểu diễn bằng một Claim với một MA_LK; Claim có thể mang nhiều insurance khi người bệnh được cấp thẻ mới giữa đợt hoặc có đồng thời nhiều thẻ/quyền lợi, và đúng một mục là focal = true. Một ClaimResponse phản hồi toàn bộ hồ sơ đó. Claim.related vẫn là quan hệ tuỳ chọn theo ngữ nghĩa FHIR prior/associated; VN Core không đặt nghĩa vụ hỗ trợ tối thiểu và không dùng phần tử này để hướng dẫn chia đợt hoặc sinh MA_LK mới. Luồng điều chỉnh/bổ sung chưa được VN Core 0.10.0 quy định mô hình FHIR. 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
• TT 12/2026/TT-BTC — Điều 10–12 và Mẫu 09/BH về giám định, thông báo kết quả/từ chối và quyết toán; lựa chọn ClaimResponse là mapping FHIR cục bộ
• 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 khoẻ (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 khoẻ) và liên thông lên Cơ sở dữ liệu sức khoẻ 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.

Mức hưởng là ẢNH CHỤP CÓ THỜI ĐIỂM, không phải thuộc tính của thẻ (kiểm toán 07/08/2026, mục 1.12): CV 2036/BHXH-CSYT hướng dẫn cơ sở KCB dùng kết quả tra cứu có thời điểm và áp dụng quyền lợi cao nhất khi người tham gia thuộc nhiều đối tượng — mức hưởng, trần và số luỹ kế thay đổi theo thời gian và theo tổ hợp đối tượng nên phải nằm trong phản hồi tra cứu (created + serviced[x] + insurance.item.benefit), không được ghi tĩnh trên Coverage. Tổng cùng chi trả luỹ kế trong năm (NĐ 188/2025/NĐ-CP Điều 18 khoản 2) biểu diễn bằng insurance.item.benefit với type = vn-benefit-type-cs#annual-copay-accumulator (0.10.0 — thay cách dùng sai benefit-type#copay-maximum của HL7, vốn nghĩa là mức cùng chi trả tối đa cho MỘT dịch vụ — T-02 review 97b): allowedMoney = trần miễn cùng chi trả (6 tháng lương cơ sở), usedMoney = số đã cùng chi trả luỹ kế tính đến thời điểm tra cứu; kỳ tính (năm tài chính) ghi ở serviced[x]. Extension vn-ext-coverage-cumulative-copay trên Coverage đã ngừng authoring từ 0.10.0. 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; Điều 18 khoản 2 — điều kiện hưởng không cùng chi trả trong năm tài chính
• 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
• CV 2036/BHXH-CSYT — kết quả tra cứu có thời điểm; áp quyền lợi cao nhất khi thuộc nhiều đối tượng. PHẠM VI, làm rõ 07/09/2026: đây là công văn của BHXH Việt Nam gửi BHXH các tỉnh, thành phố, ràng buộc cơ sở KCB gián tiếp qua BHXH tỉnh và hợp đồng KCB BHYT — không phải văn bản quy phạm áp thẳng lên cơ sở. Thiết kế serviced[x] vẫn đứng vững vì nó phản ánh bản chất ảnh-chụp-có-thời-điểm của kết quả tra cứu.

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ó. Trong hợp đồng VN Core, báo cáo kết quả complete khai chỉ tiêu mẫu hoặc nhóm tiêu chuẩn chất lượng bệnh viện phải có đúng một nhóm KL, với measureScore.value bằng 0 (không đạt) hoặc 1 (đạt). evaluatedResource dẫn tới bằng chứng, không thay thế trường kết luận này. Bản pending, error và data-collection có thể chưa có kết luận; chỉ tiêu khác giữ cách tính riêng. 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 — chỉ là nguồn lịch sử cho MA_LYDO_VVIEN; đã hết hiệu lực từ 01/07/2024 theo Điều 3 QĐ 4750/QĐ-BYT
• QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT — chuẩn dữ liệu KCB/BHYT hiện hành
• QĐ 3276/QĐ-BYT — MA_DOITUONG_KCB; QĐ 1804/QĐ-BYT — MA_LOAI_KCB 01–16 và danh mục mã khoa.

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 hoá 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
• TT 06/2026/TT-BYT (hiệu lực 01/07/2026) + QĐ 1849/QĐ-BYT (23/06/2026) — ICD-10 VN edition 2026 cho reasonCode; chuỗi QĐ 4469/QĐ-BYT + QĐ 98/QĐ-BYT chỉ còn là provenance cho dữ liệu lập trước 01/07/2026
• 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ứ:

• Luật 20/2023/QH15 — Luật Giao dịch điện tử, đọc theo sửa đổi tại Luật 60/2024/QH15
• Luật 60/2024/QH15 — Luật Dữ liệu, nền tảng quản trị và truy xuất nguồn dữ liệu số
• TT 13/2025/TT-BYT — 06/6/2025 — bệnh án điện tử
• NĐ 23/2025/NĐ-CP — chữ ký điện tử và dịch vụ tin cậy nói chung
• NĐ 68/2024/NĐ-CP — chữ ký số chuyên dùng công vụ cho cơ quan nhà nước/đơn vị sự nghiệp công lập
• NĐ 137/2024/NĐ-CP — chỉ áp dụng khi giao dịch thuộc phạm vi cơ quan nhà nước/hệ thống thông tin phục vụ giao dịch đ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 hoá 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 hoá của US Core, JP Core, CH Core: dùng base RelatedPerson thay vì extension tuỳ 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, đọc theo VBHN 108/VBHN-VPQH năm 2025) — Điều 101 khoản 1 — cha, mẹ/người giám hộ đại diện cho trẻ em trong giao dịch dân sự; không đồng nhất phạm vi trẻ em dưới 16 tuổi với người chưa thành niên dưới 18 tuổi theo Bộ luật Dân sự
• 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 hoá 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 chuyển tiếp), 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ề theo Luật KCB 2023 Điều 27. Cấu trúc {6 chữ số}/{mã cơ quan}-GPHN có trong TT 32/2023/TT-BYT Phụ lục XIX, nhưng profile vẫn bảo toàn nguyên chuỗi do cơ quan có thẩm quyền cấp và KHÔNG áp regex, vì bảng mã cơ quan của Phụ lục đó phản ánh cơ cấu 63 tỉnh trước NQ 202/2025/QH15 — xem giải thích đầy đủ tại identifier[GPHN] bên dưới
• identifier[CCHN] = số Chứng chỉ hành nghề cấp theo Luật KCB 40/2009/QH12. KHÔNG thuần lịch sử: theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2, CCHN được tiếp tục sử dụng NHƯ giấy phép hành nghề cho tới khi chuyển đổi
• Mỗi slice GPHN và CCHN mang extension practiceLicenseStatus (1..1) khai trạng thái pháp lý của chính credential đó, kèm phạm vi bị đình chỉ khi đình chỉ một phần. Hiệu lực KHÔNG suy từ period.end — xem VNPracticeLicenseStatusCS
• extension[practiceLicenseExemption] khai căn cứ miễn điều kiện giấy phép theo Luật 15/2023/QH15 Điều 19 khoản 2-4 (sinh viên thực hành, y tế thôn bản, huy động khẩn cấp, đoàn KCB nhân đạo nước ngoài, cấp cứu cộng đồng)

Chức danh pháp lý và nghĩa vụ giấy phép: qualification[RegulatedTitle] khai một trong 10 chức danh chuyên môn phải có giấy phép hành nghề (Luật 15/2023/QH15 Điều 26 khoản 1). Khai chức danh đó kích hoạt invariant vn-practitioner-regulated-title-license. Ngạch/hạng viên chức V.08 (VNPractitionerTitleCS) là trục khác, dùng ở PractitionerRole và KHÔNG kích hoạt invariant — xem ConceptMap vn-cm-practitioner-title-to-regulated-title.

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.

Nhóm liên kết các tờ đơn của một lần kê đơn kết hợp thuốc cổ truyền, thuốc dược liệu với thuốc hoá dược trong điều trị ngoại trú, theo TT 55/2025/TT-BYT Điều 7 khoản 2. Mỗi tờ đơn giữ nguyên mẫu và mã đơn thuốc quốc gia riêng của nó — phần thuốc thang và thuốc cổ truyền theo VNCoreYHCTOutpatientPrescription (hậu tố T), phần hoá dược theo VNCoreOutpatientPrescription (hậu tố N, H hoặc C). RequestGroup mang mã ĐỢT KÊ ĐƠN, không phải mã đơn thuốc pháp lý. Chỉ dùng khi thực sự có từ hai tờ đơn trở lên; một tờ đơn đơn lẻ không cần nhóm. / Links the separate prescription forms of a combined traditional-and-modern medicine outpatient prescription per Circular 55/2025/TT-BYT Article 7.2. Each form keeps its own national prescription code; this resource carries an episode-level identifier instead.

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)
• QĐ 2113/QĐ-BYT (Khung kiến trúc dữ liệu y tế) — ANCHOR của ô sổ cái chiều P-A theo cửa capability-backed. Phụ lục Lớp 5 Người dùng an toàn: 'Hệ thống phải ghi nhận đầy đủ lịch sử truy cập và có khả năng kiểm tra, truy vết (audit) theo thời gian thực hoặc hậu kiểm', phạm vi mục III phủ 'các cơ sở y tế công lập và ngoài công lập'. Đây là nghĩa vụ NĂNG LỰC — profile thực thi nó bằng cờ Must Support và invariant vn-audit-data-access-traceable, KHÔNG bằng cardinality: profile này không siết min của element nào vượt FHIR base. Phép suy từ nghĩa vụ sang từng cờ MS được viết ra trong governance/review/capability-obligation-anchors.json và cổng kiểm tập MS phải nằm trong tập đã khai
• Luật 116/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — đang áp dụng; Luật 24/2018/QH14 đã hết hiệu lực) — Luật An ninh mạng mới. PHẠM VI, làm rõ 07/09/2026: Luật định nghĩa nhật ký hệ thống tại Điều 2 khoản 11, nhưng nghĩa vụ lưu nhật ký của Luật (Điều 25 khoản 2 điểm b) áp cho doanh nghiệp cung cấp dịch vụ trên mạng viễn thông, mạng Internet — KHÔNG đặt nghĩa vụ log cho hệ thống khám bệnh, chữa bệnh nói chung. Viện dẫn ở đây là để định nghĩa thuật ngữ và làm bối cảnh an ninh mạng, không phải làm căn cứ cardinality
• 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 hoá 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 khoẻ đị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 khoẻ 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 khoẻ tâm thần (Mẫu 04).
• QĐ 1332/QĐ-BYT (2024) — Sổ sức khoẻ đ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 khoẻ (Loại I–V) trong kết luận khám sức khoẻ đị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 khoẻ 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.

PHẠM VI ÁP DỤNG: binding required ở đây ràng buộc ĐÚNG thang của profile này. Cơ sở đang dùng một thang phân loại khác — ESI, ATS bản gốc, CTAS hay thang nội bộ — thì KHÔNG dùng profile này, vì ép mã của thang khác vào thang này sẽ làm mất nghĩa gốc; hãy dùng Observation với bộ mã của thang ấy, hoặc dẫn xuất profile riêng. Profile này không tuyên bố thang 5 mức là thang phân loại cấp cứu bắt buộc của Việt Nam. 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 hoá mã CLS và ánh xạ LOINC.

Profile Observation bão hoà 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 hoá 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 khoẻ đ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 khoẻ 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 khoẻ điện tử tích hợp trên VNeID — bản tóm tắt sức khoẻ 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 hoá 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.

Ghi nhận một sự cố bất lợi xảy ra sau tiêm chủng (AEFI), gồm cả phản ứng thông thường lẫn tai biến nặng.

Căn cứ pháp lý. TT 13/2026/TT-BYT Điều 2 khoản 2 định nghĩa "Sự cố bất lợi sau tiêm chủng là hiện tượng bất thường về sức khoẻ bao gồm các biểu hiện tại chỗ tiêm hoặc toàn thân xảy ra sau tiêm chủng, không nhất thiết do việc sử dụng vắc xin, sinh phẩm"; khoản 3 định nghĩa phản ứng thông thường. NĐ 165/2026/NĐ-CP Điều 2 khoản 7 định nghĩa tai biến nặng, và Điều 50 khoản 2 lấy hai kết cục "để lại di chứng dẫn đến bị khuyết tật" và "bị tử vong" làm căn cứ bồi thường nhà nước.

Bốn trục tách rời, cố ý không gộp. Văn bản trộn nhiều chiều thông tin vào cùng một cụm chữ, nhưng chúng độc lập với nhau và phải ở bốn element khác nhau:

Gộp chúng lại sẽ mất thông tin thật: một phản ứng thông thường vẫn có thể severity = severe (sốt cao), và một tai biến nặng vẫn có thể outcome = resolved (sốc phản vệ được cấp cứu kịp).

Quan hệ nhân quả KHÔNG bắt buộc — nhưng mũi tiêm phải truy được. Chính định nghĩa nói sự cố "không nhất thiết do việc sử dụng vắc xin, sinh phẩm". Vì thế bản ghi liên kết mũi tiêm qua MỘT trong hai đường, tách bạch về ngữ nghĩa:

• extension[relatedImmunization] — liên hệ THỜI GIAN thuần tuý (mũi tiêm xảy ra trước sự cố), không hàm ý nhân quả; dùng cho ca chưa có hoặc không có nghi ngờ (ví dụ sự cố trùng hợp);
• suspectEntity (0..*) — chỉ khai khi THỰC SỰ nghi ngờ mũi tiêm gây ra sự cố, đúng ngữ nghĩa R4 của element này.

Invariant vn-aefi-immunization-linked bảo đảm ít nhất một đường tồn tại. Bắt khai causality sẽ ép người báo cáo kết luận điều mà tại thời điểm ghi nhận chưa ai kết luận được — trong khi NĐ 165/2026/NĐ-CP Điều 52 giao việc đánh giá nguyên nhân cho Hội đồng tư vấn chuyên môn. Vì vậy suspectEntity.causality để 0..*.

Phân loại pháp lý cho phép treo. seriousness là 0..1: vắng nghĩa là CHƯA PHÂN LOẠI — hệ thống tiếp nhận phải coi bản ghi chưa phân loại là chưa loại trừ tai biến nặng, không được suy diễn thành phản ứng thông thường. Kết cục tử vong/di chứng buộc phân loại ngay (invariant vn-aefi-severe-outcome-seriousness).

Khuyết tật không phải mã kết cục. Di chứng dẫn đến khuyết tật được ghi bằng resultingCondition trỏ tới VNCoreCondition, không bằng một mã outcome tự đặt. Khuyết tật là một tình trạng sức khoẻ có mã bệnh, có ngày khởi phát, có thể theo dõi — nhồi nó vào enum kết cục sẽ vứt bỏ toàn bộ những thứ đó.

Trạng thái draft. Profile này ở mức draft: hệ thống báo cáo tai biến nặng quốc gia theo TT 13/2026/TT-BYT Điều 15 khoản 5 chưa công bố đặc tả kỹ thuật, nên chưa khoá được danh mục biểu hiện lâm sàng (event) và chưa mô hình hoá luồng điều tra của Đoàn điều tra tai biến nặng (TT 13/2026/TT-BYT Điều 13 khoản 2 điểm a — thành lập trong 24 giờ kể từ khi nhận được báo cáo).

Sự cố y khoa xảy ra trong quá trình khám bệnh, chữa bệnh theo TT 43/2018/TT-BYT — ngã, nhầm thuốc, nhầm người bệnh, nhiễm khuẩn bệnh viện, sự cố phẫu thuật, và mọi tình huống khác mà Thông tư gọi là sự cố y khoa.

Khác với sự cố sau tiêm chủng. VNCoreAdverseEventPostImmunization phủ một miền hẹp và khác hẳn: sự cố bất lợi SAU TIÊM CHỦNG theo TT 13/2026/TT-BYT, gắn với mũi tiêm và với cơ chế bồi thường nhà nước. Hai profile không kế thừa nhau và không thay thế nhau — một ca ngã trong buồng bệnh không phải AEFI, một ca sốc phản vệ sau tiêm không phân loại theo Phụ lục I của Thông tư này.

BA TRỤC PHÂN LOẠI, và chúng không thay nhau được. Điều 7 khoản 1 buộc phân loại theo cả ba tiêu chí:

Vì sao mức A–I nằm ở seriousness chứ không severity. AdverseEvent.severity bị ràng buộc required vào bộ mã mild | moderate | severe của HL7 — không rebind được, và nó nói về mức độ nặng nhẹ LÂM SÀNG. Trục A–I quyết định NGHĨA VỤ PHÁP LÝ: mục 1–6 báo cáo tự nguyện, mục 7–9 báo cáo bắt buộc (Điều 5 khoản 1). Đó đúng là ngữ nghĩa của seriousness ("assessment whether this event was of real importance"), và seriousness có binding example nên rebind được. Ai muốn khai thêm mức độ lâm sàng vẫn dùng severity song song — NC1 tương ứng mild, NC2 moderate, NC3 severe, nhưng đó là phép chiếu MẤT THÔNG TIN, không phải định nghĩa.

Phân loại CHO PHÉP TREO, và đó là cố ý. Cả bốn trục đều 0..* hoặc 0..1. Điều 7 giao việc phân loại cho bộ phận tiếp nhận và quản lý sự cố, thực hiện SAU khi tiếp nhận báo cáo; còn nội dung tối thiểu của một báo cáo tự nguyện theo Điều 5 khoản 3 điểm a chỉ gồm địa điểm, thời điểm, mô tả, tình trạng người bị ảnh hưởng và biện pháp xử lý ban đầu. Ép ba trục thành bắt buộc sẽ chặn đúng những bản ghi mà Thông tư tuyên bố là hợp lệ. Hệ tiếp nhận phải coi bản ghi chưa phân loại là CHƯA LOẠI TRỪ tổn thương nặng.

Danh tính người báo cáo: hai chế độ, và không invariant nào cưỡng chế được. Điều 5 khoản 3 điểm a: báo cáo tự nguyện KHÔNG đòi họ tên người báo cáo; báo cáo bắt buộc phải đầy đủ mẫu Phụ lục III "và ghi rõ họ tên người báo cáo". Ngược lại, Điều 12 khoản 3, Điều 13 khoản 2 và Điều 14 khoản 2 đều buộc "giữ bí mật, ẩn danh tính của cá nhân hay của cơ sở khám bệnh, chữa bệnh báo cáo sự cố y khoa". Hai điều đó không mâu thuẫn — chúng nói về hai TẦNG khác nhau: bản ghi nội bộ phải có tên và được bảo vệ bằng phân quyền (Thông tư giao cho bộ phận đầu mối quyền tra cứu); bản chia sẻ lên Sở Y tế, Bộ Y tế hoặc công bố thì phải ẩn danh. Vì vậy recorder không bị ép 1..1: một invariant như thế sẽ đánh trượt đúng bản đã ẩn danh hợp pháp. Bản chia sẻ đánh dấu bằng meta.security (ANONYED hoặc PSEUDED).

Không mô hình hoá hạn báo cáo 1 giờ. Điều 5 khoản 2 điểm b buộc báo trước bằng điện thoại trong 1 giờ với sự cố nghiêm trọng theo điểm b khoản 1. Đó là hành vi vận hành không để lại dấu vết trong AdverseEvent, và điều kiện kích hoạt còn phụ thuộc nhiều ca (tử vong từ 2 người trở lên cùng nguyên nhân) nên không kiểm được trên một resource. Hạn ấy ghi ở ^short của recordedDate làm hướng dẫn.

Trạng thái draft. Hệ thống báo cáo sự cố y khoa trực tuyến mà Điều 5 khoản 3 điểm b nhắc tới chưa công bố đặc tả kỹ thuật, nên chưa khoá được luồng chia sẻ lên Sở Y tế và Bộ Y tế.

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. Đối với thiết bị loại C/D, số lưu hành là bằng chứng regulatory thường được kỳ vọng nhưng không phải điều kiện tuyệt đối trong profile: cảnh báo thiếu số cần được đối chiếu với giấy phép/số chuyển tiếp tại Điều 22 khoản 1 điểm a hoặc trường hợp miễn tại Điều 24 VBHN 08/VBHN-BYT năm 2026. 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 phải được đọc cùng TT 24/2026/TT-BYT. TT 59/2025/TT-BYT đã hết hiệu lực từ 01/07/2026 và chỉ còn giá trị truy vết lịch sử.

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/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)
• TT 24/2026/TT-BYT (30/06/2026, hiệu lực 01/07/2026) — xác định mức độ rủi ro TBYT, sửa Điều 8 TT 05/2022/TT-BYT và làm TT 59/2025/TT-BYT hết hiệu lực. VBHN 04/VBHN-BYT chỉ còn là ảnh chụp hợp nhất lịch sử trước thay đổi này
• 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
• TT 10/2026/TT-BYT (14/05/2026, hiệu lực 01/07/2026) — căn cứ hiện hành về tiêu chuẩn, định mức và phân cấp thẩm quyền đối với thiết bị chuyên dùng trong lĩnh vực y tế; Điều 7 khoản 2 làm TT 08/2019/TT-BYT và TT 46/2025/TT-BYT hết hiệu lực, hai văn bản cũ chỉ còn dùng cho provenance lịch sử
• QĐ 15/2025/QĐ-TTg đọc cùng QĐ 10/2026/QĐ-TTg — khung tiêu chuẩn, định mức sử dụng máy móc, thiết bị đã được sửa đổi một phần; không đọc QĐ 15/2025/QĐ-TTg độc lập
• VBHN 14/VBHN-BYT năm 2025 hợp nhất TT 04/2017/TT-BYT + TT 50/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 tuỳ chọn khi cần chuẩn hoá 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/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 tuỳ 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/VBHN-BYT, là dimension regulatory tuỳ chọn ở mức sản phẩm/model.
• TT 10/2026/TT-BYT Điều 5 khoản 5 giới hạn định mức thiết bị vào kế hoạch, dự toán, mua sắm và quản lý tài sản; không được dùng định mức này để thanh toán từng dịch vụ KCB. Vì vậy căn cứ TT 10/2026/TT-BYT/QĐ 15/2025/QĐ-TTg/QĐ 10/2026/QĐ-TTg chỉ hỗ trợ capacity/inventory governance, không định nghĩa mã hoặc mức thanh toán tại Claim.item.
• 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 hoá 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 hiện hành từ 01/07/2026, đọc theo trạng thái đã sửa đổi; quan hệ metadata với Luật 143/2025/QH15 còn cần pháp chế xác nhận phạm vi; Luật 24/2018/QH14 đã hết hiệu lực
• NĐ 23/2025/NĐ-CP — nhánh chữ ký điện tử chung nếu nộp Mẫu 08 dưới dạng điện tử
• NĐ 68/2024/NĐ-CP — nhánh chữ ký số chuyên dùng công vụ nếu chủ thể nộp thuộc cơ quan nhà nước/đơn vị sự nghiệp công lập

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
• QĐ 241/QĐ-BTC — 05/02/2026 — công bố nhóm dữ liệu thẻ BHYT được chia sẻ thay giấy tờ TTHC và API JSON tra cứu; API này không phải FHIR REST API và không tự đặt cardinality/binding cho profile
• CV 1804/BHXH-QLT — 04/08/2025 — snapshot 59 mã đối tượng BHYT phạm vi BHXH chung/cấp tỉnh và chuyển đổi khoá ĐDCN/CCCD
• CV 2036/BHXH-CSYT — 22/08/2025 — xác định quyền lợi bằng kết quả tra cứu có thời điểm, không suy chỉ từ mã đối tượng
• 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ã hoá 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; TT 43/2013/TT-BYT và TT 21/2017/TT-BYT đã hết hiệu lực 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 tiêm chủng bắt buộc gồm 13 bệnh được nêu tên và 1 nhóm mở (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 khoẻ đị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 khoẻ (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.

Tài khoản viện phí gom toàn bộ chi phí của một đợt khám bệnh, chữa bệnh về một chỗ.

Vì sao cần. Một đợt điều trị thực tế có thể trải nhiều Encounter (nhập khoa, chuyển khoa, chuyển tuyến nội viện) nhưng chỉ có một bảng kê chi phí và một hồ sơ đề nghị thanh toán. Account là nơi duy nhất trong R4 giữ đúng quan hệ đó: Encounter.account, ChargeItem.account và Invoice.account cùng trỏ về nó. Nhờ vậy câu hỏi 'dòng chi phí này thuộc đợt điều trị nào, và bảng kê nào tổng hợp nó' trả lời được bằng truy vấn chứ không bằng cách so chuỗi MA_LK.

Quan hệ với MA_LK. MA_LK theo QĐ 3176/QĐ-BYT vẫn là định danh nghiệp vụ để gửi BHXH và vẫn nằm trên identifier. Khác biệt: MA_LK là khoá trao đổi, còn Account là đối tượng có thật trong hệ thống — hai thứ không thay nhau được.

Không dùng cho. Account KHÔNG mang số tiền. Tổng chi phí nằm ở Invoice.totalNet, kết quả giám định nằm ở ClaimResponse. Account chỉ trả lời câu hỏi thuộc về đâu.

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ứ:

• Luật 20/2023/QH15 — Luật Giao dịch điện tử, đọc theo sửa đổi tại Luật 60/2024/QH15
• Luật 60/2024/QH15 — Luật Dữ liệu, nền tảng quản trị dữ liệu số
• 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 hoá 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Đ 23/2025/NĐ-CP — Chữ ký điện tử và dịch vụ tin cậy
• NĐ 68/2024/NĐ-CP — Chữ ký số chuyên dùng công vụ khi áp dụng cho cơ sở y tế công lập
• NĐ 137/2024/NĐ-CP — Chỉ khi giao dịch thuộc phạm vi cơ quan nhà nước/hệ thống thông tin phục vụ giao dịch điện tử
• QĐ 1332/QĐ-BYT — Sổ sức khoẻ điện tử trên VNeID
• Luật 91/2025/QH15 — BVDLCN: dữ liệu y tế = DLCN nhạy cảm

Ranh giới: profile này biểu diễn metadata/tệp được tham chiếu. Từ 0.10.0, bằng chứng chuyển đổi giấy ↔ điện tử được mã hoá bằng VNCoreExtPaperConversion — bốn phần tử bám đúng bốn điểm của Luật Giao dịch điện tử 20/2023/QH15 Điều 12 khoản 1: toàn vẹn thông tin, truy cập được để tham chiếu, ký hiệu riêng kèm thông tin bên chuyển đổi, và chữ ký số khi bản gốc là giấy phép/chứng nhận/chứng chỉ/văn bản xác nhận, chấp thuận.

authenticator KHÔNG thay được extension này: nó nói ai xác thực nội dung, không nói ai thực hiện chuyển đổi và bằng cách nào. Một tệp scan cũng không tự chứng minh mình là bản chuyển đổi hợp lệ. Chuỗi tác nhân và bằng chứng chữ ký chi tiết vẫn dùng Provenance khi hợp đồng trao đổi yêu cầu.

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 26 khoản 3, Điều 27 khoản 3 điểm b-c và Điều 36-37 (chức danh, phạm vi và đăng ký hành nghề), TT 41/2025/TT-BYT (bác sĩ, bác sĩ YHDP, y sĩ), TT 02/2025/TT-BYT (điều dưỡng, hộ sinh, kỹ thuật y), TTLT 11/2015 (y tế công cộng), TTLT 27/2015 (dược), TTLT 28/2015 (dinh dưỡng), TTLT 08/2016 (dân số), TT 14/2021/TT-BYT (khúc xạ), TT 32/2023/TT-BYT Điều 10-11 và các phụ lục tương ứng (phạm vi hành nghề theo chức danh chuyên môn). Các code trong vn-specialty-cs là abstraction do dự án gán để trao đổi liên thông; các văn bản trên không ban hành trực tiếp bộ mã này.

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 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ã hoá 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), đọc cùng QĐ 1931/QĐ-BYT (29/06/2026, áp dụng từ 01/07/2026) — chuẩn dữ liệu đầu ra KCB hiện hành; QĐ 1931/QĐ-BYT sửa MUC_HUONG và SO_DANG_KY
• QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB hiện hành; QĐ 6556/QĐ-BYT đã hết hiệu lực sau giai đoạn chuyển tiếp kết thúc 01/07/2026
• NĐ 188/2025/NĐ-CP — ban hành 01/07/2025, hiệu lực 15/08/2025 — Điều 13 về giá trị sử dụng thẻ, Điều 21 về thay đổi mức hưởng trong đợt điều trị và Điều 50 khoản 4 về trường hợp thẻ hết hạn khi đang điều trị nội trú; không phải căn cứ trực tiếp cho cờ FHIR insurance.focal
• 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 PHẠM VI — profile này KIỂM quyền lợi của một thẻ ĐÃ BIẾT, chứ không TÌM thẻ. insurance là 1..* và mỗi mục trỏ tới một VNCoreCoverage đã tồn tại, nên hồ sơ chỉ dựng được khi đã biết mã thẻ. Tình huống thường gặp ở khâu tiếp đón — người bệnh chỉ xuất trình CCCD và cơ sở phải TRA RA mã thẻ — KHÔNG dùng profile này: đó là nghiệp vụ tra cứu của Cổng BHXH theo NĐ 164/2025/NĐ-CP, thực hiện qua API của cổng; kết quả trả về mới dùng để tạo VNCoreCoverage, rồi mới đến lượt profile này kiểm hiệu lực và mức hưởng. Ghi rõ ranh giới 16/08/2026 sau khi rà từ góc người triển khai: bản trước chỉ nói 'luồng tra cứu', khiến kỹ sư tưởng dựng được hồ sơ khám phá thẻ bằng CCCD rồi mắc kẹt ở cardinality bắt buộc.

Profile Observation cho đánh giá Y học cổ truyền (YHCT) tại Việt Nam theo pattern question/property + coded value (0.10.0):

• Atomic: code = thuộc tính được khám (vn-yhct-observation-attribute-vs: loại mạch, chất lưỡi, rêu lưỡi, triệu chứng vấn chẩn), valueCodeableConcept = finding theo bộ mã dùng chung (vn-yhct-pulse-cs/vn-yhct-tongue-cs/vn-yhct-symptom-cs); mô tả tự do ở value.text/note, KHÔNG dùng valueString.
• Panel tứ chẩn: code = mã panel-*, không value, thành phần nối bằng hasMember.
• Mạch theo bộ vị: Observation loại mạch dùng component.code = bộ vị (tả/hữu × thốn/quan/xích) và component.valueCodeableConcept = finding mạch tại bộ vị đó.

Query một kiểu duy nhất cho finding (toàn cục hoặc theo bộ vị): SearchParameter chuẩn R4 combo-value-concept — CapabilityStatement khai SHALL. 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 (hai văn bản ban hành mã FINDING; mã thuộc tính/panel là project-assigned của VN Core — xem vn-yhct-observation-attribute-cs).

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 hoá 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ú hoá dược (VNCoreOutpatientPrescription): mã đơn thuốc quốc gia mang hậu tố T; bài thuốc cổ truyền mã hoá 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, TT 55/2025/TT-BYT Điều 7 khoản 2 quy định kê thành các TỜ ĐƠN RIÊNG theo từng mẫu: thuốc thang theo Phụ lục I, thuốc cổ truyền và thuốc dược liệu theo Phụ lục II, thuốc hoá dược theo TT 26/2025/TT-BYT. Mỗi tờ đơn tự mang một mã đơn thuốc quốc gia 14 ký tự riêng, nên groupIdentifier KHÔNG dùng chung giữa phần cổ truyền và phần hoá dược — một giá trị không thể vừa mang hậu tố T vừa mang N/H/C. Để nối các tờ đơn của cùng một đợt điều trị, dùng VNCoreCombinedPrescriptionGroup (RequestGroup) với một mã đợt riêng, hoặc encounter chung. / Traditional-medicine outpatient prescription profile per Circular 55/2025/TT-BYT; the national prescription code carries the T suffix. Combined prescriptions are separate forms with separate codes, linked by a RequestGroup.

Profile cho đơn thuốc gây nghiện kê để giảm đau cho người bệnh ung thư điều trị ngoại trú, theo TT 26/2025/TT-BYT Điều 8 khoản 1 (ban hành 30/06/2025, hiệu lực 01/07/2025). Khác biệt so với profile cha VNCoreOutpatientPrescription: đơn phải ghi ĐÚNG BA đợt điều trị liên tiếp trên cùng một đơn, mỗi đợt không quá 10 ngày và có ngày bắt đầu–kết thúc rõ ràng, tổng cả ba đợt không quá 30 ngày; mã đơn quốc gia phải mang hậu tố N của đơn thuốc gây nghiện. Đơn gây nghiện KHÔNG phải cho người bệnh ung thư không thuộc phạm vi profile này — Điều 8 chỉ điều chỉnh trường hợp giảm đau ung thư. / Narcotic prescription for cancer pain management per Circular 26/2025/TT-BYT Article 8.1: exactly three consecutive treatment courses on a single prescription, each at most 10 days, 30 days in total.

Profile cho đơn thuốc hoá 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 phải CHỨA bối cảnh ngoại trú hoặc ra viện (outpatient/discharge của hệ HL7 medicationrequest-category) — profile không cấm gắn thêm category khác bên cạnh; đơn phải đã phát hành, tức status không được là draft. Đơ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 must include an outpatient or discharge context (additional categories are not forbidden); status must not be draft.

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 hoá 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ợ 34 tỉnh theo NQ 202/2025/QH15 và danh mục mã 3.321 xã/phường/đặc khu theo QĐ 19/2025/QĐ-TTg Phụ lục II. Bổ sung extension mã hoá tỉnh/TP và xã/phường. Cấp huyện (district) giữ lại cho backward-compatible nhưng KHÔNG Must Support. Địa chỉ chỉ có text được hỗ trợ chính thức, kể cả khi country = 'VN'. Mã tỉnh/xã là thông tin bổ sung khi nguồn có mã đã xác minh; Must Support không buộc tạo mã hoặc tạo extension rỗng khi nguồn chỉ có chữ. Giữ nguyên địa chỉ nguồn khi bổ sung mã. Text-only addresses are supported; verified province and ward codings are optional additions. Căn cứ:

• NQ 202/2025/QH15 — 12/6/2025 — sắp xếp ĐVHC cấp tỉnh
• NQ 203/2025/QH15 — hiệu lực 16/6/2025; khoản 2 Điều 2 kết thúc hoạt động của đơn vị hành chính cấp huyện trong cả nước 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 hoá 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 khoẻ). 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 khoẻ (Đ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 hoá 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.

Bằng chứng cho việc một tài liệu đã được chuyển đổi giữa văn bản giấy và thông điệp dữ liệu, theo Luật Giao dịch điện tử 20/2023/QH15 Điều 12.

Vì sao cần. Một tệp scan đính vào DocumentReference KHÔNG tự chứng minh rằng nó là bản chuyển đổi hợp lệ của một văn bản giấy. authenticator cũng không: nó nói ai xác thực nội dung, không nói ai thực hiện việc chuyển đổi và bằng cách nào. Thiếu lớp bằng chứng này thì bên nhận không phân biệt được một bản scan tuỳ tiện với một bản chuyển đổi có giá trị pháp lý.

Bốn phần tử bám đúng bốn điểm của Điều 12 khoản 1:

Hai chiều. Điều 12 khoản 2 quy định chiều ngược lại (thông điệp dữ liệu → văn bản giấy) với yêu cầu tương ứng; direction phân biệt hai chiều để cùng một cấu trúc dùng được cho cả hai.

Không thay thế Provenance. Extension này ghi bằng chứng chuyển đổi gắn liền tài liệu. Chuỗi tác nhân, thời điểm và chữ ký chi tiết vẫn nên có Provenance riêng khi hợp đồng trao đổi yêu cầu.

Một căn cứ pháp lý cụ thể, có điều/khoản và tài liệu chứng minh, cho một kết quả giám định — đặc biệt cho khoản tiền mang category denied.

Vì sao bắt buộc với từ chối. NĐ 188/2025/NĐ-CP Điều 51 khoản 2 quy định việc từ chối thanh toán "phải nêu rõ căn cứ, lý do từ chối, số tiền bị từ chối thanh toán trong biên bản giám định". Ba yếu tố đó là điều kiện của chính hành vi từ chối, không phải siêu dữ liệu tuỳ chọn. Một bản ghi chỉ nói "bị từ chối" mà không dẫn được căn cứ thì không đủ để cơ sở khám bệnh, chữa bệnh thực hiện quyền kiến nghị tại Điều 51 khoản 3.

Vì sao áp cả cho khoản bị từ chối tự động. Cũng tại khoản 2, nghĩa vụ nêu căn cứ bao gồm "cả các chi phí khám bệnh, chữa bệnh bảo hiểm y tế đề nghị cơ quan bảo hiểm xã hội thanh toán trên môi trường điện tử được trả tự động khi cơ sở khám bệnh, chữa bệnh gửi dữ liệu". Từ chối do hệ thống tự sinh không được miễn nghĩa vụ này.

Ranh giới. Extension mang căn cứ mà bên giám định VIỆN DẪN; nó không chứng minh việc viện dẫn là đúng. Đánh giá tính đúng đắn thuộc quy trình kiến nghị và cơ quan có thẩm quyền.

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.

Quan hệ có hướng giữa trạng thái mã; không khẳng định thực thể hoặc địa giới liên tục. Directional administrative code-state event; no entity-continuity assertion. Full history is not certified.

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/VBHN-BYT (hợp nhất TT 43/2025/TT-BYT + TT 53/2025/TT-BYT về Trạm Y tế xã/phường). PHẠM VI CĂN CỨ: ba văn bản trên quy định MÔ HÌNH quản lý hai chiều — đó là chế định nghiệp vụ. Bản thân extension và cách đặt cơ quan hướng dẫn chuyên môn tách khỏi Organization.partOf là thiết kế của VN Core; FHIR base không có element nào cho quan hệ này. 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/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.

Tên cơ sở giáo dục mà người được kiểm tra sức khoẻ đang theo học, theo TT 33/2026/TT-BYT — Phụ lục II mục 12 (trẻ em cơ sở giáo dục mầm non) và Phụ lục III mục 10 (học sinh cơ sở giáo dục phổ thông). Đặt trên Composition chứ không trên Patient vì đây là dữ kiện của MỘT lần kiểm tra đầu năm học — người học đổi trường thì bản ghi các năm trước vẫn phải giữ đúng trường tại thời điểm đó. Kiểu string chứ không phải Reference(Organization): văn bản hỏi TÊN cơ sở giáo dục và không cấp mã định danh cơ sở giáo dục nào; ép Reference sẽ buộc bên gửi tự tạo Organization không có mã pháp lý.

Cơ sở khám bệnh, chữa bệnh mà bảng giá này áp dụng, dưới dạng tham chiếu có định danh cơ sở KCB — không phải chuỗi tên.

Vì sao cần. Sau 01/01/2025, không còn khung giá quốc gia thống nhất theo hạng bệnh viện: giá cụ thể do cấp có thẩm quyền phê duyệt cho từng cơ sở theo phương pháp định giá của TT 21/2024/TT-BYT. Vì vậy một ChargeItemDefinition chỉ có nghĩa khi biết nó của cơ sở nào. ChargeItemDefinition.publisher là chuỗi tự do — khớp tên bệnh viện bằng chuỗi là cách sai để kiểm 'dòng chi phí này có áp đúng bảng giá của cơ sở đã thực hiện hay không'.

Cách dùng. Trỏ tới Organization mang định danh cơ sở KCB (http://fhir.hl7.org.vn/core/sid/cskcb). Khi đối soát, so định danh này với ChargeItem.performingOrganization hoặc Encounter.serviceProvider.

Căn cứ:

• TT 21/2024/TT-BYT — phương pháp định giá dịch vụ khám bệnh, chữa bệnh
• QĐ 697/QĐ-BYT — mẫu bảng kê chi phí, cột (4) đơn giá bệnh viện

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 một con người trong hồ sơ — bệnh nhân, hoặc thân nhân/các bên liên quan được biểu diễn bằng RelatedPerson. Mã 01–54 theo Danh mục thành phần dân tộc Việt Nam tại QĐ 121-TCTK/PPCĐ. ValueSet hiện còn cho phép mã bổ sung 55 (người nước ngoài, xuất hiện trong một số sổ tay thống kê GSO) và 99 (fallback cục bộ); hai mã này không được trình bày như thành phần dân tộc do QĐ 121-TCTK/PPCĐ ban hành. Cấu trúc extension và binding là thiết kế VN Core. FHIR base chỉ có US Race/Ethnicity — không phù hợp cho Việt Nam.

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

Chỉ tra cứu trong validFrom..verifiedThrough; endKind unknown không có nghĩa vô hạn. Field-scoped administrative evidence; an unknown end does not mean infinity. Full history is not certified.

NGHỈ DÙNG từ 0.10.0 — không dùng cho dữ liệu mới. Extension từng mang khoá, khoảng thời gian và mức hưởng của một giai đoạn trên Claim hoặc ExplanationOfBenefit. Dữ liệu mới dùng một Claim với nhiều insurance khi đổi thẻ giữa đợt; thứ tự thẻ nằm ở Claim.insurance.sequence, đúng một mục là focal, và không nối các thẻ bằng Claim.related. Giai đoạn thẻ/mức hưởng cùng các dòng chi phí chuyển sang vn-ext-cost-statement-segment trên Invoice. 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.

RETIRED since 0.10.0 — do not use for new data. This extension formerly carried a benefit stage on Claim or ExplanationOfBenefit. New data uses multiple ordered Claim.insurance entries for a card change within one episode, exactly one focal entry, and no Claim.related link between the cards. Card/benefit stages and their cost lines move to vn-ext-cost-statement-segment on Invoice.

Giai đoạn nghiệp vụ của một kiến nghị xem xét lại việc từ chối thanh toán hoặc thu hồi chi phí khám bệnh, chữa bệnh bảo hiểm y tế.

Tách khỏi Task.status vì status chỉ mô tả vòng đời kỹ thuật của công việc và không phân biệt được hai nhánh mà NĐ 188/2025/NĐ-CP Điều 51 khoản 3 và Điều 52 khoản 4 cho phép: kiến nghị chính cơ quan bảo hiểm xã hội xem xét lại, hay kiến nghị cơ quan có thẩm quyền giải quyết. Đó là khác biệt pháp lý quyết định, không phải chi tiết vận hành.

Hình thức đến khám chữa bệnh. Bổ sung cho danh mục loại KCB legacy của VNCoreExtInsuranceVisitType: loại KCB xác định mức hưởng BHYT, extension này 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ứ nghiệp vụ: NĐ 188/2025/NĐ-CP, TT 01/2025/TT-BYT — chế định chuyển cơ sở khám bệnh, chữa bệnh. Tập mã do VN Core thiết kế; xem đính chính 19/08/2026 tại VNReferralModeCS.

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). 8 giá trị theo VNTreatmentOutcomeVS: 1 Khỏi, 2 Đỡ, 3 Không thay đổi, 4 Nặng hơn, 5 Tử vong tại cơ sở KCB, 6 Tiên lượng nặng xin về, 7 Chưa xác định, 8 Tử vong ngoại viện. Đính chính 16/08/2026: mô tả cũ ghi 5 giá trị và dừng ở 'Tử vong' — thiếu mã 6, 7 và mã 8 (tử vong ngoại viện, do QĐ 4750/QĐ-BYT bổ sung), khiến người triển khai tưởng danh mục hẹp hơn thực tế. 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).

NGHỈ DÙNG từ 0.10.0 — không dùng cho dữ liệu mới. Thay bằng vn-ext-cost-statement-line.

Đi theo số phận của vn-ext-coverage-benefit-stage: dữ liệu mới không dùng extension này để nối dòng Claim với giai đoạn. Khi đổi thẻ giữa đợt, một Claim mang nhiều insurance và dòng chi phí được phân theo ngày dịch vụ; trên bảng kê, việc trỏ dòng về phân đoạn thẻ nằm ở segmentSequence của vn-ext-cost-statement-line.

Chi tiết: ADR-0021.

Extension từng liên kết một dòng chi phí Claim hoặc ExplanationOfBenefit với giai đoạn hưởng trên insurance. Giá trị positiveInt từng khớp sequence trong VNCoreExtCoverageBenefitStage; quy tắc này chỉ mô tả dữ liệu cũ. 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 retired extension formerly linked a Claim or ExplanationOfBenefit cost line to an insurance benefit stage. New data segments cost-statement lines with vn-ext-cost-statement-line; card changes within one Claim are ordered through Claim.insurance and line service dates.

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 ĐÃ NGỪNG dùng, chỉ để đọc dữ liệu lịch sử theo trường MA_LYDO_VVIEN của QĐ 4210/QĐ-BYT (2017), gồm bốn mã nguồn 1–4; mã 5 là mở rộng dự án, không phải mã của Bộ Y tế. Theo QĐ 4750/QĐ-BYT Điều 2 và Điều 3, việc gửi/nhận dữ liệu theo QĐ 4210/QĐ-BYT (đã hết hiệu lực) chấm dứt và QĐ 4210/QĐ-BYT hết hiệu lực từ 01/07/2024. Không dùng extension này trong trao đổi BHXH hiện hành.

Dữ liệu hiện hành dùng MA_DOITUONG_KCB theo QĐ 3276/QĐ-BYT trên VNCoreClaim.subType và MA_LOAI_KCB theo QĐ 1804/QĐ-BYT trên VNCoreEncounter.type.

NGHỈ DÙNG từ 0.10.0 — không dùng cho dữ liệu mới.

Extension này từng ghi loại đơn vị cấp xã (xã / phường / đặc khu) trên Address. VNCoreAddress hiện chỉ khai hai extension mã tỉnh và mã xã, đều tuỳ chọn khi nguồn có mã đã xác minh; không yêu cầu tạo extension loại đơn vị.

Hướng dẫn chuyển đổi cập nhật 11/09/2026: không đọc property wardType phẳng từ vn-ward-cs. Bộ mã hành chính có lịch sử không có property đó; cùng mã có thể đổi loại hình theo sự kiện có căn cứ, như chuyển xã thành phường. Giữ nguyên mã, text và ngày hồ sơ của nguồn; đối chiếu trạng thái tên và sự kiện có bằng chứng tại ngày đó. Chưa có giai đoạn hoặc chưa có căn cứ về loại hình thì không suy từ tên hiện hành và không tự gán loại đơn vị.

Lookup theo ngày hiện trả tên và quan hệ cha trong phạm vi đã xác minh, không cung cấp property wardType riêng. Việc xác định loại hình phải giữ căn cứ và phạm vi riêng; CodeSystem.status không phải trạng thái hiệu lực hoặc loại hình của từng mã.

English: Retired Address extension. Preserve the original address and use dated evidence; the history catalogue has no flat wardType property and the lookup API does not return one.

Căn cứ lưu giữ artifact lịch sử: Luật 72/2025/QH15 và NQ 202/2025/QH15. Lý do nghỉ dùng ban đầu: kiểm toán 31/07/2026 — analysis/77 mục C1.

Mở rộng ghi nhận mã loại đối tượng tham gia bảo hiểm y tế (DN, HC, HN, TE, BT, CN, LH…). ValueSet đi kèm là snapshot 59 mã thuộc phạm vi BHXH chung/cấp tỉnh theo Phụ lục I CV 1804/BHXH-QLT; binding extensible cho phép mã sectoral có thẩm quyền của BHXH Quân đội/BHXH Công an Nhân dân. Mã nhóm được tra cứu từ cơ quan BHXH kèm danh mục nguồn và thời điểm. Hai ký tự đầu của mã thẻ 15 ký tự legacy không đủ để xác định nghĩa hiện hành. Khi đã xác minh danh mục Phụ lục C QĐ 3680/QĐ-BHXH, ghi bằng vn-bhyt-card-type-legacy-cs; nếu chưa xác minh được, giữ nguyên identifier và văn bản nguồn, không tự gán mã hiện hành. Không đồng nhất mã nhóm với toàn bộ giá trị MA_THE_BHYT trong chuẩn dữ liệu đầu ra hiện hành.

Mã đối tượng KHÔNG tự xác định mức quyền lợi, tỷ lệ cùng chi trả hoặc kết quả adjudication. Hệ thống phải dùng thông tin quyền lợi do Cổng BHXH trả về và pháp luật có hiệu lực tại thời điểm dịch vụ. Từ 01/01/2026, NQ 261/2025/QH15 Điều 2 khoản 1 điểm a và CV 38/BYT-BH ngày 06/01/2026 chuyển CN và người từ đủ 75 tuổi trở lên thuộc LH sang mã quyền lợi 2 (100% trong phạm vi được hưởng).

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. PHẠM VI CĂN CỨ: QĐ 3176/QĐ-BYT cho phép để trống trường SO_CCCD trong trường hợp bất khả kháng (trẻ sơ sinh, người mất ý thức/tâm thần không lấy được số định danh) — đó là chế định nghiệp vụ. TẬP LÝ DO thì không văn bản nào ban hành, do VN Core thiết kế để ghi nhận có cấu trúc thay vì bỏ trống không lời giải thích.

Phân biệt giấy chứng sinh CẤP LẦN ĐẦU với giấy CẤP LẠI, theo chỉ tiêu LAN_CAP của QĐ 2919/QĐ-BYT (Phụ lục I STT 3 và Phụ lục II STT 3).

Vì sao cần extension riêng. Composition.status của FHIR R4 mô tả vòng đời BẢN GHI (preliminary | final | amended | entered-in-error), không mô tả việc cơ sở cấp lại một giấy mới cho cùng lần sinh. Một giấy cấp lại vẫn là final ngay từ đầu và không phải bản sửa của giấy trước — nó là chứng từ độc lập, có mã MA_GCS riêng. Nhồi thông tin này vào status sẽ làm sai cả hai ý nghĩa.

Vì sao code chứ không phải boolean. Văn bản công bố hai giá trị 0 và 1 chứ không phải một cờ có/không, và để ngỏ khả năng bổ sung giá trị. Dùng boolean sẽ phải tự đặt tên cho một trong hai nhánh và mất khả năng mở rộng.

Giữ nguyên lexical của văn bản. Giá trị là chính chuỗi 0/1 mà chỉ tiêu công bố, không phiên dịch sang nhãn tiếng Anh — để đối soát ngược với dữ liệu gốc không cần bảng tra.

Khai căn cứ pháp lý khiến nghĩa vụ có giấy phép hành nghề KHÔNG áp dụng cho người này TRONG PHẠM VI vai trò hành nghề tại một cơ sở, theo Luật 15/2023/QH15 Điều 19 khoản 2, 3, 4.

Vì sao ở PractitionerRole. Miễn trừ luôn hữu hạn theo tổ hợp (cơ sở, thời gian, phạm vi, người giám sát): học viên thực hành TẠI cơ sở hướng dẫn dưới người hướng dẫn; đợt KCB nhân đạo theo văn bản cho phép của đợt; huy động khẩn cấp theo quyết định huy động. Các chiều đó là element NATIVE của role — organization (cơ sở), period (thời hạn), location, code/specialty/healthcareService (phạm vi) — extension này không lặp lại chúng mà chỉ mang phần FHIR không có sẵn: căn cứ, người giám sát và bằng chứng.

Đây không phải cửa thoát cho dữ liệu thiếu. Invariant vn-role-exemption-bounded buộc role mang miễn trừ phải có cơ sở + thời hạn hữu hạn; vn-role-exemption-trainee-supervised buộc nhóm học viên/thực hành có người giám sát xác định được. Bằng chứng (evidence) nhận Reference(DocumentReference) khi văn bản đã số hoá HOẶC Identifier (số quyết định huy động/văn bản cho phép) khi thực địa chỉ có số hiệu giấy — không chấp nhận tuyên bố suông.

NGỪNG AUTHORING TỪ 0.10.0 (quyết định governance 12/08/2026, analysis/99 mục 3; CORE-P1-18 review 97a): miễn trừ GPHN là quyền CÓ GIỚI HẠN theo cơ-sở/thời-gian/phạm-vi — đặt ở cấp Practitioner thì miễn trừ tại cơ sở A dùng được vô hạn để hành nghề độc lập tại B. Bản ghi MỚI dùng vn-ext-practice-license-exemption-role trên PractitionerRole (có supervisor + evidence, bị ràng organization + period hữu hạn). Extension này giữ nguyên định nghĩa để ĐỌC dữ liệu 0.9/đầu-0.10; dự kiến gỡ khỏi profile Practitioner ở 0.11.

Khai căn cứ pháp lý khiến nghĩa vụ có giấy phép hành nghề KHÔNG áp dụng cho người này, theo Luật 15/2023/QH15 Điều 19 khoản 2, 3 và 4.

Vì sao là extension trên Practitioner chứ không phải một trạng thái credential. Những người thuộc diện miễn trừ thường KHÔNG CÓ credential nào để gắn trạng thái lên — sinh viên đang thực hành, nhân viên y tế thôn bản, người cấp cứu tại cộng đồng. Miễn trừ là thuộc tính của con người trong một bối cảnh hành nghề cụ thể, không phải thuộc tính của một giấy tờ.

Đây không phải cửa thoát cho dữ liệu thiếu. Khai extension này là một tuyên bố pháp lý có thể kiểm chứng ngoài hệ thống: người giám sát với nhóm thực hành, chương trình đào tạo với y tế thôn bản, quyết định huy động với nhóm khẩn cấp, giấy phép hành nghề nước ngoài và văn bản cho phép đợt KCB nhân đạo với nhóm nước ngoài. Bên dựa vào dữ liệu phải đối chiếu được, không chấp nhận suông.

Mũi tiêm chủng xảy ra TRƯỚC sự cố bất lợi, làm căn cứ xếp bản ghi vào miền 'sự cố bất lợi sau tiêm chủng' (AEFI). Extension này chỉ ghi nhận LIÊN HỆ THỜI GIAN (temporal association), KHÔNG hàm ý mũi tiêm bị nghi ngờ gây ra sự cố.

Phân biệt với AdverseEvent.suspectEntity: theo R4, suspectEntity là thực thể nghi ngờ gây ra sự cố (instance 'describes the entity that is suspected to have caused the adverse event'). TT 13/2026/TT-BYT Điều 2 khoản 2 định nghĩa AEFI là hiện tượng bất thường về sức khoẻ xảy ra sau tiêm chủng, 'không nhất thiết do việc sử dụng vắc xin, sinh phẩm' — nghĩa là một báo cáo AEFI hợp lệ có thể CHƯA có bất kỳ nghi ngờ nhân quả nào (ví dụ sự cố trùng hợp do bệnh lý khác). Khi đó dùng extension này để truy được mũi tiêm; chỉ khai suspectEntity khi thực sự có nghi ngờ nhân quả. Invariant vn-aefi-immunization-linked của VNCoreAdverseEventPostImmunization yêu cầu ít nhất một trong hai đường liên kết tồn tại.

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. QĐ 34/2020/QĐ-TTg là nguồn trực tiếp của bộ mã. TT 28/2016/TT-BYT đã hết hiệu lực từ 15/02/2026 theo TT 56/2025/TT-BYT Điều 22 khoản 2 và không được dùng làm căn cứ hiện hành cho binding này.

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ụ/vật tư (NGAY_YL). Mapping XML 3176: NGAY_YL. Chỉ dùng cho resource KHÔNG có element ngày y lệnh sẵn trong FHIR R4. MedicationRequest và ServiceRequest đã có authoredOn nên phải dùng element gốc, không dùng extension này (kiểm toán 31/07/2026 — analysis/77 mục B5). Nguồn thiết kế: OHP Data Processor (procedure-order-date).

Năm trục ĐỘC LẬP mô tả cách một dòng chi phí trên bảng kê được hình thành: vai trò dòng, cơ sở tính, quy tắc trần, miễn trần (lặp được) và phiên bản bộ công thức.

Vì sao không mã hoá bằng một enum tổ hợp. Các trục thực sự độc lập với nhau. Một dòng thiết bị thành phần trong gói có thể vừa lấy giá trị báo cáo làm căn cứ, vừa thuộc diện miễn trần theo NĐ 188/2025/NĐ-CP Điều 16 — ba sự thật không suy ra được từ nhau. Liệt kê tổ hợp sẽ nổ số lượng mã và vẫn bỏ sót khi văn bản mới thêm một nhánh.

Vì sao cần formulaVersion. Hai bộ quy tắc chạy song song và KHÔNG trùng nhau: mẫu bảng kê QĐ 697/QĐ-BYT và chuẩn dữ liệu XML của chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT. Công thức không thu thêm phần chênh lệch chỉ có ở bộ thứ hai. Không khai rõ dòng theo bộ nào thì mọi phép đối soát đều mơ hồ.

Ranh giới. Extension mô tả dòng được tính THEO CÁCH NÀO; nó không tự tính và không thay giá trị tiền. Số tiền vẫn nằm ở carrier chi phí, và cột 9 luôn là giá trị authoritative.

Nhóm nguyên nhân gây ra sự cố y khoa theo Mục IV Phụ lục IV TT 43/2018/TT-BYT — trục thứ ba trong ba trục phân loại bắt buộc tại Điều 7 khoản 1.

Vì sao phải là extension. FHIR R4 không có element nào mang yếu tố góp phần gây ra sự cố. AdverseEvent.suspectEntity mang THỰC THỂ nghi gây hại — một thuốc, một thiết bị — chứ không phải nguyên nhân dạng "nhận thức của nhân viên" hay "văn hoá tổ chức"; mượn nó cho trục này sẽ biến một yếu tố tổ chức thành một sản phẩm bị nghi ngờ. Element contributingFactor chỉ xuất hiện từ R5. Vì vậy VN Core khai extension riêng thay vì bẻ nghĩa element sẵn có.

Lặp lại được. Điều 8 giao việc phân tích yếu tố ảnh hưởng và nguyên nhân gốc cho bộ phận tiếp nhận; một sự cố thường có nhiều nguyên nhân cùng lúc (nhân viên + tổ chức + môi trường), nên extension này là 0..* trên profile.

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ới các văn bản sửa đổi, bổ sung TT 50/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.

Bằng chứng về nội dung đã thông báo cho chủ thể dữ liệu tại thời điểm xin sự đồng ý, theo Luật 91/2025/QH15 Điều 9 khoản 2 và NĐ 356/2025/NĐ-CP Điều 6.

Vì sao cần. Luật đặt điều kiện hiệu lực cho sự đồng ý: chỉ có hiệu lực khi chủ thể biết rõ ba nhóm thông tin. Trước 0.10.0, VN Core chỉ có Consent.organization (tổ chức quản lý bản ghi — mà chính profile ghi rõ là KHÔNG suy ra được vai trò pháp lý), provision.purpose (mục đích) và source[x] (bản gốc tuỳ chọn). Không có chỗ nào mang loại dữ liệu đã thông báo, danh tính và vai trò của bên kiểm soát, hay bản thông báo quyền và nghĩa vụ. Khi tranh chấp, nghĩa vụ chứng minh thuộc về bên kiểm soát (NĐ 356/2025/NĐ-CP Điều 6 khoản 2) — mà dữ liệu để chứng minh thì không tồn tại.

Bốn phần tử bắt buộc bám bốn yêu cầu của văn bản:

Mục đích xử lý — nửa còn lại của điểm a — vẫn nằm ở Consent.provision.provision.purpose, nơi FHIR đã có sẵn ngữ nghĩa và nơi sự đồng ý được thể hiện theo TỪNG mục đích (Điều 9 khoản 4 điểm a); VNCoreConsent ép mọi rule permit phải có purpose.

Khai báo, không phải phép màu. Extension này ghi lại hệ thống tuyên bố đã thông báo những gì. Nó không tự chứng minh rằng nội dung đó đã thực sự đến với chủ thể, cũng không thay cho bản gốc đồng ý. Giá trị của nó là biến nghĩa vụ chứng minh thành dữ liệu kiểm được: thiếu phần tử nào thì thấy ngay, và bản ghi nào thiếu thì không đạt profile.

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.

Mức kiểm soát đặc biệt của một thuốc hoặc nguyên liệu làm thuốc, theo trục bảy giá trị tại mục 6.4.4 QĐ 232/QĐ-TTYQG. Đặt trên VNCoreMedication để sổ xuất–nhập–tồn, sổ sử dụng và các chế độ báo cáo tại QĐ 2716/QĐ-BYT tổng hợp được theo nhóm kiểm soát. / Special-control classification of a medicine or drug material per section 6.4.4 of Decision 232/QĐ-TTYQG.

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 cùng TT 24/2026/TT-BYT. TT 59/2025/TT-BYT đã hết hiệu lực từ 01/07/2026. Extension này là tuỳ 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.

Một phân đoạn của bảng kê chi phí: một thẻ BHYT (hoặc không thẻ) trong một khoảng thời gian với một mức hưởng.

Mẫu bảng kê của QĐ 697/QĐ-BYT lặp phần chi phí theo từng thẻ và từng mức hưởng trong cùng một đợt khám chữa bệnh — một người có thể đổi thẻ giữa đợt, hoặc cùng một thẻ đổi mức hưởng khi đủ điều kiện (NĐ 188/2025/NĐ-CP Điều 21). Extension này biểu diễn đúng cách lặp đó.

Khác biệt cốt lõi so với vn-ext-coverage-benefit-stage (dùng trên Claim, đã ngừng): coverage ở đây là 0..1. QĐ 697/QĐ-BYT Phần Hai hướng dẫn lập bảng kê cho người không có thẻ bảo hiểm y tế — trường hợp đó phân đoạn không có Coverage nào và mức hưởng để trống. Đây chính là điều Claim không biểu diễn được vì Claim.insurance là 1..* (xem ADR-0021).

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ý: VBHN 08/VBHN-BYT năm 2026 hợp nhất NĐ 98/2021/NĐ-CP và các văn bản sửa đổi. Điều 21 quy định loại định danh pháp lý, không quy định lexical format của chuỗi số:

• đối với thiết bị loại A, B: số lưu hành là số công bố tiêu chuẩn áp dụng;
• đối với thiết bị loại C, D: số lưu hành là số giấy chứng nhận đăng ký lưu hành;
• số lưu hành có giá trị không thời hạn, trừ trường hợp cấp khẩn cấp theo Điều 21 khoản 3.

VN Core bảo toàn nguyên chuỗi số do cơ quan tiếp nhận/cấp cung cấp và không áp regex PCBA/PCBB/ĐKLH, vì các pattern đó không được Điều 21 ban hành. Điều 22 khoản 1 điểm a còn thừa nhận các giấy tờ/số theo quy định chuyển tiếp và Điều 24 quy định các trường hợp miễn công bố, miễn đăng ký; extension này vì vậy là carrier khi có số lưu hành, không tự chứng minh đủ điều kiện lưu hành.

Đâ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/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 hoá, 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).

Ba thuộc tính của một dòng bảng kê mà Invoice.lineItem của FHIR R4 không có sẵn: phân đoạn thẻ mà dòng thuộc về, nhóm chi phí, và ngày hoặc khoảng thực hiện.

Invoice.lineItem chỉ có sequence, chargeItem[x] và priceComponent. Ba dữ liệu dưới đây là cột bắt buộc của mẫu QĐ 697/QĐ-BYT nên phải bổ sung; số lượng và tiền thì dùng element gốc (priceComponent.factor và priceComponent.amount).

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 Claim.item, Claim.item.detail, ExplanationOfBenefit.item, ExplanationOfBenefit.item.detail và Invoice.lineItem. Thông tin từ các resource lâm sàng hoặc dược được đưa vào dòng chi phí tương ứng; không gắn extension này trực tiếp lên những resource nguồn đó. 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 đọc cùng QĐ 1931/QĐ-BYT (áp dụng từ 01/07/2026) cho trường MUC_HUONG/SO_DANG_KY; QĐ 697/QĐ-BYT cho các cột bảng kê; VBHN 14/VBHN-BYT (hợp nhất TT 04/2017/TT-BYT với TT 50/2017/TT-BYT và TT 24/2025/TT-BYT) cho mức thanh toán TBYT; NĐ 188/2025/NĐ-CP là bối cảnh quyền lợi/ngoại lệ, không phải nguồn duy nhất của mọi trần dòng chi phí. English summary: Reusable BHYT cost information on Claim/EOB items and item details, and Invoice line items. Medication, procedure and service facts are represented on the corresponding financial line, not by placing this extension on the source clinical resource. 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 hành động thay người khác. Mô hình hoá 'token đại diện' phục vụ Policy Decision Point (PDP): miền thẩm quyền, loại thẩm quyền, nguồn xác minh, bằng chứng, 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.10.0 đợt 2 (breaking — kiểm toán 06-07/08/2026, analysis/90 §6.2): tách HAI MIỀN thẩm quyền bằng domain 1..1, vì hai loại quyền không đồng nhất và không suy ra nhau: (1) healthcare-decision — quyết định thay về khám chữa bệnh (Luật KCB 15/2023/QH15 Điều 8); (2) data-subject-rights — thực hiện quyền chủ thể dữ liệu thay chủ thể: đồng ý, truy cập, chỉnh sửa, xoá dữ liệu (Luật 91/2025/QH15 Điều 24; Bộ luật Dân sự Điều 134-143) — vd cha/mẹ xem Sổ SKĐT của con qua VNeID. Một người giữ cả hai quyền = HAI instance extension, mỗi instance một miền với căn cứ, bằng chứng, thời hạn riêng. selectionBasis hạ 1..1 → 0..1: nó là khung của Luật KCB Điều 8 khoản 2 nên bắt buộc trong miền healthcare-decision và phải vắng trong miền data-subject-rights (invariant vn-representation-domain-basis). Thêm evidence 0..* — bằng chứng lặp được mang issuer/document/scope/purpose/validity; quan hệ gia đình hoặc bản ghi quan hệ dân cư KHÔNG tự chứng minh thẩm quyền (uỷ quyền bắt buộc có evidence — invariant vn-representation-proxy-evidence).

THAY ĐỔI 0.10.0 đợt 1 (breaking): thêm selectionBasis — một trong năm nhóm căn cứ lựa chọn tại Luật KCB 15/2023/QH15 Điều 8 khoản 2 điểm a-đ; thêm legalProvision 1..* để ghi văn bản và điều/khoản cụ thể, cho phép lặp vì một thẩm quyền thường dựa trên nhiều quy định đồng thời; nâng verifiedDate từ 0..1 lên 1..1. Kèm invariant vn-representation-type-selection-basis ràng loại thẩm quyền với nhóm căn cứ. Quy tắc một người bệnh chỉ có một người đại diện tại một thời điểm (Điều 8 khoản 1) CỐ Ý không invariant-hoá: nó cần truy vấn toàn bộ authority đang hiệu lực của cùng người bệnh, việc một instance đơn lẻ không thấy được — thuộc tầng PDP/service.

THAY ĐỔI 0.8.0 (breaking — hậu kiểm toán Codex): sub-extension restrictedSensitivity đã XOÁ — 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 hồ sơ sự cố vi phạm dữ liệu cá nhân, ghi trên AuditEvent của chính sự cố đó.

Phạm vi hẹp — đọc kỹ trước khi dùng. 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ố' — và điều khoản này áp cho hồ sơ sự cố liên quan dữ liệu vị trí và dữ liệu sinh trắc học, không phải cho nhật ký truy cập nói chung.

Vì vậy extension này CHỈ dùng trên AuditEvent ghi nhận một sự cố vi phạm thuộc phạm vi trên. KHÔNG dùng làm thời hạn lưu trữ chung cho mọi nhật ký truy cập: thời hạn lưu nhật ký là chính sách ở cấp hệ thống và cấp phân loại dữ liệu, gắn một khoảng thời gian tuỳ ý lên mọi AuditEvent vừa sai căn cứ vừa làm tăng lượng dữ liệu phải giữ.

Trước 0.10.0, phần mô tả có câu 'khuyến nghị mặc định 5 năm cho mọi loại DLCN nhạy cảm' — đó là mở rộng quá phạm vi điều khoản, đã gỡ (kiểm toán 31/07/2026 — analysis/77 mục C1).

Complex extension mang trạng thái pháp lý của một identifier giấy phép hành nghề (GPHN) hoặc chứng chỉ hành nghề (CCHN) chuyển tiếp, cùng dữ liệu của quyết định đình chỉ nếu có. Extension gắn TRỰC TIẾP vào Identifier.

Vì sao là trạng thái tường minh chứ không phải ngày tháng. Hiệu lực của GPHN không suy được từ identifier.period.end: Luật 15/2023/QH15 Điều 32 khoản 5 điểm b cho phép giấy phép tiếp tục có hiệu lực quá ngày ghi trên giấy phép khi cơ quan có thẩm quyền chưa trả lời hồ sơ gia hạn. Tương tự, CCHN cũ vẫn được dùng như GPHN theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2. Cả hai nhánh này đều vô hình với phép so sánh ngày.

Vì sao cần affectedScope. NĐ 96/2023/NĐ-CP Điều 30 khoản 4 điểm a buộc quyết định đình chỉ ghi rõ đình chỉ một phần hay toàn bộ phạm vi hành nghề, và nếu một phần thì nêu rõ phạm vi. Người bị đình chỉ một phần VẪN hành nghề hợp pháp ở phần còn lại (khoản 5 điểm a: cơ quan "thực hiện việc giới hạn phạm vi hành nghề"), nên không thể coi họ như mất credential.

Vì sao KHÔNG phải modifierExtension. Identifier kế thừa Element, không kế thừa BackboneElement, nên trong FHIR R4 nó không có modifierExtension.

Bên dựa vào dữ liệu phải đọc trạng thái này thay vì tự suy luận từ thời hạn.

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.

Complex extension gắn TRỰC TIẾP vào Identifier của giấy phép hoạt động cơ sở KCB, mang trạng thái pháp lý và dữ liệu của quyết định đình chỉ/thu hồi.

Vì sao gắn vào Identifier chứ không vào Organization: trạng thái này thuộc về CHÍNH credential đó. Một pháp nhân có nhiều địa điểm thì mỗi địa điểm một giấy phép riêng (Luật 15/2023/QH15 Điều 50 khoản 1) và có thể bị đình chỉ độc lập với nhau.

Vì sao KHÔNG phải modifierExtension: Identifier kế thừa Element, không kế thừa BackboneElement, nên trong FHIR R4 nó không có modifierExtension. Extension này bổ sung thông tin về credential, không đảo ngược nghĩa của bất kỳ element nào — đặc biệt KHÔNG thay đổi nghĩa của Organization.active.

Căn cứ: Luật 15/2023/QH15 Điều 50 (giấy phép không thời hạn), Điều 55 (đình chỉ một phần hoặc toàn bộ, thời hạn 01-24 tháng, điều kiện hoạt động trở lại), Điều 56 (thu hồi); NĐ 96/2023/NĐ-CP Điều 78 (nội dung bắt buộc của quyết định đình chỉ và quyết định thu hồi).

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ố trên Address, dùng chung canonical vn-province-cs cho các giai đoạn. FHIR Address.state chỉ là text — extension này bổ sung mã hoá (Coding) để tra cứu chính xác. Binding history cho phép lưu mã có trong các danh mục đã thu nhận; không tự chứng nhận hiệu lực lịch sử. Tra cứu tên và tỉnh quản lý theo ngày hồ sơ chỉ trong khoảng có bằng chứng. Thiếu ngày hoặc bằng chứng phải trả không đủ căn cứ; không thay tên nguồn bằng tên hiện hành. Coding.version là phiên bản bộ mã, không phải ngày hồ sơ. Danh sách chọn mới dùng vn-province-vs tại mốc của bản dữ liệu. Căn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg; NQ 30/2026/QH16 và NQ 36/2026/QH16 (đổi tên mã 75, 22).

Extension tổng hợp chi phí KCB theo từng nhóm nguồn chi trả. Mapping theo chuỗi XML QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT: T_THUOC, T_VTYT, T_BNCCT, T_BNTT, T_BHTT, T_NGUONKHAC, T_BHTT_GDV. Riêng T_NGOAIDS là trường của XML legacy QĐ 4210/QĐ-BYT, giữ để đọc/bridge dữ liệu lịch sử; không coi đó là trường của XML 3176 hoặc tự đổi thành 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 hoá 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).

NGỪNG AUTHORING TỪ 0.10.0 (kiểm toán 07/08/2026, mục 1.12) — giữ định nghĩa để consumer đọc dữ liệu 0.9 legacy; VNCoreCoverage đã khoá 0..0.

Lý do chuyển: tổng cùng chi trả luỹ kế là số liệu CÓ THỜI ĐIỂM — nó thay đổi sau mỗi lượt thanh toán và chỉ có nghĩa gắn với một thời điểm tra cứu. Ghi tĩnh trên Coverage biến ảnh chụp thành thuộc tính của thẻ, sai bản chất và trái cách CV 2036/BHXH-CSYT yêu cầu cơ sở dùng KẾT QUẢ TRA CỨU CÓ THỜI ĐIỂM (và áp quyền lợi cao nhất khi người tham gia thuộc nhiều đối tượng). Biểu diễn thay thế: VNCoreCoverageEligibilityResponse — benefit type = vn-benefit-type-cs#annual-copay-accumulator (0.10.0 đổi từ copay-maximum của HL7 vì mã đó nghĩa là trần cùng chi trả cho MỘT dịch vụ — T-02 review 97b) (allowedMoney = trần miễn cùng chi trả 6 tháng lương cơ sở, usedMoney = luỹ kế đã cùng chi trả), serviced[x] = năm tài chính, created = thời điểm tra cứu.

Căn cứ (của khái niệm luỹ kế cùng chi trả):

• NĐ 188/2025/NĐ-CP — Điều 18 khoản 2 quy định điều kiện và xử lý số cùng chi trả để hưởng quyền lợi không cùng chi trả trong năm tài chính.
• QĐ 697/QĐ-BYT — Phụ lục, nhóm thông tin hành chính 16–18 của bảng kê chi phí.
• Luật 51/2024/QH15 — Sửa đổi Luật BHYT, hiệu lực 01/07/2025.

Vai trò của văn bản được viện dẫn trong một tuyên bố vn-ext-legal-basis: ban hành nội dung (issuing), quy định cách dùng (governing), nền tảng lĩnh vực (foundational), hay chỉ tra cứu lịch sử (historical). Không có vai trò KHÔNG phải lỗi — nhiều tuyên bố chỉ cần nói 'có căn cứ'. Vai trò cần thiết khi artifact biểu diễn một danh mục/biểu mẫu do văn bản ban hành: lúc đó phải chỉ được đúng văn bản NGUỒN, phân biệt với văn bản chỉ quy định cách ghi hoặc đã hết hiệu lực. English: Role of the cited document within a legal-basis assertion. Attached to the Coding itself so that existing assertions remain valid — this is a purely additive change.

Vai trò trao đổi cục bộ của một khai báo Composition.attester trong bảng kê chi phí. Mỗi khai báo giữ vai trò và thời điểm riêng nếu có; một attester có thể mang nhiều khai báo khi cùng một người đảm nhiệm nhiều vai trò. Extension không chứng minh chữ ký, thẩm quyền hoặc việc các vai trò thuộc về những người khác nhau. / Local exchange role carried by a cost-statement Composition attester; each role declaration can retain its own attestation time for the same actor.

Mở rộng ghi nhận mã xã/phường/đặc khu 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ã gồm năm chữ số, giữ số 0 đầu. Binding history dùng chung canonical vn-ward-cs cho mã đã thu nhận; không chứng nhận mọi mã còn hiệu lực hay có đầy đủ lịch sử. Danh sách chọn mới dùng vn-ward-vs tại mốc của bản dữ liệu. Tên và tỉnh quản lý phải tra theo ngày hồ sơ trong khoảng có bằng chứng. Căn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg.

Một đợt điều trị của đơn thuốc gây nghiện giảm đau cho người bệnh ung thư: số thứ tự đợt và khoảng ngày bắt đầu–kết thúc. Căn cứ TT 26/2025/TT-BYT Điều 8 khoản 1: mỗi lần kê đơn tối đa 30 ngày, phải ghi cụ thể 03 đợt điều trị liên tiếp trên một đơn, mỗi đợt không vượt quá 10 ngày, ghi rõ ngày bắt đầu và kết thúc. Extension đặt trên MedicationRequest (cấp ĐƠN, không phải cấp dòng thuốc — mẫu đơn N tại Phụ lục II xếp ba đợt trước mục Thuốc điều trị); ràng buộc số lượng đợt và tính liên tiếp nằm ở profile VNCoreCancerPainNarcoticPrescription. Khi một đơn có nhiều dòng thuốc (nhiều MedicationRequest cùng groupIdentifier), MỌI dòng phải mang cùng một bộ ba đợt — FHIRPath không đọc được resource khác nên ràng buộc liên-dòng do cổng scripts/validate-narcotic-courses.py canh. / One treatment course of a cancer-pain narcotic prescription: course number and its inclusive date range, per Circular 26/2025/TT-BYT Article 8.1.

Logical model đặc tả nội dung mà Nghị định 356/2025/NĐ-CP (ban hành 31/12/2025, hiệu lực 01/01/2026) BUỘC phải có trong bản ghi sự đồng ý của chủ thể dữ liệu và trong thông báo vi phạm quy định bảo vệ dữ liệu cá nhân — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của nhóm profile đồng ý và thông báo vi phạm.

Điều 6 khoản 1 nêu nguyên văn: 'Các phương thức xin sự đồng ý của chủ thể dữ liệu cá nhân 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 ý.' Ba thông tin ấy là điều kiện để sự đồng ý KIỂM CHỨNG ĐƯỢC — thiếu một trong ba thì bản ghi không chứng minh được gì. Khoản 2 buộc lưu trữ sự đồng ý và đặt trách nhiệm chứng minh lên bên kiểm soát dữ liệu khi có tranh chấp; khoản 4 buộc thông báo rõ cho chủ thể khi dữ liệu cần xử lý là dữ liệu cá nhân NHẠY CẢM — mọi dữ liệu sức khoẻ đều thuộc nhóm này.

Điều 28 khoản 1 liệt kê bốn nhóm nội dung của thông báo vi phạm: (a) mô tả tính chất vi phạm gồm thời gian, địa điểm, hành vi, tổ chức/cá nhân, các loại dữ liệu và số lượng dữ liệu liên quan; (b) chi tiết liên lạc của bộ phận hoặc nhân sự bảo vệ dữ liệu cá nhân; (c) mô tả hậu quả, thiệt hại có thể xảy ra; (d) mô tả biện pháp giải quyết, giảm thiểu tác hại. / Logical model for the consent record and data-breach notification content required by Decree 356/2025/NĐ-CP.

Logical model cho bản tin (envelope) đồng bộ tự động tập dữ liệu khám sức khoẻ định kỳ từ cơ sở KCB lên Cổng/Trục dữ liệu sức khoẻ 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 hoá 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 khoẻ 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 khoẻ 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 khoẻ 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 khoẻ BHXH → CSDL sức khoẻ 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. QĐ 5937/QĐ-BYT và chuỗi QĐ 3176/QĐ-BYT là nguồn trực tiếp của trường/mã dữ liệu XML; Luật Người khuyết tật, NĐ 28/2012/NĐ-CP và VBHN 11/VBHN-BYT năm 2026 cung cấp ngữ nghĩa và quy trình xác định mức độ khuyết tật, không tự tạo ra bộ mã số XML.

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 LEGACY cho Bảng 9 giấy chứng sinh — KHÔNG phải schema hiện hành.

Lineage. QĐ 2919/QĐ-BYT Điều 3 bãi bỏ thẳng Bảng 9. Chỉ tiêu dữ liệu Giấy chứng sinh ban hành kèm theo Quyết định số 130/QĐ-BYT ngày 18/01/2023 (đồng thời bãi bỏ QĐ 1898/QĐ-BYT), hiệu lực 01/10/2025. Cấu trúc 35 trường trong LM này vì vậy chỉ còn giá trị ĐỌC/ĐỐI SOÁT giấy chứng sinh cấp TRƯỚC 01/10/2025.

Không dùng để sinh dữ liệu mới. Giấy cấp từ 01/10/2025 theo QĐ 2919/QĐ-BYT, gồm HAI schema riêng: Phụ lục I (sinh thường, 30 chỉ tiêu) và Phụ lục II (mang thai hộ, 45 chỉ tiêu). Hai schema đó KHÔNG phải một delta nhỏ của Bảng 9 — số trường, cách chia khối và vai trò các bên đều khác — nên chúng có logical model riêng thay vì sửa LM này.

Vì sao giữ LM cũ thay vì repurpose canonical. Đổi nội dung canonical này sang QĐ 2919/QĐ-BYT sẽ khiến payload lịch sử đổi nghĩa theo phiên bản package: cùng một tài liệu, đọc bằng hai version IG khác nhau lại ra hai schema khác nhau. Việc bãi bỏ chuẩn cho dữ liệu MỚI không làm mất giá trị audit của giấy đã cấp hợp lệ trước đó.

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 Phần III Phụ lục QĐ 2682/QĐ-BYT: thông tin cơ sở KCB (35 trường) và danh mục thiết bị, vật tư y tế (10 trường; văn bản dẫn QĐ 3373/QĐ-BYT 29/8/2023 — chưa có trong sổ đăng ký). 'Cấp đơn vị' 1–5 là cấp quản lý (Bộ, Sở, xã, bộ ngành khác…), không phải tuyến hay cấp chuyên môn; 'Tình trạng CSKCB' 0–4 là trạng thái quy trình đăng ký, không phải trạng thái giấy phép.

Cấu trúc bản ghi Danh mục bệnh y học cổ truyền, gồm 6 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Traditional Medicine Disease Catalog, containing 6 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục bệnh, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Disease Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục chương bệnh, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Disease Chapter Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục các nhóm đối tượng khuyết tật, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Disability Beneficiary Group Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục dạng tật, gồm 5 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Disability Type Catalog, containing 5 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục hưởng chính sách trợ cấp xã hội, hỗ trợ kinh phí chăm sóc nuôi dưỡng hàng tháng, gồm 8 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Monthly Social Allowance Catalog, containing 8 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục hưởng trợ giúp tại cơ sở trợ giúp xã hội, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Institutional Social Assistance Service Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục loại bệnh, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Disease Type Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục loại hình cơ sở khám chữa bệnh, gồm 3 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Healthcare Facility Type Catalog, containing 3 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục mã đối tượng khám bệnh, chữa bệnh, gồm 5 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Patient Visit Type Catalog, containing 5 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục mức độ khuyết tật, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Disability Severity Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục nguyên nhân tử vong, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Death Cause Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục người làm công tác xã hội, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Social Work Type Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục nhóm bệnh, gồm 10 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Disease Group Catalog, containing 10 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục phạm vi hành nghề của người hành nghề, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Practitioner Practice Scope Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục quy mô, phạm vi hoạt động chuyên môn của cơ sở khám bệnh, chữa bệnh, gồm 5 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Healthcare Facility Technical Scope Catalog, containing 5 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục văn bằng đào tạo của người hành nghề, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Practitioner Qualification Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Cấu trúc bản ghi Danh mục đối tượng tại cơ sở trợ giúp xã hội, gồm 4 trường theo Phụ lục 1 QĐ 2113/QĐ-BYT. Mô hình giữ tên, kiểu và mô tả nguồn; cardinality 0..1 là lựa chọn mô hình hoá của VN Core khi bảng không quy định tính bắt buộc. / Record schema for Institutional Social Assistance Beneficiary Catalog, containing 4 source fields from Appendix 1 of Decision 2113/QD-BYT. Source names, types and descriptions are retained; 0..1 cardinality is a VN Core modeling choice where the table does not specify requiredness.

Logical model cho Phần IV Phụ lục QĐ 2682/QĐ-BYT: 8 trường của bảng danh mục kỹ thuật theo TT 23/2024/TT-BYT (chương, số thứ tự, mã, tên, ngày áp dụng). Mã kỹ thuật trần va chạm giữa PL1 và PL2 (vd 1.206) nên khi trao đổi phải kèm hệ mã/edition (vn-dvkt-cs, vn-dvkt-pl2-cs). Mốc 'Từ ngày 01/7/2026' của trường Ngày áp dụng là mô tả trong ô bảng, lệch TT 25/2026/TT-BYT Điều 3 (PL1 đến hết 31/12/2027, PL2 từ 01/01/2028) — ghi nhận, không dùng đổi hiệu lực.

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 cho Phần VI Phụ lục QĐ 2682/QĐ-BYT: 22 trường của dòng chi phí KCB theo đợt tổng hợp báo cáo, văn bản căn cứ TT 12/2026/TT-BTC. Không phải toàn bộ Claim và không phải biên bản quyết toán quý (Mẫu 06/BH). 'Mã loại khám chữa bệnh 01–09 theo QĐ 824/QĐ-BYT' trong văn bản đã cũ so với 16 mã của QĐ 1804/QĐ-BYT — ghi nhận ở comment.

Logical model đặc tả thông tin mà Quyết định 2113/QĐ-BYT buộc lưu trong dữ liệu truy vết, và thông tin mà Thông tư 47/2026/TT-BCA buộc có trong nhật ký truy cập hệ thống — Chỉ phần THỨ NHẤT làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile Provenance; phần thứ hai KHÔNG đóng vai trò ấy cho AuditEvent, vì lý do phạm vi nêu bên dưới.

QĐ 2113/QĐ-BYT, Lớp 4 của mô hình an toàn dữ liệu, nêu nguyên văn: 'Truy vết dữ liệu (Data Lineage): là yêu cầu bắt buộc đối với tất cả hệ thống có chức năng chia sẻ, tích hợp hoặc phân tích dữ liệu. Dữ liệu truy vết phải bảo đảm lưu lại đầy đủ các thông tin sau: nguồn gốc dữ liệu; thời điểm và điều kiện thu thập; các hành động xử lý đã thực hiện; tổ chức hoặc đơn vị thực hiện hành động đó.'

TT 47/2026/TT-BCA mục 3.9.2.1.4 nêu: 'Nhật ký truy cập hệ thống tối thiểu bao gồm các thông tin: địa chỉ nguồn, địa chỉ đích, tài khoản đích và thời điểm xảy ra sự kiện.' PHẠM VI: TT 47/2026/TT-BCA là QUY CHUẨN cho 'hệ thống thông tin lưu trữ tài liệu điện tử trong các cơ quan Đảng, Nhà nước' (mục 1.1), KHÔNG phải cho cơ sở khám bệnh, chữa bệnh nói chung — nên đây chỉ là căn cứ CÓ ĐIỀU KIỆN, áp khi hệ thống thật sự thuộc phạm vi Quy chuẩn. ĐÍNH CHÍNH 07/09/2026: câu trước đó trong chính Description này nói 'QĐ 2113/QĐ-BYT không quy định gì về nhật ký truy cập' là SAI — phụ lục của quyết định ấy CÓ, ở Lớp 5 'Người dùng an toàn': 'cá nhân truy cập vào hệ thống phải được xác thực định danh… Hệ thống phải ghi nhận đầy đủ lịch sử truy cập và có khả năng kiểm tra, truy vết (audit)', phạm vi tại mục III phủ 'các cơ sở y tế công lập và ngoài công lập'. Đó là nghĩa vụ NĂNG LỰC đúng phạm vi nhưng KHÔNG liệt kê trường — khác hẳn Lớp 4 vốn nói 'là yêu cầu bắt buộc' rồi liệt kê đủ bốn thông tin. Vì vậy MỌI trường của nhóm nhật ký khai 0..1, nhóm này KHÔNG dùng làm bảng chỉ tiêu đối chiếu ở chiều P-A, và ô sổ cái của VNCoreAuditEvent ở trạng thái hoãn.

Logical model cho Phần V Phụ lục QĐ 2682/QĐ-BYT: 46 trường trong tám bảng cấu hình giá — danh mục kỹ thuật (lặp Phần IV), loại cơ sở/dịch vụ, cấu hình giá khám bệnh, dịch vụ giường, hạng bệnh viện, giá ngày giường theo hạng, danh mục dịch vụ kỹ thuật và cấu hình giá dịch vụ. Đây là cấu trúc bảng CSDL (khoá chính/khoá ngoại/mã ví dụ), tương ứng VNCoreChargeItemDefinition khi có đủ cơ sở áp dụng và thời gian hiệu lực; số thông tư mặc định 22/2023/TT-BYT là giá LỊCH SỬ (hết hiệu lực 01/01/2025).

Bốn mươi lăm chỉ tiêu dữ liệu điện tử Giấy chứng sinh cho trường hợp MANG THAI HỘ theo QĐ 2919/QĐ-BYT Phụ lục II, áp dụng cho giấy cấp TỪ 01/10/2025.

KHÔNG DÙNG ĐỂ SINH XML. Model này là mô hình NGỮ NGHĨA, không phải wire contract. Phụ lục II có sáu cặp chỉ tiêu TRÙNG TÊN nhưng mang hai vai trò khác nhau, nên không thể sinh ra một tài liệu XML mà bên nhận phân biệt được ai là ai:

Việc chuẩn hoá khoảng trắng KHÔNG cứu được: sau khi bỏ khoảng trắng (MA_DANTOC_CHONG_N MTH → MA_DANTOC_CHONG_NMTH) hai chỉ tiêu vẫn trùng tên. Đặt thêm hậu tố tự nghĩ ra để tách chúng là BỊA wire name — bên nhận không có cơ sở nào biết quy ước đó. Cổng sinh XML chỉ được mở khi có một trong ba: XSD hoặc data dictionary chính thức, văn bản đính chính, hoặc mẫu XML thực tế có nguồn gốc từ hệ thống liên thông và được chủ quản xác nhận.

Hai tên chỉ tiêu mang chữ CHONG nhưng thuộc về NGƯỜI VỢ — căn cứ khác nhau cho từng chỉ tiêu. STT 17 mâu thuẫn với chính diễn giải của nó: diễn giải ghi nguyên văn 'Ghi mã dân tộc của người vợ bên mang thai hộ'. STT 6 thì diễn giải KHÔNG nói vai trò — chỉ có đường link tra cứu danh mục dân tộc; căn cứ xác định vai trò vợ ở đây là VỊ TRÍ chỉ tiêu trong khối STT 4-9 (toàn khối là thông tin vợ bên nhờ mang thai hộ) cùng bố cục mẫu giấy. Model đặt tên phần tử theo VAI TRÒ THẬT, tên công bố giữ nguyên trạng ở ^mapping.

Phụ lục II THIẾU sáu chỉ tiêu mà Phụ lục I có (đã đối chiếu toàn văn): TINH_TRANG_CON, NGAY_CS, GHI_CHU, SINHCON_PHAUTHUAT, SINHCON_DUOI32TUAN, SINHCON_PHAUTHUAT_DUOI32TUAN. Nghiêm trọng nhất là TINH_TRANG_CON — ở Phụ lục I đây là trường BẮT BUỘC với yêu cầu 'trường hợp dị dạng, dị tật phải ghi cụ thể'; giấy chứng sinh mang thai hộ vì vậy không có chỗ ghi tình trạng trẻ. NGAY_CS vắng trong khi mẫu giấy vẫn có dòng ngày cấp. Model KHÔNG tự thêm trường mà văn bản không công bố.

Chồng bên mang thai hộ: bảng và mẫu mâu thuẫn. Bảng chỉ tiêu đánh bắt buộc (X) cho toàn bộ STT 21-24, nhưng chính mẫu giấy ghi 'Họ, chữ đệm, tên khai sinh của chồng (nếu có)' và chú thích 'Trong trường hợp không có thông tin người chồng bên mang thai hộ thì bỏ trống'. Model theo mẫu (0..1) vì đó là quy tắc nghiệp vụ dứt khoát; trạng thái bắt buộc theo bảng được lưu ở ^comment từng trường để không mất dấu xung đột.

Cấu trúc phẳng, không lồng. Tên phần tử mang tiền tố vai trò (intendedMother*, intendedFather*, surrogateMother*, surrogateFather*) thay vì lồng BackboneElement — nhất quán với toàn bộ logical model khác trong IG.

Ba mươi chỉ tiêu dữ liệu điện tử Giấy chứng sinh theo QĐ 2919/QĐ-BYT Phụ lục I, áp dụng cho giấy cấp TỪ 01/10/2025.

Thay cho schema nào. QĐ 2919/QĐ-BYT Điều 3 bãi bỏ Bảng 9 của QĐ 130/QĐ-BYT và bãi bỏ QĐ 1898/QĐ-BYT. Dữ liệu phát sinh trước 01/10/2025 vẫn đọc bằng BHYTXML9BirthCertificateLM (legacy, 35 trường); hai model chạy song song chứ không thay thế nhau.

Trường hợp mang thai hộ dùng model KHÁC. Phụ lục II có schema riêng 45 chỉ tiêu với các bên nhờ mang thai hộ và bên mang thai hộ — xem VNSurrogacyBirthCertificateLM.

Kiểu dữ liệu công bố vs kiểu dùng ở đây. Văn bản công bố MA_BHXH_ME và SOCON_LANNAY kiểu Số, nhưng model dùng string: mã BHXH 10 chữ số là ĐỊNH DANH, không phải lượng — ép sang số nguyên sẽ mất số 0 đứng đầu và không còn so khớp được với dữ liệu gốc. Từng trường có ^comment ghi rõ kiểu công bố.

Tên chỉ tiêu chứa khoảng trắng là lỗi soạn thảo của văn bản. Ba chỉ tiêu tại mục Ghi chú xuất hiện dưới dạng SINHCON_PHAUTH UAT, SINHCON_DUOI32T UAN, SINHCON_PHAUTH UAT_DUOI32TUAN — khoảng trắng nằm ngay trong bản DOCX gốc, không phải lỗi khi trích văn bản. Model dùng tên đã bỏ khoảng trắng; tên công bố nguyên trạng lưu ở ^mapping với identity birth-certificate-published để đối chiếu được với văn bản.

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 hoá GÓI DỮ LIỆU kết xuất theo CV 365, KHÔNG mô hình hoá 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 cho Phần I.2 Phụ lục QĐ 2682/QĐ-BYT: ba mẫu phiếu khám sức khoẻ và khám sức khoẻ định kỳ theo QĐ 1551/QĐ-BYT và QĐ 2062/QĐ-BYT — trẻ dưới 6 tuổi (109 trường), từ đủ 6 đến dưới 18 tuổi (87), từ đủ 18 tuổi (123). Từng trường được đối chiếu với item của ba Questionnaire KSK hiện có (VNKSKQuestionnaireU06/06to18/18Plus) trong ledger; kiểu dữ liệu giữ theo văn bản — nơi văn bản khai decimal mà Questionnaire dùng integer (chiều dài, vòng đầu, vòng cánh tay, chiều cao) được ghi ở comment.

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 khoẻ đ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 gom ba nhóm nghĩa vụ ghi trường còn lại của đợt đối chiếu nhóm (A), mỗi nhóm một văn bản nguồn — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của các profile tương ứng.

Nhóm địa chỉ và giấy chứng sinh theo QĐ 2919/QĐ-BYT Phụ lục I: bảng chỉ tiêu đánh dấu X vào ba trường nơi cư trú — NOI_CU_TRU (địa chỉ đầy đủ, tối đa 1024 ký tự), MATINH_CU_TRU (mã đơn vị hành chính cấp tỉnh, 2 ký tự) và MAXA_CU_TRU (mã đơn vị hành chính cấp xã/phường, 5 ký tự) — cùng mã giấy chứng sinh MA_GCS. Hai mã hành chính tách riêng khỏi địa chỉ chữ là có lý do: địa chỉ chữ để người đọc, còn mã để máy đối chiếu với danh mục đơn vị hành chính.

Nhóm mã bệnh theo QĐ 3176/QĐ-BYT Bảng 1 chỉ tiêu 27: 'Ghi mã bệnh chính theo mã ICD-10 do Bộ trưởng Bộ Y tế ban hành'. Chỉ tiêu 28 MA_BENH_KT (bệnh kèm theo) là trường riêng và không mang cùng nghĩa vụ — bệnh chính có đúng MỘT, bệnh kèm theo có thể nhiều hoặc không có.

Nhóm phản hồi tra cứu thẻ theo TT 48/2017/TT-BYT Điều 6 khoản 2 điểm a: Cổng Thông tin giám định BHYT 'phải phản hồi thông tin về tình trạng, thông tin thẻ bảo hiểm y tế của người đó'. Cùng điểm a còn buộc cung cấp lịch sử khám chữa bệnh 6 tháng gần nhất, nhưng đó là dữ liệu KHÁC — không thuộc phản hồi quyền lợi, nên không đưa vào model này. / Logical model gathering the remaining field-level obligations of documentary conformance group (A).

Logical model đặc tả nghĩa vụ niêm yết giá mà Luật Khám bệnh, chữa bệnh số 15/2023/QH15 đặt lên cơ sở khám bệnh, chữa bệnh, đọc cùng định nghĩa 'giá niêm yết' của pháp luật về giá — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile bảng giá dịch vụ.

Luật 15/2023/QH15 Điều 60 khoản 4 buộc cơ sở khám bệnh, chữa bệnh: 'Niêm yết giá dịch vụ khám bệnh, chữa bệnh, giá dịch vụ chăm sóc, hỗ trợ theo yêu cầu tại cơ sở và trên Hệ thống thông tin về quản lý hoạt động khám bệnh, chữa bệnh.' Nghĩa vụ có hai vế — niêm yết TẠI CƠ SỞ và niêm yết TRÊN HỆ THỐNG THÔNG TIN — nên mức giá phải tồn tại ở dạng dữ liệu, không chỉ ở bảng dán tường.

VBHN 25/VBHN-VPQH Điều 29 khoản 1 định nghĩa: 'Niêm yết giá là hình thức công khai về giá. Giá niêm yết là giá mua, giá bán hàng hóa, dịch vụ đã bao gồm các loại thuế, phí và lệ phí (nếu có)'. Khoản 2 đòi niêm yết 'bảo đảm rõ ràng và không gây nhầm lẫn cho khách hàng về mức giá'; khoản 3 cấm bán cao hơn giá niêm yết. Ba khoản ấy cùng nói một điều với mô hình dữ liệu: phải có ĐÚNG MỘT mức giá xác định, đã gồm thuế phí, để đối chiếu được với số tiền thực thu. / Logical model for the price publication obligation of Law 15/2023/QH15 read together with the price law definition of a listed price.

Logical model cho Phần II Phụ lục QĐ 2682/QĐ-BYT: 23 trường thông tin người hành nghề, văn bản dẫn căn cứ QĐ 450/QĐ-KCB (23/12/2025) của Cục Quản lý Khám, chữa bệnh — văn bản này chưa có trong sổ đăng ký VN Core (chờ toàn văn) nên căn cứ ở đây chỉ là QĐ 2682/QĐ-BYT.

Logical model đặc tả nội dung mà Thông tư 43/2018/TT-BYT (ban hành 31/12/2018) BUỘC phải có trong báo cáo sự cố y khoa — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile sự cố an toàn người bệnh.

Điều 5 khoản 3 điểm a, phần báo cáo tự nguyện, nêu nguyên văn: 'Nội dung báo cáo tối thiểu cần có: Địa điểm, thời điểm xảy ra và mô tả, đánh giá sơ bộ về sự cố, tình trạng của người bị ảnh hưởng, biện pháp xử lý ban đầu theo Mẫu Báo cáo sự cố y khoa quy định tại Phụ lục III ban hành kèm theo Thông tư này.'

Cùng điểm a, phần báo cáo bắt buộc, đặt ngưỡng cao hơn: 'Nội dung báo cáo phải đầy đủ tất cả các thông tin có trên Mẫu Báo cáo sự cố y khoa quy định tại Phụ lục III và ghi rõ họ tên người báo cáo.' Ngưỡng ấy dẫn sang mẫu ở phụ lục nên chưa khai được thành trường; model dừng ở danh sách tối thiểu mà văn bản liệt kê tường minh.

Chuỗi báo cáo của mức bắt buộc cũng khác: người gây ra hoặc phát hiện sự cố báo cho trưởng khoa và bộ phận quản lý sự cố; trưởng khoa báo cho lãnh đạo cơ sở; lãnh đạo cơ sở báo NGAY cho cơ quan quản lý. Ba chặng ấy là quy trình, không sinh trường dữ liệu nào ngoài danh tính người báo cáo. / Logical model for the patient safety incident report content required by Circular 43/2018/TT-BYT.

Logical model đặc tả các trường mà Quyết định 2682/QĐ-BYT Phần I.4.6 buộc phải có trong một bản ghi kết quả cận lâm sàng khi loại cận lâm sàng là chẩn đoán hình ảnh — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile báo cáo chẩn đoán hình ảnh.

Bảng I.4.6 áp cho bốn loại cận lâm sàng và đánh dấu 'Bắt buộc' cho: ID kết quả, ID đợt khám, loại cận lâm sàng (STT 3 — '1=Xét nghiệm, 2=CĐHA, 3=Thăm dò chức năng, 4=Chỉ số theo dõi'), tên nhóm cận lâm sàng (STT 5), tên cận lâm sàng (STT 7), kết quả và thời điểm. Ngược lại, MÃ nhóm (STT 4) và MÃ cận lâm sàng (STT 6) đều ghi 'Không bắt buộc' — nghĩa là văn bản đòi TÊN thực tế phải có, còn mã hoá là tuỳ chọn. Mô hình dữ liệu phải giữ được tên ngay cả khi hệ thống chưa mã hoá được dịch vụ.

Model chỉ khai nhánh loại = 2. Ba loại còn lại dùng chung bảng nhưng thuộc profile khác, và VNKCBDBHealthRecordLM đã ánh xạ chúng về VNCoreDiagnosticReport nền. / Logical model for the imaging report content required by Decision 2682/QĐ-BYT section I.4.6, branch 'category = 2'.

Logical model đặc tả những nội dung mà Quyết định 697/QĐ-BYT (ban hành 19/03/2026, triển khai 01/07/2026) BUỘC cơ sở khám bệnh, chữa bệnh phải ghi trong Bảng kê chi phí khám bệnh, chữa bệnh — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của nhóm profile bảng kê chi phí.

Ba nhóm: dòng dịch vụ (hướng dẫn ghi từng mục — tên dịch vụ, số lượng, đơn giá), khoản tiền phân bổ theo nguồn thanh toán (mục III.9.a — số tiền người bệnh cùng chi trả và số tiền người bệnh tự trả, dùng để xác định quyền lợi miễn cùng chi trả), và chữ ký xác nhận (ba nhóm người phải ký, kèm hình thức ký cho từng nhóm).

Về chữ ký: văn bản nêu ba nhóm — người lập bảng kê, kế toán viện phí, và người bệnh hoặc người đại diện của người bệnh. Riêng nhóm thứ hai có quy tắc thay thế: khám bệnh, chữa bệnh tại Trạm y tế tuyến xã và tương đương mà chưa có kế toán viện phí thì thay bằng chữ ký và họ tên của người phụ trách đơn vị — nên đây là nghĩa vụ về VAI TRÒ, không phải về chức danh cụ thể. / Logical model for the cost statement content required by Decision 697/QĐ-BYT, used as the documentary requirement table for the cost statement profiles.

Logical model đặc tả các thông tin mà Thông tư 49/2018/TT-BYT (ban hành 28/12/2018) BUỘC phải lưu trong hồ sơ xét nghiệm, cùng yêu cầu tối thiểu về nhãn mẫu bệnh phẩm tại Quyết định 3725/QĐ-BYT — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của nhóm profile bệnh phẩm và báo cáo xét nghiệm.

Điều 5 khoản 4 điểm a liệt kê nguyên văn mười ba mục phải lưu: tên xét nghiệm, tên người lấy mẫu bệnh phẩm, loại mẫu bệnh phẩm, thời gian lấy, thời gian tiếp nhận mẫu bệnh phẩm, phương pháp xét nghiệm, kết quả mẫu kiểm tra chất lượng (nếu có), số lô và hạn sử dụng thuốc thử chính, tên người thực hiện xét nghiệm, kết quả, kết luận xét nghiệm, người ký kết quả xét nghiệm. Trong đó chỉ 'kết quả mẫu kiểm tra chất lượng' kèm điều kiện '(nếu có)'; mười hai mục còn lại là nghĩa vụ tuyệt đối.

Điều 5 khoản 3 điểm a bổ sung nghĩa vụ ký: người phụ trách phải kiểm tra kết quả và KÝ trước khi trả kết quả cho người bệnh. Điều 5 khoản 4 điểm b ràng buộc vòng đời bệnh phẩm: phần còn lại sau xét nghiệm chỉ được huỷ khi kết quả đã được ký.

QĐ 3725/QĐ-BYT mục c yêu cầu mã mẫu xét nghiệm 'được hệ thống phát sinh tự động và duy nhất trên toàn hệ thống', và nhãn mẫu 'tối thiểu phải có thông tin rõ ràng về mã mẫu xét nghiệm'. / Logical model for the laboratory record content required by Circular 49/2018/TT-BYT and the minimum specimen label requirement of Decision 3725/QĐ-BYT.

Logical model đặc tả nội dung mà Thông tư 51/2017/TT-BYT (ban hành 29/12/2017, hiệu lực 15/02/2018) BUỘC phải khai thác và ghi lại về tiền sử dị ứng của người bệnh — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile dị ứng và profile tiền sử gia đình.

Điều 4 khoản 5 nêu nguyên văn: 'Bác sĩ, người kê đơn thuốc hoặc nhân viên y tế khác có thẩm quyền phải khai thác kỹ tiền sử dị ứng thuốc, dị nguyên của người bệnh trước khi kê đơn thuốc hoặc chỉ định sử dụng thuốc theo quy định tại Phụ lục VI ban hành kèm theo Thông tư này. Tất cả thông tin liên quan đến dị ứng, dị nguyên phải được ghi vào sổ khám bệnh, bệnh án, giấy ra viện, giấy chuyển viện.'

Hai nghĩa vụ tách bạch trong câu ấy: KHAI THÁC trước khi kê đơn, và GHI vào bốn loại hồ sơ. Nghĩa vụ thứ hai là thứ chạm tới IG: thông tin dị ứng không được nằm riêng trong một sổ dị ứng mà phải đi theo hồ sơ người bệnh qua các tuyến.

Điều 4 khoản 6 thêm nghĩa vụ có điều kiện: 'Khi đã xác định được thuốc hoặc dị nguyên gây phản vệ, bác sĩ, nhân viên y tế phải cấp cho người bệnh thẻ theo dõi dị ứng ghi rõ tên thuốc hoặc dị nguyên gây dị ứng theo hướng dẫn tại Phụ lục VII'. Thẻ ở Phụ lục VII có cột 'Nghi ngờ' và 'Chắc chắn' cho mỗi dị nguyên — đó là mức độ xác minh, thứ mà mẫu khai thác ở Phụ lục VI không hỏi. / Logical model for the allergy history content required by Circular 51/2017/TT-BYT.

Logical model đặc tả nội dung mà Thông tư 32/2023/TT-BYT Phụ lục XXIX BUỘC phải ghi trong phiếu theo dõi và chăm sóc điều dưỡng — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile kế hoạch chăm sóc và mục tiêu chăm sóc.

Hướng dẫn ghi phiếu nêu ba nghĩa vụ tách bạch: (1) 'Can thiệp điều dưỡng: Ghi rõ nội dung can thiệp hoặc xây dựng các nội dung can thiệp và mã hóa'; (2) 'Xây dựng chẩn đoán điều dưỡng và đưa ra các mục tiêu chăm sóc đối với từng chẩn đoán'; (3) 'Thực hiện đánh giá/lượng giá mục tiêu chăm sóc: đánh dấu (X) vào các ô mục tiêu sau khi đã hoàn thành'.

Nghĩa vụ thứ hai đặt quan hệ MỘT-NHIỀU rõ ràng: mục tiêu gắn với TỪNG chẩn đoán điều dưỡng, không phải một mục tiêu chung cho cả đợt chăm sóc. Nghĩa vụ thứ ba là lượng giá — nó biến mục tiêu thành thứ đo được, nên trạng thái hoàn thành phải ghi lại chứ không suy từ việc đợt chăm sóc đã kết thúc. / Logical model for the nursing care record content required by Appendix XXIX of Circular 32/2023/TT-BYT.

Logical model đặc tả các ô thăm khám y học cổ truyền mà Thông tư 32/2023/TT-BYT buộc phải ghi — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile quan sát y học cổ truyền.

Phụ lục XXIX, phần 'B. Y HỌC CỔ TRUYỀN', đặt nghĩa vụ ghi: 'Từ mục I đến mục IV:' — 'Trong mỗi mục cần ghi số vào các ô.' Danh sách các ô nằm ở mẫu bệnh án y học cổ truyền của Phụ lục XXVIII, nơi mỗi ô in sẵn thang lựa chọn có đánh số.

Ba ô lấy vào model đều thuộc tứ chẩn và đều có thang đóng: chất lưỡi/sắc lưỡi (12 lựa chọn), rêu lưỡi (8 lựa chọn), mạch chẩn (8 lựa chọn). Thang của chúng luôn có lựa chọn cho trạng thái bình thường hoặc 'Khác', nên nghĩa vụ ghi KHÔNG buộc phải phát hiện bệnh lý dương tính — người khám ghi đúng cái mình quan sát được, kể cả khi bình thường. / Logical model for the traditional-medicine examination fields required by Circular 32/2023/TT-BYT.

Logical model đặc tả các trường mà Thông tư 26/2025/TT-BYT (ban hành 30/06/2025, hiệu lực 01/07/2025) BUỘC phải ghi trong đơn thuốc hoặc hồ sơ bệnh án ngoại trú, làm bảng chỉ tiêu văn bản để đối chiếu cardinality của nhóm profile kê đơn ngoại trú.

Ba nhóm: thông tin người bệnh trên đơn (Điều 6 khoản 2-4), nội dung từng dòng thuốc (Điều 6 khoản 6 — tám trường), và đợt điều trị của đơn thuốc gây nghiện giảm đau ung thư (Điều 8 khoản 1 — ba đợt liên tiếp, mỗi đợt có ngày bắt đầu và ngày kết thúc).

Điều 6 khoản 6 liệt kê nguyên văn tám nội dung phải ghi cho MỖI loại thuốc: tên thuốc, nồng độ hoặc hàm lượng, số lượng hoặc thể tích, liều dùng mỗi lần, số lần dùng trong ngày, đường dùng, thời điểm dùng, số ngày sử dụng. Đây là nghĩa vụ tuyệt đối, không kèm điều kiện — khác với khoản 2 (số định danh cá nhân, 'nếu có') và khoản 4 (số tháng tuổi và cân nặng, chỉ với trẻ dưới 72 tháng tuổi).

Model không mô tả toàn bộ cấu trúc đơn thuốc; nó chỉ giữ phần văn bản đặt nghĩa vụ. / Logical model for the prescription content that Circular 26/2025/TT-BYT requires to be recorded, used as the documentary requirement table for conformance checking of the outpatient prescription profiles.

Logical model đặc tả các nội dung mà Thông tư 55/2025/TT-BYT (hiệu lực 01/07/2025) BUỘC phải ghi khi kê đơn thuốc thang, thuốc cổ truyền và thuốc dược liệu — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile đơn thuốc y học cổ truyền.

Điều 8 khoản 5 điểm a nêu nguyên văn: 'Khi kê đơn thuốc thang ghi tên theo Dược điển hoặc tên thường dùng, không bao gồm tên khoa học của dược liệu, vị thuốc cổ truyền, tên loài, cây con, khoáng vật làm thuốc; ghi rõ khối lượng, đơn vị tính, số lượng thuốc thang, không viết tắt tên thuốc; hướng dẫn cụ thể cách sắc thuốc, cách uống thuốc và thời gian uống thuốc; đối với vị thuốc cổ truyền có khối lượng dưới 10 (mười) gam thì phải ghi số 0 (không) ở phía trước.'

Bảy nghĩa vụ tách ra từ câu ấy: tên vị thuốc, khối lượng, đơn vị tính, số lượng thang, cách sắc, cách uống, thời gian uống. Quy tắc ghi số 0 phía trước cho khối lượng dưới 10 gam là quy tắc TRÌNH BÀY trên tờ đơn, không phải ràng buộc giá trị — số 6 và số 06 là cùng một khối lượng.

Điều 8 khoản 2-4 lặp lại các nghĩa vụ chung của TT 26/2025/TT-BYT về thông tin người bệnh (số định danh 'nếu có', nơi cư trú, và nhóm trẻ dưới 72 tháng tuổi), nên không nhắc lại ở đây — xem VNOutpatientPrescriptionContentLM. / Logical model for the herbal and traditional medicine prescription content required by Circular 55/2025/TT-BYT.

Logical model đặc tả nội dung mà Thông tư 23/2011/TT-BYT BUỘC phải ghi khi thực hiện thuốc cho người bệnh — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile ghi nhận thực hiện thuốc.

Điều 6 khoản 3 điểm b nêu nguyên văn: 'Ghi cụ thể số thuốc điều trị cho mỗi người bệnh, mỗi khi thực hiện xong một thuốc phải đánh dấu thuốc đã thực hiện.'

Câu này đặt hai nghĩa vụ khác loại: một là GHI SỐ (liều đã dùng cho người bệnh), hai là ĐÁNH DẤU (trạng thái đã thực hiện, gắn với thời điểm thực hiện xong). Cả hai đều tuyệt đối — 'mỗi khi thực hiện xong một thuốc' là mọi lần, không kèm điều kiện. / Logical model for the medication administration record content required by Circular 23/2011/TT-BYT.

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 hoá đơ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.

Logical model cho phong bì vận chuyển của Cổng tiếp nhận dữ liệu thuộc Hệ thống thông tin giám định BHYT (gdbhyt.baohiemxahoi.gov.vn): request gửi hồ sơ mang fileHsBase64 — chuỗi Base64 của file XML đã ký số — cùng thông tin xác thực và loại hồ sơ.

INFORMATIVE / non-normative: mô hình ánh xạ transport envelope (không phải FHIR resource normative) — mapping aid cho implementer viết adapter.

Vì sao có model này và vì sao KHÔNG có profile chữ ký số. TT 12/2026/TT-BTC Điều 2 khoản 2 buộc mọi tài liệu, dữ liệu KCB điện tử gửi Cổng phải được ký số và xác thực, nhưng payload mà Cổng nhận là XML ký XMLDSig, không phải resource FHIR. Vì vậy VN Core mô hình hoá đúng lớp wire ở đây và không tạo profile Signature FHIR-native: một profile như vậy sẽ mô tả thứ không bên nào trong luồng này trao đổi. VNCoreBHYTSubmissionBundle là gói FHIR trước khi chuyển đổi sang XML; Bundle.signature của nó không phải CHUKYDONVI của phong bì này.

Tuân thủ model này không chứng minh chữ ký hợp lệ. Kiểm tra Base64 ↔ XML giải mã, canonicalized bytes, chuỗi chứng thư, trạng thái thu hồi và phép thử RSA nằm ngoài FHIRPath — thuộc rule external signature-verification-contract.

Nguồn và giới hạn của nguồn. Phụ lục kỹ thuật 71 trang của QĐ 326/QĐ-BHXH có lớp text trực tiếp; các phần tử XMLDSig dưới đây trích từ exemplar trong phụ lục đó. Phụ lục không kèm XSD hay bảng cardinality riêng cho khối chữ ký, nên cardinality 1..1 và reference 2..2 là ràng buộc của logical model suy ra từ exemplar, không phải tuyên bố về một lược đồ chính thức. Bảy trường request được đặt 1..1 vì bảng tham số nguồn đánh dấu bắt buộc. Bản quyết định một trang hiện chỉ có scan không có lớp text; PL01 lỗi ZIP trailer và PL02 chưa công khai — xem statusEvidenceNote của mã QD-326-2026-BHXH.

Căn cứ: QĐ 326/QĐ-BHXH (31/3/2026, hiệu lực 01/4/2026) — hướng dẫn kỹ thuật gửi, nhận tài liệu và dữ liệu điện tử trên Cổng tiếp nhận dữ liệu; TT 12/2026/TT-BTC Điều 2 khoản 2 — nghĩa vụ ký số và xác thực.

Logical model đặc tả các phép đo mà Quyết định 1575/QĐ-BYT (ban hành và hiệu lực 27/03/2023) BUỘC phải ghi trị số trên bảng kiểm sàng lọc trước tiêm chủng cho trẻ em — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của profile cân nặng và profile nhiệt độ cơ thể.

Cả bốn mẫu bảng kiểm (Phụ lục I-IV) đều có ô 'Cân nặng: __' và 'Thân nhiệt: __ °C' nằm trong phần bắt buộc điền, trước mục I 'Khám sàng lọc'. Nghĩa vụ đo và ghi không suy từ việc mẫu có ô trống — phần IV.1 của hướng dẫn nói thẳng ai làm việc đó: 'Điều dưỡng viên, hộ sinh viên: Ghi các thông tin của trẻ, TRỰC TIẾP CÂN TRẺ, ĐO VÀ GHI KẾT QUẢ NHIỆT ĐỘ của trẻ', và 'Bác sĩ, y sĩ: … trực tiếp đo và ghi kết quả nhiệt độ của trẻ khi không có điều dưỡng viên, hộ sinh viên'. Hai trị số ấy còn là căn cứ của các mục sàng lọc dẫn tới tạm hoãn: ngưỡng thân nhiệt 'Sốt: nhiệt độ ≥ 38°C; Hạ thân nhiệt: nhiệt độ ≤ 35,5°C' (đo tại nách) có ở CẢ BỐN mẫu, còn ngưỡng 'Cân nặng < 2000g' CHỈ có ở hai mẫu dùng ngoài bệnh viện — Phụ lục III và IV không có mục ấy, và hướng dẫn tại bệnh viện còn ghi 'thực hiện tiêm chủng các vắc xin theo lịch với trẻ nhẹ cân (so với tuổi)'. Nghĩa vụ GHI TRỊ SỐ thì không đổi theo nơi tiêm.

Hai bản dành cho trẻ dưới 1 tháng (Phụ lục II và IV) ghi cân nặng bằng GAM, hai bản còn lại bằng KILÔGAM — xem chú thích tại canNang.giaTri về hệ quả với ràng buộc đơn vị của profile.

Model KHÔNG khai kết luận sàng lọc và loại vắc xin thành trường có nghĩa vụ: xem ketLuanSangLoc. / Logical model for the mandatory measurements on the pre-vaccination screening checklist required by Decision 1575/QĐ-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 thoả 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ý/luỹ 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 cho Phần I.4 Phụ lục QĐ 2682/QĐ-BYT: chín bảng của sổ sức khoẻ — hành chính và định danh (19 trường), người đại diện/giám hộ (8), tiền sử bệnh (10), đợt khám bệnh, chữa bệnh (16), chẩn đoán xác định khi ra viện (7), kết quả cận lâm sàng và chỉ số theo dõi (14), thuốc đã điều trị/đã kê (10), phẫu thuật thủ thuật (7), tóm tắt hồ sơ bệnh án (10). Khoá số nguyên, khoá ngoại và thời điểm tạo/cập nhật bản ghi được giữ đúng kiểu nguồn và đánh dấu 'db-internal' trong ledger. Bất nhất giữ nguyên: I.4.4 STT 10 tên 'Ngày giờ vào viện' nhưng diễn giải là ngày giờ ra viện.

Logical model đặc tả 46 trường nội dung Sổ sức khoẻ đ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ị). CĂN CỨ CẤP CHÍNH PHỦ TỪ 15/08/2026: Nghị quyết 66.22/2026/NQ-CP về phát triển công dân số nâng kênh này khỏi phạm vi thí điểm cấp Bộ — Phụ lục I mục 5 xếp Sổ sức khoẻ điện tử (Bộ Y tế, lĩnh vực khám bệnh, chữa bệnh) vào nhóm giấy tờ, thông tin ghi chú 'Cơ bản' phải tích hợp, cập nhật trên ứng dụng định danh quốc gia; Điều 9 khoản 7 giao Bộ Y tế chủ trì, phối hợp Bộ Công an hướng dẫn các cơ sở y tế kết nối, chia sẻ dữ liệu để triển khai tiện ích y tế số trên ứng dụng đó. LƯU Ý THỜI HẠN: Nghị quyết chỉ có hiệu lực đến hết 28/02/2027 (Điều 10 khoản 1) — hết thời hạn phải rà lại căn cứ này thay vì mặc định còn hiệu lực. Nghị quyết KHÔNG thay đổi 46 trường nội dung, kênh liên thông hay cờ hiển thị nêu trên: nó bổ sung nghĩa vụ tích hợp ở tầng chính sách, không tạo trường dữ liệu mới.

Logical model cho Phần I.1 Phụ lục QĐ 2682/QĐ-BYT: 22 trường thông tin về khám bệnh, chữa bệnh mà CSDL về hoạt động KCB lưu tối thiểu — văn bản 'căn cứ theo' Bảng 8 (tóm tắt hồ sơ bệnh án) của QĐ 3176/QĐ-BYT nên tên trường và thứ tự trùng BHYTXML8TreatmentSummaryLM; ánh xạ FHIR chép từ model đó. Bất nhất trong văn bản được giữ nguyên và ghi ở comment: STT 19 tên 'Mã cơ sở KCB' nhưng diễn giải là mã GPHN của người ký (MA_TTDV); văn bản ghi ngày QĐ 3176/QĐ-BYT là 10/6/2024 (đúng: 29/10/2024).

Logical model mô tả phần dữ liệu dùng chung của thông tin khám sức khoẻ tuyển dụng và khám sức khoẻ định kỳ đối với người điều khiển phương tiện giao thông đường sắt theo Phụ lục 02 và Phụ lục 03 TT 42/2025/TT-BYT. Đây là tập dữ liệu tối thiểu, không phải biểu mẫu giấy hoặc điện tử bắt buộc. Theo Điều 3 khoản 2 TT 42/2025/TT-BYT, cơ sở khám sức khoẻ tự ban hành biểu mẫu và có thể bổ sung thông tin, nhưng phải bảo đảm đầy đủ thông tin tối thiểu của phụ lục tương ứng và cập nhật dữ liệu theo Điều 5 TT 36/2024/TT-BYT. Hai logical model chuyên biệt xác định các nội dung riêng của khám tuyển dụng và khám định kỳ.

Logical model chuyên biệt hoá tập dữ liệu dùng chung cho khám sức khoẻ tuyển dụng đối với người điều khiển phương tiện giao thông đường sắt theo Phụ lục 02 TT 42/2025/TT-BYT. Đây là tập dữ liệu tối thiểu, không phải biểu mẫu giấy hoặc điện tử bắt buộc. Theo Điều 3 khoản 2 TT 42/2025/TT-BYT, cơ sở khám sức khoẻ tự ban hành biểu mẫu và có thể bổ sung thông tin, nhưng phải bảo đảm đầy đủ thông tin tối thiểu của Phụ lục 02 và cập nhật dữ liệu theo Điều 5 TT 36/2024/TT-BYT. Giấy khám sức khoẻ tuyển dụng có giá trị 12 tháng kể từ ngày ký kết luận.

Logical model chuyên biệt hoá tập dữ liệu dùng chung cho khám sức khoẻ định kỳ đối với người điều khiển phương tiện giao thông đường sắt theo Phụ lục 03 TT 42/2025/TT-BYT, được sửa đổi bởi Điều 4 TT 25/2026/TT-BYT. Đây là tập dữ liệu tối thiểu, không phải biểu mẫu giấy hoặc điện tử bắt buộc. Theo Điều 3 khoản 2 TT 42/2025/TT-BYT, cơ sở khám sức khoẻ tự ban hành biểu mẫu và có thể bổ sung thông tin, nhưng phải bảo đảm đầy đủ thông tin tối thiểu của Phụ lục 03 và cập nhật dữ liệu theo Điều 5 TT 36/2024/TT-BYT. Mục 3 Khám mắt được Điều 4 TT 25/2026/TT-BYT bổ sung vào Phần II Phụ lục 03 và có hiệu lực từ ngày 15/08/2026; bản gốc TT 42/2025/TT-BYT nhảy số từ mục 2 sang mục 4.

Logical model cho tập dữ liệu mẫu phiếu khám sức khoẻ định kỳ / khám sàng lọc (Phụ lục 01, QĐ 2062/QĐ-BYT). Mô hình hoá 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 khoẻ 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.

Logical model cho Phần I.3 Phụ lục QĐ 2682/QĐ-BYT: ba mẫu đơn thuốc theo TT 26/2025/TT-BYT — đơn chung (18 trường), đơn 'N' thuốc gây nghiện (22), đơn 'H' thuốc hướng thần/tiền chất (19) — và bảng đơn thuốc ngoại trú theo dòng thuốc (32). Mỗi mẫu là một BackboneElement; nhóm thông tin trong mẫu (cơ sở, người bệnh, khám và điều trị, ký xác nhận, bổ sung, người nhận thuốc) ghi ở comment của từng trường.

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 được bảo toàn dưới property ma-bai-thuoc. Mỗi ô Thành phần (nếu có) không trống trong các hàng cùng Mã dùng chung là một property thanh-phan riêng, theo đúng thứ tự hàng nguồn và giữ cả giá trị lặp; mã có mọi ô Thành phần (nếu có) trống thì không có property thanh-phan.

Metadata wrapper cho danh mục ICD-10 Việt Nam edition 2026 — dựng từ bảng 29 cột trong phụ lục ban hành kèm TT 06/2026/TT-BYT (bản PDF ký/công bố), đã hợp nhất QĐ 1849/QĐ-BYT, gồm 16.052 concept (15.844 hiện hành + 208 mã huỷ giữ inactive). Danh mục áp dụng toàn quốc từ 01/07/2026; đã đối soát chéo với chuỗi QĐ 4469/QĐ-BYT − PL4 + PL5 QĐ 1849/QĐ-BYT (scripts/reconcile_icd10_edition.py).

Dữ liệu hiện có trong lớp chuẩn hoá

• Cấu trúc phân cấp type -> disease; ký hiệu †/* giữ nguyên như bản in
• 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
• Sáu cờ sử dụng WHO 2019 (bảng TT 06 cột 24-29) + hướng dẫn mã hoá song ngữ

Cách dùng trong VN Core

• Khi coding trong resource FHIR, dùng system = http://fhir.hl7.org.vn/core/CodeSystem/vn-icd10-cs; mã WHO gốc gửi kèm ở coding thứ hai với http://hl7.org/fhir/sid/icd-10
• Dữ liệu lập trước 01/07/2026 theo edition 2020 đọc bằng bản đóng băng CodeSystem-vn-icd10-cs-2020-legacy.full.json (version 2020-legacy)

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; route canonical .json được trỏ sang full JSON download

Bảng phân loại quốc tế mã hoá 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: QĐ 2552/QĐ-BYT Phụ lục I (Đợt 1) và QĐ 2738/QĐ-BYT Phụ lục I (Đợt 3). FHIR concept code sử dụng cột Mã U / Mã hoá 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. Một dòng bệnh danh của Đợt 3 (mã dùng chung 6500365, ICD-10 F98.0) không được văn bản cấp mã nên không có concept tương ứng; năm thể lâm sàng của nó vẫn có đủ.

Hai chiều chuyển đổi hình thức giữa văn bản giấy và thông điệp dữ liệu theo Luật Giao dịch điện tử 20/2023/QH15 Điều 12. Hai chiều được quy định ở hai khoản khác nhau với yêu cầu riêng, nên phải phân biệt tường minh.

Danh mục chuyên khoa y tế do VN Core gán mã để sử dụng trong trao đổi dữ liệu khám bệnh, chữa bệnh. Căn cứ hiện hành làm legal/workflow driver: TT 32/2023/TT-BYT Điều 10-11, Phụ lục V–XVII và Luật KCB 2023 Điều 26 khoản 3, Điều 27 khoản 3 điểm b-c, Điều 36-37. Các văn bản này mô tả chức danh, phạm vi và đăng ký hành nghề nhưng không ban hành trực tiếp các code ngắn trong CodeSystem này; toàn bộ code là project-assigned abstraction và không thay thế nội dung phạm vi trên GPHN. 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) và chỉ còn provenance lịch sử. / Vietnamese medical specialty list for healthcare practice scope classification. The codes are project-assigned interoperability abstractions informed by Circular 32/2023/TT-BYT Arts.10-11, Appendices V–XVII and the Medical Examination and Treatment Law Arts.26(3), 27(3)(b-c), 36-37; they are not statutory codes. Legacy references TT 43/2013/TT-BYT and TT 21/2017/TT-BYT are superseded as of 18/10/2024.

Danh mục 49 chất lây nhiễm loại A theo TT 33/2026/TT-BYT Phụ lục I, mã số vận chuyển UN 2814 (chất lây nhiễm ảnh hưởng đến người). Dùng để phân loại mẫu bệnh phẩm khi đóng gói và vận chuyển theo Điều 12 và Điều 13 của Thông tư. Chất lây nhiễm loại B là phần bù của danh mục này nên không liệt kê. Mã FHIR do dự án đặt vì văn bản không cấp mã cho từng mục.

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.

Đúng 10 chức danh chuyên môn phải có giấy phép hành nghề theo Luật 15/2023/QH15 Điều 26 khoản 1 điểm a-k.

Vì sao cần CodeSystem riêng thay vì dùng VNPractitionerTitleCS. VNPractitionerTitleCS là hệ mã ngạch/hạng VIÊN CHỨC (V.08.xx.xx) theo thông tư liên tịch về chức danh nghề nghiệp viên chức y tế: nó phân biệt hạng I/II/III/IV và bao gồm cả những ngạch không thuộc diện phải có giấy phép hành nghề KCB (y tế công cộng, dược, dân số). Nó cũng chỉ áp cho viên chức đơn vị sự nghiệp công lập — người hành nghề tại cơ sở tư nhân, lương y, người có bài thuốc gia truyền không nằm trong hệ đó. Dùng V.08 làm điều kiện kích hoạt nghĩa vụ giấy phép sẽ vừa thừa (bắt dược sĩ, cán bộ dân số có GPHN) vừa thiếu (bỏ sót toàn bộ khu vực tư nhân).

CodeSystem này biểu diễn CHỨC DANH PHÁP LÝ do dữ liệu tự khai và là điều kiện kích hoạt invariant vn-practitioner-regulated-title-license.

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 11/2015 (y tế công cộng), TTLT 27/2015 (dược), TTLT 28/2015 (dinh dưỡng), TTLT 08/2016 (dân số) và TT 14/2021/TT-BYT (khúc xạ nhãn khoa). Các mã V.08 này mô tả chức danh của viên chức trong đơn vị sự nghiệp công lập; không phải giấy phép, phạm vi hành nghề hoặc taxonomy bắt buộc cho khu vực tư nhân. Với bốn TTLT cũ, provenance của mã lấy trực tiếp từ Điều 2; TT 03/2022/TT-BYT sửa tiêu chuẩn chức danh nhưng không sửa danh sách mã tại Điều 2. / Vietnamese healthcare civil service position codes (V.08 series) covering 32 codes across 11 professional groups. These public-sector titles are distinct from professional licences and scopes of practice.

Danh mục chứng trạng (triệu chứng) Y học cổ truyền theo tứ chẩn, ban hành tại QĐ 2738/QĐ-BYT Phụ lục III: C1 vọng chẩn, C2 văn chẩn, C3 vấn chẩn, C4 thiết chẩn — 50 nhóm và 861 chứng trạng. Khác vn-yhct-symptom-cs ở chỗ danh mục này không gắn với thể lâm sàng nào và đã khử trùng lặp, nên dùng để ghi chứng trạng quan sát được độc lập với chẩn đoán. FHIR concept code sử dụng cột Mã dùng chung; cột Mã chuyên môn, nhóm cấp trên và bước chẩn trong tứ chẩn được bảo toàn dưới concept properties.

Năm nhóm căn cứ lựa chọn người đại diện của người bệnh theo Luật 15/2023/QH15 Điều 8 khoản 2 điểm a-đ.

Đây là taxonomy nhóm lựa chọn, không thay thế việc ghi điều/khoản pháp lý cụ thể: một thẩm quyền thường dựa trên nhiều quy định đồng thời (ví dụ cha, mẹ đại diện cho con chưa thành niên dựa trên cả Điều 8 khoản 2 điểm c Luật KCB và Điều 136 khoản 1 Bộ luật Dân sự). Vì vậy VN Core dùng năm mã ổn định ở đây và ghi điều khoản chi tiết bằng trường lặp riêng, thay vì tạo một mã cho mỗi điều khoản.

Căn cứ: Luật 15/2023/QH15 (Luật Khám bệnh, chữa bệnh) Điều 8 khoản 2; Bộ luật 91/2015/QH13 (Bộ luật Dân sự) Điều 46-63 và Điều 135-141 cho các nhánh dẫn chiếu tại điểm c, d và đ. / Five statutory bases for selecting a patient's representative under the Law on Medical Examination and Treatment, Article 8(2).

Các trường hợp cá nhân được khám bệnh, chữa bệnh hợp pháp mà KHÔNG cần có giấy phép hành nghề đang còn hiệu lực, theo Luật 15/2023/QH15 Điều 19 khoản 2, 3 và 4.

Vì sao cần CodeSystem này. Điều 19 khoản 1 điểm a đặt điều kiện chung là "có giấy phép hành nghề đang còn hiệu lực", nhưng khoản 2 miễn điểm a, b và c cho bốn nhóm; khoản 3 miễn điểm a và b cho người nước ngoài và người Việt Nam định cư ở nước ngoài KCB nhân đạo theo đợt, hợp tác đào tạo hoặc chuyển giao kỹ thuật; khoản 4 miễn toàn bộ khoản 1 cho người tham gia cấp cứu tại cộng đồng. Một invariant chỉ biết "có chức danh thì phải có giấy phép" sẽ TỪ CHỐI SAI toàn bộ những người này — sinh viên thực hành, nhân viên y tế thôn bản, đoàn mổ nhân đạo nước ngoài, người cấp cứu cộng đồng — dù họ hành nghề đúng luật.

Mã ở đây KHÔNG phải là một loại credential. Nó là tuyên bố về CĂN CỨ PHÁP LÝ khiến nghĩa vụ credential không áp dụng cho bản ghi này, và phải kiểm chứng được ngoài hệ thống.

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.

Giá trị của trường 'Cấp đơn vị' (Phần III.1 STT 4 QĐ 2682/QĐ-BYT) — cấp cơ quan quản lý cơ sở (Bộ Y tế, Sở Y tế, tuyến xã, bộ ngành khác…). KHÔNG phải tuyến chuyên môn hay cấp chuyên môn kỹ thuật (vn-facility-care-level-cs).

Ba cấp độ an toàn sinh học của phòng xét nghiệm theo NĐ 165/2026/NĐ-CP Điều 60 khoản 1. Không có cấp IV: Nghị định phân loại đúng ba cấp. Cấp độ phù hợp với từng kỹ thuật xét nghiệm trên từng vi sinh vật do TT 33/2026/TT-BYT Phụ lục IV quy định.

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.

CodeSystem tổng hợp dùng trong VN Core: mã 01–54 theo Danh mục thành phần dân tộc Việt Nam của Tổng cục Thống kê (121/TCTK-PPCĐ); mã 55 (Người nước ngoài) là supplement xuất hiện trong một số tài liệu nghiệp vụ thống kê GSO nhưng không phải một dân tộc trong QĐ 121-TCTK/PPCĐ; mã 99 (Không rõ) là fallback cục bộ của VN Core và không phải mã đầu ra ổn định do QĐ 121-TCTK/PPCĐ ban hành. 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.

11 nhóm dữ liệu cá nhân cơ bản theo NĐ 356/2025/NĐ-CP Điều 3. Dùng để khai loại dữ liệu cá nhân được xử lý khi thông báo cho chủ thể dữ liệu tại thời điểm xin sự đồng ý (Luật 91/2025/QH15 Điều 9 khoản 2 điểm a). Mã ở đây KHÔNG phải mã lâm sàng và không thay thế Consent.provision.class (loại resource FHIR) — hai trục khác nhau: một bên là phạm trù dữ liệu cá nhân theo luật, một bên là kiểu tài nguyên kỹ thuật.

12 nhóm dữ liệu cá nhân nhạy cảm theo NĐ 356/2025/NĐ-CP Điều 4 khoản 1 — danh mục Chính phủ ban hành theo uỷ quyền tại Luật 91/2025/QH15 Điều 2 khoản 3. Dữ liệu y tế thuộc điểm d (tình trạng sức khoẻ), nên hầu như mọi Consent trong VN Core đều chạm danh mục này. Xin sự đồng ý xử lý dữ liệu thuộc danh mục này thì chủ thể phải được thông báo rằng dữ liệu cần xử lý là dữ liệu cá nhân nhạy cảm (NĐ 356/2025/NĐ-CP Điều 6 khoản 4). Khác với vn-data-sensitivity-class-cs (ba lớp chính sách truy cập của IG: cơ bản / nhạy cảm / bảo vệ đặc biệt), hệ thống mã này là danh mục do văn bản liệt kê, dùng để khai chính xác đã thông báo những loại dữ liệu nào.

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

Metadata wrapper cho 19438 kỹ thuật của Phụ lục 017 VBHN 13/2026/VBHN-TT-BYT (áp dụng đến hết 31/12/2027 theo TT 25/2026/TT-BYT Điều 3), chép nguyên văn kể cả 1232 mã tiền tố BS_ và literal 19165. Danh sách mã tải riêng tại CodeSystem-vn-dvkt-cs.full.json trên trang tải xuống — wrapper giữ content=not-present để bản dựng IG không phình như ICD-10.

Metadata wrapper cho 9124 định danh suy dẫn của Phụ lục 028 VBHN 13/2026/VBHN-TT-BYT (danh mục kỹ thuật thực hiện từ 01/01/2028 theo TT 25/2026/TT-BYT Điều 3, đủ 9.128 dòng và 30 chương), làm đích cho ConceptMap/vn-cm-dvkt-pl1-to-pl2. Giữ experimental vì phụ lục không có cột mã kỹ thuật và còn một va chạm định danh 29.2 chưa được đính chính. Danh sách tải riêng tại CodeSystem-vn-dvkt-pl2-cs.full.json.

Danh mục mã bệnh Y học cổ truyền theo Phụ lục 07.1 QĐ 7603/QĐ-BYT — 4150 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à 470 bệnh danh và thể lâm sàng theo QĐ 2552/QĐ-BYT Phụ lục I và QĐ 2738/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 35 mã sửa theo QĐ 1978/QĐ-BYT, cùng phần sửa đổi và huỷ bỏ trong chính phụ lục nguồn (07.3 sửa mã U67.221, 07.4 huỷ 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 dòng STT (K01–K60, K99) sinh ra 67 mã trong bộ này vì sáu mã con được liệt kê bổ sung; á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ã hoá (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). Phạm vi fragment: đủ 67 mã được liệt kê trong bảng Phụ lục 02; không liệt kê mọi mã suy dẫn do cơ sở hình thành theo các quy tắc trên. Quy ước count=67 của bản biểu diễn VN Core chỉ đếm các concept liệt kê trong bảng, không đếm các biểu thức mã ghép/chuyên khoa sâu/đơn nguyên. Compositional=true chỉ báo có quy tắc cấu tạo mã, không chứng nhận engine đã hỗ trợ kiểm quy tắc. Khoa được hiểu là Khoa/Trung tâm/Viện/Đơn nguyên. Nếu tên khoa không giống bảng, cơ sở chọn một mã phù hợp nhất theo phạm vi chuyên môn hoặc chức năng, nhiệm vụ. Mã suy dẫn ngoài bảng cần kiểm căn cứ thành lập, khoa gốc và quy tắc tại cơ sở; không tự coi chuỗi bắt đầu bằng K là hợp lệ. Nguồn dữ liệu: QĐ 1804/QĐ-BYT Phụ lục 02; các nhãn biên tập có ghi chú tại concept.

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.

Danh mục 284 mã tiền giường theo Phụ lục 3 và 4 QĐ 2010/QĐ-BYT (19/6/2025): 277 mã bảng, 2 mã giường lưu và 5 mã giường ban ngày cho hoá/xạ trị, phục hồi chức năng, YHCT. QĐ 3276/QĐ-BYT thay Phụ lục 5 và QĐ 1804/QĐ-BYT thay Phụ lục 6; hai văn bản không sửa các mã giường này. Complete source coverage of Appendices 3 and 4; no claim to cover every other bed-day catalogue.

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 nhóm chế phẩm vaccine phân theo bệnh đích, phục vụ VNCoreImmunization.

Ngữ nghĩa: mỗi mã định danh một NHÓM CHẾ PHẨM vaccine (vaccine class), KHÔNG phải bệnh đích. Ví dụ #hep-b nghĩa là 'vaccine viêm gan B', không phải 'bệnh viêm gan B'. Bệnh đích thuộc Immunization.protocolApplied.targetDisease, dùng VNConditionCodeVS (ICD-10 VN / SNOMED CT). Từ 0.10.0, display được viết lại thành dạng 'Vaccine …' để không đọc nhầm thành tên bệnh (kiểm toán 31/07/2026 — analysis/77 mục B1); mã và nghĩa giữ nguyên, không có canonical split.

Danh mục này ở mức NHÓM chế phẩm. Khi cần định danh chế phẩm cụ thể (nhà sản xuất, tên thương mại, số đăng ký), bổ sung thêm một Coding vào cùng vaccineCode — slicing của profile để mở (open) đúng cho mục đích đó.

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 tiêm chủng bắt buộc gồm 13 bệnh được nêu tên và 1 nhóm mở. Nguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx

28 sự cố y khoa nghiêm trọng của Phụ lục II TT 43/2018/TT-BYT, xếp trong 6 nhóm.

Khi nào dùng. Điều 7 khoản 2: sự cố đã xác định là tổn thương nặng (NC3 — mức G, H, I của danh mục mức tổn thương) thì phải phân loại CHI TIẾT tiếp theo danh mục này. Với các mức A–F, danh mục này không áp dụng.

Quan hệ phân nhóm. grouped-by giữ bố cục của Phụ lục II. Mục 28 nằm sau nhóm cuối trong bảng nhưng bao quát mọi sự cố NC3 khác ngoài mục 1–27; vị trí đó không kết luận sự cố ở mục 28 là hành vi phạm tội hình sự. Quan hệ cha-con phục vụ trình bày và tra lại vị trí nguồn, không dùng để suy luận thuộc tính hình sự.

Mã do VN Core đặt. Phụ lục II chỉ đánh số thứ tự 1–28 trong bảng và không ban hành bộ mã; số thứ tự trần (1, 2, …) không dùng làm mã được vì nó không tự mô tả và dễ trùng với mọi danh mục đánh số khác. Toàn bộ concept ở đây mang codeSource = project-assigned; số thứ tự gốc giữ nguyên ở property sourceOrdinal để đối chiếu ngược với văn bản.

Sáu mã nhóm không phải mã sự cố. Chúng là tầng phân nhóm của chính Phụ lục II, mang notSelectable — không được dùng để phân loại một sự cố cụ thể, chỉ để gom nhóm khi hiển thị và thống kê.

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.

Căn cứ là PHỤ LỤC của CV 6955/BNV-TGCP. Phụ lục lập theo hai cột: tôn giáo và tổ chức tôn giáo đã được Nhà nước công nhận thuộc tôn giáo đó — một tôn giáo có thể ứng với nhiều tổ chức (ví dụ Phật giáo → Giáo hội Phật giáo Việt Nam; Tin lành → nhiều hội thánh khác nhau). CodeSystem này lấy cột tôn giáo của phụ lục, giữ nguyên thứ tự và cách gọi tên trong đó.

Đây là trục đúng cho Patient: dữ liệu cần biết là người bệnh theo tôn giáo nào, không phải thuộc tổ chức nào. Nếu về sau có nhu cầu về trục tổ chức (thống kê, xác nhận chức sắc) thì phải là CodeSystem RIÊNG ánh xạ về đây, không nhồi thêm mã vào hệ này.

65 xét nghiệm được liên thông, công nhận kết quả giữa các cơ sở khám bệnh, chữa bệnh theo QĐ 3148/QĐ-BYT ngày 07/07/2017, chia ba mục: Huyết học (22), Hoá sinh (17), Vi sinh (26).

Bộ mã này trả lời một câu hỏi vận hành: kết quả xét nghiệm do cơ sở khác thực hiện có được dùng lại thay vì chỉ định lại hay không, và còn giá trị trong bao lâu. maxValidityDays mang đúng cột "Thời gian tối đa" của văn bản, chỉ khai ở 43 mục có số ngày. Trong 22 mục không có số ngày, 21 mục dẫn bệnh lý và diễn biến lâm sàng; mục HIV khẳng định (43.24.175) yêu cầu tuân thủ các quy định về xét nghiệm HIV. Đọc recognitionNote của từng mục; không gán giá trị mặc định, 0 ngày hoặc hiệu lực vô hạn khi thiếu maxValidityDays.

Vì sao không có invariant nào cưỡng chế việc công nhận. Chính Điều 2 khoản 3 của Quyết định trao quyền quyết định cho bác sĩ lâm sàng: "Bác sỹ lâm sàng là người quyết định việc sử dụng kết quả xét nghiệm liên thông công nhận hay cần thiết chỉ định xét nghiệm lại tuỳ thuộc vào tình trạng bệnh lý và diễn biến lâm sàng của người bệnh." Điều kiện công nhận ở Điều 2 khoản 1 và 2 (phòng xét nghiệm đạt mức chất lượng theo điều kiện được dẫn tại chính QĐ 3148/QĐ-BYT, hoặc đã đạt ISO 15189) là điều kiện của TỔ CHỨC, không phải thuộc tính của một kết quả. Một Observation vẫn hợp lệ về cấu trúc dù nơi phát hành chưa đủ điều kiện liên thông.

Mã lấy nguyên văn cột "MÃ TT43" của văn bản. Đây là provenance lịch sử: cột nguồn dùng số thứ tự kỹ thuật theo chương của TT 43/2013/TT-BYT đã hết hiệu lực. Mã ấy vẫn truy được sang danh mục kỹ thuật hiện hành: TT 25/2026/TT-BYT Điều 3 khoản 2 sửa Điều 4 khoản 4 TT 23/2024/TT-BYT, quy định "Số thứ tự kỹ thuật theo từng chương của Thông tư số 43/2013/TT-BYT … được liệt kê tại cột 2 Phụ lục số 01 của Thông tư này được tiếp tục sử dụng làm mã kỹ thuật". Ánh xạ 43.CC.NN → CC.NN vì vậy do chính văn bản tuyên bố, không phải suy diễn của VN Core — xem ConceptMap, đối chiếu được 64/65 mục.

SÁU MÃ ĐÃ ĐÍNH CHÍNH THEO BẢN KÝ SỐ. Bản .docx đang lưu của Quyết định chứa sáu chuỗi mã hỏng — thiếu dấu chấm hoặc dính số: 43 22.87, 4323 30, 43.24 9, 43.2420, 43 24.24, 43 2428. Đối chiếu bản PDF có chứng thư số của Bộ Y tế (ký 17/07/2017, sha256 85f5305b…f677d756) cho thấy bản gốc ghi đúng 43.22.87, 43.23.30, 43.24.9, 43.24.20, 43.24.24, 43.24.28. Concept mang mã đúng; chuỗi hỏng giữ nguyên ở property sourceCodeLiteral để truy được về bản đang lưu.

MỘT MỤC KHÔNG CÓ MÃ, và đó là khiếm khuyết của chính văn bản. Mục Vi sinh số 26 "Mycobacterium tuberculosis QuantiFERON (IGRA)" bỏ trống cột mã trong CẢ bản .docx LẪN bản ký số — không phải lỗi trích xuất. VN Core cấp mã VS-26 cho mục này (codeSource = project-assigned) và ghi ứng viên tham chiếu từ QĐ 1227/QĐ-BYT (mã dùng chung 1020171, LOINC 45323-3) ở property, kèm needsReview — ứng viên ấy KHÔNG phải mã do Quyết định này cấp.

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; sáu cột còn lại của phụ lục được bảo toàn dưới concept property: mã dược liệu (3), nguồn gốc Nam (4) và Bắc (5) là hai ô đánh dấu độc lập, tên khoa học của dược liệu (6) và tên khoa học của cây, con, khoáng vật làm thuốc (7).

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.

Giai đoạn nghiệp vụ của một kiến nghị xem xét lại việc từ chối thanh toán hoặc thu hồi chi phí khám bệnh, chữa bệnh bảo hiểm y tế.

Căn cứ. NĐ 188/2025/NĐ-CP Điều 51 khoản 3 (kiến nghị việc từ chối thanh toán) và Điều 52 khoản 4 (kiến nghị việc thu hồi) đều cho cơ sở khám bệnh, chữa bệnh hai đường đi: kiến nghị chính cơ quan bảo hiểm xã hội xem xét lại, HOẶC kiến nghị cơ quan có thẩm quyền xem xét, giải quyết theo quy định của pháp luật. Điều 53 khoản 1 nói tới kết quả giải quyết cuối cùng của cơ quan có thẩm quyền, tức hai đường này có thể nối tiếp nhau chứ không loại trừ.

Vì sao là CodeSystem riêng chứ không dùng Task.status. Task.status mô tả vòng đời KỸ THUẬT của công việc (requested, in-progress, completed…), không phân biệt được kiến nghị đang ở cơ quan bảo hiểm xã hội hay đã chuyển lên cơ quan có thẩm quyền — mà đó chính là khác biệt pháp lý quan trọng nhất của quy trình này.

Toàn bộ mã do dự án tự đặt: hai điều luật trên quy định QUYỀN kiến nghị và trách nhiệm giải quyết, không ban hành danh mục mã trạng thái.

Ba giá trị của trường 'Giới tính' (Phần I.4.1 STT 4 QĐ 2682/QĐ-BYT): 1 Nam, 2 Nữ, 3 Khác. Khác vn-gender-cs của QĐ 3176/QĐ-BYT ở mã 3 (3 = 'Chưa xác định'), nên hai bộ mã không đồng nhất; Phần II dùng 1/2 và Phần I.3 dùng M/F — ghi ở comment của từng trường.

Danh mục mã giới tính ba mã dùng cho hai trường ở hai văn bản: GIOI_TINH (QĐ 3176/QĐ-BYT, STT 7 Bảng 1) và GIOI_TINH_CON (QĐ 2919/QĐ-BYT, bảng chỉ tiêu Giấy chứng sinh). Bảng 9 của QĐ 130/QĐ-BYT — nơi GIOI_TINH_CON từng nằm — đã bị QĐ 2919/QĐ-BYT bãi bỏ từ 15/09/2025. 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.

Đính chính chủ động đối với lỗi chép của phụ lục nguồn. Ba mã 6536521, 6536522, 6536523 trong Phụ lục III mang tên tiếng Việt "Thính Cung" và mã quốc tế SI19.L/.R/.B, nhưng tên quốc tế (Qucha), mã SNOMED (272881001) và đường kinh (Bàng quang) đều là của huyệt Khúc Sai (6536520, BL4) ở dòng ngay trên. Thính Cung vốn đã có đủ bốn biến thể riêng ở 6536503-6536506, nên nếu giữ nguyên thì Thính Cung có hai bộ biến thể trùng mã quốc tế còn Khúc Sai không có biến thể nào.

Theo quy luật bốn dòng mỗi huyệt của phụ lục (gốc → bên trái → bên phải → hai bên), ba dòng này là biến thể theo bên của Khúc Sai. Bộ hướng dẫn đính chính hai cột chép nhầm — tên tiếng Việt thành Khúc Sai (bên trái/bên phải/hai bên) và mã quốc tế thành BL4.L/.R/.B — trong khi giữ nguyên mã dùng chung do Bộ Y tế cấp. Đính chính ghi đầy đủ ở trường sourceCorrections của data/yhct/yhct-acupoint.json kèm giá trị trước và sau, không sửa lặng lẽ. Đề nghị Cục Quản lý Y Dược cổ truyền đính chính văn bản gốc.

Danh mục hình thức đến khám chữa bệnh: tự đến, chuyển đến từ tuyến dưới, từ tuyến trên, từ cùng tuyến, cấp cứu. Bổ sung cho danh mục loại KCB — loại KCB xác định mức hưởng BHYT, hình thức đến ghi nhận nguồn gốc chuyển người bệnh. ĐÍNH CHÍNH 19/08/2026 (Tầng 2, lô QĐ 3176/QĐ-BYT): các bản ≤0.9.0 mô tả đây là trường HTCHUYEN của chuẩn dữ liệu đầu ra theo QĐ 3176/QĐ-BYT. Không đúng — chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT không có chỉ tiêu nào mang tên đó, và không bản trích toàn văn nào trong kho toàn văn của dự án chứa chuỗi này. Tập mã do VN Core thiết kế; căn cứ nghiệp vụ là chế định chuyển cơ sở khám bệnh, chữa bệnh tại NĐ 188/2025/NĐ-CP và TT 01/2025/TT-BYT.

Bốn nhóm của trường 'Hình thức khám chữa bệnh' (Phần VI STT 4 QĐ 2682/QĐ-BYT): NGOAI_TRU, DIEU_TRI_NGOAI_TRU, BAN_NGAY, NOI_TRU — trục tổng hợp chi phí, không đồng nhất với 16 mã loại KCB (vn-encounter-type-cs) hay Encounter.class; crosswalk có điều kiện ở ConceptMap vn-cm-kcbdb-cost-form-to-encounter-type.

Phân hạng cơ sở khám bệnh, chữa bệnh theo TT 06/2024/TT-BYT: hạng đặc biệt, hạng I, hạng II và hạng III. Hạng pháp lý này độc lập với cấp chuyên môn kỹ thuật/cấp khám bệnh, chữa bệnh và với kết quả đánh giá tiêu chuẩn chất lượng bệnh viện.

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ốn giá trị của trường 'Loại cận lâm sàng' (Phần I.4.6 STT 3 QĐ 2682/QĐ-BYT): xét nghiệm, chẩn đoán hình ảnh, thăm dò chức năng, chỉ số theo dõi. Không trùng trực tiếp với HL7 diagnostic service sections; dùng làm category nguồn khi chuyển đổi.

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/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 khoẻ 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). KHÔNG phải bản sao danh mục 12 mục chi phí của QĐ 697/QĐ-BYT: đây là taxonomy của dự án cho ServiceRequest.category, chỉ tham chiếu ĐƯỢC MỘT PHẦN sang QĐ 697/QĐ-BYT (mã chữ thay mã số; mục 6 'Thủ thuật, phẫu thuật' tách thành PT và TT; không có mục ngày giường, máu, thuốc, thiết bị, vận chuyển vì các mục đó không phải yêu cầu dịch vụ). Khi cần mã chi phí của bảng kê QĐ 697/QĐ-BYT, dùng VNBHYTClaimCostGroupCS — bộ mã đó mới bám danh mục chi phí. / Vietnamese medical service request category classification. Based on hospital department structure and medical technical service catalog (TT 23/2024/TT-BYT). NOT a copy of the 12 cost categories in QĐ 697/QĐ-BYT — this is a project taxonomy for ServiceRequest.category with only partial correspondence; use VNBHYTClaimCostGroupCS for QĐ 697/QĐ-BYT cost-statement codes.

Ba giá trị của trường 'Loại định danh' (Phần II STT 7 QĐ 2682/QĐ-BYT): thẻ CCCD, thẻ CMND, hộ chiếu. Ánh xạ sang vn-identifier-type-cs (CCCD/CMND/HC) ở ConceptMap vn-cm-kcbdb-identity-document-type-to-identifier-type.

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

Ba giá trị của trường 'Loại hình khám chữa bệnh' (Phần I.4.4 STT 8 QĐ 2682/QĐ-BYT): ngoại trú, nội trú, cấp cứu. Đây là trục class của đợt khám (tương đương Encounter.class AMB/IMP/EMER), KHÔNG phải mã loại KCB 01–16 (vn-encounter-type-cs).

Danh mục ĐÃ NGỪNG dùng, chỉ để đọc dữ liệu lịch sử theo MA_LYDO_VVIEN của QĐ 4210/QĐ-BYT (2017): mã 1–4 có nguồn từ văn bản; mã 5 do dự án tự đặt. QĐ 4750/QĐ-BYT Điều 2 và Điều 3 chấm dứt trao đổi theo QĐ 4210/QĐ-BYT và làm QĐ 4210/QĐ-BYT hết hiệu lực từ 01/07/2024. Không dùng CodeSystem này để tạo dữ liệu hoặc trao đổi với cơ quan BHXH hiện hành; dùng VNPatientVisitTypeCS/QĐ 3276/QĐ-BYT và VNEncounterTypeCS/QĐ 1804/QĐ-BYT.

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

Hai loại khám sức khoẻ của người điều khiển phương tiện giao thông đường sắt theo TT 42/2025/TT-BYT Điều 3 khoản 2: khám sức khoẻ tuyển dụng (bộ thông tin tối thiểu tại Phụ lục 02) và khám sức khoẻ định kỳ (bộ thông tin tối thiểu tại Phụ lục 03). VÌ SAO KHÔNG DÙNG VNHealthCheckupFormTypeCS: bộ mã đó liệt kê các LOẠI MẪU PHIẾU do QĐ 1551/QĐ-BYT rồi QĐ 2062/QĐ-BYT ban hành. TT 42/2025/TT-BYT KHÔNG ban hành mẫu phiếu — Điều 3 khoản 2 giao cơ sở khám sức khoẻ tự ban hành biểu mẫu, luật chỉ chuẩn hoá thông tin tối thiểu. Mã #04 'KSK định kỳ cho nhân viên đường sắt' trong bộ đó thuộc giai đoạn QĐ 1551/QĐ-BYT, đã được QĐ 2062/QĐ-BYT thay và phải giữ nguyên trạng thái legacy; nó cũng mô tả 'nhân viên đường sắt' — phạm vi rộng hơn 'người điều khiển phương tiện giao thông đường sắt' của TT 42/2025/TT-BYT. Vì vậy bộ mã này tách riêng, không tái dùng và không mở rộng mã #04.

Danh mục loại mẫu phiếu khám sức khoẻ 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 khoẻ tâm thần theo TT 25/2026/TT-BYT; mã #22–#23 là hai nội dung KIỂM TRA sức khoẻ đầu năm học theo TT 33/2026/TT-BYT — chế độ khác và loại trừ với khám sức khoẻ định kỳ. Mã #24–#25 là hai phiếu khám sức khoẻ cho người điều khiển phương tiện giao thông đường sắt theo TT 42/2025/TT-BYT Phụ lục 02 và Phụ lục 03 (Phụ lục 03 được Điều 4 TT 25/2026/TT-BYT bổ sung mục 3 Khám mắt). 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ử. LƯU Ý khi đọc dữ liệu cũ: mã #04 deprecated cũng mang nhãn khám sức khoẻ định kỳ cho nhân viên đường sắt, nhưng nó thuộc bộ mẫu QĐ 1551/QĐ-BYT đã ngừng dùng; phiếu theo TT 42/2025/TT-BYT dùng #25.

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.

Các loại quyền lợi BHYT của Việt Nam KHÔNG có mã tương đương đúng nghĩa trong benefit-type của HL7, dùng tại CoverageEligibilityResponse.insurance.item.benefit.type.

Mã đầu tiên thay thế cách dùng sai benefit-type#copay-maximum (T-02, review 97b — quyết định governance 12/08/2026): HL7 R4 định nghĩa copay-maximum là mức cùng chi trả tối đa CHO MỘT DỊCH VỤ, trong khi nghiệp vụ Việt Nam cần biểu diễn LUỸ KẾ cùng chi trả trong năm tài chính so với trần miễn cùng chi trả (6 tháng lương cơ sở) — một accumulator theo kỳ, không phải mức trần per-service. Payer chuẩn FHIR đọc mã HL7 sẽ hiểu thành nghĩa khác; mã quốc gia giữ đúng ngữ nghĩa.

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 gồm 71 mã: 59 mã theo Phụ lục I CV 1804/BHXH-QLT ngày 04/08/2025 cho phạm vi BHXH chung/cấp tỉnh và 12 mã wire/sectoral/legacy được giữ để tương thích theo QĐ 3680/QĐ-BHXH và QCVN 09:2025/BCA. Chưa thu thập và xác minh đầy đủ catalog riêng của BHXH Quân đội/BHXH Công an Nhân dân, vì vậy content là fragment. CV 1804/BHXH-QLT mục IV.6–7 giao các hệ thống ngành xây bộ mã riêng và cho phép tiếp tục mã hiện hành trong thời gian chuyển tiếp. CH, TK, TH có lifecycle unknown: vắng trong snapshot 59 mã không phải bằng chứng đã bãi bỏ.

Canonical này dùng nghĩa theo snapshot CV 1804/BHXH-QLT. Các ký hiệu DN, HX, NN, NO, CT và nhiều mã khác không bảo đảm cùng nghĩa với tiền tố thẻ cũ. Dữ liệu xác minh được theo Phụ lục C QĐ 3680/QĐ-BHXH dùng vn-bhyt-card-type-legacy-cs; khi chưa biết danh mục nguồn, giữ định danh gốc và tra cứu BHXH, không tự gán canonical hiện hành chỉ từ hai ký tự đầu.

Từ 0.10.0 bỏ property group và historical-benefit-level khỏi danh mục hiện hành: nhóm đóng, điều kiện tham gia và mức quyền lợi có phạm vi/thời điểm khác nhau. Định nghĩa từng mã chỉ phân loại người tham gia. Không dùng mã đối tượng để tính tiền hoặc quyết định adjudication. Dùng quyền lợi do cơ quan BHXH cung cấp và pháp luật có hiệu lực tại thời điểm dịch vụ. Từ 01/01/2026, NQ 261/2025/QH15 Điều 2 khoản 1 điểm a và CV 38/BYT-BH ngày 06/01/2026 cập nhật quyền lợi cho CN và người từ đủ 75 tuổi trở lên thuộc LH; không áp dụng tự động cho mọi người mang mã LH. Hỗ trợ mức đóng HS/SV là chính sách khác với mức hưởng chi phí KCB.

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

Miền (domain) mà một thẩm quyền đại diện có hiệu lực. Hai miền xuất phát từ hai nhánh pháp luật KHÁC NHAU và trao hai loại quyền KHÁC NHAU — kiểm toán 06-07/08/2026 (analysis/90 §6.2) xác định việc gộp chúng trong một token là over-promote quyền đại diện:

1. Đại diện QUYẾT ĐỊNH KHÁM CHỮA BỆNH (Luật 15/2023/QH15 Điều 8): quyết định thay người bệnh về phương án điều trị, ký cam kết, nhận thông tin sức khoẻ trong khuôn khổ khám chữa bệnh.
2. Đại diện THỰC HIỆN QUYỀN CHỦ THỂ DỮ LIỆU (Luật 91/2025/QH15 Điều 24; Bộ luật Dân sự 91/2015/QH13 Điều 134-143): thay mặt chủ thể dữ liệu đồng ý/rút đồng ý, truy cập, yêu cầu chỉnh sửa hoặc xoá dữ liệu cá nhân — ví dụ cha/mẹ xem Sổ Sức khoẻ điện tử của con trên VNeID.

Một người có thể giữ cả hai thẩm quyền, nhưng mỗi thẩm quyền là MỘT token riêng với căn cứ, phạm vi, bằng chứng và thời hạn riêng — có quyền quyết định KCB không suy ra có quyền dữ liệu và ngược lại.

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 vn-province-cs. Nguồn ban hành: Phụ lục 1 Thông tư 07/2016/TT-BCA — Bảng danh mục mã tỉnh, thành phố trực thuộc Trung ương nơi công dân đăng ký khai sinh. Thông tư 17/2024/TT-BCA về thi hành Luật Căn cước giữ vai quy chiếu nghiệp vụ; hệ mã prefix vẫn đượ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.

Bộ mã bổ sung cho Observation.code của ba mẫu phiếu khám sức khoẻ tại Phụ lục 01 QĐ 2062/QĐ-BYT (07/7/2026). Gồm 160 tên trường nguyên dạng, ví dụ TSBT_BENH_MAT, KHAM_TAI và PHAN_LOAI_SK. Nhãn hiển thị có thể bổ sung ngữ cảnh của mục khám; property codeSource ghi nguồn của mã.

Phạm vi đối chiếu: 319 dòng của ba mẫu phiếu, hợp nhất thành 239 tên trường. Loại 40 trường dùng resource/element khác, 7 chỉ tiêu dùng profile Observation chuẩn riêng, 10 trường tiêm chủng và 22 trường chữ ký CKDT_* dùng Provenance. Các trường này vẫn được giữ trong Questionnaire; không phải phần thiếu của bộ mã Observation.

Bộ mã là fragment của các chỉ tiêu khám sức khoẻ, không tuyên bố phủ mọi trường hoặc mọi mẫu KSK. Chỉ lập ConceptMap sang LOINC/SNOMED khi có đối sánh ngữ nghĩa phù hợp. QĐ 2047/QĐ-BYT cung cấp hướng dẫn lâm sàng cho NGUY_CO_TU_KY ở trẻ 16–30 tháng; nguồn tên trường trao đổi vẫn là QĐ 2062/QĐ-BYT.

English summary: 160 supplemental Observation identifiers from the three Appendix 01 health checkup forms. Demographic, signature, immunization and separately coded standard Observation fields are outside this fragment.

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ã hoá 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 hoá dược — xem ConceptMap vn-cm-yhct-medicine-to-chemical-drug.

960 mã nguồn của danh mục hoạt chất: 936 hiện hành trong phạm vi nguồn đã đối chiếu, 23 đã ngừng dùng (status = retired), 1 mã nguồn còn cần thẩm định (status = experimental, notSelectable = true).

Danh mục rút từ cột MA_HOAT_CHAT của Phụ lục 05.1 QĐ 7603/QĐ-BYT (25/12/2018), cùng các phụ lục hoạt chất liên quan. Đã áp toàn bộ sửa đổi của QĐ 4905/QĐ-BYT (21/10/2019) có tác động đến phép rút này: PL01/02 đổi mã; PL03 bổ sung thuốc; PL04 loại thuốc; PL05/06 đối chiếu việc chuyển thuốc sang/từ PL05.4; PL07 thêm vào danh sách hoạt chất bị loại; PL08 gỡ khỏi danh sách bị loại; PL09 chỉ thay đổi đường dùng; PL10/11 bỏ/bổ sung dấu sao theo từng thuốc. Loại một thuốc không tự làm ngừng dùng mã hoạt chất.

19 mã được đính chính giữ lại ở trạng thái retired kèm replaced-by. Mã nguồn 10.102 được giữ nguyên để tra ngược bảng, nhưng ở trạng thái experimental và không được chọn cho bản ghi mới: chưa có căn cứ để tự đổi thành 40.102 hoặc gán hiệu lực của mã đó. complete ở đây chỉ sự đầy đủ của phép rút nguồn, không xác nhận hiệu lực cuối cùng của mã còn cần thẩm định.

16 mã mang restricted: có ít nhất một biến thể thuốc đóng góp cho mã đó mang dấu sao sau sửa đổi. Đây không phải kết luận mọi thuốc cùng hoạt chất đều có điều kiện thanh toán. restricted-mixed, khi có, báo đồng thời tồn tại biến thể có và không có dấu sao. Tên trước sửa đổi, tên hiện tại và tên thuốc bị loại được giữ riêng trong dữ liệu nguồn có kiểm soát; display chọn tên đầy đủ nhất của tập biến thể sau sửa đổi.

PHẠM VI: snapshot các nguồn QĐ 7603/QĐ-BYT và QĐ 4905/QĐ-BYT tới 21/10/2019. Đây là mã hoạt chất, không phải cột SO_DANG_KY của từng sản phẩm. Danh mục không tự thay thế việc đối chiếu chính sách thanh toán mới hơn hoặc điều kiện của thuốc cụ thể.

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ý; public v0.10.0 mirror cùng bộ 309 concepts với sổ đăng ký. 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 MA_XANG_DAU theo Phụ lục 2 QĐ 3276/QĐ-BYT ngày 17/10/2025. Bảy loại nhiên liệu có mã theo Vùng 1 và Vùng 2, cùng mã XEDIEN cho sử dụng điện (sạc điện, pin,…).

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.

Mã định danh section cho các Composition đặc thù Việt Nam khi LOINC không có mã section tương đương. Khởi tạo 0.10.0 với một mã cho section "các bên của việc mang thai hộ" (giấy chứng sinh mang thai hộ theo QĐ 2919/QĐ-BYT Phụ lục II) — section này cần mã ổn định để profile slice được bằng discriminator pattern thay vì dựa vào title tiếng Việt (P1 #9, round 3 14/08/2026). Các Composition VN khác bổ sung mã vào đây khi có nhu cầu slice.

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 hoá 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 hoá 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 hoá 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ã hoá 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 khoẻ học tập/làm việc, Đủ sức khoẻ học tập/làm việc.

Bộ mã trả lời kết luận đủ/không đủ tiêu chuẩn sức khoẻ điều khiển phương tiện giao thông đường sắt: Không đủ = 0, Đủ = 1. NGUỒN GÁN MÃ VÀ CĂN CỨ HIỆN HÀNH KHÁC NHAU: giá trị 0/1 kế thừa từ trường DU_TIEU_CHUAN_DK_PTGT_DUONG_SAT trong Phụ lục 01 QĐ 1551/QĐ-BYT (mã 0 = Không đủ, mã 1 = Đủ). QĐ 2062/QĐ-BYT khoản 4 đã THAY THẾ Phụ lục 01–03 của QĐ 1551/QĐ-BYT và bản Phụ lục 01 mới KHÔNG còn trường này, nên KHÔNG được ghi QĐ 2062/QĐ-BYT là nguồn của mã (đính chính 16/08/2026 sau review độc lập). Căn cứ hiện hành cho nội dung kết luận là TT 42/2025/TT-BYT — Phụ lục 02 mục V và Phụ lục 03 mục IV đều yêu cầu ghi rõ người đề nghị khám sức khoẻ có đủ hay không đủ tiêu chuẩn sức khoẻ điều khiển phương tiện giao thông đường sắt. Giữ nguyên hai mã 0/1 và canonical hiện có để bảo toàn tương thích; KHÔNG tạo bộ mã đủ/không đủ thứ hai. KHÔNG GỘP PHÂN LOẠI SỨC KHOẺ VÀO ĐÂY: phân loại sức khoẻ Loại I–V mà Phụ lục 03 yêu cầu là một trục riêng, dùng VNHealthCheckupClassificationCS/VS; lý do không đủ dùng VNRailwayFitnessCriterionCS/VS. Vòng đời của bộ mã này độc lập với vòng đời biểu mẫu: VNKSKQuestionnaire04 (mẫu QĐ 1551/QĐ-BYT) đã retired nhưng bộ mã vẫn active vì kết luận đủ/không đủ tiếp tục được dù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. Danh mục này thay Phụ lục 5 QĐ 2010/QĐ-BYT (19/6/2025). QĐ 3276/QĐ-BYT đồng thời thay danh mục nhiên liệu ở Phụ lục 5 QĐ 824/QĐ-BYT bằng Phụ lục 2 riêng; không gộp hai miền mã. 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 (chức năng, nhiệm vụ Bộ Y tế — bị NĐ 313/2026/NĐ-CP thay thế từ 18/08/2026), 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ị. Definition giữ đầy đủ trường hợp, viện dẫn và mức hưởng được ghi trong từng ô Phụ lục 1; ô trống không suy thành 0% hoặc 100%. Tỷ lệ nêu trong nguồn phải đọc cùng phạm vi quyền lợi, mức hưởng và thời điểm; bộ mã không thay kết quả giám định/tra cứu BHXH.

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.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

Chín mức tổn thương A–I của Phụ lục I TT 43/2018/TT-BYT, kèm cấp độ nguy cơ NC0–NC3 và chế độ báo cáo tương ứng.

Vì sao MỘT bộ mã chứ không phải hai cộng một ánh xạ. Cấp nguy cơ NC không phải một trục phân loại độc lập: Phụ lục I gán NC cho từng mức A–I ngay trong cùng một hàng, quan hệ là cố định và một chiều. Tách thành VN…HarmLevelCS + VN…RiskLevelCS + ConceptMap sẽ dựng ba artifact để diễn đạt một cột của một bảng, và mở ra khả năng khai một tổ hợp A+NC3 mà văn bản không cho phép. Cấp nguy cơ vì vậy là property của mức, không phải mã riêng.

Vì sao tên không mang chữ "severity". Trong FHIR R4, AdverseEvent.severity là mức độ nặng nhẹ LÂM SÀNG (mild | moderate | severe) và bị ràng buộc required vào bộ mã của HL7 — không rebind được. Trục A–I ở đây quyết định NGHĨA VỤ PHÁP LÝ (báo cáo tự nguyện hay bắt buộc), nên nó thuộc về AdverseEvent.seriousness, giống cách VNAEFIClassificationCS đã phân biệt hai trục ấy cho sự cố sau tiêm chủng. Đặt tên theo "harm level" để không ai nối nhầm bộ mã này vào severity.

Mức A là sự cố CHƯA XẢY RA. "Tình huống có nguy cơ gây ra sự cố (near miss)" vẫn phải báo cáo và vẫn là một bản ghi hợp lệ. Hệ quả mô hình hoá: bản ghi mang mức A phải khai AdverseEvent.actuality = #potential, khác với mọi mức còn lại. Đây là điểm dễ sai nhất khi sao chép từ hồ sơ tiêm chủng, nơi mọi bản ghi đều là #actual.

Chế độ báo cáo là thuộc tính công bố, không phải luật máy cưỡng chế được ở tầng bộ mã. Điều 5 khoản 1 chia tự nguyện (mục 1–6) và bắt buộc (mục 7–9) theo đúng ranh giới NC2/NC3. Property reportingMode ghi lại ranh giới ấy để đọc được bằng máy, nhưng invariant của profile phải liệt kê mã cứng G|H|I: FHIRPath không đọc được property của CodeSystem.

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 khoẻ đị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 khoẻ. 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 khoẻ.

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.adjudication.reason (kết quả giám định) và ClaimResponse.error.code (lỗi xử lý) — hai tầng KHÁC NHAU, xem hai ValueSet con VNBHYTProcessingIssueVS/VNBHYTAdjudicationIssueVS. 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ã hoá tự do khi pilot.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

Bốn nhóm nguy cơ của vi sinh vật gây bệnh truyền nhiễm theo NĐ 165/2026/NĐ-CP Điều 59 khoản 1. Danh mục vi sinh vật xếp theo bốn nhóm này do TT 33/2026/TT-BYT Phụ lục IV ban hành và nằm ở vn-pathogen-cs.

6 nhóm nguyên nhân và 24 mục con của Mục IV Phụ lục IV TT 43/2018/TT-BYT — trục thứ ba trong ba trục phân loại bắt buộc tại Điều 7 khoản 1.

FHIR R4 không có element nào mang nguyên nhân sự cố. AdverseEvent.suspectEntity nói về THỰC THỂ nghi gây hại (thuốc, thiết bị), không phải yếu tố góp phần; contributingFactor chỉ có từ R5. Vì vậy trục này gắn vào profile qua extension riêng, không mượn element sẵn có cho một nghĩa khác.

Hai tầng, và tầng cha KHÔNG dùng để phân loại. Bảng của Phụ lục IV đánh số nhóm 1–6 rồi liệt kê các mục con dưới dạng ô đánh dấu. Mã nhóm ở đây mang notSelectable: một bản ghi phải chỉ tới mục con cụ thể, trừ khi bộ phận tiếp nhận chưa phân loại xong.

Quan hệ phân nhóm. grouped-by giữ bố cục của phụ lục; quan hệ cha-con không khẳng định rằng mọi tính chất của nhóm cha đều đúng với mục con.

Mã do VN Core đặt. Phụ lục IV là MẪU BÁO CÁO — nó in các ô đánh dấu bằng văn xuôi và không ban hành bộ mã nào. Toàn bộ concept mang codeSource = project-assigned; số thứ tự nhóm giữ ở sourceOrdinal để đối chiếu ngược với mẫu.

11 nhóm sự cố y khoa và 48 mục con của Mục II Phụ lục IV TT 43/2018/TT-BYT — trục thứ hai trong ba trục phân loại bắt buộc tại Điều 7 khoản 1.

Hai tầng, và tầng cha KHÔNG dùng để phân loại. Bảng của Phụ lục IV đánh số nhóm 1–11 rồi liệt kê các mục con dưới dạng ô đánh dấu. Mã nhóm ở đây mang notSelectable: một bản ghi phải chỉ tới mục con cụ thể, trừ khi bộ phận tiếp nhận chưa phân loại xong.

Quan hệ phân nhóm. grouped-by giữ bố cục của phụ lục; quan hệ cha-con không khẳng định rằng mọi tính chất của nhóm cha đều đúng với mục con.

Mã do VN Core đặt. Phụ lục IV là MẪU BÁO CÁO — nó in các ô đánh dấu bằng văn xuôi và không ban hành bộ mã nào. Toàn bộ concept mang codeSource = project-assigned; số thứ tự nhóm giữ ở sourceOrdinal để đối chiếu ngược với mẫu.

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Đ 2738/QĐ-BYT Phụ lục IV — phụ lục này thay thế Phụ lục IV QĐ 3080/QĐ-BYT theo Điều 4.2. FHIR concept code sử dụng cột Mã dùng chung và không đổi so với bản trước; cột Mã chuyên môn mới nằm ở property ma-chuyen-mon, mã chuyên môn theo QĐ 3080/QĐ-BYT giữ ở ma-chuyen-mon-truoc cho 77 pháp điều trị đã có (Phụ lục V là bảng remap chính thức).

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 hoá 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.

Năm loại sức khoẻ cán bộ A, B1, B2, C, D dùng trong kết luận khám sức khoẻ cán bộ thuộc diện Ban Bảo vệ, chăm sóc sức khoẻ cán bộ quản lý. Căn cứ: QĐ 1266/QĐ-BYT (21/3/2020) — Quy định tiêu chuẩn phân loại sức khoẻ cán bộ và mẫu phiếu khám sức khoẻ cán bộ; thay thế QĐ 2136/QĐ-BYT ngày 15/6/2005.

KHÔNG TRỘN VỚI THANG I–V. VNHealthCheckupClassificationCS xếp theo MỨC KHOẺ (Loại I rất khoẻ đến Loại V rất yếu) và dùng cho khám sức khoẻ định kỳ nói chung. Thang ở đây xếp theo KHẢ NĂNG CÔNG TÁC — cùng một người có thể ở Loại III của thang kia mà vẫn là B1 ở thang này, vì hai câu hỏi khác nhau: 'khoẻ tới đâu' và 'có đủ sức khoẻ tiếp tục công tác không'. Ánh xạ giữa hai thang KHÔNG tồn tại trong văn bản nào; đừng suy ra.

Trục này còn mang thêm một chiều mà thang I–V không có: TUỔI ĐỜI. Loại A giới hạn không quá 60, B1 không quá 70, B2 không quá 80 — nên kết luận phân loại phụ thuộc cả tuổi chứ không chỉ tình trạng bệnh.

Vietnamese cadre health classification (A, B1, B2, C, D) per Decision 1266/QĐ-BYT. It ranks fitness for continued duty, not general health level, and is not interchangeable with the Class I-V scale.

Phân loại sức khoẻ theo 5 mức (Loại I–V) dùng trong kết luận khám sức khoẻ đị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 khoẻ (gốc phân loại sức khoẻ theo TT 14/2013/TT-BYT).

Ba tầng phân loại sự cố bất lợi sau tiêm chủng (AEFI) theo đúng cấu trúc định nghĩa của pháp luật: một tầng bao trùm và hai nhánh con loại trừ nhau.

aefi (sự cố bất lợi sau tiêm chủng)
├── common-reaction (phản ứng thông thường)
└── serious-aefi   (tai biến nặng)

Vì sao ba mã chứ không phải hai. TT 13/2026/TT-BYT Điều 2 khoản 2 định nghĩa "sự cố bất lợi sau tiêm chủng" là khái niệm BAO TRÙM — "bao gồm phản ứng thông thường sau tiêm chủng và tai biến nặng sau tiêm chủng". Bỏ tầng cha đi thì không còn cách nào khai một sự cố đã ghi nhận nhưng chưa phân loại xong, trong khi thực tế báo cáo ban đầu thường ở đúng trạng thái đó.

Mã do dự án đặt, không phải mã pháp định. Cả ba văn bản đều định nghĩa khái niệm bằng văn xuôi và KHÔNG ban hành bộ mã. Toàn bộ mã ở đây mang codeSource = project-assigned; căn cứ pháp lý trong định nghĩa chỉ để neo ngữ nghĩa, không biến slug thành mã của Bộ Y tế.

Ranh giới. CodeSystem này phân loại MỨC ĐỘ NGHIÊM TRỌNG theo pháp luật (seriousness), không phải biểu hiện lâm sàng (event), không phải mức độ nặng nhẹ của triệu chứng (severity), cũng không phải kết cục (outcome) hay quan hệ nhân quả (causality). Bốn trục đó độc lập với nhau — một phản ứng thông thường vẫn có thể severity = severe (sốt cao), và một tai biến nặng vẫn có thể outcome = resolved.

Trục phân loại mức kiểm soát đặc biệt của thuốc và nguyên liệu làm thuốc, theo mục 6.4.4 QĐ 232/QĐ-TTYQG — đặc tả API Hệ thống Cơ sở dữ liệu về dược, trường special_control_type. Nền pháp lý của phân loại là Luật Dược 105/2016/QH13 Điều 2 khoản 26; danh mục hoạt chất của từng nhóm do Bộ Y tế ban hành tại TT 18/2026/TT-BYT và QĐ 3235/QĐ-BYT, KHÔNG nằm trong bộ mã này. / Special-control classification axis for medicines and drug materials, per section 6.4.4 of Decision 232/QĐ-TTYQG (national pharmaceutical database API specification).

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ã hoá đị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).

Tập hợp quan sát danh mục quận/huyện cùng các trạng thái có bằng chứng trong phạm vi đã kiểm. content=fragment không chứng nhận lịch sử đầy đủ. English: Catalogue observations with bounded evidenced states; the fragment is not a complete administrative history. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

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

Thuộc tính được khám trong tứ chẩn y học cổ truyền (vọng-văn-vấn-thiết) và các mã panel tương ứng, dùng làm Observation.code (atomic) hoặc component.code (mạch theo bộ vị). Finding trả về lấy từ các bộ mã dùng chung: vn-yhct-pulse-cs (mạch), vn-yhct-tongue-cs (lưỡi), vn-yhct-symptom-cs (triệu chứng) theo QĐ 2552/QĐ-BYT (12/08/2025) và QĐ 3080/QĐ-BYT (26/09/2025). Hai văn bản này ban hành mã FINDING, không ban hành mã thuộc tính/phép khám — mọi mã trong CodeSystem này do VN Core đặt (codeSource = project-assigned), sẽ thay bằng danh mục quốc gia khi được ban hành.

Bộ mã cho bảng tiêu chuẩn sức khoẻ của người điều khiển phương tiện giao thông đường sắt. Căn cứ: TT 42/2025/TT-BYT (ban hành 14/11/2025, hiệu lực 01/01/2026) Phụ lục 01 — Bảng tiêu chuẩn sức khoẻ, ban hành theo Điều 2 và Luật Đường sắt Điều 48 khoản 2. Thay TT 12/2018/TT-BYT. CHIỀU CỦA BẢNG: đây là tiêu chí LOẠI TRỪ, không phải tiêu chí đạt. Cột 3 của Phụ lục 01 ghi rõ: người có MỘT TRONG các tình trạng bệnh, tật liệt kê thì KHÔNG đủ điều kiện điều khiển phương tiện giao thông đường sắt. Vì vậy một mã ở đây được ghi nhận nghĩa là 'người khám có tình trạng này' ⇒ kết luận không đủ điều kiện; không mã nào có nghĩa 'đạt'. CẤU TRÚC 2 CẤP: 9 concept cha là 9 chuyên khoa theo đúng số thứ tự của Phụ lục 01; 40 concept lá là 40 gạch đầu dòng tiêu chí. Quan hệ cha-con biểu diễn bằng nested concept (hierarchyMeaning = grouped-by), KHÔNG mã hoá phân cấp vào ký tự mã. Mã lá giữ đúng số thứ tự chuyên khoa và thứ tự gạch đầu dòng trong văn bản để truy vết ngược được (ví dụ rw-03-1 là gạch đầu dòng thứ nhất của chuyên khoa 3 MẮT). KHÔNG TÁCH SÂU HƠN GẠCH ĐẦU DÒNG: nhiều gạch đầu dòng chứa nhiều điều kiện nối bằng 'hoặc'/'và' (ví dụ tiêu chí thị lực có hai vế mắt tốt và mắt kém). Tách nhỏ hơn sẽ làm thay đổi logic AND/OR của văn bản, nên toàn bộ nội dung một gạch đầu dòng nằm trong definition của đúng một concept. NGƯỠNG ĐỊNH LƯỢNG CHỈ LÀ VĂN BẢN: definition chép sát nội dung pháp lý, nhưng KHÔNG phải là quy tắc máy thi hành được. IG không tự động kết luận đủ/không đủ từ các ngưỡng này — việc đánh giá do người hành nghề khám sức khoẻ thực hiện theo Điều 3. Nếu về sau cần tự động hoá thì phải làm bằng Library/CQL có thẩm định lâm sàng, không phải bằng invariant trên profile. PHẠM VI: đường SẮT. Tiêu chuẩn sức khoẻ người lái xe đường bộ là TT 36/2024/TT-BYT, không dùng bộ mã này.

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ã chứng trạng (triệu chứng) theo thể lâm sàng Y học cổ truyền Việt Nam: QĐ 3080/QĐ-BYT Phụ lục I (Đợt 2) và QĐ 2738/QĐ-BYT Phụ lục II (Đợt 3). FHIR concept code sử dụng cột Mã dùng chung; mã chuyên môn của phụ lục và tên thể lâm sàng được bảo toàn dưới concept properties. Concept của Đợt 3 mang thêm bệnh danh và mã U của khối bệnh trong phụ lục gốc.

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.

Phạm vi — đọc kỹ. CodeSystem này gộp ba loại khái niệm khác nhau: (a) chức danh chuyên môn thuộc diện phải có giấy phép hành nghề theo Luật 15/2023/QH15 Điều 26 khoản 1; (b) học vị và chức danh khoa học (ThS, TS, PGS, GS); (c) văn bằng chuyên khoa sau đại học (BS CKI, BS CKII) và nghề ngoài phạm vi khám bệnh, chữa bệnh (dược sĩ, cử nhân y tế). Các mã ở nhóm (b) và (c) không tự làm phát sinh nghĩa vụ giấy phép hành nghề.

Căn cứ: Luật KCB 2023 Điều 26 khoản 1 (chức danh chuyên môn phải có GPHN) và Điều 27 (nội dung, thời hạn GPHN), 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.26(1), Art.27 and Decree 96/2023/NĐ-CP.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

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 pháp lý của giấy phép hành nghề (GPHN) hoặc chứng chỉ hành nghề (CCHN) chuyển tiếp.

Vì sao không suy hiệu lực từ identifier.period.end. GPHN có thời hạn 05 năm (Luật 15/2023/QH15 Điều 27 khoản 2), nhưng Điều 32 khoản 5 điểm b tạo ngoại lệ: khi cơ quan có thẩm quyền đã nhận đủ hồ sơ gia hạn mà đến ngày hết hạn vẫn không có văn bản trả lời thì giấy phép TIẾP TỤC có hiệu lực. Một hệ thống so period.end >= today() sẽ từ chối sai người hành nghề đang hợp pháp. Mã renewal-pending-continued biểu diễn đúng nhánh đó.

CCHN không thuần lịch sử. NĐ 96/2023/NĐ-CP Điều 143 khoản 2: từ 01/01/2024, CCHN cấp theo Luật KCB 40/2009/QH12 được tiếp tục sử dụng NHƯ giấy phép hành nghề cho tới khi chuyển đổi khi làm thủ tục gia hạn. Điều 143 khoản 3 đặt mốc: áp thời hạn 05 năm từ năm 2030, hết hiệu lực năm 2035. Mã cchn-transition-continued biểu diễn CCHN đang trong cửa sổ đó.

Vì sao tách đình chỉ một phần khỏi đình chỉ toàn bộ. NĐ 96/2023/NĐ-CP Điều 30 khoản 4 điểm a buộc quyết định đình chỉ ghi rõ là đình chỉ một phần hay toàn bộ phạm vi hành nghề, và nếu một phần thì phải nêu rõ phạm vi. Khoản 5 điểm a cho thấy hệ quả thực tế: cơ quan "thực hiện việc giới hạn phạm vi hành nghề" chứ không tước quyền hành nghề. Gộp hai thứ vào một mã suspended sẽ khiến người bị đình chỉ một phần — vẫn hành nghề hợp pháp phần còn lại — bị hệ thống từ chối oan.

Trạng thái này là thuộc tính của CHÍNH credential, không phải của con người.

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 vòng đời pháp lý của giấy phép hoạt động cơ sở khám bệnh, chữa bệnh.

Vì sao cần CodeSystem này: giấy phép hoạt động KHÔNG có thời hạn (Luật 15/2023/QH15 Điều 50 khoản 1), nên không thể suy hiệu lực từ identifier.period. Trục đúng là TRẠNG THÁI, do quyết định hành chính quyết định — đình chỉ một phần hoặc toàn bộ (Điều 55 khoản 1) hoặc thu hồi (Điều 56 khoản 1).

Trạng thái bổ sung ý nghĩa cho credential và KHÔNG thay đổi nghĩa của Organization.active. Organization.active là cờ vận hành của bản ghi (bản ghi còn dùng hay không), không phải tuyên bố pháp lý về giấy phép — hai trục này cố ý tách rời.

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ế

Các mã ĐỘC LẬP mô tả cách một dòng chi phí trên bảng kê được hình thành, chia theo năm trục: vai trò dòng, cơ sở tính, quy tắc trần, miễn trừ trần và phiên bản công thức.

Vì sao năm trục độc lập chứ không một enum phẳng. Một enum liệt kê tổ hợp sẽ nổ tổ hợp và vẫn không phủ hết: QĐ 697/QĐ-BYT có nhánh vận chuyển tính theo kilomet (đơn vị tính ghi Km, số lượng là số km cả chiều đi và về), nhánh vận chuyển chưa được phê duyệt giá (tính qua lượng nhiên liệu tiêu hao), nhánh người bệnh tự túc phương tiện (chỉ tổng hợp chi phí thực tế một chiều theo hoá đơn), nhánh gói thiết bị y tế so với trần 45 tháng lương cơ sở, nhánh stent thứ hai/ba/tư có trần riêng, và nhóm đối tượng KHÔNG áp trần theo NĐ 188/2025/NĐ-CP Điều 16. Trong khi đó công thức không thu thêm phần chênh lệch lại thuộc chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT. Cùng một dòng có thể vừa là thành phần gói, vừa tính theo giá trị báo cáo, vừa được miễn trần — ba sự thật độc lập, phải khai độc lập.

Mã trong hệ này KHÔNG phải mã do cơ quan nhà nước ban hành: các văn bản mô tả cách ghi bằng văn xuôi và ví dụ, không ban hành danh mục mã. Đây là mã cục bộ của VN Core để làm dữ liệu kiểm được.

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ã hoá 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ý.

Giá trị của trường 'Tình trạng CSKCB' (Phần III.1 STT 15 QĐ 2682/QĐ-BYT) — trạng thái quy trình đăng ký/duyệt hồ sơ cơ sở trên CSDL. KHÔNG phải trạng thái giấy phép hoạt động (vn-operating-license-status-cs) hay Organization.active.

Tập hợp quan sát danh mục tỉnh/thành phố cùng các trạng thái có bằng chứng trong phạm vi đã kiểm. content=fragment không chứng nhận lịch sử đầy đủ. English: Catalogue observations with bounded evidenced states; the fragment is not a complete administrative history. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

Từ vựng kỹ thuật do VN Core thiết kế cho trường bằng chứng trạng thái và sự kiện hành chính; không phải mã đơn vị hành chính do cơ quan nhà nước ban hành. English: Project-defined administrative evidence tokens, not official unit codes. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

Vai của từng bên trong giấy chứng sinh trường hợp MANG THAI HỘ theo QĐ 2919/QĐ-BYT Phụ lục II (hiệu lực 01/10/2025): bên mang thai hộ (người vợ sinh trẻ + người chồng) và bên nhờ mang thai hộ (người vợ + người chồng).

Vì sao cần bộ mã riêng. HL7 v3 RoleCode chỉ có GESTM (gestational mother) cho người sinh trẻ; ba vai còn lại của Phụ lục II không có mã quốc tế tương đương — trước 0.10.0 chúng chỉ phân biệt bằng relationship.text, nghĩa là KHÔNG máy-đọc được (P1 #9, round 3 14/08/2026). Bốn mã này dùng trên RelatedPerson.relationship BÊN CẠNH (không thay) mã GESTM và text tiếng Việt.

Toàn bộ mã do dự án tự đặt: Phụ lục II mô tả bốn bên như chỉ tiêu dữ liệu, không ban hành danh mục mã vai.

Bốn vai trò trong xử lý dữ liệu cá nhân theo Luật 91/2025/QH15 Điều 2: bên kiểm soát (khoản 7), bên xử lý (khoản 8), bên kiểm soát và xử lý (khoản 9), bên thứ ba (khoản 10). Ranh giới do luật vạch theo quyền quyết định mục đích và phương tiện xử lý, không theo quy mô hay loại hình tổ chức: một bệnh viện tự quyết định mục đích và trực tiếp xử lý là bên kiểm soát và xử lý; một nhà cung cấp hạ tầng chỉ xử lý theo hợp đồng là bên xử lý. Khi thông báo cho chủ thể lúc xin sự đồng ý, Luật 91/2025/QH15 Điều 9 khoản 2 điểm b chỉ nêu hai vai trò: bên kiểm soát, hoặc bên kiểm soát và xử lý — xem invariant vn-consent-disclosed-controller-role.

Vai trò của một văn bản trong tuyên bố căn cứ pháp lý của artifact: ban hành nội dung, quy định cách dùng, làm nền tảng lĩnh vực, hay chỉ mang tính lịch sử. Dùng qua extension vn-ext-legal-basis-role gắn trên chính Coding của vn-ext-legal-basis. English: Role a legal document plays in an artifact's legal-basis assertion — issuing the content, governing its use, providing the domain foundation, or historical reference only.

Bộ mã cục bộ của VN Core để phân biệt ba vai trò xác nhận trong bản ghi trao đổi bảng kê chi phí: người lập bảng kê, kế toán viện phí và xác nhận của người bệnh. Đây là mã do VN Core đặt để trao đổi ổn định; không phải bộ mã quốc gia do QĐ 697/QĐ-BYT ban hành. Một người có thể đảm nhiệm nhiều vai trò nếu quy trình áp dụng cho phép; bộ mã không khẳng định các vai trò phải do những người khác nhau thực hiện. / VN Core local exchange codes for the three cost-statement attestation roles. These are project-assigned codes, not nationally issued codes, and they do not imply distinct actors.

Danh mục 378 vi sinh vật gây bệnh truyền nhiễm theo nhóm nguy cơ và cấp độ an toàn sinh học phù hợp với kỹ thuật xét nghiệm, ban hành tại TT 33/2026/TT-BYT Phụ lục IV, chia 4 khối: vi rút và prion, vi khuẩn, ký sinh trùng, nấm. Mã FHIR do dự án đặt vì văn bản chỉ đánh số thứ tự dòng; số thứ tự gốc giữ ở property sourceOrdinal. Yêu cầu về cấp độ an toàn sinh học giữ nguyên văn ở biosafety-requirement; property mã hoá biosafety-level chỉ có ở các dòng mà văn bản ghi đúng một cấp.

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, transitionEndDate, status, supersedes, supersededBy, issuingAuthority, officialUrl, shortName, relationshipNote, statusReviewedAt, statusEvidenceUrl, statusEvidenceNote. officialUrl được giữ để tương thích tooling hiện có; ưu tiên Cổng Văn bản Chính phủ, CSDL quốc gia VBPL hoặc Công báo, chỉ dùng trang tra cứu exact khác khi chưa có nguồn chính thức ổn định. 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
• amended: đang có hiệu lực nhưng đã được sửa đổi, bổ sung một phần; phải đọc cùng văn bản sửa đổi hoặc bản hợp nhất hiện hành
• 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ế

Tập hợp quan sát danh mục xã/phường/đặc khu cùng các trạng thái có bằng chứng trong phạm vi đã kiểm. content=fragment không chứng nhận lịch sử đầy đủ. English: Catalogue observations with bounded evidenced states; the fragment is not a complete administrative history. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

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ứ: Phụ lục 05.10 QĐ 7603/QĐ-BYT — Danh mục mã đường dùng/dạng dùng (63 mã), ban hành lại và bổ sung 2 mã bởi Phụ lục 12 QĐ 4905/QĐ-BYT (65 mã). Danh mục gốc gộp cả đường đưa thuốc và dạng bào chế dưới một trục; trục nghĩa tách bằng property axis. Nguồn dữ liệu: OHP Data Processor (production mapping).

Bản lưu đúng 49 mã và nghĩa tại Phụ lục C QĐ 3680/QĐ-BHXH ngày 23/12/2022. Phạm vi nghĩa là bảng Phụ lục C; chú thích XML ở phần lược đồ trong cùng văn bản có chỗ rút gọn khác bảng (NO, CC), không dùng để thay định nghĩa của bảng. Chỉ dùng đọc/kiểm tra dữ liệu đã xác minh theo danh mục nguồn này. Không đại diện cho mọi thẻ cũ, không bao gồm các mã bổ sung về sau và không khẳng định thời điểm chấm dứt sử dụng của từng mã. Trạng thái retired áp dụng cho artifact lưu trữ, không tuyên bố văn bản hay mã ngành đã hết hiệu lực. Dữ liệu cũ của VN Core 0.8.0 có 53 mã và có diễn giải chưa chuẩn; phải kiểm tra nguồn trước khi chuyển canonical, không đổi hàng loạt chỉ vì trùng ký hiệu. Nghĩa hiện hành theo CV 1804/BHXH-QLT nằm tại vn-bhyt-card-type-cs. ConceptMap liên quan chỉ mô tả quan hệ có giao nhau (relatedto), không phải lệnh tự chuyển mã hoặc căn cứ tính quyền lợi. Không nhúng tỷ lệ thanh toán.

Danh mục đối tượng khám sức khoẻ đị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 khoẻ đị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à tuỳ 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ã hoá (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 và QĐ 2738/QĐ-BYT Phụ lục I. Bao gồm 470 mã (70 bệnh danh + 400 thể lâm sàng). FHIR code sử dụng Mã U / Mã hoá chính thức; Mã dùng chung được bảo toàn ở concept property ma-dung-chung của CodeSystem.

Mười bệnh được nêu tên tại TT 13/2026/TT-BYT Điều 4 — danh mục bệnh phải sử dụng vắc xin, sinh phẩm bắt buộc trong TIÊM CHỦNG CHỐNG DỊCH.

Vì sao tách khỏi danh mục tiêm chủng bắt buộc. Điều 3 và Điều 4 của cùng thông tư là hai danh mục KHÁC NHAU phục vụ hai phương thức tổ chức khác nhau: Điều 3 cho Chương trình tiêm chủng mở rộng (tiêm thường xuyên, tiêm bù liều), Điều 4 cho tiêm chủng chống dịch. Chúng giao nhau nhưng không lồng nhau — tả, dại, cúm và COVID-19 chỉ có ở Điều 4; viêm gan vi rút B, lao, uốn ván, Hib, HPV, phế cầu, Rota chỉ có ở Điều 3.

Khoản 11 là nhóm mở, không phải bệnh. Điều 4 khoản 11 ghi "Các bệnh truyền nhiễm khác theo khuyến cáo của Tổ chức Y tế Thế giới và được Bộ trưởng Bộ Y tế quyết định" — đó là cơ chế bổ sung, không phải một bệnh cụ thể. ValueSet này vì vậy liệt kê đúng 10 bệnh được nêu tên; nhánh mở phải được thể hiện bằng strength = extensible tại nơi binding, KHÔNG bằng một mã thứ 11.

Không tạo CodeSystem bệnh mới. Cả 10 mã đã có trong VNCommunicableDiseaseCS (danh mục bệnh truyền nhiễm theo QĐ 1965/QĐ-BYT). Tạo bộ mã song song sẽ sinh hai định danh cho cùng một bệnh.

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 danh mục ICD-10 Việt Nam (vn-icd10-cs, edition 2026); hai mã L99 và L99.0 mang vai trò asterisk (mã biểu hiện) — ghi bằng property dagger-asterisk của CodeSystem chứ không nhét ký hiệu vào giá trị mã. 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ố.

Tập giá trị cho VNCoreExtPaperConversion.direction. Toàn bộ VNConversionDirectionCS.

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

49 chất lây nhiễm loại A theo TT 33/2026/TT-BYT Phụ lục I, mã vận chuyển UN 2814.

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

Miền CHẨN ĐOÁN HÌNH ẢNH của bộ mã chỉ số cận lâm sàng QĐ 1227/QĐ-BYT (11/04/2025): Phụ lục 05 — 1.240 chỉ số. Tách theo miền nghiệp vụ (kiểm toán 07/08/2026, mục 1.6) để binding theo đúng loại dịch vụ; toàn danh mục ở vn-cls-vs. / The imaging-domain subset (appendix 05) of the national clinical-indicator catalog.

Miền GIẢI PHẪU BỆNH của bộ mã chỉ số cận lâm sàng QĐ 1227/QĐ-BYT (11/04/2025): Phụ lục 04 — 81 chỉ số. Tách theo miền nghiệp vụ (kiểm toán 07/08/2026, mục 1.6) để binding theo đúng loại dịch vụ; toàn danh mục ở vn-cls-vs. / The pathology-domain subset (appendix 04) of the national clinical-indicator catalog.

Miền XÉT NGHIỆM của bộ mã chỉ số cận lâm sàng QĐ 1227/QĐ-BYT (11/04/2025): Phụ lục 01 Huyết học — Truyền máu (1.022), Phụ lục 02 Sinh hoá (447), Phụ lục 03 Vi sinh (174) — 1.643 chỉ số.

Tách theo miền nghiệp vụ (kiểm toán 07/08/2026, mục 1.6): QĐ 1227/QĐ-BYT gộp ba miền — xét nghiệm, giải phẫu bệnh, chẩn đoán hình ảnh — vào một danh mục; binding Observation xét nghiệm dùng ValueSet này để không kéo mã chẩn đoán hình ảnh/giải phẫu bệnh vào kết quả xét nghiệm. Toàn danh mục (cả ba miền) vẫn ở vn-cls-vs. / The laboratory-domain subset (appendices 01-03) of the national clinical-indicator catalog.

TOÀN danh mục chỉ số cận lâm sàng Đợt 1 — 2.964 chỉ số từ QĐ 1227/QĐ-BYT (11/04/2025), gộp cả ba miền nghiệp vụ. Khi binding theo loại dịch vụ, dùng ba ValueSet con tách theo miền (kiểm toán 07/08/2026, mục 1.6): vn-cls-laboratory-vs (Phụ lục 01-03 xét nghiệm, 1.643), vn-cls-pathology-vs (Phụ lục 04 giải phẫu bệnh, 81), vn-cls-imaging-vs (Phụ lục 05 chẩn đoán hình ảnh, 1.240). ValueSet này giữ vai trò toàn danh mục cho ngữ cảnh không phân miền (ví dụ DiagnosticReport phủ cả ba loại báo cáo). Mỗi chỉ số có đích LOINC trong ConceptMap vn-cm-cls-to-loinc (độ phủ kỹ thuật 100%; 1.404 equivalent, 1.560 wider — không phải mọi cặp đều tương đương lâm sàng). / The FULL national clinical-indicator catalog (2,964 codes, QĐ 1227/QĐ-BYT). For per-domain bindings use vn-cls-laboratory-vs / vn-cls-pathology-vs / vn-cls-imaging-vs.

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.

Đúng 10 chức danh chuyên môn phải có giấy phép hành nghề theo Luật 15/2023/QH15 Điều 26 khoản 1 điểm a-k.

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ị chứng trạng (triệu chứng) y học cổ truyền theo tứ chẩn. 911 mã: 50 nhóm và 861 chứng trạng, trục C1 vọng chẩn / C2 văn chẩn / C3 vấn chẩn / C4 thiết chẩn. Từ QĐ 2738/QĐ-BYT (26/8/2026) — PL III. Khác vn-yhct-symptom-vs ở chỗ danh mục này không gắn với thể lâm sàng nào.

Năm căn cứ lựa chọn người đại diện của người bệnh theo Luật 15/2023/QH15 Điều 8 khoản 2 điểm a-đ. / The five statutory bases for selecting a patient's representative.

Sáu căn cứ miễn điều kiện có giấy phép hành nghề tại Luật 15/2023/QH15 Điều 19 khoản 2, 3 và 4.

Từ vựng kỹ thuật do VN Core thiết kế cho trường bằng chứng trạng thái và sự kiện hành chính; không phải mã đơn vị hành chính do cơ quan nhà nước ban hành. English: Project-defined administrative evidence tokens, not official unit codes. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

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ám cách một dòng chi phí được tính. Trục này cho biết công thức nào áp được và công thức nào KHÔNG áp — authoritative-reported nghĩa là số tiền lấy nguyên từ chứng từ, không suy ngược.

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

Toàn bộ 5 mã của vn-kcbdb-facility-management-level-cs (QĐ 2682/QĐ-BYT, Phần III.1 STT 4).

Ba cấp độ an toàn sinh học của phòng xét nghiệm theo NĐ 165/2026/NĐ-CP Điều 60 khoản 1. Không có cấp IV.

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ị tổng hợp gồm mã 01–54 từ Danh mục thành phần dân tộc Việt Nam (TCTK) và hai mã supplement 55/99 phục vụ trao đổi. Hai mã supplement là local design, không được coi là mã thành phần dân tộc do QĐ 121-TCTK/PPCĐ ban hành.

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ộ 4150 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ã được liệt kê, gồm 61 dòng STT + 6 mã con). 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. Include CodeSystem fragment; không chứng nhận đầy đủ mọi mã suy dẫn như K02.D35. Khi bộ mã không biểu đạt đúng đơn vị, mã suy dẫn chỉ dùng sau khi xác minh quy tắc và nguồn tại cơ sở theo binding extensible.

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.

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.

Sáu giai đoạn của quy trình kiến nghị theo NĐ 188/2025/NĐ-CP Điều 51 khoản 3, Điều 52 khoản 4 và Điều 53.

Toàn bộ 3 mã của vn-kcbdb-gender-cs (QĐ 2682/QĐ-BYT, Phần I.4.1 STT 4).

Tập giá trị mã giới tính: trường GIOI_TINH (Bảng 1) theo QĐ 3176/QĐ-BYT (29/10/2024) và trường GIOI_TINH_CON theo QĐ 2919/QĐ-BYT (15/09/2025), văn bản bãi bỏ Bảng 9 của QĐ 130/QĐ-BYT và ban hành lại trường con. 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. 1.630 mã theo QĐ 2552/QĐ-BYT (12/8/2025) Phụ lục III — gồm mã nhóm, huyệt gốc và các biến thể theo bên (bên trái, bên phải, hai bên), kèm tên quốc tế và ánh xạ SNOMED CT. Mỗi biến thể mang một Mã dùng chung riêng do Bộ Y tế cấp; property ben trên CodeSystem cho biết biến thể.

Tập mã hình thức đến khám chữa bệnh: tự đến, chuyển đến từ tuyến dưới, từ tuyến trên, từ cùng tuyến, cấp cứu. Tập mã do VN Core thiết kế — xem đính chính 19/08/2026 tại VNReferralModeCS.

Toàn bộ 4 mã của vn-kcbdb-cost-form-cs (QĐ 2682/QĐ-BYT, Phần VI STT 4).

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.

KHÔNG bao gồm ICD-10 WHO: mã quốc tế thuộc lát code.coding[icd10who] của VNCoreConditionDiagnosis, không thuộc lát icd10vn mà tập giá trị này ràng buộc. Tập giá trị danh mục ICD-10 Việt Nam edition 2026 (vn-icd10-cs, business version 2026-07-01) — dựng từ bảng 29 cột trong phụ lục ban hành kèm TT 06/2026/TT-BYT (bản PDF ký), đã hợp nhất QĐ 1849/QĐ-BYT và đối soát ba chiều với chuỗi QĐ 4469/QĐ-BYT − PL4 + PL5 (scripts/reconcile_icd10_edition.py). Mã bị huỷ theo Phụ lục 4 QĐ 1849/QĐ-BYT nằm trong CodeSystem với property inactive — terminology server áp inactive khi expansion; dữ liệu lập trước 01/07/2026 đọc bằng bản đóng băng 2020-legacy.

Tập con của VNBHYTReviewIssueCS gồm các mã mô tả KẾT QUẢ GIÁM ĐỊNH — lý do một khoản chi bị từ chối, bị treo hoặc phải đối soát tiếp, sau khi hồ sơ đã được xử lý.

Dùng tại ClaimResponse.adjudication.reason (kể cả item.adjudication.reason), KHÔNG dùng tại ClaimResponse.error.code — xem VNBHYTProcessingIssueVS để biết vì sao hai tầng phải tách.

Danh mục này là taxonomy baseline cục bộ, KHÔNG phải catalog mã từ chối chính thức của cơ quan bảo hiểm xã hội: NĐ 188/2025/NĐ-CP Điều 51 không ban hành danh mục mã lý do từ chối, mà chỉ buộc nêu rõ căn cứ, lý do và số tiền trong biên bản giám định.

Tập con của VNBHYTReviewIssueCS gồm các mã mô tả LỖI XỬ LÝ — tình huống khiến hồ sơ không thể được giám định, chứ không phải kết quả của việc giám định.

Vì sao tách tập này. ClaimResponse.error trong FHIR R4 được định nghĩa là "Processing errors — errors encountered during the processing of the adjudication", và error.code là "an error code … which details why the claim could not be adjudicated". Từ chối thanh toán BHYT theo NĐ 188/2025/NĐ-CP Điều 51 thì ngược lại: nó là KẾT QUẢ của giám định, sau khi hồ sơ đã được xử lý xong. Dùng chung một ValueSet cho cả hai làm mờ ranh giới đó và khiến bên nhận không phân biệt được "không xử lý được" với "đã xử lý và từ chối".

Mã từ chối nghiệp vụ nằm ở VNBHYTAdjudicationIssueVS, dùng tại ClaimResponse.adjudication.reason.

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ừ vựng kỹ thuật do VN Core thiết kế cho trường bằng chứng trạng thái và sự kiện hành chính; không phải mã đơn vị hành chính do cơ quan nhà nước ban hành. English: Project-defined administrative evidence tokens, not official unit codes. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

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.

Toàn bộ 4 mã của vn-kcbdb-lab-category-cs (QĐ 2682/QĐ-BYT, Phần I.4.6 STT 3).

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/VBHN-BYT Điều 3-4. Dùng cho HealthcareService.type với binding extensible.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

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.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

Hợp của hai danh mục dữ liệu cá nhân do NĐ 356/2025/NĐ-CP ban hành: cơ bản (Điều 3) và nhạy cảm (Điều 4 khoản 1). Dùng cho nội dung phải thông báo cho chủ thể dữ liệu khi xin sự đồng ý — loại dữ liệu cá nhân được xử lý theo Luật 91/2025/QH15 Điều 9 khoản 2 điểm a. Hai danh mục đủ phủ: mỗi danh mục có một nhóm quét (other-basic, other-sensitive-by-law), nên binding required không chặn trường hợp thực tế nào.

Toàn bộ 3 mã của vn-kcbdb-identity-document-type-cs (QĐ 2682/QĐ-BYT, Phần II STT 7).

Tập giá trị loại hình cơ sở y tế cho AUTHORING dữ liệu hiện hành (mô hình chính quyền 2 cấp từ 01/07/2025): toàn bộ vn-organization-type-cs TRỪ hai mã mang ngữ nghĩa legacy #TYT và #TTYT (property status = deprecated). Trạm y tế cấp xã hiện hành dùng #health-station-commune.

Tập ĐẦY ĐỦ (gồm cả mã legacy, để đọc/validate dữ liệu lập trước 01/07/2025) vẫn là vn-organization-type-vs — binding required của vn-ext-org-type giữ tập đầy đủ vì extension phủ cả bản ghi lịch sử; hệ thống tạo MỚI bản ghi tổ chức hiện hành đối chiếu tập này (T-05, review 97b: trước 0.10.0 không có ranh giới máy giữa hai lớp nên analytics không phân biệt được tổ chức legacy/current sau sắp xếp ĐVHC).

Tập giá trị loại hình cơ sở y tế theo Luật KCB 2023 — tập ĐẦY ĐỦ, gồm cả hai mã mang ngữ nghĩa legacy trước 01/07/2025 (#TYT, #TTYT — property status = deprecated) để đọc/validate dữ liệu lịch sử. Hệ thống tạo MỚI bản ghi tổ chức hiện hành dùng tập vn-organization-type-authoring-vs (loại hai mã legacy; trạm y tế cấp xã hiện hành dùng #health-station-commune) — xem T-05, review 97b.

Toàn bộ 3 mã của vn-kcbdb-visit-class-cs (QĐ 2682/QĐ-BYT, Phần I.4.4 STT 8).

ValueSet ĐÃ NGỪNG dùng, chỉ để đọc dữ liệu MA_LYDO_VVIEN lịch sử. QĐ 4210/QĐ-BYT hết hiệu lực từ 01/07/2024 theo QĐ 4750/QĐ-BYT Điều 3. Không dùng ValueSet này để tạo dữ liệu hoặc trao đổi BHXH hiện hành; dùng VNPatientVisitTypeVS/QĐ 3276/QĐ-BYT và VNEncounterTypeVS/QĐ 1804/QĐ-BYT.

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ị đóng gồm 2 mã: khám sức khoẻ tuyển dụng (Phụ lục 02) và khám sức khoẻ định kỳ (Phụ lục 03) theo TT 42/2025/TT-BYT Điều 3 khoản 2. Dùng để phân định bộ thông tin tối thiểu bắt buộc của mỗi loại trong các logical model khám sức khoẻ đường sắt.

Tập giá trị hiện hành cho Composition.type của hồ sơ khám, kiểm tra sức khoẻ: ba mẫu khám sức khoẻ định kỳ theo nhóm tuổi (#18–#20) theo QĐ 2062/QĐ-BYT, mẫu khám sức khoẻ tâm thần (#21) theo TT 25/2026/TT-BYT và hai nội dung kiểm tra sức khoẻ đầu năm học (#22–#23) theo TT 33/2026/TT-BYT và hai phiếu khám sức khoẻ cho người điều khiển phương tiện giao thông đường sắt (#24–#25) theo TT 42/2025/TT-BYT Phụ lục 02 và Phụ lục 03. Kiểm tra đầu năm học và khám định kỳ là hai chế độ LOẠI TRỪ nhau theo TT 33/2026/TT-BYT Điều 3 khoản 2 điểm c. 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.

Từ vựng kỹ thuật do VN Core thiết kế cho trường bằng chứng trạng thái và sự kiện hành chính; không phải mã đơn vị hành chính do cơ quan nhà nước ban hành. English: Project-defined administrative evidence tokens, not official unit codes. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

Tập giá trị cho CoverageEligibilityResponse.insurance.item.benefit.type: union bảng benefit-type của HL7 (benefit, deductible, visit, copay…) với các khái niệm quyền lợi Việt Nam trong vn-benefit-type-cs (luỹ kế cùng chi trả năm tài chính…).

Vì sao cần union (T-02, review 97b): trước 0.10.0 IG tái dùng copay-maximum của HL7 cho luỹ kế năm — mã có nghĩa 'mức cùng chi trả tối đa cho MỘT dịch vụ' — nên hệ thống payer chuẩn FHIR hiển thị trần năm thành mức copay per-service. Khái niệm không có mã HL7 đúng nghĩa phải mang mã quốc gia, không mượn mã gần giống.

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.

Snapshot đóng gồm đúng 59 mã loại đối tượng tại Phụ lục I CV 1804/BHXH-QLT ngày 04/08/2025, áp dụng cho phạm vi BHXH chung/cấp tỉnh. ValueSet không bao quát catalog riêng của BHXH Quân đội hoặc BHXH Công an Nhân dân.

Mã đối tượng chỉ dùng để phân loại người tham gia, không tự quyết định mức adjudication hoặc số tiền quỹ BHYT thanh toán. Hệ thống phải dùng kết quả tra cứu có thời điểm của cơ quan BHXH và pháp luật hiện hành; riêng CN và người từ đủ 75 tuổi trở lên thuộc LH có cập nhật quyền lợi từ 01/01/2026 theo NQ 261/2025/QH15 và CV 38/BYT-BH.

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

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

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. PHẠM VI CĂN CỨ: QĐ 3176/QĐ-BYT cho phép để trống SO_CCCD trong ca bất khả kháng; danh mục lý do do VN Core thiết kế, không phải mã do Bộ Y tế ban hành.

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.

Hai miền thẩm quyền đại diện: quyết định khám chữa bệnh (Luật 15/2023/QH15 Điều 8) và thực hiện quyền chủ thể dữ liệu (Luật 91/2025/QH15 Điều 24; Bộ luật Dân sự). / The two representation authority domains: healthcare decision-making and data-subject rights.

Ba căn cứ miễn trần 45 tháng lương cơ sở. Lặp được vì một dòng có thể thuộc nhiều diện miễn cùng lúc.

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ị cho DiagnosticReport.code của báo cáo CHẨN ĐOÁN HÌNH ẢNH:

• LOINC (http://loinc.org) — mã báo cáo hình ảnh quốc tế (vd 36643-5 XR Chest 2 Views).
• Miền chẩn đoán hình ảnh của danh mục CLS (vn-cls-cs Phụ lục 05, QĐ 1227/QĐ-BYT — 1.240 chỉ số).

Trước 0.10.0 child profile Imaging chỉ fix category mà kế thừa binding toàn danh mục vn-cls-vs của base — báo cáo hình ảnh nhận được cả mã xét nghiệm/giải phẫu bệnh, và example LOINC nằm ngoài declared VS (CORE-P1-03/T-03, review 97). Từ 0.10.0 phần LOINC ĐƯỢC lọc theo miền ngay ở tầng compose bằng property chuẩn của chính LOINC: CLASS regex ^(RAD|OB[.]US|CARD[.]US|GEN[.]US|EYE[.]US)$ cộng STATUS in ACTIVE, TRIAL (loại mã đã khai tử/không khuyến nghị). Hai tầng canh: filter VS khi có máy chủ thuật ngữ, và graph gate [LOINC-DOMAIN] đối chiếu offline cho corpus ví dụ bằng bảng thuộc tính LOINC thu từ nguồn Bộ Y tế.

ĐÃ ĐO LẠI 03/09/2026: nhánh LOINC nay expand ĐÚNG. $expand trên máy chủ thuật ngữ nội bộ trả 9.712 mã — 8.475 từ http://loinc.org cộng 1.237 từ vn-cls-cs. Con số LOINC khớp chính xác phép đếm độc lập trên bảng thuộc tính nguồn (data/loinc/loinc_detail.jsonl): 8.905 mã có CLASS khớp biểu thức, còn 8.475 sau khi áp thêm STATUS in ACTIVE,TRIAL. Phân bố: RAD 7.295 · CARD.US 809 · OB.US 793 · GEN.US 5 · EYE.US 3.

Vì sao lần đo 30/08/2026 ra rỗng, và vì sao KHÔNG cần Part file của Regenstrief như dự kiến ban đầu: lúc đó máy chủ chưa được nạp property CLASS, nên biểu thức không có gì để so. Ngày 02/09/2026 scripts/txserver-load.py bổ sung CLASS (kiểu string, lấy từ trường loinc_class) và ORDER_OBS vào lô nạp LOINC; cổng txgw tự đánh giá regex/in cho hai property này vì tx.fhir.org không hiểu chúng. Chẩn đoán cũ — LOINC mô hình hoá CLASS như Coding nên phải ánh xạ sang LP… — đúng với máy chủ dùng bản LOINC gốc của Regenstrief, nhưng KHÔNG áp dụng cho bản do Bộ Y tế công bố: bản đó mang tên lớp ngắn ở dạng chuỗi, và khi nạp đúng kiểu thì filter khớp thẳng.

Đã kiểm txgw dùng so khớp toàn chuỗi, không phải so khớp một phần: nếu dùng search thay fullmatch, cùng biểu thức sẽ khớp 9.096 mã thay vì 8.905 — số trả về chứng minh nó khớp chặt.

Hệ quả cho bên triển khai. Hàng rào miền LOINC nay có HAI tầng đều hiệu lực: filter tập giá trị khi có máy chủ thuật ngữ, và graph gate [LOINC-DOMAIN] đối chiếu offline cho bản dựng không có máy chủ. $expand của tập giá trị này dùng được để liệt kê mã hình ảnh hợp lệ.

Tập giá trị cho DiagnosticReport.code của báo cáo GIẢI PHẪU BỆNH:

• LOINC (http://loinc.org) — mã báo cáo GPB quốc tế (vd 60568-3 Pathology synoptic report).
• Miền giải phẫu bệnh của danh mục CLS (vn-cls-cs Phụ lục 04, QĐ 1227/QĐ-BYT).

Trước 0.10.0 child profile Pathology chỉ fix category mà kế thừa binding toàn danh mục vn-cls-vs của base — báo cáo GPB nhận được cả mã xét nghiệm/hình ảnh (CORE-P1-03/T-03, review 97). Từ 0.10.0 phần LOINC được lọc theo miền ở tầng compose: CLASS regex ^(PATH|CYTO|MOLPATH) cộng STATUS in ACTIVE, TRIAL. Hai tầng canh: filter VS khi có máy chủ thuật ngữ, và graph gate [LOINC-DOMAIN] đối chiếu offline cho corpus ví dụ.

ĐÃ ĐO LẠI 03/09/2026: nhánh LOINC nay expand ĐÚNG. $expand trả 3.502 mã, so với 81 mã (toàn bộ từ vn-cls-cs) ở lần đo 30/08/2026. Phép đếm độc lập trên data/loinc/loinc_detail.jsonl cho 3.491 mã khớp biểu thức CLASS, còn 3.423 sau khi áp STATUS in ACTIVE,TRIAL — cộng phần vn-cls-cs thì khớp tổng máy chủ trả về. Nguyên nhân lần đo cũ ra rỗng: máy chủ chưa được nạp property CLASS; scripts/txserver-load.py bổ sung nó ngày 02/09/2026. Chi tiết chẩn đoán ghi ở VNImagingReportCodeVS.

LƯU Ý biểu thức ở đây KHÔNG neo cuối chuỗi (^(PATH|CYTO|MOLPATH), không có $) — khác VNImagingReportCodeVS vốn neo cả hai đầu. Đây là CHỦ Ý: nhánh con của MOLPATH phải vào tập, và chúng chiếm phần lớn — MOLPATH.MUT 1.276 · PATH 689 · MOLPATH 662 · MOLPATH.TRNLOC 139 · MOLPATH.PHARMG 123 · MOLPATH.REARRANGE 93. Neo $ ở đây sẽ cắt mất toàn bộ giải phẫu bệnh phân tử.

Hàng rào miền nay có hai tầng đều hiệu lực: filter tập giá trị khi có máy chủ thuật ngữ, và graph gate [LOINC-DOMAIN] cho bản dựng offline.

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

• ICD-10 áp dụng hiện hành theo TT 06/2026/TT-BYT và hướng dẫn kỹ thuật QĐ 1849/QĐ-BYT; profile/workflow quyết định có bắt buộc slice này hay không. QĐ 4469/QĐ-BYT và QĐ 98/QĐ-BYT chỉ còn là provenance edition lịch sử
• SNOMED CT IPS Terminology — Clinical Findings (tuỳ 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ã hoá 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 160 mã chỉ tiêu bổ sung cho Observation KSK (Observation.code) của ba mẫu Phụ lục 01; không gồm chữ ký CKDT_* (dùng Provenance). QĐ 2062/QĐ-BYT là nguồn tên trường; QĐ 2047/QĐ-BYT cung cấp ngữ nghĩa lâm sàng cho chỉ tiêu NGUY_CO_TU_KY ở trẻ 16–30 tháng nhưng không phải nguồn tên mã trao đổi dữ liệu.

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 HOÁ: 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ã hoá 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.

Tập giá trị cho ServiceRequest.code — hợp nhất các hệ mã mà một chỉ định dịch vụ tại Việt Nam có thể mang, theo đúng prose của profile:

• Danh mục thủ thuật/DVKT (vn-procedure-code-vs: DVKT TT 23/2024/TT-BYT, ICD-9-CM QĐ 387/QĐ-BYT, SNOMED CT Procedure) — cho chỉ định thủ thuật/phẫu thuật.
• LOINC (http://loinc.org) — cho chỉ định xét nghiệm theo hệ quốc tế.
• Danh mục chỉ số cận lâm sàng (vn-cls-vs — toàn bộ ba miền QĐ 1227/QĐ-BYT) — cho chỉ định XN/GPB/CĐHA theo danh mục quốc gia.

Vì sao phải hợp nhất. Trước 0.10.0 ServiceRequest.code bind vn-procedure-code-vs trong khi ^definition hứa 'XN: LOINC hoặc mã CLS VN' — prose, binding và chính example glucose (LOINC) mâu thuẫn nhau; một router phân luồng theo binding sẽ gán nhầm miền dịch vụ (CORE-P1-02/T-03, review 97). Ràng buộc THEO MIỀN nay có hai tầng: (1) phần LOINC lọc ngay ở compose bằng ORDER_OBS in Order, Both — trục chuẩn của LOINC phân biệt mã CHỈ ĐỊNH ĐƯỢC với mã chỉ dùng ghi kết quả — cộng STATUS in ACTIVE, TRIAL; (2) graph validator đối chiếu category với miền cho mã CLS nội (vn-cls-cs) và đối chiếu thuộc tính LOINC offline qua gate [LOINC-DOMAIN].

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 tra cứu đủ 960 mã nguồn, gồm 936 mã hiện hành trong phạm vi nguồn, 23 mã retired và 1 mã experimental không được chọn cho bản ghi mới. Full include phục vụ giải nghĩa dữ liệu và đối chiếu nguồn, không phải danh sách giá trị được phép ghi mới.

Tập giá trị hợp nhất cho code của một khoản chi phí phát sinh trong đợt khám bệnh, chữa bệnh — dùng trên VNCoreChargeItem.

Mẫu bảng kê QĐ 697/QĐ-BYT chia chi phí thành 12 danh mục, nhưng mã của từng khoản lại lấy từ các danh mục nguồn khác nhau: khám bệnh theo hạng bệnh viện, ngày giường theo hạng và loại giường, dịch vụ kỹ thuật theo TT 23/2024/TT-BYT, thuốc và vật tư theo danh mục riêng. Tập giá trị này gom các danh mục đã có trong bộ hướng dẫn để một ChargeItem bất kỳ đều tra được mã, thay vì để trống binding và mỗi hệ thống tự chọn hệ mã.

Binding ở mức extensible: nhóm chi phí nào chưa có danh mục quốc gia dạng FHIR (thuốc, vật tư y tế) thì dùng mã của cơ sở kèm text, không bị chặn.

Tập giá trị cho Observation.code của kết quả xét nghiệm: gồm cả hai hệ mà thực tế Việt Nam đang dùng song song.

• LOINC (http://loinc.org) — hệ quốc tế, dùng để trao đổi ra ngoài và để hệ thống nước ngoài đọc được.
• Miền xét nghiệm của danh mục chỉ số cận lâm sàng Việt Nam (vn-cls-cs, Phụ lục 01-03 QĐ 1227/QĐ-BYT: Huyết học — Truyền máu, Sinh hoá, Vi sinh — 1.643/2.964 chỉ số), là danh mục các cơ sở phải mã hoá theo khi báo cáo và thanh toán.

Vì sao gộp hai hệ. Trước 0.10.0, VNCoreObservationLab.code bind vào tập chung observation-codes của HL7, còn vn-cls-vs chỉ được dùng ở DiagnosticReport. Hệ quả: 2.964 chỉ số của danh mục quốc gia không ràng buộc được bất kỳ kết quả xét nghiệm nào, dù chính nó là danh mục bắt buộc. Cách gộp ở đây theo đúng khuôn đã dùng cho ICD-10 (vn-icd10-vs) và DVKT (vn-procedure-code-vs).

Vì sao chỉ miền xét nghiệm. QĐ 1227/QĐ-BYT gộp ba miền nghiệp vụ — xét nghiệm (PL 01-03), giải phẫu bệnh (PL 04), chẩn đoán hình ảnh (PL 05) — vào một danh mục. Kết quả XÉT NGHIỆM không được mang mã chụp X-quang; từ 0.10.0 phần CLS của ValueSet này lọc theo property appendix để chỉ giữ miền xét nghiệm (kiểm toán 07/08/2026, mục 1.6). Miền khác dùng vn-cls-pathology-vs / vn-cls-imaging-vs; toàn danh mục ở vn-cls-vs.

Không thay nhau — và không tự động dual-code. Mỗi chỉ số CLS đều có đích LOINC trong vn-cm-cls-to-loinc, nhưng đó là độ phủ kỹ thuật: chỉ 1.404/2.964 quan hệ là equivalent, còn 1.560 là wider — mã LOINC đích RỘNG HƠN khái niệm CLS nguồn. Gửi kèm coding LOINC chỉ đúng khi quan hệ là equivalent; với quan hệ wider, hệ thống không được tự sinh coding LOINC từ mã CLS như thể tương đương — làm vậy là ghi một kết quả xét nghiệm thành khái niệm rộng hơn thực tế. Xem ràng buộc vn-lab-observation-code-system trên profile.

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 tra cứu mã MA_XANG_DAU dùng trong dữ liệu XML3 theo Phụ lục 2 QĐ 3276/QĐ-BYT. Tập độc lập với mã đối tượng đến KCB (MA_DOITUONG_KCB) và không định nghĩa quy tắc thanh toán vận chuyển.

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ã section cho các Composition đặc thù Việt Nam.

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ế đang có hiệu lực cho VN Core:

• 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 Phụ lục 1 (TT 23/2024/TT-BYT) — danh mục đang thực hiện đến hết 31/12/2027 theo TT 25/2026/TT-BYT Điều 3.

Phụ lục 2 không nằm trong tập này: TT 25/2026/TT-BYT Điều 3 dời mốc áp dụng sang 01/01/2028, nên tại thời điểm hiện hành mã PL2 chưa được phép dùng để tạo dữ liệu mới. Hệ thống cần chuẩn bị chuyển đổi dùng VNProcedureCodeTransitionTargetVS; ánh xạ PL1→PL2 ở vn-cm-dvkt-pl1-to-pl2.

Binding extensible. Ánh xạ DVKT VN ↔ ICD-9-CM theo QĐ 4466/QĐ-BYT (2020).

GIỚI HẠN PHẢI BIẾT — nhánh SNOMED của tập này KHÔNG đối chiếu được. Tập giá trị lọc nhánh Procedure của SNOMED CT bằng concept is-a 71388002, nhưng bộ SNOMED CT mà Bộ Y tế ban hành (QĐ 2427/QĐ-BYT, 2493, 2805/QĐ-BYT) gồm ĐÚNG bốn nhánh — cấu trúc cơ thể, bất thường hình thái, dị ứng và phát hiện lâm sàng. Nó không có concept procedure nào, và cũng không mang quan hệ cha-con để trả lời is-a. Hệ quả: máy chủ thuật ngữ nào chỉ nạp bộ mã quốc gia sẽ trả về expansion RỖNG cho nhánh ấy — và một kết quả rỗng KHÔNG được đọc là đã đối chiếu xong mà không mã nào vi phạm.

Đây là khoảng trống của bộ mã quốc gia, không phải của công cụ. Bên triển khai cần mã thủ thuật SNOMED phải dùng bản SNOMED CT quốc tế có license riêng. Cổng validate-snomed-procedure-fence.py canh đúng chỗ này để bản dựng không lấy expansion rỗng làm bằng chứng đã kiểm.

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 khoẻ học tập/làm việc, Đủ sức khoẻ học tập/làm việc.

ValueSet kết luận đủ/không đủ tiêu chuẩn sức khoẻ điều khiển phương tiện giao thông đường sắt: Không đủ = 0, Đủ = 1. Giá trị mã 0/1 kế thừa từ trường DU_TIEU_CHUAN_DK_PTGT_DUONG_SAT Phụ lục 01 QĐ 1551/QĐ-BYT (phụ lục đã bị QĐ 2062/QĐ-BYT thay thế); căn cứ hiện hành cho nội dung kết luận là TT 42/2025/TT-BYT (Phụ lục 02 mục V, Phụ lục 03 mục IV). Phân loại sức khoẻ Loại I–V là trục riêng (vn-health-checkup-classification-vs); lý do không đủ dùng vn-railway-fitness-criterion-vs.

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.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

Hai nhánh con của cây phân loại AEFI: common-reaction (phản ứng thông thường) và serious-aefi (tai biến nặng).

Vì sao KHÔNG gồm mã cha aefi. AdverseEvent.seriousness phải trả lời dứt khoát "nặng hay không nặng". Mã aefi là tầng bao trùm dùng ở category để nói "đây là sự cố sau tiêm chủng"; cho phép nó ở seriousness đồng nghĩa cho phép khai một giá trị không quyết định điều gì, và mọi phép lọc "có bao nhiêu ca tai biến nặng" đều mất nghĩa.

Chín mức A–I của Phụ lục I TT 43/2018/TT-BYT. Dùng tại AdverseEvent.seriousness của VNCoreAdverseEventPatientSafety.

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 khoẻ đị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.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design). TT 17/2024/TT-BCA giữ vai governing — nó quy định cách khai thác dữ liệu dân cư, không ban hành danh mục nguồn xác lập quyền đại diện. GIỚI HẠN KIỂM CHỨNG ghi theo N1/N2: phụ lục nhúng của TT 17/2024/TT-BCA chưa trích được nên phần đó là "không kiểm được", không phải "đã kiểm và không có".

Tập mã nhóm issue cục bộ dùng cho ClaimResponse.adjudication.reason (kết quả giám định) và ClaimResponse.error.code (lỗi xử lý) — hai tầng KHÁC NHAU, xem hai ValueSet con VNBHYTProcessingIssueVS/VNBHYTAdjudicationIssueVS 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 đủ.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

Bốn nhóm nguy cơ của vi sinh vật gây bệnh truyền nhiễm theo NĐ 165/2026/NĐ-CP Điều 59 khoản 1.

6 nhóm và 24 mục con của Mục IV Phụ lục IV TT 43/2018/TT-BYT.

11 nhóm và 48 mục con của Mục II Phụ lục IV TT 43/2018/TT-BYT.

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ị dùng cho Measure.topic và MeasureReport.group.code của bộ tiêu chuẩn chất lượng cơ bản bệnh viện: năm nhóm tiêu chuẩn I–V theo Phụ lục TT 35/2024/TT-BYT, cộng mã KL mang kết luận xếp loại nhị phân theo Điều 1 khoản 3 điểm c của chính thông tư. Tổng 6 mã.

KL là nhóm cấu trúc do dự án đặt (codeSource = project-assigned) chứ không phải một nhóm tiêu chuẩn của Phụ lục — nó tồn tại vì báo cáo cần một hàng kết luận cùng trục với năm nhóm. Đừng đếm nó vào số nhóm tiêu chuẩn khi trích dẫn thông tư. / ValueSet for hospital basic quality standards: the five standard groups I–V per the Annex of Circular 35/2024/TT-BYT plus the KL overall-conclusion code (project-assigned structural code, not an Annex group). Six codes in total.

Hai bộ công thức song song: mẫu bảng kê QĐ 697/QĐ-BYT và chuẩn dữ liệu XML chuỗi QĐ 3176/QĐ-BYT. Phải khai rõ dòng đang theo bộ nào vì hai bộ khác nhau ở một số nhánh.

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. 164 pháp trị. Từ QĐ 2738/QĐ-BYT (26/8/2026) — PL IV, phụ lục thay thế PL IV QĐ 3080/QĐ-BYT theo Điều 4.2. Mã dùng chung của 77 pháp điều trị đã có không đổi; mã chuyên môn theo QĐ 3080/QĐ-BYT giữ ở concept property ma-chuyen-mon-truoc.

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 đọc cùng TT 24/2026/TT-BYT. TT 59/2025/TT-BYT đã hết hiệu lực từ 01/07/2026.

Năm loại sức khoẻ cán bộ theo QĐ 1266/QĐ-BYT, dùng cho kết luận khám sức khoẻ cán bộ thuộc diện Ban Bảo vệ, chăm sóc sức khoẻ cán bộ quản lý. Không dùng cho khám sức khoẻ định kỳ nói chung — trục đó dùng VNHealthCheckupClassificationVS.

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

Bảy mức kiểm soát đặc biệt (0–6) theo mục 6.4.4 QĐ 232/QĐ-TTYQG. Dùng trên VNCoreMedication qua extension vn-ext-controlled-substance-class để sổ xuất–nhập–tồn, sổ sử dụng và các chế độ báo cáo tổng hợp được theo nhóm kiểm soát.

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ừ vựng kỹ thuật do VN Core thiết kế cho trường bằng chứng trạng thái và sự kiện hành chính; không phải mã đơn vị hành chính do cơ quan nhà nước ban hành. English: Project-defined administrative evidence tokens, not official unit codes. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

Từ vựng kỹ thuật do VN Core thiết kế cho trường bằng chứng trạng thái và sự kiện hành chính; không phải mã đơn vị hành chính do cơ quan nhà nước ban hành. English: Project-defined administrative evidence tokens, not official unit codes. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

Năm quy tắc trần áp cho dòng chi phí. Trần 45 tháng lương cơ sở là số tính ra theo mức lương tại thời điểm, không phải hằng số.

Tập mã quận/huyện đã quan sát hoặc có trạng thái được kiểm chứng. Thành viên tập mã không tự chứng minh tên, cha, hiệu lực theo ngày hoặc trạng thái hiện hành. English: Observed/evidenced historical code membership, not proof of dated name, parent or current legal status. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

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.

28 sự cố nghiêm trọng của Phụ lục II TT 43/2018/TT-BYT. Sáu mã nhóm bị loại khỏi tập chọn được vì mang notSelectable.

Toàn bộ thuộc tính quan sát và mã panel tứ chẩn YHCT — binding cho Observation.code (atomic + panel) và component.code (bộ vị mạch) của VNCoreObservationYHCT. Xem mô tả pattern ở CodeSystem cùng tên.

Tập giá trị 40 TIÊU CHÍ LOẠI TRỪ (mã lá) của bảng tiêu chuẩn sức khoẻ người điều khiển phương tiện giao thông đường sắt. CHỈ chứa mã lá: 9 mã nhóm chuyên khoa (rw-01…rw-09) bị loại trừ khỏi tập giá trị vì Phụ lục 01 tách cột Chuyên khoa khỏi cột tình trạng bệnh, tật — chuyên khoa là nhãn nhóm, không phải một tiêu chí có thể đạt hay không đạt. Ghi mã nhóm vào kết luận sẽ mất thông tin về tiêu chí cụ thể nào bị vi phạm. Căn cứ: TT 42/2025/TT-BYT Phụ lục 01. CHIỀU CỦA TẬP GIÁ TRỊ: ghi nhận một mã nghĩa là người khám CÓ tình trạng bệnh, tật đó ⇒ không đủ điều kiện điều khiển phương tiện giao thông đường sắt. Không mã nào mang nghĩa 'đạt tiêu chuẩn'. Dùng cho phần tử 'tiêu chí không đủ điều kiện' trong các logical model khám sức khoẻ đường sắt, để kết luận 'Không đủ' nêu được đúng tiêu chí thay vì chỉ có văn bản tự do. Binding ở mức extensible: cơ sở khám sức khoẻ có thể ghi thêm lý do ngoài danh mục, nhưng lý do thuộc Phụ lục 01 thì phải dùng mã ở đây.

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ị chứng trạng (triệu chứng) theo thể lâm sàng y học cổ truyền. 3252 chứng trạng: 1451 từ QĐ 3080/QĐ-BYT (26/9/2025) — PL I và 1801 từ QĐ 2738/QĐ-BYT (26/8/2026) — PL II.

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.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

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.

Tập trạng thái của giấy phép hành nghề và chứng chỉ hành nghề chuyển tiếp, gồm hai nhánh tiếp tục hiệu lực theo Luật 15/2023/QH15 Điều 32 khoản 5 điểm b và NĐ 96/2023/NĐ-CP Điều 143 khoản 2.

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.

Bốn trạng thái vòng đời của giấy phép hoạt động cơ sở khám bệnh, chữa bệnh theo Luật 15/2023/QH15 Điều 55-56.

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. 6 trạng thái: in-force | amended | 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.

Toàn bộ 5 mã của vn-kcbdb-facility-registration-status-cs (QĐ 2682/QĐ-BYT, Phần III.1 STT 15).

Tập giá trị thử nghiệm, chưa đầy đủ và chưa có hiệu lực, chỉ dùng để chuẩn bị chuyển đổi.

Nội dung hiện tại là 9.124 identifier do dự án suy dẫn theo mẫu {chương}.{STT trong chương}. Từ 03/09/2026 nguồn là Phụ lục 028 của VBHN 13/2026/VBHN-TT-BYT — phụ lục của chính văn bản, thay cho workbook tải từ cổng dmkt.kcb.vn vốn thiếu 1.152 identifier và bỏ trọn Chương 30. Phụ lục pháp lý có 9.128 dòng kỹ thuật và đủ 30 chương, nhưng không có cột Mã kỹ thuật: chỉ có STT toàn cục, STT trong chương, tên chương, Mã liên kết và tên kỹ thuật. Vì vậy đây vẫn không phải bộ mã chính thức.

Chênh 4 dòng giữa 9.128 dòng nguồn và 9.124 identifier: hai dòng Chương 17 (STT 5424, 5442) còn trống tên trong PDF; STT 5240 (SPECT não) trống ô chương nên không suy được identifier; hai kỹ thuật Chương 29 cùng suy ra 29.2 nên chỉ biểu diễn bằng một mã. Các dòng nguồn vẫn được giữ để rà. Tên STT 5226/5227 đã tách theo bố cục PDF trang 937; bản trích DOC gộp hai tên vào dòng 5226. Quyết định có pin nguồn và giữ nameRaw để đối chiếu.

Không tự tạo mã cho dòng trống, không đặt hậu tố để tách xung đột 29.2; cần Cục Quản lý Khám, chữa bệnh xác nhận chính sách định danh trước khi công bố đầy đủ.

Nhan đề gốc của phụ lục là 'Danh mục kỹ thuật thực hiện từ ngày 01/7/2026', nhưng TT 25/2026/TT-BYT Điều 3 đã dời mốc áp dụng sang 01/01/2028.

Phạm vi sử dụng:

• KHÔNG dùng làm binding cho profile đang hoạt động; mã trong tập này chưa được phép dùng để tạo dữ liệu mới cho tới 01/01/2028.
• Chỉ dùng để kiểm thử tập con chuyển đổi và đối chiếu ánh xạ PL1→PL2 (vn-cm-dvkt-pl1-to-pl2).

Danh mục đang có hiệu lực: VNProcedureCodeVS (Phụ lục 1, đến hết 31/12/2027).

Tách khỏi VNProcedureCodeVS sau kiểm toán 31/07/2026 (analysis/77 mục B2): trước đó một ValueSet duy nhất include cả hai phụ lục, khiến bộ kiểm chấp nhận mã chưa có hiệu lực tại thời điểm hiện hành.

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.

PHÂN ĐỊNH NGUỒN (09/09/2026): taxonomy quan hệ vòng đời tổ chức trong bộ này DO VN CORE ĐẶT (khai local-design). NQ 202/2025/QH15 và NĐ 102/2025/NĐ-CP giữ vai governing — chúng quy định bối cảnh sắp xếp đơn vị hành chính và quản lý dữ liệu y tế, không ban hành danh mục quan hệ. Ghi nhận từ vòng phản biện: Luật 15/2023/QH15 Điều 52 khoản 1 điểm d (cơ sở KCB chia tách, hợp nhất, sáp nhập) sát nghĩa hơn, có thể bổ sung làm governing ở chu kỳ sau.

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.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

Tập mã tỉnh/thành phố đã quan sát hoặc có trạng thái được kiểm chứng. Thành viên tập mã không tự chứng minh tên, cha, hiệu lực theo ngày hoặc trạng thái hiện hành. English: Observed/evidenced historical code membership, not proof of dated name, parent or current legal status. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

Tập đầy đủ mã tỉnh/thành phố trong danh mục hiện hành đã đối chiếu độc lập tại mốc 2026-09-20; mã, tên và cha chỉ được bảo đảm trong cửa sổ đã rà. English: Complete independently reviewed current membership at 2026-09-20, with bounded code/name/parent evidence. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

Tập giá trị bốn vai của giấy chứng sinh mang thai hộ theo QĐ 2919/QĐ-BYT Phụ lục II.

Toàn bộ bốn vai trò tại Luật 91/2025/QH15 Điều 2 khoản 7, 8, 9 và 10. ValueSet giữ đủ bốn vai trò vì đây là taxonomy pháp lý dùng chung; việc thu hẹp xuống hai vai trò được phép thông báo khi xin đồng ý (Điều 9 khoản 2 điểm b) đặt ở invariant của VNCoreConsent, nơi có thể ghi kèm căn cứ — thay vì tạo thêm một ValueSet lọc không giải thích được lý do.

Năm vai trò của một dòng trên bảng kê QĐ 697/QĐ-BYT. Quyết định cột nào bắt buộc: dòng tổng gói mang cột 10-13, thiết bị thành phần chỉ mang cột 1-9.

Bốn vai trò của văn bản trong tuyên bố căn cứ pháp lý: issuing (ban hành nội dung), governing (quy định cách dùng), foundational (nền tảng lĩnh vực), historical (chỉ tra cứu lịch sử). Tập ĐÓNG và bind required trên vn-ext-legal-basis-role: đây là siêu dữ liệu của IG, mở rộng tự do sẽ làm mất khả năng suy luận bằng máy.

Ba vai trò trao đổi cục bộ dùng trên attester của VNCoreCostStatementComposition. Các mã do VN Core đặt, không phải bộ mã quốc gia. / VN Core local exchange roles for cost-statement attesters; these are project-assigned codes.

378 vi sinh vật gây bệnh truyền nhiễm và 4 mã khối theo TT 33/2026/TT-BYT Phụ lục IV. Bốn mã khối mang notSelectable nên không dùng để phân loại một vi sinh vật cụ thể.

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í trên cơ thể, gồm HAI miền: vị trí giải phẫu theo SNOMED CT Body Structures, và huyệt châm cứu theo danh mục YHCT của Bộ Y tế (bổ sung từ 0.10.0 để mã hoá thủ thuật châm cứu/bấm huyệt — trước đó hướng dẫn của VNCoreProcedure.bodySite và binding nói ngược nhau). 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 mã xã/phường/đặc khu đã quan sát hoặc có trạng thái được kiểm chứng. Thành viên tập mã không tự chứng minh tên, cha, hiệu lực theo ngày hoặc trạng thái hiện hành. English: Observed/evidenced historical code membership, not proof of dated name, parent or current legal status. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

Tập đầy đủ mã xã/phường/đặc khu trong danh mục hiện hành đã đối chiếu độc lập tại mốc 2026-09-20; mã, tên và cha chỉ được bảo đảm trong cửa sổ đã rà. English: Complete independently reviewed current membership at 2026-09-20, with bounded code/name/parent evidence. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

Toàn bộ 65 mục của danh mục xét nghiệm được liên thông, công nhận kết quả giữa các cơ sở khám bệnh, chữa bệnh theo QĐ 3148/QĐ-BYT.

Không bind vào Observation.code. Đây là danh mục CHÍNH SÁCH — nó trả lời "kết quả này có được công nhận liên thông không và còn giá trị bao lâu", không phải "kết quả này là xét nghiệm gì". Mã xét nghiệm của một Observation vẫn lấy từ LOINC hoặc danh mục cận lâm sàng (vn-cls-vs). Tập giá trị này dùng để tra cứu và đối chiếu, và làm nguồn cho ConceptMap sang danh mục kỹ thuật hiện hành.

Tập giá trị đường dùng thuốc, dùng cho Dosage.route.

Từ 0.10.0, tập này loại trừ những mã của VNMedicationRouteCS không phải đường đưa thuốc vào cơ thể mà là dạng bào chế hoặc dạng đóng gói — 'Dung dịch', 'Dung dịch rửa', 'Dung dịch thẩm phân', 'Bột hít', 'Dạng hít', 'Bình khí lỏng hoặc nén', 'Bình khí nén'. Những mã này thuộc Medication.form, không thuộc Dosage.route (kiểm toán 31/07/2026 — analysis/77 mục B3).

Các mã thuộc trục kỹ thuật đưa thuốc (axis = method: phun mù, khí dung, áp sát khối u, cấy vào khối u, chiếu ngoài) vẫn được giữ trong tập này vì thực tế lâm sàng ghi nhận chúng ở vị trí đường dùng; trục nghĩa được phân biệt bằng property axis trên CodeSystem thay vì loại bỏ.

Cho bên triển khai: khi mã ghi ở Dosage.route có axis = method, NÊN ghi thêm Dosage.method mang chính mã đó, và Dosage.route mang đường đưa thuốc tương ứng nếu xác định được. Bên nhận đọc dữ liệu để hỗ trợ quyết định lâm sàng, kiểm tra tương tác thuốc hoặc chuyển sang bộ mã quốc tế PHẢI đọc property axis trước khi coi giá trị ở Dosage.route là đường dùng — nếu không, một mã kỹ thuật sẽ bị hiểu thành đường đưa thuốc.

Mã và nghĩa của CodeSystem giữ nguyên, không có canonical split — dữ liệu đã ghi vẫn giải nghĩa được (ADR-0017 Điều 9).

Đúng 49 mã Phụ lục C QĐ 3680/QĐ-BHXH ngày 23/12/2022. Chỉ dùng đọc dữ liệu đã xác minh theo danh mục này; không thay thế snapshot 59 mã CV 1804/BHXH-QLT và không bao quát mọi danh mục thẻ cũ.

Tập giá trị đối tượng khám sức khoẻ đị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 khoẻ đị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.

Ánh xạ có hướng chỉ gồm sự kiện đã kiểm chứng; relatedto không đồng nhất thực thể pháp lý hoặc địa giới. English: Reviewed directional code-state events only; relatedto does not assert entity or boundary equivalence. Phạm vi lịch sử chưa đầy đủ; không chứng nhận H5, tính liên tục của thực thể hay khả năng phát hành. English: Historical evidence is incomplete; H5, legal-entity continuity and publication readiness are not certified.

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: 470/470 mã của VNYHCTDiseaseCS — gồm 70 bệnh danh gốc và 400 thể lâm sàng, trỏ tới 46 mã ICD-10 riêng biệt.

HAI TẦNG NGUỒN GỐC — đọc kỹ trước khi dùng: 70 bệnh danh gốc lấy TRỰC TIẾP từ cột ICD-10 của các phụ lục nguồn (QĐ 2552/QĐ-BYT: 38; QĐ 2738/QĐ-BYT: 32). 400 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 hoá 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.

Phạm vi dữ liệu: 228 concept từ QĐ 2552/QĐ-BYT và 242 concept từ QĐ 2738/QĐ-BYT; chỉ các concept đã có mã U mới thuộc CodeSystem này.

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 edition 2026 theo TT 06/2026/TT-BYT + QĐ 1849/QĐ-BYT; QĐ 4469/QĐ-BYT là provenance của edition trước 01/07/2026, không phải căn cứ hiện hành), phục vụ liên thông Condition/khai báo bệnh truyền nhiễm. Nguyên tắc mô hình hoá (đã đố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 đã xoá 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).
• TT 06/2026/TT-BYT + QĐ 1849/QĐ-BYT — ICD-10 áp dụng hiện hành tại Việt Nam (đích); QĐ 4469/QĐ-BYT chỉ là provenance edition lịch sử. / 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 hoá (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.

Ánh xạ Phụ lục 017 → Phụ lục 028 đọc từ cột "Mã liên kết" của chính Phụ lục 028 VBHN 13/2026/VBHN-TT-BYT (6054 mã PL1 có ánh xạ, 7647 cặp) — không còn là suy dẫn từ workbook của cổng. Giữ experimental vì định danh đích vẫn là suy dẫn ({chương}.{STT}) và 2% tham chiếu trong cột đó chưa phân giải được về Phụ lục 017: một số ô ghi dải mã ("8.29 - 8.113"), ô ghi dấu * , và mã trỏ tới kỹ thuật không còn trong danh mục hiện hành. Những ô đó được liệt kê ở data/dmkt/vbhn13-pl2.json thay vì đoán. equivalence=relatedto vì một kỹ thuật PL1 thường tương ứng nhiều kỹ thuật PL2 chi tiết hơn.

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.

Crosswalk giới tính 1/2/3 của Phần I.4.1 STT 4 QĐ 2682/QĐ-BYT sang vn-gender-cs (QĐ 3176/QĐ-BYT). Mã 3 hai bên khác nghĩa ('Khác' so với 'Chưa xác định') nên chỉ là inexact. Ánh xạ do VN Core thiết kế.

Liên hệ bốn nhóm 'Hình thức khám chữa bệnh' của Phần VI STT 4 QĐ 2682/QĐ-BYT với một số mã của vn-encounter-type-cs (16 mã theo QĐ 1804/QĐ-BYT). Phần VI căn cứ TT 12/2026/TT-BTC, nhưng hướng dẫn nhóm của Thông tư vẫn viện dẫn QĐ 824/QĐ-BYT: ngoại trú 01/06/07; điều trị ngoại trú 02/05/08; ban ngày 04/09; nội trú 03. QĐ 1804/QĐ-BYT đã định nghĩa mã 09 là nội trú dưới 04 giờ và loại khỏi điều trị ban ngày. Các liên hệ relatedto do VN Core thiết kế không khẳng định tương đương, không xác lập lại thành viên nhóm theo mã hiện hành và không đủ để tự chuyển nhóm báo cáo thành MA_LOAI_KCB. Cần biết loại điều trị thực tế và phiên bản danh mục áp dụng.

Cầu định danh giữa danh mục ICD-10 Việt Nam (vn-icd10-cs, edition 2026) và bảng ICD-10 của WHO (edition 2019). 15.821 mã có mã WHO tương ứng (cùng chuỗi mã, quan hệ equivalent); 231 mã không map (mở rộng riêng của Việt Nam hoặc dòng không mang tên WHO 2019 trong phụ lục).

ĐIỀU KIỆN MAP: mã vừa có hình thái hợp lệ trong khung WHO vừa mang tên bệnh ở cột DISEASE NAME WHO 2019 của bảng phụ lục TT 06/2026/TT-BYT — tức đối chiếu theo tuyên bố của phụ lục ban hành, KHÔNG phải đối chiếu trực tiếp cơ sở dữ liệu WHO. Mã bị huỷ theo Phụ lục 4 QĐ 1849/QĐ-BYT (inactive) KHÔNG map — phần lớn bị huỷ với lý do WHO không có mã tương ứng; dữ liệu lịch sử cần liên thông theo edition cũ dùng bản đóng băng CodeSystem-vn-icd10-cs-2020-legacy.full.json.

Dùng khi cần gửi coding thứ hai theo hệ WHO cho liên thông quốc tế, hoặc khi đọc dữ liệu trao đổi dưới URI WHO trước phiên bản 0.10.0. Mã cấp 5 của chương XIII (M) và XIX (S/T) là supplementary subdivision do chính WHO định nghĩa nên vẫn thuộc hệ WHO.

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ứ hiện hành:

• TT 06/2026/TT-BYT (hiệu lực 01/07/2026) + QĐ 1849/QĐ-BYT (23/06/2026) — danh mục ICD-10 VN edition 2026 (nguồn mã chẩn đoán; T-08 review 97b — QĐ 4469/QĐ-BYT chỉ còn là provenance cho dữ liệu trước 01/07/2026).
• 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 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.

Crosswalk 'Loại định danh' 1/2/3 của Phần II STT 7 QĐ 2682/QĐ-BYT sang vn-identifier-type-cs (CCCD, CMND, HC). Ánh xạ do VN Core thiết kế.

Crosswalk ba giá trị 'Loại hình khám chữa bệnh' của sổ sức khoẻ (Phần I.4.4 STT 8 QĐ 2682/QĐ-BYT) sang Encounter.class (HL7 v3 ActCode). Ánh xạ do VN Core thiết kế — văn bản không in bảng ánh xạ.

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

4149 ánh xạ từ 4145 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.

4145/4150 mã có ánh xạ; 5 mã 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) — mỗi mã nguồn là một element mang đủ các target, 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ạ 470 bệnh danh và thể lâm sàng của QĐ 2552/QĐ-BYT và QĐ 2738/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 hoá 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 hoá 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ã hoá dược tạm thời.

1373 ánh xạ từ mã huyệt châm cứu Việt Nam sang SNOMED CT, lấy cột mã tham chiếu SNOMED CT của Phụ lục III QĐ 2552/QĐ-BYT.

Vì sao cần post-coordination. Phụ lục gán CÙNG một mã SNOMED cho cả bốn biến thể của một huyệt — huyệt gốc, bên trái, bên phải, hai bên. Chép nguyên quan hệ đó thì mọi bản dịch sang SNOMED đều mất thông tin bên mà không báo gì. Vì vậy 978 biến thể theo bên mang thêm target.product với attribute Laterality (272741003) và giá trị tương ứng, đồng thời hạ equivalence xuống wider — mã đích một mình rộng hơn mã nguồn vì không nói được bên.

Huyệt gốc và mã nhóm giữ equivalence = equivalent.

Mã và display của attribute laterality lấy từ SNOMED International Global Patient Set (hl7.terminology#7.2.0, giấy phép CC BY 4.0).

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.

Crosswalk đủ 32 mã VNPractitionerTitleCS (ngạch/hạng chức danh nghề nghiệp viên chức y tế) sang 10 chức danh pháp lý phải có giấy phép hành nghề tại Luật 15/2023/QH15 Điều 26 khoản 1.

ConceptMap này KHÔNG tham gia invariant. Nó chỉ hỗ trợ chuyển đổi và tra cứu. Invariant vn-practitioner-regulated-title-license đọc chức danh pháp lý do dữ liệu TỰ KHAI tại Practitioner.qualification, không suy diễn từ mã V.08 — vì hai lý do:

1. Bốn ánh xạ mang relatedto (ba ngạch Dinh dưỡng, một ngạch Khúc xạ nhãn khoa) chỉ đúng khi có xác nhận ngữ nghĩa ngoài mã: ngạch Dinh dưỡng không tự chứng minh người đó hành nghề với chức danh pháp lý Dinh dưỡng lâm sàng.
2. Hệ V.08 chỉ áp cho viên chức đơn vị sự nghiệp công lập. Người hành nghề khu vực tư nhân, lương y và người có bài thuốc gia truyền không có mã V.08 nhưng vẫn thuộc diện phải có giấy phép hành nghề.

Phân bố: 18 mã wider (ngạch cụ thể hơn chức danh pháp lý), 10 mã unmatched (y tế công cộng, dược, dân số — ngoài Điều 26 khoản 1), 4 mã relatedto có điều kiện.

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 hoá 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ạ 64 mã của danh mục xét nghiệm liên thông theo QĐ 3148/QĐ-BYT sang mã kỹ thuật trong danh mục hiện hành TT 23/2024/TT-BYT. Các mã nguồn mang provenance lịch sử từ cột MÃ TT43; TT 43/2013/TT-BYT đã hết hiệu lực.

QUY TẮC ÁNH XẠ DO CHÍNH VĂN BẢN TUYÊN BỐ, không phải suy diễn của VN Core. TT 25/2026/TT-BYT Điều 3 khoản 2 sửa Điều 4 khoản 4 TT 23/2024/TT-BYT, quy định số thứ tự kỹ thuật theo từng chương của TT 43/2013/TT-BYT và TT 21/2017/TT-BYT, khi được liệt kê tại cột 2 Phụ lục 01, tiếp tục được dùng làm mã kỹ thuật tương ứng. Do đó 43.CC.NN → CC.NN.

ĐÃ ĐỐI CHIẾU TỪNG DÒNG, không chỉ áp công thức: cả 64 mã đích đều tồn tại trong CodeSystem DVKT hiện hành; target.display được đồng bộ trực tiếp từ CodeSystem đích để không giữ chuỗi tên bị cắt hoặc biến dạng từ bảng nguồn trung gian.

MỘT MỤC KHÔNG CÓ TRONG ÁNH XẠ: Vi sinh số 26 (Mycobacterium tuberculosis QuantiFERON) bị bỏ trống cột mã trong chính văn bản, kể cả bản có chứng thư số. Không suy mã cho mục đó theo quy tắc trên, vì không có số thứ tự nguồn để suy.

Á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ế.

Đối chiếu 49 mã Phụ lục C QĐ 3680/QĐ-BHXH với các mã cùng ký hiệu trong danh mục umbrella hiện hành. Mỗi cặp chỉ khẳng định giao nhau về đối tượng (relatedto), không khẳng định tương đương, không bao quát mọi mã đích có thể có. Đây là quan hệ do VN Core phân tích từ định nghĩa, không phải bảng chuyển đổi do BHXH ban hành. Phải xác minh người tham gia và tra cứu cơ quan BHXH để chọn mã hiện hành; không dùng ConceptMap này để tự thay mã.

ARTIFACT TƯƠNG THÍCH ĐÃ NGỪNG DÙNG. Phiên bản cũ đã mô hình URL cổng gdbhyt thành NamingSystem; đó là sai loại artifact vì URL này là Endpoint.address, không phải Identifier.system. 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ữ liệu mới KHÔNG dùng NamingSystem này. Dùng URL tại Endpoint.address; nếu cần định danh một instance cấu hình Endpoint thì dùng vn-bhyt-gateway-endpoint-ns trên Endpoint.identifier.

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

Namespace cho mã chỉ tiêu thuộc hệ thống chỉ tiêu thống kê quốc gia, do NĐ 94/2022/NĐ-CP quy định nội dung (khái niệm, phương pháp tính, phân tổ, kỳ công bố, nguồn số liệu) tại Phụ lục I. Mã gồm bốn chữ số: hai chữ số đầu là nhóm lĩnh vực, hai chữ số sau là số thứ tự chỉ tiêu trong nhóm — nhóm 16 là Y tế và chăm sóc sức khoẻ (1601 số bác sĩ trên 10.000 dân, 1602 số giường bệnh trên 10.000 dân). Dùng cho Measure.identifier của các chỉ tiêu báo cáo Chính phủ mà QĐ 2716/QĐ-BYT giao Bộ Y tế thực hiện. KHÔNG phải bộ mã do VN Core cấp: mã do Chính phủ ban hành, ở đây chỉ khai namespace để tham chiếu được (ADR-0017 Điều 11). Không tự sinh mã mới cho chỉ tiêu chưa có trong Phụ lục I — QĐ 293/QĐ-TTg để TRỐNG cột mã cho chỉ số hài lòng người bệnh nội trú, số vụ ngộ độc thực phẩm và tỷ lệ chất thải y tế được xử lý; ba chỉ tiêu đó chưa thuộc hệ thống chỉ tiêu thống kê quốc gia.

Hệ thống định danh cho Bundle chứng nhận sức khoẻ 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 khoẻ định kỳ lên trục dữ liệu sức khoẻ cá nhân của Bộ Y tế. Endpoint.address giữ URL kỹ thuật thực tế.

Hệ thống định danh Mã giấy chứng sinh (MA_GCS) do cơ sở khám bệnh, chữa bệnh cấp theo QĐ 2919/QĐ-BYT (hiệu lực 01/10/2025). KHÔNG PHẢI số Giấy khai sinh: Giấy chứng sinh do cơ sở khám bệnh, chữa bệnh cấp ngay sau khi trẻ ra đời; Giấy khai sinh do Uỷ ban nhân dân cấp sau đó theo thủ tục hộ tịch. Khác cơ quan cấp, khác thời điểm, khác cấu trúc số — số Giấy khai sinh dùng sid/gks, không dùng namespace này. CẤU TRÚC: đúng 18 ký tự dạng XXXXX.GCS.ZZZZZ.YY — 5 ký tự số thứ tự tăng dần của giấy đã cấp trong năm tại cơ sở, literal GCS, 5 ký tự mã cơ sở khám bệnh chữa bệnh, 2 số cuối của năm. Số thứ tự chỉ duy nhất TRONG một cơ sở và một năm, nên mã nhúng sẵn cả mã cơ sở lẫn năm để đạt tính duy nhất toàn quốc — không được cắt bớt phần nào khi trao đổi. Căn cứ:

• QĐ 2919/QĐ-BYT — hiệu lực 01/10/2025 — chuẩn và định dạng dữ liệu điện tử Giấy chứng sinh; bãi bỏ QĐ 1898/QĐ-BYT và bãi bỏ Bảng 9 của QĐ 130/QĐ-BYT
• NĐ 63/2024/NĐ-CP — 10/6/2024 — liên thông điện tử đăng ký khai sinh, đăng ký thường trú, cấp thẻ BHYT cho trẻ em dưới 6 tuổi.

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

SCHEME DÙNG TẠM (B-06, hậu kiểm 12/08/2026 — nhân rộng khuôn MRN 0.8.0): Mã liên kết hồ sơ bhyt ma_lk do TỪNG cơ sở tự quản lý nên khoá uniqueness là system+value — một URI quốc gia dùng chung cho mọi cơ sở KHÔNG bảo đảm uniqueness (hai cơ sở có thể trùng value; merge dữ liệu liên cơ sở sẽ đụng danh tính token system|value). Khuyến nghị chính: mỗi cơ sở TỰ CÔNG BỐ URI riêng (vd https://benhvien.example.vn/sid/ma-lk). 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ở. 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.

SCHEME DÙNG TẠM (B-06, hậu kiểm 12/08/2026 — nhân rộng khuôn MRN 0.8.0): Mã lượt khám ma_luot_kcb do TỪNG cơ sở tự quản lý nên khoá uniqueness là system+value — một URI quốc gia dùng chung cho mọi cơ sở KHÔNG bảo đảm uniqueness (hai cơ sở có thể trùng value; merge dữ liệu liên cơ sở sẽ đụng danh tính token system|value). Khuyến nghị chính: mỗi cơ sở TỰ CÔNG BỐ URI riêng (vd https://benhvien.example.vn/sid/ma-luot-kcb). 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ở. 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 legacy (10 chữ số), do BHXH Việt Nam cấp. Gắn với sổ BHXH và dữ liệu lịch sử về quá trình tham gia BHXH/BHYT/BHTN. CV 1804/BHXH-QLT ngày 04/08/2025 quy định dùng ĐDCN/CCCD thay mã số BHXH từ 01/08/2025, đồng thời cho phép tiếp tục dùng mã 10 số trong giai đoạn hoàn thiện phần mềm. Vì vậy VN Core giữ sid/bhxh cho migration/interoperability nhưng không ghi CCCD vào namespace này; CCCD dùng sid/cccd. 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
• CV 1804/BHXH-QLT — 04/8/2025 — chuyển khoá quản lý sang ĐDCN/CCCD, có giai đoạn chuyển tiếp.

Hệ thống định danh cho Bundle hoặc tài liệu đại diện Sổ Sức khoẻ đ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 khoá 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ử — 14 ký tự, ghép từ mã cơ sở KCB (05) + mã đơn (07) + dấu gạch + ký tự loại đơn. Cơ sở bán lẻ thuốc bán theo mã đơn và báo cáo về donthuocquocgia.vn.

Ai sinh mã. Bộ Y tế là cơ quan quản trị cấu trúc mã và Hệ thống đơn thuốc quốc gia, nhưng mã cụ thể do phần mềm nguồn của cơ sở KCB (HIS) tự sinh theo cấu trúc rồi gửi lên: QĐ 808/QĐ-BYT đặt ma_don_thuoc trong FormData của request /api/v1/gui-don-thuoc, còn TT 26/2025/TT-BYT Phụ lục I chỉ nói mã 'được tạo ra tự động theo cấu trúc quy định' mà không nêu chủ thể. Không mô tả cổng quốc gia như bên cấp phát từng mã.

Ký tự loại đơn. TT 26/2025/TT-BYT: N đơn thuốc gây nghiện, H đơn thuốc hướng thần/tiền chất, C đơn thuốc khác. TT 55/2025/TT-BYT dùng T cho đơn thuốc thang. QĐ 808/QĐ-BYT (contract cổng, ban hành trước) dùng bộ C/N/H/Y với Y cho đơn y học cổ truyền — giá trị legacy ở tầng transport, không dùng cho dữ liệu canonical. Căn cứ:

• TT 26/2025/TT-BYT — kê đơn thuốc hoá 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. Đối chiếu QĐ 1551/QĐ-BYT đọc cùng QĐ 2062/QĐ-BYT (thay Phụ lục 01-03): tên trường ghi 'Mã cơ sở khám bệnh, chữa bệnh theo chuẩn GLN', phần diễn giải ghi 'Ghi mã cơ sở khám bệnh, chữa bệnh nơi đối tượng đến khám sức khỏe do cơ quan có thẩm quyền cấp, gồm 13 ký tự'. QĐ 2062/QĐ-BYT lặp trường này tại Phụ lục 01 STT 23, Phụ lục 02 STT 19 và Phụ lục 03 STT 18. Như vậy văn bản xác lập: mã do cơ quan Việt Nam cấp, dài 13 ký tự, theo chuẩn GLN. Điều văn bản KHÔNG nói: mã này có phải GS1 GLN đăng ký toàn cầu (có tiền tố doanh nghiệp GS1 và số kiểm tra theo thuật toán GS1) hay chỉ mượn cấu trúc 13 chữ số của GLN. NamingSystem giữ trung lập ở điểm còn mở đó — chỉ ràng buộc độ dài 13 ký tự số; không khẳng định là GTIN hàng hoá. Cần văn bản hướng dẫn cấp mã để chốt. 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 khoẻ + Sổ SKĐT. Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) đọc cùng QĐ 2062/QĐ-BYT (07/7/2026); Luật KCB 2023 (15/2023/QH15).

SCHEME DÙNG TẠM (B-06, hậu kiểm 12/08/2026 — nhân rộng khuôn MRN 0.8.0): Mã định danh tổ chức nội bộ do TỪNG cơ sở tự quản lý nên khoá uniqueness là system+value — một URI quốc gia dùng chung cho mọi cơ sở KHÔNG bảo đảm uniqueness (hai cơ sở có thể trùng value; merge dữ liệu liên cơ sở sẽ đụng danh tính token system|value). Khuyến nghị chính: mỗi cơ sở TỰ CÔNG BỐ URI riêng (vd https://benhvien.example.vn/sid/organization-local-id). 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ở. 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ụ.

SCHEME DÙNG TẠM (B-06, hậu kiểm 12/08/2026 — nhân rộng khuôn MRN 0.8.0): Mã định danh địa điểm nội bộ do TỪNG cơ sở tự quản lý nên khoá uniqueness là system+value — một URI quốc gia dùng chung cho mọi cơ sở KHÔNG bảo đảm uniqueness (hai cơ sở có thể trùng value; merge dữ liệu liên cơ sở sẽ đụng danh tính token system|value). Khuyến nghị chính: mỗi cơ sở TỰ CÔNG BỐ URI riêng (vd https://benhvien.example.vn/sid/location-local-id). 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ở. 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 khoá 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 Luật KCB 40/2009/QH12.

KHÔNG phải định danh thuần lịch sử: NĐ 96/2023/NĐ-CP Điều 143 khoản 2 quy định từ 01/01/2024, chứng chỉ hành nghề đã cấp được TIẾP TỤC SỬ DỤNG NHƯ giấy phép hành nghề cho tới khi được chuyển đổi khi thực hiện thủ tục gia hạn (khoản 3), với phạm vi hành nghề theo phạm vi đã được cấp có thẩm quyền phê duyệt. Khoản 3 đặt mốc: áp thời hạn 05 năm từ năm 2030 và hết hiệu lực năm 2035.

Trạng thái pháp lý của từng số CCHN đọc ở extension vn-ext-practice-license-status, KHÔNG suy từ loại định danh: một số CCHN có thể đang cchn-transition-continued (còn dùng như GPHN), expired (đã chuyển đổi hoặc hết hiệu lực), revoked hay bị đình chỉ.

Format không cố định, tuỳ từng đợt cấp phép trước đây — KHÔNG áp regex.

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ứ hiện hành của hệ định danh tại ngày 04/08/2026 là Luật 60/2014/QH13 (Điều 14 — số định danh cá nhân gắn vào giấy khai sinh); luật này còn hiệu lực đến hết 28/02/2027. Luật 03/2026/QH16 là future-effective từ 01/03/2027 và Điều 29 khoản 2 làm luật hiện hành hết hiệu lực đúng từ mốc đó. Không chuyển căn cứ structured sang luật mới trước ngày hiệu lực.

Hệ thống định danh số giấy phép hoạt động của cơ sở khám bệnh, chữa bệnh.

Mỗi cơ sở KCB có một giấy phép hoạt động và giấy phép này KHÔNG có thời hạn (Luật 15/2023/QH15 Điều 50 khoản 1). Cơ sở có thêm địa điểm khác thì mỗi địa điểm phải có một giấy phép hoạt động riêng — vì vậy định danh này gắn với ĐỊA ĐIỂM cơ sở, không phải với pháp nhân.

Vì giấy phép không có thời hạn, hiệu lực thực tế KHÔNG suy được từ ngày tháng: nó phụ thuộc quyết định đình chỉ (Điều 55) hoặc thu hồi (Điều 56). Trạng thái đó biểu diễn bằng extension vn-ext-operating-license-status gắn trực tiếp lên Identifier.

Giấy phép hoạt động cấp theo Luật KCB 40/2009/QH12 vẫn tiếp tục có giá trị và cơ sở được tiếp tục hoạt động theo giấy phép đã cấp mà không phải chuyển đổi hình thức tổ chức (NĐ 96/2023/NĐ-CP Điều 144 khoản 1) — những giấy phép này mang trạng thái active.

KHÔNG áp regex: NĐ 96/2023/NĐ-CP Điều 61 khoản 6 chỉ dẫn chiếu Mẫu số 06 Phụ lục II mà không quy định quy tắc định dạng số giấy phép, và toàn văn Nghị định trong repo không chứa nội dung mẫu này.

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 công dân Việt Nam — kể cả người 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ố.

Phạm vi — không dùng cho hộ chiếu nước ngoài. Số hộ chiếu chỉ duy nhất trong phạm vi quốc gia cấp; mỗi nước đánh số theo dãy riêng nên cùng một chuỗi số có thể trùng giữa các nước. Vì khoá định danh trong FHIR là system + value, đưa hộ chiếu nước ngoài vào namespace này sẽ phá bảo đảm duy nhất và cho phép va chạm giữa hai người khác quốc tịch. Hộ chiếu do nước khác cấp dùng URI namespace của chính quốc gia đó khi đã công bố; nếu chưa có, ghi rõ cơ quan/quốc gia cấp ở Identifier.assigner.

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. Theo VBHN 08/VBHN-BYT năm 2026 Điều 21, số lưu hành là số công bố tiêu chuẩn áp dụng đối với thiết bị loại A/B và là số giấy chứng nhận đăng ký lưu hành đối với thiết bị loại C/D. Đâ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. Namespace này nhận nguyên giá trị từ hồ sơ/cổng quản lý và không hàm ý một lexical format PCBA/PCBB/ĐKLH, vì Điều 21 không ban hành các pattern đó.

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ố (vận hành từ 01/4/2021; legacy/chuyển tiếp sau CV 1804/BHXH-QLT) — 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à KHOÁ 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). CV 1804/BHXH-QLT chuyển khoá quản lý người tham gia sang ĐDCN/CCCD từ 01/08/2025 nhưng vẫn cho phép mã 10 số trong giai đoạn chuyển tiếp; điều này không biến CCCD thành một giá trị hợp lệ của sid/bhyt. 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
• CV 1804/BHXH-QLT — 04/8/2025 — chuyển khoá quản lý sang ĐDCN/CCCD, có giai đoạn chuyển tiếp
• 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 thoả 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 thoả 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.

Vai đối ứng của Data Responder: hệ thống yêu cầu và tiêu thụ dữ liệu lõi VN Core trên cùng 15 profile. Nghĩa vụ là XỬ LÝ ĐÚNG Ý NGHĨA phần tử Must Support khi có mặt và coi việc vắng dữ liệu là trạng thái hợp lệ — không phải điền đủ. / The requester counterpart: consume the same 15 core profiles, handling Must Support elements meaningfully and treating absence as valid.

NGƯỠNG TỐI THIỂU để một hệ thống tuyên bố 'đáp ứng dữ liệu lõi VN Core': phục vụ read + search-type trên 15 profile lõi, điền phần tử Must Support khi đã biết giá trị và không làm mất dữ liệu khi trả về. Hệ thống đạt lát này có thể conform mà KHÔNG cần triển khai các lát chuyên biệt (EMR đầy đủ, ứng dụng người dân, cổng BHYT). / The minimum national conformance bar: read + search on 15 core profiles with lossless Must Support handling.

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.

CapabilityStatement THAM CHIẾU TỔNG HỢP: liệt kê toàn bộ bề mặt tài nguyên mà VN Core IG định nghĩa (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. KHÔNG một hệ thống đơn lẻ nào phải triển khai tất cả — đây không phải 'minimum national core server'. Yêu cầu tuân thủ THẬT theo từng vai trò triển khai nằm ở các CapabilityStatement chuyên biệt (EMR server, cổng BHYT client/server, ứng dụng người dân) và nghĩa vụ máy-đọc-được theo actor (obligation extension, ActorDefinition vn-actor-*). / A REFERENCE aggregate CapabilityStatement enumerating the full VN Core resource surface; no single system is expected to implement all of it — per-role conformance lives in the specialised CapabilityStatements and actor obligations.

Yêu cầu tuân thủ tối thiểu cho CỔNG LIÊN THÔNG tiếp nhận thông điệp dữ liệu y tế phục vụ thủ tục hành chính theo NĐ 63/2024/NĐ-CP — cổng dịch vụ công, hệ thống của cơ quan tư pháp, công an, BHXH. Tiếp nhận phải lưu trọn nội dung và không được từ chối vì phần tử vắng dữ liệu hợp lệ. Đây KHÔNG phải bề mặt trao đổi EMR nội bộ, cũng không phải bề mặt giám định BHYT. / Minimum conformance for the gateway receiving health data messages for administrative procedures.

Yêu cầu tuân thủ tối thiểu cho hệ thống TIẾP NHẬN tài liệu biểu mẫu đã lập — hiện là bảng kê chi phí KCB theo QĐ 697/QĐ-BYT (vn-core-cost-statement-document-bundle): hệ lưu trữ của cơ sở, hệ đối soát chi phí, cổng cung cấp cho người bệnh. Tiếp nhận không làm thay đổi nội dung/chữ ký của tài liệu. / Minimum conformance for systems that RECEIVE finalized form documents; receiving must not alter the signed content.

Yêu cầu tuân thủ tối thiểu cho hệ thống CUNG CẤP tài liệu biểu mẫu đã lập — hiện là bảng kê chi phí KCB theo QĐ 697/QĐ-BYT (vn-core-cost-statement-document-bundle): cơ sở KCB xuất bảng kê đã ký cho người bệnh, cơ quan đối soát hoặc hệ lưu trữ. Đây KHÔNG phải bề mặt gửi giám định BHYT — hồ sơ đề nghị thanh toán đi qua VNBHYTGatewayClient/Server. / Minimum conformance for systems that PROVIDE finalized form documents (currently the QĐ 697/QĐ-BYT cost-statement document bundle). Not a BHYT adjudication submission surface.

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 hoá, 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. PHÂN ĐỊNH NGUỒN: hợp đồng phép gọi (code, parameter, kiểu trả về) do VN Core thiết kế; các văn bản viện dẫn đặt nghĩa vụ và nội dung dữ liệu, không ban hành phép gọi.

OperationDefinition cho phép thu hồi hoặc huỷ hồ sơ BHYT đã gửi. PHÂN ĐỊNH NGUỒN: hợp đồng phép gọi (code, parameter, kiểu trả về) do VN Core thiết kế; các văn bản viện dẫn đặt nghĩa vụ và nội dung dữ liệu, không ban hành phép gọi.

OperationDefinition cho phép kiểm tra hồ sơ BHYT trước khi gửi Cổng giám định BHXH. PHÂN ĐỊNH NGUỒN: hợp đồng phép gọi (code, parameter, kiểu trả về) do VN Core thiết kế; các văn bản viện dẫn đặt nghĩa vụ và nội dung dữ liệu, không ban hành phép gọi.

SearchParameter cho phép tìm AdverseEvent theo identifier. FHIR R4 core KHÔNG định nghĩa tham số AdverseEvent.identifier (khác với hầu hết resource khác), nên VN Core khai tham số cục bộ để hợp đồng tạo-có-điều-kiện (If-None-Exist: identifier={system}|{value}) của Ổn định và tuân thủ thực hiện được trên resource này. Ví dụ: GET [base]/AdverseEvent?identifier=http://benhvien.example.vn/sid/adverse-event|AE-2026-0042

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à khoá 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ứ hiện hành: TT 06/2026/TT-BYT (hiệu lực 01/07/2026) + QĐ 1849/QĐ-BYT (23/06/2026) — danh mục và hướng dẫn mã hoá ICD-10 edition 2026. Chuỗi QĐ 4469/QĐ-BYT (2020) + QĐ 98/QĐ-BYT (2022) chỉ còn là provenance cho dữ liệu lập trước 01/07/2026 (T-08, review 97b). Phủ CẢ HAI hệ: danh mục Việt Nam (vn-icd10-cs — hệ chính khi coding) và bảng WHO (http://hl7.org/fhir/sid/icd-10 — coding thứ hai cho liên thông quốc tế và dữ liệu trao đổi trước 0.10.0). Nếu chỉ lọc một hệ thì truy vấn sẽ bỏ sót đúng nửa dữ liệu. Ví dụ: GET [base]/Condition?vn-icd10=http://fhir.hl7.org.vn/core/CodeSystem/vn-icd10-cs|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 khoá 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). CCHN là credential CHUYỂN TIẾP, không thuần lịch sử: theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2 nó tiếp tục được dùng như giấy phép hành nghề tới khi chuyển đổi. 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; cấu trúc số giấy phép theo TT 32/2023/TT-BYT Phụ lục XIX. Ví dụ: GET [base]/Practitioner?vn-gphn=000001/BYT-GPHN

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à khoá 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

Fixture âm chỉ đảo thứ tự thời gian của DEN_NGAY và TU_NGAY khi có SO_NGAY; không dùng làm dữ liệu nghiệp vụ.

Fixture âm chỉ thiếu NGUYENNHAN_DINHCHI khi MA_DINH_CHI_THAI=1; không dùng làm dữ liệu nghiệp vụ.

Fixture âm chỉ dùng MA_LOAI_RV ngoài tập mã đóng; không dùng làm dữ liệu nghiệp vụ.

Fixture âm chỉ dùng MA_TAI_NAN ngoài tập mã đóng; không dùng làm dữ liệu nghiệp vụ.

Fixture âm chỉ dùng PHAM_VI ngoài tập mã đóng; không dùng làm dữ liệu nghiệp vụ.

Fixture âm chỉ thiếu THOIGIAN_DINHCHI khi MA_DINH_CHI_THAI=1; không dùng làm dữ liệu nghiệp vụ.

Fixture âm chỉ dùng KET_QUA_DTRI ngoài tập mã đóng; không dùng làm dữ liệu nghiệp vụ.

Fixture âm — KHÔNG dùng làm mẫu. Bản ghi khai suspectEntity nhưng phần instance chỉ có type = 'Immunization', không có reference cũng không có identifier. Về hình thức thì có nghi ngờ nhân quả; về thực chất không truy được mũi tiêm nào, nên không đối chiếu được sổ tiêm chủng và không điều tra được — y hệt trường hợp bỏ trống hoàn toàn.

Kỳ vọng: vn-aefi-immunization-linked báo lỗi (với biểu thức trước 16/08/2026 thì KHÔNG, đó là lý do fixture này tồn tại).

Fixture âm — KHÔNG dùng làm mẫu. Người mẹ ký parental-proxy consent ngày 22/04/2026 nhưng token thẩm quyền của chính người mẹ chỉ được xác minh ngày 23/04/2026; G-012 phải từ chối dữ kiện chưa tồn tại tại thời điểm ký.

Fixture âm — KHÔNG dùng làm mẫu. Đợt 3 bắt đầu cách đợt 2 bốn ngày. Phải bị vn-rx-narcotic-course-consecutive từ chối.

Fixture âm — KHÔNG dùng làm mẫu. Entry Observation phải bị cổng [LOINC-DOMAIN] từ chối dù không có JSON top-level riêng.

Fixture âm — KHÔNG dùng làm mẫu. Bản sao của ExampleBHYTSubmissionOutpatient bị bỏ duy nhất entry Claim để chứng minh vn-bhyt-submission-has-claim.

Fixture âm — KHÔNG dùng làm mẫu. Bản sao ExampleBHYTSubmissionOutpatient bỏ duy nhất entry Coverage để chứng minh vn-bhyt-submission-has-coverage.

Fixture âm — KHÔNG dùng làm mẫu. Bản sao ExampleBHYTSubmissionOutpatient bỏ duy nhất entry Patient để chứng minh vn-bhyt-submission-has-patient.

Fixture âm — KHÔNG dùng làm mẫu. Bản ghi tự xưng là sự cố bất lợi SAU TIÊM CHỦNG nhưng không có extension[relatedImmunization] (liên hệ thời gian) lẫn suspectEntity (nghi ngờ nhân quả) — không cách nào truy ra mũi tiêm nào đứng trước sự cố, tức là không có căn cứ xếp bản ghi vào miền AEFI, không đối chiếu được với sổ tiêm chủng, không điều tra được.

Kỳ vọng: vn-aefi-immunization-linked báo lỗi.

Fixture âm — phải bị vn-measure-report-hospital-quality-conclusion từ chối.

Fixture âm — KHÔNG dùng làm mẫu. DiagnosticReport.code là 100019-9 (CLASS=MOLPATH.MUT) trong khi category là chẩn đoán hình ảnh. Phải bị nhánh imaging của cổng [LOINC-DOMAIN] từ chối.

Fixture âm — KHÔNG dùng làm mẫu. Phải bị cổng [LOINC-DOMAIN] từ chối vì LOINC CLASS=RAD nằm ngoài miền pathology.

Fixture âm — KHÔNG dùng làm mẫu. type = summary nhưng không evaluatedResource nào. Phải bị vn-measure-report-summary-evidenced từ chối.

Fixture âm — KHÔNG dùng làm mẫu. date cố ý sớm hơn period.end; phải bị vn-measure-report-period-order từ chối.

Fixture âm — KHÔNG dùng làm mẫu. Bản chuyển đổi giấy được đánh dấu là văn bản chính thức nhưng không có bằng chứng chữ ký số. 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).

Fixture âm — KHÔNG dùng làm mẫu. Bản final có đủ người lập và kế toán viện phí nhưng thiếu vai trò xác nhận của người bệnh. Phải bị vn-cost-statement-composition-three-signatures từ chối.

Fixture âm — KHÔNG dùng làm mẫu. Attachment có metadata nhưng không có data hoặc url và phải bị vn-birth-certificate-content-present từ chối.

Fixture âm — KHÔNG dùng làm mẫu. Bản sao ExampleBundleCostStatementSigned có Composition trỏ ExamplePatientMinimal nhưng Invoice vẫn trỏ ExamplePatientNguyenVanAn; phải bị vn-cost-statement-document-same-subject từ chối.

Fixture âm — KHÔNG dùng làm mẫu. Bản ghi khai status = #rejected — tức chủ thể dữ liệu đã KHÔNG đồng ý — nhưng bên trong vẫn giữ một provision.provision mang type = #permit.

Đây là mâu thuẫn nguy hiểm nhất của lớp đồng ý: một hệ thống đọc provision để quyết định cho phép truy cập sẽ thấy rule permit và mở dữ liệu, dù trạng thái của chính bản ghi nói rằng không có sự đồng ý nào. Luật 91/2025/QH15 Điều 9 đặt sự đồng ý làm căn cứ xử lý; rule cho phép tồn tại trong một bản đã từ chối là căn cứ rỗng.

Vi phạm: vn-consent-rejected-not-permit — (status = 'rejected') implies provision.repeat(provision).type.where($this = 'permit').empty().

Fixture âm — KHÔNG dùng làm mẫu. Bảng giá ngày giường chỉ khai một khoản phụ thu mà không khai mức giá gốc base để tính khoản phụ thu đó.

Kỳ vọng: invariant vn-charge-item-definition-base-price-required báo lỗi.

Fixture âm — KHÔNG dùng làm mẫu. Bảng giá kỹ thuật can thiệp động mạch vành có ngày phê duyệt nhưng không nêu đơn vị công bố và cũng không dẫn chiếu URI của quyết định. Vì vậy không có đường nào trong hai đường được VN Core cho phép để tra ngược bảng giá về quyết định phê duyệt.

Mọi dữ liệu còn lại được giữ nguyên từ ví dụ dương ExampleChargeItemDefinitionPCI; mức giá vẫn dùng VND.

Kỳ vọng: invariant vn-charge-item-definition-approval-traceable báo lỗi.

Fixture âm — KHÔNG dùng làm mẫu. Sao chép ExampleCostStatementUninsured và thêm đúng một totalGross dùng USD để cô lập invariant tiền tệ ở cấp toàn bảng kê.

Fixture âm — KHÔNG dùng làm mẫu. Sao chép ExampleCostStatementMultiSegment và đổi khoá phân đoạn thứ hai thành sequence = 1, trùng với phân đoạn đầu.

Fixture âm — KHÔNG dùng làm mẫu. Phân đoạn không có coverage, và cột số (8) đã khai đúng bằng 0, nhưng cột số (13) 'Người bệnh tự trả' chỉ ghi 150.000 trong khi cột số (7) 'Thành tiền BV' là 200.000.

QĐ 697/QĐ-BYT Phần Hai mục 2 quy định: 'cột số (13) “Người bệnh tự trả” bằng cột số (7) “Thành tiền BV”'. Người không có thẻ bảo hiểm y tế thì không có nguồn nào khác gánh phần chi phí, nên toàn bộ thành tiền phải nằm ở cột người bệnh tự trả.

Đây là fixture bổ trợ cho ExampleCostStatementUninsuredRatioNotZero: hai vế của cùng một invariant được thử riêng, không gộp vào một resource, để mỗi lần chạy chỉ chứng minh đúng một mệnh đề.

Điểm tinh vi: phần chênh 50.000 được đẩy sang otherSource nên tổng bốn nguồn vẫn đúng bằng cột (7) và invariant vn-cost-statement-line-allocation-sum KHÔNG bắt được lỗi này. Chỉ ràng buộc riêng cho bảng kê không thẻ mới phát hiện: với người không có thẻ, 'nguồn khác' không thể thay người bệnh trả.

Kỳ vọng: invariant vn-cost-statement-uninsured-line-defaults báo lỗi.

Fixture âm — KHÔNG dùng làm mẫu. Phân đoạn không có coverage, tức bảng kê của người không có thẻ bảo hiểm y tế, nhưng dòng chi phí lại khai paymentRatio = 80 — cột số (8) của mẫu bảng kê.

QĐ 697/QĐ-BYT Phần Hai mục 2 quy định: 'Cột số (8) “Tỷ lệ thanh toán BHYT” mặc định bằng 0'. Một người không có thẻ thì không có tỷ lệ thanh toán BHYT nào để hưởng; ghi 80% ở đây tạo ra một bảng kê tự mâu thuẫn — không có thẻ nhưng vẫn tuyên bố quỹ chi trả theo tỷ lệ.

Lỗi này khó thấy vì mọi phần tử đều có mặt và tổng bốn nguồn thanh toán vẫn khớp cột (7): cột (13) đúng bằng 200.000, insuranceFund và patientCopay đều bằng 0. Chỉ một con số ở cột (8) nói rằng dòng này đang được hiểu là có bảo hiểm.

Fixture chỉ sai đúng MỘT lý do: benefitLevel không được khai (nếu khai sẽ thêm lỗi vn-cost-statement-uninsured-no-benefit), tổng phân bổ vẫn bằng cột (7) (không chạm vn-cost-statement-line-allocation-sum), và cột (13) vẫn bằng cột (7) (không chạm vế thứ hai của chính invariant đang thử).

Kỳ vọng: invariant vn-cost-statement-uninsured-line-defaults báo lỗi.

Fixture âm — KHÔNG dùng làm mẫu. Bảng kê đã phát hành có hai dòng hợp lệ, nhưng dòng ngày giường không khai extension phân bổ bốn nguồn thanh toán của các cột (10)–(13).