HL7 - REFACTORED

RXG - Pharmacy/Treatment Give Segment

HL7 Attribute Table - RXG - Pharmacy/Treatment Give Segment
Seq#	Data Element Name	DataType	Usage	Vocabulary	Cardinality	Item #	Length	C.LEN	Flags
RXG
1	Give Sub-ID Counter	NM	R		[1..1]	00342		4	#
2	Dispense Sub-ID Counter	NM	O		[0..1]	00334		4	#
3	Quantity/Timing		W		[0..1]	00221
4	Give Code	CWE	R	0292(R) Vaccines Administered(Required)	[1..1]	00317
5	Give Amount - Minimum	NM	R		[1..1]	00318
6	Give Amount - Maximum	NM	O		[0..1]	00319
7	Give Units	CWE	R	0715	[1..1]	00320
8	Give Dosage Form	CWE	O	0716	[0..1]	00321
9	Administration Notes	CWE	O	0737	[0..*]	00351
10	Substitution Status	ID	O	0167(R) Substitution Status(Required)	[0..1]	00322	[1..1]
11	Dispense-to Location		W		[0..1]	01303
12	Needs Human Review	ID	O	0136(R) Yes/no Indicator(Required)	[0..1]	00307	[1..1]
13	Special Administration Instructions	CWE	O	0738	[0..*]	00343	[1..250]
14	Give Per	ST	C		[0..1]	00331		20	#
15	Give Rate Amount	ST	O		[0..1]	00332		6	#
16	Give Rate Units	CWE	O	0722	[0..1]	00333
17	Give Strength	NM	O		[0..1]	01126
18	Give Strength Units	CWE	O	0723	[0..1]	01127
19	Substance Lot Number	ST	O		[0..*]	01129		20	#
20	Substance Expiration Date	DTM	O		[0..*]	01130
21	Substance Manufacturer Name	CWE	O		[0..*]	01131
22	Indication	CWE	O	0758	[0..*]	01123
23	Give Drug Strength Volume	NM	O		[0..1]	01692		5	#
24	Give Drug Strength Volume Units	CWE	O	0744	[0..1]	01693
25	Give Barcode Identifier	CWE	O	0745	[0..1]	01694
26	Pharmacy Order Type	ID	O	0480(R) Pharmacy Order Types(Required)	[0..1]	01695	[1..1]
27	Dispense to Pharmacy	CWE	W	0714	[0..1]	01688
28	Dispense to Pharmacy Address	XAD	W		[0..1]	01689
29	Deliver-to Patient Location	PL	O		[0..1]	01683
30	Deliver-to Address	XAD	O		[0..1]	01684
31	Give Tag Identifier	EI	O		[0..*]	03393
32	Dispense Amount	NM	C		[0..1]	03316
33	Dispense Units	CWE	C	0746	[0..1]	03317

RXG-1: Give Sub-ID Counter (NM) 00342

Definition: Use if this RXG segment carries information about a single administration. This field must contain a unique number for the placer order number. This field along with the placer order number provides a unique reference to the specific scheduled give date/time transmitted by the pharmacy/treatment supplier for this order.

If the RXG segment carries information about multiple administrations, this field's value is zero (0), since in this case a one-to-one matching with the RXA segment is ambiguous.

RXG-2: Dispense Sub-ID Counter (NM) 00334

Definition: This is the dispense sub-ID to which this give message is related.

RXG-3: Quantity/Timing () 00221

Attention: The RXG-3 field was retained for backward compatibilty only as of v 2.5 and the detail was withdrawn and removed from the standard as of v 2.7.

Note: The contents of fields 3-8 should be identical to the comparable fields in the RXE (RXE-2 thru 5).

RXG-4: Give Code (CWE) 00317

Definition: This field is the identifier of the medical substance/treatment ordered to be given to the patient; it is equivalent to OBR-4-Universal service ID in function. See the RXE segment for a complete definition of the RXE-2-Give code. If the substance given is a vaccine, CVX codes may be used to code this field (see HL7 Table 0292 - Vaccines administered in Chapter 2C, Code Tables).

RXG-5: Give Amount - Minimum (NM) 00318

Definition: This field contains the ordered amount as encoded by the pharmacy/treatment supplier. In a variable dose order, this is the minimum ordered amount. In a non-varying dose order, this is the exact amount of the order.

Note: This field is not a duplication of the first component of the quantity/timing field, since in non-pharmacy/treatment orders, that component can be used to specify multiples of an ordered amount.

Another way to say this is that, for pharmacy/treatment orders, the quantity component of the quantity/timing field refers to what is to be given out at each service interval; and thus, in terms of the RX order, that first component always defaults to 1. Hence, in the actual execution of the order, the value of 1 in the first component of the quantity/timing field always refers to one administration of the amount specified in this field (the requested Give Amount field).

RXG-6: Give Amount - Maximum (NM) 00319

Definition: In a variable dose order, this is the maximum ordered amount. In a non-varying dose order, this field is not used.

