HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Ví dụ Bundle: Fixture âm: bản ký và bảng kê thuộc hai người bệnh khác nhau

Document Subject

Trần Thị B Female, DoB: 2000-06-15 ( Căn cước công dân: VNCCCD#079300001234)

Document Content

Từ 10/03/2026 đến 13/03/2026 — mức hưởng 80%

Từ 14/03/2026 đến 17/03/2026 — mức hưởng 100%

Additional Resources Included in Document

Entry 2 - fullUrl = http://fhir.hl7.org.vn/core/Invoice/ExampleCostStatementMultiSegment

Resource Invoice:

Phân đoạn thẻ và mức hưởng trên bảng kê — Cost Statement Card Segment

Phân đoạn thẻ và mức hưởng trên bảng kê — Cost Statement Card Segment

identifier: Mã liên kết hồ sơ BHYT/LK-ITEMIZED-2026-0001

status: issued

subject: Nguyễn Văn An

recipient: Nguyễn Văn An

date: 2026-03-17

issuer: Bệnh viện Chợ Rẫy

account: Tài khoản viện phí của đợt nội trú 10/03–17/03/2026

lineItem

Thuộc tính dòng bảng kê chi phí — Cost Statement Line Attributes

  • segmentSequence: 1
  • category: Khám bệnh
  • serviced: 2026-03-10
  • unit: Lần
  • hospitalUnitPrice: ₫200.000 (VND)

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

  • scope: Trong phạm vi hưởng BHYT
  • paymentRatio: 100
  • benefitLevel: 80
  • insuranceUnitPrice: ₫200.000 (VND)
  • insuranceLineAmount: ₫200.000 (VND)

Phân bổ nguồn thanh toán theo dòng — Line Payment Allocation

  • insuranceFund: ₫160.000 (VND)
  • patientCopay: ₫40.000 (VND)
  • otherSource: ₫0 (VND)
  • patientSelfPay: ₫0 (VND)

sequence: 1

chargeItem: Khám chuyên khoa Ngoại tiêu hoá

lineItem

Thuộc tính dòng bảng kê chi phí — Cost Statement Line Attributes

  • segmentSequence: 2
  • category: Ngày giường điều trị nội trú
  • serviced: 2026-03-14 --> 2026-03-16
  • unit: Ngày
  • hospitalUnitPrice: ₫300.000 (VND)

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

  • scope: Trong phạm vi hưởng BHYT
  • paymentRatio: 100
  • benefitLevel: 100
  • insuranceUnitPrice: ₫300.000 (VND)
  • insuranceLineAmount: ₫900.000 (VND)

Phân bổ nguồn thanh toán theo dòng — Line Payment Allocation

  • insuranceFund: ₫900.000 (VND)
  • patientCopay: ₫0 (VND)
  • otherSource: ₫0 (VND)
  • patientSelfPay: ₫0 (VND)

sequence: 2

chargeItem: Ngày giường bệnh nội khoa

TotalNets

-ValueCurrency
*1100000VND

Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Account/ExampleAccountInpatientEpisode

Resource Account:

identifier: Mã liên kết hồ sơ BHYT/LK-ITEMIZED-2026-0001

status: Inactive

type: patient billing account

name: Đợt nội trú 10/03–17/03/2026 — Ngoại tiêu hoá

subject: Nguyễn Văn An

servicePeriod: 2026-03-10 --> 2026-03-17

coverage

coverage: Coverage: extension = Cán bộ, công chức, viên chức,->Bệnh viện Chợ Rẫy; identifier = http://fhir.hl7.org.vn/core/sid/bhyt#VNBHYT#HC4790791234567; status = active; type = Medical; relationship = Self; period = 2026-03-15 --> 2027-03-14

priority: 1

coverage

coverage: Coverage: extension = Người lao động trong doanh nghiệp nhà nước,->Bệnh viện Chợ Rẫy; identifier = http://fhir.hl7.org.vn/core/sid/bhyt#VNBHYT#0791234567; status = active; type = Medical; relationship = Self; period = 2025-08-01 --> 2026-07-31

priority: 2

owner: Bệnh viện Chợ Rẫy

description:

Đã chốt bảng kê và gửi hồ sơ đề nghị thanh toán; tài khoản đóng sau khi quyết toán quý I/2026.

Guarantors

-PartyOnHold
*Nguyễn Văn Anfalse

Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn

Resource Patient:

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ế/0791234567
  • Mã bệnh nhân nội bộ/BV-CR-2026-001234
  • Mã số bảo hiểm xã hội/0791234567
Contact Detail
Dân tộc — Vietnam Ethnicity ExtensionKinh
Patient Birth PlacePhường Ngọc Hà, Hà Nội
Nghề nghiệp — Vietnam Occupation ExtensionNhà phân tích hệ thống
Patient ReligionCông giáo
Patient Citizenship:
  • code: Viet Nam

Entry 5 - fullUrl = http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationChoRay

Resource Organization:

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: Từ 70 điểm trở lên

identifier: Giấy phép hoạt động cơ sở KCB/203/BYT-GPHĐ (use: official, period: 2014-07-08 --> (ongoing)), Mã cơ sở khám chữa bệnh/79001

active: true

name: Bệnh viện Chợ Rẫy

Contacts

-TelecomAddress
*ph: 028 3855 4137201B Nguyễn Chí Thanh, Phường Chợ Lớn, Thành phố Hồ Chí Minh

Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/ChargeItem/ExampleChargeItemBedDay

Resource ChargeItem:

definitionCanonical: Giá ngày giường bệnh nội khoa — Bệnh viện Chợ Rẫy, hiệu lực 2026

status: Billed

code: Ngày giường bệnh nội khoa

subject: Nguyễn Văn An

occurrence: 2026-03-14 --> 2026-03-16

performingOrganization: Bệnh viện Chợ Rẫy

quantity: 3 ngày (Details: UCUM coded = 'd')

account: Tài khoản viện phí LK-ITEMIZED-2026-0001

note:

Ba ngày giường thuộc phân đoạn mức hưởng 100% của bảng kê LK-ITEMIZED-2026-0001.

Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Coverage/ExampleCoverageBHYTNew

Resource Coverage:

Loại đối tượng BHYT — Vietnam BHYT Card Type Extension: Người lao động trong doanh nghiệp nhà nước

Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension: Bệnh viện Chợ Rẫy

identifier: VNBHYT/0791234567

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 8 - fullUrl = http://fhir.hl7.org.vn/core/Coverage/ExampleCoverageBHYTReissued

Resource Coverage:

Loại đối tượng BHYT — Vietnam BHYT Card Type Extension: Cán bộ, công chức, viên chức

Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension: Bệnh viện Chợ Rẫy

identifier: VNBHYT/HC4790791234567

status: Active

type: Bảo hiểm y tế

subscriber: Nguyễn Văn An

beneficiary: Nguyễn Văn An

relationship: Self

period: 2026-03-15 --> 2027-03-14

Entry 9 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterInpatient

Resource Encounter:

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

-ConditionUse
*No display for Encounter.diagnosis.condition (reference: ->Viêm ruột thừa cấp (K35.8))Admission diagnosis

account: Tài khoản viện phí LK-ITEMIZED-2026-0001

Entry 10 - fullUrl = http://fhir.hl7.org.vn/core/PractitionerRole/ExamplePractitionerRole

Resource PractitionerRole:

active: true

period: 2015-06-01 --> (ongoing)

practitioner: BS CKII Nguyễn Thị Lan

organization: Bệnh viện Chợ Rẫy

code: Bác sĩ chính (hạng II)

specialty: Nội khoa, Tim mạch

location: Khoa Tim mạch

Entry 11 - fullUrl = http://fhir.hl7.org.vn/core/PractitionerRole/ExamplePractitionerRoleBillingAccountant

Resource PractitionerRole:

active: true

period: 2022-06-01 --> (ongoing)

practitioner: Trần Văn Minh

organization: Bệnh viện Chợ Rẫy

code: Kế toán viện phí

Entry 12 - fullUrl = http://fhir.hl7.org.vn/core/Condition/ExampleConditionAppendicitis

Resource Condition:

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

encounter: Encounter: extension = Khỏi; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-03-10-NTRU-0042; status = finished; class = inpatient encounter (ActCode#IMP); period = 2026-03-10 14:00:00+0700 --> 2026-03-17 10:00:00+0700; reasonCode =

recordedDate: 2026-03-10

Entry 13 - fullUrl = http://fhir.hl7.org.vn/core/Location/ExampleLocationChoRayCardiology

Resource Location:

identifier: VNLocationLocalId/CR-TIM

status: Active

name: Khoa Tim mạch

description:

Đơn vị chuyên môn nội khoa tim mạch trực thuộc Bệnh viện Chợ Rẫy

type: Khoa lâm sàng

address: Tầng 3 khối nhà điều trị, 201B Nguyễn Chí Thanh, Phường Chợ Lớn, Thành phố Hồ Chí Minh

managingOrganization: Bệnh viện Chợ Rẫy

Entry 14 - fullUrl = http://fhir.hl7.org.vn/core/Practitioner/ExamplePractitionerBSCKII

Resource Practitioner:

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

qualification

code: Bác sỹ

issuer: Bộ Y tế

qualification

code: Bác sĩ Chuyên khoa II — Nội khoa

issuer: Bộ Y tế

Entry 15 - fullUrl = http://fhir.hl7.org.vn/core/Practitioner/ExamplePractitionerMinimal

Resource Practitioner:

identifier: Giấy phép hành nghề/005678/HCM-GPHN

name: Trần Văn Minh

Qualifications

-Code
*Bác sỹ

Entry 16 - fullUrl = http://fhir.hl7.org.vn/core/Patient/ExamplePatientMinimal

Resource Patient:

Trần Thị B Female, DoB: 2000-06-15 ( Căn cước công dân: VNCCCD#079300001234)