GetbeelDocs

Change the tax profile

Changes only what it sends and marks it confirmed; null clears a value (back to the detection); `confirm` confirms detected values as they are; `regimes` replaces the special income tax regimes; their `params` are typed per kind and getbeel computes the numbers from them. A value you set always wins over the detection and changes which deadlines the tax calendar lists. Ask the user, never guess. Recorded in the audit log. Live keys only.

PATCH
/companies/me/tax-profile

Changes only what it sends and marks it confirmed; null clears a value (back to the detection); confirm confirms detected values as they are; regimes replaces the special income tax regimes; their params are typed per kind and getbeel computes the numbers from them. A value you set always wins over the detection and changes which deadlines the tax calendar lists. Ask the user, never guess. Recorded in the audit log. Live keys only.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

application/json
  1. body

Changes only what it sends; null clears a value (back to the detection). Ask the user, never guess.

legal_form?|null
vat_periodicity?|null
withholding_agent?|

Pays professionals' fees with a ritenuta d'acconto (adds the monthly 1040 F24)

has_employees?|

Has employees on payroll (adds the 1001 code to the monthly withholdings)

reverse_charge_suppliers?|

Buys from suppliers outside Italy (reverse charge, autofatture TD17–TD19)

oss_registered?boolean

Only false: "not registered for the OSS" (answers the question and clears oss_from / oss_until). To register, set oss_from with PATCH /companies/me/tax-settings

intrastat?|

Files Intrastat lists (sales or purchases with other EU businesses)

in_liquidation?|

The company is in liquidation (its deadlines from liquidation_from are flagged for review)

liquidation_from?|

Only with in_liquidation: true

first_fiscal_year?|

First tax year of the business (no deadline of an earlier year is listed)

social_security?|null
social_security_fund?|

Name of the cassa (Cassa Forense, Inarcassa…), only with social_security: cassa_professionale

regimes?array<>|

Replaces the special income tax regimes; [] or null: none (answers the special_regimes question)

confirm?array<>

Fields whose detected value you confirm as it is (e.g. ["legal_form"]); special_regimes confirms "none"

Itemsitems <= 13

Corpo della risposta

OK

application/json
  1. response

Values are the effective profile: yours, else a high-confidence detection, else null

object*string
legal_form*|null
regime_fiscale*|

From the company profile (RF01 ordinario, RF19 forfettario…): changed there, confirmed here

vat_periodicity*|null
withholding_agent*boolean|null
has_employees*boolean|null
reverse_charge_suppliers*boolean|null
intrastat*boolean|null
oss_suggested*boolean

B2C sales to other EU countries above the €10,000 EU threshold (evidence only: the OSS registration is a separate setting)

oss_registered*|

Registered in the OSS union scheme: read-only, from the tax settings (oss_from set: true; "not registered" answered on the profile: false; null: not answered). Set it with PATCH /companies/me/tax-settings (oss_from, oss_until), which also adds the quarterly OSS returns

in_liquidation*boolean|null
liquidation_from*|null
first_fiscal_year*|null
social_security*|null
social_security_fund*string|null
is_person*boolean

A natural person (ditta individuale, professionista)

regimes*array<>
regime_warnings*array<>

Mismatches between the RegimeFiscale of the company and the regimes in force: regime_code_mismatch (e.g. forfettario with RF01), regime_missing_for_code (RF19 without a forfettario regime), two_substitute_regimes, impatriati_with_forfettario (forfettario income cannot use the impatriati reduction), docenti_with_neo_residenti (not cumulable, L. 232/2016 c. 154), docenti_with_substitute_regime (forfettario or minimi income cannot use the docenti reduction)

sources*

Per field: user (set by you: wins), detected (high-confidence detection, applied), unknown (asked in questions or left out), not_applicable

confirmed*

Who confirmed each field, through what, when

detection*
questions*array<>

What to ask the user, once, in plain language. Never guess the answer: ask and PATCH it.

Esempio di richiesta
curl -X PATCH 'https://www.getbeel.com/api/v1/companies/me/tax-profile' \  -H 'Content-Type: application/json' \  -d '{}'
Esempio di risposta
{  "object": "tax_profile",  "legal_form": "srl",  "regime_fiscale": "string",  "vat_periodicity": "monthly",  "withholding_agent": true,  "has_employees": true,  "reverse_charge_suppliers": true,  "intrastat": true,  "oss_suggested": true,  "oss_registered": true,  "in_liquidation": true,  "liquidation_from": "2026-10-29",  "first_fiscal_year": -9007199254740991,  "social_security": "gestione_separata",  "social_security_fund": "string",  "is_person": true,  "regimes": [    {      "kind": "irpef_ordinario",      "valid_from": "2026-10-29",      "valid_until": "2026-10-29",      "params": {        "property1": "string",        "property2": "string"      },      "id": "string",      "source": "detected",      "effect": {        "kind": "irpef_ordinario",        "year": -9007199254740991,        "applies": true,        "rate": {          "value": 0,          "source": {            "title": "string",            "url": "string",            "article": "string"          }        },        "taxable_share": {          "value": 0,          "source": {            "title": "string",            "url": "string",            "article": "string"          }        },        "income_cap": {          "value": 0,          "source": {            "title": "string",            "url": "string",            "article": "string"          }        },        "ends_year": -9007199254740991,        "tax_codes": {          "first": "string",          "second": "string",          "balance": "string"        },        "flat_tax": {          "value": 0,          "source": {            "title": "string",            "url": "string",            "article": "string"          }        },        "notes": [          "string"        ],        "missing_rules": [          "string"        ]      }    }  ],  "regime_warnings": [    {      "key": "string",      "params": {        "property1": "string",        "property2": "string"      }    }  ],  "sources": {    "property1": "user",    "property2": "user"  },  "confirmed": {    "property1": {      "via": "user",      "at": "string"    },    "property2": {      "via": "user",      "at": "string"    }  },  "detection": {    "detected_at": "string",    "fields": {      "property1": {        "value": "string",        "confidence": "high",        "evidence": {          "key": "string",          "params": {            "property1": "string",            "property2": "string"          }        },        "held": {          "value": "string",          "confidence": "high",          "evidence": {            "key": "string",            "params": {              "property1": "string",              "property2": "string"            }          },          "since": "string"        }      },      "property2": {        "value": "string",        "confidence": "high",        "evidence": {          "key": "string",          "params": {            "property1": "string",            "property2": "string"          }        },        "held": {          "value": "string",          "confidence": "high",          "evidence": {            "key": "string",            "params": {              "property1": "string",              "property2": "string"            }          },          "since": "string"        }      }    }  },  "questions": [    {      "field": "legal_form",      "question": "string"    }  ]}