GetbeelDocs

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.

PATCH
/fixed-assets/{id}

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.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

id*string
Getbeel-Company?string

Act 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.

Formatuuid
application/json
  1. body
name?string

What the asset is, as it appears in the libro cespiti (fixed-asset register)

Length1 <= length <= 200
category_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?string

Name of the asset category, when it is not in the DM 31/12/1988 table (give coefficient too). Overrides the label of category_code

Length1 <= length <= 200
coefficient?number

Percent per year (ministerial coefficient), e.g. 20

Range0 < value <= 100
kind?string
Value in"tangible""intangible"
cost?string

Cost net of deductible VAT (costo fiscale)

Match^\d{1,11}\.\d{2}$
purchase_date?string

Date of the purchase; from the received invoice if omitted

Match^(?:(?:\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])))$
Formatdate
in_service_date?|

Date it entered into function: depreciation starts that year (art. 102 c. 1). null = not in use yet

first_year_half?boolean

Halve the first year (default true; art. 102 c. 2). Intangibles are never halved

expense_in_full?boolean

Deduct 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

Corpo della risposta

OK

application/json
  1. response
id*string
object*string
name*string
kind*string
Value in"tangible""intangible"
category_code*string|null
category_label*string
category_note*string|null
coefficient*number
cost*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
purchase_date*string
Match^(?:(?:\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])))$
Formatdate
in_service_date*|null
first_year_half*boolean
expense_in_full*boolean
small_asset*boolean

Tangible with cost up to 516.46: may be deducted in full

depreciation_overrides*
received_invoice_id*string|null
supplier_name*string|null
document_number*string|null
notes*string|null
status*string
Value in"not_in_service""depreciating""fully_depreciated""disposed"
as_of_year*integer
Range-9007199254740991 <= value <= 9007199254740991
accumulated_depreciation*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
residual_value*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
schedule*array<>
disposal*|null
warnings*array<string>
created_at*string
Match^(?:(?:\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))$
Formatdate-time
updated_at*string
Match^(?:(?:\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))$
Formatdate-time
Esempio di richiesta
curl -X PATCH 'https://www.getbeel.com/api/v1/fixed-assets/string' \  -H 'Content-Type: application/json' \  -d '{}'
Esempio di risposta
{  "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"}