Yes, active referrals in Ocean can be resent to a FHIR or Open API endpoint.
This is helpful in the case where an Ocean Site originally received referrals without an integration, but then subsequently configured a FHIR or Open API integration, and would now like to send the referrals received prior to the integration into the newly integrated system.
This functionality is also valuable in the case where a user may want to send an active referral (that may already have engaged the integration) as an update to the integration. This may be because a previous attempt to send an event failed.
- In the Ocean Portal, open the 'Menu' and select 'Admin'.
-
- Select 'Integrations'.
-
- In the 'Referral Integrations' table, click the 'Bulk Actions' button for the relevant integration.
-
- Click the 'Upload file' button to upload a CSV file (without a header row) containing the referral reference values for the referrals that should be resent to the FHIR or Open API endpoint.
-
- Use the dropdown to select an action ("Send as a new referral", or "Send as an updated referral").
- Click 'Submit'.
-
After submission, a CSV file will be downloaded to your computer that includes the list of referral reference values and whether Ocean can perform the update to it. Ocean will automatically proceed to begin sending the referrals.
Note: The referrals will be sent in a phased manner so that they do not overwhelm the receiving API endpoint. If a large number of referrals are being actioned, please allow several hours before validating that they have all arrived in the receiving system.
Advanced Notes
- Only 1000 referral reference values can be uploaded at one time.
- Patients, referrers, and recipients will not be notified about this new referral event.
- There is no impact to referral analytics.
- There is no impact to referral retention/purge timelines.
- An event will be added to the Event Log within the referral to indicate that the referral has been ‘resent’ via the webhook.
- Ocean will avoid resending a duplicate referral on behalf of a listing that is feeding a Service Request Repository.
- Ocean will include all of the existing appointment info and/or messaging that has been sent between providers to-date as part of either the 'Send as a new referral' or 'Send as an updated referral' actions.
- The add-service-request ServiceRequest will contain the original date that the referral was received so that the chronological order is maintained