What is an asset#
Assets are pieces of equipment that's been installed at a property. These can be things like HVAC units, boilers, heatpumps or generators. Due to each business wanting to store unique information about the type of equipment they work with, asset structures are completely dynamic.Asset groups and types#
Each asset will have a group and a type that determines the category of asset for example Boiler > Combination boiler, or Generator > Standby generator. The group and types are determined by each business and configured inside Commusoft's settings. You can get a list of these via a GET call using the API.There is a relationship between asset groups and types, a one to many groups to types.Understanding the asset structure/fields#
The asset fields themselves are configured with standard asset fields, which are fields that all assets share, for example 'Make' and 'Mode'. To get a list of standard asset fields the business has configured, call the /assetStructure API. As well as standard fields, assets can have specific fields based on the group and type. For example, it maybe necessary to store specific information only relevant to the group or, the type.Sub assets#
Sub assets are assets that belong to a parent asset. These can be used to breakdown large or complex assets into small components. The benefit of this is that you can associate jobs, create forms and track history of those smaller components. For example, in a large generator installation you may want to track the main generator as a parent asset and multiple ATS as sub assets.Version control#
Modified at 2026-09-11 08:03:30
