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

Draft Website - For Review Purposes Only

RXE - Pharmacy/Treatment Encoded Order Segment

The RXE segment details the pharmacy or treatment application's encoding of the order. It also contains several pharmacy-specific order status fields, such as RXE-16-number of refills remaining, RXE-17-number of refills/doses dispensed, RXE-18-D/T of most recent refill or dose dispensed, and RXE-19-total daily dose.

Note that ORC-7-quantity/timing has a different meaning from RXE-1-quantity/timing and RXG-3-quantity/timing. The pharmacy or treatment department has the "authority" (and/or necessity) to schedule dispense/give events. Hence, the pharmacy or treatment department has the responsibility to encode this scheduling information in RXE-1-quantity/timing and RXG-3-quantity/timing. ORC-7-quantity/timing does not change: it always specifies the requested give/dispense schedule of the original order.

HL7 Attribute Table - RXE - Pharmacy/Treatment Encoded Order Segment
Seq# Data Element Name DataType Usage Vocabulary Cardinality Item # Length C.LEN Flags
RXE
1 Quantity/Timing W [0..1] 00221
2 Give Code CWE R [1..1] 00317
3 Give Amount - Minimum NM R [1..1] 00318
4 Give Amount - Maximum NM O [0..1] 00319
5 Give Units CWE R [1..1] 00320
6 Give Dosage Form CWE O [0..1] 00321
7 Provider's Administration Instructions CWE O [0..*] 00298
8 Deliver-To Location W [0..1] 00299
9 Substitution Status ID O [0..1] 00322 [1..1]
10 Dispense Amount NM C [0..1] 00323
11 Dispense Units CWE C [0..1] 00324
12 Number Of Refills NM O [0..1] 00304 3 #
13 Ordering Provider's DEA Number XCN B [0..*] 00305
14 Pharmacist/Treatment Supplier's Verifier ID XCN B [0..*] 00306
15 Prescription Number ST C [0..1] 00325 20 #
16 Number of Refills Remaining NM C [0..1] 00326
17 Number of Refills/Doses Dispensed NM C [0..1] 00327
18 D/T of Most Recent Refill or Dose Dispensed DTM C [0..1] 00328
19 Total Daily Dose CQ C [0..1] 00329
20 Needs Human Review ID O [0..1] 00307 [1..1]
21 Special Dispensing Instructions CWE O [0..*] 00330
22 Give Per ST C [0..1] 00331 20 #
23 Give Rate Amount ST O [0..1] 00332 6 #
24 Give Rate Units CWE O [0..1] 00333
25 Give Strength NM O [0..1] 01126
26 Give Strength Units CWE O [0..1] 01127
27 Give Indication CWE O [0..*] 01128
28 Dispense Package Size NM O [0..1] 01220
29 Dispense Package Size Unit CWE O [0..1] 01221
30 Dispense Package Method ID O [0..1] 01222 [1..2]
31 Supplementary Code CWE O [0..*] 01476
32 Original Order Date/Time DTM O [0..1] 01673
33 Give Drug Strength Volume NM O [0..1] 01674 5 #
34 Give Drug Strength Volume Units CWE O [0..1] 01675
35 Controlled Substance Schedule CWE O [0..1] 01676
36 Formulary Status ID O [0..1] 01677 [1..1]
37 Pharmaceutical Substance Alternative CWE O [0..*] 01678
38 Pharmacy of Most Recent Fill CWE O [0..1] 01679
39 Initial Dispense Amount NM O [0..1] 01680
40 Dispensing Pharmacy CWE B [0..1] 01681
41 Dispensing Pharmacy Address XAD B [0..1] 01682
42 Deliver-to Patient Location PL O [0..1] 01683
43 Deliver-to Address XAD O [0..1] 01684
44 Pharmacy Order Type ID O [0..1] 01685 [1..1]
45 Pharmacy Phone Number XTN O [0..*] 02310

RXE-1: Quantity/Timing () 00221

Attention: The RXE-1 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.

