Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.0 - Draft for Community Review
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-06-03 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="vn-validation-rule-cs"/>
<language value="vi"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem vn-validation-rule-cs</b></p><a name="vn-validation-rule-cs"> </a><a name="hcvn-validation-rule-cs"> </a><p><b>Properties</b></p><p><b>This code system defines the following properties for its concepts</b></p><table class="grid"><tr><td><b>Name</b></td><td><b>Code</b></td><td><b>URI</b></td><td><b>Type</b></td><td><b>Description</b></td></tr><tr><td>severity</td><td>severity</td><td>http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#severity</td><td>string</td><td>Mức độ trả về trong OperationOutcome: error | warning | information</td></tr><tr><td>tier</td><td>tier</td><td>http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#tier</td><td>string</td><td>Tầng kiểm tra: tier-1 (FHIRPath invariant), tier-2 (server-side), tier-3 (business rule)</td></tr><tr><td>category</td><td>category</td><td>http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#category</td><td>string</td><td>Phân loại căn cứ: normative-data-standard | legal-business-rule | profile-conformance | technical-quality-guardrail | source-exception</td></tr><tr><td>expression</td><td>expression</td><td>http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#expression</td><td>string</td><td>Biểu thức FHIRPath hoặc tóm tắt quy tắc kiểm tra</td></tr><tr><td>invariant</td><td>invariant</td><td>http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#invariant</td><td>string</td><td>Tên FHIRPath invariant tương ứng trong profile (nếu là tier-1)</td></tr><tr><td>legalBasis</td><td>legalBasis</td><td>http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#legalBasis</td><td>string</td><td>Căn cứ pháp lý/chuẩn dữ liệu cho quy tắc</td></tr></table><p><b>Concepts</b></p><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs</code> defines the following codes:</p><table class="codes"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>severity</b></td><td><b>tier</b></td><td><b>category</b></td><td><b>expression</b></td><td><b>invariant</b></td><td><b>legalBasis</b></td><td><b>English (English, en)</b></td></tr><tr><td style="white-space:nowrap">VN-RULE-PAT-001<a name="vn-validation-rule-cs-VN-RULE-PAT-001"> </a></td><td>Số CCCD phải đúng 12 chữ số</td><td>Giá trị identifier[CCCD] phải khớp [0-9]{12}. Sửa: chuẩn hóa số CCCD 12 số; nếu là CMND cũ 9 số dùng slice/identifier khác.</td><td>error</td><td>tier-1</td><td>normative-data-standard</td><td>Patient.identifier.where(system='.../sid/cccd').value.matches('[0-9]{12}')</td><td>vn-cccd-format</td><td>Luật Căn cước 2023 Điều 20</td><td>CCCD number must be exactly 12 digits</td></tr><tr><td style="white-space:nowrap">VN-RULE-PAT-002<a name="vn-validation-rule-cs-VN-RULE-PAT-002"> </a></td><td>Chữ số thứ 4 của CCCD không phù hợp giới tính</td><td>Chữ số thứ 4 mã hóa giới tính/thế kỷ: nam→chẵn, nữ→lẻ. Cảnh báo vì có thể có ca chuyển giới chưa cập nhật CCCD. Kiểm tra phía server.</td><td>warning</td><td>tier-2</td><td>technical-quality-guardrail</td><td/><td/><td>Luật Căn cước 2023</td><td>The 4th digit of CCCD does not match gender</td></tr><tr><td style="white-space:nowrap">VN-RULE-PAT-003<a name="vn-validation-rule-cs-VN-RULE-PAT-003"> </a></td><td>Mã xã/phường không thuộc tỉnh/TP đã chọn</td><td>Khi có cả extension[province] và extension[ward], mã xã (5 số) phải thuộc tỉnh (2 số). Tra bảng ĐVHC theo thời điểm hiệu lực. Kiểm tra phía server.</td><td>error</td><td>tier-2</td><td>normative-data-standard</td><td/><td/><td>QĐ 19/2025/QĐ-TTg; NQ 202/2025/QH15</td><td>Commune/ward code is not within selected province/city</td></tr><tr><td style="white-space:nowrap">VN-RULE-PAT-004<a name="vn-validation-rule-cs-VN-RULE-PAT-004"> </a></td><td>Cấp cứu: cho phép Patient chỉ có identifier tạm</td><td>Trong cấp cứu, KHÔNG chặn tạo hồ sơ vì thiếu CCCD. Cho phép POST Patient với identifier tạm (use=temp) để xử trí trước, định danh sau. Quy tắc cho phép (permissive), không phải lỗi.</td><td>information</td><td>tier-3</td><td>profile-conformance</td><td/><td/><td>QĐ 01/2008/QĐ-BYT (cấp cứu xử trí trước)</td><td>Emergency: allow Patient to have only a temporary identifier</td></tr><tr><td style="white-space:nowrap">VN-RULE-PAT-005<a name="vn-validation-rule-cs-VN-RULE-PAT-005"> </a></td><td>Hợp nhất hồ sơ phải dùng Patient.link, không tạo định danh trùng</td><td>Khi merge hồ sơ tạm với hồ sơ CCCD chính thức: dùng Patient.link (replaced-by/replaces), chuyển hồ sơ tạm active=false. KHÔNG xóa cứng, KHÔNG tạo định danh y tế (VHN) trùng. Kiểm tra phía server.</td><td>error</td><td>tier-2</td><td>profile-conformance</td><td/><td/><td/><td>Record merge shall use Patient.link, do not create duplicate identifiers</td></tr><tr><td style="white-space:nowrap">VN-RULE-ADDR-001<a name="vn-validation-rule-cs-VN-RULE-ADDR-001"> </a></td><td>Địa chỉ Việt Nam phải có extension:province</td><td>Địa chỉ có country='VN' nên có extension:province. Sửa: bổ sung mã tỉnh theo VNProvinceCS.</td><td>warning</td><td>tier-1</td><td>profile-conformance</td><td/><td>vn-addr-province</td><td/><td>Vietnam address must include extension:province</td></tr><tr><td style="white-space:nowrap">VN-RULE-ENC-001<a name="vn-validation-rule-cs-VN-RULE-ENC-001"> </a></td><td>Encounter.serviceProvider là bắt buộc</td><td>Lượt khám phải gắn cơ sở KCB chịu trách nhiệm. Sửa: thêm Encounter.serviceProvider trỏ VNCoreOrganization.</td><td>error</td><td>tier-1</td><td>profile-conformance</td><td>Encounter.serviceProvider.exists()</td><td/><td>QĐ 3176/QĐ-BYT</td><td>Encounter.serviceProvider is required</td></tr><tr><td style="white-space:nowrap">VN-RULE-ENC-002<a name="vn-validation-rule-cs-VN-RULE-ENC-002"> </a></td><td>Encounter.period không được chồng lấn cho cùng bệnh nhân</td><td>Trừ encounter lồng nhau, các period của cùng bệnh nhân không nên overlap. Kiểm tra phía server.</td><td>warning</td><td>tier-3</td><td>technical-quality-guardrail</td><td/><td/><td/><td>Encounter.period must not overlap for the same patient</td></tr><tr><td style="white-space:nowrap">VN-RULE-CON-001<a name="vn-validation-rule-cs-VN-RULE-CON-001"> </a></td><td>Mỗi Condition chỉ nên ghi 1 chẩn đoán</td><td>1 resource Condition = 1 mã chẩn đoán (không gộp đa chẩn đoán). Sửa: tách thành nhiều Condition.</td><td>warning</td><td>tier-3</td><td>profile-conformance</td><td/><td/><td/><td>Each Condition should contain only one diagnosis</td></tr><tr><td style="white-space:nowrap">VN-RULE-MED-002<a name="vn-validation-rule-cs-VN-RULE-MED-002"> </a></td><td>Cấp phát ngoại trú/bán lẻ phải có authorizingPrescription</td><td>Không cấp phát 'mồ côi': cấp phát ngoại trú/nhà thuốc bán lẻ (category=outpatient/community) phải trỏ về VNCoreMedicationRequest để bảo toàn chuỗi kê đơn → cấp phát → thanh toán BHYT. Cấp phát nội trú từ tủ trực/khoa Dược nên gắn y lệnh khi có y lệnh tương ứng (vd ExampleMedicationDispenseInpatientAntibiotic → ExampleMedicationRequestCefotaximeInpatient).</td><td>error</td><td>tier-3</td><td>profile-conformance</td><td>MedicationDispense.category.coding.where(code='outpatient' or code='community').exists() implies MedicationDispense.authorizingPrescription.exists()</td><td/><td>TT 26/2025/TT-BYT; QĐ 3176/QĐ-BYT</td><td>Outpatient/retail dispensing must include authorizingPrescription</td></tr><tr><td style="white-space:nowrap">VN-RULE-MED-003<a name="vn-validation-rule-cs-VN-RULE-MED-003"> </a></td><td>MedicationAdministration nên liên kết y lệnh (request)</td><td>Sự kiện dùng thuốc nên trỏ về MedicationRequest để khép chuỗi y lệnh → cấp phát → sử dụng. Sửa: thêm MedicationAdministration.request.</td><td>warning</td><td>tier-3</td><td>profile-conformance</td><td/><td/><td/><td>MedicationAdministration should reference medication request order</td></tr><tr><td style="white-space:nowrap">VN-RULE-CLM-001<a name="vn-validation-rule-cs-VN-RULE-CLM-001"> </a></td><td>Claim phải có đúng 1 thẻ BHYT chính (focal=true)</td><td>Một hồ sơ thanh toán có đúng 1 insurance.focal=true; thẻ bổ trợ dùng focal=false. Sửa: đánh dấu đúng thẻ chính.</td><td>error</td><td>tier-1</td><td>profile-conformance</td><td>Claim.insurance.where(focal=true).count() = 1</td><td/><td>QĐ 697/QĐ-BYT; NĐ 188/2025/NĐ-CP Đ22</td><td>Claim must have exactly one primary health insurance card (focal=true)</td></tr><tr><td style="white-space:nowrap">VN-RULE-CLM-014<a name="vn-validation-rule-cs-VN-RULE-CLM-014"> </a></td><td>Số ngày giường phải khớp số ngày nằm viện</td><td>Số lượng item nhóm chi phí ngày giường (cost-category 2.2) phải khớp số ngày Encounter.period.end − period.start. Kiểm tra phía server.</td><td>error</td><td>tier-2</td><td>legal-business-rule</td><td/><td/><td>QĐ 697/QĐ-BYT</td><td>Number of bed-days must match length of stay</td></tr><tr><td style="white-space:nowrap">VN-RULE-BHYT-001<a name="vn-validation-rule-cs-VN-RULE-BHYT-001"> </a></td><td>Thiếu SO_CCCD nhưng không có mã lý do bất khả kháng</td><td>Khi xuất dữ liệu BHXH (QĐ 3176), SO_CCCD bắt buộc; nếu trống phải có Patient.extension[force-majeure-reason]. Kiểm tra phía server/gateway.</td><td>error</td><td>tier-2</td><td>normative-data-standard</td><td/><td/><td>QĐ 3176/QĐ-BYT</td><td>Missing SO_CCCD without exemption reason code</td></tr><tr><td style="white-space:nowrap">VN-RULE-BHYT-002<a name="vn-validation-rule-cs-VN-RULE-BHYT-002"> </a></td><td>MA_LK phải nhất quán trên toàn bộ hồ sơ gửi</td><td>MA_LK là khóa liên kết hồ sơ một đợt KCB; Claim.identifier[MALK] và Bundle.identifier phải cùng giá trị cho mọi resource liên quan. Kiểm tra phía server.</td><td>error</td><td>tier-2</td><td>normative-data-standard</td><td/><td/><td>QĐ 3176/QĐ-BYT</td><td>MA_LK must be consistent across all submitted records</td></tr><tr><td style="white-space:nowrap">VN-RULE-BHYT-003<a name="vn-validation-rule-cs-VN-RULE-BHYT-003"> </a></td><td>Ngày giờ xuất cổng BHXH phải theo định dạng yyyyMMddHHmm</td><td>Trường ngày giờ xuất/gateway (NGAY_VAO, NGAY_RA, NGAY_YL...) phải đúng yyyyMMddHHmm ở lớp export. Kiểm tra phía server/gateway.</td><td>error</td><td>tier-2</td><td>normative-data-standard</td><td/><td/><td>QĐ 3176/QĐ-BYT</td><td>BHXH discharge timestamp must follow format yyyyMMddHHmm</td></tr><tr><td style="white-space:nowrap">VN-RULE-BDL-001<a name="vn-validation-rule-cs-VN-RULE-BDL-001"> </a></td><td>Mỗi entry trong transaction Bundle phải có request.method và request.url</td><td>Bundle.type=transaction yêu cầu mỗi entry có request.method + request.url (FHIR bdl-3). Sửa: bổ sung request cho mọi entry.</td><td>error</td><td>tier-1</td><td>profile-conformance</td><td>Bundle.where(type='transaction').entry.all(request.method.exists() and request.url.exists())</td><td/><td>FHIR R4 bdl-3; NĐ 164/2025/NĐ-CP</td><td>Each entry in a transaction Bundle must have request.method and request.url</td></tr><tr><td style="white-space:nowrap">VN-RULE-TERM-001<a name="vn-validation-rule-cs-VN-RULE-TERM-001"> </a></td><td>Mã không thuộc ValueSet có binding required</td><td>Mã coding không nằm trong ValueSet ràng buộc required của phần tử. Sửa: dùng mã hợp lệ từ ValueSet (vd ICD-10 VN, nhóm chi phí QĐ 697).</td><td>error</td><td>tier-1</td><td>normative-data-standard</td><td/><td/><td/><td>Code not in required-bound ValueSet</td></tr></table></div>
</text>
<url value="http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs"/>
<version value="0.6.0"/>
<name value="VNValidationRuleCS"/>
<title
value="Registry quy tắc kiểm tra hợp lệ VN Core — VN Core Validation Rule Registry"/>
<status value="draft"/>
<experimental value="false"/>
<date value="2026-06-03"/>
<publisher value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<contact>
<name value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<telecom>
<system value="url"/>
<value value="https://hl7.org.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="info@hl7.org.vn"/>
</telecom>
</contact>
<contact>
<name value="Omi HealthTech (OmiGroup)"/>
<telecom>
<system value="url"/>
<value value="https://omihealthtech.vn"/>
</telecom>
<telecom>
<system value="url"/>
<value value="https://omigroup.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="info@hl7.org.vn"/>
</telecom>
</contact>
<description
value="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ệ](validation-guidance.html) (chi tiết 3 tầng) và [OperationOutcome & Registry quy tắc](validation-and-operationoutcome.html) (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."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<caseSensitive value="true"/>
<content value="complete"/>
<count value="18"/>
<property>
<code value="severity"/>
<uri
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#severity"/>
<description
value="Mức độ trả về trong OperationOutcome: error | warning | information"/>
<type value="string"/>
</property>
<property>
<code value="tier"/>
<uri
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#tier"/>
<description
value="Tầng kiểm tra: tier-1 (FHIRPath invariant), tier-2 (server-side), tier-3 (business rule)"/>
<type value="string"/>
</property>
<property>
<code value="category"/>
<uri
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#category"/>
<description
value="Phân loại căn cứ: normative-data-standard | legal-business-rule | profile-conformance | technical-quality-guardrail | source-exception"/>
<type value="string"/>
</property>
<property>
<code value="expression"/>
<uri
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#expression"/>
<description value="Biểu thức FHIRPath hoặc tóm tắt quy tắc kiểm tra"/>
<type value="string"/>
</property>
<property>
<code value="invariant"/>
<uri
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#invariant"/>
<description
value="Tên FHIRPath invariant tương ứng trong profile (nếu là tier-1)"/>
<type value="string"/>
</property>
<property>
<code value="legalBasis"/>
<uri
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-validation-rule-cs#legalBasis"/>
<description value="Căn cứ pháp lý/chuẩn dữ liệu cho quy tắc"/>
<type value="string"/>
</property>
<concept>
<code value="VN-RULE-PAT-001"/>
<display value="Số CCCD phải đúng 12 chữ số"/>
<definition
value="Giá trị identifier[CCCD] phải khớp [0-9]{12}. Sửa: chuẩn hóa số CCCD 12 số; nếu là CMND cũ 9 số dùng slice/identifier khác."/>
<designation>
<language value="en"/>
<value value="CCCD number must be exactly 12 digits"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-1"/>
</property>
<property>
<code value="category"/>
<valueString value="normative-data-standard"/>
</property>
<property>
<code value="expression"/>
<valueString
value="Patient.identifier.where(system='.../sid/cccd').value.matches('[0-9]{12}')"/>
</property>
<property>
<code value="invariant"/>
<valueString value="vn-cccd-format"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="Luật Căn cước 2023 Điều 20"/>
</property>
</concept>
<concept>
<code value="VN-RULE-PAT-002"/>
<display value="Chữ số thứ 4 của CCCD không phù hợp giới tính"/>
<definition
value="Chữ số thứ 4 mã hóa giới tính/thế kỷ: nam→chẵn, nữ→lẻ. Cảnh báo vì có thể có ca chuyển giới chưa cập nhật CCCD. Kiểm tra phía server."/>
<designation>
<language value="en"/>
<value value="The 4th digit of CCCD does not match gender"/>
</designation>
<property>
<code value="severity"/>
<valueString value="warning"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-2"/>
</property>
<property>
<code value="category"/>
<valueString value="technical-quality-guardrail"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="Luật Căn cước 2023"/>
</property>
</concept>
<concept>
<code value="VN-RULE-PAT-003"/>
<display value="Mã xã/phường không thuộc tỉnh/TP đã chọn"/>
<definition
value="Khi có cả extension[province] và extension[ward], mã xã (5 số) phải thuộc tỉnh (2 số). Tra bảng ĐVHC theo thời điểm hiệu lực. Kiểm tra phía server."/>
<designation>
<language value="en"/>
<value value="Commune/ward code is not within selected province/city"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-2"/>
</property>
<property>
<code value="category"/>
<valueString value="normative-data-standard"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="QĐ 19/2025/QĐ-TTg; NQ 202/2025/QH15"/>
</property>
</concept>
<concept>
<code value="VN-RULE-PAT-004"/>
<display value="Cấp cứu: cho phép Patient chỉ có identifier tạm"/>
<definition
value="Trong cấp cứu, KHÔNG chặn tạo hồ sơ vì thiếu CCCD. Cho phép POST Patient với identifier tạm (use=temp) để xử trí trước, định danh sau. Quy tắc cho phép (permissive), không phải lỗi."/>
<designation>
<language value="en"/>
<value
value="Emergency: allow Patient to have only a temporary identifier"/>
</designation>
<property>
<code value="severity"/>
<valueString value="information"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-3"/>
</property>
<property>
<code value="category"/>
<valueString value="profile-conformance"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="QĐ 01/2008/QĐ-BYT (cấp cứu xử trí trước)"/>
</property>
</concept>
<concept>
<code value="VN-RULE-PAT-005"/>
<display
value="Hợp nhất hồ sơ phải dùng Patient.link, không tạo định danh trùng"/>
<definition
value="Khi merge hồ sơ tạm với hồ sơ CCCD chính thức: dùng Patient.link (replaced-by/replaces), chuyển hồ sơ tạm active=false. KHÔNG xóa cứng, KHÔNG tạo định danh y tế (VHN) trùng. Kiểm tra phía server."/>
<designation>
<language value="en"/>
<value
value="Record merge shall use Patient.link, do not create duplicate identifiers"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-2"/>
</property>
<property>
<code value="category"/>
<valueString value="profile-conformance"/>
</property>
</concept>
<concept>
<code value="VN-RULE-ADDR-001"/>
<display value="Địa chỉ Việt Nam phải có extension:province"/>
<definition
value="Địa chỉ có country='VN' nên có extension:province. Sửa: bổ sung mã tỉnh theo VNProvinceCS."/>
<designation>
<language value="en"/>
<value value="Vietnam address must include extension:province"/>
</designation>
<property>
<code value="severity"/>
<valueString value="warning"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-1"/>
</property>
<property>
<code value="category"/>
<valueString value="profile-conformance"/>
</property>
<property>
<code value="invariant"/>
<valueString value="vn-addr-province"/>
</property>
</concept>
<concept>
<code value="VN-RULE-ENC-001"/>
<display value="Encounter.serviceProvider là bắt buộc"/>
<definition
value="Lượt khám phải gắn cơ sở KCB chịu trách nhiệm. Sửa: thêm Encounter.serviceProvider trỏ VNCoreOrganization."/>
<designation>
<language value="en"/>
<value value="Encounter.serviceProvider is required"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-1"/>
</property>
<property>
<code value="category"/>
<valueString value="profile-conformance"/>
</property>
<property>
<code value="expression"/>
<valueString value="Encounter.serviceProvider.exists()"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="QĐ 3176/QĐ-BYT"/>
</property>
</concept>
<concept>
<code value="VN-RULE-ENC-002"/>
<display
value="Encounter.period không được chồng lấn cho cùng bệnh nhân"/>
<definition
value="Trừ encounter lồng nhau, các period của cùng bệnh nhân không nên overlap. Kiểm tra phía server."/>
<designation>
<language value="en"/>
<value value="Encounter.period must not overlap for the same patient"/>
</designation>
<property>
<code value="severity"/>
<valueString value="warning"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-3"/>
</property>
<property>
<code value="category"/>
<valueString value="technical-quality-guardrail"/>
</property>
</concept>
<concept>
<code value="VN-RULE-CON-001"/>
<display value="Mỗi Condition chỉ nên ghi 1 chẩn đoán"/>
<definition
value="1 resource Condition = 1 mã chẩn đoán (không gộp đa chẩn đoán). Sửa: tách thành nhiều Condition."/>
<designation>
<language value="en"/>
<value value="Each Condition should contain only one diagnosis"/>
</designation>
<property>
<code value="severity"/>
<valueString value="warning"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-3"/>
</property>
<property>
<code value="category"/>
<valueString value="profile-conformance"/>
</property>
</concept>
<concept>
<code value="VN-RULE-MED-002"/>
<display
value="Cấp phát ngoại trú/bán lẻ phải có authorizingPrescription"/>
<definition
value="Không cấp phát 'mồ côi': cấp phát ngoại trú/nhà thuốc bán lẻ (category=outpatient/community) phải trỏ về VNCoreMedicationRequest để bảo toàn chuỗi kê đơn → cấp phát → thanh toán BHYT. Cấp phát nội trú từ tủ trực/khoa Dược nên gắn y lệnh khi có y lệnh tương ứng (vd ExampleMedicationDispenseInpatientAntibiotic → ExampleMedicationRequestCefotaximeInpatient)."/>
<designation>
<language value="en"/>
<value
value="Outpatient/retail dispensing must include authorizingPrescription"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-3"/>
</property>
<property>
<code value="category"/>
<valueString value="profile-conformance"/>
</property>
<property>
<code value="expression"/>
<valueString
value="MedicationDispense.category.coding.where(code='outpatient' or code='community').exists() implies MedicationDispense.authorizingPrescription.exists()"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="TT 26/2025/TT-BYT; QĐ 3176/QĐ-BYT"/>
</property>
</concept>
<concept>
<code value="VN-RULE-MED-003"/>
<display value="MedicationAdministration nên liên kết y lệnh (request)"/>
<definition
value="Sự kiện dùng thuốc nên trỏ về MedicationRequest để khép chuỗi y lệnh → cấp phát → sử dụng. Sửa: thêm MedicationAdministration.request."/>
<designation>
<language value="en"/>
<value
value="MedicationAdministration should reference medication request order"/>
</designation>
<property>
<code value="severity"/>
<valueString value="warning"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-3"/>
</property>
<property>
<code value="category"/>
<valueString value="profile-conformance"/>
</property>
</concept>
<concept>
<code value="VN-RULE-CLM-001"/>
<display value="Claim phải có đúng 1 thẻ BHYT chính (focal=true)"/>
<definition
value="Một hồ sơ thanh toán có đúng 1 insurance.focal=true; thẻ bổ trợ dùng focal=false. Sửa: đánh dấu đúng thẻ chính."/>
<designation>
<language value="en"/>
<value
value="Claim must have exactly one primary health insurance card (focal=true)"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-1"/>
</property>
<property>
<code value="category"/>
<valueString value="profile-conformance"/>
</property>
<property>
<code value="expression"/>
<valueString value="Claim.insurance.where(focal=true).count() = 1"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="QĐ 697/QĐ-BYT; NĐ 188/2025/NĐ-CP Đ22"/>
</property>
</concept>
<concept>
<code value="VN-RULE-CLM-014"/>
<display value="Số ngày giường phải khớp số ngày nằm viện"/>
<definition
value="Số lượng item nhóm chi phí ngày giường (cost-category 2.2) phải khớp số ngày Encounter.period.end − period.start. Kiểm tra phía server."/>
<designation>
<language value="en"/>
<value value="Number of bed-days must match length of stay"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-2"/>
</property>
<property>
<code value="category"/>
<valueString value="legal-business-rule"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="QĐ 697/QĐ-BYT"/>
</property>
</concept>
<concept>
<code value="VN-RULE-BHYT-001"/>
<display value="Thiếu SO_CCCD nhưng không có mã lý do bất khả kháng"/>
<definition
value="Khi xuất dữ liệu BHXH (QĐ 3176), SO_CCCD bắt buộc; nếu trống phải có Patient.extension[force-majeure-reason]. Kiểm tra phía server/gateway."/>
<designation>
<language value="en"/>
<value value="Missing SO_CCCD without exemption reason code"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-2"/>
</property>
<property>
<code value="category"/>
<valueString value="normative-data-standard"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="QĐ 3176/QĐ-BYT"/>
</property>
</concept>
<concept>
<code value="VN-RULE-BHYT-002"/>
<display value="MA_LK phải nhất quán trên toàn bộ hồ sơ gửi"/>
<definition
value="MA_LK là khóa liên kết hồ sơ một đợt KCB; Claim.identifier[MALK] và Bundle.identifier phải cùng giá trị cho mọi resource liên quan. Kiểm tra phía server."/>
<designation>
<language value="en"/>
<value value="MA_LK must be consistent across all submitted records"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-2"/>
</property>
<property>
<code value="category"/>
<valueString value="normative-data-standard"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="QĐ 3176/QĐ-BYT"/>
</property>
</concept>
<concept>
<code value="VN-RULE-BHYT-003"/>
<display
value="Ngày giờ xuất cổng BHXH phải theo định dạng yyyyMMddHHmm"/>
<definition
value="Trường ngày giờ xuất/gateway (NGAY_VAO, NGAY_RA, NGAY_YL...) phải đúng yyyyMMddHHmm ở lớp export. Kiểm tra phía server/gateway."/>
<designation>
<language value="en"/>
<value
value="BHXH discharge timestamp must follow format yyyyMMddHHmm"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-2"/>
</property>
<property>
<code value="category"/>
<valueString value="normative-data-standard"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="QĐ 3176/QĐ-BYT"/>
</property>
</concept>
<concept>
<code value="VN-RULE-BDL-001"/>
<display
value="Mỗi entry trong transaction Bundle phải có request.method và request.url"/>
<definition
value="Bundle.type=transaction yêu cầu mỗi entry có request.method + request.url (FHIR bdl-3). Sửa: bổ sung request cho mọi entry."/>
<designation>
<language value="en"/>
<value
value="Each entry in a transaction Bundle must have request.method and request.url"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-1"/>
</property>
<property>
<code value="category"/>
<valueString value="profile-conformance"/>
</property>
<property>
<code value="expression"/>
<valueString
value="Bundle.where(type='transaction').entry.all(request.method.exists() and request.url.exists())"/>
</property>
<property>
<code value="legalBasis"/>
<valueString value="FHIR R4 bdl-3; NĐ 164/2025/NĐ-CP"/>
</property>
</concept>
<concept>
<code value="VN-RULE-TERM-001"/>
<display value="Mã không thuộc ValueSet có binding required"/>
<definition
value="Mã coding không nằm trong ValueSet ràng buộc required của phần tử. Sửa: dùng mã hợp lệ từ ValueSet (vd ICD-10 VN, nhóm chi phí QĐ 697)."/>
<designation>
<language value="en"/>
<value value="Code not in required-bound ValueSet"/>
</designation>
<property>
<code value="severity"/>
<valueString value="error"/>
</property>
<property>
<code value="tier"/>
<valueString value="tier-1"/>
</property>
<property>
<code value="category"/>
<valueString value="normative-data-standard"/>
</property>
</concept>
</CodeSystem>