Service Directory > v31.2 > Resource_Management > Issue_Asset
 

Operation: Issue_Asset

This service operation will allow you to issue business assets and submit them to the business process. Request data includes issue date, custodian (worker), location and worktags for the corresponding issue 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: Issue_Asset_Request

Element containing Business Process Parameters, Business Asset Reference and Issue 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 Issue transaction. 
Validation Description
Business Asset status ([asset status]) is not valid for Issue. Status must be 'In Service' or '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. 
An Asset cannot be issued if it has Contract information.   
Discrete Composite Asset or Components of Non-Discrete Composite Asset cannot be issued.   
You can't issue assets for the Type and Accounting Method of the Supplier Contract.   
 
Asset_Issue_Data  Asset_Issue_Data  [1..1]  Data values and flags that will be used to update the Business Asset during the Issue transaction. 
Validation Description
The following Asset Worktags are required but have not been assigned: [missing]   
The following Asset Worktag types are invalid: [invalid]   
To issue assets that share accounting worktags, select the Keep Worktags of Asset Shares field.   
Remove the values in the Worktags field if you want to issue assets that share accounting worktags or enter zero in the Keep Worktags of Asset Shares field if you want to override share accounting worktags.   
You can't issue 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 issue 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: Issue_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  
Business_Asset_Issue_Reference  Business_AssetObject  [0..1]  Business Asset specified for Issue.   
top
 

Financials_Business_Process_Parameters

part of: Issue_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_Issue_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: Issue_Asset_Request, Issue_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_Issue_Data

part of: Issue_Asset_Request
Element containing Business Asset Issue 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.   
Transaction_Effective_Date  date  [1..1]  The transaction effective date of the asset issue. The date must be greater than or equal to the asset's acquisition date. If the asset is depreciable, the Ledger Period must exist for the date specified. 
Validation Description
Select an Issue or Transfer Date that is on or between the asset's acquisition date and today.   
Ledger Period must exist for the Issue or Transfer Date specified for Depreciable Assets.   
The Asset cannot be Placed in Service/Issued at this time. Your asset accountant must ensure all fiscal years / periods for this asset's useful life are set up in the fiscal schedules of all asset books where the asset's depreciation profile has 'Number of Days' as the rate basis.   
Issue Date cannot be prior to last issue or transfer 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   
 
Issue_To_Reference  WorkerObject  [1..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
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.   
To retain values from Business Asset, the Location and Worktags fields must be blank.   
 
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.   
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].   
 
Validation Description
The following Asset Worktags are required but have not been assigned: [missing]   
The following Asset Worktag types are invalid: [invalid]   
To issue assets that share accounting worktags, select the Keep Worktags of Asset Shares field.   
Remove the values in the Worktags field if you want to issue assets that share accounting worktags or enter zero in the Keep Worktags of Asset Shares field if you want to override share accounting worktags.   
You can't issue 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 issue 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_Issue_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_Issue_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