← Blog
Field note

Từ Epic App Orchard tới Showroom: tích hợp Epic năm 2026

Thien Nguyen · Nov 11, 2026

Năm 2026 bạn có thể tích hợp với Epic mà không trả Epic đồng nào: FHIR API công khai và các API theo chuẩn trên open.epic là miễn phí, tự phục vụ. Chỉ trả khi cần thêm: Vendor Services từ $1.900/năm cho tài liệu, sandbox và hỗ trợ của Epic, còn listing Connection Hub trên Showroom là $500 mỗi app mỗi năm.

App Orchard không còn nữa. Epic thay nó bằng Showroom, tách trải nghiệm developer thành open.epic (miễn phí, tự phục vụ) và Vendor Services (trả phí, có hỗ trợ), và liên tục thêm API: bản phát hành tháng 8/2026 hỗ trợ USCDI v5 và US Core 8, và Epic đã công bố hơn 50 API cho quy định prior authorization của CMS. Với CTO hay head of product, câu hỏi không còn là "có vào được Epic không?" mà là "đi đường nào, dùng API nào, và hàng đợi của từng health system kéo dài bao lâu?". Bài này tổng hợp những gì chính các trang của Epic nói, tính đến tháng 11/2026. BeevR không phải đối tác của Epic và không có listing trên Showroom.

Cái gì đã thay thế Epic App Orchard?

Showroom thay App Orchard làm marketplace của Epic. Công cụ cho developer giờ nằm ở hai nơi: open.epic (gồm Epic on FHIR tại fhir.epic.com) cho truy cập miễn phí, tự phục vụ, và Vendor Services cho hỗ trợ trả phí, tài liệu bổ sung và công cụ kiểm thử.

FAQ của Vendor Services định nghĩa các tầng sản phẩm trên Showroom:

  • Cornerstone Partners: công nghệ gắn liền với phần mềm Epic.
  • Toolbox: sản phẩm thuộc một số nhóm cụ thể, làm theo cách tích hợp Epic khuyến nghị (gọi là "Blueprint").
  • Toolbox Under Construction: các nhóm Toolbox mà khuyến nghị vẫn đang được viết.
  • Connection Hub: sản phẩm đã có kết nối thật với ít nhất một site Epic.

Hai điểm trong FAQ thay đổi cách bạn lập kế hoạch. Thứ nhất, không cần quan hệ đặc biệt nào để phát triển hay triển khai app. Thứ hai, listing Connection Hub không bắt buộc để khách hàng tải app của bạn. Showroom là marketing và phân hạng, không phải cửa chặn API.

Tích hợp với Epic năm 2026 tốn bao nhiêu?

Phí của chính Epic khá nhỏ: $0 cho open.epic, từ $1.900/năm cho Vendor Services, và $500 mỗi app mỗi năm cho listing Connection Hub. Chi phí thật nằm ở thời gian kỹ sư của bạn cộng với khối lượng việc IT và bảo mật ở từng health system, thứ mà không trang nào của Epic định giá giúp bạn.

Con đườngPhí Epic (công bố)Bạn nhận được gìKhi nào phù hợp
open.epic / Epic on FHIR$0Tài liệu FHIR và API theo chuẩn, sandbox tự phục vụ, đăng ký client ID, FHIR endpoint của khách hàngApp SMART on FHIR chuẩn, app truy cập cho bệnh nhân, tích hợp chủ yếu là đọc
Vendor ServicesTừ $1.900/năm; dùng thử 3 tháng, hủy được hoàn tiền trừ dịch vụ đã dùngTài liệu bổ sung, API riêng của Epic, spec HL7 v2 và X12, sandbox mở rộng, Hyperspace Simulator, Hyperdrive harness, ticket Sherlock, hỗ trợ thiết kếTích hợp sâu vào workflow, API riêng của Epic, app nhúng, làm interface
Showroom Connection Hub$500 mỗi app mỗi nămListing công khai; phải cam kết có ít nhất một kết nối Epic đang chạyTiếp thị tới thêm khách hàng Epic sau lần go-live đầu
ToolboxKhông công bốPhân hạng do Epic cấp cho sản phẩm theo Blueprint của nhómSản phẩm thuộc nhóm Epic đã định nghĩa

Nguồn: giá và điều kiện dùng thử Vendor Services lấy từ FAQ Vendor Services của Epic; phí $500 Connection Hub lấy từ tài liệu Vendor Services của Epic và bài của Fierce Healthcare khi Showroom ra mắt. FAQ của Epic ghi bạn tự bán trực tiếp cho khách hàng và tự đàm phán giá, điều khoản; các tài liệu này của Epic không nhắc tới chia doanh thu.

Biểu đồ cột phí developer Epic công bố theo năm: open.epic và Epic on FHIR $0; listing Showroom Connection Hub $500 mỗi app mỗi năm, cần một kết nối Epic đang chạy; Vendor Services từ $1.900 mỗi năm.
Phí của Epic nhỏ; thời gian của IT bên health system mới là chi phí thật.

API nào của Epic là miễn phí?

