xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Asset — entity reference
REFERENCE · Last reviewed

Asset — entity reference

An asset is one identifiable physical unit, such as a machine, vehicle, device or piece of furniture, kept in the Fixed Assets app. It is both the fixed-asset register and the service install base. For items with Track Lots and Track Asset, receiving a goods receipt creates one asset per received line from its item lot. Posting a sales invoice to inventory (Post Inventory) then updates the asset that holds the sold lot, or creates one if none exists, and writes the customer, sale, install and purchase dates, price and invoice number. Package component lines become child assets. Opening a service order marks the asset under service until the order is delivered. Invoicing a service order writes the last service date, branch, partner and usage readings. Posting an asset disposal sets Status to Disposed and Net Book Value to 0. Saving an asset posts no journal, and its depreciation fields drive no calculation; Recurring Depreciation schedules post depreciation and do not update the asset.

Fields

FieldLabelTypeRequiredWhat it does
AccountIdAccountLookup → AccountThe customer who owns the unit, set from the sales invoice. Service orders, cases, leads, quotes and opportunities fill an empty Account from it.
AssetCategoryAsset CategoryPickListValues: IT, Furniture, Office Equipment, Machinary.
AssetCodeAsset CodeTextYour code for the unit. Automatic assets take the lot's serial number, or the supplier invoice number when there is no serial.
AssetConditionAsset ConditionTextFree-text condition note. A visit activity form that asks for asset condition writes it back here.
AssetIdRoot AssetLookup → AssetA self-referencing lookup to the top of the asset hierarchy, labelled 'Root Asset'. Despite the name this is not the record's own identifier — that is Id — and confusing the two is an easy mistake on this entity. Use it together with ParentAssetId, which points only one level up, and AssetLevel, which records the depth.
AssetLevelAsset LevelNumberThe depth of this asset within its parent/child hierarchy, used with ParentAssetId and AssetId to distinguish a top-level unit from its sub-components.
AssetProvidedAccountIdAssetProvedByLookup → AccountLabelled AssetProvedBy. A goods receipt sets it to the receiving company (the receipt's Company) and a sales invoice replaces it with the invoice's company. Not on the standard forms.
AssetServicedByAccountIdAsset Serviced ByLookup → AccountThe company that services the unit, set from the sales invoice's company. Not on the standard forms.
AssetSubCategoryAsset Sub CategoryPickListValues: LED TV, Tablet, Biometric Machine, Mobile Phone, CCTV Camera, Air Conditioner, Conference Table, Laptop, Desktop, Server, Printer, Scanner, Router, CNC Machines.
AverageUsageAverage UsageDecimal
AverageUsageHoursAverage Usage (Hours)Decimal
BatchNoBatch NoText, uniqueThe manufacturer batch copied from the item lot. Must be unique across all assets; a second asset with the same value is refused with "Batch No '…' already exists".
BranchIdLast Service BranchLookup → BranchLabelled Last Service Branch, but it holds the branch that received the unit on a goods receipt. Service does not change it; the last service branch is in the field labelled Branch.
CompetitorAssetIs Competitor ProductBoolean
ComponentNumberComponent NumberTextComponent number from the goods receipt line or the item lot.
ConsequenceOfFailureConsequence Of FailurePickListA criticality rating used to prioritise maintenance, seeded with Insignificant, Minor, Moderate, Major and Critical. It describes the impact if the asset fails, not its current condition — that is AssetCondition. Values: Insignificant, Minor, Moderate, Major, Critical.
ContactIdContactLookup → ContactThe owner's contact person, set from the sales invoice.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CurrentAmountCurrent AmountCurrency
CurrentLifecycleEndDateCurrent Lifecycle End DateDate
CurrentMrrCurrent Monthly Recurring RevenueCurrency
CurrentQuantityCurrent QuantityNumber
CurrentUsageReadingCurrent Usage ReadingDecimalThe latest known reading, entered by hand; no process updates it. The inactive seeded rule Nudge Asset Service Overdue compares it with Last Usage Reading.
CurrentUsageReadingHoursCurrent Usage Reading (Hours)Decimal
DepreciationMethodDepreciation MethodPickListStraight Line or WDV. Stored only; depreciation is computed by the Recurring Depreciation schedule. Values: Straight Line, WDV.
DepreciationPolicyIdDepreciation PolicyLookup → DepreciationPolicyThe policy describing how the unit should depreciate. Stored only; linking it creates no schedule.
DescriptionDescriptionLongMultiLineText
DigitalAssetStatusDigital Asset StatusPickListThe health signal reported by a connected or telemetry-enabled asset, seeded with On, Warning and Error. It reflects device telemetry and is independent of the commercial lifecycle held in Status. Values: On, Warning, Error.
DisposalDateDisposal DateDateWhen the unit was disposed of, written by a posted asset disposal.
DisposalValueDisposal ValueCurrencyThe disposal proceeds, written by a posted asset disposal.
GoodsReceiptIdGoods ReceiptLookup → GoodsReceiptThe goods receipt that created the asset. Kept when the unit is later sold.
IdIdGuidYes
InstallationAddressContactAddressIdInstallation AddressLookup → ContactAddressThe installation address, set from the sales invoice's shipping address. Not on the standard forms.
InstallDateInstall DateDateWhen the unit was installed. A sales invoice sets it to the invoice date.
InternalAssetIs InternalBooleanMarks a unit the company owns and uses itself rather than one sold to a customer. This is the distinction that separates own-use fixed assets from customer install-base records held in the same table.
InUseIn UseBoolean
InvoiceIdInvoiceLookup → InvoiceThe sales invoice that last updated the asset. Not on the standard forms.
InvoiceNumberInvoice NumberTextThe number of the sales invoice that last updated the asset.
IsPDIDoneIs PDI DoneBooleanWhether the pre-delivery inspection is complete. Receipts and invoices set it to off; nothing sets it on, so tick it yourself.
ItemIdItemLookup → ItemThe product this unit is. Service orders copy it from the asset.
ItemLotIdItem LotLookup → ItemLotThe item lot this asset represents. A sales invoice finds the existing asset through this lot, so one lot has one asset.
LabelLabelText
LastServiceBranchIdBranchLookup → BranchLabelled Branch: the branch of the last invoiced service order, written when the service order is invoiced.
LastServiceDateLast Service DateDateDate of the last invoiced service order, written when the order is invoiced.
LastServicePartnerAccountIdLast Service PartnerLookup → AccountThe company that invoiced the last service, written when the service order is invoiced.
LastUsageReadingLast Usage ReadingDecimalMeter reading at the last invoiced service. Cannot be negative. A new service order or opportunity cannot enter a lower reading. A ticked Reset Usage Reading on the invoiced order sets it to 0.
LastUsageReadingHoursLast Usage Reading (Hours)DecimalHours reading at the last invoiced service. A new service order or opportunity cannot enter lower hours. A ticked Reset Usage Hours on the invoiced order sets it to 0.
LifecycleEndDateLifecycle End DateDateAndTime
LifecycleManagedAssetHas Lifecycle ManagementBooleanMarks an asset that is managed on a defined replacement lifecycle, which is what makes the LifecycleStartDate, LifecycleEndDate, CurrentLifecycleEndDate and TotalLifecycleAmount fields meaningful. Those lifecycle fields should be ignored when this flag is false.
LifecycleStartDateLifecycle Start DateDate
LotNumberLot NumberTextThe item lot's name, copied when the asset is created or updated from a receipt or invoice.
ManufactureDateManufacture DateDateManufacturing date from the receipt line or the item lot.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextThe asset's display name. Required, with no numbering series. Assets created by a goods receipt or invoice are named from the item lot's serial number.
NetBookValueNet Book ValueCalculatedCarrying value. Holds what you enter, and posting an asset disposal sets it to 0. It does not follow posted depreciation.
OwnerIdOwnerLookup → UserAccountYes
ParentAssetIdParent AssetLookup → AssetThe unit this one is part of. Set automatically for package component lines on a sales invoice; can be set by hand to build a hierarchy.
PhonePhoneTextCopied from the owning account when the asset is created or its Account changes. Not on the standard web forms.
PricePriceCurrencyThe unit's sale price. Set from the invoice line amount when a sales invoice posts to inventory.
ProductCodeProduct CodeText
ProductDescriptionProduct DescriptionText
ProductFamilyProduct FamilyPickList
ProductSKUStock Keeping UnitTextA free-text stock-keeping-unit code carried on the asset. It is not a reference to the SKU entity — that is the separate SKUId lookup — so joining on this text will not resolve a SKU record.
PurchaseCostPurchase CostCurrencyWhat the unit cost, from the goods receipt line's unit cost. Kept when the unit is sold.
PurchaseDatePurchase DateDateAndTimeWhen the unit was bought. A goods receipt sets the receipt date; a later sales invoice replaces it with the invoice date.
PutToUseDatePut To Use DateDateWhen the unit was put to use. A sales invoice sets it to the invoice date.
QuantityQuantityNumberUnits this record stands for: the received quantity, then the invoice line quantity. Usually 1 for serialised items.
RecordTypeIdRecord TypeGuid, hidden
RegistrationDateRegistration DateDateAndTimeRegistration date copied from the item lot.
RegistrationNumberRegistration NumberText
SaleDateSale DateDateWhen the unit was sold, set to the invoice date. Cannot be earlier than Manufacture Date.
SaleInvoiceNumberSaleInvoiceNumberLongMultiLineText
SalvageValueSalvage ValueCurrencyIntended residual value. Stored only and not on the standard forms.
SellingBranchIdSelling BranchLookup → BranchThe branch that sold the unit, from the sales invoice. Campaign schedules use it when the asset has no last service branch.
SellingPartnerAccountIdSelling Partner AccountLookup → AccountThe company that sold the unit, from the sales invoice. Campaign schedules use it when the asset has no last service partner.
SerialNumberSerial NumberTextThe manufacturer's serial number, copied from the item lot.
SKUIdSKULookup → SKUThe lookup to the SKU record for this asset, populated from the originating invoice line when the asset is auto-created. Use this rather than the free-text ProductSKU field when you need the actual SKU.
StatusStatusPickListLifecycle state: Draft, Purchased, Installed or Obsolete, set by hand. Posting an asset disposal writes Disposed, which is not one of the list values. No other process changes it. Values: Installed, Obsolete, Purchased, Draft.
StatusReasonStatus ReasonPickListA qualifier on the current Status, seeded with Paused, Not Ready and Off. It explains why an asset is not in service rather than restating the status itself. Values: Paused, Off.
StorageLocationIdStorage LocationLookup → StorageLocation
SupplierInvoiceDateSupplier Invoice DateDateThe supplier invoice date from the goods receipt or the item lot.
SupplierInvoiceNumberSupplierInvoiceNumberLongMultiLineText
TestFieldTestFieldLongMultiLineText
TotalLifecycleAmountTotal Lifecycle AmountCurrency
UIPropsUI PropsText
UniqueIdentifierUuTextA tenant-defined unique identifier for the unit, separate from SerialNumber and RegistrationNumber. Its label is the truncated placeholder 'Uu', which carries no meaning — go by the field name.
UpdatedDateTimeModified DateDateAndTime
UsageEndDateUsage End DateDate
UsageHoursResetAtUsage Hours Reset AtDecimalThe order's hours reading stored when an invoiced service order had Reset Usage Hours ticked.
UsageReadingResetAtUsage Reading Reset AtDecimalThe order's usage reading stored when an invoiced service order had Reset Usage Reading ticked.
UsefulLifeUseful LifeNumberIntended useful life. Stored only and not on the standard web forms.

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
Delete2DeleteDeleteDelete
DeleteListHeaderDeleteDeleteDeleteListHeader
EditEditEditEdit
EditInLineEditInLineEditInlineEditInLine
EditRowEditEditEditRow
NewNewNewNew

Validations

ValidationApplies toError messageNotes
XM_DateOfSaleRuleValidationSaleDate, ErrorDate Of Sale cannot be before Manufacturing DateDate Of Sale cannot be before Manufacturing Date
XM_LastServiceDateRuleValidationLastServiceDate, Error, inactiveLast Date cannot exceed Current DateLast Date cannot exceed Current Date
XM_LastUsageReadingValidationLastUsageReading, ErrorUsage Reading Cannot be NegativeUsage Reading Cannot be Negative