visit the hl7 website The Demo site for our new HL7 Version 2+ (plus) Standard

18.8.9 AIP - Appointment Information - Personnel Resource Segment (10.6.7)

The AIP segment contains information about the personnel types that can be scheduled. Personnel included in a transaction using this segment are assumed to be controlled by a schedule on a schedule filler application. Personnel not controlled by a schedule are not identified on a schedule request using this segment. The kinds of personnel described on this segment include any healthcare provider in the institution controlled by a schedule (for example: technicians, physicians, nurses, surgeons, anesthesiologists, or CRNAs).

HL7 Attribute Table - AIP - Appointment Information - Personnel Resource

Base Framework
Seq#Data ElementDescriptionFlagsImplementCardinalityLengthC.LENVocabularyData Type
AIP
100906Set ID - AIP SHOULD[1..1][1..4]
SI

Sequence ID


200763Segment Action Code
C

Condition defined for this element

MAY[0..1][1..1]univ: SegmentActionCode (CD) hl7VS-segmentActionCode (VS) segmentAction (CS)
ID

Coded Value for HL7 Defined Tables


300913Personnel Resource ID
C

Condition defined for this element

MAY[0..*] 
XCN

Extended Composite ID Number and Name for Persons


400907Resource Type
C

Condition defined for this element

MAY[0..1] StaffType (CD)
CWE

Coded with Exceptions

500899Resource Group MAY[0..1] 
CWE

Coded with Exceptions


601202Start Date/Time
C

Condition defined for this element

MAY[0..1] 
DTM

Date/Time


700891Start Date/Time Offset
C

Condition defined for this element

MAY[0..1] 
NM

Numeric


800892Start Date/Time Offset Units
C

Condition defined for this element

MAY[0..1] 
CNE

Coded with No Exceptions

900893Duration MAY[0..1] 
NM

Numeric

1000894Duration Units MAY[0..1] 
CNE

Coded with No Exceptions


1100895Allow Substitution Code
C

Condition defined for this element

MAY[0..1] repr: AllowSubstitutionCodes (CD)
CWE

Coded with Exceptions

1200889Filler Status Code
C

Condition defined for this element

MAY[0..1] repr: FillerStatusCodes (CD)
CWE

Coded with Exceptions

Conditions/Invariants

The root for the expression is on the segment.

Seq. Referenced Elements Introduction Invariant Comment
1 ?

Seq#Data ElementDescriptionFlagsImplementCardinalityLengthC.LENVocabularyData Type
AIP
100906Set ID - AIP SHALL[1..1][1..4]
SI

Sequence ID


200763Segment Action Code
C

Condition defined for this element

MAY[0..1][1..1]univ: SegmentActionCode (CD) hl7VS-segmentActionCode (VS) segmentAction (CS)
ID

Coded Value for HL7 Defined Tables


300913Personnel Resource ID
C

Condition defined for this element

MAY[0..*] 
XCN

Extended Composite ID Number and Name for Persons


400907Resource Type
C

Condition defined for this element

MAY[0..1] StaffType (CD)
CWE

Coded with Exceptions

500899Resource Group MAY[0..1] 
CWE

Coded with Exceptions


601202Start Date/Time
C

Condition defined for this element

MAY[0..1] 
DTM

Date/Time


700891Start Date/Time Offset
C

Condition defined for this element

MAY[0..1] 
NM

Numeric


800892Start Date/Time Offset Units
C

Condition defined for this element

MAY[0..1] 
CNE

Coded with No Exceptions

900893Duration MAY[0..1] 
NM

Numeric

1000894Duration Units MAY[0..1] 
CNE

Coded with No Exceptions


1100895Allow Substitution Code
C

Condition defined for this element

MAY[0..1] repr: AllowSubstitutionCodes (CD) hl7VS-allowSubstitutionCodes (VS) allowSubstitution (CS)
CWE

Coded with Exceptions

1200889Filler Status Code
C

Condition defined for this element

MAY[0..1] repr: FillerStatusCodes (CD) hl7VS-fillerStatusCodes (VS) fillerStatus (CS)
CWE

