GetbeelDocs

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.

PATCH
/companies/me/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.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Request Body

application/json
  1. body
vat_periodicity?string

How the company settles VAT (liquidazione mensile or trimestrale). It decides the VAT deadlines and periods.

Value in"monthly""quarterly"
withholding_agent?boolean

Whether 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?boolean

Automatic 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?integer

Days before the due date for the automatic preparation (1-30, default 5).

Range1 <= value <= 30

Response Body

OK

application/json
  1. response

null means not set yet (see missing_settings of the tax calendar)

object*string
vat_periodicity*|null
withholding_agent*|null
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*boolean

Automatic 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*integer

Days before the due date for the automatic preparation (1-30, default 5).

Range1 <= value <= 30
require_accountant_approval*boolean

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

Example Request
curl -X PATCH 'https://www.getbeel.com/api/v1/companies/me/tax-settings' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "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}