OperationDefinition
prepare
Invocations
URL: [base]/$prepare
This operation changes content
Parameters (In)
| Name | Cardinality | Type | Documentation |
|---|
| content | 1..1 | Bundle | The prescription order message to process (without Provence resource) |
Return Values (Out)
| Name | Cardinality | Type | Documentation |
|---|
| digest | 1..1 | string | Message Digest response containing the signed signature in XML format |
| algorithm | 1..1 | string | |
| timestamp | 1..1 | string | dateTime when the digest was created |
This operation does not use the parameters resource for input parameters, it does for the response. \n\n A server may return one of several status codes: \n\n * 200 OK: Indicates that the message has been fully processed.
{
"id": "MessageHeader-prepare-message",
"url": "https://fhir.nhs.uk/OperationDefinition/MessageHeader-prepare-message",
"name": "MessageheaderPrepareMessage",
"date": "2020-08-03T00:00:00+00:00",
{
{
"value": "interoperabilityteam@nhs.net"
}
]
}
],
"description": "Convert a prescription in FHIR format into the canonicalised HL7 V3 signature fragments which should be signed by the prescriber.",
"comment": "This operation does not use the parameters resource for input parameters, it does for the response. \\n\\n A server may return one of several status codes: \\n\\n * **200 OK**: Indicates that the message has been fully processed.",
{
"documentation": "The prescription order message to process (without Provence resource)",
},
{
"documentation": "Message Digest response containing the signed signature in XML format",
},
{
},
{
}
]
}
<id value="MessageHeader-prepare-message" />
<url value="https://fhir.nhs.uk/OperationDefinition/MessageHeader-prepare-message" />
<name value="MessageheaderPrepareMessage" />
<kind value="operation" />
<date value="2020-08-03T00:00:00+00:00" />
<value value="interoperabilityteam@nhs.net" />
</telecom>
</contact>
<description value="Convert a prescription in FHIR format into the canonicalised HL7 V3 signature fragments which should be signed by the prescriber." />
<comment value="This operation does not use the parameters resource for input parameters, it does for the response. \n\n A server may return one of several status codes: \n\n * **200 OK**: Indicates that the message has been fully processed." />
<documentation value="The prescription order message to process (without Provence resource)" />
</parameter>
<documentation value="Message Digest response containing the signed signature in XML format" />
</parameter>
<name value="algorithm" />
</parameter>
<name value="timestamp" />
</parameter>
</OperationDefinition>
release
Invocations
URL: [base]/Task/$release
This operation changes content
Parameters (In)
| Name | Cardinality | Type | Documentation |
|---|
| group-identifier | 0..1 | Identifier | The short-form-prescription-id (token) of the prescription. Used for releasing Patient prescriptions |
| owner | 1..1 | Organization | The organization (pharmacy) downloading the prescriptions. Used for releasing Nominated Pharmacy prescriptions |
| status | 1..1 | code | Status from ValueSet http://hl7.org/fhir/valueset-task-status.html Use: accepted |
| agent | 1..1 | PractitionerRole | The professional submitting the release request |
Return Values (Out)
| Name | Cardinality | Type | Documentation |
|---|
| return | 1..1 | Bundle | A FHIR Bundle (type=searchset) which contains prescription-order FHIR Messages which match the search parameters. An empty search will still return a FHIR Bundle but with no entries. |
Only one of the parameters group-identifier and owner MUST be provided. This operation performs both a query on the message queue and updates the status of returned prescriptions.
{
"id": "Task-release-message",
},
"url": "https://fhir.nhs.uk/OperationDefinition/Task-release-message",
"date": "2020-11-13T09:29:23+11:00",
{
{
"value": "interoperabilityteam@nhs.net"
}
]
}
],
"description": "Use this endpoint to download prescriptions from Spine before it is dispensed. You can download a single prescription using the prescription's ID, or download up to 25 prescriptions (per request) nominated to a dispenser using the dispenser's ODS code.",
"comment": "Only one of the parameters group-identifier and owner MUST be provided. This operation performs both a query on the message queue and updates the status of returned prescriptions.",
],
"outputProfile": "https://fhir.nhs.uk/StructureDefinition/NHSDigital-Bundle-SearchSet",
{
"name": "group-identifier",
"documentation": "The short-form-prescription-id (token) of the prescription. Used for releasing Patient prescriptions",
},
{
"documentation": "The organization (pharmacy) downloading the prescriptions. Used for releasing Nominated Pharmacy prescriptions",
},
{
"documentation": "Status from ValueSet http://hl7.org/fhir/valueset-task-status.html Use: accepted",
},
{
"documentation": "The professional submitting the release request",
"type": "PractitionerRole"
},
{
"documentation": "A FHIR Bundle (type=searchset) which contains prescription-order FHIR Messages which match the search parameters. An empty search will still return a FHIR Bundle but with no entries.",
}
]
}
<id value="Task-release-message" />
</meta>
<url value="https://fhir.nhs.uk/OperationDefinition/Task-release-message" />
<name value="ReleaseTask" />
<kind value="operation" />
<date value="2020-11-13T09:29:23+11:00" />
<value value="interoperabilityteam@nhs.net" />
</telecom>
</contact>
<description value="Use this endpoint to download prescriptions from Spine before it is dispensed. You can download a single prescription using the prescription's ID, or download up to 25 prescriptions (per request) nominated to a dispenser using the dispenser's ODS code." />
<comment value="Only one of the parameters group-identifier and owner MUST be provided. This operation performs both a query on the message queue and updates the status of returned prescriptions." />
<outputProfile value="https://fhir.nhs.uk/StructureDefinition/NHSDigital-Bundle-SearchSet" />
<name value="group-identifier" />
<documentation value="The short-form-prescription-id (token) of the prescription. Used for releasing Patient prescriptions" />
<type value="Identifier" />
</parameter>
<documentation value="The organization (pharmacy) downloading the prescriptions. Used for releasing Nominated Pharmacy prescriptions" />
<type value="Organization" />
</parameter>
<documentation value="Status from ValueSet http://hl7.org/fhir/valueset-task-status.html Use: accepted" />
</parameter>
<documentation value="The professional submitting the release request" />
<type value="PractitionerRole" />
</parameter>
<documentation value="A FHIR Bundle (type=searchset) which contains prescription-order FHIR Messages which match the search parameters. An empty search will still return a FHIR Bundle but with no entries." />
</parameter>
</OperationDefinition>
group-identifier
group-identifier is used to download a single prescription. This is called a Patient Release Request. This group identifier (also known as prescription token or the prescription short form id) is either retrieved via the Task API Prescription Tracker API
or is presented to the pharmacy to the pharmacy by the patient (on paper or patient App).
Patient Release Request
{
"name": "group-identifier",
"valueIdentifier": {
"system": "https://fhir.nhs.uk/Id/prescription-order-number",
"value": "82D996-C81010-11DB12"
}
},
owner
An Organization resource representing the pharmacy downloading the prescription.
{
"name": "owner",
"resource": {
"resourceType": "Organization",
"id": "organization",
"identifier": [
{
"system": "https://fhir.nhs.uk/Id/ods-organization-code",
"value": "VNE51"
}
],
"address": [
{
"city": "West Yorkshire",
"use": "work",
"line": [
"17 Austhorpe Road",
"Crossgates",
"Leeds"
],
"postalCode": "LS15 8BA"
}
],
"active": true,
"type": [
{
"coding": [
{
"system": "https://fhir.nhs.uk/CodeSystem/organisation-role",
"code": "182",
"display": "PHARMACY"
}
]
}
],
"name": "The Simple Pharmacy",
"telecom": [
{
"system": "phone",
"use": "work",
"value": "0113 3180277"
}
]
}
}
accept
The only value to be used is accepted. This is for consistency with NHSDigital-Task and for future use.
{
"name": "status",
"valueCode": "accepted"
},
agent
This is a NHSDigital-PractitionerRole resource.
GMC Reference Number MUST NOT be used as a Practitioner identifier
An example of a unattended $release payload.
{
"id": "ee778f88-e1aa-49b0-8cbc-77d54c65ef9e",
{
},
{
"id": "16708936-6397-4e03-b84f-4aaa790633e0",
{
"system": "https://fhir.nhs.uk/Id/sds-role-profile-id",
}
],
"system": "https://fhir.nhs.uk/Id/sds-user-id",
},
},
{
{
"system": "https://fhir.nhs.uk/CodeSystem/NHSDigital-SDS-JobRoleCode",
"code": "S0030:G0100:R0620"
}
]
}
],
]
}
},
{
{
"system": "https://fhir.nhs.uk/Id/ods-organization-code",
}
],
{
"city": "West Yorkshire",
"17 Austhorpe Road",
"Crossgates",
"Leeds"
],
}
],
{
{
"system": "https://fhir.nhs.uk/CodeSystem/organisation-role",
}
]
}
],
"name": "The Simple Pharmacy",
]
}
}
]
}
An example of a attended $release payload.
{
"id": "66bc43c6-b803-4593-96c9-44c62f4613f4",
{
},
{
"id": "16708936-6397-4e03-b84f-4aaa790633e0",
"system": "https://fhir.nhs.uk/Id/sds-user-id",
},
},
{
{
"system": "https://fhir.nhs.uk/CodeSystem/NHSDigital-SDS-JobRoleCode",
"code": "S0030:G0100:R0620"
}
]
}
],
]
}
},
{
{
"system": "https://fhir.nhs.uk/Id/ods-organization-code",
}
],
{
"city": "West Yorkshire",
"17 Austhorpe Road",
"Crossgates",
"Leeds"
],
}
],
{
{
"system": "https://fhir.nhs.uk/CodeSystem/organisation-role",
}
]
}
],
"name": "The Simple Pharmacy",
]
}
}
]
}
verify-signature
| Name |
Url |
| verify-signature |
https://fhir.nhs.uk/OperationDefinition/verify-signature |
Invocations
URL: [base]/$verify-signature
This operation changes content
Parameters (In)
| Name | Cardinality | Type | Documentation |
|---|
| content | 1..1 | Bundle | The search Bundle retrieved from the $release operation |
Return Values (Out)
| Name | Cardinality | Type | Documentation |
|---|
| entryNumber | 1..1 | integer | Index to the Bundle.entry in the supplied FHIR Bundle |
{
"id": "ee360b98-f807-4c5b-a16f-d72933aff9d1",
"url": "https://fhir.nhs.uk/OperationDefinition/verify-signature",
"name": "VerifySignature",
"date": "2022-02-17T09:29:23+11:00",
{
{
"value": "interoperabilityteam@nhs.net"
}
]
}
],
"description": "Use this endpoint to verify a prescription's signature to ensure that the signature is valid, and that it matches the prescription it is attached to. This endpoint is expected to be used immediately after downloading prescriptions. Send the response message from the release endpoint to this endpoint. The signatures on these prescriptions will be verified. \n The endpoint will return a set of (up to 25) verify responses associated with the bundle of prescriptions sent to the endpoint for verification.",
"code": "verify-signature",
],
{
"documentation": "The search Bundle retrieved from the $release operation",
},
{
"documentation": "Index to the Bundle.entry in the supplied FHIR Bundle",
{
"name": "messageIdentifier",
"documentation": "A reference to the Bundled prescription-order FHIR Bundle",
},
{
"documentation": "The result of the individual prescription-order signature verification",
"type": "OperationOutcome"
}
]
}
]
}
<id value="ee360b98-f807-4c5b-a16f-d72933aff9d1" />
<url value="https://fhir.nhs.uk/OperationDefinition/verify-signature" />
<name value="VerifySignature" />
<kind value="operation" />
<date value="2022-02-17T09:29:23+11:00" />
<value value="interoperabilityteam@nhs.net" />
</telecom>
</contact>
<description value="Use this endpoint to verify a prescription's signature to ensure that the signature is valid, and that it matches the prescription it is attached to. This endpoint is expected to be used immediately after downloading prescriptions. Send the response message from the release endpoint to this endpoint. The signatures on these prescriptions will be verified. \n The endpoint will return a set of (up to 25) verify responses associated with the bundle of prescriptions sent to the endpoint for verification." />
<code value="verify-signature" />
<documentation value="The search Bundle retrieved from the $release operation" />
</parameter>
<name value="entryNumber" />
<documentation value="Index to the Bundle.entry in the supplied FHIR Bundle" />
<name value="messageIdentifier" />
<documentation value="A reference to the Bundled prescription-order FHIR Bundle" />
<type value="Reference" />
</part>
<documentation value="The result of the individual prescription-order signature verification" />
<type value="OperationOutcome" />
</part>
</parameter>
</OperationDefinition>