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.