Company Settings:
- HL7 Immunization Export 2.5.1 Entering Organization - defines the value placed in the ORC.17
- HL7 Immunization Export 2.5.1 Filer Order Number Namespace ID - defines the value placed in ORC 3.2
- HL7 Immunization Export 2.5.1 Filer Order Number Universal ID - defines the value placed in ORC 3.3
- HL7 Immunization Export 2.5.1 Filer Order Number Universal ID Type - defines the value placed in ORC 3.4
- HL7 Immunization Export 2.5.1 Placer Order Number Namespace ID - defines the value placed in ORC 2.2
- HL7 Immunization Export 2.5.1 Placer Order Number Universal ID - defines the value placed in ORC 2.3
- HL7 Immunization Export 2.5.1 Placer Order Number Universal ID Type - defines the value placed in ORC 2.4
- HL7 Immunization Export 2.5.1 Receiving Responsible Organization - defines the value placed in MSH 23
- HL7 Immunization Export 2.5.1 Sending Responsible Organization - defines the value placed in MSH 22
- HL7 Immunization Export 2.5.1 Immunization Export 2.5.1 Entity Identifier - defines the value placed in
- HL7 Immunization Export 2.5.1 Immunization Export 2.5.1 Include Batch and File Header and Trailer Segments
- HL7 Immunization Export 2.5.1 MSH-15 value
- HL7 Immunization Export 2.5.1 MSH-16 value
- HL7 Immunization Export 2.5.1 MSH-21 value
- HL7 Immunization Export 2.5.1 Only include primary OBX line
- HL7 Immunization Export 2.5.1 PID 3.1 SSN exlusion
- HL7 Immunization Export 2.5.1 PID-6.7 value
- HL7 Immunization Export 2.5.1 Push MSH-4 value into RXA-11.4
- HL7 Immunization Export 2.5.1 Push RXA-3 value into RXA-4
- HL7 Immunization Export 2.5.1 Receiving Application
- HL7 Immunization Export 2.5.1 Receiving Facility
- HL7 Immunization Export 2.5.1 Send Ordering Physician NPI in ORC-12
- HL7 Immunization Export 2.5.1 Send Ordering Physician NPI in RXA-10
- HL7 Immunization Export 2.5.1 Sending Application
- HL7 Immunization Export 2.5.1 Sending Facility
- HL7 Immunization Export 2.5.1 Exclude PV1 segment
- HL7 Immunization Export Line Feed
- HL7 Immunization Export Max Export Size
- HL7 Immunization Export - MSH per patient
- HL7 Immunization Export MSH-10 Use chart number when MSH per patient is set
- HL7 Immunization Export Path
- HL7 Immunization Export Patient Identifier
- HL7 Immunization Export Version Number
- HL7 Immunization Filename Prefix
- HL7 Immunization Filename Suffix
iSalus Healthcare supports immunization reporting using the HL7 v2.5.1 message format and SOAP based web services according to the CDC 1.0 WSDL.
Follow these steps to setup connectivity to your state immunization information system (IIS) registry:
- Click on the Setup Portal Icon.

- Click on Immunization Registry under the Interface Setup section.

- Select the Immunization Registry you are connecting to.

- Enter the UserID provided from the Immunization Registry.

- Enter the Practice's Password provided from the Immunization Registry.

- Enter the Facility ID if provided from the Immunization Registry.

- Click the checkboxes for the remaining 3 registry settings:

- Press the Save button to save the registry settings.

The practice is now ready to Retreive Immunization History and Forecasts from and Send Immunization Records to the registry.
Contact iSalus Support if you do not see the registry you are working with in the registry list.
Practices have 2 choices for reporting immunizations to Immunization Information Systems (IIS) - via interface or via export and upload.
Option 1: Report Immunizations via Interface
iSalus Healthcare currently supports immunization messages in the HL7 v2.5.1 and V2.3.1 message format and via SOAP based web services according to the CDC 1.0 WSDL. Learn more about connecting to a State Immunization Registry.
Once your practice is setup and the EHR is connected with a direct interface to your State Immunization Registry, follow these steps to report your practice's immunizations electronically via interface:
- Click on the Reports portal.

- Click on Immunization Export under the Public Health section.

- Select the Historical check-box to include patient-reported/historical immunizations.

