DemandFlow Support Centre

INVDISPOSAL: Disposal

A disposal or decommission record for inventory items, covering approval, data sanitisation, financial write-off, and environmental compliance.

Default definition. This article describes the default INVDISPOSAL 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 INVDISPOSAL.

Entity properties

Property	Value
Entity code	`INVDISPOSAL`
Display name	Disposal
Plural	Disposals
Level	55000

Use cases

Tracks the full end-of-life process for assets and consumables. Three-column layout: left (25%) has disposal identity (reference, reason, status workflow, priority, requested by, request date), middle (35%) has what is being disposed (component, inventory item, serial, quantity, site, data sanitisation section with wipe method/certificate/verified by. visible only for IT asset reasons), right (40%) has financial and compliance (book value, salvage/recovery value, write-off amount, disposal method, disposal vendor, waste certificate reference, completion date, notes).

Fields

Disposal Details

Field	Type	Required	Notes
`name`	text	Yes	Disposal Reference.
`reason`	enum	Yes	Valid ids: `endOfLife` (End of Service Life), `damaged` (Damaged Beyond Repair), `obsolete` (Obsolete / Superseded), `decommission` (IT Decommission), `recall` (Vendor Recall), `hazardous` (Hazardous / Safety Risk), `surplus` (Surplus Stock).
`status`	enum	Yes	Valid ids: `requested` (Requested), `approved` (Approved), `inProgress` (In Progress), `completed` (Completed), `rejected` (Rejected).
`priority`	enum		Valid ids: `low` (Low), `normal` (Normal), `high` (High), `urgent` (Urgent).
`ownerId`	reference → user		Requested By.
`requestDate`	date		Request Date.
`approvedBy`	reference → user		Approved By.

Item

Field	Type	Required	Notes
`componentId`	reference → `COMP`	Yes	Component.
`inventoryId`	reference → `COMPINV`		Inventory Item.
`serialNumber`	text		Serial Number.
`qty`	number	Yes	Quantity.
`siteId`	reference → `SITE`	Yes	Site.

Data Sanitisation

Field	Type	Notes
`wipeMethod`	enum	Valid ids: `none` (Not Applicable), `softwareWipe` (Software Wipe (NIST 800-88)), `degauss` (Degaussing), `physicalDestruction` (Physical Destruction), `cryptoErase` (Cryptographic Erase), `factoryReset` (Factory Reset).
`wipeCertificate`	text	Certificate of data destruction reference
`wipeVerifiedBy`	reference → user	Verified By.
`wipeDate`	date	Wipe Date.

Financial

Field	Type	Notes
`bookValue`	number	Current net book value at time of disposal
`recoveryValue`	number	Recovery / Salvage Value.
`writeOffAmount`	number	Book value minus recovery value

Disposal & Compliance

Field	Type	Notes
`disposalMethod`	enum	Valid ids: `weeeRecycling` (WEEE Recycling), `vendorReturn` (Return to Vendor), `donation` (Donation), `resale` (Resale), `physicalDestruction` (Physical Destruction), `hazardousWaste` (Hazardous Waste Disposal), `generalWaste` (General Waste).
`disposalVendorId`	reference → `VEN`	Recycling or disposal service provider
`wasteCertificate`	text	Waste transfer note or duty of care certificate
`completionDate`	date	Completion Date.
`notes`	text (multi-line)	Notes.

Relationships

Lookups: componentId points at a COMP record; inventoryId points at a COMPINV record; siteId points at a SITE record; disposalVendorId points at a VEN record; ownerId points at a user; approvedBy points at a user; wipeVerifiedBy points at a user.

Creating a Disposal via the API

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

{
  "entity":   "INVDISPOSAL",
  "level":    55000,
  "comboKey": "SUB:<your-sub-id>|ENT:",
  "name": "Example",
  "reason": "endOfLife",
  "status": "requested",
  "componentId": ""
}

Listing Disposals

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

DemandFlow Support Centre

INVDISPOSAL: Disposal

INVDISPOSAL: Disposal

Entity properties

Use cases

Fields

Relationships

Creating a Disposal via the API

Listing Disposals

See also

Was this article helpful?