Overview
The BTX (Blood Product Transfusion/Disposition) segment communicates the final transfusion or disposition outcome for a blood product previously ordered with a BPO and dispensed with a BPX. BTX is delivered inside a blood-product transfusion/disposition response (BTS). It carries the donation ID, component coding, blood group, commercial-product details, quantity and amount, transfusion/disposition status, message status, the date/time of status, the administering and verifying clinicians, transfusion start/end timestamps, any adverse-reaction codes, and the reason a transfusion was interrupted.
When to use BTX
Use BTX whenever the blood bank or clinical unit needs to communicate the disposition of a unit that was previously dispensed: transfused, partially transfused, returned, wasted, or quarantined following an adverse reaction. Each BTX repetition reports one disposed unit and is paired to the matching BPO/BPX repetitions inside the bb-products group.
Field-by-field reference
The following table reflects the HAPI HL7v2 v2.5.1 javadoc for BTX. Required indicators mirror the HL7 v2.5.1 standard for blood-product transfusion/disposition reporting. Lengths are not enforced by HAPI and are shown as "—".
| Seq | Name | Data Type | Length | Req | Repeat | Table # | Description |
|---|---|---|---|---|---|---|---|
| BTX-1 | Set ID - BTX | si | — | R | — | — | Sequential number identifying this BTX |
| BTX-2 | BC Donation ID | ei | — | O | — | — | Unique donation identifier from collection facility |
| BTX-3 | BC Component | cne | — | O | — | — | Coded blood component being disposed |
| BTX-4 | BC Blood Group | cne | — | O | — | — | ABO and Rh blood group of the unit |
| BTX-5 | CP Commercial Product | cwe | — | O | — | — | Commercial product code for derivatives |
| BTX-6 | CP Manufacturer | xon | — | O | — | — | Manufacturer of the commercial product |
| BTX-7 | CP Lot Number | ei | — | O | — | — | Lot number of the commercial product |
| BTX-8 | BP Quantity | nm | — | O | — | — | Number of units transfused or disposed |
| BTX-9 | BP Amount | nm | — | O | — | — | Numeric amount actually administered |
| BTX-10 | BP Units | ce | — | O | — | — | Units of measure for BP Amount |
| BTX-11 | BP Transfusion/Disposition Status | cwe | — | R | — | [HL70513] | Final transfusion or disposition status |
| BTX-12 | BP Message Status | id | — | R | — | [HL70512] | Overall status of the disposition message |
| BTX-13 | BP Date/Time of Status | ts | — | R | — | — | Date/time the disposition status was set |
| BTX-14 | BP Administrator | xcn | — | O | — | — | Clinician who administered the transfusion |
| BTX-15 | BP Verifier | xcn | — | O | — | — | Clinician who verified unit and patient |
| BTX-16 | BP Transfusion Start Date/Time of Status | ts | — | O | — | — | Date/time the transfusion was started |
| BTX-17 | BP Transfusion End Date/Time of Status | ts | — | O | — | — | Date/time the transfusion completed |
| BTX-18 | BP Adverse Reaction Type | cwe | — | O | Y | [HL70514] | Coded adverse reaction(s) observed |
| BTX-19 | BP Transfusion Interrupted Reason | cwe | — | O | — | — | Reason a transfusion was interrupted |
Examples
Minimal BTX
BTX|1|||||||||TX^Transfused^HL70513|SC^Status Change^HL70512|20260610154500
Fully populated BTX
BTX|1|W0312625001324^^MNTR&2.16.840.1.113883.19.4.10&ISO|RBC^Red Blood Cells^HL70388|A POS^A Positive^HL70389||||1|250|mL^milliliters^ISO+|TX^Transfused^HL70513|SC^Status Change^HL70512|20260610154500|55667788^Okafor^Ada^^^^MT|66778899^Nguyen^Linh^^^^RN|20260610150500|20260610154500||
Annotated breakdown
BTX|1|W0312625001324^^MNTR&...&ISO|RBC^Red Blood Cells^HL70388|A POS^A Positive^HL70389|...
│ │ │ │
│ │ │ └─ BTX-4 BC Blood Group
│ │ └─ BTX-3 BC Component
│ └─ BTX-2 BC Donation ID
└─ BTX-1 Set ID = 1
...||||1|250|mL^milliliters^ISO+|TX^Transfused^HL70513|SC^Status Change^HL70512|20260610154500|...
│ │ │ │ │ │
│ │ │ │ │ └─ BTX-13 BP Date/Time of Status
│ │ │ │ └─ BTX-12 BP Message Status
│ │ │ └─ BTX-11 BP Transfusion/Disposition Status
│ │ └─ BTX-10 BP Units
│ └─ BTX-9 BP Amount
└─ BTX-8 BP Quantity
...|55667788^Okafor^Ada^^^^MT|66778899^Nguyen^Linh^^^^RN|20260610150500|20260610154500||
│ │ │ │ │
│ │ │ │ └─ BTX-19 Transfusion Interrupted Reason
│ │ │ └─ BTX-17 BP Transfusion End Date/Time
│ │ └─ BTX-16 BP Transfusion Start Date/Time
│ └─ BTX-15 BP Verifier
└─ BTX-14 BP Administrator
Used in
BTX is reported inside the blood-product transfusion/disposition response (BTS) generated for a BPS blood-product dispense status message. One BTX appears per disposed unit within the bb-products group, paired with the parent BPO and the dispense status BPX.
Excerpt — BTS (transfusion/disposition response)
MSH|^~&|BBANK|MERCY|EHR|MERCY|20260610154500||BTS^O32^BTS_O32|MSG00027311|P|2.5.1
PID|1||MRN884213^^^MERCY^MR||Reyes^Mateo^J||19710423|M
ORC|RE|ORD-994412|FLR-553201||CM||||20260610154500|||11223344^Patel^Ravi
BPO|1|RBC^Red Blood Cells^HL70388|1|20260610080000
BPX|1|DI^Dispensed^HL70510|SC^Status Change^HL70511|20260610091200||W0312625001324^^MNTR&2.16.840.1.113883.19.4.10&ISO|RBC^Red Blood Cells^HL70388|A^Allogeneic^HL70417||||A POS^A Positive^HL70389||20260618235900|1|250|mL^milliliters^ISO+|BPU-2026-009912
BTX|1|W0312625001324^^MNTR&2.16.840.1.113883.19.4.10&ISO|RBC^Red Blood Cells^HL70388|A POS^A Positive^HL70389||||1|250|mL^milliliters^ISO+|TX^Transfused^HL70513|SC^Status Change^HL70512|20260610154500|55667788^Okafor^Ada^^^^MT|66778899^Nguyen^Linh^^^^RN|20260610150500|20260610154500||
Excerpt — BRP (dispense status response) cross-reference
MSH|^~&|BBANK|MERCY|EHR|MERCY|20260610091500||BRP^O30^BRP_O30|MSG00027183|P|2.5.1
PID|1||MRN884213^^^MERCY^MR||Reyes^Mateo^J||19710423|M
ORC|SC|ORD-994412|FLR-553201||CM||||20260610091200
BPO|1|RBC^Red Blood Cells^HL70388|1|20260610080000
BPX|1|DI^Dispensed^HL70510|SC^Status Change^HL70511|20260610091200||W0312625001324^^MNTR&2.16.840.1.113883.19.4.10&ISO|RBC^Red Blood Cells^HL70388|A^Allogeneic^HL70417||||A POS^A Positive^HL70389|CMV-^CMV Negative^HL70388|20260618235900|1|250|mL^milliliters^ISO+|BPU-2026-009912
The donation ID (BPX-5 / BTX-2) is the durable join key across the dispense (BRP) and disposition (BTS) responses, while ORC and BPO carry the same order identifiers throughout the lifecycle.
FHIR mapping
No segment-level ConceptMap is published in the v2-to-FHIR IG for BTX. The information conveyed by BTX maps conceptually to FHIR MedicationAdministration (referencing a BiologicallyDerivedProduct), with adverse reaction data (BTX-18) flowing to AdverseEvent and the administering and verifying clinicians populating MedicationAdministration.performer.
Implementation notes
- BTX-11 (HL70513) is the clinical outcome — Transfused (TX), Partial Transfusion (PT), Returned (RA), Wasted (WA), etc. BTX-12 (HL70512) is the high-level message status — receiving systems should not rely on BTX-12 alone to drive clinical logic.
- BTX-18 is the only repeating field — use the
~separator to convey multiple adverse reactions observed during a single transfusion. - Populate BTX-16 and BTX-17 whenever the unit was actually administered; downstream analytics rely on these timestamps to compute transfusion duration.
- BTX-19 should be populated only when BTX-11 indicates an interrupted or partial transfusion, and should reference the same patient-facing adverse-reaction context as BTX-18 when applicable.
