Add a proroga
Moves the deadlines of deadline_kind (all: every tax deadline; never the EU OSS return or the bilancio deposit) whose legal date is in nominal_from–nominal_to to new_due_date, from valid_from. status active applies it at once (official source required), updates prepared unpaid filings and tells the teams it affects in the app; pending (default) waits for approval. Tax rules apply to every company: only getbeel administrators change them, with a live key that has the admin-only tax_rules:admin scope (created in the admin page; 403 insufficient_scope otherwise, 403 live_key_required with a test key, 403 super_admin_required when its creator is no longer an administrator). Recorded in the audit log.
Moves the deadlines of deadline_kind (all: every tax deadline; never the EU OSS return or the bilancio deposit) whose legal date is in nominal_from–nominal_to to new_due_date, from valid_from. status active applies it at once (official source required), updates prepared unpaid filings and tells the teams it affects in the app; pending (default) waits for approval. Tax rules apply to every company: only getbeel administrators change them, with a live key that has the admin-only tax_rules:admin scope (created in the admin page; 403 insufficient_scope otherwise, 403 live_key_required with a test key, 403 super_admin_required when its creator is no longer an administrator). Recorded in the audit log.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Getbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidapplication/json- body
deadline_kind*string"all""bollo""withholdings""vat_payment""vat_annual_balance""vat_advance""lipe""vat_return""oss_return""income_tax_balance""income_tax_advance""chamber_fee""income_tax_return""financial_statements""inps_fixed""inps_balance""inps_advance""inps_reduction_request""pf_tax_balance""pf_tax_advance""pf_tax_return"nominal_from*stringFirst legal (nominal) due date it moves (YYYY-MM-DD)
^\d{4}-\d{2}-\d{2}$nominal_to*stringLast legal due date it moves (the same day for one)
^\d{4}-\d{2}-\d{2}$new_due_date*stringThe new due date (YYYY-MM-DD); never earlier than nominal_to
^\d{4}-\d{2}-\d{2}$valid_from*stringThe day the act is in force (YYYY-MM-DD)
^\d{4}-\d{2}-\d{2}$source_url*stringhttps link of the official act
^https:\/\/length <= 500source_title*stringThe act, e.g. DPCM 12 giugno 2027, art. 1
1 <= length <= 300quote?|The sentence of the act that moves the deadline
note?|Internal note
status*string"pending""active""pending"OK
application/json- response
object*stringid*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuiddeadline_kind*string"all""bollo""withholdings""vat_payment""vat_annual_balance""vat_advance""lipe""vat_return""oss_return""income_tax_balance""income_tax_advance""chamber_fee""income_tax_return""financial_statements""inps_fixed""inps_balance""inps_advance""inps_reduction_request""pf_tax_balance""pf_tax_advance""pf_tax_return"nominal_from*string^\d{4}-\d{2}-\d{2}$nominal_to*string^\d{4}-\d{2}-\d{2}$new_due_date*string^\d{4}-\d{2}-\d{2}$valid_from*string^\d{4}-\d{2}-\d{2}$source_url*stringsource_title*stringsource_quote*string|nullquote_verified*booleannote*string|nullstatus*string"pending""active""rejected"proposed_via*stringWho added it: admin page, API, MCP, or the weekly rules watch (ai)
"admin""api""mcp""ai"decided_at*string|nullnotified_at*|When the teams whose deadlines it moves were told
created_at*stringfilings_updated?integerPrepared, unpaid filings whose due date changed (on create and approve)
-9007199254740991 <= value <= 9007199254740991curl -X POST 'https://www.getbeel.com/api/v1/tax-rules/overrides' \ -H 'Content-Type: application/json' \ -d '{ "deadline_kind": "all", "nominal_from": "string", "nominal_to": "string", "new_due_date": "string", "valid_from": "string", "source_url": "string", "source_title": "string", "status": "active"}'{ "object": "tax_calendar_override", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "deadline_kind": "all", "nominal_from": "string", "nominal_to": "string", "new_due_date": "string", "valid_from": "string", "source_url": "string", "source_title": "string", "source_quote": "string", "quote_verified": true, "note": "string", "status": "pending", "proposed_via": "admin", "decided_at": "string", "notified_at": "string", "created_at": "string", "filings_updated": -9007199254740991}Add a rule value POST
Adds a value of a known key for its dates. status active puts it in force at once, only with an official source (agenziaentrate.gov.it, mef.gov.it, finanze.gov.it, gazzettaufficiale.it, inps.it, normattiva.it, fatturapa.gov.it; 400 official_source_required otherwise); pending (default) waits for approval. Two active values of a key never overlap (409 rule_value_overlap). Tax rules apply to every company: only getbeel administrators change them, with a live key that has the admin-only tax_rules:admin scope (created in the admin page; 403 insufficient_scope otherwise, 403 live_key_required with a test key, 403 super_admin_required when its creator is no longer an administrator). Recorded in the audit log.
Approve or reject a proposal POST
Approves (in force at once) or rejects a pending rule value or proroga. Through the API only a proposal with an official source can be approved, and a rules-watch proposal only when its quote was found word for word in the source (400 quote_not_verified: a PDF; approve it in the admin page after reading it). 404 proposal_not_found when it was already decided. Tax rules apply to every company: only getbeel administrators change them, with a live key that has the admin-only tax_rules:admin scope (created in the admin page; 403 insufficient_scope otherwise, 403 live_key_required with a test key, 403 super_admin_required when its creator is no longer an administrator). Recorded in the audit log.