HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.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 HIV/AIDS

Bundle ExampleBHYTSubmissionHIV 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ế/0791234567
  • Mã bệnh nhân nội bộ/BV-CR-2026-001234
  • Mã số bảo hiểm xã hội/0791234567
Contact Detail
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 nhà nước

Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension: Bệnh viện Chợ Rẫy

identifier: VNBHYT/0791234567

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: Từ 70 điểm trở lên

identifier: Giấy phép hoạt động cơ sở KCB/203/BYT-GPHĐ (use: official, period: 2014-07-08 --> (ongoing)), 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:

Language: vi

identifier: Mã đơn vị BHXH minh hoạ — Fictional BHXH organization-unit identifier/BHXH-VN-CQ-TW

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

Resource Claim:

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

status: Active

type: Professional

subType: KCB khi thay đổi nơi lưu trú, nơi cư trú

use: Claim

patient: Nguyễn Văn An

created: 2026-04-18

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

priority: Normal

Diagnoses

-SequenceDiagnosis[x]Type
*1Bệnh do virus gây suy giảm miễn dịch ở người [HIV] gây ra bệnh nhiễm trùng và/hoặc ký sinh trùngPrincipal Diagnosis

Insurances

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

item

Nguồn chi trả — Payment Source Extension: Bảo hiểm y tế

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

sequence: 1

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

productOrService: Thuốc ARV phối hợp TDF/3TC/DTG

quantity: 30

UnitPrices

-ValueCurrency
*12000VND

Nets

-ValueCurrency
*360000VND

Totals

-ValueCurrency
*360000VND

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

Resource MedicationRequest:

Số đăng ký thuốc (Visa) — Medication Registration Number: ARV-TLD-2026-021

Nguồn chi trả — Payment Source Extension: Bảo hiểm y tế

groupIdentifier: VNPrescriptionCode/790010000664-C

status: Active

intent: Order

category: Outpatient

subject: Nguyễn Văn An

authoredOn: 2026-04-18 09:30:00+0700

requester: BS CKII Nguyễn Thị Lan

DosageInstructions

-SequenceTextTimingRoute
*1Uống 1 viên mỗi ngày, tái khám và lĩnh thuốc định kỳ hàng thángOnce per 1 dayUống

dispenseRequest

quantity: 30 viên (Details: UCUM code{tablet} = '{tablet}')

ExpectedSupplyDurations

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

Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/DocumentReference/InlineDocumentReferenceBHYTSubmissionHIV

Resource DocumentReference:

identifier: VNDocumentNumber/HIV-2026-000021

status: Current

type: Hồ sơ điều trị HIV/AIDS

subject: Nguyễn Văn An

date: 2026-04-18 09:30:00+0700

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

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

description:

Phác đồ điều trị HIV/AIDS: TDF/3TC/DTG, theo dõi ngoại trú định kỳ hàng tháng.

content

Attachments

-ContentTypeLanguageTitleCreation
*application/pdfviHoSoDieuTriHIV-NguyenVanAn-20260418.pdf2026-04-18 09:30:00+0700

Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/Practitioner/ExamplePractitionerBSCKII

Resource Practitioner:

identifier: Căn cước công dân/079175001234, Giấy phép hành nghề/001234/BYT-GPHN, Chứng chỉ hành nghề/HCM-001234/BYT-CCHN

name: Nguyễn Thị Lan

gender: Female

qualification

code: Bác sỹ

issuer: Bộ Y tế

qualification

code: Bác sĩ Chuyên khoa II — Nội khoa

issuer: Bộ Y tế