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.
from zato.hl7v2 import OH3
oh3 = OH3()
oh3.set_id = '1'
oh3.occupation = 'Welder'
oh3.industry = 'Construction'How to construct and work with real-world OH3 segments.
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'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'
)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'Step-by-step guides for working with HL7 v2 in Zato.
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.
Complete list of fields in the OH3 segment, HL7 v2.9.
| # | Python name | Datatype | Usage | Repeatable | Table |
|---|---|---|---|---|---|
| 1 | set_id | SI | Required | No | - |
| 2 | action_code | ID | Optional | No | - |
| 3 | occupation | CWE | Required | No | HL70958 |
| 4 | industry | CWE | Required | No | HL70955 |
| 5 | usual_occupation_duration_years | NM | Optional | No | - |
| 6 | start_year | DT | Optional | No | - |
| 7 | entered_date | DT | Optional | No | - |
| 8 | work_unique_identifier | EI | Optional | No | - |
Get started with Zato and connect your systems in minutes.