RXE-2: Give Code (CWE) 00317

Definition: This field identifies the medical substance or treatment that has been ordered to be given to the patient, as encoded by the pharmacy or treatment supplier; it is equivalent to OBR-4-universal service ID in function. In the RXE segment, this give code must be fully encoded. The dispense fields, which define the units and amount of what is to be issued to the patient (see RXE-10-dispense amount and RXE-11-dispense units below) do not necessarily correlate with the instructions of what amount is to be "given" or administered with each dose, and may or may not be specified with the order. For example, the "give" part of the order may convey the field-representation of give 250 mg of Ampicillin, while the request to dispense part of the order may convey issue 30 tablets of generic equivalent for this outpatient prescription.

The coding system used is conditional on both the nature of the medical substance or treatment ordered and site-specific implementation considerations. For vaccines, HL7 Table 0292 – Vaccines Administered is the preferred coding system. For non-vaccine products, the coding system may be a local implementation of User-defined Table 0479 – Pharmaceutical Substances or an external coding system. Examples of external coding systems include, but are not limited to, National Drug Codes (NDC), Medispan Generic Product Identifier (MGPI), Drug Descriptor Identifier (DDID), and other drug codes listed in HL7 Table 0396 – Coding Systems. The following examples illustrate some code tables other than User-defined Table 0479:

NDC:                0006915404^Norvasc 10mg Tabs^NDC

DDID:                015189^Norvasc 10mg Tabs^DDID

CVX (HL70292):            30^HBIG^CVX

RXE-3: Give Amount - Minimum (NM) 00318

Definition: This field contains the ordered amount as encoded by the pharmacy or 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; 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).


RXE-4: Give Amount - Maximum (NM) 00319

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

RXE-5: Give Units (CWE) 00320

Definition: This field contains the units for the give amount as encoded by the pharmacy or treatment (e.g., respiratory therapy) application. Refer to Table 0715 - 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.

RXE-6: Give Dosage Form (CWE) 00321

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

RXE-7: Provider's Administration Instructions (CWE) 00298

Definition: This field contains the ordering provider's instructions to the patient or the provider administering the drug or treatment. If coded, a user-defined table must be used; if free text (describing a custom IV, mixture, or salve, for example), place the text in the second component, e.g., |^this is a free text administration instruction|.Refer to Table 0718 - Provider's Administration Instructions in Chapter 2C for valid values.

RXE-8: Deliver-To Location () 00299

Attention: The RXE-8 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.

RXE-9: Substitution Status (ID) 00322

Definition: Refer to HL7 Table 0167 - Substitution Status in Chapter 2C, Code Tables, for valid values. If a substitution has been made, and a record of the original requested give code (RXO-1-requested give code) is needed, the optional RXO segment can be included in the RDE message.

RXE-10: Dispense Amount (NM) 00323

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

RXE-11: Dispense Units (CWE) 00324

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 0720 - Dispense Units in Chapter 2C for valid values.

RXE-12: Number Of Refills (NM) 00304

Definition: This field contains the total original number of refills. Outpatient only.

RXE-13: Ordering Provider's DEA Number (XCN) 00305

Definition: This field is retained for backward compatibility only as of v 27. The reader is referred to the PRT segment described in Chapter 7.

This field is defined as conditional because it is required when the substance requested is a controlled substance (e.g., a narcotic). If the person referenced in this field is also referenced in PRT segment, they must contain the same information. However, if there is a difference, then PRT segment takes precedence.

RXE-14: Pharmacist/Treatment Supplier's Verifier ID (XCN) 00306

Definition: This field is retained for backward compatibility only as of v 27. The reader is referred to the PRT segment described in chapter 7.

This field contains the provider ID of Pharmacist/treatment supplier's verifier. Use if required by the pharmacy or treatment application or site on orders (or some subgroup of orders). If the person referenced in this field is also referenced in PRT segment, they must contain the same information. However, if there is a difference, then PRT segment takes precedence.

RXE-15: Prescription Number (ST) 00325

