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

Draft Website - For Review Purposes Only

Data Type

Data types

The data types in this section are listed in alphabetical order.

The data type examples in this Standard are given using the standard HL7 encoding rules, with the delimiter values from Figure 2-1 of Chapter 2, "Control", section 2.5.4, "Message delimiters".

Note: These message construction rules define the standard HL7 encoding rules, creating variable length delimited messages. Although only one set of encoding rules has been defined as a standard since HL7 Version 2.3, other encoding rules are possible (but since they are non-standard, they may only be used by a site-specific agreement).



In this chapter, square brackets, "[" and "]", are used to specify optional parts of a string. For instance, the format of a date field is “YYYY[MM[DD]]” which denotes that the field may contain four, six, or eight characters respectively. The characters may further constrain the possible contents of the string – this will be documented at the point of use.

AD - address

HL7 Component Table - AD - address
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
AD
1 Street Address [0..1] 120 ST
2 Other Designation [0..1] 120 ST
3 City [0..1]  50 ST
4 State or Province [0..1]  50 ST
5 Zip or Postal Code [0..1]  12 ST
6 Country SHALL [0..1] [3..3]     ID
7 Address Type SHALL [0..1] [1..3]     ID
8 Other Geographic Designation [0..1]  50 ST

Components: <Street Address (ST)> & <Other Designation (ST)> & <City (ST)> & <State or Province (ST)> & <Zip or Postal Code (ST)> & <Country (ID)> & <Address Type (ID)> & <Other Geographic Designation (ST)>


Example:

|10 ASH LN^#3^LIMA^OH^48132|

AD-1: Street Address (ST)

Definition: This component specifies the street or mailing address of a person or institution. When referencing an institution, this first component is used to specify the institution name. When used in connection with a person, this component specifies the first line of the address.

AD-2: Other Designation (ST)

Definition: This component specifies the second line of address. In general, it qualifies address. Examples: Suite 555 or Fourth Floor. When referencing an institution, this component specifies the street address.

AD-3: City (ST)

Definition: This component specifies the city, district or place where the addressee is located depending upon the national convention for formatting addresses for postal usage.

AD-4: State or Province (ST)

Definition: This component specifies the state or province where the addressee is located. State or province should be represented by the official postal service codes for that country.

AD-5: Zip or Postal Code (ST)

Definition: This component specifies the zip or postal code where the addressee is located. Zip or postal codes should be represented by the official codes for that country. In the US, the zip code takes the form 99999[-9999], while the Canadian postal code takes the form A9A9A9 and the Australian Postcode takes the form 9999.

AD-6: Country (ID)

Definition: This component specifies the country where the addressee is located. HL7 specifies that the 3-character (alphabetic) form of ISO 3166 be used for the country code. Refer to HL7 Table 0399 - Country Code in Chapter 2C, Code Tables, for valid values.

AD-7: Address Type (ID)

Definition: This component specifies the kind or type of address. Refer to HL7 Table 0190 - Address Type in Chapter 2C, Code Tables, for valid values.

AD-8: Other Geographic Designation (ST)

Definition: This component specifies any other geographic designation that may be necessary. It includes county, bioregion, SMSA, etc.

AUI - authorization information

HL7 Component Table - AUI - authorization information
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
AUI
1 Authorization Number [0..1]  30 ST
2 Date [0..1]     DT
3 Source [0..1] 199 ST

Components: <Authorization Number (ST)> & <Date (DT)> & <Source (ST)>


AUI-1: Authorization Number (ST)

Definition: Identifier assigned to the authorization.

AUI-2: Date (DT)

Definition: Date of authorization.

AUI-3: Source (ST)

Definition: Source of authorization.

CCD - charge code and date

HL7 Component Table - CCD - charge code and date
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CCD
1 Invocation Event SHALL [1..1] [1..1]     ID
2 Date/time [0..1]     DTM

Components: <Invocation Event (ID)> & <Date/time (DTM)>


CCD-1: Invocation Event (ID)

Definition: Specifies the code for the event precipitating/triggering the charge activity. Refer to HL7 Table 0100 - Invocation event for valid values.

CCD-2: Date/time (DTM)

Definition: The second component is used to express the exact time to charge for the ordered service; it is used only when the CCD.1 value is T. When used, it is expressed as a DTM data type.

CCP - channel calibration parameters

Attention: Retained for backward compatibility only in version 2.7. This is used only in the CD Channel Definition data type, which has been retained for backward compatibility only in v2.7.

HL7 Component Table - CCP - channel calibration parameters
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CCP
1 Channel Calibration Sensitivity Correction Factor [0..1]   6 NM
2 Channel Calibration Baseline [0..1]   6 NM
3 Channel Calibration Time Skew [0..1]   6 NM

Components: <Channel Calibration Sensitivity Correction Factor (NM)> & <Channel Calibration Baseline (NM)> & <Channel Calibration Time Skew (NM)>


CCP-1: Channel Calibration Sensitivity Correction Factor (NM)

Definition: This component defines a correction factor for channel sensitivity, which may be derived from the last calibration procedure performed. The actual channel sensitivity is the nominal channel sensitivity given in the previous component multiplied by the unitless correction factor.

CCP-2: Channel Calibration Baseline (NM)

Definition: This component defines the actual channel baseline (the data value which corresponds to a nominal input signal of zero). The actual baseline may differ from the ideal because of a dc offset in the amplifier connected to the ADC. The actual baseline values for all channels (which need not be integers) may be determined at the time of calibration as the average digitized values obtained when a zero input signal is connected to each channel.

CCP-3: Channel Calibration Time Skew (NM)

Definition: This component defines the time difference between the nominal sampling (digitization) time (which would be the same for all channels) and the actual sampling time of the channel, in seconds (or fractions thereof). This value will differ from zero when all channels in the montage are not sampled simultaneously, as occurs in systems, which sample successive channels at regular time intervals. This value may be determined from a calibration procedure in which an identical time-varying signal is applied to all channels and interchannel time differences are estimated, or more commonly it may be taken from the manufacturer’s specifications for the digitizing system used. For example, for a system which samples successive channels at regular time intervals t, the time skew of channel number n would be (n-1)t. The actual time of sampling (digitization) of sample number m of channel number n in such a system would be R + (m-1)/f + (n-1)t, where R is the reference time at the start of the epoch and f is the channel sampling frequency (t < 1/f).

CD - channel definition

Attention: Retained for backward compatibility onlyas of v 2.7. This is used only in the waveform message, CHM category, which has been retained for backward compatibility only in v 2.7.

HL7 Component Table - CD - channel definition
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CD
1 Channel Identifier [0..1]     WVI
2 Waveform Source [0..1]     WVS
3 Channel Sensitivity and Units [0..1]     CSU
4 Channel Calibration Parameters [0..1]     CCP
5 Channel Sampling Frequency [0..1]   6 NM
6 Minimum and Maximum Data Values [0..1]     NR

Components: <Channel Identifier (WVI)> & <Waveform Source (WVS)> & <Channel Sensitivity and Units (CSU)> & <Channel Calibration Parameters (CCP)> & <Channel Sampling Frequency (NM)> & <Minimum and Maximum Data Values (NR)>

Subcomponents for Channel Identifier (WVI): <Channel Number (NM)> ^ <Channel Name (ST)>

Subcomponents for Waveform Source (WVS): <Source One Name (ST)> ^ <Source Two Name (ST)>

Subcomponents for Channel Sensitivity and Units (CSU): <Channel Sensitivity (NM)> ^ <Unit of Measure Identifier (ST)> ^ <Unit of Measure Description (ST)> ^ <Unit of Measure Coding System (ID)> ^ <Alternate Unit of Measure Identifier (ST)> ^ <Alternate Unit of Measure Description (ST)> ^ <Alternate Unit of Measure Coding System (ID)> ^ <Unit of Measure Coding System Version ID (ST)> ^ <Alternate Unit of Measure Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Unit of Measure Identifier (ST)> ^ <Second Alternate Unit of Measure Text (ST)> ^ <Name of Second Alternate Unit of Measure Coding System (ID)> ^ <Second Alternate Unit of Measure Coding System Version ID (ST)> ^ <Unit of Measure Coding System OID (ST)> ^ <Unit of Measure Value Set OID (ST)> ^ <Unit of Measure Value Set Version ID (DTM)> ^ <Alternate Unit of Measure Coding System OID (ST)> ^ <Alternate Unit of Measure Value Set OID (ST)> ^ <Alternate Unit of Measure Value Set Version ID (DTM)> ^ <Alternate Unit of Measure Coding System OID (ST)> ^ <Alternate Unit of Measure Value Set OID (ST)> ^ <Alternate Unit of Measure Value Set Version ID (ST)>

Subcomponents for Channel Calibration Parameters (CCP): <Channel Calibration Sensitivity Correction Factor (NM)> ^ <Channel Calibration Baseline (NM)> ^ <Channel Calibration Time Skew (NM)>

Subcomponents for Minimum and Maximum Data Values (NR): <Low Value (NM)> ^ <High Value (NM)>

Definition: This data type is used for labeling of digital waveform data. It defines a recording channel, which is associated with one of the values in each time sample of waveform data. Each channel has a number (which generally defines its position in a multichannel display) and an optional name or label (also used in displays). One or two named waveform sources may also be associated with a channel (providing for the use of differential amplifiers with two inputs). The other components of the channel definition data type are optional. The individual components are defined as follows:

CD-1: Channel Identifier (WVI)

Definition: This component specifies the number and name of the recording channel where waveform data is transmitted.

CD-2: Waveform Source (WVS)

Definition: This component identifies the source of the waveform connected to the channel. Two names may be specified if it is necessary to individually identify the two inputs for a waveform. Only one name need be specified if the channel is connected to a single input. For example, in EKG recordings typically only one name is used (such as I or II); in electroencephalography, two names are typically used, one for each input of the differential amplifier (such as F3 and C3).

CD-3: Channel Sensitivity and Units (CSU)

Definition: This component defines the channel sensitivity (gain) and the units in which it is measured.

CD-4: Channel Calibration Parameters (CCP)

Definition: This component identifies the corrections to channel sensitivity, the baseline, and the channel time skew.

CD-5: Channel Sampling Frequency (NM)

Definition: This component defines the sampling frequency in hertz of the channel, that is, the reciprocal of the time in seconds between successive samples

CD-6: Minimum and Maximum Data Values (NR)

Note: this is the frequency of transmitted data, which may or may not be the actual frequency at which the data was acquired by an analog-to-digital converter or other digital data source (i.e. the data transmitted may be subsampled, or interpolated, from the originally acquired data.)


Definition: This component defines the minimum and maximum data values which can occur in this channel in the digital waveform data, that is, the range of the ADC. , and also specifies whether or not non-integral data values may occur in this channel in the waveform data. If the minimum and maximum values are both integers (or not present), only integral data values may be used in this channel. If either the minimum or the maximum value contains a decimal point, then non-integral as well as integral data values may be used in this channel. For an n-bit signed ADC, the nominal baseline B = 0, and the minimum (L) and maximum (H) values may be calculated as follows:

L = -2n-1

H = 2n-1 - 1

For an unsigned n-bit ADC, the minimum value L = 0, and the nominal baseline value (B) and maximum value (H) may be calculated from the formulas,

B = 2n-1

H = 2n - 1

The actual signal amplitude A (for differentially amplified potential measurements, the potential at electrode number one minus that at electrode number two) may be calculated from the value D (range L to H) in the waveform data using the actual baseline value B and the nominal sensitivity S and actual sensitivity correction factor C by the formula,

A = SC(D-B)

WITHDRAWN (CE – coded entry)

Attention: The CE data type has been replaced by the CWE and CNE data types and the detail was withdrawn and removed from the standard as of v 2.6.

CF - coded element with formatted values

As of v2.7 a third tuple, formerly known as triplet, has been added to the CF data type. Additionally, 3 new components were added to each tuple such that each tuple now has a total of 7 components. The Original Text component applies to the CF as a whole.

HL7 Component Table - CF - coded element with formatted values
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CF
1 Identifier [0..1]  20 ST
2 Formatted Text [0..1]     FT
3 Name of Coding System SHALL [0..1] [1..12]     ID
4 Alternate Identifier [0..1]  20 ST
5 Alternate Formatted Text [0..1]     FT
6 Name of Alternate Coding System SHALL [0..1] [1..12]     ID
7 Coding System Version ID [0..1]  10 ST
8 Alternate Coding System Version ID [0..1]  10 ST
9 Original Text [0..1] 199 ST
10 Second Alternate Identifier [0..1]  20 ST
11 Second Alternate Formatted Text [0..1]     FT
12 Name of Second Alternate Coding System SHALL [0..1] [1..12]     ID
13 Second Alternate Coding System Version ID [0..1]  10 ST
14 Coding System OID [0..1] 199 ST
15 Value Set OID [0..1] 199 ST
16 Value Set Version ID [0..1]   8 DTM
17 Alternate Coding System OID [0..1] 199 ST
18 Alternate Value Set OID [0..1] 199 ST
19 Alternate Value Set Version ID [0..1]   8 DTM
20 Second Alternate Coding System OID [0..1] 199 ST
21 Second Alternate Value Set OID [0..1] 199 ST
22 Second Alternate Value Set Version ID [0..1]   8 DTM

Components: <Identifier (ST)> & <Formatted Text (FT)> & <Name of Coding System (ID)> & <Alternate Identifier (ST)> & <Alternate Formatted Text (FT)> & <Name of Alternate Coding System (ID)> & <Coding System Version ID (ST)> & <Alternate Coding System Version ID (ST)> & <Original Text (ST)> & <Second Alternate Identifier (ST)> & <Second Alternate Formatted Text (FT)> & <Name of Second Alternate Coding System (ID)> & <Second Alternate Coding System Version ID (ST)> & <Coding System OID (ST)> & <Value Set OID (ST)> & <Value Set Version ID (DTM)> & <Alternate Coding System OID (ST)> & <Alternate Value Set OID (ST)> & <Alternate Value Set Version ID (DTM)> & <Second Alternate Coding System OID (ST)> & <Second Alternate Value Set OID (ST)> & <Second Alternate Value Set Version ID (DTM)>


Definition: This data type transmits codes and the formatted text associated with the code. This data type can be used to transmit for the first time the formatted text for the canned text portion of a report, for example, a standard radiological description for a normal chest X-ray. The receiving system can store this information and in subsequent messages only the identifier need be sent. Another potential use of this data type is transmitting master file records that contain formatted text. This data type has six components as follows:

The components, primary and alternate, are defined exactly as in the CE data type with the exception of the second and fifth components, which are of the formatted text data type.

Example:

OBX||CF|71020^CXR^99CPMC||79989^\H\Description:\N\\.sp\\ti+4\Heart is not enlarged. There is no evidence of pneumonia, effusion, pneumothorax or any masses. \.sp+3\\H\Impression:\N\\.sp\\.ti+4\Negative chest.^99CPMC

CF-1: Identifier (ST)

Definition: Sequence of characters (the code) that uniquely identifies the item being referenced by the <text>. Different coding schemes will have different elements here.

CF-2: Formatted Text (FT)

Definition: Name or description of the item in question with the addition of embedded formatting instructions.

CF-3: Name of Coding System (ID)

Definition: Contains the name of the coding system employed.

Refer to HL7 Table 0396 - Coding System in Chapter 2C, Code Tables, for valid values.

As of v2.7 this component is required when CF.1 is populated and CF.14 is not populated. Both CF.3 and CF.14 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the coding system as specified in CF.3 and/orCF.14, the Coding System component or the Coding System OID, for the tuple.

CF-4: Alternate Identifier (ST)

Definition: A sequence of characters that uniquely identifies an alternate code. Analogous to CF-1 Identifier.

Usage Notes: The Alternate Identifier is used to represent the local or user seen code as described. If present, it obeys the same rules of use and interpretation as described for component 1. If both are present, the identifiers in component 4 and component 1 should have exactly the same meaning, i.e., they should be exact synonyms.

CF-5: Alternate Formatted Text (FT)

Definition: Name or description of the alternate identifier in question with the addition of embedded formatting instructions. Analogous to CF.2 Formatted Text.

CF-6: Name of Alternate Coding System (ID)

Definition: Contains the name of the coding system employed for the alternate identifier. Analogous to CF.3 Name of Coding System.

Refer to HL7 Table 0396 - Coding System in Chapter 2C, Code Tables, for valid values.

As of v2.7 this component is required when CF.4 is populated andCF.17 is not populated. Both CF.6 and CF.17 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the coding ystem as specified inCF.6 and/or CF.17, the Coding System component or the Coding System OID, for the tuple.

CF-7: Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 1-3. If CF.3 is populated with a value other than HL7nnnn or is of table type user-defined, version ID must be valued with an actual version ID. If CF.3 is populated with a value of HL7nnnn and nnnn is of table type HL7, version ID may have an actual value or it may be absent. If version ID is absent, it will be interpreted to have the same value as the HL7 version number in the message header.

CF-8: Alternate Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 4-6. Analogous To CF.7 Coding System Version ID.

CF-9: Original Text (ST)

Definition: The text as seen and/or selected by the user who entered the data. Original text can be used in a structured user interface to capture what the user saw as a representation of the code on the data input screen, or in a situation where the user dictates or directly enters text, it is the text entered or uttered by the user. In a situation where the code is assigned sometime after the text was entered, original text is the text or phrase used as the basis for assigning the code.

CF-10: Second Alternate Identifier (ST)

Definition: A sequence of characters that uniquely identifies an alternate code. Analogous to CF.1 Identifier.

CF-11: Second Alternate Formatted Text (FT)

Definition: The descriptive or textual name of the Second Alternate Identifier. Analogous to CF.2 Formatted Text.

CF-12: Name of Second Alternate Coding System (ID)

Definition: Identifies the coding scheme being used in the Second Alternate Identifier component. Analogous to CF. Name of Coding System.

This component is required when CF.10 is populated and CF.20 is not populated. Both CF.10 and CF.20 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the coding ystem as specified in CF.12 and/or CF.20 the Coding System component or the Coding System OID for the tuple.

CF-13: Second Alternate Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 10-12. Analogous To CF.7 Coding System Version ID.

CF-14: Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CNE.3. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CF.1 is populated and CF.3 is not populated. Both CF.3 and CF.14 may be populated.

CF-15: Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CWE.1 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined value sets, the OID registered in the HL7 OID registry SHALL be used. A value set may or need not be present irrespective of other fields.

CF-16: Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CF.15. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CF.15 is populated.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


CF-17: Alternate Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CF.6. Analogous To CF.14 Coding System OID.

The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CF.4 is populated and CF.6 is not populated. Both CF.6 and CF.17 may be populated.

CF-18: Alternate Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CF.4 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined value sets, the OID registered in the HL7 OID registry SHALL be used.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


A value set may or need not be present irrespective of other fields.

CF-19: Alternate Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CF.18. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CF.18 is populated.

CF-20: Second Alternate Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CF.12. Analogous To CF.14 Coding System OID.

The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CF.10 is populated and CF.12 is not populated. Both CF.12 and CF.20 may be populated.

CF-21: Second Alternate Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CF.10 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined value sets, the OID registered in the HL7 OID registry SHALL be used.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


A value set may or need not be present irrespective of other fields.

CF-22: Second Alternate Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CF.21. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CF.21 is populated.

CNE - coded with no exceptions

As of v2.7 a third tuple, formerly known as triplet, has been added to the CNE data type. Additionally, 3 new components were added to each tuple such that each tuple now has a total of 7 components. The Original Text component applies to the CNE as a whole.

HL7 Component Table - CNE - coded with no exceptions
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CNE
1 Identifier [1..1]  20 ST
2 Text [0..1] 199 ST
3 Name of Coding System SHALL [0..1] [1..12]     ID
4 Alternate Identifier [0..1]  20 ST
5 Alternate Text [0..1] 199 ST
6 Name of Alternate Coding System SHALL [0..1] [1..12]     ID
7 Coding System Version ID [0..1]  10 ST
8 Alternate Coding System Version ID [0..1]  10 ST
9 Original Text [0..1] 199 ST
10 Second Alternate Identifier [0..1]  20 ST
11 Second Alternate Text [0..1] 199 ST
12 Name of Second Alternate Coding System SHALL [0..1] [1..12]     ID
13 Second Alternate Coding System Version ID [0..1]  10 ST
14 Coding System OID [0..1] 199 ST
15 Value Set OID [0..1] 199 ST
16 Value Set Version ID [0..1]   8 DTM
17 Alternate Coding System OID [0..1] 199 ST
18 Alternate Value Set OID [0..1] 199 ST
19 Alternate Value Set Version ID [0..1]   8 DTM
20 Second Alternate Coding System OID [0..1] 199 ST
21 Second Alternate Value Set OID [0..1] 199 ST
22 Second Alternate Value Set Version ID [0..1]   8 DTM

Components: <Identifier (ST)> & <Text (ST)> & <Name of Coding System (ID)> & <Alternate Identifier (ST)> & <Alternate Text (ST)> & <Name of Alternate Coding System (ID)> & <Coding System Version ID (ST)> & <Alternate Coding System Version ID (ST)> & <Original Text (ST)> & <Second Alternate Identifier (ST)> & <Second Alternate Text (ST)> & <Name of Second Alternate Coding System (ID)> & <Second Alternate Coding System Version ID (ST)> & <Coding System OID (ST)> & <Value Set OID (ST)> & <Value Set Version ID (DTM)> & <Alternate Coding System OID (ST)> & <Alternate Value Set OID (ST)> & <Alternate Value Set Version ID (DTM)> & <Second Alternate Coding System OID (ST)> & <Second Alternate Value Set OID (ST)> & <Second Alternate Value Set Version ID (DTM)>


Example 1: The drug must be coded and must be taken from the specified coding system. The coding system is an external coding system. Example is derived from FT1-26.

|0006-0106-58^Prinivil 10mg oral tablet^NDC|

Example 2: Consent mode must be coded and must be taken from the specified coding system. The coding system is an HL7 code table. Example is taken from CON-10.

|V^Verbal^HL70497^^^^2.8|

CNE-1: Identifier (ST)

Definition: The first component contains the sequence of characters (the code) that uniquely identifies the item being referenced by the CNE.2. Different coding schemes will have different elements here.

Usage Note: The identifier is required and must be a valid code.

CNE-2: Text (ST)

Definition: The second component contains the descriptive or textual name of the identifier, e.g., myocardial infarction or X-ray impression. This is the corresponding text assigned by the coding system to the identifier.

Usage Note: Text description of code is optional but its use should be encouraged since it makes messages easier to review for accuracy, especially during interface testing and debugging.

CNE-3: Name of Coding System (ID)

Definition: The third component contains the code for the name of the coding system from which the value in CNE.1 is obtained.Refer to HL7 Table 0396 - Coding Systems in Chapter 2C, Code Tables, for valid values. Each coding system is assigned a unique identifier.

As of v2.7 this component is required when CNE.1 is populated and CNE.14 is not populated. Both CNE.3 and CNE.14 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the codingSystem as specified in CNE.3 and/or CNE.14 the Coding System component or the Coding System OID for the tuple.The combination of the identifier and name of coding system represent a unique concept for a data item.

Some organizations that publish code sets author more than one. The coding system, then, to be unique, is a concatenation of the name of the coding authority organization and the name of its code set or table. When an HL7 table is used for a CNE data type, the name of coding system component is defined as HL7nnnn where nnnn is the HL7 table number. Similarly, ISO tables will be named ISOnnnn, where nnnn is the ISO table number.

Usage Note: The following statement is retained for backward compatibility as of v2.7. Best practice would recommend that this component always be populated. However, if the field narrative explicitly states "Refer to HL7 Table nnnn for valid values”, and, if the sending and receiving systems are HL7 compliant, the coding system would be known from the standard. This would be similar to a field with an ID data type, except that there is a second triplet in which to express an alternate code.

CNE-4: Alternate Identifier (ST)

Definition: A sequence of characters that uniquely identifies an alternate code. Analogous to CNE.1 Identifier.

Usage Notes: The Alternate Identifier is used to represent the local or user seen code as described. If present, it obeys the same rules of use and interpretation as described for component 1. If both are present, the identifiers in component 4 and component 1 should have exactly the same meaning, i.e., they should be exact synonyms.

CNE-5: Alternate Text (ST)

Definition: The descriptive or textual name of the alternate identifier. Analogous to CNE.2 Text.

Usage Notes: If present, CNE.5 obeys the same rules of use and interpretation as described for CNE.2.

CNE-6: Name of Alternate Coding System (ID)

Definition: Identifies the coding scheme being used in the alternate identifier component. Analogous to CNE.3 Name of Coding System. Refer to HL7 Table 0396 - Coding Systems in Chapter 2C, Code Tables, for valid values.

As of v2.7 this component is required when CNE.4 is populated and CNE.17 is not populated. Both CNE.6 and CNE.17 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the codingSystem as specified in CNE.6 and/or CNE.17, the "Coding System" component or the "Coding System OID", for the tuple.

Usage Notes: If present, CNE.6 obeys the same rules of use and interpretation as described for CNE.3.

CNE-7: Coding System Version ID (ST)

Definition: the version ID for the coding system identified by CNE.3. It belongs conceptually to components 1-3 and appears here only for reasons of backward compatibility.

Usage Note: If the coding system is any system other than an "HL7 coding system," version ID must be valued with an actual version ID. If the coding system is "HL7 coding system," version ID may have an actual value or it may be absent. If version ID is absent, it will be interpreted to have the same value as the HL7 version number in the message header. Text description of code is optional but its use should be encouraged since it makes messages easier to review for accuracy, especially during interface testing and debugging.

CNE-8: Alternate Coding System Version ID (ST)

Definition: the version ID for the coding system identified by CNE.6. It belongs conceptually to the group of Alternate components (see note 2.A.1) and appears here only for reasons of backward compatibility. Analogous to CNE.7 Coding System Version ID.

Usage Notes: If present, CNE.8 obeys the same rules of use and interpretation as described for CNE.7.

CNE-9: Original Text (ST)

