Excel Add-In for Oracle Fusion Cloud Financials

Build 24.0.9175

Invoices

Manages key supplier invoice data, including header, lines, distributions, installments, and descriptive flexfields for payables processing.

Table Specific Information

Select

The 本製品 uses the Oracle Fusion Cloud Financials API to process some of the filters having queryable=true in metadata. The 本製品 processes other filters within the 本製品.

For example, the following query is processed server side:

SELECT * FROM [Cdata].[Financials].[Invoices] WHERE InvoiceId = 10003

Insert

Create an invoice.

INSERT INTO [Cdata].[Financials].[Invoices] (InvoiceNumber,InvoiceCurrency,InvoiceAmount,InvoiceDate,BusinessUnit,Supplier,SupplierSite,Requester,InvoiceGroup,Description) VALUES ('AND_Unmatched_Invoice','USD',2212.75,'2019-02-01','Vision Operations','Advanced Network Devices','FRESNO','Johnson,Mary','01Feb2019','Office Supplies')

If you want to add child views/tables along with the parent table, you can add the child in following ways:

  • Using TEMP table:

    INSERT into InvoicesinvoiceLinesinvoiceDistributions#TEMP(DistributionLineNumber,DistributionCombination,DistributionAmount,DistributionLineType,CUReferenceNumber) values (26,'101.10.60230.462.000.000',3.25,'Item',1)
    INSERT into InvoicesinvoiceLinesinvoiceDistributions#TEMP(DistributionLineNumber,DistributionCombination,DistributionAmount,DistributionLineType,CUReferenceNumber) values (27,'101.10.60230.462.000.000',83.25,'Item',2)
    INSERT into InvoicesinvoiceLines#TEMP(invoiceDistributions,LineNumber,DistributionCombination,LineAmount,CUReferenceNumber) values ('InvoicesinvoiceLinesinvoiceDistributions#TEMP',46,'101.10.60230.462',3.25,1)
    INSERT into InvoicesinvoiceLines#TEMP(invoiceDistributions,LineNumber,DistributionCombination,LineAmount,CUReferenceNumber) values ('InvoicesinvoiceLinesinvoiceDistributions#TEMP',47,'101.10.60230.462',36.25,2)
    INSERT INTO [Cdata].[Financials].[Invoices] (InvoiceNumber,InvoiceCurrency,InvoiceAmount,InvoiceDate,BusinessUnit,Supplier,SupplierSite,Requester,InvoiceGroup,Description,invoiceLines) VALUES ('AND_Unmatched_Invoice','USD',2212.75,'2019-02-01','Vision Operations','Advanced Network Devices','FRESNO','Johnson,Mary','01Feb2019','Office Supplies','InvoicesinvoiceLines#TEMP')

    Note : you can use CUReferenceNumber to map the child views/tables to their parent. For example, invoiceLines having CUReferenceNumber 1, will have the child aggregates having CUReferenceNumber 1.

  • Directly providing the aggregate:

    INSERT INTO [Cdata].[Financials].[Invoices] (InvoiceNumber,InvoiceCurrency,InvoiceAmount,InvoiceDate,BusinessUnit,Supplier,SupplierSite,Requester,InvoiceGroup,Description,invoiceLines) VALUES ('AND_Unmatched_Invoice','USD',2212.75,'2019-02-01','Vision Operations','Advanced Network Devices','FRESNO','Johnson,Mary','01Feb2019','Office Supplies','[
      {
        "LineNumber": 3,
        "LineAmount": 54.25,
        "DistributionCombination": "101.10.60230.462"
      }
    ]')

Update

The Oracle Fusion Cloud Financials API uses InvoiceUniqId instead of InvoiceId as a path parameter in the URL to update the record.

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 [Cdata].[Financials].[Invoices] set Description='abcd' where InvoiceUniqId=454545454;

Note: This does not require any extra GET request to retrieve the UniqId.

Alternatively, if you want to apply any other filter. Please use InvoiceId instead of InvoiceUniqId. You can update the record in the following way:

Update [Cdata].[Financials].[Invoices] set Description='abcd' where InvoiceId=454545454 and Supplier='abc';

Note : Update on aggregates are not allowed by API, use the child tables to add/update/delete aggregates.

Delete

The Oracle Fusion Cloud Financials API uses InvoiceUniqId instead of InvoiceId as a path parameter in the URL to delete the record.

If you want to delete a record directly using the id (without any other filter), you can delete the record in the following way:

Delete from [Cdata].[Financials].[Invoices] where InvoiceUniqId=454545454;

Note: This does not require any extra GET request to retrieve the UniqId.

