Search loading...

API Hub

Explore and Make use of Nationally Defined Messaging APIs

 

Encounters

Encounters HTML view
Back to Top

Back to Top

Section Code Section Name TPP EMIS Vision Microtest
ENC Encounters Yes Yes Yes Yes

Clinical narrative

An encounter is an interaction between a patient and a health care professional (HCP) that is recorded on the patient record. This can include:

  • planned encounters - such as pre-arranged Appointments with a GP
  • unplanned encounters - such as at an out of hours clinic and those unrecorded through appointment module(s)
  • direct encounters - such as a face-to-face session with a GP
  • indirect encounters - such as a GP reviewing and updating a patient record on receipt of some test results

Purpose

The purpose of supplying encounters within GP Connect is to allow a clinician to view a history of a patient’s interactions with a clinician or an HCP.

Sections and subsections

There is a single main section for encounters with no subsections.

Date filter

A date filter is applicable for the encounters section. Provider messages for a date filter can be found here.

Section content banner

Provider message(s) describing at a summary level how this section has been populated. Provider content messages can be found here.

Table construction requirements

Providers MUST adhere to the table construction requirements listed below:

  • table header MUST be “Encounters”
  • table columns MUST be ordered left-to-right (1..N)
  • table content MUST NOT be truncated

Table columns

Providers MUST return all the columns as described in the table below, ordered by Date descending:

Order Name Description Value Details
1
Date The date of the encounter dd-Mmm-yyyy
2
Title A short human readable title for the encounter, to be composed of a subset of the Practitioner and Organization details linked to the encounter free-text
3
Details Longer human readable details for the encounter free-text

HTML view

The following content highlights the expected HTML tags and format providers MUST use when generating the HTML content:

<div>
   <h1>Encounters</h1>
   <div>
      <p>
         <!-- GP transfer banner -->
      </p>
   </div>
   <div>
      <p>
         <!-- Content banner -->
      </p>
   </div>
   <div>
      <p>
         <!-- Date banner -->
      </p>
   </div>
   <div>
      <p>
         <!-- Exclusion banner -->
      </p>
   </div>
   <table>
      <thead>
         <tr>
            <th>Date</th>
            <th>Title</th>
            <th>Details</th>
         </tr>
      </thead>
      <tbody>
         <tr>
            <!-- the <tr>...</tr> element will repeat for each encounter-->
            <td>{{encounter.date}}</td>
            <td>{{encounter.entry}}</td>
            <td>{{encounter.details}}</td>
         </tr>
      </tbody>
   </table>
</div>
</div>

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