Epic cho biết danh mục API công khai và theo chuẩn ngành trên open.epic được cung cấp cho developer mà không tính thêm phí. open.epic đếm được hơn 750 API và interface miễn phí, và 3.423 app đang chạy dùng web service của họ.

Những bổ sung gần đây đáng đưa vào roadmap 2026:

  • USCDI v5 và US Core 8 trong bản phát hành tháng 8/2026, gồm chỉ thị y tế trước (advance directives), mong muốn về trải nghiệm chăm sóc và dữ liệu tuân thủ dùng thuốc.
  • Hơn 50 API và playbook cho CMS-0057-F (prior authorization, Provider Access, Payer-to-Payer). Các payer thuộc diện áp dụng có hạn chót API chủ yếu vào 01/01/2027, nên prior auth và trao đổi payer–provider là mảng tích hợp Epic sôi động nhất năm nay.
  • Một MCP server của open.epic cho phép AI client tìm kiếm tài liệu và spec trên open.epic. Đây là công cụ tra tài liệu, không phải kênh truyền PHI.
  • Hơn 40 playbook cho developer và mẫu tạo client ID "một cú nhấp" với các API khuyến nghị đã chọn sẵn.

Những gì open.epic không cho bạn: API riêng (không theo chuẩn) của Epic, kiểm thử nhúng trên desktop và mobile, spec interface HL7 v2 và X12, và hỗ trợ trực tiếp từ kỹ sư Epic. Đó là phạm vi của Vendor Services.

Bốn chỉ số từ open.epic tháng 11/2026: hơn 750 API và interface miễn phí; 3.423 app đang chạy dùng web service của open.epic; hơn 50 API cho quy định prior authorization CMS-0057-F; hỗ trợ USCDI v5 và US Core 8 trong bản phát hành tháng 8/2026.
Danh mục miễn phí tiếp tục mở rộng, dẫn đầu là CMS-0057 và USCDI v5.

Xác thực backend (server-to-server) với Epic hoạt động thế nào?

Epic theo profile SMART Backend Services với client-credentials grant dùng JWT đã ký, dù hiện vẫn khác profile này ở một số điểm. Bạn đăng ký một JWK Set URL, ký một JWT sống ngắn, rồi đổi lấy access token. Mỗi health system còn phải ánh xạ backend client của bạn vào một user để hoạt động của nó được audit.

Các chi tiết trong đặc tả OAuth 2.0 của Epic hay làm các đội vấp:

  • Thuật toán: RS256, RS384 và RS512 cho mọi confidential client; ES256 và ES384 chỉ cho client đăng ký JWK Set URL. Epic khuyến nghị app mới dùng JWKS URL với khóa elliptic-curve.
  • Thời hạn JWT: exp không được quá 5 phút trong tương lai.
  • Chống replay: jti tối đa 151 ký tự và không được dùng lại khi JWT còn hiệu lực.
  • Khóa tách biệt: Epic không chấp nhận JWKS URL của môi trường non-production làm URL production cho app mới. Hãy dùng cặp khóa riêng cho từng môi trường.
  • Cấu hình phía khách hàng: ngoài sandbox, health system phải cấu hình để audit truy cập của backend app. Hãy tính thời gian cho việc này ở mỗi lần go-live.

Chúng tôi đi sâu về thiết kế scope, xoay vòng khóa và rủi ro riêng của AI agent trong bài SMART on FHIR backend services.

Có ghi dữ liệu ngược vào Epic được không?

Được, với một số resource cụ thể. Epic cho biết họ hỗ trợ thao tác đọc và ghi cho hàng chục resource và sub-resource FHIR, cùng CDS Hooks (patient-view và order-sign) và API riêng của Epic ở những chỗ chuẩn chưa có. Ghi được gì phụ thuộc vào API, phiên bản Epic và cấu hình của health system.

Quyền ghi nâng cao yêu cầu. Health system sẽ hỏi app của bạn ghi gì, ai duyệt, sửa sai thế nào, và mỗi hành động được quy cho ai. Với tính năng AI, đây là câu hỏi thiết kế chính chứ không phải chi tiết. Một model soạn nháp và một con người lưu vào hồ sơ dễ được duyệt hơn nhiều so với một model tự lưu. Chúng tôi giải thích mẫu này trong bài AI có người giám sát trong ngành chịu quản lý.

Bulk FHIR của Epic có hợp cho phân tích và dữ liệu huấn luyện AI không?

Chỉ hợp cho một số việc. Epic chỉ hỗ trợ thao tác Group export (Bulk Data 1.0.1 cộng một số tính năng mới hơn), không hỗ trợ _since, và xếp việc đồng bộ data warehouse và nạp dữ liệu tăng dần vào nhóm use case không phù hợp. Kết quả được giữ 14 ngày rồi bị xóa.

Hướng dẫn bulk data của Epic còn cảnh báo các lần export chạy trên database vận hành của tổ chức, và khuyên kiểm tra trạng thái mỗi 10 phút với nhóm dưới 100 bệnh nhân, mỗi 30 phút với nhóm lớn hơn. Phù hợp là các lần export định kỳ cho một cohort xác định hoặc nộp dữ liệu cho registry. Với pipeline phân tích hay AI đầy đủ, hãy hỏi health system về các lựa chọn data warehouse của Epic. Bài bulk FHIR export cho phân tích và AI phân tích chi tiết các đánh đổi.

