Service Directory > v32.1 > Human_Resources > Add_Update_Organization
 

Operation: Add_Update_Organization

This operation adds a new Organization (or updates an existing Organization) with the supplied information. A new effective-dated organization name is automatically created if any attributes used for organization name are different as of specified effective date.


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

Utilize the following elements to add (or update, if already existing) a new Organization into the Workday system. A new effective-dated organization name is automatically created if any attributes used for organization name are different as of specified effective date.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Organization_Data  Organization_Data  [1..1]  Encapsulating element containing all Organization data. 
Validation Description
Assigning this superior organization would create a circular reference.  Assign Superior Org Vaidation Help Text 
Availability Date is required when creating a new Organization.  VLD DOC: Check Avail. Date. 
Organization Subtype is required when creating a new Organization.  Organization Subtype is required when creating a new Organization. 
Assigning this Container Organization would create a circular reference.  Assigning this Container Organization would create a circular reference. 
Multiple Organizations are referenced by the same ID.  Multiple Organizations are referenced by the same ID. 
Organization Subtype is not valid for Organization Type  Organization Subtype needs to be valid for Organization Type. 
Organization Type is required for a top level organization.  Organization Type is required for a top level organization. 
Organization Visibility is required for a top level organization.  Organization Visibility is required for a top level organization. 
The organization type for an existing organization cannot be changed.  The organization type for an existing organization cannot be changed. 
Superior/subordinate organization hierarchies are not allowed for this organization type.  Superior/subordinate organization hierarchies are allowed for only certain organization types. 
Include Manager/Leader in Name is not valid for an organization of this organization type.  Include Manager/Leader in Name is only valid for organizations of certain organization types. 
Either position management or job management must be enabled for supervisory organizations.  Either position management or job management must be enabled for supervisory organizations. 
Activating a hiring freeze is allowed only for supervisory organizations.  Activating a hiring freeze is allowed only for supervisory organizations. 
Primary Location is required for top level supervisory organizations.  Primary Location is required for top level supervisory organizations. 
Primary Location is allowed only for supervisory organizations.  Primary Location is allowed only for supervisory organizations. 
If specified, the organization type for a subordinate organization must match its top level organization.  If specified, the organization type for a subordinate organization must match its top level organization. 
If specified, the organization visibility for a subordinate organization must match its top level organization.  If specified, the organization visibility for a subordinate organization must match its top level organization. 
Position management or job management can only be enabled for supervisory organizations.  Position management or job management can only be enabled for supervisory organizations. 
The organization type does not match the organization type allowed for roll-up by the container organization.  The organization type does not match the organization type allowed for roll-up by the container organization. 
Organization Code is required If 'Include Organization Code in Name' is selected.  Organization Code is required If 'Include Organization Code in Name' is selected. 
Enter an Organization Name or use the Organization Code as the name by entering an Organization Code and selecting the 'Include Organization Code in Name' checkbox.  Enter an Organization Name or use the Organization Code as the name by entering an Organization Code and selecting the 'Include Organization Code in Name' checkbox. 
Enter an Organization Name or select the 'Include Manager/Leader in Name' checkbox or use the Organization Code as the name by entering an Organization Code and selecting the 'Include Organization Code in Name' checkbox.  Enter an Organization Name or select the 'Include Manager/Leader in Name' checkbox or use the Organization Code as the name by entering an Organization Code and selecting the 'Include Organization Code in Name' checkbox. 
Organization Subtype does not match the Hierarchy Structure defined on top level organization.  Organization Subtype needs to be valid for the Hierarchy Structure on top level organization. 
'Include Organization ID in Name' can only be set to true for supervisory organizations.  'Include Organization ID in Name' can only be set to true for supervisory organizations. 
A superior that is inactive now or will be inactive in future cannot be assigned to an active subordinate organization.  A superior that is inactive now or will be inactive in future cannot be assigned to an active subordinate organization. 
An organization that is inactive now or will be inactive in future cannot include an active organization.  An organization that is inactive now or will be inactive in future cannot include an active organization. 
The Staffing Model cannot be changed for this organization.   
 
