Triển khai

Ba lộ trình cụ thể để đưa VN Core vào thực tế.

Bệnh viện, nhà cung cấp, và cơ quan nhà nước có ba xuất phát điểm khác nhau. Trang này ghi lại playbook tham khảo cho từng nhóm — gắn trực tiếp với mốc hạn TT 13/2025/TT-BYT, QĐ 697/QĐ-BYT và Luật 91/2025/QH15.

Playbook · Bệnh viện / Cơ sở KCB

Đáp ứng EMR và liên thông BHYT đúng lộ trình pháp lý

VN Core giúp bệnh viện chuẩn hóa dữ liệu nhân khẩu học, lượt khám, chẩn đoán, dược, cận lâm sàng và thanh toán BHYT trên nền FHIR R4 — song hành cùng chuẩn XML đầu ra hiện hành theo QĐ 3176/QĐ-BYT (thường được gọi theo tên legacy “XML 4210”), thay vì thay thế ngay.

Mốc hạn pháp lý liên quan: Thông tư 13/2025/TT-BYT và QĐ 697/QĐ-BYT đặt các mốc pháp lý riêng. Kế hoạch kỹ thuật phải lập ngược từ mốc áp dụng tương ứng, nhưng thời lượng từng gate phụ thuộc phạm vi và bằng chứng kiểm thử.

Các bước chính

  1. Gate 1 · Inventory

    Khảo sát và mapping dữ liệu

    Rà soát HIS, EMR, LIS, PACS; xác định chủ dữ liệu, interface, vocabulary, SLA và quality baseline. Đối chiếu trường dữ liệu với Patient, Encounter, Condition, Observation, Coverage và Claim theo VN Core.

    Output: Qua gate khi inventory, mapping, gap/risk register và baseline được chủ hệ thống phê duyệt

  2. Gate 2 · Contract

    Thí điểm nhân khẩu học và lượt khám

    Chọn workflow thí điểm có phạm vi rõ; thống nhất package version, profile, terminology, interaction và security contract. Dùng CCCD theo constraint VN Core; bổ sung BHXH theo ngữ cảnh và ghi mã số BHYT theo đúng định dạng hiện hành hoặc legacy.

    Output: Qua gate khi CapabilityStatement, test plan, dữ liệu mẫu và tiêu chí rollback được các bên thống nhất

  3. Gate 3 · Clinical pilot

    Mở rộng Lab, CĐHA, Dược

    Bổ sung DiagnosticReport, Observation và MedicationDispense theo phạm vi pilot. Mapping bộ mã QĐ 1227/QĐ-BYT và thuật ngữ lâm sàng phải lưu provenance, relationship và version.

    Output: Qua gate khi validation, test liên vận, đối soát dữ liệu và clinical review đạt tiêu chí đã phê duyệt

  4. Gate 4 · BHYT adapter

    Đồng bộ BHYT và bảng kê chi phí

    Tạo Coverage, Claim và ExplanationOfBenefit theo VN Core; triển khai adapter cho 16 logical models BHYT (Check-in + XML1–XML15) và 3 operations validate/submit/reverse. Annotation ^mapping ở logical models là đầu vào kỹ thuật; package chưa phát hành artifact ConceptMap bao phủ và kiểm chứng đầu-cuối toàn bộ XML ↔ Claim/EOB. Chuẩn bị bảng kê chi phí 12 nhóm theo QĐ 697/QĐ-BYT (hiệu lực pháp lý 19/03/2026, hạn triển khai phần mềm 01/07/2026).

    Output: Qua gate khi adapter được kiểm thử theo từng bảng/operation, có reconciliation và không làm gián đoạn submission hiện hành

  5. Gate 5 · Operate and scale

    Conformance và rollout toàn viện

    Vận hành với monitoring, reconciliation, incident response và audit. Chỉ mở rộng use case khi SLA và security acceptance đạt ngưỡng; resource Consent/AuditEvent/Provenance chỉ dùng khi đúng semantics và policy triển khai.

Sai lầm thường gặp

  • Dùng VNeID làm identifier người bệnh: sai — VNeID chỉ ở lớp ứng dụng người dân, CCCD mới là identifier lõi.
  • Bỏ luôn XML 4210 để chuyển sang FHIR: rủi ro — hiện chưa có văn bản thay thế chính thức, nên chạy song song.
  • Dùng danh mục 63 tỉnh cũ: sai — NQ 202/2025/QH15 quy định 34 tỉnh/TP, bỏ cấp huyện từ 01/07/2025.
  • Đồng nhất nghĩa vụ bảo vệ dữ liệu với một resource FHIR cụ thể: sai — phải đánh giá DPIA, consent, access control, audit và retention theo vai trò, mục đích xử lý và pháp luật áp dụng.

Tài nguyên tham khảo

Playbook · Nhà cung cấp HIS / EMR / LIS / Middleware

Công bố interface FHIR có phạm vi và bằng chứng conformance rõ ràng

Nhà cung cấp có thể giữ schema nội bộ và triển khai adapter VN Core, hoặc thay đổi mô hình dữ liệu sản phẩm khi có căn cứ. Quyết định phải dựa trên phạm vi use case, khả năng tái sử dụng, semantic loss, vận hành và total cost đã được tổ chức tự đánh giá.

