Service Directory > v31.2 > Resource_Management > Transfer_Asset
 

Operation: Transfer_Asset

This service operation will allow you to transfer business assets and submit them to the business process. Request data includes issue date, custodian (worker), location and worktags for the corresponding transfer transaction. A boolean is provided that allows the location and worktags values to be defaulted from the custodian. This web service doesn't enable Workday to automatically populate related worktags. The public Get Asset 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: Transfer_Asset_Request

Element containing Business Process Parameters, Business Asset Reference and Transfer details.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Business_Process_Parameters  Financials_Business_Process_Parameters  [0..1]  Business Process Parameters provide the ability to auto-submit to the business process.   
Business_Asset_Reference  Business_AssetObject  [1..1]  Reference to an existing Business Asset that will be used for the Transfer transaction. 
Validation Description
Business Asset Status ([asset status]) is not valid for Transfer. Status cannot be Disposed, Pending Disposal or Received Not Registered.   
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. 
Discrete Composite Asset or Components of Non-Discrete Composite Asset cannot be transferred.   
You can't transfer assets for the Type and Accounting Method of the Supplier Contract.   
 
Asset_Transfer_Data  Asset_Transfer_Data  [1..1]  Data values and flags that will be used to update the Business Asset during the Transfer transaction. 
Validation Description
Either Worker, Location, or Worktags must change to be able to transfer the asset.  Either Worker, Location, or Worktags must change to be able to transfer the asset. 
The following Asset Worktags are required but have not been assigned: [missing]   
The following Asset Worktag types are invalid: [invalid]   
You must enter 1 in the Keep Asset Share field if you want to transfer assets that share accounting. Enter zero if you do not want transfered assets to share accounting.   
You cannot enter a value in the Keep Asset Share field when transfered assets do not share accounting.   
You can't transfer assets using both the Default Location and Worktags from Worker and Keep Worktags of Asset Shares. Enter zero in the Default Location and Worktags from Worker field to transfer assets using the share accounting worktags or enter zero in the Keep Worktags of Asset Shares field if you want to override share accounting worktags.   
 
top
 

Response Element: Transfer_Asset_Response

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

Financials_Business_Process_Parameters

part of: Transfer_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, Asset_Transfer_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_AssetObject

part of: Transfer_Asset_Request, Transfer_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  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_Transfer_Data

part of: Transfer_Asset_Request
Element containing Business Asset Transfer details.
 
Parameter name Type/Value Cardinality Description Validations
@Keep_Worktags_of_Asset_Shares  boolean  [1..1]  Boolean that when checked will keep the current Asset Share Worktags, if unchecked the worktags will be overridden.   
Transfer_Date  date  [1..1]  The transaction effective date of the Asset Transfer. The date must be greater than or equal to the Asset's acquisition date and must not be prior to the last issued date. If the Business Asset is Depreciable, the Ledger Period must exist for the date specified. 
Validation Description
Transfer date cannot be prior to last issue date, last transfer date or acquisition date, and cannot be after today   
Ledger Period must exist for the Issue or Transfer Date specified for Depreciable Assets.   
Select an Issue or Transfer Date that is on or between the asset's acquisition date and today.   
The transfer date must be less than or equal to today's date.  The transfer date 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   
Transaction effective date of this transaction cannot be prior to last partial disposal date for asset   
 
Transfer_To_Worker_Reference  WorkerObject  [0..1]  Reference to an existing worker or custodian of the business asset   
Default_Location_and_Worktags_from_Worker  boolean  [0..1]  Indicates whether the Location and Worktags values will be defaulted from the Worker specified. 1=default; 2=do not default If defaulting is requested, a Worker must be specified while Location and Worktags are blank. 
Validation Description
In order to use default values, a Worker must be specified while Location and Worktags are blank.   
 
Keep_Location_and_Worktags_from_Business_Asset  boolean  [0..1]  You must first configure the Maintain Worktag Type Precedences task to Not Default Worker Organization Assignments as Worktags for Business Asset. Indicates whether the Location and Worktags of the Business Asset remain. If you set this field to True, Location and Worktags must be blank. If Default Location and Worktags from Worker are also set to True, Workday merges the Asset Worktags with the Worker Worktags. 
Validation Description
To retain values from Business Asset, the Location and Worktags fields must be blank.   
You can't retain values from Business Asset. You must first configure the Maintain Worktag Type Precedences task to Not Default Worker Organization Assignments as Worktags for Business Asset.   
 
Transfer_To_Location_Reference  LocationObject  [0..1]  Reference to the location of the business asset   
Worktags_Reference  Accounting_WorktagObject  [0..*]  Reference to existing worktags. Worktags are a way to mark tasks and business objects to make them easier to access and summarize. Each transaction can include one value for each worktag type and is subject to configurable validation when submitted for approval. 
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 document line.   
Select a balancing worktag for Worktags of the following type: [type]   
[missing worktags for spend and item]   
[non-allowed worktags for spend and item]   
'[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].   
Remove the values in the Worktags field if you want to transfer assets that share accounting worktags or enter zero in the Keep Worktags of Asset Shares field if you want to override share accounting worktags.   
 
Asset_Transfer_Comments  string  [0..1]  Enter comments when necessary for asset transfer reason.   
Validation Description
Either Worker, Location, or Worktags must change to be able to transfer the asset.  Either Worker, Location, or Worktags must change to be able to transfer the asset. 
The following Asset Worktags are required but have not been assigned: [missing]   
The following Asset Worktag types are invalid: [invalid]   
You must enter 1 in the Keep Asset Share field if you want to transfer assets that share accounting. Enter zero if you do not want transfered assets to share accounting.   
You cannot enter a value in the Keep Asset Share field when transfered assets do not share accounting.   
You can't transfer assets using both the Default Location and Worktags from Worker and Keep Worktags of Asset Shares. Enter zero in the Default Location and Worktags from Worker field to transfer assets using the share accounting worktags or enter zero in the Keep Worktags of Asset Shares field if you want to override share accounting worktags.   
top
 

LocationObject

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

LocationObjectID

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

WorkerReferenceEnumeration

part of: WorkerObjectID
Base Type
string
top
 

Business_AssetReferenceEnumeration

part of: Business_AssetObjectID
Base Type
string
top
 

LocationReferenceEnumeration

part of: LocationObjectID
Base Type
string
top
 

Accounting_WorktagReferenceEnumeration

part of: Accounting_WorktagObjectID
Base Type
string
top