SIU S12

SIU S12: Create a new appointment for a patient

Overview

Currently, this message can only be used to invite a single patient to a non-recurring appointment.

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: Replacement. The existing appointment is replaced in its entirety with the values provided in this message. A partial update is not performed.

When not matched: New [[Appointment]] created.

Definition

Segment

Field

Opt

RP/#

Component

Description

Example

Data Model

Blank Ignored On Update

Segment

Field

Opt

RP/#

Component

Description

Example

Data Model

Blank Ignored On Update

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

 

 

 

 

 

 

 

SCH-1.1

Placer ID. You must provide a unique ID for this appointment. This will also be required if you wish to subsequently modify or cancel this appointment.

APPT000001

[[Appointment.External Data Point ID]]

N/A

 

SCH-7

O

 

 

Appointment reason. This is optional; if not provided a default value of "Appointment" will be used.

 

 

 

 

 

 

 

SCH-7.2

Reason (free text). We will set this as the subject.

Check up

[[Appointment.Subject]]

Y

 

SCH-8

O

 

 

Appointment type. See our notes on code sets for more information on our handling of coded data.

 

 

 

 

 

 

 

SCH-8.1

Appointment type code

A1

[[Appointment.Type.Code]]

Y

 

 

 

 

SCH-8.3

Appointment type coding system

MyCoding

[[Appointment.Type.Code System]]

Y

 

SCH-11

R

 

 

The start date/time is required, but the end date/time is optional.

 

 

 

 

 

 

 

SCH-11.4

Appointment start date/time.

201506130100

[[Appointment.Start Timestamp]]

Y

 

 

 

 

SCH-11.5

Appointment end date/time.

201506130130

[[Appointment.End Timestamp]]

Y

[ NTE ]

 

 

 

 

This can be used to populate the description field of an appointment with additional instructions and information

 

 

 

 

NTE-3

O

 

 

Description of the appointment (free text)

 

 

 

 

 

 

 

NTE-3.1

Description

Your regular check up appointment.

[[Appointment.Description]]

Y

PV1

 

 

 

 

This is used to include additional information about the appointment, such as the location

 

 

 

 

PV1-3

R

 

 

 

 

 

 

 

 

 

 

PV1-3.9

Appointment location (free text)

Your local surgery

[[Appointment.Location]]

Y

 

PV1-10

O

 

 

Hospital service. See our notes on code sets for more information on our handling of coded data.

 

 

 

 

 

 

 

PV1-10.1

Hospital service code

 

[[Appointment.Specialty]]

N/A

[ RGS

 

 

 

 

Resource group

 

 

 

{ [ AIP ] }
]

 

 

 

 

Appointment Information - Personnel

 

[[Appointment->External Appointment Participant.Name]]

 

 

AIP-3

R

Y

 

Personnel.
If provided, at least the family name must be given. Otherwise this participant will be ignored.

 

 

 

 

 

 

 

AIP-3.2

Family name

Jones

 

N/A

 

 

 

 

AIP-3.3

Given name

Stuart

 

N/A

 

 

 

 

AIP-3.4

Middle names

James

 

N/A

 

 

 

 

AIP-3.6

Prefix

Dr

 

N/A

 

AIP-4

O

 

 

Role

 

 

 

 

 

 

 

AIP-4.2

Text

Doctor

 

N/A

[ ZAP ]

 

 

 

 

Allows an external appointment partner to provide a management URL. See our documentation on Appointment Partners and also the Manual for more information.

 

 

 

 

ZAP-1

O

 

 

This must be a valid URL. Query parameters are permitted.

 

 

 

 

 

 

 

ZAP-1.1

External management URL

https://appointments-r-us.co.uk/manage/123

[[Appointment.External Management URL]]

N/A

Examples

SIU S12 HL7 messages: institute sends information about a new appointment to which the patient will be invited. An institute can invite a patient to a new appointment using an SIU S12 message.

MSH|^~\&|app|sender|HL7API|PKB|201303080949||SIU^S12|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||||||^checkup^||||^^^201411201231^201411201232|||||||||||||||

NTE|||My comment|

PV1|||^^^^^^^^health centre

RGS|

AIP|||^Jones^Stuart^James^^Dr|^Doctor

ZAP|https://appointments-r-us.co.uk/manage/123

Response

PKB will respond with a standard HL7 acknowledgement.