How to File 1099-R Through IRIS

What Is Form 1099-R?

Form 1099-R, Distributions From Pensions, Annuities, Retirement or Profit-Sharing Plans, IRAs, Insurance Contracts, etc., is one of the most complex information returns filed with the IRS. It reports distributions from:

• Pension and retirement plans: Defined benefit plans, 401(k)s, 403(b)s, and profit-sharing plans
• Individual Retirement Arrangements (IRAs): Traditional IRAs, Roth IRAs, SEP-IRAs, and SIMPLE IRAs
• Annuity contracts: Both qualified and non-qualified annuities
• Insurance contracts: Life insurance proceeds, disability payments, and long-term care benefits
• Government plans: Section 457 deferred compensation, military retirement, and civil service retirement

The form captures not just the distribution amount, but the character of the distribution — whether it's taxable, a rollover, an early withdrawal, a required minimum distribution, or one of dozens of other transaction types. This complexity is encoded in distribution codes that must be accurately mapped in the IRIS XML schema. For a complete overview, see our 1099-R guide.

Distribution Code Mapping in IRIS XML

The distribution code (Box 7) is the most critical field on Form 1099-R. It tells the IRS how to treat the distribution for tax purposes. In IRIS XML, distribution codes must be represented using exact code values that match IRS specifications. Getting this wrong can trigger validation errors or incorrect tax treatment for the recipient.

Common Distribution Codes

Code	Description	Tax Treatment
1	Early distribution, no known exception	Taxable + 10% early withdrawal penalty
2	Early distribution, exception applies	Taxable, no penalty
3	Disability	Taxable, no penalty
4	Death	Taxable to beneficiary, no penalty
7	Normal distribution	Taxable, no penalty (age 59½+)
D	Annuity payments from non-qualified plans	Taxable under Section 409A rules
G	Direct rollover to qualified plan or IRA	Not taxable (rollover)

Combination codes: IRIS XML supports two-character distribution code combinations (e.g., 1A, 2B, 4D). The first character indicates the distribution type, and the second indicates additional context. The schema validates that only legitimate code combinations are used.

Box-Specific Requirements in IRIS

Form 1099-R has more reportable fields than most 1099 forms. The IRIS XML schema includes elements for each box, with specific validation rules:

• Box 1 — Gross distribution: Total amount distributed before any deductions. This is always required.
• Box 2a — Taxable amount: The portion of the distribution that is taxable. If unknown, the "Taxable amount not determined" indicator (Box 2b) must be set.
• Box 2b — Taxable amount not determined / Total distribution: Two separate indicator fields in the XML schema. Setting these correctly prevents IRS notices to recipients.
• Box 5 — Employee contributions or insurance premiums: The recipient's after-tax contributions, used to calculate the taxable portion of annuity payments.
• Box 6 — Net unrealized appreciation (NUA): Applies to employer securities distributed from qualified plans. Frequently left blank when it shouldn't be, triggering downstream issues.
• Box 9b — Total employee contributions: Lifetime contributions to the plan, used in annuity taxation calculations.
• Box 10 — Amount allocable to IRR: The amount allocable to an irrevocable right to receive, relevant for specific pension plan types.

Taxable vs Non-Taxable Amounts

One of the most common 1099-R filing errors is incorrect handling of taxable vs non-taxable amounts. IRIS schema validation catches some of these errors, but not all:

• Rollovers (Code G): The gross distribution appears in Box 1, but Box 2a should be $0 since the distribution is not taxable. Many filers incorrectly populate Box 2a with the same amount as Box 1.
• Roth IRA distributions: Qualified distributions from Roth IRAs are non-taxable. Use Code Q and ensure Box 2a reflects $0 or the non-taxable portion.
• Return of excess contributions: Code 8 or P. The taxable amount includes only the earnings portion, not the original contribution.
• After-tax employee contributions: When a plan participant has made after-tax contributions (Box 5), the taxable amount calculation follows the annuity exclusion ratio rules.

State Tax Withholding Reporting

Form 1099-R frequently involves state tax withholding, especially for pension and annuity payments. The IRIS XML schema supports up to two state entries per form, including:

• State identification number: Your payer's state withholding account number (not the federal EIN)
• State income tax withheld: The amount withheld for state income tax purposes
• State distribution amount: The portion of the distribution attributable to that state

For states that participate in the Combined Federal/State Filing Program, including the state information in your IRIS submission allows the IRS to forward copies automatically. For non-participating states, you'll need to file directly. See our state filing requirements guide for the full breakdown.

High-Volume Filing for Financial Institutions

Insurance companies, pension plan administrators, brokerage firms, and banks often file hundreds of thousands of 1099-R forms each year. At this scale, precision and automation are critical. For industry-specific guidance, see our IRIS guide for banks and financial institutions.

• Distribution code accuracy: Automated systems must correctly assign distribution codes based on the transaction type, the recipient's age, the plan type, and the distribution reason. A single incorrect code can generate an IRS notice and a confused recipient.
• Bulk filing through IRIS: Use the A2A API or a provider like BoomTax for high-volume submissions. The IRIS Taxpayer Portal is not viable for large-scale filing.
• Correction workflows: With complex forms like 1099-R, corrections are common. Ensure your filing process supports efficient correction generation and tracking.

Filing 1099-R Through BoomTax

BoomTax simplifies 1099-R filing through IRIS, handling the complexity of distribution codes, taxable amount calculations, and state withholding:

• Keep your FIRE-format files: Your retirement plan administration or insurance system generates FIRE-format output today. Upload those files to BoomTax and we handle the IRIS conversion automatically.
• Distribution code validation: BoomTax validates distribution codes and code combinations before submission, catching invalid codes and mismatches that would cause IRIS rejections.
• Taxable amount logic: We validate the relationship between gross distribution, taxable amount, and indicator fields to prevent the most common 1099-R filing errors.
• State filing included: BoomTax handles state filing for 1099-R, including states with separate withholding requirements.
• Scale: File any volume through bulk upload or API.

Frequently Asked Questions

Next Steps

• IRIS filing guide for banks and financial institutions
• How to file 1099-R corrections through IRIS
• IRIS XML format and schema guide
• 2027 IRIS filing deadlines calendar
• Upload your FIRE-format files — BoomTax handles IRIS