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
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. 
Multiple Organizations are referenced by the same ID.  Multiple Organizations are referenced by the same ID. 
The organization type for an existing organization cannot be changed.  The organization type for an existing organization cannot be changed. 
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. 
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. 
Position management or job management can only be enabled for supervisory organizations.  Position management or job management can only be enabled for supervisory organizations. 
'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. 
Assigning this superior organization would create a circular reference.  Assign Superior Org Vaidation Help Text 
Organization Type is required for a top level organization.  Organization Type is required for a top level organization. 
The Staffing Model cannot be changed for this organization.   
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. 
Organization Visibility is required for a top level organization.  Organization Visibility is required for a top level organization. 
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. 
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. 
Superior/subordinate organization hierarchies are not allowed for this organization type.  Superior/subordinate organization hierarchies are allowed for only certain organization types. 
Primary Location is allowed only for supervisory organizations.  Primary Location is allowed only for supervisory organizations. 
Organization Subtype is not valid for Organization Type  Organization Subtype needs to be valid for Organization Type. 
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. 
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. 
Assigning this Container Organization would create a circular reference.  Assigning this Container Organization would create a circular reference. 
Either position management or job management must be enabled for supervisory organizations.  Either position management or job management must be enabled for supervisory organizations. 
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. 
 
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  OrganizationObject  [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  LocationObject  [0..1]  Primary location (for supervisory organizations) is effective dated.   
Container_Organization_Reference  OrganizationObject  [0..*]  Container Organization Reference   
Validation Description
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. 
Multiple Organizations are referenced by the same ID.  Multiple Organizations are referenced by the same ID. 
The organization type for an existing organization cannot be changed.  The organization type for an existing organization cannot be changed. 
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. 
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. 
Position management or job management can only be enabled for supervisory organizations.  Position management or job management can only be enabled for supervisory organizations. 
'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. 
Assigning this superior organization would create a circular reference.  Assign Superior Org Vaidation Help Text 
Organization Type is required for a top level organization.  Organization Type is required for a top level organization. 
The Staffing Model cannot be changed for this organization.   
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. 
Organization Visibility is required for a top level organization.  Organization Visibility is required for a top level organization. 
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. 
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. 
Superior/subordinate organization hierarchies are not allowed for this organization type.  Superior/subordinate organization hierarchies are allowed for only certain organization types. 
Primary Location is allowed only for supervisory organizations.  Primary Location is allowed only for supervisory organizations. 
Organization Subtype is not valid for Organization Type  Organization Subtype needs to be valid for Organization Type. 
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. 
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. 
Assigning this Container Organization would create a circular reference.  Assigning this Container Organization would create a circular reference. 
Either position management or job management must be enabled for supervisory organizations.  Either position management or job management must be enabled for supervisory organizations. 
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. 
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
 

OrganizationObject

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

OrganizationObjectID

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

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
 

LocationObject

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

Organization_Reference

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
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
 

OrganizationReferenceEnumeration

part of: OrganizationObjectID
Base Type
string
top
 

LocationReferenceEnumeration

part of: LocationObjectID
Base Type
string
top