Read Estimate

GET /api/autopilot/estimate?year= — the live cash-basis tax position.

cash_received is the year's collected revenue (IncassiYear.total) and the only input to breakdown: the forfettario taxes what was banked, so an invoice that is issued but unpaid changes nothing here. It is reported beside it as invoiced_unpaid precisely so the estimate is not misread as the whole year — that figure is what is still owed, not income yet.

limit is the forfettario revenue ceiling and limit_used_pct the share of it consumed, uncapped: past 100 the user needs to see by how far, and breakdown.eligible is what says the regime itself is gone (the engine then reports the ordinario fallback, which is the honest answer to "what do I owe", not an offer).

by_ateco splits cash_received by activity (AP-093): a user working under two ATECO codes has two coefficients, so no single stored one describes the year. When two or more coded activities carry revenue, breakdown is computed from the blended coefficient Σ(revenue_i × coefficient_i) / Σ(revenue_i) — the same taxable base quadro LM reaches row by row. With one activity (the ordinary case) the profile's own coefficient is used exactly as before, so nothing about a single-ATECO estimate changes.