These are errors and rejects every filer can get when sending information returns to IRIS, whether through the free IRIS Taxpayer Portal or through filing software. IRIS reports each one on the acknowledgment by rule number.
Form 1099-QA business rules
Besides the rules on this page, IRIS checks the rules every form shares, such as SHAREDIRFORM014 (payee name and TIN); those are on the cross-form error code pages. The IRIS Taxpayer Portal also takes Form 1099-QA as a CSV upload, using the IRS template for the form.
In the tax year 2026 rule set: 1 report error and reject over the threshold. A reject stops the submission; a report error is accepted with errors and counts as filed; past an unpublished threshold, report errors reject the submission. The descriptions are our own summaries; your acknowledgment gives the rule number.
| Rule | Severity | What it checks |
|---|---|---|
| F1099QA002 | Report error, reject over threshold | Basis, if reported, must equal the gross distribution minus earnings. |
Elements of Form1099QADetail
Each Form 1099-QA return is one Form1099QADetail record in a submission of group 1. The table lists its 14 elements in schema order for tax year 2026: whether each is required, and the format IRIS accepts. Element names are the ones the IRS uses in its IRIS ATS examples and Publication 5718; the IRS revises the schema each year.
| Element | Required | Format |
|---|---|---|
TaxYr | Required | Four-digit year |
RecordId | Required | Whole number, up to 8 digits |
IssuerOfficeCd | Optional | Exactly 4 characters |
VoidInd | Required | 1 (yes) or 0 (no) |
CorrectedInd | Required | 1 (yes) or 0 (no) |
PrevSubmittedRecRecipientGrp | Optional | Group of elements |
RecipientDetail | Required | Group of elements |
RecipientAccountNum | Optional | Text, up to 30 characters |
GrossDistributionAmt | Optional | Amount, zero or more, up to 2 decimal places |
EarningsAmt | Optional | Amount, zero or more, up to 2 decimal places |
BasisAmt | Optional | Amount, zero or more, up to 2 decimal places |
ProgramToProgramTransferInd | Required | 1 (yes) or 0 (no) |
FinalReturnInd | Required | 1 (yes) or 0 (no) |
NotDesignatedBeneficiaryInd | Required | 1 (yes) or 0 (no) |
Check a file before you send it. TIN Comply's free IRIS 1099 File Checker runs an IRIS XML or CSV file against the IRS business rules in your browser.