Schedule a demo
Segment

Usual work

Records the occupation and industry that a patient has held for the longest duration over their working life. It includes the usual occupation code, usual industry code, the number of years spent in that occupation, the start year, and a unique identifier. This segment supports long-term occupational exposure assessment and epidemiological studies by providing a standardized representation of the patient's primary work history.

8fields
3required
v2.9HL7 version
oh3.py
from zato.hl7v2 import OH3

oh3 = OH3()
oh3.set_id = '1'
oh3.occupation = 'Welder'
oh3.industry = 'Construction'

Build OH3 segments in Python

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

1

Primary occupation

Records the usual occupation and industry with duration and start year

from zato.hl7v2.v2_9 import OH3
from zato.hl7v2.v2_9 import CWE

oh3 = OH3()
oh3.set_id = '1'
oh3.occupation = CWE(
    identifier='WLD',
    text='Welder',
    name_of_coding_system='HL70958'
)
oh3.industry = CWE(
    identifier='CON',
    text='Construction',
    name_of_coding_system='HL70955'
)
oh3.usual_occupation_duration_years = (
    '25'
)
oh3.start_year = '19990101'
oh3.entered_date = '20240601'
2

Tracked record

Usual work entry with a unique identifier for record tracking

from zato.hl7v2.v2_9 import OH3
from zato.hl7v2.v2_9 import CWE, EI

oh3 = OH3()
oh3.set_id = '2'
oh3.occupation = CWE(
    identifier='TCH',
    text='Teacher',
    name_of_coding_system='HL70958'
)
oh3.industry = CWE(
    identifier='EDU',
    text='Education',
    name_of_coding_system='HL70955'
)
oh3.usual_occupation_duration_years = (
    '15'
)
oh3.start_year = '20090101'
oh3.entered_date = '20240701'
oh3.work_unique_identifier = EI(
    entity_identifier='OH3-2024-001',
    namespace_id='MAIN'
)
3

Minimal usual work

Records only the required occupation and industry fields with entered date

from zato.hl7v2.v2_9 import OH3
from zato.hl7v2.v2_9 import CWE

oh3 = OH3()
oh3.set_id = '3'
oh3.occupation = CWE(
    identifier='DRV',
    text='Driver',
    name_of_coding_system='HL70958'
)
oh3.industry = CWE(
    identifier='TRN',
    text='Transportation',
    name_of_coding_system='HL70955'
)
oh3.entered_date = '20240801'

Learn by building

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

Frequently asked questions

OH3 records the occupation and industry a patient held for the longest duration during their working life. It supports long-term occupational exposure assessment by providing the usual occupation, industry, duration in years, and start year.

The occupation field uses CWE with HL7 table 0958:

from zato.hl7v2.v2_9 import OH3, CWE

oh3 = OH3()
oh3.occupation = CWE(
    identifier='WLD',
    text='Welder',
    name_of_coding_system='HL70958'
)

Use the usual_occupation_duration_years numeric field:

from zato.hl7v2.v2_9 import OH3

oh3 = OH3()
oh3.usual_occupation_duration_years = (
    '25'
)

The work_unique_identifier field uses the EI datatype:

from zato.hl7v2.v2_9 import OH3, EI

oh3 = OH3()
oh3.work_unique_identifier = EI(
    entity_identifier='OH3-2024-001',
    namespace_id='MAIN'
)

OH2 records individual past or present jobs with detailed schedule and employer data, while OH3 captures only the single occupation and industry held longest over the patient's career. Use OH3 for epidemiological summaries and OH2 for detailed job history.

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.

OH3 field reference

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

#Python nameDatatypeUsageRepeatableTable
1set_idSIRequiredNo-
2action_codeIDOptionalNo-
3occupationCWERequiredNoHL70958
4industryCWERequiredNoHL70955
5usual_occupation_duration_yearsNMOptionalNo-
6start_yearDTOptionalNo-
7entered_dateDTOptionalNo-
8work_unique_identifierEIOptionalNo-

Ready to build integrations?

Get started with Zato and connect your systems in minutes.

Open source In Python