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

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

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

Walkthrough nghiệp vụ đầu-cuối qua tình huống lâm sàng thực tế – từ đăng ký khám đến thanh toán BHYT – cho thấy resource nào xuất hiện theo từng bước, thứ tự tham chiếu ra sao và điểm giao cắt với lớp 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 │─▶│ 5. SERVICE   │
  │  Đăng ký   │  │  Thẻ BHYT  │  │  Lượt khám   │  │  Chẩn đoán   │  │   REQUEST    │
  └────────────┘  └────────────┘  └──────────────┘  └──────────────┘  │   Chỉ định    │
                                                                        └──────┬───────┘
                                                                               │
  ┌────────────┐  ┌────────────────┐  ┌──────────────────┐  ┌──────────────┐  │
  │ 10. CLAIM  │◀─│ 9. CLAIM       │◀─│ 8. MEDICATION    │◀─│ 7. OBSERVATION│◀─┘
  │ RESPONSE   │  │    BHYT        │  │    REQUEST       │  │   LAB         │
  │ Phản hồi TT│  │ Yêu cầu TT     │  │   Đơn thuốc      │  │ Kết quả XN    │
  └────────────┘  └────────────────┘  └──────────────────┘  └──────┬───────┘
                                                                    │
                                                             ┌──────▼───────┐
                                                             │ 6. SPECIMEN  │
                                                             │ Lấy/nhận mẫu │
                                                             └──────────────┘

Ghi chú: Sơ đồ trên thể hiện 10 bước chính trong tình huống ngoại trú. Các resource 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: Lấy và tiếp nhận mẫu bệnh phẩm — VNCoreSpecimen

Phòng xét nghiệm tiếp nhận mẫu huyết thanh sau khi lấy máu.

Profile: VNCoreSpecimen Example: ExampleSpecimenSerumChemistry

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

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

Profile: VNCoreObservationLab Example: ExampleObservationLabGlucose

Bước 8: 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 9: Hoàn tất tài chính và đề nghị thanh toán BHYT

Bước này gồm hai nhánh liên quan nhưng không đồng nhất: lập tài khoản/bảng kê chi phí và lập hồ sơ đề nghị thanh toán BHYT.

Bước 9a: Tài khoản viện phí và bảng kê chi phí — VNCoreAccount + VNCoreCostStatementInvoice

Khi kết thúc lượt khám, chi phí được gom về tài khoản viện phí của đợt, rồi lập bảng kê chi phí theo mẫu QĐ 697/QĐ-BYT. Đây là hai việc khác nhau và nằm trên hai resource khác nhau — xem ADR-0021.

Ba ô ký của mẫu nằm ở VNCoreCostStatementComposition.attester; cả khối được bàn giao bằng VNCoreCostStatementDocumentBundle.

Profile: VNCoreAccount · VNCoreCostStatementInvoice · VNCoreCostStatementComposition

Bước 9b: Hồ sơ đề nghị thanh toán BHYT — VNCoreClaim

Claim là hồ sơ đề nghị thanh toán gửi cơ quan bảo hiểm xã hội — KHÔNG phải bảng kê chi phí. Bảng kê 13 cột đi kèm là Invoice riêng ở bước 9a, nối bằng cùng MA_LK.

Lưu ý: ExampleClaimBHYT minh hoạ hồ sơ đề nghị cho lượt nội trú (viêm ruột thừa, tổng 14.820.000 VND — trong đó 1.770.000 VND thuốc ngoài danh mục BHYT người bệnh tự trả). Hồ sơ ngoại trú đơn giản hơn — xem ExampleClaimOutpatient và kết quả giám định từ chối một phần ExampleClaimResponsePartialDeny.

Profile: VNCoreClaim

Bước 10: 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            │
  ├────────┬──────────────────────────────────────────────────────────┤
  │ 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  │ Specimen → Lấy mẫu huyết thanh xét nghiệm               │
  │ 09:05  │ Specimen → Tiếp nhận mẫu tại phòng xét nghiệm           │
  │ 09:20  │ 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:02  │ Account + Invoice → Gom chi phí, lập bảng kê 13 cột    │
  │ 10:05  │ Claim → Hồ sơ đề nghị thanh toán gửi BHXH              │
  │ 10:10  │ ClaimResponse → BHXH phản hồi: chấp nhận               │
  └────────┴──────────────────────────────────────────────────────────┘

