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

Draft Website - For Review Purposes Only

RXD - Pharmacy/Treatment Dispense Segment

HL7 Attribute Table - RXD - Pharmacy/Treatment Dispense Segment
Seq# Data Element Name DataType Usage Vocabulary Cardinality Item # Length C.LEN Flags
RXD
1 Dispense Sub-ID Counter NM R [1..1] 00334 4 #
2 Dispense/Give Code CWE R [1..1] 00335
3 Date/Time Dispensed DTM R [1..1] 00336
4 Actual Dispense Amount NM R [1..1] 00337
5 Actual Dispense Units CWE C [0..1] 00338
6 Actual Dosage Form CWE O [0..1] 00339
7 Prescription Number ST R [1..1] 00325 20 #
8 Number of Refills Remaining NM C [0..1] 00326
9 Dispense Notes ST O [0..*] 00340 200 #
10 Dispensing Provider XCN B [0..*] 00341
11 Substitution Status ID O [0..1] 00322 [1..1]
12 Total Daily Dose CQ O [0..1] 00329
13 Dispense-to Location W [0..1] 01303
14 Needs Human Review ID O [0..1] 00307 [1..1]
15 Special Dispensing Instructions CWE O [0..*] 00330
16 Actual Strength NM O [0..1] 01132
17 Actual Strength Unit CWE O [0..1] 01133
18 Substance Lot Number ST O [0..*] 01129 20 #
19 Substance Expiration Date DTM O [0..*] 01130
20 Substance Manufacturer Name CWE O [0..*] 01131
21 Indication CWE O [0..*] 01123
22 Dispense Package Size NM O [0..1] 01220
23 Dispense Package Size Unit CWE O [0..1] 01221
24 Dispense Package Method ID O [0..1] 01222 [1..2]
25 Supplementary Code CWE O [0..*] 01476
26 Initiating Location CWE O [0..1] 01477
27 Packaging/Assembly Location CWE O [0..1] 01478
28 Actual Drug Strength Volume NM O [0..1] 01686 5 #
29 Actual Drug Strength Volume Units CWE O [0..1] 01687
30 Dispense to Pharmacy CWE B [0..1] 01688
31 Dispense to Pharmacy Address XAD B [0..1] 01689
32 Pharmacy Order Type ID O [0..1] 01690 [1..1]
33 Dispense Type CWE O [0..1] 01691
34 Pharmacy Phone Number XTN O [0..*] 02311
35 Dispense Tag Identifier EI O [0..*] 03392

RXD-1: Dispense Sub-ID Counter (NM) 00334

Definition: This field starts with 1 the first time that medication/treatment is delivered/dispensed for this order. Increments by one with each additional issuance.

RXD-2: Dispense/Give Code (CWE) 00335

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

Note: The contents of RXD-2-dispense/give code should be compatible with the comparable field in the RXE (RXE-2-give code). The RDS message refers ONLY to the dispensing of the drug or treatment by the pharmacy or treatment supplier.


RXD-3: Date/Time Dispensed (DTM) 00336

Definition: This field indicates when the pharmaceutical/treatment is dispensed from the pharmacy or treatment supplier. Use the time stamp format.

RXD-4: Actual Dispense Amount (NM) 00337

Definition: This field indicates the amount dispensed.

RXD-5: Actual Dispense Units (CWE) 00338

Definition: This field indicates the units dispensed. Site-defined table. This field is required if the units are not implied by the actual dispense code. If present, it overrides units 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 0704 - Actual Dispense Units in Chapter 2C for valid values.

RXD-6: Actual Dosage Form (CWE) 00339

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 dispense/give code in RXD-2-dispense/give code. Use this field when the give code and the dispense code do not specify the dosage form. Refer to Table 0705 - Actual Dosage Form in Chapter 2C for valid values.

RXD-7: Prescription Number (ST) 00325

Definition: This field is equivalent in uniqueness to the pharmacy/treatment supplier filler order number. At some sites, this may be the pharmacy/treatment supplier (internal) sequential form. At other sites, this may be an external number.

RXD-8: Number of Refills Remaining (NM) 00326

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

