Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Please click through to theData Model to explore the presentation of these entities in the web interface.

Expand
titleUpdate behaviour

[[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

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

...