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. |