Please refer to Integration to MESH for an introduction to the use of MESH for GP Connect Messaging use cases.
MESH message routing
GPCM-SD-56 | All messages sent through this use case MUST use MESH automated message routing in order to ensure that the message is routed correctly to the registered practice of the patient. |
Please refer to Message routing to registered practice for details of how to use this facility.
Workflow groups and Workflow ID
GPCM-SD-57 | Each instance of a Send Federated Consultation Report message MUST include the following MESH Workflow ID in the MESH message metadata: TBC:WorkflowID |
GPCM-SD-58 | Each instance of an acknowledgement message generated as a result of receipt of a Send Federated Consultation Report message MUST include the following Workflow ID in the MESH message metadata: TBC:WorkflowID_ACK |
MESH client configuration
When using the MESH client to send a message to the MESH server, the .CTL
file will contain the following metadata about the message:
GPCM-SD-59 | From_DTS MUST contain the MESH mailbox ID of the sender of the message – in this case the federated GP practice. |
GPCM-SD-60 | To_DTS MUST contain the NHS Number, DOB and Surname of the patient delimited by the underscore character ‘_’. This enables automatic routing of the message to the registered GP MESH mailbox. |
GPCM-SD-61 | Subject MUST contain To contain text in the following format:Federated consultation report for {Patient Name} , NHS Number {NHS Number}, seen at {Practice Name}, ODS Code {ODS Code} |
An example .CTL
file is given below for a Federated Consultation Summary message regarding a consultation which took place for a fictional patient: Mr Richard Smith, NHS Number 1234567890, Date of birth 9th January 1955.
<DTSControl>
<Version>1.0</Version>
<AddressType>DTS</AddressType>
<MessageType>Data</MessageType>
<From_DTS>GP0001</From_DTS>
<To_DTS>GPPROVIDER_1234567890_09011955_Smith</To_DTS>
<Subject>Federated GP consultation summary for patient Mr Richard Smith , NHS Number 1234567890, with details of encounter which at practice GP0001</Subject>
<LocalId></LocalId>
<DTSId></DTSId>
<PartnerId></PartnerId>
<Compress>Y</Compress>
<Encrypted>N</Encrypted>
<WorkflowId>TBC-GPCONNECT_FEDERATED_CONSULTATION</WorkflowId>
<ProcessId></ProcessId>
<DataChecksum></DataChecksum>
<IsCompressed>Y</IsCompressed>
</DTSControl>
MESH API configuration
Whe using the MESH API the Send Message API call will be used by a practice API client to send a message to the MESH server. MESH metadata items are defined in HTTP header fields as described below:
GPCM-SD-62 | Mex-From MUST contain the MESH mailbox ID of the sender of the message – in this case the federated GP practice. |
GPCM-SD-63 | Mex-To MUST contain the NHS Number, DOB and Surname of the patient delimited by the underscore character ‘_’. This enables automatic routing of the message to the registered GP MESH mailbox. |
GPCM-SD-64 | Mex-Subject MUST contain To contain text in the following format:Federated consultation report for {Patient Name} , NHS Number {NHS Number}, seen at {Practice Name}, ODS Code {ODS Code} |