SIU S15: Cancel an appointment for a patient

Overview

The Placer ID (SCH-1.1) is used to identify the appointment.

If the appointment to be cancelled is not known to PKB, then a new appointment will first be created with the provided information, before then being cancelled. To allow the appointment to be created the S15 message will need to include the additional mandatory elements as detailed in the S12 specification.

Relevant entities

Please click through to the Data Model to explore the presentation of these entities in the web interface.

[[Appointment]]

Matched on: [[Appointment.External Data Point ID]] as derived from SCH-1.1

When matched: [[Appointment.Status]] set to Cancelled. The other details of the appointment are not updated.

When not matched: New [[Appointment]] created (and immediately cancelled). In this scenario the S15 message will need to conform to the S12 specification to first create the [[Appointment]]. If it does not then PKB will respond with an AR rejection message.

Definition

Segment

Field

Opt

RP/#

Component

Description

Example

Data Model

MSH

Message header. This conforms to PKB's standard definition.

PID

Patient identification. This conforms to PKB's standard definition.

SCH

Schedule an activity

SCH-1

R

Placer ID

[[Appointment.External Data Point ID]]

SCH-1.1

Placer ID. You must provide a unique ID for this appointment.

APPT000001

Examples

MSH|^~\&|app|sender|HL7API|PKB|201303080949||SIU^S15|ABC0000000001|P|2.4

PID|||9999999999^^^NHS^NH||Smith^John^Joe^^Mr||19700101|M|||Flat name^1, The Road^London^London^SW1A 1AA^GBR||01234567890^PRN~07123456789^PRS|^NET^^john.smith@company.com~01234098765^WPN||||||||||||||||N|

SCH|ID123

Response

PKB will respond with a standard HL7 acknowledgement.

PKB customer sites: deploy | developer | information governance | procurement | manual

© Patients Know Best, Ltd. Registered in England and Wales Number: 6517382. VAT Number: GB 944 9739 67.

This API specification and design is licensed under a Creative Commons Attribution 4.0 International License.