Expense Item and Expense Report (Deprecated)

Logical Business Objects

Financials : Expenses : Expense
Financials : Expenses : Expense

Relationships

The following table describes how this service data object is related to other service data objects or business object services.

Relationship Type	Object or Service
Handles	Expense Descriptive Flexfield SDO
Handles	Expense Company Allocation SDO
Handles	Project Expense Allocation SDO
Handles	Expense Report
Handles	Expense Item
Handles	Expense Report Descriptive Flexfield SDO
Handles	Expense Cost Center Allocation SDO
Handles	Expense Distribution

Operations

submitExpenseReport
getExpense
createExpense
updateExpense
deleteExpense
mergeExpense
findExpense
processExpense
processCSExpense
getExpenseReport
createExpenseReport
updateExpenseReport
deleteExpenseReport
mergeExpenseReport
findExpenseReport
processExpenseReport
processCSExpenseReport

submitExpenseReport

WARNING: Superseded by REST resource /fscmRestApi/resources/latest/expenseReports/{expenseReportsUniqID} POST method. An operation that enables you to submit an expense report that was previously created and is in saved status.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expenseReportNumber	string	A parameter that specifies the report number of the expense report that has to be submitted

Response Payload

Element Name	Type	Description
result	string	A parameter that returns the status of report submission

getExpense

An operation that retrieves a specific expense item.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expenseId	long	A parameter that specifies the identifier for the expense item to be retrieved.

Response Payload

Element Name	Type	Description
result	Expense Item	A parameter that returns the expense item that matches the expense item identifier.

createExpense

An operation that creates an expense item.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expense	Expense Item	A parameter that specifies the details for the new expense item to be created.

Response Payload

Element Name	Type	Description
result	Expense Item	A parameter that returns the newly created expense item.

updateExpense

An operation that updates an expense item.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expense	Expense Item	A parameter that returns the updated expense item.

Response Payload

Element Name	Type	Description
result	Expense Item	A parameter that specifies the expense item selected for update.

deleteExpense

An operation that deletes an expense item.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expense	Expense Item	A parameter that specifies the expense item to be deleted.

Response Payload

Element Name	Type	Description
result	void	A parameter that returns the processed expense item.

mergeExpense

An operation that matches an expense item and creates a new one if a match does not exist, or updates an expense item if a match does exist.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expense	Expense Item	A parameter that specifies the expense item to be merged.

Response Payload

Element Name	Type	Description
result	Expense Item	A parameter that returns the processed expense item.

findExpense