Definition: This field contains the prescription number as assigned by the pharmacy or treatment application. Equivalent in uniqueness to the pharmacy/treatment filler order number. At some sites, this may be the pharmacy or treatment system (internal) sequential form. At other sites, this may be an external form. This is a required field in RXE when used in pharmacy/treatment messages, but it is not required when used in product experience messages (see Chapter 7).

RXE-16: Number of Refills Remaining (NM) 00326

Definition: Number of refills remaining. This field is conditional because it is required when a prescription is dispensed to an outpatient. It is not relevant to inpatient treatment orders.

RXE-17: Number of Refills/Doses Dispensed (NM) 00327

Definition: Number of refills remaining. This field is conditional because it is required when a prescription is dispensed to an outpatient. It is not relevant to inpatient treatment orders.

RXE-18: D/T of Most Recent Refill or Dose Dispensed (DTM) 00328

Definition: Date/time of the most recent refill or dose dispensed.

RXE-19: Total Daily Dose (CQ) 00329

Definition: This field contains the total daily dose for this particular pharmaceutical as expressed in terms of actual dispense units.

RXE-20: Needs Human Review (ID) 00307

Definition: This field uses HL7 Table 0136 - Yes/No Indicator in Chapter 2C, Code Tables. The values have the following meaning for this field:

Y    Yes - Indicates that a warning is present. The application receiving the encoded order needs to warn the person administering the drug or treatment to pay attention to the text in RXE-21-pharmacy/treatment special dispensing instructions.

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

RXE-21: Special Dispensing Instructions (CWE) 00330

Definition: This field contains the pharmacy or treatment supplier's provider-generated special instructions to the provider dispensing/administering the order. Refer to Table 0721 - Special Dispensing Instructions in Chapter 2C for valid values.

RXE-22: Give Per (ST) 00331

Definition: This field contains the time unit to use to calculate the rate at which the pharmaceutical 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.

