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ơ BHYT có VET_THUONG_TP

Language: vi

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

Bundle ExampleBHYTSubmissionRecurrentWound 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/InlineCoverageBHYTRecurrentWound

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 có công với cách mạng (liệt sĩ, thương binh nặng, Bà mẹ VNAH)

> 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/InlineClaimBHYTSubmissionRecurrentWound

Resource Claim:

> Language: vi

> Profile: Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile

> identifier: Mã liên kết hồ sơ BHYT/LK-2026-VTTP-000073

> 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-20

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

> priority: Normal

> ### Diagnoses

> - | Sequence | Diagnosis[x] | Type
> * | 1 | Vết thương tái phát vùng chi dưới | Principal Diagnosis

> ### Procedures

> - | Sequence | Procedure[x]
> * | 1 | Phẫu thuật/thủ thuật cắt lọc vết thương, vết nhiễm trùng hoặc vết bỏng hoại tử

> ### Insurances

> - | Sequence | Focal | Coverage
> * | 1 | true | BHYT người có công — flag vết thương tái phát

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

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

> > Thông tin thầu — Tender Information Extension: 99/QĐ-TTMS;G1;N1;2026;VTTP.01

> > Flag vết thương/bệnh tật tái phát — Recurrent Wound Benefit Flag: true

> > sequence: 1

> > category: Thuốc, dịch truyền

> > productOrService: Diclofenac 50mg điều trị đau do vết thương tái phát

> > quantity: 10 viên

> > ### UnitPrices

> > - | Value | Currency
> > * | 5000 | VND

> > ### Nets

> > - | Value | Currency
> > * | 50000 | VND

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

> > Flag vết thương/bệnh tật tái phát — Recurrent Wound Benefit Flag: true

> > sequence: 2

> > category: Phẫu thuật, thủ thuật

> > productOrService: Cắt lọc vết thương tái phát

> > quantity: 1

> > ### UnitPrices

> > - | Value | Currency
> > * | 600000 | VND

> > ### Nets

> > - | Value | Currency
> > * | 600000 | VND

> ### Totals

> - | Value | Currency
> * | 650000 | VND