Definition: The text as seen and/or selected by the user who entered the data. Original text can be used in a structured user interface to capture what the user saw as a representation of the code on the data input screen, or in a situation where the user dictates or directly enters text, it is the text entered or uttered by the user. In a situation where the code is assigned sometime after the text was entered, original text is the text or phrase used as the basis for assigning the code.

CNE-10: Second Alternate Identifier (ST)

Definition: A sequence of characters that uniquely identifies a second alternate code. Analogous to CN-1 Identifier.

CNE-11: Second Alternate Text (ST)

Definition: The descriptive or textual name of the Second Alternate Identifier. Analogous to CNE.2 Text.

CNE-12: Name of Second Alternate Coding System (ID)

Definition: Identifies the coding scheme being used in the Second Alternate Identifier component. Analogous to CNE.3 Name of Coding System. Refer to HL7 Table 0396 - Coding Systems in Chapter 2C, Code Tables, for valid values.

As of v2.7 this component is required when CNE.10 is populated and CNE.20 is not populated. Both CNE.12 and CNE.20 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the codingSystem as specified in CNE.12 and/or CNE.20, the "Coding System" component or the "Coding System OID", for the tuple.

CNE-13: Second Alternate Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 10-12. Analogous to CNE.7 Coding System Version ID.

CNE-14: Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CNE.3. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CNE.1 is populated and CNE.3 is not populated. Both CNE.3 and CNE.14 may be populated.

CNE-15: Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CNE.1 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined value sets, the OID registered in the HL7 OID registry SHALL be used.

A value set may or need not be present irrespective of other fields.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


CNE-16: Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CNE.15. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CNE.15 is populated.

CNE-17: Alternate Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CNE.6. Analogous to CNE.14 OID for Coding System.

The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CNE.4 is populated and CNE.6 is not populated. Both CNE.6 and CNE.17 may be populated.

CNE-18: Alternate Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CNE.4 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined value sets, the OID registered in the HL7 OID registry SHALL be used.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


A value set may or need not be present irrespective of other fields.

CNE-19: Alternate Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CNE.18. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CNE.18 is populated.

CNE-20: Second Alternate Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) from which the value in CNE.12 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined numbers, the OID registered in the HL7 OID registry should be used.

This component is required when CNE.4 is populated and neither CNE.6 nor CNE.18 is populated. In short either the CNE.6 or the CNE.14 or CNE.17 must be populated when CNE.4 is populated.

CNE-21: Second Alternate Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CNE.10 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined value sets, the OID registered in the HL7 OID registry SHALL be used. A value set may or need not be present irrespective of other fields.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


CNE-22: Second Alternate Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CNE.21. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CNE.21 is populated.

CNN - composite ID number and name simplified

Attention: Retained for backward compatibility only in version 2.6. Fields associated with this data type have been replaced by the ROL segment.

HL7 Component Table - CNN - composite ID number and name simplified
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CNN
1 ID Number [0..1]  15 ST
2 Family Name [0..1]  50 ST
3 Given Name [0..1]  30 ST
4 Second and Further Given Names or Initials Thereof [0..1]  30 ST
5 Suffix [0..1]  20 ST
6 Prefix [0..1]  20 ST
7 Degree [0..1]   6 IS
8 Source Table [0..1]   4 IS
9 Assigning Authority - Namespace ID [0..1]  20 IS
10 Assigning Authority - Universal ID [0..1] 199 ST
11 Assigning Authority - Universal ID Type SHALL [0..1] [1..6]     ID

Components: <ID Number (ST)> & <Family Name (ST)> & <Given Name (ST)> & <Second and Further Given Names or Initials Thereof (ST)> & <Suffix (ST)> & <Prefix (ST)> & <Degree (IS)> & <Source Table (IS)> & <Assigning Authority - Namespace ID (IS)> & <Assigning Authority - Universal ID (ST)> & <Assigning Authority - Universal ID Type (ID)>


CNN-1: ID Number (ST)

Coded ID according to a user-defined table. If the first component is present, either CNN.8 or CNN.9, or both CNN.10 and CNN.11, must be valued.

CNN-2: Family Name (ST)

This component contains the person's family name in a string format.

CNN-3: Given Name (ST)

Used to specify a first name.

CNN-4: Second and Further Given Names or Initials Thereof (ST)

CNN-5: Suffix (ST)

Used to specify a name suffix (e.g., Jr. or III).

CNN-6: Prefix (ST)

Used to specify a name prefix (e.g., Dr.).

CNN-7: Degree (IS)

Used to specify an educational degree (e.g., MD). Refer to User-defined Table 0360 – Degree/license/certificate in Chapter 2C, Code Tables, for suggested values.

CNN-8: Source Table (IS)

Refer to User-defined Table 0297 - CN ID source in Chapter 2C, Code Tables, for suggested values. Used to delineate the first component. If component 1 is valued, either CNN.8 or CNN.9, or both CNN.10 and CNN.11, must be valued.

CNN-9: Assigning Authority - Namespace ID (IS)

See section, 2.A.14.4, "Assigning Authority (HD)" for definition. Refer to User-defined Table 0363 – Assigning Authority in Chapter 2C, Code Tables, for suggested values. Assigning Authority is normally expressed as an HD data type, but has been flattened to 3 components here (CNN.9, CNN.10 and CNN.11) in this data type so that it may be fully expressed. Also note that if additional components are added to the HD data type in the future, adjustment will need to be made accordingly to this data type.

If component 1 is valued, either CNN.8 or CNN.9, or both CNN.10 and CNN.11, must be valued.

CNN-10: Assigning Authority - Universal ID (ST)

See section, 2.A.14.4, "Assigning Authority (HD)" for definition.

If CNN.11 is valued, this component must be valued. If component 1 is valued, either CNN.8 or CNN.9, or both CNN.10 and CNN.11, must be valued.

CNN-11: Assigning Authority - Universal ID Type (ID)

See section, 2.A.14.4, "Assigning Authority (HD)" for definition. If this component is a known UID refer to HL7 Table 0301 - Universal ID type in Chapter 2C, Code Tables, for valid values.

If CNN.10 is valued, this component must be valued. If component 1 is valued, either CNN.8 or CNN.9, or both CNN.10 and CNN.11, must be valued.

CP - composite price

HL7 Component Table - CP - composite price
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CP
1 Price [1..1]     MO
2 Price Type SHALL [0..1] [1..2]     ID
3 From Value [0..1]     NM
4 To Value [0..1]     NM
5 Range Units [0..1]     CWE
6 Range Type SHALL [0..1] [1..1]     ID

Components: <Price (MO)> & <Price Type (ID)> & <From Value (NM)> & <To Value (NM)> & <Range Units (CWE)> & <Range Type (ID)>

Subcomponents for Price (MO): <Quantity (NM)> ^ <Denomination (ID)>

