auto invioce
TRANSCRIPT
3/17/16, 7:09 PMDocument
Page 1 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
Troubleshooting AutoInvoice for Oracle Receivables Release 11.5 Through 12 (Doc ID1075757.1)
Modified: Nov 12, 2013 Type: TROUBLESHOOTING
In this Document
Purpose
Troubleshooting Steps
1. How Does AutoInvoice Work?
2. Alternatives to AutoInvoice
3. Using Diagnostics to Check Setup
4. Identifying What Went Wrong
a. Import Failed: ERROR
b. Import Completed: Exception Report ERROR
c. Import Completed: Nothing Imported
d. Transaction Imported: Record is Incorrect
e. Master Program Failed: ERROR
f. Import Never Completes
5. Validating the Data Being Imported (Custom Interface vs. Seeded Integration)
a. Custom Integration or Data Migration Issues
b. Integration with Oracle Applications that Feed AutoInvoice
6. Troubleshooting Specific Steps in AutoInvoice
a. Accounting (AutoAccounting)
b. Credit Memos
c. Customer, Addresses and Customer Contact
d. Currency and Exchange Rates
e. Dates: Transaction Date, GL Date
f. Flexfields: Transaction, Global, Descriptive
g. Freight
h. Grouping Rules
i. Inventory Transactions (Warehouse, Items, etc)
j. Line Ordering
k. Numbering: Document Sequencing and Transaction Numbering
l. Payment Terms
3/17/16, 7:09 PMDocument
Page 2 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
m. Purge
n. Invoicing and Accounting Rules
o. Revenue Recognition
p. Receipt Method
q. Remit To Addresses
r. Sales Representatives, Sales Credits and Territories
s. Taxes
t. Transaction Sources
u. Transaction Types
v. Unit of Measure
w. Commitments
7. Environment Issues: Performance, Hardware, Database, Memory or other peripheral issues
8. Fixing Data Issues
9. Capturing Debug Logs and Trace Files
10. Additional Diagnostics
11. Still Have Questions?
12. Logging a Service Request
References
APPLIES TO:
Oracle Receivables - Version 11.5.10.0 and laterOracle Contracts - Version 11.5.10 and laterOracle Order Management - Version 11.5.10.0 and laterOracle Project Billing - Version 11.5.10.0 and laterOracle E-Business Tax - Version 12.0 and laterInformation in this document applies to any platform.Executable:RAXMTR - Autoinvoice Master ProgramExecutable:RAXTRX - Autoinvoice Import ProgramExecutable:RAXDEL - Autoinvoice Purge Program
PURPOSE
Oracle Receivables (AR): AutoInvoice Information Center > Generic Setup and Troubleshooting Resources >Note 1075757.1
This note is intended to walk you through a set of sequential steps that will facilitate troubleshooting AutoInvoice issues inReleases 11.5 through 12.1.
TIP: There are many notes in the Knowledge base written to help you troubleshoot AutoInvoice. However, since this feature
3/17/16, 7:09 PMDocument
Page 3 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
is large and is impacted by many components, it may get confusing to navigate through the notes to find your solution.
We highly recommend using the following notes:
Note 1523525.1, AutoInvoice Post-Processor Validation Report: Overview and Installation Instructions Note 1483249.1, AutoInvoice: Debugging Flow Advisor, it is designed to help you narrow in and identify the notethat may assist in resolving your issue.
TROUBLESHOOTING STEPS
1. How Does AutoInvoice Work?
How is it submitted? AutoInvoice is run using the Concurrent Request submission process. Scheduling: Through the Concurrent Request form, AutoInvoice can be scheduled to run on a periodic basis. Parameters: When scheduling or submitting AutoInvoice, parameters allow you to control what data sources
are used when importing records and what dates default on transactions. Additional controls are available on thetransaction source that you specify on the records being imported.
AutoInvoice Master Program (RAXMTR): Upon submission the master program is called. This programcoordinates the activities being done such as gathering statistics, marking records for processing (setting requestIDs on blocks of records, parallel processing). The master program also spawns and manages child requests forimporting and purging of data.
AutoInvoice Import Program (RAXTRX): The key step in AutoInvoice is the import program. Uponsubmission this request is spawned by the Master Program. It converts the data in the interface table into invoicesand also produces the execution and validation reports.
AutoInvoice Report: This is produced by the import stage, and actually contains output from 2 reports:AutoInvoice Execution Report: Provides a summary of the records from each of the Interface tablesindicating a count for selected, processed and rejected. This section also provides a breakdown of the typesof transactions created.AutoInvoice Validation Report: If there were errors during Import, this section provides detailedmessages describing the errors encountered. This section should assist users in correcting the interface dataso they can be re-processed successfully.
Note: Many existing notes discussing topics regarding the output of the AutoInvoice Import, refer to theExecution and Validation Report interchangeably, because they are contained in the same output file.
AutoInvoice Purge (RAXDEL): This is conditionally run after import (based upon your AR system optionssettings).
Run as standalone? AutoInvoice Import can be run as a standalone request (not spawned by the Master Program)by adding AutoInvoice Import to the request group associated with your responsibility. This is normally only done as atroubleshooting step when the Master Program is failing. Note that no statistics are gathered in this scenario, thus youmay encounter performance issues in some scenarios.
3/17/16, 7:09 PMDocument
Page 4 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
Invoke Programatically? <<Note 1127399.1>> Provides some sample code that can be modified to invokeautoinvoice from a custom procedure. This is provided to assist customers in building integration however support forthis type of cusotomization is limited.
2. Alternatives to AutoInvoice
AutoInvoice is one of several utilities provided to import transactions. Other options include:
Oracle EDI GatewayOracle Receivables API'sXML Invoices (Part of Bill Presentment Architecture)
Despite the availability of alternatives, AutoInvoice is by far the most popular and heavily used integration point forReceivables (AR) transactions. This is especially true where batch processing is desired. Most integration with Oracle ARand other Oracle modules occurs through AutoInvoice.
3. Using Diagnostics to Check Setup
An easy step when troubleshooting AutoInvoice is to execute the AutoInvoice Setup Diagnostic test. This diagnostic can berun by following the simple instructions in Note 1079666.1. The output of this diagnostic will help you work through manyconfiguration issues and avoid encountering the corresponding problems.
A sample output is shown below. Note the warning next to several of the lines.
3/17/16, 7:09 PMDocument
Page 5 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
Selecting the link will take you to the corresponding setup check where you can review the warnings. In the examplebelow we can see that our current settings could negatively impact our system performance. Taking proactive steps hereto eliminate or address these issues can often resolve the issue we are encountering.
3/17/16, 7:09 PMDocument
Page 6 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
4. Identifying What Went Wrong
If you are setting up a new interface to AR, we strongly encourage you to begin with a thorough review of the steps in:Note 1067402.1 AutoInvoice Setup for Release 12: A Case Study Using a Simple Script
Also, if you are getting error messages and are not quite sure where to start, you can also reviewNote 1138254.1 Listing of AutoInvoice Execution Report Error Messages and Troubleshooting Tips to Resolve each Error
Common Causes when AutoInvoice doesn't Import or Imports IncorrectlyThere are five scenarios that typically occur when AutoInvoice fails to import a record from the interface table or Imports it
3/17/16, 7:09 PMDocument
Page 7 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
incorrectly.
a. Import Failed: ERROR
When AutoInvoice fails with an ERROR status, it is important to review the concurrent log files: AutoInvoiceMaster and AutoInvoice Import, for any error messages. Your primary goal when the request returns anERROR status is to identify the error stack so that you can search for and find the solution document (forknown issues)
There are three primary types of diagnostics that you can leverage to find an error:
AutoInvoice Debug LogsFND Debug LogsTrace Files
Note 1079666.1 "How to Capture a Debug Log or Trace File for AutoInvoice in 11i and R12" explains howand when to capture each of these Debug records, what they look like in the log file and shows someexamples on how you can interpret them.
In most cases when reviewing these logs it is possible to find an error written by the code to the log file.
Once you have the error in hand, search for your error in Document 1082238.1 "TroubleshootingAutoInvoice: Concurrent Request Failures (Request Status = Error)"
If you do not find your specific issue documented in this note then conduct a keyword search on your errormessage to see if the issue is known and if a solution is available.
Tip: Always do a keyword search in My Oracle Support after finding an error message. It is the fastestway to identify root cause and a solution for your issue.
raagtf()+ Current system time is 26-MAR-2010 17:07:57None of the transaction flexfield contexts you have provided for this request haveenabled segmentsError calling raagtf()Error calling raamil()Error calling raapft()
In the example above, begin by searching on the error phrase from the log file "None of the transactionflexfield contexts you have provided for this request have enabled segments"
If you are unable to find the solution using that phrase or if you receive too many choices in the searchresults, add one or more of the additional messages such as "Error calling raagtf()" to your search phrase.
3/17/16, 7:09 PMDocument
Page 8 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
In the unlikely event that none of these steps returns a known issue it may be helpful to review Note100435.1 "What Do Each of the Subprograms in AutoInvoice Do ". Searching within this document for thefirst program name "raagtf" can help you to understand what the program was doing when it failed. In thisexample, the program is designed to "Get Transaction Flexfield Information". You can use this along withsection 6 in this note to find detailed troubleshooting documents for each main section of AutoInvoice. Inthe scenario above this would take you to the section on Transaction Flexfields and guide you throughadditional troubleshooting steps.
b. Import Completed: Exception Report ERROR
Exceptions are the most straightforward scenario to handle. In most cases the exception message is clearenough so that you realize what you must fix.
For example, if the report output shows this:
The supplied ship-to address ID must exist in Oracle Receivables, and it must agree with the supplied ship-to customer (ORIG_SYSTEM_SHIP_ADDRESS_ID)(1601).
Then there is a problem with the customer ship-to address Id provided, and you can investigate that further.The best option to resolve these errors is a search on the exact error phrase. This should return aconsolidation note detailing known setup and bugs that can trigger the error. We suggest that you excludethe token values (fields that reflect your environment such as ID's or names) to improve your search results.
Another option is to search Section 6 of this document. This section speaks to known setup and other issuesfor each sub-feature invoked by AutoInvoice.
In some cases the exception report will show a vague error such as the one below:
ERRORUnexpected Error Populate Error - 1071886
When this occurs you will need to treat the situation as if AutoInvoice failed (see section 2a above) and usethe AutoInvoice Debug Log and FND Debug log to find the cause. In Release 12 this vague exception canoccur when E-Business Tax fails but AutoInvoice is able to work past the issue without failing.
Note 1089172.1, Troubleshooting Autoinvoice Import - Execution Report Errors (Request Status =Completed) explains the most common exceptions, and provides recommendations for each issue.
c. Import Completed: Nothing Imported
3/17/16, 7:09 PMDocument
Page 9 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
While uncommon, it is possible that records will not be picked up when you submit the AutoInvoice program. This is almost always the result of invalid parameters being passed to the concurrent request. Check tomake sure that the source you are submitting exactly matches the data in the interface table. If this occursand you are setting up AutoInvoice for a new data source either as part of a migration or as part of anintegration, refer to Note 1067402.1 AutoInvoice Setup for Release 12: A Case Study Using a Simple Script
This is often reported as "Records are Stuck in the RA_INTERFACE_LINES_ALL interface table" Which isadditionally discussed in the following notes:Note 1146573.1 Troubleshooting Items that won't import or that are "Stuck" in the interface tableNote 1094863.1 Troubleshooting AutoInvoice: Master Program (RAXMTR) Errors And 'No Data Found' Issues
d. Transaction Imported: Record is Incorrect
There are two primary scenarios that are encountered here: Either the record imported incorrectly due toAutoInvoice setup (grouping rules are wrong, the Transaction Flexfield is not set up properly, GL datederivation is wrong, etc.) or it imported incorrectly due to a more generic system setup. In a few cases theimport can fail due to a defect (bug).
To establish which case you are facing we again must try to narrow the scope to identify the most likely rootcause. Use the appropriate section in section 5 of this document to review the setup from the perspective ofthe system feeding autoinvoice and then, if unresolved, section 6 to focus on specific causes for thesymptoms reported..
e. Master Program Failed: ERROR
3/17/16, 7:09 PMDocument
Page 10 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
The AutoInvoice Master program has a very simple role which is to manage the worker programs, memoryallocation and gather statistics.
The most common presentation with the Master Program occurs when no records are found to beprocessed. In this case the master program completes but no data is imported.
Note 1094863.1 Troubleshooting AutoInvoice: Master Program Errors or Shows 'No Data Found' has beencreated to document the steps you can use to diagnose and fix issues that present with the Master Program.
f. Import Never Completes
In some situations, the AutoInvoice process never completes, this could be a performance issue, pleasecheck Note 1083467.1, How to Setup AutoInvoice for Optimal performance.It is also possible that there is data corruption in your interface or core AR tables, please check Note1294898.1, Troubleshooting AutoInvoice: Process Stops Working, No Errors in Log File
5. Validating the Data Being Imported (Custom Interface vs. Seeded Integration)
a. Custom Integration or Data Migration Issues
While the Receivables Reference Guide provides a good outline of field validation used by AutoInvoice, justgetting a file to import can be difficult. To simplify the implementation, case study Note 1067402.1 wascreated. This document, along with several supporting "child" notes, provides a comprehensive overview ofhow to implement AutoInvoice to support data sourced in a legacy application. If this is the first time youare attempting to run AutoInvoice for a new source we strongly encourage you to use this case study tovalidate your setup.
b. Integration with Oracle Applications that Feed AutoInvoice
In most cases, problems with Oracle Applications that interface with Receivables through AutoInvoice occurin the utility that inserts data into the tables. If your data is sourced in an Oracle Application, we encourageyou to review the note on the specific module listed below. These notes outline some of the more commonissues that have been reported with the integration.
Troubleshooting AutoInvoice Integration with Oracle Project BillingTroubleshooting AutoInvoice Integration with Oracle Order Management
3/17/16, 7:09 PMDocument
Page 11 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
If your problem is not resolved then please proceed to section 6 below 'Troubleshooting Specific Steps inAutoInvoice' where we break AutoInvoice into components and walk you through the steps required to debugthe unique area where your exception is occurring.
6. Troubleshooting Specific Steps in AutoInvoice
Note 100435.1 provides a list of AutoInvoice progams and a short description of what it handles.
Check it out!
Troubleshooting has never been easier, with this tool Note 1523525.1 AutoInvoice Post-Process ValidationReport: Overview and Installation Instructions
a. Accounting (AutoAccounting)
AutoAccounting is used by Receivables to assign preliminary accounting to an invoice or credit memo and thecorresponding tax and freight lines. As with other areas of AutoInvoice, when AutoAccounting fails it canoccur as a handled error in the debug log. An example of this might be:
APP-11526: 0 arcerr()- Current system time is 21-MAY-2001 13:54:11arcsai() Not all AutoAccounting types are definedError calling arcdsu_do_setup()
Again, if you encounter any log error you should begin by performing a My Oracle Support search on theprimary portion of the error message. In the example above, start with "arcsai() Not all AutoAccounting typesare defined" and then expand to add additional error components if the results from your search are toolarge.
Alternately, AutoAccounting can fail to generate an account segment (say the company segment) and thengenerate an error in the exception report such as the one shown below:
Please Correct Revenue (or Receivable or Freight or Tax) Account Assignment
To troubleshoot these errors the following note has been created. In this note you will step through the basictroubleshooting required to debug common exceptions with AutoInvoice accounting.
Note 1080995.1 Troubleshooting AutoAccounting in AutoInvoice Note 1228525.1 How to Import and Troubleshoot Distributions in AutoInvoice UsingRA_INTERFACE_DISTRIBUTIONS_ALL
b. Credit Memos
As part of the AutoInvoice process, you can interface Applied or On-Account Credit Memos. You mayencounter various errors such as:
The Open Receivable flag of your credit memo must match the flag of the transaction you are crediting.
3/17/16, 7:09 PMDocument
Page 12 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
An invoice can only reference a commitment
Invalid reference line attribute value
To troubleshoot these and other errors regarding Credit Memos in AutoInvoice or in the Transaction form, thefollowing note was created.
Note 1110573.1, Troubleshooting Credit Memos in Receivables
c. Customer, Addresses and Customer Contact
Customer validation errors typically are caused by incomplete setup and take the form of messages similar tothese:
Invalid bill to customer id (ORIG_SYSTEM_BILL_CUSTOMER_ID)The Bill To address id must exist in Oracle Receivables, and it must be assigned to the Bill To customer ORIG_SYSTEM_BILL_ADDRESS_ID.
The exact string will differ based upon the column from RA_INTERFACE_LINES_ALL that is invalid.
To troubleshoot these errors the following note has been created. In this note you will step through the basictroubleshooting required to debug common exceptions with Customer fields in AutoInvoice.
Note 1097660.1 Troubleshooting AutoInvoice Customer, Address and Contact Errors and Exceptions
d. Currency and Exchange Rates
(Work in Process - check back soon)
e. Dates: Transaction Date, GL Date
Date errors will most often present with the following message in the AutoInvoice execution report:
Error: Unable to derive a GL date for your transaction. Please ensure that your transaction is in a GL period which you have defined
If you find that AutoInvoice is using the wrong date or that it is rejecting the transaction with the abovemessage, we encourage you the following to troubleshoot the issue:
Note 201241.1 Troubleshooting AutoInvoice Date Derivation and How AutoInvoice Derives Dates
f. Flexfields: Transaction, Global, Descriptive
Transaction Flexfields are very important in your AutoInvoice setup as they control how AutoInvoice uniquelyidentifies a discrete transaction and the lines that should exist within that transaction. Link-To transactionflexfields also allow you to create a credit memo against an existing invoice.
Note 1077555.1 Troubleshooting Transaction Flexfields in AutoInvoice provides a step-by-step flow for you touse when diagnosing issues related to Transaction Flexfield setup.
Common error presentations discussed in this note include:
APP-11914 Duplicate Transaction Flexfield
AutoInvoice terminated abnormally
3/17/16, 7:09 PMDocument
Page 13 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
All enabled segments of Transaction Flexfield must have a value
APP-00778 invalid context field value (OE) passed to flexfield routine FDFDFA
None of the transaction flexfield contexts you have provided for this request have enabled segments
Data in ATTRIBUTE1-15 fields are not transferred into core AR table fields.
Value set validation is not done against segments of the Transaction Flexfield
Attributes from Order Entry are truncated when transferred into AR tables
g. Freight
Receivables allows you to associate Freight to your transactions. You have the option of recognizing revenueand calculating taxes on freight, or simple freight wherein you charge a fee.
For more information on what to check when you encounter issues with freight, please review:
Note 1096942.1, How to Setup and Troubleshoot Freight in AutoInvoice and the Transactions Form
h. Grouping Rules
AutoInvoice uses grouping rules to group invoices, credit memos and debit memos. Grouping rules containvarious transaction attributes (columns in RA_INTERFACE_LINES_ALL table) that must be identical acrossseveral interface records if the intention was for it to create one transaction.
If AutoInvoice is generating one invoice for multiple orders, then you may not have correctly defined theattributes that are being used to group invoice lines.
The Grouping Rule that is used by AutoInvoice is attached in your Batch source : Navigation: Setup > Transactions > Sourcesin the AutoInvoice tab
Grouping Rule Setup can be checked at:Navigation: Setup > Transactions > AutoInvoice > Grouping Rules
Common Error: Invoice lines with the same invoice number have been separated by the grouping process, causing duplicateinvoice numbers.
For Troubleshooting information see Note 1084554.1 Troubleshooting Grouping Rules in AutoInvoiceFor additional information see Note 1067993.1 How To Use Grouping Rules With AutoInvoice
3/17/16, 7:09 PMDocument
Page 14 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
i. Inventory Transactions (Warehouse, Items, etc)
The message Invalid Warehouse ID (WAREHOUSE_ID) (xxx) is normally displayed whenever an invoice line isprocessed by AutoInvoice but the warehouse is invalid.
To troubleshoot this issue, refer to:
Note 1089026.1 AutoInvoice Error: Invalid Warehouse Id (WAREHOUSE_ID) (xxx), where a comprehensivelisting of causes/fixes has been compiled.
j. Line Ordering
AutoInvoice uses Line Ordering Rules to order transaction lines when grouping the transactions it creates intoinvoices, debit memos, and credit memos. You can assign a line ordering rule to each grouping rule. You alsoassign transaction attributes to your line ordering rules.
AutoInvoice uses these attributes to order invoice lines. You can assign a priority to these attributes for eachof your invoice line ordering rules. You can also specify an ascending or descending order for eachtransaction attribute assigned to a rule.
For Troubleshooting information see Note 1086155.1 - Troubleshooting Line Ordering in AutoInvoice
For Additional Information see Note 1067965.1 - How to Manage Line Ordering When Using AutoInvoice toImport.
k. Numbering: Document Sequencing and Transaction Numbering
For your transaction numbers, if you use Document Sequencing and/or you have the system set up to 'CopyDocument Number to Transaction Number', refer to the notes below:
Note 1086565.1 How To Setup Document Sequences In Receivables.Note 1087122.1 Troubleshooting Document Sequences in Receivables
For invoice number ordering, review:Note 1071559.6 AutoInvoice Issue: Invoice Numbering During Import of Invoices is Not in Logical/ExpectedOrder
For Batch Numbering: Refer to:
Note 1088132.1 Troubleshooting Transaction Batch Sources For AutoInvoice
l. Payment Terms
Most problems encountered with Payment Terms arise due to missing or invalid terms on a transaction that isbeing imported. A Term ID or Term Name is required for all invoices imported via AutoInvoice.
To learn more about the payment term validation used when importing records please refer to:
Note 1083494.1 Troubleshooting Payment Terms in AutoInvoice where you can follow step-by-stepinstructions to troubleshoot and resolve most issues with Payment Terms.
m. Purge
3/17/16, 7:09 PMDocument
Page 15 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
AutoInvoice purge provides a method of clearing out records from the Interface tables that have beenprocessed successfully.
To learn more about AutoInvoice Purge, please refer to:
Note 1127413.1, Understanding and Troubleshooting AutoInvoice Purge.
n. Invoicing and Accounting Rules
Invoicing and Accounting rules allow you to control the schedule for recognizing Receivable and Revenue ona transaction. You may encounter issues such as:
Please supply both an invoicing rule and an accounting rule for this invoice
Please define all periods in which revenue is to be recognized or credited. Note that revenue cannot be recognized or credited in closed and close pending periods.
To learn more about Invoicing and Accounting Rules, please refer to:
Note 1116934.1, How To Setup And Troubleshoot Invoicing Rules and Accounting Rules
o. Revenue Recognition
Revenue Recognition allows you to spread out the accounting for the revenue associated to your transactionacross multiple periods. This feature is used in conjunction with Invoicing Rules and Accounting Rules above.
You may encounter errors such as the following:
arp_auto_rule.create_other_plug()- 09-JUL-03 09:03:01
EXCEPTION: arp_auto_rule.create_assignments()
ORA-06512: at "APPS.ARP_AUTO_RULE", line 479
To learn more about Revenue Recognition, please refer to
Note 1121944.1, Understanding and Troubleshooting Revenue Recognition.
p. Receipt Method
Receipt Method errors typically present as one of the following the AutoInvoice execution report:
R12:
1) When the receipt method is of type Automatic, you must either supply a valid bank account or ensure that a primary bank account for the currency code of the transaction has been set up for the Bill To customer
3/17/16, 7:09 PMDocument
Page 16 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
11.5
1) The supplied payment method must be defined and active for the bill-to customer or site
2) When the payment method is of type Automatic, you must either supply a valid bank account or ensure that a primary bank account for the currency code of the transaction has been set up for the Bill To customer
These errors are typically resolved by validating that the non-Manual receipt methods are able to derive avalid bank account.
To investigate this further and to read about some known bugs with the derivation of Receipt Methods andBank Accounts, refer to Note 1098583.1 Troubleshooting AutoInvoice Receipt Method and Payment MethodErrors and Issues
q. Remit To Addresses
Common Error:
Cannot get remit to address
A "Default Value" should be assigned for the Country and State with a blank zip code range.Adding this "default value" will eliminate the user from having to enter every possible Country and Statecombination that may be used. Also, by using this "default value" items will pass validation without runninginto an error because the remit-to address is not defined.
For more on remit-to address setup and troubleshooting please see Note 1101855.1 TroubleshootingReceivables Remit To Address Errors
r. Sales Representatives, Sales Credits and Territories
Common Error:
Invalid Salesrep Number
Log File shows:
AR_RAXTRX_SALESREP_INACTIVE.
This is a known issue, please refer Note 1112705.1 : AutoInvoice Error: Invalid Salesrep Number(SALESREP_NUMBER)
For a compilation of other troubleshooting tips, please refer to Note 1118944.1, Troubleshooting AutoInvoice- Sales Credits, explains troubleshooting common issues experienced when interfacing sales credit records.
s. Taxes
For R12 refer to Note 745968.1 Troubleshooting AutoInvoice Tax Issues with R12 E-Business Tax (EBTax)
For 11i refer to Note 1086146.1 Troubleshooting AutoInvoice Tax Issues with R11.5 (11i) Receivables TaxEngine
t. Transaction Sources
3/17/16, 7:09 PMDocument
Page 17 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
Whenever a new Transaction Source is created, it's common to experience various issues related to the setupof the source, and the data that is being imported. The Transaction Source Setup plays a key function as tohow AutoInvoice validates the data to be imported. The following is a list of some of the functionality that iscontrolled by the Transaction Source setup:
Transaction Numbering - Automatic or ManualGL Date DerivationGrouping RulesCustomer Information - Values Passed (ID, Value, Segment)
Bill To and Ship ToAddressContactPayment Method
Accounting Information - Values Passed (ID, Value, Segment)Invoicing RulePayment Terms
Sales Credit ValidationInvalid LinesGL Date in a Closed Period
For more details on Troubleshooting AutoInvoice Transaction Sources, review Note 1088132.1, Setups toConsider When Implementing New Interface Source Requirements
u. Transaction Types
Transaction Types are used to classify transactions, and have several attributes that help to manage howtransactions are processed within the applications. Utilizing these attributes allows you to managetransactions based on a business operation's requirements. The following reflects some of the attributes thatcan be used when defining a Transaction Type:
Class: Invoice, Credit Memo, Debit Memo, etc.Creation Sign: Negative, Positive, AnyPost To GLOpen ReceivableAllow Over ApplicationAccounting Distribution:
ReceivableRevenueUnbilled ReceivableTax AccountFreightClearing AccountUnearned Revenue Account
Payment Terms
For more details on Troubleshooting AutoInvoice Transaction Types, review
Note 1090878.1, Troubleshooting - Transaction Types In Oracle Receivables.
Also you can refer to
Note 1067797.1, Setting Up Transaction Types In Oracle Receivables.
3/17/16, 7:09 PMDocument
Page 18 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
v. Unit of Measure
Unit of Measure is required only when inventory items are passed as part of the interface. When passed, theUnit of Measure is validated to ensure that it exists in the UOM base tables and, if associated to an inventoryitem, that the UOM is consistent with the UOM Class from the inventory item and organization combination. For more on troubleshooting Unit of Measure issues with AutoInvoice, please see
Note 1132807.1 Troubleshooting Unit of Measure Issues with AutoInvoice
w. Commitments
Note 120410.1 Transactions Workbench: Overview of Commitments (Deposits and Guarantees)
7. Environment Issues: Performance, Hardware, Database, Memory or other peripheral issues
AutoInvoice Performance Setup and Troubleshooting is outlined in detail in the following documents:
Note 1089196.1 Troubleshooting AutoInvoice Performance IssuesNote 1083467.1 Setup AutoInvoice for Optimal Performance
8. Fixing Data Issues
As mentioned in the section above on "How AutoInvoice Works", the AutoInvoice import program generates an outputvalidation report when it completes. This report will list out each record that was rejected during import and will thenprovide an error code detailing why the record was rejected. In the example below, the error points to an invalidtransaction type.
This record can be corrected using the Receivables Interface Lines FormResponsibility: Receivables ManagerNavigation: Control > AutoInvoice > Interface Lines
Query the record or records that were rejected using the "Errors Exist" checkbox as your query parameter
3/17/16, 7:09 PMDocument
Page 19 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
To correct the error, navigate back to the lines form and position your cursor on the Line type field, Click on the foldermenu and click on Show field. Doing this will allow you to expose more fields from the table in the form.
3/17/16, 7:09 PMDocument
Page 20 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
To fix this particular error, we want to modify the Transaction Type Id, so locate that field name in the list of values andclick on it.
3/17/16, 7:09 PMDocument
Page 21 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
The Transaction Type Id field will now be displayed to the right of Line type and you can enter the correct ID, and saveyour changes.
3/17/16, 7:09 PMDocument
Page 22 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
If there were multiple errors on a line, you would follow the same process to make corrections to other fields. Once allcorrections are complete you can run AutoInvoice again.
Some other similar errors due to invalid ID values would be:
For more details on execution report Error Messages and how to correct them, refer to Note 1089172.1 TroubleshootingAutoInvoice - Execution Report Errors (Request Status = Complete) For more details on correcting errors when AutoInvoice fails with an error status on the concurrent request, refer to Note1082238.1 Troubleshooting AutoInvoice: Concurrent Request Failures (Request Status = Error)
9. Capturing Debug Logs and Trace Files
There are three primary types of diagnostics:
AutoInvoice Debug LogsFND Debug LogsTrace Files
Note 1079666.1 How to Capture a Debug Log or Trace File for AutoInvoice in 11i and R12 explains how and when to
3/17/16, 7:09 PMDocument
Page 23 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
capture each of these Debug records, what they look like in the log file and shows some examples on how you caninterpret them.
10. Additional Diagnostics
AutoInvoice has numerous diagnostic scripts that are helpful when troubleshooting. The table below lists some of themore useful options
Diagnostic Name Description/Usage
AutoInvoice InterfaceData Collection Script
Lists Invoice interface data, Pro*C file versions and triggers
Oracle ReceivablesAutoInvoice Setup Test
Lists and validates basic set-up of AutoInvoice, triggers, pro*C file versions
Sales Order DiagnosticScript
This script captures all of the important data relating to the order in the Order Entry system
Accounts ReceivableTransaction Diagnostics
Extracts data from all the tables related to a specific AR transaction. Particularly helpfulwhen troubleshooting issues where AI invoices Transactions incorrectly
Customer DiagnosticScript
Extracts data about a specific customer
RDA Extracts file versions for a specific product
Search the catalog applicable to your release for instructions on how to run these scriptsRelease 11i : Note 179661.1Release 12.0.3 Note 464866.1Release 12.0.4: Note 469721.1Release 12.0.6+: Note 741601.1Release 12.1.1 Note 783319.1Release 12.1.2 Note 942527.1
11. Still Have Questions?
To discuss this information further with Oracle experts and industry peers, we encourage you to review, join or start adiscussion in the My Oracle Support Receivables Community.
To provide feedback on this note, click on the Rate this document link.
12. Logging a Service Request
This note and the auxiliary notes referenced within attempt to guide you to resolution of most known issues withAutoInvoice. If you find that you require assistance after completing the steps outlined in this note please provide thefollowing information to expedite resolution of your issue:
3/17/16, 7:09 PMDocument
Page 24 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
1) Can you replicate the same issue with a manual invoice?2) Can you replicate this at will in AutoInvoice?3) Do you have any research findings that would help us in understanding or troubleshooting this issue? If yes what?4) Did this work before? If so what has changed?5) If this is a problem with a specific invoice?
provide the AutoInvoice debug log referenced in Note 1079666.1. provide the AutoInvoice Data Collection Test diagnostic and AutoInvoice Setup diagnostic referenced in Note1079666.1.
REFERENCES
NOTE:1137414.1 - Information Center: Overview of AutoInvoice in Oracle Receivables (AR) 11.5 and laterNOTE:1138254.1 - Listing of AutoInvoice Error Messages and Troubleshooting Tips to Resolve each ErrorNOTE:783319.1 - Oracle E-Business Suite Diagnostics Test Catalog for 12.1.1NOTE:942527.1 - E-Business Suite Diagnostic Tests Catalog for 12.1.2NOTE:1110573.1 - Troubleshooting Credit Memos in the Transaction Workbench and AutoInvoice in ReceivablesNOTE:1112705.1 - AutoInvoice Error: Invalid Salesrep Number (SALESREP_NUMBER)NOTE:1116934.1 - How To Setup And Troubleshoot Invoicing Rules and Accounting RulesNOTE:1117544.1 - E-Business Tax (EBTax) Information CenterNOTE:1098583.1 - Troubleshooting AutoInvoice Receipt Method, Payment Method, Credit Card and Bank Account ErrorsNOTE:1101855.1 - Troubleshooting Remit To Address in Oracle ReceivablesNOTE:1132807.1 - Troubleshooting Unit of Measure Issues with AutoInvoiceNOTE:1146573.1 - Troubleshooting AutoInvoice: "Stuck in the Interface" issues: Interface line not created in AR and noerror is showing in the interfaceNOTE:745968.1 - Troubleshooting AutoInvoice Tax Issues with R12 E-Business Tax (EBTax)NOTE:1228525.1 - How to Import and Troubleshoot Distributions in AutoInvoice UsingRA_INTERFACE_DISTRIBUTIONS_ALLNOTE:1294898.1 - Troubleshooting AutoInvoice: Process Stops Working, No Errors in Log FileNOTE:179661.1 - E-Business Suite Diagnostics 11i Test CatalogNOTE:201241.1 - Troubleshooting AutoInvoice Date Derivation: GL Date, Invoice Date, Due Date, Ship Date, Billing Date,Rule DateNOTE:464866.1 - E-Business Suite Diagnostics Test Catalog for 12.0.3 RUP 3NOTE:1090878.1 - Troubleshooting Transaction Types In Oracle ReceivablesNOTE:1094863.1 - Troubleshooting AutoInvoice: Master Program Issues including Errors, Warnings and When No DataImportsNOTE:1096942.1 - How To Setup Freight For AutoInvoice And The Transactions WorkbenchNOTE:1097660.1 - Troubleshooting AutoInvoice Customer, Address and Contact Errors and ExceptionsNOTE:469721.1 - Oracle E-Business Suite Diagnostics Test Catalog for 12.0.4 (RUP 4)NOTE:741601.1 - Oracle E-Business Suite Diagnostics Test Catalog for 12.0.6 RUP 6NOTE:1083756.1 - Troubleshooting Order Management Invoice Creation Through AutoInvoiceNOTE:1086146.1 - Troubleshooting AutoInvoice Tax Issues with R11.5 (11i) Receivables Tax EngineNOTE:1089196.1 - Troubleshooting AutoInvoice Performance IssuesNOTE:1080995.1 - Troubleshooting AutoAccounting in AutoInvoiceNOTE:1118944.1 - Troubleshooting AutoInvoice - Sales CreditsNOTE:1121944.1 - Understanding and Troubleshooting Revenue Recognition in Oracle ReceivablesNOTE:1127399.1 - Sample PLSQL Script to Call Autoinvoice Import Program RAXTRX UsingFND_REQUEST.SUBMIT_REQUEST in Release 12NOTE:1127413.1 - Understanding And Troubleshooting AutoInvoice Purge Interface TablesNOTE:100435.1 - Listing and Description of AutoInvoice ProgramsNOTE:1084554.1 - Troubleshooting Grouping Rules In AutoInvoice
3/17/16, 7:09 PMDocument
Page 25 of 25https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419
Didn't find what you are looking for?
NOTE:1086155.1 - Troubleshooting Line Ordering in AutoInvoiceNOTE:1086565.1 - How To Setup Document Sequences In ReceivablesNOTE:1087122.1 - Troubleshooting Document Sequences in ReceivablesNOTE:1088132.1 - Troubleshooting Transaction Batch Sources For AutoInvoice and Transactions WorkbenchNOTE:1089026.1 - AutoInvoice Error: Invalid Warehouse ID (WAREHOUSE_ID) (xxx)NOTE:1089172.1 - Troubleshooting Autoinvoice Import - Execution Report Errors (Request Status = Completed)NOTE:1067797.1 - Setting Up Transaction Types In Oracle ReceivablesNOTE:1067965.1 - How to Manage Line Ordering When Using AutoInvoice To Import TransactionsNOTE:1067993.1 - How To Use Grouping Rules With AutoInvoiceNOTE:1075757.1 - Troubleshooting AutoInvoice for Oracle Receivables Release 11.5 Through 12NOTE:1077555.1 - Troubleshooting Transaction Flexfields in AutoInvoiceNOTE:1067402.1 - AutoInvoice Setup for Release 12: A Case Study Using a Simple ScriptNOTE:1079666.1 - How to Capture a Debug Log or Trace File and Diagnostics for AutoInvoice in 11i and R12NOTE:1082238.1 - Troubleshooting AutoInvoice: Concurrent Request Failures (Request Status = Error)NOTE:1083467.1 - How To Setup AutoInvoice For Optimal PerformanceNOTE:1083494.1 - AutoInvoice Errors: Troubleshooting Payment Terms In AutoInvoiceNOTE:1313855.1 - Transactions Workbench: List of Known Issues Regarding Deposits and GuaranteesNOTE:120410.1 - Transactions Workbench: Overview of Commitments (Deposits and Guarantees)