Implementation guide for digital medicines

This guidance is under active development by NHS Digital 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:


FHIR Resource Method Url
R4 MedicationRequest POST
R4 MedicationDispense POST
R4 MedicationStatement POST
STU3 MedicationRequest POST
STU3 MedicationDispense POST
STU3 MedicationStatement POST


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"?>
  <id value="urn:med-req-1023938" />
  <status value="active" />
  <intent value="order" />
      <system value="" />
      <code value="inpatient" />
      <display value="inpatient" />
    <reference value="urn:medication-38769117" />
    <display value="Amoxicillin" />
    <reference value="urn:patient-011223344" />
    <display value="Mrs Anne Teak" />
  <authoredOn value="2020-05-15T15:00:00Z" />
    <reference value="urn:staff-1112" />
    <display value="Dr Maikeu Well" />
    <reference value="urn:staff-1112" />
    <display value="Dr Maikeu Well" />
        <frequency value="3" />
        <period value="1" />
        <periodUnit value="d" />
        <system value="" />
        <code value="26643006" />
        <display value="oral" />
        <value value="500" />
        <unit value="milligram" />
        <system value="" />
        <code value="mg" />
    <allowedBoolean value="false" />

back to top