IRS IRIS Filing Support

Fix: Verify the IRIS Application for TCC is complete and that the user is an authorized user on the application. The current Taxpayer Portal guide states that the Portal uses an IRIS TCC beginning with “D.” Do not use an AIR or legacy FIRE TCC in place of the IRIS TCC.

Fix: Confirm you selected the correct form/tax year and are using the current IRS CSV template for that form. Save as a true CSV, preserve the required headers, remove extra title rows/blank columns and confirm required issuer information exists in the portal.

Fix: Download the current formatting guidelines/template from the portal. Copy your data under the IRS headings instead of renaming the headings to match your internal spreadsheet. Watch for hidden spaces and duplicate header names.

Fix: Trim text fields, remove unintended adjacent spaces, preserve leading zeros in TIN/ZIP/code fields, use the required date formats, and remove currency symbols/commas where the template expects numeric values only.

Fix: Format identifiers as text before importing/pasting into Excel. Check for scientific notation, stripped leading zeros and auto-converted dates. Re-export the CSV and inspect the actual text file before upload.

Fix: Compare the recipient name/TIN to Form W-9 or other source documentation. IRIS identifies the affected record, but the IRS does not disclose what name/TIN is on its master file. Correct only when you have authoritative information.

Fix: A received status means processing is not complete. Do not immediately retransmit. Publication 5717 tells filers to allow processing time, then return to View Submitted Forms and check the Receipt ID/status again.

Fix: The IRS treats records accepted with errors as accepted. Review the error detail and make corrections for the affected records. Do not resend accepted records as new originals.

Fix: At least one submission was rejected. Identify which submission/records failed. Replace only the rejected submission(s) as the current IRIS workflow instructs; preserve accepted data.

Fix: All submissions in that transmission were rejected. Resolve the reported problem and use the Replace workflow rather than creating corrections to returns that were never accepted.

Fix: Check whether the record has already been successfully corrected or whether a correction is already in progress. Publication 5717 lists both conditions as reasons the correction selection may be unavailable.

Fix: Treat issuer errors differently from recipient corrections. The current Publication 5717 states that issuer name/TIN errors cannot be resolved through the normal Portal correction process and provides a written correspondence procedure. Follow the current guide for the required letter and mailing address.

Fix: Use the current tax-year IRIS schema/business-rule package. Validate namespaces, element sequence, form-total groups, required attributes, TIN types, correction indicators and form-specific elements before transmitting.

Fix: Confirm the A2A TCC, API Client ID, registered key material and environment all belong to the same authorized application. Recheck Publication 5718 and the IRIS A2A setup instructions before changing payload data.

Fix: ATS and Production are separate environments. Use the correct endpoints and credentials, and do not assume an ATS acceptance is a Production filing. Check the IRIS known-issues page for current environment-specific problems.

No. The Taxpayer Portal is a browser workflow for manual entry and CSV upload. A2A is a software-to-IRS XML transmission channel with API setup and ATS testing.

The Taxpayer Portal upload workflow uses IRS-formatted CSV data. Use Excel to prepare the data if you want, but export it to the current IRS CSV format and validate the raw CSV before upload.

The IRS has accepted the record(s), but identified errors. Publication 5717 says every effort should be made to correct those errors. Do not treat the accepted record as rejected.

At least one submission in the transmission was rejected while other submissions were accepted. Replace the rejected submission(s), not the accepted submissions.

Use a correction for an accepted record that needs changes. Use replacement for rejected submission data as directed by IRIS. Always base the choice on the status and acknowledgement.

The current Publication 5717 says issuer name/TIN errors are not corrected through the normal Portal correction workflow. Follow the guide's correspondence procedure.

The IRS distributes IRIS schemas/business rules and publishes ATS examples. Publication 5718 defines A2A specifications; Publication 5719 and the IRIS ATS page cover testing.

Check the IRS IRIS Known Issues and Solutions page for the Taxpayer Portal, A2A and A2A ATS. The IRS updates those files during the year.

The IRS IRIS page lists the current help desk numbers and hours. Use that page rather than relying on an old phone number saved in internal notes.