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.

This field identifies the specific type of service being performed (e.g., "Physiotherapy" or "Cardiology"). Ideally use standard codes:

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

SCH-13

O

Single Point Of Contact

SCH-13.4

Email address for appointment booking team

example@gmail.com

Y

SCH-13.7

Phone number for appointment booking team

01234 567 891

Y

SCH-13.8

Phone extension for appointment booking team

2

Y

SCH-13.9

Free text note for appointment booking team

Lines open 10am till 4pm

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

O

Patient class

PV1-2.1

Patient class. Allowed values are defined in Code Set PKBCS04.

If a blank or unknown value is provided the class will default to OTHER.

O

[[Encounter Event.Class]]

Y

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