Service Directory > v25.1 > Resource_Management > Submit_Catalog_Load
 

Operation: Submit_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: Submit_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_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.   
Supplier Contract has multiple Supplier Catalogs. Please provide a Supplier Catalog instead for loading items.   
A Supplier Catalog is required to load items.   
You may specify a Supplier Catalog Reference or a Supplier Contract Reference, but not both.   
This Supplier Contract already has a Catalog Load in progress.   
 
top
 

Response Element: Submit_Catalog_Load_Response

Element containing Put Catalog Load Response Data
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Catalog_Load_Reference  Unique_IdentifierObject  [0..1]  Catalog Load Reference   
Effective_Date  date  [0..1]  Catalog Effective Date   
Supplier_Catalog_Reference  Supplier_CatalogObject  [0..1]  Supplier Catalog for Catalog Load   
Supplier_Contract_Reference  Supplier_ContractObject  [0..1]  Supplier Contract Reference   
Catalog_Load_Item_Reference_Data  Catalog_Load_Item_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.   
 
Catalog_Load_Data_Reference_Data  Catalog_Load_Data  [0..*]  Element containing 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.   
Supplier Contract has multiple Supplier Catalogs. Please provide a Supplier Catalog instead for loading items.   
A Supplier Catalog is required to load items.   
You may specify a Supplier Catalog Reference or a Supplier Contract Reference, but not both.   
This Supplier Contract already has a Catalog Load in progress.   
 
top
 

Financials_Business_Process_Parameters

part of: Submit_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_Data

part of: Submit_Catalog_Load_Request, Submit_Catalog_Load_Response
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  [0..1]  Supplier Catalog for Catalog Load   
Supplier_Contract_Reference  Supplier_ContractObject  [0..1]  Reference to an existing Supplier Contract   
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_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.   
Supplier Contract has multiple Supplier Catalogs. Please provide a Supplier Catalog instead for loading items.   
A Supplier Catalog is required to load items.   
You may specify a Supplier Catalog Reference or a Supplier Contract Reference, but not both.   
This Supplier Contract already has a Catalog Load in progress.   
top
 

Supplier_CatalogObject

part of: Submit_Catalog_Load_Response, Catalog_Load_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
 

Supplier_ContractObject

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

Supplier_ContractObjectID

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

part of: Submit_Catalog_Load_Response, Catalog_Load_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]  Internal Purchase Item for the Catalog Load 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_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_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_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_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
 

Unique_IdentifierObject

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

Supplier_CatalogReferenceEnumeration

part of: Supplier_CatalogObjectID
Base Type
string
top
 

Supplier_ContractReferenceEnumeration

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

Unique_IdentifierReferenceEnumeration

part of: Unique_IdentifierObjectID
Base Type
string
top