top
 

Response Element: Organization_Reference

 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Integration_ID_Reference  External_Integration_ID_Reference_Data  [1..1]  Integration ID reference is used as a unique identifier for integratable objects in the Workday system.   
Validation Description
Organization Reference Integration ID does not exist!  A valid instance of Organization must exist for the given Integration ID Reference. 
Organization Reference references an Inactive Organization.  A valid instance of Organization also infers that the Organization is in an Active status. 
top
 

Organization_Data

part of: Organization_Add_Update
Encapsulating element containing all Organization data.
 
Parameter name Type/Value Cardinality Description Validations
@Effective_Date  date  [1..1]  Effective Date. A new effective-dated organization name is automatically created if any attributes used for organization name are different as of specified effective date which include: Organization Name, Organization Code, and Include 'xx' in Name booleans.   
Organization_Reference_ID  string  [0..1]  Organization Reference ID. To ensure backward compatibility, the Organization Reference ID element will not be populated on outbound data (i.e. Get Organization web service) for Workday 9 and earlier versions. It will be populated with on outbound data starting with Workday 10.   
Include_Organization_ID_in_Name  boolean  [0..1]  Boolean attribute identifying whether to include the Organization ID within the name (Display ID within Workday). A new effective-dated organization name is automatically created if value for this field is different as of specified effective date.   
Integration_ID_Data  External_Integration_ID_Data  [0..1]  Integration ID Data   
Organization_Name  string  [0..1]  Text attribute identifying Organization Name. A new effective-dated organization name is automatically created if value for this field is different as of specified effective date.   
Availability_Date  date  [0..1]  Date the Organization is available for staffing events.   
Include_Organization_Code_In_Name  boolean  [0..1]  Boolean attribute identifying whether to include the Organization Code within the name (Display ID within Workday). A new effective-dated organization name is automatically created if value for this field is different as of specified effective date.   
Organization_Code  string  [0..1]  Text attribute identifying Organization Code. A new effective-dated organization name is automatically created if value for this field is different as of specified effective date.   
Include_Leader_In_Name  boolean  [0..1]  Boolean attribute identifying whether to include the Manager/Leader Name within the name (Display ID in Workday). A new effective-dated organization name is automatically created if value for this field is different as of specified effective date.   
Frozen_Status  boolean  [0..1]  Element containing boolean attribute identifying whether a Hiring Freeze is currently in affect.   
Job_Management_Enabled  boolean  [0..1]  Boolean element identifying whether Job Management is enabled.   
Position_Management_Enabled  boolean  [0..1]  Element containing boolean attribute identifying whether Position Management is enabled.   
Superior_Organization_Reference  Superior_Organization_Reference_Data  [0..1]  Superior Organization Reference   
Organization_Type_Reference  Organization_Type_Reference_Data  [0..1]  Organization Type Reference   
Organization_Subtype_Reference  Organization_Subtype_Reference_Data  [0..1]  Organization Subtype Reference   
Organization_Visibility_Reference  Organization_Visibility_Reference_Data  [0..1]  Organization Visibility Reference   
Primary_Business_Site_Reference  Primary_Business_Site_Reference_Data  [0..1]  Primary location (for supervisory organizations) is effective dated.   
Container_Organization_Reference  Container_Organization_Reference_Data  [0..*]  Container Organization Reference 
Validation Description
Container Organization Reference does not allow Locations.  This container organization is configured to not allow locations to be included in it. 
 
