Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.0 - Draft for Community Review
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Phiên bản 0.5.0 công bố 52 profiles. Chi tiết ràng buộc, ví dụ và Must Support đọc trực tiếp tại từng artifact, cùng với Phần mở rộng và Hướng dẫn Must Support.
VN Core hiện tại giữ các nguyên tắc sau:
IPS, rồi mới localize;VN Core tiếp tục phân lớp Observation để tránh dồn nhiều semantics khác nhau vào một hồ sơ:
lab, pathology, radiology, vital signs, structured exam, social history khi đã có nhu cầu và căn cứ rõ;Observation phình to, ôm nhiều semantics không tương thích.VN Core IG định nghĩa 52 profiles trên FHIR R4 resources, chia thành 6 nhóm:
| Nhóm | Hồ sơ | Số lượng |
|---|---|---|
| Hành chính (Administrative) | Patient, RelatedPerson, Practitioner, PractitionerRole, Organization, OrganizationDepartment, Location, Address, HealthcareService | 9 |
| Lâm sàng (Clinical) | Encounter, Condition, ConditionDiagnosis, Observation (10: Lab, VitalSigns, YHCT, BloodPressure, HeartRate, BodyTemperature, BodyWeight, BodyHeight, RespiratoryRate, SpO2), AllergyIntolerance, Procedure, MedicationRequest, MedicationDispense, Medication, Immunization, ServiceRequest, Specimen, ImagingStudy | 22 |
| Tài chính (Financial) | Coverage, Claim, ClaimResponse, ExplanationOfBenefit, PaymentReconciliation | 5 |
| Tài liệu và quản trị dữ liệu (Documents & Governance) | Consent, Composition, CompositionBreachNotification, DocumentReference, DiagnosticReport, DiagnosticReportLab, DiagnosticReportImaging, DiagnosticReportPathology, AuditEvent, Provenance | 10 |
| Luồng nghiệp vụ và trao đổi (Workflow & Exchange) | Bundle, BHYTSubmissionBundle, EndpointBHYT | 3 |
| Trang thiết bị (Device) | Device, ImplantableDevice, DeviceUseStatement | 3 |
| Profile | Resource gốc | Căn cứ | Must Support chính | Examples |
|---|---|---|---|---|
| VNCorePatient | Patient | TT 13/2025, Luật Căn cước 2023, 121/TCTK-PPCĐ, QĐ 34/2020 | identifier[CCCD], identifier[BHYT], identifier[BHXH], name, gender, birthDate, address |
Đầy đủ, Tối thiểu, Bệnh nhi, Nước ngoài |
| VNCoreRelatedPerson | RelatedPerson | TT 13/2025, Luật BHYT, Luật 91/2025 | patient, relationship, identifier, name |
Mẹ bệnh nhi |
| VNCorePractitioner | Practitioner | Luật KCB 2023, TT 13/2025, NĐ 96/2023 | identifier[GPHN], name, qualification |
BS CKII, Tối thiểu |
| VNCorePractitionerRole | PractitionerRole | TT 41/2025, TT 02/2025, TT 32/2023 | practitioner, organization, location, code |
Nội khoa, Tim mạch |
| VNCoreOrganization | Organization | Luật KCB 2023, NĐ 96/2023, TT 06/2024 | identifier[CSKCB], name, type |
BV Chợ Rẫy, Trạm YT, PK tư nhân, TTYT, CDC, Legacy |
| VNCoreOrganizationDepartment | Organization | QĐ 2010/QĐ-BYT Phụ lục 6 — 54 mã khoa | identifier[departmentCode] (K01-K53, K99), identifier[localCode], type = #dept, name, partOf → VNCoreOrganization |
Khoa Tim mạch, Khoa CĐHA |
| VNCoreLocation | Location | TT 13/2025, Luật KCB 2023 | identifier, status, name, type, managingOrganization |
Khoa Tim mạch, KNT Ngọc Hà, Phòng khám 1 |
| VNCoreHealthcareService | HealthcareService | VBHN 06/2026/VBHN-BYT, Luật KCB 2023, Luật 72/2025 | providedBy, category, type, name, location |
— |
| VNCoreAddress | Address | NQ 202/2025 | — (datatype profile) | Xem Patient examples |
VNCoreOrganizationDepartment kế thừa trực tiếp từ FHIR Organization, không kế thừa VNCoreOrganization, để giữ semantics khoa/phòng rõ ràng qua partOf bắt buộc tới cơ sở y tế chủ quản.
Extensions dùng trong nhóm: VNCoreExtEthnicity, VNCoreExtOccupation, VNCoreExtForceMajeureReason, VNCoreExtProvince, VNCoreExtWard, VNCoreExtOrgRank, VNCoreExtHealthUnitRank, VNCoreExtOrgRankStatus, VNCoreExtOrgLevel, VNCoreExtOrgType, VNCoreExtFacilityCareLevel, VNCoreExtLegacyTechnicalLine, VNCoreExtQualityScoreBand, cùng HL7 extensions patient-religion, patient-citizenship, patient-birthPlace.
| Profile | Resource gốc | Căn cứ | Must Support chính | Examples |
|---|---|---|---|---|
| VNCoreEncounter | Encounter | QĐ 3176/QĐ-BYT, TT 13/2025, Luật BHYT | status, class, subject, period, reasonCode |
Ngoại trú, Nội trú |
| VNCoreCondition | Condition | QĐ 4469/2020, QĐ 2552/2025 | code, subject, encounter |
Viêm ruột thừa, ĐTĐ, Viêm phổi, YHCT |
| VNCoreObservationLab | Observation | QĐ 1227/2025, TT 13/2025 | code, value[x], subject, status |
Glucose |
| VNCoreObservationVitalSigns | Observation | TT 13/2025 | code, value[x], subject, status, effectiveDateTime |
Sinh hiệu |
| VNCoreObservationYHCT | Observation | QĐ 2552/2025, QĐ 3080/2025 | code, value[x], subject, status |
Mạch chẩn |
| VNCoreAllergyIntolerance | AllergyIntolerance | QĐ 2805/2025 | code, patient, clinicalStatus |
Penicillin |
| VNCoreProcedure | Procedure | QĐ 387/QĐ-BYT (2026), TT 23/2024, US Core implantable pattern | code, subject, status, focalDevice khi thủ thuật thao tác trên thiết bị |
Cắt ruột thừa, Đặt stent mạch vành, Tháo lưới lọc TMC |
| VNCoreMedicationRequest | MedicationRequest | TT 13/2025, QĐ 3176, Luật Dược 2016 | status, intent, medication[x], subject, authoredOn, requester, dosageInstruction |
Amoxicillin |
| VNCoreMedicationDispense | MedicationDispense | Luật Dược 105/2016 Điều 74, Luật 44/2024, NĐ 163/2025, TT 26/2025 | status, medicationCodeableConcept, subject → VNCorePatient, authorizingPrescription → VNCoreMedicationRequest, whenHandedOver |
Ngoại trú BHYT, Nội trú |
| VNCoreMedication | Medication | Luật Dược 2016, QĐ 3176 | code, status |
Amoxicillin 500mg |
| VNCoreServiceRequest | ServiceRequest | TT 13/2025, TT 20/2014, QĐ 3176 | status, intent, category, code, subject, requester |
XN đường huyết, X-quang ngực |
| VNCoreSpecimen | Specimen | TT 13/2025, QĐ 1227 | identifier, status, type, subject, receivedTime, request, collection |
Huyết thanh, Máu CBC, Nước tiểu |
| VNCoreImagingStudy | ImagingStudy | QĐ 1227/QĐ-BYT, QĐ 2427/QĐ-BYT | identifier[studyInstanceUID], status, modality, subject, procedureCode, series.bodySite |
CT ngực, Siêu âm bụng |
Extensions dùng trong nhóm: VNCoreExtInsuranceVisitType, VNCoreExtReferralMode, VNCoreExtEncounterCode, VNCoreExtTreatmentOutcome, VNCoreExtMedRegNumber.
| Profile | Resource gốc | Căn cứ | Must Support chính | Examples |
|---|---|---|---|---|
| VNCoreCoverage | Coverage | Luật BHYT, NĐ 188/2025, QĐ 3176 | identifier[BHYT], beneficiary, subscriber, status, type |
BHYT mới, BHYT cũ, Trẻ em, Liên kết người đại diện |
| VNCoreClaim | Claim | QĐ 3176, QĐ 697, NĐ 188/2025, Luật BHYT | status, type, use, patient, provider, insurance, diagnosis, item, total |
BHYT nội trú |
| VNCoreClaimResponse | ClaimResponse | QĐ 3176, QĐ 697 | status, type, use, patient, outcome |
Phản hồi BHYT |
| VNCoreExplanationOfBenefit | ExplanationOfBenefit | QĐ 697, NĐ 188/2025 | status, type, use, patient, outcome, insurance |
EOB BHYT, Trẻ em |
| VNCorePaymentReconciliation | PaymentReconciliation | TT 12/2026/TT-BTC, NĐ 188/2025, NĐ 164/2025, Luật 51/2024 | period, created, paymentIssuer, outcome, detail, paymentAmount |
— |
Extensions dùng trong nhóm: VNCoreExtBHYTCardType, VNCoreExtPrimaryCareFacility, VNCoreExtClaimCostSummary, VNCoreExtClaimItemDepartment, VNCoreExtClaimPaymentPeriod, VNCoreExtInsuranceCostInfo, VNCoreExtDeviceGroup, VNCoreExtDeviceInsuranceScope, VNCoreExtPaymentMethod, VNCoreExtOrderDate.
| Profile | Resource gốc | Căn cứ | Must Support chính | Examples |
|---|---|---|---|---|
| VNCoreConsent | Consent | Luật 91/2025, NĐ 356/2025 | status, category, patient, dateTime, provision |
Đồng ý, Qua cha mẹ, Từ chối |
| VNCoreComposition | Composition | TT 13/2025, NĐ 137/2024 | identifier, status, type, subject, date, author, title, section |
BAĐT, Tóm tắt ra viện |
| VNCoreCompositionBreachNotification | Composition | Luật 91/2025, NĐ 356/2025, Luật 116/2025 | subject, author, attester, section[organizationInfo], section[breachDescription], section[commitment] |
— |
| VNCoreDocumentReference | DocumentReference | TT 13/2025, NĐ 137/2024, QĐ 1332, Luật 91/2025 | status, type, subject, author, custodian, content |
BAĐT |
| VNCoreDiagnosticReport | DiagnosticReport | TT 13/2025, QĐ 1227/2025, QĐ 697/QĐ-BYT | status, code, subject, result, category slicing open on coding.code |
Kết quả XN |
| VNCoreDiagnosticReportLab | DiagnosticReport | QĐ 3148/QĐ-BYT, QĐ 1227/QĐ-BYT, QĐ 697/QĐ-BYT | category = LAB, nhóm chi phí XN, specimen, result, presentedForm |
Báo cáo XN |
| VNCoreDiagnosticReportImaging | DiagnosticReport | QĐ 1227/QĐ-BYT, TT 23/2024, QĐ 697/QĐ-BYT | category = RAD, imagingStudy → VNCoreImagingStudy, resultsInterpreter, media, specimen 0..0 |
Báo cáo CĐHA |
| VNCoreDiagnosticReportPathology | DiagnosticReport | QĐ 1227/QĐ-BYT, QĐ 2427/QĐ-BYT, QĐ 2493/QĐ-BYT | category = PAT, specimen 1..*, conclusionCode extensible → VNMorphologyVS |
Báo cáo GPB |
| VNCoreAuditEvent | AuditEvent | Luật 91/2025, NĐ 356/2025, Luật KCB 2023 | type, recorded, agent, source, entity |
Audit truy cập |
| VNCoreProvenance | Provenance | TT 13/2025, NĐ 137/2024, Luật 91/2025 | target, recorded, agent, signature |
Chữ ký số BAĐT |
Từ v0.4, VNCoreDiagnosticReport là parent cho 3 sub-profiles Lab, Imaging và Pathology theo pattern JP Core. category dùng slicing open trên coding.code để vừa giữ mã HL7 v2-0074 (LAB, RAD, PAT) vừa cho phép thêm nhóm chi phí theo QĐ 697/QĐ-BYT.
| Profile | Resource gốc | Căn cứ | Must Support chính | Examples |
|---|---|---|---|---|
| VNCoreBundle | Bundle | TT 13/2025, QĐ 3176, NĐ 164/2025 | type, timestamp, entry, entry.resource |
Ngoại trú BHYT, XN |
| VNCoreBHYTSubmissionBundle | Bundle | QĐ 3176, QĐ 697, NĐ 164/2025 | type, timestamp, identifier, entry |
Ngoại trú, Nội trú |
| VNCoreEndpointBHYT | Endpoint | TT 12/2026/TT-BTC, NĐ 164/2025, QĐ 3176 | status, connectionType, payloadType, address |
— |
| Profile | Resource gốc | Căn cứ | Must Support chính | Examples |
|---|---|---|---|---|
| VNCoreDevice | Device | TT 04/2017/TT-BYT Phụ lục 01, TT 24/2025/TT-BYT, VBHN 14/VBHN-BYT, QĐ 3176/QĐ-BYT, QĐ 847/QĐ-BYT | identifier[medicalDeviceItemCode], identifier[serialNumber], udiCarrier, type 0..1 MS, status, lifecycle fields (manufacturer, dates, lot/serial/model); deviceGroup chỉ optional/fallback, ưu tiên trên Claim.item khi là dòng chi phí |
VTYT |
| VNCoreImplantableDevice | Device | US Core Implantable pattern, TCVN 13995/13996, NĐ 98/2021, TT 05/2022, QĐ 3176/QĐ-BYT | patient 1..1, type 1..1, status 1..1, udiCarrier, lifecycle fields, safety |
Stent, Lưới lọc TMC |
| VNCoreDeviceUseStatement | DeviceUseStatement | QĐ 3176/QĐ-BYT, FHIR clinical use | status, subject, device; không chứa PHAM_VI/TYLE_TT/MUC_HUONG |
Sử dụng VTYT |
Extensions dùng trong nhóm: VNCoreExtDeviceGroup (fallback trên Device; ưu tiên Claim.item) và VNCoreExtDeviceRiskClass. Phạm vi/tỷ lệ/mức hưởng BHYT của TBYT nằm ở nhóm tài chính trên Claim.item, không ở DeviceUseStatement.
| Nếu cần | Nên đọc tiếp |
|---|---|
| Phần mở rộng dùng trong profiles | Extensions |
| Danh mục thuật ngữ và binding | Terminology |
| Hướng dẫn Must Support | Must Support Guidance |
| Tình huống lâm sàng đầu-cuối | Clinical Scenarios |
| Hướng dẫn kiểm tra hợp lệ | Validation Guidance |
This page is the published profile inventory for the current VN Core release. It groups 52 FHIR R4 profiles by domain and summarizes the main resource scope, legal basis, Must Support expectations, and example links. Detailed constraints, semantics, and examples must be read from each artifact page.