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

Hồ sơ (Profiles)

Hồ sơ — Profiles

Phiên bản 0.6.0 công bố 71 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.

Nguyên tắc profile

VN Core hiện tại giữ các nguyên tắc sau:

• Ưu tiên đi từ baseline quốc tế, đặc biệt là IPS, rồi mới localize;
• Chỉ thêm profile hoặc extension khi khác biệt của Việt Nam là thật và có căn cứ;
• Không coi profile là đủ nếu thiếu yêu cầu tuân thủ, hướng dẫn theo vai trò triển khai, ví dụ và bộ kiểm thử.

Phân lớp Observation

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

• Có lớp nền cho kết quả và các nhóm quan sát cốt lõi;
• Tách dần guidance hoặc profile theo domain như lab, pathology, radiology, vital signs, structured exam, social history khi đã có nhu cầu và căn cứ rõ;
• Tránh để một profile Observation phình to, ôm nhiều semantics không tương thích.

---

Tổng quan

VN Core IG định nghĩa 71 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, 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, MedicationDispense, MedicationAdministration, MedicationStatement, Medication, Immunization, ServiceRequest, Specimen, ImagingStudy	32
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, CompositionHealthCheckup, CompositionHealthRecordSummary, CompositionIPS, CompositionBreachNotification, Questionnaire, QuestionnaireResponse, DocumentReference, DiagnosticReport, DiagnosticReportLab, DiagnosticReportImaging, DiagnosticReportPathology, AuditEvent, Provenance	15
Luồng nghiệp vụ và trao đổi (Workflow & Exchange)	Bundle, BundleIPS, BHYTSubmissionBundle, HealthCheckupDocumentBundle, HealthRecordSummaryBundle, HealthCredentialBundle, EndpointBHYT	7
Trang thiết bị (Device)	Device, ImplantableDevice, DeviceUseStatement	3

---

Nhóm 1: Hành chính

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	TYT xã
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.

---

Nhóm 2: Lâm sàng

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
VNCoreFamilyMemberHistory	FamilyMemberHistory	QĐ 1551, TT 13/2025	status, patient → VNCorePatient, relationship, condition.code	TS gia đình THA
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ú
VNCoreMedicationAdministration	MedicationAdministration	TT 13/2025, QĐ 3176, Luật Dược 105/2016 Điều 74, NĐ 163/2025	status, medicationCodeableConcept, subject → VNCorePatient, effective[x] (NGAY_TH_YL), request → VNCoreMedicationRequest	Nội trú
VNCoreMedicationStatement	MedicationStatement	TT 13/2025, Luật Dược 105/2016	status, medicationCodeableConcept, subject → VNCorePatient, effective[x], dosage	Amlodipine
VNCoreEpisodeOfCare	EpisodeOfCare	TT 13/2025, QĐ 3176	status, patient → VNCorePatient, type, period, diagnosis.condition → VNCoreCondition	Tăng huyết áp mạn
VNCoreCarePlan	CarePlan	TT 13/2025	status, intent, subject → VNCorePatient, encounter, category, period, careTeam → VNCoreCareTeam	Tăng huyết áp
VNCoreCareTeam	CareTeam	TT 13/2025, Luật KCB 2023	status, subject → VNCorePatient, participant.role/member, managingOrganization	Nhóm THA
VNCoreObservationTriageAcuity	Observation	QĐ 01/2008/QĐ-BYT, TT 13/2025	status, code, subject → VNCorePatient, valueCodeableConcept từ VNTriageAcuityVS (5 mức)	Triage cấp độ 2
VNCoreClinicalImpression	ClinicalImpression	TT 13/2025	status, subject → VNCorePatient, encounter, assessor, summary, finding	Tăng huyết áp
VNCoreGoal	Goal	TT 13/2025	lifecycleStatus, description, subject → VNCorePatient, target	Kiểm soát HA
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.

---

Nhóm 3: Tài chính

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.

---

Nhóm 4: Tài liệu và quản trị dữ liệu

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
VNCoreCompositionHealthCheckup	Composition	QĐ 1551, QĐ 1332	type, subject, section (giấy KSK định kỳ)	KSK
VNCoreCompositionHealthRecordSummary	Composition	QĐ 1332, QĐ 1551, QĐ 1923 (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Đ 1551, HL7 IPS	bản xuất khẩu quốc tế (IPS), sinh qua $summary	IPS
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
VNCoreQuestionnaire	Questionnaire	QĐ 1551, QĐ 1332, QĐ 3176	mẫu phiếu KSK (HL7 SDC); 17 mẫu, item.linkId = mã trường Phụ lục 01	Mẫu ≥18 tuổi
VNCoreQuestionnaireResponse	QuestionnaireResponse	QĐ 1551, TT 13/2025	questionnaire, subject → VNCorePatient, item (dữ liệu KSK đã điền)	KSK ≥18 tuổi
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 = SP (Surgical Pathology), 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, 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.

---

Nhóm 5: Luồng nghiệp vụ và trao đổi

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ú
VNCoreHealthCheckupDocumentBundle	Bundle	QĐ 1551, QĐ 1332	type (document), entry (giấy KSK định kỳ)	KSK
VNCoreHealthRecordSummaryBundle	Bundle	QĐ 1332, QĐ 1551	type (document), entry (Sổ SKĐT)	Sổ SKĐT
VNCoreHealthCredentialBundle	Bundle	QĐ 1332, Luật 91/2025 (SMART Health Cards/Links)	type (collection), entry (chứng nhận sức khỏe QR)	Chứng nhận
VNCoreBundleIPS	Bundle (kế thừa HL7 IPS)	QĐ 1332, TT 13/2025, HL7 IPS	type (document), entry[0]=CompositionIPS — kết quả $summary	IPS Bundle
VNCoreEndpointBHYT	Endpoint	TT 12/2026/TT-BTC, NĐ 164/2025, QĐ 3176	status, connectionType, payloadType, address	—

---

Nhóm 6: Trang thiết bị

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.

---

Liên hệ với các trang khác

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

---

English Summary

This page is the published profile inventory for the current VN Core release. It groups 71 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.