HL7 Vietnam VN Core FHIR Implementation Guide

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 - Local Development build (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Ví dụ Bundle: Ví dụ: Bundle hồ sơ thanh toán BHYT nội trú

Language: vi

Profile: Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle

Bundle ExampleBHYTSubmissionInpatient of type collection

Entry 1 - fullUrl = http://example.org/fhir/Patient/ExamplePatientNguyenVanAn

Resource Patient:

> Language: vi

> Profile: Bệnh nhân VN Core — VN Core Patient Profile

> 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) an.nguyen@email.vn 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://example.org/fhir/Coverage/ExampleCoverageBHYTNew

Resource Coverage:

> Language: vi

> Profile: Thẻ BHYT VN Core — VN Core Coverage Profile

> 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

Entry 3 - fullUrl = http://example.org/fhir/Organization/ExampleOrganizationChoRay

Resource Organization:

> Language: vi

> Profile: Cơ sở y tế VN Core — VN Core Organization Profile

> 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

Entry 4 - fullUrl = http://example.org/fhir/Organization/ExampleOrganizationBHXH

Resource Organization:

> Language: vi

> Profile: Cơ sở y tế VN Core — VN Core Organization Profile

> identifier: Mã cơ quan BHXH Việt Nam (mã quy ước)/00000

> active: true

> type: Cơ quan bảo hiểm xã hội

> name: Bảo hiểm xã hội Việt Nam

> ### Contacts

> - | Address
> * | Số 7 Tràng Thi, Hoàn Kiếm, Hà Nội

Entry 5 - fullUrl = http://example.org/fhir/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

Entry 6 - fullUrl = http://example.org/fhir/DiagnosticReport/ExampleDiagnosticReportLab

Resource DiagnosticReport:

> Language: vi

> Profile: Báo cáo Xét nghiệm VN Core — VN Core Lab DiagnosticReport

> ## Xét nghiệm sinh hóa máu (Laboratory, 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-17 08:30:00+0700
> Reported | 2026-03-17 14:00:00+0700
> Performer | Khoa Xét nghiệm — BV Chợ Rẫy

> Report Details

> Code | Value | Reference Range | Flags | When For
> Glucose máu lúc đói | 6.8 mmol/L (Details: UCUM codemmol/L = 'mmol/L') | 3.9 - 6.1 mmol/L | Final, High | 2026-03-19 09:20:00+0700

> Glucose tăng nhẹ (6.8 mmol/L, ref: 3.9–6.1). Cần theo dõi HbA1c. Creatinine trong giới hạn bình thường.

> Coded Conclusions:

> - Tăng glucose máu

Entry 7 - fullUrl = http://example.org/fhir/Composition/ExampleCompositionDischargeSummary

Resource Composition:

> Language: vi

> Profile: Bệnh án điện tử VN Core — VN Core Composition Profile

> Security Label: R (Details: [not stated] code R)

> identifier: VNDocumentNumber/BA-NKH-2026-00123

> status: Final

> type: Discharge summary

