DIS - Discharge

Treatment episode discharge records

Record Type: DIS | Version: CoBHRM 2026-Q3 | Parent: ADMISSION

Overview

The DISCHARGE schema captures information about the end of a treatment episode. A discharge record closes an open admission and allows for outcome tracking. Each admission can have at most one discharge record.

Transaction Types: All record types support Add (A), Update (U), and Replace (R) transactions. See Transaction Types for details.

---

1. Schema Reference

Identifier Fields

BHA Column Name	Field Name	Format	Required	Valid Values	Notes
RECORD_TYPE	Record Type	x(3)	Y	DIS	Must be exact, case-sensitive
TRANSACTION_TYPE	Transaction Type	x(1)	Y	A, U, R	See Transaction Types
BHASO_ADMISSION_IDENTIFIER	Admission Identifier	x(-)	Y	Alphanumeric	Must exist in ADMISSION
EFFECTIVE_DATE	Effective Date	date	Y	YYYY-MM-DD

Discharge Detail Fields

BHA Column Name	Field Name	Format	Required	Valid Values	Notes
LAST_CONTACT_DATE	Date of Last Contact	date	Y	YYYY-MM-DD	Date sequence: Admission Date ≤ Last Contact Date ≤ Discharge Date
DISCHARGE_DATE	Discharge Date	date	Y	YYYY-MM-DD	Date sequence: Admission Date ≤ Last Contact Date ≤ Discharge Date
DISCHARGE_STATUS	Discharge Type / Status	9(2)	Y	See Discharge Type
END_OF_TREATMENT_REASON	End of Treatment Reason	9(2)	Conditional	See End of Treatment Reason	Required if Discharge Type = 03 (Treatment Not Completed At This Facility)

Status at Discharge Fields

BHA Column Name	Field Name	Format	Required	Valid Values	Notes
ARRESTS_PAST_30_DAYS	Arrests in Past 30 Days	9(2)	Y	0-30
EMPLOYMENT_STATUS	Employment Status	9(2)	Y	See Employment Status
LIVING_SITUATION	Living Situation	9(2)	Y	See Living Situation
SELFHELP_ATTENDANCE	Self Help / Peer Support Attendance	9(2)	Y	0-30	Last 30 days at discharge
EDUCATION_LEVEL	Education Level	x(2)	Y	See Education Level
SCHOOL_ATTENDANCE	School Attendance Status	9(1)	Y	See School Attendance Status	Ages 3-17: must be 1 (full-time) or 2 (part-time), or 99 if unknown. All others: must be 3 (not enrolled). Previous 3 months
LEGAL_STATUS	Legal Status	9(2)	Y	See Legal Status	Statutory commitment at any time during treatment

Legal Status / Service Identifier cross-validation (pending update — expected to change before April 1, 2026):

• Legal Status 13 (Emergency Commitment) requires WM services only (01, 02, 12)
• Legal Status 08 (Involuntary Alcohol/Drug Commitment) requires SUD services only (03-11)
• Legal Status 02-07, 09-12 requires MH services only (17-22)

Both the Legal Status and Service Identifier code lists have been renumbered. The mapping above references the previous numbering and will be updated once the new cross-validation matrix is finalized. See Cross-Tab Dependencies for details.

System Metadata Fields

These fields are required in every submission and track record creation and modification:

BHA Column Name	Field Name	Format	Required	Notes
CREATED_DATE	Created Date	yyyy-mm-dd HH24:MI:SS.FF	Y	Date/time record was created
CREATED_BY	Created By	x(100)	Y	User/system that created the record
LAST_UPDATED_DATE	Last Updated Date	yyyy-mm-dd HH24:MI:SS.FF	Y	If TRANSACTION_TYPE = A, must equal CREATED_DATE

---

2. Examples

Minimal Valid Example

Treatment completed successfully. All required fields populated.

