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

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Ví dụ Bundle: Ví dụ: Bundle chuyển tuyến từ xã lên tỉnh

Language: vi

Profile: Gói trao đổi dữ liệu VN Core — VN Core Bundle Profile

Bundle ExampleBundleReferralUpward of type collection

Entry 1 - fullUrl = http://fhir.hl7.org.vn/core/Patient/InlinePatientTranThiMai

Resource Patient:

> Language: vi

> Profile: Bệnh nhân VN Core — VN Core Patient Profile

> Trần Thị Mai Female, DoB: 1964-08-20 ( Căn cước công dân: VNCCCD#075162034567)

> Other Ids: | Thẻ bảo hiểm y tế/075162034567
> Contact Detail | Xã Tân Phú, Đồng Nai
> Dân tộc — Vietnam Ethnicity Extension | Kinh

Entry 2 - fullUrl = http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationTramYTe

Resource Organization:

> Language: vi

> Profile: Cơ sở y tế VN Core — VN Core Organization Profile

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

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

> Tình trạng xếp hạng cơ sở y tế — Organization Rank Status Extension: Không áp dụng

> Cấp năng lực cơ sở KCB — Facility Care Level Extension: Cấp ban đầu

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

> active: true

> name: Trạm Y tế phường Ngọc Hà

> ### Contacts

> - | Address
> * | Phường Ngọc Hà, Thành phố Hà Nội

Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Organization/InlineOrganizationBVTinhDongNai

Resource Organization:

> Language: vi

> Profile: Cơ sở y tế VN Core — VN Core Organization Profile

> 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: Tỉnh

> Hạng cơ sở khám bệnh, chữa bệnh — Vietnam KCB Facility Rank Extension: Hạng I

> 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

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

> active: true

> type: Healthcare Provider

> name: Bệnh viện Đa khoa Đồng Nai

Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/InlineEncounterPrimaryXa

Resource Encounter:

> Language: vi

> Profile: Lượt khám/nhập viện VN Core — VN Core Encounter Profile

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

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

> Kết quả điều trị — Vietnam Treatment Outcome Extension: Chưa xác định

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

> status: completed

> class: ambulatory

> type: Khám cấp cứu tại trạm y tế xã

> subject: Trần Thị Mai

> serviceProvider: Trạm Y tế xã Tân Phú

> ### Diagnoses

> - | Condition | Use
> * | No display for Encounter.diagnosis.condition (reference: ->I21.9 — Nhồi máu cơ tim cấp (nghi ngờ)) | Admission diagnosis

Entry 5 - fullUrl = http://fhir.hl7.org.vn/core/Condition/InlineConditionSuspectedMI

Resource Condition:

> Language: vi

> Profile: Chẩn đoán VN Core — VN Core Condition Profile

> clinicalStatus: Active

> verificationStatus: Provisional

> category: Encounter Diagnosis

> code: Nhồi máu cơ tim cấp, không đặc hiệu (chẩn đoán sơ bộ)

> subject: Trần Thị Mai

> encounter: Encounter: extension = Khám chữa bệnh ban đầu,Chuyển đến từ tuyến dưới,Chưa xác định,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-TYT-2026-04-08-001; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-08 14:00:00+0700 --> 2026-04-08 14:45:00+0700

> onset: 2026-04-08 13:30:00+0700

> recordedDate: 2026-04-08

> note:

> > Đau ngực trái đột ngột lan ra cánh tay trái, vã mồ hôi, khó thở. Tiền sử tăng huyết áp không kiểm soát. ECG tại trạm y tế: ST chênh lên ở DII, DIII, aVF. Nghi STEMI thành dưới.

Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationECGAbnormal

Resource Observation:

> Language: vi

> Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile

> status: Preliminary

> category: Laboratory

> code: Điện tâm đồ (ECG)

> subject: Trần Thị Mai

> encounter: Khám ban đầu tại Trạm Y tế xã Tân Phú

> effective: 2026-04-08 14:15:00+0700

> performer: Trạm Y tế xã Tân Phú

> value: Nhịp xoang 92 lần/phút. ST chênh lên 3mm ở DII, DIII, aVF. Nghi STEMI thành dưới.

> interpretation: Bất thường — nghi ngờ nhồi máu cơ tim cấp

Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/ServiceRequest/InlineServiceRequestReferralUpward

Resource ServiceRequest:

> Language: vi

> Profile: Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile

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

> status: Active

> intent: Order

> category: Khám chuyên khoa

> priority: Urgent

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

> subject: Trần Thị Mai

> encounter: Encounter: extension = Khám chữa bệnh ban đầu,Chuyển đến từ tuyến dưới,Chưa xác định,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-TYT-2026-04-08-001; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-08 14:00:00+0700 --> 2026-04-08 14:45:00+0700

> authoredOn: 2026-04-08 14:30:00+0700

> requester: Trạm Y tế xã Tân Phú

> performer: Bệnh viện Đa khoa Đồng Nai

> note:

> > Chuyển tuyến LÊN (xã → tỉnh). Đã sơ cứu: Aspirin 300mg nhai, NTG 0.5mg ngậm dưới lưỡi × 1 lần. HA 100/60 mmHg. Chuyển cấp cứu bằng xe cứu thương.

Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/DocumentReference/InlineDocumentReferenceReferralLetter

Resource DocumentReference:

> Language: vi

> Profile: Tài liệu y tế VN Core — VN Core DocumentReference Profile

> status: Current

> type: Giấy chuyển viện

> subject: Trần Thị Mai

> > context

> > Khám ban đầu tại Trạm Y tế xã Tân Phú

> date: 2026-04-08 14:35:00+0700

> author: Trạm Y tế xã Tân Phú

> description:

> Giấy chuyển viện — chuyển tuyến lên BV Đa khoa Đồng Nai. Lý do: nghi nhồi máu cơ tim cấp, cần can thiệp mạch vành.

> > content

> > ### Attachments

> > - | ContentType | Title | Creation
> > * | application/pdf | Giay-chuyen-vien-TranThiMai-20260408.pdf | 2026-04-08 14:35:00+0700