- Click on the Magnifying Glass icon to search for new/updated immunization records not yet sent to the IIS.

- The patient records will appear in the search results. Select the records you wish to send or right-click on the S column header and click on Select All to select all of the immunization records.

- Press the Send button to submit the immunization records to the IIS.

Select the Exported check-box prior to running your search to include previously exported immunization records (helpful for testing).

Click the Search menu > Advanced Search to perform a more specific, advanced search for Immunization records.

Option 2: Report Immunizations via Export and Upload
If your practice is not connected with your State Immunization Registry via direct EHR interface, follow these steps to extract your Immunization HL7 files to upload to an external website or directory on your computer:
- Click on the Reports portal.

- Click on Immunization Export under the Public Health section.

- Select the Historical check-box to include patient-reported/historical immunizations.

- Click on the Magnifying Glass icon to search for new/updated immunization records not yet exported.

- The patient records will appear in the search results. Select the records you wish to send or right-click on the S column header and click on Select All to select all of the immunization records.

- Click on the Export button.

- Select where to save the immunization file, rename the file if desired and press the Save button.

Select the Exported check-box prior to running your search to include previously exported immunization records (helpful for testing).

Click the Search menu > Advanced Search to perform a more specific, advanced search for Immunization records.

Many state Immunization Information System (IIS) allow practices to retrieve evaluated immunization history and immunization forecast directly into their EMR. This electronic information includes a patient's up-to-date list of immunizations received (history) as well as a list and schedule of vaccinations that the patient should receive in the future (forecast). This information should prevent incorrect administration of vaccinations and ensure all necessary vaccinations are provided to patients on a correct schedule.
iSalus Healthcare currently supports querying (Z44) and receiving Evaluated History and Forecast (Z33, Z42) messages in the HL7 v2.5.1 Release 1.5 message format. iSalus can connect to external registries/HIEs via SOAP based webservices according to the CDC 1.0 WSDL. Learn more about connecting to a State Immunization Registry.
To pull a patient's immunization history and forecast:
- Open the patient in the EMR via patient appointment or patient search.
- Click on the Reconciliation Clipboard icon on the patient Timeline Summary.

- Click on the Cloud Download icon in the Immunization section.

- A list of matching patients will display. Select the appropriate patient record and then click on the Retrieve History button.

- The patient's immunization history and forecast will display. Click the Info button to view detailed information about the immunization.

- To add the immunization to the patient's Immunization History, click the Ignore link. This will toggle it to Add. Repeat for all immunization you wish to add to the patient's record.

- Press the Save button to update the patient's record.

- The historical immunizations display in the Immunization History.

