Skip to content
P4 Software P4 Software / activoHQ English

Add these docs to Claude

Ask Claude questions about these docs. Claude reads the published pages and links you back to them. Copy this address:

https://p4-software.opendocs.page/mcp

In claude.ai or Claude Desktop: open Settings, then Connectors, choose Add custom connector and paste the address.

In Claude Code, run:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Asset models

Asset models

Overview

An asset model is a type of asset (Computer, Vehicle, Projector, Air conditioner), not a specific unit. You define it once and every asset of that type inherits its configuration: the depreciation method, the useful life, the residual value, the fields that describe the asset and the Accounting account codes.

The asset model is the single classifier in activoHQ. It replaces the old Asset categories: the category was merged into the model, so today one record holds both the Accounting classification and the type definition. If your company used categories in the past, review the Accounting codes on each model, because classification is now managed from this screen.

Asset administrators and the Accounting team use this screen to prepare the catalog before Assets are registered.


How to get there

Master > Asset Models

Direct URL: /master/asset-models


Key concepts

Term Definition
Asset model The asset type. It defines depreciation, fields and Accounting accounts for every unit of that type.
Manufacturer The type's primary brand. It is required; when a type spans several brands, use a generic manufacturer. Each asset can also name its own manufacturer, which overrides the model's.
Field template A reusable set of extra fields (for example CPU and RAM for computers, VIN and plate for vehicles). It is created under Master > Custom fieldsets and assigned to the model. Every asset of the model shows those fields.
Useful Life (months) The number of months over which the asset is depreciated.
Residual Value % The percentage of the cost that is not depreciated and remains as salvage value.
Half-year convention A rule that halves the depreciation charge in the first months of an asset's life. Depreciation runs do not apply it at this time; it only affects the sample projection on the Depreciation tab, and that projection follows the half-year setting of the depreciation method you chose.
Requestable Indicates that staff can ask for this type of asset from the Requests menu (self-service).
EULA Acceptance text the user must approve when an asset of this type is handed over.
Minimum quantity alert A threshold of available units. When the count falls below it, administrators and asset managers who switched on Low-stock alerts in their profile are notified by email. 0 switches the alert off.

How to use it

Create an asset model

  1. Click New in the top bar. The model record opens.
  2. In the Identification section, fill in:
    • Name (required): the asset type, for example Computer, Vehicle or Projector.
    • Manufacturer (required): pick the brand from the drop-down.
    • Model Number (optional): the type's internal reference code.
    • Notes (optional): a rich text editor; it accepts bold, lists and links.
    • Image (optional): click Image to upload a representative photo of the type. PNG, GIF, JPG and WebP are accepted. To take it off, click Remove.
  3. Under Depreciation, set the Method, the Useful Life (months), the Residual Value % and, if it applies, tick Half-year convention.
  4. Under Fields for this type, choose the Field template. This section appears only when at least one active field template exists. Below the field, the preview These Assets will have: lists the fields that will appear on each asset.
  5. Under Accounting Integration, enter the Asset Account Code, the Accum. Depreciation Account Code and the Depreciation Expense Account Code. This section appears only when the company has an Endpoint URL under cifraHQ Posting (see Companies). Depreciation runs need the accumulated depreciation and depreciation expense codes. Disposals, revaluations and impairments also need codes for the gain or loss on disposal, the disposal clearing account, the revaluation surplus and the impairment loss, which this screen does not offer yet; until they are available, those operations on a model created here are refused with the message Asset model [name] is missing GL account codes for .... Contact P4 Software support if you need them.
  6. Under Behavior, tick whatever applies:
    • Require serial number: the asset form will not save an asset of this type without a serial number. The system does not check that serial numbers are unique.
    • Users may request this model: enables the type in request self-service.
    • Require acceptance (EULA) at checkout: shows the EULA text the user must accept.
    • Minimum quantity alert: the number of available units at which an email alert is sent.
    • Active: inactive types stay on existing Assets but cannot be chosen for new ones.
  7. Click Save.

Edit a model

  1. In the table, click the model's Name.
  2. The record opens with four tabs:
    • Edit - every field described above.
    • Assets - the Assets using this model, with Code, Name, Status and Availability.
    • Depreciation - a sample projection on a cost of $10,000: monthly charge and the book value curve across the useful life, down to the residual value.
    • History - recorded changes to the model.
  3. Change what you need and click Save.

Clone a model

Cloning is not available from the table at this time: the right-click menu offers Edit, View and Delete, but no Clone. To create a similar model, click New and repeat the Settings, or use the CSV import described below.

Delete or deactivate a model

  1. Right-click the row and choose Delete; confirm the operation.
  2. If the model already has Assets, the system does not delete it: it Reports that the model has Assets and cannot be deleted, and offers Deactivate it now?. Accept, and the model stops appearing as an option on new Assets while keeping its history.

