DemandFlow Support Centre

ITASSET: IT Asset

IT asset with full lifecycle tracking including hardware specs, financials, warranty, security, and compliance.

Default definition. This article describes the default ITASSET definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches ITASSET.

Entity properties

Property	Value
Entity code	`ITASSET`
Display name	IT Asset
Plural	IT Assets
Level	50000

Use cases

ITASSET is a comprehensive IT asset management entity designed for end-user computing and general IT equipment (laptops, desktops, monitors, peripherals) as distinct from the COMP/COMPINV model which focuses on infrastructure components. It uses ITTYPE and ITSTATUS as lookup entities for classification and status rather than inline selects, enabling organisation-specific taxonomies. The General panel covers identification (assetTag, serialNumber), hardware specs (manufacturer via VEN, model, formFactor via ITFORMFACTOR, processor, memory, storage via ITSTORAGETYPE, GPU), and assignment (assignedTo user, department via DEPT, physical location fields).

Fields

Asset Identification

Field	Type	Required	Notes
`ref`	text		Ref.
`name`	text	Yes	Asset Name.
`assetTag`	text	Yes	Asset Tag.
`serialNumber`	text		Serial Number.
`status`	reference → `ITSTATUS`		Status.
`assetType`	reference → `ITTYPE`		Asset Type.
`configItem`	reference → `CMDB`		Configuration Item.
`description`	text (multi-line)		Description.
`assetOwnership`	enum		Valid ids: `company` (Company), `personal` (Personal), `unknown` (Unknown).
`assetCategory`	enum		Valid ids: `physical` (Physical), `virtual` (Virtual).

Hardware Details

Field	Type	Notes
`manufacturer`	reference → `VEN`	Manufacturer.
`model`	text	Model.
`formFactor`	reference → `ITFORMFACTOR`	Form Factor.
`processor`	text	Processor.
`memoryGB`	number	Memory (GB).
`storageGB`	number	Storage (GB).
`storageType`	reference → `ITSTORAGETYPE`	Storage Type.
`gpuModel`	text	GPU Model.

Assignment & Location

Field	Type	Notes
`assignedTo`	reference → `STF`	Assigned To.
`assignmentDate`	date	Assignment Date.
`department`	reference → `DEPT`	Department.
`condition`	enum	Valid ids: `good` (Good), `fair` (Fair), `damaged` (Damaged), `defective` (Defective).
`building`	text	Building.
`floor`	text	Floor.
`room`	text	Room.
`notes`	text (multi-line)	Notes.

Network Information

Field	Type	Notes
`hostname`	text	Hostname.
`primaryMacAddress`	text	Primary MAC Address.
`wifiMacAddress`	text	WiFi MAC Address.
`ipAddress`	text	IP Address.
`networkName`	text	Network Name.
`domainName`	text	Domain.
`remoteAccessEnabled`	enum	Valid ids: `1` (Enabled), `0` (Disabled).

Software Information

Field	Type	Notes
`operatingSystem`	text	Operating System.
`osVersion`	text	OS Version.
`lastBootTime`	date	Last Boot Time.
`lastScan`	date	Last Inventory Scan.
`encryptionStatus`	enum	Valid ids: `1` (Encrypted), `2` (Not Encrypted), `3` (Partial), `4` (Unknown).
`lastPatchDate`	date	Last Patch Date.
`complianceStatus`	enum	Valid ids: `1` (Compliant), `2` (Non-Compliant), `3` (Review Required).

Intune

Field	Type	Notes
`intuneDeviceId`	text	Intune Device ID.
`intuneComplianceState`	enum	Valid ids: `compliant` (Compliant), `noncompliant` (Non-Compliant), `unknown` (Unknown).
`intuneLastSync`	datetime	Last Intune Sync.
`intuneEnrolledDate`	datetime	Intune Enrolled.
`intuneEnrollmentType`	text	Enrollment Type.
`intuneUserPrincipalName`	text	Intune User.

Virtual Configuration

