Register a fixed asset
Registers a bene strumentale, often bought with a received invoice (received_invoice_id fills purchase date, supplier and number). Depreciation starts in the year it enters into function (art. 102 c. 1 TUIR) at most at the ministerial coefficient, halved in the first year (c. 2); a tangible asset up to 516.46 can be deducted in full (c. 5). The asset’s cost is then left out of the year’s costs in the tax estimate. Live keys only (403 livemode_required). Free.
Registers a bene strumentale, often bought with a received invoice (received_invoice_id fills purchase date, supplier and number). Depreciation starts in the year it enters into function (art. 102 c. 1 TUIR) at most at the ministerial coefficient, halved in the first year (c. 2); a tangible asset up to 516.46 can be deducted in full (c. 5). The asset’s cost is then left out of the year’s costs in the tax estimate. Live keys only (403 livemode_required). Free.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Idempotency-Key?stringRecommended. Retrying with the same key and body within 24 hours replays the first response (header Idempotent-Replayed: true) instead of acting twice. The same key with a different body returns 422 idempotency_key_reused.
length <= 255Getbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidapplication/json- body
name*stringWhat the asset is, as it appears in the libro cespiti (fixed-asset register)
1 <= length <= 200category_code?|A category of the DM 31/12/1988 table (GET /fixed-asset-categories); sets label, coefficient and kind. Omit it to give category_label and coefficient yourself
category_label?stringName of the asset category, when it is not in the DM 31/12/1988 table (give coefficient too). Overrides the label of category_code
1 <= length <= 200coefficient?numberPercent per year (ministerial coefficient), e.g. 20
0 < value <= 100kind?string"tangible""intangible"cost*stringCost net of deductible VAT (costo fiscale)
^\d{1,11}\.\d{2}$purchase_date?stringDate of the purchase; from the received invoice if omitted
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$datein_service_date?|Date it entered into function: depreciation starts that year (art. 102 c. 1). null = not in use yet
first_year_half?booleanHalve the first year (default true; art. 102 c. 2). Intangibles are never halved
expense_in_full?booleanDeduct a tangible asset of unit cost up to 516.46 in full in the year (art. 102 c. 5)
depreciation_overrides?Amount actually deducted in a year when less than the maximum (the coefficient is a ceiling, art. 102 c. 2 TUIR), e.g. {"2027": "100.00"}. Use it for assets depreciated before getbeel too. Merged per year with the saved ones; null removes a year.
received_invoice_id?|The received invoice it was bought with (GET /received-invoices)
supplier_name?|Name of the supplier the asset was bought from
document_number?|Number of the purchase invoice
notes?|Free-text note, up to 1000 characters
disposal_date?|Sold or eliminated on this date (with disposal_amount)
disposal_amount?||Sale price, "0.00" when eliminated
OK
application/json- response
id*stringobject*stringname*stringkind*string"tangible""intangible"category_code*string|nullcategory_label*stringcategory_note*string|nullcoefficient*numbercost*stringDecimal amount as a string
^-?\d+\.\d{2}$purchase_date*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$datein_service_date*|nullfirst_year_half*booleanexpense_in_full*booleansmall_asset*booleanTangible with cost up to 516.46: may be deducted in full
depreciation_overrides*received_invoice_id*string|nullsupplier_name*string|nulldocument_number*string|nullnotes*string|nullstatus*string"not_in_service""depreciating""fully_depreciated""disposed"as_of_year*integer-9007199254740991 <= value <= 9007199254740991accumulated_depreciation*stringDecimal amount as a string
^-?\d+\.\d{2}$residual_value*stringDecimal amount as a string
^-?\d+\.\d{2}$schedule*array<>disposal*|nullwarnings*array<string>created_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timeupdated_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timecurl -X POST 'https://www.getbeel.com/api/v1/fixed-assets' \ -H 'Content-Type: application/json' \ -d '{ "name": "MacBook Pro 14\"", "cost": "1220.00"}'{ "id": "string", "object": "fixed_asset", "name": "string", "kind": "tangible", "category_code": "string", "category_label": "string", "category_note": "string", "coefficient": 0, "cost": "122.00", "purchase_date": "2026-10-29", "in_service_date": "2026-10-29", "first_year_half": true, "expense_in_full": true, "small_asset": true, "depreciation_overrides": { "property1": "122.00", "property2": "122.00" }, "received_invoice_id": "string", "supplier_name": "string", "document_number": "string", "notes": "string", "status": "not_in_service", "as_of_year": -9007199254740991, "accumulated_depreciation": "122.00", "residual_value": "122.00", "schedule": [ { "year": -9007199254740991, "max_amount": "122.00", "amount": "122.00", "accumulated": "122.00", "residual": "122.00", "kind": "depreciation", "overridden": true } ], "disposal": { "date": "2026-10-29", "price": "122.00", "residual": "122.00", "gain": "122.00" }, "warnings": [ "string" ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}