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 Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (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

Bundle ExampleBHYTSubmissionRecurrentWound of type collection


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

Resource Coverage:

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:

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://example.org/fhir/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://example.org/fhir/Claim/InlineClaimBHYTSubmissionRecurrentWound

Resource Claim:

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

-SequenceDiagnosis[x]Type
*1Vết thương tái phát vùng chi dướiPrincipal Diagnosis

Procedures

-SequenceProcedure[x]
*1Phẫ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

-SequenceFocalCoverage
*1trueBHYT 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

-ValueCurrency
*5000VND

Nets

-ValueCurrency
*50000VND

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

-ValueCurrency
*600000VND

Nets

-ValueCurrency
*600000VND

Totals

-ValueCurrency
*650000VND