Retreive Referral worklist A008 lookups for Review Reason

e-Referral Service (e-RS) e-Referral Service FHIR API
1

Hi We are using the A008 API to retrieve the ASI worklist for a trust and have noticed that the reason for adding to the list is a coded value

“valueCodeableConcept”:

{

“coding”:

[

{

“system”: “https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1”,

“code”: “NO_SLOTS_AT_SERVICE”

}

I cant seem to find this value in the A004 Retrieve Reference data API, am I missing something?

2

Thanks for using the forum Steve - I’ll notify one of the team to have a look at this for you

3

Hi Steve, I will have a look into this now for you :slight_smile:

4

Hi Steve,

Thanks for flagging this, this value genuinely isn’t retrievable from A004.

The eRSReviewReason-1 code system used here is a static, fixed set of codes rather than dynamic reference data. A004 only serves dynamic codeSystemType values such as SPECIALTY, CLINIC-TYPE, APPOINTMENT-CANCELLATION-REASON etc.

Instead, the full set of possible codes for eRS-ReviewReason-1 is documented directly in the OAS Specification itself, whenever a “reason” field can appear. The complete fixed list isshown in the “code: enum” section below:

image
image1136×523 9.98 KB

We’d recommend hard coding these four values on your side rather than trying to resolve them via A004, the spec’s enum definition for this field is the source of truth and wont need a reference data lookup.

Hope this helps,

George