RECORD_TYPE|TRANSACTION_TYPE|BHASO_ADMISSION_IDENTIFIER|EFFECTIVE_DATE|LAST_CONTACT_DATE|DISCHARGE_DATE|DISCHARGE_STATUS|END_OF_TREATMENT_REASON|ARRESTS_PAST_30_DAYS|EMPLOYMENT_STATUS|LIVING_SITUATION|SELFHELP_ATTENDANCE|EDUCATION_LEVEL|SCHOOL_ATTENDANCE|LEGAL_STATUS|CREATED_DATE|CREATED_BY|LAST_UPDATED_DATE
DIS|A|ADM-000001|2024-06-15|2024-06-10|2024-06-15|01||0|02|15|8|12|02|01|2024-06-15 10:00:00|system|2024-06-15 10:00:00

Complete Example with End of Treatment Reason

Discharge with DISCHARGE_STATUS = 03 (Treatment Not Completed), which triggers the END_OF_TREATMENT_REASON conditional requirement.

RECORD_TYPE|TRANSACTION_TYPE|BHASO_ADMISSION_IDENTIFIER|EFFECTIVE_DATE|LAST_CONTACT_DATE|DISCHARGE_DATE|DISCHARGE_STATUS|END_OF_TREATMENT_REASON|ARRESTS_PAST_30_DAYS|EMPLOYMENT_STATUS|LIVING_SITUATION|SELFHELP_ATTENDANCE|EDUCATION_LEVEL|SCHOOL_ATTENDANCE|LEGAL_STATUS|CREATED_DATE|CREATED_BY|LAST_UPDATED_DATE
DIS|A|ADM-000002|2024-07-20|2024-07-15|2024-07-20|03|03|0|04|15|0|12|01|01|2024-07-20 11:00:00|jdoe|2024-07-20 11:00:00

END_OF_TREATMENT_REASON = 03 means “Client stopped coming and contact efforts failed.” This field is only required when DISCHARGE_STATUS = 03.

Edge Case: Transfer to Another Program

Client transferred to another substance use treatment program (DISCHARGE_STATUS = 02).

RECORD_TYPE|TRANSACTION_TYPE|BHASO_ADMISSION_IDENTIFIER|EFFECTIVE_DATE|LAST_CONTACT_DATE|DISCHARGE_DATE|DISCHARGE_STATUS|END_OF_TREATMENT_REASON|ARRESTS_PAST_30_DAYS|EMPLOYMENT_STATUS|LIVING_SITUATION|SELFHELP_ATTENDANCE|EDUCATION_LEVEL|SCHOOL_ATTENDANCE|LEGAL_STATUS|CREATED_DATE|CREATED_BY|LAST_UPDATED_DATE
DIS|A|ADM-000003|2024-08-30|2024-08-28|2024-08-30|02||0|01|15|4|14|01|01|2024-08-30 09:00:00|system|2024-08-30 09:00:00

---

3. Template

View DISCHARGE Template

DISCHARGE schema template with headers and sample row

---

4. Parsing Rules

CSV Parsing Rules

Property	Value
Encoding	UTF-8
Delimiter	Pipe (|)
Quote Character	Double quote (")
Escape	Backslash (\)
Date Format	YYYY-MM-DD
Timestamp Format	YYYY-MM-DD HH24:MI:SS.FF (Mountain Time)
Null Representation	Empty field (||)

See File Format Requirements for full details on encoding, quoting, data types, and null handling.

---

5. Update Semantics

Primary Key

RECORD_TYPE + BHASO_ADMISSION_IDENTIFIER (one discharge per admission)

Transaction Types

Type	Code	Behavior
Add	A	Creates discharge record; fails if discharge exists for admission
Update	U	Updates existing discharge record
Replace	R	Overwrites discharge record

Idempotency

• Only one discharge record per BHASO_ADMISSION_IDENTIFIER
• Once discharged, case cannot receive new clinical records
• Re-admission requires new BHASO_ADMISSION_IDENTIFIER

---

Related Schemas

Schema	Relationship	Key Field
CLIENT	Grandparent	BHASO_CLIENT_IDENTIFIER
ADMISSION	Parent	BHASO_ADMISSION_IDENTIFIER
DIAGNOSIS (DXD)	Sibling (same admission)	BHASO_ADMISSION_IDENTIFIER
SUBSTANCE USE (SID)	Sibling (same admission)	BHASO_ADMISSION_IDENTIFIER

DXD and SID records are filled out when a discharge occurs, but they link directly to the Admission via BHASO_ADMISSION_IDENTIFIER — they are not children of the Discharge record.