Change a fixed asset or record its disposal
Send only what changes. disposal_date and disposal_amount record a sale or elimination: the gain or loss is price minus the cost not yet depreciated (art. 86 and 101 TUIR); no quota is computed in the disposal year. depreciation_overrides records smaller deductions of past years. Live keys only (403 livemode_required). Free.
Send only what changes. disposal_date and disposal_amount record a sale or elimination: the gain or loss is price minus the cost not yet depreciated (art. 86 and 101 TUIR); no quota is computed in the disposal year. depreciation_overrides records smaller deductions of past years. Live keys only (403 livemode_required). Free.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringGetbeel-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 PATCH 'https://www.getbeel.com/api/v1/fixed-assets/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "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"}