GetbeelDocs

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.

GET
/companies/me/tax-calendar

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.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Parametri query

from?string

First due date, default 90 days ago

Match^(?:(?:\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])))$
Formatdate
to?string

Last due date, default a year from today

Match^(?:(?:\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])))$
Formatdate

Corpo della risposta

OK

application/json
  1. response
object*string
applicable*boolean

False 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|null
from*string
Match^(?:(?:\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])))$
Formatdate
to*string
Match^(?:(?:\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])))$
Formatdate
data*array<>
Esempio di richiesta
curl -X GET 'https://www.getbeel.com/api/v1/companies/me/tax-calendar'
Esempio di risposta
{  "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"    }  ]}