Skip to main content

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.

All supported tax years

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.

All supported tax years

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.

Tax year 2025–2026

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

Tax year 2021–2025

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

Tax year 2025

§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.

All supported tax years

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.

All supported tax years

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.

All supported tax years

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.

Tax year 2025

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.

Tax year 2025–2026

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)

Tax year 2025–2026

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

Tax year 2025–2026

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

Tax year 2025

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)

Tax year 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

Tax year 2025

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

Tax year 2025

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.