EMR Integration Overview

Vigil integrates with EMR systems to synchronize patient data and clinical documentation.

Data Flows

Inbound (EMR → Vigil)

Data Type	Method	Trigger
Patient census	HL7 ADT	Admit/discharge/transfer
Observation levels	FHIR Order	Physician order change

ADT Messages:

• A01 (Admit) - Creates patient in Vigil
• A02 (Transfer) - Updates patient location
• A03 (Discharge) - Marks patient as discharged

Outbound (Vigil → EMR)

Data Type	Method	Frequency
Observations	FHIR Observation	Real-time
Vital signs	FHIR Observation	Real-time
Assessments	FHIR Observation	Real-time

Data syncs within minutes of documentation in Vigil.

Configuration

Configure EMR integration at Settings > Integrations > Config tab.

Required Settings

Setting	Description
EMR Type	Epic, Cerner, MEDITECH, or Custom
FHIR Base URL	EMR's FHIR R4 endpoint
Auth URL	OAuth2 token endpoint
Client ID	OAuth2 client identifier
Client Secret	OAuth2 client secret

Optional Settings

Setting	Description
Scopes	Required OAuth2 scopes
HL7 Version	2.4, 2.5, or 2.5.1
FHIR Version	R4 or STU3
SMART Launch URL	For patient context launch

Patient Matching

Vigil matches patients between systems using:

Method	Fields
MRN only	Medical Record Number
MRN + DOB	MRN and Date of Birth
SSN + DOB	Last 4 SSN and Date of Birth

Configure matching method based on your facility's policies.

Data Flow Toggles

Enable or disable specific data flows:

Flow	Direction	Default
Patient Census	Inbound	Enabled
Observations	Outbound	Enabled
Vitals	Outbound	Enabled
Assessments	Outbound	Enabled

Testing the Connection

1. Navigate to Settings > Integrations
2. On the Status tab, tap Test Connection
3. Vigil attempts to:
   • Authenticate with your EMR
   • Verify FHIR endpoint accessibility
   • Check required permissions
4. Results show:
   • FHIR version
   • Available resources
   • Permission status

Monitoring

Status Tab

View real-time connection status:

• Connected - Integration working normally
• Degraded - Some sync failures occurring
• Not Connected - Integration not configured
• Token Expired - Re-authentication needed

Sync Statistics

Track sync health:

• Total syncs
• Successful syncs
• Failed syncs
• Pending syncs

Sync Log

View individual sync events:

1. Navigate to Sync Log tab
2. Filter by:
   • All / Failed Only
   • Date range
3. See sync details:
   • Timestamp
   • Data type
   • Status
   • Error message (if failed)

Retrying Failed Syncs

Failed syncs retry automatically. To manually retry:

1. Find the failed sync in the log
2. Tap Retry
3. Monitor for success

ADT Log

View incoming ADT messages:

1. Navigate to ADT Log tab
2. See received messages:
   • Timestamp
   • Message type (A01, A02, A03)
   • Patient identifier
   • Processing status

Security

EMR credentials are:

• Encrypted at rest
• Never logged or displayed
• Transmitted only over HTTPS
• Stored in Vigil's secure credential vault

See Security for details.