HL7 FHIR eReferral Integration Setup Guide


Getting Started With the Integration

Service providers can manage Ocean eReferrals within their patient electronic medical record (EMR) or client management system (CMS) through integration with Ocean.  The integration enables:
  • eReferrals to appear within the EMR/CMS without requiring initial activity within the Ocean portal;
  • Status updates to the eReferral (e.g. accepted, booked, cancelled) to be sent to Ocean (which will result in a notification to the provider and patient);
  • Updates to the patient's core demographics to be sent to Ocean;
  • Referral-related communication to be added to the referral (e.g. patient or provider instructions, attachments.)


Receiving Referrals from Ocean

The following setup guide is intended to provide software developers with the preliminary steps required to prepare an Ocean site for integration with an EMR/CMS.  Additional detail for each step is provided in the linked support articles. Completion of these steps will enable the testing of non-authenticated connectivity and receipt of the Ocean HL7 FHIR eReferral resource bundle.   

  1. Create an Ocean user account and site (click on the "Other EMRs" button).
  2. Generate the site's Shared Encryption Key (SEK).
  3. Enable Cloud Connect within the Ocean Portal - see the "Enable Ocean Cloud Connect" section.
  4. Access Cloud Connect and store the SEK  - see Steps 1 and 2.
  5. Configure the API endpoint for your EMR/CMS - HL7 FHIR eReferral tab > Step 1
  6. Set up the service directory listing for your site - complete the basic details for the listing and under "eReferral Policy", enable 'Accept eReferrals'. 
  7. Establish a linkage between the service directory listing and the API endpoint - HL7 FHIR eReferral tab > Step 2.

  8. Create a new inbound eReferral within Ocean


Sending Referral Updates to Ocean

In order for the EMR/CMS to send updates to Ocean, the following additional setup steps are necessary. The HL7 FHIR APIs that support the eReferral messaging lifecycle are described in a separate API documentation.

  1. Set up the site-specific OAuth2 credentials to communicate with Ocean - HL7 FHIR eReferral tab > Step 3.



Have more questions? Submit a request