Fix IRIS transmittal errors
Learn how to resolve errors in your IRS IRIS transmittal files.
When the IRS processes your transmittal, you may receive errors that need to be corrected or rejected records that need to be resubmitted.
For some errors, your error message will include a line number showing the exact record location in the transmittal file. Download the file, find the record with the error, and fix the record in our system by following these steps.
- On the IRIS Transmit page, click the transmittal's row, then click Download file.
- Expand the ErrorInformationGrp section and review the error line information and message in the ErrorMessageTxt line. In this example, the line number showing the exact record location is highlighted in yellow and the error message is highlighted in blue.
- Find the line with the error in the transmittal file. In this example, the error is in line 80 and is related to the Country code field.
Common errors
Accepted with errors
- If Business Name in Issuer Detail has a value, then TIN and Business Name must match IRS records.
- The payer's name and Taxpayer Identification Number (TIN) combination do not match IRS records. Review and correct the payer's Name and TIN fields, then notify the IRS. Read more about making corrections.
- If Person Name and TIN in Recipient Detail have a value, they must match the IRS database.
- The recipient's name and TIN combination do not match IRS records. Review and correct the recipient's Name and TIN fields, then submit corrections to the IRS.
- Phone Number in Issuer Detail must have a value.
- The payer's contact phone number is required. Edit the payer and enter the contact phone number.Important:
This field is only required for future filings. This tax year, you don't need to file corrections for this error and won't be penalized for ignoring it.
- TIN in Recipient Detail must have a value.
- All recipients must have a TIN. Contact the recipient to request their TIN. Then edit the recipient and submit corrections to the IRS.
- If TIN in Recipient Detail is a duplicate of TIN in Recipient Detail on another record in the Submission, then Recipient Account Number must have a value and be unique within a submission.
- The same TIN is in the transmittal file multiple times without unique account IDs. Edit the recipient to enter the Account ID, then transmit the record again as a previously rejected original.
Rejected
- Receipt ID mismatch
- Original Receipt ID does not match Receipt ID from an Original transmission that was rejected previously.
- You corrected an original transmittal before receiving an original receipt ID from the IRS. Resubmit the corrections, referencing the original receipt ID when you select a filing type.
- Field formatting errors
- The value '|1|1' of element 'n1:UniqueRecordId' is not valid; The value '8857' of element 'n1:ZIPCd' is not valid.
- A field contains data that does not match the expected format. Fix the error, then transmit the record again as a previously rejected original.Tip:
Check out the field validation errors for common field formatting requirements.
- Value '8807' is not facet-valid with respect to pattern '[0-9]{5}(([0-9]{4})|([0-9]{7}))?' for type 'ZIPCodeType'.
- The Zip code field must be five digits. Fix the ZIP code, then transmit the record again as a previously rejected original.
- The value '' of element 'n1:CountryCd' is not valid; Value '' is not facet-valid with respect to enumeration '[AF, AX, AL, AG, AQ, AN, AO, AV, AY, AC, AR, AM, AA, AT, AS, AU, AJ, BF, BA, FQ, BG, BB, BO, BE, BH, BN, BD, BT, BL, BK, BC, BV, BR, IO, VI, BX, BU, UV, BM, BY, CB, CM, CA, CV, CJ, CT, CD, CI, CH, KT, IP, CK, CO, CN, CF, CG, CW, CR, CS, IV, HR, CU, UC, CY, EZ, DA, DX, DJ, DO, DR.
- The Country code field is either empty or not a valid two-letter International Organization for Standardization (ISO) country code. Fix the country code, then transmit the record again as a previously rejected original.
- Value '' is not facet-valid with respect to enumeration '[AL, AK, AS, AZ, AR, CA, CO, MP, CT, DE, DC, FM, FL, GA, GU, HI, ID, IL, IN, IA, KS, KY, LA, ME, MH, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PW, PA, PR, RI, SC, SD, TN, TX, VI, UT, VT, VA, WA, WV, WI, WY, AA, AE, AP]'. It must be a value from the e.
- A State field does not contain a valid two-letter state abbreviation. Fix the state abbreviation, then transmit the record again as a previously rejected original.
- Value '- NONE -' is not facet-valid with respect to pattern '[A-Za-z0-9]( ?[A-Za-z0-9\-/])*' for type 'StreetAddressType'.
- The address fields contain invalid characters or formatting. Fix the address, then transmit the record again as a previously rejected original.
- Value '' is not facet-valid with respect to pattern '([A-Za-z\-] ?)*[A-Za-z\-]' for type 'PersonLastNameType'.
- A name field contains invalid characters or formatting. Fix the name, then transmit the record again as a replacement.
- Value '11601249' is not facet-valid with respect to pattern '[0-9]{9}' for type 'TINType'.
- The TIN field format is invalid. This field must contain nine digits, for example 123456789. Fix the TIN, then transmit the record again as a previously rejected original.
- Missing required information
- The value '' of element 'n1:StateAbbreviationCd' is not valid; The value '' of element 'n1:PersonLastNm' is not valid.
- A required field is empty. Enter a value in the field, then transmit the record again as a previously rejected original.
- The content of element 'n1:PersonName' is not complete. One of '{"urn:us:gov:treasury:irs:ir":PersonMiddleNm, "urn:us:gov:treasury:irs:ir":PersonLastNm}' is expected.
- A required name field is empty. If the TIN type is SSN, the Name (first name) and Last name fields are required. Enter a value in the empty required name field, then transmit the record again as a replacement.