Tài nguyên tham gia

Tình huống 2: CT lồng ngực ngoại trú BHYT

Bối cảnh

Bệnh nhân ngoại trú có triệu chứng hô hấp được bác sĩ chỉ định CT lồng ngực. Quy trình cần nối chỉ định, siêu dữ liệu DICOM, báo cáo đọc phim và nhóm chi phí CĐHA trong hồ sơ BHYT.

Luồng dữ liệu FHIR

  ┌────────────────────┐
  │ 1. SERVICE REQUEST │  BS chỉ định CT lồng ngực
  └─────────┬──────────┘
            │
            ▼
  ┌────────────────────┐
  │ 2. IMAGING STUDY   │  KTV chụp, StudyInstanceUID, modality CT
  └─────────┬──────────┘
            │
            ▼
  ┌────────────────────┐
  │ 3. DIAG REPORT     │  BS đọc phim, imagingStudy, PDF kết quả
  │    IMAGING         │
  └─────────┬──────────┘
            │
            ▼
  ┌────────────────────┐
  │ 4. CLAIM BHYT      │  Nhóm chi phí 4 CĐHA theo QĐ 697/QĐ-BYT
  └────────────────────┘

Điểm kiểm tra quan trọng: VNCoreDiagnosticReportImaging.imagingStudy phải tham chiếu đúng VNCoreImagingStudy đã sinh từ bước thực hiện chụp, thay vì chỉ gửi text kết quả rời rạc.

Tình huống 3: Sinh thiết giải phẫu bệnh

Bối cảnh

Bệnh nhân được chỉ định sinh thiết tổn thương nghi ngờ. Luồng này cần bảo toàn bệnh phẩm, kết luận giải phẫu bệnh và khả năng cập nhật chẩn đoán xác định.

Luồng dữ liệu FHIR

  ┌────────────────────┐
  │ 1. SERVICE REQUEST │  BS chỉ định sinh thiết
  └─────────┬──────────┘
            │
            ▼
  ┌────────────────────┐
  │ 2. SPECIMEN        │  Bệnh phẩm, type/body site theo SNOMED Body Structure
  └─────────┬──────────┘
            │
            ▼
  ┌────────────────────┐
  │ 3. DIAG REPORT     │  GPB: specimen bắt buộc, conclusionCode extensible
  │    PATHOLOGY       │
  └─────────┬──────────┘
            │
            ▼
  ┌────────────────────┐
  │ 4. CONDITION       │  Cập nhật chẩn đoán xác định nếu có
  └────────────────────┘

VNCoreDiagnosticReportPathology dùng conclusionCode với binding extensible, không dùng required, vì terminology QA và ánh xạ local chưa hoàn tất cho toàn bộ mã hình thái. Implementer nên dùng VNMorphologyVS khi có mã phù hợp, nhưng vẫn được phương án dự phòng sang SNOMED CT chính thức hoặc text narrative để không chặn triển khai thực tế.

Các tình huống đang harden cho thí điểm

Các tình huống dưới đây thuộc phạm vi v0.10.0 nhưng vẫn cần phản hồi triển khai thật trước khi nâng mức maturity. 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 cho các ví dụ end-to-end tiếp theo.

Mọi góp ý xin gửi qua email [email protected].

Liên hệ với các trang khác

English Summary

This page walks through a complete outpatient visit at a Vietnamese hospital, from patient registration through BHYT insurance claim adjudication, using 14 interlinked VN Core profiles across 10 clinical steps. The scenario illustrates Vietnam-specific elements such as CCCD-based identifiers, BHYT coverage verification, ICD-10 VN coding, and insurance claim submission. Additional scenarios covering inpatient care, referral, traditional medicine, and emergency visits are part of the v0.10.0 pilot-hardening scope and will be promoted as implementation evidence matures.