FBR IRIS errors and return validation fixes

Common FBR IRIS Errors and How to Fix Them

FBR IRIS errors often point to a missing section, an unreconciled Wealth Statement, or a filing period that is not open for your taxpayer profile. The exact message can vary, and FBR does not publish a complete public catalogue of these validation strings. I’ve mapped the error phrases filers commonly report to the IRIS sections worth checking first. For preparation before you file, see my tax preparation guide for Pakistan.

Hey, Shahzad here. I’ve spent the past 20+ years helping individuals, freelancers, and business owners across Pakistan file their taxes properly. Start with the section named in the message; don’t randomly change figures just to make the warning disappear.

Key takeaways

  • “IRIS return submission not allowed” can relate to a closed period or taxpayer status, not only a broken return.
  • A business-income deduction may require a declared Business Activity section.
  • “Attributes annexure” complaints usually mean a required declaration or supporting section needs attention.
  • Check that your Wealth Statement reconciles inflows and outflows before submitting.
  • Error text and portal layout can change. Treat the message shown in your own IRIS account as the current instruction.

Why do FBR IRIS errors appear?

FBR IRIS validates information across several parts of the return. A value entered under income, deductions, tax credits, assets or business activity may depend on a declaration elsewhere, so a return can look complete while a required section is still missing. The portal’s errors are not collected in a public official error-code list; the phrases below are reported by filers, not quoted from an FBR manual. Use them as clues, then check the relevant section in your own return.

IRIS returns are arranged into sections such as Data, Deductions, Tax Chargeable or Credits, Attributes, Business Activity, Wealth Statement and Annexures. The wording and layout may change. Avoid relying on a menu path copied from an old screenshot.

What does “IRIS return submission not allowed” mean?

The reported message “IRIS return submission not allowed” can mean the form or filing period is not open for your taxpayer profile. It may also appear when a required return section is incomplete. Check the tax year, return type, NTN status and period shown in your account before rebuilding the return; a period-status issue will not be fixed by changing figures.

Check these items in order:

  1. Confirm you are in the intended tax year and return type.
  2. Review the taxpayer profile and NTN status shown in IRIS.
  3. Check whether the filing period or form is available for your profile.
  4. If those details are correct, inspect the return for incomplete required sections and validation alerts.

If the portal still blocks you, save the exact message and contact FBR through the helpline listed on its official website. I’m not printing a phone number here because the current listing has not been independently confirmed for this draft.

How do you fix “business section before claiming tax deduction”?

Filers report a “business section before claiming tax deduction” message when they claim business income or a business-related deduction without completing the corresponding Business Activity declaration. Check the Business Activity section and provide the information applicable to your business before returning to the deduction. Do not add a business merely to clear an error if the income or deduction does not belong to you.

Use this check:

  1. Identify which deduction or income entry triggered the warning.
  2. Open the Business Activity section in the current return and review its required fields.
  3. Make sure the declared activity matches your actual income source.
  4. Return to the deduction and confirm its amount and supporting details.

Business owners, freelancers and salaried filers can have different reporting situations. If you did not earn business income, do not guess at a business classification; check the relevant FBR guidance or ask a tax professional.

What should you check for an “attributes annexure” error?

An “attributes annexure” warning reported by filers points you back to the Attributes or related annexure sections in the return. These declarations can cover deductions, assets or capital gains, depending on the return and taxpayer. Review the fields connected to the warning and make sure the information agrees with the figures elsewhere; the phrase alone does not identify one universal missing field.

Compare the affected declaration with the corresponding entry in Data, Deductions, Tax Chargeable or Credits, and the relevant annexure. The section names are useful landmarks, but the exact field depends on your return. Don’t copy another taxpayer’s entries.

Why does IRIS reject a Wealth Statement?

The Wealth Statement is a reconciliation, not just an asset list. Its inflows and outflows must explain the change in wealth for the period. If the return flags reconciliation, compare opening wealth, income and other inflows with expenses, taxes, acquisitions and closing wealth. A mismatch needs a truthful correction supported by your records, not a balancing number entered to force submission.

What to compareWhat to review
Opening positionPrevious year’s closing wealth and any brought-forward balances
InflowsDeclared income and other amounts that genuinely increased available funds
OutflowsPersonal expenses, tax paid and relevant purchases or transfers
Closing positionAssets and liabilities at the end of the tax year

The correct treatment can depend on the facts and the return year. Keep bank statements, receipts and working papers available while you reconcile.

What should you do before submitting again?

Before retrying, read the full validation message and note the section or annexure it names. Review the current return rather than following an old screenshot, then confirm that related figures agree across the relevant sections. If you need the full filing process, see my FBR IRIS return filing guide. Here, we’ll focus on errors and fixes.

  1. Save or note the full error text and the tax year.
  2. Check the named section and any related declaration.
  3. Reconcile dependent figures against your records.
  4. Save the return and use the portal’s current validation option again.
  5. If the message persists, contact FBR using the support details currently listed on FBR’s official website, or consult a qualified tax adviser.

What mistakes should you avoid when fixing IRIS errors?

The quickest-looking fix can create a worse problem later. Don’t delete a valid deduction, enter a made-up business activity, or use a number from a different taxpayer’s return just to get past validation. IRIS messages identify a problem to investigate; they do not replace your records or determine whether a claim is legally available to you.

Check the tax year first. Then compare each relevant declaration with your source documents. If an error appears to be a portal issue, keep the message and seek help rather than repeatedly submitting altered figures.

Related reads

Frequently asked questions

Does “submission not allowed” always mean IRIS is down?

No. Filers may see this kind of message when a form or filing period is unavailable for their taxpayer profile, or when the return has an incomplete requirement. Confirm the tax year, return type, NTN status and period in your account before treating it as a technical outage. If those are correct, review the sections named by other validation messages.

Why does IRIS ask for a Business Activity section?

A return claiming business income or a business-related deduction may require a matching Business Activity declaration. Review the section and ensure it reflects your actual activity. If you have no business income, don’t invent one to clear a warning; confirm the treatment for your situation with FBR guidance or a tax adviser.

What is the Attributes annexure in an IRIS return?

Attributes is one of the return’s sections or annexures where declarations related to items such as deductions, assets or capital gains may appear. The fields depend on the return and taxpayer, so a reported “attributes annexure” error does not point to one universal correction. Read the validation text and compare related entries across the return.

Can I submit my return if the Wealth Statement does not reconcile?

A mismatch means the figures do not explain the change in wealth for the year. Recheck opening and closing positions, income, inflows, expenses and purchases against your records. Don’t enter a balancing figure without evidence. If you cannot identify the difference, seek help before filing; the correct explanation depends on your facts.

Where can I get help with an IRIS error?

Keep the full message, tax year and section details, then consult the support information currently listed on FBR’s official website or speak with a qualified tax adviser. Portal labels and contact details can change. Never share passwords, one-time codes or unredacted identity documents in public forums.

Should I follow an old IRIS screenshot or video?

Use old tutorials only as general orientation. IRIS labels and validation behaviour can change, and screenshots may show a different tax year or taxpayer type. Follow the fields in your current account. If a step differs, check current FBR guidance instead of guessing a menu path. Compare the tutorial’s date with the return year you are filing.

Need help with an IRIS return?

If the return remains blocked after you check the relevant sections, get professional help before changing figures you cannot support. I can help with tax filing and FBR-related services; contact details are available on the site’s verified service pages.

Conclusion

Start with the exact message and the IRIS section it names. Check your taxpayer profile and filing period for submission blocks, and reconcile declarations with your records before trying again.