Epic Integration

This guide covers connecting Ward to Epic.

Prerequisites

Before starting, you need:

• App registration via Epic on FHIR
• FHIR R4 endpoint URL
• SMART Backend Services credentials (client ID and signing key)
• Required scopes approved

Work with your Epic administrator to obtain these credentials.

Required Scopes

Request these FHIR scopes:

Scope	Purpose
system/Patient.read	Read patient demographics
system/Observation.read	Read existing observations
system/Observation.write	Write observations from Ward

Configuration Steps

1. Access Integration Settings

1. Sign in to Ward as IT Admin
2. Navigate to Management → Integrations
3. Tap Config tab

2. Configure EMR Connection

Field	Value
EMR Type	Epic
FHIR Base URL	https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4 (example)
Auth URL	https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token (example)
Client ID	From Epic on FHIR registration
Client Secret	JWT signing key from Epic
FHIR Version	R4

3. Configure Patient Matching

Select matching method based on your Epic configuration:

• MRN - Match on Epic MRN
• MRN + DOB - Match on MRN and date of birth

4. Configure Data Flows

Enable desired data flows:

• ✓ Patient Census (Inbound)
• ✓ Observations (Outbound)
• ✓ Vitals (Outbound)
• ✓ Assessments (Outbound)

5. Test Connection

1. Tap Save
2. Return to Status tab
3. Tap Test Connection
4. Verify successful connection

ADT Integration

To receive patient census updates:

Epic Configuration

1. Configure Epic to send ADT messages to Ward's webhook
2. Use HL7 v2.5.1 format
3. Include these segments:
   • MSH (Message Header)
   • EVN (Event Type)
   • PID (Patient Identification)
   • PV1 (Patient Visit)

Ward Configuration

1. Navigate to Config tab
2. Set HL7 Version to 2.5.1
3. Note the Webhook URL displayed
4. Provide this URL to your Epic administrator

ADT Events

Event	Epic Action	Ward Action
A01	Admit	Create patient
A02	Transfer	Update unit/room
A03	Discharge	Mark discharged
A08	Update	Update demographics

SMART on FHIR Launch

Enable launching Ward directly from Epic:

Configuration

1. In Config tab, set SMART Launch URL
2. Provide this URL to your Epic administrator
3. Epic configures a hyperlink or button

Usage

1. Staff clicks Ward link in Epic
2. Ward opens to the correct patient context
3. No additional sign-in required (SSO)

Troubleshooting

Connection fails

• Verify FHIR Base URL is accessible from Ward
• Check client credentials are correct
• Ensure required scopes are approved

Syncs failing

• Check Sync Log for error messages
• Verify patient exists in Epic (matching may fail)
• Review OAuth token expiration

ADT not arriving

• Verify Epic is configured to send to correct URL
• Check network connectivity
• Review ADT Log for received messages

Contact your Epic administrator and Ward support for complex issues.