Section 7 Data Mapping for ISS-UI Services/ ISS-A2A Web Services
Publication 5258 — Guide for Affordable Care Act (ACA) Information Returns (AIR) Submission Composition and Reference Guide · 2026-10-03 edition · updated 2026-10-04 · United States
This section provides mapping of the request and the response information exchanged between the transmitter and IRS. The mapping feeds into the request and response XML schemas for the messages. Both the request and the response schemas are incorporated into the ACA XML library.
The data mapping that follows is structured according to the asynchronous business process as follows:
- The transmitter sends a transmission with a Form Data File to IRS and receives a Receipt ID from IRS
in a single synchronous session. In the ISS-A2A Channel, the synchronous session is comprised of the transmitter sending a SOAP Request message with a transmission to IRS and receiving a SOAP Response message with the Receipt ID. In the ISS-UI Channel, the synchronous session is comprised of the transmitter logging on to IRS, uploading the Transmission Data File containing information pertaining to the transmitter and the transmission, uploading the Form Data File, submitting the transmission and receiving the Receipt ID at their Web Browser.
- The transmitter sends a message with the Receipt ID associated with the transmission and receives the
status and, if applicable, error detail. In the ISS-A2A Channel, the synchronous session is comprised of the transmitter sending a SOAP Request message with the Receipt ID pertaining to the transmission for which they are requesting status and receiving a SOAP Response message with the status (one of Accepted, Accepted with Errors, Partially Accepted, Rejected, Processing, Not Found) and, if errors were found during processing, the Error Data File containing the details of the errors. In the ISS-UI Channel, the synchronous session is comprised of the transmitter logging on to IRS, entering the Receipt ID and their TCC via a Web Browser and receiving the status via a web page and the capability to browse or download the Error Data File if errors were found during processing.
This section identifies the boundary data exchanged between the transmitter and IRS for the following transactions:
Transmitting the Form Data File and receiving the response Requesting the Acknowledgement and receiving the response
This section also identifies the business data sent to IRS by a transmitter. The business data is sent to IRS in the Form Data File containing Forms 1094/1095-B and Forms 1094/1095-C XML elements.
Guide for ACA Information Returns Submission Composition and Reference Guide 86
Data Mapping for ISS-UI Services/ISS-A2A Web Services
7.1 | Data Mapping – Message Data Boundary
Tables 7-1 through 7-3 provide the data element definitions relevant to the transmission SOAP Request and SOAP Response messages.
Tables 7-4 through 7-6 provide the data element definitions relevant to the Acknowledgement request SOAP Request and SOAP Response messages.
Table 7-1: Form 1094-1095 B and C Transmission SOAP Request Header – ACA Business Header
ACABusinessHeader Definition XML Element Name
Unique Transmission Id Unique Transmission Id UniqueTransmissionId
Time stamp Time stamp Timestamp
Table 7-2: Form 1094-1095 B and C Transmission SOAP Request Manifest Header
ACATransmitterManifestReqDtl Definition XML Element Name
Payment Yr Tax year of the filing PaymentYr
Prior Year Data Ind Prior Filing year Indicator PriorYearDataInd
Employer Identification Number (EIN) Transmitter’s 9-digit EIN EIN
TransmissionTypeCd
TestFileCd –‘T’ to be used only in AATS ‘P’ to be used only in PROD
OriginalReceiptId - (optional)
TransmitterForeignEntityInd (optional)
TransmitterNameGrp BusinessNameLine1Txt BusinessNameLine2Txt -(optional)
Transmission Type Cd
Transmission Type Indicates whether Transmission has Original (O), Replacement (R), Corrected (C)
Test File Ind Test File Indicator
Original Receipt ID
Original Receipt Identifier of the Transmission being replaced
Transmitter Foreign Entity Transmitter Foreign Entity Ind Indicator
Global type for name of the Transmitter Name Grp transmitter.
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 87
Data Mapping for ISS-UI Services/ISS-A2A Web Services
| ACATransmitterManifestReqDtl | Definition | XML Element Name |
|---|---|---|
| Company Information Grp | Global type for the Company (Transmitter) Information. *USAddressGrpType and ForeignAddressGrpType are choice elements. |
CompanyNm MailingAddressGrp USAddressGrp AddressLine1Txt AddressLine2Txt CityNm |
| USStateCd USZIPCd USZIPExtensionCd Or ForeignAddressGrp AddressLine1Txt AddressLine2Txt CityNm CountryCd – OR CountryNm ForeignProvinceNm ForeignPostalCd ContactNameGrp PersonFirstNm PersonMiddleNm -(optional) PersonLastNm SuffxNm-(optional) ContactPhoneNum |
||
| Vendor Information Grp | Global type or the vendor information |
VendorInformationGrp VendorCd ContactNameGrp (Person) ContactPhoneNum |
| Total Payee Record Cnt | The Total Number of Payees count |
TotalPayeeRecordCnt |
| Total Payer Record Cnt | The Total Number of Payer Records count |
TotalPayerRecordCnt |
| Software Id | An identifcation number assigned by IRS to a software |
SoftwareId |
| Form Type Cd | Form Type 10941095B/ |
FormTypeCd |
| Binary Format Cd | An identifer for a fle format of content type of a binary object. Extensible Markup Language (XML) is the only accepted type at this time |
BinaryFormatCd |
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 88
Data Mapping for ISS-UI Services/ISS-A2A Web Services
ACATransmitterManifestReqDtl Definition XML Element Name
ChecksumAugmentationNum
AttachmentByteSizeNum
DocumentSystemFileNm
Checksum Augmentation Num
A SHA-256 Checksum value (64 characters) provided by Requestors and IRS verify the size of file received is the same as the size transmitted
A size of a binary object Attachment Byte Size Num (attachment) in bytes
The filename of a document Document System File Nm in a file system
Table 7-3: Form 1094-1095 B and C Transmission SOAP Response
ACABusinessHeader Definition XML Element Name
UniqueTransmissionId Unique Transmission ID UniqueTransmissionId
Timestamp
Base type for a date and time stamp – Time zone portion is required, and fractional seconds are prohibited
ACABulkRequestTransmitterResponse
Timestamp
TransmissionStatusCd
Transmission Status Code
The current known status of the transmission (Processing, Accepted, Accepted with Errors, Partially Accepted or Rejected)
Receipt Id A unique receipt identifier ReceiptId
ErrorMessageDetail ErrorMessageCd ErrorMessageTxt
Error Message Detail
Global type for the Error Message Detail *Error code/error message will always be in XML structure. Error Message Detail will be repeated for each error
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 89
Data Mapping for ISS-UI Services/ISS-A2A Web Services
Table 7-4: Form 1094-1095 B and C Acknowledgement SOAP Request to check the Status of the Transmission
ACABusinessHeader Definition XML Element Name
UniqueTransmissionID Unique Transmission ID UniqueTransmissionId
Timestamp
Timestamp
Base type for a date and time stamp – Time zone portion is required, and fractional seconds are prohibited
ACABulkRequestTransmitterStatusDetailRequest
Receipt Id A unique receipt identifier ReceiptId
Table 7-5: Form 1094-1095 B and C Transmission SOAP Response Header
ACABusinessHeader Definition XML Element Name
Global type for the Unique UniqueTransmissionID Transmitter Identifier
Timestamp
Base type for a date and time stamp – Time zone portion is required, and fractional seconds are prohibited
ACABulkRequestTransmitterResponse
UniqueTransmissionId
Timestamp
TransmissionStatusCd
Transmission Status Code
Current state of transmission processing (Processing, Accepted, Accepted with Errors, Partially Accepted or Rejected)
Receipt Id A unique receipt identifier ReceiptId
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 90
Data Mapping for ISS-UI Services/ISS-A2A Web Services
Table 7-6: Form 1094-1095 B and C Transmission SOAP Response Header – ACA Business Header
| TransmitterErrorDetailGrp | Definition | XML Element Name |
|---|---|---|
| Unique Submission Id | Unique Submission Identifer | UniqueSubmissionId |
| Error Message Detail | Global type for the Error Message Detail |
ErrorMessageDetail ErrorMessageCd |
| TransmitterErrorDetailGrp | Defnition | XML Element Name |
| *Error code/ always be in XML structure. Error Message Detail will be repeated for each error |
ErrorMessageTxt XpathContent |
7.2 | Data Mapping – Form Data Boundary
Tables 7-7 and 7-8 provide the data element definitions relevant to Issuer Reporting. Issuers include health insurance issuers, sponsors of a self-insured health plan and government agencies that administers government-sponsored health insurance programs. The Form Line Numbers are taken from the Form 1094-B and Form 1095-Bs.
Tables 7-9 and 7-10 provide the data element definitions relevant to Employer Reporting. Employers include Applicable Large Employers (ALE). The Form Line Numbers are taken from the Form 1094-C and Form 1095-C forms.
Table 7-7: Form 1094-B
| Form Line Num | 1094-B Data Element | Definition | XML Element Name |
|---|---|---|---|
| None | Tax Year | Tax Year being fled for | TaxYr |
| None | Unique submission number | SubmissionId | |
| None | Original Unique Submission ID | OriginalUniqueSubmissionId | |
| None | Test Scenario ID | TestScenarioId | |
| None | TIN Request Type code |
TIN Request type code | TINRequestTypeCd |
| 1 | Filer’s name | Filer’s complete Name | BusinessName BusinessNameLine1Txt BusinessNameLine2Txt |
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 91
Data Mapping for ISS-UI Services/ISS-A2A Web Services
| Form Line Num | 1094-B Data Element | Definition | XML Element Name |
|---|---|---|---|
| 2 | Employer Identifcation Number (EIN) |
The fler’s 9-digit EIN. | EmployerEIN |
| 3 | Name of person to contact |
The name of the person to contact who is responsible for answering any questions. |
ContactNameGrp PersonFirstNm PersonMiddleNm PersonLastNm SuffxNm |
| 4 | Contact telephone number |
Phone number of contact person |
ContactPhoneNum |
| 5 | Street Address (including room or suite no.) |
The fler’s complete address where all correspondence will be sent. |
MailingAddressGrp USAddressGrp AddressLine1Txt AddressLine2Txt |
| 6 | City or town | IRS XML schema provides a choice between using US Address or Foreign Address. Differences are noted in individual felds on the right. If TransmitterForeignEntityInd is true then, ForeignAddressGrp will be used. Choice between CountryCd and CountryNm |
CityNm USStateCd USZIPCd USZIPExtensionCd Or ForeignAddressGrp AddressLine1Txt AddressLine2Txt CityNm CountryCd - OR CountryNm ForeignProvinceNm ForeignPostalCd |
| 7 | State or Province |
State or Province |
State or Province |
| 8 | Country and ZIP or Foreign Postal Code |
Country and ZIP or Foreign Postal Code |
Country and ZIP or Foreign Postal Code |
| 9 | Total number of Forms 1095-B submitted with this transmittal |
The total number of Forms 1095-B that are transmitted with this Form 1094-B. |
Form1095BAttachedCnt |
| None | Signature | Jurat Signature PIN* | JuratSignaturePIN |
| None | Title | Person Title* | PersonTitleTxt |
| None | Date | Signature Date | SignatureDt |
- Please note that Signature and Title are not required for Form 1094C
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 92
Data Mapping for ISS-UI Services/ISS-A2A Web Services
Table 7-8: Form 1095-B
| Form Line Num | 1095-B Data Element | Definition | XML Element Name |
|---|---|---|---|
| None | Unique Record ID | RecordId | |
| None | Test Scenario ID | TestScenarioId | |
| None | TIN Request Type Code | TIN Request Type Code | ResponsibleIndividualGrp TINRequestTypeCd |
| Person Name Control Type | Person Name Control Type | ResponsibleIndividualGrp PersonNameControlTxt |
|
| Business Name Control Type | Business Name Control Type | ResponsibleIndividualGrp BusinessNameControlTxt |
|
| None | TIN Request Type Code | TIN Request Type Code | SponsoringEmployerInfoGrp |
| TINRequestTypeCd | |||
| None | TIN Request Type Code | TIN Request Type Code | CoveredIndividualGrp TINRequestTypeCd |
| None | TIN Request Type Code | TIN Request Type Code | SponsoringEmployerInfoGrp TINRequestTypeCd |
| None | TIN Request Type Code | TIN Request Type Code | IssuerInfoGrp TINRequestTypeCd |
| None | Corrected | Identifes the Information Return as containing corrections to the previously transmitted 1095B. |
CorrectedInd |
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 93
Data Mapping for ISS-UI Services/ISS-A2A Web Services
| Form Line Num | 1095-B Data Element | Definition | XML Element Name |
|---|---|---|---|
| None | CorrectedRecord RecipientGrp |
Information to identify the record being corrected |
CorrectedRecord RecipientGrp CorrectedUnique RecordId Choice between: CorrectedRecRecipient PrsnNameCorrected RecRecipientName CorrectedRecRecipientTIN |
| None | Tax Year | Identifes the tax year that the forms are being fled for |
TaxYr |
Get a plain-English answer with a citation back to this text.
Ask AI about this code