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 khám ngoại trú + thanh toán BHYT

Bundle ExampleBundleOutpatientBHYT 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
  • 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://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ế

beneficiary: Nguyễn Văn An

period: 2025-08-01 --> 2026-07-31


Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/InlineEncounterOutpatientGastritis

Resource Encounter:

Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type Extension: Khám chữa bệnh ban đầu

Mã lượt khám — Encounter Code Extension: Mã lượt khám chữa bệnh/LK-2026-04-05-0142

status: completed

class: ambulatory

type: Khám ngoại trú chuyên khoa Tiêu hóa

subject: Nguyễn Văn An

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

Diagnoses

-ConditionUse
*No display for Encounter.diagnosis.condition (reference: ->K29.5 — Viêm dạ dày mạn tính)Admission diagnosis

Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/Condition/InlineConditionGastritis

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Viêm dạ dày mạn tính, không đặc hiệu

subject: Nguyễn Văn An

encounter: Encounter: extension = Khám chữa bệnh ban đầu,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-05-0142; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-05 08:00:00+0700 --> 2026-04-05 10:30:00+0700

recordedDate: 2026-04-05


Entry 5 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationGlucoseNormal

Resource Observation:

status: Final

category: Laboratory

code: Glucose máu lúc đói

subject: Nguyễn Văn An

encounter: Encounter: extension = Khám chữa bệnh ban đầu,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-05-0142; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-05 08:00:00+0700 --> 2026-04-05 10:30:00+0700

effective: 2026-04-05 08:30:00+0700

performer: BS CKII Nguyễn Thị Lan

value: 5.2 mmol/L (Details: UCUM codemmol/L = 'mmol/L')

ReferenceRanges

-LowHighText
*3.9 mmol/L (Details: UCUM codemmol/L = 'mmol/L')6.1 mmol/L (Details: UCUM codemmol/L = 'mmol/L')

3.9 – 6.1 mmol/L


Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/InlineMedicationRequestOmeprazole

Resource MedicationRequest:

Số đăng ký thuốc (Visa) — Medication Registration Number: VD-25123-18

Ngày y lệnh — Order Date Extension: 2026-04-05 10:00:00+0700

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

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

status: Active

intent: Order

category: Outpatient

subject: Nguyễn Văn An

encounter: Encounter: extension = Khám chữa bệnh ban đầu,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-05-0142; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-05 08:00:00+0700 --> 2026-04-05 10:30:00+0700

authoredOn: 2026-04-05 10:00:00+0700

requester: BS CKII Nguyễn Thị Lan

dosageInstruction

sequence: 1

text: Uống 1 viên 20mg, 1 lần/ngày, trước ăn sáng 30 phút

timing: before breakfast, Once per 1 day

route: Uống

DoseAndRates

-Dose[x]
*20 mg (Details: UCUM codemg = 'mg')

dispenseRequest

numberOfRepeatsAllowed: 0

quantity: 14 viên

ExpectedSupplyDurations

-ValueUnitSystemCode
*14ngàyhttp://unitsofmeasure.orgd

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

Resource Claim:

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

  • totalMedication: ₫168.000 (VND)
  • totalInsurance: ₫318.400 (VND)
  • totalPatientCopay: ₫79.600 (VND)
  • totalPatientSelfPay: ₫0 (VND)

Kỳ thanh toán — Claim Payment Period Extension

  • year: 2026
  • month: 4

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-OUT-000201

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

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

priority: Normal

Diagnoses

-SequenceDiagnosis[x]Type
*1Viêm dạ dày mạn tínhPrincipal Diagnosis

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 Nội tiêu hóa

quantity: 1

UnitPrices

-ValueCurrency
*150000VND

Nets

-ValueCurrency
*150000VND

item

Khoa thực hiện — Claim Item Department Extension: Khoa Xét nghiệm

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

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

sequence: 2

category: Xét nghiệm

productOrService: Định lượng Glucose máu (lúc đói)

quantity: 1

UnitPrices

-ValueCurrency
*80000VND

Nets

-ValueCurrency
*80000VND

item

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

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

sequence: 3

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

productOrService: Omeprazole 20mg viên nang × 14

quantity: 14

UnitPrices

-ValueCurrency
*12000VND

Nets

-ValueCurrency
*168000VND

Totals

-ValueCurrency
*398000VND

Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/ClaimResponse/InlineClaimResponseOutpatientBHYT

Resource ClaimResponse:

status: Active

type: Professional

use: Claim

patient: Nguyễn Văn An

created: 2026-04-05

insurer: Bảo hiểm xã hội Việt Nam

request: Yêu cầu thanh toán BHYT ngoại trú

outcome: complete

item

itemSequence: 1

adjudication

category: Submitted Amount

Amounts

-ValueCurrency
*150000VND

adjudication

category: Eligible Amount

Amounts

-ValueCurrency
*150000VND

adjudication

category: CoPay

Amounts

-ValueCurrency
*30000VND

adjudication

category: Benefit Amount

Amounts

-ValueCurrency
*120000VND

item

itemSequence: 2

adjudication

category: Submitted Amount

Amounts

-ValueCurrency
*80000VND

adjudication

category: Eligible Amount

Amounts

-ValueCurrency
*80000VND

adjudication

category: CoPay

Amounts

-ValueCurrency
*16000VND

adjudication

category: Benefit Amount

Amounts

-ValueCurrency
*64000VND

item

itemSequence: 3

adjudication

category: Submitted Amount

Amounts

-ValueCurrency
*168000VND

adjudication

category: Eligible Amount

Amounts

-ValueCurrency
*168000VND

adjudication

category: CoPay

Amounts

-ValueCurrency
*33600VND

adjudication

category: Benefit Amount

Amounts

-ValueCurrency
*134400VND

total

category: Submitted Amount

Amounts

-ValueCurrency
*398000VND

total

category: Eligible Amount

Amounts

-ValueCurrency
*398000VND

total

category: CoPay

Amounts

-ValueCurrency
*79600VND

total

category: Benefit Amount

Amounts

-ValueCurrency
*318400VND

payment

type: Complete

Amounts

-ValueCurrency
*318400VND