---
title: "SIU S13 (Update Existing Appointment)"
canonical: "https://wiki.patientsknowbest.com/space/api/3364947195/SIU%20S13%20(Update%20Existing%20Appointment)"
format: markdown
---
> Macro (toc)

## SIU S13: Update An Existing Appointment For A Patient

## Overview

The Placer ID (SCH-1.1) is used to identify the appointment. If the appointment to be updated is not known to PKB, then a new appointment will be created with the provided information. An update to a Pending, Cancelled or DNA appointment will set the appointment status back to active.

## 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>: Partial update. See S12 specification for which fields will be left unmodified if a blank is provided. If the matched appointment has an [[Appointment.Status]] of ‘CANCELLED’ or ‘DNA’ then status will revert to ‘ACTIVE’. Note: the list of external participants is purged and replaced.

<u>When not matched</u>: New [[Appointment]] created.
</details>

## Definition

The message structure is the same as an <u>[SIU S12](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3364947182)</u>.

## Examples

> MSH|^~\&|app|sender|HL7API|PKB|201303080949||SIU^S13|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||||||^checkup^||||^^^201411201231^201411201232||^^^^^^0300300300^3^Lines are open 8am-8:30pm
> 
> NTE|||My comment|
> 
> PV1||O|^^^^^^^^new health centre

## 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>.