Wayfinder Data Requirements
If you are a PKB customer in England and have chosen PKB as your supplier for the NHS App integration Wayfinder programme, it is imperative you review and adhere to the following requirements as closely as possible.
Even if you are not part of the Wayfinder programme, PKB would recommend you follow the guidance in order to provide high quality appointment information to your patients.
- 1 Appointments via SIU
- 1.1 Wayfinder requirements
- 1.1.1 Specialty
- 1.1.2 Locations:
- 1.1.3 Home visits:
- 1.1.4 Single Point Of Contact
- 1.1.5 General content guidelines:
- 1.1.6 The following appointment types should be excluded for ALL patients:
- 1.2 Inpatient & Daycase appointments
- 1.3 Appointments Notifications & Messages (N&M)
- 1.4 Appointment messaging for rescheduling or cancelling appointments via PKB & NHS App
- 1.5
- 1.1 Wayfinder requirements
- 2 Wayfinder Questionnaires & associated NHS App Notifications & Messages (N&M)
- 3 Coming soon: Wayfinder Documents & associated NHS App Notifications & Messages (N&M)
- 4 Coming later: Wayfinder Patient Initiated Follow-Up (PIFU)
- 5 NHS England - Example Wayfinder Assurance checklist
Appointments via SIU
Wayfinder requirements
Specialty
Every appointment MUST have a specialty. The specialty is sent from PKB to the NHS App to provide an NHS App ‘appointment description’. PKB also use the specialty to determine whether the appointment is shown in the NHS App with NHS-E Mental Health supporting text or not.
For NHS customers, these should align with the NHS National Data Dictionary main specialties and MUST NOT contain acronyms. Specialty names must be written in full (e.g., avoid "ENT" or "CARD"). (PV1-10.1 field)
Where possible, service should use the main specialties & codes however, if none are applicable you can also use
Community Care service specialties https://www.datadictionary.nhs.uk/data_elements/service_or_team_type_referred_to_community_care.html
Mental health specialties https://www.datadictionary.nhs.uk/data_elements/service_or_team_type_referred_to_mental_health.html
Ideally your Hospital Service code set should be provided to the PKB integration team with a textual description for each code. You should also inform PKB when any new codes require adding to the code set.
Example of appointment description in NHS App built using specialty followed by the word appointment.
Example of Mental health care card added to all appointments with a Mental Health specialty
Example of the detailed appointment page for a non-mental health appointment
Locations:
Location fields should be descriptive, avoid acronyms, and must not be overly long. (PV1-3.9 field)
These descriptions are displayed in the NHS App as part of the appointment card, as well as in NHS App Notifications & Messages, and alongside the appointment details in PKB.
If you are not currently able to meet the NHS Data Quality requirements for locations, they may still allow you to go live if you are actively working to improve this data. If so, they will suppress the location in the NHS App and display the trust name instead (as it appears in the ODS code directory)
Home visits:
If you wish to include home visits in your appointment feed:
Please ensure ‘Home visit’ is populated in PV1-3.9 (location field)
NHS-E require you to add the following supporting text in NTE-3.1 (PKB description field)
“If you think your home address might be out of date, contact your care team on/at [contact details for checking/updating home address].”
Example of a home visit appointment with supporting text
Single Point Of Contact
(SPOC) information should be supplied (in SCH-13)
SCH-13.4: Email address for appointment booking team
SCH-13.7: Booking team phone number
SCH-13.8: Phone extension
SCH-13.9: Free-text notes (e.g., "Lines open 10-4")
Example of a home visit appointment with supporting text
General content guidelines:
Textual fields should be in normal text (upper and lower case) with no unnecessary capitalisation, abbreviations or characters.
No clinically sensitive terminology should be included - Such as 2WW
The following appointment types should be excluded for ALL patients:
Appointments for patients who are acknowledged as being prisoners
Patients with safeguarding flags
Multidisciplinary team (MDT) appointments or any appointment that does not need the patient to attend.
Silent appointments - These are appointments that are scheduled for a patient AFTER a diagnostic test but BEFORE the patient has been told of their diagnosis. E.g a patient has a scan and it's determined they have cancer, at that point a follow up oncology appointment with the consultant/nurse is booked. It would not be appropriate for the patient to know about this follow-up appointment until they have spoken to their referring clinician. Organisations are advised to add ‘delay’ or make these appointments ‘silent’ so they are not released into the patient's record.
Dummy' or 'holding' appointments - These are appointments that do not exist and the patient should not attend.
Inpatient & Daycase appointments
If you wish to include Inpatient & Daycase appointments in your feed, you will need to:
Populate the Patient Encounter Class in PV1-2.1,
Provide either the Inpatient or Daycase code from Code Set PKBCS04
Please note., outpatient will be automatically assumed if no value is provided
Provide an end time for the appointment in SCH-11.5
If sending appointments that are not face-to-face outpatient appointments, this field should be populated. This includes if appointments are Virtual, as code of V should be provided.
Please note - Onboarding with Inpatient & Daycase appointments requires a seperate approval from NHS-England Wayfinder team.
Example of Inpatient & Daycases in NHS App
Example of an Appointment sent as Inpatient with end time the next day.
Example of an appointment sent as Inpatient or daycase with end time on the same day.
Appointments Notifications & Messages (N&M)
If you wish to onboard to the NHS App Notifications & Messages (N&M) sent for new, updated and cancelled appointments, you will simply need to complete the NHS App onboarding checklist.
(You can opt to go live with appointments & appointment N&M at the same time to save doing seperate onboarding checklists.)
You can read more about NHS App Notifications & Messages on our NHS App wiki.
Appointment messaging for rescheduling or cancelling appointments via PKB & NHS App
You can optionally switch on PKB Appointment Messaging so that patients are able to request a reschedule or cancel for their appointments. This configuration is on an organisation level, and once switched on, all patients will see the option to send a request to reschedule or cancel their appointment up until 72 hours prior to the appointment. This function helps prevent DNAs.
Prior to PKB switching on this function for you, you will need to:
Decide with the organisation which team should handle appointment messages.
Most organisations will opt to use a new appointment booking team or an existing patient liaison team.
Patients do not need to be added to the team to send appointment messages.
The coordinator for the team will need to set up all the professionals as contactable
Ask your PKB representative to set up Auto CC for the team, and then turn on the appointment messaging feature
Wayfinder Questionnaires & associated NHS App Notifications & Messages (N&M)
If you wish to onboard to Wayfinder Questionnaires with PKB you will need to:
Onboard to PKB Advanced Questionnaires (We do not display our legacy questionnaires in Wayfinder). Advanced Questionnaires can be triggered via the User Interface or via FHIR (See our FHIR API specification here.
Ensure all your Advanced Questionnaires have a patient-friendly standardised description/title of
the questionnaire that would be appropriate to display to a patient as this will be used for the NHS App Questionnaire description. Example: Dermatology pre-consultation questionnaireYou can read more about recommended naming conventions here.
Ensure that if the Questionnaire is for Mental Health, there are no mandatory questions, so the patient can come back to questions as needed.
Complete the assurance checklist for the Wayfinder team (they will send you this form)
Example of Questionnaire descriptions shown in the NHS App Document & Questionnaire library
Example of an NHS App message triggered by PKB with a link to complete the questionnaire in PKB
Example of a PKB Questionnaire accessed via NHS App
Coming soon: Wayfinder Documents & associated NHS App Notifications & Messages (N&M)
If you wish to onboard to Wayfinder Documents & associated NHS App Notifications & Messages (N&M) with PKB you will need to:
Onboard to PKB Document feed
Ensure you are sending the Document Specialty in PV1-10.1
Ensure you are sending the document type sent in TXA-2
Please note, only the following document types will be included in the Wayfinder feed:
AD - Advanced directive
AL - Appointment letter
BR - Birth report
CD - Consent document
CL - Clinic letter
CR - Clinician review summary
CSS - Clinical support services
DL - Discharge letter
DS - Discharge summary
HS - Health screening report
MDT - Multidisciplinary team meeting notes
MHD - Mental health document
MHL - Mental health letter
QR - Questionnaire response
OR - Operative report
RAL - Referral acknowledgement letter
RL - Referral letter
SP - Signposting document
ST - Support document
TCI - Admission (TCI) letter
TT - Timetable
Complete the Assurance Checklist for the Wayfinder team (they will send you this form)
Coming later: Wayfinder Patient Initiated Follow-Up (PIFU)
If you wish to onboard to Wayfinder PIFU with PKB you will need to:
Onboard to PKB Document feeds & Advanced Questionnaires (see previous sections)
These feeds may need to be adapted slightly - Details coming soon
Complete the Assurance Checklist for the Wayfinder Deployment team (they will send you this form - see example below for reference)
NHS England - Example Wayfinder Assurance checklist
Please note - you should use the latest copy of this form which will be sent to you by the Wayfinder Deployment Team.
Assurance | Status |
| (PKB will send this to Wayfinder on your behalf) |
Current Trust DSPT Status |
|
Confirmation of DCB0160 or sign-off by Clinical Safety Officer/Chief Clinical Information Officer/Medical Director
| Y/N |
Confirmation of DCB0129 in place This document is shared by the supplier and should be passed onto your Clinical Safety Officer to update the DCB0160.
| Y/N |
DPA/CCN Signed between PEP provider and trust Please liaise with your IG and your PEP supplier to confirm signage. | Y/N |
Update to DPIA done Please share the link above (futureNHS site) with your IG. I have also shared the supplier’s IG framework to help with IG discussions. The IG lead at the Trust and the supplier’s end could help address IG concerns, etc. | Y/N/in progress |
Update to your Privacy Notice done NHS recommended statement: "If you view or manage your hospital appointments, questionnaires or documents via the NHS App [we/your hospital] share[s] your data with NHS England who operate the NHS App and provide this functionality, known as NHS Wayfinder services. For more information, see the NHS Wayfinder services privacy policy." | Y/N/in progress |
Agreement to store patient NHS Numbers within the Aggregator We need this approval from your IG Lead, and it is also good practice to include this in your DPIA, i.e. that you will be sharing NHS numbers with the aggregator. | Y/N |
Confirmation that PKB has been integrated with NHS Login for the Trust (Y/N) | Y |
Clinical Safety Assurance
To be completed by your Clinical Safety Lead/Officer
Assurance | Status |
Do you have a clinical risk management system? | Y/N |
As part of your PAS integration to a Portal Provider, have you had visibility of the PKB Safety Case and Hazard Log as evidence of their compliance to DCB0129? | Yes - PKB publish Safety Case & Hazard Log here - https://wiki.patientsknowbest.com/space/IG/3422060563/Digital+Technology+Assessment+Criteria+(DTAC)#Supporting-Documentation |
Have you undertaken Clinical Risk Management activities for this product which comply with DCB0160? | Y/N |
Have you integrated the risks which are transferrable from the Portal Provider into your own Safety Case and Hazard Log? | Y/N |
Have all risks identified in your Safety Case and Hazard Log been analysed, evaluated and mitigated appropriately? | Y/N |