VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Tình huống lâm sàng

Tình huống lâm sàng — Clinical Scenarios

Trang này minh họa cách sử dụng VN Core FHIR IG qua tình huống lâm sàng thực tế, từ khi bệnh nhân đăng ký khám đến khi thanh toán BHYT.

Tình huống 1: Khám ngoại trú — Thanh toán BHYT

Bối cảnh

Bệnh nhân Nguyễn Văn An (nam, sinh 15/03/1985, CCCD 001085012345) đến khám ngoại trú tại Bệnh viện Chợ Rẫy với triệu chứng sốt, ho, khó thở. Bệnh nhân có thẻ BHYT đúng tuyến.

Luồng dữ liệu FHIR

  ┌───────────┐    ┌───────────┐    ┌──────────────┐    ┌──────────────┐
  │ 1. PATIENT│───▶│2. COVERAGE│───▶│ 3. ENCOUNTER │───▶│ 4. CONDITION │
  │  Đăng ký  │    │  Thẻ BHYT │    │  Lượt khám   │    │  Chẩn đoán   │
  └───────────┘    └───────────┘    └──────┬───────┘    └──────────────┘
                                          │
                   ┌──────────────────────┬┴───────────────────┐
                   │                      │                    │
             ┌─────▼──────┐    ┌──────────▼───┐    ┌──────────▼──────┐
             │5. SERVICE  │    │6. OBSERVATION│    │7. MEDICATION    │
             │  REQUEST   │    │  Kết quả XN  │    │   REQUEST       │
             │  Chỉ định  │    │              │    │   Đơn thuốc     │
             └────────────┘    └──────────────┘    └─────────────────┘

             ┌─────────────┐    ┌─────────────────┐
             │  8. CLAIM   │───▶│ 9. CLAIM        │
             │  Yêu cầu TT│    │   RESPONSE      │
             │  BHYT       │    │   Phản hồi TT   │
             └─────────────┘    └─────────────────┘

Ghi chú: Sơ đồ trên thể hiện 9 bước chính trong tình huống ngoại trú. Các resources hỗ trợ (Organization, Practitioner) không hiển thị trong sơ đồ nhưng được tham chiếu từ nhiều bước.

Bước 1: Đăng ký bệnh nhân — VNCorePatient

Tiếp nhận tạo/cập nhật hồ sơ bệnh nhân với thông tin nhân khẩu học.

Profile: VNCorePatient Example: ExamplePatientNguyenVanAn

Bước 2: Xác minh thẻ BHYT — VNCoreCoverage

Kiểm tra và ghi nhận thông tin thẻ BHYT.

Profile: VNCoreCoverage Example: ExampleCoverageBHYTNew

Bước 3: Tạo lượt khám — VNCoreEncounter

Khi bệnh nhân vào phòng khám, hệ thống tạo Encounter.

Profile: VNCoreEncounter Example: ExampleEncounterOutpatient

Bước 4: Chẩn đoán — VNCoreCondition

Bác sĩ khám và chẩn đoán: Viêm phổi (J18.9).

Profile: VNCoreCondition Example: ExampleConditionPneumonia

Bước 5: Chỉ định xét nghiệm — VNCoreServiceRequest

BS chỉ định xét nghiệm glucose máu lúc đói.

Profile: VNCoreServiceRequest Example: ExampleServiceRequestLabGlucose

Bước 6: Kết quả xét nghiệm — VNCoreObservationLab

Phòng xét nghiệm trả kết quả.

Profile: VNCoreObservationLab Example: ExampleObservationLabGlucose

Bước 7: Kê đơn thuốc — VNCoreMedicationRequest

BS kê đơn thuốc điện tử.

Profile: VNCoreMedicationRequest Example: ExampleMedicationRequestAmoxicillin

Lưu ý: Example FSH dùng medicationCodeableConcept (inline). Profile cũng hỗ trợ medicationReference khi cần link đến resource Medication riêng (có thêm SNOMED CT, số đăng ký thuốc).

Bước 8: Thanh toán BHYT — VNCoreClaim

Khi kết thúc lượt khám, hệ thống tạo yêu cầu thanh toán BHYT.