RXD-9: Dispense Notes (ST) 00340

Definition: This field contains free text notes to the person dispensing 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). This may contain free text describing a custom IV, mixture, or salve for example.

RXD-10: Dispensing Provider (XCN) 00341

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 the person dispensing the pharmaceutical. 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.

RXD-11: Substitution Status (ID) 00322

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

RXD-12: Total Daily Dose (CQ) 00329

Definition: This field contains the total daily dose being dispensed as expressed in terms of the actual dispense units.

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


RXD-13: Dispense-to Location () 01303

Definition: This field is retained for backward compatibility only as of v 2.6 and withdrawn from the standard as of v 2.8. The reader is referred toRXD-30 and RXD-31.

RXD-14: 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 RXD-15-Special dispensing instructions.

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

RXD-15: Special Dispensing Instructions (CWE) 00330

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

RXD-16: Actual Strength (NM) 01132

Definition: Use when RXD-2-Dispense/Give Code does not specify the strength. This is the numeric part of the strength, of a single dosage unit of the dispensed product, used in combination with RXD-17-actual strength unit.

RXD-17: Actual Strength Unit (CWE) 01133

Definition: Use when RXD-2-Dispense/Give Code does not specify the strength. This is the unit of the strength, of a single dosage unit of the dispensed product, used in combination with RXD-16-actual strength. Refer to Table 0707 - Actual Strength Unit 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.


RXD-18: 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.


RXD-19: 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^L.


RXD-20: Substance Manufacturer Name (CWE) 01131

Definition: This field contains the manufacturer of the medical substance administered when it is a manufactured substance.

Note: For vaccines, code system MVX may be used to code this field. See Section 4A.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.


RXD-21: 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 0708 - Indication in Chapter 2C for valid values.

RXD-22: Dispense Package Size (NM) 01220

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

RXD-23: Dispense Package Size Unit (CWE) 01221

Definition: This field contains the units in which RXE-28-dispense package size is denominated. The advertised number of units in the manufacturer's package, i.e., the package as it comes from the supplier. Refer to Table 0709 - Dispense Package Size Unit in Chapter 2C for valid values.

RXD-24: 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.

RXD-25: 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 0710 - Supplementary Code in Chapter 2C for valid values.

RXD-26: Initiating Location (CWE) 01477

Definition: This field identifies the pharmacy or other treatment dispensing service (e.g., respiratory) that received the initial request. Refer to Table 0711 - Initiating Location in Chapter 2C for valid values.

Example: Pharmacy A (the Intake/Receiving) receives a phone call from the patient requesting a medication refill, but stipulates that the prescription will be picked up in pharmacy B. In accordance with the business process the prescription will be packaged/assembled in Pharmacy C.

RXD-27: Packaging/Assembly Location (CWE) 01478

Definition: This field identifies the pharmacy which packaged/assembled request. Refer to Table 0712 - Packaging/Assembly Location in Chapter 2C for valid values.

RXD-28: Actual Drug Strength Volume (NM) 01686

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 RXD-16, RXD-17, RXD-28 and RXD-29 as

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

RXD-29: Actual Drug Strength Volume Units (CWE) 01687

Description: This field indicates the volumetric unit associated with RXD-28 Actual Drug Strength Volume. See example in RXD-28. Refer to Table 0713 - Actual Drug Strength Volume Units in Chapter 2C for valid values.

RXD-30: Dispense to Pharmacy (CWE) 01688

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 0714 - Dispense to 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.

RXD-31: Dispense to Pharmacy Address (XAD) 01689

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 or the patient's location where the dispensing will occur.

RXD-32: Pharmacy Order Type (ID) 01690

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.

RXD-33: Dispense Type (CWE) 01691

Definition: This is the type of dispensing event that occurred. Refer to User-defined Table 0484 – Dispense Type for suggested values.

RXD-34: Pharmacy Phone Number (XTN) 02311

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 RXE-45 to support pharmacy contact information in the context of the order, the encoded order and the dispense.

RXD-35: Dispense Tag Identifier (EI) 03392

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-automatic system, can inform the nurse that "for the 8 a.m. 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.