Professional Documents
Culture Documents
AR Accounting Date Derived Based On The Default Date
AR Accounting Date Derived Based On The Default Date
AR Accounting Date Derived Based On The Default Date
Troubleshooting AutoInvoice Date Derivation: GL Date, Invoice Date, Due Date, Ship Date, Billing Date,
Rule Date (Doc ID 201241.1)
In this Document
Purpose
Troubleshooting Steps
1. Date Derivation In AutoInvoince: How It Works
2. General Ledger Date
a. Invoice Without Rules
b. Invoice With Rules
i. Bill In Advance Invoicing Rules
ii. Bill in Arrears Invoicing Rules
iii. How Accounting Rule Start Dates Are Derived
c. Credit Memos (RMAs)
d. General Ledger Date Handling For Closed Periods
e. GL Date Validation In AutoInvoice
3. Transaction Date & Ship Date
a. Invoice
b. Credit Memo
4. Billing Date (Balance Forward Billing)
5. Due Date
6. Receivables Transaction Source Setup Impacting Date Derivation
a. Date Derivation In Transaction Batch Source Window
b. Adjust GL Date In Closed Period Setup In Transaction Batch Source Window
7. AutoInvoice Execution/Validation Report Date Errors And Steps To Resolve
8. Known Bugs And Fixes For AutoInvoice Date Derivation Issues
APPLIES TO:
PURPOSE
Oracle Receivables (AR): AutoInvoice Information Center >Troubleshooting AutoInvoice for Oracle Receivables Release
11.5 Through 12 > Note 201241.1
The purpose of this note is to provide a clear explanation of the logic used by AutoInvoice to derive the General Ledger Date and the
Transaction Date while processing transactions.
It is intended as a resource to assist you in identifying why a date is not what you expected. It can also be used to influence setup during
an implementation so that dates default as intended.
This note should be used in conjunction with the following two articles:
Note 1067402.1, AutoInvoice Setup for Release 12: A Case Study Using a Simple Script
1 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
Note 1075757.1, Troubleshooting AutoInvoice for Oracle Receivables Release 11.5 Through 12
TROUBLESHOOTING STEPS
During the process of AutoInvoice you can enter the General Ledger (GL) date and the Transaction date for a particular
transaction explicitly in the relevant columns of the RA_INTERFACE_LINES_ALL table or you can allow the AutoInvoice
process to derive the dates.
If the dates are provided, AutoInvoice will typically use them. There are a few scenarios where dates cannot be provided as
input parameters; these scenarios are discussed in section 2.e titled GL Date Validation.
If the dates are not provided, they will be derived. Date Derivation of the General Ledger date and Transaction date during
the process of AutoInvoice depends on the following:
GL_DATE
TRX_DATE
SHIP_DATE_ACTUAL
SALES_ORDER_DATE
RULE_START_DATE
2. Selection of the Derive Date Option in the Accounting Information Tab of the Transaction Sources
window.
3. Whether or not Invoicing Rules and Accounting Rules are used.
4. Setting of the GL Date in a Closed Period option in the AutoInvoice Options tab of the particular
Transaction Batch Source.
5. Default Date entered while submitting the AutoInvoice Program.
Once imported as a transaction in receivables, the GL date used by AutoInvoice is stored in the table.column:
RA_CUST_TRX_LINE_GL_DIST_ALL.GL_DATE.
Note: The GL date discussed in this note is for the initial accounting entry booked to record the creation of the invoice.
For invoices with rules, Revenue Recognition will generate additional accounting entries and may impact the dates seen by
users when reviewing transactions in Receivables.
Start by determining if your invoice has rules or not. If it does not start in section a below. If it does have rules, refer to section b.
Table shows how AutoInvoice selects a GL date when an invoice without rules is imported.
1 Interface Lines GL Date exists = Yes GL Date from the interface table
Interface GL Date in Open Period = Yes
2 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
2 Interface Lines GL Date exists = No Default date parameter for this AutoInvoice submission
Derive Date = No
6 Interface Lines GL Date exists = No Default date parameter provided for the AutoInvoice request
Derive Date = Yes
Transaction Date Exists = No
3 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
The following flow shows the GL Date derivation logic for invoices without rules.
The default date from the parameters window is shown in the example below:
4 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
This table shows examples of GL Date Derivation for invoices without rules:
5 13-Mar-2010 01-Apr-2010
6 01-Apr-2010
When an invoice with rules is processed, the GL date derivation process is impacted by your choice of rules. Both the
Invoicing Rule and the Accounting Rule influence the GL date.
If you use Bill in Advance as the invoicing rule, AutoInvoice uses the earliest start date* of the accounting rules
associated with your invoice lines as the GL date of the invoice.
*See section iii. below for logic used to derive the start date.
If you use Bill in Arrears as the invoicing rule then the GL date is derived slightly different depending upon your
accounting rule type/period (i.e., Specific date) and Batch Source setups. Rule Start Date is an important driver
in determining the GL date.
5 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
Fixed Schedule Specific AutoInvoice sets the GL and Transaction dates equal to the latest Specific Date of the accou
Date
All Other Bill in Arrears AutoInvoice first computes an ending date for each invoice line based on the accounting rul
Accounting Rule Types start date, and duration. AutoInvoice then uses the latest available date for the invoice GL d
The following sequential logic is used to find the start date for the accounting rules. Use this matrix to find the
rule date on your transaction and then use the logic for your specific situation from the sections above to
determine which value is used as the GL date.
1 Accounting Rule Type = Fixed duration Specific Date from the Accounting Rule Setup
Period = Specific Date
3 Derive Date Checked in Batch Source Option is checked (see 1. Use the Ship Date if it is populated and in an open/enter
section 6 in this note) 2. If no Ship Date exists, then use Sales Order Date if it is
period.
3. If there is no Ship Date and no Sales Order Date, use th
the AutoInvoice submission.
4 Derive Date = Unchecked Default Date specified in the Run AutoInvoice Window
6 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
# Rule_Start Ship_Date Sales_Order Default_ Derive Accounting Rule Start Date Used
_Date _Date Parameter Date Rule Used
_Date
7 01-Apr-2010
Note: The Ship Date is not used for GL dates on Credit Memos and should not be passed as part of a credit memo
interface. AutoInvoice uses the logic described above to derive the GL date. The Ship date is also derived for credit
memos using the earliest shipment date from the transaction you are crediting.
Whether the General Ledger date is derived or specifically entered, the system validates whether it falls within a period which
is Closed or Not Opened. If the GL date falls within a period which is Closed or Not Opened, the Transaction Batch Source
controls what occurs next. As shown in Section 6. of this note, the 'General Ledger Date in a Closed Period' option can be set
to 'Adjust' or 'Reject' with the following consequences:
1. The last day of the latest prior period that has an Open status is picked up as the General Ledger date.
2. If a prior period with an Open status does not exist, AutoInvoice uses the first day of the first subsequent period that
has a status of Open.
3. If there are no prior or subsequent Open periods, AutoInvoice uses the first day of the first subsequent period that
7 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
1. The last day of the latest prior period with an Open status is picked up as the General Ledger date.
2. If a prior period with an Open status does not exist, AutoInvoice uses the first day of a subsequent Open period.
However, if there is more than one subsequent period with a status of Open, AutoInvoice rejects the line.
3. If there are no prior period or subsequent Open periods, AutoInvoice uses the first day of the first subsequent period
with a status of Future. If there is more than one subsequent period with a status of Future, AutoInvoice rejects the
transaction.
8 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
# Jan Feb Mar Apr May Option GL GL Date Invoice Uses Action by GL Date
Date in a Entered or Rules AutoInvoice Used
Closed Derived
Period
3 Open Closed Open Closed Closed Adjust 01-FEB-10 With/Without Adjust date 31-Jan-10
Rules
4 Open Closed Open Closed Closed Reject 01-FEB-10 With/Without Reject Line
Rules
5 Closed Closed Open Closed Closed Adjust 01-FEB-10 With/Without Adjust Date 01-Mar-10
Rules
6 Closed Closed Open Closed Closed Reject 01-FEB-10 With/Without Reject Line
Rules
7 Closed Closed Open Open Open Adjust 01-FEB-10 With Rules Reject Line
8 Closed Closed Open Open Open Reject 01-FEB-10 With Rules Reject Line
9 Closed Closed Open Open Open Adjust 01-FEB-10 Without Rules Adjust Date 01-Mar-10
10 Closed Closed Open Open Open Reject 01-FEB-10 Without Rules Reject Line
11 Closed Closed Future Closed Closed Adjust 01-FEB-10 With/Without Adjust Date 01-Mar-10
Rules
12 Closed Closed Future Closed Closed Reject 01-FEB-10 With/Without Reject Line
Rules
13 Closed Closed Future Future Future Adjust 01-FEB-10 With Rules Reject Line
14 Closed Closed Future Future Future Reject 01-FEB-10 With Rules Reject Line
15 Closed Closed Future Future Future Adjust 01-FEB-10 Without Rules Adjust Date 01-Mar-10
16 Closed Closed Future Future Future Reject 01-FEB-10 Without Rules Reject Line
17 Open Never Never Never Never Adjust 01-FEB-10 Bill in Advance or Adjust Date 31-Jan-10
Opened Opened Opened Opened Bill in Arrears rule
1. The entered or derived GL date must be in an Open or Future enterable accounting period.
2. The GL date cannot be in a Closed, Closed Pending, or Not Opened period if the GL Date in a Closed Period field for
your batch source is set to 'Reject.' (For invoices that use Bill in Arrears rules, AutoInvoice always rejects lines that have
a general ledger date in a closed period.)
3. The period must exist in GL_PERIOD_STATUSES.
4. If Accounting Rules are used, all periods must be defined for the duration of the accounting rule in
GL_PERIOD_STATUSES.
5. If 'Post To GL' is set to No on the transaction type of the transaction being passed, the GL_DATE column must be NULL.
6. If your invoice uses Bill in Arrears as the invoicing rule, then the GL_DATE column should be NULL.
7. If the Line Type being processed is Tax or Freight, the GL_DATE column should be NULL.
8. The GL date of a credit memo cannot be before the GL date of the associated invoice and/or the invoice date.
You can specify whether AutoInvoice will reject or partially create transactions that have a GL date in a closed period. For
example, you import an invoice with three invoice lines and one of the lines is invalid. If the value of the Invalid Line option for
this batch source is set to 'Create Invoice,' AutoInvoice will create the invoice with only the two valid lines. You can then use
the Transactions Workbench to add the line that was rejected.
If Invalid Line is set to 'Reject Invoice,' AutoInvoice will not import this transaction or any of its lines into the interface tables.
Transactions that fail validation appear in the AutoInvoice Validation report. The values you enter in the AutoInvoice
Processing Options tabbed region of the Transaction Sources window determine how AutoInvoice will process transactions
with invalid data. See Section 6 on Transaction Batch Sources.
9 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
a. Invoice
Fulfillment Sets
If you are using fulfillment sets in Order Management (OM), you should be careful about which setup option you choose. If
you have your system set up to use the Ship Date, the system will assign the earliest ship date possible. If you have significant
lags between shipments this could result in invoice dates equal to the first shipment, which will throw off your aging, discount
calculations, etcetera. If you find yourself in this situation, you can change your setup to use the system date as the date
default.
Refer to section 1 of this note for setup necessary to map the ship date to system date.
Assuming AutoInvoice is run daily, this would have the net effect of assigning the GL/transaction date that matches the last
shipment date. Alternately, you can invoice each line as it is shipped by not using fulfillment sets. (For 11i, apply the latest
version of OEXPINVB.pls to avoid known problems. Presently this is 115.221.11510.55 available through Patch 9477748).
TIP: If you use Oracle Inventory and Oracle Order Management for sales order shipments, you should elect to derive your
dates and use the shipment date for your invoice GL date. This way, you can ensure that you have booked your revenue
and cost to the same accounting period. If you do not match revenue and cost in the same period, you violate basic GAAP
principles and may distort your profit. In addition, you cannot run a meaningful Margin Analysis report. This report
summarizes your revenue and cost of goods sold transactions by item and customer order, and specifies a transaction date
range. If your transactions are booked in the wrong period, the Margin Analysis report reflects those incorrect
transactions.
b. Credit Memo
If a transaction date is not passed for your credit memo, AutoInvoice uses the following hierarchy to determine the credit
memo's transaction date:
RECURRING - this is the type users can create when they define their own billing cycles. In AutoInvoice, if the billing
cycle associated to the payment term is of type RECURRING, AutoInvoice will derive the Billing Date. The logic to derive
billing date is to find the first billable date on or after the transaction date and to use that as the billing date on the
invoice.
EVENT - Oracle seeds only one billing cycle for this type, named EXTERNAL. Users cannot create additional EVENT type
10 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
billing cycles. In AutoInvoice, if the billing cycle associated to the payment term is of type EVENT, you are required to
pass in a value for the Billing Date.
See section 8 on Bug fixes for a Release 12 issue with this logic.
From Bug 7165627 the following logic is used to derive the billing date
5. Due Date
When submitting AutoInvoice, users enter two parameters that influence Due Date derivation. They are:
1. Base Due Date on Trx Date: Use this parameter to indicate whether you want AutoInvoice to calculate invoice due
dates based on transaction dates or based on either the ship date, sales order date, or default date. The default for this
parameter is Yes, which prompts AutoInvoice to use the transaction dates as the due dates for your invoices. If you
change the value to No, then AutoInvoice looks at the setting of the Derive Date option on a transaction's batch source
to determine the due date. Depending on the Derive Date setting, AutoInvoice derives the due date in a different way
Additionally, if the value of this parameter is No, then AutoInvoice uses the Due Date Adjustment Days parameter to
determine the final due date.
Note:
When Base Due Date on Trx Date = Yes, and you are interfacing Balance Forward invoices via AutoInvoice, the
process has logic to first check for the value in BILLING_DATE:
2. Due Date Adjustment Days: Use this parameter to adjust your invoice due date calculations. You can enter any
integer between the range of -9999 and 9999. AutoInvoice uses this parameter only when the Base Due Date on Trx
Date parameter is set to No. When Base Due Date on Trx Date is No, AutoInvoice compares the due date that it
derived against the transaction date plus the number of days that you enter. AutoInvoice uses whichever date is later
as the final due date.
Terms setup also drives due date derivation as does Balance Forward Billing . When Balance Forward Billing is in use the
Billing Date can also be considered in deriving the Due Date.
Several bugs have been reported on Due Date handling and are covered in Section 8 of this document.
Also refer to the following documents:
Receivables Responsibility
Navigation: Setup > Transactions > Sources > Accounting Information
11 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
The Accounting Information tab of the Transaction Sources (RAXSUMSC) window is where you select the criteria for validation
regarding accounting information. The fields that impact date derivation are:
Invoicing Rule
Accounting Rule
Derive Date check box
Select the Derive Date check box to derive the default Rule Start Date and default using the logic explained in section 2b.
TIP: If you use Oracle Inventory and Oracle Order Management for sales order shipments, you should select to derive
your dates and use the shipment date for your transaction GL date. This way, you can ensure that you have booked your
revenue and cost to the same accounting period.
Receivables Responsibility
Navigation: Setup > Transactions > Sources >AutoInvoice Options
12 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
The value entered in the GL Date in a Closed Period field determines how AutoInvoice handles imported transactions that have
lines with a General Ledger date that is in a closed period.
Select Adjust to automatically adjust the General Ledger date to the first GL date of the next Open or Future enterable
period.
Select Reject to reject these transactions from being processed by AutoInvoice.
GL date was not passed as Correct your setup to increment the date and p
Unable to derive a GL date for your transaction.
Please ensure that your transaction is in a GL period
request parameter and Derive scheduling AutoInvoice. (This can occur if the
which you have defined Date was unchecked in Batch and the request submission was not set to incr
source or
Pass GL date as a parameter to interface table
or
Modify you Batch Source setup to allow GL dat
13 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
Bug 8667653
Release: 12.0 - 12.1
Symptoms: Autoinvoice rejects lines with erroneous messages about Invalid warehouse_id when
batch source setup has Accounting/Invoicing Rule = None and GL date to be derived from shipping or
order date.
1) Incorrect RA_CUST_TRX_LINE_GL_DIST.GL_DATE, with the following variations : This is RDBMS Bug 4483951
a) RA_CUST_TRX_LINE_GL_DIST.GL_DATE <> RA_CUSTOMER_TRX.TRX_DATE
14 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
*NOTE: Fixed files are often not the most current versions available. This table recommends the patch that contains THE MOST
CURRENT release of the fixed file. For this reason the patch readme file may not make specific mention of the symptoms described on
the lines above.
Due to Brazil Regulations, when a Transaction in Autoinvoice is processed, any day after it was inserted into Autoinvoice, the Invoice Date
should be the day it was processed and will not consider the trx_date value entered in the autoinvoice interface table.
Also, the GL_DATE should be same as the Transaction Date.
To discuss this information further with Oracle experts and industry peers, we encourage you to review, join or start a discussion in the
My Oracle Support Receivables Community.
To provide feedback on this note, click on the Rate this document link.
If you feel that a Service Request is needed, please be sure to provide the information listed below:
15 of 16 21-02-2018 19:15
Document 201241.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
2. Provide the values for all variables that can influence the date from the section above
3. Document any troubleshooting steps you have performed
4. Provide a debug log and diagnostics as discussed in Note 1079666.1 How to Obtain an AutoInvoice Debug Log or Trace File for 11i and
R12
16 of 16 21-02-2018 19:15