Methodology changelog
Every engine change, on the record.
Our correction policy is simple: when a calculation issue is found, we fix the engine, add a regression test, and record it here — including the mistakes. A tax product that only publishes its wins isn't telling you anything.
Each entry names the results it could have changed and what to do if yours is one of them. Figures on screen are recomputed from your saved data every time you open a return; a package PDF reflects the engine on the day it was generated, so a package that predates a correction touching your situation should be generated again before you file. If the review step does not offer that, write to support@atamatax.com with the tax year and the output is updated where possible.
Form 8938 maximum penalty stated as $60,000
The facts registry gave the maximum penalty for an unfiled Form 8938 as $50,000. That $50,000 caps the continuation penalty that follows the initial $10,000 after an IRS notice, so the maximum is $60,000 — the figure the IRS's own comparison of Form 8938 and FBAR requirements states. Every page and tool that quotes the penalty reads the corrected fact.
Affected: /form-8938 and its FAQ answer · IRS risk scanner · consequence lines in the decision engine · Verified against: IRC §6038D(d); IRS comparison of Form 8938 and FBAR requirements
What to do: Nothing to redo — no tax figure changed.
Long-term holding period counted by calendar date
A gain is long-term only when the asset was held more than one year, so the sale must fall after the anniversary of the purchase. The engine and the gain preview on the transactions step counted 365 days instead, which treated a sale on the anniversary itself — or 365 days later across a 29 February — as long-term. Both now read one calendar-date rule; a 29 February purchase turns long-term after 28 February of the following year.
Affected: Short- vs long-term split on Form 8949 / Schedule D · capital-gain rate · transactions-step preview · Verified against: IRC §1222; IRS Publication 544
What to do: Only a sale made exactly on its purchase anniversary (or 365 days after a purchase across 29 February) changes. If your year has one, open the return again and generate the package again.
QEF inclusions count toward the NIIT only with the §1.1411-10(g) election
QEF inclusions were counted as net investment income for the 3.8% NIIT in every case. Under the §1411 regulations they count only when the §1.1411-10(g) election applies. The return now asks whether it does; without that answer the inclusions stay out of the NIIT base and the package says so. The same release moved the NIIT into its own computation layer with a line-by-line Form 8960 trace.
Affected: Form 8960 · NIIT on QEF-elected funds · Verified against: Treas. Reg. §1.1411-10(c)(1)(i)(A) and (g)
What to do: If you hold a QEF-elected fund, answer the §1.1411-10(g) question on the review step and generate the package again.
Filing Obligations Diagnostic: six corrections before the first report
A review pass on the new diagnostic corrected six rules before any report was issued. An unanswered “were you living abroad” question now takes the April due date and is listed as an open question (only a confirmed answer earns the June extension). Self-employment gross receipts count in the gross-income test even when only net earnings were entered. The conversion table shows the most recent published year's rate. Net self-employment earnings of $400 or more now settle the filing requirement even when the currency conversion leaves a range. An employment period whose last month precedes its first is refused rather than read as zero income. And a married-filing-separately filer aged 65 or over is no longer told the threshold includes an age addition it does not have.
Affected: U.S. Filing Obligations Diagnostic — due dates, filing-threshold tests, conversion table · Verified against: IRS Publication 501 (filing thresholds); IRS Publication 54 (two-month extension for taxpayers abroad); IRC §6017
What to do: Nothing to redo — corrected before the first report.
Australian franking credits are not a Form 1116 credit
The Australia treaty page said the underlying Australian company tax counts as creditable foreign tax on Form 1116. For an individual it does not: IRC §901 credits foreign income tax paid by the taxpayer, and the company tax behind a franked dividend was paid by the company. The page now says so, and the franking-credits guide sets out the consequence — a fully franked dividend paid to a non-resident generally carries no Australian withholding, so there is usually no Australian tax on it to credit.
Affected: /treaty/australia · Form 1116 guidance for Australian dividends · Verified against: IRC §901
What to do: If a return relied on the earlier wording, compare its Form 1116 entry for Australian dividends with the corrected guide before filing.
Form 8938 counts the foreign account, not the securities inside it
Two corrections to the Form 8938 total. A foreign brokerage arrived twice — once as the account you entered and once as the funds held in it — so $300,000 of assets read as $600,000. And a fund imported without an ISIN had no recorded domicile, so it added nothing to the total even when it was flagged as a PFIC. The engine now follows §6038D: securities held in a financial account are reported through that account. Each brokerage records whether it is a US or non-US account; until that is answered its holdings still count and a blocking gap names the amount, and a PFIC counts as foreign unless its domicile is stated as US.
Affected: Form 8938 threshold test and Part I total · FBAR and Form 8938 account prompts · package PDF · Verified against: IRC §6038D(b); Form 8938 instructions
What to do: Answer the US / non-US question for each brokerage on the accounts step, then generate the package again.
PFIC screen covers funds domiciled in any non-US country
The fund screen accepted a fund domicile from seven jurisdictions only (Ireland, Luxembourg, the Cayman Islands, Bermuda, Jersey, Guernsey, Switzerland). A Canadian mutual fund, a UK OEIC, a French SICAV or a German UCITS ETF was screened as not a PFIC, so no Form 8621 or §1291 computation followed. The domicile half of the test now accepts any non-US country, while the name must state a vehicle (fund, ETF, SICAV, OEIC, unit trust and their non-English forms). Refinements the same day kept the wider screen off operating companies: a listed asset manager (Amundi SA, Invesco Ltd) is screened as a company, plural vehicle words (“ETFs”) match, a bare “Trust” goes to review rather than to either answer, and “profondo” no longer reads as “fondo”. Screen rule version 2026-08-26.4.
Affected: PFIC classification · Form 8621 count · §1291 · package tier · Verified against: IRC §1297(a); a corpus of 31 operating companies and 30 pooled vehicles with both error counts tested together
What to do: Classifications are stored at import. If you imported holdings before 2026-08-26, import the statement again or confirm each fund's status on the holdings step.
Returns computed from every imported row
The database answers at most 1,000 rows per request, and the engine read holdings and transactions in one request across every year imported — so a history above 1,000 rows lost dispositions without an error, and capital gains and the §1291 charge came out low. Reads are now paged to the end, and a read that reaches the import cap raises a blocking gap instead of a figure. A failed read of the brokerage-account list, which gates both reads, now stops the package with an error instead of producing a return from zero holdings.
Affected: Realized gains · §1291 · every figure in the preview and the package · Verified against: Regression tests that reproduce the 1,000-row response limit and a failed account read
What to do: If your imports across all years exceed 1,000 rows, open the return again and generate the package again.
Self-employment tax shown with the totalization condition
Schedule SE was computed at the full 15.3% and marked as settled. Where a totalization agreement assigns your social-security coverage to your country of residence, a certificate of coverage documents that no US self-employment tax is due. The figure stays — it is the IRS position without a certificate — and the return now states that it is overstated if you hold one.
Affected: Schedule SE · self-employment tax for filers living abroad · Verified against: US totalization agreements (IRS and SSA totalization guidance)
What to do: If you hold a certificate of coverage, read the Schedule SE note in the package and give the certificate to whoever files the return.
Interactive Brokers statements read in full
Corrections to the Interactive Brokers reader. Trades now carry the ISIN and description from the statement's instrument section, so a fund outside the ticker registry is screened as a fund rather than as a bare ticker. Trades are dated by trade date, not settlement date, so a late-December sale stays in its tax year. Currency-conversion rows are no longer recorded as securities sales, and withholding tax is reported as foreign tax rather than as a fee. A continental share count such as 1.234,5 is read as 1,234.5 shares (gains were unaffected: the statement supplies proceeds and basis).
Affected: Interactive Brokers imports — PFIC screening, tax-year assignment, Form 1116 foreign tax, share counts · Verified against: Regression tests on Interactive Brokers activity-statement layouts
What to do: If you imported an Interactive Brokers statement before 2026-08-26, import it again.
Foreign-currency sales converted at IRS yearly average rates
Non-USD dispositions had to be restated in USD by hand before they entered the return (see 2026-08-20). They are now converted at the IRS yearly average rate — proceeds at the rate for the year of sale, cost basis at the rate for the year of purchase. The table covers 39 currencies for 2021–2025; a year or currency outside it keeps the restate-in-USD gap rather than borrowing a neighbouring rate. Every conversion is disclosed with the rate applied.
Affected: Realized gains and §1291 on non-USD statements · Verified against: IRS yearly average currency exchange rates
What to do: Review the conversion notes in the package before filing.
Holdings keep their currency; a similar name can only send a fund to review
Two import corrections. A holding's currency was detected and then dropped on save, so a CHF year-end value entered the FBAR and Form 8938 tests as dollars; it is now stored, and a non-USD holding raises its conversion gap. And a foreign fund whose name contains a US fund's registered name — the London line of an Irish S&P 500 UCITS contains VOO's — was screened as not a PFIC at high confidence; name similarity can now only send a holding to review. Statements started before sign-in also keep their currency and ISIN columns when carried into the account.
Affected: FBAR and Form 8938 thresholds · PFIC classification · imports started before sign-in · Verified against: 31 CFR §1010.350 (FBAR maximum value); IRC §1297
What to do: If you imported holdings before 2026-08-25, import the statement again.
Sales without a share quantity, and fractional-share sales
A sale carrying proceeds, cost basis and both dates but no share quantity — common when an export omits the quantity column — was treated as unmatched and its gain dropped to $0 ($100,000 of proceeds on a $60,000 basis reported no gain). Such rows are now valued directly. Separately, a sale of less than one share split its proceeds wrongly: half a share sold for $90 on a $50 basis booked a $5 loss instead of a $40 gain. Proceeds are now allocated by each lot's share of the quantity sold.
Affected: Realized gains on Form 8949 / Schedule D · fractional shares and crypto · Verified against: IRC §1001 (gain is the amount realized less adjusted basis)
What to do: If your statements omit quantities or include fractional shares, open the return again and generate the package again.
The residence country you chose decides the treaty on the return
Denmark and Italy, added as treaty desks after the treaty step's country list was written, were saved as France, so a Danish filer saw the French convention. Changing country part-way also kept the earlier country's positions. The country chosen on the residency step now decides which treaty applies, positions saved for another country are cleared with a notice, and the checkout prices only the treaty positions the package includes.
Affected: Treaty positions (Form 8833) · Complex tier pricing · package PDF · Verified against: US income tax treaties with Denmark, Italy and France
What to do: If you live in Denmark or Italy, or changed country during the return, check the treaty step and generate the package again.
A foreign-currency sale without a rate creates no capital loss
A sale in a foreign currency with no exchange rate was valued at $0 of proceeds, which booked a long-term loss equal to the whole cost basis — on a test return it reduced tax owed from $23,867 to $17,867 — while the gap text said the row had been excluded. A foreign-currency cost basis was also subtracted from USD proceeds without conversion. Such rows are now excluded in fact, raise a blocking gap, and can be restated in USD on the transactions step.
Affected: Realized gains · §1291 · Swissquote, DEGIRO and other non-USD statements · Verified against: IRC §1001
What to do: If you imported a non-USD statement before 2026-08-20, open the return again — the conversion added on 2026-08-25 now values those rows.
PFIC income counts as investment income for the credit limit and Form 8960
Two of the three PFIC regimes (§1291 and QEF) were missing from the test for whether a return has investment income. For a filer whose only investment income was a PFIC disposition, the §904 foreign-source share defaulted to 100% — a full foreign tax credit with no sourcing — and Form 8960 was left off the forms list although the NIIT had been charged. On a test return, adding $1 of dividends moved tax owed by $30,000.28. One definition now covers all three regimes and net losses.
Affected: Form 1116 (§904 limitation) · Form 8960 · referral to a professional for §904 sourcing · Verified against: IRC §§904, 1291, 1411
What to do: If your return combines a PFIC sale or QEF inclusion with a foreign tax credit, open it again and generate the package again.
European statements: number format and currency
Amounts written 12.500,00 — the format of Swissquote, DEGIRO and most European brokers — were read as 12.50, a thousand times too small; the separator convention is now detected per value, including the Swiss apostrophe (12'500.00). The importer also saved every row as USD after removing the currency symbol, so a €10,000 sale entered the return as $10,000. The currency is now kept for holdings and sales, and a non-USD amount is converted or flagged — never read at 1:1.
Affected: Every CSV import — holding values, proceeds, cost basis · Verified against: Regression tests on European broker number formats and non-USD statements
What to do: If you imported a European statement before 2026-08-18, import it again.
Foreign operating companies are not presumed to be PFICs
A foreign domicile alone triggered the PFIC presumption, so Nestlé, Novartis, Accenture, Medtronic, Ryanair, Seagate and Spotify screened as PFICs — putting an ordinary stock sale through the §1291 regime at roughly nine times the correct tax. The screen now also requires a pooled-investment signal in the name; a foreign company without one goes to review.
Affected: PFIC classification · §1291 on foreign company stock · Verified against: IRC §1297(a) (income and asset tests)
What to do: If a foreign company's stock shows as a PFIC on your holdings step, confirm or change its status there and generate the package again.
§6621 underpayment rate for 2025 corrected to 7%
The interest table carried 7.5% for 2025; every quarter of 2025 was 7%, so the §1291 interest charge on any allocation spanning 2025 was overstated. It now uses 7%. The fourth-quarter 2026 rate (7%) was added on 2026-08-26, once Rev. Rul. 2026-15 published it; an unpublished quarter is never extrapolated.
Affected: §1291 interest charge (Form 8621 Part V) · Verified against: IRC §6621; IRS quarterly interest rates
What to do: If your return includes a §1291 charge, open it again and generate the package again.
A PFIC sold in full during the year is taxed under §1291
A PFIC sold down to zero before year-end left no year-end holding, so nothing marked the sale as a PFIC disposition: it was taxed as an ordinary capital gain and no Form 8621 was required. The classification is now stored on the transaction itself, and a fund sold in full counts toward the §1291 charge and the Form 8621 requirement for the year of sale. The on-screen figures took the fix on 2026-08-17 and the package generator on 2026-08-18 — on a $150,000 sale against a $60,000 basis, the package had shown $3,885.00 where the preview showed $35,027.92.
Affected: §1291 excess distribution · Form 8621 requirement · package PDF · Verified against: IRC §1291; IRC §1298(f); Form 8621 instructions
What to do: If you sold a fund in full during the year and generated a package before 2026-08-18, generate it again.
An unknown fund domicile is no longer read as a US domicile
When a broker export had no ISIN column — Schwab and Fidelity often omit it — each fund's domicile was unknown, and the screen treated unknown as US: every foreign fund in the file came back “not a PFIC” at high confidence and no Form 8621 followed. Unknown now goes to the low-confidence lane that asks you to confirm, and each holding stores the confidence and reason with its classification instead of the yes/no alone.
Affected: PFIC classification of imported holdings · Form 8621 count · Verified against: IRC §1297; Form 8621 instructions
What to do: Import the statement again, or confirm each fund's status on the holdings step.
FBAR penalties restated after Bittner v. United States
The non-willful FBAR penalty was described per account. After Bittner v. United States (2023) it applies per late report, not per account: up to $16,536 per report as inflation-adjusted, while the willful maximum is the greater of $165,353 or 50% of the balance. The “3 accounts × 6 years = $180,000” example was removed, and every page quoting the penalties reads the facts registry.
Affected: Home page · FBAR guides · llms.txt · Verified against: Bittner v. United States (2023); 31 U.S.C. §5321; 31 CFR §1010.821
What to do: Nothing to redo — a guidance correction; no computed figure changed.
Sample return computed by the engine
The sample return was assembled by hand and carried a stale $14,600 standard deduction and a $126,500 FEIE cap. It now runs through the same engine as a paid package with the 2025 figures ($15,750 and $130,000), and its result changed from $0 owed to $1,156 owed — all of it from the PFIC computation.
Affected: Sample return · sample PDF · home page case file · Verified against: Rev. Proc. 2024-40 as amended by the One Big Beautiful Bill Act; Form 2555 instructions
What to do: Nothing to redo — the sample is illustrative.
Sample report Form 8938 verdict made engine-consistent
The published sample report hardcoded “Form 8938 required: Yes” next to figures below the printed thresholds, and its asset total wrongly included US-domiciled holdings. The sample case now carries explicit foreign bank accounts, every threshold verdict is derived from the same rule the engine applies, and a regression suite replays the sample through the real engine so the two can never disagree again. The package PDF now also names the exact test crossed (end-of-year vs any-time) and explains how the specified-foreign-assets figure is composed.
Affected: Sample PFIC report · package PDF Form 8938/FBAR section · Verified against: IRS Form 8938 instructions (reporting thresholds for taxpayers living abroad)
Form 8938 any-time test and foreign-only asset base
The FATCA threshold check previously ran the end-of-year test only and compared the total portfolio (including US-domiciled assets) against the threshold. It now runs both statutory tests — end-of-year and maximum-value-during-year — against specified foreign assets only, with foreign accounts contributing an explicit EOY balance when provided (never assumed equal to their maximum).
Affected: Form 8938 threshold check · triggered-forms detection · Verified against: IRS Form 8938 instructions; 26 CFR §1.6038D-2
FBAR computed from entered accounts
FBAR previously surfaced as an unconditional attestation request. The engine now aggregates the maximum annual balance across entered foreign financial accounts and computes the $10,000 verdict, while still requesting confirmation that no accounts are missing.
Affected: FBAR (FinCEN 114) check · Verified against: 31 CFR §1010.350; FinCEN Form 114 instructions
PFIC elections now drive the computation (no fabricated §1291 worst case)
The QEF / mark-to-market / §1291 election previously did not change the computed tax, and a fixed-shape §1291 “worst case” was estimated from assumptions (5-year hold, zero prior distributions). Elections now branch the math: MtM includes the §1296 gain in ordinary income; QEF requires the fund's Annual Information Statement and is otherwise reported as needs-input; §1291 charges are computed only from actual dispositions with known acquisition dates and basis — never fabricated.
Affected: Form 8621 computation · per-holding election chooser · package PDF · Verified against: IRC §§1291, 1295, 1296; IRS Form 8621 instructions (Rev. Dec 2025)
§1291 excess-distribution charge on actual dispositions
Dispositions of a known PFIC with explicit acquisition date and cost basis are now taxed under the §1291 excess-distribution regime: gain allocated ratably over the holding period, prior-year slices taxed at each year's top statutory rate with §6621 underpayment interest compounded per year. PFIC dispositions are excluded from the normal capital-gain pass so nothing is taxed twice.
Affected: Form 8621 Part V · Schedule 2 line 17p · Verified against: IRC §1291(a),(c); IRC §6621 quarterly rate tables
FEIE (§911) stacking and NIIT (§1411) added
Form 2555 exclusion computed with the §911(f) stacking worksheet (tax on income including the add-back minus tax on the exclusion alone), capped at the year's maximum. NIIT computed as 3.8% of the lesser of net investment income and MAGI over the filing-status threshold — flagged needs-input when MAGI is not supplied rather than approximated.
Affected: Form 2555 · Form 8960 · 1040 summary · Verified against: IRC §911(f); IRC §1411; Form 2555 instructions
Golden-test harness for tax math
Introduced hand-derived reference cases cross-checked against independent bracket calculators before being committed — federal brackets, LT capital-gain stacking, Form 1116 credit cap, FIFO realized gains, threshold arithmetic. Every engine change since must pass this suite.
Affected: Entire tax engine · Verified against: Rev. Proc. 2024-40 (2025 inflation adjustments)
Last reviewed . Known limitations are listed per form on the supported-forms page.