Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.3.0 - STU1 Draft
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.3.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 ExampleBundleOutpatientBHYT of type collection
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
- Tài khoản định danh điện tử VNeID/VNEID-001085012345
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
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ế
beneficiary: Nguyễn Văn An
period: 2025-08-01 --> 2026-07-31
Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/InlineEncounterOutpatientGastritis
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: Khám chữa bệnh ban đầu
Mã lượt khám — Encounter Code Extension: Mã lượt khám chữa bệnh/LK-2026-04-05-0142
status: completed
class: ambulatory
type: Khám ngoại trú chuyên khoa Tiêu hóa
subject: Nguyễn Văn An
serviceProvider: Bệnh viện Chợ Rẫy
Diagnoses
Condition Use No display for Encounter.diagnosis.condition (reference: ->K29.5 — Viêm dạ dày mạn tính) Admission diagnosis
Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/Condition/InlineConditionGastritis
Resource Condition:
Language: vi
clinicalStatus: Active
verificationStatus: Confirmed
category: Encounter Diagnosis
code: Viêm dạ dày mạn tính, không đặc hiệu
subject: Nguyễn Văn An
recordedDate: 2026-04-05
Entry 5 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationGlucoseNormal
Resource Observation:
Language: vi
Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile
status: Final
category: Laboratory
code: Glucose máu lúc đói
subject: Nguyễn Văn An
effective: 2026-04-05 08:30:00+0700
performer: BS CKII Nguyễn Thị Lan
value: 5.2 mmol/L (Details: UCUM codemmol/L = 'mmol/L')
ReferenceRanges
Low High Text 3.9 mmol/L (Details: UCUM codemmol/L = 'mmol/L') 6.1 mmol/L (Details: UCUM codemmol/L = 'mmol/L') 3.9 – 6.1 mmol/L
Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/InlineMedicationRequestOmeprazole
Resource MedicationRequest:
Language: vi
Profile: Đơn thuốc VN Core — VN Core MedicationRequest Profile
Số đăng ký thuốc (Visa) — Medication Registration Number: VD-25123-18
Ngày y lệnh — Order Date Extension: 2026-04-05 10:00:00+0700
Thông tin chi phí BHYT — Insurance Cost Info Extension
- scope: Trong phạm vi hưởng BHYT
- paymentRatio: 100
- benefitLevel: 80
status: Active
intent: Order
category: Outpatient
subject: Nguyễn Văn An
authoredOn: 2026-04-05 10:00:00+0700
requester: BS CKII Nguyễn Thị Lan
dosageInstruction
sequence: 1
text: Uống 1 viên 20mg, 1 lần/ngày, trước ăn sáng 30 phút
timing: before breakfast, Once per 1 day
route: Uống
DoseAndRates
Dose[x] 20 mg (Details: UCUM codemg = 'mg') dispenseRequest
numberOfRepeatsAllowed: 0
quantity: 14 viên
ExpectedSupplyDurations
Value Unit System Code 14 ngày http://unitsofmeasure.org d
Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Claim/InlineClaimOutpatientBHYT
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: ₫168.000 (VND)
- totalInsurance: ₫318.400 (VND)
- totalPatientCopay: ₫79.600 (VND)
- totalPatientSelfPay: ₫0 (VND)
Kỳ thanh toán — Claim Payment Period Extension
- year: 2026
- month: 4
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-OUT-000201
status: Active
type: Professional
subType: KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu
use: Claim
patient: Nguyễn Văn An
created: 2026-04-05
provider: Bệnh viện Chợ Rẫy
priority: Normal
Diagnoses
Sequence Diagnosis[x] Type 1 Viêm dạ dày mạn tính Principal Diagnosis 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 Khám bệnh
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 Nội tiêu hóa
quantity: 1
UnitPrices
Value Currency 150000 VND Nets
Value Currency 150000 VND item
Khoa thực hiện — Claim Item Department Extension: Khoa Xét nghiệm
Thông tin chi phí BHYT — Insurance Cost Info Extension
- scope: Trong phạm vi hưởng BHYT
- paymentRatio: 100
- benefitLevel: 80
sequence: 2
category: Xét nghiệm
productOrService: Định lượng Glucose máu (lúc đói)
quantity: 1
UnitPrices
Value Currency 80000 VND Nets
Value Currency 80000 VND item
Thông tin chi phí BHYT — Insurance Cost Info Extension
- scope: Trong phạm vi hưởng BHYT
- paymentRatio: 100
- benefitLevel: 80
sequence: 3
category: Thuốc, dịch truyền
productOrService: Omeprazole 20mg viên nang × 14
quantity: 14
UnitPrices
Value Currency 12000 VND Nets
Value Currency 168000 VND Totals
Value Currency 398000 VND
Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/ClaimResponse/InlineClaimResponseOutpatientBHYT
Resource ClaimResponse:
Language: vi
Profile: Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile
status: Active
type: Professional
use: Claim
patient: Nguyễn Văn An
created: 2026-04-05
insurer: Bảo hiểm xã hội Việt Nam
request: Yêu cầu thanh toán BHYT ngoại trú
outcome: complete
item
itemSequence: 1
adjudication
category: Submitted Amount
Amounts
Value Currency 150000 VND adjudication
category: Eligible Amount
Amounts
Value Currency 150000 VND adjudication
category: CoPay
Amounts
Value Currency 30000 VND adjudication
category: Benefit Amount
Amounts
Value Currency 120000 VND item
itemSequence: 2
adjudication
category: Submitted Amount
Amounts
Value Currency 80000 VND adjudication
category: Eligible Amount
Amounts
Value Currency 80000 VND adjudication
category: CoPay
Amounts
Value Currency 16000 VND adjudication
category: Benefit Amount
Amounts
Value Currency 64000 VND item
itemSequence: 3
adjudication
category: Submitted Amount
Amounts
Value Currency 168000 VND adjudication
category: Eligible Amount
Amounts
Value Currency 168000 VND adjudication
category: CoPay
Amounts
Value Currency 33600 VND adjudication
category: Benefit Amount
Amounts
Value Currency 134400 VND total
category: Submitted Amount
Amounts
Value Currency 398000 VND total
category: Eligible Amount
Amounts
Value Currency 398000 VND total
category: CoPay
Amounts
Value Currency 79600 VND total
category: Benefit Amount
Amounts
Value Currency 318400 VND payment
type: Complete
Amounts
Value Currency 318400 VND