This way of performing an endpoint lookup only relates to finding and sending a patient’s data to their GP. By providing patient details, the Spine can perform the endpoint lookup to determine the MESH mailbox of their GP.
To do this, you'll need to edit the <To_DTS> field of the control file of the MESH message you are wishing to send. This can also be utilised when using the MESH Server API by populating the same input in the Mex-To: attribute.
The format of the To_DTS field to use the endpoint lookup service, where [delimiter] is an underscore “_”, is:
An example To_DTS value would be:
GPPROVIDER = is used to identify that a patient’s details are provided in the To_DTS field. This must be all upper case.
1234567890 = is the patient’s NHS number
19670126 = is the patient’s date of birth format (YYYYMMDD)
Smith = is the patient’s surname
A MESH message containing the string above will tell MESH that a Spine Mini Service Provider (SMSP) NHS Number cross-check demographic search of a patient is required to return the patient’s GP practice/ODS code. The MESH server will extract the patient's GP practice/ODS code from a successful cross-check response. Finally, the MESH server will resolve the patient's ODS code into a MESH mailbox using the MESH Endpoint Lookup Service.
The MESH server will detect messages where the mailbox needs to be resolved using the 'GPPROVIDER' tag for the WorkflowIDs:
Where a single mailbox is successfully identified for GP practice, the MESH server will use the identified MESH Mailbox ID for delivery of the message.
The MESH server will substitute the identified MESH Mailbox ID for the provided patient details such that these patient details are not visible in message reporting via the MOLES interface.
The MESH server will provide enhanced error reporting to include errors from the NHS Number cross-check trace and MESH mailbox lookup.
Potential error codes are:
- EPL-150 ERROR_TOO_MANY_MAILBOX_MATCHES = 'Multiple mailboxes matches'
- EPL-151 ERROR_NO_MAILBOX_MATCHES = 'No mailbox matched'
- EPL-152 ERROR_INVALID_NHSNUMBER = 'Invalid NHS Number'
- EPL-153 ERROR_NHSNUMBER_NOT_FOUND = 'NHS Number not found'
- EPL-154 ERROR_NO_DEMOGRAPHICS_MATCH = 'NHS Number supplied does not match the demographics'