RXG-7: Give Units (CWE) 00320

Definition: This field contains the units for the give amount. Refer to Table 0735 - Give Units in Chapter 2C for valid values.

Note: These units can be a "compound quantity;" i.e., the units may contain the word "per." For example, micrograms per KG (micg/kg) is an acceptable value, which means that the units are micrograms per KG (of body weight).

A table of standard units that contains compound units is needed. Until such a table is agreed on, a user-defined table is needed for each site.

RXG-8: Give Dosage Form (CWE) 00321

Definition: The dosage form indicates the manner in which the medication/treatment is aggregated for dispensing, e.g., tablets, capsules, suppositories. In some cases, this information is implied by the give code in RXG-4-Give Code. Use this field when the give code does not specify the dosage form. Refer to Table 0736 - Give Dosage Form in Chapter 2C for valid values.

RXG-9: Administration Notes (CWE) 00351

Definition: This field contains notes to the person administering the medication/treatment (may include the ordering provider's original notes, as well as any notes from the formulary or the pharmacy or treatment supplier). If coded, a user-defined table must be used. If free text, place a null in the first component and the text in the second, e.g., |^this is a free text administration note|. Refer to Table 0737 - Administration Notes in Chapter 2C for valid values.

RXG-10: Substitution Status (ID) 00322

Definition: Refer to HL7 Table 0167 - Substitution Status in Chapter 2C, Code Tables, for valid values.

Note: The next two fields are equivalent to the corresponding fields of the RXE segment. They are included (optionally) in the RXG so that it may "stand alone" as a "give" instruction segment.

RXG-11: Dispense-to Location () 01303

Definition: This field is retained for backward compatibility only as of v 2.6 and removed from the standard as of v 2.8. The reader is referred to RXG-27 and RXG-28.

RXG-12: Needs Human Review (ID) 00307

Definition: Refer to HL7 Table 0136 - Yes/No Indicator for valid values. The values have the following meaning for this field:

Y Yes - Indicates that a warning is present. The application receiving the dispense order needs to warn the person dispensing/administering the drug or treatment to pay attention to the text in RXG-13-Special administration instructions.

N No - Indicates no warning is present. This is the equivalent default (null) value.

RXG-13: Special Administration Instructions (CWE) 00343

Definition: This field contains pharmacy/treatment supplier-generated special instructions to the provider administering the order. Refer to Table 0738 - Special Administration Instructions in Chapter 2C for valid values.

RXG-14: Give Per (ST) 00331

Definition: This field contains the time unit to use to calculate the rate at which the pharmaceutical/treatment is to be administered.

Format:

S<integer>	=	<integer> seconds
M<integer>	=	<integer> minutes
H<integer>	=	<integer> hours
D<integer>	=	<integer> days
W<integer>	=	<integer> weeks
L<integer>	=	<integer> months
T<integer>	=	at the interval and amount stated until a total of <integer> "DOSAGE" is accumulated. Units would be assumed to be the same as in the QUANTITY field.
INDEF	=	do indefinitely - also the default

This is the same as the format specified for the DURATION component of the quantity/timing field, excluding the "X" specification.

Required when relevant (e.g., certain IVs). For example, if the "give amount/units" were 300 ml and the "give per" time unit were H1 (equivalent to one hour), the rate is 300ml/hr.

RXG-15: Give Rate Amount (ST) 00332

Definition: This field contains the amount (number) of substance/treatment to be administered.

RXG-16: Give Rate Units (CWE) 00333

Definition: This field contains the units for RXG-15-give rate amount. May be composite. The ratio of the RXG-15-give rate amount and RXG-16-give rate units fields define the actual rate of administration. Thus, if RXG-15-give rate amount = 100 and RXG-16-give rate units = ml/hr, the requested rate of administration is 100 ml/hr. Refer to Table 0740 - Give Rate Units in Chapter 2C for valid values.

RXG-17: Give Strength (NM) 01126

Definition: Use when RXG-4-Give code does not specify the strength. This is the numeric part of the strength, used in combination with RXG-18-Give strength units.

RXG-18: Give Strength Units (CWE) 01127

Definition: Use when RXG-4-Give Code does not specify the strength. This is the unit of the strength, used in combination with RXG-17-Give Strength. Refer to Table 0741 - Give Strength Units in Chapter 2C for valid values.

Note: These units can be a "compound quantity"; i.e., the units may express a quantity per unit of time. For example, micrograms per hour (micg/h) is an acceptable value. These compound units are contained in the ISO+ table. See Chapter 7 for full definition of ISO+ units.

RXG-19: Substance Lot Number (ST) 01129

Definition: This field contains the lot number of the medical substance administered.

Note: The lot number is the number printed on the label attached to the container holding the substance and on the packaging which houses the container. If the substance is a vaccine, for example, and a diluent is required, a lot number may appear on the vial containing the diluent; however, any such identifier associated with a diluent is not the identifier of interest. The substance lot number should be reported, not that of the diluent.

RXG-20: Substance Expiration Date (DTM) 01130

Definition: This field contains the expiration date of the medical substance administered.

Note: Vaccine expiration date does not always have a "day" component; therefore, such a date may be transmitted as YYYYMM.

RXG-21: Substance Manufacturer Name (CWE) 01131

Definition: This field contains the manufacturer of the medical substance administered.

Note: For vaccines, code system MVX may be used to code this field (see section4A.7.1, "Vaccine administration data"). This field may be used if the manufacturer of the substance is not identified by the code used in RXA-5-administered code.

RXG-22: Indication (CWE) 01123

Definition: This field contains the identifier of the condition or problem for which the drug/treatment was prescribed. May repeat if multiple indications are relevant. Refer to Table 0743 - Indication in Chapter 2C for valid values.

RXG-23: Give Drug Strength Volume (NM) 01692

Description: This numeric field defines the volume measurement in which the drug strength concentration is contained. For example, Acetaminophen 120 MG/5ML Elixir means that 120 MG of the drug is in a solution with a volume of 5 ML, which would be encoded in RXG-17, RXG-18, RXG-23 and RXG-24 as:

RXG|||||||||||||||||120|mg^^ISO|||||5|ml^^ISO ...<cr>

RXG-24: Give Drug Strength Volume Units (CWE) 01693

Description: This field indicates the volumetric unit associated with RXG-23 Give Drug Strength Volume. See example in RXG-23. Refer to Table 0744 - Give Drug Strength Volume Units in Chapter 2C for valid values.

RXG-25: Give Barcode Identifier (CWE) 01694

Definition: This field contains the pharmacy system's assigned barcode number for the give occurrence. For IV orders, many pharmacy systems generate a barcode number to identify a specific bag/bottle of the order. This number can be an instance identifier; unique for the patient, drug combination, and schedule instance or it may be just a drug identifier. Refer to Table 0745 - Give Barcode Identifier in Chapter 2C for valid values.

The composition and use of the barcode number is dependent on application negotiation. An example of this field follows: The barcode number is in the following format, 9XXXXXXX000. The number '9' is a constant, XXXXXXX is seven (7) characters for a unique identifier assigned or derived from the patient account and order ID and 000 is the zero-filled three (3) character IV bottle number.

The maximum length of the first component of this field is 40 characters to allow for the maximum existing barcode length in use today. The second component contains the description of the item being coded and the third component may define the barcode type.

12345678901^IV bottle^3X9

RXG-26: Pharmacy Order Type (ID) 01695

Definition: The Pharmacy Order Type field defines the general category of pharmacy order which may be used to determine the processing path the order will take. Refer to HL7 Table 0480 Pharmacy Order Types in Chapter 2C, Code Tables, for valid values.

This field may also be used for grouping of related orders for processing and/or reports. For example, Medication Administration Records (MARs) often group large volume solutions, medications and small volume solutions differently based upon site-specific workflow.

Usage Rule: This field is optional for all Pharmacy transactions. When not populated, a default value of "M" is assumed.

RXG-27: Dispense to Pharmacy (CWE) 01688

Attention: This field was retained for backward compatibilty only as of v 2.7 and the detail was withdrawn and removed from the standard as of v 2.9. The reader is referred to the PRT segment described in Chapter 7.

RXG-28: Dispense to Pharmacy Address (XAD) 01689

RXG-29: Deliver-to Patient Location (PL) 01683

Definition: This field specifies the location of the patient to whom the pharmaceutical substance is to be delivered.

RXG-30: Deliver-to Address (XAD) 01684

Definition: This field specifies the address, either mailing or physical, to which the prescription should be mailed or delivered.

RXG-31: Give Tag Identifier (EI) 03393

Definition: This field contains an identifier for the individual product instance for the dispense occurrence. This may represent a barcode, RFID or other means of automatically-readable product instance. Repetitions represent the same instance where more than one barcode, RFID or other identification is present.

For example, the medication preparer, e.g., a semi-automated system, can inform the nurse that "for the 8.am administration event, the medication that has been assigned and available at the patient bedside has the barcode BBBBBBBBBBB." The nurse would scan the barcode to ensure that the right medication is being administered.

This differs from RXG-25 Give Barcode Identifier in that RXG-25 may include other workflow content or the product at various levels of granularity. RXG-31 specifically identifies the product instance.

RXG-32: Dispense Amount (NM) 03316

Definition: This field contains the amount to be dispensed as encoded by the pharmacy or treatment supplier.

RXG-33: Dispense Units (CWE) 03317

Definition: This field contains the units for the dispense amount as encoded by the pharmacy or treatment supplier. This field is required if the units are not implied by the actual dispense code. This must be in simple units that reflect the actual quantity of the substance dispensed. It does not include compound units. Refer to Table 0746 - Dispense Units in Chapter 2C for valid values.

Draft Website - For Review Purposes Only