Coded with Exceptions

Base FrameworkBase Standard Profile
Seq#Data ElementDescriptionFlagsImplementCardinalityLengthC.LENVocabularyData TypeImplementVocabulary
AIP 
100906Set ID - AIP SHOULD[1..1][1..4]
SI

Sequence ID

SHALL

200763Segment Action Code
C

Condition defined for this element

MAY[0..1][1..1]univ: SegmentActionCode (CD) hl7VS-segmentActionCode (VS) segmentAction (CS)
ID

Coded Value for HL7 Defined Tables

MAY 

300913Personnel Resource ID
C

Condition defined for this element

MAY[0..*] 
XCN

Extended Composite ID Number and Name for Persons

MAY

400907Resource Type
C

Condition defined for this element

MAY[0..1] StaffType (CD)
CWE

Coded with Exceptions

MAY
500899Resource Group MAY[0..1] 
CWE

Coded with Exceptions

MAY

601202Start Date/Time
C

Condition defined for this element

MAY[0..1] 
DTM

Date/Time

MAY

700891Start Date/Time Offset
C

Condition defined for this element

MAY[0..1] 
NM

Numeric

MAY

800892Start Date/Time Offset Units
C

Condition defined for this element

MAY[0..1] 
CNE

Coded with No Exceptions

MAY 
900893Duration MAY[0..1] 
NM

Numeric

MAY
1000894Duration Units MAY[0..1] 
CNE

Coded with No Exceptions

MAY 

1100895Allow Substitution Code
C

Condition defined for this element

MAY[0..1] repr: AllowSubstitutionCodes (CD)
CWE

Coded with Exceptions

MAYhl7VS-allowSubstitutionCodes (VS) allowSubstitution (CS)
1200889Filler Status Code
C

Condition defined for this element

MAY[0..1] repr: FillerStatusCodes (CD)
CWE

Coded with Exceptions

MAYhl7VS-fillerStatusCodes (VS) fillerStatus (CS)
Base Framework Base Standard Profile
Seq# Data Element Description Flags Optionality Repetition Length C.LEN Table Data Type Optionality Table
AIP  
1 00906 Set ID - AIP   O   [1..4]  
SI

Sequence ID

R  

2 00763 Segment Action Code
C

Condition defined for this element

O   [1..1]  
ID

Coded Value for HL7 Defined Tables

  (0206)

3 00913 Personnel Resource ID
C

Condition defined for this element

O Y    
XCN

Extended Composite ID Number and Name for Persons

   

4 00907 Resource Type
C

Condition defined for this element

O      
CWE

Coded with Exceptions

  (0182)
5 00899 Resource Group   O      
CWE

Coded with Exceptions

   

6 01202 Start Date/Time
C

Condition defined for this element

O      
DTM

Date/Time

   

7 00891 Start Date/Time Offset
C

Condition defined for this element

O      
NM

Numeric

   

8 00892 Start Date/Time Offset Units
C

Condition defined for this element

O      
CNE

Coded with No Exceptions

   
9 00893 Duration   O      
NM

Numeric

   
10 00894 Duration Units   O      
CNE

Coded with No Exceptions

   

11 00895 Allow Substitution Code
C

Condition defined for this element

O      
CWE

Coded with Exceptions

  (0279)
12 00889 Filler Status Code
C

Condition defined for this element

O      
CWE

Coded with Exceptions

  (0278)
Seq# Data Element Description Optionality Repetition Length C.LEN Table Data Type
AIP
1 00906 Set ID - AIP R   [1..4]  
SI

Sequence ID

2 00763 Segment Action Code C   [1..1] (0206)
ID

Coded Value for HL7 Defined Tables

3 00913 Personnel Resource ID C Y    
XCN

Extended Composite ID Number and Name for Persons

4 00907 Resource Type C     (0182)
CWE

Coded with Exceptions

5 00899 Resource Group O      
CWE

Coded with Exceptions

6 01202 Start Date/Time C      
DTM

Date/Time

7 00891 Start Date/Time Offset C      
NM

Numeric

