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 có giấy chuyển tuyến

Bundle ExampleBHYTSubmissionReferral 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/ExampleOrganizationTTYTHangIV

Resource Organization:

Loại hình cơ sở y tế — Vietnam Organization Type Extension: Trung tâm y tế

Cấp quản lý hành chính y tế — Vietnam Administrative Health Level Extension: Tỉnh

Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Non-KCB Health Unit Rank Extension: Hạng IV

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 cơ bản

Tuyến chuyên môn kỹ thuật lịch sử — Legacy Technical Line Extension: Tuyến 3 — Huyện

identifier: Mã cơ sở khám chữa bệnh/48045

active: true

type: Trung tâm y tế khu vực

name: Trung tâm Y tế khu vực An Phú

Contacts

-Address
*Xã An Phú, Tỉnh An Giang

Entry 4 - 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 5 - 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 6 - 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


Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Claim/InlineClaimBHYTSubmissionReferral

Resource Claim:

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

status: Active

type: Professional

subType: KCB tại cơ sở KCB cấp ban đầu (TYT, PK, TTYT huyện)

use: Claim

patient: Nguyễn Văn An

created: 2026-04-22

provider: Trung tâm Y tế khu vực An Phú

priority: Normal

diagnosis

sequence: 1

diagnosis: Gastrointestinal haemorrhage, unspecified

type: Principal Diagnosis

diagnosis

sequence: 2

diagnosis: Iron deficiency anaemia, unspecified

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

sequence: 1

category: Khám bệnh

productOrService: Khám chuyên khoa Nội tiêu hóa

Nets

-ValueCurrency
*150000VND

Totals

-ValueCurrency
*150000VND

Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/InlineEncounterBHYTSubmissionReferral

Resource Encounter:

status: completed

class: ambulatory

subject: Nguyễn Văn An

serviceProvider: Trung tâm Y tế khu vực An Phú


Entry 9 - fullUrl = http://fhir.hl7.org.vn/core/ServiceRequest/InlineServiceRequestReferralBHYTSubmission

Resource ServiceRequest:

Hình thức chuyển tuyến — Referral Mode Extension: Chuyển đến từ tuyến dưới

identifier: VNDocumentNumber/HS-CT-2026-000031, VNDocumentNumber/GCT-2026-000745, VNDocumentNumber/SCT-2026-000112

status: Active

intent: Order

category: Khám chuyên khoa

priority: Urgent

code: No display for ServiceRequest.code (concept: )

subject: Nguyễn Văn An

encounter: Encounter: status = finished; class = ambulatory (ActCode#AMB); period = 2026-04-22 08:30:00+0700 --> 2026-04-22 11:00:00+0700; reasonCode =

occurrence: 2026-04-22 11:00:00+0700

authoredOn: 2026-04-22 10:30:00+0700

requester: BS. Trần Văn Minh

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

note: ,

Hướng điều trị: nội soi tiêu hóa cấp cứu, cầm máu qua nội soi, hồi sức truyền dịch tại tuyến trên.

Vận chuyển bằng xe cứu thương của Trung tâm, có điều dưỡng hộ tống.