Add a rule value
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.
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.
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
key*stringA rule key getbeel knows (GET /v1/tax-rules lists them), e.g. inps.maternity_yearly
value*numberIn the unit of the key: a % as 26.07, euros as 4604.2
valid_from*stringFirst day it applies (YYYY-MM-DD)
^\d{4}-\d{2}-\d{2}$valid_to?|Last day it applies; null: until changed
source_url*stringhttps link of the official source
^https:\/\/length <= 500source_title*stringThe act, e.g. INPS circolare n. 9 del 2 febbraio 2027
1 <= length <= 300source_article?|Article, paragraph or section of the source
quote?|The sentence of the source that gives the value
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)$uuidkey*stringvalue*numbervalid_from*string^\d{4}-\d{2}-\d{2}$valid_to*|nullsource_url*stringsource_title*stringsource_article*string|nullsource_quote*|The sentence of the source that gives the value
quote_verified*booleanThe quote was found word for word in the source getbeel read (false for a PDF or a value typed by hand)
status*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|nulldecision_note*string|nullcreated_at*stringcurl -X POST 'https://www.getbeel.com/api/v1/tax-rules/values' \ -H 'Content-Type: application/json' \ -d '{ "key": "string", "value": 0, "valid_from": "string", "source_url": "string", "source_title": "string", "status": "active"}'{ "object": "tax_rule_value", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "key": "inps.maternity_yearly", "value": 0, "valid_from": "string", "valid_to": "string", "source_url": "string", "source_title": "string", "source_article": "string", "source_quote": "string", "quote_verified": true, "status": "pending", "proposed_via": "admin", "decided_at": "string", "decision_note": "string", "created_at": "string"}Tax rules in force GET
Every rule value by date (origin code: shipped with getbeel; db: added since), the values missing in the next 13 months, and the proroghe in force. pending (the proposals of the rules watch) and watch_runs are null unless the key is a live key of a getbeel administrator. Both key modes.
Add a proroga POST
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.