Service Directory > v31.2 > Resource_Management > Update_Asset_Useful_Life
 

Operation: Update_Asset_Useful_Life

This is the submit request for asset useful life updates. You may adjust or correct asset useful life using this operation. To adjust, set the Adjust Useful Life boolean to True; to correct as of the asset acquisition date, leave the boolean False. The web service will submit the transaction into the business process. The public Get Resources web service may be used to export current business asset information and obtain references.


@ - 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: Update_Asset_Useful_Life_Request

Element contains Business Process Parameters, Business Asset Reference for asset to update, and asset useful life update details
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Business_Asset_Reference  Business_AssetObject  [1..1]  Reference to the Business Asset which useful life need to be corrected or adjusted 
Validation Description
There is a pending event for the asset that should be completed before this asset transaction can be processed.  There is a pending event for the asset that should be completed before this asset transaction can be processed. 
Cannot update useful life for this asset since the accounting treatment is not depreciable capital  Cannot update useful life for this asset since the accounting treatment is not depreciable capital 
Cannot update useful life for this asset since accounting information has not been assigned yet  Cannot update useful life for this asset since accounting information has not been assigned yet 
Cannot update the useful life of this asset since it is either disposed or pending disposal  Cannot update the useful life of this asset since it is either disposed or pending disposal 
Cannot update the useful life of this asset since it is out of service   
Cannot update useful life of an asset loaded into Workday as fully depreciated  Cannot update useful life of an asset loaded into Workday as fully depreciated 
You cannot adjust the useful life of this asset due to a problem with its depreciation start date not aligning with the first period in the depreciation schedule. Please contact Support for assistance.  You cannot adjust the useful life of this asset due to a problem with its depreciation start date not aligning with the first period in the depreciation schedule. Please contact Support for assistance. 
Cannot update the useful life of this asset since it has been removed   
The asset is part of a lease contract. You can't update the useful life for term books.   
 
Business_Process_Parameters  Financials_Business_Process_Parameters  [0..1]  Business Process Parameters provide the ability to auto-submit to the business process.   
Business_Asset_Useful_Life_Update_Data  Business_Asset_Useful_Life_Update_Data  [1..1]  Business Asset useful life update data 
Validation Description
Depreciation End Date must be on or after the Date the Asset is Acquired.  Depreciation End Date must be on or after the Date the Asset is Acquired. 
Useful Life in Periods is required and must be different than the current Useful Life.  Useful Life in Periods is required and must be different than the current Useful Life. 
New useful life periods cannot be less than number of periods already depreciated as of the adjustment date.  New useful life periods cannot be less than number of periods already depreciated as of the adjustment date. 
Depreciation End Date is required and must be different than the current Depreciation End Date.  Depreciation End Date is required and must be different than the current Depreciation End Date. 
The Depreciation End Date and Useful Life Periods must have different values than the current Depreciation End Date and Useful Life.  The Depreciation End Date and Useful Life Periods must have different values than the current Depreciation End Date and Useful Life. 
Depreciation End Date cannot be prior to depreciation start date of the transaction effective date  Depreciation End Date cannot be prior to depreciation start date of the transaction effective date 
 
top
 

Response Element: Update_Asset_Useful_Life_Response

Root element for the Response on the Put operation.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Submit_Useful_Life_Adjust_or_Correct_Reference  Business_AssetObject  [0..1]  Business Asset specified for useful life update   
top
 

Business_AssetObject

part of: Update_Asset_Useful_Life_Request, Update_Asset_Useful_Life_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  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
 

Financials_Business_Process_Parameters

part of: Update_Asset_Useful_Life_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
 

Business_Asset_Useful_Life_Update_Data

part of: Update_Asset_Useful_Life_Request
Element contains Business Asset useful life update details
 
Parameter name Type/Value Cardinality Description Validations
Adjust_Useful_Life  boolean  [0..1]  Indicator to whether to perform Correct Useful Life or Adjust Useful Life. Enter 0 to correct useful life or 1 to adjust useful life 
Validation Description
Cannot correct useful life for assets converted from another system into Workday  Cannot correct useful life for assets converted from another system into Workday 
Useful life correction cannot be performed on assets with post acquisition adjustments, life adjustments, impairments, reclassifications, partial disposals or suspended periods  Useful life correction cannot be performed on assets with post acquisition adjustments, life adjustments, impairments, reclassifications, partial disposals or suspended periods 
 