An operation that searches for expense items using specified criteria.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
findCriteria	{http://xmlns.oracle.com/adf/svc/types/}FindCriteria	A parameter that specifies the search criteria for expense items and the maximum records returned at a time.
findControl	{http://xmlns.oracle.com/adf/svc/types/}FindControl	A parameter that controls the search for expense items. Not currently used.

Response Payload

Element Name	Type	Description
result	Expense Item	A parameter that returns the list of expense items that satisfy the search criteria.

processExpense

An operation that processes expense items in bulk.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
changeOperation	string	A parameter that specifies the action to be performed on expense items, such as create, update, merge, or delete.
expense	Expense Item	A parameter that specifies the list of expense items to be processed.
processControl	{http://xmlns.oracle.com/adf/svc/types/}ProcessControl	A parameter that controls the bulk processing of expense items, such as whether to commit valid data if invalid data is present in the batch and whether to return the key attributes or the complete set of attributes. Not currently used.

Response Payload

Element Name	Type	Description
result	Expense Item	A parameter that returns the list of processed expense items.

processCSExpense

An operation that sends processed expense items in bulk to another data source.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
processData	{http://xmlns.oracle.com/adf/svc/types/}ProcessData	A parameter that specifies the object, which represents the changes to expense items.
processControl	{http://xmlns.oracle.com/adf/svc/types/}ProcessControl	A parameter that controls the bulk processing of expense items, such as whether to commit valid data if invalid data is present in the batch and whether to return the key attributes or the complete set of attributes. Not currently used.

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/adf/svc/types/}ProcessData	A parameter that returns the list of processed expense items with associated warnings and informational messages when applicable.

getExpenseReport

An operation that retrieves a specific expense report.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expenseReportId	long	A parameter that specifies the identifier for the expense report to be retrieved.

Response Payload

Element Name	Type	Description
result	Expense Report	A parameter that returns the expense report that matches the expense report identifier.

createExpenseReport

An operation that creates an expense report.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expenseReport	Expense Report	A parameter that specifies the details for the new expense report to be created.

Response Payload

Element Name	Type	Description
result	Expense Report	A parameter that returns the newly created expense report.

updateExpenseReport

An operation that updates an expense report.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expenseReport	Expense Report	A parameter that specifies the expense report selected for update.

Response Payload

Element Name	Type	Description
result	Expense Report	A parameter that returns the updated expense report.

deleteExpenseReport

An operation that deletes an expense report.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expenseReport	Expense Report	A parameter that specifies the expense report to be deleted.

Response Payload

Element Name	Type	Description
result	void	A parameter that returns the processed expense report.

mergeExpenseReport

An operation that merges an expense report, which creates an expense report if it does not exist and updates the expense report if it does exist.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
expenseReport	Expense Report	A parameter that specifies the expense report to be merged.

Response Payload

Element Name	Type	Description
result	Expense Report	A parameter that returns the processed expense report.

findExpenseReport

An operation that searches for expense reports using specified criteria.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
findCriteria	{http://xmlns.oracle.com/adf/svc/types/}FindCriteria	A parameter that specifies the search criteria for expense reports and the maximum records that can be returned at a time.
findControl	{http://xmlns.oracle.com/adf/svc/types/}FindControl	A parameter that controls the search for expense reports. Not currently used.

Response Payload

Element Name	Type	Description
result	Expense Report	A parameter that returns the list of expense reports that satisfy the search criteria.

processExpenseReport

An operation that processes expense reports in bulk.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
changeOperation	string	A parameter that specifies the action to be performed on expense reports, such as create, update, merge, or delete.
expenseReport	Expense Report	A parameter that specifies the list of expense reports to be processed.
processControl	{http://xmlns.oracle.com/adf/svc/types/}ProcessControl	A parameter that controls the bulk processing of expense reports, such as whether to commit valid data if invalid data is present in the batch and whether to return the key attributes or the complete set of attributes. Not currently used.

Response Payload

Element Name	Type	Description
result	Expense Report	A parameter that returns the list of processed expense reports.

processCSExpenseReport

An operation that sends processed expense reports in bulk to another data source.

Life Cycle Status: Deprecated

Request Payload

Element Name	Type	Description
processData	{http://xmlns.oracle.com/adf/svc/types/}ProcessData	A parameter that specifies the object, which represents the changes to expense reports.
processControl	{http://xmlns.oracle.com/adf/svc/types/}ProcessControl	A parameter that controls the bulk processing of expense reports, such as whether to commit valid data if invalid data is present in the batch and whether to return the key attributes or the complete set of attributes. Not currently used.

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/adf/svc/types/}ProcessData	A parameter that returns the list of processed expense reports with associated warnings and informational messages when applicable.

Security

The following tables list the privileges required to perform the service operations, and the duty roles that each privilege is granted to.

Service Operations to Privileges Mapping

Operation Name	Privilege Code	Privilege Name	Privilege Description
All Operations	EXM_MANAGE_EXPENSE_REPORT_PRIV	Manage Expense Report	Allows creation of expense items and expense reports. Allows updating expense items and managing submitted expense reports. Allows tracking of expense reports, expense items, and payments.

Privileges to Duty Roles Mapping

Privilege Code	Granted to Duty Role Code	Granted to Duty Role Name	Granted To Duty Role Description
EXM_MANAGE_EXPENSE_REPORT_PRIV	ORA_EXM_EXPENSE_ENTRY_DUTY	Expense Entry	Creates and updates expense items and expense reports.

Duty Roles to Duty or Job Roles Mapping

Duty Role Code	Granted to Duty or Job Role Code	Granted to Duty or Job Role Name	Granted To Duty or Job Role Description
ORA_EXM_EXPENSE_ENTRY_DUTY	ORA_IBY_EMPLOYEE_BANK_ACCOUNT_MANAGEMENT_DUTY	Employee Bank Account Management	Manages employee bank accounts and other payment details.
ORA_EXM_EXPENSE_ENTRY_DUTY	ORA_FUN_FIN_AI_AGENT_RUNTIME_DUTY	Financials Intelligent Agent Runtime	Allows end users to access intelligent agents within the Financials product family.
ORA_EXM_EXPENSE_ENTRY_DUTY	ORA_XCC_TRANSACTIONAL_DUTY	Transaction Entry with Budgetary Control	Manages the budgetary control tasks by job roles who perform transactions that are subject to budgetary control, such as accounts payable manager.