GetbeelDocs

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

PUT
/companies/me/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).

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Request Body

application/json
  1. body
year*integer

Tax year these inputs are for, e.g. 2026

Range2000 <= value <= 2100
entity?string

company: 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

Value in"company""forfettario""irpef""minimi""other"
other_revenue?number

Revenue of the year not in getbeel’s issued invoices (e.g. corrispettivi), in euros as a number or a decimal string. Default 0

Range0 <= value <= 10000000000
other_costs?number

Costs of the year without an invoice in getbeel (rent, insurance, bank fees…), in euros as a number or a decimal string. Default 0

Range0 <= value <= 10000000000
personnel_costs?number

Company: all personnel costs of the year, in euros as a number or a decimal string (deducted for IRES). Default 0

Range0 <= value <= 10000000000
permanent_staff_costs?number

Permanent staff costs, deductible from the IRAP base

Range0 <= value <= 10000000000
ires_adjustments?number

Variazioni fiscali: + non-deductible costs, − exempt income

Range-10000000000 <= value <= 10000000000
irap_rate?number

IRAP rate of the region (default 3.9)

Range0 <= value <= 10
isa_subject?boolean
prior_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?boolean

5% substitute tax for the first five years (c. 65)

revenue_basis?string
Value in"collected""invoiced"
inps_scheme?string
Value in"gestione_separata""artigiani""commercianti""cassa_professionale""none"
inps_reduction_35?boolean
insured_before_1996?boolean
inps_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?string

IRPEF (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

Value in"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?number

Minimi: 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

Range0 <= value <= 10000000000

Response Body

OK

application/json
  1. response
object*string
year*integer
Range-9007199254740991 <= value <= 9007199254740991
entity*string
Value in"company""forfettario""irpef""minimi""other"
label*string
reliable*boolean
inputs*
inputs_saved*boolean
figures*
profit_before_tax*|null
ires*|null
irap*|null
forfettario*|null
flat_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?|null
irpef?|null
inps*|null
total_taxes*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
installments*array<>
warnings*array<string>
sources*array<string>
Example Request
curl -X PUT 'https://www.getbeel.com/api/v1/companies/me/tax-estimate' \  -H 'Content-Type: application/json' \  -d '{  "year": 2000}'
Example Response
{  "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"  ]}