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
Appointment information is used to populate [[Appointment]] entities
Please click through to the Data Model to explore the presentation of these entities in the web interface.
Definition
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 include a description of the appointment | Â | Â | Â |
 | 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. |  |  |  |
 |  |  |  | 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.