Implementation guide for interoperable medicines

This guidance is under active development by NHS England and content may be added or updated on a regular basis.

Step 6: Send FHIR to the assurance tool

Setting up a collection

We recommend setting up a collection of queries to enable you to easily locate which are you need to test.

For example:

api-client-collection

Endpoints

FHIR Resource Method Url
R4 MedicationRequest POST http://192.168.128.27:8080/R4/MedicationRequest
R4 MedicationDispense POST http://192.168.128.27:8080/R4/MedicationDispense
R4 MedicationStatement POST http://192.168.128.27:8080/R4/MedicationStatement
STU3 MedicationRequest POST http://192.168.128.27:8080/STU3/MedicationRequest
STU3 MedicationDispense POST http://192.168.128.27:8080/STU3/MedicationDispense
STU3 MedicationStatement POST http://192.168.128.27:8080/STU3/MedicationStatement

Headers

Key Value Description
fromASID {value} This will be provided in the email from the Self-Assurance Service Desk
toASID 111111111111 A test value not authenticated by the test tool
Accept application/fhir+xml If using xml, application/fhir+json, if json
Content-Type application/fhir+xml If using xml, application/fhir+json, if json

Sending FHIR

Paste the appropriate FHIR within each query into the request body are of the API client. Ensure that the type is apporprioately set (e.g. xml or json).

Press Send.

Providing you're connected to OpenTest, and have setup the headers correctly, you will receive a 201: No Content response from the assurance tool.

Example MedicationRequest XML payload

<?xml version="1.0" encoding="utf-16"?>
<MedicationRequest>
  <id value="urn:med-req-1023938" />
  <status value="active" />
  <intent value="order" />
  <category>
    <coding>
      <system value="http://terminology.hl7.org/CodeSystem/medicationrequest-category" />
      <code value="inpatient" />
      <display value="inpatient" />
    </coding>
  </category>
  <medicationReference>
    <reference value="urn:medication-38769117" />
    <display value="Amoxicillin" />
  </medicationReference>
  <subject>
    <reference value="urn:patient-011223344" />
    <display value="Mrs Anne Teak" />
  </subject>
  <authoredOn value="2020-05-15T15:00:00Z" />
  <requester>
    <reference value="urn:staff-1112" />
    <display value="Dr Maikeu Well" />
  </requester>
  <recorder>
    <reference value="urn:staff-1112" />
    <display value="Dr Maikeu Well" />
  </recorder>
  <dosageInstruction>
    <timing>
      <repeat>
        <frequency value="3" />
        <period value="1" />
        <periodUnit value="d" />
      </repeat>
    </timing>
    <route>
      <coding>
        <system value="http://snomed.info/sct" />
        <code value="26643006" />
        <display value="oral" />
      </coding>
    </route>
    <doseAndRate>
      <doseQuantity>
        <value value="500" />
        <unit value="milligram" />
        <system value="http://unitsofmeasure.org" />
        <code value="mg" />
      </doseQuantity>
    </doseAndRate>
  </dosageInstruction>
  <substitution>
    <allowedBoolean value="false" />
  </substitution>
</MedicationRequest>
back to top