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.
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.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
application/json- body
Changes only what it sends; null clears a value (back to the detection). Ask the user, never guess.
legal_form?|nullvat_periodicity?|nullwithholding_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?booleanOnly 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?|nullsocial_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"
items <= 13OK
application/json- response
Values are the effective profile: yours, else a high-confidence detection, else null
object*stringlegal_form*|nullregime_fiscale*|From the company profile (RF01 ordinario, RF19 forfettario…): changed there, confirmed here
vat_periodicity*|nullwithholding_agent*boolean|nullhas_employees*boolean|nullreverse_charge_suppliers*boolean|nullintrastat*boolean|nulloss_suggested*booleanB2C 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|nullliquidation_from*|nullfirst_fiscal_year*|nullsocial_security*|nullsocial_security_fund*string|nullis_person*booleanA 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.
curl -X PATCH 'https://www.getbeel.com/api/v1/companies/me/tax-profile' \ -H 'Content-Type: application/json' \ -d '{}'{ "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" } ]}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.
Detect the tax profile now POST
Re-runs the detection from the company data (name, regime, issued and received invoices, recorded withholdings), stores it and returns it with the profile. It never changes a value you set. New obligations (e.g. B2C sales above the OSS threshold) also add a notice in the app. getbeel runs it every month by itself. Live keys only.