Transaction_Effective_Date  date  [0..1]  Date of useful life adjustment. Required if value of Useful Life Adjust is 1 or 'y'. Must be blank if Useful Life Adjust is 0 or 'n'. 
Validation Description
Adjustment Date cannot be less than Date Acquired of the Business Asset  Adjustment Date cannot be less than Date Acquired of the Business Asset 
Adjustment Date is required when the option Adjust Useful Life is 1 (true)  Adjustment Date is required when the option Adjust Useful Life is 1 (true) 
Adjustment date should not be entered when Adjust Useful Life is 0 (false)   
Adjustment date for this transaction cannot be prior to last reclassification date for asset   
Transaction effective date of this transaction cannot be prior to last partial disposal date for asset  Transaction effective date of this transaction cannot be prior to last partial disposal date for asset 
Ledger Period must exist for the Adjustment Date.  Ledger Period must exist for the Adjustment Date. 
Adjustment Date cannot be less than Depreciation Start Date  Adjustment Date cannot be less than Depreciation Start Date 
You are entering a useful life adjustment with an EARLIER effective date than an existing cost adjustment or useful life adjustment.  You are entering a useful life adjustment with an EARLIER effective date than an existing cost adjustment or useful life adjustment. 
Adjustment Date cannot be AFTER end date of of the last period in the depreciation schedule  Adjustment Date cannot be AFTER end date of of the last period in the depreciation schedule 
Depreciation start date for useful life adjustment cannot be earlier than last resume date.  Depreciation start date for useful life adjustment cannot be earlier than last resume date. 
 
Useful_Life  decimal (12, 0) >0   [0..1]  New value for useful life in periods 
Validation Description
Useful Life cannot be more than 200 years. Useful life in years is useful life in periods divided by number of periods in the company's fiscal year.  Useful Life cannot be more than 200 years. Useful life in years is useful life in periods divided by number of periods in the company's fiscal year. 
When depreciation is based on the number of days per period, all the fiscal years / periods for an asset's useful life must already be created in order to calculate the depreciation amount for each period correctly. In order to complete the accounting setup for this asset, you will first need to create additional fiscal years / periods for the fiscal schedule of this asset's company.  When depreciation is based on the number of days per period, all the fiscal years / periods for an asset's useful life must already be created in order to calculate the depreciation amount for each period correctly. In order to complete the accounting setup for this asset, you will first need to create additional fiscal years / periods for the fiscal schedule of this asset's company. 
 
Depreciation_End_Date  date  [0..1]  Update the depreciation end date of contract assets. 
Validation Description
Fiscal Period must exist for depreciation end date  Fiscal Period must exist for depreciation end date 
 
Restricted_to_Books_Reference  Asset_BookObject  [0..*]  Reference to asset books that are used by the asset. Enter asset books if you want to restrict the useful life to specific books. To update useful life for all asset books, leave this field blank. 
Validation Description
Restricted to Book is required when the asset has at least one fully depreciated book   
At least one of the Restricted to Books is not valid for asset. Only assets already defined and not loaded into Workday or transferred from different company fully depreciated are valid.   
At least one of the Restricted to Books is not valid for the asset because it uses a Declining Balance depreciation method. You cannot adjust the useful life for those assets books.   
You cannot update the useful life of this asset because it uses a Declining Balance depreciation method.   
 
Validation Description
Depreciation End Date must be on or after the Date the Asset is Acquired.  Depreciation End Date must be on or after the Date the Asset is Acquired. 
Useful Life in Periods is required and must be different than the current Useful Life.  Useful Life in Periods is required and must be different than the current Useful Life. 
New useful life periods cannot be less than number of periods already depreciated as of the adjustment date.  New useful life periods cannot be less than number of periods already depreciated as of the adjustment date. 
Depreciation End Date is required and must be different than the current Depreciation End Date.  Depreciation End Date is required and must be different than the current Depreciation End Date. 
The Depreciation End Date and Useful Life Periods must have different values than the current Depreciation End Date and Useful Life.  The Depreciation End Date and Useful Life Periods must have different values than the current Depreciation End Date and Useful Life. 
Depreciation End Date cannot be prior to depreciation start date of the transaction effective date  Depreciation End Date cannot be prior to depreciation start date of the transaction effective date 
top
 

Asset_BookObject

part of: Business_Asset_Useful_Life_Update_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_BookObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Asset_BookObjectID

part of: Asset_BookObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Asset_Book_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
 

Business_AssetReferenceEnumeration

part of: Business_AssetObjectID
Base Type
string
top
 

WorkerReferenceEnumeration

part of: WorkerObjectID
Base Type
string
top
 

Asset_BookReferenceEnumeration

part of: Asset_BookObjectID
Base Type
string
top