A029 Available actions for user - Returning unexpected blank array

Hello e-RS Team,

I’m attempting to use A029 to ensure we only display what actions are available to the user, however it is unexpected return an empty. The steps are as follows:

  • Create referral for review - calling A029 as a ‘REFERRING_CLINICIAN’ returns actions as expected.
  • Send referral for triage
  • Either via API or in e-RS itself record a triage outcome
  • Logging in as a ‘SERVICE_PROVIDER_CLINICIAN’ I now get an empty array when calling A029, however logging in to e-RS as ‘SERVICE_PROVIDER_CLINICIAN’ I can actions are available to me for that referral

Could you please advise when I get no actions returned via the API?

Kind regards,
Birch

Hi @chris.birch - Thanks for reaching out and welcome to the community!

The A029 API endpoint does not currently support the return of all available actions.

In fact, for a Service Provider, the only action it will ever return is RECORD_REVIEW_OUTCOME, the rest are all referrer actions:

  • CREATE_APPOINTMENT
  • CHANGE_SHORTLIST
  • CHANGE_SHORTLIST_AND_SEND_FOR_TRIAGE
  • CANCEL_REFERRAL
  • CANCEL_DIRECTLY_BOOKED_APPOINTMENT

Were you after a specific action?

Thanks,
Z.

Thanks for the response.

It was for actions like these as a service provider, I think if A029 doesn’t do this then we will have to work out what the user can do based on the state of the referral then and what worklist it is in.

Kind regards,
Birch

Hi @chris.birch -

Yes. Actions like ‘Accept’ (A013), ‘Reject’ (A014) and ‘Request admin to rebook’ (A022) are actioned via the Referrals for Review worklist so those should be straightforward to determine.

The other actions aren’t supported via the API hence are not returned via A029.

Thanks,
Z.