---
title: "SIU S15 (Cancel Appointment)"
canonical: "https://wiki.patientsknowbest.com/space/api/3364849014/SIU%20S15%20(Cancel%20Appointment)"
format: markdown
---
> Macro (toc)

# 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

- Appointment information is used to populate[ ](http://www.google.com/url?q=http%3A%2F%2Fdev.patientsknowbest.com%2Fhome%2Fdata-model%23TOC-Appointment&sa=D&sntz=1&usg=AOvVaw2b4AZDXyHgNVkc4xPV7Kdv)<u>[[[Appointment]]](https://wiki.patientsknowbest.com/space/api/3729195048/Entity%3A+Appointment)</u> entities

Please click through to the[ ](http://www.google.com/url?q=http%3A%2F%2Fdev.patientsknowbest.com%2Fhome%2Fdata-model&sa=D&sntz=1&usg=AOvVaw3H4dk1Ql5ZGfvclmnuHM_Y)<u>[Data Model](https://wiki.patientsknowbest.com/space/api/3363700789/Data+Model)</u> to explore the presentation of these entities in the web interface.

<details>
<summary>Update behaviour</summary>

**[[Appointment]]**

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

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

<u>When not matched</u>: 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.
</details>

## Definition

| **Segment** | **Field** | **Opt** | **RP/#** | **Component** | **Description** | **Example** | **Data Model** |
| --- | --- | --- | --- | --- | --- | --- | --- |
| **MSH** |  |  |  |  | Message header. This conforms to PKB's <u>[standard definition](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3365012972)</u>. |  |  |
| **PID** |  |  |  |  | Patient identification. This conforms to PKB's <u>[standard definition](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3364849216)</u>. |  |  |
| **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{status:01}||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[ ](http://www.google.com/url?q=http%3A%2F%2Fdev.patientsknowbest.com%2Fhome%2Fhl7-api%2Fmessages%2Fack&sa=D&sntz=1&usg=AOvVaw19jl6l0RTsr4epvg_3z1Se)<u>[standard HL7 acknowledgement](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3364848470)</u>.