Validation Description
Assigning this superior organization would create a circular reference.  Assign Superior Org Vaidation Help Text 
Availability Date is required when creating a new Organization.  VLD DOC: Check Avail. Date. 
Organization Subtype is required when creating a new Organization.  Organization Subtype is required when creating a new Organization. 
Assigning this Container Organization would create a circular reference.  Assigning this Container Organization would create a circular reference. 
Multiple Organizations are referenced by the same ID.  Multiple Organizations are referenced by the same ID. 
Organization Subtype is not valid for Organization Type  Organization Subtype needs to be valid for Organization Type. 
Organization Type is required for a top level organization.  Organization Type is required for a top level organization. 
Organization Visibility is required for a top level organization.  Organization Visibility is required for a top level organization. 
The organization type for an existing organization cannot be changed.  The organization type for an existing organization cannot be changed. 
Superior/subordinate organization hierarchies are not allowed for this organization type.  Superior/subordinate organization hierarchies are allowed for only certain organization types. 
Include Manager/Leader in Name is not valid for an organization of this organization type.  Include Manager/Leader in Name is only valid for organizations of certain organization types. 
Either position management or job management must be enabled for supervisory organizations.  Either position management or job management must be enabled for supervisory organizations. 
Activating a hiring freeze is allowed only for supervisory organizations.  Activating a hiring freeze is allowed only for supervisory organizations. 
Primary Location is required for top level supervisory organizations.  Primary Location is required for top level supervisory organizations. 
Primary Location is allowed only for supervisory organizations.  Primary Location is allowed only for supervisory organizations. 
If specified, the organization type for a subordinate organization must match its top level organization.  If specified, the organization type for a subordinate organization must match its top level organization. 
If specified, the organization visibility for a subordinate organization must match its top level organization.  If specified, the organization visibility for a subordinate organization must match its top level organization. 
Position management or job management can only be enabled for supervisory organizations.  Position management or job management can only be enabled for supervisory organizations. 
The organization type does not match the organization type allowed for roll-up by the container organization.  The organization type does not match the organization type allowed for roll-up by the container organization. 
Organization Code is required If 'Include Organization Code in Name' is selected.  Organization Code is required If 'Include Organization Code in Name' is selected. 
Enter an Organization Name or use the Organization Code as the name by entering an Organization Code and selecting the 'Include Organization Code in Name' checkbox.  Enter an Organization Name or use the Organization Code as the name by entering an Organization Code and selecting the 'Include Organization Code in Name' checkbox. 
Enter an Organization Name or select the 'Include Manager/Leader in Name' checkbox or use the Organization Code as the name by entering an Organization Code and selecting the 'Include Organization Code in Name' checkbox.  Enter an Organization Name or select the 'Include Manager/Leader in Name' checkbox or use the Organization Code as the name by entering an Organization Code and selecting the 'Include Organization Code in Name' checkbox. 
Organization Subtype does not match the Hierarchy Structure defined on top level organization.  Organization Subtype needs to be valid for the Hierarchy Structure on top level organization. 
'Include Organization ID in Name' can only be set to true for supervisory organizations.  'Include Organization ID in Name' can only be set to true for supervisory organizations. 
A superior that is inactive now or will be inactive in future cannot be assigned to an active subordinate organization.  A superior that is inactive now or will be inactive in future cannot be assigned to an active subordinate organization. 
An organization that is inactive now or will be inactive in future cannot include an active organization.  An organization that is inactive now or will be inactive in future cannot include an active organization. 
The Staffing Model cannot be changed for this organization.   
top
 

External_Integration_ID_Data

part of: Organization_Data
Integration ID Help Text
 
Parameter name Type/Value Cardinality Description Validations
ID  ID  [1..*]  External ID that uniquely identifies the integratable object within the context of the integration system identified by the System ID attribute.   
top
 

ID

part of: External_Integration_ID_Reference_Data, External_Integration_ID_Data
External ID that uniquely identifies the integratable object within the context of the integration system identified by the System ID attribute.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@System_ID  string  [1..1]  Integration system identifier, part of a two part key (including the text value of the ID element) that uniquely identify integratable object. 
Validation Description
Integration System ID does not exist.  A valid instance of Integration ID must exist for the given System ID. 
 
top
 

Superior_Organization_Reference_Data

part of: Organization_Data
Reference element representing a unique instance of Organization.
 