Mốc hạn pháp lý liên quan: Nhà cung cấp phải dành đủ thời gian cho procurement, mapping, validation và operational acceptance trước mốc go-live của khách hàng; không có khoảng đệm cố định cho mọi sản phẩm.

Các bước chính

  1. Gate 1 · Reproducible setup

    Thiết lập môi trường dev

    Dựng HAPI FHIR hoặc Azure FHIR Service. Cài SUSHI + IG Publisher. Clone VN Core IG và build thành công trên máy dev.

    Output: Qua gate khi build/package version được khóa và môi trường có thể tái lập trong CI

  2. Gate 2 · Interface contract

    Triển khai layer tương thích

    Thiết kế adapter HIS native schema → FHIR cho use case đã chọn. Công bố interaction, profile, search parameter và security được hỗ trợ bằng CapabilityStatement; không mặc định hỗ trợ toàn bộ FHIR REST.

    Output: Qua gate khi interface contract, mapping và test fixtures được review và version hóa

  3. Gate 3 · Conformance evidence

    Conformance và validation

    Chạy FHIR Validator với VN Core IG. Xử lý tất cả errors; chấp nhận warnings có lý do rõ ràng. Tích hợp CI để validate mỗi commit.

    Output: Qua gate khi CI green cho phạm vi đã công bố, warnings được giải trình và test negative/security đạt yêu cầu

  4. Gate 4 · Operational pilot

    Triển khai tại khách hàng

    Pilot với khách hàng đã thống nhất phạm vi. Thu thập edge case, đo SLA, kiểm tra reconciliation/rollback và viết implementation report trước khi nhân rộng; đóng góp gap về VN Core qua issue/PR.

Sai lầm thường gặp

  • Hardcode danh mục tỉnh/xã: sai — danh mục ĐVHC thay đổi (NQ 202/2025/QH15); phải dùng CodeSystem của VN Core để update được.
  • Chỉ validate local: không phát hiện thiếu Must Support. Luôn chạy FHIR Validator chính thức với VN Core IG.
  • Bỏ qua Extensions VN: các trường như dân tộc, thẻ BHYT, tuyến KCB là đặc thù VN — không thể dùng US Core thay thế.
  • Tạo profile riêng của nhà cung cấp song song VN Core: phân mảnh hệ sinh thái; nên góp ý vào VN Core qua cộng đồng.

Tài nguyên tham khảo

Playbook · Cơ quan nhà nước / BYT / BHXH / Sở Y tế

Điều phối chuẩn dữ liệu liên thông trên quy mô ngành

VN Core là đóng góp mở trial-use, chưa phải tiêu chuẩn quốc gia chính thức. Các cơ quan có thể tham khảo để xây dựng hướng dẫn kỹ thuật, bổ trợ XML 4210, hoặc tài liệu hóa các quyết định sắp ban hành (Consent, EMR interoperability).

Mốc hạn pháp lý liên quan: Việc ổn định VN Core, chuẩn bị hồ sơ Affiliate và căn chỉnh chính sách phụ thuộc bằng chứng pilot, quy trình governance và phê duyệt của các cơ quan/tổ chức có thẩm quyền; không có ngày hoàn tất mặc định.

Các bước chính

  1. Giai đoạn 1

    Tham khảo và phản biện

    Đội ngũ kỹ thuật của Cục/Sở xem xét VN Core IG, xác nhận khớp thực tế nghiệp vụ, gửi phản biện qua kênh chính thức.

  2. Giai đoạn 2

    Pilot phối hợp

    Chọn nhóm cơ sở và đối tác đủ đại diện cho workflow cần kiểm chứng; định nghĩa trước dataset, tiêu chí thành công, trách nhiệm và phạm vi thử Claim/EOB.

  3. Giai đoạn 3

    Chính thức hóa từng phần

    Đưa các mảng phù hợp vào thông tư/quyết định (ví dụ: nhân khẩu học, thẻ BHYT, mã cận lâm sàng). Giữ tính tương thích ngược với XML 4210/3176.

  4. Giai đoạn 4

    Hỗ trợ thành lập HL7 Vietnam

    Chuẩn bị governance và hồ sơ Affiliate khi đủ điều kiện; chỉ chuyển giao stewardship sau khi có phê duyệt chính thức và kế hoạch continuity rõ ràng.

Sai lầm thường gặp

  • Ban hành standard trước khi có pilot thực tế: rủi ro mismatch với nghiệp vụ. VN Core ưu tiên pilot trước, chuẩn hóa sau.
  • Khóa cứng vào một nhà cung cấp duy nhất: VN Core mở theo CC-BY-4.0, bất kỳ nhà cung cấp nào cũng triển khai được.
  • Bỏ qua interoperability quốc tế: VN Core dựa trên FHIR R4 của HL7 International, giữ khả năng trao đổi với JP Core, KR Core, US Core.

Tài nguyên tham khảo

Bước tiếp theo

Cần trao đổi về lộ trình cụ thể cho tổ chức của bạn?

Đội ngũ Omi HealthTech sẵn sàng chia sẻ kinh nghiệm triển khai FHIR tại Việt Nam, Nhật Bản, Hàn Quốc và đồng hành trong giai đoạn khởi đầu.

Đặt lịch tư vấn 30 phút Đăng ký thí điểm