auto invioce

25
3/17/16, 7:09 PM Document Page 1 of 25 https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=15bmmwf0pl_419 Troubleshooting AutoInvoice for Oracle Receivables Release 11.5 Through 12 (Doc ID 1075757.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

Upload: conrad-rodricks

Post on 05-Apr-2017

113 views

Category:

Technology


0 download

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)