Service Directory > v25.1 > Resource_Management > Import_Catalog_Load
 

Operation: Import_Catalog_Load

This service operation will add or update Catalog Items. Catalog Load Requests contain supplier specific Catalog Items and effective dated pricing. Catalog Load Requests can be associated with Supplier Contracts. Once a Catalog Load Request is fully approved Catalog Items are available for use on Requisitions and Purchase Orders based on their effective date. Catalog Loads include data such as Supplier, Supplier Contract, Effective Date, memo and item details such as Item ID, Item Name, Item Description, Unit of Measure and Unit Price.


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

Contains request reference and response group for getting Catalog Load data
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Business_Process_Parameters  Financials_Business_Process_Parameters  [0..*]  Business Process Parameters provide the ability to auto-submit to the business process.   
Catalog_Load_Data  Catalog_Load__HV__Data  [1..1]  Catalog Load Data 
Validation Description
A Catalog Load Request for this Supplier Catalog has already been saved as draft or is in progress. Complete or cancel the existing Catalog Load Request before creating a new one.   
Effective Date may not be in the past.   
A Supplier Catalog is required to load items.   
 
top
 

Response Element: Put_Import_Process_Response

Put Import Process Response element
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Import_Process_Reference  Web_Service_Background_Process_RuntimeObject  [0..1]  Web Service Background Process Runtime element   
Header_Instance_Reference  InstanceObject  [0..1]  Header Instance element   
top
 

Financials_Business_Process_Parameters

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

Catalog_Load__HV__Data

part of: Import_Catalog_Load_Request
Element containing Catalog Load Data
 
Parameter name Type/Value Cardinality Description Validations
Effective_Date  date  [0..1]  Catalog Effective Date   
Supplier_Catalog_Reference  Supplier_CatalogObject  [1..1]  Supplier Catalog for Catalog Load   
Default_Lead_Time_in_Days  decimal (12, 0) >0   [0..1]  Catalog Load Default Catalog Load Item Lead Time in Days   
Catalog_Load_Item_Data  Catalog_Load_Item__HV__Data  [0..*]  Element containing Catalog Load Item data. 
Validation Description
Cannot use Catalog Item ID as it is used for a different Catalog Item   
Specify a Purchase Item that has the same Spend Category as the Catalog Item.   
Provide a valid Spend Category when you specify the Purchase Item for the Catalog Item.   
 
Memo  string  [0..1]  This transaction header memo will print on the delivered transaction. It is optional freeform text   
Validation Description
A Catalog Load Request for this Supplier Catalog has already been saved as draft or is in progress. Complete or cancel the existing Catalog Load Request before creating a new one.   
Effective Date may not be in the past.   
A Supplier Catalog is required to load items.   
top
 

Supplier_CatalogObject

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

Supplier_CatalogObjectID

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

Catalog_Load_Item__HV__Data

part of: Catalog_Load__HV__Data
Element containing Catalog Load Item Data
 
Parameter name Type/Value Cardinality Description Validations
Catalog_Item_ID  string  [0..1]  Catalog Item Unique Identifier   
Item_Identifier  string  [1..1]  Catalog Item Identifier   
Item_Name  string  [1..1]  Catalog Item Name   
Item_Description  string  [1..1]  Catalog Item Description   
Item_Unit_Price  decimal (26, 6)   [0..1]  Catalog Item Unit Price   
Item_URL  string  [0..1]  Catalog Item URL   
Unit_of_Measure_Code_Reference [Choice]   Unit_of_MeasureObject  [1..1]  Catalog Item Unit of Measure Code Reference   
UN_CEFACT_UOM_Code [Choice]   string  [1..1]  Catalog Item UN CEFACT Common Code used for Unit of Measure   
Lead_Time  decimal (12, 0) >0   [0..1]  Catalog Item Lead Time   
Spend_Category_Reference [Choice]   Spend_CategoryObject  [1..1]  Catalog Item Spend Category   
UNSPSC_Code [Choice]   decimal (12, 0) >0   [1..1]  Catalog Item UNSPSC code for Spend Category   
Alternate_Item_Identifiers  Catalog_Load_Alternate_Item_Identifier  [0..*]  Alternate Item Identifiers for Catalog Load items.   
Purchase_Item_Reference  Purchase_ItemObject  [0..1]  Purchase Item for the Catalog Item   
Conversion_Factor  decimal (21, 9) >0   [0..1]  Conversion Factor between Ordering Unit of Measure and Purchase Item Base Unit of Measure   
Validation Description
Cannot use Catalog Item ID as it is used for a different Catalog Item   
Specify a Purchase Item that has the same Spend Category as the Catalog Item.   
Provide a valid Spend Category when you specify the Purchase Item for the Catalog Item.   
top
 

Unit_of_MeasureObject

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

Unit_of_MeasureObjectID

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

Spend_CategoryObject

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

Spend_CategoryObjectID

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

Catalog_Load_Alternate_Item_Identifier

part of: Catalog_Load_Item__HV__Data
Alternate Item Identifiers for Catalog Load items.
 
Parameter name Type/Value Cardinality Description Validations
Item_Identifier_Type_Reference  Item_Identifier_TypeObject  [1..1]  Item Identifier Type for the Alternate Item Identifier.   
Alternate_Identifier_Value  string  [1..1]  Item Identifier Value for the Alternate Item Identifier.   
top
 

Item_Identifier_TypeObject

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

Item_Identifier_TypeObjectID

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

Purchase_ItemObject

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

Purchase_ItemObjectID

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

Web_Service_Background_Process_RuntimeObject

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

Web_Service_Background_Process_RuntimeObjectID

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

InstanceObject

part of: Put_Import_Process_Response
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]     
ID  Instance_ID  [0..*]     
top
 

Instance_ID

part of: InstanceObject
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@parent_id  string  [1..1]     
@parent_type  string  [1..1]     
@type  string  [1..1]     
top
 

WorkerReferenceEnumeration

part of: WorkerObjectID
Base Type
string
top
 

Supplier_CatalogReferenceEnumeration

part of: Supplier_CatalogObjectID
Base Type
string
top
 

Unit_of_MeasureReferenceEnumeration

part of: Unit_of_MeasureObjectID
Base Type
string
top
 

Spend_CategoryReferenceEnumeration

part of: Spend_CategoryObjectID
Base Type
string
top
 

Item_Identifier_TypeReferenceEnumeration

part of: Item_Identifier_TypeObjectID
Base Type
string
top
 

Purchase_ItemReferenceEnumeration

part of: Purchase_ItemObjectID
Base Type
string
top
 

Web_Service_Background_Process_RuntimeReferenceEnumeration

part of: Web_Service_Background_Process_RuntimeObjectID
Base Type
string
top