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 Disposal — entity reference
REFERENCE · Last reviewed

Asset Disposal — entity reference

The retirement of one asset by sale, scrap or donation. It records the proceeds and a snapshot of the asset's cost and accumulated depreciation, and its Post Disposal action turns them into a balanced journal: accumulated depreciation is reversed, the asset's cost is removed, any proceeds are booked and the difference is booked as a gain or loss. Posting marks the disposal Posted and GL Posted, stores the journal and the booked gain or loss, and sets the linked asset's Status to Disposed, copies the disposal date and proceeds onto it and sets its Net Book Value to 0. Every figure and GL account is typed on the disposal; nothing is read from the asset or its depreciation schedule. There is no un-post action, and reversing the journal does not reopen the disposal or the asset.

Fields

FieldLabelTypeRequiredWhat it does
AccumulatedDepreciationAccumulated DepreciationCurrencyDepreciation charged on the asset up to the disposal date, typed here rather than read from the asset or its schedule. Posting debits it to the Accumulated Depreciation GL Account; when it is 0 that line is left out.
AccumulatedDepreciationGLAccountIdAccumulated Depreciation GL AccountLookup → GLAccountThe accumulated depreciation account that is debited to reverse the depreciation. Required to post, even when Accumulated Depreciation is 0.
AssetIdAssetLookup → AssetThe asset being retired. Posting sets this asset's Status to Disposed, copies the disposal date and proceeds onto it and sets its Net Book Value to 0. The picker lists every asset, including ones already disposed, and nothing stops a second disposal of the same asset.
BranchIdBranchLookup → BranchThe location the disposal posts under. Required to post, and copied to the journal header and every line. If it is empty when the Fixed Asset GL Account is set, it is filled from that GL account's default branch.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CurrencyCurrencyPickListNot on the standard forms and not used by posting; the journal is in the company's currency.
DisposalDateDisposal DateDateThe date of the disposal and of its journal. The journal must fall in an open fiscal period of the company. When empty, posting uses today's date. Copied to the asset's Disposal Date on posting.
DisposalMethodDisposal MethodPickListHow the asset left the business: Sale, Scrap or Donation. Recorded for reporting only; posting does not read it. Values: Sale, Scrap, Donation.
DisposalReasonDisposal ReasonPickListWhy the asset was retired: Sold, Damaged or Obsolete. Recorded for reporting only; posting does not read it. Values: Damaged, Obsolete, Sold.
DisposalValueDisposal ValueCurrencyThe proceeds received. Posting debits it to the Proceeds GL Account when it is above zero, and copies it to the asset's Disposal Value. Leave it empty or 0 for a scrap or donation with no proceeds.
FixedAssetGLAccountIdFixed Asset GL AccountLookup → GLAccountThe asset (gross block) account the cost is credited to. Required to post.
GainLossGain/LossCalculated (calculated)Disposal Value minus Net Book Value: positive is a gain, negative a loss. Shown as a calculated figure while you edit; posting recalculates it and stores the amount actually booked.
GainLossGLAccountIdGain/Loss GL AccountLookup → GLAccountThe account for the profit or loss on disposal: credited with a gain, debited with a loss. Required whenever the proceeds differ from net book value.
GLIdGL JournalLookup → JournalThe journal created by Post Disposal. Not on the standard forms; find the journal in the Journals list by Source Entity Name AssetDisposal.
IdIdGuidYes
IsGLPostedGL PostedBooleanSet on by Post Disposal. A disposal with this flag on cannot be posted again.
LabelLabelTextOptional description. Not on the standard forms. When filled, it is used instead of the number in the posted journal's label and narration.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesDisposal number, given automatically on save from the Asset Disposal document name setting (series AD).
NetBookValueNet Book ValueCurrencyCarrying value at disposal. Leave it empty and posting uses Purchase Cost minus Accumulated Depreciation. If you type a value, it must equal Purchase Cost minus Accumulated Depreciation, otherwise the journal does not balance and posting is refused.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdCompanyLookup → AccountThe company that owned the asset. Required to post: the journal is posted under this company and into its open fiscal period. When a new disposal names neither a company nor a branch, it is filled from the owner's default company access, if the owner has one.
ProceedsGLAccountIdProceeds GL AccountLookup → GLAccountThe bank, cash or receivable clearing account the proceeds are debited to. Needed whenever Disposal Value is above zero; without it the journal does not balance. Avoid a control account such as trade receivables, because disposal journal lines carry no party.
PurchaseCostPurchase CostCurrencyThe asset's original cost, typed here rather than read from the asset. Must be above zero to post; posting credits it to the Fixed Asset GL Account to remove the asset from the books.
RecordTypeIdRecord TypeGuid, hidden
StatusStatusPickListEmpty on a new disposal; you can set it by hand on the record page. Post Disposal sets it to Posted, a value that is not one of the list values; the other list values are never set by the system and do not affect posting. A Posted disposal cannot be posted again. Values: Draft, Pending Approval, Disposed.
SubscriptionKeySubscription KeyGuid, hiddenYes
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteHeaderDeleteDeleteDeleteHeader
DeleteRowDeleteDeleteDeleteRow
EditEditEditInlineEdit
EditEntityEditEditEdit
EditRowEditEditEditRow
NewNewNewNew
PostDisposalPost DisposalServerAction (PostDisposal)Post Disposal
  • Asset — looks up via AssetId
  • Journal — looks up via GLId
  • GLAccount — looks up via ProceedsGLAccountId
  • GLAccount — looks up via GainLossGLAccountId
  • GLAccount — looks up via FixedAssetGLAccountId
  • GLAccount — looks up via AccumulatedDepreciationGLAccountId
  • Account — looks up via PartnerAccountId
  • Branch — looks up via BranchId
  • Journal — referenced by via SourceRecordId