Save the inputs of the tax estimate
The figures getbeel cannot know (legal form, ATECO, personnel costs, INPS scheme, last year’s taxes for the acconti…), stored per year and merged over the saved ones; returns the recomputed estimate. Next year starts from these answers. Live keys only (403 livemode_required); saving the inputs is free (nothing is charged to the balance).
The figures getbeel cannot know (legal form, ATECO, personnel costs, INPS scheme, last year’s taxes for the acconti…), stored per year and merged over the saved ones; returns the recomputed estimate. Next year starts from these answers. Live keys only (403 livemode_required); saving the inputs is free (nothing is charged to the balance).
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
application/json- body
year*integerTax year these inputs are for, e.g. 2026
2000 <= value <= 2100entity?stringcompany: società di capitali (IRES + IRAP); forfettario: regime forfettario (imposta sostitutiva + INPS); irpef: persona fisica in regime ordinario (IRPEF by bracket, detrazione lavoro autonomo, addizionali, INPS; the impatriati reduction from the tax profile); minimi: regime di vantaggio (5% substitute tax on income collected minus costs and INPS, codes 1793/1794/1795); other: not estimated
"company""forfettario""irpef""minimi""other"other_revenue?numberRevenue of the year not in getbeel’s issued invoices (e.g. corrispettivi), in euros as a number or a decimal string. Default 0
0 <= value <= 10000000000other_costs?numberCosts of the year without an invoice in getbeel (rent, insurance, bank fees…), in euros as a number or a decimal string. Default 0
0 <= value <= 10000000000personnel_costs?numberCompany: all personnel costs of the year, in euros as a number or a decimal string (deducted for IRES). Default 0
0 <= value <= 10000000000permanent_staff_costs?numberPermanent staff costs, deductible from the IRAP base
0 <= value <= 10000000000ires_adjustments?numberVariazioni fiscali: + non-deductible costs, − exempt income
-10000000000 <= value <= 10000000000irap_rate?numberIRAP rate of the region (default 3.9)
0 <= value <= 10isa_subject?booleanprior_year_ires?|Company: IRES (corporate income tax) of the previous year in euros. When given, the acconti are computed on it (historical method); null: on this year’s estimate
prior_year_irap?|Company: IRAP (regional production tax) of the previous year in euros. When given, the acconti are computed on it (historical method); null: on this year’s estimate
ateco_code?|Forfettario: ATECO code of the activity (Italian classification of economic activities), used to find the forfettario group when forfettario_group is not given
forfettario_group?|Forfettario: activity group 1–9 of the coefficients of profitability table (L. 190/2014, allegato 4). Takes precedence over ateco_code
startup_rate?boolean5% substitute tax for the first five years (c. 65)
revenue_basis?string"collected""invoiced"inps_scheme?string"gestione_separata""artigiani""commercianti""cassa_professionale""none"inps_reduction_35?booleaninsured_before_1996?booleaninps_amount_override?|Forfettario: the yearly social-security contributions in euros, when getbeel should not compute them (e.g. a cassa professionale). null: computed from inps_scheme
contributions_paid?|Forfettario: social-security contributions actually paid in the year, in euros, deducted from the income (cash basis). null: the estimated contributions are assumed
prior_year_substitute_tax?|Forfettario and minimi: imposta sostitutiva (the flat tax replacing income tax) of the previous year in euros (minimi: Redditi PF rigo LM42). When given, the acconti are computed on it (historical method); null: on this year’s estimate
irpef_activity?stringIRPEF (persona fisica, regime ordinario): professional = lavoro autonomo (quadro RE), business = impresa individuale (RF/RG, contabilità semplificata assumed). The impatriati regime from 2024 only reduces professional income
"professional""business"regional_surcharge_rate?|IRPEF: addizionale regionale of the region of residence, % (base 1.23; regions add up to 2.1 points; MEF Dipartimento Finanze tables). null: the base rate of the year, with a warning
municipal_surcharge_rate?|IRPEF: addizionale comunale of the comune of residence, % (0 to 0.9). null: unknown, counted as 0 with a warning
prior_year_irpef?|IRPEF: last year’s “Differenza” (Redditi PF rigo RN34: imposta netta minus ritenute) in euros. When given, the acconti (4033/4034) are computed on it (historical method); null: on this year’s estimate
withholdings_suffered?|IRPEF: ritenute d’acconto suffered in the year in euros (the clients’ 20% withholding), subtracted from the net IRPEF. null: the RT01 ritenute of the invoice payments recorded in getbeel
minimi_prior_losses?numberMinimi: losses of earlier years still usable (Redditi PF rigo LM9 col. 3: the regime’s losses of the last five years, the first three years’ without time limit), in euros. Default 0
0 <= value <= 10000000000OK
application/json- response
object*stringyear*integer-9007199254740991 <= value <= 9007199254740991entity*string"company""forfettario""irpef""minimi""other"label*stringreliable*booleaninputs*inputs_saved*booleanfigures*profit_before_tax*|nullires*|nullirap*|nullforfettario*|nullflat_tax?|Neo-residenti (TUIR art. 24-bis, from the tax profile): paid in one go on F24 ELIDE, code NRPP, by the saldo date. It does not change the partita IVA income tax
minimi?|nullirpef?|nullinps*|nulltotal_taxes*stringDecimal amount as a string
^-?\d+\.\d{2}$installments*array<>warnings*array<string>sources*array<string>curl -X PUT 'https://www.getbeel.com/api/v1/companies/me/tax-estimate' \ -H 'Content-Type: application/json' \ -d '{ "year": 2000}'{ "object": "tax_estimate", "year": -9007199254740991, "entity": "company", "label": "Stima, da verificare con il commercialista", "reliable": false, "inputs": { "property1": null, "property2": null }, "inputs_saved": true, "figures": { "revenue_invoiced": "122.00", "revenue_collected": "122.00", "withholdings_collected": "122.00", "costs_invoiced": "122.00", "asset_purchases": "122.00", "depreciation": "122.00", "full_deduction": "122.00", "gains": "122.00", "losses": "122.00", "invoices_issued": -9007199254740991, "invoices_received": -9007199254740991, "unreviewed_received": -9007199254740991, "skipped_foreign_currency": -9007199254740991 }, "profit_before_tax": "122.00", "ires": { "base": "122.00", "rate": 0, "amount": "122.00" }, "irap": { "base": "122.00", "rate": 0, "amount": "122.00" }, "forfettario": { "revenue": "122.00", "group": -9007199254740991, "coefficient": 0, "gross_income": "122.00", "contributions_deducted": "122.00", "taxable_income": "122.00", "rate": 0, "rate_source": "profile", "substitute_tax": "122.00" }, "flat_tax": { "amount": "122.00", "family_members": -9007199254740991, "source": "string" }, "minimi": { "revenue": "122.00", "costs": "122.00", "gross_income": "122.00", "contributions_deducted": "122.00", "contributions_excess": "122.00", "losses_used": "122.00", "taxable_income": "122.00", "rate": 0, "rate_source": "profile", "substitute_tax": "122.00" }, "irpef": { "income": "122.00", "impatriati_share": 0, "reduction_kind": "impatriati_2024", "reddito_complessivo": "122.00", "contributions_deducted": "122.00", "taxable_income": "122.00", "gross_tax": "122.00", "deduction": "122.00", "net_tax": "122.00", "withholdings": "122.00", "tax_due": "122.00", "regional_surcharge": { "rate": 0, "amount": "122.00" }, "municipal_surcharge": { "rate": 0, "amount": "122.00" }, "second_rate": 0 }, "inps": { "scheme": "gestione_separata", "base": "122.00", "amount": "122.00", "fixed_part": "122.00", "reduction_applied": true }, "total_taxes": "122.00", "installments": [ { "key": "first_advance", "tax_year": -9007199254740991, "tax": "ires", "tax_code": "string", "due_date": "2026-10-29", "late_due_date": "2026-10-29", "amount": "122.00", "confirmed": true, "note": "string", "note_code": "estimated_advances" } ], "warnings": [ "string" ], "sources": [ "string" ]}Tax estimate of a year (stima) GET
An estimate, to check with the accountant: for a company (società di capitali) IRES 24% and IRAP (3.9% or the regional rate given); for the regime forfettario the imposta sostitutiva (15%, or 5% for start-ups) on revenue × the ATECO group coefficient minus contributions, and the INPS contributions (gestione separata 26.07%, artigiani/commercianti with the 2026 minimale). Figures come from getbeel: issued invoices (or payments recorded, for forfettari), reviewed received invoices without the fixed assets, depreciation and gains of the year. installments lists acconti and saldo with F24 codes and dates (art. 17 DPR 435/2001); dates not yet confirmed by a source in force are confirmed false.
List POS–RT links GET
Each payment terminal linked to a registratore telematico, with its status (to_file, filed, end_to_file, ended) and, when something is still to communicate, the window of provv. AdE 424470/2025 (from the 6th to the last working day of the second month after the change).