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 YHCT đầy đủ — Yêu thống thể hàn thấp

Bundle ExampleBundleYHCTFullVisit 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/Practitioner/ExamplePractitionerBSCKII

Resource Practitioner:

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

name: Nguyễn Thị Lan

gender: Female

Qualifications

-CodeIssuer
*Bác sĩ Chuyên khoa II — Nội khoaBộ Y tế

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

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-18-YHCT-0042

Kết quả điều trị — Vietnam Treatment Outcome Extension: Đỡ

status: completed

class: ambulatory

type: Khám ngoại trú YHCT — Yêu thống thể hàn thấp

subject: Nguyễn Văn An

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

participant

diagnosis

condition: No display for Encounter.diagnosis.condition (reference: ->M54.5 — Đau thắt lưng (Tây y / ICD-10))

use: Admission diagnosis

diagnosis

condition: No display for Encounter.diagnosis.condition (reference: ->U62.392.5.01 — Yêu thống: Thể hàn thấp (YHCT))

use: Admission diagnosis


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

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Đau thắt lưng mạn tính (mã ICD-10 Tây y song song YHCT)

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-18-YHCT-0042,Đỡ; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-18 08:00:00+0700 --> 2026-04-18 11:00:00+0700

onset: 2026-01-18 00:00:00+0700

recordedDate: 2026-04-18

note:

Đau lưng mạn tính 3 tháng. Đau tăng khi trời lạnh ẩm. Không chấn thương. Đây là mã Tây y — chẩn đoán YHCT xem InlineConditionYHCTHanThap.


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

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Yêu thống thể hàn thấp — Đau lưng do phong hàn thấp xâm phạm

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-18-YHCT-0042,Đỡ; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-18 08:00:00+0700 --> 2026-04-18 11:00:00+0700

onset: 2026-01-18 00:00:00+0700

recordedDate: 2026-04-18

note:

Chẩn đoán YHCT: Yêu thống thể hàn thấp. Biểu hiện: đau thắt lưng tăng khi lạnh ẩm, sợ lạnh, mạch trầm trì, lưỡi nhợt rêu trắng. Pháp điều trị: Ôn thông kinh lạc, Trừ phong thấp.


Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/Condition/InlineConditionYHCTBatCuong

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Hàn chứng — Bát cương biện chứng: Hàn (phong hàn thấp tý)

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-18-YHCT-0042,Đỡ; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-18 08:00:00+0700 --> 2026-04-18 11:00:00+0700

recordedDate: 2026-04-18

note:

Bát cương biện chứng: Hàn chứng. Căn cứ: đau tăng khi lạnh, sợ lạnh, mạch trầm trì, lưỡi nhợt. Kết luận bát cương: Lý — Hàn — Thực (hàn thấp tà thực). Điều trị cần ôn dương tán hàn.


Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTPulse

Resource Observation:

status: Final

category: Y học cổ truyền

code: Thiết chẩn — Bắt mạch YHCT (tứ chẩn)

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-18-YHCT-0042,Đỡ; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-18 08:00:00+0700 --> 2026-04-18 11:00:00+0700

effective: 2026-04-18 09:00:00+0700

performer: BS CKII Nguyễn Thị Lan

value: Mạch trầm, trì. Hai tay đều trầm trì, lực yếu, nhất là bộ thận. Phù hợp hàn thấp tý.

note:

Thiết chẩn tổng hợp: Mạch trầm trì — phù hợp hàn thấp tý. Mạch bộ thận (chi xích) đặc biệt trầm trì yếu, chứng tỏ thận dương hư suy. Kết hợp các chứng khác → thể hàn thấp.

component

code: Mạch trầm

value: Mạch trầm — ấn sâu mới thấy rõ, cả hai tay. Biểu hiện lý chứng (nội thương).

component

code: Mạch trì

value: Mạch trì — nhịp < 60 lần/phút. Biểu hiện hàn chứng (dương hư hoặc hàn tà).


Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTTongue

Resource Observation:

status: Final

category: Y học cổ truyền

code: Vọng chẩn — Quan sát lưỡi YHCT (tứ chẩn)

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-18-YHCT-0042,Đỡ; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-18 08:00:00+0700 --> 2026-04-18 11:00:00+0700

effective: 2026-04-18 09:05:00+0700

performer: BS CKII Nguyễn Thị Lan

value: Lưỡi nhợt, rêu trắng dày ướt. Phù hợp hàn thấp — dương hư thấp trệ.

note:

Vọng chẩn lưỡi: Chất nhợt + rêu trắng dày ướt. Kết luận: Hàn thấp xâm phạm, dương khí bị tổn thương. Phù hợp hoàn toàn với thiết chẩn mạch trầm trì.

component

code: Chất lưỡi nhợt/Chất lưỡi nhạt

value: Chất lưỡi nhợt nhạt — khí huyết hư, dương hư. Cả thân lưỡi đều nhạt.

