Draft Website - For Review Purposes Only

The APR segment contains parameters and preference specifications used for requesting appointments in the SRM message. It allows placer applications to provide coded parameters and preference indicators to the filler application, to help determine when a requested appointment should be scheduled. An APR segment can be provided in conjunction with either the ARQ segment or any of the service and resource segments (AIG, AIS, AIP, and AIL). If an APR segment appears in conjunction with an ARQ segment, its parameters and preference indicators pertain to the schedule request as a whole. If the APR segment appears with any of the service and resource segments, then its parameters and preferences apply only to the immediately preceding service or resource.

HL7 Attribute Table - APR - Appointment Preferences Segment

Seq#	DataElement	Description	Must Implement	Flags	Cardinality	Length	C.LEN	Vocabulary	DataType
APR
1	00908	Time Selection Criteria			[0..*]			0294 Time Selection Criteria Parameter Class Codes	SCV
2	00909	Resource Selection Criteria			[0..*]			0294 Time Selection Criteria Parameter Class Codes	SCV
3	00910	Location Selection Criteria			[0..*]			0294 Time Selection Criteria Parameter Class Codes	SCV
4	00911	Slot Spacing Criteria		=	[0..1]		5		NM
5	00912	Filler Override Criteria			[0..*]				SCV

Definition: This field is used to communicate parameters and preferences to the filler application regarding the selection of an appropriate time slot for an appointment. The first component of this field is a code identifying the parameter or preference being passed to the filler application. The second component is the actual data value for that parameter.

For example, if a filler application allows preference parameters to be passed to specify a preferred start time, a preferred end time, and preferred days of the week for the appointment, it may define the parameter class codes and valid data sets based on suggested codes from User-defined Table 0294 - Time Selection Criteria Parameter Class Codes in Chapter 2C, Code Tables, for suggested values.

Given the set of parameter class codes and valid value sets from User-Defined table 0294, a placer may indicate a preferred start time of 8:00 AM on Monday, Wednesday or Friday by specifying the following in APR-1 Time Selection Criteria:

...|PREFSTART^0800~MON^OK~WED^OK~FRI^OK~TUE^NO~THU^NO~SAT^NO~SUN^NO|...

The valid set of preferences should be determined by the placer and filler applications during implementation of the interface.

Definition: This field is used to communicate parameters and preferences to the filler application regarding the selection of an appropriate resource for an appointment. The first component of this field is a code identifying the parameter or preference being passed to the filler application. The second component is the actual data value for that parameter.

Refer to Section 10.6.8.1, "APR-1 Time Selection Criteria (SCV) 00908," for an example illustrating how this mechanism works within an interface.

The valid set of preferences should be determined by the placer and filler applications during implementation of the interface. Refer to User-defined Table 0294 - Time Selection Criteria Parameter Class Codes in Chapter 2C, Code Tables, for suggested examples.

Definition: This field is used to communicate parameters and preferences to the filler application regarding the selection of an appropriate location for the appointment. The first component of this field is a code identifying the parameter or preference being passed to the filler application. The second component is the actual data value for that parameter.

Refer to Section 10.6.8.1, "APR-1 Time Selection Criteria (SCV) 00908," for an example illustrating how this mechanism works within an interface.

The valid set of preferences should be determined by the placer and filler applications during implementation of the interface. Refer to User-defined Table 0294 - Time Selection Criteria Parameter Class Codes in Chapter 2C, Code Tables, for suggested examples.

Definition: This field is used in queries returning lists of possible appointment slots, or other lists of slots. If the filler application allows it, the querying application may indicate the spacing of the slots returned to the querying application, in relation to the requested start date/time in the ARQ segment. The value in this field should be a positive integer, representing the number of minutes between slot starting times that is returned in the query.

For example, if there is a request that an appointment with a duration of 1.5 hours be scheduled some time between 9:00 AM and 11:30 AM, and the APR-4 Slot Spacing Criteria field contains a value of 15, then the list of slots returned should read as follows:

9:00 - 10:30
9:15 - 10:45
9:30 - 11:00
9:45 - 11:15
10:00 - 11:30

Definition: This field is used to communicate override parameters to the filler application. These override parameters allow placer applications to override specific features of filler applications such as conflict checking. It is assumed that the placer and filler applications will pass enough information to determine whether the requestor is allowed to override such features. This chapter does not provide any security or permission information.

The first component of this field is a code identifying the parameter being passed to the filler application. The second component is the actual data value for that parameter.

Refer to Section 10.6.8.1, "APR-1 Time Selection Criteria (SCV) 00908," for an example illustrating how this mechanism works within an interface.

The valid set of parameters should be determined by the placer and filler applications during implementation of the interface.