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
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
Language: vi
Profile: Gói trao đổi dữ liệu VN Core — VN Core Bundle Profile
Bundle ExampleBundleYHCTFullVisit of type collection
Entry 1 - fullUrl = http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn
Resource Patient:
Language: vi
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
- +84-00-0000-0001
- [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 Extension Kinh Patient Birth Place Phường Ngọc Hà, Hà Nội Nghề nghiệp — Vietnam Occupation Extension Nhà phân tích hệ thống Patient Religion Công giáo Patient Citizenship:
- code: Viet Nam
Entry 2 - fullUrl = http://fhir.hl7.org.vn/core/Practitioner/ExamplePractitionerBSCKII
Resource Practitioner:
Language: vi
Profile: Nhân viên y tế VN Core — VN Core Practitioner Profile
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ế
Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/InlineEncounterYHCTFullVisit
Resource Encounter:
Language: vi
Profile: Lượt khám/nhập viện VN Core — VN Core Encounter Profile
Kết quả điều trị — Vietnam Treatment Outcome Extension: Đỡ
identifier: Mã lượt khám chữa bệnh/LK-2026-04-18-YHCT-0042
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:
Language: vi
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
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:
Language: vi
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
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:
Language: vi
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
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:
Language: vi
Profile: Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
status: Final
category: Y học cổ truyền
code: Thiết chẩn — loại mạch
subject: Nguyễn Văn An
effective: 2026-04-18 09:00:00+0700
performer: BS CKII Nguyễn Thị Lan
value: Mạch trầm — ấn sâu mới thấy rõ, cả hai tay; lý chứng (nội thương)
note:
Thiết chẩn: mạch trầm (kèm trì — xem InlineObservationYHCTPulseSlow), lực yếu. Kết hợp các chứng → thể hàn thấp tý.
Components
Code Value[x] Mạch bộ xích tay trái (tả xích) Bộ thận (tả xích) trầm yếu rõ nhất — thận dương hư suy
Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTTongue
Resource Observation:
Language: vi
Profile: Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
status: Final
category: Y học cổ truyền
code: Vọng chẩn — chất lưỡi
subject: Nguyễn Văn An
effective: 2026-04-18 09:05:00+0700
performer: BS CKII Nguyễn Thị Lan
value: Chất lưỡi nhợt nhạt cả thân lưỡi — khí huyết hư, dương hư
note:
Vọng chẩn lưỡi (cùng rêu trắng + rêu dày): hàn thấp xâm phạm, dương khí tổn thương — khớp thiết chẩn mạch trầm trì.
Entry 9 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTSymptom
Resource Observation:
Language: vi
Profile: Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
status: Final
category: Y học cổ truyền
code: Vấn chẩn — triệu chứng chính
subject: Nguyễn Văn An
effective: 2026-04-18 08:30:00+0700
performer: BS CKII Nguyễn Thị Lan
value: Đau thắt lưng âm ỉ 3 tháng, theo vùng, không lan xuống chân; VAS 6/10
note:
Vấn chẩn tổng hợp: khởi phát mùa đông; không sốt, không vã mồ hôi, tiểu trong dài (không nhiệt). Kết luận: hàn thấp tý — kiêm thận dương hư.
Entry 10 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTPulseSlow
Resource Observation:
Language: vi
Profile: Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
status: Final
category: Y học cổ truyền
code: Thiết chẩn — loại mạch (đặc tính thứ hai)
subject: Nguyễn Văn An
effective: 2026-04-18 09:00:00+0700
performer: BS CKII Nguyễn Thị Lan
value: Mạch trì — nhịp < 60 lần/phút; hàn chứng (dương hư hoặc hàn tà)
Entry 11 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTTongueCoatingWhite
Resource Observation:
Language: vi
Profile: Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
status: Final
category: Y học cổ truyền
code: Vọng chẩn — rêu lưỡi (màu)
subject: Nguyễn Văn An
effective: 2026-04-18 09:05:00+0700
performer: BS CKII Nguyễn Thị Lan
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
Entry 12 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTTongueCoatingThick
Resource Observation:
Language: vi
Profile: Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
status: Final
category: Y học cổ truyền
code: Vọng chẩn — rêu lưỡi (độ dày)
subject: Nguyễn Văn An
effective: 2026-04-18 09:05:00+0700
performer: BS CKII Nguyễn Thị Lan
value: Rêu dày ướt — thực tà (thấp); trắng + dày → hàn thấp thực chứng
Entry 13 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTSymptomColdAggravation
Resource Observation:
Language: vi
Profile: Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
status: Final
category: Y học cổ truyền
code: Vấn chẩn — yếu tố tăng nặng
subject: Nguyễn Văn An
effective: 2026-04-18 08:30:00+0700
performer: BS CKII Nguyễn Thị Lan
value: Tăng rõ khi lạnh ẩm/mưa; giảm khi chườm ấm, nghỉ ngơi — điển hình hàn thấp
Entry 14 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationYHCTSymptomColdIntolerance
Resource Observation:
Language: vi
Profile: Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
status: Final
category: Y học cổ truyền
code: Vấn chẩn — toàn thân
subject: Nguyễn Văn An
effective: 2026-04-18 08:30:00+0700
performer: BS CKII Nguyễn Thị Lan
value: Sợ lạnh, thích ấm, tay chân lạnh mùa đông — dương khí hư
Entry 15 - fullUrl = http://fhir.hl7.org.vn/core/Procedure/InlineProcedureAcupuncture
Resource Procedure:
Language: vi
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
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 16 - fullUrl = http://fhir.hl7.org.vn/core/Medication/InlineMedicationHerbalFormula
Resource Medication:
Language: vi
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 17 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/InlineMedicationRequestHerbal
Resource MedicationRequest:
Language: vi
Profile: Đơn thuốc cổ truyền ngoại trú VN Core — VN Core Traditional-Medicine Outpatient Prescription Profile
groupIdentifier: VNPrescriptionCode/790010000845-T
status: Active
intent: Order
category: Outpatient
subject: Nguyễn Văn An
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
Sequence Text Timing Route 1 Sắ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út 2 per 1 day Uống (đường uống — thuốc sắc) dispenseRequest
quantity: 14 thang (Details: UCUM code{herbal-packet} = '{herbal-packet}')
ExpectedSupplyDurations
Value Unit System Code 14 ngày http://unitsofmeasure.org d
Entry 18 - fullUrl = http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationChoRay
Resource Organization:
Language: vi
Profile: Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB 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: 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
Telecom Address ph: 028 3855 4137 201B Nguyễn Chí Thanh, Phường Chợ Lớn, Thành phố Hồ Chí Minh