component

code: Rêu lưỡi trắng

value: Rêu trắng — biểu chứng hoặc hàn chứng. Kết hợp rêu dày → hàn thấp.

component

code: Rêu lưỡi dầy/Rêu lưỡi dày

value: Rêu dày — thực tà (thấp, thực nhiệt, thực hàn). Ở đây kết hợp trắng dày → hàn thấp thực chứng.


Entry 9 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTSymptom

Resource Observation:

status: Final

category: Y học cổ truyền

code: Vấn chẩn — Hỏi bệnh YHCT (tứ chẩn)

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-18-YHCT-0042,Đỡ; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-18 08:00:00+0700 --> 2026-04-18 11:00:00+0700

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

performer: BS CKII Nguyễn Thị Lan

value: Đau thắt lưng mạn tính 3 tháng, tăng khi lạnh ẩm, sợ lạnh, không sốt, tiểu trong dài. Phù hợp hàn thấp tý.

note:

Vấn chẩn tổng hợp: Khởi phát mùa đông, đau tăng khi lạnh ẩm, giảm khi ấm. Không sốt, không vã mồ hôi. Tiểu trong dài (không có nhiệt). Kết luận vấn chẩn: Hàn thấp tý — kiêm thận dương hư.

component

code: Đau nhiều vùng thắt lưng

value: Đau thắt lưng âm ỉ, kéo dài 3 tháng. Đau theo vùng, không lan xuống chân. VAS 6/10.

component

code: Đau tăng khi trời lạnh, ẩm

value: Đau tăng rõ rệt khi trời lạnh, ẩm, mưa. Giảm khi chườm ấm, nghỉ ngơi. Điển hình hàn thấp.

component

code: Sợ lạnh

value: Bệnh nhân sợ lạnh, thích ấm, tay chân lạnh về mùa đông. Biểu hiện dương khí hư.


Entry 10 - fullUrl = http://fhir.hl7.org.vn/core/Procedure/InlineProcedureAcupuncture

Resource Procedure:

Ngày y lệnh — Order Date Extension: 2026-04-18 09:30:00+0700

status: Completed

code: Châm cứu hào châm — 5 huyệt vùng thắt lưng + toàn thân

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-18-YHCT-0042,Đỡ; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-18 08:00:00+0700 --> 2026-04-18 11:00:00+0700

Performers

-Actor
*BS CKII Nguyễn Thị Lan

bodySite: Thận Du (BL23) — Bổ thận tráng dương, cường cân cốt, Yêu Dương Quan (GV3) — Ôn thông đốc mạch, tán hàn thấp, Uỷ Trung (BL40) — Yếu huyệt trị yêu thống, thư cân hoạt lạc, Đại Trường Du (BL25) — Điều khí cục bộ vùng thắt lưng, Hợp Cốc (LI4) — Trừ phong tán tà, thông kinh hoạt lạc toàn thân

outcome: Đạt đắc khí tại tất cả 5 huyệt. Bệnh nhân cảm giác tê, căng, nặng tại chỗ. Sau châm 30 phút: đau thuyên giảm VAS 6→3/10.

note:

Châm hào châm: Mỗi huyệt châm sâu 1.0–1.5 thốn, kích thích đắc khí. Lưu kim 30 phút. Thủ pháp bổ (xoay kim thuận chiều, nhanh vào chậm ra) tại Thận Du + Yêu Dương Quan (bổ thận tráng dương). Tả tại Hợp Cốc (trừ phong tà). Tần suất: ngày 1 lần × 10 ngày liên tiếp (1 liệu trình).


Entry 11 - fullUrl = http://fhir.hl7.org.vn/core/Medication/InlineMedicationHerbalFormula

Resource Medication:

code: Bài thuốc Can khương thương truật thang — trị yêu thống thể hàn thấp

ingredient

ingredient

ingredient

ingredient

ingredient

ingredient

ingredient

ingredient

ingredient


Entry 12 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/InlineMedicationRequestHerbal

Resource MedicationRequest:

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

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-18-YHCT-0042,Đỡ; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-18 08:00:00+0700 --> 2026-04-18 11:00:00+0700

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

requester: BS CKII Nguyễn Thị Lan

note:

Pháp điều trị tổng hợp: Ôn thông kinh lạc + Trừ phong thấp. Liệu trình 14 ngày sắc uống kết hợp châm cứu hào châm 10 buổi. Kiêng kỵ: không dùng thức ăn lạnh, tắm nước lạnh. Tái khám sau 14 ngày để đánh giá kết quả.

DosageInstructions

-SequenceTextTimingRoute
*1Sắc uống: ngày 1 thang, sắc 3 lần lấy nước, chia 2 lần uống (sáng + tối), uống ấm sau ăn 30 phút2 per 1 dayUống (đường uống — thuốc sắc)

dispenseRequest

quantity: 14 thang

ExpectedSupplyDurations

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