| Code | Display | Definition | severity | tier | category | expression | invariant | legalBasis | English (English, en) |
| VN-RULE-PAT-001 | Số CCCD phải đúng 12 chữ số | 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. | error | tier-1 | normative-data-standard | Patient.identifier.where(system='.../sid/cccd').value.matches('[0-9]{12}') | vn-cccd-format | Luật Căn cước 2023 Điều 20 | CCCD number must be exactly 12 digits |
| VN-RULE-PAT-002 | Chữ số thứ 4 của CCCD không phù hợp giới tính | 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. | warning | tier-2 | technical-quality-guardrail | | | Luật Căn cước 2023 | The 4th digit of CCCD does not match gender |
| VN-RULE-PAT-003 | Mã xã/phường không thuộc tỉnh/TP đã chọn | 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. | error | tier-2 | normative-data-standard | | | QĐ 19/2025/QĐ-TTg; NQ 202/2025/QH15 | Commune/ward code is not within selected province/city |
| VN-RULE-PAT-004 | Cấp cứu: cho phép Patient chỉ có identifier tạm | 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. | information | tier-3 | profile-conformance | | | QĐ 01/2008/QĐ-BYT (cấp cứu xử trí trước) | Emergency: allow Patient to have only a temporary identifier |
| VN-RULE-PAT-005 | Hợp nhất hồ sơ phải dùng Patient.link, không tạo định danh trùng | 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. | error | tier-2 | profile-conformance | | | | Record merge shall use Patient.link, do not create duplicate identifiers |
| VN-RULE-ADDR-001 | Địa chỉ Việt Nam phải có extension:province | Địa chỉ có country='VN' nên có extension:province. Sửa: bổ sung mã tỉnh theo VNProvinceCS. | warning | tier-1 | profile-conformance | | vn-addr-province | | Vietnam address must include extension:province |
| VN-RULE-ENC-001 | Encounter.serviceProvider là bắt buộc | 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. | error | tier-1 | profile-conformance | Encounter.serviceProvider.exists() | | QĐ 3176/QĐ-BYT | Encounter.serviceProvider is required |
| VN-RULE-ENC-002 | Encounter.period không được chồng lấn cho cùng bệnh nhân | 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. | warning | tier-3 | technical-quality-guardrail | | | | Encounter.period must not overlap for the same patient |
| VN-RULE-CON-001 | Mỗi Condition chỉ nên ghi 1 chẩn đoán | 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. | warning | tier-3 | profile-conformance | | | | Each Condition should contain only one diagnosis |
| VN-RULE-MED-002 | Cấp phát ngoại trú/bán lẻ phải có authorizingPrescription | 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). | error | tier-3 | profile-conformance | MedicationDispense.category.coding.where(code='outpatient' or code='community').exists() implies MedicationDispense.authorizingPrescription.exists() | | TT 26/2025/TT-BYT; QĐ 3176/QĐ-BYT | Outpatient/retail dispensing must include authorizingPrescription |
| VN-RULE-MED-003 | MedicationAdministration nên liên kết y lệnh (request) | 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. | warning | tier-3 | profile-conformance | | | | MedicationAdministration should reference medication request order |
| VN-RULE-CLM-001 | Claim phải có đúng 1 thẻ BHYT chính (focal=true) | 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. | error | tier-1 | profile-conformance | Claim.insurance.where(focal=true).count() = 1 | | QĐ 697/QĐ-BYT; NĐ 188/2025/NĐ-CP Đ22 | Claim must have exactly one primary health insurance card (focal=true) |
| VN-RULE-CLM-014 | Số ngày giường phải khớp số ngày nằm viện | 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. | error | tier-2 | legal-business-rule | | | QĐ 697/QĐ-BYT | Number of bed-days must match length of stay |
| VN-RULE-BHYT-001 | Thiếu SO_CCCD nhưng không có mã lý do bất khả kháng | 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. | error | tier-2 | normative-data-standard | | | QĐ 3176/QĐ-BYT | Missing SO_CCCD without exemption reason code |
| VN-RULE-BHYT-002 | MA_LK phải nhất quán trên toàn bộ hồ sơ gửi | 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. | error | tier-2 | normative-data-standard | | | QĐ 3176/QĐ-BYT | MA_LK must be consistent across all submitted records |
| VN-RULE-BHYT-003 | Ngày giờ xuất cổng BHXH phải theo định dạng yyyyMMddHHmm | 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. | error | tier-2 | normative-data-standard | | | QĐ 3176/QĐ-BYT | BHXH discharge timestamp must follow format yyyyMMddHHmm |
| VN-RULE-BDL-001 | Mỗi entry trong transaction Bundle phải có request.method và request.url | 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. | error | tier-1 | profile-conformance | Bundle.where(type='transaction').entry.all(request.method.exists() and request.url.exists()) | | FHIR R4 bdl-3; NĐ 164/2025/NĐ-CP | Each entry in a transaction Bundle must have request.method and request.url |
| VN-RULE-TERM-001 | Mã không thuộc ValueSet có binding required | 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). | error | tier-1 | normative-data-standard | | | | Code not in required-bound ValueSet |