FINASSET: Financial Asset
A capitalised asset on the fixed asset register, tracking acquisition, depreciation, revaluation, and disposal for financial reporting.
FINASSET definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches FINASSET.Entity properties
| Property | Value |
|---|---|
| Entity code | FINASSET |
| Display name | Financial Asset |
| Plural | Financial Assets |
| Level | 55000 |
Use cases
Separates financial lifecycle from physical inventory (COMPINV) and catalogue (COMP). Not every inventory item is a financial asset, and not every financial asset is physical inventory (e.g. software licenses, patents). Three-panel layout. General panel: left (25%) has identity (asset tag, name, status, category, class), middle (35%) has acquisition (purchase date, in-service date, cost, vendor, PO, invoice, cost centre, GL account, budget code), right (40%) has depreciation (method, useful life, start date, residual/salvage, current NBV, accumulated depreciation, last run date/amount, fully depreciated flag). Linked Items panel shows the optional COMPINV reference and any related disposal records. Status workflow: draft → capitalised → depreciating → fully-depreciated → disposed / impaired / written-off. The inventoryId link to COMPINV is optional. standalone FINASSET records cover non-physical assets. When INVDISPOSAL completes, an automation can update the FINASSET status to disposed and record the write-off.
Fields
Asset Identity
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Asset Name. |
assetTag | text | Fixed asset register reference number | |
status | enum | Yes | Valid ids: draft (Draft), capitalised (Capitalised), depreciating (Depreciating), fullyDepreciated (Fully Depreciated), impaired (Impaired), disposed (Disposed), writtenOff (Written Off). |
category | enum | Valid ids: hardware (IT Hardware), software (Software License), network (Network Equipment), furniture (Furniture & Fittings), vehicle (Vehicle), building (Building / Leasehold), intangible (Intangible Asset), other (Other). | |
class | reference → COMPTYPE | Classification. | |
description | text (multi-line) | Description. |
Acquisition
| Field | Type | Required | Notes |
|---|---|---|---|
purchaseDate | date | Purchase Date. | |
inServiceDate | date | In-Service Date. | |
acquisitionCost | number | Yes | Acquisition Cost. |
currency | reference → CURRENCY | Currency. | |
vendorId | reference → VEN | Vendor. | |
purchaseOrderId | reference → PO | Purchase Order. | |
invoiceNumber | text | Invoice Number. | |
costCentreId | reference → COSTCTR | Cost Centre. | |
glAccountId | reference → GLACCT | GL Account. | |
budgetCodeId | reference → BUDGCODE | Budget Code. |
Depreciation
| Field | Type | Required | Notes |
|---|---|---|---|
depreciationMethod | enum | Valid ids: straightLine (Straight-Line), decliningBalance (Declining Balance), sumOfYears (Sum-of-Years Digits), unitsOfProduction (Units of Production), none (No Depreciation). | |
usefulLifeMonths | number | Useful Life (Months). | |
depreciationStartDate | date | Depreciation Start Date. | |
residualValue | number | Residual / Salvage Value. | |
depreciableAmount | number | Acquisition cost minus residual value Read only. | |
accumulatedDepreciation | number | Accumulated Depreciation. | |
currentNBV | number | Acquisition cost minus accumulated depreciation | |
lastDepreciationDate | date | Last Depreciation Run. | |
lastDepreciationAmount | number | Last Period Amount. | |
fullyDepreciated | boolean | Fully Depreciated. |
Physical Asset
| Field | Type | Required | Notes |
|---|---|---|---|
inventoryId | reference → COMPINV | Link to the physical asset (optional. leave blank for non-physical assets) | |
componentId | reference → COMP | Component. | |
siteId | reference → SITE | Site. |
Revaluation & Impairment
| Field | Type | Required | Notes |
|---|---|---|---|
lastRevaluationDate | date | Last Revaluation Date. | |
revaluationAmount | number | Positive = upward revaluation, negative = downward | |
impairmentDate | date | Impairment Date. | |
impairmentAmount | number | Impairment Loss. | |
impairmentReason | text (multi-line) | Impairment Reason. |
Disposal
| Field | Type | Required | Notes |
|---|---|---|---|
disposalDate | date | Disposal Date. | |
disposalProceeds | number | Disposal Proceeds. | |
gainLossOnDisposal | number | Disposal proceeds minus NBV at disposal Read only. | |
disposalNotes | text (multi-line) | Disposal Notes. |
Activity timeline panel attached.
Relationships
- Lookup:
class(reference →COMPTYPE). - Lookup:
currency(reference →CURRENCY). - Lookup:
vendorId(reference →VEN). - Lookup:
purchaseOrderId(reference →PO). - Lookup:
costCentreId(reference →COSTCTR). - Lookup:
glAccountId(reference →GLACCT). - Lookup:
budgetCodeId(reference →BUDGCODE). - Lookup:
inventoryId(reference →COMPINV). - Lookup:
componentId(reference →COMP). - Lookup:
siteId(reference →SITE).
Creating a Financial Asset via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "FINASSET",
"level": 55000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example name",
"status": "draft",
"acquisitionCost": 0,
"assetTag": "Example value"
}Listing Financial Assets records
GET /v1/entities/FINASSET/SUB:<your-sub-id>