Alternatively, if you want to apply any other filter. Please use InvoiceId instead of InvoiceUniqId. You can delete the record in the following way:

Delete from [Cdata].[Financials].[Invoices] where InvoiceUniqId=454545454 and Supplier='abc';

Columns

Name Type ReadOnly Description
InvoiceId [KEY] Long True

Unique identifier for the invoice, used for tracking and managing invoices in the system.

InvoiceUniqId [KEY] String True

Alternative unique identifier for the invoice, used for insert, update, and delete operations to manage invoice records.

InvoiceNumber String False

The unique number assigned to the supplier invoice, used for referencing and identifying the invoice.

InvoiceCurrency String False

Currency code used on the invoice, which can be manually specified or defaulted from the Supplier Site or invoicing business unit.

PaymentCurrency String False

Currency used to make a payment for the invoice, specified during invoice creation or defaulted from the Supplier Site or business unit settings.

InvoiceAmount Decimal False

The total amount of the invoice in the transaction currency, specified when creating the invoice.

InvoiceDate Date False

The date on the supplier invoice, which can be set during creation or defaulted to the system date.

BusinessUnit String False

The name of the business unit for the invoice, set during creation and cannot be changed after the invoice is created.

Supplier String False

The name of the supplier associated with the invoice, provided during invoice creation and cannot be changed afterward.

SupplierNumber String True

Unique identifier for the supplier associated with the invoice.

ProcurementBU String False

Procurement business unit linked to the supplier site for identifying the correct supplier site in the invoice.

SupplierSite String False

The physical location of the supplier where goods and services are delivered. This value must be set at invoice creation and is immutable afterward.

RequesterId Long False

Unique identifier for the requester who initiated the goods or services request, used in invoice approval workflows.

Requester String False

Name of the person requesting the goods or services associated with the invoice.

InvoiceGroup String False

Name of the invoice group, assigned for reporting and payment purposes, required during invoice creation based on business unit settings.

ConversionRateType String False

The source of the currency conversion rate for the invoice, used when dealing with non-functional currencies.

ConversionDate Date False

Date when the conversion rate is applied to convert amounts to another currency, essential for non-functional currency invoices.

ConversionRate Decimal False

The rate used to convert one currency into another for the invoice, essential for non-functional currency invoices.

AccountingDate Date False

The accounting date for the invoice, determining when the invoice is recorded in accounting. It can be defaulted or manually provided.

Description String False

A textual description of the invoice for clarification or additional information.

DeliveryChannelCode String False

Code used to identify the method of payment delivery associated with the invoice.

DeliveryChannel String False

The text on electronic payment instructions used by the bank for processing payments, such as printing a check or holding it for collection.

PayAloneFlag Bool False

Flag indicating whether the invoice is to be paid independently of other invoices for the same supplier.

InvoiceSourceCode String True

The code that identifies the source of the invoice, such as a spreadsheet, external system, or user-defined source.

InvoiceSource String False

The source system from which the invoice was created, such as external systems or spreadsheets.

InvoiceType String False

The type of invoice, such as Standard, Prepayment, Credit Memo, or Debit Memo, defined by the invoice amount and other parameters.

PayGroup String False

Groups invoices for a single payment run, categorizing suppliers into specific groups like Employees, Merchandise, or Government.

InvoiceReceivedDate Date False

The date when the invoice was received, which can be used to calculate the due date for payments.

PaymentReasonCode String False

User-defined code for categorizing the reason for the payment.

PaymentReason String False

Code from a government or central bank that provides additional details on the reason for payment, used for regulatory reporting.

PaymentReasonComments String False

User comments explaining the reason for the payment, which can be entered during invoice creation.

RemittanceMessageOne String False

First remittance message used for payment processing, providing additional payment details.

RemittanceMessageTwo String False

Second remittance message used for payment processing.

RemittanceMessageThree String False

Third remittance message used for payment processing.

PaymentTerms String False

Terms used to calculate payment dates, installments, and discount amounts, based on agreements with the supplier.

TermsDate Date False

Date used along with payment terms to determine due dates and discount dates.

GoodsReceivedDate Date False

The date when goods were received, used for calculating the invoice payment due date.

PaymentMethodCode String False

Code used to identify the method of payment, such as check, cash, or credit card.

PaymentMethod String False

Indicates how the payer will make the payment, which can be defaulted from supplier or profile-level payment settings.

SupplierTaxRegistrationNumber String False

Tax registration number of the supplier, used for tax reporting and compliance.

FirstPartyTaxRegistrationId Long False

