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 - Draft for Community Review (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Language: vi
Profile: Gói trao đổi dữ liệu VN Core — VN Core Bundle Profile
Bundle ExampleBundleInpatientTransaction of type transaction
Entry 1 - fullUrl = http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn
Resource Patient:
Language: vi
Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)
Other Ids:
- Thẻ bảo hiểm y tế/001085012345
- Mã bệnh nhân nội bộ/BV-CR-2026-001234
- Mã số bảo hiểm xã hội/0791234567
Contact Detail
- ph: 0901234567(Mobile)
- [email protected]
- Số 123 Nguyễn Huệ, Phường Bến Thành, Thành phố Hồ Chí Minh
Dân tộc — Vietnam Ethnicity Extension Kinh Patient Birth Place Phường Ngọc Hà, Hà Nội Nghề nghiệp — Vietnam Occupation Extension Nhà phân tích hệ thống Patient Religion Công giáo Patient Citizenship:
- code: Viet Nam
Request:
PUT Patient/ExamplePatientNguyenVanAn
Entry 2 - fullUrl = http://fhir.hl7.org.vn/core/Coverage/ExampleCoverageBHYTNew
Resource Coverage:
Language: vi
Loại đối tượng BHYT — Vietnam BHYT Card Type Extension: Người lao động trong doanh nghiệp
Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension: Bệnh viện Chợ Rẫy
identifier: VNBHYT/001085012345
status: Active
type: Bảo hiểm y tế
subscriber: Nguyễn Văn An
beneficiary: Nguyễn Văn An
relationship: Self
period: 2025-08-01 --> 2026-07-31
Request:
PUT Coverage/ExampleCoverageBHYTNew
Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Practitioner/ExamplePractitionerBSCKII
Resource Practitioner:
Language: vi
Profile: Nhân viên y tế VN Core — VN Core Practitioner Profile
identifier: Căn cước công dân/079175001234, Giấy phép hành nghề/001234/BYT-GPHN, Chứng chỉ hành nghề/HCM-001234/BYT-CCHN
name: Nguyễn Thị Lan
gender: Female
Qualifications
Code Issuer Bác sĩ Chuyên khoa II — Nội khoa Bộ Y tế
Request:
PUT Practitioner/ExamplePractitionerBSCKII
Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationChoRay
Resource Organization:
Language: vi
Loại hình cơ sở y tế — Vietnam Organization Type Extension: Bệnh viện
Cấp quản lý hành chính y tế — Vietnam Administrative Health Level Extension: Trung ương
Hạng cơ sở khám bệnh, chữa bệnh — Vietnam KCB Facility Rank Extension: Đặc biệt
Tình trạng xếp hạng cơ sở y tế — Organization Rank Status Extension: Đã xếp hạng
Cấp năng lực cơ sở KCB — Facility Care Level Extension: Cấp chuyên sâu
Dải điểm chất lượng cơ sở KCB — Quality Score Band Extension: Trên 70 điểm
identifier: Mã cơ sở khám chữa bệnh/79001
active: true
name: Bệnh viện Chợ Rẫy
Contacts
Telecom Address ph: 028 3855 4137 201B Nguyễn Chí Thanh, Phường Chợ Lớn, Thành phố Hồ Chí Minh
Request:
PUT Organization/ExampleOrganizationChoRay
Entry 5 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterInpatient
Resource Encounter:
Language: vi
Profile: Lượt khám/nhập viện VN Core — VN Core Encounter Profile
Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type Extension: Đúng tuyến
Kết quả điều trị — Vietnam Treatment Outcome Extension: Khỏi
identifier: Mã lượt khám chữa bệnh/LK-2026-03-10-NTRU-0042
status: completed
class: inpatient encounter
subject: Nguyễn Văn An
serviceProvider: Bệnh viện Chợ Rẫy
Diagnoses
Condition Use No display for Encounter.diagnosis.condition (reference: ->Viêm ruột thừa cấp (K35.8)) Admission diagnosis
Request:
PUT Encounter/ExampleEncounterInpatient
Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/Condition/ExampleConditionAppendicitis
Resource Condition:
Language: vi
Profile: Chẩn đoán lượt khám VN Core — VN Core Encounter Diagnosis Condition Profile
clinicalStatus: Active
verificationStatus: Confirmed
category: Encounter Diagnosis
code: Viêm ruột thừa cấp
bodySite: Ruột thừa
subject: Nguyễn Văn An
recordedDate: 2026-03-10
Request:
PUT Condition/ExampleConditionAppendicitis
Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Procedure/ExampleProcedureAppendectomy
Resource Procedure:
Language: vi
Ngày y lệnh — Order Date Extension: 2026-03-12 07:30:00+0700
status: Completed
code: Phẫu thuật cắt ruột thừa nội soi
subject: Nguyễn Văn An
bodySite: Ruột thừa
Request:
PUT Procedure/ExampleProcedureAppendectomy
Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/Specimen/ExampleSpecimenAppendixTissue
Resource Specimen:
Language: vi
identifier: VNSpecimenLocalIdNamingSystem/GPB-20260310-0008
accessionIdentifier: VNSpecimenLocalIdNamingSystem/GPB-TN-20260310-0042
status: Available
type: Mô ruột thừa
subject: Nguyễn Văn An
receivedTime: 2026-03-10 15:20:00+0700
Collections
Collected[x] Method BodySite 2026-03-10 14:30:00+0700 Bệnh phẩm sau cắt ruột thừa No display for Specimen.collection.bodySite (concept: Appendix) container
note:
Mẫu mô ruột thừa gửi giải phẫu bệnh sau phẫu thuật.
Request:
PUT Specimen/ExampleSpecimenAppendixTissue
Entry 9 - fullUrl = http://fhir.hl7.org.vn/core/DiagnosticReport/ExampleDiagnosticReportPathology
Resource DiagnosticReport:
Language: vi
Profile: Báo cáo Giải phẫu bệnh VN Core — VN Core Pathology DiagnosticReport
Giải phẫu bệnh lý (Surgical Pathology, Xét nghiệm)
Subject Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345) When For 2026-03-10 14:30:00+0700 Reported 2026-03-12 16:00:00+0700 Performer Khoa Giải phẫu bệnh — BV Chợ Rẫy Report Details
Đại thể: Ruột thừa dài 7cm, đường kính 1.2cm, sưng nề phù nề, phủ fibrin màu vàng xanh. Lòng ruột thừa chứa mủ vàng đục. Vi thể: Thâm nhập bạch cầu đa nhân toàn thành, mủ trong lòng ruột thừa. Hoại tử thành khu trú, chưa thủng. Không thấy tế bào ác tính. Kết luận: Viêm ruột thừa cấp mủ (K35.8), chưa vỡ.
Coded Conclusions:
- Viêm ruột thừa cấp mủ, chưa vỡ
Request:
PUT DiagnosticReport/ExampleDiagnosticReportPathology
Entry 10 - fullUrl = http://fhir.hl7.org.vn/core/MedicationDispense/ExampleMedicationDispenseInpatientAntibiotic
Resource MedicationDispense:
Language: vi
Profile: Cấp phát thuốc VN Core — VN Core Medication Dispense Profile
Số đăng ký thuốc (Visa) — Medication Registration Number: VD-18422-16
status: Completed
category: Inpatient
subject: Nguyễn Văn An
Performers
Actor Khoa Dược — Bệnh viện Chợ Rẫy authorizingPrescription: Y lệnh Cefotaxime 1g IV mỗi 8 giờ
quantity: 6 lọ
daysSupply: 2 ngày (Details: UCUM coded = 'd')
whenHandedOver: 2026-03-16 15:00:00+0700
dosageInstruction
sequence: 1
text: Tiêm tĩnh mạch Cefotaxime 1g mỗi 8 giờ
timing: 3 per 1 day
route: Tiêm tĩnh mạch
DoseAndRates
Dose[x] 1 g (Details: UCUM codeg = 'g')
Request:
PUT MedicationDispense/ExampleMedicationDispenseInpatientAntibiotic
Entry 11 - fullUrl = http://fhir.hl7.org.vn/core/Composition/ExampleCompositionDischargeSummary
Resource Composition:
identifier: VNDocumentNumber/BA-NKH-2026-00123
status: Final
type: Discharge summary
date: 2026-03-17 10:00:00+0700
author: BS CKII Nguyễn Thị Lan
title: Tóm tắt xuất viện — Viêm ruột thừa cấp K35.8
custodian: Bệnh viện Chợ Rẫy
Request:
PUT Composition/ExampleCompositionDischargeSummary
Entry 12 - fullUrl = http://fhir.hl7.org.vn/core/Claim/ExampleClaimBHYT
Resource Claim:
Language: vi
Profile: Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile
Tổng chi phí theo nhóm — Claim Cost Summary Extension
- totalMedication: ₫3.200.000 (VND)
- totalInsurance: ₫10.440.000 (VND)
- totalPatientCopay: ₫2.610.000 (VND)
- totalPatientSelfPay: ₫1.770.000 (VND)
Kỳ thanh toán — Claim Payment Period Extension
- year: 2026
- month: 3
Phương thức thanh toán — Payment Method Extension: Phí dịch vụ (FFS)
identifier: Mã liên kết hồ sơ BHYT/LK-2026-000101
status: Active
type: Institutional
subType: KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu
use: Claim
patient: Nguyễn Văn An
created: 2026-03-17
provider: Bệnh viện Chợ Rẫy
priority: Normal
Diagnoses
Sequence Diagnosis[x] Type 1 Acute appendicitis, other and unspecified Principal Diagnosis Procedures
Sequence Procedure[x] 1 Phẫu thuật nội soi ổ bụng cắt bỏ ruột thừa Insurances
Sequence Focal Coverage 1 true BHYT Nguyễn Văn An — DN 80% item
Khoa thực hiện — Claim Item Department Extension: Khoa Ngoại tiêu hoá
Thông tin chi phí BHYT — Insurance Cost Info Extension
- scope: Trong phạm vi hưởng BHYT
- paymentRatio: 100
- benefitLevel: 80
sequence: 1
category: Khám bệnh
productOrService: Khám chuyên khoa Ngoại tiêu hóa
Nets
Value Currency 150000 VND item
Khoa thực hiện — Claim Item Department Extension: Khoa Ngoại tiêu hoá
sequence: 2
category: Ngày giường điều trị nội trú
productOrService: Ngày giường Ngoại loại 1 — 7 ngày
quantity: 7
UnitPrices
Value Currency 360000 VND Nets
Value Currency 2520000 VND item
sequence: 3
category: Phẫu thuật, thủ thuật
productOrService: Phẫu thuật nội soi ổ bụng cắt bỏ ruột thừa
Nets
Value Currency 8500000 VND item
Nguồn chi trả — Payment Source Extension: Bảo hiểm y tế
sequence: 4
category: Thuốc, dịch truyền
productOrService: Ceftriaxone 2g bột pha tiêm hậu phẫu
Nets
Value Currency 3200000 VND item
Nhóm TBYT theo danh mục BHYT — VN Device Group: Ống thông, ống dẫn lưu, ống nối, dây nối, chạc nối, catheter
Phạm vi BHYT cho VTYT — Device Insurance Scope Extension: Trong phạm vi hưởng BHYT
Thông tin chi phí BHYT — Insurance Cost Info Extension
- scope: Trong phạm vi hưởng BHYT
- paymentRatio: 100
- benefitLevel: 80
sequence: 5
category: Thiết bị y tế
productOrService: Kim luồn tĩnh mạch an toàn 22G
quantity: 3
UnitPrices
Value Currency 150000 VND Nets
Value Currency 450000 VND Totals
Value Currency 14820000 VND
Request:
PUT Claim/ExampleClaimBHYT
Entry 13 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/ExampleMedicationRequestCefotaximeInpatient
Resource MedicationRequest:
Language: vi
Profile: Đơn thuốc VN Core — VN Core MedicationRequest Profile
Số đăng ký thuốc (Visa) — Medication Registration Number: VD-18422-16
status: Active
intent: Order
category: Inpatient
subject: Nguyễn Văn An
authoredOn: 2026-03-16 08:00:00+0700
requester: BS CKII Nguyễn Thị Lan
dosageInstruction
sequence: 1
text: Tiêm tĩnh mạch Cefotaxime 1g mỗi 8 giờ
timing: 3 per 1 day
route: Tiêm tĩnh mạch
DoseAndRates
Dose[x] 1 g (Details: UCUM codeg = 'g')
Request:
PUT MedicationRequest/ExampleMedicationRequestCefotaximeInpatient
Entry 14 - fullUrl = http://fhir.hl7.org.vn/core/MedicationAdministration/ExampleMedicationAdministrationInpatient
Resource MedicationAdministration:
Language: vi
Profile: Sử dụng/Cho dùng thuốc VN Core — VN Core Medication Administration Profile
status: Completed
category: Inpatient
subject: Nguyễn Văn An
Performers
Actor No display for MedicationAdministration.performer.actor (reference: ->BS CKII Nguyễn Thị Lan) request: Y lệnh Cefotaxime 1g IV mỗi 8 giờ
Dosages
Route Dose Tiêm tĩnh mạch 1 g (Details: UCUM codeg = 'g')
Request:
PUT MedicationAdministration/ExampleMedicationAdministrationInpatient
