GetbeelDocs

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.

POST
/tax-rules/overrides

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.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Getbeel-Company?string

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

Formatuuid
application/json
  1. body
deadline_kind*string
Value in"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

First legal (nominal) due date it moves (YYYY-MM-DD)

Match^\d{4}-\d{2}-\d{2}$
nominal_to*string

Last legal due date it moves (the same day for one)

Match^\d{4}-\d{2}-\d{2}$
new_due_date*string

The new due date (YYYY-MM-DD); never earlier than nominal_to

Match^\d{4}-\d{2}-\d{2}$
valid_from*string

The day the act is in force (YYYY-MM-DD)

Match^\d{4}-\d{2}-\d{2}$
source_url*string

https link of the official act

Match^https:\/\/
Lengthlength <= 500
source_title*string

The act, e.g. DPCM 12 giugno 2027, art. 1

Length1 <= length <= 300
quote?|

The sentence of the act that moves the deadline

note?|

Internal note

status*string
Default"pending"
Value in"active""pending"

Corpo della risposta

OK

application/json
  1. response
object*string
id*string
Match^([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)$
Formatuuid
deadline_kind*string
Value in"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
Match^\d{4}-\d{2}-\d{2}$
nominal_to*string
Match^\d{4}-\d{2}-\d{2}$
new_due_date*string
Match^\d{4}-\d{2}-\d{2}$
valid_from*string
Match^\d{4}-\d{2}-\d{2}$
source_url*string
source_title*string
source_quote*string|null
quote_verified*boolean
note*string|null
status*string
Value in"pending""active""rejected"
proposed_via*string

Who added it: admin page, API, MCP, or the weekly rules watch (ai)

Value in"admin""api""mcp""ai"
decided_at*string|null
notified_at*|

When the teams whose deadlines it moves were told

created_at*string
filings_updated?integer

Prepared, unpaid filings whose due date changed (on create and approve)

Range-9007199254740991 <= value <= 9007199254740991
Esempio di richiesta
curl -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"}'
Esempio di risposta
{  "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}