Add a fixed asset
asset_addAdd one fixed asset to the register and return its id with the rate, useful life and convention taken from the bundled tax table. Cost and residual are whole minor units. Free tier holds ten assets.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What the asset is, e.g. "MacBook Pro 16" or "Delivery van" | |
| note | No | ||
| method | No | "straight-line" or "declining-balance". Default: the table row method, straight-line for the Polish annex and the reducing-balance pool rate for the UK | |
| scheme | No | "pl" Polish KST annex rates, "uk" HMRC capital allowance pools, "us" IRS MACRS GDS. Omit to derive it from the shared business profile currency | |
| project | No | Project, department or cost centre this asset belongs to | |
| category | Yes | A code or name from the bundled table, e.g. "487" or "Computers and computer sets" (pl), "main" (uk), "5-year" (us). Read assets://categories for the list | |
| currency | No | ISO code. Defaults to the shared business profile currency, else the scheme table currency | |
| rate_pct | No | Override the annual percentage derived from the table. Use for a lowered Polish rate under art. 16i | |
| cost_minor | Yes | Acquisition cost in MINOR units (integer cents/grosze), e.g. 549900 for 5499.00. Never a decimal | |
| life_years | No | Override the useful life derived from the table, in years. The answer reports that it was an override | |
| purchase_date | Yes | ISO date YYYY-MM-DD the asset was bought | |
| residual_minor | No | Residual or salvage value in MINOR units, default 0. Must be less than cost. MACRS ignores it and the answer says so | |
| in_service_date | No | ISO date YYYY-MM-DD the asset entered use and the register. Defaults to purchase_date | |
| declining_coefficient | No | Declining-balance coefficient. Polish default 2.0, capped by the table; ignored with straight-line |