Relates a practitioner (identified in the preceding STF) to a specific organizational unit, including the department, practicing specialty at that unit, and employment status. It follows STF in MFN staff master file messages and supports situations where the same practitioner has different roles or specialties at different organizational units within the institution.
from zato.hl7v2.v2_9 import ORG
from zato.hl7v2.v2_9 import XON, CWE
org = ORG()
org.primary_key_value_org = '1'
org.organization_unit_identifier = XON(
organization_name='FITNESS',
id_number='FIT001'
)
org.organization_unit_type = CWE(
identifier='DEPT',
text='Department',
name_of_coding_system='HL70464'
)
name = XON(organization_name='Active Life Wellness')
org.organization_name = nameHow to construct and work with real-world ORG segments.
Primary exercise and physical therapy department
from zato.hl7v2.v2_9 import ORG
from zato.hl7v2.v2_9 import XON, CWE
org = ORG()
org.primary_key_value_org = '1'
org.organization_unit_identifier = XON(
organization_name='FITNESS',
id_number='FIT001'
)
org.organization_unit_type = CWE(
identifier='DEPT',
text='Department',
name_of_coding_system='HL70464'
)
org.organization_name = XON(organization_name='Active Life Wellness')
org.organization_unit = CWE(
identifier='FIT',
text='Fitness Department',
name_of_coding_system='HL70464'
)Clinical nutrition and dietary counseling department
from zato.hl7v2.v2_9 import ORG
from zato.hl7v2.v2_9 import XON, CWE
org = ORG()
org.primary_key_value_org = '2'
org.organization_unit_identifier = XON(
organization_name='NUTRITION',
id_number='NUT002'
)
org.organization_unit_type = CWE(
identifier='DEPT',
text='Department',
name_of_coding_system='HL70464'
)
org.organization_name = XON(organization_name='River Valley Wellness')
org.organization_unit = CWE(
identifier='NUT',
text='Nutrition Services',
name_of_coding_system='HL70464'
)Wellness screening and preventive medicine department
from zato.hl7v2.v2_9 import ORG
from zato.hl7v2.v2_9 import XON, CWE
org = ORG()
org.primary_key_value_org = '3'
org.organization_unit_identifier = XON(
organization_name='PREVENTIVE',
id_number='PREV003'
)
org.organization_unit_type = CWE(
identifier='CLINIC',
text='Clinic',
name_of_coding_system='HL70464'
)
org.organization_name = XON(organization_name='Harmony Health Center')
org.organization_unit = CWE(
identifier='PREV',
text='Preventive Care',
name_of_coding_system='HL70464'
)Step-by-step guides for working with HL7 v2 in Zato.
ORG defines organizational units within healthcare organizations. It's used to structure departments, clinics, facilities, and practice groups, particularly useful for organizing wellness center services.
Use HL70464 table values for unit types like DEPT (Department), CLINIC (Clinic), or FAC (Facility):
org.organization_unit_type = CWE(
identifier='DEPT',
text='Department',
name_of_coding_system='HL70464'
)organization_unit_identifier identifies the specific unit with codes and IDs, while organization_name contains the parent organization information. Both use XON datatype but serve different purposes.
Use multiple ORG segments to represent hierarchical structures. Each ORG can reference parent units through the organization_unit_identifier or establish relationships through the organization_name field.
Use HL70464 for organization unit types. For custom unit types, ensure consistent coding across your wellness center organization.
Zato connects to any system that speaks HL7v2 over MLLP or FHIR over REST. This includes Epic, Cerner, Meditech, Allscripts, and other EHR platforms.
Yes, Zato has built-in MLLP support for sending and receiving HL7v2 messages. MLLP channels handle the framing protocol automatically.
Zato supports HL7 v2.9, which is backward compatible with earlier versions including v2.3, v2.5, and v2.7. Standard segments and datatypes are available as typed Python classes.
Yes. Zato handles both HL7v2 and FHIR natively, so you can parse v2 messages and build FHIR resources with IG-specific extensions in the same service. Typed Python classes are available for both protocols, including extensions from US Core, UK Core, Da Vinci, and other Implementation Guides.
Complete list of fields in the ORG segment, HL7 v2.9.
| # | Python name | Datatype | Usage | Repeatable | Table |
|---|---|---|---|---|---|
| 1 | set_id_org | SI | Required | No | - |
| 2 | organization_unit_code | CWE | Optional | No | HL70405 |
| 3 | organization_unit_type_code | CWE | Optional | No | HL70474 |
| 4 | primary_org_unit_indicator | ID | Optional | No | HL70136 |
| 5 | practitioner_org_unit_identifier | CX | Optional | No | - |
| 6 | health_care_provider_type_code | CWE | Optional | No | HL70452 |
| 7 | health_care_provider_classification_code | CWE | Optional | No | HL70453 |
| 8 | health_care_provider_area_of_specialization_code | CWE | Optional | No | HL70454 |
| 9 | effective_date_range | DR | Optional | No | - |
| 10 | employment_status_code | CWE | Optional | No | HL70066 |
| 11 | board_approval_indicator | ID | Optional | No | HL70136 |
| 12 | primary_care_physician_indicator | ID | Optional | No | HL70136 |
| 13 | cost_center_code | CWE | Optional | Yes | HL70539 |
Get started with Zato and connect your systems in minutes.