Overview
When iSalus OfficeEMR submits immunization records to a state immunization registry, the outbound HL7 2.5.1 message must include a facility identifier that the registry can match to the submitting practice. This identifier is assigned by the registry and must be entered in iSalus before submissions will be accepted.
The facility identifier appears in two fields of the HL7 message:
| HL7 Field | Segment Location | Purpose |
|---|---|---|
| MSH-4 | MSH|...|...|...|{value}|... |
Sending facility — identifies the organization submitting the message to the registry. |
| RXA-11 | RXA|...|^^^^{value}~~~L|... |
Administered-at location — identifies where the immunization was given. Most registries validate this field to authorize the submission. |
Configure Location in the Setup > Location Screen
The facility identifier is configured at the location level in iSalus. Each physical location that submits immunizations must be configured separately.
Navigation
Instructions
- Open the Setup Portal in iSalus OfficeEMR.
- Click Locations.
- Search for and open the location record to be configured.
- Within the location record, click the Immunization Export Setup link. This is a secondary configuration section within the location form.
- The Immunization Export Setup dialog contains two fields:
Field What to Enter MSH 4 The registry-assigned facility identifier for this location. Enter the exact value provided by the state registry (e.g., a SIIS ID, OID, or alphanumeric facility code). RXA 11 Enter the same registry-assigned facility identifier. This is the value that most registries actively validate on inbound messages. - Verify that your expected values are populated in the MSH 4 and RXA 11 fields.
- Click OK to save.
- After updating, verify the practice output when records are submitted via Reports > Immunization Export report.
- Repeat for every location at the practice that submits immunizations to a registry.
Finding the Registry-Assigned Facility Identifier
The facility identifier must come from the state registry — this value is not generated by or known by iSalus. General registry guidance:
- Log in to the state registry's portal for the practice.
- Navigate to the practice or facility profile.
- Locate the facility identifier, SIIS ID, organization ID, or equivalent field. The format varies by registry.
- If the value is not visible in the portal, contact the state registry's support team directly to inquire on how to obtain the necessary information.
Review Related Company Settings
The following company settings (Patient > Patient Export Settings) control how the facility identifier is formatted and placed within the outbound HL7 message. Review these settings to confirm they are aligned with the requirements of the registry the practice is submitting to.
Company Settings Quick Reference
| Setting | Recommended Value | Impact |
|---|---|---|
| HL7 Immunization Export 2.5.1 RXA-11 | 2 |
Facility ID placed in RXA-11.4 — required by most registries. |
| Push MSH-4 value into RXA-11.4 | true |
MSH-4 automatically copied to RXA-11.4, keeping both fields in sync. |
| Sending Facility (MSH-4) — company level | ^^ (empty) |
When blank, each location's Immunization Export Setup drives MSH-4. |
| Receiving Facility (MSH-6) | Registry-provided | Identifies the destination registry. Provided during onboarding. |
| Send Ordering Physician NPI in ORC-12 | Per registry requirement | Sends provider NPI in ORC-12 instead of internal iSalus provider ID. |
| Send Ordering Physician NPI in RXA-10 | Per registry requirement | Sends provider NPI in RXA-10 instead of internal iSalus user ID. |
More Details for Related Company Settings
HL7 Immunization Export 2.5.1 — RXA-11
Controls which sub-field of RXA-11 receives the facility identifier.
| Value | Behavior | Notes |
|---|---|---|
0 |
Populate RXA-11.1 | Places the facility ID in the Point of Care sub-field. Not accepted by most state registries. |
1 |
Do not populate | RXA-11 is left empty. Use only if the registry explicitly does not require a facility ID in this field. |
2 |
Populate RXA-11.4 | Recommended. Places the facility ID in the Facility sub-component (RXA-11.4). Required by most state registries. |
HL7 Immunization Export 2.5.1 — Push MSH-4 Value into RXA-11.4
When enabled, iSalus automatically copies the MSH-4 value into RXA-11.4, so both fields are populated from a single source — the location record's Immunization Export Setup.
| Value | Behavior |
|---|---|
true |
Recommended. The MSH-4 value (sourced from the location record) is automatically pushed into RXA-11.4 on every outbound message. Both fields stay in sync. |
false |
MSH-4 and RXA-11.4 are populated independently. The RXA-11 field in the location's Immunization Export Setup must be manually maintained. |
HL7 Immunization Export 2.5.1 — Sending Facility (MSH-4)
A company-level override for MSH-4. Accepts a three-part value: NamespaceID^UniversalID^UniversalIDType.
| Value | Behavior |
|---|---|
^^ (empty) |
Recommended for multi-location practices. When blank, MSH-4 is sourced per-location from the Immunization Export Setup, allowing each location to carry its own facility identifier. |
| Populated value | If populated, this value overrides the location record for all locations company-wide. Appropriate only if all locations share a single registry facility identifier. |
HL7 Immunization Export 2.5.1 — Receiving Facility (MSH-6)
Defines the destination registry endpoint in the MSH-6 field. Accepts a three-part value: NamespaceID^UniversalID^UniversalIDType. This value is provided by the state registry during onboarding and is the same for all practices submitting to that registry.
HL7 Immunization Export 2.5.1 — Send Ordering Physician NPI in ORC-12
When true, places the ordering provider's NPI in ORC-12.1 and ORC-12.3 instead of the iSalus internal provider ID. Does not affect facility ID fields, but may be required by registries that mandate NPI-based provider identification.
HL7 Immunization Export 2.5.1 — Send Ordering Physician NPI in RXA-10
When true, places the ordering provider's NPI in RXA-10.1 and RXA-10.3 instead of the iSalus administering user ID. Does not affect facility ID fields but contributes to full message compliance for NPI-required registries.
iSalus Healthcare Support | Applies to OfficeEMR HL7 2.5.1 immunization exports to all state immunization registries.






