Import models from a CSV file

  1. Click Import in the top bar (or go to /master/asset-models/import).

  2. Prepare a CSV file with a header row and the recognized columns:

    Name, ModelNumber, Manufacturer, DepreciationMethod, UsefulLifeMonths, ResidualValuePercent, RequireSerialNumber, UsersMayRequest, MinimumQuantityAlert

  3. Click Choose CSV file and select the file.

  4. When it finishes, the Result shows how many records were created, updated and failed, plus the Errors detail if there were any.

Import rules:

  • Models are identified by Name + Model Number: if they already exist they are updated; if not, they are created.
  • Manufacturers that do not exist are created automatically.
  • An unknown depreciation method fails that row; the remaining rows carry on processing. The method is matched by its name or its code.
  • A row without a Manufacturer also fails.
  • When a model already exists, the import overwrites it with the file: a blank method cell clears the method, blank checkbox columns switch the options off, and the model is set to Active. Export or review the existing models before importing over them.

Fields

Field Type Required Description Validation
Name Text Yes The asset type. Every unit of the type shares the model's configuration. Cannot be empty.
Manufacturer Drop-down Yes The type's primary brand, or a generic manufacturer if it spans several brands. An existing manufacturer must be selected.
Model Number Text No The type's internal reference code. None.
Notes Rich text No Internal notes, specifications or instructions. None.
Image File No A representative photo of the type. PNG, GIF, JPG and WebP only.
Method Drop-down No The depreciation method inherited by Assets of the type. None.
Useful Life (months) Number Yes Months of depreciation. Required when a method is set.
Residual Value % Number Yes The percentage of cost that is not depreciated. Required when a method is set.
Half-year convention Checkbox No Stored on the model. Depreciation runs do not apply it at this time. None.
Field template Drop-down No The set of custom fields the type's Assets will show. Shown only when an active field template exists. The set must exist under Custom fieldsets.
Asset Account Code Text No The asset's Accounting account for the cifraHQ integration. Shown only when the company has a cifraHQ Endpoint URL. None.
Accum. Depreciation Account Code Text No The accumulated depreciation account. Shown only when the company has a cifraHQ Endpoint URL. None.
Depreciation Expense Account Code Text No The depreciation expense account. Shown only when the company has a cifraHQ Endpoint URL. None.
Require serial number Checkbox No Requires a serial number to be filled in when an asset of this type is saved on the asset form. Uniqueness is not checked.
Users may request this model Checkbox No Enables the type in Requests self-service. None.
Require acceptance (EULA) at checkout Checkbox No Shows an agreement the user must accept when receiving the asset. Ticking it enables the EULA text field.
EULA text Text No The content of the usage agreement. Only visible when acceptance is required.
Minimum quantity alert Number No The available-unit threshold for the email alert. 0 switches the alert off.
Active Checkbox No Inactive types cannot be chosen on new Assets. None.

Table columns

Column Description
Name The type's name. Click it to open the record.
Model # Model number.
Manufacturer The brand tied to the model.
Depreciation The configured depreciation method.
Assets Total number of Assets using the model. A calculated column: it cannot be filtered.
Available Available units (neither checked out nor disposed). A calculated column: it cannot be filtered.
Requestable Whether staff can request the type from self-service.
Active The model's status.

Permissions

Action Permission
View the screen AssetModels.View
Create models AssetModels.Create
Edit models AssetModels.Edit
Delete or deactivate models AssetModels.Delete
Import from CSV AssetModels.Import
Clone models AssetModels.Clone (reserved for cloning, which is not available from the table at this time)

Administrators hold every permission. Users without the view permission see Access denied. Your administrator assigns permissions under Settings > Users.


Notes

  • Categories no longer exist as a separate catalog. All classification, including the Accounting accounts, lives on the asset model.
  • Custom fields are defined on the model, not on the asset. To add a field to a type, edit the matching field template under Master > Custom fieldsets and assign it to the model.
  • An asset's manufacturer can differ from the model's: the model supplies the default and each asset can adjust it.
  • Switching the active company: changing company reloads the table with the selected company's models.
  • The Depreciation tab projection is illustrative (a $10,000 basis) and does not affect real Assets.

Troubleshooting

Symptom Likely cause Resolution
Access denied appears when opening the screen. The user does not have the AssetModels.View permission. Ask your administrator for the permission.
The model does not appear when registering an asset. The model is inactive or belongs to another company. Tick Active on the model record and check the active company.
The model cannot be deleted. The model has Assets attached. Use Deactivate it now? when the system offers it; that keeps the history.
The asset does not show the fields you expect. The model has no field template assigned, or the template does not include that field. Assign or edit the model's Field template.
A row in the import fails. The named depreciation method does not exist. Create the method under Master > Depreciation methods, or fix the name in the CSV and import again.
The type does not appear under Requests. Users may request this model is not ticked. Edit the model and tick the box.
Minimum quantity alerts never arrive. The threshold is 0, no administrator or asset manager has switched the Low-stock alerts notification on in their profile, or email is not configured. Set a threshold above zero, and check the recipients' My profile and Settings > Email.
A disposal, revaluation or impairment is refused with Asset model [name] is missing GL account codes. The model has no Accounting codes for that operation, and this screen does not offer all of them yet. Contact P4 Software support.

Related

Was this page helpful?