8 00892 Start Date/Time Offset Units C      
CNE

Coded with No Exceptions

9 00893 Duration O      
NM

Numeric

10 00894 Duration Units O      
CNE

Coded with No Exceptions

11 00895 Allow Substitution Code C     (0279)
CWE

Coded with Exceptions

12 00889 Filler Status Code C     (0278)
CWE

Coded with Exceptions

18.8.9.1 AIP Field Definitions (10.6.7.0)

18.8.9.2 AIP-1 Set ID - AIP (SI) 00906 (10.6.7.1)

Definition: This field contains a number that uniquely identifies the information represented by this segment in this transaction for the purposes of addition, change or deletion.

18.8.9.3 AIP-2 Segment Action Code (ID) 00763 (10.6.7.2)

Definition: This field contains the action to be taken when updating or modifying information in this segment from previously sent interface transactions. Refer to HL7 Table 0206 - Segment Action Code in Chapter 2C, Code Tables, for valid values.

This field is conditionally required. It is required for all updating or modifying trigger events.

18.8.9.4 AIP-3 Personnel Resource ID (XCN) 00913 (10.6.7.3)

Definition: This field contains the ID number and name of the person being requested or scheduled for an appointment. This field is used to identify a specific person being requested, or a specific person who has been scheduled as a resource for an appointment. If the specific person is not known, but the type of resource is, AIP-4 Resource Type is used to identify the type of personnel resource required or scheduled. At a minimum, the ID number component should be supplied to identify either the specific person being requested or the specific person who has been scheduled. For inter-enterprise communications, for which a shared ID number may not be available, the minimum components needed to uniquely identify a person may be defined by site-specific negotiations.

This field is conditionally required for this segment. In new schedule request messages, it is required if the request asks that a specific person be scheduled. For all other request messages, the specific person should be identified if the information is available (either because a specific person was initially requested, or because the filler application returned the ID of the specific person who has been scheduled).

This field is required for all unsolicited transactions from the filler application. This field is optional for all query transactions.

18.8.9.5 AIP-4 Resource Type (CWE) 00907 (10.6.7.4)

Definition: This field identifies the type of the personnel requested/scheduled for an appointment. For all messages, this field is conditionally required if a specific location is not identified in AIP-3 Personnel Resource ID. Refer to HL7 Table 0182 - Staff Type in Chapter 2C, Code Tables, for suggested values.

18.8.9.6 AIP-5 Resource Group (CWE) 00899 (10.6.7.5)

Definition: This field identifies the requested resource as a member of the indicated group. If, in a Schedule Request Message (SRM), no specific resource is requested, but an AIP-4 Resource Type is requested, the AIP-5 Resource Group field can be used to further qualify the type of resource being requested.

18.8.9.7 AIP-6 Start Date/Time (DTM) 01202 (10.6.7.6)

Definition: This field contains the date and time this service needs for the appointment. This field allows the application to identify that the service is required for the appointment at a different time than the appointment's start date/time.

This field is conditionally required. If a value for AIP-7 Start Date/Time Offset is not provided, then a value is required for this field. To specify that there is no difference between the appointment's start date/time and the resource's start date/time either replicate the appointment's start date/time into this field, or specify an offset of zero (0) in AIP-7 Start Date/Time Offset and any valid time unit code in AIP-8 Start Date/Time Offset Units.

18.8.9.8 AIP-7 Start Date/Time Offset (NM) 00891 (10.6.7.7)

Definition: This field contains the offset this resource needs for the appointment, expressed in units of time relative to the scheduled start date/time. This field indicates to the application that the resource is required for the appointment at a different time than the appointment's start date/time. The first component contains the offset amount. An offset of zero (0), or an unvalued field, indicates that the resource is required at the start date/time of the appointment.

A positive offset (an unsigned or positive number) indicates that the resource is required after the appointment's start date/time. Specifying a negative offset indicates that the resource is required prior to the specified start date/time of the appointment. Negative offsets are allowed, and sites should clearly define the effect of a negative offset on the appointment's start date/time.