Một dự án tích hợp Epic mất bao lâu?

Phần build của bạn có thể chỉ vài tuần; ngày go-live thường do phía health system quyết. Epic nói việc đăng ký, kết nối và go-live có thể làm trên open.epic mà không cần Epic tham gia, nhưng mỗi khách hàng vẫn tự chạy đánh giá bảo mật, cấu hình của analyst, kiểm thử và quy trình quản lý thay đổi.

Epic liệt kê ba nhóm bạn làm việc cùng ở mỗi khách hàng: vận hành (trưởng khoa, người đại diện lâm sàng), IT (analyst có chứng chỉ Epic), và nhân viên hỗ trợ của Epic khi cần. Hãy lên kế hoạch cho:

  1. Chốt phạm vi với khách hàng: API nào, scope nào, backend client ánh xạ vào user nào.
  2. Đánh giá bảo mật: bảng câu hỏi, BAA, bằng chứng pentest, sơ đồ luồng dữ liệu. Có báo cáo SOC 2 sẽ rút ngắn bước này.
  3. Analyst cấu hình và kiểm thử trên môi trường non-production của khách hàng.
  4. Go-live và giám sát, kể cả khi bản nâng cấp Epic làm thay đổi hành vi.

Epic không công bố các mốc thời gian này, và chúng khác nhau rất nhiều giữa các health system. Đừng hứa ngày với khách hàng khi đội IT của họ chưa xếp lịch.

Nên dùng open.epic, Vendor Services hay cả hai?

Bắt đầu với open.epic. Chuyển sang Vendor Services khi bạn cần API riêng của Epic, workflow nhúng (Hyperspace, Hyperdrive, MyChart, mobile), interface HL7 v2 hay X12, hoặc cần Epic góp ý thiết kế. Lên Connection Hub sau khách hàng đầu tiên đã chạy thật, khi bạn muốn các khách hàng Epic khác tìm thấy mình.

Dấu hiệu bạn cần Vendor Services

  • Workflow cần một API không có trong danh mục công khai.
  • Bạn cần kiểm thử bên trong client của Epic (Hyperspace Simulator hay Hyperdrive harness).
  • Bạn đang xây interface (ADT, chỉ định, kết quả) chứ không phải app.
  • Bạn muốn Epic góp ý thiết kế trước khi analyst của health system xem xét.

Dấu hiệu bạn chưa cần

  • App dùng resource FHIR chuẩn và SMART launch.
  • Bạn đang chứng minh sản phẩm với một health system đối tác thiết kế trước.

Các dự án Epic thường hỏng ở đâu?

Những lỗi quen thuộc: build trên dữ liệu sandbox chẳng giống production, cho rằng mọi health system bật cùng một bộ API, bỏ qua việc ánh xạ backend client vào user ở từng khách hàng, và coi listing Showroom là vạch đích.

Tính năng AI thêm ba lỗi nữa: gửi cho model nhiều PHI hơn mức việc cần, để model ghi vào hồ sơ mà không ai duyệt, và không có bộ đánh giá chứng minh tính năng chạy đúng trên dữ liệu thực tế trước khi go-live. Xem bài AI agent tuân thủ HIPAA cho các lớp kiểm soát, và kiểm thử LLM cho ngành chịu quản lý cho phần đánh giá.

BeevR làm việc này thế nào

Chúng tôi xây phần ứng dụng của các tích hợp Epic: app SMART on FHIR, backend service với quản lý khóa JWKS, pipeline bulk export, và tính năng AI soạn nháp để bác sĩ duyệt. Chúng tôi làm dựa trên tài liệu công khai của Epic và môi trường của khách hàng; chúng tôi không phải đối tác Epic, và sẽ nói thẳng khi một sản phẩm native của Epic hay sản phẩm mua sẵn là lựa chọn tốt hơn. Mọi hành động đều được ghi log, scope ở mức tối thiểu, và không có gì được ghi vào hồ sơ bệnh án khi chưa có người xác nhận. BeevR ký BAA với tư cách business associate, AI model có thể chạy trong chính tài khoản AWS của bạn theo AWS BAA, và bạn sở hữu source code và IP từ ngày đầu.

Đội senior do founder dẫn dắt ở Hà Nội đang vận hành một EHR multi-tenant ở bốn phòng khám tại Mỹ với khoảng 300 bệnh nhân mỗi ngày, và bạn xem demo chạy được mỗi thứ Sáu. Dự án chạy theo từng giai đoạn phạm vi cố định, giá cố định, từ $10K mỗi giai đoạn. Xem dịch vụ tích hợp EHR và phát triển AI agent cho y tế.

Đang lên kế hoạch tích hợp Epic cho 2027? Đặt lịch gọi 30 phút, chúng tôi sẽ đối chiếu use case của bạn với con đường Epic, các API và các bước phía khách hàng mà nó thực sự cần.