Subcomponents for Range Units (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


Example:

|100.00&USD^UP^0^9^min^P~50.00&USD^UP^10^59^min^P~10.00&USD^UP^60^999^P~50.00&USD^AP~200.00&USD^PF

~80.00&USD^DC|

CP-1: Price (MO)

Definition: The only required component; usually containing a decimal point.

Note: Each component of the MO data type (Section 2.A.41, "MO - money") is a subcomponent here.


CP-2: Price Type (ID)

Definition: A coded value, data type ID. Refer to HL7 Table 0205 – Price Type in Chapter 2C, Code Tables, for valid values.

CP-3: From Value (NM)

Definition: The number specifying the lower limit or boundary of the range. This component, together with the CP.4 component, specifies the "price range". The range can be defined as either time or quantity. For example, the range can indicate that the first 10 minutes of the procedure has one price. Another repetition of the data type can use the range to specify that the following 10 to 60 minutes of the procedure is charged at another price per; a final repetition can specify that the final 60 to N minutes of the procedure at a third price.

Note: If the CP.2 Price Type component is TP, both CP.3 and CP.4 may be null.


CP-4: To Value (NM)

Definition: The number specifying the high limit or boundary of the range.

CP-5: Range Units (CWE)

Definition: This component describes the units associated with the range, e.g., seconds, minutes, hours, days, quantity (i.e., count). As of v2.7 the Externally-defined Unified Code for Units of Measure (UCUM) case sensitive code is the required code for units of measure. Refer to the externally-defined table "Unified Code for Units of Measure" (UCUM) [http://aurora.rg.iupui.edu/UCUM] for valid values. Local codes may be transmitted in addition to UCUM codes.

This component is required if CP.3 From Value and/or CP.4 To Value are present.

CP-6: Range Type (ID)

Definition: Refer to HL7 Table 0298 - CP Range Type for valid values.

CQ - composite quantity with units

HL7 Component Table - CQ - composite quantity with units
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CQ
1 Quantity [0..1]     NM
2 Units [0..1]     CWE

Components: <Quantity (NM)> & <Units (CWE)>

Subcomponents for Units (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


Examples:

|123.7^kg|        kilograms is an ISO unit

|150^lb&&ANSI+|    weight in pounds is a customary US unit defined within ANSI+.

CQ-1: Quantity (NM)

Definition: This component specifies the numeric quantity or amount of an entity.

CQ-2: Units (CWE)

Definition: This component species the units in which the quantity is expressed. As of v2.7 the externally-defined Unified Code for Units of Measure (UCUM) case sensitive code is the required code for units of measure. Refer to the external table "Unified Code for Units of Measure" (UCUM) [http://aurora.rg.iupui.edu/UCUM] for valid values. Local codes may be transmitted in addition to UCUM codes.

Refer to user-defined Table 0794 - Units in Chaper 2C, Code Tables, for valid values.

CSU - channel sensitivity and units

Attention: Retained for backward compatibility only in version 2.7. This is used only in the CD Channel Definition data type, which has been retained for backward compatibility only in version 2.7.

As of v2.7 a third tuple, formerly known as triplet, has been added to the CSU data type. Additionally, 3 new components were added to each tuple such that each tuple now has a total of 7 components. The Original Text component applies to the CSU as a whole.

HL7 Component Table - CSU - channel sensitivity and units
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CSU
1 Channel Sensitivity [1..1]     NM
2 Unit of Measure Identifier [0..1]  20 ST
3 Unit of Measure Description [0..1] 199 ST
4 Unit of Measure Coding System SHALL [0..1] [1..12]     ID
5 Alternate Unit of Measure Identifier [0..1]  20 ST
6 Alternate Unit of Measure Description [0..1] 199 ST
7 Alternate Unit of Measure Coding System SHALL [0..1] [1..12]     ID
8 Unit of Measure Coding System Version ID [0..1]  10 ST
9 Alternate Unit of Measure Coding System Version ID [0..1]  10 ST
10 Original Text SHALL [0..1] [199..] 199 ST
11 Second Alternate Unit of Measure Identifier [0..1]  20 ST
12 Second Alternate Unit of Measure Text [0..1] 199 ST
13 Name of Second Alternate Unit of Measure Coding System SHALL [0..1] [1..12]     ID
14 Second Alternate Unit of Measure Coding System Version ID [0..1]  10 ST
15 Unit of Measure Coding System OID [0..1] 199 ST
16 Unit of Measure Value Set OID [0..1] 199 ST
17 Unit of Measure Value Set Version ID [0..1]   8 DTM
18 Alternate Unit of Measure Coding System OID [0..1] 199 ST
19 Alternate Unit of Measure Value Set OID [0..1] 199 ST
20 Alternate Unit of Measure Value Set Version ID [0..1]   8 DTM
21 Alternate Unit of Measure Coding System OID [0..1] 199 ST
22 Alternate Unit of Measure Value Set OID [0..1] 199 ST
23 Alternate Unit of Measure Value Set Version ID [0..1]   8 ST

Components: <Channel Sensitivity (NM)> & <Unit of Measure Identifier (ST)> & <Unit of Measure Description (ST)> & <Unit of Measure Coding System (ID)> & <Alternate Unit of Measure Identifier (ST)> & <Alternate Unit of Measure Description (ST)> & <Alternate Unit of Measure Coding System (ID)> & <Unit of Measure Coding System Version ID (ST)> & <Alternate Unit of Measure Coding System Version ID (ST)> & <Original Text (ST)> & <Second Alternate Unit of Measure Identifier (ST)> & <Second Alternate Unit of Measure Text (ST)> & <Name of Second Alternate Unit of Measure Coding System (ID)> & <Second Alternate Unit of Measure Coding System Version ID (ST)> & <Unit of Measure Coding System OID (ST)> & <Unit of Measure Value Set OID (ST)> & <Unit of Measure Value Set Version ID (DTM)> & <Alternate Unit of Measure Coding System OID (ST)> & <Alternate Unit of Measure Value Set OID (ST)> & <Alternate Unit of Measure Value Set Version ID (DTM)> & <Alternate Unit of Measure Coding System OID (ST)> & <Alternate Unit of Measure Value Set OID (ST)> & <Alternate Unit of Measure Value Set Version ID (ST)>


CSU-1: Channel Sensitivity (NM)

Definition: This component transmits the nominal value that corresponds to one unit in the waveform data, that is, the effective resolution of the least significant bit of the ADC, and the polarity of the channel.

CSU-2: Unit of Measure Identifier (ST)

Definition: The unit designation for the channel sensitivity. This field is required if the unit of measure description is not present.

CSU-3: Unit of Measure Description (ST)

Definition: The full text name of the unit of measure identifier. This field is required if the unit of measure identifier is not present.

CSU-4: Unit of Measure Coding System (ID)

Definition: Specifies the designated system of units. Refer to HL7 Table 0396 – Coding System in Chapter 2C, Code Tables, for valid values. This component is required if the CSU.2 Unit of Measure Identifier is present.

Both CSU.4 and CSU.15 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the codingSystem as specified in CSU.4 and/or CSU.15, the "Coding System" component or the "Coding System OID" for the tuple.

CSU-5: Alternate Unit of Measure Identifier (ST)

Definition: A sequence of characters that uniquely identifies an alternate units designation for the channel sensitivity. Analogous to CSU.2 Unit of Measure Identifier.

Usage Notes: The Alternate Identifier is used to represent the local or user seen code as described. If present, it obeys the same rules of use and interpretation as described for component 1. If both are present, the identifiers in component 4 and component 1 should have exactly the same meaning, i.e., they should be exact synonyms.

CSU-6: Alternate Unit of Measure Description (ST)

Definition: The full text name of the alternate unit of measure identifier. Analogous to CSU.3 Unit of Measure Description.

CSU-7: Alternate Unit of Measure Coding System (ID)

Definition: Specifies the coding system for the alternate unit of measure. Refer to HL7 Table 0396 – Coding System in Chapter 2C, section "Coding System Table" for valid values. Analogous to CSU.4 Unit of Measure Coding System.

This field is required if the CSU.5 Alternate Unit of Measure Identifier is present. Both CSU.7 and CSU.18 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the codingSystem as specified in CSU.7 and/or CSU.18, the "Coding System" component or the "Coding System OID" for the tuple.

CSU-8: Unit of Measure Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 2-4. If CSU.4 is populated with a value other than HL7nnnn or is of table type user-defined, version ID must be valued with an actual version ID. If CSU.4 is populated with a value of HL7nnnn and nnnn is of table type HL7, version ID may have an actual value or it may be absent. If version ID is absent, it will be interpreted to have the same value as the HL7 version number in the message header.

CSU-9: Alternate Unit of Measure Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 5-7. Analogous to CSU.8 Unit of Measure Coding System Version ID.

CSU-10: Original Text (ST)

Definition: The text as seen and/or selected by the user who entered the data. Original text can be used in a structured user interface to capture what the user saw as a representation of the code on the data input screen, or in a situation where the user dictates or directly enters text, it is the text entered or uttered by the user. In a situation where the code is assigned sometime after the text was entered, original text is the text or phrase used as the basis for assigning the code.

CSU-11: Second Alternate Unit of Measure Identifier (ST)

Definition: A sequence of characters that uniquely identifies a second alternate units designation for the channel sensitivity. Analogous to CSU.2 Unit of Measure Identifier.

CSU-12: Second Alternate Unit of Measure Text (ST)

Definition: The descriptive or textual name of the second alternate identifier. Analogous to CSU.3 Unit of Measure Description.

CSU-13: Name of Second Alternate Unit of Measure Coding System (ID)

Definition: Specifies the coding system for the second alternate unit of measure. Analogous to CSU.4 Unit of Measure Coding System. Refer to HL7 Table 0396 – Coding System in Chapter 2C, Code Tables, for valid values.

This component is required when CSU.11 is populated. Both CSU.13 and CSU.21 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the codingSystem as specified in CSU.13 and/or CSU.21 the Coding System component or the Coding System OID for the tuple.

CSU-14: Second Alternate Unit of Measure Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 11-13. Analogous to CSU.8 Unit of Measure Coding System Version ID.

CSU-15: Unit of Measure Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CSU.4. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CSU.2 is populated and CSU.4 is not populated. Both CSU.4 and CSU.15 may be populated.

CSU-16: Unit of Measure Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CSU.2 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined value sets, the OID registered in the HL7 OID registry SHALL be used.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


A value set may or need not be present irrespective of other fields.

CSU-17: Unit of Measure Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CSU.16. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CSU.16 is populated.

CSU-18: Alternate Unit of Measure Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CSU.7. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CSU.5 is populated and CSU.7 is not populated. Both CSU.7 and CSU.18 may be populated.

CSU-19: Alternate Unit of Measure Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CSU.5 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined value sets, the OID registered in the HL7 OID registry SHALL be used.

A value set may or need not be present irrespective of other fields. .

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


CSU-20: Alternate Unit of Measure Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CSU.19. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CSU.19 is populated.

CSU-21: Alternate Unit of Measure Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CSU.13. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CSU.11 is populated and CSU.13 is not populated. Both CSU.13 and CSU.21 may be populated.

CSU-22: Alternate Unit of Measure Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CSU.11 is obtained. The value for this component is 2.16.840.1.113883.12.#### where "####" is to be replaced by the HL7 table number in the case of an HL7 defined or user defined table. For externally defined value sets, the OID registered in the HL7 OID registry SHALL be used.

A value set may or need not be present irrespective of other fields.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


CSU-23: Alternate Unit of Measure Value Set Version ID (ST)

Definition: This component carries the version for the value set identified by CSU.22. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CSU.22 is populated.

CWE - coded with exceptions

As of v2.7 a third tuple, formerly known as triplet, has been added to the CWE data type. Additionally, 3 new components were added to each tuple such that each tuple now has a total of 7 components. The Original Text component applies to the CWE as a whole.

HL7 Component Table - CWE - coded with exceptions
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CWE
1 Identifier [0..1]  20 ST
2 Text [0..1] 199 ST
3 Name of Coding System SHALL [0..1] [1..12]     ID
4 Alternate Identifier [0..1]  20 ST
5 Alternate Text [0..1] 199 ST
6 Name of Alternate Coding System SHALL [0..1] [1..12]     ID
7 Coding System Version ID [0..1]  10 ST
8 Alternate Coding System Version ID [0..1]  10 ST
9 Original Text [0..1] 199 ST
10 Second Alternate Identifier [0..1]  20 ST
11 Second Alternate Text [0..1] 199 ST
12 Name of Second Alternate Coding System SHALL [0..1] [1..12]     ID
13 Second Alternate Coding System Version ID [0..1]  10 ST
14 Coding System OID [0..1] 199 ST
15 Value Set OID [0..1] 199 ST
16 Value Set Version ID [0..1]   8 DTM
17 Alternate Coding System OID [0..1] 199 ST
18 Alternate Value Set OID [0..1] 199 ST
19 Alternate Value Set Version ID [0..1]   8 DTM
20 Second Alternate Coding System OID [0..1] 199 ST
21 Second Alternate Value Set OID [0..1] 199 ST
22 Second Alternate Value Set Version ID [0..1]   8 DTM

Components: <Identifier (ST)> & <Text (ST)> & <Name of Coding System (ID)> & <Alternate Identifier (ST)> & <Alternate Text (ST)> & <Name of Alternate Coding System (ID)> & <Coding System Version ID (ST)> & <Alternate Coding System Version ID (ST)> & <Original Text (ST)> & <Second Alternate Identifier (ST)> & <Second Alternate Text (ST)> & <Name of Second Alternate Coding System (ID)> & <Second Alternate Coding System Version ID (ST)> & <Coding System OID (ST)> & <Value Set OID (ST)> & <Value Set Version ID (DTM)> & <Alternate Coding System OID (ST)> & <Alternate Value Set OID (ST)> & <Alternate Value Set Version ID (DTM)> & <Second Alternate Coding System OID (ST)> & <Second Alternate Value Set OID (ST)> & <Second Alternate Value Set Version ID (DTM)>


Definition: Specifies a coded element and its associated detail. The CWE data type is used when 1) more than one table may be applicable or 2) the specified HL7 or externally defined table may be extended with local values or 3) when text is in place, the code may be omitted.

The presence of two sets of equivalent codes in this data type is semantically different from a repetition of a CWE-type field. With repetition, several distinct codes (with distinct meanings) may be transmitted.

Usage Notes: The CWE data type should be used for coded fields with one or more of the following characteristics:

  • The identifier code (CWE.1) component is optional

  • The set of allowable values from which the identifier code is drawn may be extended on a site-specific basis

  • An exception identifier code may be encountered; that is, a code that is not defined in the value set (either model or site-extended).

This is in contrast to the CNE data type, which requires a code from a non-extendable value set be sent in the identifier code component (CNE.1) in all cases (except, of course, if the entire field is empty and defined as optional at the segment level).

The rules for populating CWE components are governed by the status of the identifier code:

Identifier Code Status

Identifier Code (CWE.1)

Descriptive Text (CWE.2)

Coding System (CWE.3)

Contained in model value set

Populated

May be populated

Must be populated with model coding system, or (not recommended) site-specific coding system that is a superset containing model values.

Contained in site-specific extensions to model value set

Populated

May be populated

Site-specific coding system.

Contained in neither model nor extended value sets

Not populated

May be populated with the identifier code, free-text description, or a concatenation of the two. Should be human interpretable.

Must not be populated.

Not supplied; but descriptive text is supplied.

Not populated

May be populated with descriptive text.

Must not be populated.


As an example, consider “currency” codes where:

  • The model values are defined by the ISO 4217 value set,

  • The value set is extended on site to include the code HL7 – “HL7 Drink Ticket”, and

  • The data entry screen on the sending system does not enforce any edits for the currency code.

And so the value set used on site is:

Identifier Code Status

Identifier Code

Descriptive Text

Model values from ISO 4217 external table

AED

United Arab Emirates, Dirhams

AFA

Afghanistan, Afghanis

ALL

Albania, Leke

ZAR

South Africa, Rand

ZMK

Zambia, Kwacha

ZWD

Zimbabwe, Zimbabwe Dollars

Site-specific extension

HL7

HL7 Events, Drink Ticket


Collectively, this value set must be referred to with a local coding system ID, because “HL7” does not exist in ISO 4217. According to the rules, the site assigns the coding system ID “99CUR” to the value set.

Based on the code and descriptive text entered by the user on the sending system, the CWE would be populated as follows:

Entered by user

Sent in CWE

Code

Descriptive Text

Identifier Code (CWE.1)

Descriptive Text (CWE.2)

Coding System (CWE.3)

GBP

Great Britain, Pound

GBP

Great Britain, Pound

ISO4217

GBP

Great Britain, Pound

99CUR (This option is NOT recommended)

HL7

HL7 Drink Ticket

HL7

HL7 Drink Ticket

99CUR

XXX

<Bogus entry>

Must not be populated

XXX

Must not be populated.

Must not be populated

Bogus entry

Must not be populated.

Must not be populated

XXX: Bogus entry

Must not be populated.

Must not be populated

anything – or nothing.

Must not be populated.

Dollar

Must not be populated

Dollar

Must not be populated.

Valued from HL7 Table 0353 (e.g., “U” for unkown)

Dollar

HL70353


Notes:

  1. Where multiple valid options for sending the entered data exist, each alternative is depicted as a separate row.

  2. CWE.2 - Descriptive Text is never required, and there are no hard and fast rules on what text may be sent in this component. Of course, common sense suggests that if valued, the text should complement the identifier code of CWE.1.

It follows that where CWE.1 cannot be valued because the entered code does not exist in the value set, the entered code may be sent in CWE.2; with or without additional descriptive text. However, this is not required by HL7.

  1. The example with GBP shows two options for the code set: ISO4217 or 99CUR. While it is now technically possible to send 99CUR on the basis that this code may exist on its own in the extended local code set, HL7 urges that where a code is a member of the standard code set, that code set should be named in CWE.3. HL7 intends to mandate this in a future release.

  2. While there are no formal rules regarding the valuation of CWE.2 - Descriptive Text, it is expected that any value contained therein be meaningful to a human reader.

CWE-1: Identifier (ST)

Definition: The first component contains the sequence of characters (the code) that uniquely identifies the item being referenced by the CWE.2. Different coding schemes will have different elements here.

In the context of “Data Missing”, described above in the Usage Note, refer to HL7 Table 0353 – CWE Statuses for valid values.

HL7 Table 0353 - CWE statuses

Code

Description

Comment

U

Unknown

UASK

Asked but Unknown

NAV

Not available

NA

Not applicable

NASK

Not asked


Refer to section 2.5.5.5 in Chapter 2, Control, for some discussion on the length of this component.

CWE-2: Text (ST)

Definition: The second component contains the descriptive or textual name of the identifier, e.g., "myocardial infarction" or "X-ray impression".

CWE-3: Name of Coding System (ID)

Definition: The third component contains the code for the name of the coding system from which the value in CWE.1 is obtained. Each coding system is assigned a unique identifier. As of v2.7 this component is required when CWE.1 is populated and CWE.14 is not populated. Both CWE.3 and CWE.14 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the codingSystem as specified in CWE.3 and/or CWE.14, the "Coding System" component or the "Coding System OID" for the tuple.

Refer to HL7 Table 0396 – Coding System in Chapter 2C, section "Coding System Table" for valid values.

Refer to section 2.A.8.3, "Name of Coding System (ID)" for a discussion of coding system conventions.

CWE-4: Alternate Identifier (ST)

Definition: A sequence of characters that uniquely identifies an alternate code. Analogous to CWE.1- Identifier.

Usage Notes: The Alternate Identifier is used to represent the local or user seen code as described. If present, it obeys the same rules of use and interpretation as described for component 1. If both are present, the identifiers in component 4 and component 1 should have exactly the same meaning, i.e., they should be exact synonyms.

CWE-5: Alternate Text (ST)

Definition: The descriptive or textual name of the alternate identifier. Analogous to CWE.2 - Text. See usage note in section introduction.

CWE-6: Name of Alternate Coding System (ID)

Definition: Identifies the coding scheme being used in the alternate identifier component. Analogous to CWE.3 - Name of Coding System. See usage note in section introduction.

As of v2.7 this component is required when CWE.4 is populated and CWE.17 is not populated. Both CWE.6 and CWE.17 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the coding System as specified in CWE.6 and/or CWE.17, the "Coding System" component or the "Coding System OID", for the tuple.

CWE-7: Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 1-3. If CWE.3 is populated with a value other than HL7nnnn or is of table type user-defined, version ID must be valued with an actual version ID. If CWE.3 is populated with a value of HL7nnnn and nnnn is of table type HL7, version ID may have an actual value or it may be absent. If version ID is absent, it will be interpreted to have the same value as the HL7 version number in the message header.

CWE-8: Alternate Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 4-6. Analogous To CWE.7 - Coding System Version ID.

CWE-9: Original Text (ST)

Definition: The text as seen and/or selected by the user who entered the data. Original text can be used in a structured user interface to capture what the user saw as a representation of the code on the data input screen, or in a situation where the user dictates or directly enters text, it is the text entered or uttered by the user. In a situation where the code is assigned sometime after the text was entered, original text is the text or phrase used as the basis for assigning the code.

CWE-10: Second Alternate Identifier (ST)

Definition: A sequence of characters that uniquely identifies a second alternate code. Analogous to CWE.1- Identifier.

CWE-11: Second Alternate Text (ST)

Definition: The descriptive or textual name of the alternate identifier. Analogous to CWE.2 - Text. See usage note in section introduction.

CWE-12: Name of Second Alternate Coding System (ID)

Definition: Identifies the coding scheme being used in the alternate identifier component. Analogous to CWE.3 Name of Coding System. See usage note in section introduction.

As of v2.7 this component is required when CWE.10 is populated and CWE.20 is not populated. Both CWE.6 and CWE.17 may be populated. Receivers should not identify a code based on its position within the tuples (Identifier, Alternate Identifier, or Second Alternate Identifier) or position within a repeating field. Instead, the receiver should always examine the coding System as specified in CWE.12 and/or CWE.20, the "Coding System" component or the "Coding System OID", for the tuple.

CWE-13: Second Alternate Coding System Version ID (ST)

Definition: This component carries the version for the coding system identified by components 10-12. Analogous to CWE.7 - Coding System Version ID.

CWE-14: Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CWE.3. The value for this component for an HL7 or User Defined table SHALL be the value published for the code system OID for the table in Chapter 2C Code Tables. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CWE.1 is populated and CWE.3 is not populated. Both CWE.3 and CWE.14 may be populated.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


CWE-15: Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CWE.1 is obtained. The value for this component is identified for each of the HL7 Tables that have values published in Chapter 2C Code Tables. For externally defined value sets, the OID registered in the HL7 OID registry and/or published in an HL7 balloted Implementation Guide SHALL be used.

A value set may or need not be present irrespective of other fields.

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


CWE-16: Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CWE.15. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CWE.15 is populated.

CWE-17: Alternate Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CWE.6. Analogous to CWE.14 Coding System OID.

The value for this component for an HL7 or User Defined table SHALL be the value published for the code system OID for the table in Chapter 2C Code Tables. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CWE.4 is populated and CWE.6 is not populated. Both CWE.6 and CWE.17 may be populated.

CWE-18: Alternate Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CWE.4 is obtained. The value for this component is identified for each of the HL7 Tables that have values published in Chapter 2C Code Tables. For externally defined value sets, the OID registered in the HL7 OID registry and/or published in an HL7 balloted Implementation Guide SHALL be used. A value set may or need not be present irrespective of other fields.

CWE-19: Alternate Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CWE.18. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CWE.18 is populated.

CWE-20: Second Alternate Coding System OID (ST)

Definition: This component contains the ISO Object Identifier (OID) for the coding system or value set named in CWE.12. Analogous to CWE.14 - Coding System OID.

The value for this component for an HL7 or User Defined table SHALL be the value published for the code system OID for the table in Chapter 2C Code Tables. For externally defined code systems the OID registered in the HL7 OID registry SHALL be used.

This component is required when CWE.10 is populated and CWE.12 is not populated. Both CWE.12 and CWE.20 may be populated.

CWE-21: Second Alternate Value Set OID (ST)

Definition: This component contains the ISO Object Identifier (OID) to allow identification of the value set from which the value in CWE.10 is obtained. The value for this component is identified for each of the HL7 Tables that have values published in Chapter 2C Code Tables. For externally defined value sets, the OID registered in the HL7 OID registry and/or published in an HL7 balloted Implementation Guide SHALL be used.

A value set may or need not be present irrespective of other fields

Note: If a code is provided, the meaning of the code must come from the definition of the code in the code system. The meaning of the code SHALL NOT depend on the value set. Applications SHALL NOT be required to interpret the code in light of the valueSet, and they SHALL NOT reject an instance because of the presence or absence of any or a particular value set/ value set version ID.


CWE-22: Second Alternate Value Set Version ID (DTM)

Definition: This component carries the version for the value set identified by CWE.21. The version is a date. The date is the date/time that the value set being used was published.

Value set version ID is required if CWE.21 is populated.

CX - extended composite ID with check digit

HL7 Component Table - CX - extended composite ID with check digit
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
CX
1 ID Number [1..1]  15 ST
2 Identifier Check Digit [0..1]   4 ST
3 Check Digit Scheme SHALL [0..1] [3..3]     ID
4 Assigning Authority [0..1]     HD
5 Identifier Type Code SHALL [1..1] [2..5]     ID
6 Assigning Facility [0..1]     HD
7 Effective Date [0..1]     DT
8 Expiration Date [0..1]     DT
9 Assigning Jurisdiction [0..1]     CWE
10 Assigning Agency or Department [0..1]     CWE
11 Security Check [0..1]   4 ST
12 Security Check Scheme SHALL [0..1] [3..3]     ID

Components: <ID Number (ST)> & <Identifier Check Digit (ST)> & <Check Digit Scheme (ID)> & <Assigning Authority (HD)> & <Identifier Type Code (ID)> & <Assigning Facility (HD)> & <Effective Date (DT)> & <Expiration Date (DT)> & <Assigning Jurisdiction (CWE)> & <Assigning Agency or Department (CWE)> & <Security Check (ST)> & <Security Check Scheme (ID)>

Subcomponents for Assigning Authority (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Assigning Facility (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Assigning Jurisdiction (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Assigning Agency or Department (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


Example:

|1234567^4^M11^ADT01^MR^University Hospital|

CX-1: ID Number (ST)

Definition: The value of the identifier itself.

CX-2: Identifier Check Digit (ST)

Definition: A digit, or digits, exclusive of the identifier in CX.1, calculated by applying an algorithm to all or some of the digits in the number, which may be used to test validity of the non-check-digit identifier.

CX-3: Check Digit Scheme (ID)

Definition: Contains the code identifying the check digit scheme employed.

Refer to HL7 Table 0061 - Check Digit Scheme for valid values.

The algorithm for calculating a Mod10 check digit is as follows:

Assume you have an identifier - 12345. Take the odd digit positions, counting from the right, i.e., 531, multiply this number by 2 to get 1062. Take the even digit positions, starting from the right (i.e., 42), prepend these to the 1062 to get 421062. Add all of these six digits together to get 15. Subtract this number from the next highest multiple of 10, i.e., 20 - 15 to get 5. The Mod10 check digit is 5. The Mod10 check digit for 401 is 0; for 9999, it’s 4; for 99999999, it’s 8.

The algorithm for calculating a Mod11 check digit is as follows:

Terms

d

=

digit of number starting from units digit, followed by 10’s position, followed by 100’s position, etc.

w

=

weight of digit position starting with the units position, followed by 10’s position, followed by 100’s position etc. Values for w = 2, 3, 4, 5, 6, 7, 2, 3, 4, 5, 6, 7, etc. (repeats for each group of 6 digits)

c

=

check digit


Calculation

(Step 1) m

=

sum of (d * w) for positions 1, 2, etc. starting with units digit

for d = digit value starting with units position to highest order

for w = weight value from 2 to 7 for every six positions starting with units digit

(Step 2) c1

=

m mod 11

(Step 3) if c1

=

0 then reset c1 = 1

(Step 4)

=

(11 - c1) mod 10


Example:

If the number is 1234567, then the mod 11 check digit = 4

The calculations are:

M = (7*2)+(6*3)+(5*4)+(4*5)+(3*6)+(2*7)+(1*2)

= 14 + 18 + 20 + 20 + 18 + 14 + 2

= 106

c1 = 106 mod 11

= 7

c = (11-c1) mod 10

= 4 mod 10

= 4

Other variants of these check digit algorithms exist and may be used by local bilateral site agreement.

Note: The check digit and code identifying check digit scheme are null if ID is alphanumeric.


CX-4: Assigning Authority (HD)

The assigning authority is a unique name of the system (or organization or agency or department) that creates the data. As of v2.7, CX.4 Assigning Authority is required if neither CX.9 nor CX.10 are populated. Best practice is to always send an OID in the Assigning Authority component

Refer to User-defined Table 0363 - Assigning Authority for suggested values.

The reader is referred to the CX.9 and the CX.10 if there is a need to transmit values with semantic meaning for an assigning jurisdiction or assigning department or agency in addition to, or instead of, an assigning authority. However, all 3 components may be valued. If, in so doing, it is discovered that the values in CX.9 and/or CX.10 conflict with CX.4, the user would look to the Message Profile or other implementation agreement for a statement as to which takes precedence.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component) may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.    

By site agreement, implementers may continue to use User-defined Table 0300 – Namespace ID for the first sub-component.


CX-5: Identifier Type Code (ID)

A code corresponding to the type of identifier. As of v2.7, CX.5 Identifier Type Code is required. Refer to HL7 Table 0203 – Identifier Type for suggested values.

CX-6: Assigning Facility (HD)

Definition: The place or location identifier where the identifier was first assigned to the patient. This component is not an inherent part of the identifier but rather part of the history of the identifier: as part of this data type, its existence is a convenience for certain intercommunicating systems.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component), may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.


CX-7: Effective Date (DT)

Definition: The first date, if known, on which the identifier is valid and active.

CX-8: Expiration Date (DT)

Definition: The last date, if known, on which the identifier is valid and active.

CX-9: Assigning Jurisdiction (CWE)

Definition: The geo-political body that assigned the identifier in component 1. As of v2.7, Assigning Jurisdiction is required if neither CX.4 nor CX.10 are populated.

The reader is referred to the CX.4 if there is a need to transmit this information as an OID.

CX-10: Assigning Agency or Department (CWE)

Definition: The agency or department that assigned the identifier in component 1. As of v2.7, Assigning Agency or Department is required if neither CX.4 nor CX.9 are populated.

Refer to User-defined Table 0530 – Organizations, agency, department for suggested values if the administrative unit under whose jurisdiction the identifier was issued is an organization, agency or department. This is populated with site-specific assigning authorities. It also should contain national or international codes when CX.5 Identifier Type Code may be assigned by more than one authority within a governmental or organizational unit. For example, a federal government may have 2 departments that assign a military identifier, its Veterans Affairs department and its Department of Defense. It is not recommended to include values for entities such as Social Security Administration (SSA), Immigration and Naturalization Service (INS), Center for Medicare and Medicaid Services (CMS) because they are included in the identifier type table. In these cases the name of the country plus the identifier type yields the correct interpretation of the identifier in component 1. Likewise, entries like department of motor vehicles (DMV) and licensing boards are not recommended for inclusion because the combination of state and identifier type yields the correct interpretation of the identifier in component 1. This approach is not to be confused with the detailed information provided in the Chapter 15 segments that have provision for specifying the precise granting body and issuing body information needed in personnel management messages.

Example 1: <Identifier> plus <Visa> yields a unique identifier.

Example 2: <identifier> plus <state> plus <DLN> yields a unique driver’s license number.

Example 3: <identifier> plus <country> plus <INS> yields a unique immigration number.

The reader is referred to the CX.4, if there is a need to transmit this information as an OID.

CX-11: Security Check (ST)

Definition: This component is used to communicate a version code that may be assigned to the value given in CX.1 ID.

CX-12: Security Check Scheme (ID)

Definition: This component is used to transmit information intended to validate the veracity of the supplied identifier or the presenter of the identifier. For example, this component may be used to ensure that the presenter of a credit card is an authorized user of that card.

Refer to HL7 Table 0904 - Security Check Scheme for valid values.

DDI - daily deductible information

HL7 Component Table - DDI - daily deductible information
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
DDI
1 Delay Days [0..1]   3 NM
2 Monetary Amount [1..1]     MO
3 Number of Days [0..1]   4 NM

Components: <Delay Days (NM)> & <Monetary Amount (MO)> & <Number of Days (NM)>

Subcomponents for Monetary Amount (MO): <Quantity (NM)> ^ <Denomination (ID)>


DDI-1: Delay Days (NM)

Definition: The number of days after which the daily deductible begins.

DDI-2: Monetary Amount (MO)

Definition: The monetary amount of the deductible.

DDI-3: Number of Days (NM)

Definition: The number of days to apply the deductible. If this component is not populated, it means that the number of days is indefinite.

DIN - date and institution name

HL7 Component Table - DIN - date and institution name
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
DIN
1 Date [1..1]     DTM
2 Institution Name [1..1]     CWE

Components: <Date (DTM)> & <Institution Name (CWE)>

Subcomponents for Institution Name (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


DIN-1: Date (DTM)

Definition: Specifies the date when a staff member became active or inactive.

DIN-2: Institution Name (CWE)

Definition: Specifies the institution where a staff member is or was active. Refer to User-Defined Table 0531 - Institution for suggested values.

DLD - discharge to location and date

HL7 Component Table - DLD - discharge to location and date
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
DLD
1 Discharge to Location [1..1]     CWE
2 Effective Date [0..1]     DTM

Components: <Discharge to Location (CWE)> & <Effective Date (DTM)>

Subcomponents for Discharge to Location (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


DLD-1: Discharge to Location (CWE)

Definition: This component specifies the healthcare facility to which the patient was discharged. Refer to User-defined Table 0113 - Discharged to Location for suggested values.

DLD-2: Effective Date (DTM)

Definition: Specifies the date on which the patient was discharged to a healthcare facility.

DLN - driver’s license number

HL7 Component Table - DLN - driver’s license number
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
DLN
1 Driver's License Number [1..1]  20 ST
2 Issuing State, Province, Country [0..1]     CWE
3 Expiration Date [0..1]     DT

Components: <Driver's License Number (ST)> & <Issuing State, Province, Country (CWE)> & <Expiration Date (DT)>

Subcomponents for Issuing State, Province, Country (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Definition: This field contains the driver’s license information. For state or province refer to official postal codes for that country; for country refer to ISO 3166 for codes.

DLN-1: Driver's License Number (ST)

Definition: This field contains the driver’s license number.

DLN-2: Issuing State, Province, Country (CWE)

Definition: Issuing authority for driver’s license. For state or province, refer to official postal codes for that country; for country, refer to ISO 3166 for codes. The ISO 3166 table has three separate forms of the country code: HL7 specifies that the 3-character (alphabetic) form be used for the country code. User-defined Table 0333 - Driver’s License Issuing Authority is used as the HL7 identifier for the user-defined table of values for this component.

DLN-3: Expiration Date (DT)

Definition: Expiration date (DT) for driver’s license.

DLT - delta

HL7 Component Table - DLT - delta
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
DLT
1 Normal Range [0..1]     NR
2 Numeric Threshold [0..1]   4 NM
3 Change Computation [0..1]     ID
4 Days Retained [0..1]   4 NM

Components: <Normal Range (NR)> & <Numeric Threshold (NM)> & <Change Computation (ID)> & <Days Retained (NM)>

Subcomponents for Normal Range (NR): <Low Value (NM)> ^ <High Value (NM)>


DLT-1: Normal Range (NR)

Definition: Specifies the normal interval of the reference data.

DLT-2: Numeric Threshold (NM)

Definition: The numeric threshold of the change that is detected.

For example the threshold may be set to 10.

DLT-3: Change Computation (ID)

Definition: Specifies if the change is computed as a percent change or as an absolute change. Refer to HL7 Table 0523 - Computation Type for valid values.

DLT-4: Days Retained (NM)

Definition: The length of time in days that the value is retained for computing delta checks.

DR - date/time range

HL7 Component Table - DR - date/time range
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
DR
1 Range Start Date/Time [0..1]     DTM
2 Range End Date/Time [0..1]     DTM

Components: <Range Start Date/Time (DTM)> & <Range End Date/Time (DTM)>


DR-1: Range Start Date/Time (DTM)

Definition: The first component contains the earliest date/time (time stamp) in the specified range.

DR-2: Range End Date/Time (DTM)

The second component contains the latest date/time in the specified range.

Note: The DTM (time stamp) data type allows the specification of precision.


DT - date

DTM - date/time

HL7 Component Table - DTM - date/time
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
DTM
1 Date/Time SHALL [0..1] [4..24]   8

One exception to this rule would be a clinical system that processed patient data collected in a clinic and a nearby hospital that happens to be in a different time zone. Such applications may choose to convert the data to a common representation. Similar concerns apply to the transitions to and from daylight saving time. HL7 supports such requirements by requiring that the time zone information be present when the information is sent. It does not, however, specify which of the treatments discussed here will be applied by the receiving system.

The DTM data type does not follow the normal truncation pattern, and the truncation character is never valid in the DTM data type. Instead, the truncation behavior is based on the semantics of dates and times.

Unless otherwise specified in the context where the DTM type is used, the DTM type may be truncated to a day. When a DTM is truncated, the truncated form SHALL still be a valid DTM type. Systems should always be able to persist full date / time information including the timezone. Refer to Chapter 2, section 2.5.5.2 "Truncation Pattern" for further information.

DTN - day type and number

HL7 Component Table - DTN - day type and number
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
DTN
1 Day Type [1..1]     CWE
2 Number of Days [1..1]   3 NM

Components: <Day Type (CWE)> & <Number of Days (NM)>

Subcomponents for Day Type (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


DTN-1: Day Type (CWE)

Definition: Specifies whether the days are denied, pending, or approved.

Refer to User-defined Table 0149 - Day Type for suggested values.

DTN-2: Number of Days (NM)

Definition: Specifies the number of days for which the certification is valid.

ED - encapsulated data

HL7 Component Table - ED - encapsulated data
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
ED
1 Source Application [0..1]     HD
2 Type of Data SHALL [1..1] [4..11]     ID
3 Data Subtype [0..1]     ID
4 Encoding SHALL [1..1] [1..6]     ID
5 Data [1..1]     TX

Components: <Source Application (HD)> & <Type of Data (ID)> & <Data Subtype (ID)> & <Encoding (ID)> & <Data (TX)>

Subcomponents for Source Application (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Definition: This data type transmits encapsulated data from a source system to a destination system. It contains the identity of the source system, the type of data, the encoding method of the data, and the data itself. This data type is similar to the RP (reference pointer) data type of Section 2.A.65, "RP - reference pointer," except that instead of pointing to the data on another system, it contains the data which is to be sent to that system.

ED-1: Source Application (HD)

Definition: A unique name that identifies the system which was the source of the data. Identical format and restrictions as in reference pointer (see Section 2.A.65.2, "Application ID (HD)").

ED-2: Type of Data (ID)

Definition: Identical to “type of data” component in the reference pointer (RP) data type. See Section 2.A.65.3, "Type of Data (ID)".

Refer to Imported Table 0834 – MIME Types for valid values.

ED-3: Data Subtype (ID)

Definition: Identical to “subtype” component in the reference pointer (RP) data type. See Section 2.A.65.4, "Subtype (ID)".

Refer to External Table 0291 - Subtype of Referenced Data for valid values.

ED-4: Encoding (ID)

Definition: The type of encoding used to represent successive octets of binary data as displayable ASCII characters. Refer to HL7 Table 0299 - Encoding for valid values.

ED-5: Data (TX)

Definition: Displayable ASCII characters which constitute the data to be sent from source application to destination application. The characters are limited to the legal characters of the ST data type, as defined in Section 2.A.75, "ST - string data," and, if encoded binary, are encoded according to the method of Section 2.A.24.2, "Type of Data (ID)".

If the encoding component (see Section 2.A.24.4, "Encoding (ID)") = "A" (none), then the data component must be scanned before transmission for HL7 delimiter characters, and any found must be escaped by using the HL7 escape sequences defined in Section 2.7 – "Use of escape sequences in text fields." On the receiving application, the data field must be de-escaped after being parsed.

If the encoding component ED.4 does not equal "A", then, after encoding, the (encoded) data must be scanned for HL7 delimiter characters, and any found must be escaped by using the HL7 escape sequences. Only then can the component be added to the HL7 segment/message. On the receiving application, the data field must be de-escaped after being parsed out of the message before being decoded. This can be expressed as "encode", "escape", "parse", "de-escape" or "decode".

EI - entity identifier

HL7 Component Table - EI - entity identifier
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
EI
1 Entity Identifier [0..1] 199 ST
2 Namespace ID [0..1]  20 IS
3 Universal ID [0..1] 199 ST
4 Universal ID Type SHALL [0..1] [1..6]     ID

Components: <Entity Identifier (ST)> & <Namespace ID (IS)> & <Universal ID (ST)> & <Universal ID Type (ID)>

Definition: The entity identifier defines a given entity within a specified series of identifiers.

The EI is appropriate for, but not limited to, machine or software generated identifiers. The generated identifier goes in the first component. The remaining components, 2 through 4, are known as the assigning authority; they identify the machine/system responsible for generating the identifier in component 1.

The specified series, the assigning authority, is defined by components 2 through 4. The assigning authority is of the hierarchic designator (HD) data type, but it is defined as three separate components in the EI data type, rather than as a single component as would normally be the case. This is in order to maintain backward compatibility with the EI’s use as a component in several existing data fields. Otherwise, the components 2 through 4 are as defined in Section 2.A.33, "HD - hierarchic designator". Hierarchic designators (HD) are unique across a given HL7 implementation.

EI-1: Entity Identifier (ST)

Definition: The first component, <entity identifier>, is usually defined to be unique within the series of identifiers created by the <assigning authority>, defined by a hierarchic designator, represented by components 2 through 4. See Section 2.A.33, "HD - hierarchic designator".

EI-2: Namespace ID (IS)

Definition: See Section 2.A.33.1, "Namespace ID (IS)" for definition. The component intentionally remains associated with the IS data type in v 2.7.

The assigning authority is a unique identifier of the system (or organization or agency or department) that creates the data. Refer to User-defined Table 0363 – Assigning Authority for suggested values.

Note: When the HD is used as a part of another data type, in this case as part of the EI data type, this table may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.

By site agreement, implementers may continue to use User-defined Table 0300 – Namespace ID for the first component


EI-3: Universal ID (ST)

Definition: See Section 2.A.33.2, "Universal ID (ST)" for definition.

EI-4: Universal ID Type (ID)

Definition: Refer to HL7 Table 0301 - Universal ID Type for valid values. See Section 2.A.33.3, "Universal ID Type (ID)," for definition.

EIP - entity identifier pair

HL7 Component Table - EIP - entity identifier pair
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
EIP
1 Placer Assigned Identifier [0..1]     EI
2 Filler Assigned Identifier [0..1]     EI

Components: <Placer Assigned Identifier (EI)> & <Filler Assigned Identifier (EI)>

Subcomponents for Placer Assigned Identifier (EI): <Entity Identifier (ST)> ^ <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Filler Assigned Identifier (EI): <Entity Identifier (ST)> ^ <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>


EIP-1: Placer Assigned Identifier (EI)

Definition: Specifies an identifier assigned to an entity by the placer system.

For example, the component might be used to convey the following:

  1. placer order number of the parent order.

  2. the specimen identifier as assigned by the placer.

  3. a location identifier assigned (or used by) the placer.

EIP-2: Filler Assigned Identifier (EI)

Definition: Specifies an identifier assigned to an entity by the filler system.

For example, the component might convey the following:

  1. filler order number of the parent order.

  2. the specimen identifier as assigned by the filler.

  3. a location identifier assigned (or used by) the filler.

WITHDRAWN (ELD – error location and description)

Attention: The ELD data type was retained for backward compatibility only as of v 2.5 and the detail was withdrawn and removed from the standard as of v 2.7. Refer to ERR-2 and ERR-3 instead.

ERL - Message location

HL7 Component Table - ERL - Message location
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
ERL
1 Segment ID SHALL [1..1] [3..3]     ST
2 Segment Sequence [1..1]     SI
3 Field Position [0..1]     SI
4 Field Repetition [0..1]     SI
5 Component Number [0..1]     SI
6 Sub-Component Number [0..1]     SI

Components: <Segment ID (ST)> & <Segment Sequence (SI)> & <Field Position (SI)> & <Field Repetition (SI)> & <Component Number (SI)> & <Sub-Component Number (SI)>


ERL-1: Segment ID (ST)

Definition: Specifies the 3-letter name for the segment.

ERL-2: Segment Sequence (SI)

Definition: Identifies the segment occurrence within the message. The first occurrence of a segment is assigned the number of 1.

Note: This number refers to the absolute position of the referenced instance of the segment type in the message – it is not synonymous with the Set-ID of the segment – for example if the referenced element is OBX in field position 5, that means it is the 5th OBX segment in the message, regardless of the number of OBR segments that may be interspersed between them, which causes a reset of the Set-ID.


ERL-3: Field Position (SI)

Definition: Identifies the number of the field within the segment. The first field is assigned a number of 1. Field number should not be specified when referring to the entire segment. This field is conditionally required, when Component Number (ERL-5) is populated..

ERL-4: Field Repetition (SI)

Definition: Identifies the repetition number of the field. The first repetition is counted as 1. If a Field Position is specified, but Field Repetition is not, Field Repetition should be assumed to be 1. If Field Position is not specified, Field Repetition should not be specified.

ERL-5: Component Number (SI)

Definition: Identifies the number of the component within the field. The first component is assigned a number of 1. Component number should not be specified when referring to the entire field. This field is conditionally required, when Sub-Component Number (ERL-6) is populated.

ERL-6: Sub-Component Number (SI)

Definition: Identifies the number of the sub-component within the component. The first sub-component is assigned a number of 1. Sub-component number should not be specified when referring to the entire component.

FC - financial class

HL7 Component Table - FC - financial class
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
FC
1 Financial Class Code [1..1]     CWE
2 Effective Date [0..1]     DTM

Components: <Financial Class Code (CWE)> & <Effective Date (DTM)>

Subcomponents for Financial Class Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

FC-1: Financial Class Code (CWE)

Definition: This component contains the financial class assigned to a person. User-defined Table 0064 - Financial Class is used as the HL7 identifier for the user-defined table of values for this component.

FC-2: Effective Date (DTM)

Definition: This component contains the effective date/time of the person’s assignment to the financial class specified in the first component.

FN - family name

HL7 Component Table - FN - family name
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
FN
1 Surname [1..1]  50 ST
2 Own Surname Prefix [0..1]  20 ST
3 Own Surname [0..1]  50 ST
4 Surname Prefix from Partner/Spouse [0..1]  20 ST
5 Surname from Partner/Spouse [0..1]  50 ST

Components: <Surname (ST)> & <Own Surname Prefix (ST)> & <Own Surname (ST)> & <Surname Prefix from Partner/Spouse (ST)> & <Surname from Partner/Spouse (ST)>


FN-1: Surname (ST)

Definition: The atomic element of the person's family name. In most Western usage, this is the person's last name.

FN-2: Own Surname Prefix (ST)

Definition: Internationalization usage for Germanic languages. This component is optional. An example of a <surname prefix> is the "van" in "Ludwig van Beethoven". Since the <surname prefix> doesn't sort completely alphabetically, it is reasonable to specify it as a separate sub-component of the PN and extended PN data types (XPN and XCN).

Note: Subcomponents <own surname prefix>, <own surname>, <surname prefix from partner/spouse> and <surname from partner/spouse> decompose complex Germanic names such as “Martha de Mum-van Beethoven”. If these subcomponents are valued, the <surname> subcomponent should still be fully valued for backward compatibility, i.e., ^de Mum-van Beethoven&de&Mum&van&Beethoven^.
Also, for clarity, the <last name prefix> has been renamed to <own surname prefix>.


FN-3: Own Surname (ST)

Definition: The portion of the surname (in most Western usage, the last name) that is derived from the person's own surname, as distinguished from any portion that is derived from the surname of the person's partner or spouse. This component is optional.

If the person's surname has legally changed to become (or incorporate) the surname of the person's partner or spouse, this is the person's surname immediately prior to such change. Often this is the person's "maiden name".

FN-4: Surname Prefix from Partner/Spouse (ST)

Definition: Internationalization usage for Germanic languages. This component is optional. An example of a <surname prefix> is the “van” in "Ludwig van Beethoven". Since the <surname prefix> doesn't sort completely alphabetically, it is reasonable to specify it as a separate sub-component of the PN and extended PN data types (XPN and XCN).

Note: Subcomponents <own surname prefix>, <own surname>, <surname prefix from partner/spouse> and <surname from partner/spouse> decompose complex Germanic names such as “Martha de Mum-van Beethoven”. If these subcomponents are valued, the <surname> subcomponent should still be fully valued for backward compatibility, i.e., ^de Mum-van Beethoven&de&Mum&van&Beethoven^.”
Also, for clarity, the <last name prefix> has been renamed to <own surname prefix>.


FN-5: Surname from Partner/Spouse (ST)

Definition: The portion of the person's surname (in most Western usage, the last name) that is derived from the surname of the person's partner or spouse, as distinguished from the part derived from the person's own surname. This component is optional.

If no portion of the person's surname is derived from the surname of the person's partner or spouse, this component is not valued. Otherwise, if the surname of the partner or spouse has legally changed to become (or incorporate) the person's surname, this is the surname of the partner or spouse immediately prior to such change.

FT - formatted text data

HL7 Component Table - FT - formatted text data
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
FT
1 Formatted Text Data [0..1]    

Example:

|\.sp\(skip one vertical line)|

For additional examples of formatting commands see Section 2.7, "Use of Escape Sequences in Text Fields".

To include alternative character sets, use the appropriate escape sequence. See Chapter 2, "Control", section 2.15.9.18, "Character set" and section 2.14.9.20, "Alternate character set handling scheme".

This specification applies no limit to the length of the FT data type, either here where the data type is defined, or elsewhere where the data type is used. While there is no intrinsic reason to limit the length of this data type for semantic or syntactical reasons, it is expected that some sort of limitation will be imposed for technical reasons in implementations. HL7 recommends that implementation length limits are published in implementation profiles. The contents of an FT field may be truncated, but the truncation pattern does not apply.

GTS - general timing specification

HL7 Component Table - GTS - general timing specification
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
GTS
1 General Timing Specification [0..1] 199

There is no technical limit to the length of a GTS expression – the expression may be as long as logically required. The conformance length of 199 caters for all the common expressions. GTS expressions are not to be truncated.

HD - hierarchic designator

HL7 Component Table - HD - hierarchic designator
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
HD
1 Namespace ID [0..1]  20 IS
2 Universal ID [0..1] 199 ST
3 Universal ID Type SHALL [0..1] [1..6]     ID

Components: <Namespace ID (IS)> & <Universal ID (ST)> & <Universal ID Type (ID)>


Examples:

Example 1: ISO example with only the 2nd and 3rd components valued:

|^2.16.840.1.113883.19^ISO|

The syntax of the second component is defined by the ISO standard for object identifiers, not by HL7 (for which the second component is of the ST data type). Thus the periods (".") in the second component are part of the ISO syntax, and are legal by the definition of the HL7 ST data type.

Example 2: A UUID example

|^478A0114-EBF0-7701-A023-6841FF05731A^UUID|

Example 3: A DNS example

|^falcon.iupui.edu^DNS|

Local examples:

Example 4: Local use only: a HD that looks like an IS data type

|LAB1|

|RX.PIMS.SystemB.KP.CA.SCA|

Note that the syntax of the first component is not defined by HL7 but by the site according to its own needs: the only requirement is that the first component’s structure is allowed by the HL7 string (ST) data type, which is used for values by the IS data type.

Example 5: Local identifier using components 2 and 3 only (Deprecated as of v2.8 and will be withdrawn in V2.10)

|^RX.PIMS.SystemB.CA.SCA^M|

An alternate way to encode the previous example, illustrating the use of the third component value of "M" (see HL7 Table 0301 - Universal ID type below) to identify a locally-defined identifier set. The second component has the same value as the previous example but is now defined to be a member of a set of allowable values defined by a site for the identifier set “M”. The use of local coding schemes as Universal ID Types is deprecated as of v 2.8; assigning authorities should be identified with true Universal IDs.

Example 6: local identifier and universal ID types:

|LAB1^2.16.840.1.113883.19.1.2.3.3.4.6.7^ISO|

A HD with an ISO "object Identifier" as a UID and a locally defined system name. Both the first component and the second and third (taken together) refer to the same entity. This example shows that the local value and the universal ID value may be transmitted with a single HD field.

HD-1: Namespace ID (IS)

Definition: The local coded item for the entity. The component intentionally remains associated with the IS data type in v 2.7.

User-defined Table 0300 - Namespace ID is used as the HL7 identifier for the user-defined table of values for this component.

Note: When the HD is used in a given segment (either as a field or as a component of another data type) this table may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.


HD-2: Universal ID (ST)

Definition: The HD’s second component, <universal ID> (UID), is a string formatted according to the scheme defined by the third component, <universal ID type> (UID type). The UID is intended to be unique over time within the UID type. It is rigorously defined. Each UID must belong to one of the specifically enumerated schemes for constructing UIDs (defined by the UID type). The UID (second component) must follow the syntactic rules of the particular universal identifier scheme (defined by the third component).

Note: These syntactic rules are not defined within HL7 but are defined by the rules of the particular universal identifier scheme (defined by the third component).


HD-3: Universal ID Type (ID)

Definition: The third component governs the interpretation of the second component of the HD. If the third component is a known UID refer to HL7 Table 0301 - Universal ID type for valid values, then the second component is a universal ID of that type.

ICD - insurance certification definition

HL7 Component Table - ICD - insurance certification definition
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
ICD
1 Certification Patient Type [0..1]     CWE
2 Certification Required SHALL [1..1] [1..1]     ID
3 Date/Time Certification Required [0..1]     DTM

Components: <Certification Patient Type (CWE)> & <Certification Required (ID)> & <Date/Time Certification Required (DTM)>

Subcomponents for Certification Patient Type (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


ICD-1: Certification Patient Type (CWE)

Definition: Specifies the category or type of patient for which this certification is requested. Refer to User-defined Table 0150 - Certification patient type for suggested values.

ICD-2: Certification Required (ID)

Definition: Specifies whether or not a certification is required. Refer to HL7 Table 0136 - Yes/no Indicator for valid values.

ICD-3: Date/Time Certification Required (DTM)

Definition: The date/time by which the certification must be obtained.

ID - coded value for HL7 defined tables

HL7 Component Table - ID - coded value for HL7 defined tables
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
ID
1 Coded Value for HL7-Defined Tables SHALL [0..1] [1..]  15

Definition: The value of such a field follows the formatting rules for an ST field except that it is drawn from a table of legal values. There shall be an HL7 table number associated with ID data types. An example of an ID field is OBR-25 Result Status. This data type should be used only for HL7 tables (see Chapter 2C, section 2.C.1.2, "HL7 Tables"). The reverse is not true, since in some circumstances it is more appropriate to use the CNE or CWE data type for HL7 tables.

The minimum and maximum lengths are specified in the context in which the ID data type is used. The longest HL7 defined legal value is 15 characters, but there are a few circumstances where the legal values are taken from code systems defined by other bodies (such as IANA mime types). In these cases, a different conformance length may be specified where the ID data type is used. It is never acceptable to truncate an ID value.

IS - coded value for user-defined tables

HL7 Component Table - IS - coded value for user-defined tables
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
IS
1 Coded Value for User-Defined Tables SHALL [0..1] [1..]  20

As of v2.7, the only approved use of the IS data type is in the HD.1, EI.2 and PL.6 plus a limited number of fields where a determination could not readily be made as to whether the item is an identifier or an actual coded item. Additionally, in accordance with chapter 2 rules, any field or data type component marked as "Retained for backward compatibility" will retain any IS data type.

The value of such a field follows the formatting rules for a ST field except that it is drawn from a site-defined (or user-defined) table of legal values. There shall be an HL7 table number associated with IS data types. An example of an IS field is the Event reason code defined in Chapter 3, "Patient Administration", section 3.4.1.4, "Event reason code". This data type should be used only for user-defined tables (see Chapter 2C, "Code Tables", section 2.C.1.1, "User-defined Tables"). The reverse is not true, since in some circumstances, it is more appropriate to use the CWE data type for user-defined tables.

It is never acceptable to truncate an IS value.

JCC - job code/class

HL7 Component Table - JCC - job code/class
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
JCC
1 Job Code [0..1]     CWE
2 Job Class [0..1]     CWE
3 Job Description Text [0..1]     TX

Components: <Job Code (CWE)> & <Job Class (CWE)> & <Job Description Text (TX)>

Subcomponents for Job Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Job Class (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Example 1: Codified job (where 1 represents the code for Administrator and F represents full time)

|1^F^Administrator|

Example 2: Uncodified job (where job codes are not codified and PT represents part time)

|^PT^Analyst|.

JCC-1: Job Code (CWE)

Definition: This component contains the person’s job code. User-defined Table 0327 - Job Code is used as the HL7 identifier for the user-defined table of values for this component.

JCC-2: Job Class (CWE)

Definition: This component contains the person’s employee classification. Refer to User-defined Table 0328 - Employee Classification for suggested values.

JCC-3: Job Description Text (TX)

Definition: This component contains the text of the job description. This will accommodate systems where job descriptions are not codified.

WITHDRAWN (LA1 - location with address variation 1)

Attention: The LA1 data type was retained for backward compatibility only as of v 2.5 and the detail was withdrawn and removed from the standard as of v 2.8.

WITHDRAWN (LA2 - location with address variation 2)

Attention: The LA2 data type was retained for backward compatibility only as of v 2.5 and the detail was withdrawn and removed from the standard as of v 2.8.

MA - multiplexed array

HL7 Component Table - MA - multiplexed array
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
MA
1 Sample Y From Channel 1 [0..1]     NM
2 Sample Y From Channel 2 [0..1]     NM
3 Sample Y From Channel 3 [0..1]     NM
4 Sample Y From Channel 4 [0..1]     NM

Components: <Sample Y From Channel 1 (NM)> & <Sample Y From Channel 2 (NM)> & <Sample Y From Channel 3 (NM)> & <Sample Y From Channel 4 (NM)>

Definition: This data type is used to represent channel-multiplexed waveform data. Assuming that fields that utilize this data type repeat and that Y represents the specific repetition, the components of the repetition will reflect sample Y from each channel.

Usage Note: The MA data type is preferred when the signal recording device outputs the waveform data by time (all signal amplitudes at time sample 1, followed by all signal amplitudes at time sample 2, followed by all signal amplitudes at time sample 3, etc.). The typical count is 32, 64, or 128 channels. At the time of this writing, the MA data type is the one used by most commercial EEG instruments, while other electrophysiological instruments (such as evoked potential instruments) may use the NA data type. The MA data type is the "natural" one for multi-channel EEG instruments since the signal acquisition process involves digitizing each channel in succession as rapidly as possible, then after a fixed interval (like 0.004 seconds) digitizing all the channels again in succession, and repeating this every 0.004 seconds as long as the recording continues.

Conversion of one format to another is often not possible or desirable in near-real-time applications. For example, a long-term EEG recording may go on for 24, 48, 72, or more hours and implementations cannot wait until the recording is ended to transmit the data because physicians need to review the waveforms as the recording is in progress; this is why it only makes sense to organize the data by the MA data type which sends the data one time sample after the next.

Note that, visually, the NA and MA data types are indistinguable: they both appear as a series of numeric components. They are distinguished by context, particularly when used in OBX.5 where the data type is specified in OBX.3.

Use Case: Commercial EEG instruments

Example 1: 3 channels (identical), 6 time-samples

|0^0^0~1^1^1~2^2^2~3^3^3~4^4^4~5^5^5|

Example 2: 1 channel, 11 time-samples

|0~1~2~3~4~5~6~7~8~9~10|

MA-1: Sample Y From Channel 1 (NM)

MA-2: Sample Y From Channel 2 (NM)

MA-3: Sample Y From Channel 3 (NM)

MA-4: Sample Y From Channel 4 (NM)

MO - money

HL7 Component Table - MO - money
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
MO
1 Quantity [0..1]     NM
2 Denomination SHALL [0..1] [3..3]     ID

Components: <Quantity (NM)> & <Denomination (ID)>

Definition: This data type specifies an amount of money and the denomination in which it is expressed.

MO-1: Quantity (NM)

Definition: The first component is a quantity.

MO-2: Denomination (ID)

Definition: The second component is the denomination in which the quantity is expressed. The values for the denomination component are the three-character codes specified in ISO-4217. See Externally-defined Table 0913 – Monetary Denomination Code.

If the denomination is not specified, "MSH-17-country code", in Chapter 2, section 2.14.9.17, is used to determine the default. Example,

|99.50^USD|

where USD is the ISO 4217 code for the U.S. American dollar.

MOC - money and charge code

HL7 Component Table - MOC - money and charge code
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
MOC
1 Monetary Amount [0..1]     MO
2 Charge Code [0..1]     CWE

Components: <Monetary Amount (MO)> & <Charge Code (CWE)>

Subcomponents for Monetary Amount (MO): <Quantity (NM)> ^ <Denomination (ID)>

Subcomponents for Charge Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


MOC-1: Monetary Amount (MO)

Definition: The amount and denomination of money associated with the charge code.

MOC-2: Charge Code (CWE)

Definition: The code identifying the charge to the ordering entity for the services performed.

MOP - money or percentage

HL7 Component Table - MOP - money or percentage
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
MOP
1 Money or Percentage Indicator [1..1]     ID
2 Money or Percentage Quantity [1..1]     NM
3 Monetary Denomination SHALL [0..1] [3..3]     ID

Components: <Money or Percentage Indicator (ID)> & <Money or Percentage Quantity (NM)> & <Monetary Denomination (ID)>


Example: USD is the ISO 4217 code for the U.S. American dollar.

|AT^99.50^USD|

MOP-1: Money or Percentage Indicator (ID)

Definition: Specifies whether the amount is currency or a percentage.

Refer to HL7 Table 0148 – Money or Percentage Indicator for valid values.

MOP-2: Money or Percentage Quantity (NM)

Definition: Specifies the currency or percentage quantity.

MOP-3: Monetary Denomination (ID)

Definition: the denomination in which the quantity is expressed where the amount is currency. The values for the denomination component are the three-character codes specified in ISO-4217. See Externally-defined Table 0913 – Monetary Denomination Code.

If the denomination is not specified, the context of the message or MSH-17 Country Code, in Chapter 2, section 2.14.9.17, is used to determine the default.

MSG - message type

HL7 Component Table - MSG - message type
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
MSG
1 Message Code SHALL [1..1] [3..3]     ID
2 Trigger Event SHALL [1..1] [3..3]     ID
3 Message Structure SHALL [1..1] [3..7]     ID

Components: <Message Code (ID)> & <Trigger Event (ID)> & <Message Structure (ID)>


MSG-1: Message Code (ID)

Definition: Specifies the message type code. Refer to HL7 Table 0076– Message Type for valid values.

This table contains values such as ACK, ADT, ORM, ORU etc.

See Chapter 2, "Control", section 2.5.1, "Messages" for further discussion.

MSG-2: Trigger Event (ID)

Definition: Specifies the trigger event code. Refer to HL7 Table 0003– Event Type for valid values.

This table contains values like A01, O01, R01 etc.

See Chapter 2, "Control", section 2.3.1, "Trigger Events" for further discussion.

MSG-3: Message Structure (ID)

Definition: Specifies the abstract message structure code. Refer to HL7 Table 0354 – Message Structure for valid values.

NA - numeric array

HL7 Component Table - NA - numeric array
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
NA
1 Value1 [0..1]     NM
2 Value2 [0..1]     NM
3 Value3 [0..1]     NM
4 Value4 [0..1]     NM

Components: <Value1 (NM)> & <Value2 (NM)> & <Value3 (NM)> & <Value4 (NM)>

Definition: This data type is used to represent a series (array) of numeric values. A field of this type may contain a one-dimensional array (vector or row) of numbers. Also, by allowing the field to repeat, a two-dimensional array (table) of numbers may be transmitted using this format, with each row of the table represented as one repetition of the field. Arrays that have one or more values not present may be transmitted using this data type. "Not present" values are represented as two adjacent component delimiters. If the absent values occur at the end of a row, the trailing component delimiters may be omitted. If an entire row of a table has no values, no component delimiters are necessary (in this case, there will be two adjacent repetition delimiters).

Example 1: vector of 8 numbers

|125^34^-22^-234^569^442^-212^6|

Example 2: 3 x 3 array of numbers

|1.2^-3.5^5.2~2.0^3.1^-6.2~3.5^7.8^-1.3|

Example 3: 5 x 4 array of numbers with the values in positions (1,1), (2,2), (2,3), (3,3), (3,4), (4,1), (4,2), (4,3), and (4,4) not present

|^2^3^4~5^^^8~9^10~~17^18^19^20|

NA-1: Value1 (NM)

NA-2: Value2 (NM)

NA-3: Value3 (NM)

NA-4: Value4 (NM)

NDL - name with date and location

Attention: Retained for backward compatibility only in v2.6. Fields associated with this data type have been replaced by the ROL segment.

HL7 Component Table - NDL - name with date and location
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
NDL
1 Name [0..1]     CNN
2 Start Date/Time [0..1]     DTM
3 End Date/Time [0..1]     DTM
4 Point of Care [0..1]  20 IS
5 Room [0..1]  20 IS
6 Bed [0..1]  20 IS
7 Facility [0..1]     HD
8 Location Status [0..1]  20 IS
9 Patient Location Type [0..1]  20 IS
10 Building [0..1]  20 IS
11 Floor [0..1]  20 IS

Components: <Name (CNN)> & <Start Date/Time (DTM)> & <End Date/Time (DTM)> & <Point of Care (IS)> & <Room (IS)> & <Bed (IS)> & <Facility (HD)> & <Location Status (IS)> & <Patient Location Type (IS)> & <Building (IS)> & <Floor (IS)>

Subcomponents for Name (CNN): <ID Number (ST)> ^ <Family Name (ST)> ^ <Given Name (ST)> ^ <Second and Further Given Names or Initials Thereof (ST)> ^ <Suffix (ST)> ^ <Prefix (ST)> ^ <Degree (IS)> ^ <Source Table (IS)> ^ <Assigning Authority - Namespace ID (IS)> ^ <Assigning Authority - Universal ID (ST)> ^ <Assigning Authority - Universal ID Type (ID)>

Subcomponents for Facility (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>


NDL-1: Name (CNN)

Definition: This component specifies the name of the person performing a service.

NDL-2: Start Date/Time (DTM)

Definition: This component specifies the starting date and time for when the person is performing the service.

NDL-3: End Date/Time (DTM)

Definition: This component specifies the ending date and time for when the person is performing the service.

NDL-4: Point of Care (IS)

Definition: This component specifies the code for the point where patient care is administered. It is conditional on NDL.9 – Patient Location Type (e.g., nursing unit or department or clinic). After floor, it is the most general patient location designation. Refer to User-defined Table 0302 - Point of care for suggested values.

NDL-5: Room (IS)

Definition: Patient room. After point of care, it is the most general location designation. Refer to User-defined Table 0303 - Room for suggested values.

NDL-6: Bed (IS)

Definition: This component specifies the code for the patient's bed. After room, it is the most general location designation. Refer to User-defined Table 0304 - Bed for suggested values.

NDL-7: Facility (HD)

Definition: This component is subject to site interpretation but generally describes the highest level physical designation of an institution, medical center or enterprise. It is the most general location designation.

NDL-8: Location Status (IS)

Definition: This component specifies the code for the status or availability of the location. For example, it may convey bed status. Refer to User-defined Table 0306 - Location Status for suggested values.

NDL-9: Patient Location Type (IS)

Definition: Location type is the categorization of the location defined by facility, building, floor, point of care, room or bed. Although not a required field, when used, it may be the only populated field. Usually includes values such as nursing unit, department, clinic, SNF, physician’s office. Refer to User-defined Table 0305 - Person Location Type for suggested values.

NDL-10: Building (IS)

Definition: This component specifies the code for the building where the person is located. After facility, it is the most general location designation. Refer to User-defined Table 0307 - Building for suggested values.

NDL-11: Floor (IS)

Definition: This component specifies the code for the floor where the person is located. After building, it is the most general location designation. Refer to User-defined Table 0308 - Floor for suggested values.

NM - numeric

HL7 Component Table - NM - numeric
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
NM
1 Numeric SHALL [0..1] [1..16]    

Examples:

|999|

|-123.792|

|0.1|

Values of this data type shall contain at least one digit to the left of the decimal point. This means that 0.1 is a valid representation, while .1 is not. Leading zeros, or trailing zeros after a decimal point, are not significant. For example, the following two values with different representations, "01.20" and "1.2," are identical. Except for the optional leading sign (+ or -) and the optional decimal point (.), no non-numeric ASCII characters are allowed. Thus, the value <12 should be encoded as a structured numeric (SN) (preferred) or as a string (ST) (allowed, but not preferred) data type.

The NM data type does not follow the normal truncation pattern, and the truncation character is never valid in the NM data type. Instead, the truncation behavior is based on the semantics of numbers.

Values of type NM may always have leading zeros truncated. Note that HL7 recommends that leading zeros not be used. Unless NM is used to represent a monetary amount, implementations may truncate trailing zeros after the decimal point up to the first non-zero digit or the decimal point, which ever comes first. Any digits to the left of the decimal point may never be truncated (other than leading zeros).

Example: 1.0200 may be truncated to 1.02, but not to 1.0.

NR - numeric range

HL7 Component Table - NR - numeric range
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
NR
1 Low Value [0..1]     NM
2 High Value [0..1]     NM

Components: <Low Value (NM)> & <High Value (NM)>


NR-1: Low Value (NM)

Definition: The number specifying the lower limit or boundary of the range.

NR-2: High Value (NM)

Definition: The number specifying the high limit or boundary of the range.

OCD - occurrence code and date

HL7 Component Table - OCD - occurrence code and date
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
OCD
1 Occurrence Code [1..1]     CNE
2 Occurrence Date [1..1]   8 DT

Components: <Occurrence Code (CNE)> & <Occurrence Date (DT)>

Subcomponents for Occurrence Code (CNE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


This data type carries data defined by CMS or other regulatory agencies. It corresponds to UB82 Fields 28-32 and UB92 fields 32a, 32b, 33a, 33b, 34a, 34b, 35a, and 35b. Refer to a UB specification for additional information.

Use Case: A Medicare beneficiary was confined in hospital from January 1, 1992 to January 10, 1992, however, his Medicare Part A benefits were exhausted as of January 8, 1992, and he was not entitled to Part B benefits. Therefore, Form Locator 32 should contain code 23 and the date 010892.

Example:

|23&Benefits Exhausted&NUBC^19920108|

OCD-1: Occurrence Code (CNE)

Definition: The NUBC code for the event or occurrence relating to a bill that may affect payer processing.

Refer to HL7-defined Table 0350 – Occurrence Code for valid values.

Values for this component need to come from National Uniform Billing Committee (NUBC). No extensions are allowed.

OCD-2: Occurrence Date (DT)

Definition: The date the event, relating to a bill that may affect payer processing, occurred.

OG - observation grouper

HL7 Component Table - OG - observation grouper
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
OG
1 Original Sub-Identifier [0..1]  20 ST
2 Group [0..1]     NM
3 Sequence [0..1]     NM
4 Identifier [0..1]     ST

Components: <Original Sub-Identifier (ST)> & <Group (NM)> & <Sequence (NM)> & <Identifier (ST)>


OG-1: Original Sub-Identifier (ST)

Definition: The Original Sub-Identifier component represents the original data type used in OBX-4 to enable backwards compatibility to continue use of the original format to provide OBX segment grouping.

OG-2: Group (NM)

Definition: The Group component indicates the group and its sequence within the OBR segment that the OBX segment is a part of.

OG-3: Sequence (NM)

Definition: The Sequence component indicates the sequence within the group as defined in OG-2.

OG-4: Identifier (ST)

Definition: The Identifier component enables assignment of an identifier to a result component, for example an isolate in a microbiology message. Futher guidance on how to use this field will be found in an Implementation Guide.

WITHDRAWN (OSD – order sequence definition)

Attention: The OSD data type was retained for backward compatibility only as of v2.5 and the detail was withdrawn and removed from the standard as of v 2.7. The reader is referred to the TQ1 and TQ2 segments for sequencing levels.

OSP - occurrence span code and date

HL7 Component Table - OSP - occurrence span code and date
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
OSP
1 Occurrence Span Code [1..1]     CNE
2 Occurrence Span Start Date [0..1]   8 DT
3 Occurrence Span Stop Date [0..1]   8 DT

Components: <Occurrence Span Code (CNE)> & <Occurrence Span Start Date (DT)> & <Occurrence Span Stop Date (DT)>

Subcomponents for Occurrence Span Code (CNE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


Use case: The patient was admitted for minor surgery (1/6/03) and discharged the following day (1/7/03). Complications ensured and the patient was readmitted the following day (1/8/03). When the claim for 1/8/03 is filed, the prior stay dates (1/6/03-1/7/03) must be reported (per the Health Plan) using Occurrence Span Code and Dates 71 - Prior Stay Date. Example:

|71&Prior Stay Date&NUBC^20030106^20030107|

OSP-1: Occurrence Span Code (CNE)

Definition: The NUBC code itself that identifies an event that relates to the payment of a claim.

Refer to HL7 Table 0351 – Occurrence Span for valid values. Values for this component need to come from National Uniform Billing Committee (NUBC). No extensions are allowed.

OSP-2: Occurrence Span Start Date (DT)

Definition: The date an event started that relates to the payment of a claim.

OSP-3: Occurrence Span Stop Date (DT)

Definition: The date an event ended that relates to the payment of a claim.

PIP - practitioner institutional privileges

HL7 Component Table - PIP - practitioner institutional privileges
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
PIP
1 Privilege [1..1]     CWE
2 Privilege Class [0..1]     CWE
3 Expiration Date [0..1]   8 DT
4 Activation Date [0..1]   8 DT
5 Facility [0..1]     EI

Components: <Privilege (CWE)> & <Privilege Class (CWE)> & <Expiration Date (DT)> & <Activation Date (DT)> & <Facility (EI)>

Subcomponents for Privilege (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Privilege Class (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Facility (EI): <Entity Identifier (ST)> ^ <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>


PIP-1: Privilege (CWE)

Definition: Specifies the institutional privilege itself. Refer to User-defined Table 0525 – Privilege for suggested values.

PIP-2: Privilege Class (CWE)

Definition: Specifies the class category of institutional privilege. Refer to User-defined Table 0526 – Privilege Class for suggested values.

PIP-3: Expiration Date (DT)

Definition: Specifies the date the institutional privilege is/was no longer valid.

PIP-4: Activation Date (DT)

Definition: Specifies the date the institutional privilege became/becomes valid.

PIP-5: Facility (EI)

Definition: Specifies the facility in which the institutional privilege is/was valid.

PL - person location

HL7 Component Table - PL - person location
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
PL
1 Point of Care [0..1]     HD
2 Room [0..1]     HD
3 Bed [0..1]     HD
4 Facility [0..1]     HD
5 Location Status [0..1]  20 IS
6 Person Location Type [0..1]  20 IS
7 Building [0..1]     HD
8 Floor [0..1]     HD
9 Location Description [0..1] 199 ST
10 Comprehensive Location Identifier [0..1]     EI
11 Assigning Authority for Location [0..1]     HD

Components: <Point of Care (HD)> & <Room (HD)> & <Bed (HD)> & <Facility (HD)> & <Location Status (IS)> & <Person Location Type (IS)> & <Building (HD)> & <Floor (HD)> & <Location Description (ST)> & <Comprehensive Location Identifier (EI)> & <Assigning Authority for Location (HD)>

Subcomponents for Point of Care (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Room (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Bed (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Facility (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Building (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Floor (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Comprehensive Location Identifier (EI): <Entity Identifier (ST)> ^ <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Assigning Authority for Location (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>


Example: Nursing Unit

A nursing unit at Community Hospital: 4 East, room 136, bed B

4E^136^B^CommunityHospital^^N^^^

Example: Clinic

A clinic at University Hospitals: Internal Medicine Clinic located in the Briones building, 3rd floor.

InternalMedicine^^^UniversityHospitals^^C^Briones^3^

Example: Home

The patient was treated at his home.

^^^^^H^^^

PL-1: Point of Care (HD)

Definition: This component specifies the code for the point where patient care is administered. It is conditional on PL.6 Person Location Type (e.g., nursing unit or department or clinic). After floor, it is the most general patient location designation. Refer to User-defined Table 0302 - Point of Care for suggested values.

PL-2: Room (HD)

Definition: This component specifies the code for the patient's room. After point of care, it is the most general person location designation. Refer to User-defined Table 0303 - Room for suggested values.

PL-3: Bed (HD)

Definition: This component specifies the code for the patient's bed. After room, it is the most general person location designation. Refer to User-defined Table 0304 - Bed for suggested values.

PL-4: Facility (HD)

Definition: This component is subject to site interpretation but generally describes the highest level physical designation of an institution, medical center or enterprise. It is the most general person location designation.

See Section 2.A.33, “HD - hierarchic designator” for discussion of data type.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component) may be redefined (given a different user-defined table number and name) by the technical committee responsible for that segment.


PL-5: Location Status (IS)

Definition: This component specifies the code for the status or availability of the location. For example, it may convey bed status. Refer to User-defined Table 0306 - Location Status for suggested values.

PL-6: Person Location Type (IS)

Definition: Person location type is the categorization of the person’s location defined by facility, building, floor, point of care, room or bed. Although not a required field, when used, it may be the only populated field. It usually includes values such as nursing unit, department, clinic, SNF, physician’s office. Refer to User-defined Table 0305 - Person location type for suggested values.

PL-7: Building (HD)

Definition: This component specifies the code for the building where the person is located. After facility, it is the most general person location designation. Refer to User-defined Table 0307 - Building for suggested values.

PL-8: Floor (HD)

Definition: This component specifies the code for the floor where the person is located. After building, it is the most general person location designation. Refer to User-defined Table 0308 - Floor for suggested values.

PL-9: Location Description (ST)

Definition: This component describes the location in free text.

PL-10: Comprehensive Location Identifier (EI)

Definition: The unique identifier that represents the physical location as a whole without regard for the individual components. This accommodates sites that may have a different method of defining physical units or who may code at a less granular level. For example, point of care, room, and bed may be 1 indivisible code.

PL-11: Assigning Authority for Location (HD)

Definition: The entity that creates the data for the individual physical location components. If populated, it should be the authority for all components populated. Refer to User-defined Table 0363 – Assigning Authority for suggested values for the first sub-component of the HD component, <namespace ID>.

This component makes it possible for codes to be differentiated when the field in which this data type is used repeats.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component) may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.

By site agreement, implementors may continue to use User-defined Table 0300 – Namespace ID for the first sub-component.


PLN - practitioner license or other Id number

HL7 Component Table - PLN - practitioner license or other Id number
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
PLN
1 ID Number [1..1]  20 ST
2 Type of ID Number [1..1]     CWE
3 State/other Qualifying Information [0..1]  62 ST
4 Expiration Date [0..1]   8 DT

Components: <ID Number (ST)> & <Type of ID Number (CWE)> & <State/other Qualifying Information (ST)> & <Expiration Date (DT)>

Subcomponents for Type of ID Number (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


PLN-1: ID Number (ST)

Definition: Specifies the license number or other ID number such as UPIN, Medicare and Medicaid number.

PLN-2: Type of ID Number (CWE)

Definition: Specifies the type of number.

Refer to User-defined Table 0338 – Practitioner ID Number Type for suggested values.

PLN-3: State/other Qualifying Information (ST)

Definition: Specifies the state or province in which the license or ID is valid, if relevant, or other qualifying information. It is recommended that state qualifications use the abbreviations from the postal service of the country.

PLN-4: Expiration Date (DT)

Definition: Specifies the date when the license or ID is no longer valid.

PPN - performing person time stamp

HL7 Component Table - PPN - performing person time stamp
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
PPN
1 Person Identifier [0..1]  15 ST
2 Family Name [0..1]     FN
3 Given Name [0..1]  30 ST
4 Second and Further Given Names or Initials Thereof [0..1]  30 ST
5 Suffix [0..1]  20 ST
6 Prefix [0..1]  20 ST
7 Degree [0..1]    
8 Source Table [0..1]     CWE
9 Assigning Authority [0..1]     HD
10 Name Type Code SHALL [0..1] [1..5]     ID
11 Identifier Check Digit [0..1]   4 ST
12 Check Digit Scheme SHALL [0..1] [3..3]     ID
13 Identifier Type Code SHALL [0..1] [1..5]     ID
14 Assigning Facility [0..1]     HD
15 Date/Time Action Performed [0..1]     DTM
16 Name Representation Code SHALL [0..1] [1..1]     ID
17 Name Context [0..1]     CWE
18 Name Validity Range [0..1]    
19 Name Assembly Order SHALL [0..1] [1..1]     ID
20 Effective Date [0..1]     DTM
21 Expiration Date [0..1]     DTM
22 Professional Suffix [0..1] 199 ST
23 Assigning Jurisdiction [0..1]     CWE
24 Assigning Agency or Department [0..1]     CWE
25 Security Check [0..1]   4 ST
26 Security Check Scheme SHALL [0..1] [3..3]     ID

Components: <Person Identifier (ST)> & <Family Name (FN)> & <Given Name (ST)> & <Second and Further Given Names or Initials Thereof (ST)> & <Suffix (ST)> & <Prefix (ST)> & <WITHDRAWN Degree> & <WITHDRAWN Source Table> & <Assigning Authority (HD)> & <Name Type Code (ID)> & <Identifier Check Digit (ST)> & <Check Digit Scheme (ID)> & <Identifier Type Code (ID)> & <Assigning Facility (HD)> & <Date/Time Action Performed (DTM)> & <Name Representation Code (ID)> & <Name Context (CWE)> & <WITHDRAWN Name Validity Range> & <Name Assembly Order (ID)> & <Effective Date (DTM)> & <Expiration Date (DTM)> & <Professional Suffix (ST)> & <Assigning Jurisdiction (CWE)> & <Assigning Agency or Department (CWE)> & <Security Check (ST)> & <Security Check Scheme (ID)>

Subcomponents for Family Name (FN): <Surname (ST)> ^ <Own Surname Prefix (ST)> ^ <Own Surname (ST)> ^ <Surname Prefix from Partner/Spouse (ST)> ^ <Surname from Partner/Spouse (ST)>

Subcomponents for Source Table (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Assigning Authority (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Assigning Facility (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Name Context (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Assigning Jurisdiction (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Assigning Agency or Department (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

This data type is the equivalent of an XCN data type joined with a DTM data type. However, the XCN data type has been flattened to allow legal expression of its embedded complex data types HD, CWE and CWE.

PPN-1: Person Identifier (ST)

Definition: This component carries the Person Identifier itself. PPN.1, in conjunction with PPN.9, uniquely identifies the entity/person.

PPN-2: Family Name (FN)

Definition: This component allows full specification of the surname of a person. Where appropriate, it differentiates the person's own surname from that of the person's partner or spouse, in cases where the person's name may contain elements from either name. It also permits messages to distinguish the surname prefix (such as "van" or "de") from the surname root. See section 2.A.30, "FN – Family Name".

PPN-3: Given Name (ST)

Definition: First name.

PPN-4: Second and Further Given Names or Initials Thereof (ST)

Definition: Multiple middle names may be included by separating them with spaces.

PPN-5: Suffix (ST)

Definition: Used to specify a name suffix (e.g., Jr. or III).

PPN-6: Prefix (ST)

Definition: Used to specify a name prefix (e.g., Dr.).

PPN-7: Degree (PPN)

Attention: The PPN.7 component was deprecated as of v2.5 and the detail was withdrawn and removed from the standard as of v2.7 See PPN.22 - Professional Suffix.

PPN-8: Source Table (CWE)

Attention: Retained for backwards compatibility only as of v2.7 and withdrawn in V2.9. The reader is referred to PPN.9 instead.

PPN-9: Assigning Authority (HD)

Definition: The assigning authority is a unique identifier of the system (or organization or agency of department) that creates the data. It is a HD data type. User-defined Table 0363 – Assigning Authority is used as the HL7 identifier for the user-defined table of values for the first sub-component of the HD component, <namespace ID>.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component) may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.

By site agreement, implementors may continue to use User-defined Table 0300 – Namespace ID for the first sub-component.


Attention: As of v 2.7, the Assigning Authority is conditional. It is required if PPN.1 is populated and neither PPN.23 nor PPN.24 are populated. All 3 components may be populated. No assumptions can be safely made based on position or sequence. Best practice is to send an OID in this component when populated.

The reader is referred to the PPN.23 and the PPN.24 if there is a need to transmit values with semantic meaning for an assigning jurisdiction or assigning department or agency in addition to, or instead of, an assigning authority. However, all 3 components may be valued. If, in so doing, it is discovered that the values in PPN.23 and/or PPN.24 conflict with PPN.9, the user would look to the Message Profile or other implementation agreement for a statement as to which takes precedence.

PPN-10: Name Type Code (ID)

Definition: A code that represents the type of name. Refer to HL7 Table 0200 - Name Type for valid values (see Section 2.A.89, “XPN - extended person name”).

PPN-11: Identifier Check Digit (ST)

Definition: A digit, or digits, exclusive of the identifier in CX.1, calculated by applying an algorithm to all or some of the digits in the number, which may be used to test validity of the non-check-digit identifier.

PPN-12: Check Digit Scheme (ID)

Definition: Contains the code identifying the check digit scheme employed.

Refer to HL7 Table 0061 - Check Digit Scheme for valid values.

PPN-13: Identifier Type Code (ID)

Definition: A code corresponding to the type of identifier. In some cases, this code may be used as a qualifier to the "Assigning authority" component. Refer to HL7 Table 0203 - Identifier Type for suggested values.

PPN-14: Assigning Facility (HD)

Definition: The place or location identifier where the identifier was first assigned to the patient. This component is not an inherent part of the identifier but rather part of the history of the identifier: as part of this data type, its existence is a convenience for certain intercommunicating systems.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component) may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.


PPN-15: Date/Time Action Performed (DTM)

This component describes when the activity was performed.

Note: If this field is not null, both the performing person and the time stamp must be valued.


PPN-16: Name Representation Code (ID)

Definition: Different name/address types and representations of the same name/address should be described by repeating of this field, with different values of the Name/Address Type and/or Name/Address Representation component.

Note: This new component remains in “alphabetic” representation with each repetition of the field using these data types. That is, even though the name may be represented in an ideographic character set, this component will remain represented in an alphabetic character set.


In general this component provides an indication of the representation provided by the data item. It does not necessarily specify the character sets used. Thus, even though the representation might provide an indication of what to expect, the sender is still free to encode the contents using whatever character set is desired. This component provides only hints for the receiver, so it can make choices regarding what it has been sent and what it is capable of displaying.

PPN-17: Name Context (CWE)

Definition: This component is used to designate the context in which a name is used. The main use case is in Australian healthcare: indigenous patients who prefer to use different names when attending different healthcare institutions. Another use case occurs in the US where health practitioners can be licensed under slightly different names and the reporting of the correct name is vital for administrative purposes. Refer to chapter 3, section 3.4.2.6 for more detailed information on how to use this table. Refer to User-defined Table 0448 – Name Context for suggested values.

PPN-18: Name Validity Range (PPN)

Attention: The PPN.18 component was deprecated as of v2.5 and the detail was withdrawn and removed from the standard as of v 2.7. Refer to PPN.20 Effective Date and PPN.21 Expiration Date.

PPN-19: Name Assembly Order (ID)

Definition: A code that represents the preferred display order of the components of this person name. Refer to HL7 Table 0444 – Name Assembly Order for valid values.

PPN-20: Effective Date (DTM)

Definition: The first date, if known, on which the person name is valid and active.

PPN-21: Expiration Date (DTM)

Definition: The last date, if known, on which the person name is valid and active.

PPN-22: Professional Suffix (ST)

Definition: Used to specify an abbreviation, or a string of abbreviations, denoting qualifications that support the person’s profession, (e.g., licenses, certificates, degrees, affiliations with professional societies, etc.). The Professional Suffix normally follows the Family Name when the Person Name is used for display purposes. Please note that this component is an unformatted string and is used for display purposes only. Detailed information regarding the contents of Professional Suffix is obtained using appropriate segments in Chapter 15, "Personnel Management".

PPN-23: Assigning Jurisdiction (CWE)

Definition: The geo-political body that assigned the identifier in component 1.

See section 2.A.14.9, "Assigning Jurisdiction (CWE)" for further detail.

PPN-24: Assigning Agency or Department (CWE)

Definition: The agency or department that assigned the identifier in component 1.

See section 2.A.14.10, "Assigning Agency or Department (CWE)" for further details.

PPN-25: Security Check (ST)

Definition: This component is used to communicate a version code that may be assigned to the value given in PPN.1 - Person Identifier.

PPN-26: Security Check Scheme (ID)

Definition: This component is used to transmit information intended to validate the veracity of the supplied identifier or the presenter of the identifier. For example, this component may be used to ensure that the presenter of a credit card is an authorized user of that card.

Refer to HL7 Table 0904 - Security Check Scheme for valid values.

PRL - parent result link

HL7 Component Table - PRL - parent result link
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
PRL
1 Parent Observation Identifier [1..1]     CWE
2 Parent Observation Sub-identifier [0..1]  20 ST
3 Parent Observation Value Descriptor [0..1]     TX

Components: <Parent Observation Identifier (CWE)> & <Parent Observation Sub-identifier (ST)> & <Parent Observation Value Descriptor (TX)>

Subcomponents for Parent Observation Identifier (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


PRL-1: Parent Observation Identifier (CWE)

Definition: Contains the unique identifier of the parent observation as defined in the OBX-3 of the parent result. The value is the same as the OBX-3 of the parent.

PRL-2: Parent Observation Sub-identifier (ST)

Definition: Contains the sub-ID of the parent result as defined in the OBX-4 of the parent result. The value is the same as the OBX-4 of the parent.

PRL-3: Parent Observation Value Descriptor (TX)

Definition: Contains a descriptor of the parent observation value as specified in the OBX-5 of the parent result.

As an example, the third component may be used to record the name of the microorganism identified by the parent result directly. The organism in this case should be identified exactly as it is in the parent culture.

PT - processing type

HL7 Component Table - PT - processing type
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
PT
1 Processing ID SHALL [1..1] [1..1]     ID
2 Processing Mode SHALL [0..1] [1..1]     ID

Components: <Processing ID (ID)> & <Processing Mode (ID)>

Definition: This data type indicates whether to process a message as defined in HL7 Application (level 7) Processing rules.

PT-1: Processing ID (ID)

Definition: A value that defines whether the message is part of a production, training, or debugging system. Refer to HL7 Table 0103 - Processing ID for valid values.

PT-2: Processing Mode (ID)

Definition: A value that defines whether the message is part of an archival process or an initial load. Refer to HL7 Table 0207 - Processing Mode for valid values.

PTA - policy type and amount

HL7 Component Table - PTA - policy type and amount
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
PTA
1 Policy Type [1..1]     CWE
2 Amount Class [0..1]     CWE
3 Money or Percentage Quantity [0..1]    
4 Money or Percentage [1..1]     MOP

Components: <Policy Type (CWE)> & <Amount Class (CWE)> & <WITHDRAWN Money or Percentage Quantity> & <Money or Percentage (MOP)>

Subcomponents for Policy Type (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Amount Class (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Money or Percentage (MOP): <Money or Percentage Indicator (ID)> ^ <Money or Percentage Quantity (NM)> ^ <Monetary Denomination (ID)>


PTA-1: Policy Type (CWE)

Definition: Specifies the policy type.

Refer to User-defined Table 0147 - Policy Type for suggested values.

PTA-2: Amount Class (CWE)

Definition: Specifies the amount quantity class.

Refer to User-defined Table 0193 - Amount Class for suggested values.

PTA-3: Money or Percentage Quantity (PTA)

Attention: The PTA.3 component was deprecated as of v2.5 and the detail was withdrawn and removed from the standard as of v 2.7. Refer to PTA.4 instead.

PTA-4: Money or Percentage (MOP)

Definition: specifies an amount that may be either currency or a percentage.

QIP - query input parameter list

HL7 Component Table - QIP - query input parameter list
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
QIP
1 Segment Field Name SHALL [1..1] [6..12]     ST
2 Values [1..1] 199 ST

Components: <Segment Field Name (ST)> & <Values (ST)>

Definition: This data type contains a segment field name and the list of values to be passed to the query processor.

Example:

|@PID.5.1^EVANS|

QIP-1: Segment Field Name (ST)

Definition: This component contains the segment field name.

Naming conventions:

Segment field names are designated by the “@” symbol concatenated with the HL7 segment ID followed by the sequence number for the field separated by a period. See sections 2.5.2, "Segments and segment groups" and 2.5.3.1, "Position (sequence within the segment)" for a definition of segment ID and sequence number. If the field is divided into components, the designation may be suffixed with ".nn", to identify a particular component (a suffix of “.3” indicates the third component of the field); otherwise, the whole field is assumed. If the field is further divided into subcomponents, the designation is suffixed with “.nn.mm", which identifies the component and subcomponent requested by relative position.

Site-specific segment field names may be used. In this case, the site-specific segment ID (if the field is not being added to an existing HL7 segment) and the sequence number must be defined so that they do not conflict with existing HL7 segment IDs and field sequence numbers.

Values for this field are defined in the function-specific chapters of this specification.

Note: If the “@” is being used as one of the delimiter characters defined in MSH-2-encoding characters, it must be “escaped.” See Section 2.7.1, "Formatting Codes".


QIP-2: Values (ST)

Definition: This component contains the field value or values in the form "value1& value2 & value3..."

A single-valued parameter contains only a single subcomponent in the second component, thus no subcomponent delimiters are needed (e.g., <segment field name> ^ <value>). A simple list of values (i.e., a one-dimensional array) may be passed instead of a single value by separating each value with the subcomponent delimiter (e.g., <segment field name> ^ <value1 & value2 &...>).

QSC - query selection criteria

HL7 Component Table - QSC - query selection criteria
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
QSC
1 Segment Field Name [1..1]     ST
2 Relational Operator SHALL [0..1] [2..2]     ID
3 Value [0..1] 199 ST
4 Relational Conjunction SHALL [0..1] [3..3]     ID

Components: <Segment Field Name (ST)> & <Relational Operator (ID)> & <Value (ST)> & <Relational Conjunction (ID)>


Example:

|@PID.5.1^EQ^EVANS|

QSC-1: Segment Field Name (ST)

Definition: The name of the field that is participating as a qualifier (usually the "key"). Refer to Section 2.A.59.1, “Segment Field Name (ST),” for segment field name conventions.

QSC-2: Relational Operator (ID)

Definition: Refer to HL7 Table 0209 - Relational Operator for valid values.

QSC-3: Value (ST)

Definition: The value to which the field will be compared.

QSC-4: Relational Conjunction (ID)

Definition: Refer to HL7 Table 0210 - Relational Conjunction for valid values. The relational conjunction is defined as follows: If more than one comparison is to be made to select qualifying rows, a conjunction relates this repetition of the field to the next.

  • When applied to strings, the relational operators LT, GT, LE, and GE imply an alphabetic comparison.

  • A "generic" comparison selects a record for inclusion in the response when the beginning of the designated field matches the select string.

  • Where a repeating field is specified as an operand, a match on any instance of that field qualifies the row for inclusion in the response message.

  • AND takes precedence over OR. More sophisticated precedence rules require that the query be expressed as an embedded query language message or a stored procedure query message (see Chapter 5, "Query").

RCD - row column definition

HL7 Component Table - RCD - row column definition
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
RCD
1 Segment Field Name SHALL [0..1] [6..12]     ST
2 HL7 Data Type SHALL [0..1] [2..3]     ID
3 Maximum Column Width SHALL [0..1] [1..5]     NM

Components: <Segment Field Name (ST)> & <HL7 Data Type (ID)> & <Maximum Column Width (NM)>

Definition: This specifies the format of a column in terms of a segment field name, a data type, and a maximum length.

Example: This defines a column containing the value of the "last name" component of PID-5, expressed as a ST data type with a maximum width of 20.

|@PID.5.1^ST^20|

RCD-1: Segment Field Name (ST)

Definition: The HL7 segment field name, which identifies the field occupying the column. Refer to Section 2.A.59.1, "Segment Field Name (ST)," for segment field name definition conventions.

RCD-2: HL7 Data Type (ID)

Definition: The two or three character HL7 data type. Refer to HL7 Table 0440 – Data Types for valid values.

RCD-3: Maximum Column Width (NM)

Definition: The maximum width of the column, as dictated by the responding system. This may vary from the HL7-defined maximum field length.

RFR - reference range

HL7 Component Table - RFR - reference range
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
RFR
1 Numeric Range [1..1]     NR
2 Administrative Sex [0..1]     CWE
3 Age Range [0..1]     NR
4 Gestational Age Range [0..1]     NR
5 Species [0..1]  20 ST
6 Race/subspecies [0..1]  20 ST
7 Conditions [0..1]     TX

Components: <Numeric Range (NR)> & <Administrative Sex (CWE)> & <Age Range (NR)> & <Gestational Age Range (NR)> & <Species (ST)> & <Race/subspecies (ST)> & <Conditions (TX)>

Subcomponents for Numeric Range (NR): <Low Value (NM)> ^ <High Value (NM)>

Subcomponents for Administrative Sex (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Age Range (NR): <Low Value (NM)> ^ <High Value (NM)>

Subcomponents for Gestational Age Range (NR): <Low Value (NM)> ^ <High Value (NM)>


Examples:

  1. A range that applies unconditionally, such as albumin, is transmitted as:

|3.0&5.5|

  1. A normal range that depends on sex, such as Hgb, is transmitted as:

|13.5&18^M~12.0 & 16^F|

  1. A normal range that depends on age, sex, and race (a concocted example) is:

|10&13^M^0&2^^^B11&13.5^M^2&20^^^B~12&14.5^M^20&70^^^B~13&16.0^M^70&^^^B|

When no value is specified for a particular component, the range given applies to all categories of that component. For example, when nothing is specified for race/species, the range should be taken as the human range without regard to race. If no age range is specified, the normal range given is assumed to apply to all ages.

RFR-1: Numeric Range (NR)

Definition: This component specifies the numeric interval of the reference data. Range is taken to be inclusive (i.e., the range includes the end points). Units are context sensitive and are defined in the usage note for the field where this data type is used.

RFR-2: Administrative Sex (CWE)

Definition: This component specifies which gender for which the reference range is valid. Refer to User-defined Table 0001 – Administrative Sex in Chapter 2C, section 3.4.2.8, "Administrative Sex" for suggested values.

RFR-3: Age Range (NR)

Definition: This component specifies the age range for which the reference range is valid. Ages of less than one year should be specified as a fraction (e.g., 1 month = 0.0830, 1 week = 0.01920, 1 day = 0.0027300). However, for most purposes involving infants, the gestational age (measured in weeks) is preferred. The lower end of the range is not indicated; the upper end is, assuring that series of ranges do not overlap.

RFR-4: Gestational Age Range (NR)

Definition: This component specifies the gestational age range for which the reference range is valid. Gestational age is relevant only when the reference range is influenced by the stage of pregnancy. The gestational age is measured in weeks from conception. For example, |1&4| implies that the normals apply to gestational ages from 1 week to 4 weeks inclusive. The lower end of the range is not included; the upper end is, assuring that series of age ranges do not overlap.

RFR-5: Species (ST)

Definition: This component specifies the species for which the reference range is valid. Species is assumed to be human unless otherwise stated. Example values are rabbit, mouse, and rat.

RFR-6: Race/subspecies (ST)

Definition: This component specifies the race or subspecies for which the reference range is valid. In the case of humans (the default species), the race is specified when race influences the reference range. When normal ranges for animals are being described, this component can be used to describe subspecies or special breeds of animals.

RFR-7: Conditions (TX)

Definition: This component specifies any arbitrary condition for which the reference range is valid. This may include such conditions as phase of menstrual cycle or dose of a particular drug. It is provided as a way to communicate the normal ranges for special conditions. It does not allow automatic checking of these text conditions.

RI - repeat interval

HL7 Component Table - RI - repeat interval
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
RI
1 Repeat Pattern [0..1]     CWE
2 Explicit Time Interval [0..1] 199 ST

Components: <Repeat Pattern (CWE)> & <Explicit Time Interval (ST)>

Subcomponents for Repeat Pattern (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


RI-1: Repeat Pattern (CWE)

Definition: The repeating frequency with which the treatment is to be administered. It is similar to the frequency and SIG code tables used in order entry systems.

Refer to User-defined Table 0335 - Repeat Pattern for suggested values.

The first component may repeat, with repeat values separated by a space. The repeats are interpreted as connected by logical ANDs.

Example:

    Twice per day, every other day: BID QOD

    Three times per day, Monday Wednesday and Friday: TID QJ135

Because of this syntax, repeat values should never contain blanks.

RI-2: Explicit Time Interval (ST)

Definition: This component explicitly lists the actual times referenced by the code in the first component, in the following format: HHMM,HHMM,HHMM,.... This second component will be used to clarify the first component in cases where the actual times vary within an institution. If the time of the order spans more than a single day, this new component is only practical if the same times of administration occur for each day of the order. If the actual start time of the order (as given by the fourth component of the quantity/timing field) is after the first explicit time, the first administration is taken to be the first explicit time after the start time. In the case where the patient moves to a location having a different set of explicit times, the existing order may be updated with a new quantity/timing field showing the changed explicit times.

Example: 2nd component of quantity/timing field:

|QID^0230,0830,1430,2030|

RMC - room coverage

HL7 Component Table - RMC - room coverage
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
RMC
1 Room Type [1..1]     CWE
2 Amount Type [0..1]     CWE
3 Coverage Amount [0..1]    
4 Money or Percentage [1..1]     MOP

Components: <Room Type (CWE)> & <Amount Type (CWE)> & <WITHDRAWN Coverage Amount> & <Money or Percentage (MOP)>

Subcomponents for Room Type (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Amount Type (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Money or Percentage (MOP): <Money or Percentage Indicator (ID)> ^ <Money or Percentage Quantity (NM)> ^ <Monetary Denomination (ID)>


RMC-1: Room Type (CWE)

Definition: Specifies the room type.

Refer to User-defined Table 0145 - Room Type for suggested values.

RMC-2: Amount Type (CWE)

Definition: Specifies amount quantity type.

Refer to User-defined Table 0146 – Amount Type for suggested values.

RMC-3: Coverage Amount (RMC)

Attention: The PTA.3 component was deprecated as of v2.5 and the detail was withdrawn and removed from the standard as of v2.7. Refer to 2.A.64.4, "Money or Percentage".

RMC-4: Money or Percentage (MOP)

Definition: specifies an amount that may be either currency or a percentage.

RP - reference pointer

HL7 Component Table - RP - reference pointer
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
RP
1 Pointer [0..1] 999 ST
2 Application ID [0..1]     HD
3 Type of Data SHALL [0..1] [4..11]     ID
4 Subtype [0..1]     ID

Components: <Pointer (ST)> & <Application ID (HD)> & <Type of Data (ID)> & <Subtype (ID)>

Subcomponents for Application ID (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Definition: This data type transmits information about data stored on another system. It contains a reference pointer that uniquely identifies the data on the other system, the identity of the other system, and the type of data.

RP-1: Pointer (ST)

Definition: A key to the referenced data assigned by the system that stores the data. The key, which is an ST data type, is used to identify and access the data, either as an object identifier, or as a hierarchical name or query string.

RP-2: Application ID (HD)

Definition: A unique designator of the system that stores the data. It is an HD data type (See Section 2.A.33, "HD - hierarchic designator"). Application ID’s must be unique across a given HL7 implementation.

Usage Note: The Application ID together with the Pointer may form a Uniform Resource Identifier (URI) in accordance with RFC 2396. In this case the Application ID shall include the Scheme and Authority parts of the URI, and the Path part if that points to an application. The Pointer shall include the Query part of the URI, or the Path part if that points to an object. All delimiters between URI parts (“:”, “/”, “?”) should be included in the components.

Referenced data may be obtained by a mechanism not defined in the HL7 standard. The Scheme part of a URI in the Application ID specifies the access protocol, e.g., HTTP or FTP.

Example 1: A CDA document accessed by FTP:

|/cdasvc/u28864099/s9076500a/e77534/d55378.xml^&ftp://www.saintelsewhere.org&URI^text^x-hl7-cda-level-one|

Example 2: A DICOM image accessed by HTTP and converted to JPEG (using the ISO/DICOM WADO standard);

Note: the ampersands in the Pointer string are escaped to “\T\” to avoid conflict with the sub-component delimiter:

|?requestType=WADO\T\study=1.2.840.113848.5.22.9220847989\T\series=1.2.840.113848.5.22.922084798.4\T\object=1.2.840.113848.5.22.922084798.4.5^&https://www.pacs.poupon.edu/wado.jsp&URI^image^jpeg|


RP-3: Type of Data (ID)

Definition: An ID data type that declares the general type of data. Refer to Imported Table 0834 – MIME Types for valid values. Table 0834 comprises the values of MIME media types established in accordance with RFC 2046 (http://ietf.org/rfc/rfc2046.txt) and registered with the Internet Assigned Numbers Authority (http://www.iana.org/numbers.html).

Note: The MIME media type values are case-insensitive, in accordance with RFC 2045.

Note: HL7 Table 0191- Type of Referenced Data is retained for backward compatibility as of v 2.6.


RP-4: Subtype (ID)

Definition: An ID data type declaring the format for the referenced. Refer to Externally-defined Table 0291 – Subtype of Referenced Data for valid values. Table 0291 comprises the values of MIME media subtypes established in accordance with RFC 2046 (http://ietf.org/rfc/rfc2046.txt) and registered with the Internet Assigned Numbers Authority (http://www.iana.org/numbers.html).

Note: the MIME media subtype values are case-insensitive, in accordance with RFC 2045.


HL7 approved "standard" extensions as defined in table 0291 are allowed.

Additional subtypes may be added to this Standard. All subtypes registered by IANA may be used by implementation agreement between cooperating parties. In addition, private, non-standard subtypes may be defined by agreement between cooperating parties. All private, non-standard subtypes should begin with the character combination “X-” to distinguish them from the standard subtypes, in accordance with RFC 2045.

RPT - repeat pattern

HL7 Component Table - RPT - repeat pattern
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
RPT
1 Repeat Pattern Code [1..1]     CWE
2 Calendar Alignment SHALL [0..1] [2..2]     ID
3 Phase Range Begin Value [0..1]  10 NM
4 Phase Range End Value [0..1]  10 NM
5 Period Quantity [0..1]  10 NM
6 Period Units [0..1]     CWE
7 Institution Specified Time SHALL [0..1] [1..1]     ID
8 Event SHALL [0..1] [2..3]     ID
9 Event Offset Quantity [0..1]  10 NM
10 Event Offset Units [0..1]     CWE
11 General Timing Specification [0..1]     GTS

Components: <Repeat Pattern Code (CWE)> & <Calendar Alignment (ID)> & <Phase Range Begin Value (NM)> & <Phase Range End Value (NM)> & <Period Quantity (NM)> & <Period Units (CWE)> & <Institution Specified Time (ID)> & <Event (ID)> & <Event Offset Quantity (NM)> & <Event Offset Units (CWE)> & <General Timing Specification (GTS)>

Subcomponents for Repeat Pattern Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Period Units (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Event Offset Units (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Definition: The repeat pattern data type should be used where it is necessary to define the frequency at which an event is to take place. This data type provides a way to define repeat pattern codes "on the fly". The repeat pattern code is equivalent to the TQ data type, component 2, sub-component 1 (repeat pattern). The additional components define the meaning of the repeat pattern code. Components 2 - 10 are used to define relatively simple repeat patterns. Component 11 is provided to define complex repeat patterns. This data type forms a bridge between the 2.x Repeat Pattern concept from Quantity/Timing, and the Version 3.0 GTS General Timing Specification. Component 1 is the 2.x concept of repeat pattern. Components 2-7 are derived from the version 3.0 data type PIVL. Components 8-10 are derived from the version 3.0 EIVL data type. If a repeat pattern cannot be defined using components 2-10, then component 11, General Timing Specification is provided. This allows the full literal form of the version 3.0 GTS to be specified.

When using the RPT, if an application doesn't recognize the code in component 1, then it may attempt to determine the appropriate frequency using the remaining components. If the application does recognize the code in component 1, the application is not required to determine the frequency from the remaining components.

Use Case: The use case supporting this proposal is the need to define repeat patterns on the fly while placing an order. The TQ data type did not have the capability to define the meaning of a repeat pattern on the fly. To get around this problem, vendors have implemented a variety of solutions to solve this issue. One way was to add Z-components to the TQ data type to transmit information about the repeat pattern. Another solution was to attempt to parse the repeat pattern code in an attempt to decipher what the code meant.

Examples:

|Q1H&Every 1 Hour&HL7xxx^^^^1^h|

|Q2J2&Every second Tuesday&HL7xxx^DW^2^^2^wk|

|BID&Twice a day at institution specified times&HL7xxx^^^^12^h^Y|

|QAM&Every morning at the institution specified time&HL7xxx^HD^00^11^1^d^Y|

|QHS&Every day before the hours of sleep&HL7xxx^^^^1^d^^AHS|

|ACM&Before Breakfast&HL7xxx^^^^^^^ACM|

RPT-1: Repeat Pattern Code (CWE)

Definition: A code representing the repeat pattern defined by the other components of this data type. Refer to User-defined Table 0335 – Repeat Pattern for suggested values.

RPT-2: Calendar Alignment (ID)

Definition: Specifies an alignment of the repetition to a calendar (e.g., to distinguish every 30 days from “the 5th of every month”). Refer to HL7 Table 0527 - Calendar Alignment for valid values.

RPT-3: Phase Range Begin Value (NM)

Definition: Used for Calendar aligned repeat patterns to determine the amount of time from the beginning of particular RPT.2 - Calendar Alignment to the beginning of the phase. If Calendar Alignment is DW (days of week), then this would be the offset from the beginning of the week.

If Phase Range Begin Value is populated, but Phase Range End Value is not populated, then this component defines when the period (RPT.5, 6) begins.

If both Phase Range Begin Value and Phase Range End Value are populated, then this component defines the earliest point in time at which the period (RPT.5, 6) will begin.

The units of measure for this component are derived from the Calendar Alignment value in RPT.2. See HL7 Table 0527 - Calendar Alignment for the units of measure associated with a particular calendar alignment.

RPT-4: Phase Range End Value (NM)

Definition: Used for Calendar aligned repeat patterns to determine the amount of time from the beginning of particular RPT.2 - Calendar Alignment to the end of the phase.

If Phase Range End Value is populated, but Phase Range Begin Value is not populated, then this component defines when the timing period (RPT.5, 6) begins.

If both Phase Range Begin Value and Phase Range End Value are populated, then this component defines the latest point in time at which the period (RPT.5, 6) will begin.

The units of measure for this component are derived from the Calendar Alignment value in RPT.2. See HL7 Table 0527 - Calendar Alignment for the units of measure associated with a particular calendar alignment.

RPT-5: Period Quantity (NM)

Definition: A time duration specifying the frequency at which the periodic interval repeats. RPT.6 - Period Units defines the units of time for this component.

RPT-6: Period Units (CWE)

Definition: Defines the units used for RPT.5 - Period Quantity. Constrained to units of time. Best practice is to use UCUM. Refer to External table the Unified Code for Units of Measure (UCUM) [http://aurora.rg.iupui.edu/UCUM] for valid values.

Condition Rule: This component is required if RPT.5 - Period Quantity is populated.

RPT-7: Institution Specified Time (ID)

Definition: A code that indicates whether the exact timing is up to the party executing the schedule (e.g., to distinguish “every 8 hours” from “3 times a day”). Refer to HL7 Table 0136 - Yes/No Indicator for valid values.

  • Y - exact timing up to party executing schedule.

  • N - exact timing as specified.

RPT-8: Event (ID)

Definition: A code for a common (periodical) activity of daily living. Refer to HL7 Table 0528 - Event-Related Period for valid values.

RPT-9: Event Offset Quantity (NM)

Definition: An interval that marks the offsets for the beginning, width and end of the event-related periodic interval measured from the time each such event actually occurred. A positive numeric value indicates the amount of time after the event in RPT.8. A negative numeric value indicates the amount of time prior to the event in RPT.8. RPT.10 - Event Offset Units defines the units of time for this component.

Usage Note: This component should not be valued unless there is a value in RPT-8 (Event).

RPT-10: Event Offset Units (CWE)

Definition: Defines the units used for RPT-9 (Event Offset Quantity). Constrained to units of time. The codes for unit of measure are specified in the Unified Code for Units of Measure (UCUM) [http://aurora.rg.iupui.edu/UCUM].

Condition Rule: This component is required if RPT.9 - Event Offset Quantity is populated.

RPT-11: General Timing Specification (GTS)

Definition: The General Timing Specification as defined by the Version 3 Data Types document.

SAD - street address

HL7 Component Table - SAD - street address
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
SAD
1 Street or Mailing Address [0..1] 120 ST
2 Street Name [0..1]  50 ST
3 Dwelling Number [0..1]  12 ST

Components: <Street or Mailing Address (ST)> & <Street Name (ST)> & <Dwelling Number (ST)>


SAD-1: Street or Mailing Address (ST)

Definition: This component specifies the street or mailing address of a person or institution. When referencing an institution, this first component is used to specify the institution name. When used in connection with a person, this component specifies the first line of the address.

SAD-2: Street Name (ST)

SAD-3: Dwelling Number (ST)

SCV - scheduling class value pair

HL7 Component Table - SCV - scheduling class value pair
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
SCV
1 Parameter Class [0..1]     CWE
2 Parameter Value [0..1]  20 ST

Components: <Parameter Class (CWE)> & <Parameter Value (ST)>

Subcomponents for Parameter Class (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Definition: This data type is used to communicate parameters and preferences to the filler application regarding the selection of an appropriate time slot, resource, location, or filler override criterion for an appointment.

For use only with the scheduling chapter.

SCV-1: Parameter Class (CWE)

Definition: The first component of this field is a code identifying the parameter or preference being passed to the filler application. Refer to User-defined Table 0294 - Time Selection Criteria Parameter Class Codes for suggested values.

SCV-2: Parameter Value (ST)

Definition: 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 following parameter class codes and valid data sets.

SI - sequence ID

HL7 Component Table - SI - sequence ID
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
SI
1 Sequence ID SHALL [0..1] [1..4]   4

This allows for a number between 0 and 9999 to be specified.

SN - structured numeric

HL7 Component Table - SN - structured numeric
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
SN
1 Comparator SHALL [0..1] [1..2]     ST
2 Num1 [0..1]     NM
3 Separator/Suffix SHALL [0..1] [1..1]     ST
4 Num2 [0..1]     NM

Components: <Comparator (ST)> & <Num1 (NM)> & <Separator/Suffix (ST)> & <Num2 (NM)>

Definition: The structured numeric data type is used to unambiguously express numeric clinical results along with qualifications. This enables receiving systems to store the components separately, and facilitates the use of numeric database queries. The corresponding sets of values indicated with the <comparator> and <separator/suffix> components are intended to be the authoritative and complete set of values. If additional values are needed for the <comparator> and <separator/suffix> components, they should be submitted to HL7 for inclusion in the Standard.

If <num1> and <num2> are both non-null, then the separator/suffix must be non-null. If the separator is "-", the data range is inclusive; e.g., <num1> - <num2> defines a range of numbers x, such that: <num1> <=x<= <num2>.

SN-1: Comparator (ST)

Definition: Defined as greater than, less than, greater than or equal, less than or equal, equal, and not equal, respectively ( ">" or "<" or ">=" or "<=" or "=" or "<>").

If this component is not valued, it defaults to equal ("=").

SN-2: Num1 (NM)

Definition: A number.

SN-3: Separator/Suffix (ST)

Definition: "-" or "+" or "/" or ":"

Examples:

|>^100|

(greater than 100)

|^100^-^200|

(equal to range of 100 through 200)

|^1^:^228|

(ratio of 1 to 128, e.g., the results of a serological test)

|^2^+|

(categorical response, e.g., occult blood positivity)


Note: The value "." has been deprecated as of version 2.9 and will be withdrawn after two versions.


SN-4: Num2 (NM)

Definition: A number or null depending on the measurement.

SNM - string of telephone number digits

HL7 Component Table - SNM - string of telephone number digits
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
SNM
1 String of telephone number digits SHALL [0..1] [1..]    

SNM is used for telephone numbers, so it is never appropriate to truncate values of type SNM.

SPD - specialty description

HL7 Component Table - SPD - specialty description
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
SPD
1 Specialty Name [1..1]  50 ST
2 Governing Board [0..1]  50 ST
3 Eligible or Certified SHALL [0..1] [1..1]     ID
4 Date of Certification [0..1]     DT

Components: <Specialty Name (ST)> & <Governing Board (ST)> & <Eligible or Certified (ID)> & <Date of Certification (DT)>


SPD-1: Specialty Name (ST)

Definition: Identifies the provider’s specialty.

SPD-2: Governing Board (ST)

Definition: Identifies the governing body providing for the specialty.

SPD-3: Eligible or Certified (ID)

Definition: Specifies the certification status. Refer to HL7 Table 0337 – Certification Status for valid values.

SPD-4: Date of Certification (DT)

Definition: Specifies when certification occurred.

WITHDRAWN (SPS – specimen source)

Attention: The SPS data type was retained for backward compatibility only as of v 2.5 and the detail was withdrawn and removed from the standard as of v 2.7. The reader is referred to the SPM segment in Chapter 7, "Observations".

SRT - sort order

HL7 Component Table - SRT - sort order
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
SRT
1 Sort-by Field SHALL [1..1] [6..12]     ST
2 Sequencing SHALL [0..1] [1..2]     ID

Components: <Sort-by Field (ST)> & <Sequencing (ID)>

Definition: Specifies those parameters by which the response will be sorted and by what method.

Example: In a tabular response query, where the return data is known by column name, the SRT might look like:

|LastName^A~FirstName^A|

Example: In a segment response query, where the return data is known by segment and offset, the SRT field would use segment field name notation:

|PID.3.1^A~PID.3.2|

SRT-1: Sort-by Field (ST)

Definition: Identifies the field by which the response will be sorted. In a tabular response, this will be the column name to sort by. In the Segment Pattern and the Display Response, this will be the segment field name to sort by. See QIP in Section 2.A.59.1, "Segment Field Name (ST)" for segment field name definition.

See Chapter 5, "Query", for a complete discussion of queries and their responses.

SRT-2: Sequencing (ID)

Definition: Identifies how the field or parameter will be sorted; and, if sorted, whether the sort will be case sensitive (the default) or not. Refer to HL7 Table 0397 – Sequencing for valid values

ST - string data

TM - time

HL7 Component Table - TM - time
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
TM
1 Time SHALL [0..1] [2..16]  13

The time zone of the sender may be sent optionally as an offset from the coordinated universal time (previously known as Greenwich Mean Time). Where the time zone is not present in a particular TM field but is included as part of the date/time field in the MSH segment, the MSH value will be used as the default time zone. Otherwise, the time is understood to refer to the local time of the sender.

Examples:

Time

Description

|0000|

midnight

|235959+1100|

1 second before midnight in a time zone eleven hours ahead of Universal Coordinated Time (i.e., East of Greenwich).

|0800|

Eight AM, local time of the sender.

|093544.2312|

44.2312 seconds after Nine thirty-five AM, local time of sender.

|13|

1pm (with a precision of hours), local time of sender.


Prior to v 2.3, this data type was specified in the format HHMM[SS[.SSSS]][+/-ZZZZ]. As of v 2.3 minutes are no longer required. By site-specific agreement, HHMM[SS[.SSSS]][+/-ZZZZ] may be used where backward compatibility must be maintained.This corresponds a minimum length of 4.

The TM data type does not follow the normal truncation pattern, and the truncation character is never valid in the TM data type. Instead, the truncation behavior is based on the semantics of times.

Unless otherwise specified in the context where the DTM type is used, the DTM type may be truncated to a particular minute. When a TM is truncated, the truncated form SHALL still be a valid TM type. Refer to Chapter 2, section 2.5.5.2, "Truncation Pattern", for further information.

WITHDRAWN (TQ – timing/quantity)

Attention: The TQ data type was retained for backward compatibility only as of v 2.5 and the detail was withdrawn and removed from the standard as of v 2.7. The reader is referred to the TQ1 and TQ2 segments in Chapter 4, "Order Entry".

WITHDRAWN (TS – timestamp)

Attention: The TS data type has been replaced by the DTM data type and the detail was withdrawn and removed from the standard as of v 2.6.

TX - text data

HL7 Component Table - TX - text data
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
TX
1 Text Data [0..1]    

Definition: String data meant for user display (on a terminal or printer). Such data would not necessarily be left justified since leading spaces may contribute greatly to the clarity of the presentation to the user. Because this type of data is intended for display, it may contain certain escape character sequences designed to control the display. Escape sequence formatting is defined in Section 2.7, "Use of escape sequences in text fields". Leading spaces should be included. Trailing spaces should be removed.

Example:

| leading spaces are allowed.|

Since TX data is intended for display purposes, the repeat delimiter, when used with a TX data field, implies a series of repeating lines to be displayed on a printer or terminal. Therefore, the repeat delimiters are regarded as paragraph terminators or hard carriage returns (e.g., they would display as though a CR/LF were inserted in the text (DOS type system) or as though a LF were inserted into the text (UNIX style system)).

A receiving system would word-wrap the text between repeat delimiters in order to fit it into an arbitrarily sized display window but start any line beginning with a repeat delimiter on a new line.

To include alternative character sets, use the appropriate escape sequence. See Chapter 2, section 2.14.9.18, "MSH-18 - Character Set" and section 2.14.9.20, "MSH-20 - Alternate Character Set Handling Scheme".

This specification applies no limit to the length of the TX data type, either here where the data type is defined, or elsewhere where the data type is used. While there is no intrinsic reason to limit the length of this data type for semantic or syntactical reasons, it is expected that some sort of limitation will be imposed for technical reasons in implementations. HL7 recommends that implementation length limits be published in implementation profiles.

UVC - UB value code and amount

HL7 Component Table - UVC - UB value code and amount
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
UVC
1 Value Code [1..1]     CWE
2 Value Amount [0..1]     MO
3 Non-Monetary Value Amount / Quantity [0..1]     NM
4 Non-Monetary Value Amount / Units [0..1]     CWE

Components: <Value Code (CWE)> & <Value Amount (MO)> & <Non-Monetary Value Amount / Quantity (NM)> & <Non-Monetary Value Amount / Units (CWE)>

Subcomponents for Value Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Value Amount (MO): <Quantity (NM)> ^ <Denomination (ID)>

Subcomponents for Non-Monetary Value Amount / Units (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


The most common semi-private room rate is used in instances where the patient is placed in a private room at their request but their insurance only covers a semi-private room rate, which can be calculated using the 01-most common semi-private room rate.

Example:

|01&most common semi private rate&NUBC^750&USD|

UVC-1: Value Code (CWE)

Definition: Specifies the National Uniform Billing Committee (NUBC) code itself.

Refer to External Table 0153 – Value Code for valid values. In the United States, values for this component need to come from National Uniform Billing Committee (NUBC); no extensions are allowed.

Other realms should determine the precise set appropriate for their realm.

UVC-2: Value Amount (MO)

Definition: Specifies the numeric amount when needed to pair with the value when it is monetary.

UVC-3: Non-Monetary Value Amount / Quantity (NM)

Definition: Specifies the numeric amount when needed to pair with the value when it is non-monetary.

UVC-4: Non-Monetary Value Amount / Units (CWE)

Definition: This component species the units in which the non-monetary quantity is expressed. Refer to the Unified Code for Units of Measure (UCUM) for valid values [http://aurora.rg.iupui.edu/UCUM].

VH - visiting hours

HL7 Component Table - VH - visiting hours
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
VH
1 Start Day Range SHALL [0..1] [3..3]     ID
2 End Day Range SHALL [0..1] [3..3]     ID
3 Start Hour Range [0..1]     TM
4 End Hour Range [0..1]     TM

Components: <Start Day Range (ID)> & <End Day Range (ID)> & <Start Hour Range (TM)> & <End Hour Range (TM)>

Definition: This data type contains the hours when a patient location is open for visiting. Refer to HL7 Table 0267 - Days of the Week for valid values for the first two components.

VH-1: Start Day Range (ID)

Definition: Starting day of visiting hours range. See HL7 Table 0267 - Days of the Week for valid values.

VH-2: End Day Range (ID)

Definition: Ending day of visiting hours range. Starting day of visiting hours range. See HL7 Table 0267 - Days of the Week for valid values.

VH-3: Start Hour Range (TM)

Definition: Starting hour on starting day of visiting hours range. See first component, 2.A.81.1, "Start Day Range (ID)".

VH-4: End Hour Range (TM)

Definition: Ending hour on ending day of visiting hours range. See second component, 2.A.81.2, "End Day Range (ID)".

VID - version identifier

HL7 Component Table - VID - version identifier
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
VID
1 Version ID SHALL [1..1] [3..5]     ID
2 Internationalization Code [0..1]     CWE
3 International Version ID [0..1]     CWE

Components: <Version ID (ID)> & <Internationalization Code (CWE)> & <International Version ID (CWE)>

Subcomponents for Internationalization Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for International Version ID (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

VID-1: Version ID (ID)

Definition: Used to identify the HL7 version. Refer to HL7 Table 0104 - Version ID in Chapter 2C for valid values.

VID-2: Internationalization Code (CWE)

Definition: Used to identify the international affiliate country code. The values to be used are those of ISO 3166 -1:1977. The ISO 3166 table has three separate forms of the country code: HL7 specifies that the 3-character (alphabetic) form be used for the country code.

Refer to HL7 Table 0399 - Country Code in Chapter 2C for the 3-character codes as defined by ISO 3166 table.

VID-3: International Version ID (CWE)

Definition: This field component identifies international affiliate’s version; it is especially important when the international affiliate has more than a single local version associated with a single US version.

VR - value range

HL7 Component Table - VR - value range
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
VR
1 First Data Code Value [0..1]   6 ST
2 Last Data Code Value [0..1]   6 ST

Components: <First Data Code Value (ST)> & <Last Data Code Value (ST)>


The VR differs from the Numeric Range (NR) data type only in that the values are not restricted to numbers. If the range is not numeric, the set must be orderable in some intuitive way such as alpha or the order must be defined in the field where the data type is used.

Example 1:

|+^+++|

Example 2: Colors of the rainbow

|violet^red|

VR-1: First Data Code Value (ST)

Definition: Specifies the lower bound value.

VR-2: Last Data Code Value (ST)

Definition: Specifies the upper bound value.

WVI - channel identifier

Attention: Retained for backward compatibility only in v 2.7. This is used only in the CD Channel Definition data type, which has been retained for backward compatibility only in v2.7.

HL7 Component Table - WVI - channel identifier
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
WVI
1 Channel Number [1..1]   4 NM
2 Channel Name [0..1]  17 ST

Components: <Channel Number (NM)> & <Channel Name (ST)>


WVI-1: Channel Number (NM)

Definition: This component specifies the number of the recording channel.

WVI-2: Channel Name (ST)

Definition: This component specifies the name of the recording channel.

WVS - waveform source

Attention: Retained for backward compatibility only in v2.7. It is used only in the CD Channel Definition data type, which has been retained for backward compatibility only in v2.7.

HL7 Component Table - WVS - waveform source
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
WVS
1 Source One Name [1..1]   8 ST
2 Source Two Name [0..1]   8 ST

Components: <Source One Name (ST)> & <Source Two Name (ST)>


WVS-1: Source One Name (ST)

Definition: This component identifies the first input for the waveform source.

WVS-2: Source Two Name (ST)

Definition: This component identifies the second input for the waveform source if a differential input is used.

XAD - extended address

HL7 Component Table - XAD - extended address
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
XAD
1 Street Address [0..1]     SAD
2 Other Designation [0..1] 120 ST
3 City [0..1]  50 ST
4 State or Province [0..1]  50 ST
5 Zip or Postal Code [0..1]  12 ST
6 Country SHALL [0..1] [3..3]     ID
7 Address Type SHALL [0..1] [1..3]     ID
8 Other Geographic Designation [0..1]  50 ST
9 County/Parish Code [0..1]     CWE
10 Census Tract [0..1]     CWE
11 Address Representation Code SHALL [0..1] [1..1]     ID
12 Address Validity Range [0..1]    
13 Effective Date [0..1]   8 DTM
14 Expiration Date [0..1]   8 DTM
15 Expiration Reason [0..1]     CWE
16 Temporary Indicator SHALL [0..1] [1..1]     ID
17 Bad Address Indicator SHALL [0..1] [1..1]     ID
18 Address Usage SHALL [0..1] [1..1]     ID
19 Addressee [0..1] 199 ST
20 Comment [0..1] 199 ST
21 Preference Order [0..1]   2 NM
22 Protection Code [0..1]     CWE
23 Address Identifier [0..1]     EI

Components: <Street Address (SAD)> & <Other Designation (ST)> & <City (ST)> & <State or Province (ST)> & <Zip or Postal Code (ST)> & <Country (ID)> & <Address Type (ID)> & <Other Geographic Designation (ST)> & <County/Parish Code (CWE)> & <Census Tract (CWE)> & <Address Representation Code (ID)> & <WITHDRAWN Address Validity Range> & <Effective Date (DTM)> & <Expiration Date (DTM)> & <Expiration Reason (CWE)> & <Temporary Indicator (ID)> & <Bad Address Indicator (ID)> & <Address Usage (ID)> & <Addressee (ST)> & <Comment (ST)> & <Preference Order (NM)> & <Protection Code (CWE)> & <Address Identifier (EI)>

Subcomponents for Street Address (SAD): <Street or Mailing Address (ST)> ^ <Street Name (ST)> ^ <Dwelling Number (ST)>

Subcomponents for County/Parish Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Census Tract (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Expiration Reason (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Protection Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Address Identifier (EI): <Entity Identifier (ST)> ^ <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>


XAD-1: Street Address (SAD)

Definition: This component contains the house number, apartment number, street name, street direction, P.O. Box number, and similar address information.

XAD-2: Other Designation (ST)

Definition: This component contains the second line of address. In US usage, it qualifies address. Examples: Suite 555 or Fourth Floor. When referencing an institution, this component specifies the street address.

XAD-3: City (ST)

Definition: This component specifies the city, or district or place where the addressee is located depending upon the national convention for formatting addresses for postal usage.

XAD-4: State or Province (ST)

Definition: This component specifies the state or province where the addressee is located. State or province should be represented by the official postal service codes for that country.

XAD-5: Zip or Postal Code (ST)

Definition: This component specifies the zip or postal code where the addressee is located. Zip or postal codes should be represented by the official codes for that country. In the US, the zip code takes the form 99999[-9999], while the Canadian postal code takes the form A9A9A9, and the Australian Postcode takes the form 9999.

XAD-6: Country (ID)

Definition: This component specifies the country where the addressee is located. HL7 specifies that the 3-character (alphabetic) form of ISO 3166 be used for the country code. Refer to HL7 Table 0399 – Country Code for valid values.

XAD-7: Address Type (ID)

Definition: This component specifies the kind or type of address. Refer to HL7 Table 0190 - Address Type for valid values.

XAD.7 is required if there are multiple occurrences of XAD in a field.

XAD-8: Other Geographic Designation (ST)

Definition: This component specifies any other geographic designation. It includes county, bioregion, SMSA, etc.

XAD-9: County/Parish Code (CWE)

Definition: A code that represents the county in which the specified address resides. User-defined Table 0289 - County/parish is used as the HL7 identifier for the user-defined table of values for this component. When this component is used to represent the county (or parish), component 8 <other geographic designation> should not duplicate it (i.e., the use of <other geographic designation> to represent the county is allowed only for the purpose of backward compatibility, and should be discouraged in this and future versions of HL7).

Allowable values: codes defined by government.

XAD-10: Census Tract (CWE)

Definition: A code that represents the census tract in which the specified address resides. User-defined Table 0288 - Census Tract is used as the HL7 identifier for the user-defined table of values for this component.

Allowable Values: codes defined by government.

XAD-11: Address Representation Code (ID)

Definition: Different <name/address types> and representations of the same name/address should be described by repeating of this field, with different values of the <name/address type> and/or <name/address representation> component.

Note: Also note that this new component remains in "alphabetic" representation with each repetition of the fields using these data types. I.e. even though the address may be represented in an ideographic character set, this component will remain represented in an alphabetic character set.


Refer to HL7 Table 0465 – Name/address Representation for valid values.

In general this component provides an indication of the representation provided by the data item. It does not necessarily specify the character sets used. Thus, even though the representation might provide an indication of what to expect, the sender is still free to encode the contents using whatever character set is desired. This component provides only hints for the receiver, so it can make choices regarding what it has been sent and what it is capable of displaying.

XAD-12: Address Validity Range (XAD)

Attention: The XAD.12 component was retained for backward compatibility as of v2.5 and the detail was withdrawn and removed from the standard as of v2.7. Refer to2.A.86.13, "Effective Date (DTM)" and 2.A.86.14, "Expiration Date (DTM)" components.

XAD-13: Effective Date (DTM)

Definition: The first date, if known, on which the address is valid and active for the ‘owning’ entity.

XAD-14: Expiration Date (DTM)

Definition: The last date, if known, on which the address is valid and active for the ‘owning’ entity.

XAD-15: Expiration Reason (CWE)

Definition: This identifies why this address was marked as "ended". Refer to User-defined Table 0616 – Address Expiration Reason for valid values.

XAD-16: Temporary Indicator (ID)

Definition: If "Y" this indicates that the address is considered temporary. Refer to HL7 Table 0136 – Yes/No Indicator.

XAD-17: Bad Address Indicator (ID)

Definition: If "Y", this indicates that it is not possible to contact the "owning" entity at this address. Refer to HL7 Table 0136 – Yes/No Indicator.

XAD-18: Address Usage (ID)

Definition: This indicates how the address is intended to be used. Refer to User-defined Table 0617 – Address Usage for valid values.

XAD-19: Addressee (ST)

Definition: Identifies the name of the person or organization that should appear as part of the address. This is also known as the "Care of" or "C/O" line.

XAD-20: Comment (ST)

Definition: Descriptive information about the use of the address.

Example: "Do not ring bell."

XAD-21: Preference Order (NM)

Definition: For an entity having multiple addresses, indicates which is the 'most preferred' (lowest number) to 'least preferred' (highest number).

If the preference order is unique across all usages for a given type, then it indicates the preference across all usages, (e.g., first try my home address, then my business address). Otherwise, the preference order is assumed to only apply within a specific usage.

Preference order numbers need not be sequential (i.e., four addresses with the priority orders of 10, 1, 5 and 15 are legitimate). The preference order numbers must be non-negative.

XAD-22: Protection Code (CWE)

Definition: Identifies that an address needs to be treated with special care or sensitivity.

The specific set of codes and appropriate handling of such addresses will vary by jurisdiction and is subject to site-specific negotiation. For example, a provider address marked as 'unlisted' might not be printed in an internal address listing. Refer to User-defined Table 0618 – Protection Code for valid values.

XAD-23: Address Identifier (EI)

Definition: A unique identifier for the address.

This component allows an address to be uniquely identified, and enables the linking of a single address to multiple people and contexts. For example, each member of a family living at the same location would share the same address, having the same identifier. A correction to the address of one family member could be automatically propagated to other members of the family.

XCN - extended composite ID number and name for persons

HL7 Component Table - XCN - extended composite ID number and name for persons
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
XCN
1 Person Identifier [0..1]  15 ST
2 Family Name [0..1]     FN
3 Given Name [0..1]  30 ST
4 Second and Further Given Names or Initials Thereof [0..1]  30 ST
5 Suffix [0..1]  20 ST
6 Prefix [0..1]  20 ST
7 Degree [0..1]    
8 Source Table [0..1]     CWE
9 Assigning Authority [0..1]     HD
10 Name Type Code SHALL [0..1] [1..5]     ID
11 Identifier Check Digit SHALL [0..1] [1..4]     ST
12 Check Digit Scheme SHALL [0..1] [3..3]     ID
13 Identifier Type Code SHALL [0..1] [2..5]     ID
14 Assigning Facility [0..1]     HD
15 Name Representation Code SHALL [0..1] [1..1]     ID
16 Name Context [0..1]     CWE
17 Name Validity Range [0..1]    
18 Name Assembly Order SHALL [0..1] [1..1]     ID
19 Effective Date [0..1]   8 DTM
20 Expiration Date [0..1]   8 DTM
21 Professional Suffix [0..1] 199 ST
22 Assigning Jurisdiction [0..1]     CWE
23 Assigning Agency or Department [0..1]     CWE
24 Security Check [0..1]   4 ST
25 Security Check Scheme SHALL [0..1] [3..3]     ID

Components: <Person Identifier (ST)> & <Family Name (FN)> & <Given Name (ST)> & <Second and Further Given Names or Initials Thereof (ST)> & <Suffix (ST)> & <Prefix (ST)> & <WITHDRAWN Degree> & <Source Table (CWE)> & <Assigning Authority (HD)> & <Name Type Code (ID)> & <Identifier Check Digit (ST)> & <Check Digit Scheme (ID)> & <Identifier Type Code (ID)> & <Assigning Facility (HD)> & <Name Representation Code (ID)> & <Name Context (CWE)> & <WITHDRAWN Name Validity Range> & <Name Assembly Order (ID)> & <Effective Date (DTM)> & <Expiration Date (DTM)> & <Professional Suffix (ST)> & <Assigning Jurisdiction (CWE)> & <Assigning Agency or Department (CWE)> & <Security Check (ST)> & <Security Check Scheme (ID)>

Subcomponents for Family Name (FN): <Surname (ST)> ^ <Own Surname Prefix (ST)> ^ <Own Surname (ST)> ^ <Surname Prefix from Partner/Spouse (ST)> ^ <Surname from Partner/Spouse (ST)>

Subcomponents for Source Table (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Assigning Authority (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Assigning Facility (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Name Context (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Assigning Jurisdiction (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Assigning Agency or Department (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


This data type is used extensively appearing in the PV1, ORC, RXO, RXE, OBR and SCH segments, as well as others, where there is a need to specify the ID number and name of a person.

Example without assigning authority and assigning facility:

|1234567^Everyman^Adam^A^III^DR^PHD^ADT01^^L^4^M11^MR|

Examples with assigning authority and assigning facility:

Dr. Harold Hippocrates’ provider ID was assigned by the Provider Master and was first issued at Good Health Hospital within the Community Health and Hospitals System. Since IS table values (first component of the HD) were not used for assigning authority and assigning facility, components 2 and 3 of the HD data type are populated and demoted to sub-components as follows:

12188^Hippocrates^Harold^H^IV^Dr^MD^^&Provider Master.Community Health and Hospitals&L^L^9^M10^DN^&Good Health Hospital.Community Health and Hospitals&L^A

Ludwig van Beethoven's medical record number was assigned by the Master Patient Index and was first issued at Fairview Hospital within the University Hospitals System.

10535^van Beethoven&van^Ludwig^A^III^Dr^PHD^^&MPI.Community Health and Hospitals&L^L^3^M10^MR^& Good Health Hospital.Community Health and Hospitals&L^A

XCN-1: Person Identifier (ST)

Definition: This component carries the Person Identifier itself. XCN.1, in conjunction with XCN.9 uniquely identifies the entity/person.

XCN.1 is required if XCN.2 is not populated. Both may be populated.

XCN-2: Family Name (FN)

Definition: This component allows full specification of the surname of a person. Where appropriate, it differentiates the person's own surname from that of the person's partner or spouse, in cases where the person's name may contain elements from either name. It also permits messages to distinguish the surname prefix (such as "van" or "de") from the surname root. See section 2.A.30, "FN - family name".

XCN.2 is required if XCN.1 is not populated. Both may be populated.

XCN-3: Given Name (ST)

Definition: First name.

XCN-4: Second and Further Given Names or Initials Thereof (ST)

Definition: Multiple middle names may be included by separating them with spaces.

XCN-5: Suffix (ST)

Definition: Used to specify a name suffix (e.g., Jr. or III).

XCN-6: Prefix (ST)

Definition: Used to specify a name prefix (e.g., Dr.).

XCN-7: Degree (XCN)

Attention: The XCN-7 component was deprecated as of v2.5 and the detail was withdrawn and removed from the standard as of v27.. Refer to XCN.21 Professional Suffix.

XCN-8: Source Table (CWE)

Attention: Retained for backwards compatibility only as of v 2.7. The reader is referred to XCN.9 instead.

User-defined Table 0297 – CN ID source is used as the HL7 identifier for the user-defined table of values for this component. Used to delineate the first component.

XCN-9: Assigning Authority (HD)

Definition: The assigning authority is a unique identifier of the system (or organization or agency of department) that creates the data. User-defined Table 0363 – Assigning Authority is used as the HL7 identifier for the user-defined table of values for the first sub-component of the HD component, <namespace ID>.

As of v 2.7, the Assigning Authority is conditional. It is required if XCN.1 is populated and neither XCN.22 nor XCN.23 are populated. All 3 components may be populated. No assumptions can be safely made based on position or sequence. Best practice is to send an OID in this component when populated.

The reader is referred to XCN.22 and XCN.23 if there is a need to transmit values with semantic meaning for an assigning jurisdiction or assigning department or agency in addition to, or instead of, an assigning authority. However, all 3 components may be valued. If, in so doing, it is discovered that the values in XCN.22 and/or XCN.23 conflict with XCN.9, the user would look to the Message Profile or other implementation agreement for a statement as to which takes precedence.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component) may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.

By site agreement, implementors may continue to use User-defined Table 0300 – Namespace ID for the first sub-component.


XCN-10: Name Type Code (ID)

Definition: A code that represents the type of name. Refer to HL7 Table 0200 - Name Type for valid values. See Section 2.A.89.7, "Name Type Code (ID)".

As of v 2.7, XCN.10 is conditional. It is required if XCN.2 is populated.

XCN-11: Identifier Check Digit (ST)

Definition: This component contains the digit, or digits, exclusive of the identifier in XCN.1, calculated by applying an algorithm to all or some of the digits in the number, which may be used to test validity of the non-check-digit identifier.

XCN-12: Check Digit Scheme (ID)

Definition: Contains the code identifying the check digit scheme employed.

Refer to HL7 Table 0061 - Check Digit Scheme for valid values.

XCN-13: Identifier Type Code (ID)

Definition: A code corresponding to the type of identifier. In some cases, this code may be used as a qualifier to the <assigning authority> component. Refer to HL7 Table 0203 - Identifier Type for suggested values.

As of v 2.7, XCN.13 is conditional. It is required if XCN.1 is populated.

XCN-14: Assigning Facility (HD)

Definition: The place or location identifier where the identifier was first assigned to the person. This component is not an inherent part of the identifier but rather part of the history of the identifier: as part of this data type, its existence is a convenience for certain intercommunicating systems.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component) may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.


XCN-15: Name Representation Code (ID)

Definition: Different <name/address types> and representations of the same <name/address> should be described by repeating of this field, with different values of the <name/address type> and/or <name/address representation> component.

Note:     This new component remains in “alphabetic” representation with each repetition of the field using these data types. I.e., even though the name may be represented in an ideographic character set, this component will remain represented in an alphabetic character set.


Refer to HL7 Table 0465 – Name/address Representation for valid values.

In general this component provides an indication of the representation provided by the data item. It does not necessarily specify the character sets used. Thus, even though the representation might provide an indication of what to expect, the sender is still free to encode the contents using whatever character set is desired. This component provides only hints for the receiver, so it can make choices regarding what it has been sent and what it is capable of displaying.

XCN-16: Name Context (CWE)

Definition: This component is used to designate the context in which a name is used. The main use case is in Australian healthcare for indigenous patients who prefer to use different names when attending different healthcare institutions. Another use case occurs in the US where health practitioners can be licensed under slightly different names and the reporting of the correct name is vital for administrative purposes. Refer to User-defined Table 0448 – Name Context for suggested values.

XCN-17: Name Validity Range (XCN)

Attention: The XCN.17 component was deprecated as of v2.5 and the detail was withdrawn and removed from the standard as of v 2.7. Refer to XCN.19 Effective Date and XCN.20 Expiration Date instead.

This component contains the start and end date/times that define the period during which this name was valid.

XCN-18: Name Assembly Order (ID)

Definition: A code that represents the preferred display order of the components of this person name. Refer to HL7 Table 0444 - Name Assembly Order for valid values.

XCN-19: Effective Date (DTM)

Definition: The first date, if known, on which the person name is valid and active.

XCN-20: Expiration Date (DTM)

Definition: The last date, if known, on which the person name is valid and active.

XCN-21: Professional Suffix (ST)

Definition: Used to specify an abbreviation, or a string of abbreviations denoting qualifications that support the person’s profession, (e.g., licenses, certificates, degrees, affiliations with professional societies, etc.). The Professional Suffix normally follows the Family Name when the Person Name is used for display purposes. Please note that this component is an unformatted string and is used for display purposes only. Detailed information regarding the contents of Professional Suffix is obtained using appropriate segments in Chapter 15, "Personnel Management".

XCN-22: Assigning Jurisdiction (CWE)

Definition: The geo-political body that assigned the identifier in XCN.1.

See section, 2.A.14.9, "Assigning Jurisdiction (CWE)" for further detail.

As of v 2.7, the Assigning Jurisdiction is conditional. It is required if XCN.1 is populated and neither XCN.9 nor XCN.23 are populated. All 3 components may be populated. The reader is referred to XCN.9 if there is a need to transmit this information as an OID.

XCN-23: Assigning Agency or Department (CWE)

Definition: The agency or department that assigned the identifier in XCN.1.

See section 2.A.14.10, "Assigning Agency or Department (CWE)" for further details.

As of v 2.7, the Assigning Jurisdiction is conditional. It is required if XCN.1 is populated and neither XCN.9 nor XCN.22 are populated. All 3 components may be populated. The reader is referred to XCN.9 if there is a need to transmit this information as an OID.

XCN-24: Security Check (ST)

Definition: This component is used to communicate a version code that may be assigned to the value given in XCN.1 Person Identifier.

XCN-25: Security Check Scheme (ID)

Definition: This component is used to transmit information intended to validate the veracity of the supplied identifier or the presenter of the identifier. For example, this component may be used to ensure that the presenter of a credit card is an authorized user of that card.

Refer to HL7 Table 0904 - Security Check Scheme for valid values

XON - extended composite name and identification number for organizations

HL7 Component Table - XON - extended composite name and identification number for organizations
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
XON
1 Organization Name [0..1]  50 ST
2 Organization Name Type Code [0..1]     CWE
3 ID Number [0..1]    
4 Identifier Check Digit [0..1]    
5 Check Digit Scheme [0..1]    
6 Assigning Authority [0..1]     HD
7 Identifier Type Code SHALL [0..1] [2..5]     ID
8 Assigning Facility [0..1]     HD
9 Name Representation Code SHALL [0..1] [1..1]     ID
10 Organization Identifier [0..1]     ST

Components: <Organization Name (ST)> & <Organization Name Type Code (CWE)> & <WITHDRAWN ID Number> & <WITHDRAWN Identifier Check Digit> & <WITHDRAWN Check Digit Scheme > & <Assigning Authority (HD)> & <Identifier Type Code (ID)> & <Assigning Facility (HD)> & <Name Representation Code (ID)> & <Organization Identifier (ST)>

Subcomponents for Organization Name Type Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Assigning Authority (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Subcomponents for Assigning Facility (HD): <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

This data type is used in fields (e.g., PV2-23, NK1-13, PD1-3, OBR-44) to specify the name and ID number of an organization.

Example 1:

The ID for Good Health Hospital was assigned by the Community Health and Hospitals enterprise’s Hospital Master and was first issued at the Central Offices.

Good Health Hospital^L^716^9^M10^&Hospital Master.Community Health and Hospitals&L^XX^&Central Offices.Community Health and Hospitals&L^A

Example 2:

Good Health Hospital has another ID that was issued by CMS. Assigning Authority, CMS, values only the first HD component, an IS data type and assigning facility is not relevant. This information might be transmitted accordingly:

Good Health Hospital^L^4544^3^M10^CMS^XX^^A

XON-1: Organization Name (ST)

Definition: The name of the specified organization.

XON-2: Organization Name Type Code (CWE)

Definition: A code that represents the type of name i.e., legal name, display name. Refer to User-defined Table 0204 - Organizational Name Type for suggested values.

XON-3: ID Number (XON)

Attention: The XON.3 component was deprecated as of v 2.5 and the detail was withdrawn and removed from the standard as of v 2.7. Refer to XON.10 Organization Identifier.

XON-4: Identifier Check Digit (XON)

Attention: The XON.4 component was deprecated as of v 2.5 and the detail was withdrawn and removed from the standard as of v 2.7.

XON-5: Check Digit Scheme (XON)

Attention: The XON.5 component was deprecated as of v 2.5 and the detail was withdrawn and removed from the standard as of v 2.7. .

XON-6: Assigning Authority (HD)

Definition: The assigning authority is a unique identifier of the system (or organization or agency or department) that creates the data. Assigning authorities are unique across a given HL7 implementation. Refer to User-defined Table 0363 - Assigning Authority for suggested values.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component) may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.    

By site agreement, implementers may continue to use User-defined Table 0300 – Namespace ID for the first sub-component.


XON-7: Identifier Type Code (ID)

Definition: A code corresponding to the type of identifier. In some cases, this code may be used as a qualifier to the "Assigning authority" component. Refer to HL7 Table 0203 - Identifier Type for suggested values.

XON-8: Assigning Facility (HD)

Definition: The place or location identifier where the identifier was first assigned to the person. This component is not an inherent part of the identifier but rather part of the history of the identifier: as part of this data type, its existence is a convenience for certain intercommunicating systems.

Note: When the HD data type is used in a given segment as a component of a field of another data type, User-defined Table 0300 - Namespace ID (referenced by the first sub-component of the HD component) may be re-defined (given a different user-defined table number and name) by the technical committee responsible for that segment.


XON-9: Name Representation Code (ID)

Definition: Different <name/address types> and representations of the same <name/address> should be described by repeating of this field, with different values of the <name/address type> and/or <name/address representation> component.

Note: This new component remains in “alphabetic” representation with each repetition of the field using these data types, i.e. even though the name may be represented in an ideographic character set, this component will remain represented in an alphabetic character set.


Refer to HL7 Table 0465 – Name/address Representation Code for valid values.

In general this component provides an indication of the representation provided by the data item. It does not necessarily specify the character sets used. Thus, even though the representation might provide an indication of what to expect, the sender is still free to encode the contents using whatever character set is desired. This component provides only hints for the receiver, so it can make choices regarding what it has been sent and what it is capable of displaying.

XON-10: Organization Identifier (ST)

Definition: This component contains the sequence of characters (the code) that uniquely identifies the item being referenced by XON.1 Organization Name. This component replaces XON.3 ID Number as of v 2.5.

Note: The check digit and code identifying check digit scheme are null if Organization identifier is alphanumeric.


XPN - extended person name

HL7 Component Table - XPN - extended person name
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
XPN
1 Family Name [1..1]     FN
2 Given Name [0..1]  30 ST
3 Second and Further Given Names or Initials Thereof [0..1]  30 ST
4 Suffix [0..1]  20 ST
5 Prefix [0..1]  20 ST
6 Degree [0..1]    
7 Name Type Code SHALL [0..1] [1..5]     ID
8 Name Representation Code SHALL [0..1] [1..1]     ID
9 Name Context [0..1]     CWE
10 Name Validity Range [0..1]    
11 Name Assembly Order SHALL [0..1] [1..1]     ID
12 Effective Date [0..1]     DTM
13 Expiration Date [0..1]     DTM
14 Professional Suffix [0..1] 199 ST
15 Called By [0..1]  30 ST

Components: <Family Name (FN)> & <Given Name (ST)> & <Second and Further Given Names or Initials Thereof (ST)> & <Suffix (ST)> & <Prefix (ST)> & <WITHDRAWN Degree> & <Name Type Code (ID)> & <Name Representation Code (ID)> & <Name Context (CWE)> & <WITHDRAWN Name Validity Range> & <Name Assembly Order (ID)> & <Effective Date (DTM)> & <Expiration Date (DTM)> & <Professional Suffix (ST)> & <Called By (ST)>

Subcomponents for Family Name (FN): <Surname (ST)> ^ <Own Surname Prefix (ST)> ^ <Own Surname (ST)> ^ <Surname Prefix from Partner/Spouse (ST)> ^ <Surname from Partner/Spouse (ST)>

Subcomponents for Name Context (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>


HL7 supports the following standards for Japanese characters:

    JIS X 0201 for ISO-IR 13 (Japanese Katakana)

    JIS X 0201 for ISO-IR 14 (Japanese Romaji)

    JIS X 0208 for ISO-IR 87 (Japanese Kanji, Hiragana and Katakana)

    JIS X 0212 for ISO-IR 159 (supplementary Japanese Kanji)

HL7 supports the following standards for European characters:

ISO 8859 (1-9) for ISO-IR 100, 101, 109, 110, 144,127, 126, 138 and 148.

Character sets are referenced in HL7 as ASCII, 8859/1,8859/2, ISO IR14, ISO IR87, and ISO IR159. DICOM uses codes laid out in ISO 2375, of the form 'ISO-IR xxx'. HL7 supports this naming as well, to facilitate interoperability.

HL7 uses the Basic G0 Set of the International Reference Version of ISO 646:1990 (ISO IR-6) as the default character repertoire for character strings. This is a single-byte character set, identical to ASCII.

Each repetition of a XPN, XON, XCN, or XAD field is assumed to begin with the default character set. If another character set is to be used, the HL7 defined escape sequence used to announce that character set must be at the beginning of the repetition, and the HL7 defined escape sequence used to start the default character set must be at the end of the repetition. Note also that several character sets may be intermixed within a single repetition as long as the repetition ends with a return to the default character set.

An application must specify which character sets it supports in the field MSH-18 Character Sets and which character set handling scheme it supports in the field MSH-20 Alternate Character Set Handling Scheme. It is assumed that the sending and receiving applications are aware of how to map character set names (i.e., ISO-IR xxx) to escape sequences.

For example, in many Japanese messages there is a mix of Romaji (i.e., Roman characters), Katakana (phonetic representation of foreign words), Hiragana (phonetic representation of Japanese words) and Kanji (pictographs). Such a message would require 4 character sets be specified in the MSH.

References for Internationalization of Name

Reference

Description

1.

“Understanding Japanese Information Processing” by Ken Lunde, O’Reilly Press

2.

NEMA PS3.5 - DICOM Part 5: Data Structure and Semantics

3.

ANSI X3.4:1986

ASCII character set

4.

ISO 646:1990

Information Processing - ISO 7-bit coded character set for information interchange

5.

ISO/IEC 2022:1994

Information Technology - Character code structure and extension techniques

6.

ISO 2375:1986

Data Processing - Procedure for the registration of escape sequences

7.

ISO 6429:1990

Information Processing - Control functions for 7-bit and 8-bit coded character sets

8.

ISO 8859 (1-9)

Information Processing - 8-bit single-byte coded graphic character sets - parts 1-9

9.

ENV 41 503:1990

Information systems interconnection - European graphic character repertoires and their coding

10.

ENV 41 508:1990

Information systems interconnection - East European graphic character repertoires and their coding

11.

JIS X 0201-1976

Code for Information Exchange

12.

JIS X 0212-1990

Code of the supplementary Japanese Graphic Character set for information interchange

13.

JIS X 0208-1990

Code for the Japanese Graphic Character set for information interchange

14.

RFC 1468    

Japanese Character Encoding for Internet Messages


Character Repertoires supported by DICOM are defined in Part 5, section 6.1. The DICOM Standard is available free on the Internet at http://medical.nema.org/.

Examples of names requiring only one iteration of the field where the XPN is applied:

Example 1: Adam A. Everyman III PhD

|Everyman^Adam^A^III^DR^^L^^^^^^^PHD|

Example 2: Ludwig van Beethoven

|Beethoven&van^Ludwig^^^^^L|

Example 3: Hermann Egon Mayer zur alten Schildesche

|Mayer^Hermann^Egon^zur alten Schildesche|

Example 4: Sister Margot

|^Margot^^^Sister^^C|

Example 5: Dr Harold Henry Hippocrates AO. MBBS. ASCTS. A physician who holds an Honorarium, an academic degree and a board certificate. Professional suffixes are displayed as concatenated. (AO = Order of Australia (Honorarium), MBBS = Bachelor of Medicine and Bachelor of Surgery, ASCTS = Australian Society of Cardiothoracic Surgeons

|Hippocrates^Harold^Henry^^^^L^^^^^^^AO.MBBS.ASCTS|

Example 6: Nancy N. Nightingale, RN, PHN, BSN, MSN. A registered nurse who is a Public Health Nurse with 2 academic degrees, BSN and MSN.

|Nightingale^Nancy^N^^^^^^^^^^^RN, PHN, BSN, MSN|

Example 7: H.Horrace Helper Jr., RN, CNP. A registered nurse who is a certified nurse practitioner.

|Helper^H^Horrace^Jr^^^^^^^^^^ RN, CNP|

Example 8: Mevrouw Irma Jongeneel de Haas.

An individual whose birth name (geboortenaam) is de Haas and whose partner's name is Jongeneel.

| Jongeneel-de Haas&de&Haas&&Jongeneel^Irma^^^Mevrouw^^L |

Examples of names requiring more than one iteration of the field where the XPN is applied:

Example 9: Herr Prof. Dr. med. Joachim W. Dudeck

|Dudeck^Joachim^W.^^Dr.med.^^L^^^^^^^ MD ~Dudeck^J.W.^^^Herr Prof.Dr.^^D|

Example 10: Herr Dr. Otto Graf Lambsdorff mdB a.D.

According to German law “Adelstitel” like “Graf” or “Baron” belongs to the family name and therefore must be encoded in the family name field separated by blanks.

|Graf Lambsdorff&Graf&Lambsdorff^Otto^^^Dr.^^L~Graf Lambsdorff&Graf&Lambsdorff^Otto^^mdB a.D.^Herr Dr.^^D|

Example 11: Walter Kemper genannt (named) Mölleken

|Kemper^Walter^^^^^L~Mölleken^Walter^^^^^A|

Example 12: Herr Dr. med. Dr. h.c. Egon Maier

|Maier^Egon^^^Dr.med. Dr.h.c.^^L^^^^^^^MD~Maier^Egon^^^Herr Dr.med. Dr.h.c^^D|

Example 13: Herr Dipl.Ing. Egon Maier

|Maier^Egon^^^^^L^^^^^^^ DIPL~Maier^Egon^^^Herr Dipl.Ing.^^D|

Example 14: Frau Gerda Müller geb. Maier, verheiratet seit 16.2.2000

|Müller^Gerda^^^Frau^^L^^^^^20000216~Maier^Gerda^^^Frau^^M|

Example 15: President Adam A Everyman III, president from 1997 until 2001, aka Sonny Everyman

|Everyman^Adam^A.^III^President^^L~^^^^Mr. President^^D^^^^^19970816^20010320~Everyman^Sonny^^^^^A|

Example 16: Michio Kimura

This example doesn’t use title and degrees, but shows the repetition of this name for different purposes. The first iteration is the legal name in Kanji; the second, Katakana; the third, alphabetic.

XPN-1: Family Name (FN)

Definition: This component allows full specification of the surname of a person. Where appropriate, it differentiates the person's own surname from that of the person's partner or spouse, in cases where the person's name may contain elements from either name. It also permits messages to distinguish the surname prefix (such as "van" or "de") from the surname root. See section 2.A.30, "FN - family name".

XPN.1 will be empty when XPN.7 is MSK. It MAY be empty when XPN.7 is NAV.

Usage Note: If a person’s name has only one component, that name will be sent in XPN.1 Family Name. This is common practice in some countries such as Indonesia. This note does not cover the case where only one part of a person's multi-part name is known (e.g., only know "John" of "John Doe").

XPN-2: Given Name (ST)

Definition: First name.

XPN-3: Second and Further Given Names or Initials Thereof (ST)

Definition: Multiple middle names may be included by separating them with spaces.

XPN-4: Suffix (ST)

Definition: Used to specify a name suffix (e.g., Jr. or III).

XPN-5: Prefix (ST)

Definition: Used to specify a name prefix (e.g., Dr.).

XPN-6: Degree (XPN)

Attention: The XPN-6 component was deprecated as of v2.5 and the detail was withdrawn and removed from the standard as of v 2.7. See XPN.14 Professional Suffix.

XPN-7: Name Type Code (ID)

Definition: A code that represents the type of name. Refer to HL7 Table 0200 - Name Type for valid values.

Note: The content of Legal Name is country specific. In the US the legal name is the same as the current married name.


XPN-8: Name Representation Code (ID)

Definition: Different <name/address types> and representations of the same <name/address> should be described by repeating of this field, with different values of the <name/address type> and/or <name/address representation> component.

Note: This new component remains in "alphabetic" representation with each repetition of the field using these data types, i.e., even though the name may be represented in an ideographic character set, this component will remain represented in an alphabetic character set.


Refer to HL7 Table 0465 – Name/address Representation for valid values.

In general this component provides an indication of the representation provided by the data item. It does not necessarily specify the character sets used. Thus, even though the representation might provide an indication of what to expect, the sender is still free to encode the contents using whatever character set is desired. This component provides only hints for the receiver, so it can make choices regarding what it has been sent and what it is capable of displaying.

XPN-9: Name Context (CWE)

Definition: This component is used to designate the context in which a name is used. The main use case is in Australian healthcare for indigenous patients who prefer to use different names when attending different healthcare institutions. Another use case occurs in the US where health practitioners can be licensed under slightly different names and the reporting of the correct name is vital for administrative purposes. Refer to User-defined Table 0448 – Name Context for suggested values.

XPN-10: Name Validity Range (XPN)

Attention: The XPN.10 component was deprecated as of v2.5 and the detail was withdrawn and removed from the standard as of v2.7. Refer to 2.A.89.12, "Effective date (DTM)" and 2.A.89.13, "Expiration date (DTM)" components.

XPN-11: Name Assembly Order (ID)

Definition: A code that represents the preferred display order of the components of this person name. Refer to HL7 0444 – Name Assembly Order for valid values.

XPN-12: Effective Date (DTM)

Definition: The first date, if known, on which the person name is valid and active.

XPN-13: Expiration Date (DTM)

Definition: The last date, if known, on which the person name is valid and active.

XPN-14: Professional Suffix (ST)

Definition: Used to specify an abbreviation, or a string of abbreviations denoting qualifications that support the person’s profession, (e.g., licenses, certificates, degrees, affiliations with professional societies, etc.). The Professional Suffix normally follows the Family Name when the Person Name is used for display purposes. Please note that this component is an unformatted string and is used for display purposes only. Detailed information regarding the contents of Professional Suffix is obtained using appropriate segments in Chapter 15, Personnel Management.

XPN-15: Called By (ST)

Definition: A "called by" name is the name that is preferred when a person is directly addressed; sometimes known as a nickname.

Note: The called by component contains a name that could be categorized as a nickname using the name usage types in HL7 Table 0200 - Name type. Its use is reserved for instances in which the nickname is a single name part that is provided in addition to a name that has some other type, such as legal. It is understood that the "called by" name is not part of the full name. Where a nickname has more parts, possibly including a family name, a different XPN with a type of nickname should instead be used.


Examples:

  • James Robert Smith is Called By Jim Bob

  • James Robert Smith is Called By JR

  • Peter Richard Smith is Called By Richard

  • Mary Margaret Elizabeth Jones is Called By Meg.

XTN - extended telecommunication number

HL7 Component Table - XTN - extended telecommunication number
Seq# Description Implement Flags Cardinality Length C.LEN Vocabulary Data Type
XTN
1 Telephone Number [0..1]    
2 Telecommunication Use Code SHALL [0..1] [3..3]     ID
3 Telecommunication Equipment Type SHALL [1..1] [2..8]     ID
4 Communication Address [0..1] 199 ST
5 Country Code [0..1]   3 SNM
6 Area/City Code [0..1]   3 SNM
7 Local Number [0..1]   9 SNM
8 Extension [0..1]   5 SNM
9 Any Text [0..1] 199 ST
10 Extension Prefix [0..1]   4 ST
11 Speed Dial Code [0..1]   6 ST
12 Unformatted Telephone Number [0..1] 199 ST
13 Effective Start Date [0..1]     DTM
14 Expiration Date [0..1]     DTM
15 Expiration Reason [0..1]     CWE
16 Protection Code [0..1]     CWE
17 Shared Telecommunication Identifier [0..1]     EI
18 Preference Order [0..1]   2 NM

Components: <WITHDRAWN Telephone Number> & <Telecommunication Use Code (ID)> & <Telecommunication Equipment Type (ID)> & <Communication Address (ST)> & <Country Code (SNM)> & <Area/City Code (SNM)> & <Local Number (SNM)> & <Extension (SNM)> & <Any Text (ST)> & <Extension Prefix (ST)> & <Speed Dial Code (ST)> & <Unformatted Telephone Number (ST)> & <Effective Start Date (DTM)> & <Expiration Date (DTM)> & <Expiration Reason (CWE)> & <Protection Code (CWE)> & <Shared Telecommunication Identifier (EI)> & <Preference Order (NM)>

Subcomponents for Expiration Reason (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Protection Code (CWE): <Identifier (ST)> ^ <Text (ST)> ^ <Name of Coding System (ID)> ^ <Alternate Identifier (ST)> ^ <Alternate Text (ST)> ^ <Name of Alternate Coding System (ID)> ^ <Coding System Version ID (ST)> ^ <Alternate Coding System Version ID (ST)> ^ <Original Text (ST)> ^ <Second Alternate Identifier (ST)> ^ <Second Alternate Text (ST)> ^ <Name of Second Alternate Coding System (ID)> ^ <Second Alternate Coding System Version ID (ST)> ^ <Coding System OID (ST)> ^ <Value Set OID (ST)> ^ <Value Set Version ID (DTM)> ^ <Alternate Coding System OID (ST)> ^ <Alternate Value Set OID (ST)> ^ <Alternate Value Set Version ID (DTM)> ^ <Second Alternate Coding System OID (ST)> ^ <Second Alternate Value Set OID (ST)> ^ <Second Alternate Value Set Version ID (DTM)>

Subcomponents for Shared Telecommunication Identifier (EI): <Entity Identifier (ST)> ^ <Namespace ID (IS)> ^ <Universal ID (ST)> ^ <Universal ID Type (ID)>

Example 1: A Work fax number

^WPN^FX^^^734^6777777

Example 2: Telephone number with extension

^WPN^PH^^^734^6777777^1

Example 2: Telephone number with internal code. In this example, assume that a corporation's telephone system supports a full external telephone number (area code and telephone number). It also supports internal dialing standards that assign a code to each facility and an extension to each telephone (which happens to be the last 4 digits of the external telephone number, by convention).

So, if the Los Angeles facility were assigned code 333, and if the "outside" telephone number at the LA office is (626) 555-1234, the components would be:

Component

Value

area/city code

626

phone number

555-1234

extension

1234

extension prefix

333


The field would be transmitted as follows:

^WPN^PH^^^626^5551234^1234^333

Example 3: speed dial. In this example, assume that a corporation's telephone system supports speed dialing numbers. For example, suppose that a corporation has a contract with a travel agency, whose external number is 1-610-555-1234. Since it is so frequently dialed, the company assigns a speed code: #6098. The components would be:

Component

Value

Area/city code

610

Phone number

555-1234

Speed Dial

#6098


The field would be transmitted as follows:

^WPN^PH^^^610^5551234^^^#6098

Example 4: home e-mail address. In this example, assume that a person has a primary home e-mail address such as someone@somewhere.com. The components would be:

Component

Value

Telecommunication Use Code

PRN

Telecommunication Equipment Type

Internet

Communication Address

someone@somewhere.com


The field would be transmitted as follows:

^PRN^Internet^someone@somewhere.com

Example 5: work e-mail address. In this example, assume that a person has a work e-mail address such as someone@somewhere.com. The components would be:

Component

Value

Telecommunication Use Code

WPN

Telecommunication Equipment Type

Internet

Communication Address

someone@somewhere.com


The field would be transmitted as follows:

^WPN^Internet^someone@somewhere.com

XTN-1: Telephone Number (XTN)

Attention: The XTN-1 component was deprecated as of v2.3 and the detail was withdrawn and removed from the standard as of v2.6.

XTN-2: Telecommunication Use Code (ID)

Definition: A code that represents a specific use of a telecommunication number. Refer to HL7 Table 0201 - Telecommunication Use Code for valid values. This component along with XTN.3 describes the nature of the telecommunication data that follows. Best practice requires the population of XTN.2 when XTN.4 or XTN.7 is populated.

XTN-3: Telecommunication Equipment Type (ID)

Definition: A code that represents the type of telecommunication equipment. Refer to HL7 Table 0202 - Telecommunication Equipment Type for valid values. This component along with XTN.2 describes the nature of the telecommunication data that follows and is necessary to accurately interpret it.

XTN-4: Communication Address (ST)

Note: This component is required if, and only allowed if, XTN.7 or XTN.12 are not populated.

Note: If any of the HL7 delimiters are found in the Communication Address, such as @, the appropriate HL7 escape sequence SHALL be used when encoding an Internet address (see Chapter 2, "Control", section 2.7.1, "Formatting Codes").


XTN-5: Country Code (SNM)

Definition: The numeric code assigned by the International Telecommunication Union in standard E.164 to access telephone services in another country. For example, "+1" is the country code for the United States, "+49" is the code for Germany.

XTN-6: Area/City Code (SNM)

Definition: The numeric code to access telephone services in another area/city within a country. This number historically needs not be dialed if the caller is located in the same area/city as the phone number of the called party.

The use and size of area/city codes is however country specific: some countries do not use area/city codes, or the use of area/city codes may be mandatory when dialing, or area/city codes may be used to group phone numbers based on other criteria than geographic location, such as cell-phone area/city-codes, or free information numbers (e.g., 800 numbers).

Most countries have a prefix for Area/City codes which only has to be dialed if one doesn't use a country code. This prefix (mostly "0", sometimes "9") should be omitted from the content of this field. If the prefix for the Area/Code is also mandatory if one uses the country code (e.g., in Italy) then this field should also contain the prefix.

XTN-7: Local Number (SNM)

Definition: The numeric code used to contact the called party, exclusive of country and area/city codes. The Local Number is required when, and allowed only if, XTN.4 and XTN.12 are not populated.

The size of the Local Number is country specific.

Note: The Local Number does not include the numeric codes that have to be dialed once a connection has been established. Examples include (automated) organizational phone systems which allow external callers to dial additional numeric codes. These additional numeric codes should be specified as an extension.


XTN-8: Extension (SNM)

Definition: The numeric code to contact the called party used within an organization, e.g., the number used if both caller and called party are located within the same organization. The extension is often the same as the last few digits of the Local Number. The use of extensions is country and site specific, and may depend on the type of phone system (PBX) used by the organization.

XTN-9: Any Text (ST)

Definition: Contains comments with respect to the telephone number.

Example: |^^^^^^^^Do not use after 5PM|

XTN-10: Extension Prefix (ST)

Definition: The characters established within a company’s internal telephone system network used as a prefix to the Extension component for internal dialing.

Note: The use of Extension Prefix requires that the Extension component be valued and that digits, as well as special characters (e.g., *, #) may be used.


XTN-11: Speed Dial Code (ST)

Definition: The characters established within a company’s internal telephone system used in place of the (external) telephone number to facilitate calling because its length is shorter than that of the telephone number.

Note: Digits, as well as special characters (e.g., *, #) may be used.


XTN-12: Unformatted Telephone Number (ST)

Definition: An expression of the telephone number as an unparsable string. The Unformatted Telephone number is required when, and allowed only if, XTN.4 and XTN.7 are not populated.

The phone number was entered as free text and sending system does not know how to parse it.

Example: |^^^^^^^^^^^1-800-Dentist|

XTN-13: Effective Start Date (DTM)

Definition: The first date, if known, on which the telecommunication number is valid and active.

XTN-14: Expiration Date (DTM)

Definition: The last date, if known, on which the telecommunication number is valid and active.

XTN-15: Expiration Reason (CWE)

Definition: Indicates why this contact number/e-mail was marked as "ended". Refer to User-defined Table 0868 – Telecommunication Expiration Reason for valid values.

XTN-16: Protection Code (CWE)

Definition: Indicates whether this information is considered sensitive or should be protected in some way. Refer to User-defined table 0618 - Protection Code for suggested values.

The specific set of codes and appropriate handling of such telecommunications addresses will vary by jurisdiction and is subject to site-specific negotiation. For example, a provider address marked as 'unlisted' might not be printed in an internal address listing.

XTN-17: Shared Telecommunication Identifier (EI)

Definition: A unique identifier for the phone number or e-mail address.

This component allows a phone number to be uniquely identified, and enables the linking of a single phone number to multiple people and contexts. For example, each member of a family living at the same location would share the same phone number, having the same identifier. A correction to the phone number of one family member could be automatically propagated to other members of the family.

HL7 does not assume responsibility for the processing rules for this component.

XTN-18: Preference Order (NM)

Definition: For an entity having multiple telecommunication addresses, indicates which is the "most preferred" (lowest number) to "least preferred" (highest number).

If the preference order is unique across all usages for a given type, then it indicates the preference across all usages, (e.g. first try my home number, then my business number). If the preference order is unique across all usages and types, then it indicates the preference across all types of telecommunication addresses. (E.g., first try my phone; if that doesn't work, use my pager.) Otherwise, the preference order is assumed to only apply within a specific type and usage.

Preference order numbers need not be sequential (i.e., three numbers with the priority orders of 0, 5 and 15 are legitimate). The preference order numbers must be non-negative.