This field is conditionally required. If a value for AIP-6 Start Date/Time is not provided, then a value is required for this field. To specify that there is no difference between the appointment's start date/time and the resource's start date/time either replicate the appointment's start date/time into this field, or specify an offset of zero (0) in AIP-7 Start Date/Time Offset and any valid time unit code in AIP-8 Start Date/Time Offset Units.

18.8.9.9 AIP-8 Start Date/Time Offset Units (CNE) 00892 (10.6.7.8)

Definition: This field contains a code describing the units of time used for expressing AIP-7 Start Date/Time Offset. This field should be valued according to the recommendations made in Chapters 2 and 7. If this field is not valued, the ISO base unit of seconds (code "s") is assumed. Refer to Chapter 7, Figures 7-6 through 7-9, for a list of ISO+ and ANS+ unit codes.

This field is conditionally required. If a value for AIP-7 Start Date/Time Offset is provided, then a value is required for this field.

As of v2.6, the known applicable external coding systems include those in the table below. If the code set you are using is in this table, then you must use that designation.

Unit of Measure Coding Systems from HL7 Table 0396

Coding System

Description

Comment

ISO+

ISO 2955.83 (units of measure) with HL7 extensions

See chapter 7.

ANS+

HL7 set of units of measure

HL7 set of units of measure based upon ANSI X3.50 - 1986, ISO 2988-83, and US customary units / see chapter 7.

18.8.9.10 AIP-9 Duration (NM) 00893 (10.6.7.9)

Definition: This field contains the duration for which the resource is requested/scheduled for an appointment, if different from the overall duration of the requested/scheduled appointment. This field indicates to the application that a resource is required for a different amount of time than the appointment's overall duration. An unvalued duration indicates that the resource is required from its start date/time offset (specified in the previous two fields) until the end of the appointment. If no start date/time offset is specified, then the resource is required for the full duration of the appointment.

This field must be a positive, non-zero number. A negative number or zero (0) is nonsensical in the context of a duration.

18.8.9.11 AIP-10 Duration Units (CNE) 00894 (10.6.7.10)

Definition: This field contains a code describing the units of time used associated with AIP-9 Duration. This field should be valued according to the recommendations made in Chapters 2 and 7. If this field is not valued, the ISO base unit of seconds (code "s") will be assumed. Refer to Chapter 7, Figures 7-6 through 7-9, for a list of ISO+ and ANS+ unit codes.

As of v2.6, the known applicable external coding systems include those in the table below. If the code set you are using is in this table, then you must use that designation.

Unit of Measure Coding Systems from HL7 Table 0396

Coding System

Description

Comment

ISO+

ISO 2955.83 (units of measure) with HL7 extensions

See chapter 7.

ANS+

HL7 set of units of measure

HL7 set of units of measure based upon ANSI X3.50 - 1986, ISO 2988-83, and US customary units / see chapter 7.

18.8.9.12 AIP-11 Allow Substitution Code (CWE) 00895 (10.6.7.11)

Definition: This field contains a code indicating whether the identified personnel resource can be replaced with an equivalent substitute personnel resource by the filler application. Refer to User-Defined Table 0279 - Allow Substitution Codes in Chapter 2C, Code Tables, for suggested values.

This field is conditionally required. It is required for all request messages. It is optional for all unsolicited transactions, and for all query messages.

18.8.9.13 AIP-12 Filler Status Code (CWE) 00889 (10.6.7.12)

Definition: This field contains a code that describes the requested/scheduled status of the personnel resource, from the point of view of the filler application. Refer to User-Defined Table 0278 - Filler Status Codes in Chapter 2C, Code Tables, for suggested codes.

This field is conditionally required. It should not be valued in any request transactions from the placer application to the filler application. It is required for all transactions from the filler application. It is optional for query transactions.

This is a conditionally required field. Because the information contained in this field is only appropriate in transactions originating from a filler application, it is required for those messages. This includes all unsolicited transactions originating from a filler application, as well as all response messages originating from a filler application. This field is optional for all transactions originating from placer, querying and auxiliary applications. It is recommended that this field be left unvalued in transactions originating from applications other than the filler application.