Field	Type	Notes
`hypervisor`	enum	Valid ids: `1` (VMware vSphere), `2` (Microsoft Hyper-V), `3` (KVM), `4` (Xen), `5` (Proxmox), `6` (AWS EC2), `7` (Azure VM), `8` (Google Compute), `9` (Other).
`hostSystem`	reference → `COMPINV`	Physical host this virtual asset runs on
`vmId`	text	VM / Instance ID.
`vmState`	enum	Valid ids: `1` (Running), `2` (Stopped), `3` (Suspended), `4` (Migrating), `5` (Failed), `6` (Unknown).

Resource Allocation

Field	Type	Notes
`vCpuCount`	number	vCPUs.
`vMemoryGB`	number	Memory (GB).
`vStorageGB`	number	Total Storage (GB).
`vStorageUsedGB`	number	Used Storage (GB).

Virtualisation Infrastructure

Field	Type	Notes
`vmCluster`	reference → `HYPCLUSTER`	Hypervisor Cluster.
`vmResourcePool`	reference → `RESOURCEPOOL`	Resource Pool.
`vmDatastore`	reference → `DATASTORE`	Datastore.
`networkPortGroup`	reference → `VPORTGROUP`	Network (Port Group).

Purchase Information

Field	Type	Notes
`purchaseDate`	date	Purchase Date.
`inServiceDate`	date	In-Service Date.
`purchaseCost`	number	Purchase Cost.
`currency`	reference → `CURRENCY`	Currency.
`vendor`	reference → `VEN`	Vendor.
`purchaseOrder`	reference → `PO`	Purchase Order.
`invoiceNumber`	text	Invoice Number.
`costCenter`	reference → `COSTCTR`	Cost Center.
`budgetCode`	reference → `BUDGCODE`	Budget Code.
`glAccount`	reference → `GLACCT`	GL Account.

Depreciation Information

Field	Type	Notes
`depreciationMethod`	reference → `DEPMETHOD`	Depreciation Method.
`usefulLifeMonths`	number	Useful Life (Months).
`depreciationStartDate`	date	Depreciation Start Date.
`currentNetBookValue`	number	Current Net Book Value.
`salvageValue`	number	Salvage Value.
`accumulatedDepreciation`	number	Accumulated Depreciation.
`lastDepreciationDate`	date	Last Depreciation Date.
`lastDepreciationAmount`	number	Last Depreciation Amount.
`depreciableValue`	number	Depreciable Value.

Warranty Information

Field	Type	Notes
`warrantyStartDate`	date	Warranty Start Date.
`warrantyEndDate`	date	Warranty End Date.
`warrantyStatus`	enum	Valid ids: `1` (Active), `2` (Expired), `3` (Void), `4` (Pending Claim).
`warrantyType`	enum	Valid ids: `1` (Manufacturer), `2` (Extended), `3` (Third-Party), `4` (Self-Insured).
`warrantyProvider`	reference → `VEN`	Warranty Provider.
`warrantyNotes`	text (multi-line)	Warranty Notes.

Support Information

Field	Type	Notes
`supportAgreement`	reference → `SUPAGREEMENT`	Support Agreement.
`supportLevel`	reference → `SUPLEVEL`	Support Level.
`supportRenewalDate`	date	Support Renewal Date.
`supportCost`	number	Annual Support Cost.
`supportProvider`	reference → `VEN`	Support Provider.
`supportEmail`	text	Support Email.
`supportPhone`	text	Support Phone.
`supportPortal`	text (URL)	Support Portal.

Maintenance Status

Field	Type	Notes
`maintenanceStatus`	enum	Valid ids: `ok` (OK), `scheduled` (Scheduled), `inProgress` (In Progress), `overdue` (Overdue).
`lastMaintenanceDate`	date	Last Maintenance.
`nextMaintenanceDate`	date	Next Maintenance.

Security Information

Field	Type	Notes
`antivirusSoftware`	text	Antivirus Software.
`avUpdateStatus`	enum	Valid ids: `1` (Current), `2` (Outdated), `3` (Disabled), `4` (Not Installed).
`lastFullScanDate`	date	Last Full Scan Date.
`encryptionType`	reference → `ITENCTYPE`	Encryption Type.
`encryptionDate`	date	Encryption Date.
`firewallStatus`	enum	Valid ids: `1` (Enabled), `2` (Disabled), `3` (Partial).
`lastVulnScanDate`	date	Last Vulnerability Scan.
`securityNotes`	text (multi-line)	Security Notes.

