task.status eReferral Lifecycle
Referral statuses can only be updated by the current referral receiver and cannot be updated by the sender or by the previous referral receiver. The table below reflects the tasks Ocean supports that can be processed when sent using the notify-add-process-request and/or the notify-update-process-request message events.
Additionally, Ocean doesn't support other statuses listed in the Task ValueSet outlined in the FHIR iGuide except those present in the table below.
| Sent Folders | Received Folders | task.status | Notes |
|---|---|---|---|
| Sent (All) | New | requested, received | When a referral is sent, it's automatically in the Sent/New folders, if any of these statuses are sent on it, no action will be taken, and it will remain in this folder. |
| Pending Booking | Pending Booking | accepted, in-progress, on-hold, ready | Ocean stores referrals in any of these statuses in the Pending Booking folders. |
| Booking Unconfirmed | Booking Unconfirmed | N/A | Ocean will be receiving an Appointment specific message event instead of a status specific message event, which will have an Appointment resource with a valid date to update the eReferral and put it in the 'Booking Unconfirmed' folder. |
| Booking Confirmed | Booking Confirmed | N/A | Ocean will be receiving an Appointment specific message event instead of a status specific message event, which will have an Appointment resource with a valid date to update the eReferral and put it in the 'Booking Confirmed' folder. |
| Awaiting Response | Awaiting Reply | N/A | A referral is only moved into this folder if a send-Communication message event is sent from the downstream system. A task specific message event will not update this folder. |
| Declined | Declined | rejected, cancelled | Declined referrals can be re-opened by sending the appropriate status and/or message event |
| Cancelled | Cancelled | N/A | Referrals can only be cancelled by the referral sender via Ocean and not a receiver. Therefore, no status update can be sent by the receiver for this action. |
| Completed | Completed | completed, failed | Completed referrals can be re-opened by sending the appropriate status and/or message event |