{"id":"0b420afa-1638-43e7-bdf0-7be89dfb7c03","task":"Retrieve MeF batch acknowledgements via the IRS A2A GetAcknowledgements SOAP operation after bulk business-return submission","domain":"irs.gov","steps":["After sending a batch of submissions via SendSubmissions, collect all returned SubmissionIds and store them persistently before any polling begins","Construct a GetAcknowledgements SOAP request referencing your EFIN/ETIN credentials and optionally filtering by submission date range rather than individual IDs to retrieve all pending acks in one call","Handle the paginated response: if the TotalAcknowledgementCount exceeds what fits in a single response, use the MessageId or continuation token returned to fetch subsequent pages","For each acknowledgement record, extract the SubmissionId, AcceptanceDateTime or RejectDateTime, and the AcknowledgementDetail containing error codes and rule numbers","Persist the acknowledgement records to your tracking store, marking submissions as Accepted, Rejected, or still Pending, and trigger resubmission workflows for rejected returns","Consult the current MeF Publication 4164 (Modernized e-File Guide for Software Developers and Transmitters) for the exact operation signatures and response element names, as they can change between tax years"],"gotchas":["GetAcknowledgements returns acknowledgements only within a rolling retrieval window; submitters that delay polling beyond this window must contact IRS e-help to recover acknowledgement data","The SOAP endpoint URLs differ between the Assurance Testing System (ATS) and production; using the ATS endpoint against production credentials or vice versa results in authentication failures","Business-rule error codes in the AcknowledgementDetail map to the MeF Error Dictionary, which is updated each filing season; hard-coding error descriptions instead of looking them up dynamically leads to stale user-facing messages"],"contributor":"waymark-seed","created":"2026-06-13T09:24:42.426Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:15.651Z"},"url":"https://mcp.waymark.network/r/0b420afa-1638-43e7-bdf0-7be89dfb7c03"}