Response codes for ITK3 messaging

Response Code Types

There will be two types of response codes:

  • Positive Response codes
  • Negative Response codes

Note: All Negative response codes are deemed to be fatal and no further processing will be carried out on the message. There will be no further response message following the response message that contains the negative response code regardless of what acknowledgement flags are set.

The ITK3 Response Codes

The ITK3 Response Codes have three prefixes. The codes are returned in response to the handling specification acknowledgement flags in the header of the incoming message. The validation of the incoming message may vary from system to system however the following rules apply to the codes:

InfAckRequested=true

  • Prefix 1 and 2 (10001 to 20014) should be returned

BusAckRequested=true

  • Prefix 3 (30001 to 30004) must be returned
Response Code Type of Response Display Name Description
10001 Negative Handling Specification Error A generic error code which gives a minimum level of assurance that systems can share the minimum information relating to Handling Specification faults.
10002 Negative Infrastructure Level Response Value - Processing Error The handling specification for infrastructure level response is present but cannot be processed. For example, may be unreadable or contain an incorrect value.
10003 Negative Business Level Response Value - Processing Error The handling specification for Business level response is present but cannot be processed. For example, may be unreadable or contain an incorrect value.
10004 Negative Message Definition Value – Processing Error The handling specification for Message Definition is present but cannot be processed. For example, may be unreadable or contain an incorrect value. This may also be returned when the message type is not supported (known) by the receiving system.
10005 Negative Message Definition Version Value – Processing Error The handling specification for Message Definition is present but the version is not supported by the receiving system.
10007 Negative Sender Reference Value - Processing Error The handling specification for Sender Reference is present but cannot be processed. For example, may be unreadable, contain an incorrect value or the use of Sender Reference is not supported by receiving system.
10008 Negative Handling Specification Business Rule Error The Handling Specification usage does not match business rules for included Payload. For example, an acknowledgement flag defined as mandatory to contain the value "true" by the Payload specification contains the value "false".
10009 Negative Unreadable message received A message has been received that is either corrupted or malformed and cannot be read by the receiving system.
10010 Negative Recipient Type - Processing Error The handling specification for Recipient Type is present but cannot be processed. For example, may be unreadable or contain an incorrect value.
20001 Negative Unrecognised Recipient Person The person referred to as the recipient in the ITK3 MessageHeader is not recognised.
20002 Negative Unrecognised Recipient Organisation The organization referred to as the recipient in the ITK3 MessageHeader is not recognised.
20003 Negative Unrecognised Sender The organization or person referred to as the sender in the ITK3 MessageHeader is not recognised. Note: This code should not be used where the domain makes use of the “GP look-up” functionality in MESH.
20004 Negative Non-Approved file type received as an attachment The Receiving system has received an attached file whose file type is not approved for the business domain.
20005 Negative Unsupported file type received as an attachment The Receiving system has received an attached file which it does not support.
20006 Negative ITK3 Header validation failure The ITK3 Header resources or elements are not correct or understandable. For example, ITK3 Bundle or ITK3 MessageHeader.
20007 Negative Duplicate Message received Bundle with this message identifier has already been processed. A Payload with this ITK3 MessageHeader identifier has already been received and processed by this recipient.
20008 Negative Duplicate Document received Bundle with this document identifier has already been processed. A Payload with this document identifier has already been received and processed by this recipient.
20009 Negative Payload validation failure Payload content validation has failed.
20010 Negative Unrecognised Payload Recipient Organisation The Recipient Organisation identified in the Payload, is not supported by this End Point (Receiving System).
20011 Negative Unrecognised Payload Recipient Person The Recipient person identified in the Payload, is not supported by this End Point (Receiving System).
20012 Negative Unauthorised Sender The Receiving system identified in the Payload is configured to reject messages from unauthorised senders. This code should not be used where the domain makes use of the “GP look-up” functionality in MESH.
20013 Positive Success The Message has been processed successfully at the infrastructure level. A response will be returned stating the fact. However, the message may still fail after further processing and result in another response if the business acknowledgement request flag has been sent to “true”.
20014 Negative Unable to Process Replacement Document A replacement document was received, but the receiver could not process the new document correctly and has therefore marked the new and original documents as "bad" on its system.
20015 Negative Message too large Payload is too large to be processed normally by the recipient system and has been rejected to avoid potential for manual intervention and subsequent loss of automated response codes. The recommended maximum size limit is 5MB.
30001 Positive Patient known here. (e.g. Patient is registered here)
30002 Negative Patient not known here. (aka ‘patient record not present in system’)
30003 Negative Patient no longer at this clinical setting
30004 Positive Patient known here and recently deceased (i.e. patient record current in GP practice system at time of patient’s death and deduction subsequently occurred for this reason) This response is only applicable for a window of less than 6-months and would start at Date of Death of Patient (or Date of Deduction when reason for this is patient’s death). If an ITK3 payload message is then received at 6 months or beyond, then the response code would revert to a 30003.
30005 Positive Referral open Referral open.
30006 Positive Referral completed Referral completed.
30007 Negative Referral escalated back to GP Referral escalated back to GP.
30008 Positive Signposting to GP (non-urgent) Patient signposted back to GP. Not a clinically urgent issue.
30009 Positive Clinical escalation to UTC/111/GPOOH Clinical escalation to 111, UTC or GP Out of Hours once consultation has completed.
30010 Positive Clinical escalation to A&E or 999 Clinical escalation to 999 or A&E once consultation has completed.
30011 Positive Advised to go elsewhere/self-referral Patient advised to go elsewhere once consultation has completed.
30012 Negative Unable to contact the patient Attempted to contact the patient at least three times unsuccessfully.
30013 Positive Closure (service not needed) Patient advises that the service is no longer needed.
30014 Negative Closure (service not accepted) Patient does not accept the service being offered.
30015 Negative Closure (duplicate referral) Duplicate referral.
30016 Positive Referral accepted Referral accepted.
30017 Negative Referral rejected Referral rejected.
30018 Negative Did Not Attend Patient failed to attend the appointment/answer the call.
30019 Positive GP Registration - Application accepted The registration has been accepted by the GP practice.
30020 Negative GP Registration - Application pending (contact practice) The registration has not been accepted. The patient needs to contact the GP practice.
30021 Negative GP Registration - Application rejected (patient already registered) The registration has not been accepted. The patient is already registered at the practice.
30022 Negative GP Registration - Application rejected (at capacity) The registration has not been accepted. The practice is at capacity and is not currently taking any new registrations.
30023 Negative GP Registration - Application rejected (out of boundary) The registration has not been accepted. The patient is out of boundary.
30024 Negative GP Registration - Application rejected (Previously removed from this practice) The registration has not been accepted. The patient has previously been removed from this practice.
30025 Negative GP Registration - Application rejected (Previously removed from another practice) The registration has not been accepted. The patient has previously been removed from another practice.
Tags: fhir