Search loading...

API Hub

Explore and Make use of Nationally Defined Messaging APIs

 

PDF layout

PDF layout for Send Consultation Report use case

Purpose

The PDF layout defines the requirements of the document layout and detailed information about data that is used to populate the document.

Requirements

Requirements are given below which define how the PDF is populated for this use case:

GPCM-SD-086 the provider system MUST include all data entered by the clinician at the sender organisation into the 'Clinical notes [notes]' section of the PDF document. This includes all free text, clinical/SNOMED CT codes, dm+d codes and any other data entered relating to the consultation
GPCM-SD-087 data MUST be displayed in a format that matches how the consultation is displayed on screen or when printed
GPCM-SD-088 the provider system MUST include in the message all attachments relating to the consultation
GPCM-SD-089 where the system does not have a concept of a consultation in its architecture, then the provider system MUST consider all data asserted about the patient for a specified date as part of the same consultation (this follows the same model as GP2GP)
GPCM-SD-090 the layout and content of the PDF MUST conform to the template and logical field model contained in the Layout section below
GPCM-SD-091 the version number MUST be displayed in the PDF in the relevant field and within the Subject of the MESH .CTL file
GPCM-SD-098 version 1 is the original report, each subsequent report that relates to the same consultation MUST increment by 1
GPCM-SD-102 if the patient has requested that the consultation is confidential then the following data items MUST NOT be sent in the PDF: Clinical Notes, Clinician, Consulting Organisation Tel No., Consulting Organisation Email, Branch Location, Organisation
GPCM-SD-133 if the local system supports setting individual data items as confidential, then each item flagged as confidential MUST contain the warning text Confidential item when sent in the Consultation Report
GPCM-SD-134 if multiple data items are flagged as confidential, the warning text Confidential item MUST be repeated for each item
GPCM-SD-136 each section displayed in the [notes] area on the PDF MUST have a corresponding title in bold text in the [Clinical note section title] section
GPCM-SD-137 each section displayed in the [notes] area on the PDF MUST be separated by a carriage return
GPCM-SD-138 the [Clinical note section title] section and the [notes] section MUST be consistently tab separated for each repeating clinical section. The [Clinical note section title] section can be wrapped if necessary
GPCM-SD-139 Patient Name MUST be in a larger font size than the other fields, space permitting
GPCM-SD-143 NHS Blue (#005EB8) and NHS Light Blue (#41B6E6) MUST be used as background colours as per the PDF template
GPCM-SD-144 Summary Reason MUST contain the following text A patient recently consulted with a clinician at an organisation different to the GP practice that they are registered with. The notes contained in this document are a summary of the consultation

Layout

The PDF below defines the expected document layout. If your browser is not compatible and unable to display the PDF, please right click and select “Save as” to download, or use this link to get the PDF directly.

Field descriptions

The following describe each of the fields used in the PDF:

Field name Description Confidential item
Version [x] The version of the consultation report sent.  
Number of related documents The number of documents attached to the message - for example, pain point diagram, ECG, photo. These will be all documents recorded on the GP system that are linked to the consultation.  
Page [x] of [y] The page number and total pages of the PDF.  
Patient Name The surname, forename(s) and title of the patient.
Format all names in the document as follows:
SURNAME <uppercase>, Forename(s), (Title)
This may wrap over multiple lines depending on the length of the name.
 
DOB The date of birth of the patient in the format dd-MMM-yyyy .  
NHS No The NHS Number of the patient in the format ### ### ####.  
Tel No The patient’s contact telephone number.
Format all telephone numbers in the document as follows:
Area Code <space> Local Number [‘x’ Extension Number]
For local numbers with more than six digits include a space before the final four digits.
 
Mobile No The patient’s contact mobile telephone number  
Current Tel No If the patient is currently staying at a temporary location, the number(s) for contacting the patient at that location. If the patient is not at a temporary location this will be blank and the ‘Current Tel No.’ label will not be shown.  
Home/Registered Address The registered address of the patient, presented line by line, including post code. This may wrap over multiple lines depending on the length of the address.  
Current Address If the patient is currently staying at a temporary location, the address of that location. If the patient is not at a temporary location this will be blank and the ‘Current Address’ label will not be shown.  
Clinician The full name and role of the treating clinician for the consultation. Where the consultation has been set to confidential the data from the consultation is not displayed. x
Tel No The main telephone number of the organisation. Where the consultation has been set to confidential the data from the consultation is not displayed. x
Email The main email address of the organisation. Where the consultation has been set to confidential the data from the consultation is not displayed. x
Branch Location The name of the branch location, if applicable. Where the consultation has been set to confidential the data from the consultation is not displayed. If Branch Location is not applicable then the label will not be shown. x
Organisation The name of the organisation and the town specified in its full address. Where the consultation has been set to confidential the data from the consultation is not displayed. x
Consultation Date The date and time of the patient’s appointment at the sending organisation in the format dd-MMM-yyyy hh:mm.  
Receiving GP Practice The name of the GP practice receiving the consultation report.  
Summary Reason A brief description of why the consultation report has been sent to the receiving GP practice entered into the [Summary Reason] section of the PDF document. The text MUST be A patient recently consulted with a clinician at an organisation different to the GP practice that they are registered with. The notes contained in this document are a summary of the consultation. x
Clinical note section title The title of the clinical section being displayed  
[notes] All data entered by the clinician at the sending organisation into the ‘[notes]’ section of the PDF document. This includes all free text, clinical/SNOMED CT codes, dm+d codes and any other data entered relating to the consultation. This data must be displayed in a format that matches how the consultation is displayed on screen or when printed. Each section must have a title in bold text. There must be a carriage return after each section to make the document more easy to read. Where the entire consultation has been set to confidential the data from the consultation is not displayed. It is replaced by the text The details of this consultation have been set as confidential. Where individual items in the consultation have been set to confidential those items are not displayed and replaced by the text Confidential item. x
Follow-up Actions A duplicate of any follow-up actions identified during the encounter entered into the [actions] section of the PDF document. x
Tags: use-case

All content is available under the Open Government Licence v3.0, except where otherwise stated