Schedule a demo
Segment

Practitioner org unit

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.

13fields
1required
v2.9HL7 version
org.py
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 = name

Build ORG segments in Python

How to construct and work with real-world ORG segments.

1

Fitness department unit

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'
)
2

Nutrition services unit

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'
)
3

Preventive care unit

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'
)

Learn by building

Step-by-step guides for working with HL7 v2 in Zato.

Frequently asked questions

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.

ORG field reference

Complete list of fields in the ORG segment, HL7 v2.9.

#Python nameDatatypeUsageRepeatableTable
1set_id_orgSIRequiredNo-
2organization_unit_codeCWEOptionalNoHL70405
3organization_unit_type_codeCWEOptionalNoHL70474
4primary_org_unit_indicatorIDOptionalNoHL70136
5practitioner_org_unit_identifierCXOptionalNo-
6health_care_provider_type_codeCWEOptionalNoHL70452
7health_care_provider_classification_codeCWEOptionalNoHL70453
8health_care_provider_area_of_specialization_codeCWEOptionalNoHL70454
9effective_date_rangeDROptionalNo-
10employment_status_codeCWEOptionalNoHL70066
11board_approval_indicatorIDOptionalNoHL70136
12primary_care_physician_indicatorIDOptionalNoHL70136
13cost_center_codeCWEOptionalYesHL70539

Ready to build integrations?

Get started with Zato and connect your systems in minutes.

Open source In Python