ExpenseReports
Contains header-level details for expense reports, such as total cost, status, and submission date for auditing and payment tracking.
Table-Specific Information
Select
The connector uses the Oracle Fusion Cloud Financials API to process some of the filters having 'queryable'='true' in metadata. The connector processes other filters within the connector.
For example, the following query is processed server-side:
SELECT * FROM ExpenseReports WHERE ExpenseReportId = 10003
Insert
Create an expense report record.
INSERT INTO ExpenseReports (ReimbursementCurrencyCode) VALUES ('USD')
If you want to add child views/tables along with the parent table, you can add the child in one of the following ways.
-
Using the TEMP table:
INSERT INTO ExpenseReportsExpense#TEMP (Location,ReceiptTime,StartDate,NumberPeople,PassengerAmount,ReceiptRequiredFlag) VALUES ('India','2024-10-10 23:12:15','2024-02-05',25,25.35,true) INSERT INTO ExpenseReports (ReimbursementCurrencyCode,expense) VALUES ('USD','ExpenseReportsExpense#TEMP') -
Directly providing the aggregate:
INSERT INTO ExpenseReports (ReimbursementCurrencyCode,expense) VALUES ('USD','[ { "Location": "India", "NumberPeople": 25, "PassengerAmount": 25.35, "ReceiptRequiredFlag": true, "StartDate": "2024-02-05", "ReceiptTime": "2024-10-10T23:12:15.000-04:00" } ]')
Update
Update an expense report record for a specific expense report identifier.
The Oracle Fusion Cloud Financials API uses ExpenseReportUniqId instead of ExpenseReportId as a path parameter in the URL to update the expense report.
If you want to update a record directly using the Id (without any other filter), you can update the record in the following way:
UPDATE ExpenseReports SET ReimbursementCurrencyCode='EUR' WHERE ExpenseReportUniqId=12457
Note: This does not require an extra GET request to retrieve the UniqId.
Alternatively, if you want to apply any other filter, use ExpenseReportId instead of ExpenseReportUniqId. You can update the record in the following way:
UPDATE ExpenseReports SET ReimbursementCurrencyCode='EUR' WHERE ExpenseReportId=12457 AND PersonId=45442
Note: Updates on aggregates are not allowed by the API. Use the child tables to add/update/delete aggregates.
Columns
| Name | Type | ReadOnly | Description |
| AssignmentId | Long | False |
Unique identifier for the assignment related to the expense report, typically assigned to a person responsible for submitting or reviewing the report. |
| AuditCode | String | False |
Code that categorizes the type of audit applied to the expense report, such as audits based on original receipts or image-based receipts. |
| AuditReturnReasonCode | String | False |
Describes the reason for returning the expense report to the individual, usually due to missing or incorrect documentation during the audit process. |
| BothpayFlag | Bool | False |
Indicates whether the expense report includes corporate card transactions where the payment liability is split between both the company and the individual. |
| CurrentApproverId | Long | False |
Identifier for the individual who is currently responsible for approving the expense report. |
| ExchangeRateType | String | False |
Type of exchange rate used to calculate the reimbursable amounts for foreign currency expenses. |
| ExpenseReportDate | Date | False |
The date the expense report was saved or submitted, typically representing the end of the reporting period. |
| ExpenseReportId [KEY] | Long | False |
A unique identifier for the expense report, used for referencing and operations like updates and deletions. |
| ExpenseReportUniqId [KEY] | String | True |
A unique identifier for the expense report used during insert, update, and delete operations, ensuring proper tracking across systems. |
| ExpenseReportNumber | String | False |
A unique reference number for the expense report that adheres to company-specific numbering conventions. |
| ExpenseReportTotal | Decimal | False |
The total amount of the expense report, calculated in the reimbursement currency. Also includes the total in the approver’s preferred currency if applicable. |
| ExpenseStatusCode | String | False |
Current approval status of the expense report, such as Approved, Pending Manager Approval, or Paid. |
| ExpenseStatusDate | Date | False |
The date when the expense report transitioned to its current approval status. |
| FinalApprovalDate | Date | False |
The date on which the expense report received final approval from all necessary approvers. |
| ImagedReceiptsReceivedDate | Date | False |
The date when receipts for the expense report, in the form of images, were received and processed. |
| ImagedReceiptsStatusCode | String | False |
Status code representing the current state of imaged receipts for the expense report, such as 'Required', 'Missing', or 'Received'. |
| MissingImagesReason | String | False |
Explanation for why imaged receipts are not included with the expense report, potentially due to issues like receipt clarity or submission delays. |
| OrgId | Long | False |
Unique identifier for the business unit or department to which the expense report belongs. |
| OverrideApproverId | Long | False |
Identifier for the initial approver selected by the individual submitting the expense report, prior to any reassignments. |
| ParentExpenseReportId | Long | False |
Identifier of the parent expense report, if the current report is a revision or related to another earlier report. |
| PaymentMethodCode | String | False |
Code representing the method of payment used for the expenses on this report, such as 'check', 'cash', or 'credit card'. |
| PersonId | Long | False |
Unique identifier for the individual who owns the expense report, often tied to their employee or user account. |
| PreparerId | Long | False |
Identifier for the person who created the expense report, typically the individual submitting the expenses for review and approval. |
| Purpose | String | False |
Description of the business purpose or activities that justify the expenses submitted in the report. |
| ReceiptsFilingNumber | String | False |
A unique filing number for receipts, manually entered by the auditor to track and verify receipts submitted with the report. |
| ReceiptsReceivedDate | Date | False |
The date on which receipts for the expense report were physically received or digitally submitted for auditing. |
| ReceiptsStatusCode | String | False |
Status of the receipts for the expense report, indicating whether receipts are 'Missing', 'Required', or 'Received'. |
| ReimbursementCurrencyCode | String | False |
Currency code representing the currency used for reimbursing the individual for expenses incurred. |
| ReportCreationMethodCode | String | False |
Indicates how the expense report was created, for example, via a mobile app on iOS or Android. |
| ReportSubmitDate | Date | False |
The date the expense report was formally submitted for review and approval. |
| TripId | Long | False |
Identifier for the business trip associated with the expense report, which helps link the report to travel-related costs. |
| UnappliedAdvancesJust | String | False |
Explanation for why an outstanding cash advance has not been applied against the current expense report. |
| UnappliedCashAdvReason | String | False |
Reason why an outstanding cash advance has not been deducted from the current expense report's total amount. |
| CreatedBy | String | True |
Indicates the user who created the expense report or row in the system, typically a person responsible for data entry. |
| CreationDate | Datetime | True |
Timestamp indicating when the expense report or row was initially created in the system. |
| LastUpdateDate | Datetime | True |
Timestamp showing the last time the expense report or row was modified, reflecting any updates or changes. |
| LastUpdateLogin | String | True |
Login session identifier associated with the user who last updated the record. |
| LastUpdatedBy | String | True |
Name or identifier of the user who made the most recent update to the expense report or row. |
| BusinessUnit | String | False |
Indicates the specific business unit or department within the organization associated with the expense report. |
| SubmitReport | String | False |
Indicates whether the expense report is ready to be submitted for review, often depending on the completion of required fields and validations. |
| MatchExpenses | String | False |
Indicates whether corporate card transactions can be matched to corresponding expenses in the report to ensure accurate reimbursement. |
| SubmitErrors | String | False |
Lists any errors or issues that occurred during the submission process, such as missing required fields or incorrect data. |
| PersonName | String | True |
Name of the individual for whom the expense report was created, typically matching their employee or user account information. |
| OriginalReceiptsStatus | String | True |
The status of the original receipts required for the expense report, indicating whether they are 'Required', 'Missing', or 'Received'. |
| ImagedReceiptsStatus | String | True |
The status of the imaged receipts required for the expense report, indicating whether they are 'Required', 'Missing', or 'Received'. |
| ExpenseReportStatus | String | True |
Overall status of the expense report, which could be 'Draft', 'Submitted', 'Approved', 'Paid', or other relevant stages. |
| AuditCodeName | String | True |
Lookup value describing the meaning of the Audit Code, providing clarity on the type of audit applied. |
| CurrentApprovers | String | True |
List of individuals who are currently waiting for approval or are responsible for approving the expense report. |
| Expense | String | False |
This field is reserved for insert operations only; for updates or deletions, appropriate child table operations should be used. |
| ExpenseReportDff | String | False |
This field is reserved for insert operations only; for updates or deletions, appropriate child table operations should be used. |
| processingDetails | String | False |
This field is reserved for insert operations only; for updates or deletions, appropriate child table operations should be used. |
| ExpensePayment | String | False |
This field is reserved for insert operations only; for updates or deletions, appropriate child table operations should be used. |
| expenseNotes | String | False |
This field is reserved for insert operations only; for updates or deletions, appropriate child table operations should be used. |
| Finder | String | True |
This column is used as a generic reference, possibly tied to specific search operations or queries. |
| SysEffectiveDate | String | True |
Date associated with the system’s effective date for data operations, possibly used to ensure accurate historical data retrieval. |
| EffectiveDate | Date | True |
Query parameter that helps fetch records which are effective as of the specified start date. |