Compliance Information

Field	Type	Notes
`complianceStatus`	enum	Valid ids: `1` (Compliant), `2` (Non-Compliant), `3` (Exempt), `4` (Under Review).
`lastComplianceCheckDate`	date	Last Compliance Check.
`nextComplianceCheckDate`	date	Next Compliance Check.
`dataClassification`	enum	Valid ids: `1` (Public), `2` (Internal), `3` (Confidential), `4` (Restricted).
`certifications`	text	e.g. ISO 27001, SOC 2, PCI-DSS
`complianceNotes`	text (multi-line)	Compliance Notes.

Lifecycle Management

Field	Type	Notes
`manufactureDate`	date	Manufacture Date.
`acquisitionDate`	date	Acquisition Date.
`deploymentDate`	date	Deployment Date.
`lifecycleStage`	enum	Valid ids: `1` (Ordered), `2` (Received), `3` (Deployed), `4` (Active), `5` (Retiring), `6` (Disposed).
`plannedRetirementDate`	date	Planned Retirement Date.
`replacementAsset`	reference → `ITASSET`	Replacement Asset.
`refreshCycle`	number	Refresh Cycle (months).
`lifecycleNotes`	text (multi-line)	Lifecycle Notes.

Disposal Information

Field	Type	Notes
`disposalDate`	date	Disposal Date.
`disposalMethod`	enum	Valid ids: `1` (Recycled), `2` (Donated), `3` (Resold), `4` (Destroyed), `5` (Returned to Vendor).
`wiped`	enum	Valid ids: `1` (Yes), `0` (No), `2` (N/A).
`wipeMethod`	enum	Valid ids: `1` (DoD 5220.22-M), `2` (NIST 800-88), `3` (Physical Destruction), `4` (Degauss), `5` (Crypto Erase).
`disposalCertificate`	text	Disposal Certificate.
`disposalVendor`	reference → `VEN`	Disposal Vendor.
`disposalCost`	number	Disposal Cost.
`disposalNotes`	text (multi-line)	Disposal Notes.

Relationships

Lookups: status points at a ITSTATUS record; assetType points at a ITTYPE record; configItem points at a CMDB record; manufacturer points at a VEN record; formFactor points at a ITFORMFACTOR record; storageType points at a ITSTORAGETYPE record; assignedTo points at a STF record; department points at a DEPT record; hostSystem points at a COMPINV record; vmCluster points at a HYPCLUSTER record; vmResourcePool points at a RESOURCEPOOL record; vmDatastore points at a DATASTORE record; networkPortGroup points at a VPORTGROUP record; currency points at a CURRENCY record; vendor points at a VEN record; purchaseOrder points at a PO record; costCenter points at a COSTCTR record; budgetCode points at a BUDGCODE record; glAccount points at a GLACCT record; depreciationMethod points at a DEPMETHOD record; warrantyProvider points at a VEN record; supportAgreement points at a SUPAGREEMENT record; supportLevel points at a SUPLEVEL record; supportProvider points at a VEN record; encryptionType points at a ITENCTYPE record; replacementAsset points at a ITASSET record; disposalVendor points at a VEN record.
Related lists: ITASSIGNMENT (format SUB|ITASSET), ITAPPSW, ITMAINT, TICKET, ITHISTORY, ITADLINE.

Creating a IT Asset via the API

POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json

{
  "entity":   "ITASSET",
  "level":    50000,
  "comboKey": "SUB:<your-sub-id>|ENT:",
  "name": "Example",
  "assetTag": "...",
  "ref": "...",
  "serialNumber": "..."
}

Listing IT Assets

# All records in your tenant
GET /v1/entities/ITASSET/SUB:<your-sub-id>

DemandFlow Support Centre

ITASSET: IT Asset

ITASSET: IT Asset

Entity properties

Use cases

Fields

Relationships

Creating a IT Asset via the API

Listing IT Assets

See also

Was this article helpful?