HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.1 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.6.1) 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 quản lý điều trị lao

Bundle ExampleBHYTSubmissionTuberculosis of type collection

Entry 1 - 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ế/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 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 2 - 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

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

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

Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationBHXH

Resource Organization:

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://fhir.hl7.org.vn/core/Claim/InlineClaimBHYTSubmissionTuberculosis

Resource Claim:

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

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

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

priority: Normal

diagnosis

sequence: 1

diagnosis: Tuberculosis of lung, confirmed by sputum microscopy with or without culture

type: Principal Diagnosis

diagnosis

sequence: 2

diagnosis: Human immunodeficiency virus [HIV] disease

Insurances

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

item

Nguồn chi trả — Payment Source Extension: Chương trình mục tiêu quốc gia

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

sequence: 1

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

productOrService: Thuốc chống lao phối hợp RHZE (4-FDC)

quantity: 60

UnitPrices

-ValueCurrency
*8000VND

Nets

-ValueCurrency
*480000VND

Totals

-ValueCurrency
*480000VND

Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/Condition/InlineConditionTuberculosisBHYTSubmission

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Lao phổi AFB(+)

bodySite: Phổi

subject: Nguyễn Văn An

onset: 2026-05-02

recordedDate: 2026-05-05

Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Condition/InlineConditionHIVBHYTSubmission

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Nhiễm HIV — đồng nhiễm lao/HIV

subject: Nguyễn Văn An

onset: 2026-04-15

recordedDate: 2026-04-18

Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/EpisodeOfCare/InlineEpisodeOfCareTuberculosisBHYTSubmission

Resource EpisodeOfCare:

status: Active

type: Điều trị lao nhạy cảm thuốc — chương trình chống lao quốc gia

Diagnoses

-Condition
*No display for EpisodeOfCare.diagnosis.condition (reference: ->Lao phổi AFB(+) (A15.0))

patient: Nguyễn Văn An

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

period: 2026-05-05 --> (ongoing)

Entry 9 - fullUrl = http://fhir.hl7.org.vn/core/CarePlan/InlineCarePlanTuberculosisBHYTSubmission

Resource CarePlan:

status: Active

intent: Plan

category: Phác đồ A1 (2RHZE/4RHE) — lao nhạy cảm thuốc người lớn

title: Kế hoạch điều trị lao phổi nhạy cảm thuốc

description: Điều trị lao phổi AFB(+) theo phác đồ A1: 2 tháng tấn công RHZE, 4 tháng duy trì RHE; giám sát DOTS, xét nghiệm đờm tháng 2/5/6.

subject: Nguyễn Văn An

period: 2026-05-05 --> (ongoing)

addresses: No display for CarePlan.addresses (reference: ->Lao phổi AFB(+) (A15.0))

Entry 10 - fullUrl = http://fhir.hl7.org.vn/core/MedicationStatement/InlineMedicationStatementARVBHYTSubmission

Resource MedicationStatement:

status: active

status: recorded

subject: Nguyễn Văn An

effective: 2026-04-18 --> (ongoing)

dateAsserted: 2026-05-05

Dosages

-Text
*Uống 1 viên/ngày, duy trì suốt quá trình điều trị lao

Entry 11 - fullUrl = http://fhir.hl7.org.vn/core/MedicationStatement/InlineMedicationStatementCTXBHYTSubmission

Resource MedicationStatement:

status: active

status: recorded

subject: Nguyễn Văn An

effective: 2026-05-05 --> (ongoing)

dateAsserted: 2026-05-05

Dosages

-Text
*Uống 1 viên 960mg/ngày trong thời gian đồng nhiễm lao/HIV