Outgoing Appointment Scheduling Interface
Outgoing Appointment Scheduling Interface
Outgoing Appointment
Scheduling Interface
Technical Specification
Version: May 2021
Last Updated: April 29, 2021
For additional interface technical specifications, or the most current version of this document, visit https://open.epic.com.
Do not distribute this document.
To access the table of contents, use the bookmarks feature within your PDF reader.
Message Specifications
The interface sends scheduling information from Cadence to external systems .
Note:
This document can be shared with third parties to assist with interface implementation.
The interface is a subset of the full standard as defined in the published normative HL7 documentation coinciding with
the released software version. It may not support the entire HL7 specification, depending on functional needs.
[{OBX}] Observation/Result 7
{
[{
}]
[{
}]
[{
}]
}
[{
}]
Additional Appointment
[ZCH] N/A
Information
Message Format for SRM Event Types S01, S02, S03, and S04
SRM General Schedule Request Message Chapter
[{OBX}] Observation/Result 7
}]
}]}
ACK General Acknowledgement Chapter
Example Messages
S12 - New Appointment
Format Example
MSH|^~\&|SCHED|SENDING FAC|RECEIVING APP|RECEIVINGFAC|2010052711090000||SIU^S12|1055|P|
2.3||
SCH|1|36996|||||||30|MIN|^^^201005271115|589^LEE^STEVEN^^^^|(608)271-9000|5301 TOKAY
BLVD^ALTERNATE ADDR^MADISON^^53719^|||||||||||1^SCH
NTE|1||CSCOPE
PID|||Z556301||JOHNSON^JOHN^^^^||19720324|M|||123 MAIN ST^^PRIOR LAKE^MN^22334^||
271-9000||||||333-44-4433|||||||||||N
PV1||O|IM||||||||||||||||36996|||||||||||||||||
OBX|1|TX|PPC^PPC||PATIENT LEVEL COMMENTS
RGS|1||1^INTERNAL MEDICINE
AIS|1||001^GI EXAM
NTE|1||Notes 1
NTE|2||Notes 2
AIG|1||399^COLONOSCOPY ROOM^^^^^|2^RESOURCE||||201005271130|30|MIN|30|MIN
NTE|1||leave 10 minutes between patients for cleaning
AIP|1||400^BEST^TINA^^^^|1^MD||201005271115|0|MIN|15|MIN
NTE|1||Tina is scheduled on alternate weeks only
S26 - Notification that Patient Did Not Show for Scheduled Appointment
Format Example
MSH|^~\&|SCHED|SENDING FAC|RECEIVING APP|RECEIVING FAC|2010061109560000||SIU^S26|1462|P|
2.3||
SCH|1|44444|||||||30|MIN|^^^201006111000|589^LEE^STEVEN^^^^|(608)271-9000|5301 TOKAY
BLVD^ALTERNATE ADDR^MADISON^^53719^|||||||||||4^NO SHOW
NTE|1||strep – pt stated
PID|||Z556301||JOHNSON^JOHN^^^^||19720324|M|||123 MAIN ST^^PRIOR LAKE^MN^22334^||
271-9000||||||333-44-4433|||||||||||N
PV1||O|IM||||||||||||||||44444|||||||||||||||||
RGS|1||1^INTERNAL MEDICINE
AIS|1||001^OFFICE VISIT
AIP|1||400^WEST^TOM^RN^^^|1^MD||201006111010|0|MIN|15|MIN
NTE|1||Have a great day.
(suggestion)
Supported Segments and Fields
10 - Message Control ST Required The value sent in this field is returned in the acknowledgment message
ID (MSA).
11 - Processing ID PT Required This field can contain the following values:
• D-Debugging
• P-Production
• T-Training
12 - Version ID VID Required HL7 version number.
Example: 2.5.1
13 - Sequence NM Optional Optional field used in the sequence number protocol
Number Format: Numeric
14 - Not Supported — — —
15 - Accept ID Optional This field indicates whether request enhanced acknowledgments are
Acknowledgment requested. If null, original acknowledgments are requested.
Type
Potential values include:
• AL-Always send acknowledgment
• NE-Never send acknowledgment
Element Name Type Usage Notes
• ER-Only send acknowledgments on errors
• SU-Only send acknowledgments on success
16 - Application ID Optional This field indicates whether request enhanced application
Acknowledgment acknowledgments are requested. If null, original application
Type acknowledgments are requested.
Values:
• AL-Always send acknowledgment
• NE-Never send acknowledgment
• ER-Only send acknowledgments on errors
• SU-Only send acknowledgments on success
17 - Country Code ID Optional This field contains the country code.
18 - Character Set ID Optional Configurable. Supports options for Unicode UTF-8, ASCII, or ISO 8859-1.
Default is no translation.
19 - Not Supported — — —
20 - Not Supported — — —
21 - Message Profile ID Optional —
Identifier
22 - Sending XON Optional Free text
Responsible
Organization
23 - Receiving XON Optional Free text
Responsible
Organization
8 - Not Supported — — —
9 - Appointment NM Optional Appointment length
Duration
Element Name Type Usage Notes
10 - Appointment CNE Optional Appointment length units
Duration Units
Format: "S" or "MIN"
11 - Appointment TQ Required This field contains the appointment start date/time, end date/time, and
Timing Quantity duration.
Format: ^^<duration>^CCYYMMDDHHMM^CCYYMMDDHHMM
17 - Not Supported — — —
18 - Not Supported — — —
19 - Not Supported — — —
20 - Entered By XCN Required Data entry person
Person
Format: <ID>^<Name>^^^^^^^<Assigning Authority>^^^^<ID Type>
21 - Not Supported — — —
22 - Not Supported — — —
23 - Not Supported — — —
24 - Not Supported — — —
25 - Filler Status Code CWE Optional Appointment status. Mapped using a translation table.
Format: <ID>^<Text>
26 - Placer Order — Optional Orders scheduled to the current appointment. May repeat if multiple
Number orders are linked to the appointment.
Format: <Order A ID#1>~<Order B ID#1>...
27 - Filler Order — Optional Orders scheduled to the current appointment. May repeat if multiple
Number orders are linked to the appointment.
Format: <Order A ID#2>~<Order B ID#2>...
5 - Not Supported — — —
6 - Handicap IS Optional Can have multiple repetitions:
<Handicap1>~<Handicap2>
7 - Not Supported — — —
8 - Not Supported — — —
9 - Not Supported — — —
10 - Not Supported — — —
11 - Publicity Code CWE Optional —
Element Name Type Usage Notes
12 - Protection ID Optional This field indicates patient consent based on document of a certain type
Indicator and status.
13 - Protection DT Optional —
Indicator Effective
Date
14 - Place of Worship XON Optional <Place of Worship name>^^<Place of Worship ID>
15 - Advance — — <Code Status Identifier>^<Code Status Title>^<Coding System ID>
Directive Code Status
16 - Immunization CWE Optional —
Registry Status
17 - Immunization DT Optional —
Registry Status
Effective Date
18 - Publicity Code DT Optional —
Effective Date
5 - Role Begin Date DTM Optional Identifies the date and time at which the role takes effect.
6 - Role End Date DTM Optional Identifies the date and time at which the role takes expires.
7 - Not Supported — — —
8 - Role Action CWE Optional Identifies the reason why the person is assuming or changing the role.
Reason
Format: <Code>^<Text>
9 - Provider Type CWE Optional This field is mapped using the associated translation table.
10 - Organization CWE Optional This field is mapped using the associated translation table.
Unit Type
11 - Office/Home XAD Optional Identifies the office address of the person in this ROL segment.
Address/Birthplace
• Street
Element Name Type Usage Notes
• Dwelling number
• City
• State
• ZIP/Postal code
• Country
• County
Format (dwelling number part of street address line 1):
<Street 1>^<Street 2>^<City>^<State>^<ZIP
code>^<Country>^<Address Type>^^<County>^^^^<Start
Date>^<End Date>
Format (dwelling number entered discretely in I SER 1276):
&<Street 1>&<Dwelling Number>^<Street
2>^<City>^<State>^<ZIP code>^<Country>^<Address
Type>^^<County>^^^^<Start Date>^<End Date>
12 - Provider Phone XTN Optional Sends the provider's office phone and fax number.
Number
4 - Not Supported — — —
5 - Not Supported — — —
6 - Not Supported — — —
7 - Attending Doctor XCN Optional Attending doctor
8 - Referring Doctor XCN Optional —
9 - Consulting Doctor XCN Optional Format: (preferred)
<Provider ID>^<Last name>^<First name>^<Middle
initial>^^^^^<Assigning authority>^^^^<Identifier type
code>
11 - Not Supported — — —
12 - Not Supported — — —
13 - Not Supported — — —
14 - Not Supported — — —
15 - Not Supported — — —
16 - Not Supported — — —
Element Name Type Usage Notes
17 - Admitting XCN Optional —
Doctor
18 - Patient Type IS Optional —
19 - Visit Number CX Optional Generally set to the same number as SCH-2.
20 - Financial Class FC Optional Retained for backwards compatibility
21 - Not Supported — — —
22 - Not Supported — — —
23 - Not Supported — — —
24 - Not Supported — — —
25 - Not Supported — — —
26 - Not Supported — — —
27 - Not Supported — — —
28 - Not Supported — — —
29 - Not Supported — — —
30 - Not Supported — — —
31 - Not Supported — — —
32 - Not Supported — — —
33 - Not Supported — — —
34 - Not Supported — — —
35 - Not Supported — — —
36 - Discharge IS Optional —
Disposition
37 - Not Supported — — —
38 - Not Supported — — —
39 - Not Supported — — —
40 - Not Supported — — —
41 - Not Supported — — —
42 - Not Supported — — —
43 - Not Supported — — —
44 - Admit Date/Time DTM Optional The date and time an appointment check-in occurred in Epic.
Format: YYYYMMDDhhmmss
45 - Discharge Date/ DTM Optional The date and time an appointment was checked out in Epic.
Time
Format: YYYYMMDDhhmmss
46 - Not Supported — — —
47 - Not Supported — — —
48 - Not Supported — — —
49 - Not Supported — — —
50 - Alternate Visit ID CX Optional —
DG1 - Diagnosis
Segment-Level Summary
7 - Not Supported — — —
8 - Not Supported — — —
9 - Not Supported — — —
10 - Not Supported — — —
11 - Not Supported — — —
12 - Not Supported — — —
13 - Not Supported — — —
14 - Not Supported — — —
15 - Not Supported — — —
16 - Not Supported — — —
17 - Not Supported — — —
18 - Not Supported — — —
19 - Not Supported — — —
Element Name Type Usage Notes
20 - Not Supported — — —
21 - Not Supported — — —
22 - Not Supported — — —
23 - Not Supported — — —
24 - Not Supported — — —
25 - Not Supported — — —
26 - Present On CWE Optional Format: String
Admission (POA)
Indicator
4 - Not Supported — — —
5 - Not Supported — — —
6 - Not Supported — — —
7 - Not Supported — — —
8 - Not Supported — — —
9 - Not Supported — — —
10 - Filler Status Code CWE Optional Appointment status Mapped using a translation table
Format: <ID>
11 - Not Supported — — —
12 - Service Filler Info ST Optional —
6 - Not Supported — — —
7 - Not Supported — — —
8 - Start Date/Time DTM Optional Appointment date and appointment time
Format: CCYYMMDDHHMM
9 - Start Date/Time NM Optional Offset to the appointment start time
Offset
10 - Start Date Time CNE Optional Configurable. Default is seconds.
Offset Units
Format: "S" or "MIN"
11 - Duration NM Optional Format: Numeric
12 - Duration Units CNE Optional Configurable. Default is seconds.
Format: "S" or "MIN"
3 - Hidden — Optional Indicates whether the appointment should be hidden from the patient.
Appointment Flag
4 - TBD Appointment — Optional Indicates whether the appointment's scheduled time will be determined at
Flag a later time.
2 - Communication ST Optional ZTP-2.1 contains the media name (for example, phone). ZTP-2.2 contains
Preference Media either Y or N to indicate whether a media is approved.
Example: Text^Y~Phone^Y~E-mail^N
8 - Not Supported — — —
9 - Appointment NM Optional Appointment length
Duration
10 - Appointment CNE Optional Appointment length unit
Duration Units
Format: "S" or "MIN"
11 - Requested Start DR Optional Appointment date and appointment time
Date/Time Range
Format: CCYYMMDDHHMM ^CCYYMMDDHHMM
12 - Not Supported — — —
13 - Not Supported — — —
14 - Not Supported — — —
Element Name Type Usage Notes
15 - Entered By XCN Required —
Person
16 - Placer Contact XTN Optional Format:(xxx)xxx-xxxx or xxx-xxxx
Phone Number
17 - Placer Contact XAD Optional Address
Address
City
State
ZIP Code
18 - Not Supported — — —
19 - Entered By XCN Required —
Person
20 - Not Supported — — —
21 - Not Supported — — —
22 - Not Supported — — —
23 - Not Supported — — —
24 - Placer Order EI Optional Orders scheduled to the current appointment. May repeat if multiple
Number orders are linked to the appointment.
Format: <Order A ID#1>~<Order B ID#1>...
25 - Filler Order EI Optional Orders scheduled to the current appointment. May repeat if multiple
Number orders are linked to the appointment.
Format: <Order A ID#1>~<Order B ID#1>...
12 - Provider Phone XTN Optional Sends the provider's office phone and fax number.
Number
4 - Not Supported — — —
5 - Not Supported — — —
6 - Not Supported — — —
7 - Attending Doctor XCN Optional Attending doctor
8 - Referring Doctor XCN Optional —
9 - Consulting Doctor XCN Optional Format: (preferred)
Element Name Type Usage Notes
<Provider ID>^<Last name>^<First name>^<Middle
initial>^^^^^<Assigning authority>^^^^<Identifier type
code>
11 - Not Supported — — —
12 - Not Supported — — —
13 - Not Supported — — —
14 - Not Supported — — —
15 - Not Supported — — —
16 - Not Supported — — —
17 - Admitting XCN Optional —
Doctor
18 - Patient Type IS Optional —
19 - Visit Number CX Optional Generally set to the same number as SCH-2.
20 - Financial Class FC Optional Retained for backwards compatibility
21 - Not Supported — — —
22 - Not Supported — — —
23 - Not Supported — — —
24 - Not Supported — — —
25 - Not Supported — — —
26 - Not Supported — — —
27 - Not Supported — — —
28 - Not Supported — — —
29 - Not Supported — — —
30 - Not Supported — — —
31 - Not Supported — — —
32 - Not Supported — — —
33 - Not Supported — — —
34 - Not Supported — — —
35 - Not Supported — — —
36 - Discharge IS Optional —
Disposition
37 - Not Supported — — —
38 - Not Supported — — —
39 - Not Supported — — —
40 - Not Supported — — —
41 - Not Supported — — —
42 - Not Supported — — —
43 - Not Supported — — —
44 - Admit Date/Time DTM Optional The date and time an appointment check-in occurred in Epic.
Format: YYYYMMDDhhmmss
Element Name Type Usage Notes
45 - Discharge Date/ DTM Optional The date and time an appointment was checked out in Epic.
Time
Format: YYYYMMDDhhmmss
46 - Not Supported — — —
47 - Not Supported — — —
48 - Not Supported — — —
49 - Not Supported — — —
50 - Alternate Visit ID CX Optional —
DG1 - Diagnosis
Segment-Level Summary
7 - Not Supported — — —
8 - Not Supported — — —
9 - Not Supported — — —
10 - Not Supported — — —
11 - Not Supported — — —
12 - Not Supported — — —
13 - Not Supported — — —
14 - Not Supported — — —
15 - Not Supported — — —
Element Name Type Usage Notes
16 - Not Supported — — —
17 - Not Supported — — —
18 - Not Supported — — —
19 - Not Supported — — —
20 - Not Supported — — —
21 - Not Supported — — —
22 - Not Supported — — —
23 - Not Supported — — —
24 - Not Supported — — —
25 - Not Supported — — —
26 - Present On CWE Optional Format: String
Admission (POA)
Indicator
4 - Not Supported — — —
5 - Not Supported — — —
6 - Not Supported — — —
7 - Not Supported — — —
8 - Not Supported — — —
9 - Not Supported — — —
10 - Filler Status Code CWE Optional Appointment status Mapped using a translation table
Format: <ID>
11 - Not Supported — — —
12 - Service Filler Info ST Optional —
NTE - Notes and Comments following AIS
Segment-Level Summary
6 - Not Supported — — —
7 - Not Supported — — —
8 - Start Date/Time DTM Optional Appointment date and appointment time
Format: CCYYMMDDHHMM
9 - Start Date/Time NM Optional Offset to the appointment start time
Offset
10 - Start Date Time CNE Optional Configurable. Default is seconds.
Offset Units
Format: "S" or "MIN"
11 - Duration NM Optional Format: Numeric
12 - Duration Units CNE Optional Configurable. Default is seconds.
Format: "S" or "MIN"
2 - Communication ST Optional ZTP-2.1 contains the media name (for example, phone). ZTP-2.2 contains
Preference Media either Y or N to indicate whether a media is approved.
Example: Text^Y~Phone^Y~E-mail^N
Message Types: SCHEDULE QUERY RESPONSE
MSH - Message Header
Element Name Type Usage Notes
2 - Encoding ST Required Value is typically: ^~\&
Characters
3 - Sending HD Optional Format: Free text, configurable
Application
4 - Sending Facility HD Optional Format: Free text, configurable
5 - Receiving HD Optional Format: Free text, configurable
Application
6 - Receiving Facility HD Optional Format: Free text, configurable
7 - Date/Time of DTM Optional Sending UTC offset is configurable.
Message
Example: 20140203133854-0500
8 - Security ST Optional The user that triggered the interface message is sent in this field.
9 - Message Type MSG Required Format: <Message type>^<Trigger event>
Example: SIU^S12
10 - Message Control ST Required A number or other unique identifier for the message.
ID
Format: Free text
11 - Processing ID PT Required This field can contain the following values:
• D-Debugging
• P-Production
• T-Training
12 - Version ID VID Required HL7 version number.
Example: 2.5.1
13 - Sequence NM Optional Optional field used in the sequence number protocol
Number Format: Numeric
14 - Not Supported — — —
15 - Accept ID Optional This field indicates whether request enhanced acknowledgments are
Acknowledgment requested. If null, original acknowledgments are requested.
Type
Potential values include:
• AL-Always
• NE-Never
• <Null>
16 - Application ID Optional This field indicates whether request enhanced application
Acknowledgment acknowledgments are requested. If null, original application
Type acknowledgments are requested.
Element Name Type Usage Notes
Values:
• NE
• <Null>
17 - Country Code ID Optional This field contains the country code.
18 - Character Set ID Optional Configurable. Supports options for Unicode UTF-8, ASCII, or ISO 8859-1.
Default is no translation.
19 - Not Supported — — —
20 - Not Supported — — —
21 - Conformance ID Optional —
Statement ID
22 - Sending XON Optional Free text
Responsible
Organization
23 - Receiving XON Optional Free text
Responsible
Organization
17 - Not Supported — — —
18 - Not Supported — — —
19 - Not Supported — — —
20 - Placer Contact XCN Optional Data entry person
Person
Format: ID^Name
21 - Not Supported — — —
22 - Not Supported — — —
23 - Not Supported — — —
24 - Not Supported — — —
25 - Filler Status Code CWE Optional Appointment status. Mapped using a translation table.
Format: <ID>^<Text>
26 - Placer Order — Optional Orders scheduled to the current appointment. May repeat if multiple
Number orders are linked to the appointment.
Format: <Order A ID#1>~<Order B ID#1>...
27 - Filler Order — Optional Orders scheduled to the current appointment. May repeat if multiple
Number orders are linked to the appointment.
Format: <Order A ID#2>~<Order B ID#2>...
14 - Phone Number – XTN Optional Format: Standard HL7 phone number format. If configured, the number
Work will be sent across several subfields.
Example: 01(848)271-9000or01(848)271-9000^^^^01^848^271-9000
Or
#<text>
21 - Mother's CX Optional —
Identifier
22 - Ethnic Group IS Optional This field is mapped according to a translation table.
23 - Birth Place ST Optional Birth city and state
Format: Standard HL7 address format
24 - Multiple Birth ID Optional —
Indicator
Element Name Type Usage Notes
25 - Birth Order NM Optional Format: Numeric
26 - Citizenship CWE Optional This field is mapped using a translation table.
27 - Veterans Military CWE Optional This field is mapped using a translation table.
Status
28 - Country of CWE Optional This field is mapped using a translation table.
Origin
29 - Patient Death DTM Optional Format: Standard HL7 timestamp
Date and Time
• Death date
• Death time
30 - Patient Death ID Optional Values:
Indicator
• Y – The patient is deceased
• N or blank – The patient is not deceased
31 - Identity ID Optional —
Unknown Indicator
32 - Identity IS Optional —
Reliability Code