> encounter: Encounter: extension = Đúng tuyến,Khỏi; status = finished; class = inpatient encounter (ActCode#IMP); period = 2026-03-10 14:00:00+0700 --> 2026-03-17 10:00:00+0700; reasonCode =

> date: 2026-03-17 10:00:00+0700

> author: BS CK II Trần Văn Hùng

> title: Tóm tắt xuất viện — Viêm phổi J18.9

> custodian: Bệnh viện Chợ Rẫy

Entry 8 - fullUrl = http://example.org/fhir/DocumentReference/ExampleDocumentReferenceScan

Resource DocumentReference:

> Language: vi

> Profile: Tài liệu y tế VN Core — VN Core DocumentReference Profile

> status: Current

> type: Bệnh án giấy (scan PDF)

> category: Bệnh án

> subject: Nguyễn Văn An

> > context

> > Khám ngoại trú 21/03/2026

> date: 2026-03-21 14:00:00+0700

> author: BV Chợ Rẫy — Phòng Lưu trữ hồ sơ

> custodian: Bệnh viện Chợ Rẫy

> description:

> Bệnh án giấy ngoại trú được số hóa — scan PDF. Per TT 13/2025/TT-BYT Điều 5: CSYT phải chuyển đổi bệnh án giấy sang điện tử trước 31/12/2026. Bệnh án ngày 21/3/2026 — BV Chợ Rẫy.

> > content

> > ### Attachments

> > - | ContentType | Language | Size | Title | Creation
> > * | application/pdf | vi | 2048000 | BenhAn-NgoaiTru-NguyenVanAn-Scan-20260321.pdf | 2026-03-21 14:00:00+0700

Entry 9 - fullUrl = http://example.org/fhir/MedicationRequest/InlineMedicationRequestBHYTSubmissionInpatient

Resource MedicationRequest:

> Language: vi

> Profile: Đơn thuốc VN Core — VN Core MedicationRequest Profile

> Số đăng ký thuốc (Visa) — Medication Registration Number: VN-15678-12

> Ngày y lệnh — Order Date Extension: 2026-03-17 16:00:00+0700

> Thông tin thầu — Tender Information Extension: 57/QĐ-TTMS;G1;N1;2022;G2.01

> > Thông tin chi phí BHYT — Insurance Cost Info Extension

> > - scope: Trong phạm vi hưởng BHYT
> > - paymentRatio: 100
> > - benefitLevel: 80

> Nguồn chi trả — Payment Source Extension: Bảo hiểm y tế

> status: Completed

> intent: Order

> category: Inpatient

> subject: Nguyễn Văn An

> authoredOn: 2026-03-17 16:00:00+0700

> requester: BS CKII Nguyễn Thị Lan

> > dosageInstruction

> > sequence: 1

> > text: Tiêm tĩnh mạch 2g, 1 lần/ngày, hậu phẫu

> > timing: Once per 1 day

> > route: Tiêm tĩnh mạch

> > ### DoseAndRates

> > - | Dose[x]
> > * | 2 g (Details: UCUM codeg = 'g')

> ### DispenseRequests

> - | Quantity
> * | 3 lọ

Entry 10 - fullUrl = http://example.org/fhir/DocumentReference/InlineDocumentReferenceMedicalAssessmentBHYTSubmissionInpatient

Resource DocumentReference:

> Language: vi

> Profile: Tài liệu y tế VN Core — VN Core DocumentReference Profile

> identifier: VNDocumentNumber/GĐYK-2026-000101, VNDocumentNumber/GGT-2026-000889

> status: Current

> type: Biên bản giám định y khoa

> subject: Nguyễn Văn An

> date: 2026-03-18 09:30:00+0700

> author: BS CKII Nguyễn Thị Lan

> custodian: Bệnh viện Chợ Rẫy

> description:

> Biên bản giám định y khoa xác định tỷ lệ tổn thương cơ thể cho Nguyễn Văn An.

> > content

> > ### Attachments

> > - | ContentType | Language | Title | Creation
> > * | application/pdf | vi | BienBanGiamDinhYKhoa-NguyenVanAn-20260318.pdf | 2026-03-18 09:30:00+0700

Entry 11 - fullUrl = http://example.org/fhir/Observation/InlineObservationMedicalAssessmentOldRate

Resource Observation:

> Language: vi

> status: Final

> category: Medical assessment

> code: Tỷ lệ tổn thương cơ thể cũ

> subject: Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)

> effective: 2026-03-18 09:00:00+0700

> performer: Practitioner Nguyễn Thị Lan

> value: 21 %

Entry 12 - fullUrl = http://example.org/fhir/Observation/InlineObservationMedicalAssessmentNewRate

Resource Observation:

> Language: vi

> status: Final

> category: Medical assessment

> code: Tỷ lệ tổn thương cơ thể mới

> subject: Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)

> effective: 2026-03-18 09:05:00+0700

> performer: Practitioner Nguyễn Thị Lan

> value: 39 %

Entry 13 - fullUrl = http://example.org/fhir/Observation/InlineObservationMedicalAssessmentTotalRate

Resource Observation:

> Language: vi

> status: Final

> category: Medical assessment

> code: Tổng tỷ lệ tổn thương cơ thể

> subject: Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)

> effective: 2026-03-18 09:10:00+0700

> performer: Practitioner Nguyễn Thị Lan

> value: 55 %

Entry 14 - fullUrl = http://example.org/fhir/Observation/InlineObservationMedicalAssessmentBenefit

Resource Observation:

> Language: vi

> status: Final

> category: Medical assessment

> code: Đang hưởng chế độ

> subject: Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)

> effective: 2026-03-18 09:15:00+0700

> performer: Practitioner Nguyễn Thị Lan

> value: Trợ cấp tai nạn lao động hằng tháng

Entry 15 - fullUrl = http://example.org/fhir/Observation/InlineObservationMedicalAssessmentDisabilityType

Resource Observation:

> Language: vi

> status: Final

> category: Medical assessment

> code: Dạng khuyết tật

> subject: Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)

> effective: 2026-03-18 09:20:00+0700

> performer: Practitioner Nguyễn Thị Lan

> value: Khuyết tật vận động

Entry 16 - fullUrl = http://example.org/fhir/Observation/InlineObservationMedicalAssessmentDisabilityDegree

Resource Observation:

> Language: vi

> status: Final

> category: Medical assessment

> code: Mức độ khuyết tật

> subject: Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)

> effective: 2026-03-18 09:25:00+0700

> performer: Practitioner Nguyễn Thị Lan

> value: Nặng