Unique identifier for the first party tax registration.

FirstPartyTaxRegistrationNumber String False

Tax registration number of the first party, used for legal and financial purposes.

LegalEntity String False

The name of the legal entity associated with the invoice, either manually entered or defaulted.

LegalEntityIdentifier String False

The identifier for the legal entity, used for tracking and compliance purposes.

LiabilityDistribution String False

Account combination for recording liabilities associated with the invoice.

DocumentCategory String False

Category of the document, used for organizing and classifying invoice types.

DocumentSequence Long False

Manual sequence number used when sequential document numbering is enabled.

VoucherNumber String False

Voucher number assigned to the invoice if document numbering is not used.

ValidationStatus String False

Indicates the validation state of the invoice, typically 'Not Validated' by default.

ApprovalStatus String True

Approval state of the invoice, showing whether it is approved, pending, or rejected.

PaidStatus String True

Indicates whether the invoice has been paid.

AccountingStatus String True

Accounting state of the invoice, showing whether it has been processed in the accounting system.

ApplyAfterDate Date False

Date after which a prepayment invoice can be applied to other invoices. This applies only to temporary prepayments.

CanceledFlag Bool True

Indicates whether the invoice has been canceled.

AmountPaid Decimal True

The amount paid against the invoice.

BaseAmount Decimal True

The base amount of the invoice before any adjustments or currency conversions.

PurchaseOrderNumber String False

Purchase order number associated with the invoice, used to match invoices to purchase orders.

Party String True

The party associated with the invoice.

PartySite String True

The party site associated with the invoice, providing further details about the location or entity.

ControlAmount Decimal False

The calculated tax amount that ensures consistency with the physical document.

DocumentFiscalClassificationCodePath String False

Classification of transactions that require special documentation for tax purposes, like international transactions.

TaxationCountry String False

Country where the transaction occurred, used for taxation and reporting purposes.

RoutingAttribute1 String True

Attribute used for routing invoice images.

RoutingAttribute2 String False

Additional attribute used for routing invoice images.

RoutingAttribute3 String False

Another attribute used for routing invoice images.

RoutingAttribute4 String False

Additional routing attribute used for invoice image processing.

RoutingAttribute5 String True

Routing attribute used for invoice image processing.

AccountCodingStatus String True

Indicates the coding status of the invoice, showing whether it has been correctly accounted for.

BudgetDate Date False

Date for budgetary calendar periods used for funds checks.

FundsStatus String True

Status of funds availability for the invoice.

CanceledDate Date True

Date the invoice was canceled.

CanceledBy String True

Username of the person who canceled the invoice.

UniqueRemittanceIdentifier String False

Unique identifier for a remittance, used for tracking payments.

UniqueRemittanceIdentifierCheckDigit String False

Check digit for validating the unique remittance identifier.

CreationDate Datetime True

Timestamp when the invoice record was created.

CreatedBy String True

Username of the person who created the invoice.

LastUpdatedBy String True

Username of the person who last updated the invoice.

LastUpdateDate Datetime True

Timestamp when the invoice was last updated.

LastUpdateLogin String True

Session login associated with the user who last updated the invoice.

BankAccount String False

Bank account number to which the payment for the invoice is remitted.

SupplierIBAN String False

Supplier's International Bank Account Number (IBAN), used for international payments.

ExternalBankAccountId Long False

Unique identifier for the external bank account associated with the supplier.

BankChargeBearer String False

Indicates who is responsible for bank charges, such as the payer or payee.

SettlementPriority String False

Priority assigned to the payment for processing based on urgency.

ReferenceKeyOne String True

First reference key for invoice tracking.

ReferenceKeyTwo String True

Second reference key for invoice tracking.

ReferenceKeyThree String True

Third reference key for invoice tracking.

ReferenceKeyFour String True

Fourth reference key for invoice tracking.

ReferenceKeyFive String True

Fifth reference key for invoice tracking.

ProductTable String True

Product table used to categorize the invoice.

ImageDocumentNumber String True

Document number for the invoice image.

invoiceLines String False

Details of the invoice lines, used for itemizing the products or services.

appliedPrepayments String False

Details of prepayments applied to the invoice.

availablePrepayments String False

Details of available prepayments for the invoice.

invoiceGdf String False

Global descriptive flexfield for additional invoice data.

invoiceInstallments String False

Details of installments for the invoice.

invoiceDff String False

User-defined descriptive flexfield for the invoice.

Finder String True

Search term or identifier used to locate and retrieve specific invoices.

EffectiveDate Date True

Date used to fetch resources that are effective as of a specified start date.

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