GP Connect (Patient Facing) Prescriptions

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

Errors and Issues

Issue Mapping HTTP Status Issue.code Issue.severity Issue.details.coding.code Issue.details.coding.display Endpoint?
Not authorised ACCESS_DENIED 401 error ACCESS_DENIED All
Prescribed item description does not match code CONFLICTING_VALUES 400 value error CONFLICTING_VALUES Request a repeat prescription
Prescribed item quantity description does not match code CONFLICTING_VALUES 400 value error CONFLICTING_VALUES Request a repeat prescription
Mismatched prescribed item to quantity CONFLICTING_VALUES 400 business-rule error CONFLICTING_VALUES Request a repeat prescription
BasedOn reference to previous prescription does not match previous CONFLICTING_VALUES 400 business-rule error CONFLICTING_VALUES Get medications relating to a patient
Duplicate prescription request DUPLICATE_REJECTED 400 duplicate error DUPLICATE_REJECTED Request a repeat prescription
Invalid prescribed item code INVALID_CODE_VALUE 400 code-invalid error INVALID_CODE_VALUE
Invalid prescribed item quantity code INVALID_CODE_VALUE 400 code-invalid error INVALID_CODE_VALUE
Invalid task ID INVALID_IDENTIFIER_VALUE 400 value error INVALID_IDENTIFIER_VALUE
Invalid patient ID INVALID_NHS_NUMBER 400 value error INVALID_NHS_NUMBER
Invalid date INVALID_PARAMETER 400 value error INVALID_PARAMETER
Attempted cancellation once cancelled or prescribed INVALID_REQUEST_STATE 400 value error INVALID_REQUEST_STATE
BasedOn reference to previous prescription not present INVALID_RESOURCE 400 required error INVALID_RESOURCE
Invalid prescribed item quantity INVALID_VALUE 400 value error INVALID_VALUE
Note too long INVALID_VALUE 400 too-long error INVALID_VALUE
Task or request date not in past INVALID_VALUE 400 value error INVALID_VALUE
Dispensing organisation not found ORGANISATION_NOT_FOUND 404 not-found error ORGANISATION_NOT_FOUND
Patient not found PATIENT_NOT_FOUND 404 not-found error PATIENT_NOT_FOUND
Task not found RESOURCE_NOT_FOUND 404 not-found error RESOURCE_NOT_FOUND Get requested prescription reorders, Cancel an unactioned repeat prescription request

Operation Outcome Usage

In the event of an error, provider systems SHALL respond by providing an OperationOutcome profiled to UKCore-OperationOutcome

Example

{
  "resourceType" : "OperationOutcome",
  "issue" : [ {
    "severity" : "error",
    "code" : "value",
    "details" : {
      "coding" : [ {
        "system" : "https://fhir.nhs.uk/R4/CodeSystem/Spine-ErrorOrWarningCode",
        "version" : "1",
        "code" : "MISSING_FIELD",
        "display" : "ResourceType Bundle must contain 'entry' field"
      } ]
    }
  } ]
}
back to top