Parameter name Type/Value Cardinality Description Validations
Organization_Reference  Organization_Reference  [1..1]  Reference element representing a unique instance of Organization. 
Validation Description
Organization Reference Integration ID does not exist!  A valid instance of Organization must exist for the given Integration ID Reference. 
Organization Reference references an Inactive Organization.  A valid instance of Organization also infers that the Organization is in an Active status. 
 
top
 

Organization_Reference

part of: Superior_Organization_Reference_Data, Container_Organization_Reference_Data
Reference element representing a unique instance of Organization.
 
Parameter name Type/Value Cardinality Description Validations
Integration_ID_Reference  External_Integration_ID_Reference_Data  [1..1]  Integration ID reference is used as a unique identifier for integratable objects in the Workday system.   
Validation Description
Organization Reference Integration ID does not exist!  A valid instance of Organization must exist for the given Integration ID Reference. 
Organization Reference references an Inactive Organization.  A valid instance of Organization also infers that the Organization is in an Active status. 
top
 

External_Integration_ID_Reference_Data

part of: Organization_Reference, Business_Site_Reference_Data
Integration ID reference is used as a unique identifier for integratable objects in the Workday system.
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display name inside the Workday system.   
ID  ID  [1..1]  External ID that uniquely identifies the integratable object within the context of the integration system identified by the System ID attribute.   
top
 

Organization_Type_Reference_Data

part of: Organization_Data
Reference element representing a unique instance of Organization Type.
 
Parameter name Type/Value Cardinality Description Validations
Organization_Type_Name  string  [1..1]  Unique attribute name/description identifying a valid instance of Organization Type. 
Validation Description
Organization Type Name does not exist.   
 
top
 

Organization_Subtype_Reference_Data

part of: Organization_Data
Reference element representing a unique instance of Organization Subtype.
 
Parameter name Type/Value Cardinality Description Validations
Organization_Subtype_Name  string  [1..1]  Unique attribute name/description identifying a valid instance of Organization Subtype. 
Validation Description
Organization Subtype Name does not exist  A valid instance of Organization Subtype must exist for the given value of Organization Subtype Name. 
 
top
 

Organization_Visibility_Reference_Data

part of: Organization_Data
Reference element representing a unique instance of Organization Visibility.
 
Parameter name Type/Value Cardinality Description Validations
Organization_Visibility_Name  string  [1..1]  Unique attribute name/description identifying a valid instance of Organization Visibility. 
Validation Description
Organization Visibility Name does not exist.  A valid instance of Organization Visibility must exist for the given value of Organization Visibility Name. 
 
top
 

Primary_Business_Site_Reference_Data

part of: Organization_Data
Reference element representing a unique instance of Location.
 
Parameter name Type/Value Cardinality Description Validations
Business_Site_Reference  Business_Site_Reference_Data  [1..1]  Reference element representing a unique instance of Location. 
Validation Description
Location Reference does not exist.  A valid instance of Location must exist for the given Integration ID Reference. 
 
top
 

Business_Site_Reference_Data

part of: Primary_Business_Site_Reference_Data
Reference element representing a unique instance of Location.
 
Parameter name Type/Value Cardinality Description Validations
Integration_ID_Reference  External_Integration_ID_Reference_Data  [1..1]  Integration ID reference is used as a unique identifier for integratable objects in the Workday system.   
Validation Description
Location Reference does not exist.  A valid instance of Location must exist for the given Integration ID Reference. 
top
 

Container_Organization_Reference_Data

part of: Organization_Data
Reference element representing a unique instance of Organization that contains or includes other Organizations. An organization can be included in multiple hierarchies, but it can only be included in one node in each top level hierarchy for any given effective date.
 
Parameter name Type/Value Cardinality Description Validations
Organization_Reference  Organization_Reference  [1..1]  Reference element representing a unique instance of Organization. 
Validation Description
Organization Reference Integration ID does not exist!  A valid instance of Organization must exist for the given Integration ID Reference. 
Organization Reference references an Inactive Organization.  A valid instance of Organization also infers that the Organization is in an Active status. 
 
Validation Description
Container Organization Reference does not allow Locations.  This container organization is configured to not allow locations to be included in it. 
top