Service Directory > v31.2 > Resource_Management > Dispose_Asset
 

Operation: Dispose_Asset

This allows you to dispose of an existing Asset. The date, disposal type, worktags, and values of the asset can be specified on the request.


@ - A parameter name with this symbol denotes an XML attribute within the document instead of an XML element.


Contents

 

Web Service

 

Request

 

Response

 

Element(s)

 

Request Element: Dispose_Asset_Request

Root element for the Request on the Dispose Asset operation.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Business_Process_Parameters  Financials_Business_Process_Parameters  [0..1]  Contains data for business processing   
Dispose_Asset_Data  Dispose_Asset_Data  [1..1]  Contains data used to process the asset disposal. 
Validation Description
The following worktag type(s) are required: [missing]   
The following Dispose Asset Worktag types are invalid: [invalid]   
 
top
 

Response Element: Dispose_Asset_Response

Root element for the Response on the Dispose Asset operation.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Asset_Disposal_Event_Reference  Unique_IdentifierObject  [0..1]  A reference to the Asset Disposal Event that was created by the request.   
top
 

Financials_Business_Process_Parameters

part of: Dispose_Asset_Request
Contains data for business processing
 
Parameter name Type/Value Cardinality Description Validations
Auto_Complete  boolean  [0..1]  When set to "true" or "1", the business process is automatically processed. This means that all approvals will be automatically approved in the system, all reviews and to-do's will be automatically by-passed, and all notifications will be automatically suppressed.   
Comment_Data  Business_Process_Comment_Data  [0..1]  Captures the Comment for the Business Process.   
top
 

Business_Process_Comment_Data

part of: Financials_Business_Process_Parameters
Captures a comment for the Business Process.
 
Parameter name Type/Value Cardinality Description Validations
Comment  string  [0..1]  Free form comment regarding the business process. 
Validation Description
This Business Process has been configured to disable comment. Please remove the comment or change the setting in the Business Process Policy or tenant setup.   
 
Worker_Reference  WorkerObject  [0..1]  Default the Person making the comment to the processing person if not submitted via the web service.   
top
 

WorkerObject

part of: Business_Process_Comment_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  WorkerObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

WorkerObjectID

part of: WorkerObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Contingent_Worker_ID, Employee_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Dispose_Asset_Data

part of: Dispose_Asset_Request
Contains data used to process the asset disposal.
 
Parameter name Type/Value Cardinality Description Validations
Asset_Reference  Business_AssetObject  [1..1]  A reference to the asset that should be disposed. 
Validation Description
The asset specified cannot currently be disposed because it has other activity in progress.   
You can only dispose an asset that is In Service, Issued, Registered, or Out of Service. If you register an asset from a lease type supplier contract, the contract must be cancelled or the asset fully depreciated. You can't dispose an asset that is a Discrete Composite Asset.  You can only dispose an asset that is In Service, Issued, Registered, or Out of Service. If you register an asset from a lease type supplier contract, the contract must be cancelled or the asset fully depreciated. You can't dispose an asset that is a Discrete Composite Asset. 
 
Transaction_Effective_Date  date  [1..1]  The transaction effective date for the asset disposal. 
Validation Description
The transaction effective date of the disposal is too soon; asset may be expired after the Period End Date of the last depreciation expense line for the life of the asset.   
The transaction effective date of the disposal cannot be earlier than the acquisition date.   
Ledger period must exist for the transaction effective date and the Depreciation Start Date for this asset disposal.   
The transaction effective date of the disposal must be less than or equal to today's date.   
The fiscal Period for the transaction date must exist in the fiscal schedule of every company asset book where this is a depreciable asset in order to do this transaction   
Transaction effective date of this transaction cannot be prior to last reclassification date for asset   
Asset has an event with transaction date after this Partial Disposal transaction effective date   
Depreciation effective date for partial disposal cannot be prior to last resume date for the asset.   
The Transaction Effective Date must be on or after the last Depreciation Date of the asset book.   
 
