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. Email Ocean Support with the email domain that you will be using during technical development and testing (e.g. to register new users, receive referral notifications, etc.).  Please identify the name of your company and integration project sponsor (e.g. a clinical or jurisdictional organization).
  2. Create an Ocean user account and site in test.cognisantmd.com
  3. Generate the site's Shared Encryption Key (SEK).
  4. Enable Cloud Connect within the Ocean Portal - see the "Enable Ocean Cloud Connect" section.
  5. Access Cloud Connect and store the SEK  - see Steps 1 and 2.
  6. Configure the API endpoint for your EMR/CMS - HL7 FHIR eReferral tab > Step 1
  7. Set up the service directory listing for your site - complete the basic details for the listing and under "eReferral Policy", enable 'Accept eReferrals'. 
  8. Establish a linkage between the service directory listing and the API endpoint - HL7 FHIR eReferral tab > Step 2.
  9. Create a second site (by accessing My Account (top right menu) and clicking on 'Create New Site'.  (This is so that you can mimic the actual referral workflow of a referral being sent to and from one Ocean site to the 'service provider' site that is supported by your integration.  You only need to complete)
  10. In the second ('sender') site, search for the 'service provider' directory listing (of the first site) in the Ocean Healthmap and submit an eReferral.


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