How do we retrieve referring clinician from the referral?

When pulling referral information, using A005, how do we get details of the Referring Organisation and User (i.e. GP Practice and GP name, but could also be a dentist, optician etc.)?

We need this information so that patient letters etc. can be sent to the referrer, rather than the patient’s registered GP (which could be different), but have been advised that these pieces of information are not available in the ReferralRequest and are only available in the Clinical Information PDF.

I can’t believe that we are the only Trust to have come across this issue, so interested to hear how others have approached it.

What identifiers do you have about the referrer?

Is it GMP/GMC codes or SDS user id’s.

(not an NHSEngland response to your question)

Hi @phil.walker3 - Thanks for reaching out.

I can’t speak for other Trusts in this regard but as discussed over email the referring org and user is only available via the clinical referral information PDF (A007) at the moment.

We can look to add them to A005 if you have time to raise a user need here:

Thanks,
Z.

Might be useful to include this link in the request

https://profiles.ihe.net/ITI/mCSD/ITI-90.html#23904124-practitioner-resource-message-semantics

This is probably the API you need from SDS/ODS/DoS(s) (it’s not really an eRS specific use case).

The use case for this is quite well described on this page IHE.ITI.MCSD\1:46 Mobile Care Services Discovery (mCSD) - FHIR v4.0.1

We have now ran into this issue, i’ve filled the form out. This will be a problem as we are hoping to use the upcoming healhcare worker api . Ideally the A005 and A008 endpoints would include the SDS ID of the referring clinician

Kind regards
Gareth

@gareth.perkins @zubeir.tai the form to request better conversation data in the API response appears to have stopped working.

What’s the current state of play with turning the opaque “who said” results from the API into a actual human-meaningful name (department, hospital, … ) ?

we use the Healthcare Worker API

Ohhh kaaayyyy … another API to onboard with :slight_smile:

So how do we take a A025 conversation entries’ valueReference.reference ( “PractitionerRole/103264992985.R69.REFERRING-CLINICIAN” ) and pass that to https://digital.nhs.uk/developer/api-catalogue/healthcare-worker-fhir#get-/Practitioner ?

Do we take the 1’st numeric substring (“103264992985”) to be “identifier” ?

Can anyone confirm that’s the correct approach, before we go through all the trouble with the NHS of onboarding to the healthcare worker API only to find out it doesn’t actually solve the issue ?

Hi - this is for the HCW API team to answer, let me tag them for you

@Sarah_Bucknall - could you please take a look at this question? Many thanks

Hi @tc1 - currently Healthcare worker API only uses the Practitioner’s SDS User ID as an identifier - which will return their name and roles assigned. Only active users details will be returned. I’m guessing the example you are sharing above is a role profile ID? You’ll need the SSD User ID (or Smartcard ID) to use as an identifier as things stand. The API is currently in BETA and we are planning to add additional identifiers over the coming months. Role profile ID will be included as an identifier in the API - but not currently available.

Hi @Sarah_Bucknall - thanks for chipping in.

Maybe I’m asking the wrong thing, or quoteing the wrong part of the eRS API response :slight_smile:

Each conversation entry of resourceType=Communication seems to have a sender prop that boils down to something like refererence=PractitionerRole/555384914100.H3G9K.SERVICE-PROVIDER-CLINICIAN right ?

Those are in turn listed as resourceType=PractitionerRole entries, which include entries like

{
"practitioner": {
"identifier": {
"system": "``http://fhir.nhs.net/Id/sds-user-id``",
"value": "555384914100"
}
}
}

Can I take the value prop from there and use with the Healthcare worker API to find out some ones name ?

Hi @tc1 - sds-user-id identifier value is the one you need for Healthcare worker API. I am not familiar with the eRS sender prop, but if you’re seeing the identifier sds-user-id - then you can use this to get practitioner details including name from Healthcare worker API.

Awesome, thanks !

We’ll go ahead and get setup for this API as well as eRS then.