Directly Bookable service question

e-Referral Service (e-RS)
1

When a referral is booked directly to a service, the referral state is “BOOKED”.

When the service is set to add to the REFERRALS_FOR_REVIEW worklist the clinician will Accept or Reject the referral.

The state remains “BOOKED”, is there an indicator that they have Accepted/Rejected?

The only state I can find is that there is an additional participant in the appointment containing a smartcard id. But I cannot find detail on the API specification to explain.

2

Hi @will.maw ,

Thanks for your question.

You’re right that the top-level referral status remains active whether the referral has been accepted or rejected - that field only reflects active, completed, or cancelled.

The indicator you’re looking for is within the extension array of the A005 response. There is a referral state extension containing a nested extension with url = "state" and a valueCoding object. The code within that coding is what changes:

  • Rejected: the code will be REJECTED

  • Not yet reviewed / Accepted: the code will remain BOOKED

So rejection is identifiable via extension.extension.valueCoding.code, but acceptance is not distinguishable from pending review - both show as BOOKED.

Hope this helps,

Ed