Section 8 Example ISS-A2A Web Service Messages
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
8.1 | Transmitter Services SOAP Message Elements
• ACATransmitterManifestReqDtl
• Form109495BTransmittalUpstream
• ACSTransmitterBusinessHeaderRequest
• ACATransmitterResponseAckGrp
8.1.1 | IRS-ACASubmitService SOAP Request Message – Manifest Header (ACAGetTransmitterBulkRequestService.wsdl)
The ACABusinessHeader, WSSESecurity, ACASecurity and ACATransmitterManifestReqDtl elements are required for a SOAP request message sent by a transmitter to be sent to transmission to IRS. The root element for the Manifest Header XML Schema is found in IRS- Form1094-1095BCTransmitterReqMessage. xsd file located in the MSG folder.
See Section 7.1 for details on the ACABusinessHeader XML. See Section 5.3.1 for details on the WSSESecurity and ACASecurity XML.
<soapenv:Envelope** **xmlns:acaBodyReq=”urn:us:gov:treasury:irs:msg:irsacabulkrequesttransmitter”** **xmlns:acaBusHeader=”urn:us:gov:treasury:irs:msg:acabusinessheader”** **xmlns:irs=”urn:us:gov:treasury:irs:common”** **xmlns:air=”urn:us:gov:treasury:irs:ext:aca:air:tyYY”** **xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/”> soapenv:Header air:ACATransmitterManifestReqDtl air:PaymentYr2021 air:PriorYearDataInd0 irs:EINirs:EIN air:TransmissionTypeCdO air:TestFileCdTestFileCode air:OriginalReceiptIdOriginalReceiptId air:TransmitterNameGrp air:BusinessNameLine1TxtBusinessNameLine1Txt air:BusinessNameLine2TxtBusinessNameLine2Txt air:CompanyInformationGrp
Guide for ACA Information Returns Submission Composition and Reference Guide 106
Example ISS-A2A Web Service Messages
air:CompanyNmCompanyNm
air:MailingAddressGrp
air:USAddressGrp
air:AddressLine1TxtAddressLine1Txt
air:AddressLine2TxtAddressLine2Txt
irs:CityNmCityNm
air:USStateCdAL
irs:USZIPCd20000
irs:USZIPExtensionCdUSZIPExtensionCd
air:ContactNameGrp
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 107
Example ISS-A2A Web Service Messages
irs:Timestamp2021-01-10T12:31:22Z <urn4:ACASecurityHeader** **xmlns:urn4=”urn:us:gov:treasury:irs:msg:acasecurityheader” /> <oas:Security** **xmlns:oas=”http://docs.oasis-open.org/wss/2004/01/oasis-200401wss- wssecurity-** **secext-1.0.xsd” /> soapenv:Body <acaBodyReq:ACABulkRequestTransmitter
version=”1.0”>
irs:BulkExchangeFileDocumentSystemFileNm.xml
8.1.2 | IRS-ACASubmitService SOAP Request Message – Form Data File (ACAGetTransmitterBulkRequestService.wsdl)
The following sample XML includes the Form Data File elements required for a SOAP request message sent by a transmitter to send a Form 1094/1095-B transmission to IRS. The root element for the Form 1094/1095-B Form Data File XML Schema is found in IRS- Form10941095BTransmitterUpstreamMessage.xsd file located in the MSG folder.
<n1:Form109495BTransmittalUpstream**
**xmlns=”urn:us:gov:treasury:irs:ext:aca:air:tyYY”**
**xmlns:irs=”urn:us:gov:treasury:irs:common”**
**xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”**
**xmlns:n1=”urn:us:gov:treasury:irs:msg:form1094-1095Btransmitterupstreammessage”**
**xsi:schemaLocation=”urn:us:gov:treasury:irs:msg:form1094- 1095Btransmitterupstreammessage**
**IRS-Form1094-1095BTransmitterUpstreamMessage.xsd”>
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 108
Example ISS-A2A Web Service Messages
irs:TINRequestTypeCdINDIVIDUAL_TIN
irs:SSN000000000
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 109
Example ISS-A2A Web Service Messages
Line 2
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 110
Example ISS-A2A Web Service Messages
irs:CityNmCity
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 111
Example ISS-A2A Web Service Messages
8.1.3 | IRS-ACASubmitService SOAP Response Message (ACAGetTransmitterBulkRequestService.wsdl)
The following sample XML includes the Manifest Header elements required in the SOAP Response message sent by IRS to the transmitter. The SOAP Response message is returned to the transmitter as part of the synchronous session for sending transmissions to IRS. The root element for the SOAP Response message XML Schema (applies to both Forms 1094/1095-B and Forms 1094/1095-C) is found in IRS-Form10941095BCTransmitterRespMessage.xsd file located in the MSG folder.
<soap:Envelope xmlns:soap=”http://schemas.xmlsoap.org/soap/envelope/”>
soap:Header
<acaBusHeader:ACABusinessHeader**
**xmlns:irs=”urn:us:gov:treasury:irs:common”**
**xmlns=”urn:us:gov:treasury:irs:ext:aca:air:tyYY”**
**xmlns:ns3=”http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurityutility-1.0.xsd”**
**xmlns:ns4=”http://www.w3.org/2000/09/xmldsig#”**
**xmlns:acaBusHeader=”urn:us:gov:treasury:irs:msg:acabusinessheader”**
**xmlns:ns6=”urn:us:gov:treasury:irs:msg:irsacabulkrequesttransmitter”**
**xmlns:ns7=”http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext- 1.0.xsd”**
**xmlns:ns8=”urn:us:gov:treasury:irs:msg:acasecurityheader”>
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 112
Example ISS-A2A Web Service Messages
8.1.4 | IRS-ACAAckngService SOAP Request Message (ACAGetTransmitterBulkRequestStatus.wsdl)
The following sample XML provided by IRS as a response to a status service request made by the transmitter. The SOAP Response message is returned to the transmitter as part of the synchronous session. The root element for the SOAP Response message XML Schema (applies to both Forms 1094/1095-B and Forms 1094/1095-C) is found in IRS- Form10941095BCResponseAckMessage.xsd file located in the MSG folder.
<p:FormBCTransmittalAckResponse** **xmlns:p="urn:us:gov:treasury:irs:msg:form10941095bcresponseackmessage"** **xmlns:p1="urn:us:gov:treasury:irs:ext:aca:air:tyYY"** **xmlns:p2="urn:us:gov:treasury:irs:common"** **xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"** **xsi:schemaLocation="urn:us:gov:treasury:irs:msg:form1094-1095bcresponseackmessage IRS-Form1094-1095BCRe-** **sponseAckMessage.xsd "> p1:ACATransmitterResponseAckGrp p2:ReceiptId ReceiptId p1:TransmitterControlCd XXXXX/p1:TransmitterControlCd>
8.1.5 | IRS-ACAAckngService SOAP Response Message – Manifest Header (ACAGetTransmitterBulkRequestStatus.wsdl)
<p:TransmitterManifestResponse**
**xmlns:p="urn:us:gov:treasury:irs:msg:form10941095BCtransmitterrespmessage"**
**xmlns:p1="urn:us:gov:treasury:irs:ext:aca:air:tyYY"**
**xmlns:p2="urn:us:gov:treasury:irs:common"**
**xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"**
**xsi:schemaLocation="urn:us:gov:treasury:irs:msg:form1094-1095BCtransmitterrespmessage IRS-Form1094-1095BC-**
**TransmitterRespMessage.xsd ">
p1:ACATransmitterManifestRespDtl
p1:UniqueTransmitterId UniqueTransmitterId
p1:TransmitterControlCd XXXXX
p1:ShipmentRecordNumXXXXX00
p2:ReceiptId ReceiptId
p1:FormTypeCd1094/1095B
p2:Timestamp2021-11-31T12:00:00Z
p2:SubmissionStatusCdAccepted
p2:ErrorMessageDetail
p2:ErrorMessageCd ErrorMessageCd
p2:DocumentSystemFileNmDocumentSystemFileNm
p2:ChecksumAugmentationNumChecksumAugmentationNump2:ChecksumAugmentationNum
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 113
Example ISS-A2A Web Service Messages
8.1.6 | IRS- ACAAckngService SOAP Response Message – Error Data File (ACAGetTransmitterBulkRequestStatus.wsdl)
The following sample XML includes the Error Data File elements that are sent by IRS to a transmitter to provide error status detail. The root element for the Forms 1094/1095-B Error Data File XML Schema is found in IRS-Form1094-1095BCTransmitterMessage.xsd file located in the MSG folder.
<ns3:FormBCTransmitterSubmissionDtl**
**xmlns="urn:us:gov:treasury:irs:ext:aca:air:tyYY"**
**xmlns:ns2="urn:us:gov:treasury:irs:common" xmlns:ns3="urn:us:gov:treasury:irs:msg:form1094-1095BCtransmitter-**
**message">
Guide for Electronically Filing ACA Information Returns for Software Developers and Transmitters 114
Example ISS-A2A Web Service Messages
Get a plain-English answer with a citation back to this text.
Ask AI about this code