The company's Italian tax deadlines
Deadlines between from and to (default: 90 days ago to a year ahead), already moved off weekends, holidays and 1–20 August: imposta di bollo on e-invoices (amount computed from the issued invoices), withholding taxes (1040), VAT payments, VAT advance and balance, LIPE, the annual VAT return, the OSS return (never moved), and for companies (IRES subjects) the income-tax saldo and acconti (IRES/IRAP), the Redditi SC and IRAP returns, the diritto camerale and the bilancio deposit. Each has its legal source. Deadlines that depend on settings the app cannot infer (VAT monthly or quarterly, withholding agent, OSS registration, the income-tax answers saved in Stima imposte) appear once they are set in the app (missing_settings). Companies outside Italy get applicable false and no deadlines.
Deadlines between from and to (default: 90 days ago to a year ahead), already moved off weekends, holidays and 1–20 August: imposta di bollo on e-invoices (amount computed from the issued invoices), withholding taxes (1040), VAT payments, VAT advance and balance, LIPE, the annual VAT return, the OSS return (never moved), and for companies (IRES subjects) the income-tax saldo and acconti (IRES/IRAP), the Redditi SC and IRAP returns, the diritto camerale and the bilancio deposit. Each has its legal source. Deadlines that depend on settings the app cannot infer (VAT monthly or quarterly, withholding agent, OSS registration, the income-tax answers saved in Stima imposte) appear once they are set in the app (missing_settings). Companies outside Italy get applicable false and no deadlines.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
from?stringFirst due date, default 90 days ago
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$dateto?stringLast due date, default a year from today
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$dateOK
application/json- response
object*stringapplicable*booleanFalse when the company is not Italian
missing_settings*array<>Set these in the app (Taxes → Settings; income_tax: Taxes → Tax estimate, whether the company pays IRES and applies ISA); deadlines that depend on them are left out until then
settings*regime_fiscale*string|nullfrom*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$dateto*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$datedata*array<>curl -X GET 'https://www.getbeel.com/api/v1/companies/me/tax-calendar'{ "object": "tax_calendar", "applicable": true, "missing_settings": [ "vat_periodicity" ], "settings": { "vat_periodicity": "monthly", "withholding_agent": true, "oss_from": "2026-10-29", "oss_until": "2026-10-29", "income_tax": { "property1": { "entity": "company", "isa": true }, "property2": { "entity": "company", "isa": true } } }, "regime_fiscale": "string", "from": "2026-10-29", "to": "2026-10-29", "data": [ { "id": "bollo:2026-Q3", "object": "tax_deadline", "kind": "bollo", "title": "string", "period": "2026-Q3", "due_date": "2026-10-29", "nominal_due_date": "2026-10-29", "days_left": -9007199254740991, "overdue": true, "action": "payment", "tax_codes": [ "string" ], "amount": "122.00", "amount_status": "final", "status": "to_prepare", "filing_id": "string", "can_prepare": true, "filing_type": "bollo", "needs_review": true, "note": "string", "note_key": "quarterly_interest", "source": "string", "extension": { "source_title": "string", "source_url": "string" }, "applies_because": [ { "key": "vat_quarterly", "params": { "property1": "string", "property2": "string" } } ], "review_key": "in_liquidation" } ]}Exclude or correct a VAT register row PUT
The same as Rettifica in Tasse → Registri IVA: exclude keeps the row out of the liquidazione; adjust sets the VAT that counts (vat_amount), for example the deductible share of a car or phone cost. A reason is required and kept with the row for the accountant. It replaces an earlier adjustment of the row. GET vat-registers and vat-settlements show the effect; a liquidazione already saved stays as it was until it is prepared again (POST /filings, type vat_payment). Live keys only.
The tax calendar as an iCal feed GET
For Google, Outlook or Apple calendars. Authenticated by the secret feed token from the app (Taxes → Add to calendar), not by an API key; rotating it there cuts off old subscriptions. Unknown tokens get 404.