Service Directory > v32.1 > Financial_Management > Submit_Mass_Update_Ledger_Period_Status
 

Operation: Submit_Mass_Update_Ledger_Period_Status

This service operation updates the Ledger Period status for a Company and Company Hierarchy for a specific Fiscal Year, Fiscal Posting Interval, and Book Code combinations.


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

Root Element for the Submit Mass Update Ledger Period Status
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Mass_Update_Ledger_Period_Status_Data  Submit_Mass_Update_Ledger_Period_Status_Data  [0..1]  Element containing data necessary for submitting update ledger period status 
Validation Description
Enter a valid status for the period. Valid statuses are: [validStatuses].   
You cannot change the status of the ledger period for a closed ledger year. Open the ledger year before changing the status of the ledger periods.   
You can't enter a value for more than one of these fields: All Book Codes, Blank Book Code, Book Code.   
You must enter a value for one of these fields: All Book Codes, Blank Book Code, Book Code.   
The status for period [period] is Close in Progress. Closed Activity must be entered.   
You can only select Closed Activity when the status is Close in Progress.   
Ledger year and ledger periods are not created for one or more of the selected companies. You must create a ledger year and ledger periods for these companies before selecting the Fiscal Year and Fiscal Posting Interval.   
The fiscal schedule entered doesn't match the fiscal schedule of the company. Enter a different fiscal schedule before you change the status of the ledger period.   
 
top
 

Response Element: Submit_Mass_Update_Ledger_Period_Status_Response

Contains the response for the Submit Update Ledger Period Status web service.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Process_Details_Reference  Partitioned_Background_Process_RuntimeObject  [0..*]  The Update Ledger Period Status Background Process created by the web service.   
top
 

Submit_Mass_Update_Ledger_Period_Status_Data

part of: Submit_Mass_Update_Ledger_Period_Status_Request
Ledger Period Status Data for submitting Ledger Period Status update operation
 
Parameter name Type/Value Cardinality Description Validations
Company_or_Company_Hierarchy_Reference  OrganizationObject  [1..*]  Indicates Company or Company Hierarchy to process Update Ledger Period Status.   
Fiscal_Period_for_Update_Ledger_Period_Status_Reference  Fiscal_Period_for_Mass_Update_Ledger_Period_Status_Reference_Data  [1..1]  Indicates the Fiscal period for the Update Ledger Period Status web service. Derived from both Fiscal Year and Fiscal Posting Interval. 
Validation Description
The Fiscal Year and Fiscal Posting Interval must be for the same Fiscal Schedule.   
 
All_Book_Codes  boolean  [0..1]  Update all book codes. Select a value Y or N.   
Blank_Book_Code  boolean  [0..1]  Update blank book code only. Select a value Y or N.   
Book_Codes_Reference  Book_CodeObject  [0..*]  Book Codes to update. Select any book codes you want to update.   
Ledger_Period_Status_Reference  Ledger_Period_StatusObject  [1..1]  Indicates the value (Status) of the Ledger Period Status.   
Closed_Activity_Reference  Period_Close_Activity_Group__Tenanted_Object  [0..*]  Indicates the Period Close Activity Group for Close in Progress Period Status.   
Validation Description
Enter a valid status for the period. Valid statuses are: [validStatuses].   
You cannot change the status of the ledger period for a closed ledger year. Open the ledger year before changing the status of the ledger periods.   
You can't enter a value for more than one of these fields: All Book Codes, Blank Book Code, Book Code.   
You must enter a value for one of these fields: All Book Codes, Blank Book Code, Book Code.   
The status for period [period] is Close in Progress. Closed Activity must be entered.   
You can only select Closed Activity when the status is Close in Progress.   
Ledger year and ledger periods are not created for one or more of the selected companies. You must create a ledger year and ledger periods for these companies before selecting the Fiscal Year and Fiscal Posting Interval.   
The fiscal schedule entered doesn't match the fiscal schedule of the company. Enter a different fiscal schedule before you change the status of the ledger period.   
top
 

OrganizationObject

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

Fiscal_Period_for_Mass_Update_Ledger_Period_Status_Reference_Data

part of: Submit_Mass_Update_Ledger_Period_Status_Data
Indicates the Fiscal period for the Update Ledger Period Status web service. Derived from both Fiscal Year and Fiscal Posting Interval.
 
Parameter name Type/Value Cardinality Description Validations
Fiscal_Year_Reference  Fiscal_YearObject  [1..1]  Indicates the Fiscal Year.   
Fiscal_Posting_Interval_Reference  Fiscal_Posting_IntervalObject  [1..1]  Indicates the Fiscal Posting Interval.   
Validation Description
The Fiscal Year and Fiscal Posting Interval must be for the same Fiscal Schedule.   
top
 

Fiscal_YearObject

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

Fiscal_YearObjectID

part of: Fiscal_YearObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Fiscal_Year_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".   
@parent_id  string  [1..1]  Contains a unique identifier for an instance of a parent object   
@parent_type  WID, Fiscal_Schedule_ID  [1..1]  The unique identifier type of a parent object   
top
 

Fiscal_Posting_IntervalObject

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

Fiscal_Posting_IntervalObjectID

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

Book_CodeObject

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

Book_CodeObjectID

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

Ledger_Period_StatusObject

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

Ledger_Period_StatusObjectID

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

Period_Close_Activity_Group__Tenanted_Object

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

Period_Close_Activity_Group__Tenanted_ObjectID

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

Partitioned_Background_Process_RuntimeObject

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

Partitioned_Background_Process_RuntimeObjectID

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

OrganizationReferenceEnumeration

part of: OrganizationObjectID
Base Type
string
top
 

Fiscal_YearReferenceEnumeration

part of: Fiscal_YearObjectID
Base Type
string
top
 

Base Type
string

top
 

Fiscal_Posting_IntervalReferenceEnumeration

part of: Fiscal_Posting_IntervalObjectID
Base Type
string
top
 

Book_CodeReferenceEnumeration

part of: Book_CodeObjectID
Base Type
string
top
 

Ledger_Period_StatusReferenceEnumeration

part of: Ledger_Period_StatusObjectID
Base Type
string
top
 

Period_Close_Activity_Group__Tenanted_ReferenceEnumeration

part of: Period_Close_Activity_Group__Tenanted_ObjectID
Base Type
string
top
 

Partitioned_Background_Process_RuntimeReferenceEnumeration

part of: Partitioned_Background_Process_RuntimeObjectID
Base Type
string
top