Power BI Connector for Oracle Fusion Cloud Financials

Build 25.0.9454

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.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9454