GetbeelDocs

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.

POST
/fixed-assets

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.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Header Parameters

Idempotency-Key?string

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

Lengthlength <= 255
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

Request Body

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

Response Body

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
Example Request
curl -X POST 'https://www.getbeel.com/api/v1/fixed-assets' \  -H 'Content-Type: application/json' \  -d '{  "name": "MacBook Pro 14\"",  "cost": "1220.00"}'
Example Response
{  "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"}