This field is defined as conditional because it is required when the ordered substance is to be administered continuously at a prescribed rate (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.

RXE-23: Give Rate Amount (ST) 00332

Definition: This field contains the rate at which the substance should be administered.

RXE-24: Give Rate Units (CWE) 00333

Definition: This field contains the units for RXE-23-give rate amount. May be composite. The ratio of the RXE-23-give rate amount and RXE-24-give rate units defines the actual rate of administration. Thus, if RXE-23-give rate amount = 100 and RXE-24-give rate units = ml/hr, the requested rate of administration is 100 ml/hr. (See ISO+ figure 7-9 in Chapter 7 for possible compound units codes.) Refer to Table 0722 - Give Rate Units in Chapter 2C for valid values.

RXE-25: Give Strength (NM) 01126

Definition: Use when RXE-2-give code does not specify the strength. This is the numeric part of the strength, used in combination with RXE-26-give strength units.

RXE-26: Give Strength Units (CWE) 01127

Definition: Use when RXE-2-Give Code does not specify the strength. This is the unit of the strength, used in combination with RXE-25-Give Strength. Refer to Table 0723 - 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.


RXE-27: Give Indication (CWE) 01128

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

RXE-28: Dispense Package Size (NM) 01220

Definition: This field contains the size of package to be dispensed. Units are transmitted in RXE-29-dispense package size unit.

RXE-29: Dispense Package Size Unit (CWE) 01221

Definition: This field contains the units in which RXE-28-dispense package size is denominated. Refer to Table 0726 - Dispense Package Size Unit in Chapter 2C for valid values.

RXE-30: Dispense Package Method (ID) 01222

Definition: This field contains the method by which treatment is dispensed. Refer to HL7 Table 0321 - Dispense Method in Chapter 2C, Code Tables, for valid values.

RXE-31: Supplementary Code (CWE) 01476

Definition: This field accommodates the identification of any codes that might be associated with the pharmaceutical substance. Common codes include: the Generic Product Identifier (GPI), Generic Code Number_Sequence Number (GCN_SEQNO), National Drug Code (NDC). Refer to Table 0727 - Supplementary Code in Chapter 2C for valid values.

RXE-32: Original Order Date/Time (DTM) 01673

Definition: This field contains the date/time of the original order (ORC-9) when a refill authorization is being requested. This was represented in the ORC-9 of the original order transaction.

RXE-33: Give Drug Strength Volume (NM) 01674

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 RXE-25, RXE-26, RXE-33 and RXE-34 as:

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

RXE-34: Give Drug Strength Volume Units (CWE) 01675

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

RXE-35: Controlled Substance Schedule (CWE) 01676

Definition: This field specifies the class of the drug or other substance if its usage is controlled by legislation. In the USA, such legislation includes the federal Controlled Substance Act (CSA) or a State Uniform Controlled Substance Act. Refer to User-defined table 0477 – Controlled Substance Schedule in Chapter 2C, Code Tables, for valid values for USA usage. Other countries should create their own versions of this table.

Because some jurisdictions may extend the list of drugs in a particular class and may create an additional schedule, table 0477 is user-defined.

RXE-36: Formulary Status (ID) 01677

Definition: This field specifies whether or not the pharmaceutical substance is part of the local formulary. Refer to HL7 table 0478 - Formulary Status in Chapter 2C, Code Tables, for valid values.

RXE-37: Pharmaceutical Substance Alternative (CWE) 01678

Definition: This field specifies a pharmaceutical substance that is in the formulary that could be prescribed in lieu of the substance being prescribed. In the case where the specified medication is non-formulary this field would contain therapeutic alternatives that are on the formulary. Refer to Table 0730 - Pharmaceutical Substance Alternative in Chapter 2C for valid values.

RXE-38: Pharmacy of Most Recent Fill (CWE) 01679

Definition: This field specifies the pharmacy that last filled the prescription. Refer to Table 0732 - Pharmacy of Most Recent Fill in Chapter 2C for valid values.

RXE-39: Initial Dispense Amount (NM) 01680

Definition: This field specifies the quantity dispensed on the original fill (first fill) of a prescription when that amount is not the same as the quantity to be used in refills. One use case is when a new medication is being prescribed and the prescriber wants to determine if the patient will tolerate the medication. The prescriber indicates that the medication should be filled for an initial amount of 30 tablets and, if tolerated, refilled using a quantity of 100 tablets. In this case, RXE-39 would contain 30 and RXE-10 would contain 100.

If this field is not populated, then the initial dispense amount is the same as RXE-10.

The units are identified in RXE-11.

RXE-40: Dispensing Pharmacy (CWE) 01681

Definition: This field is retained for backward compatibility only as of v 27. The information formerly communicated using this field should now be communicated using the PRT segment. The reader is referred to chapter 7 for a description of that segment. Refer to Table 0733 - Dispensing Pharmacy in Chapter 2C for valid values.

This field specifies the pharmacy that will dispense or has dispensed the prescription. In the context of an order/request (i.e., in an RXO segment) this field represents the requested dispensing pharmacy. In the context of a registered order (i.e., in an RXE segment) this field represents the intended dispensing pharmacy, the pharmacy that is expected to dispense the prescription.

RXE-41: Dispensing Pharmacy Address (XAD) 01682

Definition: This field is retained for backward compatibility only as of v 27. The information formerly communicated using this field should now be communicated using the PRT segment. The reader is referred to chapter 7 for a description of that segment.

This field specifies the address of the dispensing facility.

RXE-42: Deliver-to Patient Location (PL) 01683

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

RXE-43: Deliver-to Address (XAD) 01684

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

RXE-44: Pharmacy Order Type (ID) 01685

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.

RXE-45: Pharmacy Phone Number (XTN) 02310

Definition: This field contains the telecommunication contact information for the pharmacy. Repetitions may be supplied for various device types or use codes, or multiple instances of the same type or use. This concept also exists as RXO-36 and RXD-34 to support pharmacy contact information in the context of the order, the encoded order and the dispense.