Disposal_Type_Reference  Asset_Disposal_TypeObject  [1..1]  A reference to the type of disposal.   
Percent_to_Dispose  decimal (19, 16) >0   [0..1]  The percent of asset total cost to dispose. Valid values between 1 and 100. If percent to dispose is 0 and cost to dispose is 0, percent to dispose will be set 100. 
Validation Description
You cannot partially dispose an asset with status of Out of Service   
You cannot partially dispose an expense asset   
You cannot partially dispose expired asset.   
Disposal percent must be greater than 0 and less than or equal to 100.   
The Percent to Dispose must be equal to 100 for leased assets.   
 
Cost_to_Dispose  decimal (26, 6)   [0..1]  The cost from total asset cost to dispose. 
Validation Description
Disposal cost must not be greater than current cost.   
The cost to dispose entered has too many digits beyond the decimal point  The cost to dispose entered has too many digits beyond the decimal point 
Asset Disposal can't be negative.   
Asset Disposal can't be positive.   
Disposal cost must not be less than current cost.   
The asset disposal cost for leased asset from a supplier contract must be equal to the cost of the asset.   
 
Disposal_Fair_Market_Value  decimal (26, 6)   [0..1]  The fair market value of the asset at the time of disposal. 
Validation Description
The disposal fair market value entered has too many digits beyond the decimal point  The disposal fair market value entered has too many digits beyond the decimal point 
 
Sale_Price  decimal (26, 6)   [0..1]  The sale price (if the Disposal Type was Sale) when the asset was sold. 
Validation Description
Sale Price can only be entered if the disposal type is a sale.   
The sale price entered has too many digits beyond the decimal point  The sale price entered has too many digits beyond the decimal point 
 
Comments  string  [0..1]  Free-form comments to include with the disposal event.   
Worktag_Reference  Accounting_WorktagObject  [0..*]  A list of worktags to track with the disposal event. 
Validation Description
One or more of the worktags selected are of an invalid type for this transaction.   
Only one worktag for each type is allowed for each disposal activity.   
Select a balancing worktag for Worktags of the following type: [type]   
[non-allowed worktags for asset web service]   
[missing worktags for business asset web service]   
'[worktag value]' is not permitted as an allowed value for worktag type: [worktag type] because it is inactive.   
[partitionable] is not allowed to be used by [company].   
Asset is shared by worktags. You cannot update these worktags during disposal.   
 
Validation Description
The following worktag type(s) are required: [missing]   
The following Dispose Asset Worktag types are invalid: [invalid]   
top
 

Business_AssetObject

part of: Dispose_Asset_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Business_AssetObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Business_AssetObjectID

part of: Business_AssetObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Asset_ID, Asset_Reference_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Asset_Disposal_TypeObject

part of: Dispose_Asset_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Asset_Disposal_TypeObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Asset_Disposal_TypeObjectID

part of: Asset_Disposal_TypeObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Resource_Disposal_Type_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Accounting_WorktagObject

part of: Dispose_Asset_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Accounting_WorktagObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Accounting_WorktagObjectID

