Epic & Cerner Integration

Epic sandbox

Register your app

1. Go to fhir.epic.com → My Apps → Create app
2. Set redirect URI: http://localhost:8081/callback (dev) or your production URL
3. Set launch URI: http://localhost:8081/launch
4. Copy the non-production client ID

Configure

# .env
EPIC_CLIENT_ID=your-non-production-client-id

Test

Use Epic's SMART launcher at https://fhir.epic.com/interconnect-amrs-fhir/oauth2/authorize with iss=https://fhir.epic.com/interconnect-amrs-fhir/api/FHIR/R4.

Cerner / Oracle Health

Known differences from Epic

Feature	Epic	Cerner
Scope format	patient/Patient.rs	patient/Patient.read
Token extras	patient, encounter	Same field names
PKCE	Required	Required
aud parameter	Required	Required

Scope normalisation

The platform normalises both formats — .read is accepted alongside .rs. SmartScopeAuthorizationInterceptor.normaliseOps() maps:

• .read → rs
• .write → cud

Register on Oracle Health code Console

1. Go to code.cerner.com → Create developer account
2. Register app with redirect URI and scopes using .read format
3. Wait 15 minutes for configuration to propagate

Cerner sandbox ISS

https://fhir-myrecord.cerner.com/r4/{tenant-id}