Change the tax settings
Changes only what it sends. The VAT periodicity decides the VAT periods (months or quarters) of the registers, liquidazioni and F24: change it only as the company actually settles VAT (ask the accountant). Live keys only.
Changes only what it sends. The VAT periodicity decides the VAT periods (months or quarters) of the registers, liquidazioni and F24: change it only as the company actually settles VAT (ask the accountant). Live keys only.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
application/json- body
vat_periodicity?stringHow the company settles VAT (liquidazione mensile or trimestrale). It decides the VAT deadlines and periods.
"monthly""quarterly"withholding_agent?booleanWhether the company is a sostituto d’imposta (pays professionals and withholds ritenute): adds the 1040 F24 deadlines.
oss_from?|The day the OSS union scheme applies from (Portale OSS registration; Reg. 282/2011 art. 57d). null: not registered (also clears oss_until). Adds the quarterly OSS return and payment deadlines.
oss_until?|The day the OSS scheme stops applying (exit or exclusion). null: still registered.
auto_prepare?booleanAutomatic preparation (default true): getbeel prepares the F24 of bollo, ritenute and periodic VAT auto_prepare_days days before the due date, once the period is over and the amount is known, and sends filing.ready. false: only reminders.
auto_prepare_days?integerDays before the due date for the automatic preparation (1-30, default 5).
1 <= value <= 30OK
application/json- response
null means not set yet (see missing_settings of the tax calendar)
object*stringvat_periodicity*|nullwithholding_agent*|nulloss_from*|The day the OSS union scheme applies from (Portale OSS registration; Reg. 282/2011 art. 57d). null: not registered (also clears oss_until). Adds the quarterly OSS return and payment deadlines.
oss_until*|The day the OSS scheme stops applying (exit or exclusion). null: still registered.
auto_prepare*booleanAutomatic preparation (default true): getbeel prepares the F24 of bollo, ritenute and periodic VAT auto_prepare_days days before the due date, once the period is over and the amount is known, and sends filing.ready. false: only reminders.
auto_prepare_days*integerDays before the due date for the automatic preparation (1-30, default 5).
1 <= value <= 30require_accountant_approval*booleanRead-only here (an owner sets it in the app): when true, only the commercialista approves a filing, and a receipt or protocol number waits for that approval.
curl -X PATCH 'https://www.getbeel.com/api/v1/companies/me/tax-settings' \ -H 'Content-Type: application/json' \ -d '{}'{ "object": "tax_settings", "vat_periodicity": "monthly", "withholding_agent": true, "oss_from": "2026-10-29", "oss_until": "2026-10-29", "auto_prepare": true, "auto_prepare_days": 1, "require_accountant_approval": true}Get the tax settings GET
VAT periodicity and whether the company is a withholding agent, as Tasse → Impostazioni. null means not set: the deadlines that depend on it are left out of the tax calendar (missing_settings). Both key modes.
Get the tax profile GET
Which taxes apply to the company: legal form, regime, VAT periodicity, withholding agent, employees, foreign suppliers, Intrastat, OSS (sales evidence and the registration), liquidation, first tax year, social security and special income tax regimes, each with its `effect` for the current year (rate or taxed share, until when, F24 codes, the official source of each number) and `regime_warnings`. Each value is yours (sources: user) or a high-confidence detection (detected), with the evidence in `detection`; low-confidence values are never applied and come back in `questions` to ask the user once. Both key modes. Free.