EPIC FHIR serviceRequest API requires category be included in the call. They describe setting category:
"Set category to the following token construction: system | code, where:
system: “http://snomed.info/sct”
code: “307835004”
The code SCTID: 307835004 represents the ‘Referral by service’, in order to find CRRN type of ServiceRequests. Either the patient, subject, or encounter must be provided."
Although in their request sample they use an oid in the category string:
https://hostname/instance/api/FHIR/R4/ServiceRequest?encounter=eTRU2xhVTNrmz..7ddqsWcES0.AzzXNW2l10ZVSu70KU3&category=1.2.840.114350.1.13.861.1.7.10.798268.30|7
A little confusing. We are looking for imaging studies. In the sandbox any call made not including the category, and only using patient id returns a valid json response of the test patient sent. Forming the category as they describe "http://snomed.info/sct|183829003" 183829003 Being snomed code for "Refer for imaging" returns same data including an added index stating:
:entry[9]:resource:issue[1]:details:coding[1]:code --- 59109
:entry[9]:resource:issue[1]:details:coding[1]:display --- An element value is invalid.
:entry[9]:resource:issue[1]:details:coding[1]:system --- urn:oid:1.2.840.114350.1.13.0.1.7.2.657369
:entry[9]:resource:issue[1]:details:text --- An element value is invalid.
:entry[9]:resource:issue[1]:diagnostics --- Invalid category: 183829003
Using code 721965002 "Laboratory Order" Returns the same informational warning along with record set. I have been stumped by this all day yesterday. I guess i am looking for a better understanding of this SNOMED category so i am able to build it correctly in code. Sending calls to this API in curl right now testing. Any explanation of this would be really helpful at this juncture.
That's just an example to show how you would pass in the system and value for the identifier. Providers are accustomed to placing orders for things, so referrals are usually entered as orders. And non-medication orders are returned by the ServiceRequest resource in Epic (as opposed to MedicationRequest for medications). That SNOMED code could be used to referrals to community services, for example,. That said, you don't have to use that particular category. As you've seen, usually an OID is used for the system within Epic, and the category would represent the order type (e.g., cardiology, pulmonary).