HL7 Vietnam VN Core FHIR Implementation Guide

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

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.3.0) 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 nội trú

Bundle ExampleBHYTSubmissionInpatient 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
  • Tài khoản định danh điện tử VNeID/VNEID-001085012345
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/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ế

beneficiary: Nguyễn Văn An

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

Resource Claim:

Tổng chi phí theo nhóm — Claim Cost Summary Extension

  • totalMedication: ₫3.200.000 (VND)
  • totalInsurance: ₫10.080.000 (VND)
  • totalPatientCopay: ₫2.520.000 (VND)
  • totalPatientSelfPay: ₫1.770.000 (VND)

Kỳ thanh toán — Claim Payment Period Extension

  • year: 2026
  • month: 3

Phương thức thanh toán — Payment Method Extension: Phí dịch vụ (FFS)

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

status: Active

type: Institutional

subType: KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu

use: Claim

patient: Nguyễn Văn An

created: 2026-03-17

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

priority: Normal

Diagnoses

-SequenceDiagnosis[x]Type
*1Acute appendicitis, other and unspecifiedPrincipal Diagnosis

Procedures

-SequenceProcedure[x]
*1Phẫu thuật nội soi ổ bụng cắt bỏ ruột thừa

Insurances

-SequenceFocalCoverage
*1trueBHYT Nguyễn Văn An — DN 80%

item

Khoa thực hiện — Claim Item Department Extension: Khoa Khám bệnh

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

  • scope: Trong phạm vi hưởng BHYT
  • paymentRatio: 100
  • benefitLevel: 80

sequence: 1

category: Khám bệnh

productOrService: Khám chuyên khoa Ngoại

Nets

-ValueCurrency
*150000VND

item

sequence: 2

category: Ngày giường điều trị nội trú

productOrService: Giường BHYT hạng I — 7 ngày

quantity: 7

UnitPrices

-ValueCurrency
*360000VND

Nets

-ValueCurrency
*2520000VND

item

sequence: 3

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

productOrService: Phẫu thuật nội soi ổ bụng cắt bỏ ruột thừa

Nets

-ValueCurrency
*8500000VND

item

sequence: 4

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

productOrService: Thuốc kháng sinh + giảm đau hậu phẫu

Nets

-ValueCurrency
*3200000VND

Totals

-ValueCurrency
*14370000VND

Entry 6 - fullUrl = http://example.org/fhir/DiagnosticReport/ExampleDiagnosticReportLab

Resource DiagnosticReport:

Xét nghiệm sinh hóa máu (Xét nghiệm)

SubjectNguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)
When For2026-03-17 08:30:00+0700
Reported2026-03-17 14:00:00+0700
Performer Khoa Xét nghiệm — BV Chợ Rẫy

Report Details

CodeValueReference RangeFlagsWhen For
Glucose máu lúc đói6.8 mmol/L (Details: UCUM codemmol/L = 'mmol/L')3.9 - 6.1 mmol/LFinal, High2026-03-19 09:20:00+0700

Glucose tăng nhẹ (6.8 mmol/L, ref: 3.9–6.1). Cần theo dõi HbA1c. Creatinine trong giới hạn bình thường.

Coded Conclusions:

  • Tăng glucose máu

Entry 7 - fullUrl = http://example.org/fhir/Composition/ExampleCompositionDischargeSummary

Resource Composition:

Language: vi

Profile: Bệnh án điện tử VN Core — VN Core Composition Profile

Security Label: R (Details: [not stated] code R)

identifier: VNDocumentNumber/BA-NKH-2026-00123

status: Final

type: Discharge summary

encounter: Encounter: extension = Đúng tuyến,Khỏi; status = finished; class = inpatient encounter (ActCode#IMP); period = 2026-03-10 14:00:00+0700 --> 2026-03-17 10:00:00+0700; reasonCode =

date: 2026-03-17 10:00:00+0700

author: BS CK II Trần Văn Hùng

title: Tóm tắt xuất viện — Viêm phổi J18.9

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


Entry 8 - fullUrl = http://example.org/fhir/DocumentReference/ExampleDocumentReferenceScan

Resource DocumentReference:

status: Current

type: Bệnh án giấy (scan PDF)

category: Bệnh án

subject: Nguyễn Văn An

context

Khám ngoại trú 21/03/2026

date: 2026-03-21 14:00:00+0700

author: BV Chợ Rẫy — Phòng Lưu trữ hồ sơ

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

description:

Bệnh án giấy ngoại trú được số hóa — scan PDF. Per TT 13/2025/TT-BYT Điều 5: CSYT phải chuyển đổi bệnh án giấy sang điện tử trước 31/12/2026. Bệnh án ngày 21/3/2026 — BV Chợ Rẫy.

content

Attachments

-ContentTypeLanguageSizeTitleCreation
*application/pdfvi2048000BenhAn-NgoaiTru-NguyenVanAn-Scan-20260321.pdf2026-03-21 14:00:00+0700