Schedule a demo
Healthcare/HL7 v2/IN3
Segment

Insurance additional information - certification

Carries certification and pre-authorization information related to the insurance plan in the preceding IN1, including certification number, certifying authority, certification dates, and approved length of stay. It is used in ADT, BAR, referral, and utilization review workflows where payer pre-certification is required, and is consumed by utilization management and claims systems.

31fields
1required
v2.9HL7 version
in3.py
from zato.hl7v2 import IN3

in3 = IN3()
in3.set_id_in3 = '1'
in3.certification_number = 'CERT001'
in3.certification_required = 'Y'
in3.certification_begin_date = '20260601'
Python examples

Build IN3 segments in Python

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

1

Routine certification

Certification for an annual wellness visit with reviewing physician and dates

from zato.hl7v2.v2_9 import IN3
from zato.hl7v2.v2_9 import CX, XCN, XTN

in3 = IN3()
in3.set_id_in3 = '1'
in3.certification_number = CX(id_number='CERT-2024-001')
in3.certification_required = 'Y'
in3.certification_modify_date_time = '20240610120000'
in3.certification_begin_date = '20240601'
in3.certification_end_date = '20241231'
in3.physician_reviewer = XCN(
    person_identifier='3344',
    family_name='GREEN',
    given_name='LISA',
    suffix='MD'
)
in3.certification_contact = 'Wellness Desk'
in3.certification_contact_phone_number = XTN(
    telecommunication_use_code='WPN',
    telecommunication_equipment_type='PH',
    country_code='1',
    area_city_code='503',
    local_number='5551234'
)
2

Coverage review

Certification agency with online verification for a routine preventive screening

from zato.hl7v2.v2_9 import IN3
from zato.hl7v2.v2_9 import CX, XCN, CWE, XTN

in3 = IN3()
in3.set_id_in3 = '1'
in3.certification_number = CX(id_number='CERT-WEL-500')
in3.certified_by = XCN(
    person_identifier='3001',
    family_name='ADAMS',
    given_name='MARK',
    suffix='MD'
)
in3.certification_begin_date = '20240701'
in3.certification_end_date = '20250701'
in3.certification_agency = CWE(
    identifier='WELLCARE',
    text='WC001'
)
in3.certification_agency_phone_number = XTN(
    telecommunication_use_code='WPN',
    telecommunication_equipment_type='PH',
    country_code='1',
    area_city_code='720',
    local_number='5559876'
)
in3.online_verification_date_time = '20240715090000'
in3.online_verification_result = CWE(
    identifier='PASS',
    text='Verified'
)
3

Second opinion

Second opinion details for an elective wellness procedure with documentation received

from zato.hl7v2.v2_9 import IN3
from zato.hl7v2.v2_9 import CX, CWE, XCN

in3 = IN3()
in3.set_id_in3 = '1'
in3.certification_number = CX(id_number='CERT-OPT-300')
in3.second_opinion_date = '20240801'
in3.second_opinion_status = CWE(
    identifier='A',
    text='Approved'
)
in3.second_opinion_documentation_received = CWE(
    identifier='Y',
    text='Yes'
)
in3.second_opinion_physician = XCN(
    person_identifier='5500',
    family_name='CHEN',
    given_name='DAVID',
    suffix='MD'
)
Tutorials

Learn by building

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

MLLP
Receive and parse HL7 v2 messages
Set up an MLLP channel, parse incoming messages, and respond with acknowledgments.
Start tutorial Build
Build and send HL7 v2 messages
Construct HL7 v2 messages from scratch using typed segment classes and send them over MLLP.
Start tutorial
Related segments

Commonly used with IN3

IN1 Insurance IN2 Insurance additional info PID Patient identification PV1 Patient visit GT1 Guarantor MSH Message header
FAQ

Frequently asked questions

IN3 carries additional insurance certification details - certification numbers, reviewing physicians, certification dates, agency information, second opinion data, and online verification results. It appears alongside IN1 and IN2 in ADT and financial messages.

Create the segment, set its fields, then read them back:

from zato.hl7v2.v2_9 import IN3, CX, XCN

in3 = IN3()
in3.certification_number = CX(id_number='CERT-001')
in3.certification_begin_date = '20240601'

cert_num = in3.certification_number
begin = in3.certification_begin_date

Use the certification_begin_date and certification_end_date fields with DT (date) values:

from zato.hl7v2.v2_9 import IN3

in3 = IN3()
in3.certification_begin_date = '20240601'
in3.certification_end_date = '20251231'

The physician_reviewer field uses the XCN (extended composite name) datatype:

from zato.hl7v2.v2_9 import IN3, XCN

in3 = IN3()
in3.physician_reviewer = XCN(
    person_identifier='3344',
    family_name='Green',
    given_name='Lisa',
    suffix='MD'
)

Use the second_opinion fields together with CWE and XCN datatypes:

from zato.hl7v2.v2_9 import IN3, CWE, XCN

in3 = IN3()
in3.second_opinion_date = '20240801'
in3.second_opinion_status = CWE(
    identifier='A',
    text='Approved'
)
in3.second_opinion_physician = XCN(
    person_identifier='5500',
    family_name='Chen',
    given_name='David',
    suffix='MD'
)

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.

Reference

IN3 field reference

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

#Python nameDatatypeUsageRepeatableTable
1set_id_in3SIRequiredNo-
2▶certification_numberCXOptionalNo-
3▶certified_byXCNOptionalYes-
4certification_requiredIDOptionalNoHL70136
5▶penaltyMOPOptionalNo-
6certification_date_timeDTMOptionalNo-
7certification_modify_date_timeDTMOptionalNo-
8▶operatorXCNOptionalYes-
9certification_begin_dateDTOptionalNo-
10certification_end_dateDTOptionalNo-
11▶daysDTNOptionalNo-
12▶non_concur_code_descriptionCWEOptionalNoHL70233
13non_concur_effective_date_timeDTMOptionalNo-
14▶physician_reviewerXCNOptionalYesHL70010
15certification_contactSTOptionalNo-
16▶certification_contact_phone_numberXTNOptionalYes-
17▶appeal_reasonCWEOptionalNoHL70345
18▶certification_agencyCWEOptionalNoHL70346
19▶certification_agency_phone_numberXTNOptionalYes-
20▶pre_certification_requirementICDOptionalYesHL70136
21case_managerSTOptionalNo-
22second_opinion_dateDTOptionalNo-
23▶second_opinion_statusCWEOptionalNoHL70151
24▶second_opinion_documentation_receivedCWEOptionalYesHL70152
25▶second_opinion_physicianXCNOptionalYesHL70010
26▶certification_typeCWEOptionalNoHL70921
27▶certification_categoryCWEOptionalNoHL70922
28online_verification_date_timeDTMOptionalNo-
29▶online_verification_resultCWEOptionalNoHL70970
30▶online_verification_result_error_codeCWEOptionalNoHL70971
31online_verification_result_check_digitSTOptionalNo-

Ready to build integrations?

Get started with Zato and connect your systems in minutes.

Get started ▶Read the docs
Open source In Python