Detect the tax profile now
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.
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.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
OK
application/json- response
object*stringdetected_at*stringobligations*array<>New obligations found by this run (a notice was added in the app)
changed*array<>Fields whose detected value or confidence changed
held*array<>Fields the new data would change in a way that removes or changes deadlines: kept as they were and marked held until you answer them
profile*Values are the effective profile: yours, else a high-confidence detection, else null
curl -X POST 'https://www.getbeel.com/api/v1/companies/me/tax-profile/detect'{ "object": "tax_profile_detection", "detected_at": "string", "obligations": [ "legal_form" ], "changed": [ "legal_form" ], "held": [ "legal_form" ], "profile": { "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" } ] }}Change the tax profile PATCH
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.
Depreciation categories and coefficients GET
The ministerial coefficients of DM 31 December 1988 (as amended by DM 28 March 1996) for the groups most small companies and professionals use ("Attività non precedentemente specificate – Altre attività", hotels and restaurants, personal services), and the art. 103 TUIR limits for software, patents, trademarks and goodwill. Any other coefficient can be given by hand when creating an asset.