SIGNALS Documentation
API Reference

Assets

Track individual stock items, quantities, and locations across warehouses.

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 stock item
Asset Number Unique asset identifier
Serial Number Manufacturer serial number
Warehouse Location/warehouse
CatalogueItem Associated catalogue item
Quantity Held Total quantity in stock
Quantity Allocated Quantity reserved for orders
Created Creation date

Asset Detail

Route: /assets/{id}

View complete asset information including quantities, location, and associated catalogue item details.

Transactions Panel

The asset detail page includes an inline "Add Transaction" form for recording stock movements (adjustments, transfers, write-offs). Transactions are displayed in a chronological list below the form.

Activities Tab

Assets have an Activities tab showing all activities linked to this asset via the regarding association.

Creating Assets

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 held. 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 Stock tab rather than an individual asset, so you can see all the newly created records together.

Live filters

System views for assets:

  • All Assets
  • Barcoded Stock (catalogue_category = 50)
  • Loose Stock (catalogue_category = 10)