SIGNALS Docs
Exit Reader View
100%
Theme

Reader View

Assets

Track individual assets, quantities, and locations across warehouses.

For loose stock, the quantity field accepts non-negative values with up to two decimal places, such as 1.25. Opening an asset for editing preserves its exact balance; stock changes use adjustments. Barcoded stock continues to represent one serialised unit per asset.

Overview

Assets represent the physical inventory in Signals. Each asset record tracks a specific item (or loose quantity) of a catalogue item at a particular warehouse location. Stock can be barcoded (individually tracked with asset/serial numbers) or loose (tracked by quantity).

Category Value Description
Loose Stock 10 Tracked by quantity
Barcoded Stock 50 Individually tracked items

Assets list

Route: /assets

Browse all assets with search, filtering, and sorting.

  • Search — filter by item name, asset number, serial number
  • Column sorting — sortable columns
  • Pagination — configurable items per page
Column Description
Item Name Display name for the asset
Catalogue item Associated catalogue item
Warehouse Location/warehouse
Asset / Barcode Unique asset identifier
Serial # Manufacturer serial number
Method Barcoded or loose
On hand Total quantity in stock
Allocated Quantity reserved for orders
Unavailable Quantity unavailable (for example in repair)
Status Asset status

Asset detail

Route: /assets/{id}

/assets/{id} is a single-unit record (one asset row). Fleet-wide quantity rollups for a catalogue item at a warehouse belong on the catalogue item's Assets tab, not here.

The page has an identity band (breadcrumb, catalogue-item icon, name/serial title, method/type/active/test/retired badges, catalogue-item + warehouse sub-line, favourite / print / actions) and a tab strip at both the top and bottom of every tab page.

Actions include Add Adjustment, Record Cost, Raise Repair, Perform Equipment Test, Retire, and recording usage readings.

Tabs

The shared record navigation has a direct Overview link and groups the other pages under Details, Operations and More. A group with one visible page appears as a direct link. Open More → Custom Fields for custom field values.

Tab Route Description
Overview /assets/{id} Headlines and registers above the Ledger, with one Asset sidebar panel
Custom Fields /assets/{id}/custom-fields Custom field values under More
Identifiers /assets/{id}/identifiers Barcode and other scanning identifiers
Costs /assets/{id}/costs The asset's cost ledger
Results & Usage /assets/{id}/results-usage Equipment test results and usage readings
Rentals /assets/{id}/rentals Rentals this asset has been on
Availability /assets/{id}/availability Availability for the asset's catalogue item (availability.view; only when the asset has a catalogue item)
Movements /assets/{id}/movements Stock movements for this asset
Activities /assets/{id}/activities Activities regarding this asset, with a New Activity action
Plugin tabs /assets/{id}/tabs/{key} Plugin-registered panels

Plugin tabs

Plugins can add extra tabs. Each one the user is allowed to see appears after the native tabs and opens /assets/{id}/tabs/{key}; it needs assets.view. Plugins can also add header actions.

Ledger panel

Choose Add Adjustment on the asset detail page to record a movement type, quantity, date and description. The Ledger panel lists entries in chronological order. Transfers use the asset transfer action.

Creating assets

The shared form leads with the catalogue item, Stock and identifiers. Expand More details → Financial & depreciation for acquired date, depreciation and purchase cost (cost permission required).

Route: /assets/create

When creating a new asset, select a catalogue item first. The form detects the catalogue item's catalogue method and adjusts the available options accordingly.

  • Loose catalogue items — a single asset tracks the total quantity on hand. Only one asset per loose catalogue item is allowed.
  • Barcoded catalogue items — each individual unit gets its own asset with a unique asset number and serial number. See Bulk barcoded entry below for entering multiple units at once.

Bulk barcoded entry

When a barcoded catalogue item is selected on the create form, a mode switcher appears between Single and Bulk entry.

  • Single — the default mode. Enter one asset number and serial number to create one asset record.
  • Bulk — enter multiple barcoded units in a table of rows. Each row has an Asset Number / Barcode and a Serial Number field. All rows are created in a single database transaction when you save.

Adding rows

  • Click Add row to append a new empty row.
  • Press Enter inside any field to add a new row and move focus to it automatically.
  • Click the × button on a row to remove it. At least one row must remain.

Uniqueness validation

Each field is validated live against existing assets in the database and against other rows in the form:

Status indicator Meaning
Green checkmark Value is unique — no conflicts
Red ✕ Duplicate — already exists in the database, or entered more than once in this form
Empty Field is blank — no validation applied

The Create Assets button is disabled until all rows are either complete (both fields filled) and unique, or empty (trailing rows left after pressing Enter are ignored). The button label shows the count of complete rows that will be created, e.g. "Create 3 Assets".

Partial rows (one field filled, one blank) also block submission.

After saving

After a successful bulk save, you are redirected to the catalogue item's Assets tab rather than an individual asset, so you can see all the newly created records together.

Purchase cost and base currency

An asset purchase cost records its amount in the base currency (purchase_cost_base), and it records that base currency (base_currency_code). The recorded base currency is frozen by these rules:

  • A purchase-cost edit in the same base currency is always allowed. The base amount is converted again at the new rate.
  • After the company base currency changes, a purchase-cost edit can re-state the purchase cost into the new base currency only while no asset cost, retirement or valuation uses the asset. The new base currency, base amount and base rate change together.
  • When an asset cost, retirement or valuation uses the asset, its base currency cannot change and its purchase cost cannot be cleared. The update is refused before the write with a 422 whose code is asset_base_currency_frozen on the purchase_cost field.
  • An asset cost edit can change the cost's base currency only together with a new base amount or base rate, and only while no retirement or valuation of the same asset exists. Otherwise it is refused before the write with the 422 code asset_cost_base_currency_frozen on the amount field. A cost edit in the same base currency is always allowed.
  • Asset valuations keep their base currency. An asset is frozen for valuation when one of its stored valuations is in a base currency different from its cost basis now (for example after the company base currency changes for an asset valued from its catalogue item price). The monthly roll-up does not calculate that asset again and does not open a new month from its original closing balance. It writes nothing for the asset, keeps its original rows and records one finding for it: reason asset_valuation_base_currency_frozen, the recorded and the new base currency, and a message. The roll-up logs each finding (asset_valuation.base_currency_frozen) and one summary (asset_valuation.rollup_skipped_assets). All other assets roll up normally, and the job completes. A re-roll request for one named asset is refused with the coded error asset_valuation_base_currency_frozen. Re-basing is not yet available; a revaluation action is planned. Until then, the asset remains frozen. Reports covering missing valuation months mark the result incomplete with reason asset_valuation_base_currency_frozen and list/count the skipped assets, including count-only reports.

The database enforces the same rules, so a direct write is refused too.

Live filters

System views for assets:

  • All Assets
  • Barcoded Stock (barcoded assets only)
  • Loose Stock (loose assets only)

Additional form guidance

On a fresh installation without assets, the page asks you to create a catalogue item before opening the asset form. Existing asset records remain accessible even if a prerequisite is later removed.