part of: Accounting_WorktagObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Academic_Level_ID, Academic_Period_ID, Academic_Person_ID, Academic_Unit_ID, Ad_hoc_Payee_ID, Applicant_ID, Asset_Adjustment_Reason_Reference_ID, Asset_Adjustment_Type_Reference_ID, Asset_Impairment_Reason_ID, Bank_Account_ID, Business_Asset_Cost_Adjustment_Reason_ID, Business_Unit_ID, Calculation_Compensation_Basis_ID, Cash_Activity_Category_ID, Catalog_Item_ID, Company_Reference_ID, Compensation_Basis_ID, Compensation_Grade_ID, Contingent_Worker_ID, Contingent_Worker_Type_ID, Corporate_Credit_Card_Account_ID, Cost_Center_Reference_ID, Custom_Organization_Reference_ID, Custom_Worktag_06_ID, Custom_Worktag_07_ID, Custom_Worktag_08_ID, Custom_Worktag_09_ID, Custom_Worktag_1_ID, Custom_Worktag_10_ID, Custom_Worktag_11_ID, Custom_Worktag_12_ID, Custom_Worktag_13_ID, Custom_Worktag_14_ID, Custom_Worktag_15_ID, Custom_Worktag_2_ID, Custom_Worktag_3_ID, Custom_Worktag_4_ID, Custom_Worktag_5_ID, Customer_Category_ID, Customer_Contract_Alternate_Reference_ID, Customer_Contract_Reference_ID, Customer_ID, Customer_Reference_ID, Deduction_Code, Deduction_Recipient_ID, Donor_ID, Earning_Code, Employee_ID, Employee_Type_ID, Ethnicity_ID, Expense_Item_ID, External_Committee_Member_ID, Financial_Aid_Award_Year_ID, Financial_Institution_ID, Financial_Institution_Reference_ID, Fund_ID, Funding_Source_Name, Gender_Code, Gift_Reference_ID, Grant_ID, Internal_Service_Provider_ID, Internal_Service_Provider_Reference_ID, Investment_Pool_ID, Investment_Profile_ID, Investor_ID, Is_Manager_ID, Is_People_Manager, ISO_3166-1_Alpha-2_Code, ISO_3166-1_Alpha-3_Code, ISO_3166-1_Numeric-3_Code, Job_Category_ID, Job_Level_ID, Job_Profile_ID, Job_Requisition_ID, Loan_ID, Location_ID, Management_Level_ID, NI_Category_Letter, Object_Class_ID, Opportunity_Reference_ID, Organization_Reference_ID, Pay_Rate_Type_ID, Payroll_Federal_Authority_Tax_Code, Payroll_Income_Code, Payroll_Local_City_Authority_Tax_Code, Payroll_Local_County_Authority_Tax_Code, Payroll_Local_Other_Authority_Tax_Code, Payroll_Local_School_District_Authority_Tax_Code, Payroll_State_Authority_Tax_Code, Petty_Cash_Account_ID, Position_ID, Position_Time_Type_ID, Program_ID, Program_of_Study_ID, Project_ID, Project_Plan_ID, Proposal_Grant_ID, Prospect_ID, Prospect_Reference_ID, Purchase_Item_ID, Receivable_Writeoff_Reason_ID, Region_Reference_ID, Revenue_Category_ID, Rubric_Value_ID, Run_Category_ID, Salary_Over_The_Cap_Type_ID, Sales_Item_ID, Spend_Category_ID, Sponsor_ID, Sponsor_Reference_ID, Student_Application_Residency_Status_ID, Student_Award_Item_ID, Student_Charge_Item_ID, Student_Course_ID, Student_Course_Section_ID, Student_ID, Student_Recruiting_Campaign_ID, Student_Recruiting_Event_ID, Student_Sponsor_Contract_ID, Student_Waiver_Item_ID, Supplier_Category_ID, Supplier_Contract_ID, Supplier_ID, Supplier_Reference_ID, Tax_Applicability_ID, Tax_Authority_ID, Tax_Authority_Reference_ID, Tax_Category_ID, Tax_Code_ID, Tax_Point_Date_Type_ID, Tax_Rate_ID, Tax_Recoverability_Object_ID, Third_Party_ID, Withholding_Order_Case_ID, Withholding_Tax_Code_ID, Withholding_Tax_Rate_ID, Work_Function_ID, Work_Shift_ID, Workday_Deduction_Code, Workday_Earning_Code, Worker_Type_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Unique_IdentifierObject

part of: Dispose_Asset_Response
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Unique_IdentifierObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Unique_IdentifierObjectID

part of: Unique_IdentifierObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  IID, WID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

WorkerReferenceEnumeration

part of: WorkerObjectID
Base Type
string
top
 

Business_AssetReferenceEnumeration

part of: Business_AssetObjectID
Base Type
string
top
 

Asset_Disposal_TypeReferenceEnumeration

part of: Asset_Disposal_TypeObjectID
Base Type
string
top
 

Accounting_WorktagReferenceEnumeration

part of: Accounting_WorktagObjectID
Base Type
string
top
 

Unique_IdentifierReferenceEnumeration

part of: Unique_IdentifierObjectID
Base Type
string
top