GetbeelDocs

Tax estimate of a year (stima)

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.

GET
/companies/me/tax-estimate

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.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Query Parameters

year?integer

Tax year (default: this year)

Range2000 <= value <= 2100

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 GET 'https://www.getbeel.com/api/v1/companies/me/tax-estimate'
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"  ]}