Lưu ý: Example ExampleClaimBHYT minh họa Claim cho lượt nội trú (viêm ruột thừa, tổng 14.370.000 VND) với đầy đủ 14 nhóm chi phí theo QĐ 697/QĐ-BYT. Claim ngoại trú đơn giản hơn — chỉ có 2-3 item (khám, XN, thuốc).

Profile: VNCoreClaim

Bước 9: Phản hồi thanh toán — VNCoreClaimResponse

Cơ quan BHXH xử lý và phản hồi yêu cầu thanh toán.

Profile: VNCoreClaimResponse

Tổng kết luồng dữ liệu

  ┌────────────────────────────────────────────────────────────────────┐
  │                    TIMELINE — Lượt khám ngoại trú BHYT            │
  ├────────┬──────────────────────────────────────────────────────────┤
  │ 07:30  │ Observation → Lấy mẫu XN glucose (lúc đói, sáng sớm)  │
  │ 08:30  │ Patient + Coverage → Đăng ký, xác minh BHYT             │
  │ 08:35  │ Encounter (in-progress) → Bắt đầu lượt khám            │
  │ 08:45  │ Condition → BS chẩn đoán Viêm phổi J18.9               │
  │ 08:50  │ ServiceRequest → Chỉ định XN Glucose                    │
  │ 09:00  │ Observation → Kết quả XN: 6.8 mmol/L (High)            │
  │ 09:30  │ MedicationRequest → Kê đơn Amoxicillin                 │
  │ 10:00  │ Encounter (finished) → Kết thúc khám                   │
  │ 10:05  │ Claim → Yêu cầu thanh toán BHYT                        │
  │ 10:10  │ ClaimResponse → BHXH phản hồi: chấp nhận               │
  └────────┴──────────────────────────────────────────────────────────┘

Resources tham gia

Các tình huống dự kiến trong phiên bản tiếp theo

Các tình huống dưới đây đang được xây dựng và dự kiến phát hành trong v0.2.0 (Q3/2026). Phản hồi từ cộng đồng và bên triển khai sẽ giúp xác định thứ tự ưu tiên.

Mọi góp ý xin gửi qua GitHub Issues.

English Summary

This page demonstrates a complete outpatient visit with BHYT (Vietnamese national health insurance) payment using VN Core FHIR profiles.

Scenario overview

• Patient: Nguyen Van An (male, born 1985, CCCD 001085012345)
• Setting: Outpatient visit at Cho Ray Hospital
• Chief complaint: Fever, cough, dyspnea
• Diagnosis: Pneumonia (ICD-10 J18.9)

Clinical workflow (9 steps)

1. Patient registration (VNCorePatient) — CCCD identifier, CCCD-based BHYT number per ND 188/2025
2. Insurance verification (VNCoreCoverage) — BHYT card validation, beneficiary type, primary care facility
3. Encounter creation (VNCoreEncounter) — Outpatient encounter with insurance visit type (MALYDO)
4. Diagnosis (VNCoreCondition) — Pneumonia J18.9 per ICD-10 VN (QD 4469)
5. Lab order (VNCoreServiceRequest) — Fasting glucose request (LOINC 1558-6)
6. Lab results (VNCoreObservationLab) — Glucose 6.8 mmol/L, flagged High (LOINC 14771-0)
7. ePrescription (VNCoreMedicationRequest) — Amoxicillin 500mg, 3 times daily for 7 days
8. Insurance claim (VNCoreClaim) — Claim submission with consultation, lab, and medication items
9. Claim response (VNCoreClaimResponse) — BHXH adjudication result

Resources involved

The scenario demonstrates 11 interlinked FHIR resources across VN Core profiles (Patient, Coverage, Organization, Practitioner, Encounter, Condition, ServiceRequest, Observation, MedicationRequest, Claim, ClaimResponse), representing the complete data flow from registration to insurance payment in a Vietnamese hospital.

Planned scenarios (v0.2.0)

Additional scenarios covering inpatient care, referral and cross-facility transfers, traditional medicine (YHCT), and emergency care are planned for the next release.