Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Phiên bản 0.10.0 công bố 99 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 ngữ nghĩa 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 ngữ nghĩa không tương thích.VN Core IG định nghĩa 99 profiles trên FHIR R4 resources, chia thành 6 nhóm:
| Nhóm | Profile | Số lượng |
|---|---|---|
| Hành chính (Administrative) | Patient, RelatedPerson, Practitioner, PractitionerRole, Organization, KCBOrganization, OrganizationDepartment, Location, Address, HealthcareService | 10 |
| Lâm sàng (Clinical) | Encounter, EpisodeOfCare, Condition, ConditionDiagnosis, ClinicalImpression, Observation (12: Lab, VitalSigns, YHCT, BloodPressure, HeartRate, BodyTemperature, BodyWeight, BodyHeight, RespiratoryRate, SpO2, TriageAcuity, HealthClassification), AllergyIntolerance, FamilyMemberHistory, Procedure, CarePlan, CareTeam, Goal, MedicationRequest, OutpatientPrescription, YHCTOutpatientPrescription, CancerPainNarcoticPrescription, MedicationDispense, MedicationAdministration, MedicationStatement, Medication, Immunization, AdverseEventPostImmunization, AdverseEventPatientSafety, CombinedPrescriptionGroup, ServiceRequest, Specimen, ImagingStudy | 38 |
| Tài chính (Financial) | Coverage, Claim, ClaimResponse, ExplanationOfBenefit, CostStatementInvoice, CostStatementComposition, CostStatementDocumentBundle, Account, ChargeItem, ChargeItemDefinition, PaymentReconciliation, CoverageEligibilityRequest, CoverageEligibilityResponse, ClaimAppealTask | 14 |
| Tài liệu và quản trị dữ liệu (Documents & Governance) | Consent, Composition, CompositionHealthCheckup, CompositionHealthRecordSummary, CompositionIPS, CompositionBreachNotification, Questionnaire, QuestionnaireResponse, BreachNotificationQuestionnaireResponse, DocumentReference, DiagnosticReport, DiagnosticReportLab, DiagnosticReportImaging, DiagnosticReportPathology, CompositionBirthCertificate, CompositionSurrogacyBirthCertificate, DocumentReferenceBirthCertificate, AuditEvent, AuditEventLegalBasisDecision, Provenance, Group, Measure, MeasureReport | 23 |
| Luồng nghiệp vụ và trao đổi (Workflow & Exchange) | Bundle, BundleIPS, BHYTSubmissionBundle, HealthCheckupDocumentBundle, HealthRecordSummaryBundle, HealthCredentialBundle, EndpointBHYT, Task, Appointment, Schedule, Slot | 11 |
| 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/TT-BYT, Luật Căn cước 2023, QĐ 121-TCTK/PPCĐ, QĐ 34/2020/QĐ-TTg | 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/TT-BYT, Luật BHYT, Luật 91/2025/QH15 | patient, relationship, identifier, name |
Mẹ bệnh nhi |
| VNCorePractitioner | Practitioner | Luật KCB 2023, TT 13/2025/TT-BYT, NĐ 96/2023/NĐ-CP | identifier[GPHN], name, qualification[RegulatedTitle], qualification[Education] |
BS CKII, Tối thiểu |
| VNCorePractitionerRole | PractitionerRole | TT 41/2025/TT-BYT, TT 02/2025/TT-BYT, TT 32/2023/TT-BYT | practitioner, organization, location, code |
Nội khoa, Tim mạch |
| VNCoreOrganization | Organization | Luật KCB 2023, NĐ 96/2023/NĐ-CP, TT 06/2024/TT-BYT | identifier[CSKCB], name, type |
BV Chợ Rẫy, Trạm YT, PK tư nhân, TTYT, CDC, Legacy |
| VNCoreKCBOrganization | Organization (kế thừa VNCoreOrganization) | Luật 15/2023/QH15 Điều 49-51, 55-56; NĐ 96/2023/NĐ-CP Điều 61, 78, 144 | identifier[OperatingLicense] (1..1, kèm trạng thái vòng đời giấy phép) |
Đang hiệu lực, Đình chỉ một phần, Đình chỉ toàn bộ, Thu hồi |
| VNCoreOrganizationDepartment | Organization | QĐ 1804/QĐ-BYT Phụ lục 02 — 67 mã khoa hiện hành | type[deptClass] (K01–K60, K99), identifier[localCode], name, partOf → VNCoreOrganization |
Khoa Tim mạch, Khoa CĐHA |
| VNCoreLocation | Location | TT 13/2025/TT-BYT, 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/VBHN-BYT, Luật KCB 2023, Luật 72/2025/QH15 | providedBy, category, type, name, location |
TYT xã |
| VNCoreAddress | Address | NQ 202/2025/QH15 | — (datatype profile) | Xem Patient examples |
VNCoreOrganizationDepartment kế thừa trực tiếp từ FHIR Organization, không kế thừa VNCoreOrganization, để giữ ngữ nghĩa khoa/phòng rõ ràng qua partOf bắt buộc tới cơ sở y tế chủ quản.
VNCoreKCBOrganization là profile con của VNCoreOrganization, dành riêng cho cơ sở khám bệnh, chữa bệnh thuộc phạm vi Luật 15/2023/QH15 Điều 48-56. Nghĩa vụ có giấy phép hoạt động (Điều 49 khoản 1) chỉ đặt ở profile con vì VNCoreOrganization còn phục vụ nhà thuốc, y tế dự phòng, kiểm nghiệm, cơ quan quản lý và cơ quan BHXH. Giấy phép hoạt động không có thời hạn (Điều 50 khoản 1) nên hiệu lực không suy được từ identifier.period: trạng thái đình chỉ/thu hồi khai tường minh qua extension vn-ext-operating-license-status. Organization.active giữ nguyên nghĩa cờ vận hành của bản ghi, không phải tuyên bố pháp lý — một cơ sở đang bị đình chỉ vẫn có active = true.
VNCorePractitioner tách qualification thành hai trục từ 0.10.0: RegulatedTitle là chức danh pháp lý trong 10 chức danh phải có giấy phép hành nghề (Luật 15/2023/QH15 Điều 26 khoản 1) và kích hoạt invariant vn-practitioner-regulated-title-license; Education là học vị/bằng cấp và không kích hoạt nghĩa vụ nào. Ngạch/hạng viên chức V.08 là trục thứ ba, dùng ở PractitionerRole và cố ý không tham gia invariant — nó chỉ phủ viên chức công lập nên bỏ sót khu vực tư nhân, lương y và người có bài thuốc gia truyền. Hiệu lực credential đọc từ trạng thái tường minh chứ không từ identifier.period: Điều 32 khoản 5 điểm b giữ giấy phép còn hiệu lực quá ngày ghi trên giấy khi đang chờ gia hạn, NĐ 96/2023/NĐ-CP Điều 143 khoản 2 cho CCHN cũ tiếp tục dùng như GPHN, và Điều 30 khoản 4 điểm a cho thấy đình chỉ một phần chỉ giới hạn phạm vi hành nghề chứ không tước credential.
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/TT-BYT, Luật BHYT | status, class, subject, period, reasonCode |
Ngoại trú, Nội trú |
| VNCoreCondition | Condition | TT 06/2026/TT-BYT, QĐ 1849/QĐ-BYT; QĐ 4469/QĐ-BYT và QĐ 98/QĐ-BYT chỉ là provenance legacy từ 01/07/2026; QĐ 2552/QĐ-BYT cho YHCT | code, subject, encounter |
Viêm ruột thừa, ĐTĐ, Viêm phổi, YHCT |
| VNCoreObservationLab | Observation | QĐ 1227/QĐ-BYT, TT 13/2025/TT-BYT | code, value[x], subject, status |
Glucose |
| VNCoreObservationVitalSigns | Observation | TT 13/2025/TT-BYT | code, value[x], subject, status, effectiveDateTime |
Sinh hiệu |
| VNCoreObservationYHCT | Observation | QĐ 2552/QĐ-BYT, QĐ 3080/QĐ-BYT | code, value[x], subject, status |
Mạch chẩn |
| VNCoreAllergyIntolerance | AllergyIntolerance | QĐ 2805/QĐ-BYT | code, patient, clinicalStatus |
Penicillin |
| VNCoreFamilyMemberHistory | FamilyMemberHistory | QĐ 1551/QĐ-BYT, TT 13/2025/TT-BYT | status, patient → VNCorePatient, relationship, condition.code |
TS gia đình THA |
| VNCoreProcedure | Procedure | QĐ 387/QĐ-BYT (2026), TT 23/2024/TT-BYT, 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/TT-BYT, QĐ 3176/QĐ-BYT, 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/QH15, NĐ 163/2025/NĐ-CP, TT 26/2025/TT-BYT | status, medicationCodeableConcept, subject → VNCorePatient, authorizingPrescription → VNCoreMedicationRequest, whenHandedOver |
Ngoại trú BHYT, Nội trú |
| VNCoreMedicationAdministration | MedicationAdministration | TT 13/2025/TT-BYT, QĐ 3176/QĐ-BYT, Luật Dược 105/2016 Điều 74, NĐ 163/2025/NĐ-CP | status, medicationCodeableConcept, subject → VNCorePatient, effective[x] (NGAY_TH_YL), request → VNCoreMedicationRequest |
Nội trú |
| VNCoreMedicationStatement | MedicationStatement | TT 13/2025/TT-BYT, Luật Dược 105/2016 | status, medicationCodeableConcept, subject → VNCorePatient, effective[x], dosage |
Amlodipine |
| VNCoreEpisodeOfCare | EpisodeOfCare | TT 13/2025/TT-BYT, QĐ 3176/QĐ-BYT | status, patient → VNCorePatient, type, period, diagnosis.condition → VNCoreCondition |
Tăng huyết áp mạn |
| VNCoreCarePlan | CarePlan | TT 13/2025/TT-BYT | status, intent, subject → VNCorePatient, encounter, category, period, careTeam → VNCoreCareTeam |
Tăng huyết áp |
| VNCoreCareTeam | CareTeam | TT 13/2025/TT-BYT, Luật KCB 2023 | status, subject → VNCorePatient, participant.role/member, managingOrganization |
Nhóm THA |
| VNCoreObservationTriageAcuity | Observation | QĐ 01/2008/QĐ-BYT, TT 13/2025/TT-BYT | status, code, subject → VNCorePatient, valueCodeableConcept từ VNTriageAcuityVS (5 mức) |
Triage cấp độ 2 |
| VNCoreClinicalImpression | ClinicalImpression | TT 13/2025/TT-BYT | status, subject → VNCorePatient, encounter, assessor, summary, finding |
Tăng huyết áp |
| VNCoreGoal | Goal | TT 13/2025/TT-BYT | lifecycleStatus, description, subject → VNCorePatient, target |
Kiểm soát HA |
| VNCoreMedication | Medication | Luật Dược 2016, QĐ 3176/QĐ-BYT | code, status |
Amoxicillin 500mg |
| VNCoreServiceRequest | ServiceRequest | TT 13/2025/TT-BYT, TT 23/2024/TT-BYT, QĐ 3176/QĐ-BYT | status, intent, category, code, subject, requester |
XN đường huyết, X-quang ngực |
| VNCoreSpecimen | Specimen | TT 13/2025/TT-BYT, QĐ 1227/QĐ-BYT | 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, VNCoreExtTreatmentOutcome, VNCoreExtMedRegNumber. (Mã lượt KCB nay dùng slice Encounter.identifier[maLuotKcb], không còn extension riêng.)
| Profile | Resource gốc | Căn cứ | Must Support chính | Examples |
|---|---|---|---|---|
| VNCoreCoverage | Coverage | Luật BHYT, NĐ 188/2025/NĐ-CP, QĐ 3176/QĐ-BYT | 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Đ-BYT, QĐ 697/QĐ-BYT, NĐ 188/2025/NĐ-CP, Luật BHYT | status, type, use, patient, provider, insurance, diagnosis, item, total |
BHYT nội trú |
| VNCoreClaimResponse | ClaimResponse | QĐ 3176/QĐ-BYT, QĐ 697/QĐ-BYT | status, type, use, patient, outcome |
Phản hồi BHYT |
| VNCoreExplanationOfBenefit | ExplanationOfBenefit | QĐ 697/QĐ-BYT, NĐ 188/2025/NĐ-CP | status, type, use, patient, outcome, insurance |
EOB BHYT, Trẻ em |
| VNCorePaymentReconciliation | PaymentReconciliation | TT 12/2026/TT-BTC, NĐ 188/2025/NĐ-CP, NĐ 164/2025/NĐ-CP, Luật 51/2024/QH15 | period, created, paymentIssuer, outcome, detail, paymentAmount |
— |
| VNCoreCoverageEligibilityRequest | CoverageEligibilityRequest | Luật 51/2024/QH15, NĐ 188/2025/NĐ-CP, NĐ 164/2025/NĐ-CP, QĐ 3176/QĐ-BYT | status, purpose, patient, created, insurer, insurance.coverage |
Tra cứu thẻ BHYT |
| VNCoreCoverageEligibilityResponse | CoverageEligibilityResponse | Luật 51/2024/QH15, NĐ 188/2025/NĐ-CP, NĐ 164/2025/NĐ-CP, QĐ 3176/QĐ-BYT | status, purpose, patient, created, request, outcome, insurer, insurance.inforce |
Phản hồi tra cứu |
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/QH15, NĐ 356/2025/NĐ-CP | status, category, patient, dateTime, provision |
Đồng ý, Qua cha mẹ, Từ chối |
| VNCoreComposition | Composition | TT 13/2025/TT-BYT, NĐ 137/2024/NĐ-CP | identifier, status, type, subject, date, author, title, section |
BAĐT, Tóm tắt ra viện |
| VNCoreCompositionHealthCheckup | Composition | QĐ 2062/QĐ-BYT (sửa đổi QĐ 1551/QĐ-BYT), TT 25/2026/TT-BYT, QĐ 1332/QĐ-BYT | type (3 mẫu theo nhóm tuổi + 1 mẫu KSK tâm thần), subject, section |
KSK |
| VNCoreCompositionHealthRecordSummary | Composition | QĐ 1332/QĐ-BYT, QĐ 2062/QĐ-BYT (sửa đổi QĐ 1551/QĐ-BYT), QĐ 1923/QĐ-BYT (pattern IPS) | type (60591-5), section (allergies/problems/medications…) — Sổ SKĐT nội địa |
Sổ SKĐT |
| VNCoreCompositionIPS | Composition (kế thừa HL7 IPS) | QĐ 1332/QĐ-BYT, QĐ 2062/QĐ-BYT (sửa đổi QĐ 1551/QĐ-BYT), HL7 IPS | bản xuất khẩu quốc tế (IPS), sinh qua $summary |
IPS |
| VNCoreCompositionBreachNotification | Composition | Luật 91/2025/QH15, NĐ 356/2025/NĐ-CP, Luật 116/2025/QH15 | subject, author, attester, section[organizationInfo], section[breachDescription], section[commitment] |
— |
| VNCoreDocumentReference | DocumentReference | TT 13/2025/TT-BYT, NĐ 137/2024/NĐ-CP, QĐ 1332/QĐ-BYT, Luật 91/2025/QH15 | status, type, subject, author, custodian, content |
BAĐT |
| VNCoreQuestionnaire | Questionnaire | QĐ 2062/QĐ-BYT, TT 25/2026/TT-BYT, QĐ 1332/QĐ-BYT, QĐ 3176/QĐ-BYT | mẫu phiếu KSK theo HL7 SDC; 3 mẫu theo nhóm tuổi và 1 mẫu sức khoẻ tâm thần; item.linkId theo Phụ lục 01 |
Mẫu ≥18 tuổi, Mẫu tâm thần |
| VNCoreQuestionnaireResponse | QuestionnaireResponse | QĐ 2062/QĐ-BYT, TT 13/2025/TT-BYT | questionnaire, subject → VNCorePatient, item (dữ liệu KSK đã điền) |
KSK ≥18 tuổi |
| VNBreachNotificationQuestionnaireResponse | QuestionnaireResponse | NĐ 356/2025/NĐ-CP, Luật 91/2025/QH15 | questionnaire cố định Mẫu 08, status = completed, authored, author, item |
Mẫu 08 |
| VNCoreDiagnosticReport | DiagnosticReport | TT 13/2025/TT-BYT, QĐ 1227/QĐ-BYT, 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/TT-BYT, 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 = SP (Surgical Pathology), specimen 1..*, conclusionCode extensible → VNMorphologyVS |
Báo cáo GPB |
| VNCoreAuditEvent | AuditEvent | Luật 91/2025/QH15, NĐ 356/2025/NĐ-CP, Luật KCB 2023 | type, recorded, agent, source, entity |
Audit truy cập |
| VNCoreProvenance | Provenance | TT 13/2025/TT-BYT, NĐ 137/2024/NĐ-CP, Luật 91/2025/QH15 | target, recorded, agent, signature |
Chữ ký số BAĐT |
| VNCoreGroup | Group | Luật 114/2025/QH15, TT 35/2024/TT-BYT, Luật 91/2025/QH15 | type, actual, characteristic, managingEntity — ưu tiên mô tả bằng tiêu chí thay vì liệt kê thành viên |
Cohort tiêm sởi |
| VNCoreMeasure | Measure | TT 35/2024/TT-BYT, Luật 15/2023/QH15 Điều 58, Luật 114/2025/QH15 | url, title, status, description, topic, scoring, compositeScoring, guidance, group.population |
Tiêu chuẩn chất lượng cơ bản — criteria là FHIRPath trên phiếu tự đánh giá |
| VNCoreMeasureReport | MeasureReport | TT 35/2024/TT-BYT, Luật 15/2023/QH15 Điều 58 | status, type, measure, period, reporter, group.measureScore |
Báo cáo complete cho bộ tiêu chuẩn chất lượng có đúng một nhóm KL và group.measureScore.value bằng 0 hoặc 1; pending, error, data-collection có thể chưa có kết luận. QuestionnaireResponse là dữ liệu đầu vào, không thay cho MeasureReport. Kết quả tự đánh giá 2025 |
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, SP) vừa cho phép thêm nhóm chi phí theo QĐ 697/QĐ-BYT. PAT không dùng vì đã bị deprecated trong v2-0074; báo cáo mô bệnh học ngoại khoa dùng SP, còn tế bào học có thể dùng profile phái sinh hoặc base VNCoreDiagnosticReport với mã CP khi cần.
| Profile | Resource gốc | Căn cứ | Must Support chính | Examples |
|---|---|---|---|---|
| VNCoreBundle | Bundle | TT 13/2025/TT-BYT, QĐ 3176/QĐ-BYT, NĐ 164/2025/NĐ-CP | type, timestamp, entry, entry.resource |
Ngoại trú BHYT, XN |
| VNCoreBHYTSubmissionBundle | Bundle | QĐ 3176/QĐ-BYT, QĐ 697/QĐ-BYT, NĐ 164/2025/NĐ-CP | type, timestamp, identifier, entry |
Ngoại trú, Nội trú |
| VNCoreHealthCheckupDocumentBundle | Bundle | QĐ 2062/QĐ-BYT (sửa đổi QĐ 1551/QĐ-BYT), TT 25/2026/TT-BYT, QĐ 1923/QĐ-BYT | type (document), entry (giấy KSK theo 3 nhóm tuổi hoặc KSK tâm thần) |
KSK |
| VNCoreHealthRecordSummaryBundle | Bundle | QĐ 1332/QĐ-BYT, QĐ 2062/QĐ-BYT (sửa đổi QĐ 1551/QĐ-BYT), QĐ 1923/QĐ-BYT | type (document), entry (Sổ SKĐT) |
Sổ SKĐT |
| VNCoreHealthCredentialBundle | Bundle | QĐ 1332/QĐ-BYT, Luật 91/2025/QH15 (SMART Health Cards/Links) | type (collection), entry (chứng nhận sức khoẻ QR) |
Chứng nhận |
| VNCoreBundleIPS | Bundle (kế thừa HL7 IPS) | QĐ 1332/QĐ-BYT, TT 13/2025/TT-BYT, HL7 IPS | type (document), entry[0]=CompositionIPS — kết quả $summary |
IPS Bundle |
| VNCoreEndpointBHYT | Endpoint | TT 12/2026/TT-BTC, NĐ 164/2025/NĐ-CP, QĐ 3176/QĐ-BYT | status, connectionType, payloadType, address |
— |
| VNCoreTask | Task | Luật 15/2023/QH15 Điều 60.10 và 61, TT 26/2025/TT-BYT Điều 12, TT 13/2025/TT-BYT, NĐ 102/2025/NĐ-CP | status, businessStatus, intent, for, requester, owner, restriction.period |
Tiếp nhận chuyển tuyến, Cấp phát đơn thuốc |
| VNCoreClaimAppealTask | Task | NĐ 188/2025/NĐ-CP Điều 51 khoản 3, Điều 52 khoản 4, Điều 53 | focus (quyết định bị kiến nghị), extension[appealStage], requester |
Kiến nghị từ chối |
| VNCoreAppointment | Appointment | Luật 15/2023/QH15 Điều 80, Luật 114/2025/QH15 Điều 44.1, TT 13/2025/TT-BYT | status, extension[careDeliveryMode], participant, slot, patientInstruction |
Tái khám từ xa |
| VNCoreSchedule | Schedule | Luật 15/2023/QH15 Điều 80, TT 32/2023/TT-BYT, TT 13/2025/TT-BYT | actor, specialty, planningHorizon, extension[careDeliveryMode] |
Lịch khám từ xa |
| VNCoreSlot | Slot | Luật 15/2023/QH15 Điều 80 (khám bệnh, chữa bệnh từ xa), Luật 91/2025/QH15, TT 13/2025/TT-BYT | schedule, status, start, end |
Đã đặt, Còn trống |
| 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, các trường vòng đời (manufacturer, dates, lot/serial/model); deviceGroup chỉ optional/phương án dự phòng, ư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/NĐ-CP, TT 05/2022/TT-BYT, QĐ 3176/QĐ-BYT | patient 1..1, type 1..1, status 1..1, udiCarrier, các trường vòng đời, 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 (phương án dự phòng 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 99 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.