API Invoice
API Invoice
API Invoice
December 2006
Oracle Receivables Reference Guide, Release 12 Part No. B31213-01 Copyright 1988, 2006, Oracle. All rights reserved. Primary Author: Charles Ahern, Stephen R. Damiani, Melanie Heisler, Essan Ni Jirman, Shivranjini Krishnamurthy, Robert MacIsaac, Kristin Penaskovic, Vijay Tiwary The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose. If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs. The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party. Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
Contents
iii
iv
XML Transactions
XML Receivables Documents Mapping................................................................................... D-1 Process Invoice XML Message Map.................................................................................... D-1 Confirm BOD Message Map................................................................................................D-5 Transaction Limitations....................................................................................................... D-6
Index
Send Us Your Comments
Oracle Receivables Reference Guide, Release 12
Part No. B31213-01
Oracle welcomes customers' comments and suggestions on the quality and usefulness of this document. Your feedback is important, and helps us to best meet your needs as a user of our products. For example: Are the implementation steps correct and complete? Did you understand the context of the procedures? Did you find any errors in the information? Does the structure of the information help you with your tasks? Do you need different information or graphics? If so, where, and in what format? Are the examples correct? Do you need more examples?
If you find any errors or have any other suggestions for improvement, then please tell us your name, the name of the company who has licensed our products, the title and part number of the documentation and the chapter, section, and page number (if available). Note: Before sending us your comments, you might like to check that you have the latest version of the document and if any concerns are already addressed. To do this, access the new Applications Release Online Documentation CD available on Oracle MetaLink and www.oracle.com. It contains the most current Documentation Library plus all documents revised or released recently. Send your comments to us using the electronic mail address: appsdoc_us@oracle.com Please give your name, address, electronic mail address, and telephone number (optional). If you need assistance with Oracle software, then please contact your support representative or Oracle Support Services. If you require training or instruction in using Oracle software, then please contact your Oracle local office and inquire about our Oracle University offerings. A list of Oracle offices is available on our Web site at www.oracle.com.
vii
Preface
Intended Audience
Welcome to Release 12 of the Oracle Receivables Reference Guide. This guide assumes you have a working knowledge of the following: The principles and customary practices of your business area. Computer desktop application usage and terminology
If you have never used Oracle Applications, we suggest you attend one or more of the Oracle Applications training classes available through Oracle University. See Related Information Sources on page x for more Oracle Applications product information.
Documentation Accessibility
Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site
ix
at http://www.oracle.com/accessibility/ .
Structure
1 Using Oracle Receivables APIs 2 Adjustment API User Notes 3 Credit Memo Approval and Creation API User Notes 4 Credit Memo Application API User Notes 5 Deposit API User Notes 6 Invoice Creation API User Notes 7 Prepayments API User Notes 8 Receipt API User Notes 9 Revenue Adjustment API User Notes A Predefined Setup for Oracle Subledger Accounting B Oracle Receivables Table and Column Descriptions C Seeded Match Rules D XML Transactions
394692.1. Online Documentation All Oracle Applications documentation is available online (HTML or PDF). PDF - PDF documentation is available for download from the Oracle Technology Network at http://otn.oracle.com/documentation. Online Help - Online help patches (HTML) are available on OracleMetaLink. Oracle MetaLink Knowledge Browser - The OracleMetaLink Knowledge Browser lets you browse the knowledge base, from a single product page, to find all documents for that product area. Use the Knowledge Browser to search for release-specific information, such as FAQs, recent patches, alerts, white papers, troubleshooting tips, and other archived documents. Oracle eBusiness Suite Electronic Technical Reference Manuals - Each Electronic Technical Reference Manual (eTRM) contains database diagrams and a detailed description of database tables, forms, reports, and programs for a specific Oracle Applications product. This information helps you convert data from your existing applications and integrate Oracle Applications data with non-Oracle applications, and write custom reports for Oracle Applications products. Oracle eTRM is available on OracleMetaLink.
Related Guides You should have the following related books on hand. Depending on the requirements of your particular installation, you may also need additional manuals or guides. Oracle Applications Installation Guide: Using Rapid Install: This book is intended for use by anyone who is responsible for installing or upgrading Oracle Applications. It provides instructions for running Rapid Install either to carry out a fresh installation of Oracle Applications Release 12, or as part of an upgrade from Release 11i to Release 12. The book also describes the steps needed to install the technology stack components only, for the special situations where this is applicable. Oracle Applications Upgrade Guide: Release 11i to Release 12: This guide provides information for DBAs and Applications Specialists who are responsible for upgrading a Release 11i Oracle Applications system (techstack and products) to Release 12. In addition to information about applying the upgrade driver, it outlines pre-upgrade steps and post-upgrade steps, and provides descriptions of product-specific functional changes and suggestions for verifying the upgrade and reducing downtime. Oracle Applications Patching Procedures: This guide describes how to patch the Oracle Applications file system and database using AutoPatch, and how to use other patching-related tools like AD Merge Patch, OAM Patch Wizard, and OAM Registered Flagged Files. Describes patch types and
xi
structure, and outlines some of the most commonly used patching procedures. Part of Maintaining Oracle Applications, a 3-book set that also includes Oracle Applications Maintenance Utilities and Oracle Applications Maintenance Procedures. Oracle Applications Maintenance Utilities: This guide describes how to run utilities, such as AD Administration and AD Controller, used to maintain the Oracle Applications file system and database. Outlines the actions performed by these utilities, such as monitoring parallel processes, generating Applications files, and maintaining Applications database entities. Part of Maintaining Oracle Applications, a 3-book set that also includes Oracle Applications Patching Procedures and Oracle Applications Maintenance Procedures. Oracle Applications Maintenance Procedures: This guide describes how to use AD maintenance utilities to complete tasks such as compiling invalid objects, managing parallel processing jobs, and maintaining snapshot information. Part of Maintaining Oracle Applications, a 3-book set that also includes Oracle Applications Patching Procedures and Oracle Applications Maintenance Utilities. Oracle Alert User's Guide: This guide explains how to define periodic and event alerts to monitor the status of your Oracle Applications data. Oracle Application Framework Developer's Guide: This guide contains the coding standards followed by the Oracle Applications development staff to produce applications built with Oracle Application Framework. This guide is available in PDF format on OracleMetaLink and as online documentation in JDeveloper 10g with Oracle Application Extension. Oracle Application Framework Personalization Guide: This guide covers the design-time and run-time aspects of personalizing applications built with Oracle Application Framework. Oracle Applications Concepts: This book is intended for all those planning to deploy Oracle E-Business Suite Release 12, or contemplating significant changes to a configuration. After describing the Oracle Applications architecture and technology stack, it focuses on strategic topics, giving a broad outline of the actions needed to achieve a particular goal, plus the installation and configuration choices that may be available. Oracle Applications Flexfields Guide: This guide provides flexfields planning, setup, and reference information for the Oracle Applications implementation team, as well as for users responsible for the ongoing maintenance of Oracle Applications product data. This guide also provides information on creating custom reports on flexfields data. Oracle Applications Multiple Organizations Implementation Guide:
xii
This guide describes the multiple organizations concepts in Oracle Applications. It describes in detail on setting up and working effectively with multiple organizations in Oracle Applications. Oracle Applications Supportability Guide: This manual contains information on Oracle Diagnostics and the Logging Framework for system administrators and custom developers. Oracle Applications System Administrator's Guide Documentation Set: This documentation set provides planning and reference information for the Oracle Applications System Administrator. Oracle Applications System Administrator's Guide Configuration contains information on system configuration steps, including defining concurrent programs and managers, enabling Oracle Applications Manager features, and setting up printers and online help. Oracle Applications System Administrator's Guide - Maintenance provides information for frequent tasks such as monitoring your system with Oracle Applications Manager, managing concurrent managers and reports, using diagnostic utilities, managing profile options, and using alerts. Oracle Applications System Administrator's Guide - Security describes User Management, data security, function security, auditing, and security configurations. Oracle Applications User's Guide: This guide explains how to navigate, enter data, query, and run reports using the user interface (UI) of Oracle Applications. This guide also includes information on setting user profiles, as well as running and reviewing concurrent requests. Oracle Integration Repository User's Guide: This guide covers the employment of Oracle Integration Repository in researching and deploying business interfaces to produce integrations between applications. Oracle Workflow Administrator's Guide: This guide explains how to complete the setup steps necessary for any product that includes workflow-enabled processes. It also describes how to manage workflow processes and business events using Oracle Applications Manager, how to monitor the progress of runtime workflow processes, and how to administer notifications sent to workflow users. Oracle Workflow Developer's Guide: This guide explains how to define new workflow business processes and customize existing Oracle Applications-embedded workflow processes. It also describes how to define and customize business events and event subscriptions. Oracle Workflow User's Guide: This guide describes how users can view and respond to workflow notifications and monitor the progress of their workflow processes. Oracle Workflow API Reference: This guide describes the APIs provided for developers and administrators to access
xiii
Oracle Workflow. Oracle Financials and Oracle Procurement Functional Upgrade Guide: Release 11i to Release 12: This guides provides detailed information about the functional impacts of upgrading Oracle Financials and Oracle Procurement products from Release 11i to Release 12. This guide supplements the Oracle Applications Upgrade Guide: Release 11i to Release 12. Oracle Financials Concepts Guide: This guide describes the fundamental concepts of Oracle Financials. The guide is intended to introduce readers to the concepts used in the applications, and help them compare their real world business, organization, and processes to those used in the applications. Oracle Financials Glossary: The glossary includes definitions of common terms that are shared by all Oracle Financials products. In some cases, there may be different definitions of the same term for different Financials products. If you are unsure of the meaning of a term you see in an Oracle Financials guide, please refer to the glossary for clarification. You can find the glossary in the online help or in the Oracle Financials Implementation Guide. Oracle Financials Implementation Guide: This guide provides information on how to implement the Oracle Financials E-Business Suite. It guides you through setting up your organizations, including legal entities, and their accounting, using the Accounting Setup Manager. It covers intercompany accounting and sequencing of accounting entries, and it provides examples. Oracle E-Business Tax User Guide: This guide describes the entire process of setting up and maintaining tax configuration data, as well as applying tax data to the transaction line. It describes the entire regime-to-rate setup flow of tax regimes, taxes, statuses, rates, recovery rates, tax jurisdictions, and tax rules. It also describes setting up and maintaining tax reporting codes, fiscal classifications, tax profiles, tax registrations, configuration options, and third party service provider subscriptions. You also use this manual to maintain migrated tax data for use with E-Business Tax. Oracle E-Business Tax Implementation Guide: This guide provides a conceptual overview of the E-Business Tax tax engine, and describes the prerequisite implementation steps to complete in other applications in order to set up and use E-Business Tax. The guide also includes extensive examples of setting up country-specific tax requirements. Oracle E-Business Tax Reporting Guide: This guide explains how to run all tax reports that make use of the E-Business Tax data extract. This includes the Tax Reporting Ledger and other core tax reports, country-specific VAT reports, and Latin Tax Engine reports. Oracle E-Business Tax: Vertex Q-Series and Taxware Sales/Use Tax System
xiv
Implementation Guide This guide explains how to setup and use the services of third party tax service providers for US Sales and Use tax. The tax service providers are Vertex Q-Series and Taxware Sales/Use Tax System. When implemented, the Oracle E-Business Tax service subscription calls one of these tax service providers to return a tax rate or amount whenever US Sales and Use tax is calculated by the Oracle E-Business Tax tax engine. This guide provides setup steps, information about day-to-day business processes, and a technical reference section. Oracle General Ledger Implementation Guide: This guide provides information on how to implement Oracle General Ledger. Use this guide to understand the implementation steps required for application use, including how to set up Accounting Flexfields, Accounts, and Calendars. Oracle General Ledger Reference Guide This guide provides detailed information about setting up General Ledger Profile Options and Applications Desktop Integrator (ADI) Profile Options. Oracle General Ledger User's Guide: This guide provides information on how to use Oracle General Ledger. Use this guide to learn how to create and maintain ledgers, ledger currencies, budgets, and journal entries. This guide also includes information about running financial reports. Oracle iReceivables Implementation Guide: This guide provides information on how to implement Oracle iReceivables. Use this guide to understand the implementation steps required for application use, including how to set up and configure iReceivables, and how to set up the Credit Memo Request workflow. There is also a chapter that provides an overview of major features available in iReceivables. Oracle Order Management Documentation Set: Use the Oracle Order Management User's Guide and Oracle Order Management Implementation Manual to learn about credit checking and credit usage rule sets. Oracle Public Sector Financials User Guide: This guide describes how to set up and administer Oracle Public Sector Advanced Features. It describes Encumbrance Reconciliation Reports, GASB 34/35 Asset Accounting, and Funds Available Enhancements. Oracle Receivables Implementation Guide: This guide provides you with information on how to implement Oracle Receivables. Use this guide to understand the implementation steps required for application use, including how to set up customers, transactions, receipts, accounting, tax, and collections. This guide also includes a comprehensive list of profile options that you can set to customize application behavior. Oracle Receivables User Guide:
xv
This guide provides you with information on how to use Oracle Receivables. Use this guide to learn how to create and maintain transactions and bills receivable, enter and apply receipts, enter customer information, and manage revenue. This guide also includes information about accounting in Receivables. Use the Standard Navigation Paths appendix to find out how to access each Receivables window. Oracle Subledger Accounting Implementation Guide: This guide provides setup information for Oracle Subledger Accounting features, including the Accounting Methods Builder. You can use the Accounting Methods Builder to create and modify the setup for subledger journal lines and application accounting definitions for Oracle subledger applications. This guide also discusses the reports available in Oracle Subledger Accounting and describes how to inquire on subledger journal entries. Oracle Trading Community Architecture User Guide: This guide describes the Oracle Trading Community Architecture (TCA) and how to use features from the Trading Community Manager responsibility to create, update, enrich, and cleanse the data in the TCA Registry. It also describes how to use Resource Manager to define and manage resources. Oracle Trading Community Architecture Administration Guide: This guide describes how to administer and implement Oracle Trading Community Architecture (TCA). You set up, control, and manage functionality that affects data in the TCA Registry. It also describes how to set up and use Resource Manager to manage resources. Oracle Trading Community Architecture Reference Guide: This guide contains seeded relationship types, seeded Data Quality Management data, D and B data elements, Bulk Import interface table fields and validations, and a comprehensive glossary. This guide supplements the documentation for Oracle Trading Community Architecture and all products in the Oracle Customer Data Management family. Oracle Trading Community Architecture Technical Implementation Guide: This guide explains how to use the public Oracle Trading Community Architecture application programming interfaces (APIs) and develop callouts based on Oracle Workflow Business Events System (BES). For each API, this guide provides a description of the API, the PL/SQL procedure, and the Java method, as well as a table of the parameter descriptions and validations. For each BES callout, this guide provides the name of the logical entity, its description, and the ID parameter name. Also included are setup instructions and sample code.
Integration Repository
The Oracle Integration Repository is a compilation of information about the service endpoints exposed by the Oracle E-Business Suite of applications. It provides a complete catalog of Oracle E-Business Suite's business service interfaces. The tool lets
xvi
users easily discover and deploy the appropriate business service interface for integration with any system, application, or business partner. The Oracle Integration Repository is shipped as part of the E-Business Suite. As your instance is patched, the repository is automatically updated with content appropriate for the precise revisions of interfaces in your environment.
xvii
1
Using Oracle Receivables APIs
This chapter covers the following topics: Major Features Solution Outline
Major Features
Before you begin....
Initialization of ARP_STANDARD and ARP_GLOBAL Custom code that uses AR or HZ APIs will set the ORG_ID via dbms_application_info.set_client_info() and then call the APIs. The APIs in turn might access either ARP_STANDARD and ARP_GLOBAL, which initialize the global variables that are used across Oracle Receivables when the package is first called. Most of these global variable values are organization dependent, and the first such call sets the global variables based on the current ORG_ID. If additional custom code then changes the ORG_ID via another call to dbms_application_info.set_client_info(), then the ORG context changes, but the ARP_STANDARD and ARP_GLOBAL context does not. In such cases, you should explicitly re-initialize the global variables by a call to these two public procedures:
1. 2.
ARP_GLOBAL.INIT_GLOBAL: For setting public variables in ARP_GLOBAL. ARP_STANDARD.INIT_STANDARD: For setting public variables in ARP_STANDARD.
Flexibility
Per Oracle API coding standards, the various Oracle Receivables APIs let you specify an
ID or its associated value for any attribute that is an INPUT parameter of the API. If both an ID and value have been specified, then the ID takes precedence over the value. This provides a wide degree of flexibility when using the API, both as a base table of the form and as a server-side routine call from the PL/SQL code. The extensive defaulting mechanism for the input parameters ensures that you will be able to achieve your basic business needs by calling the relevant APIs with a minimum number of parameters. This gives you many options to achieve your requirements when you call the relevant API.
Modular Approach
The API has been designed in a highly modular fashion, resulting in code that is: Easy to understand Easy to maintain Easy to expand
Error Handling
Oracle Receivables APIs provide an extensive error-handling and error-reporting mechanism whereby all errors encountered in the Defaulting and Validation phases are reported and put on the message stack. The calling program can look up all error messages, or the first error message on the stack. If only one error exists on the message stack, then you do not need to fetch the message from the stack because the message will return as one of the output parameters of the API routine.
Robust Validation
The validations that Oracle Receivables APIs perform are robust in nature. The APIs collect all encountered validation errors and put them on the message stack. The relevant entity handler is called only if no errors are reported during the Defaulting and Validation phases.
Debug Messages
Extensive debug messages have been incorporated to simplify the troubleshooting process when problems are encountered with any API. Debug messages can be written to the log file by calling the appropriate routines described in Exception Handling and Result Messages, page 1-3.
Solution Outline
Modular Approach
To modularize an API, the basic structure of the API is divided into four parts:
1.
Defaulting the IDs from the values and cross validating, if you provide both the values and the IDs. Defaulting all the entity level information, which you have not entered or which the API needs internally. Validating the entity level information that you entered. Calling to the entity handlers to perform the relevant task.
2.
3. 4.
This results in code that is easy to understand and easy to maintain. Any new functionality can be added by a simple code plug-in at each of the four parts.
Defaulting
In general, the various parameters in each API call get defaulted, if not entered, based on the following: Values of the other parameters in the API call Values set in the AR_SYSTEM_PARAMETERS table entered through the System Options form Relevant profile option values
Depending on the above three factors and the exact business requirement, the minimum number of parameters required to perform certain business tasks may vary. Null values are defaulted for the parameters that could not be defaulted by the API defaulting routines. For various attributes of the business objects, you can pass either the ID or the value of the attribute. If you specify only the value, then the value is used to derive the ID; otherwise, the ID (if specified) is taken directly. If you specify both the ID and the value, then the ID takes precedence over the value and a warning message informs you of this.
Overall status Messages describing the operations performed or errors encountered by the APIs Some output values that the API caller might want to use (this is different for different API routines and is described in each API's relevant chapter, in the API Usage section).
Return Status
The return status (x_return_status) of the API informs the caller about the result of the operation (or operations) performed by the API. The different possible values for an API return status are: Success (FND_API.G_RET_STS_SUCCESS) Error (FND_API.G_RET_STS_ERROR) Unexpected error (FND_API.G_RET_STS_UNEXP_ERROR)
The following section describes the different values of return status and their meanings. Success A success return status means that the API was able to perform all the operations requested by its caller. A success return status may be accompanied by informative messages in the API message list. Error An error return status means that the API failed to perform some or all of the operations requested by its caller. An error return status is usually accompanied by messages describing the error (or errors) and how to fix it. In most cases, you should be able to take corrective action to fix regular, expected errors such as missing attributes or invalid date ranges. Unexpected error An unexpected error status means that the API has encountered an error condition it did not expect or could not handle. In this case, the API is unable to continue with its regular processing. Examples of such errors are irrecoverable data inconsistency errors, memory errors, and programming errors (such as attempting a division by zero). In most cases, only system administrators or application developers can fix these unexpected errors.
Messages
The APIs put result messages into a message list. Programs calling the APIs can then get the messages from the list and process them by issuing them, loading them into a database table, or writing them to a log file.
Messages are stored in an encoded format to let the API callers find message names using the standard functions provided by the message dictionary. It also allows the storing of these messages in database tables and reporting off these tables in different languages. The API message list must be initialized every time a program calls an API. API callers can either call the message list utility function FND_MSG_PUB.Initialize or request that the API do the initialization on their behalf by setting the p_init_msg_list parameter to TRUE. The program calling the API can retrieve messages from the message stack using the existing FND API functions FND_MSG_PUB.Count_Msg and FND_MSG_PUB.Get. Message Level Threshold The message level threshold is stored in a profile option named FND_API_MSG_LEVEL_THRESHOLD. This profile option can be updated at all levels (site, application, or user). The API checks against this threshold before writing a message to the API message list.
Debug Messages
You must enable debugging by calling the routine arp_standard.enable_file_debug. The routine requires 2 parameters: path_name and file_name.
arp_standard.enable_file_debug(<pathname>, <filename>)
The path name can be identified by using the following select statement:
select value from v$parameter where name = 'utl_file_dir',
The file name can be any name that you choose. Example
arp_standard.enable_file_debug ('/sqlcom/log','txt.log')
This call would write the output debug file 'txt.log' in the path '/sqlcom/log'.
2
Adjustment API User Notes
This chapter covers the following topics: Overview API Usage Messages
Overview
This document outlines the use of the Adjustment API. This API allows users to create, approve, update, and reverse adjustments for invoices using simple calls to PL/SQL functions. The Adjustment API is not intended to replace the existing Adjustment form, Adjustment Approval form, or the batch Auto-Adjust program.
Note: The Adjustment API requires the following receivable activity
You can access the API in two ways: With standard PL/SQL servers-side routine calls Through Forms, using the capability of Forms6 to have a procedure as its underlying base table.
API Usage
To create, modify, approve, or reverse adjustments, use the following routines: Ar_Adjust_pub.Create_Adjustment, page 2-3: Use this routine to create an adjustment for an invoice.
Ar_Adjust_pub.Modify_Adjustment, page 2-17: Use this routine to modify an adjustment's status, comments, and reason code.
Note: If the existing status of the adjustment is A or R, then it
cannot be modified.
Ar_Adjust_pub.Approve_Adjustment, page 2-12: Use this routine to approve an adjustment. Ar_Adjust_pub.Reverse_Adjustment, page 2-22: Use this routine to reverse an adjustment.
The Adjustment API has a defaulting mechanism for input parameters. This lets you create, approve, update, and reverse adjustments while passing a minimal number of API parameters.
Note: You can pass an adjustment account and override the default
account (derived from the adjustment's receivable activity), provided that: The GL account source on the adjustment's receivable activity is Activity and the tax code source is None. The AR: Override Adjustment Activity Account Option profile option is set to Yes.
The following table shows standard API parameters that are common to all routines in the Adjustment API:
Parameter Typ e IN Data-type Require d Yes Default Value Description
p_api_version
NUMBER
Used to compare version numbers of incoming calls to its current version number. Allows API callers to request that the API does initialization of the message list on their behalf. Used by API callers to ask the API to commit on their behalf.
p_init_msg_list
IN
VARCHAR2
FND_API.G_FALSE
p_commit
IN
VARCHAR2
FND_API.G_FALSE
Parameter
Typ e IN
Data-type
Require d
Default Value
Description
p_validation_level
NUMBER
FND_API.G_VALID_ LEVEL_FULL
Not currently for use by the user. Allow this parameter to default. Represents the API overall return status. For possible values, see Error Handling, page 1-2. Number of messages in the API message list This is the message in encoded format if p_msg_count=1
p_return_status
OUT
VARCHAR2
p_msg_count
OUT
NUMBER
p_msg_data
OUT
VARCHAR2
Ar_Adjust_pub.Create_Adjustment
Use this routine to create adjustments to invoices. The API returns the Out parameter p_new_adjust_id, which represents the newly-created adjustment ID. The following is a breakdown of parameters for this routine, divided according to parameter type:
Input Parameters
Standard API parameters: 4 Create Adjustment parameters: 6 required parameters (might vary depending on the adjustment type)
Output Parameters
Standard API parameters: 3 Create Adjustment parameters: 2 Since the Create Adjustment API allows users to pass the adjustment record type to the procedure, it is not recommended that users enter values for unnecessary fields. These fields could be populated for internal use only.
Parameter Descriptions
The following table lists parameters that pertain specifically to the Create Adjustment routine:
Parameter p_adj_rec.type
Type IN
Data-type VARCHAR 2
Required Yes
Default Value
Description The type of adjustment to be created. Possible Values: 'INVOICE', 'LINE', 'TAX', 'FREIGHT', 'CHARGES', 'FINCHRG' Payment Schedule id of the transaction for which the transaction is to be created. If the adjustment type is any other value than 'INVOICE' then this is a required field. The amount indicates the amount to be adjusted. If the adjustment type is 'LINE' then the customer_trx_line_id indicates the line to be adjusted. For all the other adjustment types the value is not required. The id of the activity name (from ar_receivables_trx) should be passed. The code combination id is not required. If the value is not passed, then the default is the code combination id specified in the receivables_trx_id record. If the value passed is not the same as the code_combination_id and the AR: Override Adjustment Activity Account Option profile option is set to No, then this would error out. The apply date should be equal to or greater than the transaction date. The gl date should be equal to or greater than the transaction gl date, and the date should be from the open/future period.
p_adj_rec.payme nt_schedule_id
IN
NUMBER
Yes
p_adj_rec.amoun t
IN
NUMBER
Yes/No
p_adj_rec.custo mer_trx_line_id
IN
NUMBER
Yes/No
IN
NUMBER
Yes
IN
NUMBER
No
IN
DATE
Yes
IN
DATE
Yes
Type IN
Data-type VARCHAR 2
Required No
Default Value
Description The reason code should a valid reason code in ar_lookups with lookup_type = 'ADJUST_REASON'. The user can enter comments, up to 2000 bytes, for creating the adjustments which could be useful for the user, for future reference. The associated cash receipt id is the id of a valid cash receipt, and is to be associated with the adjustment. The USSGL transaction code should be a valid USSGL transaction code in gl_ussgl_transaction_codes. Some value that indicates to the user that it was created through the Adjustment API. Eg. 'ADJ-API' This attribute_category and the attribute1 through attribute15 can be entered if the user want to enter the details of the descriptive flexfield for the adjustment.
p_adj_rec.comm ents
IN
VARCHAR 2
No
IN
NUMBER
No
IN
VARCHAR 2
No
p_adj_rec.create d_from
IN
VARCHAR 2
Yes
IN
VARCHAR 2
No
IN
No. Entered values will be overwritte n. No. Entered values will be overwritte n.
p_adj_rec.acctd_ amount
IN
Type IN
Data-type
Required No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n.
Default Value
Description
p_adj_rec.set_of_ books_id
IN
p_adj_rec.adjust ment_type
IN
p_adj_rec.status
IN
p_adj_rec.line_a djusted
IN
p_adj_rec.freight _adjusted
IN
Type IN
Data-type
Required No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n.
Default Value
Description
IN
p_adj_rec.batch_ id
IN
p_adj_rec.custo mer_trx_id
IN
p_adj_rec.subseq uent_trx_id
IN
IN
Type IN
Data-type
Required No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n.
Default Value
Description
p_adj_rec.associa ted_application_i d
IN
p_adj_rec.autom atically_generate d
IN
p_adj_rec.postab le
IN
p_adj_rec.appro ved_by
IN
p_adj_rec.adjust ment_number
IN
Type IN
Data-type
Required No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n.
Default Value
Description
p_adj_rec.doc_se quence_id
IN
p_adj_rec.postin g_control_id
IN
p_adj_rec.last_u pdated_by
IN
p_adj_rec.last_u pdated_date
IN
p_adj_rec.last_u pdated_login
IN
Type IN
Data-type
Required No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No. Entered values will be overwritte n. No.
Default Value
Description
p_adj_rec.creatio n_date
IN
p_adj_rec.progra m_application_i d
IN
p_adj_rec.progra m_id
IN
p_adj_rec.progra m_update_date
IN
IN
IN
VARCHAR 2
No.
FND_API.G_ TRUE
This value can be set to 'F' if the adjusted amount should not be validated against the users approval limit.
Type IN
Data-type VARCHAR 2 VARCHAR 2 ar_adjustm ent.adjustm ent_numbe r%type ar_adjustm ent.adjustm ent_id%typ e VARCHAR 2
Required No.
Default Value Y
IN
No.
FND_API.G_ TRUE
This value should never be set to 'F'. It is used for some internal logic. If the adjustment is created successfully, then this parameter will contain the value of the new adjustment number. If the adjustment is created successfully, then this parameter will contain the value of the new adjustment id. This flag is only used for BR.
p_new_adjust_n umber
OUT
p_new_adjust_id
OUT
p_called_from
IN
No
NULL
Note: If the user passes values for any parameter not reported in the
table above, then those values will be ignored and will not show up in the record.
Default values for API parameters derive from the following: Values of the other parameters in the API call Values set in the ar_system_parameters table entered through the System Options form Relevant profile option values
Depending on the user's particular business needs, the minimum number of parameters required to create an adjustment may vary.
Example
The following is the simplest test case for creating an adjustment. Objective: To create an adjustment, passing the minimum number of parameters. Entered parameters: p_adj_rec.type = 'INVOICE', p_adj_rec.payment_schedule_id = 22222, p_adj_rec.receivables_trx = 15, p_adj_rec.apply_date = to_date('12-FEB-00', 'DD-MON-RR'), p_adj_rec.gl_date = to_date('12-FEB-00', 'DD-MON-RR'), p_adj_rec.created_from = 'ADJ-API' Call to the API:
AR_ADJUST_PUB.Create_Adjustment( p_api_name => 'AR_ADJUST_PUB', p_api_version => 1.0, p_msg_count => msg_count , p_msg_data => msg_data, p_return_status => return_status, p_adj_rec => adj_rec, p_new_adjust_number => new_adj_num, p_new_adjust_id => new_adj_id );
Result: Creates an adjustment, passing two standard required parameters and six adjustment record related parameters.
Ar_Adjust_pub.Approve_Adjustment
Use this routine to approve an adjustment. The following is a breakdown of parameters for this routine, divided according to parameter type:
Input Parameters
Standard API parameters: 4 Approve Adjustment parameters: 1 required parameter
Output Parameters
Standard API parameters: 3
Parameter Descriptions
Although the Approve Adjustments API allows users to pass the adjustment record
type to the procedure, all the values are overwritten by the values in the existing adjustment record except for the status and gl_date. The following table shows parameters that pertain specifically to the Approve Adjustment routine.
Note: If required parameters are not passed in a call to this API, then
the call will fail. If values are not required, then the values for those fields will be copied from the existing values of the adjustment.
Parameter
Type
Data-type
Require d Yes
Default Value
Description
p_old_adjust_id
IN
NUMBER
p_adj_rec.type p_adj_rec.payme nt_schedule_id p_adj_rec.amoun t p_adj_rec.custo mer_trx_line_id p_adj_rec.receiva bles_trx_id p_adj_rec.code_c ombination_id p_adj_rec.apply_ date p_adj_rec.gl_dat e
IN IN
VARCHAR2 NUMBER
No No
IN
NUMBER
No
IN
NUMBER
No
IN
NUMBER
No
IN
NUMBER
No
IN
DATE
No
IN
DATE
No
GL date of adjustment
The GL date should be entered if it is going to be different from the one in the old adjustment.
p_adj_rec.reason _code
IN
VARCHAR2
No
Parameter
Type
Data-type
Require d No
Default Value
Description
p_adj_rec.comm ents p_adj_rec.associa ted_cash_receipt _id p_adj_rec.ussgl_t ransaction_code p_adj_rec.create d_from p_adj_rec.attribu te_category, p_adj_rec.attribu te1 p_adj_rec.attribu te15 p_adj_rec.adjust ment_id p_adj_rec.acctd_ amount p_adj_rec.gl_pos ted_date p_adj_rec.set_of_ books_id p_adj_rec.adjust ment_type p_adj_rec.status
IN
VARCHAR2
IN
NUMBER
No
IN
VARCHAR2
No
IN
VARCHAR2
No
IN
VARCHAR2
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
p_adj_rec.line_a djusted
IN
No
Parameter
Type
Data-type
Require d No
Default Value
Description
p_adj_rec.freight _adjusted p_adj_rec.tax_ad justed p_adj_rec.receiva bles_chages_adj usted p_adj_rec.batch_ id p_adj_rec.custo mer_trx_id p_adj_rec.subseq uent_trx_id p_adj_rec.charge back_customer_t rx_id p_adj_rec.distrib ution_set_id p_adj_rec.associa ted_application_ id p_adj_rec.autom atically_generate d p_adj_rec.postab le p_adj_rec.appro ved_by
IN
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
Parameter
Type
Data-type
Require d No
Default Value
Description
p_adj_rec.adjust ment_nu,mber p_adj_rec.doc_se quence_value p_adj_rec.doc_se quence_id p_adj_rec.postin g_control_id p_adj_rec.last_u pdated_by p_adj_rec.last_u pdated_date p_adj_rec.last_u pdated_login p_adj_rec.create d_by p_adj_rec.creatio n_date p_adj_rec.progra m_application_i d p_adj_rec.progra m_id p_adj_rec.progra m_update_date p_adj_rec.reques t_id
IN
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
Parameter
Type
Data-type
Require d No
Default Value
Description
p_chk_approval _limits
IN
VARCHAR2
FND_API.G_T RUE
This value can be set to 'F' if the adjusted amount should not be validated against the users approval limit. This flag is used only for Bills Receivable.
p_move_deferre d_tax
IN
VARCHAR2
No
Example
The following is the simplest test case for approving an adjustment. Objective: To approve an adjustment, passing the minimum number of parameters. Entered parameters: adjustment_id = 88888; Call to the API:
AR_ADJUST_PUB.Approve_Adjustment( p_api_name => 'AR_ADJUST_PUB', p_api_version => 1.0, p_msg_count => msg_count , p_msg_data => msg_data, p_return_status => return_status, p_old_adjust_id => adjustment_id );
Result: Approves an adjustment, passing 2 standard required parameters and 1 adjustment record parameter.
Ar_Adjust_pub.Modify_Adjustment
Use this routine to update an adjustment. The attributes that can be modified are comments, gl date, and status. If the status of the adjustment is already 'A' (i.e. the adjustment has already been approved), then you cannot update the adjustment. The following is a breakdown of parameters for this routine, divided according to parameter type:
Input Parameters
Standard API parameters: 4 Modify Adjustment parameters: 1 required parameter
Output Parameters
Standard API parameters: 3
Parameter Descriptions
Although the Modify Adjustments API allows users to pass the adjustment record type to the procedure, all the values are overwritten by the existing adjustment record except for the status, comments, and gl_date. The following table shows parameters that pertain specifically to the Modify Adjustments routine.
Note: If required parameters are not passed in a call to this API, then
the call will fail. If values are not required, then the values for those fields will be copied from the existing values of the adjustment.
Parameter
Type
Data-type
Required
Default Value
Description
p_old_adjust_id
IN
NUMBER
Yes
P_adj_rec.type p_adj_rec.payment_ schedule_id p_adj_rec.amount p_adj_rec.customer _trx_line_id p_adj_rec.receivabl es_trx_id p_adj_rec.code_com bination_id
IN IN
VARCHAR2 NUMBER
No No
IN IN
NUMBER NUMBER
No No
IN
NUMBER
No
IN
NUMBER
No
Parameter
Type
Data-type
Required
Default Value
Description
p_adj_rec.apply_da te p_adj_rec.gl_date
IN
DATE
No
IN
DATE
No
GL date of adjustment
The GL date should be entered if the user wishes to modify the existing gl date of the adjustment.
P_adj_rec.reason_co de p_adj_rec.comment s
IN
VARCHAR2
No
IN
VARCHAR2
No
The comments should be entered if the user wishes to modify the existing comments of the adjustment.
P_adj_rec.associate d_cash_receipt_id p_adj_rec.ussgl_tra nsaction_code p_adj_rec.created_f rom p_adj_rec.attribute_ category, p_adj_rec.attribute1 p_adj_rec.attribute1 5 p_adj_rec.adjustme nt_id p_adj_rec.acctd_am ount p_adj_rec.gl_posted _date p_adj_rec.set_of_bo oks_id
IN
NUMBER
No
IN
VARCHAR2
No
IN
VARCHAR2
No
IN
VARCHAR2
No
IN
No
IN
No
IN
No
IN
No
Parameter
Type
Data-type
Required
Default Value
Description
IN
No
IN
No
The status should be entered if the user wishes to change the existing status of the adjustment. Possible Value: 'A', 'R', 'M', 'W'.
p_adj_rec.line_adju sted p_adj_rec.freight_a djusted p_adj_rec.tax_adjus ted p_adj_rec.receivabl es_chages_adjusted p_adj_rec.batch_id p_adj_rec.customer _trx_id p_adj_rec.subseque nt_trx_id p_adj_rec.chargeba ck_customer_trx_id p_adj_rec.distributi on_set_id p_adj_rec.associate d_application_id p_adj_rec.automatic ally_generated p_adj_rec.postable
IN
No
IN
No
IN
No
IN
No
IN IN
No No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
Parameter
Type
Data-type
Required
Default Value
Description
p_adj_rec.approved _by p_adj_rec.adjustme nt_nu,mber p_adj_rec.doc_sequ ence_value p_adj_rec.doc_sequ ence_id p_adj_rec.posting_c ontrol_id p_adj_rec.last_upda ted_by p_adj_rec.last_upda ted_date p_adj_rec.last_upda ted_login p_adj_rec.created_b y p_adj_rec.creation_ date p_adj_rec.program_ application_id p_adj_rec.program_ id p_adj_rec.program_ update_date p_adj_rec.request_i d
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
IN
No
Parameter
Type
Data-type
Required
Description
p_chk_approval_li mits
IN
VARCHAR2
No
This value can be set to 'F' if the adjusted amount should not be validated against the users approval limit. This flag is only used for Y.
p_move_deferred_t ax
IN
VARCHAR2
No
Example
The following is the simplest test case for updating an adjustment. Objective: To update an adjustment, passing the minimum number of parameters. For this example, assume the user wants to update comments. Entered parameters: old_adjustment_id = 88888 adj_rec.comments = 'This is the new comment' Call to the API:
AR_ADJUST_PUB.Create_Adjustment( p_api_name => 'AR_ADJUST_PUB', p_api_version => 1.0, p_msg_count => msg_count , p_msg_data => msg_data, p_return_status => return_status, p_adj_rec => adj_rec, p_old_adjust_id => old_adjustment_id );
Result: Updates an adjustment, passing two standard required parameters and one adjustment record parameter. Users should also pass values for other parameters that the user wishes to update in the adjustment record.
Ar_Adjust_pub.Reverse_Adjustment
Use this routine to reverse an adjustment. The following is a breakdown of parameters
Input Parameters
Standard API parameters: 4 Reverse Adjustment parameters: 1 required parameter
Output Parameters
Standard API parameters: 3 Reverse Adjustment parameters: 1
Parameter Descriptions
The following table shows parameters that pertain specifically to the Reverse Adjustment routine:
Parameter p_old_adjust_id Type IN Data-type NUMBER Required Yes Default Value Description The id of the adjustment that needs to be modified. The user can specify any comments that should appear in the reverse adjustment. The user can enter a gl date if he wishes it to be different from the old adjustments gl date. The user can enter a date if he wishes it to be different from the old adjustments date.
p_comments
IN
VARCHAR 2
No
p_reversal_gl_da te
IN
DATE
No
p_reversal_date
IN
DATE
No
OUT IN
NUMBER VARCHAR 2
No
FND_API.G_TRU E
This value can be set to 'F' if the adjusted amount should not be validated against the users approval limit. This flag is used only for Bills Receivable.
p_move_deferre d_tax
IN
VARCHAR 2
No
Parameter p_called_from
Type IN
Data-type VARCHAR 2
Required No
Example
The following is the simplest test case for reversing an adjustment. Objective: To reverse an adjustment, passing the minimum number of parameters. Entered parameters: old_adjustment_id = 88888 Call to the API:
AR_ADJUST_PUB.Reverse_Adjustment( p_api_name => 'AR_ADJUST_PUB', p_api_version => 1.0, p_msg_count => msg_count , p_msg_data => msg_data, p_return_status => return_status, p_old_adjust_id => old_adjustment_id p_new_adj_id => new_adjustment_id);
Result: Reverses an adjustment, passing two standard required parameters and one adjustment record parameter.
Messages
The following table describes the possible messages returned by the Adjustment API.
Message Number 42963 Message Name AR_AAPI_ADJ_AMOUNT_ZERO Message Description No Adjustment amount passed.
Message Description Cannot adjust, because the amount due in the Payment Schedule is zero, and the type specified is INVOICE. The Apply date &APPLY_DATE is earlier than the transaction date &TRX_DATE. The specified document sequence: &DOCUMENT_SEQ is not required as the Unique Sequence Number profile option does not allow it. The GL date: &GL_DATE is not in an open or future enterable period. The GL date &GL_DATE is earlier than the apply date &APPLY_DATE. The Adjustment GL date &GL_DATE is earlier than the transaction GL date &TRX_GL_DATE. Invalid adjustment ID: &ADJUSTMENT_ID specified. Invalid code combination ID: &CCID Invalid status: &STATUS passed during creation of Adjustment Invalid Descriptive Flexfield has been provided. Invalid Payment Schedule ID: &PAYMENT_SCHEDULE_ID Invalid receivables trx ID: &RECEIVABLES_TRX_ID
42965
42966
42967
AR_AAPI_GLDATE_INVALID_PER IOD AR_AAPI_GLDATE_LT_APPLYDA TE AR_AAPI_GLDATE_LT_TRXGLDA TE AR_AAPI_INVALID_ADJ_ID AR_AAPI_INVALID_CCID AR_AAPI_INVALID_CREATE_STA TUS AR_AAPI_INVALID_DESC_FLEX AR_AAPI_INVALID_PAYSCHD
42968
42969
42973 42974
42975
42976
42977
Message Description Adjustment not allowed for transactions of class: &CLASS Invalid type of adjustment: &TYPE Invalid USSGL Transaction Code &USSGL_CODE has been specified Customer trx line ID: &CUSTOMER_TRX_LINE_ID passed for type = &TYPE Apply date has not been specified No valid approval codes exists for Adjustments in the Lookup table No valid code combinations exist for Adjustment No code combination id exists for receivables trx ID: &RECEIVABLES_TRX_ID and no code combination has been specified No changes allowed for Adjustment with &STATUS status No values specified for the Created From attribute of the adjustment No customer ID exists for payment schedule ID: &PAYMENT_SCHEDULE_ID No customer trx id exists for payment schedule ID: &PAYMENT_SCHEDULE_ID Invalid customer trx line id: &CUSTOMER_TRX_LINE_ID passed for customer trx id: &CUSTOMER_TRX_ID GL date has not been specified No valid open or future enterable GL periods exist for the ledger ID &SET_OF_BOOKS_ID
42979 42980
AR_AAPI_INVALID_TYPE AR_AAPI_INVALID_USSGL_CODE
42981
42982 42983
42984 42985
AR_AAPI_NO_CCID AR_AAPI_NO_CCID_FOR_ACTIVI TY
42986
42987
42988
AR_AAPI_NO_CUSTOMER_ID
42989
42990
42991 42992
Message Description No valid reason codes exist for Adjustments in the Lookup table No valid receivables activity exists for Adjustments No valid type codes exists for Adjustments in the Lookup table No valid USSGL Codes exist for Adjustment Override Activity profile option does not allow to override the Code Combination ID provided in the Receivables Activity USSGL code is not allowed as the USSGL profile option does not allow it
42994 42995
AR_AAPI_NO_RECEIVABLES_TRX AR_AAPI_NO_TYPE_CODES
42996 42997
42998
AR_AAPI_USSGL_CODE_DISALLO W
3
Credit Memo Approval and Creation API User Notes
This chapter covers the following topics: Overview API Usage Messages
Overview
This document outlines the use of the Credit Memo Approval and Creation API. This API lets you initiate the creation of a credit memo against a specified transaction either with or without an approval process. To create a credit memo using an existing, user-defined Credit Memo Request workflow approval process, set the p_skip_workflow_flag parameter to N. In this case, the workflow process proceeds independently of the Credit Memo Approval and Creation API. If the disputed amount of the invoice is approved, then a credit memo is automatically created.
Note: You must set up the Credit Memo Request workflow before
using the Credit Memo Approval and Creation API. For more information, see the Oracle Receivables User Guide.
To create a credit memo directly, without sending a request through the workflow approval process, set the p_skip_workflow_flag parameter to Y. If you set the p_skip_workflow_flag parameter to Y, then the Credit Memo Approval and Creation API bypasses the workflow process and calls code to automatically create the credit memo. When you set the p_skip_workflow_flag parameter to Y, you might also have to set values for its associated parameters: p_credit_method_installments,
p_credit_method_rules, and p_batch_source_name. For more information, see the description of the AR_CREDIT_MEMO_API_PUB.Create_Request routine, page 3-2. You cannot use the Credit Memo Approval and Creation API to generate on-account credit memos. You must specify an existing transaction to credit.
API Usage
This section describes how to use the Credit Memo Approval and Creation API to initiate a Credit Memo Request workflow process request and to check the status of an existing request. The API is made up of two routines: AR_CREDIT_MEMO_API_PUB.Create_Request and AR_CREDIT_MEMO_API_PUB.Get_Request_Status. To initiate the Credit Memo Request workflow process by making a credit memo workflow request, call the \AR_CREDIT_MEMO_API_PUB.Create_Request routine, page 3-2. To view the status of an existing request, call the AR_CREDIT_MEMO_API_PUB.Get_Request_Status routine, page 3-9.
Prerequisites
You must define three HTML pages that display this information: The credit memo dispute request The original transaction details The transaction activities
You provide the API with the URLs of these pages. When workflow notifications are sent to the collector, approver, and receivable roles, links to the URLs are set in the message body of the notification. If the URLs are not correctly set up, then you will receive an error message such as "URL not found" when you click on the links. You must also set up the Credit Memo Request workflow before you use the Credit Memo Approval and Creation API. For more information, see "Setting Up Credit Memo Request Workflow" in the Oracle Receivables User Guide.
AR_CREDIT_MEMO_API_PUB.Create_Request
You can call this routine to create the Credit Memo Request workflow process request. When the workflow request has been created, the API returns a unique request ID number (p_request_id) that you can use to track the status of the request. The following is a breakdown of this routine's parameters, based upon parameter type:
Standard Parameters
This table lists and describes the standard parameters common to all routines in the Credit Memo Approval and Creation API.
Parameter p_api_version Type IN Data-type NUMBER Required Yes Default Value Description Used to compare version numbers of incoming calls to current version number. Set to TRUE to have the API automatically initialize the message list. Set to TRUE to have the API commit automatically. Overall return status of the API.
p_init_msg_list
IN
VARCHAR 2
FND_API.G_FA LSE
p_commit
IN
FND_API.G_FA LSE
x_return_status
OUT
x_msg_count
OUT
Number of messages in the API message list. Message in encoded format if x_msg_count=1.
x_msg_data
OUT
VARCHAR 2
Create_Request Parameters
This table lists and describes parameters that specifically pertain to the Create_Request routine: See Legend, page 3-7 for this table's legend.
Parameter p_customer_trx_id Type IN Data-type ra_customer_trx.customer_trx_id %type ra_cm_request.line_credit_flag Required Yes Description Customer_trx_id of the disputed invoice. This value should be set to Y if the dispute is at the line level.
p_line_credit_flag
IN
Yes
Parameter p_line_amount
Type IN
Data-type ra_cm_request.line_amount%type
Required Yes/No
Description Amount of the line dispute at the header level. If the dispute is at the header level, you should enter either the line_amount, tax_amount or freight_amount. Amount of the tax dispute at the header level. Amount of the freight dispute at header level. User defined lookup code that represents the reason for the invoice dispute. Should be a valid lookup_code for the lookup_type CREDIT_MEMO_REASON. Comments about the credit memo request, entered if required. These comments appear in the notes region of the Transaction window. Enter the duplicate invoice number if using the "Duplicate Billing" reason code. Tax exemption certificate number. URL that displays the information of the actual credit memo dispute request.* See Legend, page 3-7 for this table's legend.
p_tax_amount
IN
ra_cm_request.tax_amount
Yes/No
p_freight_amount
IN
ra_cm_request.freight_amount
Yes/No
p_cm_reason_code
IN
ra_cm_requests.cm_reason_code %type
YES
p_comments
IN
ra_cm_requests.comments%type
No
p_orig_trx_number
IN
VARCHAR2
No
p_tax_ex_cert_num
IN
VARCHAR2
No
p_request_url*
IN
VARCHAR2
No**
Parameter p_transaction_url
Type IN
Data-type VARCHAR2
Required No**
Description URL that displays the information of the original transaction. See Legend, page 3-7 for this table's legend.
p_trans_act_url
IN
VARCHAR2
No**
URL that displays information about the original transaction activities. See Leend, page 3-7 for this table's legend.
p_cm_line_tbl(x).cus tomer_trx_line_id
IN
ra_customer_trx_line.customer_tr x_line_id%type
Yes/No
This value must be entered only if the dispute is at the line level. This value indicates the line_id that is in dispute.
Note: Where
p_cm_line_tbl(x), x indicates the index. The dispute can be for multiple lines.
p_cm_line_tbl(x).ext ended_amount
IN
ra_customer_trx_line.extended_a mount%type
Yes/No
This value must be entered only if the dispute is at the line level. This value indicates the amount that is in dispute for the line. This value must be entered only if the dispute is at the line level. This value indicates the quantity that is in dispute for the line. This value must be entered only if the dispute is at the line level. This value indicates the price that is in dispute for the line. Defaults to N. If this value is set to Y, the entire workflow is skipped for that particular request and the credit memo is directly created.
p_cm_line_tbl(x).qua ntity_credited
IN
NUMBER
Yes/No
p_cm_line_tbl(x).pri ce
IN
NUMBER
Yes/No
p_skip_workflow_fl ag
IN
VARCHAR2
No
Type IN
Data-type VARCHAR2
Required No
Description The p_credit_method_installments is the credit method that is used for crediting a transaction that uses split payment terms. Choices include PRORATE, LIFO, FIFO, or NULL. This value may be required if the p_skip_workflow_flag is set to Y.
This parameter is mandatory if the credit memo is against a transaction that uses split payment terms and LINE_TYPE = LINE or CHARGES, or you are passing header freight. Do not enter a value for this parameter if LINE_TYPE = TAX, or if you are passing freight for a specific line.
Parameter p_credit_method_rul es
Type IN
Data-type VARCHAR2
Required No
Description The p_credit_method_rules is the credit method for crediting a transaction which uses an accounting rule. Choices include PRORATE, LIFO, UNIT, or NULL. This value may be required if the p_skip_workflow_flag is set to Y.
This parameter is mandatory if the credit memo is against a transaction which uses an accounting rule and LINE_TYPE = LINE or CHARGES, or you are passing header freight. Do not enter a value for this parameter if LINE_TYPE = TAX, or if you are passing freight for a specific line.
p_batch_source_nam e x_request_id
IN
VARCHAR2
No
This value is required if the p_skip_workflow_flag is set to Y. Request_id of the credit memo that is returned if the data passed is valid and the credit memo request is created.
OUT
VARCHAR2
Yes
Legend * The request confirmation page might need the request_id as a parameter to query the information. This will not be available to the calling program when creating the p_request_url parameter because the request_id is the out parameter of the API. Calling programs should leave the request_id value blank and the table handler will add the request_id value and pass it to Workflow. The code searches for the "req_id=" string and replaces it with req_id="req_id". The parameter name must be req_id. For example: For the old technology stack (PL/SQL), the following represents the request URL in iReceivables to call the "Request Confirmation" page. Note that no value
** If the calling application does not enter the request, transaction, and transaction activities URLs, then you will see a default page reading "Unavailable" when you click on these links in the notifications screen. It is strongly recommended that the calling application have the UI (user interface) display these pages and pass these URLs to the API.
Parameter validation
The API validates all parameters that you enter. If any of the required fields are missing or invalid, then the API returns an error message. A list of error messages is documented in Messages, page 3-12.
Example
This example shows a simple test case for creating a credit memo request for a dispute at the header level: Objective: To create a credit memo request. Parameters entered: customer_trx_id = 99999 line_credit_flag = N line_amount = -100 cm_reason_code = RETURN Call to the API:
AR_CREDIT_MEMO_API_PUB.Create_Request( x_return_status => p_return_status, x_msg_count => p_msg_count, x_msg_data => p_msg_data , CREDIT MEMO REQUEST PARAMETERS: p_customer_trx_id => 99999, p_line_credit_flag => 'N', p_line_amount => -100, p_cm_reason_code => 'RETURN', p_request_url => 'arw_single_trx.single_trx_page?p1=19769&p2=1&wf=Y', p_transaction_url => 'arw_single_trx.single_trx_page?p1=19769&p2=1&wf=Y' p_trans_act_url => 'arw_single_trx.single_act_page?p1=19769&p2=1&wf=Y' x_request_id => p_request_id
AR_CREDIT_MEMO_API_PUB.Get_Request_Status
Use this routine to view the Credit Memo Request workflow process request status. The API returns the status of the request and information about where the request is in the workflow. The following is a breakdown of parameters for this routine, based on parameter type:
Standard parameters
This table shows the standard API parameters common to all routines in the Credit Memo Approval and Creation API:
Parameter Type Data-type Required Default Value Description
p_api_version
IN
NUMBER
Yes
Used to compare version numbers of incoming calls to its current version number. Set to TRUE to have the API automatically initialize the message list. Overall return status of the API. Number of messages in the API message list. Message, in encoded format if x_msg_count=1.
p_init_msg_list
IN
VARCHAR2
FND_API. G_FALSE
x_return_status x_msg_count
OUT OUT
VARCHAR2 NUMBER
x_msg_data
OUT
VARCHAR2
Get_Request_Status parameters
This table shows parameters that specifically pertain to the Get_Request_Status routine:
Parameter Type Data-type Require d YES Description
p_request_id
IN
ra_cm_requests.request_id%type
ID of the credit memo request whose status you are checking. Status of the credit memo request.
x_status_meaning
OUT
VARCHAR2
Parameter
Type
Data-type
Require d
Description
x_reason_meaning
OUT
VARCHAR2
Reason for the dispute of the credit memo request. Customer transaction ID for the dispute of the credit memo request. Credit memo transaction ID that was created for the dispute. Total amount of dispute for lines.
x_customer_trx_id
OUT
ra_cusotmer_trx.customer_trx_id %type
x_cm_customer_trx_ id x_line_amount
OUT
OUT
x_tax_amount
OUT
x_freight_amount
OUT
Total amount of dispute for freight. Indicates whether the dispute is at the line level or the header level. If the value is set to Y, the dispute is at the line level. Name of the requestor. Date of the request. Comments entered by the requestor. Credit memo approval date if the credit memo has been created for the request. Table that contains the line level dispute information. The values in the table will be set if the x_line_credits_flag = Y.
x_line_credits_flag
OUT
x_approval_date
OUT
DATE
x_cm_line_tbl
OUT
cm_line_tbl_type_cover
Parameter
Type
Data-type
Require d
Description
x_cm_activity_tbl
OUT
cm_activity_tbl_type_cover
Table that contains the status of the activities for the request. Table that contains the notes inserted for the transaction that is disputed.
x_cm_notes_tbl
OUT
cm_notes_tbl_type_cover
Note:
TYPE CM_LINE_REC_TYPE_COVER IS RECORD customer_trx_line_id: ra_customer_trx_lines.customer_trx_line_id%type, extended_amount: ra_customer_trx_lines.extended_amount%type, quantity_credited: number, price: number; TYPE CM_LINE_TBL_TYPE_COVER IS TABLE OF CM_LINE_REC_TYPE_COVER INDEX BY BINARY INTEGER; x_cm_line_tbl CM_LINE_TBL_TYPE_COVER; TYPE CM_ACTIVITY_REC_TYPE_COVER IS RECORD begin_date: DATE, activity_name: VARCHAR2(80), status: wf_item_activity_statuses.activity_status%type, user: wf_item_activity_statuses.activity_user%type); TYPE CM_ACTIVITY_TBL_TYPE_COVER IS TABLE OF CM_ACTIVITY_REC_TYPE_COVER INDEX BY BINARY INTEGER; x_cm_activity_tbl CM_ACTIVITY_TBL_TYPE_COVER; TYPE CM_NOTES_REC_TYPE_COVER IS RECORD ( NOTES ar_notes.text%type); TYPE CM_NOTES_TBL_TYPE_COVER IS TABLE OF CM_NOTES_REC_TYPE_COVER INDEX BY BINARY INTEGER; x_cm_notes_tbl CM_NOTES_TBL_TYPE_COVER;
Parameter validation
The API validates all parameters that you enter. If any of the required fields are missing or invalid, then the API returns an error message. A list of error messages is documented in Messages, page 3-12.
Example
The following example is a simple test case for viewing the status of the credit memo request. Objective:
To get the status of the credit memo request. Parameters entered: request_id = 122 Call to the API:
AR_CREDIT_MEMO_API_PUB.Get_Request_Status( p_api_version => 1.0, x_msg_count => msg_count , x_msg_data => msg_data, x_return_status => return_status, p_request_id => request_id, x_status_meaning => status_meaning, x_reason_meaning => reason_meaning, x_customer_trx_id => customer_trx_id, x_cm_customer_trx_id => cm_customer_trx_id, x_line_amount => line_amount, x_tax_amount => tax_amount, x_freight_amount => freight_amount, x_line_credits_flag => line_credits_flag, x_created_by => created_by, x_creation_date => creation_date, x_cm_line_tbl => cm_line_tbl, x_cm_activity_tbl => cm_activity_tbl, x_cm_notes_tbl => cm_notes_tbl);
Messages
The following table describes the possible messages returned by the Credit Memo Approval and Creation API.
Message Number 11936 Message Name Message Description
AR_RAXTRX-1719
You must supply a reason code for your credit memo transaction. You cannot overapply this transaction. Line does not exist (customer_trx_line_id:[customer_trx_line_id]). Transaction does not exist (customer_trx_id:[customer_trx_id]). You specified an invalid value for the LINE_CREDIT_FLAG parameter. The valid values are Y and N.
11091 42711
AR_CKAP_OVERAPP AR_TAPI_LINE_NOT_EXIST
42756
AR_TAPI_TRANS_NOT_EXIST
294003
AR_CMWF_API_INVALID_VAL UE
Message Name
Message Description
The value for LINES_CREDIT_FLAG is Y, please provide at least one line level information. Request does not exist (REQUEST_ID: &REQUEST_ID)
294002
4
Credit Memo Application API User Notes
This chapter covers the following topics: Overview API Usage Messages
Overview
This document outlines in detail the Credit Memo Application API. This public API currently allows the application of an on-account credit memo to an activity such as Electronic Refund, which creates a customer refund for the credit memo via the creation of a negative miscellaneous receipt. Please refer to the Oracle Receivables User Guide for more detail on customer credit refund functionality.
API Usage
To apply or unapply an on-account credit memo to an activity, call the following APIs: ar_cm_application_pub.activity_application, page 4-2: Applies an on-account credit memo to an activity. ar_cm_application_pub.activity_unapplication, page 4-11: Unapplies an on-account credit memo from an activity.
ar_cm_application_pub.activity_application
Use this routine to apply an on-account credit memo to an activity, such as Electronic Refund. The API returns the receivable_application_id of the receivable_application created.
Input Parameters
Standard API parameters: 4 Activity application parameters: 12 (including 1 descriptive flexfield parameter and 1 global descriptive flexfield parameter)
Output Parameters
Standard API parameters: 3 Activity application parameters: 4 required parameters (might vary depending on the adjustment type)
Parameter Descriptions
The input descriptive flexfield parameter is a record of type attribute_rec_type:
TYPE attribute_rec_type IS RECORD (p_attribute_category IN VARCHAR2, p_attribute1 IN VARCHAR2, p_attribute2 IN VARCHAR2, p_attribute3 IN VARCHAR2, p_attribute4 IN VARCHAR2, p_attribute5 IN VARCHAR2, p_attribute6 IN VARCHAR2, p_attribute7 IN VARCHAR2, p_attribute8 IN VARCHAR2, p_attribute9 IN VARCHAR2, p_attribute10 IN VARCHAR2, p_attribute11 IN VARCHAR2, p_attribute12 IN VARCHAR2, p_attribute13 IN VARCHAR2, p_attribute14 IN VARCHAR2, p_attribute15 IN VARCHAR2);
The input global descriptive flexfield parameter is a record of type global_ attribute_rec_type:
TYPE global_attribute_rec_type IS RECORD (p_global_attribute_category IN VARCHAR2, p_global_attribute1 IN VARCHAR2, p_global_attribute2 IN VARCHAR2, p_global_attribute3 IN VARCHAR2, p_global_attribute4 IN VARCHAR2, p_global_attribute5 IN VARCHAR2, p_global_attribute6 IN VARCHAR2, p_global_attribute7 IN VARCHAR2, p_global_attribute8 IN VARCHAR2, p_global_attribute9 IN VARCHAR2, p_global_attribute10 IN VARCHAR2, p_global_attribute11 IN VARCHAR2, p_global_attribute12 IN VARCHAR2, p_global_attribute13 IN VARCHAR2, p_global_attribute14 IN VARCHAR2, p_global_attribute15 IN VARCHAR2, p_global_attribute16 IN VARCHAR2, p_global_attribute17 IN VARCHAR2, p_global_attribute18 IN VARCHAR2, p_global_attribute19 IN VARCHAR2, p_global_attribute20 IN VARCHAR2);
The following table lists the standard API parameters which are common to all the routines in the credit memo application API:
Parameter p_api_version Type IN Data-type NUMBER Required Yes Default Value Description Used to compare version numbers of incoming calls to its current version number. Unexpected error is raised if version in-compatibility exists. In the current version of the API, you should pass in a value of 1.0 for this parameter. p_init_msg_list IN VARCHAR2
FND_API.G_FA LSE
Allows API callers to request that the API does initialization of the message list on their behalf. Used by API callers to ask the API to commit on their behalf. Not to be used currently as this is a public API .
p_commit
IN
VARCHAR2
p_validation_lev el
IN
NUMBER
Parameter x_return_status
Type OUT
Data-type VARCHAR2
Required
Default Value
Description Represents the API overall return status. See: Exception Handling and Result Messages, page 1-3. Number of messages in the API message list This is the message in encoded format if x_msg_count=1
x_msg_count
OUT
NUMBER
x_msg_data
OUT
VARCHAR2
The following table lists the parameters that are relevant to the activity_application routine:
Parameter
Type
Data-type
Required * Yes
Description
p_customer_trx_id
IN
NUMBER
Customer transaction identifier of the on account credit memo to be applied. Default: None Validation: Must be a completed on-account credit memo (not a regular credit memo related to an invoice where previous_customer_trx_id has a value). Must have a receipt method. Receipt method must belong to a receipt class that allows remittance. Receipt method must have a remittance bank account. Must have customer bank account details. Must have a negative original amount due. Must not be negative due to overpayment. Errors: AR_REF_NO_PAYMENT_METHODAR_REF_N O_CUST_BANK AR_REF_NOT_OACM AR_REF_CM_INCOMPLETE AR_REF_CM_POSITIVE AR_REF_MORE_THAN_CM_AMT AR_REF_RCT_CLASS_REMIT AR_REF_NO_REMIT_BANK
Parameter
Type
Data-type
Required * Yes
Description
p_amount_applied
IN
NUMBER
The amount of the credit memo to apply to an activity. Default: None Validation: Must be greater than zero. Must not cause the credit memo to be overapplied. Total applied to Electronic Refund, including this application and other applications on the same credit memo, must not fall outside the approval limits or Credit Memo refunds specified for the user/currency. Errors: AR_CKAP_OVERAPP AR_REF_CM_APP_NEG AR_REF_USR_LMT_OUT_OF_RANGE
p_applied_payment_sc hedule_id
IN
NUMBER
Yes
The payment_schedule_id of the activity being applied to. Default: None Validation: Only 1 value is currently allowed: -8 (Electronic Refund) Error:AR_RAPI_APP_PS_ID_INVALID
p_receivable_trx_id
IN
NUMBER
Yes
Receivables Transacation Identifier of the activity being applied to. Default: None Validation: Must be of type Credit Memo Refund. Error: AR_RAPI_ACTIVITY_X_INVALID
Parameter
Type
Data-type
Required * No
Description
p_apply_date
IN
DATE
The date the credit memo is applied to the activity. Default: The greater of system date and transaction date. Validation: Must not precede the transaction date of the credit memo. Error: AR_APPLY_BEFORE_TRANSACTION
p_apply_gl_date
IN
DATE
No
Date that this application will be posted to the General Ledger. Default: Gets defaulted to the system date if it is in an open or future enterable period, otherwise:
If the most recent open period is prior to the transaction date: last date of that period If there is a period open after the transaction date: first date of the last open period
The date is in an Open or Future period The period cannot be an Adjustment period Must not precede the credit memo GL date
Error: AR_INVALID_APP_GL_DATE AR_VAL_GL_INV_GL p_ussgl_transaction_co de IN VARCHAR2(3 0) No Code defined by public sector accounting. Default: None Validation: None Error: None
Parameter
Type
Data-type
Required * No
Description
p_called_from
IN
VARCHAR2(2 0)
This parameter is used to identify the calling routine. Default: Null Validation: None Error: None
p_attribute_record
IN
attribute_rec_t ype
No
This is a record type which contains all 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receivable Application Information flexfield. Default: DFF APIs used to do the defaulting Validation: DFF APIs used to do the validation depending on setup Error: AR_RAPI_DESC_FLEX_INVALID
p_global_attribute_rec ord
IN
global_attribut e_rec_type
No
This is a record type which contains all 20 global descriptive flexfield segments and one global descriptive flexfield structure defining column. Default: None Validation: None
p_comments
IN
No
User's comments
p_chk_approval_limit_ flag
IN
No
Flag used to optionally override user approval limits for Credit Memo refunds. Values: 'Y' = Yes (check limits), 'N' = No (do not check limits) Default: 'Y' Validation: None
Parameter
Type
Data-type
Required * No
Description
p_application_ref_type
IN OUT
VARCHAR2(3 0)
The context of application ref num/id is passed back in this parameter. For Electronic refunds this will be MISC_RECEIPT Default: None Validation: None Error: None
P_application_ref_id
IN OUT
NUMBER
No
For Electronic Refunds, the cash_receipt_id of the negative miscellaneous receipt created for the refund is passed back in this parameter. Default: None Validation: None Error: None
p_application_ref_nu m
IN OUT
VARCHAR2(3 0)
No
For Electronic Refunds, the receipt number for the resulting miscellaneous receipt will be passed back in this parameter. Default: None Validation: None Error: None
p_receivable_applicati on_id
OUT
NUMBER(15)
No
*If the values for the Required parameters are not passed in a call to this API, then the call itself will fail. However, depending on the business scenario, you must pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Validation
This section explains the validation in this API, which does not relate directly to any of the above columns. User Approval Limits Only checked if p_chk_approval_limits_flag <> 'N'.
Limits must exist for the user calling the credit memo application API for the credit memo currency. The total amount applied to Electronic Refund for a particular credit memo must fall within the limits.
Example
Objective: To apply an on-account credit memo to the Electronic Refund activity using a call to ar_cm_application_pub.activity_application and passing the minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_init_msg_list p_customer_trx_id p_amount_applied p_applied_payment_schedule _id p_receivables_trx_id Entered Value 1.0 FND_API.G_TRUE 1001 100 1071 Default Value
1089
This table lists the defaulted input parameters, which were not entered:
Parameter p_apply_date p_apply_gl_date p_chk_approval_limit_flag Entered Value Default Value sysdate sysdate 'Y'
Ar_cm_application_pub.activity_application( p_api_version => 1.0, p_init_msg_list => FND_API.G_TRUE, p_customer_trx_id => 1001, p_amount_applied => 100, p_applied_payment_schedule_id => 1071, p_receivables_trx_id => 1089, x_return_status => l_return_status, x_msg_count => l_msg_count, x_msg_data => l_msg_data, p_application_ref_type => l_application_ref_type, p_application_ref_id => l_application_ref_id, p_application_ref_num => l_application_ref_num);
The warnings and error messages put on the message stack by the API are retrieved after execution of this API by the calling program in the following manner:
IF l_msg_count = 1 Then --there is one message raised by the API, so it has been sent out --in the parameter x_msg_data, get it. l_msg_data_out := l_msg_data; ELSIF l_msg_count > 1 Then --the messages on the stack are more than one so call them in a loop -- and put the messages in a PL/SQL table. loop count := count +1 ; l_mesg := FND_MSG_PUB.Get; If l_mesg IS NULL Then EXIT; else Mesg_tbl(count).message := l_mesg; End if; end loop; END IF;
Depending on the message level threshold set by the profile option FND_API_MSG_LEVEL_THRESHOLD, the messages put on the message stack may contain both the error messages and the warnings. Result: An electronic refund can be created for an on account credit memo by specifying only 6 input parameters in the above API call.
ar_cm_application_pub.activity_unapplication
Call this routine to reverse an activity application on an on-account credit memo. Such applications currently include only Electronic Refunds.
Input Parameters
Standard API parameters: 4 Activity unapplication parameters: 4
Output Parameters
Standard API parameters: 3
Parameter Descriptions
For descriptions of the seven standard API parameters, see ar_cm_application_pub.activity_application, page 4-2. The following table lists the parameters that are relevant to the activity_unapplication routine:
Parameter Type Data-type Required * No Description
p_customer_trx_id
IN
NUMBER(15)
The customer transaction identifier of the on-account credit memo from which the activity application is to be unapplied. Default: Null Validation: 1. Must have at least one Electronic Refund application Must have only 1 Electroinic Refund application if receivable_application_id is not supplied Must be specified if receivable_application_id is not secified
2.
3.
Parameter
Type
Data-type
Required * No
Description
p_receivable_applica tion_id
IN
NUMBER(15)
Identifies the receivable application. Used to derive the customer trx id if not specified. Default: If only one Electronic Refund application exists, then receivable-application_id is taken from it. Validation: 1. 2. applied_payment_schedule_id must be -8 Display flag = 'Y' (latest application) and status = 'ACTIVITY' Must correspond to the customer_trx_id specified.
3.
Error: AR_RAPI_REC_APP_ID_INVALID
Parameter
Type
Data-type
Required *
Description
p_reversal_gl_date
IN
DATE
The reversal gl date used for the accounting entries. Default: Gets defaulted to the application gl date if it is a valid gl_date, otherwise:
If the most recent open period is prior to the transaction date: last date of that period If there is a period open after the transaction date: first date of the last open period
The date is in an Open or Future period The period cannot be an Adjustment period
2. 3.
reversal GL date >= application GL date reversal GL date >= transaction GL date
Error: AR_INVALID_APP_GL_DATE AR_RW_BEFORE_APP_GL_DATE AR_VAL_GL_INV_GL p_called_from IN VARCHAR2(20) Yes Used to indicate which program is calling this API. Default: None Validation: None Error: None
Example
Objective: To unapply an activity application using a call to ar_cm_application_pub.activity_unapplication, and passing a minimum number of input parameters. This table lists the entered parameters:
DefaultValue
This table lists the defaulted input parameters, which were not entered:
Parameter p_customer_trx_id p_reversal_gl_date p_called_from Entered Value Defaultvalue 20338 01-JUN-2000
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Exception Handling and Result Messages, page 1-3.
Messages
The following table lists all the error messages raised by the Credit Memo Application API: TYPE E: Error message W: Warning message
MESSAGE_CODE MESSAGE_TEXT EXPLANATION TYP E E
AR_APPLY_BEFORE_TRANSACTIO N AR_CKAP_OVERAPP
Apply Date must be greater than or equal to the Transaction Date. You cannot over apply this transaction.
This message will appear if the amount being applied to the credit memo results in a change of sign of the balance due remaining
MESSAGE_CODE
MESSAGE_TEXT
EXPLANATION
TYP E E
AR_INVALID_APP_GL_DATE
Either the GL date must be changed, or the period in which it falls must be opened or made future-enterable.
AR_RAPI_ACTIVITY_INVALID
The receivables activity name is invalid. The specified combination of payment schedule identifier and receivables transaction identifier is invalid.
AR_RAPI_ACTIVITY_X_INVALID
The activity type derived from the receivables_trx_id does not match with the activity type of the specified payment_schedule_id.
AR_RAPI_APP_PS_ID_INVALID
Applied payment schedule identifier has an invalid value. Invalid receivable application identifier for the specified applied payment schedule identifier. Applied amount could not be defaulted.
AR_RAPI_APP_PS_RA_ID_X_INVA LID
AR_RAPI_APPLIED_AMT_NULL
The p_applied_amount was not specified by the user and it could not be defaulted from the specified transaction
AR_RAPI_CUST_TRX_ID_INVALID
Invalid customer transaction identifier. Customer transaction identifier is null. The entered values for the descriptive flexfield &DFF_NAME is invalid. Invalid receipt method identifier. Invalid receivable application identifier.
AR_RAPI_CUST_TRX_ID_NULL
AR_RAPI_DESC_FLEX_INVALID
AR_RAPI_RCT_MD_ID_INVALID AR_RAPI_REC_APP_ID_INVALID
E E
MESSAGE_CODE
MESSAGE_TEXT
EXPLANATION
TYP E E
AR_RAPI_REC_APP_ID_NULL
Receivable application identifier is null. Invalid receivable transaction identifier. Please enter a receivables transaction identifier. Reversal GL date is null. Invalid applied payment schedule identifier for the specified transaction.
AR_RAPI_REC_TRX_ID_INVALID
AR_RAPI_REC_TRX_ID_NULL
AR_RAPI_REV_GL_DATE_NULL AR_RAPI_TRX_PS_ID_X_INVALID
The p_applied_payment_schedule _id specified by the user does not match with the payment_schedule_id derived from the p_customer_trx_id and the p_installment.
E E
AR_RAPI_TRX_PS_NOT_DEF_CUS
The customer could not be defaulted from the entered transaction and the applied payment schedule identifier. The activity type for the entered receivable transaction identifier does not match with the activity of the entered payment schedule identifier . The GL date cannot be before the credit memo GL date. Only positive credit memo refund amounts are allowed. Please complete this credit memo. Credit memo refunds are only allowed on negative credit memos.
AR_RAPI_TRX_RA_ID_X_INVALID
AR_REF_BEFORE_CM_GL_DATE
AR_REF_CM_APP_NEG
AR_REF_CM_INCOMPLETE AR_REF_CM_POSITIVE
E E
MESSAGE_CODE
MESSAGE_TEXT
EXPLANATION
TYP E E
AR_REF_MORE_THAN_CM_AMT
You cannot refund more than the credit memo amount. To enable credit memo refunds, please add customer bank details to the credit memo. Credit memo refund approval limits do not exist for this user and currency. To enable credit memo refunds, please add a receipt method to the credit memo. To enable credit memo refunds, the credit memo receipt method must belong to a receipt class with an assigned remittance bank. Credit memo refunds are only allowed for on-account credit memos.
AR_REF_NO_CUST_BANK
AR_REF_NO_APPROVAL_LIMIT
AR_REF_NO_PAYMENT_METHOD
AR_REF_NO_REMIT_BANK
AR_REF_NOT_OACM
Only transactions with Credit Memo class and unattached to another transaction are allowed.
AR_REF_RCT_CLASS_REMIT
To enable credit memo refunds, the receipt class associated with this credit memo receipt method must require remittance. The total refund amount must be within &FROM_AMOUNT and &TO_AMOUNT. Reversal GL Date must be on or after original GL Date of &GL_DATE. The GL date should not be prior to the invoice's GL date.
AR_REF_USR_LMT_OUT_OF_RAN GE
AR_RW_BEFORE_APP_GL_DATE
AR_VAL_GL_INV_GL
5
Deposit API User Notes
This chapter covers the following topics: Overview API Usage Messages
Overview
This document outlines the specifications and the methodology for using the various Commitment (Deposit) APIs. These APIs provide an extension to existing functionality of creating and manipulating deposits through the standard Oracle Receivables Transactions workbench. You can access these APIs: As standard PL/SQL servers-side routine calls Through Forms, utilizing the capability of Forms6 to have a procedure as its underlying base table
API Usage
To create a deposit, you can call the following PL/SQL APIs:
AR_DEPOSIT_API_PUB.Create_deposit, page 5-2: Creates a single deposit and completes it. AR_DEPOSIT_API_PUB.insert_non_rev_salescredit, page 5-27: Creates nonrevenue sales credit for a deposit.
AR_DEPOSIT_API_PUB.Create_deposit
This routine is called to create a deposit for the transactions. Only one owner can be assigned to a commitment. This API routine has 8 output and 136 input parameters in total. Of the output parameters, the API returns CUSTOMER_TRX_ID , CUSTOMER_TRX_LINE_ID, and new TRX_NUMBER, if generated during deposit creation. The following is the breakdown of the parameters:
Input
Standard API parameters: 4 Deposit parameters: 132 + 2 (global descriptive flexfield parameter)
Output
Standard API parameters: 3 Deposit parameters: 5
Parameter Descriptions
The input global descriptive flexfield parameter is a record of type global_attr_rec_type.
TYPE global_attr_rec_type IS RECORD( global_attribute_category VARCHAR2(30) default null, global_attribute1 VARCHAR2(150) default NULL, global_attribute2 VARCHAR2(150) DEFAULT NULL, global_attribute3 VARCHAR2(150) DEFAULT NULL, global_attribute4 VARCHAR2(150) DEFAULT NULL, global_attribute5 VARCHAR2(150) DEFAULT NULL, global_attribute6 VARCHAR2(150) DEFAULT NULL, global_attribute7 VARCHAR2(150) DEFAULT NULL, global_attribute8 VARCHAR2(150) DEFAULT NULL, global_attribute9 VARCHAR2(150) DEFAULT NULL, global_attribute10 VARCHAR2(150) DEFAULT NULL, global_attribute11 VARCHAR2(150) DEFAULT NULL, global_attribute12 VARCHAR2(150) DEFAULT NULL, global_attribute13 VARCHAR2(150) DEFAULT NULL, global_attribute14 VARCHAR2(150) DEFAULT NULL, global_attribute15 VARCHAR2(150) DEFAULT NULL, global_attribute16 VARCHAR2(150) DEFAULT NULL, global_attribute17 VARCHAR2(150) DEFAULT NULL, global_attribute18 VARCHAR2(150) DEFAULT NULL, global_attribute19 VARCHAR2(150) DEFAULT NULL, global_attribute20 VARCHAR2(150) DEFAULT NULL, global_attribute21 VARCHAR2(150) DEFAULT NULL, global_attribute22 VARCHAR2(150) DEFAULT NULL, global_attribute23 VARCHAR2(150) DEFAULT NULL, global_attribute24 VARCHAR2(150) DEFAULT NULL, global_attribute25 VARCHAR2(150) DEFAULT NULL, global_attribute26 VARCHAR2(150) DEFAULT NULL, global_attribute27 VARCHAR2(150) DEFAULT NULL, global_attribute28 VARCHAR2(150) DEFAULT NULL, global_attribute29 VARCHAR2(150) DEFAULT NULL, global_attribute30 VARCHAR2(150) DEFAULT NULL);
The following table lists standard API parameters that are common to all the routines in the Commitment (Deposit) API.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object; otherwise, error messages will be reported.
Parameter
Type
Data-type
Require d Yes
Default Value
Description
p_api_version
IN
NUMBER
Used to compare version numbers of incoming calls to its current version number. Unexpected error is raised if version incompatibility exists. In the current version of the API, you should pass a value of 1.0 for this parameter.
Parameter
Type
Data-type
Require d
Default Value
Description
p_init_msg_list
IN
VARCHAR2
FND_API.G_FALS E
Allows API callers to request that the API does initialization of the message list on their behalf. Used by API callers to ask the API to commit on their behalf. Not to be used currently as this is a public API. Represents the API overall return status. Number of messages in the API message list. This is the message in encoded format if x_msg_count=1.
p_commit
IN
VARCHAR2
p_validation_lev el x_return_status
IN
NUMBER
OUT
VARCHAR2
x_msg_count
OUT
NUMBER
x_msg_data
OUT
VARCHAR2
The following table lists the parameters that pertain specifically to the deposit.
Parameter p_deposit_number Type IN Data-type VARCHAR2 Required* Description The deposit number of the deposit to be created. Default: Null Validation: If AR_RA_BATCH_AUTO_NUM_FLAG set by batch source is true, then it is derived automatically; else it is required to be present. Error: AR_DAPI_DEPOSIT_NO_NULL p_deposit_date IN DATE
The deposit date of the entered deposit. Default: System date Validation: This field is mandatory. Error: None
Parameter p_usr_currency_cod e
Type IN
Data-type VARCHAR2
Required*
Description The translated currency code. Used to derive the p_currency_code if it is not entered. Default: None Validation: Should be a valid currency, so that the corresponding currency code can be derived. Error: AR_RAPI_USR_CURR_CODE_INVALID
p_currency_code
IN
VARCHAR2
The actual currency code that gets stored in AR tables. Default: Derived from p_usr_currency_code if entered, else defaults to the functional currency code. Validation: Validated against the currencies in FND_CURRENCIES table. Error: AR_RAPI_CURR_CODE_INVALID Warning: AR_RAPI_FUNC_CURR_DEFAULTED
p_usr_exchange_rate _type
IN
VARCHAR2
The translated exchange rate type. Used to derive the p_exchange_rate_type if it has not been entered. Default: None Validation: Should be a valid rate type. Error: AR_RAPI_USR_X_RATE_TYP_INVALID
Parameter p_exchange_rate_ty pe
Type IN
Data-type VARCHAR2
Required*
Description Exchange rate type stored in AR tables. Default: In case of foreign currency receipt, the value is derived from p_usr_exchange_rate_type. If p_usr_exchange_rate_type is null, then the value defaults from the AR: Default Exchange Rate Type profile option. Validation: Validated against values in GL_DAILY_CONVERSION_TYPES table. Error: AR_RAPI_X_RATE_TYPE_INVALID
p_exchange_rate
IN
NUMBER
The exchange rate between the receipt currency and the functional currency. Default: Derived from the Daily Rates table for rate_type <> User in case of nonfunctional currency. If Journals: Display Inverse Rate profile option = Y, set user-entered value to 1/ p_exchange_rate. The entered value is rounded to a precision of 38. Validation: In case of nonfunctional currency, the rate should have a positive value for rate type=User For nonfunctional currency and type is <> User, do not specify any value. Error: AR_RAPI_X_RATE_INVALID AR_RAPI_X_RATE_NULL
p_exchange_rate_dat e
IN
DATE
The date on which the exchange rate is valid. Default: Receipt date Validation: For a nonfunctional currency and type is <>User, there should be a valid rate existing in the database for this date. This is a cross validation of type, currency, and date. Error: AR_NO_RATE_DATA_FOUND
Parameter p_batch_source_id
Type IN
Data-type NUMBER
Required*
Description Batch source identifier for the commitment. Default: Same as ar_ra_batch_source profile option. Validation: It should be a valid batch source and it should exist in the database. This field is mandatory if not defined in profile option. Error: AR_DAPI_BS_NAME_INVALID AR_DAPI_BS_NAME_IGN AR_DAPI_BS_ID_INVALID
p_batch_source_nam e
IN
VARCHAR2
Batch source name for the commitment. Default: Same as ar_ra_batch_source_name profile option. Validation: It should be a valid batch source and it should exist in the database. Error: AR_DAPI_BS_NAME_INVALID AR_DAPI_BS_NAME_IGN AR_DAPI_BS_ID_INVALID
p_cust_trx_type_id
IN
NUMBER
Transaction Type identifier. Default: Based on the value of batch source Validation: It should be a valid transaction type. This field is mandatory. Error: AR_DAPI_TRANS_TYPE_INVALID AR_RAPI_TRANS_TYPE_IGN AR_DAPI_TRANS_TYPE_ID_INVALID
p_cust_trx_type
IN
VARCHAR2
Transaction Type name. Default: Based on the value of batch source Validation: It should be a valid transaction type. Error: AR_DAPI_TRANS_TYPE_INVALID AR_RAPI_TRANS_TYPE_IGN AR_DAPI_TRANS_TYPE_ID_INVALID
Parameter p_class
Type IN
Data-type VARCHAR2
Required*
Description Constant value = DEP. Keeping as an input for a future enhancement. Date that this deposit will be posted to the general ledger. Default: Gets defaulted to the current date if it is a valid gl_date, otherwise:
p_gl_date
IN
DATE
If the most recent open period is prior to the receipt date: last date of that period. If there is a period open after the deposit date: first date of the last open period.
The date is in an Open or Future period. The period cannot be an Adjustment period.
Error: AR_INVALID_APP_GL_DATE
Parameter p_bill_to_customer_i d
Type IN
Data-type NUMBER
Required*
Description The CUSTOMER_ID for the bill-to customer. Default: Defaulted from customer name/number. If all name, number, and ID are null, then it is same as ship-to CUSTOMER_ID. Validation: Customer exists and has prospect code = CUSTOMER. Customer has a profile defined at the customer level. Either bill-to or ship-to customer must exist. Error: AR_RAPI_CUST_ID_INVALID AR_RAPI_CUS_NAME_INVALID AR_RAPI_CUS_NUM_INVALID AR_RAPI_CUS_NAME_NUM_INVALID AR_RAPI_CUS_NAME_NUM_IGN AR_DAPI_BILL_OR_SHIP_CUST_REQ
p_bill_to_customer_ name
IN
VARCHAR2
The name for the entered customer. Used to default the customer ID if not specified. Default: None Validation: None Error: AR_RAPI_CUS_NAME_INVALID
p_bill_to_customer_ number
IN
VARCHAR2
The number for the entered customer. Used to default the customer ID if not specified. Default: None Validation: None Error: AR_RAPI_CUS_NAME_INVALID
p_bill_to_location
IN
VARCHAR2
The location for the bill-to customer. Default: Defaulted from the primary bill-to customer location, if defined. Otherwise, null. Validation: This field is mandatory. Error: AR_DAPI_CUS_LOC_INVALID
Parameter p_bill_to_contact_id
Type IN
Data-type NUMBER
Required*
Description The contact identifier for the bill-to customer. Default: Defaulted from the bill-to customer site level, then customer level, if defined. Otherwise, null. Validation: Yes Error: AR_DAPI_BIll_CONTACT_NAME_INV AR_DAPI_CUS_CONTACT_INVALID
p_bill_to_contact_fir st_name
IN
VARCHAR2
The first name of contact for the bill-to customer. Default: Defaulted from bill-to customer site level, then customer level, if defined. Otherwise, null. Validation: This field is mandatory. Error: AR_DAPI_BIll_CONTACT_NAME_INV AR_DAPI_CUS_CONTACT_INVALID
p_bill_to_contact_las t_name
IN
VARCHAR2
The last name of contact for the bill-to customer. Default: Defaulted from bill-to customer site level, then customer level, if defined. Otherwise, null. Validation: This field is mandatory. Error: AR_DAPI_BIll_CONTACT_NAME_INV AR_DAPI_CUS_CONTACT_INVALID
Type IN
Data-type NUMBER
Required*
Description The CUSTOMER_ID for the ship-to customer. Default: Defaulted from customer name/number. Null otherwise. Validation: Customer exists and has prospect code = CUSTOMER. Customer has a profile defined at the customer level. Either bill-to or ship-to customer must exist. Error: AR_RAPI_CUST_ID_INVALID AR_RAPI_CUS_NAME_INVALID AR_RAPI_CUS_NUM_INVALID AR_RAPI_CUS_NAME_NUM_INVALID AR_RAPI_CUS_NAME_NUM_IGN AR_DAPI_BILL_OR_SHIP_CUST_REQ
p_ship_to_customer _name
IN
VARCHAR2
The name for the entered customer. Used to default the customer ID, if not specified. Default: None Validation: None Error: AR_RAPI_CUS_NAME_INVALID
p_ship_to_customer _number
IN
VARCHAR2
The number for the entered customer. Used to default the customer ID, if not specified. Default: None Validation: None Error: AR_RAPI_CUS_NAME_INVALID
p_ship_to_location
IN
VARCHAR2
The location for the bill-to customer. Default: Defaulted from primary bill-to customer location, if defined. Otherwise, null. Validation: This field is mandatory. Error: AR_DAPI_CUS_LOC_INVALID
Parameter p_ship_to_contact_i d
Type IN
Data-type NUMBER
Required*
Description The contact identifier for the bill-to customer. Default: Defaulted from bill-to customer site level, then from customer level, if it is defined. If not defined, then it is not defaulted. Validation: Yes Error: AR_DAPI_BIll_CONTACT_NAME_INV AR_DAPI_CUS_CONTACT_INVALID
p_ship_to_contact_fi rst_name
IN
VARCHAR2
The first name of contact for the bill-to customer. Default: Defaulted from bill-to customer site level, then customer level, if defined. Otherwise, null. Validation: This field is mandatory. Error: AR_DAPI_BIll_CONTACT_NAME_INV AR_DAPI_CUS_CONTACT_INVALID
p_ship_to_contact_la st_name
IN
VARCHAR2
The last name of contact for the bill-to customer. Default: Defaulted from bill-to customer site level, then customer level, if defined. Otherwise, null. Validation: This field is mandatory. Error: AR_DAPI_BIll_CONTACT_NAME_INV AR_DAPI_CUS_CONTACT_INVALID
Parameter p_term_id
Type IN
Data-type NUMBER
Required*
Description Payment terms identifier for the transactions. You can override payment terms. Default: Following hierarchy is used to default payment terms: 1. 2. 3. Customer bill-to site level Customer address level Customer level transaction type
Validation: It should be a valid payment term. Error: AR_DAPI_TERM_NAME_INVALID AR_DAPI_TERM_ID_INVALID p_term_name IN VARCHAR2
Payment terms name for the transactions. You can override payment terms. Default: Following hierarchy is used to default payment terms name: 1. 2. 3. Customer bill-to site level Customer address level Customer level transaction type
Parameter p_salesrep_id
Type IN
Data-type NUMBER
Required*
Description Salesperson identifier for the transactions. You can override salesperson. Default: Default the primary ID from the bill-to customer. If salescredits are required and no ID is defaulted from the bill-to customer, then p_salesrep_id is set to -3, which means "No sales credit". Validation: It should be a valid salesperson in the system. Error: AR_DAPI_SALESREP_NAME_INVALID AR_DAPI_SALESREP_ID_INVALID
p_salesrep_name
IN
VARCHAR2
Salesperson name for the transactions. You can override salesperson. Default: Default the primary from the bill-to customer. If salescredits are required and no salesperson is defaulted from the bill-to customer, then p_salesrep_name is set to -3, which means "No sales credit". Validation: It should be a valid salesperson in the system. Error: AR_DAPI_SALESREP_NAME_INVALID AR_DAPI_SALESREP_ID_INVALID
p_interface_header_ context
IN
VARCHAR2
IN
VARCHAR2
Interface header attribute value Default: Null Validation: Null Error: Null
Parameter p_attribute_category
Type IN
Data-type VARCHAR2
Required*
Description Descriptive Flexfield structure defining column. Default: Null Validation: It should be a valid structure. Error: Null
p_attribute1 to p_attribute15
IN
VARCHAR2
Descriptive Flexfield segment column. Default: Null Validation: It should be a valid segment. Error: Validate_Desc_Flexfield
p_global_attr_cust_r ec
IN
This is a record type that contains all the 25 global descriptive flexfield segments and one global descriptive flexfield structure defining column. Default: None Validation: None Error:
p_document_numbe r
IN
NUMBER
Value assigned to document receipt. Default: Null. Validation: User should not pass the value if the current document sequence is automatic. Document sequence value should not be entered if the Sequential Numbering profile option is set to Not Used. Error: AR_RAPI_DOC_SEQ_AUTOMATIC AR_RAPI_DOC_SEQ_NOT_EXIST_A AR_RAPI_DOC_SEQ_NOT_EXIST_P
p_ussgl_transaction_ code
IN
VARCHAR2
Code defined by public sector accounting. Default: None Validation: None Error: None
Parameter p_printing_option
Type IN
Data-type VARCHAR2
Required*
Description Printing option for the invoice. Default: Default is print option of transaction type. Validation: Can be 'PRI' or 'NOT' Error: AR_DAPI_PO_INVALID
p_default_tax_exem pt_flag
IN
VARCHAR2
Tax exempt flag. You can enter value for the field only if the TAX: Allow Override of Customer Exception profile option is yes. Default: 'S' i.e. Standard Validation: From lookup table for lookup_type = 'TAX_CONTROL_FLAG' Error: AR_DAPI_STATUS_TRX_INVALID
p_status_trx
IN
VARCHAR2
Status of the transaction. This is a user-maintainable field and it can be defined in lookup table. Default: OP, can be CL, PEN, VD Validation: from lookup table for LOOKUP_TYPE = 'INVOICE_TRX_STATUS' Error: AR_DAPI_STATUS_TRX_INVALID
p_financial_charges
IN
VARCHAR2
Indicates whether financial charges are calculated. Default: Null Validation: can be null, Y, N Error: AR_DAPI_FC_INVALID
p_agreement_id
IN
NUMBER
Agreement associated with transaction for the customer. Default: Null Validation: Null Error: Null
Parameter p_special_instructio ns
Type IN
Data-type VARCHAR2
Required*
Description Any special instruction for the transaction, up to 240 characters. Default: Null Validation: Null Error: Null
p_comments p_purchase_order
IN
VARCHAR2
User's comments. Purchase order number. Default: Null Validation: Null Error: Null
p_purchase_order_r evision
IN
VARCHAR2
Purchase order revision number. Default: Null Validation: Null Error: Null
p_purchase_order_d ate
IN
DATE
p_remit_to_address_ id
IN
NUMBER
Remit-to address ID for the customer Default: Remit_to_address assigned to country, state, and postal code combination for the customer's address. Validate from the view: AR_ACTIVE_REMIT_TO_ADDRESSES_V Error: AR_DAPI_LOC_SITE_NUM_IGN AR_DAPI_REMIT_ADDR_ID_INVD
Type IN
Data-type NUMBER
Required*
Description The customer_id for the sold-to customer. Default: Bill_to_customer_id Validation:
Customer exists and has prospect code = CUSTOMER Customer has a profile defined at customer level Either bill-to or ship-to customer must exist
The name for the entered/defaulted sold-to customer. Default: none Validation: 1. Customer exists and has prospect code = CUSTOMER Customer has a profile defined at customer level Either bill-to or ship-to customer must exist
2.
3.
Type IN
Data-type VARCHAR2
Required*
Description The number for the entered/defaulted sold-to customer. Default: None Validation: Customer exists and has prospect code = CUSTOMER. Customer has a profile defined at customer level. Either bill-to or ship-to customer must exist. Error: AR_DAPI_SOLD_CUST_NUM_INVALID AR_DAPI_SOLD_CUST_COM_INVALID
p_paying_customer_ id
The customer_id associated with the customer bank account assigned to your transaction. Default: Same as bill-to customer Validation: Customer exists and has prospect code = CUSTOMER. Customer has a profile defined at customer level. Either bill-to or ship-to customer must exist. Error: AR_DAPI_CUS_NAME_NUM_IGN AR_DAPI_PAY_CUST_ID_INVALID
p_paying_customer_ name
The name for the entered/defaulted paying customer. Default: None Validation: Customer exists and has prospect code = CUSTOMER. Customer has a profile defined at customer level. Either bill-to or ship-to customer must exist. Error: AR_DAPI_PAY_CUST_NAME_INVALID AR_DAPI_PAY_CUST_COM_INVALID
Type
Data-type
Required*
Description The number for the entered/defaulted paying customer. Default: None Validation: Customer exists and has prospect code = CUSTOMER. Customer has a profile defined at customer level. Either bill-to or ship-to customer must exist. Error: AR_DAPI_PAY_CUST_NUM_INVALID AR_DAPI_PAY_CUST_COM_INVALID
p_paying_location
The location for the paying customer. Default: Null Validation: This field is mandatory. Error: AR_DAPI_CUS_LOC_INVALID
p_receipt_method_i d
IN
NUMBER
Identifies the receipt method of the transactions. Default: From receipt method name. Validation: Validation detailed in Example, page 5-25. Error: AR_RAPI_RCPT_MD_NAME_IGN AR_RAPI_RCPT_MD_ID_INVALID
p_receipt_method_n ame
IN
VARCHAR2
The receipt method name of the transactions. Default: None Validation: None Error: AR_RAPI_RCPT_MD_NAME_INVALID
Type IN
Data-type NUMBER
Required*
Description Customer bank account identifier. Default: None Validation: From AP_BANK_ACCOUNTS table. Error: AR_RAPI_CUS_BK_NAME_NUM_IGN AR_RAPI_CUS_BK_AC_ID_INVALID
p_cust_bank_accoun t_name
IN
VARCHAR2
Customer bank account name. Default: None Validation: From AP_BANK_ACCOUNTS table. Error: AR_RAPI_CUS_BK_AC_NAME_INVALID AR_RAPI_CUS_BK_AC_2_INVALID
p_cust_bank_accoun t_number
IN
VARCHAR2
Customer bank account number. Default: None Validation: From AP_BANK_ACCOUNTS table. Error: AR_RAPI_CUS_BK_AC_NUM_INVALID AR_RAPI_CUS_BK_AC_2_INVALID
p_start_date_commit ment
IN
DATE
Start date of commitment. Default: Sysdate Validation: Based on end date, etc. Error: AR_TW_BAD_COMMITMT_DATE_RAN GE AR_TW_COMMIT_END_TRX_DATE AR_TW_BAD_DATE_COMMITMENT
Type IN
Data-type DATE
Required*
Description End date of commitment. Default: Null Validation: Based on start date, etc. Error: AR_TW_BAD_COMMITMT_DATE_RAN GE AR_TW_COMMIT_END_TRX_DATE AR_TW_BAD_DATE_COMMITMENT
p_amount
IN
NUMBER
Deposit amount. Default: Cannot be negative. Validation: Based on start date, etc. This field is mandatory. Error: AR_DAPI_COMM_AMOUNT_NULL AR_TW_COMMIT_AMOUNT_NEGATIV E
p_inventory_id
IN
NUMBER
Item ID of commitment. You can enter memo or item ID. Default: Null Validation: Based on MTL_SYSTEM_ITEMS_B table. Error: AR_DAPI_INV_ID_INVALID AR_DAPI_INV_MEMO_COM
p_memo_line_id
IN
NUMBER
Memo line ID. You can enter memo or item ID. Default: Null Validation: Based on AR_MEMO_LINES table. Error: AR_DAPI_MEMO_NAME_INVALID AR_DAPI_MEMO_WRG AR_DAPI_INV_MEMO_COM
Parameter p_memo_line_name
Type IN
Data-type VARCHAR2
Required*
Description Deposit amount. Default: Null Validation: Based on AR_MEMO_LINES table. Error: AR_DAPI_MEMO_NAME_INVALID AR_DAPI_MEMO_WRG
p_description
IN
VARCHAR2
IN
VARCHAR2
Interface line context for deposit. Default: Null Validation: Null Error: Null
IN
VARCHAR2
NULL
Interface line attribute value for deposit. Default: Null Validation: Null Error: Null
p_comm_attr_catego ry
IN
VARCHAR2
NULL
Descriptive Flexfield structure defining column for deposit lines. Default: Null Validation: It should be a valid structure. Error: Null
Type IN
Data-type VARCHAR2
Required* NULL
Description Descriptive Flexfield segment column for deposit lines. Default: Null Validation: It should be a valid segment. Error: Validate_Desc_Flexfield
IN
global_attr_rec _type
NULL
This is a record type that contains all the 25 global descriptive flexfield segments for deposit lines and one global descriptive flexfield structure defining column. Default: None Validation: None Error: None
p_owner_id
IN
NUMBER
Null
ID of the commitment owner. Default: None Validation: Yes (same as customer contact). Error: N/A
p_owners_name
IN
NUMBER
Null
Name of the commitment owner. Default: None Validation: Yes (same as customer contact) Error: N/A
OUT OUT
VARCHAR2 VARCHAR2
New transaction number, if generated. New CUSTOMER_TRX_ID of the deposit created. New CUSTOMER_TRX_LINE_ID of the deposit created. Row ID of the deposit created. Status of the deposit created.
OUT
VARCHAR2
OUT OUT
VARCHAR2 VARCHAR2
Example
Objective: To create a deposit using a call to ar_deposit_api_pub.Create_deposit and passing a minimum number of Input parameters. Entered parameters:
p_api_version =1.0 , p_init_msg_list ='F' , p_deposit_number = 'Your Deposit Number' p_deposit_date = sysdate, p_currency_code ='USD', p_batch_source_id = Choose a Valid Batch source ID p_cust_trx_type_id = Choose a Valid Transaction Type ID of class "Deposit' p_class ='DEP' i.e. Depsoit p_bill_to_customer_number = Choose a Valid Customer Number p_start_date_commitment = sysdate p_amount = Choose deposit Amount p_description = Your Deposit Description
Before calling the APIs you should set up the application, responsibility and the user in the context of Oracle Applications by calling the following FND API.
fnd_global.apps_initialize ( user_id =>'Your user id', resp_id => 'Your Responsibility id', resp_appl_id => 'Your Application id');
For example:
fnd_global.apps_initialize ( user_id => 1318, resp_id => 50559, resp_appl_id => 222);
p_api_version => 1.0, p_init_msg_list => FND_API.G_TRUE, p_commit => FND_API.G_TRUE, p_validation_level => FND_API.G_VALID_LEVEL_FULL, x_return_status => l_return_status, x_msg_count => l_msg_count, x_msg_data => l_msg_data, p_deposit_number => 'dapi_'||userenv('SESSIONID'), p_deposit_date => sysdate, p_currency_code => 'USD', p_batch_source_id => 'Choose a Valid Batch source ID', p_cust_trx_type_id => 'Choose a Valid Transaction Type ID of class Deposit', p_class => 'DEP' , p_bill_to_customer_number => 'Choose a Valid Customer Number', p_start_date_commitment => sysdate, p_amount => 'Choose deposit Amount', p_description => 'Your Deposit Description', X_new_trx_number =>l_new_trx_number, X_new_customer_trx_id =>l_new_customer_trx_id, X_new_customer_trx_line_id =>l_new_customer_trx_line_id, X_new_rowid =>l_new_rowid, X_new_status =>l_new_status ) ; IF l_msg_count = 1 Then 2. 3.
There is one message raised by the API, so it has been sent out. In the parameter x_msg_data, get it.
dbms_output.put_line('l_msg_data '||l_msg_data); ELSIF l_msg_count > 1 Then
4. 5.
The messages on the stack are more than one, so call them in a loop. And print the messages.
LOOP IF nvl(l_count,0) < l_msg_count THEN l_count := nvl(l_count,0) +1 ; l_msg_data := FND_MSG_PUB.Get(FND_MSG_PUB.G_NEXT,FND_API.G_FALSE); IF l_count = 1 THEN dbms_output.put_line('l_msg_data 1 '||l_msg_data); ELSIF l_count = 2 THEN dbms_output.put_line('l_msg_data 2 '||l_msg_data); ELSIF l_count = 3 THEN dbms_output.put_line('l_msg_data 3 '||l_msg_data); ELSIF l_count = 4 THEN dbms_output.put_line('l_msg_data 4 '||l_msg_data); ELSIF l_count = 5 THEN dbms_output.put_line('l_msg_data 5 '||l_msg_data); ELSIF l_count = 6 THEN dbms_output.put_line('l_msg_data 6 '||l_msg_data); END IF; dbms_output.put_line('l_msg_data '||to_char(l_count)||': '||l_msg_data); ELSE EXIT; END IF; END LOOP; END IF; Commit; END;
Depending on the message level threshold set the profile option FND_API_MSG_LEVEL_THRESHOLD, the messages put on the message stack may contain both the error messages and the warnings.
AR_DEPOSIT_API_PUB.insert_non_rev_salescredit
This routine is called to assign nonrevenue sales credit to salespersons for a deposit. You can create as many of the nonrevenue credit assignments as you need. This API routine has 4 output and 22 input parameters in total. The following is the breakdown of the parameters:
Input
Standard API parameters: 4 Owners parameters: 22
Output
Standard API parameters: 3 Owners parameters: 0
Parameter Descriptions
The following table lists the API parameters.
Parameter p_api_version
Type IN
Data-type NUMBER
Required Yes
Default Value
Description Used to compare version numbers of incoming calls to its current version number. Unexpected error is raised if version incompatibility exists. In the current version of the API, you should pass in a value of 1.0 for this parameter. Allows API callers to request that the API does initialization of the message list on their behalf. Used by API callers to ask the API to commit on their behalf. Not to be used currently as this is a public API. Represents the API overall return status. Number of messages in the API message list. This is the message in encoded format if x_msg_count=1.
p_init_msg_list
IN
VARCHAR 2
FND_API.G_FALS E
p_commit
IN
VARCHAR 2 NUMBER
p_validation_lev el x_return_status
IN
OUT
VARCHAR 2 NUMBER
x_msg_count
OUT
x_msg_data
OUT
VARCHAR 2
Parameter p_customer_trx_id
Type IN
Data-type NUMBER
Required
Description Customer_trx_id of the deposit created. Default: None Validation: Yes Error: N/A
p_salesrep_number
IN
NUMBER
Null
Salesperson number. Default: None Validation: Yes (same as customer contact). Error: N/A
p_salesrep_id
IN
NUMBER
p_non_revenue_amo unt_split
IN
NUMBER
Nonrevenue credit amount associated with salesperson. Default: None Validation: Yes Error: N/A
p_non_revenue_perc ent_split
IN
NUMBER
Nonrevenue credit percent associated with salesperson. Default: None Validation: Yes Error: N/A
p_attribute_category
IN
VARCHAR 2
Descriptive Flexfield structure defining column. Default: Null Validation: It should be a valid structure. Error: Null
Type IN
Data-type VARCHAR 2
Required
Description Descriptive Flexfield segment column. Default: Null Validation: It should be a valid segment. Error: Validate_Desc_Flexfield
Example
Objective: To create owner assignment using ar_deposit_api_pub. insert_non_rev_salescredit and passing a minimum number of Input parameters. Entered parameters:
p_api_version => 1.0 , p_init_msg_list => 'F', ,p_customer_trx_id => 'Valid Customer Trx ID, Must be a deposit' ,p_salesrep_id => -3 , means no Sales Rep p_non_revenue_percent_split => 300
Before calling the APIs you should set up the application, responsibility and the user in the context of Oracle Application by calling the following FND API.
fnd_global.apps_initialize ( user_id =>'Your user id', resp_id => 'Your Responsibility id', resp_appl_id => 'Your Application id');
For example:
fnd_global.apps_initialize ( user_id => 1318, resp_id => 50559, resp_appl_id => 222);
BEGIN fnd_global.apps_initialize ( user_id => 1318, resp_id => 50559, resp_appl_id => 222); ar_deposit_api_pub.insert_non_rev_salescredit( 1.
p_api_version
=> 1.0, p_init_msg_list => FND_API.G_TRUE, p_commit => FND_API.G_TRUE, p_validation_level => FND_API.G_VALID_LEVEL_FULL, x_return_status => l_return_status, x_msg_count => l_msg_count, x_msg_data => l_msg_data, p_customer_trx_id => ' Valid Customer Trx ID , Must be a deposit', p_salesrep_id => -3, p_non_revenue_amount_split => 300); dbms_output.put_line('return status '||l_return_status); dbms_output.put_line('l_msg_count '||to_char(l_msg_count)); IF l_msg_count 2. 3. = 1 Then
There is one message raised by the API, so it has been sent out. In the parameter x_msg_data, get it.
dbms_output.put_line('l_msg_data '||l_msg_data); ELSIF l_msg_count > 1 Then
4. 5.
The messages on the stack are more than one, so call them in a loop. And print the messages.
LOOP IF nvl(l_count,0) < l_msg_count THEN l_count := nvl(l_count,0) +1 ; l_msg_data := FND_MSG_PUB.Get(FND_MSG_PUB.G_NEXT,FND_API.G_FALSE); IF l_count = 1 THEN dbms_output.put_line('l_msg_data 1 '||l_msg_data); ELSIF l_count = 2 THEN dbms_output.put_line('l_msg_data 2 '||l_msg_data); ELSIF l_count = 3 THEN dbms_output.put_line('l_msg_data 3 '||l_msg_data); ELSIF l_count = 4 THEN dbms_output.put_line('l_msg_data 4 '||l_msg_data); ELSIF l_count = 5 THEN dbms_output.put_line('l_msg_data 5 '||l_msg_data); ELSIF l_count = 6 THEN dbms_output.put_line('l_msg_data 6 '||l_msg_data); END IF; dbms_output.put_line('l_msg_data '||to_char(l_count)||': '||l_msg_data); ELSE EXIT; END IF; END LOOP; END IF; Commit; END;
Depending on the message level threshold set the profile option FND_API_MSG_LEVEL_THRESHOLD, the messages put on the message stack may contain both the error messages and the warnings.
Messages
Messages play an important role in the effectiveness of your API calls. The right message is raised at the right point to convey to you the exact error that has occurred or any warnings that have been raised. In the Commitment (Deposit) API, all error messages and warnings raised during the execution are put on the message stack and can be retrieved by the user as described in Exception Handling and Result Messages, page 1-3.
The commitment amount requires a value. The customer location is invalid. The customer site use ID could not be defaulted. The customer contact is invalid. A value for the customer ID, name, or number is required. The batch name or ID is invalid. The transaction type ID is invalid. The transaction type is invalid. The term name is invalid. The term ID is invalid. The sales representative name is invalid. The sales representative ID is invalid.
E E E
294852 294853
AR_DAPI_CUS_CONTACT_INVALID AR_DAPI_CUST_NULL
E E
E E E E E E E
Message Code
Message Text
Type
The batch source name is invalid. The batch source ID is invalid. The batch source name has been ignored. The sold-to customer name is invalid.
E E W E
294863
294864
The combination of sold-to customer name and number must be valid. The paying customer name is invalid.
294865
AR_DAPI_PAY_CUST_NAME_INVALI D AR_DAPI_SOLD_CUST_DFT
The sold-to customer defaulted to the bill-to customer. The combination of paying customer name and number must be valid. The paying customer number is invalid. The paying customer name and number have been ignored. The paying customer ID is invalid. The sold-to customer ID is invalid. The sold-to customer name and number have been ignored. The printing option is invalid. The transaction status is invalid. The default tax flag is invalid. A batch or a batch in the profile is required.
294866
AR_DAPI_PAY_CUST_COM_INVALID
294867
AR_DAPI_PAY_CUST_NUM_INVALID AR_DAPI_CUS_NAME_NUM_IGN
E W
294868 294869
E E W
294871 294872
E E E E
Message Code
Message Text
Type
AR_DAPI_MEMO_NAME_INVALID AR_DAPI_MEMO_WRG
The memo name is invalid. The memo ID, not the provided memo name, has been used. The type ID, not the provided type, has been used. The inventory item ID is invalid. Enter either a memo or inventory item ID. A bill-to or ship-to customer is required. Both a first and last name are required for the bill-to contact. Both a first and last name are required for the ship-to contact. A deposit number is required. The finance charges are invalid. The location site number has been ignored. The remit-to address ID is invalid. The customer location site number is invalid. The remit-to address did not successfully default. A value for either the transaction type or ID is required. The combination of the bill-to contact's first and last name must be valid.
E W
AR_DAPI_TRANS_TYPE_IGN
294877 294878
AR_DAPI_INV_ID_INVALID AR_DAPI_INV_MEMO_COM AR_DAPI_BILL_OR_SHIP_CUST_REQ AR_DAPI_BILL_CONTACT_NAME_IN V AR_DAPI_SHIP_CONTACT_NAME_IN V AR_DAPI_DEPOSIT_NO_NULL AR_DAPI_FC_INVALID AR_DAPI_LOC_SITE_NUM_IGN AR_DAPI_REMIT_ADDR_ID_INVD AR_DAPI_CUST_LOC_SITE_NUM_INV AR_DAPI_REMIT_ADDRESS_DFT_ERR
E E E E
294879
294881
E E W E E E
294885
AR_DAPI_TRANS_TYPE_NULL
294886
AR_DAPI_BIll_CONTACT_COM_INV
Message Code
Message Text
Type
AR_DAPI_SHIP_CONTACT_COM_INV
The combination of the ship-to contact's first and last name must be valid. The deposit did not successfully post. The header was not successfully inserted for the deposit. The bill-to customer was defaulted from the ship-to customer because a value for the bill-to customer did not exist. The location is invalid. The salesperson was not successfully inserted for the deposit. The salesperson ID and name are required. A percentage or amount of nonrevenue sales credit is required. A deposit number or customer transaction ID is required. The deposit number has been ignored. The customer transaction ID is invalid. The deposit number is invalid. The nonrevenue sales credit amount has been ignored.
294888 294889
AR_DAPI_POST_COMMIT_ST AR_DAPI_INSERT_HEADER_ST
E E
AR_DAPI_BILL_VAL_SHIP_IGN
294890 294891
AR_DAPI_LOC_INV AR_DAPI_SALESREP_ST
E E
294892 294893
AR_DAPI_SALESREP_NO_ID_NAME AR_DAPI_NON_REV_AMT_PCT
E E
294894
AR_DAPI_DEP_NO_ID_REQ
294895 294896
W E E W
6
Invoice Creation API User Notes
This chapter covers the following topics: Overview API Usage
Overview
This document outlines the use of Invoice Creation API. This API allows users to create an invoice using simple calls to PL/SQL functions. The Invoice Creation API is not intended to replace the existing Transaction workbench, AutoInvoice, or the Transaction API program. You can access this API in two ways: As standard PL/SQL servers-side routine calls Through Forms, utilizing the capability of Forms6 to have a procedure as its underlying base table
Modular Approach
To modularize the Invoice Creation API, the basic structure of the API is divided into four parts:
1. 2.
Get all the default values from profiles and AR_SYSTEM_PARAMETERS table. Populate four global temporary tables for Header, Lines, Distributions and Sales Credits from PL/SQL tables and Default values (if user has not entered). Validate all the parameters entered by the user. Call the entity handlers to perform the relevant task (such as Create).
3. 4.
This results in easy to understand and easy to maintain code. Any new functionality can be added by a simple code plug-in at each of the four parts.
Debug Messages
The Invoice Creation API uses the Oracle Applications Logging Framework to log all debug messages in a central repository. Please query using module name, ar.plsql.InvoiceAPI. The debugging can be enabled by the setting the following profile options:
1. 2.
FND: Debug Log Enabled(AFLOG_ENABLED) to 'Y'. FND: Debug Log Level (AFLOG_LEVEL) to 'Statement'.
Once the above parameters are set, the message will be logged in the FND repository. The API to log accepts log level, module name, and the actual text. An example is given below:
FND_LOG.STRING(P_LOG_LEVEL,P_MODULE_NAME, P_MESSAGE);
All Invoice Creation API debug messages use a module name of 'ar.plsql.InvoiceAPI'. See: Oracle Applications Supportability Guide.
API Usage
To create an invoice, you can call the following PL/SQL APIs: AR_INVOICE_API_PUB.CREATE_INVOICE: Creates multiple invoices in a batch. AR_INVOICE_API_PUB.CREATE_SINGLE_INVOICE: Create a single invoice and return customer_trx_id.
AR_INVOICE_API_PUB
The API contains 2 public procedures to create either a single invoice, or multiple invoices in batch mode. The input parameters are the same for both procedures and are explained in the following section. Use the CREATE_INVOICE procedure to create multiple invoices in a batch. The procedure returns a global record type structure which contains the batch_id to retrieve the necessary data from the transaction tables. The structure is defined in the package specification of ar_invoice_api_pub. Please refer to Example for Creating Multiple Invoices in a Batch, page 6-17 for usage.
Use the CREATE_SINGLE_INVOICE procedure to create a single invoice. The procedure returns customer_trx_id as an out parameter. Please refer to Example for Creating a Single Invoice, page 6-19 for usage.
API Parameters
The API accepts the following parameters:
p_api_version p_init_msg_list p_commit p_batch_source_rec p_trx_header_tbl p_trx_lines_tbl p_trx_dist_tbl p_trx_salescredits_tbl x_customer_trx_id x_return_status x_msg_count x_msg_data IN IN IN IN IN IN IN IN OUT OUT OUT OUT NUMBER, VARCHAR2 := FND_API.G_FALSE, VARCHAR2 := FND_API.G_FALSE, batch_source_rec_type, trx_header_tbl_type, trx_line_tbl_type, trx_dist_tbl_type, trx_salescredits_tbl_type, NUMBER, VARCHAR2, NUMBER, VARCHAR2,
p_init_msg_list
IN
VARCHAR2
FND_API.G_FAL SE
p_commit
IN
VARCHAR2
FND_API.G_FAL SE
x_customer_trx_i d
OUT
NUMBER
x_return_status
OUT
VARCHAR2
Parameter x_msg_count
Type OUT
Required
Default Value
Description Number of messages in the PI message list (not used by this API). Message in case API encounters any unexpected error.
x_message_data
OUT
VARCHAR2
P_BATCH_SOURCE_REC Parameter
The P_BATCH_SOURCE_REC parameter is of PL/SQL record type, and has the following attributes, as described in this table:
Attribute Name Data Type NUMBER Requir ed Default Value Description
batch_source_id
Null
If batch_source_id is null then value will be derived from AR_RA_BATCH_SOURCE profile option. In case the value is passed then it will be validated against ra_batch_sources. Only 'Manual' batch sources are allowed. If the value is null then Sysdate will be taken.
default_date
DATE
Null
P_TRX_HEADER_TBL Parameter
The P_TRX_HEADER_TBL parameter is of PL/SQL table type TRX_HEADER_REC_TYPE. TRX_HEADER_REC_TYPE has the following attributes, as described in this table:
Attribute Name Data Type Require d Yes Default Value Description
trx_header_id
NUMBER
Identifier for the Invoice header record. This must be unique for each record. This column can be generated based on a sequence or any number value. The value does not get recorded into any table.
Attribute Name
Data Type
Require d
Description
trx_number
VARCHAR2(30 )
This is the transaction number for the invoice. This field should not be populated if the batch source has Copy Document Sequence Number to Transaction Number checked or if Automatic Transaction Numbering is enabled. Invoice Date. If no value is passed then p_batch_source_rec.default_date is used. If that too is not passed then sysdate is used. General ledger Date. If no date is passed then p_batch_source_rec.default_date is used. If that too is not passed then sysdate is used. Transaction Currency. If not populated then ar_system_parameters is used to retrieve it. The currency if populated must be active as of the transaction date. Transaction Type Identifier. Only 'INV' type is allowed. Validated against ra_cust_trx_types. If not populated, then it is retrieved from the batch source. Bill To Customer ID. This must exist in hz_cust_accounts table. The customer must be an active ('A') customer. Validated against hz_cust_accounts.cust_account_id. Bill To Customer Number. If both Bill To Customer ID and Bill To Customer Number are passed, then the former will take precedence.Validated against hz_cust_accounts.account_number. Bill To Customer Name. If all three are passed, the precedence is as follows: Customer ID, Customer Number, then Customer Name. Bill To Customer Contact ID. This must exist for the Bill To Customer and Bill To Address combination.
trx_date
DATE
Null
gl_date
DATE
Null
trx_currency
VARCHAR2(30 )
Null
cust_trx_type_id
NUMBER
Null
bill_to_customer_id
NUMBER
Yes
bill_to_account_num ber
VARCHAR2(30 )
Null
bill_to_customer_na me
VARCHAR2 (260)
Null
bill_to_contact_id
NUMBER
Null
Attribute Name
Data Type
Require d
Description
bill_to_address_id
NUMBER
Bill To Address ID. This must exist in hz_cust_acct_sites for the populated Bill To Customer ID Bill To Site use ID. The site use ID must exist in combination with Ship To Customer ID, Ship To Address ID. Ship To Customer ID. This must exist in hz_cust_accounts table. Ship To Customer Number. If both Bill To Customer ID and Ship To Customer Number are passed, then the former will take precedence. Ship To Customer Name. If all three are passed, the precedence is as follows: Customer ID, Customer Number, then Customer Name. Ship To Customer Contact ID. This must exist for the Ship To Customer and Ship To Address combination. Ship To Address ID. This must exist in hz_cust_acct_sites for the populated Ship To Customer ID. Ship To Site use ID. The site use ID must exist in combination with Ship To Customer ID, Ship To Address ID. Ship To Customer ID. This must exist in hz_cust_accounts table. Payment Terms Identifier. The Term ID must be valid for the transaction date. If not populated, then it is retrieved from ra_terms based on bill_to_customer_id and bill_to_site_use_id.
bill_to_site_use_id
NUMBER
Null
ship_to_customer_id
NUMBER
ship_to_account_nu mber
VARCHAR2(30 )
Null
ship_to_customer_n ame
VARCHAR2 (260)
Null
ship_to_contact_id
NUMBER
Null
ship_to_address_id
NUMBER
Null
ship_to_site_use_id
NUMBER
Null
sold_to_customer_id
NUMBER
Null
term_id
NUMBER
Null
Attribute Name
Data Type
Require d
Description
primary_salesrep_id
NUMBER
Primary Salesrep ID. This is required if Salesperson check box is checked in the System Options form. If not populated, then it is derived based on bill-to_customer_id and bill_to_site_use_id. Primary Salesrep name. If both salesrep ID and name are passed, then Salesrep ID will take precedence. Exchange Rate Type. This must exist in gl_daily_conversion_types. Required if trx_currency is different from functional currency. If not populated, then it will derive from gl. Exchange Date. Required if trx_currency is different from functional currency. If not populated, then it will derive from gl. Exchange Rate. This should be entered only if transaction currency is different from the functional currency and exchange rate type is 'User'. Territory ID. If not populated, then it is defaulted based on the following hierarchy:
primary_salesrep_na me
VARCHAR2 (240)
Null
exchange_rate_type
VARCHAR2(60 )
Null
exchange_date
DATE
Null
exchange_rate
NUMBER
Null
territory_id
NUMBER
Null
The Bill To site use The Ship To Site Use The Primary Salesrep's territory depending on the value of the DEFAULT_TERRITORY system option
remit_to_address_id
NUMBER
Null
Remit To Address ID. If not populated, then it is defaulted based on country, state, and postal code of bill_to_site_use_id. If populated, then validated against ar_active_remit_to_addresses_v.
Attribute Name
Data Type
Require d
Description
invoicing_rule_id
NUMBER
Invoicing Rule ID. Valid values are -2 and -3. If you enter a value here, then you must populate accounting rule for line type = 'LINE'. Revenue Accounting lookup code for INVOICE_PRINT_OPTIONS. Valid codes are PRI - Print and NOT - Do not Print. Purchase Order Number for this transaction.
printing_option
VARCHAR2(20 )
Null
purchase_order
Null
Null
Purchase Order Revision. This must not be entered if purchase order is not populated. Purchase Order date. This must not be entered if purchase order is not populated. Comments. Value can be printed on an invoice using the Print Invoice view. Stores the special instruction. Value can be printed on an invoice using the Print Invoice view. Indicates if finance charges are included. Y for yes, N otherwise. This is the payment identifier for this transaction. If not populated, then it is defaulted based on the following hierarchy: 1. Primary receipt method of parent primary bill to site Primary receipt method of the parent customer Primary receipt method of the bill to site Primary receipt method of the bill-to customer
Null
comments
Null
internal_notes
Null
finance_charges
VARCHAR2(1)
Null
receipt_method_id
NUMBER
Null
2.
3. 4.
Attribute Name
Data Type
Require d
Description
related_customer_tr x_id
NUMBER
Customer transaction ID of the document to which this transaction is related. Validated against ra_customer_trx_all.customer_trx_id. Not required for on-account credit memos. Customer Agreement identifier for this transaction. If not populated, then it will be defaulted from the commitment. Must exist in SO_AGREEMENTS. (For future use.) Ship Via Code. If populated, then validated against org_freight. Ship Date Waybill Number
agreement_id
NUMBER
Null
ship_via
Null
ship_date_actual waybill_number
Null Null
fob_point
Null
Free on Board Point. Validated against AR_LOOKUPS.LOOKUP_TYPE='FOB'. Customer bank account ID. If the receipt method is Automatic, then it is required. If not populated, then it will be default using the following hierarchy. 1. Primary bank account assigned to the primary site. Primary bank assigned to parent customer. Primary bank assigned to bill to site use. Primary bank assigned to bill to customer.
customer_bank_acco unt_id
Null
2.
3. 4.
VARCHAR2(30 ) VARCHAR2(30 )
Null
Default value for the USSGL Transaction Code Flexfield (for future use) The status of the transaction. If not populated, then defaulted from Transaction Type. Valid values are 'OP', 'CL', 'PEN', 'VD.
Null
Attribute Name
Data Type
Require d
Description
paying_customer_id
NUMBER
This column is required when the RECEIPT_METHOD_ID column is an automatic receipt method. This column is required when the RECEIPT_METHOD_ID column is an automatic receipt method. Document Number. Must not exist in Oracle Receivables. Descriptive flexfield structure definition column. Descriptive flexfield segment.
paying_site_use_id
NUMBER
Null
doc_sequence_value
NUMBER(15)
Null
attribute_category
Null
attribute1 - 10
Null
Null
Reserved for country-specific functionality. (For future use.) Reserved for country-specific functionality. (For future use.) Interface header context.
Null
Null
Null
P_TRX_LINES_TBL Parameter
The P_TRX_LINES_TBL parameter is of PL/SQL table type TRX_LINE_REC_TYPE. TRX_LINE_REC_TYPE has the following attributes, as described in this table:
Attribute Name
Data Type
Required
Default Value
Description
trx_header_id
NUMBER
Yes
Identifier for the Invoice header record. This column can be generated based on a sequence or any number value. The value does not get recorded into any table. This column ties back with P_TRX_HEADER_TBL. Identifier for the Invoice lines record. This column can be generated based on a sequence or any number value. The value does not get recorded into any table. This column is required only if line type is 'TAX' and 'FREIGHT' (if it is associated with any line). Line number of the invoice Reason code. Validated against AR_LOOKUPS.LOOKUP_TYPE = 'INVOICING_REASON'. Inventory item identifier. Mutually exclusive with the column MEMO_LINE_ID. Validated against mtl_system_items.inventory_item_id and invoice_enabled_flag = 'Y'. Line description. Required if inventory_item_id or memo_line_id is not provided. Quantity of an order Quantity of invoice line. Required for Invoices. List price per unit. Selling price per unit for a transaction line. Required for Invoices. Sales order number for this transaction.
trx_line_id
NUMBER
Yes
link_to_trx_line_id
NUMBER
line_number reason_code
NUMBER VARCHAR2(3 0)
Yes
inventory_item_id
NUMBER
description
VARCHAR2 (240)
sales_order
VARCHAR2(5 0)
Attribute Name
Data Type
Required
Default Value
Description
sales_order_line
sales_order_date accounting_rule_id
Sales order date for this transaction. Accounting rule identifier. Must provide a value for invoice with Rule ID. Validated against RA_RULES. Receivables lookup code for STD_LINE_TYPE.
line_type
Yes
attribute_category
attribute1-15
rule_start_date
First GL date of the invoice. Only used for invoice with rules. Interface line context.
amount
Transaction line revenue amount. If line type = 'FREIGHT' or 'TAX', then amount must be populated. Tax precedence for a tax line. Used to compute tax compounding.
tax_precedence
NUMBER
Attribute Name
Data Type
Required
Default Value
Description
tax_rate
NUMBER
Tax rate for a line. Required for TAX line in case amount is not populated. Memo line description identifier. Mutually exclusive with the column INVENTORY_ITEM_ID. Not required for 'TAX' and 'FREIGHT' lines. Unit of measure code. Required for line type of 'LINE' and has a item on the line. Not required for 'TAX' and 'FREIGHT' lines. Default value for the USSGL Transaction Code Flexfield. (For future use.) Default context value for the USSGL Transaction Code Flexfield. (For future use.) Unique identifier for AR_VAT_TAX. Required for 'TAX' Lines. Tax Lines are controlled by the lookup (TAX_CONTROL_FLAG), which allows for standard tax, exempt tax, and required tax. Exemption certificate number for item lines that have TAX_EXEMPT_FLAG set to E for exempt. Tax Exempt Reason, for item lines that have tax_exempt_flag set to "E" (exempt). Intrastate movement ID number that is tied to the shipment information. Reserved for country-specific functionality. (For future use.) Reserved for country-specific functionality. (For future use.)
memo_line_id
NUMBER
uom_code
VARCHAR2(3 )
tax_exempt_flag
VARCHAR2(1 )
tax_exempt_number
VARCHAR2(8 0)
VARCHAR2(3 0) NUMBER
Attribute Name
Data Type
Required
Default Value
Description
amount_includes_ta x_flag
VARCHAR2(1 )
Y indicates tax is inclusive. N indicates tax is exclusive. NULL for lines indicates tax cannot be overridden or tax is a tax group. Cannot be NULL for tax types. Must be NULL for other types. Foreign key to the HR_ORGANIZATIONS table. The warehouse identifies the ship-from location and can be used to control taxation. Within the US, the Warehouse ID is important when calculating tax on the origin/modified origin state sales tax. Outside the US you can use tax groups and conditions to build a schedule of multiple conditional taxes based on both the ship-from and ship-to county/county/state or provinces. Identifies the contract line from Oracle Contracts Core that is associated with this line. Identifies source data from original system.
warehouse_id
NUMBER
contract_line_id
NUMBER
source_data_key1-5
invoiced_line_acctg_ level
P_TRX_DIST_TBL Parameter
The P_TRX_DIST_TBL parameter is of PL/SQL table type TRX_DIST_REC_TYPE. TRX_DIST_REC_TYPE has the following attributes, as described in this table:
Attribute Name Data Type Require d Yes Default Value Description
trx_line_id
NUMBER
Identifier for the Invoice lines record. This column can be generated based on a sequence or any number value. The value does not get recorded into any table.
Attribute Name
Data Type
Require d
Default Value
Description
trx_header_id
NUMBER
Identifier for the Invoice header record. This column can be generated based on a sequence or any number value. The value does not get recorded into any table. This column ties back with P_TRX_HEADER_TBL. Required in case of 'REC' distribution type. Identifier for the Distribution record. This column can be generated based on a sequence or any number value. The value does not get recorded into any table. Account Class for this distribution. Freight, Receivable, Revenue, AutoInvoice Clearing, Tax, Unbilled Receivable, Unearned Revenue, or Charges account type. Amount of this record in the foreign currency. Required if percentage is not passed. Amount of this record in the functional currency. If not populated, then it will be populated based on amount passed. Percent of the line amount represented by this record. Required if amount is not passed. Code combination ID for Accounting Flexfield. Validated against gl_code_combinations.code_combination_id. Descriptive flexfield structure definition column. Descriptive flexfield segment. Comment about the revenue distribution.
trx_dist_id
NUMBER
Yes
account_class
VARCHAR2(20)
Yes
amount
NUMBER
acctd_amount
NUMBER
percent
NUMBER
code_combination_i d
NUMBER
Yes
attribute_category
VARCHAR2(30)
attribute1-15 comments
VARCHAR2(150) VARCHAR2(240)
P_TRX_SALESCREDITS_TBL Parameter
The P_TRX_SALESCREDITS_TBL parameter is of PL/SQL table type TRX_SALESCREDITS_REC_TYPE.
TRX_ SALESCREDITS _REC_TYPE has the following attributes, as described in this table:
Attribute Name Data Type Required Default Value Description
trx_salescredit_id
NUMBER
Yes
Identifier for the Salesperson on the lines record. This column can be generated based on a sequence or any number value. The value does not get recorded into any table. Identifier for the Invoice lines record. This column can be generated based on a sequence or any number value. The value does not get recorded into any table. Identifies the salesperson for this sales credit assignment. Validated against ra_salesreps.salesrep_id. Salesrep Number assignment. Validated against ra_salesreps.salesrep_number. If both number and ID is passed, then ID will take precedence. Sales Credit Type Name. Validated against so_sales_credit_types.name. Sales Credit Type Identifier. Validated against so_sales_credit_types.sales_credit_type_id. If both ID and name are passed, then ID will take precedence. The amount of revenue/non-revenue credit for this salesperson/customer. Required if salescredit_percent_split is not passed. The percent of revenue/non-revenue credit for this salesperson/customer. Required if salescredit_amount_split is not passed. Descriptive flexfield structure definition column. Descriptive flexfield segment.
trx_line_id
NUMBER
Yes
salesrep_id
NUMBER
Yes
salesrep_number
VARCHAR2( 30)
sales_credit_type_na me sales_credit_type_id
Yes
salescredit_amount_ split
NUMBER
salescredit_percent_s plit
NUMBER
attribute_category
attribute1-15
DECLARE
l_return_status l_msg_count l_msg_data l_batch_id varchar2(1); number; varchar2(2000); number;
l_batch_source_rec ar_invoice_api_pub.batch_source_rec_type; l_trx_header_tbl ar_invoice_api_pub.trx_header_tbl_type; l_trx_lines_tbl ar_invoice_api_pub.trx_line_tbl_type; l_trx_dist_tbl ar_invoice_api_pub.trx_dist_tbl_type; l_trx_salescredits_tbl ar_invoice_api_pub.trx_salescredits_tbl_type; CURSOR cBatch IS select customer_trx_id from ra_customer_trx_all where batch_id = l_batch_id; CURSOR cValidTxn IS SELECT trx_header_id From ar_trx_header_gt WHERE trx_header_id not in ( SELECT trx_header_id FROM ar_trx_errors_gt); 2.
BEGIN
1.
2.
3.
4.
5.
6.
7.
8.
Check if there are record exist in error table. If no records exist for a trx_header_id, then only Invoice will create in the system; otherwise not.
For cValidTxnRec IN cvalidTxn loop IF (ar_invoice_api_pub.g_api_outputs.batch_id IS NOT NULL) THEN dbms_output.put_line('Invoice(s) suceessfully created!') ; dbms_output.put_line('Batch ID: ' || ar_invoice_api_pub.g_api_outputs.batch_id); l_batch_id := ar_invoice_api_pub.g_api_outputs.batch_id;
9.
for cBatchRec in cBatch loop dbms_output.put_line ( 'Cust Trx Id '|| cBatchRec.customer_trx_id ); end loop; ELSE dbms_output.put_line('Errors found!'); END IF; End loop; END IF; END; / 10. See all the validation errors. SET LINESIZE 200 COLUMN trx_header_id HEADING 'Header ID' COLUMN trx_line_id HEADING 'Line ID' COLUMN error_message HEADING 'Message' COLUMN invalid_value HEADING 'Invalid Value' COLUMN trx_header_id FORMAT 9999999 COLUMN trx_line_id FORMAT 9999999 COLUMN error_message FORMAT a30 COLUMN invalid_value FORMAT a20 SELECT trx_header_id, trx_line_id, error_message, invalid_value FROM ar_trx_errors_gt;
DECLARE
l_return_status l_msg_count l_msg_data l_batch_id l_cnt varchar2(1); number; varchar2(2000); number; number := 0;
l_batch_source_rec ar_invoice_api_pub.batch_source_rec_type; l_trx_header_tbl ar_invoice_api_pub.trx_header_tbl_type; l_trx_lines_tbl ar_invoice_api_pub.trx_line_tbl_type; l_trx_dist_tbl ar_invoice_api_pub.trx_dist_tbl_type; l_trx_salescredits_tbl ar_invoice_api_pub. l_customer_trx_id number; 2.
BEGIN
1.
2.
l_trx_header_tbl(1).trx_header_id := 101; l_trx_header_tbl(1).trx_number := 'Test Invoice API'; l_trx_header_tbl(1).bill_to_customer_id := 1006; l_trx_header_tbl(1).cust_trx_type_id := 2376; 3.
4.
5.
6.
7.
8.
SELECT count(*) Into cnt From ar_trx_errors_gt; IF cnt = 0 THEN dbms_output.put_line ( 'Customer Trx id '|| l_customer_trx_id); ELSE dbms_output.put_line ( 'Transaction not Created, Please check ar_trx_errors_gt table'); END IF; END; / 9.
Note: In the above examples, we did not pass distribution and sales
credits. Note, however, that you can create an invoice passing distributions and sales credits.
7
Prepayments API User Notes
This chapter covers the following topics: Overview API Usage Messages
Overview
This document outlines the specifications and the methodology for using the Prepayments API. Use the Prepayments API to: Generate a unique payment grouping identifier (payment_set_id) Create a prepayment receipt flagged with this payment_set_id Apply the prepayment receipt to a receivable activity of type Prepayment
You can access this API: As standard PL/SQL server-side routine calls Through forms, utilizing the capability of Forms6 to have a procedure as its underlying base table
The Prepayments API lets you model down payments, deposits, or prepayments as receipts created in Oracle Receivables in advance of the invoice creation event. It is not intended for the purpose of creating receipts for existing invoices, simply before the invoices.
API Usage
This section describes how to use the Prepayments API to: Create a prepayment receipt Apply the prepayment receipt to the prepayment activity Calculate the amount of all the installments of a particular payment term
To create, apply, and refund a prepayment receipt, you can call the following PL/SQL routine: AR_PREPAYMENTS_PUB.Create_Prepayment, page 7-2: Use this routine to create a prepayment receipt. AR_PREPAYMENTS_PUB.Get_Installment, page 7-9: Use this routine to calculate the amount of all installments of a given payment term.
AR_PREPAYMENTS_PUB.Create_Prepayment
This routine is called to create a prepayment receipt. This API routine has 5 output, 8 input-output, and 56 input parameters. Of the output parameters, the API returns 5.
Input
Standard API parameters: 4 Prepayment parameters: 48 + 8 (INOUT) parameters 4 (global descriptive flexfield parameters)
Output
Standard API parameters: 3 Prepayment parameters: 2 + 8 (INOUT) parameters
Parameter Descriptions
The input descriptive flexfield parameter is a record of type attribute_rec_type.
TYPE attribute_rec_type IS RECORD( attribute_category VARCHAR2(30) DEFAULT NULL, attribute1 VARCHAR2(150) DEFAULT NULL, attribute2 VARCHAR2(150) DEFAULT NULL, attribute3 VARCHAR2(150) DEFAULT NULL, attribute4 VARCHAR2(150) DEFAULT NULL, attribute5 VARCHAR2(150) DEFAULT NULL, attribute6 VARCHAR2(150) DEFAULT NULL, attribute7 VARCHAR2(150) DEFAULT NULL, attribute8 VARCHAR2(150) DEFAULT NULL, attribute9 VARCHAR2(150) DEFAULT NULL, attribute10 VARCHAR2(150) DEFAULT NULL, attribute11 VARCHAR2(150) DEFAULT NULL, attribute12 VARCHAR2(150) DEFAULT NULL, attribute13 VARCHAR2(150) DEFAULT NULL, attribute14 VARCHAR2(150) DEFAULT NULL, attribute15 VARCHAR2(150) DEFAULT NULL);
The following table lists the parameters that pertain specifically to the Create Prepayment routine:
Parameter Type Mandatory/Op tional M O O Data-type Default Value Description
IN IN IN
Parameter
Type
Mandatory/Op tional O
Data-type
Default Value
Description
p_validation_lev el x_return_status x_msg_count x_msg_data p_usr_currency_ code p_currency_code p_usr_exchange_ rate_type p_exchange_rate _type
IN
NUMBER
Default FND_API.G_VALID_LEVEL_FULL Return status of the prepayment call Message counts in message stack Message text in message stack. Translated currency code
M M M O
IN IN
M O
VARCHAR2 VARCHAR2
IN
VARCHAR2
Exchange rate type, if other than functional currency (if functional currency is different than receipt) Exchange rate date
p_exchange_rate _date p_exchange_rate p_amount p_factor_discoun t_amount p_receipt_numb er p_receipt_date p_gl_date p_maturity_date
IN
DATE
IN IN IN
O M O
INO UT IN IN IN
VARCHAR2
Receipt number, need to pass if doc sequence is not enabled Receipt creation Date GL date of the receipt Maturity date of the receipt
O O O
Parameter
Type
Mandatory/Op tional O
Data-type
Default Value
Description
p_postmark_dat e p_customer_id p_customer_nam e p_customer_nu mber p_customer_ban k_account_id p_customer_ban k_account_num p_customer_ban k_account_name p_location p_customer_site _use_id p_customer_rece ipt_reference p_override_remi t_account_flag p_remittance_ba nk_account_id p_remittance_ba nk_account_num p_remittance_ba nk_account_nam e
IN
DATE
IN IN
M O
NUMBER VARCHAR2
IN
NUMBER
Customer Number
IN
NUMBER
IN
VARCHAR2
IN
VARCHAR2
IN IN
O M
VARCHAR2 NUMBER
IN
VARCHAR2
IN
VARCHAR2
IN
VARCHAR2
IN
VARCHAR2
IN
VARCHAR2
Parameter
Type
Mandatory/Op tional O M
Data-type
Default Value
Description
IN IN
DATE NUMBER
IN
VARCHAR2
IN
NUMBER
Doc sequence value, if doc sequence is enabled (mandatory if doc sequence is enabled) USSGL transaction code, if exists, on receipt header Anticipated receipt clearing date
p_ussgl_transact ion_code p_anticipated_cl earing_date p_called_from p_attribute_rec p_global_attribut e_rec p_receipt_comm ents p_issuer_name p_issue_date p_issuer_bank_b ranch_id p_cr_id p_applied_paym ent_schedule_id
IN
NUMBER
IN
DATE
IN IN IN
M O O
Which program called this routine? Receipt Header attributes Global attributes on receipt header (GDF) Receipt header comments
IN
VARCHAR2
IN IN IN
O O O
AR Notes Issuer name AR Notes Issue Date AR Notes Issuer bank branch ID
OUT IN
M M
NUMBER NUMBER
Parameter
Type
Mandatory/Op tional O
Data-type
Default Value
Description
p_amount_appli ed
IN
NUMBER
Specify amount which needs to be put in prepayment out of the receipt amount Prepayment application reference from a lookup code for lookup type AR_PREPAYMENT_TYPE to indicate where it is created from. For example, OM. Application reference ID. For example, order ID. Reference number. For example, order number. Additional reference, if exists
p_application_re f_type
IN
VARCHAR2
p_application_re f_id p_application_re f_num p_secondary_ap plication_ref_id p_receivable_trx _id p_amount_appli ed_from p_apply_date p_apply_gl_date app_ussgl_trans action_code p_show_closed_i nvoices p_move_deferre d_tax app_attribute_re c
NUMBER
VARCHAR2
NUMBER
NUMBER
Receivable activity ID, default if not passed for prepayment. Amount applied in functional currency If null, takes sysdate Application GL date USSGL transaction type code on application Default FALSE
IN
NUMBER
IN IN IN
O O O
IN
VARCHAR2
IN
VARCHAR2
Default Y
IN
RECORD TYPE
Application attributes
Parameter
Type
Mandatory/Op tional O
Data-type
Default Value
Description
IN
RECORD TYPE
IN IN OUT IN
O M
VARCHAR2 VARCHAR2
VARCHAR2
Decides whether to call Oracle Payments. DEFAULT FND_API.G_FALSE Oracle Payments return error code
VARCHAR2
VARCHAR2
NUMBER
Receivable applications ID of the application If passed, it will take the passed payment_set_id while creating prepayment application. Otherwise, generate a new number and pass it back.
IN OUT
NUMBER
Example
The following is a test case for creating a prepayment. Objective: To create a prepayment, passing the minimum number of parameters. Entered parameters: p_api_version p_currency_code p_amount p_customer_id
AR_PREPAYMENTS_PUB.Get_Installment
This routine is called to calculate the amount of all installments of a given payment term. This API routine has 4 output and 3 input parameters. Of the output parameters, the API returns 5.
Input
Standard API parameters: 0 Prepayment parameters: 3
Output
Standard API parameters: 3 Prepayment parameters: 1
Parameter Descriptions
The following table lists the parameters that pertain specifically to the Get Installment routine:
Parameter Type Mandatory/O ptional M M Data-Type Default Value Details
p_term_id p_amount
IN IN
NUMBER VARCHAR2
Payment term ID Input amount for which the installment amount needs to be calculated Currency code for calculating the installment amount A table consisting of installment number and installment amount Return status of the API call Message counts in message stack Message text in message stack.
p_currency_code
IN
VARCHAR2
OUT
NUMBER
M M M
Example
The following is a test case for get_installment. Objective: To get the installment amount given an amount, payment term and currency code. Entered parameters: p_term_id
p_amount p_currency_code
AR_PREPAYMENTS_PUB.get_installment( p_term_id => l_term_id , p_amount => l_amount, p_currency_code => l_currency_code, p_installment_tbl => l_installment_tbl , x_return_status => x_return_status, x_msg_count => x_msg_count, x_msg_data => x_msg_data);
--OUT
Messages
Messages play an important role in the effectiveness of your API calls. The right message is raised at the right point to convey to you the exact error that has occurred or any warnings that have been raised. In the Prepayments API, all error messages and warnings raised during the execution are put on the message stack and can be retrieved by the user as described in Robust Validation, page 1-2. The following is the list of all error messages raised by the Prepayments API.
Message Number 96735 Message Name Message Description
AR_RAPI_CUS_BK_AC_2_INVALID
Invalid combination of customer bank account name and number. The prepayment sequence generation has failed. Please contact your system administrator. Payment term ID is invalid. The amount can not be null, 0, or negative. Currency code is invalid.
294347
AR_RAPI_PREPAY_SEQ_FAILED
96734
Since this API also calls the Receipt API AR_RECEIPT_API_PUB, it could also throw messages raised by the Receipt API. Please refer to messages listed in Receipt API Messages, page 8-136.
8
Receipt API User Notes
This chapter covers the following topics: Overview API Usage Messages
Overview
This document outlines the specifications and the methodology for using the various Receipt APIs. These APIs provide an extension to existing functionality of creating and manipulating receipts through standard AR Receipts forms and lockboxes. You can access these APIs: As standard PL/SQL server-side routine calls Through forms, utilizing the capability of Forms6 to have a procedure as its underlying base table
Unapplying the receipt application to a particular transaction Reversing the receipt Activity application, such as Receipt Write-off Creating a miscellaneous receipt Other account application, such as Claim Investigation Receipt-to-receipt application Creating a cash receipt and an on-account application in one pass
API Usage
To create, apply, unapply, or reverse a cash receipt, you can call the following PL/SQL APIs: Ar_receipt_api_pub.Create_cash, page 8-3: Creates a single cash receipt, as in the case of manually created cash receipts. Ar_receipt_api_pub.Apply, page 8-21: Applies a cash receipt to a particular installment of a debit item. The application can also be a cross currency application. Ar_receipt_api_pub.Create_and_apply, page 8-35: Creates a cash receipt and applies it to a specified installment of a debit item in one pass. Application fails if the creation fails due to some reason.
Ar_receipt_api_pub.Unapply, page 8-55: Unapplies the application of a particular installment of a debit item against the specified cash receipt. Ar_receipt_api_pub.Apply_on_account, page 8-61: Creates an on-account application for a cash receipt. Ar_receipt_api_pub.Unapply_on_account, page 8-66: Unapplies the on-account application on the specified receipt. Ar_receipt_api_pub.Reverse, page 8-70: Reverses the specified receipt. Ar_receipt_api_pub.activity_application, page 8-75: Applies to an activity, such as Receipt Write-off. Ar_receipt_api_pub.activity_unapplication, page 8-82: Unapplies from an activity, such as a Receipt Write-off. Ar_receipt_api_pub.Create_misc, page 8-86: Creates a single miscellaneous receipt. Ar_receipt_api_pub.apply_other_account, page 8-100: Applies to other account activities, such as Claim Investigation (for Trade Management customers only). Ar_receipt_api_pub.unapply_other_account, page 8-107: Unapplies from other account activities, such as Claim Investigation. Ar_receipt_api_pub.apply_open_receipt, page 8-111: Creates a receipt-to-receipt application (payment netting). Ar_receipt_api_pub.unapply_open_receipt, page 8-117: Unapplies a receipt-to-receipt application. Ar_receipt_api_pub.Create_apply_on_acc, page 8-120: Creates a cash receipt and an on-account application in one pass. If the receipt creation fails, then the application fails as well.
Ar_receipt_api_pub.Create_cash
This routine is called to create cash receipts for the payment received in the form of a check or cash. Cash receipts can be created as identified (with a customer) or as unidentified (without a customer).
Note: This routine does not call Oracle Payments directly. See
This API routine has 4 output and 44 input parameters in total. As one of the output parameters, the API returns the cash_receipt_id of the cash receipt created. The following is the breakdown of the parameters:
Input
Standard API parameters: 4 Cash Receipt parameters: 38 + 1 (descriptive flexfield parameter) + 1 (global descriptive flexfield parameter)
Output
Standard API parameters: 3 Cash Receipt parameters: 1
Parameter Descriptions
The input descriptive flexfield parameter is a record of type attribute_rec_type.
TYPE attribute_rec_type IS RECORD (p_attribute_category IN VARCHAR2, p_attribute1 IN VARCHAR2, p_attribute2 IN VARCHAR2, p_attribute3 IN VARCHAR2, p_attribute4 IN VARCHAR2, p_attribute5 IN VARCHAR2, p_attribute6 IN VARCHAR2, p_attribute7 IN VARCHAR2, p_attribute8 IN VARCHAR2, p_attribute9 IN VARCHAR2, p_attribute10 IN VARCHAR2, p_attribute11 IN VARCHAR2, p_attribute12 IN VARCHAR2, p_attribute13 IN VARCHAR2, p_attribute14 IN VARCHAR2, p_attribute15 IN VARCHAR2);
The input global descriptive flexfield parameter is a record of type global_ attribute_rec_type.
TYPE global_attribute_rec_type IS RECORD (p_global_attribute_category IN VARCHAR2, p_global_attribute1 IN VARCHAR2, p_global_attribute2 IN VARCHAR2, p_global_attribute3 IN VARCHAR2, p_global_attribute4 IN VARCHAR2, p_global_attribute5 IN VARCHAR2, p_global_attribute6 IN VARCHAR2, p_global_attribute7 IN VARCHAR2, p_global_attribute8 IN VARCHAR2, p_global_attribute9 IN VARCHAR2, p_global_attribute10 IN VARCHAR2, p_global_attribute11 IN VARCHAR2, p_global_attribute12 IN VARCHAR2, p_global_attribute13 IN VARCHAR2, p_global_attribute14 IN VARCHAR2, p_global_attribute15 IN VARCHAR2, p_global_attribute16 IN VARCHAR2, p_global_attribute17 IN VARCHAR2, p_global_attribute18 IN VARCHAR2, p_global_attribute19 IN VARCHAR2, p_global_attribute20 IN VARCHAR2);
The following table lists standard API parameters that are common to all the routines in the Receipt API.
Parameter Typ e IN Data-type Require d Yes Default Value Description
p_api_version
NUMBER
Used to compare version numbers of incoming calls to its current version number. Unexpected error is raised if version incompatibility exists. In the current version of the API, you should pass in a value of 1.0 for this parameter. Allows API callers to request that the API does initialization of the message list on their behalf. Used by API callers to ask the API to commit on their behalf. Not to be used currently as this is a public API. Represents the API overall return status. Detailed in Return Status, page 1-4.
p_init_msg_list
IN
VARCHAR 2
FND_API.G_FALS E
p_commit
IN
VARCHAR 2 NUMBER
p_validation_lev el x_return_status
IN
OUT
VARCHAR 2
Parameter
Typ e OUT
Data-type
Require d
Default Value
Description
x_msg_count
NUMBER
Number of messages in the API message list This is the message in encoded format if x_msg_count=1
x_msg_data
OUT
VARCHAR 2
The following table lists the parameters that pertain specifically to the cash receipt routine.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Parameter p_usr_currency_cod e
Type IN
Data-type VARCHAR2
Required
Description The translated currency code. Used to derive the p_currency_code if it is not entered. Default: None Validation: Should be a valid currency, so that the corresponding currency code can be derived. Error: AR_RAPI_USR_CURR_CODE_INVALID
Parameter p_currency_code
Type IN
Data-type VARCHAR2
Required
Description The actual currency code that gets stored in AR tables. Default: 1. Derived from p_usr_currency_code if entered, else Defaults to the functional currency code
2.
Validation: Validated against the currencies in fnd_currencies table. Error: AR_RAPI_CURR_CODE_INVALID Warning: AR_RAPI_FUNC_CURR_DEFAULTED p_usr_exchange_rate _type IN VARCHAR2
The translated exchange rate type. Used to derive the p_exchange_rate_type if it has not been entered. Default: None Validation: Should be a valid rate type. Error: AR_RAPI_USR_X_RATE_TYP_INVALID
p_exchange_rate_ty pe
IN
VARCHAR2
Exchange rate type stored in AR tables. Default: 1. In case of foreign currency receipt, derived from p_usr_exchange_rate_type. In case of foreign currency receipt, defaults from profile option 'AR: Default Exchange Rate Type'
2.
Parameter p_exchange_rate
Type IN
Data-type NUMBER
Required
Description The exchange rate between the receipt currency and the functional currency. Default: 1. Derived from the Daily Rates table for rate_type <>'User' in case of non-functional currency If profile option Journals: Display Inverse Rate = 'Y', set user entered value to 1/ p_exchange_rate The entered value is rounded to a precision of 38.
2.
3.
Validation: 1. In case of non-functional currency the rate should have a positive value for rate type= 'User' For non-functional currency and type is <> 'User', do not specify any value.
2.
The date on which the exchange rate is valid. Default: Receipt date Validation: For a non-functional currency and type is <>'User' there should be a valid rate existing in the database for this date. This is a cross validation of type, currency, and date. Error: AR_NO_RATE_DATA_FOUND
p_amount
IN
NUMBER
Yes
The cash receipt amount. Default: Null Validation: >0 Error: AR_RAPI_REC_AMT_NEGATIVE AR_RAPI_RCPT_AMOUNT_NULL
Type IN
Data-type NUMBER
Required
Description The bank charges on the cash receipt. Default: None Validation: 1. Bank charges not allowed if profile option AR: Create Bank Charges = 'No'. Bank charges not allowed if the receipt state, derived from the receipt class of the receipt method <> 'CLEARED'. If allowed then >=0
2.
3.
The receipt number of the receipt to be created. Default: If not specified, the receipt number is defaulted from the document sequence value. Validation: Receipt number should not be null. Error: AR_RAPI_RCPT_NUM_NULL
p_receipt_date
IN
DATE
The receipt date of the entered cash receipt. Default: System date Validation: None Error: None
Parameter p_gl_date
Type IN
Data-type DATE
Required
Description Date that this receipt will be posted to the General Ledger. Default: Gets defaulted to the receipt date if it is a valid gl_date. Validation: The date is valid if the following conditions are true:
The date is in an Open or Future period The period cannot be an Adjustment period
If the most recent open period is prior to the receipt date: last date of that period If there is a period open after the receipt date: first date of the last open period
Receipt maturity date. Default: Deposit date Validation: >= p_receipt_date Error: AR_RW_MAT_BEFORE_RCT_DATE
p_postmark_date
IN
DATE
Parameter p_customer_id
Type IN
Data-type NUMBER(15)
Required
Description The customer_id for the paying customer. Default: Defaulted from customer name/number Validation: 1. Customer exists and has prospect code = 'CUSTOMER' Customer has a profile defined at the customer level
2.
The name for the entered customer. Used to default the customer id if not specified. Default: None Validation: None Error: AR_RAPI_CUS_NAME_INVALID
p_customer_number
IN
The customer number. Used to default the customer_id if not specified Default: None Validation: None Error: AR_RAPI_CUS_NUM_INVALID
Type IN
Data-type NUMBER(15)
Required
Description The customer bank account id. Default: From bank account id/number Validation: 1. It must be a valid Bank Account of the paying customer The inactive date (if defined) of the Bank Account, should be greater than the receipt_date The receipt date has to be within the Start date and the End date of the Bank Account
2.
3.
The customer bank account number. Used to default the customer bank account id, if not specified Default: None Validation: None Error: None
p_customer_bank_ac count_name
IN
VARCHAR2(8 0)
The customer bank account name. Used to default the customer bank account id, if not specified Default: None Validation: None Error: None
p_location
IN
VARCHAR2(4 0)
The Bill_To location for the customer. Used to derive the p_customer_site_use_id Default: None Validation: None Error: AR_RAPI_CUS_LOC_INVALID
Type IN
Data-type NUMBER(15)
Required
Description The Bill_To site_use_id for the customer Default: 1. 2. Defaulted from customer location, else Primary Bill_To customer site_use_id of the customer.
Validation: It should be a valid Bill_To site of the paying customer. Error: AR_RAPI_CUS_SITE_USE_ID_INVALID p_customer_receipt_ reference IN VARCHAR2(3 0)
This column is used to store a customer receipt reference value supplied by the customer at the confirmation time. Default: None Validation: None Error: None
p_override_remit_ba nk_account_flag
IN
VARCHAR2(1 )
The flag value decides when the remittance bank account can be overridden by the remittance selection process. Default: 'Y' Validation: valid values 'Y' and 'N' Error: AR_RAPI_INVALID_OR_REMIT_BK_AC
Type IN
Data-type NUMBER(15)
Required
Description Identifies the user's bank account for depositing the receipt. Default: 1. 2. From remittance bank account number From the receipt method based on logic mentioned in Defaulting, page 8-18.
Validation: Validation logic detailed in Validation, page 8-17. Error: AR_RAPI_REM_BK_AC_ID_INVALID AR_RAPI_REM_BK_AC_ID_NULL p_remittance_bank_ account_num IN VARCHAR2(3 0)
The remittance bank account number. Used to default the remittance bank account id if not specified. Default: None Validation: None Error: AR_RAPI_REM_BK_AC_NUM_INVALID
p_remittance_bank_ account_name
IN
VARCHAR2(5 0)
The remittance bank account name. Used to default the remittance bank account id if not specified Default: None Validation: None Error: AR_RAPI_REM_BK_AC_NAME_INVALID
p_deposit_date
IN
DATE
The deposit date. Default: receipt date Validation: None Error: None
Parameter p_receipt_method_i d
Type IN
Data-type NUMBER(15)
Required
Description Identifies the receipt method of the receipt Default: From receipt method name Validation: Validation detailed in Validation, page 8-17 Error: AR_RAPI_INVALID_RCT_MD_ID
p_receipt_method_n ame
IN
VARCHAR2(3 0)
The receipt method name of the receipt. Used to default the receipt method id if not specified. Default: None Validation: None Error: AR_RAPI_RCPT_MD_NAME_INVALID
p_doc_sequence_val ue
IN
NUMBER
Value assigned to document receipt. Default: Detailed in Defaulting, page 8-18 Validation:
User should not pass in the value if the current document sequence is automatic. Document sequence value should not be entered if profile option Sequential Numbering is set to Not Used
Code defined by public sector accounting. Default: None Validation: None Error: None
p_anticipated_cleari ng_date
IN
DATE
Date the receipt is expected to be cleared. Default: None Validation: >= gl_date Error: AR_RW_EFFECTIVE_BEFORE_GL_DATE
Parameter p_event
Type IN
Data-type VARCHAR2
Required
Description The event that resulted in the creation of the receipt. Currently used only by Bills Receivable. Default: None Validation: None Error: None
p_called_from
IN
VARCHAR2(2 0)
This parameter is used to identify the calling routine. Currently used to identify only the 'BR_REMIT' program. Default: None Validation: None Error: None
p_attribute_record
IN
This is a record type which contains all the 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Information flexfield. Default: DFF APIs used to do the defaulting and validation Validation: DFF APIs used to do the defaulting and validation Error: AR_RAPI_DESC_FLEX_INVALID
p_global_attribute_r ecord
IN
global_attribut e_rec_type
This is a record type which contains all the 20 global descriptive flexfield segments and one global descriptive flexfield structure defining column. Default: None Validation: None Error:
p_comments
IN
VARCHAR2 (240)
User's comments
Parameter p_issuer_name
Type IN
Data-type VARCHAR2(5 0)
Required
Description Issuer name of Notes Receivable (Asia Pacific Requirement) Default: None Validation: None Error:
p_issue_date
IN
DATE
Date Notes receivable was issued (Asia Pacific Requirement) Default: None Validation: None Error: None
p_issuer_bank_branc h_id
IN
NUMBER(15)
Bank/ Branch issuing the Notes Receivable (Asia Pacific Requirement) Default: None Validation: None Error: None
p_cr_id
OUT
NUMBER(15)
Yes
The cash receipt id of the receipt created by the API call. Indicates if you want to default the site use from p_customer_site_use_id. The default value is Y. Pass N to default nothing. If the Require Billing Location for Receipts system option is selected, then no value is required here.
p_default_site_use
IN
VARCHAR2
No
Validation
This section explains the validation mechanisms for the various parameters of this API which are relatively more complex and could not be explained in the Description column of the preceding table. Validating Receipt Method ID The receipt method ID is validated per the following conditions:
It must be a valid receipt method ID in the AR_RECEIPT_METHOD table. Receipt date must lie between the receipt method start date and end date (if not null). The creation method code for the receipt class of this particular receipt method ID should be 'AUTOMATIC,' the remit flag ='Y,' and the confirm flag = 'N' or 'MANUAL.' At least one remittance bank account associated with this receipt method ID must have either the multi-currency flag set to 'Y' or the same currency as the receipt currency. In addition, this should have a bank account type = 'INTERNAL' and its inactive date (if specified) greater than the receipt_date.
Validating Remittance Bank Account ID A remittance bank account ID, which is associated with a particular receipt method, is validated after validating the receipt method ID. If the receipt method ID is invalid, then the validation for the remittance bank account ID is not completed. An error message raised for an invalid value is AR_RAPI_INVALID_REMIT_BK_AC_ID. The remittance bank account ID must: Be a valid remittance bank account ID for the current receipt method. Have the multi-currency flag set to 'Y' or the same currency as the receipt currency. In addition, this should have a bank account type = 'INTERNAL' and its inactive date (if specified) greater than the receipt_date.
Validating for Duplicate Receipt If the combination of the receipt_date, receipt_number, and amount on this receipt matches any existing receipts which have not been reversed, then the error message AR_RW_CASH_DUPLICATE_RECEIPT is raised.
Defaulting
This section explains the defaulting mechanisms for the various parameters of this API which are relatively more complex and could not be explained in the Description column of the preceding table. Defaulting the Remittance Bank Account ID In addition to being defaulted from the remittance bank account name and/or remittance bank account number, the remittance bank account identifier is defaulted from the receipt method that is specified for the cash receipt. If only one remittance bank account is associated with the specified receipt method that has the multi-currency flag = 'Y' or has same currency as the receipt currency, and the receipt date is within its start date and end date range, then that remittance bank account is used as the default
value.
Example
Objective: To create an identified cash receipt using a call to Ar_receipt_api_pub.Create_cash and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_init_msg_list p_receipt_number p_amount p_receipt_method_id p_customer_name Entered Value 1.0 FND_API.G_TRUE 'aj_test_api_1' 1000 1001 'Computer Service and Rentals' Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_customer_id p_currency_code p_receipt_date p_gl_date p_deposit_date p_customer_site_use_id Entered Value Default Value 1006 USD 10-FEB-2000 10-FEB-2000 10-FEB-2000 1025
Entered Value
10001
10-FEB-2000
The warnings and the error messages that the API puts on the message stack are retrieved after execution of this API by the calling program in the following manner:
IF l_msg_count = 1 Then --there is one message raised by the API, so it has been sent out --in the parameter x_msg_data, get it. l_msg_data_out := l_msg_data; ELSIF l_msg_count > 1 Then --the messages on the stack are more than one so call them in a loop -- and put the messages in a PL/SQL table. loop count := count +1 ; l_mesg := FND_MSG_PUB.Get; If l_mesg IS NULL Then EXIT; else Mesg_tbl(count).message := l_mesg; End if; end loop; END IF;
Depending on the message level threshold set by the profile option FND_API_MSG_LEVEL_THRESHOLD, the messages put on the message stack may contain both the error messages and the warnings. Result: We were able to create an identified cash receipt by specifying only six input parameters in our call to this API. Similarly, without initializing the message stack (p_init_msg_list not passed and
defaulted), you can create an unidentified cash receipt (without a customer) by passing only four input parameters to this API call.
Ar_receipt_api_pub.Apply
Call this routine to apply the cash receipts of a customer (identified cash receipt) to a debit item. This debit item could be of the same customer or related customer, or an unrelated customer, depending on the value of the Allow Payment of Unrelated Transactions system option. This API routine has 3 output and 34 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 28 + 1 (descriptive flexfield record parameters) + 1 (global descriptive flexfield record parameters)
Output
Standard API parameters: 3 Application parameters: 0
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the parameters that pertain specifically to the Apply routine.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Parameter p_cr_id
Type IN
Data-type NUMBER(15)
Required
Description The cash_receipt_id of the receipt which needs to be applied to a given debit item. Default: None Validation: 1. 2. 3. Type must be 'CASH' Status must not be Reversed or Approved The receipt must not be Unidentified
The receipt number of the receipt to be applied. Used to default the cash_receipt_id. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID
p_customer_trx_id
IN
NUMBER(15)
The customer_trx_id of the debit item to which the receipt is to be applied Default: None Validation: Detailed in Validation, page 8-31 Error: Detailed in Validation, page 8-31
p_trx_number
IN
VARCHAR2(20)
The trx_number of the debit item to which the receipt is to be applied. Used to default the customer_trx_id Default: None Validation: None Error: AR_RAPI_TRX_NUM_INVALID
Parameter p_installment
Type IN
Data-type NUMBER(15)
Required
Description The installment (or term_sequence_number) of the debit item. Used in conjunction with customer_trx_id to derive the applied payment schedule id if not specified. Default: 1, if only one installment exists for the debit item Validation: 1. 2. >0; valid installment of transaction.
Also see Validation, page 8-31 Error: AR_RAPI_INSTALL_NULL p_applied_payment _schedule_id IN NUMBER(15)
The payment schedule id of the debit item. Also used to derive the customer_trx_id if not specified Default: Defaulted based on the installment and the customer_trx_id Validation: 1. 2. >0 It must correspond to Customer trx id and installment specified. It must have the status <> 'CL' if the show closed invoices flag <> 'Y'
3.
Error: AR_RAPI_APP_PS_ID_INVALID
Parameter p_amount_applied
Type IN
Data-type NUMBER
Required
Description The transaction amount to which the receipt is to be applied, in the transaction currency. Default: The default amount applied can be either the open amount of the transaction or the unapplied amount of the receipt, but you can change it. Use the AR: Always Default Transaction Balance for Applications profile option, Oracle Receivables Implementation Guide to control how Receivables defaults the applied amount. The profile option's defaulting rules are:
If you set the profile option to Yes, then the default amount applied is the remaining transaction amount. If you set the profile option to No, or if a null value exists, then the defaulting rule is: 1. If the unapplied receipt amount is greater than or equal to the transaction, then the default amount applied is the remaining transaction amount. If the unapplied receipt amount is less than the remaining transaction amount, then the default amount applied is the unapplied receipt amount. If the unapplied receipt amount is negative, then the default amount applied is the remaining transaction amount.
2.
3.
Discounts, if applicable, are taken into account by the discounts routine which calculates the amount applied. Validation: Detailed in Validation, page 8-31 Error: Detailed in Validation, page 8-31
Type IN
Data-type NUMBER
Required
Description The allocated receipt amount in receipt currency. Use only for cross currency receipt applications. Do not use when transaction and receipt currencies are the same. Default:
For a same currency application, defaults to null For the cross currency application, defaults to trans_to_receipt_rate * amount_applied
Validation: Detailed in Validation, page 8-31 Error: Detailed in Validation, page 8-31 p_trans_to_receipt_r ate IN NUMBER
For cross currency receipts, the exchange rate used to convert an amount from a foreign currency to functional currency Default: Detailed in Defaulting, page 8-30 Validation: Detailed in Validation, page 8-31 Error: Detailed in Validation, page 8-31
p_discount
IN
NUMBER
Discount on the debit item, entered in the invoice currency Default: Detailed in Defaulting, page 8-30 Validation: Detailed in Validation, page 8-31 Error: Detailed in Validation, page 8-31
Parameter p_apply_date
Type IN
Data-type DATE
Required
Description Date the application was applied. Default: 1. 2. Receipt date, if receipt date >= system date System date, if receipt date < system date
Validation: apply date >= transaction date apply date >= receipt date Error: AR_APPLY_BEFORE_TRANSACTION AR_APPLY_BEFORE_RECEIPT p_gl_date IN DATE
Date that this application will be posted to the General Ledger Default: Detailed in Defaulting, page 8-30 Validation: 1. Validated as per standard gl date validation described for the gl date in Create_cash routine >= transaction gl date >= receipt gl date
2. 3.
Code defined by public sector accounting. Default: None Validation: None Error: None
Type IN
Data-type NUMBER(15)
Required
Description The customer trx line id of the debit item to which the payment is applied. Default: From the line number if specified Validation: This should be a valid line id for the specified customer trx id. Error: AR_RAPI_TRX_LINE_ID_INVALID
p_line_number
IN
NUMBER
The line number of the debit item to which the payment is applied. Default: None Validation: None Error: AR_RAPI_TRX_LINE_NO_INVALID
p_show_closed_invo ices
IN
VARCHAR2(1)
This flag decides whether to do the receipt application against closed invoices. The valid values are 'Y' and 'N' Default: 'N' Validation: Any other value is treated as 'N'. Error: None
p_event
IN
VARCHAR2(50)
The event that resulted in the creation of the receipt. Currently used only by Bills Receivables. Default: None Validation: None Error: None
p_move_deferred_ta x
IN
VARCHAR2(1)
Depending on maturity date, this flag indicates when deferred tax should be moved on the accounting event. Default: None Validation: None Error: None
Parameter p_attribute_record
Type IN
Data-type attribute_rec_typ e
Required
Description This is a record type which contains all the 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Application Information flexfield. Default: DFF APIs used to do the defaulting and validation Validation: DFF APIs used to do the defaulting and validation Error: AR_RAPI_DESC_FLEX_INVALID
p_global_attribute_r ecord
IN
global_attribute_ rec_type
This is a record type which contains all the 20 global descriptive flexfield segments and One global descriptive flexfield structure defining column. Default: None Validation: None Error: None
p_comments
IN
User's comments
p_payment_set_id
IN
Payment set ID is populated only for a prepayment receipt that needs to be applied to a given debit item. Default: None Validation: None
p_application_ref_ty pe
IN
VARCHAR2(30)
Application reference type this determines the context of the application reference fields. Default: None Validation: Must be Null or, if a Trade Management deduction is being created, then must be 'CLAIM' (Trade Management must be installed). Error: AR_RAPI_INVALID_APP_REF
Type IN IN
Required
Description Must be NULL. The reference number relating to the application reference type. If application reference type is 'CLAIM', then this would be a deduction number. Default: None Validation: If populated, then must be an existing deduction number in Trade Management. Error: AR_RAPI_INVALID_CLAIM_NUM
p_secondary_applica tion_ref_id
IN
NUMBER(15)
The secondary application reference ID related to the application reference type. Default: None Validation: If populated, and if the application reference type is 'CLAIM', then this must contain a valid claim ID in Trade Management. Error: AR_RW_INVALID_CLAIM_ID
p_application_ref_re ason
IN
VARCHAR2(30)
The reason code related to the application reference type. Default: None Validation: If populated, and if the application reference type is 'CLAIM', then this must contain a valid reason code ID in Trade Management. Error: AR_RAPI_INVALID_REF_REASON
p_customer_referenc e
IN
VARCHAR2(100)
Parameter p_customer_reason
Type IN
Data-type VARCHAR2(30)
Required
Description Reason code supplied by customer, in the context of an application reference type of 'CLAIM'. Default: None Validation: None in Oracle Receivables (the attempt to match to an Oracle reason code is made in Trade Management).
Defaulting
This section explains the defaulting mechanisms for the various parameters of this API, which are relatively more complex in nature and could not be explained in the Description column of the preceding table. Trans to receipt rate For a cross currency application, the transaction to receipt rate is defaulted by the following rules: Check if a fixed rate exists (using the GL APIs) between the transaction currency and the receipt currency. If yes, then get it and use it as the default. If there is no fixed rate relationship between the transaction currency and the receipt currency, and the profile option AR: Cross Currency Exchange Rate Type has a value, then try to derive a rate from the database using the profile option value and the cash receipt date as the exchange rate date. If you get a rate from the database, then use it as default. If the amount_applied and the amount_applied_from are specified, then derive the transaction to receipt rate using the following equation: trans_to_receipt_rate=amount_applied_from/amount_applied.
GL Date The application GL date is defaulted to the greater of the Receipt GL date or, depending on the value of the profile option AR: Application GL Date Default, the system date or transaction GL date. Discount Defaults to the maximum discount available on the transaction, as of the date of application, which is internally calculated by the discounts routine.
Validation
This section explains the validation mechanisms for the various parameters of this API which are relatively more complex in nature and could not be explained in the Description column of the preceding table. Customer Trx ID The customer_trx_id is validated using the conditions mentioned below: If the Show Closed Invoices flag is set to 'Y,' then the current transaction + installment can have a payment schedule status of Closed ('CL'). Otherwise, the payment schedule status must be Open ('OP'). If the Allow Payment of Unrelated Transactions system option = 'Y,' then the current transaction can be for a customer who is not related to the customer on the receipt. Otherwise, the transaction must be for the same or related customer on the receipt. The transaction must be an Invoice, Credit Memo, Debit Memo, Deposit, or Chargeback.
Note: This transaction can be in a currency that is different from the
receipt currency.
Depending on the specified input parameters, one of the following error messages is raised for an invalid transaction: AR_RAPI_TRX_ID_INST_INVALID AR_RAPI_TRX_NUM_INST_INVALID AR_RAPI_CUST_TRX_ID_INVALID AR_RAPI_TRX_NUM_INVALID AR_RAPI_APP_PS_ID_INVALID
For details of these messages, refer to Messages, page 8-136. Amount Applied The amount applied cannot be null. The error message raised for an invalid value is AR_RAPI_APPLIED_AMT_NULL. The amount applied must not be greater than the line amount for the given customer_trx_line ID (if specified). The error message raised for an invalid value is AR_RW_APPLIED_GREATER_LINE.
Depending on the creation sign, natural application flag, allow overapplication flag, and the amount due remaining of the specified transaction installment, the amount applied is validated to check for overapplication and natural application. The error messages raised for invalid values are AR_CKAP_OVERAPP, AR_CKAP_NATURALAPP, and AR_CKAP_CT_SIGN. For details of the messages, refer to Messages, page 8-136. For a cross currency application, the following equation should always be valid: amount applied * trans to receipt rate = amount applied from The error message raised is AR_RAPI_INVALID_CC_AMTS.
Amount Applied From During a cross-currency receipt application, the amount applied from cannot be null. The error message raised for an invalid value is AR_RAPI_AMT_APP_FROM_NULL. The amount applied from cannot be greater than the unapplied amount available on the receipt. The error message raised for invalid values is AR_RW_APP_NEG_UNAPP. If the transaction currency and the receipt currency are the same, then the amount applied from must always be null. The error message raised for an invalid value is AR_RAPI_AMT_APP_FROM_INVALID. As mentioned previously for a cross currency application, the following equation must always be valid: amount applied * trans to receipt rate = amount applied from Trans to Receipt Rate For a cross currency application, the trans to receipt rate should have a positive value. The error message raised for an invalid value is AR_RW_CC_RATE_POSITIVE. If the transaction currency and the receipt currency are the same, then the rate should not have any value specified. The error message raised for an invalid value is AR_RAPI_INVALID_CC_RATE. For a cross currency application, the following equation should always be valid: amount applied * trans to receipt rate = amount applied from If this condition is violated, then the error raised is AR_RAPI_CC_RATE_AMTS_INVALID.
Discount If the amount due original on the transaction (debit item) is negative, then discount = 0 or null. The error message raised for an invalid value is AR_RW_NO_DISCNT. If amount applied > 0, then the discount cannot be negative. The error message raised for an invalid value is AR_RW_VAL_NEG_DISCNT. If partial discount flag = 'N' and the transaction has not been completely paid off by the receipt application, then the discount = 0 or null. The error message raised for an invalid value is AR_NO_PARTIAL_DISC. The discount must not be greater than the maximum discount allowed on the transaction, which is internally calculated in the API by the discounts routine. The error message raised for an invalid value is AR_RW_VAL_DISCOUNT.
If the Allow Unearned Discounts system option = 'N,' then the discount must be less than or equal to the allowed earned discount, which gets internally calculated in the API by the discounts routine for the given transaction. The error message raised for an invalid value is AR_RW_VAL_UNEARNED_DISCOUNT. Application Ref Num If p_application_ref_type is 'CLAIM', then the application reference number can be populated with a valid deduction number from Trade Management. This deduction/overpayment must be in the same currency as the debit item being applied to. Otherwise, the error message raised is AR_RAPI_INVALID_CLAIM_NUM. Secondary Application Ref ID If p_application_ref_type is 'CLAIM', then the secondary application reference ID can be populated with a valid claim ID from Trade Management. This deduction/overpayment must be in the same currency as the debit item being applied to. Otherwise, the error message raised is AR_RAPI_INVALID_CLAIM_NUM. If both the application reference number and the secondary application reference ID are left null, and p_application_ref_type is 'CLAIM', then a new claim will be created in Trade Management.
Example
Objective: To apply a cash receipt in functional currency to an invoice in functional currency having only one installment using a call to the API Ar_receipt_api_pub.Apply and passing a minimum number of input parameters. This table lists the entered parameters:
Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_customer_trx_id p_installment p_cr_id p_gl_date p_applied_payment_schedule _id p_apply_date p_amount_applied p_amount_applied_from p_discount p_show_closed_invoices Entered Value Default Value 187807 1 23927 10-FEB-2000 36271
10-FEB-2000 98 98 2 'N'
Result: We were able to apply the cash receipt against the specified transaction by specifying only three input parameters in our call to this API. The retrieval and handling of the warnings and the error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.Create_and_apply
Call this routine to create a cash receipt and apply it to a specified installment of a debit item. This debit item could be for the same customer or related customer, or for an unrelated customer, depending on the Allow Payment of Unrelated Transactions system option. This is essentially a superset of the ar_receipt_api_pub.Create_cash and Ar_receipt_api_pub.Apply APIs, and contains the same parameters as contained in those two APIs. During the call to this API, if the creation of the receipt is successfully completed but its application to the debit item fails, then the receipt creation is also rolled back. This routine calls Oracle Payments, where required. See Integration with Oracle Payments, page 8-2.
Note: To create credit card receipts that need to be processed by Oracle
Payments APIs, you must pass the p_call_payment_processor parameter as fnd_api.g_true. Additionally, you must specify the p_customer_bank_account_id parameter.
This API routine has 3 output and 57 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 45 + 2 (descriptive flexfield record parameter) + 2 (global descriptive flexfield record parameter)
Output
Standard API parameters: 3 Application parameters: 0
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the parameters that are relevant to the receipt creation and application for the API.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create
Parameter p_usr_currency_cod e
Type IN
Data-type VARCHAR2
Required
Description The translated currency code. Used to derive the p_currency_code if it is not entered. Default: None Validation: Should be a valid currency, so that we can derive the corresponding currency code. Error: AR_RAPI_USR_CURR_CODE_INVALID
p_currency_code
IN
VARCHAR2(15)
The actual currency code that gets stored in AR tables. Default: 1. Derived from p_usr_currency_code if entered. Otherwise, Defaulted to the functional currency code.
2.
Validation: Validated against the currencies in fnd_currencies table. Error: AR_RAPI_CURR_CODE_INVALID Warning: AR_RAPI_FUNC_CURR_DEFAULTED p_usr_exchange_rate _type IN VARCHAR2
The translated exchange rate type. Used to derive the p_exchange_rate_type if it has not been entered. Default: None Validation: Should be a valid rate type. Error: AR_RAPI_USR_X_RATE_TYP_INVALID
Parameter p_exchange_rate_ty pe
Type IN
Data-type VARCHAR2(30)
Required
Description Exchange rate type stored in AR tables. Default: 1. In case of foreign currency receipt, derived from p_usr_exchange_rate_type If p_usr_exchange_rate_type is null, then defaulted from AR: Default Exchange Rate Type profile option Should be left null, if the receipt is in the same denomination as functional currency
2.
3.
Parameter p_exchange_rate
Type IN
Data-type NUMBER
Required
Description The exchange rate between the receipt currency and the functional currency. Default: 1. Derived from the Daily Rates table for rate_type <>'User' in case of non-functional currency If profile option Journals: Display Inverse Rate = 'Y', set user entered value to 1/ p_exchange_rate The entered value is rounded to a precision of 38.
2.
3.
Validation: 1. In case of non-functional currency the rate should have a positive value for rate type= 'User' For non-functional currency and type <> 'User' the user should not specify any value.
2.
The date on which the exchange rate is valid. Default: Receipt date Validation: For a non-functional currency and type <> 'User' there should be a valid rate existing in the database for this date. This is a cross validation of type, currency and date Error: AR_NO_RATE_DATA_FOUND
Parameter p_amount
Type IN
Data-type NUMBER
Required Yes
Description The cash receipt amount. Default: Null Validation: >0 Error: AR_RAPI_REC_AMT_NEGATIVE AR_RAPI_RCPT_AMOUNT_NULL
p_factor_discount_a mount
IN
NUMBER
The bank charges on the cash receipt. Default: None Validation: 1. Bank charges are not allowed if profile option AR: Create Bank Charges = 'No'. Bank charges not allowed if the receipt state, derived from the receipt class of the receipt method, <> 'CLEARED'. If allowed, then >= 0.
2.
3.
The receipt number of the receipt to be created. Default: If not specified, the receipt number is defaulted from the document sequence value. Validation: Receipt number should not be null Error: AR_RAPI_RCPT_NUM_NULL
p_receipt_date
IN
DATE
The receipt date of the entered cash receipt. Default: System date Validation: None Error: None
Parameter p_gl_date
Type IN
Data-type DATE
Required
Description Date that this receipt will be posted to the General Ledger. Default: Gets defaulted to the receipt date if it is a valid gl_date. Validation: The date is valid if the following conditions are true:
The date is in an Open or Future period The period cannot be an Adjustment period
If the most recent open period is prior to the receipt date: last date of that period If there is a period open after the receipt date: first date of the last open period
Receipt maturity date. Default: Deposit date Validation: >= p_receipt_date Error: AR_RW_MAT_BEFORE_RCT_DATE
p_customer_id
IN
NUMBER(15)
The customer_id for the paying customer. Default: Refer to Defaulting, page 8-52 Validation: 1. Customer exists and has prospect code = 'CUSTOMER' Customer has a profile defined a customer level
2.
Error: AR_RAPI_CUST_ID_INVALID
Parameter p_customer_name
Type IN
Data-type VARCHAR2(50)
Required
Description The name for the entered customer. Used to default the customer id if not specified. Default: None Validation: None Error: AR_RAPI_CUS_NAME_INVALID
p_customer_number
IN
VARCHAR2(30)
The customer number. Used to default the customer_id if not specified. Default: None Validation: None Error: AR_RAPI_CUS_NUM_INVALID
p_customer_bank_ac count_id
IN
NUMBER(15)
The customer bank account ID. Default: From bank account ID/number. Validation: 1. It must be a valid bank account of the paying customer. The inactive date (if defined) of the bank account should be greater than the receipt_date. The receipt date must be within the Start date and the End date of the bank account uses.
2.
3.
The customer bank account number. Used to default the customer bank account id, if not specified. Default: None Validation: None Error: None
Type IN
Data-type VARCHAR2(80)
Required
Description The customer bank account name. Used to default the customer bank account id, if not specified. Default: None Validation: None Error: None
p_customer_location
IN
VARCHAR2(40)
The Bill_To location for the customer. Used to derive the p_customer_site_use_id. Default: None Validation: None Error: AR_RAPI_CUS_LOC_INVALID
p_customer_site_use _id
IN
NUMBER(15)
The Bill_To site_use_id for the customer. Default: 1. Defaulted from customer location. Otherwise, Primary Bill_To customer site_use_id of the customer.
2.
Validation: It should be a valid Bill_To site of the paying customer. Error: AR_RAPI_CUS_SITE_USE_ID_INVALID p_customer_receipt_ reference IN VARCHAR2(30)
This column is used to store a customer receipt reference value that the customer supplies at the confirmation time. Default: None Validation: None Error: None
Type IN
Data-type VARCHAR2(1)
Required
Description The flag value decides when the remittance bank account can be overridden by the remittance selection process. Default: 'Y' Validation: valid values 'Y' and 'N' Error: AR_RAPI_INVALID_OR_REMIT_BK_AC
p_remittance_bank_ account_id
IN
NUMBER(15)
Identifies the user's bank account for depositing the receipt. Default: 1. 2. From remittance bank account number From the receipt method based on logic mentioned in Defaulting, page 8-18
Validation: Validation logic detailed in Validation, page 8-17 Error: AR_RAPI_REM_BK_AC_ID_INVALID AR_RAPI_REM_BK_AC_ID_NULL p_remittance_bank_ account_num IN VARCHAR2(30)
The remittance bank account number. Used to default the remittance bank account id if not specified. Default: None Validation: None Error: AR_RAPI_REM_BK_AC_NUM_INVALID
p_remittance_bank_ account_name
IN
VARCHAR2(50)
The remittance bank account name. Used to default the remittance bank account id if not specified. Default: None Validation: None Error: AR_RAPI_REM_BK_AC_NAME_INVALID
Parameter p_deposit_date
Type IN
Data-type DATE
Required
Description The deposit date. Default: receipt date Validation: None Error: None
p_receipt_method_i d
IN
NUMBER(15)
Identifies the receipt method of the receipt. Default: From receipt method name Validation: Validation detailed in Validation, page 8-17 Error: AR_RAPI_INVALID_RCT_MD_ID
p_receipt_method_n ame
IN
VARCHAR2(30)
The receipt method name of the receipt. Used to default the receipt method id if not specified. Default: None Validation: None Error: None
Parameter p_doc_sequence_val ue
Type IN
Data-type NUMBER
Required
Description Value assigned to document receipt. Default: Detailed in Defaulting, page 8-18. Validation:
You should not pass a value, if the current document sequence is automatic. Document sequence value should not be entered if profile option Sequential Numbering is set to Not Used.
Code defined by public sector accounting. Default: None Validation: None Error: None
p_anticipated_cleari ng_date
IN
DATE
Date the receipt is expected to be cleared. Default: None Validation: >= gl_date Error: AR_RW_EFFECTIVE_BEFORE_GL_DATE
p_event
IN
VARCHAR2
The event that resulted in the creation of the receipt. Currently used only by Bills Receivables. Default: None Validation: None Error: None
Parameter p_called_from
Type IN
Data-type VARCHAR2(20)
Required
Description This parameter is used to identify the calling routine. Currently used to identify only the 'BR_REMIT' program. Default: None Validation: None Error: None
p_attribute_record
IN
attribute_rec_type
This is a record type which contains all the 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Information flexfield. Default: DFF APIs used to do the defaulting and validation Validation: DFF APIs used to do the defaulting and validation Error: AR_RAPI_DESC_FLEX_INVALID
p_global_attribute_r ecord
IN
global_attribute_r ec_type
This is a record type which contains all the 20 global descriptive flexfield segments and one global descriptive flexfield structure defining column. Default: None Validation: None Error:
p_issuer_name
IN
VARCHAR2(50)
Issuer name of Notes Receivable (Asia Pacific Requirement). Default: None Validation: None Error: None
Parameter p_issue_date
Type IN
Data-type DATE
Required
Description Date when the note receivable was issued (Asia Pacific Requirement). Default: None Validation: None Error: None
p_customer_trx_id
IN
NUMBER(15)
The customer_trx_id of the debit item to which the receipt is to be applied. Default: None Validation: Detailed in Validation, page 8-31 Error: Detailed in Validation, page 8-31
p_trx_number
IN
VARCHAR2(20)
The trx_number of the debit item to which the receipt is to be applied. Used to default the customer_trx_id. Default: None Validation: None Error: AR_RAPI_TRX_NUM_INVALID
p_installment
IN
NUMBER(15)
The installment (or term_sequence_number) of the debit item. Used in conjunction with customer_trx_id to derive the applied payment schedule id if not specified. Default: 1, if only one installment exists for the debit item Validation: 1. 2. >0 valid installment of transaction.
Type IN
Data-type NUMBER(15)
Required
Description The payment schedule id of the debit item. Also used to derive the customer_trx_id if not specified. Default: Defaulted based on the installment and the customer_trx_id Validation: 1. 2. >0 It must correspond to Customer trx id and installment specified. It must have the status <> 'CL' if the show closed invoices flag <> 'Y'
3.
The transaction amount to which the receipt is to be applied. This in the transaction currency. Default: The default amount applied can be either the open amount of the transaction or the unapplied amount of the receipt, but you can change it. Use the AR: Always Default Transaction Balance for Applications profile option, Oracle Receivables Implementation Guide to control how Receivables defaults the applied amount. For the profile option's defaulting rules, see Ar_receipt_api_pub.Apply, page 8-21. Discounts, if applicable, are taken into account by the discounts routine which calculates the amount applied. Validation: Detailed in Validation, page 8-31 . Error: Detailed in Validation, page 8-31.
Type IN
Data-type NUMBER
Required
Description The allocated receipt amount in receipt currency. Use only for cross currency receipt applications. Do not use when transaction and receipt currencies are the same. Default:
For a same currency application, defaults to null. For the cross currency application, defaults to trans_to_receipt_rate * amount_applied.
Validation: Detailed in Validation, page 8-31 . Error: Detailed in Validation, page 8-31. p_trans_to_receipt_r ate IN NUMBER
For cross currency receipts, the exchange rate used to convert an amount from a foreign currency to functional currency. Default: Detailed in Defaulting, page 8-30 Validation: Detailed in Validation, page 8-31 Error: Detailed in Validation, page 8-31
p_discount
IN
NUMBER
Discount on the debit item, entered in the invoice currency. Default: Detailed in Defaulting, page 8-30 Validation: Detailed in Validation, page 8-31 Error: Detailed in Validation, page 8-31
Parameter p_apply_date
Type IN
Data-type DATE
Required
Description Date the application was applied. Default: 1. Receipt date, if receipt date >= system date System date, if receipt date < system date
2.
Validation: apply date >= transaction date apply date >= receipt date Error: AR_APPLY_BEFORE_TRANSACTION AR_APPLY_BEFORE_RECEIPT p_apply_gl_date IN DATE
Date that this application will be posted to the General Ledger. Default: Detailed in Defaulting, page 8-30 Validation: 1. Validated as per standard gl date validation described for the gl date in Create_cash routine Greater than or equal to transaction gl date Greater than or equal to receipt gl date
2.
3.
Code defined by public sector accounting. Default: None Validation: None Error:
Type IN
Data-type NUMBER(15)
Required
Description The customer trx line id of the debit item to which the payment is applied. Default: From the line number if specified Validation: This should be a valid line id for the specified customer trx id. Error: AR_RAPI_TRX_LINE_ID_INVALID
p_line_number
IN
NUMBER
The line number of the debit item to which the payment is applied. Default: None Validation: None Error: AR_RAPI_TRX_LINE_NO_INVALID
p_show_closed_invo ices
IN
VARCHAR2(1)
This flag decides whether to do the receipt application against closed invoices. The valid values are 'Y' and 'N'. Default: 'N' Validation: Check for the valid values. Error: AR_RAPI_INVALID_SHOW_CL_INV
p_event
IN
VARCHAR2(50)
The event that resulted in the creation of the receipt. Currently used only by Bills Receivables. Default: None Validation: None Error: None
p_move_deferred_ta x
IN
VARCHAR2(1)
Depending on maturity date, this flag indicates when deferred tax should be moved on the accounting event. Default: None Validation: None Error: None
Type IN
Data-type attribute_rec_type
Required
Description This is a record type which contains all the 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Application Information flexfield. Default: DFF APIs used to do the defaulting and validation Validation: DFF APIs used to do the defaulting and validation Error: AR_RAPI_DESC_FLEX_INVALID
p_app_global_attrib ute_record
IN
global_attribute_r ec_type
This is a record type which contains all the 20 global descriptive flexfield segments and one global descriptive flexfield structure defining column. Default: None Validation: None Error:
IN IN
FND_API.G_ FALSE
User's comments for the application. This is the payment processing indicator flag. Pass as FND_API.G_TRUE, if you want to call Oracle Payments for credit card processing. Indicates if you want to default the site use from p_customer_site_use_id. The default value is Y. Pass N to default nothing. If the Require Billing Location for Receipts system option is selected, then no value is required here.
p_default_site_use
IN
VARCHAR2
No
Defaulting
This section explains the defaulting mechanisms for the various parameters of this API which are relatively more complex in nature and could not be explained in the Description column of the preceding table.
Customer ID The p_customer_id is required for the create_and_apply routine because an unidentified receipt cannot be applied to a transaction. If not specified, then the customer ID gets defaulted from one of the following: Customer number, customer name, or both Bill_to customer on the transaction or drawee customer on the bill (for receipt application against a bill)
If the customer ID is not defaulted by one of the above, then the AR_RAPI_CUST_ID_NULL error is raised.
Example
Objective: To create a cash receipt in the functional currency against an invoice in USD having only one installment, using a call to the API Ar_receipt_api_pub.Create_and_Apply and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_receipt_number p_amount p_receipt_method_id p_customer_name Entered Value 1.0 'aj_test_api_3' 1000 1001 'Computer Service and Rentals' 'aj_test_trx_3' Default Value
p_trx_number
This table lists the defaulted input parameters, which were not entered:
Parameter p_customer_id Entered Value Default Value 1006
Parameter p_currency_code p_receipt_date p_gl_date p_deposit_date p_customer_site_use_id p_override_remit_bank_acco unt_flag p_remittance_bank_account_i d p_maturity_date p_customer_trx_id p_installment p_apply_gl_date p_applied_payment_schedule _id p_apply_date p_amount_applied p_amount_applied_from p_discount p_show_closed_invoices
Entered Value
10001
Result: We were able to create the cash receipt 'aj_test_api_3' and then apply it against the invoice 'aj_test_trx_3' by specifying only six input parameters in our call to this API. Both the receipt and the invoice are in the functional currency. The retrieval and
handling of the warnings and the error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.Unapply
Call this routine to unapply a cash receipt application against a specified installment of a debit item or payment_schedule_id. This API routine has 3 output and 14 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 10
Output
Standard API parameters: 3 Application parameters: 0
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the parameters that are specific to the unapplication for the API.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Parameter p_cr_id
Type IN
Data-type NUMBER(15)
Required
Description The cash_receipt_id of the receipt whose application has to be unapplied. Default: None Validation: 1. 2. Status must not be Reversed or Approved The receipt should have an application on it.
The receipt number of the receipt whose application is to be unapplied. Used to default the cash_receipt_id. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID AR_RAPI_TRX_NUM_INST_INVALID
p_customer_trx_id
IN
NUMBER(15)
The customer_trx_id of the debit item against which the specified receipt has an application. Default: None Validation: The transaction must have an application against the specified receipt. Error: AR_RAPI_CUST_TRX_ID_INVALID AR_RAPI_TRX_ID_INST_INVALID
p_trx_number
IN
VARCHAR2(20)
The trx_number of the debit item against which the specified receipt has an application. Used to default the customer_trx_id. Default: None Validation: None Error: None
Parameter p_installment
Type IN
Data-type NUMBER(15)
Required
Description The installment (or term_sequence_number) of the debit item. Used in conjunction with customer_trx_id to derive the applied payment schedule id if not specified. Default: 1, if only one installment exists for the debit item Validation: 1. 2. >0 valid installment of transaction
The payment schedule id of the debit item. Also used to derive the customer_trx_id, if not specified. Default: Derived from the installment and the customer_trx_id. Validation: 1. 2. >0 It must correspond to Customer trx id and installment, if specified. For applications with Bills Receivables installed, you cannot unapply a bill that is in the process of remittance.
3.
Error: AR_RAPI_APP_PS_ID_INVALID
Type IN
Data-type NUMBER(15)
Required
Description Identifies the receivable application. Used to derive the customer_trx_id, cash_receipt_id, and the applied_payment_schedule_id, if not specified. Default: Defaulted from the specified transaction and the receipt. Validation: 1. 2. 3. Application type must be 'CASH'. Display flag = 'Y' (latest application). The applied payment schedule id of the receivable application record must correspond to the p_applied_payment_schedules_id, if specified. The cash receipt id must correspond to the cash receipt id specified. For applications with Bills Receivables installed, you cannot unapply the application of a bill that is in the process of remittance.
4.
5.
Parameter p_reversal_gl_date
Type IN
Data-type DATE
Required
Description The reversal gl date. Default: Gets defaulted to the application gl date if it is a valid gl_date. Validation: It is valid if the following conditions are true:
The date is in an Open or Future period. The period cannot be an Adjustment period. The reversal GL date >= application GL date. The reversal GL date >= receipt GL date.
If the most recent open period is prior to the receipt date: last date of that period If there is a period open after the receipt date: first date of the last open period
This parameter is used to identify the calling routine. Default: None Validation: None Error: None
p_cancel_claim_flag
IN
VARCHAR2(1)
Defaulting
This section explains the defaulting mechanisms for the various parameters of this API which are relatively more complex and could not be explained in the Description column of the preceding table.
Receivable Application ID If not specified, then the receivable application ID can be defaulted by one of the following: Using the specified installment and p_customer_trx_id (derived from p_trx_number if not specified) and p_cr_id (derived from the receipt number if not specified). Using the specified value of p_applied_payment_schedule_id and p_cr_id (derived from the receipt number if not specified).
Validation
This section explains the cross validations for the various parameters of this API which are relatively more complex and could not be explained in the Description column of the preceding table. Cross validation between customer_trx_id, applied_payment_schedule_id, cash_receipt_id, and receivable_application_id If p_customer_trx_id, p_installment, and p_applied_payment_schedule_id are specified and the two do not point to the same transaction, then the error AR_RAPI_TRX_PS_ID_X_INVALID is raised. If the combination of the specified p_applied_payment_schedule_id (or derived from the p_customer_trx_id and p_installment) and the specified p_receivable_application_id is invalid, then the error AR_RAPI_APP_PS_RA_ID_X_INVALID or AR_RAPI_TRX_RA_ID_X_INVALID is raised, depending on the input parameters.
Example
Objective: To unapply the receipt application against an invoice using the call to API Ar_receipt_api_pub.Unapply and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_receipt_number Entered Value 1.0 'aj_test_api_4' Default Value
Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id p_customer_trx_id p_reversal_gl_date p_receivable_application_id Entered Value Default Value 1006 USD 10-FEB-2000 29711
The retrieval and handling of the warnings and the error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.Apply_on_account
Call this routine to apply an on-account application of the specified cash receipt. This API routine has 3 output and 21 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 14 + 1 (descriptive flexfield record type) + 1 (global descriptive flexfield record type)
Output
Standard API parameters: 3 Application parameters: 0
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the descriptions of the on-account application-related
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Parameter p_cr_id
Type IN
Data-type NUMBER(15)
Required
Description The cash_receipt_id of the receipt which is to be applied on account. Default: None Validation: 1. 2. Type must be 'CASH' Status must not be Reversed or Approved
The receipt must not be Unidentified Error: AR_RAPI_CASH_RCPT_ID_INVALID AR_RAPI_CASH_RCPT_ID_NULL p_receipt_number IN VARCHAR2(30)
The receipt number of the receipt to be applied on account. Used to default the cash_receipt_id. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID
Parameter p_amount_applied
Type IN
Data-type NUMBER
Required
Description The amount on the cash receipt that is to be applied on account. Default: Amount due remaining on the receipt. Validation: 1. 2. Greater than or equal to 0. Less than or equal to the amount due remaining on the receipt.
Date the application was applied. Default: 1. Receipt date, if receipt date >= system date System date, if receipt date < system date
2.
Parameter p_apply_gl_date
Type IN
Data-type DATE
Required
Description Date that this application will be posted to the General Ledger. Default: Defaulted to greater of the receipt date and the system date. Validation: 1. Validated as per standard gl date validation described for the gl date in Create_cash routine. >= receipt gl date.
2.
Code defined by public sector accounting. Default: None Validation: None Error: None
p_attribute_rec
IN
attribute_rec_typ e
This is a record type which contains all the 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Application Information flexfield. Default: DFF APIs used to do the defaulting and validation Validation: DFF APIs used to do the defaulting and validation Error: AR_RAPI_DESC_FLEX_INVALID
Parameter p_global_attribute_r ec
Type IN
Required
Description This is a record type which contains all the global descriptive flexfields: One global descriptive flexfield structure defining column and 20 segments. Default: None Validation: None Error: None
IN IN
VARCHAR2(240) VARCHAR2(30)
User comments. Deduction number, if resulting from Trade Management claim settlement. Claim ID, if resulting from Trade Management claim settlement. Reference supplied by customer.
IN
NUMBER(15)
IN
VARCHAR2(100)
IN
VARCHAR2(20)
This parameter is used to identify the calling routine. Default: None Validation: None Error: None
IN IN
VARCHAR2(30) VARCHAR2(30)
Reason code supplied by customer. Used for automated receipt handling. Leave null. Used for automated receipt handling. Leave null.
IN
VARCHAR2(30)
Example
Objective: To apply a cash receipt in the functional currency to an invoice in the functional currency having only one installment, using a call to the API Ar_receipt_api_pub.Apply_on_account and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_receipt_number Entered Value 1.0 'aj_test_cr_2' Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id p_gl_date p_apply_date p_amount_applied Entered Value Default Value 23927 01-JUN-2000 01-JUN-2000 100
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.Unapply_on_account
Call this routine to unapply an on-account application on the specified cash receipt. This API routine has 3 output and 8 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 4
Output
Standard API parameters: 3 Application parameters: 0
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the parameters that are relevant to the on-account unapplication for the API.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Parameter p_cr_id
Type IN
Data-type NUMBER(15)
Required
Description The cash_receipt_id of the receipt whose application has to be unapplied. Default: None Validation: 1. Status must not be Reversed or Approved. The receipt must have an on-account application on it.
2.
The receipt number of the receipt which is to be unapplied. Used to default the cash_receipt_id. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID
Type IN
Data-type NUMBER(15)
Required
Description Identifies the receivable application. Used to derive the customer trx id, cash_receipt_id and the applied_ps_id, if not specified. Default: Refer to Validation, page 8-74. Validation: 1. 2. Application type = 'CASH'. Display flag = 'Y' (latest application) and status = 'ACC'. The applied payment schedule id of the receivable application record must correspond to the p_applied_payment_schedules_id, if specified. The cash receipt id must correspond to the cash receipt id specified.
3.
4.
Error: AR_RAPI_REC_APP_ID_INVALID
Parameter p_reversal_gl_date
Type IN
Data-type DATE
Required
Description The reversal gl date. Default: Gets defaulted to the application gl date if it is a valid gl_date. Validation: It is valid if the following conditions are true:
The date is in an Open or Future period. The period cannot be an Adjustment period. The reversal GL date >= application GL date. The reversal GL date >= receipt GL date.
If the most recent open period is prior to the receipt date: last date of that period If there is a period open after the receipt date first date of the last open period
Defaulting
This section explains the defaulting mechanisms for the various parameters of this API which could not be explained in the Description column of the preceding table. Receivable Application ID The value for p_receivable_application_id, if not specified, is defaulted from the p_cr_id (or p_receipt_number). If the receipt does not have an on-account application, then the error AR_RAPI_CASH_RCPT_ID_INVALID is raised. If there is more than one on-account application on the receipt and the value for p_receivable_application_id has not been specified, then the error AR_RAPI_MULTIPLE_ON_AC_APP is raised.
Example
Objective: To unapply the receipt application using the call to API Ar_receipt_api_pub.Unapply_on_account and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_receipt_number Entered Value 1.0 'aj_test_api_6' Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id p_reversal_gl_date Entered Value Default Value 20338 01-JUN-2000
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.Reverse
Call this routine to reverse cash as well as miscellaneous receipts. This API routine has 3 output and 14 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 11 + 1 (descriptive flexfield record type) 1 (global descriptive flexfield record type)
Output
Standard API parameters: 3 Application parameters: 0
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the descriptions of the reversal-related parameters of the API.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Parameter p_cr_id
Type IN
Data-type NUMBER(15)
Required
Description The cash_receipt_id of the receipt which needs to be reversed. Default: None Validation: Detailed in Defaulting, page 869. Error:
p_receipt_number
IN
VARCHAR2(30 )
The receipt number of the receipt to be reversed. Used to default the cash_receipt_id. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID
p_reversal_category _code
IN
VARCHAR2(20 )
Identifies the reason why the payment entry was reversed. Default: None Validation: Validated against the values in ar_lookups for lookup_type = 'REVERSAL_CATEGORY_TYPE Error: AR_RAPI_REV_CAT_CD_NULL AR_RAPI_REV_CAT_CD_INVALID
Type IN
Data-type VARCHAR2(80 )
Required
Description This is the translated lookup meaning for the reversal category code. Used to default the reversal category code if not specified. Default: None Validation: None Error: AR_RAPI_REV_CAT_NAME_INVALID
p_reversal_gl_date
IN
DATE
The General Ledger Date that is used to credit the Account CCID for the reversed receipt. Default: System date Validation: 1. Validated as per standard gl date validation described for the gl date in Create_cash routine Greater than or equal to receipt gl date
2.
System date if system date >= receipt date, else Receipt date if receipt date > system date
Type IN
Data-type VARCHAR2(30 )
Required
Description Indicates the reason for reversing receipt Default: None Validation: Validated against the values in ar_lookups for lookup_type = 'CKAJST_REASON' Error: AR_RAPI_REV_REAS_CD_INVALID AR_RAPI_REV_REAS_CD_NULL
p_reversal_reason_n ame
IN
VARCHAR2(80 )
This is the translated lookup meaning for reversal reason code. Used for defaulting the reversal reason code if not specified. Default: None Validation: None Error: AR_RAPI_REV_REAS_NAME_INVALID
p_reversal_comment s p_atttribute_rec
IN
IN
This is a record type which contains all the descriptive flexfields: One descriptive flexfield structure defining column and 15 segments. Default: None Validation: None Error: None
p_global_attribute_r ec
IN
global_attribut e_rec_type
This is a record type which contains all the global descriptive flexfields: One global descriptive flexfield structure defining column and 20 segments. Default: None Validation: None Error: None
p_cancel_claims_flag
IN
VARCHAR2(1)
Parameter p_called_from
Type IN
Data-type VARCHAR2(20 )
Required
Description This parameter is used to identify the calling routine. Default: None Validation: None Error: None
Validation
This section explains the validation mechanisms for the various parameters of this API which are relatively more complex in nature and could not be explained in the Description column of the preceding table. Cash Receipt ID We have to validate whether this is a valid cash receipt ID, and whether we can reverse this receipt. The validation steps are: This is a valid value in the database. For an invalid value, the error message AR_RAPI_CASH_RCPT_ID_INVALID is raised. Status should not be 'Reversed' for this receipt because you cannot reverse an already reversed receipt. The error message raised for an invalid value is AR_RAPI_CASH_RCPT_ID_INVALID.
The receipt is not standard reversible if any two of the following conditions are true: If a chargeback was created against an invoice that is applied to the payment to be reversed. If there are any payments, adjustments, credit memos, or chargebacks against the above chargeback records in the AR_PAYMENT_SCHEDULES table. If the above chargeback has already been posted to the general ledger.
The AR_RAPI_NON_REVERSIBLE error message is raised for invalid values. In these cases, you can create a debit memo reversal to reverse the receipt. Since the Receipt API does not currently support debit memo reversals, you can manually create them using the Receipts workbench.
Example
Objective:
To reverse a cash receipt using a call to the API Ar_receipt_api_pub.Reverse and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_receipt_number p_reversal_category_code p_reversal_reason_code Entered Value 1.0 'aj_test_cr_7' 'NSF' 'PAYMENT REVERSAL' Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id p_reversal_date p_reversal_gl_date Entered Value Default Value 20340 01-JUN-2000 01-JUN-2000
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.activity_application
Call this routine to do an activity application on a cash receipt. Such applications include Short Term Debit (STD) and Receipt Write-off applications. This API routine has 4 output and 25 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 22 + 1 (descriptive flexfield record type) 1 (global descriptive flexfield record type)
Output
Standard API parameters: 3 Application parameters: 1
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the descriptions of the activity application-related parameters of the API.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Parameter p_cr_id
Type IN
Data-type NUMBER(15)
Required*
Description The cash_receipt_id of the receipt which is to be used for the activity application. Default: None Validation: 1. 2. Type must be 'CASH' Status must not be Reversed or Approved The receipt must not be Unidentified
3.
The receipt number of the receipt to be applied. Used to default the cash_receipt_id. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID
Parameter p_amount_applied
Type IN
Data-type NUMBER
Required*
Description The amount on the cash receipt that is to be applied against the specified activity. Default: Amount due remaining on the receipt. Validation: 1. 2. Greater than or equal to 0. Less than or equal to the amount due remaining on the receipt. If a receipt write-off, then must fall within user and system limits (limits must be set).
3.
Error: AR_RAPI_APPLIED_AMT_NULL AR_RW_APP_NEG_UNAPP AR_RW_AMOUNT_LESS_THAN_APP AR_WR_NO_LIMIT AR_WR_USER_LIMIT AR_SYSTEM_WR_NO_LIMIT_SET AR_WR_TOTAL_EXCEED_MAX_AMOU NT p_applied_payment _schedule_id IN NUMBER(15) Yes The payment schedule identifier here corresponds to special seeded values, such as -2. Default: Validation: The value should correspond to the special seeded values, such as: -2 (Short Term Debt). Error: AR_RAPI_APP_PS_ID_INVALID
Type IN
Data-type NUMBER(15)
Required*
Description The customer_trx_id of the Bill for which the activity (e.g. Short Term Debt) application is being done. Default: Validation: The customer_trx_id should correspond to that of a Bill which has a current status of FACTORED or MATURED_PEND_RISK_ELIMINATION. Error: AR_RAPI_LK_CUS_TRX_ID_INVALID
p_receivables_trx_id
IN
NUMBER(15)
Identifier of the receivables activity. Default: None Validation: 1. 2. Valid database value. The activity_type for the receivables_trx_id should be in sync with the applied payment schedule identifier passed in.
Date the application was applied. Default: 1. Receipt date, if receipt date >= system date. System date, if receipt date < system date.
2.
Parameter p_apply_gl_date
Type IN
Data-type DATE
Required*
Description Date that this application will be posted to the General Ledger. Default: Defaulted to greater of the receipt date and the system date. Validation: 1. Validated as per standard GL date validation described for the GL date in Create_cash routine. >= receipt GL date
2.
Code defined by public sector accounting. Default: None Validation: None Error: None
p_attribute_rec
IN
attribute_rec_typ e
This is a record type which contains all 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Application Information flexfield. Default: DFF APIs used to do the defaulting and validation Validation: DFF APIs used to do the defaulting and validation Error: AR_RAPI_DESC_FLEX_INVALID
p_global_attribute_r ec
IN
global_attribute_ rec_type
This is a record type which contains all the global descriptive flexfields: one global descriptive flexfield structure defining column and 20 segments. Default: None Validation: None Error: None
Parameter p_comments
Type IN
Required*
Description User's comments for the activity application. Not used. Leave null.
IN
IN IN
NUMBER(15) VARCHAR2(30)
Not used. Leave null. If resulting from a settlement of a claim, then this will contain the deduction number. If resulting from a settlement of a claim, then this will contain the claim ID. Payment set ID is populated only when doing a prepayment activity application on a prepayment receipt. Default: None Validation: None
IN
NUMBER(15)
IN
NUMBER(15)
OUT
NUMBER(15)
IN
IN
Flag to indicate whether user-level write-off limits should apply. Default: Y Validation: None Error: None
p_called_from
IN
VARCHAR2(20)
This parameter is used to identify the calling routine. Default: None Validation: None Error: None
Type IN
Data-type VARCHAR2(1)
Required*
IN
NUMBER(15)
IN
VARCHAR2(30)
Used for automated receipt handling. Leave null. Used for automated receipt handling. Leave null.
IN
VARCHAR2(30)
Example
Objective: To apply a cash receipt in then functional currency to a receipt write-off activity in the functional currency, using a call to the API Ar_receipt_api_pub.activity_application and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_receipt_number p_receivables_trx_id p_applied_payment_schedule _id Entered Value 1.0 'aj_test_cr_2' 1300 -3 Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id Entered Value Default Value 23927
Entered Value
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.activity_unapplication
Call this routine to do a reversal of an activity application on a cash receipt. Such applications include Short Term Debt and Receipt write-off. This API routine has 3 output and 9 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 5
Output
Standard API parameters: 3 Application parameters: 0
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the descriptions of the activity unapplication-related parameters of the API.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Parameter p_cr_id
Type IN
Data-type NUMBER(15)
Required
Description The cash_receipt_id of the receipt on which the activity application needs to be reversed. Default: None Validation: 1. 2. Type must be 'CASH' Status must not be Reversed or Approved The receipt must not be Unidentified
3.
The receipt number of the receipt to be reversed. Used to default the cash_receipt_id. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID
Type IN
Data-type NUMBER(15)
Required
Description Identifies the receivable application. Used to derive the customer trx id, cash_receipt_id and the applied_ps_id if not specified. Default: Refer to Validation, page 8-74. Validation: 1. 2. Application type = 'CASH'. Display flag = 'Y' (latest application) and status = 'ACTIVITY'. The applied payment schedule id of the receivable application record must correspond to the p_applied_payment_schedule_id, if specified. Must correspond to the cash receipt id specified.
3.
4.
Error: AR_RAPI_REC_APP_ID_INVALID
Parameter p_reversal_gl_date
Type IN
Data-type DATE
Required
Description The reversal GL date. Default: Gets defaulted to the application GL date if it is a valid gl_date. Validation: It is valid if the following conditions are true:
The date is in an Open or Future period The period cannot be an Adjustment period Reversal GL date >= application GL date Reversal GL date >= receipt GL date
If the most recent open period is prior to the receipt date: last date of that period If there is a period open after the receipt date: first date of the last open period
Error: AR_INVALID_APP_GL_DATE AR_RW_BEFORE_APP_GL_DATE AR_RW_BEFORE_RECEIPT_GL_DATE p_called_from IN VARCHAR2(20) Yes Indicates which program is calling this API. For example, the BR_REMIT program would be calling this routine for short term debt applications. Default: None Validation: None Error: None
Example
Objective: To unapply an activity application, using a call to the API Ar_receipt_api_pub.activity_unapplication and passing minimum number of input parameters.
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id p_reversal_gl_date Entered Value Default Value 20338 01-JUN-2000
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.Create_misc
Call this routine to create a miscellaneous receipt.
Note: This routine does not call Oracle Payments directly. See
This API routine has 4 output and 36 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 32
Output
Standard API parameters: 3 Application parameters: 1
Parameter Descriptions
The following table lists the standard API parameters, which are common to all the routines in the Receipt API:
Parameter p_api_version Type IN Data-type NUMBER Required Yes Default Value Description Used to compare version numbers of incoming calls to its current version number. Unexpected error is raised if version incompatibility exists. In the current version of the API, you should pass in a value of 1.0 for this parameter. p_init_msg_list IN VARCHAR2
FND_API.G_FAL SE
Allows API callers to request that the API does initialization of the message list on their behalf. Used by API callers to ask the API to commit on their behalf. Not to be used currently as this is a public API.
p_commit
IN
VARCHAR2
p_validation_lev el
IN
NUMBER
x_return_status
OUT
VARCHAR2
Represents the API overall return status. Detailed in Return Status, page 1-4. Number of messages in the API message list. This is the message in encoded format if x_msg_count=1.
x_msg_count
OUT
NUMBER
x_msg_data
OUT
VARCHAR2
The following table lists the parameters that are relevant to the miscellaneous receipt:
Parameter p_usr_currency_cod e
Type IN
Data-type VARCHAR2
Required
Description The translated currency code. Used to derive the p_currency_code if it is not entered. Default: None Validation: Should be a valid currency, so that the corresponding currency code can be derived. Error: AR_RAPI_USR_CURR_CODE_INVALID
p_currency_code
IN
VARCHAR2
The actual currency code that gets stored in AR tables. Default: 1. Derived from p_usr_currency_code if entered. Otherwise, Defaults to the functional currency code
2.
Validation: Validated against the currencies in fnd_currencies table. Error: AR_RAPI_CURR_CODE_INVALID Warning: AR_RAPI_FUNC_CURR_DEFAULTED p_usr_exchange_rate _type IN VARCHAR2
The translated exchange rate type. Used to derive the p_exchange_rate_type if it has not been entered. Default: None Validation: Should be a valid rate type. Error: AR_RAPI_USR_X_RATE_TYP_INVALID
Parameter p_exchange_rate_ty pe
Type IN
Data-type VARCHAR2
Required
Description Exchange rate type stored in AR tables. Default: 1. In case of foreign currency receipt, derived from p_usr_exchange_rate_type. In case of foreign currency receipt, defaults from profile option AR: Default Exchange Rate Type
2.
Validation: Validated against values in gl_daily_conversion_types table. Error: AR_RAPI_X_RATE_TYPE_INVALID p_exchange_rate IN NUMBER
The exchange rate between the receipt currency and the functional currency. Default: 1. Derived from the Daily Rates table for rate_type <> 'User' in case of non-functional currency If profile option Journals: Display Inverse Rate = 'Y', set user-entered value to 1/p_exchange_rate The entered value is rounded to a precision of 38
2.
3.
Validation: 1. In case of non-functional currency, the rate should have a positive value for rate type = 'User' For non-functional currency and type is <> 'User', do not specify any value
2.
Parameter p_exchange_rate_dat e
Type IN
Data-type DATE
Required
Description The date on which the exchange rate is valid. Default: Receipt date Validation: For a non-functional currency and type is <> 'User', there should be a valid rate existing in the database for this date. This is a cross validation of type, currency, and date. Error: AR_NO_RATE_DATA_FOUND
p_amount
IN
NUMBER
Yes
The cash receipt amount. Default: Null Validation: > 0 Error: AR_RAPI_REC_AMT_NEGATIVE AR_RAPI_RCPT_AMOUNT_NULL
p_receipt_number
IN
VARCHAR2(30 )
The receipt number of the receipt to be created. Default: If not specified, the receipt number is defaulted from the document sequence value. Validation: Receipt number should not be null Error: AR_RAPI_RCPT_NUM_NULL
p_receipt_date
IN
DATE
The receipt date of the entered cash receipt. Default: System date Validation: None Error: None
Parameter p_gl_date
Type IN
Data-type DATE
Required
Description Date when this receipt will be posted to the general ledger. Default: Gets defaulted to the receipt date if it is a valid gl_date, otherwise:
If the most recent open period is prior to the receipt date: last date of that period If there is a period open after the receipt date: first date of the last open period
The date is in an Open or Future period The period cannot be an Adjustment period
Error: AR_INVALID_APP_GL_DATE
Parameter p_receivables_trx_id
Type IN
Data-type NUMBER(15)
Required
Description Identifies the receivables activity. Default: If not specified, it is derived from p_activity. Validation: Validates it against the values in the ar_receivables_trx table
Type column having values: 'MISCCASH', 'BANK_ERROR', 'CCREFUND'. Checks the receipt_date to be within start_date_active and end_date_active column values. Status is Active or null. Not null.
Name of the receivables activity. This is used to derive the p_receivables_trx_id. Default: None Validation: None Error: None
p_misc_payment_so urce
IN
VARCHAR2(30 )
Identifies the source of the miscellaneous receipt. Default: None Validation: None Error: None
Parameter p_tax_code
Type IN
Data-type VARCHAR2(50 )
Required
Description Depending on the sign of the amount entered, it is the asset tax code (for positive sign or zero) or the liability tax code (negative sign). This is used to derive the p_vat_tax_id. Default: None Validation: None Error: None
Parameter p_vat_tax_id
Type IN
Data-type NUMBER(15)
Required
Description The VAT tax identifier for the current miscellaneous receipt. Default:
Validation: 1. For 'Accrual' accounting method, the vat_tax_id is validated against the values in ar_vat_tax having
receipt_date between start_date_active and end_date_active column values enabled_flag = 'Y' tax_type should not be 'TAX_GROUP', 'LOCATION', 'SALES_TAX' displayed_flag = 'Y' The tax_class is 'O' (output) for positive or zero amount and 'I' (input) for negative amount ledger should match the current ledger
2.
For 'Cash basis' accounting method, the vat_tax_id should not be specified.
Parameter p_tax_rate
Type IN
Data-type NUMBER
Required
Description The new tax rate specified when you override the rate for an ad-hoc tax code. Default: 1. Defaulted from the tax rate on the tax code (p_tax_code/p_vat_tax_id). Defaulted from the p_tax_amount when the tax amount is specified for the ad-hoc tax code case.
2.
Validation: For 'Accrual' accounting method, tax rate can be specified only in case of an ad-hoc tax code (p_tax_code/p_vat_tax_id) and the profile option 'Tax: Allow Ad Hoc Tax Changes' set to Yes. For 'Cash basis' accounting method, the tax_rate should never be specified. Error: AR_RAPI_TAX_RATE_INVALID AR_RAPI_TAX_RATE_AMT_X_INVALI D p_tax_amount IN NUMBER
The tax amount specified in case where you override the rate for an ad-hoc tax code. It is used to derive the tax_rate. Default: None Validation: This needs to be specified only in case of an ad-hoc tax code (p_tax_code/p_vat_tax_id) and the profile option 'Tax: Allow Ad Hoc Tax Changes' set to Yes. For 'Cash basis' accounting method, the tax_amount should never be specified Error: AR_RAPI_TAX_RATE_AMT_X_INVALI D
Parameter p_deposit_date
Type IN
Data-type DATE
Required
Description The deposit date. Default: Receipt date Validation: None Error: None
p_reference_type
IN
VARCHAR2(30 )
Indicates whether this miscellaneous receipt is a 'PAYMENT', 'RECEIPT', 'PAYMENT_BATCH' or 'REMITTANCE'. Default: None Validation:
Check it for the specified valid values. Should not have a null value if either p_reference_id or p_reference_num is specified.
A foreign key to AR_BATCHES, AR_CASH_RECEIPTS, AP_INVOICE_SELECTION_CRITERIA or AP_CHECKS, depending on the specified value of p_reference_type. Default: None Validation: Detailed in Validation, page 817. Error: AR_RAPI_REF_NUM_INVALID AR_RAPI_REF_ID_INVALID
p_reference_num
IN
VARCHAR2(30 )
The reference number. It is used for deriving the p_reference_id. Default: None Validation: None Error: None
Type IN
Data-type NUMBER(15)
Required
Description Identifies the user's bank account for depositing the receipt. Default: 1. From remittance bank account number From the receipt method based on logic mentioned in Defaulting, page 8-18.
2.
Validation: In addition to the validation logic detailed in Validation, page 8-17, those receipt methods which have notes_receivable = 'Y' or bill_of_exchange_flag = 'Y' on the receipt class are excluded for miscellaneous receipts. Error: AR_RAPI_REM_BK_AC_ID_INVALID AR_RAPI_REM_BK_AC_ID_NULL p_remittance_bank_ account_num IN VARCHAR2(30 )
The remittance bank account number. Used to default the remittance bank account id if not specified. Default: None Validation: None Error: AR_RAPI_REM_BK_AC_NUM_INVALI D
p_remittance_bank_ account_name
IN
VARCHAR2(50 )
The remittance bank account name. Used to default the remittance bank account id if not specified. Default: None Validation: None Error: AR_RAPI_REM_BK_AC_NAME_INVALI D
Type IN
Data-type VARCHAR2(30 )
Required
Description Code defined by public sector accounting. Default: None Validation: None Error: None
p_receipt_method_i d
IN
NUMBER(15)
Identifies the receipt method of the receipt. Default: From receipt method name Validation: In addition to the validation logic detailed in Validation, page 8-17, those receipt methods which have notes_receivable = 'Y' or bill_of_exchange_flag = 'Y' on the receipt class are excluded for the miscellaneous receipts. Error: AR_RAPI_INVALID_RCT_MD_ID
p_receipt_method_n ame
IN
VARCHAR2(30 )
The receipt method name of the receipt. Used to default the receipt method id if not specified Default: None Validation: None Error: AR_RAPI_RCPT_MD_NAME_INVALID
Parameter p_doc_sequence_val ue
Type IN
Data-type NUMBER
Required
Description Value assigned to document receipt. Default: Detailed in Defaulting, page 8-18. Validation:
User should not pass in the value if the current document sequence is automatic Document sequence value should not be entered if profile option Sequential Numbering is set to Not Used
Date the receipt is expected to be cleared. Default: None Validation: greater than or equal to gl_date Error: AR_RW_EFFECTIVE_BEFORE_GL_DAT E
p_attribute_rec
IN
attribute_rec_ty pe
This is a record type which contains all 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Information flexfield. Default: DFF APIs used to do the defaulting and validation Validation: DFF APIs used to do the defaulting and validation Error: AR_RAPI_DESC_FLEX_INVALID
Parameter p_global_attribute_r ec
Type IN
Required
Description This is a record type which contains all 20 global descriptive flexfield segments and one global descriptive flexfield structure defining column. Default: None Validation: None Error:
p_comments
IN
VARCHAR2(24 0) NUMBER(15)
User's comments.
p_misc_receipt_id
OUT
Yes
The cash_receipt_id of the receipt created by the API call. This parameter is used to identify the calling routine. Default: None Validation: None Error: None
p_called_from
IN
VARCHAR2 (20)
Ar_receipt_api_pub.apply_other_account
Call this routine to do an "other" account application on a cash receipt. Typically this would be to create a claim investigation application with a noninvoice-related deduction or overpayment in Trade Management (if installed). This API routine has 4 output and 26 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 18 + 1 (descriptive flexfield record type) 1 (global descriptive flexfield record type)
Output
Standard API parameters: 3 Application parameters: 1
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the descriptions of the other account application-related parameters of the API:
Parameter p_cr_id Type IN Data-type NUMBER (15) Required Description The cash_receipt_id of the receipt which is to be applied to the "other" account. Default: None Validation: 1. 2. 3. Type must be 'CASH'. Status must not be Reversed or Approved. The receipt must not be Unidentified.
The receipt number of the receipt to be applied to the "other" account. Used to default the cash_receipt_id. Default: None Validation: None Error : AR_RAPI_RCPT_NUM_INVALID
p_amount_applied
IN
NUMBER
The amount on the cash receipt that is to be applied to the "other" account. Default: Amount due remaining on the receipt. Validation: Less than or equal to the amount due remaining on the receipt. Error: AR_RAPI_APPLIED_AMT_NULL AR_RW_AMOUNT_LESS_THAN_APP
Type IN
Required Yes
Description This payment schedule identifier corresponds to special seeded values, such as 4 (for Claim Investigation). Default: Validation: The value should correspond to the special seeded values, such as -4 (Claim Investigation). Error: AR_RAPI_APP_PS_ID_INVALID
p_receivables_trx_id
IN
NUMBER (15)
Identifier of receivables activity. Default: None Validation: 1. 2. Valid database value. The activity_type for the receivables_trx_id should be in sync with the provided applied payment schedule identifier.
Date the application was applied. Default: 1. 2. Receipt date, if receipt date >= system date. System date, if receipt date < system date.
Parameter p_apply_gl_date
Type IN
Data-type DATE
Required
Description Date when this application will be posted to the General Ledger. Default: Defaulted to greater of the receipt date and the system date. Validation: 1. Validated as per standard gl date validation described for the gl date in the Create_cash routine. >= receipt gl date
2.
Code defined by public sector accounting. Default: None Validation: None Error: None
p_attribute_rec
IN
attribute_rec _type
This is a record type which contains all the 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Application Information flexfield. Default: DFF APIs used to do the defaulting and validation. Validation: DFF APIs used to do the defaulting and validation. Error : AR_RAPI_DESC_FLEX_INVALID
Parameter p_global_attribute_r ec
Type IN
Required
Description This is a record type which contains all the global descriptive flexfields: one global descriptive flexfield structure defining column and 20 segments. Default: None Validation: None Error: None
p_comments
IN
User's comments for the other account application. Defines the context of the application reference columns. For Trade Management, the value should be 'CLAIM'. Default: None Validation: Must be 'CLAIM' if a Trade Management deduction is being created (Trade Management must be installed). Error: AR_RAPI_INVALID_APP_REF
p_application_ref_ty pe
IN
Yes
p_application_ref_id
IN
p_application_ref_n um
IN
The reference number relating to the application reference type. If application reference type is 'CLAIM', then this would be a deduction number. Default: None Validation: If populated, then must be an existing deduction number in Trade Management. Error: AR_RAPI_INVALID_CLAIM_NUM
Type IN
Required
Description The secondary application reference ID related to the application reference type. Default: None Validation: If populated, and if application reference type is 'CLAIM', then this must contain a valid claim ID in Trade Management. Error: AR_RW_INVALID_CLAIM_ID
p_payment_set_id
IN
NUMBER (15)
Payment set ID is populated only for a prepayment receipt which is to be applied to the "other" account. Default: None Validation: None
OUT
The ID of the resulting activity receivable application. The reason code related to the application reference type. Default: None Validation: If populated, and if application reference type is 'CLAIM', then this must contain a valid reason code ID from Trade Management. Error: AR_RAPI_INVALID_REF_REASON
IN
p_customer_referenc e p_customer_reason
IN
IN
Reason code supplied by customer, in the context of an application reference type of 'CLAIM'. Default: None Validation: None in Oracle Receivables (the attempt to match to an Oracle reason code is made in Trade Management).
Parameter p_called_from
Type IN
Required
Description This parameter is used to identify the calling routine. Default: None Validation: None Error: None
Example
Objective: To apply a cash receipt in functional currency to Claim Investigation, and to create a non-invoice overpayment in the functional currency using a call to the API Ar_receipt_api_pub.apply_other_account and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_receipt_number p_receivables_trx_id p_application_ref_type p_applied_payment_schedule _id Entered Value 1.0 'aj_test_cr_2' 1400 'CLAIM' -4 Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id p_gl_date Entered Value Default Value 23927 01-JUN-2000
Entered Value
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.unapply_other_account
Call this routine to do a reversal of an "other" account application on a cash receipt. This API routine has 3 output and 9 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 6
Output
Standard API parameters: 3 Application parameters: 0
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the descriptions of the other account unapplication-related parameters of the API:
Parameter p_cr_id
Type IN
Required
Description The cash_receipt_id of the receipt which is to be applied to the "other" account. Default: None Validation: 1. 2. Type must be 'CASH'. Status must not be Reversed or Approved. The receipt must not be Unidentified.
3.
The receipt number of the receipt from which the "other" account application is to be unapplied. Used to default the cash_receipt_id. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID
Type IN
Required
Description Identifies the receivable application. Used to derive the customer trx id, cash_receipt_id, and the applied_ps_id, if not specified. Default: Refer to Validation, page 8-74. Validation: 1. 2. Application type = 'CASH'. Display flag = 'Y' (latest application) and status = 'OTHER ACC'. The applied payment schedule id of the receivable application record must correspond to the p_applied_payment_schedules_id, if specified. The cash receipt id must correspond to the cash receipt id specified.
3.
4.
Error: AR_RAPI_REC_APP_ID_INVALID
Parameter p_reversal_gl_date
Type IN
Data-type DATE
Required
Description The reversal gl date. Default: Gets defaulted to the application gl date if it is a valid gl_date. Validation: It is valid if the following conditions are true:
The date is in an Open or Future period. The period cannot be an Adjustment period. The reversal GL date >= application GL date. The reversal GL date >= receipt GL date.
If the most recent open period is prior to the receipt date: last date of that period If there is a period open after the receipt date: first date of the last open period
Indicates which program is calling this API. Default: None Validation: None Error: None
p_cancel_claim_flag
IN
VARCHAR2 (1)
Example
Objective: To unapply an "other" account application using the call to API Ar_receipt_api_pub.unapply_other_account and passing a minimum number of input
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id p_reversal_gl_date Entered Value Default Value 20338 01-JUN-2000
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.apply_open_receipt
Call this routine to apply a cash receipt to another open receipt. Open receipts include unapplied cash, on-account cash, and claim investigation applications. Claim investigation applications can be applied only if Trade Management is installed. This API routine has 8 output and 18 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 12 + 2 (descriptive and global descriptive flexfield record type)
Output
Standard API parameters: 3 Application parameters: 5
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3.
The following table lists the descriptions of the apply open receipt-related parameters of the API:
Parameter p_cr_id Type IN Data-type NUMBER (15) Required Description The cash_receipt_id of the receipt which is to be applied to an open receipt. Default: None Validation: 1. 2. Type must be 'CASH'. Status must not be Reversed or Approved. The receipt must not be Unidentified. The receipt being applied and the open receipt must have the same currency.
3. 4.
The receipt number of the receipt to be applied to an open receipt. Used to default the cash_receipt_id. The receipt being applied and the open receipt must have the same currency. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID AR_RW_NET_DIFF_RCT_CURR
p_applied_payment _schedule_id
IN
NUMBER (15)
Type IN
Required
Description The cash_receipt_id of the open receipt which is to be applied to. Default: None Validation: 1. 2. Type must be 'CASH'. Status must not be Reversed or Approved. The receipt must not be Unidentified. The receipt being applied and the open receipt must have the same currency.
3. 4.
The receipt number of the open receipt. Used to default the open cash_receipt_id. The receipt being applied and the open receipt must have the same currency. Default: None Validation: None Error: AR_RAPI_RCPT_NUM_INVALID AR_RW_NET_DIFF_RCT_CURR
p_open_rec_app_id
IN
NUMBER (15)
The ID of the receivable application of the open receipt, if on-account or claim investigation. Default: None Validation: Must have status of ACC or OTHER ACC, and display must be 'Y'. Errors: AR_RAPI_REC_APP_ID_INVALID AR_RW_NET_OPEN_RCT_ONLY
Parameter p_amount_applied
Type IN
Required
Description The amount on the cash receipt that is to be applied to an open receipt. Default: None Validation: Must be a natural application, i.e. it must move the balance on the open receipt closer to zero. Error: AR_RAPI_APPLIED_AMT_NULL AR_RW_AMOUNT_LESS_THAN_APP AR_RW_NET_OPEN_AMT_INC
p_apply_date
IN
DATE
Date the application was applied. Default: 1. Receipt date, if receipt date >= system date. System date, if receipt date < system date.
2.
Parameter p_apply_gl_date
Type IN
Data-type DATE
Required
Description Date when this application will be posted to the General Ledger. Default: Defaulted to greater of the receipt GL date, the open receipt GL date, and the system date. Validation: 1. Validated as per standard gl date validation described for the gl date in the Create_cash routine. >= receipt gl date.
2.
Code defined by public sector accounting. Default: None Validation: None Error: None
p_attribute_rec
IN
attribute_rec_ type
This is a record type which contains all the 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Application Information flexfield. Default: DFF APIs used to do the defaulting and validation. Validation: DFF APIs used to do the defaulting and validation. Error: AR_RAPI_DESC_FLEX_INVALID
Parameter p_global_attribute_r ec
Type IN
Required
Description This is a record type which contains all the global descriptive flexfields: One global descriptive flexfield structure defining column and 20 segments. Default: None Validation: None Error: None
p_comments
IN
User's comments for the other account application. The reference number from the open receipt application, if applicable. If the application reference type is 'CLAIM', then this would be a deduction number. The ID of the resulting payment netting receivable application. The ID of the corresponding payment netting receivable application created on the applied-to receipt. Amount applied from the receipt, in functional currency and converted using the main receipt's exchange rate. Amount applied to the open receipt, in functional currency and converted using the open receipt's exchange rate. Used in conjunction with x_applied_amount_applied_from to determine exchange gain/loss. This parameter is used to identify the calling routine. Default: None Validation: None Error: None
x_application_ref_nu m
OUT
OUT
OUT
x_acctd_amount_ap plied_from
OUT
NUMBER (15)
x_acctd_amount_ap plied_to
OUT
VARCHAR2 (30)
p_called_from
IN
VARCHAR2 (20)
Example
Objective: To apply a cash receipt in your functional currency to unapplied cash on another receipt, using a call to the API Ar_receipt_api_pub.apply_open_receipt and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_receipt_number p_open_receipt_number p_amount_applied Entered Value 1.0 'aj_test_cr_10' 'aj_test_cr_30' -200 Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id p_open_cash_receipt_id p_gl_date p_apply_date Entered Value Default Value 23935 23973 01-JUN-2000 01-JUN-2000
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.unapply_open_receipt
Call this routine to reverse a payment netting application on a cash receipt. This API routine has 3 output and 7 input parameters in total. Based on the type, the following is the breakdown of the parameters:
Input
Standard API parameters: 4 Application parameters: 3
Output
Standard API parameters: 3 Application parameters: 0
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the descriptions of the unapply open receipt-related parameters of the API:
Parameter p_receivable_applica tion_id Type IN Data-type NUMBER(15) Required Description Identifies the receivable application to be unapplied. Default: Refer to Validation, page 8-74. Validation: 1. 2. Application type = 'CASH'. Display flag = 'Y' (latest application) and status = 'ACTIVITY', receivables_trx_id = -163. Unapplying this application must not result in either receipt becoming negative.
3.
Parameter p_reversal_gl_date
Type IN
Data-type DATE
Required
Description The reversal gl date. Default: Gets defaulted to the application gl date if it is a valid gl_date. Validation: It is valid if the following conditions are true:
The date is in an Open or Future period. The period cannot be an Adjustment period. The reversal GL date >= application GL date. The reversal GL date >= receipt GL date.
If the most recent open period is prior to the receipt date: last date of that period If there is a period open after the receipt date: first date of the last open period
Error: AR_INVALID_APP_GL_DATE AR_RW_BEFORE_APP_GL_DATE AR_RW_BEFORE_RECEIPT_GL_DATE p_called_from IN VARCHAR2(20 ) Yes Indicates which program is calling this API. Default: None Validation: None Error: None
Example
Objective: To unapply an open receipt/payment netting application using the call to API Ar_receipt_api_pub.unapply_open_receipt and passing a minimum number of input parameters. This table lists the entered parameters:
Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_cr_id p_reversal_gl_date Entered Value Default Value 20340 01-JUN-2000
The retrieval and handling of the warnings and error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Ar_receipt_api_pub.Create_apply_on_acc
This routine is called to create a cash receipt and place it on account. Use this routine when no specific debit item is referenced for receipt application, but you do not want to leave the cash as an unapplied liability. This is essentially a superset of Ar_receipt_api_pub.Create_cash, page 8-3 and Ar_receipt_api_pub.Apply_on_account, page 8-61 APIs, and contains the same parameters as contained in those two APIs. During the call to this API, if the receipt is successfully created but its on-account application fails, then the receipt creation is also rolled back. This routine calls Oracle Payments, where required. See Integration with Oracle Payments, page 8-2.
Note: To create credit card receipts that need to be processed by Oracle
Payments APIs, you must pass the p_call_payment_processor parameter as fnd_api.g_true. Additionally, you must specify the p_customer_bank_account_id parameter.
Input
Standard API parameters: 4 Application parameters: 49 + 2 (descriptive flexfield parameter)
Output
Standard API parameters: 3 Application parameters: 1
Parameter Descriptions
For a description of this routine's standard parameters, see Ar_receipt_api_pub.Create_cash, page 8-3. The following table lists the parameters that pertain specifically to the receipt creation and on-account application routine:
Parameter p_usr_currency_cod e Type IN Data-type VARCHAR2 Required Description The translated currency code. Used to derive the p_currency_code if it is not entered. Default: None Validation: Should be a valid currency, so that the corresponding currency code can be derived. Error: AR_RAPI_USR_CURR_CODE_INVALID p_currency_code IN VARCHAR2 (15)
The actual currency code that gets stored in AR tables. Default: 1. Derived from p_usr_currency_code if entered, else Defaults to the functional currency code
2.
Validation: Validated against the currencies in the fnd_currencies table. Error: AR_RAPI_CURR_CODE_INVALID Warning: AR_RAPI_FUNC_CURR_DEFAULTED
Type IN
Data-type VARCHAR2
Required
Description The translated exchange rate type. Used to derive the p_exchange_rate_type if it has not been entered. Default: None Validation: Should be a valid rate type. Error: AR_RAPI_USR_X_RATE_TYP_INVALID
p_exchange_rate_ty pe
IN
VARCHAR2 (30)
Exchange rate type stored in AR tables. Default: 1. In case of foreign currency receipt, derived from p_usr_exchange_rate_type. In case of foreign currency receipt, defaults from AR: Default Exchange Rate Type profile option. Should be left null, if receipt is in the same denomination as functional currency.
2.
3.
Parameter p_exchange_rate
Type IN
Data-type NUMBER
Required
Description The exchange rate between the receipt currency and the functional currency. Default: 1. Derived from the Daily Rates table for rate_type <> 'User' in case of non-functional currency. If profile option Journals: Display Inverse Rate = 'Y', set user-entered value to 1/ p_exchange_rate. The entered value is rounded to a precision of 38.
2.
3.
Validation: 1. In case of non-functional currency, the rate should have a positive value for rate type='User'. For non-functional currency and type <> 'User', do not specify any value.
2.
The date on which the exchange rate is valid. Default: Receipt date Validation: For a non-functional currency and type <> 'User', a valid rate should exist in the database for this date. This is a cross validation of type, currency, and date. Error: AR_NO_RATE_DATA_FOUND
p_amount
IN
NUMBER
Yes
The cash receipt amount. Default: Null Validation: > 0 Error: AR_RAPI_REC_AMT_NEGATIVE AR_RAPI_RCPT_AMOUNT_NULL
Type IN
Data-type NUMBER
Required
Description The bank charges on the cash receipt. Default: None Validation: 1. Bank charges are not allowed if profile option AR: Create Bank Charges = 'No'. Bank charges not allowed if the receipt state, derived from the receipt class of the receipt method, <> 'CLEARED'. If allowed, then >= 0.
2.
3.
The receipt number of the receipt to be created. Default: If not specified, the receipt number is defaulted from the document sequence value. Validation: Receipt number should not be null. Error: AR_RAPI_RCPT_NUM_NULL
p_receipt_date
IN
DATE
The receipt date of the entered cash receipt. Default: System date Validation: None Error: None
Parameter p_gl_date
Type IN
Data-type DATE
Required
Description Date that this receipt will be posted to the general ledger. Default: Gets defaulted to the receipt date if it is a valid gl_date. Validation: The date is valid if the following conditions are true:
The date is in an Open or Future period The period cannot be an Adjustment period
If the most recent open period is prior to the receipt date: last date of that period If there is a period open after the receipt date: first date of the last open period
Receipt maturity date. Default: Deposit date Validation: >= p_receipt_date Error: AR_RW_MAT_BEFORE_RCT_DATE
p_customer_id
IN
NUMBER (15)
The customer_id for the paying customer. Default: Refer to Defaulting, page 8-52. Validation: 1. Customer exists and has prospect code = 'CUSTOMER' Customer has a profile defined at the customer level
2.
Error: AR_RAPI_CUST_ID_INVALID
Parameter p_customer_name
Type IN
Required
Description The name for the entered customer. Used to default the customer id if not specified. Default: None Validation: None Error: AR_RAPI_CUS_NAME_INVALID
p_customer_number
IN
VARCHAR2 (30)
The customer number. Used to default the customer_id if not specified. Default: None Validation: None Error: AR_RAPI_CUS_NUM_INVALID
p_customer_bank_ac count_id
IN
NUMBER (15)
The customer bank account id. Default: From bank account id/number Validation: 1. It must be a valid bank account of the paying customer . The inactive date (if defined) of the bank account should be greater than the receipt_date. The receipt date must be within the Start date and the End date of the bank account uses.
2.
3.
The customer bank account number. Used to default the customer bank account id, if not specified. Default: None Validation: None Error: None
Type IN
Required
Description The customer bank account name. Used to default the customer bank account id, if not specified. Default: None Validation: None Error: None
p_location
IN
VARCHAR2 (40)
The Bill_To location for the customer. Used to derive the p_customer_site_use_id. Default: None Validation: None Error: AR_RAPI_CUS_LOC_INVALID
p_customer_site_use _id
IN
NUMBER (15)
The Bill_To site_use_id for the customer. Default: 1. Defaulted from customer location. Otherwise, Primary Bill_To customer site_use_id of the customer.
2.
Validation: It should be a valid Bill_To site of the paying customer. Error: AR_RAPI_CUS_SITE_USE_ID_INVALID p_customer_receipt_ reference IN VARCHAR2 (30)
This column is used to store a customer receipt reference value supplied by the customer at the confirmation time. Default: None Validation: None Error: None
Type IN
Required
Description The flag value decides when the remittance bank account is can be overridden by the remittance selection process. Default: 'Y' Validation: valid values 'Y' and 'N' Error: AR_RAPI_INVALID_OR_REMIT_BK_AC
p_remittance_bank_ account_id
IN
NUMBER (15)
Identifies the user's bank account for depositing the receipt. Default: 1. 2. From remittance bank account number From the receipt method based on logic mentioned in Defaulting, page 8-18.
Validation: Validation logic detailed in Validation, page 8-17. Error: AR_RAPI_REM_BK_AC_ID_INVALID AR_RAPI_REM_BK_AC_ID_NULL p_remittance_bank_ account_num IN VARCHAR2 (30)
The remittance bank account number. Used to default the remittance bank account id, if not specified. Default: None Validation: None Error: AR_RAPI_REM_BK_AC_NUM_INVALID
p_remittance_bank_ account_name
IN
VARCHAR2 (50)
The remittance bank account name. Used to default the remittance bank account id, if not specified. Default: None Validation: None Error: AR_RAPI_REM_BK_AC_NAME_INVALID
Parameter p_deposit_date
Type IN
Data-type DATE
Required
Description The deposit date. Default: receipt date Validation: None Error: None
p_receipt_method_i d
IN
NUMBER (15)
Identifies the receipt method of the receipt. Default: From receipt method name. Validation: Validation detailed in Validation, page 8-17. Error: AR_RAPI_INVALID_RCT_MD_ID
p_receipt_method_n ame
IN
VARCHAR2 (30)
The receipt method name of the receipt. Used to default the receipt method id if not specified. Default: None Validation: None Error: None
Parameter p_doc_sequence_val ue
Type IN
Data-type NUMBER
Required
Description Value assigned to document receipt. Default: Detailed in Defaulting, page 8-18. Validation:
User should not pass in the value if the current document sequence is automatic. Document sequence value should not be entered if profile option Sequential Numbering is set to Not Used.
Code defined by public sector accounting. Default: None Validation: None Error: None
p_anticipated_cleari ng_date
IN
DATE
Date the receipt is expected to be cleared. Default: None Validation: >= gl_date Error: AR_RW_EFFECTIVE_BEFORE_GL_DATE
p_event
IN
VARCHAR2
The event that resulted in the creation of the receipt. Currently used only by Bills Receivable. Default: None Validation: None Error: None
Parameter p_called_from
Type IN
Required
Description This parameter is used to identify the calling routine. Currently used to identify only the 'BR_REMIT' program. Default: None Validation: None Error: None
p_attribute_record
IN
attribute_rec_t ype
This is a record type which contains all the 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Information flexfield. Default: DFF APIs complete the defaulting and validation. Validation: DFF APIs complete the defaulting and validation. Error: AR_RAPI_DESC_FLEX_INVALID
p_global_attribute_r ecord
IN
global_attribut e_rec_type
This is a record type which contains all the 20 global descriptive flexfield segments and one global descriptive flexfield structure defining column. Default: None Validation: None
p_receipt_comments
IN
p_issuer_name
IN
Issuer name of notes receivable (Asia Pacific requirement). Default: None Validation: None Error: None
Parameter p_issue_date
Type IN
Data-type DATE
Required
Description Date when notes receivable was issued (Asia Pacific requirement). Default: None Validation: None Error: None
p_issuer_bank_branc h_id
IN
NUMBER (15)
Bank/ Branch issuing the notes receivable (Asia Pacific Requirement). Default: None Validation: None Error: None
p_cr_id
OUT
NUMBER (15)
The cash_receipt_id of the receipt created by the API call. The amount on the cash receipt that is to be applied to an account. Default: The default amount applied can be either the open amount of the transaction or the unapplied amount of the receipt, but you can change it. Use the AR: Always Default Transaction Balance for Applications profile option, Oracle Receivables Implementation Guide to control how Receivables defaults the applied amount. For the profile option's defaulting rules, see Ar_receipt_api_pub.Apply, page 8-21. Validation: Less than or equal to the amount due remaining on the receipt. Error: AR_RAPI_APPLIED_AMT_NULL AR_RW_AMOUNT_LESS_THAN_APP
p_amount_applied
IN
NUMBER
Parameter p_apply_date
Type IN
Data-type DATE
Required
Description Date the application was applied. Default: 1. 2. Receipt date, if receipt date >= system date. System date, if receipt date < system date.
Validation: apply date >= receipt date Error: AR_APPLY_BEFORE_RECEIPT p_apply_gl_date IN DATE
Date that this application will be posted to the general ledger. Default: Defaulted to greater of the receipt date and the system date. Validation: 1. Validated as per standard gl date validation described for the gl date in create_cash routine >= receipt gl date
2.
p_app_attribute_rec ord
IN
attribute_rec_t ype
This is a record type which contains all the 15 descriptive flexfield segments and one descriptive flexfield structure defining column. It represents the Receipt Application Information flexfield. Default: DFF APIs complete the defaulting and validation. Validation: DFF APIs complete the defaulting and validation. Error: AR_RAPI_DESC_FLEX_INVALID
Type IN
Required
Description This is a record type which contains all the 20 global descriptive flexfield segments and one global descriptive flexfield structure defining column. Default: None Validation: None
app_comments
IN
IN
Deduction number, if resulting from Trade Management claim settlement. Claim ID, if resulting from Trade Management claim settlement. Reference supplied by customer.
IN
IN
VARCHAR2 (100) VARCHAR2 (20) VARCHAR2 (30) VARCHAR2 (30) VARCHAR2 (1)
IN
IN
Used for automated receipt handling, leave null. Used for automated receipt handling, leave null. This is the payment processing indicator flag. Pass as FND_API.G_TRUE, if you want to call i Payment payment APIs for credit card processing. Indicates if you want to default the site use from p_customer_site_use_id. The default value is Y. Pass N to default nothing. If the Require Billing Location for Receipts system option is selected, then no value is required here.
IN
IN
p_default_site_use
IN
VARCHAR2
No
Example
Objective: To create a cash receipt and apply to On Account in the functional currency using a call to the API Ar_receipt_api_pub.Create_Apply_on_acc and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_receipt_number p_amount p_receipt_method_id p_customer_name Entered Value 1.0 'aj_test_api_3' 1000 1001 'Computer Service and Rentals' Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_customer_id p_currency_code p_receipt_date p_gl_date p_deposit_date p_customer_site_use_id p_override_remit_bank_acco unt_flag Entered Value Default Value 1006 USD 19-APR-2004 19-APR-2004 19-APR-2004 1025 'Y'
Entered Value
Result: We were able to create the cash receipt 'aj_test_api_3' and then apply it to 'On account' by specifying only 5 input parameters in our call to this API. The receipt is in the functional currency. The retrieval and handling of the warnings and the error messages, put on the message stack by the API during execution, are the same as described in Defaulting, page 8-18.
Messages
Messages play an important role in the effectiveness of your API calls. The right message is raised at the right point to convey to you the exact error that has occurred or any warnings that have been raised. The Receipt API puts on the message stack all error messages and warnings raised during execution. You can retrieve messages and warnings as described in Exception Handling and Result Messages, page 1-3.
MESSAGE_CODE AR_APPLY_BEFORE_RECEIPT
MESSAGE_TEXT Apply Date must be greater than or equal to the Receipt Date. Apply Date must be greater than or equal to the Transaction Date. For a receipt status other than cleared, bank charges are not allowed. Please enter a positive exchange rate. The exchange rate cannot be zero. GL date, &GL_DATE, is not in an open or future-enterable period. The Bank Charges amount cannot be negative. No discounts allowed on this installment unless it is fully paid. There is no rate for this currency, rate date and rate type in the database. Override remittance bank flag has invalid value. Customer bank account identifier has taken a precedence over the customer bank account name and number. The receivables activity name is invalid.
EXPLANATION
TYPE E
AR_EXCHANGE_RATE_NEGATI VE AR_EXCHANGE_RATE_ZERO
AR_INVALID_APP_GL_DATE
AR_JG_BC_AMOUNT_NEGATIVE
AR_NO_PARTIAL_DISC
AR_NO_RATE_DATA_FOUND
AR_RAPI_ACTIVITY_INVALID
MESSAGE_CODE AR_RAPI_ACTIVITY_IGN
MESSAGE_TEXT Both a receivables transaction identifier and a receivables activity exist for this record. The receivables transaction identifier takes precedence over the receivables activity. Please enter a different combination of receipt amount, tax amount, and tax rate. The tax code is invalid. The tax rate is invalid. Both a VAT identifier and a tax code exist for this record. The VAT identifier takes precedence over the tax code. Please enter a receivables transaction identifier. The VAT identifier is invalid.
EXPLANATION
TYPE W
AR_RAPI_TAX_RATE_AMT_X_IN VALID
E E W
AR_RAPI_REC_TRX_ID_NULL
The reference type is invalid. The reference number is invalid. Both a reference identifier and a reference number exist for this record. The reference identifier takes precedence over the reference number. The reference identifier is invalid. Please enter a reference identifier.
E E W
AR_RAPI_REF_ID_INVALID
AR_RAPI_REF_ID_NULL
MESSAGE_TEXT Please enter a reference type. The specified combination of payment schedule identifier and receivables transaction identifier is invalid.
EXPLANATION
TYPE E E
The activity type derived from the receivables_trx_id does not match with the activity type of the specified payment_schedule_id.
AR_RAPI_AMT_APP_FROM_INV ALID
The allocated receipt amount and the applied amount should be same for the functional currency receipt. Applied payment schedule identifier has an invalid value. Invalid receivable application identifier for the specified applied payment schedule identifier. Applied amount could not be defaulted.
AR_RAPI_APP_PS_ID_INVALID
AR_RAPI_APP_PS_RA_ID_X_INV ALID
AR_RAPI_APPLIED_AMT_NULL
The p_applied_amount was not specified by the user and it could not be defaulted from the specified receipt or the specified transaction. For explanation on defaulting mechanism refer Defaulting, page 8-30
Cash receipt identifier is null. The entered combination of the applied amount, allocated amount and the cross currency rate is invalid.
This error is raised if the following condition is violated in the cross currency applications: p_trans_to_receipt_rate* p_amount_applied = p_amount_applied_from.
E E
MESSAGE_CODE AR_RAPI_CC_RATE_INVALID
MESSAGE_TEXT Do not enter the cross currency rate if the receipt and the transaction are in same currency.
EXPLANATION For the same currency receipt application, p_trans_to_receipt_rate should not be specified. In case of a cross currency receipt application, the p_trans_to_receipt_rate could neither be defaulted nor derived. The specified currency code has an invalid value. The specified combination of the p_customer_bank_account_num ber and p_customer_bank_account_nam e is invalid and cannot be used to derive the p_customer_bank_account_id. The specified value of p_customer_bank_account_id is invalid. The specified value of p_customer_bank_account_nam e is invalid. The specified value of p_customer_bank_account_num ber is invalid. The specified value of p_location has an invalid value.
TYPE E
AR_RAPI_CC_RATE_NULL
AR_RAPI_CURR_CODE_INVALI D AR_RAPI_CUS_BK_AC_2_INVALI D
AR_RAPI_CUS_BK_AC_ID_INVA LID
AR_RAPI_CUS_BK_AC_NAME_I NVALID
AR_RAPI_CUS_BK_AC_NUM_IN VALID
AR_RAPI_CUS_LOC_INVALID
Customer location is invalid for the specified customer. Invalid customer name. Invalid combination of customer name and number. Invalid customer number.
E E
MESSAGE_TEXT Customer site use identifier is invalid for the specified customer.
EXPLANATION The specified value of p_customer_site_use_id is invalid for the given customer. It should be a valid BILL_TO site_use_id for the customer. Neither the user had passed in any value for the p_location / p_customer_site_use_id, nor could it be defaulted to the primary Bill_To location for the given customer.
TYPE E
AR_RAPI_CUS_STE_USE_ID_NOT _DEF
AR_RAPI_CUST_ID_INVALID AR_RAPI_CUST_ID_NULL
The p_customer_id is null. For details, refer to API Usage, page 8-2. The specified values of p_customer_number and/or p_customer_name are ignored if the value for p_customer_id has been passed in.
E E
AR_RAPI_CUS_NAME_NUM_IG N
AR_RAPI_CUST_TRX_ID_INVALI D AR_RAPI_CUST_TRX_ID_NULL
Invalid customer transaction identifier. Customer transaction identifier is null. Invalid deferred tax flag.
The entered values for the descriptive flexfield &DFF_NAME is invalid. You have passed in the document sequence value, even though the current document sequence is automatic.
AR_RAPI_DOC_SEQ_AUTOMATI C
MESSAGE_CODE AR_RAPI_DOC_SEQ_NOT_EXIST _A
MESSAGE_TEXT Document sequence does not exist for the current document even though profile option Sequential Numbering is set to Always Used. Document sequence does not exist for the current document even though profile option Sequential Numbering is set to Partially Used. Document sequence value should not be entered if profile option Sequential Numbering is set to Not Used. The profile option Sequential Numbering is set to Always Used and the document sequence is manual. The document sequence value is null. The profile option Sequential Numbering is set to Partially Used and the document sequence is manual. The document sequence value is null. Functional currency defaulted as the receipt currency. The customer could not be defaulted from the applied payment schedule identifier and the installment.
EXPLANATION
TYPE E
AR_RAPI_DOC_SEQ_NOT_EXIST _P
AR_RAPI_DOC_SEQ_VAL_INVA LID
AR_RAPI_DOC_SEQ_VALUE_NU LL_A
AR_RAPI_DOC_SEQ_VALUE_NU LL_P
This error is raised if the customer_id cannot be derived from the p_applied_payment_schedule_i d and the p_installment specified in the create_and_apply routine.
AR_RAPI_INSTALL_NULL AR_RAPI_INVALID_APP_REF
The installment number is null. Please supply a valid application reference type.
E E
MESSAGE_CODE AR_RAPI_INVALID_CLAIM_ID
MESSAGE_TEXT A valid claim ID &CLAIM_ID does not exist for the specified receipt and amount. The claim is invalid. Please enter a different claim number. Please supply a valid reference reason. More than one On Account application exists for the current receipt. Please specify the receivable application identifier.
EXPLANATION
TYPE E
This error is raised in the unapply_on_account routine if for the specified cash receipt, more than one On Account application exists and the p_receivable_application_id is not specified. Explanation: refer to Defaulting, page 8-69. This error is raised in the create_and_apply routine if the customer is not entered and cannot be derived from the specified p_applied_payment_schedule_i d. This is a required field in the create_cash and the create_and_apply routines.
AR_RAPI_NON_REVERSIBLE
Standard reversal not possible for this receipt. The customer could not be defaulted from the applied payment schedule identifier.
AR_RAPI_PSID_NOT_DEF_CUS
AR_RAPI_RCPT_AMOUNT_NUL L
AR_RAPI_RCPT_MD_ID_NULL AR_RAPI_RCPT_MD_NAME_IGN
Receipt method identifier is null. Receipt method identifier has taken precedence over receipt method name.
E W
EXPLANATION This error is raised if the p_receipt_method_id is not passed in and the specified p_receipt_method_name is invalid. This error is raised in the Unapply routine, if the specified receipt has no application against the specified transaction.
TYPE E
AR_RAPI_RCPT_NOT_APP_TO_I NV
AR_RAPI_RCPT_NUM_IGN
Cash receipt identifier has taken a precedence over the receipt number. Invalid receipt number. Invalid combination of receivable application identifier and the cash receipt identifier.
The p_cr_id derived from the p_receivable_application_id specified by the user does not match with the p_cr_id which is either specified by the user or defaulted from the p_receipt_number.
E E
E E
Invalid receivable application identifier. Receivable application identifier is null. Invalid receivable transaction identifier.
AR_RAPI_REC_APP_ID_NULL
BR
AR_RAPI_REC_TRX_ID_INVALID
MESSAGE_CODE AR_RAPI_REM_BK_AC_2_INVAL ID
EXPLANATION The specified combination of the p_remittance_bank_account_nu mber and p_remittance_bank_account_na me is invalid, and cannot be used to derive the p_remittance_bank_account_id. This error is raised if the specified p_remittance_bank_account_id is not associated with the specified p_receipt_method_id.
TYPE E
AR_RAPI_REM_BK_AC_ID_INVA LID
AR_RAPI_REM_BK_AC_ID_NULL
Remittance bank account identifier is null. Invalid remittance bank account name. Remittance bank account identifier has taken a precedence over the remittance bank account name and number. Invalid remittance bank account number. Invalid reversal category code.
Reversal category code is null. Reversal category code has taken precedence over the reversal category name. Invalid reversal category name.
E W
EXPLANATION
TYPE E
Reversal reason code is invalid. Reversal reason code has taken a precedence over the reversal reason name. Invalid reversal reason name.
E W
Invalid combination of the customer transaction identifier and installment. The customer could not be defaulted from the entered transaction and the installment.
AR_RAPI_TRX_INS_NOT_DEF_C US
This error is raised in the create_and_apply routine if the customer is not entered and cannot be derived from the specified transaction and installment. This error is raised in the create_and_apply routine if the customer is not entered and cannot be derived from the specified p_customer_trx_id/trx_number, p_installment and p_applied_payment_schedule_i d.
AR_RAPI_TRX_INS_PS_NOT_DEF _CUS
The customer could not be defaulted from the entered transaction, installment and applied payment schedule identifier.
AR_RAPI_TRX_LINE_AMT_DEFL T
Amount applied has been defaulted to the line amount of the specified transaction line. Invalid customer transaction line identifier. Invalid transaction line number.
AR_RAPI_TRX_LINE_ID_INVALI D AR_RAPI_TRX_LINE_NO_INVAL ID
MESSAGE_CODE AR_RAPI_TRX_NOT_DEF_CUST
MESSAGE_TEXT The customer could not be defaulted from the entered transaction.
EXPLANATION This error is raised in the create_and_apply routine if the customer is not entered and cannot be derived from the specified p_customer_trx_id/trx_number.
TYPE E
AR_RAPI_TRX_NUM_IGN
Customer transaction identifier has taken a precedence over the transaction number. Invalid combination of transaction number and installment. Invalid transaction number. Invalid applied payment schedule identifier for the specified transaction.
AR_RAPI_TRX_NUM_INST_INVA LID
AR_RAPI_TRX_NUM_INVALID AR_RAPI_TRX_PS_ID_X_INVALI D
The p_applied_payment_schedule_i d specified by the user does not match with the payment_schedule_id derived from the p_customer_trx_id and the p_installment. This error is raised in the create_and_apply routine if the customer is not entered and cannot be derived from the specified p_customer_trx_id/trx_number and the p_applied_payment_schedule_i d. This message is to be used by the API, activity_application, added as part of the Bills Receivables changes.
E E
AR_RAPI_TRX_PS_NOT_DEF_CU S
The customer could not be defaulted from the entered transaction and the applied payment schedule identifier.
AR_RAPI_TRX_RA_ID_X_INVALI D
The activity type for the entered receivable transaction identifier does not match with the activity of the entered payment schedule identifier. Currency code took a precedence over the user currency code.
AR_RAPI_USR_CURR_CODE_IG N
EXPLANATION
TYPE E
User exchange rate type is invalid. Exchange rate type took a precedence over the User exchange rate type. Invalid exchange rate date.
AR_RAPI_X_RATE_DATE_INVAL ID AR_RAPI_X_RATE_INVALID
This would be raised if the exchange rate type is not 'User' and the exchange rate has been specified.
E E
Exchange rate type is null. The receipt amount cannot be less than the sum of the applied and on-account amounts. Amount applied cannot be negative for an On Account application. You may not apply more than the receipt amount.
E E
AR_RW_APP_NEG_ON_ACCT
AR_RW_APP_NEG_UNAPP
This error is raised if you try to apply more than the unapplied amount on the receipt against a transaction.
MESSAGE_CODE AR_RW_APPLIED_GREATER_LI NE
MESSAGE_TEXT Amount applied cannot be greater than the original line amount of &AMOUNT.
EXPLANATION This error is raised in the apply and create_and_apply routines if the line number of transaction has been specified and the amount applied is greater than the original line amount of the transaction line.
TYPE E
AR_RW_BEFORE_APP_GL_DATE
Reversal GL Date must be on or after original GL Date of &GL_DATE. The Reversal GL Date cannot be before the Receipt GL Date. A cash receipt with this number, date, amount and customer already exists. Cross currency rate must be greater than zero.
AR_RW_CC_RATE_POSITIVE
This error is raised in the apply and create_and_apply routines if the p_trans_to_receipt_rate has a negative value. This error is raised in the apply and the create_and_apply routines if the apply gl_date is before the receipt gl_date.
AR_RW_GL_DATE_BEFORE_REC _GL
AR_RW_GL_DATE_BEFORE_OPE N_REC_GL
The application GL date must be later than the open receipt GL date for a receipt-to-receipt application. The Maturity Date cannot be before the Receipt Date. Both receipts in a receipt to receipt application must have the same currency.
AR_RW_MAT_BEFORE_RCT_DA TE AR_RW_NET_DIFF_RCT_CURR
MESSAGE_CODE AR_RW_NET_OPEN_AMT_INC
MESSAGE_TEXT A receipt-to-receipt application must decrease the open receipt balance or bring the receipt balance closer to zero. Netting is allowed on open receipts only (unapplied cash, on-account cash and claim investigation applications). Unapplying this payment netting application is not allowed because it would cause the applied receipt balance to become negative. Discounts are not permitted for transactions with a negative original balance. You have paid the same invoice twice. Please correct. You cannot enter a negative receipt amount for cash receipts. Discount taken is greater than the discount available (&DISC_AVAILABLE). Discount cannot be negative. Discount not allowed for On Account application. Clear discount amount field or enter zero. Cannot take unearned discount because the Allow Unearned Discount system option is set to No.
EXPLANATION
TYPE E
AR_RW_NET_OPEN_RCT_ONLY
AR_RW_NET_UNAPP_OVERAPP
AR_RW_NO_DISCNT
AR_RW_PAID_INVOICE_TWICE
AR_RW_RCT_AMOUNT_NEGATI VE AR_RW_VAL_DISCOUNT
AR_RW_VAL_NEG_DISCNT AR_RW_VAL_ONACC_DISC
E E
AR_RW_VAL_UNEARNED_DISC OUNT
MESSAGE_CODE AR_SYSTEM_WR_NO_LIMIT_SET
MESSAGE_TEXT Please set the receipt write-off limits range system option. The GL date should not be prior to the invoice's GL date. User Write-off limit does not exist. The total write-off amount must fall within the receipt write-off limits range system option. Total write-off amount must be in the range of &FROM_AMOUNT to &TO_AMOUNT.
EXPLANATION
TYPE E
AR_VAL_GL_INV_GL
AR_WR_NO_LIMIT
AR_WR_TOTAL_EXCEED_MAX_ AMOUNT
AR_WR_USER_LIMIT
9
Revenue Adjustment API User Notes
This chapter covers the following topics: Overview API Usage Messages
Overview
This document outlines the specifications and the methodology for using the various Revenue Adjustment APIs. These APIs provide an extension to existing functionality of adjusting revenue and sales credits through the standard AR Revenue Management form. You can access these APIs: As standard PL/SQL servers-side routine calls Through Forms, utilizing the capability of Forms6 to have a procedure as its underlying base table
Presently, the main business need for the API is the requirement to have event-based revenue recognition. In Receivables, you can defer revenue recognition, and earn the revenue at a later date using the API. Throughout the process, the API uses AutoAccounting to determine the accounts to be debited/credited with each operation.
API Usage
To earn and unearn revenue, transfer sales credits, and add non-revenue sales credits at the transaction, item, category, or transaction line level, you can call the following four PL/SQL APIs: AR_RevenueAdjust_PUB.Unearn_Revenue, page 9-2: Transfers the specified amount of revenue from the revenue account to the unearned revenue account on the specified transaction lines. AR_RevenueAdjust_PUB.Earn_Revenue, page 9-16: Transfers the specified amount of revenue from the unearned revenue account to the revenue account on the specified transaction lines. AR_RevenueAdjust_PUB.Transfer_Sales_Credits, page 9-18: Transfers revenue and/or non-revenue sales credits between salespersons on the specified transaction lines. In the case of revenue sales credits, the associated revenue is also transferred between cost centers, assuming that AutoAccounting derives the cost center segment of the accounting flexfield from the salesperson. AR_RevenueAdjust_PUB.Add_Non_Revenue_Sales_Credits, page 9-23: Adds non-revenue sales credits for any salesperson to the specified transaction lines.
For all options, a specific amount or percentage of the total value can be specified. All available revenue can also be specified, except for Add_Non_Revenue_Sales_Credits, where this is not applicable.
Note: You cannot specify both revenue and nonrevenue sales credits
AR_RevenueAdjust_PUB.Unearn_Revenue
Call this routine to move revenue from the earned revenue account to the unearned revenue account using AutoAccounting. This API routine has 4 input and 5 output parameters in total. One of the input parameters is a record type that holds all the revenue adjustment information and has 120 elements. The output parameters include the revenue_adjustment_number and revenue_adjustment_id of the revenue adjustment. The following is the breakdown of the parameters:
Input
Standard API parameters: 3 Revenue Adjustment parameters: 1 (revenue adjustment record type)
Output
Standard API parameters: 3 Revenue Adjustment parameters: 2
Parameter Descriptions
The input revenue adjustment parameter is a record of type AR_Revenue_Adjustment_PVT.Rev_Adj_Rec_Type.
TYPE Rev_Adj_Rec_Type IS RECORD (CUSTOMER_TRX_ID ,TRX_NUMBER ,BATCH_SOURCE_NAME ,ADJUSTMENT_TYPE ,FROM_SALESREP_ID ,FROM_SALESREP_NUMBER ,TO_SALESREP_ID ,TO_SALESREP_NUMBER ,FROM_SALESGROUP_ID ,TO_SALESGROUP_ID ,SALES_CREDIT_TYPE ,AMOUNT_MODE ,AMOUNT ,PERCENT ,LINE_SELECTION_MODE ,FROM_CATEGORY_ID ,FROM_CATEGORY_SEGMENT1 ,FROM_CATEGORY_SEGMENT2 ,FROM_CATEGORY_SEGMENT3 ,FROM_CATEGORY_SEGMENT4 ,FROM_CATEGORY_SEGMENT5 ,FROM_CATEGORY_SEGMENT6 ,FROM_CATEGORY_SEGMENT7 ,FROM_CATEGORY_SEGMENT8 ,FROM_CATEGORY_SEGMENT9 ,FROM_CATEGORY_SEGMENT10 ,FROM_CATEGORY_SEGMENT11 ,FROM_CATEGORY_SEGMENT12 ,FROM_CATEGORY_SEGMENT13 ,FROM_CATEGORY_SEGMENT14 ,FROM_CATEGORY_SEGMENT15 ,FROM_CATEGORY_SEGMENT16 ,FROM_CATEGORY_SEGMENT17 ,FROM_CATEGORY_SEGMENT18 ,FROM_CATEGORY_SEGMENT19 ,FROM_CATEGORY_SEGMENT20 ,TO_CATEGORY_ID ,TO_CATEGORY_SEGMENT1 ,TO_CATEGORY_SEGMENT2 ,TO_CATEGORY_SEGMENT3 ,TO_CATEGORY_SEGMENT4 ,TO_CATEGORY_SEGMENT5 ,TO_CATEGORY_SEGMENT6 ,TO_CATEGORY_SEGMENT7 ,TO_CATEGORY_SEGMENT8 ,TO_CATEGORY_SEGMENT9 ,TO_CATEGORY_SEGMENT10 ,TO_CATEGORY_SEGMENT11 ,TO_CATEGORY_SEGMENT12 ,TO_CATEGORY_SEGMENT13 ,TO_CATEGORY_SEGMENT14 ,TO_CATEGORY_SEGMENT15 ,TO_CATEGORY_SEGMENT16 ,TO_CATEGORY_SEGMENT17 ,TO_CATEGORY_SEGMENT18 ,TO_CATEGORY_SEGMENT19 ,TO_CATEGORY_SEGMENT20 ,FROM_INVENTORY_ITEM_ID ,FROM_ITEM_SEGMENT1 ,FROM_ITEM_SEGMENT2
NUMBER(15) RA_CUSTOMER_TRX.trx_number%TYPE RA_BATCH_SOURCES.name%TYPE VARCHAR2(15) DEFAULT 'UN' NUMBER(15) RA_SALESREPS.salesrep_number%TYPE NUMBER(15) RA_SALESREPS.salesrep_number%TYPE jtf_rs_groups_b.group_id%TYPE jtf_rs_groups_b.group_id%TYPE VARCHAR2(15) DEFAULT 'R' VARCHAR2(15) DEFAULT 'T' NUMBER NUMBER VARCHAR2(15) DEFAULT 'A' NUMBER(15) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) NUMBER(15) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) VARCHAR2(40) NUMBER(15) VARCHAR2(40) VARCHAR2(40)
,FROM_ITEM_SEGMENT3 VARCHAR2(40) ,FROM_ITEM_SEGMENT4 VARCHAR2(40) ,FROM_ITEM_SEGMENT5 VARCHAR2(40) ,FROM_ITEM_SEGMENT6 VARCHAR2(40) ,FROM_ITEM_SEGMENT7 VARCHAR2(40) ,FROM_ITEM_SEGMENT8 VARCHAR2(40) ,FROM_ITEM_SEGMENT9 VARCHAR2(40) ,FROM_ITEM_SEGMENT10 VARCHAR2(40) ,FROM_ITEM_SEGMENT11 VARCHAR2(40) ,FROM_ITEM_SEGMENT12 VARCHAR2(40) ,FROM_ITEM_SEGMENT13 VARCHAR2(40) ,FROM_ITEM_SEGMENT14 VARCHAR2(40) ,FROM_ITEM_SEGMENT15 VARCHAR2(40) ,FROM_ITEM_SEGMENT16 VARCHAR2(40) ,FROM_ITEM_SEGMENT17 VARCHAR2(40) ,FROM_ITEM_SEGMENT18 VARCHAR2(40) ,FROM_ITEM_SEGMENT19 VARCHAR2(40) ,FROM_ITEM_SEGMENT20 VARCHAR2(40) ,TO_INVENTORY_ITEM_ID NUMBER(15) ,TO_ITEM_SEGMENT1 VARCHAR2(40) ,TO_ITEM_SEGMENT2 VARCHAR2(40) ,TO_ITEM_SEGMENT3 VARCHAR2(40) ,TO_ITEM_SEGMENT4 VARCHAR2(40) ,TO_ITEM_SEGMENT5 VARCHAR2(40) ,TO_ITEM_SEGMENT6 VARCHAR2(40) ,TO_ITEM_SEGMENT7 VARCHAR2(40) ,TO_ITEM_SEGMENT8 VARCHAR2(40) ,TO_ITEM_SEGMENT9 VARCHAR2(40) ,TO_ITEM_SEGMENT10 VARCHAR2(40) ,TO_ITEM_SEGMENT11 VARCHAR2(40) ,TO_ITEM_SEGMENT12 VARCHAR2(40) ,TO_ITEM_SEGMENT13 VARCHAR2(40) ,TO_ITEM_SEGMENT14 VARCHAR2(40) ,TO_ITEM_SEGMENT15 VARCHAR2(40) ,TO_ITEM_SEGMENT16 VARCHAR2(40) ,TO_ITEM_SEGMENT17 VARCHAR2(40) ,TO_ITEM_SEGMENT18 VARCHAR2(40) ,TO_ITEM_SEGMENT19 VARCHAR2(40) ,TO_ITEM_SEGMENT20 VARCHAR2(40) ,FROM_CUST_TRX_LINE_ID NUMBER(15) ,FROM_LINE_NUMBER NUMBER(15) ,TO_CUST_TRX_LINE_ID NUMBER(15) ,TO_LINE_NUMBER NUMBER(15) ,GL_DATE DATE ,REASON_CODE VARCHAR2(15) ,COMMENTS VARCHAR2(2000) ,ATTRIBUTE_CATEGORY VARCHAR2(30) ,ATTRIBUTE1 VARCHAR2(150) ,ATTRIBUTE2 VARCHAR2(150) ,ATTRIBUTE3 VARCHAR2(150) ,ATTRIBUTE4 VARCHAR2(150) ,ATTRIBUTE5 VARCHAR2(150) ,ATTRIBUTE6 VARCHAR2(150) ,ATTRIBUTE7 VARCHAR2(150) ,ATTRIBUTE8 VARCHAR2(150) ,ATTRIBUTE9 VARCHAR2(150) ,ATTRIBUTE10 VARCHAR2(150) ,ATTRIBUTE11 VARCHAR2(150) ,ATTRIBUTE12 VARCHAR2(150) ,ATTRIBUTE13 VARCHAR2(150) ,ATTRIBUTE14 VARCHAR2(150)
,ATTRIBUTE15
VARCHAR2(150));
The following table lists standard API parameters that are common to all the routines in the Revenue Adjustment API.
Parameter p_api_version Type IN Data-type NUMBER Required Yes Default Value Description Used to compare version numbers of incoming calls to its current version number. Unexpected error is raised if version incompatibility exists. In the current version of the API, you should pass in a value of 1.0 for this parameter. Allows API callers to request that the API does initialization of the message list on their behalf. Used by API callers to ask the API to commit on their behalf. Revenue Adjustment record type
p_init_msg_list
IN
VARCHAR2
FND_API.G_FAL SE
p_commit
IN
VARCHAR2
p_rev_adj_rec
IN
Yes
x_return_status
OUT
Represents the API overall return status. Detailed in Return Status, page 1-4. Number of messages in the API message list. This is the message in encoded format if x_msg_count=1. The ID of the resulting revenue adjustment. The user visible number of the resulting revenue adjustment.
x_msg_count
OUT
NUMBER
x_msg_data
OUT
VARCHAR2
x_adjustment_id
OUT
NUMBER
x_adjustment_n umber
OUT
VARCHAR2
The following table lists Rev_Adj_Rec_Type elements that are relevant to Unearn_Revenue:
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported. At least one of the numbered sets of parameters is required.
Parameter p_customer_trx_id
Data-type NUMBER(15)
Required 1
Description The ID of the transaction on which revenue is to be adjusted. Default: None Validation: Must exist if specified. Must not have a class of 'CB','DM','BR','DEP','GUAR' (i.e. chargeback, debit memo, bills receivable, deposit, guarantee). Must not have had credit memo(s) raised against the full transaction value. Warning if partial credit memo has been raised. Every line must have revenue sales credits adding to 100%. Errors: AR_TAPI_TRANS_NOT_EXIST AR_TW_INCORRECT_SALESCREDIT AR_RA_CB_DISALLOWED AR_RA_DM_DISALLOWED AR_RA_BR_DISALLOWED AR_RA_DEP_DISALLOWED AR_RA_GUAR_DISALLOWED AR_TW_INCORRECT_SALESCREDIT AR_RA_FULL_CREDIT Warnings: AR_RA_PARTIAL_CREDIT
trx_number
ra_customer_trx.trx_ number%TYPE
The user visible transaction number Default: None Validation: Ignored if customer_trx_id has a value. Must be unique. Batch source can be optionally passed as extra assurance of uniqueness - then must be unique for that batch source. Otherwise, validation is the same as for customer_trx_id. Errors: AR_RA_TRX_NOTFOUND AR_RA_TRX_TOO_MANY_ROWS
Parameter batch_source_name
Required
Description Name of the batch source associated with the trx_number, if specified. Only used in association with trx_number to help ensure uniqueness. Default: None Validation: Ignored if trx_number is not passed. If an invalid string is passed, the trx not found message will result.
adjustment_type
VARCHAR2(15)
Type of revenue adjustment. This element should be left null. Default: 'UN'
from_salesrep_id
NUMBER(15)
The ID of the salesperson whose revenue is being adjusted. Validation: If specified, must exist, must be currently active, and must have been active on transaction date. Must have revenue sales credits on at least one line on the transaction. Error: AR_TAPI_INVALID_SALESREP_ID AR_RA_SALESREP_NOT_ON_TRX
from_salesrep_number
ra_salesreps.salesrep _number%TYPE
The user visible number of the salesperson whose revenue is being adjusted. Validation: Ignored if from_salesrep_id is specified. Otherwise, validation is as for from_salesrep_id. Error: AR_RA_INAVLID_SALESREP_NUMBER
to_salesrep_id
NUMBER
Not used for unearning revenue and should be left null. Not used for unearning revenue and should be left null.
to_salesrep_number
VARCHAR2(30)
Parameter from_salesgroup_id
Required
Description The ID of the sales group of the salesperson whose revenue is being adjusted. Validation: Must have revenue sales credits on at least one line on the transaction. Error: AR_RA_SALESREP_NOT_ON_TRX
to_salesgroup_id
Not used for unearning revenue and should be left null. Not used for unearning revenue and should be left null. The amount mode specifies whether an amount, a percentage (of total value of selected lines), or all adjustable revenue is to be adjusted. Possible values are:
sales_credit_type
amount_mode
VARCHAR2(15)
Default: 'T' Validation: Must be one of the above values Error: AR_RA_INVALID_AMOUNT_MODE amount NUMBER
The amount of revenue to be adjusted Default: None Validation: Ignored unless amount_mode = 'A', in which case it must have a value. Must be =< total recognized revenue for selected lines, and salesperson (if specified). Errors: AR_RA_AMT_EXCEEDS_AVAIL_REV AR_RA_ZERO_AMOUNT
Parameter percent
Data-type NUMBER
Required
Description The percentage of total selected transaction line value to be adjusted. Default: None Validation: Ignored unless amount_mode = 'P' in which case it must have a value. Must be =< percentage of total value of selected lines represented by recognized revenue for selected lines, and salesperson (if specified). Errors: AR_RA_PCT_EXCEEDS_AVAIL_PCT AR_RA_ZERO_AMOUNT
line_selection_mode
VARCHAR2(15)
The line selection mode determines how lines were selected for adjustment. Possible values are:
Default: 'A' Validation: Must be one of the above values Error: AR_RA_INVALID_LINE_MODE from_category_id NUMBER(15)
The ID of the item category used to identify the lines to be adjusted. Default: None Validation: Must be a valid category ID, and there must be lines on the transaction that have items belonging to this category. Must be specified if line selection mode = 'C'. Errors: AR_RA_NO_FROM_CATEGORY AR_RA_INVALID_CATEGORY_ID AR_RA_CATEGORY_NOT_ON_TRX
Data-type VARCHAR2(40)
Required
Description Segments 1 to 20 of the category flexfield Default: None Validation: Ignored if from_category_id has a value. Enough segment values to uniquely identify a category must be passed - ideally all defined segments. Otherwise, validation is the same as for from_category_id. Error: AR_RA_INVALID_CAT_SEGMENTS
NUMBER(15) VARCHAR2(40)
Not currently used and should be left null. Not currently used and should be left null.
NUMBER(15)
The ID of the inventory item used to identify the lines to be adjusted. Default: None Validation: Must be a valid inventory item ID and there must be lines on the transaction that have items with this ID. Must be specified if line selection mode = 'I'. Errors: AR_RA_NO_FROM_ITEM AR_RA_INVALID_ITEM_ID AR_RA_ITEM_NOT_ON_TRX
from_item_segment1 -from_item_segment20
VARCHAR2(40)
Segments 1 to 20 of the item flexfield Default: None Validation: Ignored if from_inventory_item_id has a value. Enough segment values to uniquely identify an item must be passed ideally all defined segments. Otherwise, validation is the same as for from_inventory_item_id. Error: AR_RA_INVALID_ITEM_SEGMENTS
to_inventory_item_id
NUMBER(15)
Data-type VARCHAR2(40)
Required
NUMBER(15)
The ID of the transaction line to be adjusted. Default: None Validation: Must be a valid line ID on the transaction. Must be specified if line selection mode = 'S' and from_line_number is null. Errors: AR_RA_NO_FROM_LINE AR_RA_INVALID_LINE_ID
from_line_number
NUMBER(15)
The user visible transaction line number. Default: None Validation: Ignored if from_cust_trx_line_id has a value. Must be a valid line number on the transaction. Errors: AR_RA_NO_FROM_LINE AR_RA_LINE_NOT_ON_TRX
Parameter gl_date
Data-type DATE
Required
Description Date that adjusted revenue will be posted to the general ledger if revenue is recognized immediately. Start date of revenue recognition if revenue is deferred. Default: Gets defaulted to the current date if it is a valid gl_date. Validation: Ignored for lines that have non-deferred accounting rules AND a duration > 1. It is valid if the following conditions are true:
The date is in an Open or Future period, or it is in a Never Opened period and the Allow Not Open Flag is set to Yes. The date is greater than or equal to the trx_date The period cannot be an Adjustment period.
If the date passed is not valid, then a warning message is written to the stack and the date is automatically overridden with a valid date using the default:
If the most recent open period is prior to the current date: last date of that period If there is a period open after the current date: first date of the last open period
Warning: AR_RA_GL_DATE_CHANGED reason_code VARCHAR2(15) Yes Lookup code for revenue adjustment reason Default: None Validation: Must be defined under AR lookup type 'REV_ADJ_REASON' Error: AR_RA_INVALID_REASON_CODE
Parameter comments
Required
attribute_category
VARCHAR2(30)
Context of the revenue adjustment descriptive flexfield. Default: None Validation: None
attribute1 - attribute15
VARCHAR2(150)
Attributes of the revenue adjustment descriptive flexfield Default: None Validation: Standard descriptive flexfield validation
Example
Objective: To unearn all revenue on a transaction using a call to AR_RevenueAdjust_PUB.Unearn_Revenue and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_init_msg_list p_rev_adj_rec.trx_number p_rev_adj_rec.reason_code Entered Value 2.0 FND_API.G_TRUE 'test_api_1' 'RA' Default Value
This table lists the defaulted input parameters, which were not entered:
Entered Value
SYSDATE
After execution of this API, the calling program retrieves the warnings and the error messages, put on the message stack by the API, in the following manner: The warnings and the error messages put on the message stack by the API are retrieved after the execution of this API by the calling program, in the following manner:
IF l_msg_count = 1 Then --there is one message raised by the API, so it has been sent out --in the parameter x_msg_data, get it. l_msg_data_out := l_msg_data; ELSIF l_msg_count > 1 Then --the messages on the stack are more than one so call them in a loop -- and put the messages in a PL/SQL table. loop count := count +1 ; l_mesg := FND_MSG_PUB.Get; If l_mesg IS NULL Then EXIT; else Mesg_tbl(count).message := l_mesg; End if; end loop; END IF;
Depending on the message level threshold set by the profile option FND_API_MSG_LEVEL_THRESHOLD, the messages put on the message stack may contain both the error messages and the warnings. Result: All revenue on this transaction was unearned by specifying only four input parameters in the call to this API.
AR_RevenueAdjust_PUB.Earn_Revenue
Call this routine to move revenue from the unearned revenue account to the earned revenue account using AutoAccounting. This API routine has 4 input and 5 output parameters in total and is almost exactly the same as the Unearn_Revenue routine described above in AR_RevenueAdjust_PUB.Unearn_Revenue, page 9-2. The following is the breakdown of the parameters:
Input
Standard API parameters: 3 Revenue Adjustment parameters: 1 (revenue adjustment record type)
Output
Standard API parameters: 3 Revenue Adjustment parameters: 2
Parameter Descriptions
For a description of this routine's standard parameters, see AR_RevenueAdjust_PUB.Unearn_Revenue, page 9-2. The Rev_Adj_Rec_Type elements that are relevant to Earn_Revenue are exactly the same as already listed in AR_RevenueAdjust_PUB.Unearn_Revenue, with the following exceptions listed in this table:
Parameter to_salesrep_id Data-type NUMBER Required Description Not used for earning revenue and should be left null. Not used for earning revenue and should be left null. Not used for earning revenue and should be left null. Not used for earning revenue and should be left null.
to_salesrep_number
VARCHAR2
to_salesgroup_id
sales_credit_type
Example
Objective:
To earn all revenue on a transaction using a call to AR_RevenueAdjust_PUB.Earn_Revenue and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_init_msg_list p_rev_adj_rec.trx_number p_rev_adj_rec.reason_code Entered Value 2.0 FND_API.G_TRUE 'test_api_1' 'RA' Default Value
This table lists the defaulted input parameters, which were not entered:
Parameter p_rev_adj_rec.amount_mode p_rev_adj_rec.line_selection_ mode p_rev_adj_rec.gl_date Entered Value Default Value 'T' 'A'
SYSDATE
The warnings and the error messages put on the message stack by the API are retrieved after the execution of this API by the calling program, as described in Example, page 914. Result: All revenue on this transaction was earned by specifying only four input parameters in the call to this API.
AR_RevenueAdjust_PUB.Transfer_Sales_Credits
Call this routine to transfer sales credits from any salesperson with sales credits on the transaction to any other salesperson. In addition, if revenue sales credits are transferred, then the associated revenue is transferred between cost centers if the AutoAccounting rules call the salesperson table and the cost center segment is derived from the salesperson. This API routine has 4 input and 5 output parameters in total and is similar to the Unearn_Revenue routine described above in AR_RevenueAdjust_PUB.Unearn_Revenue, page 9-2. The following is the breakdown of the parameters:
Input
Standard API parameters: 3 Revenue Adjustment parameters: 1 (revenue adjustment record type)
Output
Standard API parameters: 3 Revenue Adjustment parameters: 2
Parameter Descriptions
For a description of this routine's standard parameters, see AR_RevenueAdjust_PUB.Unearn_Revenue, page 9-2. The Rev_Adj_Rec_Type elements that are relevant to Transfer_Sales_Credits are the same as already listed in AR_RevenueAdjust_PUB.Unearn_Revenue, with the following exceptions/additions listed in this table.
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported.
Parameter from_salesrep_id
Data-type NUMBER(15)
Required
Description The ID of the salesperson from whom sales credits are being transferred. Default: Null Validation: If specified, must exist, must be currently active, and must have been active on transaction date. Must have revenue sales credits on at least one line on the transaction. If neither from_salesrep_id nor from_salesrep_number are specified, sales credits of the specified type are transferred belonging to all salesreps on the transaction (i.e. null = all). Error: AR_TAPI_INVALID_SALESREP_ID AR_RA_SALESREP_NOT_ON_TRX
from_salesrep_number
The user visible number of the salesperson from whom sales credits are being transferred. Validation: Ignored if from_salesrep_id is specified. Otherwise, validation is as for from_salesrep_id. Error: AR_RA_INVALID_SALESREP_NUMBER
to_salesrep_id
NUMBER(15)
The ID of the salesperson to whom sales credits are being transferred. Validation: If specified, must exist, and must be currently active and must have been active on transaction date. Errors: AR_TAPI_INVALID_SALESREP_ID AR_RA_NO_TO_SALESREP
to_salesrep_number
The user visible number of the salesperson to whom sales credits are being transferred. Validation: Ignored if to_salesrep_id is specified. Otherwise, validation is as for to_salesrep_id. Error: AR_RA_INVALID_SALESREP_NUMBER
Parameter from_salesgroup_id
Required
Description The ID of the sales group of the salesperson from whom sales credits are being transferred. Default: Null Validation: Must have sales credits (of the type being transferred) on at least one line on the transaction. If FROM_SALESGROUP_ID is not specified, then all sales credits of the specified type for the chosen salesperson are transferred (ie. null = all). Error: AR_RA_SALESREP_NOT_ON_TRX
to_salesgroup_id
jtf_rs_groups_b. group_id%TYP E
The ID of the sales group of the salesperson to whom sales credits are being transferred. Validation: If specified, then must exist and must be currently active. Salesperson must have been an active member of this group at some time between:
the earliest of the transaction date and any parent commitment/invoice dates, and the latest of the current date, transaction date, and any parent commitment/invoice dates.
Error: AR_INVALID_SALESGROUP_ID
Parameter sales_credit_type
Data-type VARCHAR2(15 )
Required Yes
Example
Objective: To transfer all revenue sales credits on a transaction from a salesperson to a new salesperson using a call to AR_RevenueAdjust_PUB.Transfer_Sales_Credits and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_init_msg_list p_rev_adj_rec.trx_number p_rev_adj_rec.from_salesrep_ number Entered Value 2.0 FND_API.G_TRUE 'test_api_1' '101' Default Value
Default Value
'RA'
This table lists the defaulted input parameters, which were not entered:
Parameter p_rev_adj_rec.amount_mode p_rev_adj_rec.sales_credit_ty pe p_rev_adj_rec.line_selection_ mode p_rev_adj_rec.gl_date Entered Value Default Value 'T' 'R'
'A'
SYSDATE
The warnings and the error messages put on the message stack by the API are retrieved after execution of this API by the calling program, as described in Example, page 9-14. Result: All revenue sales credits on this transaction belonging to salesperson 101 were transferred to salesperson 299 by specifying only six input parameters in the call to this API. Additionally, all associated revenue was transferred between corresponding cost centers. Note that if salesrep number 101 was the only salesperson with revenue sales credits on this transaction, then from_salesrep_number could have been omitted. This is because no specified salesperson means all salespersons, thereby cutting the required number of parameters to five.
AR_RevenueAdjust_PUB.Add_Non_Revenue_Sales_Credits
Call this routine to add non-revenue sales credits to any existing or new salesperson on a transaction. This does not involve a transfer of revenue. This API routine has 4 input and 5 output parameters in total and is similar to the Unearn_Revenue routine described in AR_RevenueAdjust_PUB.Unearn_Revenue, page 9-2. The following is the breakdown of the parameters:
Input
Standard API parameters: 3 Revenue Adjustment parameters: 1 (revenue adjustment record type)
Output
Standard API parameters: 3 Revenue Adjustment parameters: 2
Parameter Descriptions
For a description of this routine's standard parameters, see AR_RevenueAdjust_PUB.Unearn_Revenue, page 9-2. The Rev_Adj_Rec_Type elements that are relevant to Add_Non_Revenue_Sales_Credits are the same as already listed in AR_RevenueAdjust_PUB.Unearn_Revenue, with the following exceptions/additions listed in this table:
Note: If required parameters are not passed in a call to this API, then
the call will fail. However, depending on the business scenario, you will have to pass in values for other parameters to successfully create the business object. Otherwise, error messages will be reported. At least one of the numbered sets of parameters is required.
Parameter from_salesrep_id
Data-type NUMBER(15)
Required
Description Not applicable in this context and should be left null. Not applicable in this context and should be left null.
from_salesrep_number
ra_salesreps.salesrep_num ber%TYPE
Parameter to_salesrep_id
Data-type NUMBER(15)
Required 2
Description The ID of the salesperson to whom non-revenue sales credits are being added. Validation: If specified, must exist, and must be currently active and must have been active on transaction date. Errors: AR_TAPI_INVALID_SALESREP_ID AR_RA_NO_TO_SALESREP
to_salesrep_number
ra_salesreps.salesrep_num ber%TYPE
The user visible number of the salesperson to whom sales credits are being transferred. Validation: Ignored if to_salesrep_id is specified. Otherwise, validation is as for to_salesrep_id. Error: AR_RA_INVALID_SALESREP_NUM BER
from_salesgroup_id
jtf_rs_groups_b.group_id %TYPE
Parameter to_salesgroup_id
Required
Description The ID of the sales group of the salesperson to whom nonrevenue sales credits are being added. Validation: If specified, then must exist and must be currently active. Salesperson must have been an active member of this group at some time between:
the earliest of the transaction date and any parent commitment/invoice dates, and the latest of the current date, transaction date, and any parent commitment/invoice dates.
Not applicable in this context and should be left null. The amount mode specifies whether an amount, a percentage (of total value of selected lines) is to be adjusted. Possible values are:
amount_mode
VARCHAR2(15)
A - amount P - percent
Default: 'T', or all adjustable revenue is not applicable in this context. Validation: Must be one of the above values (A or P). Error: AR_RA_INVALID_AMOUNT_MOD E
Example
Objective:
To add 50% of the total transaction value in non-revenue sales credits to a new salesperson on a transaction, using a call to AR_RevenueAdjust_PUB.Add_Non_Revenue_Sales_Credits and passing a minimum number of input parameters. This table lists the entered parameters:
Parameter p_api_version p_init_msg_list p_rev_adj_rec.trx_number p_rev_adj_rec.to_salesrep_nu mber p_rev_adj_rec.amount_mode p_rev_adj_rec.percent p_rev_adj_rec.reason_code Entered Value 2.0 FND_API.G_TRUE 'test_api_1' '299' Default Value
'P' 50 'RA'
This table lists the defaulted input parameters, which were not entered:
Parameter p_rev_adj_rec.line_selection_ mode p_rev_adj_rec.gl_date Entered Value Default Value 'A'
SYSDATE
AR_RevenueAdjust_PUB.Add_Non_Revenue_Sales_Credits( p_api_version => 2.0, p_init_msg_list => FND_API.G_TRUE, p_rev_adj_rec.trx_number => 'test_api_1', p_rev_adj_rec.to_salesrep_number => '299' p_rev_adj_rec.amount_mode => 'P', p_rev_adj_rec.percent => 50, p_rev_adj_rec.reason_code => 'RA', x_return_status => l_return_status, x_msg_count => l_msg_count, x_msg_data => l_msg_data, x_adjustment_id => l_adjustment_id, x_adjustment_number => l_adjustment_number);
The warnings and the error messages put on the message stack by the API are retrieved after execution of this API by the calling program, as described in Example, page 9-14. Result: Non-revenue sales credits were added to salesperson 299 on this transaction by specifying only seven input parameters in the call to this API.
Messages
Messages play an important role in the effectiveness of API calls. The right message is raised at the right point to convey the exact error that has occurred or any warnings that have been raised. In the Revenue Adjustment API, all error messages and warnings raised during execution are put on the message stack and can be retrieved by the user as described in Exception Handling and Result Messages, page 1-3.
AR_INVALID_SALESGROUP_ID
MESSAGE TEXT The amount entered is greater than &TOT_AVAIL_REV, the total available revenue on the lines selected
DESCRIPTION This message is generated by the revenue adjustment API when there is insufficient adjustable revenue on the selected transaction lines to meet the specified amount.
TYPE E
AR_RA_BR_DISALLOWED
Revenue cannot be adjusted on bills receivable There are no lines with items for category ID &CATEGORY_ID on this transaction. Revenue cannot be adjusted on chargebacks Revenue cannot be adjusted on deposits. Revenue cannot be adjusted on debit memos or debit memo reversals One or more credit memos have been applied for the full amount of this invoice GL date, &GL_DATE, is not in an open or future-enterable period. GL date has been changed to &NEW_GL_DATE Revenue cannot be adjusted on guarantees. Amount mode &AMOUNT_MODE is invalid. This combination of category segments is invalid: &CONCAT_SEGS.
AR_RA_CATEGORY_NOT_ON_T RX
AR_RA_CB_DISALLOWED
AR_RA_DEP_DISALLOWED
AR_RA_DM_DISALLOWED
AR_RA_FULL_CREDIT
AR_RA_GL_DATE_CHANGED
AR_RA_GUAR_DISALLOWED
MESSAGE TEXT A valid category to which items belong that are currently on one or more lines on this transaction must be entered Category ID &CATEGORY_ID is invalid. An error occurred while generating the following accounting flexfield code combination: &CODE_COMBINATION
DESCRIPTION
TYPE E
AR_RA_INVALID_CATEGORY_I D AR_RA_INVALID_CODE_COMB
This message is generated by the revenue adjustment API because of an error with the specified accounting flexfield code combination. Possible causes: segment values could not be found by AutoAccounting or have been disabled.
AR_RA_INVALID_ITEM
A valid item that is currently on one or more lines on this transaction must be entered Inventory item ID &ITEM_ID is invalid. This combination of item segments is invalid: &CONCAT_SEGS. Transaction line ID &CUST_TRX_LINE_ID is invalid. Line selection mode &LINE_MODE is invalid. Reason code &REASON_CODE is not a valid lookup code. Sales credit type &SALESCRED_TYPE is invalid.
AR_RA_INVALID_ITEM_ID
AR_RA_INVALID_ITEM_SEGME NTS
AR_RA_INVALID_LINE_ID
AR_RA_INVALID_LINE_MODE
AR_RA_INVALID_REASON
AR_RA_INVALID_SALESCRED_ TYPE
MESSAGE TEXT Salesperson number &SALESREP_NUMBER is invalid. There are no lines with item &ITEM_ID on this transaction. There are no lines with line number &LINE_NUMBER on this transaction. There is no earned revenue on this transaction
DESCRIPTION
TYPE E
AR_RA_ITEM_NOT_ON_TRX
AR_RA_LINE_NOT_ON_TRX
AR_RA_NO_EARNED_REVENU E
This message is generated by the revenue adjustment API when there is no earned revenue on the selected transaction lines.
Please provide a from-category. Please provide a from-item. Please provide a from-line. The transaction date must fall during an open period or prior to a future period
This message is generated by the revenue adjustment API because there are no open or future periods relating to the transaction date or following the transaction date. Revenue cannot be posted to periods prior to the transaction date. This message is generated by the revenue adjustment API when a transaction line with no sales credits is encountered. This message is generated by the revenue adjustment API when there is no adjustable revenue on the selected transaction lines.
E E E E
AR_RA_NO_REV_SALES_CREDI T
AR_RA_NO_REV_TO_ADJUST
MESSAGE TEXT There are no sales credits for this line selection available to transfer Please provide a valid salesperson number or ID for sales credit transfers or additions. Please provide a valid transaction number or ID. There is no unearned revenue on this transaction
DESCRIPTION
TYPE E
AR_RA_NO_TO_SALESREP
AR_RA_NO_TRX_NUMBER
AR_RA_NO_UNEARNED_REVE NUE
This message is generated by the revenue adjustment API when there is no unearned revenue on the selected transaction lines.
AR_RA_PARTIAL_CREDIT
One or more partial credit memos have been applied against this invoice The percentage entered is greater than &TOT_AVAIL_PCT, the total available percentage of adjustable revenue on the lines selected Revenue and non-revenue sales credits exceed &SALES_CREDIT_LIMIT percent for salesperson &SALESREP_NAME on line &LINE_NUMBER
AR_RA_PCT_EXCEEDS_AVAIL_ PCT
This message is generated by the revenue adjustment API when there is insufficient adjustable revenue on the selected transaction lines to meet the specified percentage. This message is generated by the revenue adjustment API when the total percentage of revenue and non-revenue sales credits per salesperson per line exceeds the limit specified in system options.
AR_RA_SALES_CREDIT_LIMIT
AR_RA_SALESREP_NOT_ON_TR X
Salesperson &SALESREP_NAME does not have any sales credits on this transaction. Transaction number &TRX_NUMBER cannot be found.
AR_RA_TRX_NOTFOUND
MESSAGE TEXT There is more than one transaction with the transaction number &TRX_NUMBER. Please also provide a batch source to ensure uniqueness of the transaction. Amount entered cannot be zero
DESCRIPTION
TYPE E
AR_RA_ZERO_AMOUNT
This message is generated by the revenue accounting API when attempting to adjust an amount of zero.
AR_RAPI_DESC_FLEX_INVALID
The entered values for the descriptive flexfield &DFF_NAME is invalid. Revenue sales credit not equal to line amount or 100% for line &LINE_NUMBER. Transaction does not exist. (CUSTOMER_TRX_ID: &CUSTOMER_TRX_ID). Invalid salesrep id. (SALESREP_ID: &SALESREP_ID)
AR_TW_INCORRECT_SALESCR EDIT
AR_TAPI_TRANS_NOT_EXIST
AR_TAPI_INVALID_SALESREP_I D
A
Predefined Setup for Oracle Subledger Accounting
This appendix covers the following topics: Data that Oracle Receivables Predefines for Oracle Subledger Accounting
The following sections describe the data that Receivables predefines in Subledger Accounting: Applications, page A-2 Event Entities, page A-3 Event Classes and Event Types, page A-3 Process Categories, page A-4
Accounting Event Class Options, page A-4 Sources, Source Assignments, and Accounting Attribute Assignments, page A-5 Journal Line Types, page A-6 Account Derivation Rules, page A-12 Journal Lines Definitions, page A-13 Application Accounting Definitions, page A-15 Subledger Accounting Methods, page A-17
Applications
Oracle Receivables predefines one application in Oracle Subledger Accounting named Receivables. Most of the data that Oracle Receivables predefines for Oracle Subledger Accounting is associated with the Receivables application. The following table shows the attribute values that Oracle Receivables predefines for the Receivables application. The first column lists the fields and the second column lists the values for each field.
Predefined Receivables Application Field Application Name Drilldown Procedure Use Security Policy Function Journal Source Third Party Control Account Type Subject to Validation Calculate Reporting Currency Amounts Value Receivables AR_DRILLDOWN_PUB_PKG.DRILLDOWN Yes XLA_SECURITY_POLICY_PKG.MO_POLICY Receivables Customer No Yes
Event Entities
The following table lists the setup information that Oracle Receivables predefines for the event entities.
Predefined Event Entities Application Entity Name Description Gapless Event Processing No No No No
Process Categories
Oracle Receivables predefines the following process categories: Adjustments Bills Receivable Miscellaneous Receipts Standard Receipts Third Party Merge Transactions
AR_ADJ_INF_V AR_TRX_INF_V
Actual Actual
Event Class
Process Category
Transaction View
Balance Types
Miscellaneous Receipt Receipt Chargeback Credit Memo Debit Memo Deposit Guarantee Invoice
Miscellaneous Receipts Standard Receipts Transactions Transactions Transactions Transactions Transactions Transactions
AR_CR_INF_V
Actual
Receipts Chargebacks Credit Memos Debit Memos Sales Invoices Sales Invoices Sales Invoices
assignments, or accounting attribute assignments. However, you can define your own custom sources. If you choose to define your own journal line types or application accounting definitions, then you can override the default accounting attribute assignments.
Oracle Receivables provides numerous predefined sources. When you use the Sources window to review the predefined sources, you can optionally export the queried sources from the application to a Microsoft Excel spreadsheet. To export a list of sources:
1. 2. 3. 4.
From an Oracle Receivables responsibility, navigate to the Sources window. Query the records you want to export. Place your cursor in the multi-row block that contains the records to be exported. Choose Export from the File menu.
Adjustment Adjustment
Actual Actual
Credit Credit
Adjustment Adjustment
Actual Actual
Credit Credit
Adjustment
Actual
Credit
Event Class Bills Receivable Bills Receivable Bills Receivable Bills Receivable Chargeback
Name Bills Receivable Receivable Bills Receivable Remittance Bills Receivable Tax Bills Receivable Unpaid Chargeback Default Receivable Chargeback Revenue Credit Memo Default Deferred Tax Application Credit Memo Default Application Credit Memo Default Tax Application Credit Memo Refund Application Credit Memo Charges Credit Memo Default Receivable Credit Memo Default Revenue Credit Memo Default Tax Credit Memo Rounding Credit Memo Unbilled Receviable
Actual Actual
Credit Credit
Credit Memo
Actual
Credit
Credit Memo
Actual
Credit
Credit Memo
Actual
Credit
Actual Actual
Credit Debit
Credit Memo
Actual
Credit
Name Credit Memo Deferred Revenue Debit Memo Charges Debit Memo Default Receivable Debit Memo Freight Debit Memo Revenue Debit Memo Rounding Debit Memo Tax Debit Memo Unbilled Receivable Debit Memo Deferred Revenue Deposit Default Receivable Deposit Offset Guarantee Default Receivable Guarantee Revenue Invoice Charges Invoice Default Receivable Invoice Freight Invoice Revenue Invoice Rounding
Side Credit
Actual Actual
Credit Debit
Debit Memo Debit Memo Debit Memo Debit Memo Debit Memo
Debit Memo
Actual
Credit
Name Invoice Tax Invoice Unbilled Receivable Invoice Deferred Revenue Miscellaneous Receipt Bank Charges Miscellaneous Receipt Cleared Cash Miscellaneous Receipt Confirmed Cash Miscellaneous Receipt Short Term Debt Miscellaneous Receipt Factored Cash Miscellaneous Receipt Miscellaneous Cash Miscellaneous Receipt Remitted Cash Miscellaneous Receipt Tax Receipt On Account Application Receipt Application to Freight Receipt Application to Revenue Receipt Application to Rounding
Miscellaneous Receipt
Actual
Credit
Miscellaneous Receipt
Actual
Credit
Miscellaneous Receipt
Actual
Credit
Miscellaneous Receipt
Actual
Credit
Miscellaneous Receipt
Actual
Credit
Miscellaneous Receipt
Actual
Credit
Actual Actual
Credit Credit
Receipt Receipt
Actual Actual
Credit Credit
Receipt
Actual
Credit
Name Receipt Application to Suspense Revenue Receipt Application to Tax Receipt Application to Unbilled Revenue Receipt Application to Earned Revenue Receipt Bank Charges Receipt Cleared Cash Receipt Credit Card Chargeback Application Receipt Chargeback Application Receipt Claim Investigation Application Receipt Confirmed Cash Receipt Currency Rounding Receipt Short Term Debt Receipt Default Application Receipt Deferred Tax Receipt Earned Discount Receipt Earned Discount on Freight Receipt Earned Discount Non-Recoverable Tax
Side Credit
Receipt Receipt
Actual Actual
Credit Credit
Receipt
Actual
Credit
Receipt
Actual
Credit
Receipt
Actual
Credit
Receipt
Actual
Credit
Name Receipt Earned Discount on Revenue Receipt Earned Discount on Tax Receipt Exchange Gain Receipt Exchange Gain Loss Receipt Exchange Loss Receipt Factored Cash Receipt Factored Bills Receivable Receipt Payment Netting Application Receipt Prepayment Application Receipt Refund Application Receipt Remitted Cash Receipt Remitted Bills Receivable Receipt Tax Receipt Unapplied Cash Unapplied Cash Receipt Unapplied for Gain Loss lines Receipt Unearned Discount
Side Debit
Receipt
Actual
Debit
Receipt
Actual
Credit
Receipt
Actual
Credit
Receipt
Actual
Credit
Name Receipt Unearned Discount on Freight Receipt Unearned Discount on Non Recoverable Tax Receipt Unearned Discount on Revenue Receipt Unearned Discount on Tax Receipt Unidentified Cash Receipt Write-Off Application
Side Debit
Receipt
Actual
Credit
Receipt
Actual
Debit
Receipt
Actual
Debit
Receipt Receipt
Actual Actual
Credit Credit
Discount Endorsement Account Collection Bank Factoring Charges Account Distribution GL Account Remit Bank Unapplied account System Gain GL Account System Loss GL Account Transaction Distribution GL Account Transaction Distribution GL Account with reference
Bills Receivable
Chargeback
Journal Line Types Credit Memo Charges, Credit Memo Default Application, Credit Memo Default Deferred Tax Application, Credit Memo Default Receivable, Credit Memo Default Revenue, Credit Memo Default Tax, Credit Memo Default Tax Application, Credit Memo Deferred Revenue, Credit Memo Refund Application, Credit Memo Rounding, Credit Memo Unbilled Receviable Debit Memo Charges, Debit Memo Default Receivable, Debit Memo Deferred Revenue, Debit Memo Freight, Debit Memo Revenue, Debit Memo Rounding, Debit Memo Tax, Debit Memo Unbilled Receivable Deposit Default Receivable, Deposit Offset Guarantee Default Receivable, Guarantee Revenue Invoice Charges, Invoice Default Receivable, Invoice Deferred Revenue, Invoice Freight, Invoice Revenue, Invoice Rounding, Invoice Tax, Invoice Unbilled Receivable Miscellaneous Receipt Bank Charges, Miscellaneous Receipt Cleared Cash, Miscellaneous Receipt Confirmed Cash, Miscellaneous Receipt Factored Cash, Miscellaneous Receipt Miscellaneous Cash, Miscellaneous Receipt Remitted Cash, Miscellaneous Receipt Short Term Debt, Miscellaneous Receipt Tax
Debit Memo
Miscellaneous Receipt
Miscellaneous Receipts
Journal Line Types Receipt Bank Charges, Receipt Chargeback Application, Receipt Claim Investigation Application, Receipt Cleared Cash, Receipt Confirmed Cash, Receipt Credit Card Chargeback Application, Receipt Currency Rounding, Receipt Default Application, Receipt Deferred Tax, Receipt Earned Discount, Receipt Earned Discount Non-Recoverable Tax, Receipt Exchange Gain Loss, Receipt Factored Bills Receivable, Receipt Factored Cash, Receipt On Account Application, Receipt Payment Netting Application, Receipt Prepayment Application, Receipt Refund Application, Receipt Remitted Bills Receivable, Receipt Remitted Cash, Receipt Short Term Debt, Receipt Tax, Receipt Unapplied Cash, Receipt Unearned Discount, Receipt Unearned Discount on Non Recoverable Tax, Receipt Unidentified Cash, Receipt Write-Off Application, Unapplied Cash Receipt Application to Earned Revenue, Receipt Application to Freight, Receipt Application to Revenue, Receipt Application to Rounding, Receipt Application to Suspense Revenue, Receipt Application to Tax, Receipt Application to Unbilled Revenue, Receipt Bank Charges, Receipt Claim Investigation Application, Receipt Cleared Cash, Receipt Confirmed Cash, Receipt Currency Rounding, Receipt Earned Discount, Receipt Earned Discount on Freight, Receipt Earned Discount on Revenue, Receipt Earned Discount on Tax, Receipt Exchange Gain Loss, Receipt Factored Bills Receivable, Receipt Factored Cash, Receipt On Account Application, Receipt Payment Netting Application, Receipt Prepayment Application, Receipt Refund Application, Receipt Remitted Bills Receivable, Receipt Remitted Cash, Receipt Short Term Debt, Receipt Unapplied Cash, Receipt Unapplied for Gain Loss lines, Receipt Unearned Discount, Receipt Unearned Discount on Freight, Receipt Unearned Discount on Revenue, Receipt Unearned Discount on Tax, Receipt Unidentified Cash, Receipt Write-Off Application, Unapplied Cash
Receipt
accounting definition that Oracle Receivables predefines for the Receivables application.
Assignments for the Predefined Receivables Default Accrual Application Accounting Definition Event Class Assignments Adjustment Bills Receivable Event Type Assignments All All Create Accounting Yes Yes Journal Line Definition Assignments Adjustments - Default Accrual Receivables Bills Journal Lines Definition Chargebacks - Default Accrual Credit Memos - Default Accrual Debit Memos - Default Accrual Deposits - Default Accrual Guarantees - Default Accrual Invoices - Default Accrual Miscellaneous Receipts
Chargeback Credit Memo Debit Memo Deposit Guarantee Invoice Miscellaneous Receipt Receipt
All
Yes
The following table lists the assignments for the Receivables Default Cash Basis Accounting Definition application accounting definition that Oracle Receivables predefines for the Receivables application.
Assignments for the Predefined Receivables Default Cash Basis Accounting Definition Application Accounting Definition Event Class Assignments Adjustment Bills Receivable Event Type Assignments All All Create Accounting No No Journal Line Definition Assignments
Event Class Assignments Chargeback Credit Memo Debit Memo Deposit Guarantee Invoice Miscellaneous Receipt Receipt
Event Type Assignments All All All All All All All
Miscellaneous Receipts
All
Yes
B
Oracle Receivables Table and Column Descriptions
This appendix covers the following topics: AutoInvoice Table and Column Descriptions Lockbox Table and Column Descriptions
Interface Tables
RA_INTERFACE_LINES_ALL, page B-1 RA_INTERFACE_SALESCREDITS_ALL, page B-50 RA_INTERFACE_DISTRIBUTIONS_ALL, page B-54 AR_INTERFACE_CONTS_ALL, page B-59 RA_INTERFACE_ERRORS_ALL, page B-60
and Reference information when importing invoices. For more information, see: Transaction Flexfields, Oracle Receivables User Guide.
ACCOUNTING_RULE_DURATION
Enter the accounting rule duration for this transaction. If LINE_TYPE = 'LINE' or you are passing header freight, and this transaction uses a variable duration accounting rule, you must enter a value in this column. If LINE_TYPE = 'TAX' ', 'CHARGES' or you are passing freight for a specific line, do not enter a value in this column. For credit memos and on-account credits, do not enter a value in this column.
Validation:
Accounting periods must be defined for the duration of the accounting rule in GL_PERIODS and RA_INTERFACE_LINES_ALL.GL_DATE and RA_INTERFACE_LINES_ALL.RULE_START_DATE must be in a period that has a status of 'Open' or 'Future'. The value in this column must be a positive integer. RA_CUSTOMER_TRX_LINES_ALL.ACCOUNTING_RUL E_DURATION
Destination:
ACCOUNTING_RULE_ID
Enter the accounting rule ID for this transaction. If LINE_TYPE = 'LINE' or you are passing header freight, this column is optional. For invoice lines with rules, you must enter either a value in this column or in ACCOUNTING_RULE_NAME, depending on the value you entered for your batch source. If you entered a value in ACCOUNTING_RULE_NAME, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX', 'CHARGES' or you are passing freight for a specific line, do not enter a value in this column. For credit memos, do not enter a value in this column; AutoInvoice uses the accounting rule from the transaction you are crediting.
Validation:
Must exist in RA_RULES.RULE_ID and RA_RULES.TYPE = 'A' or 'ACC_DUR'. If LINE_TYPE = 'CHARGES', then this column must be null. RA_CUSTOMER_TRX_LINES_ALL.ACCOUNTING_RUL E_ID
Destination:
ACCOUNTING_RULE_NAME
Enter the accounting rule name for this transaction.
If LINE_TYPE = 'LINE' or you are passing header freight, this column is optional. For invoice lines with rules, you must enter either a value in this column or in ACCOUNTING_RULE_ID, depending on the value you entered for your batch source. If LINE_TYPE = 'TAX,' 'CHARGES,' or if you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the accounting rule from the transaction you are crediting.
Validation:
Must exist in RA_RULES.NAME and RA_RULES.TYPE = 'A' or 'ACC_DUR'. If LINE_TYPE = 'CHARGES', then this column must be null. None
Destination:
ACCTD_AMOUNT
Do not enter a value. Receivables does not currently use this column.
Validation: Destination:
None None
AGREEMENT_NAME
Enter the name of the customer agreement for this transaction. If LINE_TYPE = 'LINE', 'CHARGES' or you are passing header freight, this column is optional. Depending on the value you entered for your batch source, you can enter either a value in this column or in AGREEMENT_ID. For invoice lines against a commitment, AutoInvoice will default the agreement from the commitment if AGREEMENT_NAME and AGREEMENT_ID are null and a agreement exists for the commitment. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos, do not enter a value in this column, AutoInvoice uses the customer agreement from the transaction you are crediting.
Validation: Destination:
AGREEMENT_ID
Enter the customer agreement ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES' or you are passing header freight, this column is optional. Depending on the value you entered for your batch source, you can enter
either a value in this column or in AGREEMENT_NAME. For invoice lines against a commitment, AutoInvoice will default the agreement from the commitment if AGREEMENT_NAME and AGREEMENT_ID are null and a agreement exists for the commitment. If LINE_TYPE = 'TAX' or you are passing freight for a specific line do not enter a value in this column. For credit memos, do not enter a value in this column, AutoInvoice uses the customer agreement from the transaction you are crediting.
Validation: Destination:
AMOUNT
Enter the revenue amount for this transaction. If LINE_TYPE = 'LINE' and this transaction is neither a freight-only nor a tax-only line, you must enter a value in this column. If this transaction is a dummy line for freight-only or tax-only, do not enter a value in this column. AutoInvoice ignores any values you enter in this column if this transaction is a dummy line. If LINE_TYPE = 'TAX', a value must be entered in either this column or the tax_rate column. Any exemptions must be factored into either of the two columns. If LINE_TYPE = 'FREIGHT' and you are passing either header freight or freight for a specific line, you must enter a value in this column. If LINE_TYPE = 'CHARGES', do not enter a value in this column. If this line has AMOUNT_INCLUDES_TAX set to Yes, the sales credits and line amounts for this column must include tax. For credit memos and on-account credits, enter the credit amount for this transaction.
Validation:
If LINE_TYPE = 'CHARGES', then this column must be null. AutoInvoice will correct revenue amounts that have the wrong currency precision. If Create Clearing is set to No for this transaction batch source (suspense/clearing account not used), RA_CUSTOMER_TRX_LINES_ALL.REVENUE_AMOUNT and RA_CUSTOMER_TRX_LINES_ALL.EXTENDED_AMOUN T. If Create Clearing is set to Yes for this transaction batch source (suspense/clearing account used), RA_CUSTOMER_TRX_LINES_ALL.REVENUE_AMOUNT .
Destination:
AMOUNT_INCLUDES_TAX_FLAG
This column controls whether the amount for this transaction line includes tax. If this column is set to 'Y', this line is assigned to a tax inclusive tax code. If this is a tax group, this column should be null. AutoInvoice only uses this column if the tax code assigned to this line has Allow Override set to Yes for the Tax Inclusive calculation. Populate this column for invoices only. For regular credit memos, AutoInvoice always uses the AMOUNT_INCLUDES_TAX_FLAG value from the invoice that you are crediting.
Validation:
If this is a tax code and Allow Override is set to No, this should be equal to either the setting of the Amount Includes Tax option for this tax code or null. Additionally, if Allow Override is set to No the Amount Includes Tax flag at the line level must equal the Allow Override flag for this tax code. RA_CUSTOMER_TRX_LINES_ALL.AMOUNT_INCLUDE S_TAX_FLAG
Destination:
APPROVAL_CODE
The payment approval code provided by the credit card issuer to indicate funds are available from the user's account.
Validation Destination
None RA_CUSTOMER_TRX_ALL.APPROVAL_CODE
ADDRESS_VERIFICATION_CODE
The credit card address verification code provided by Oracle Payment Server.
Validation Destination
ATTRIBUTE1-15
Enter the Invoice Line Information Flexfield attribute information for this transaction. Descriptive Flexfield attributes allow you to store additional columns, the contents of which you define. These columns are optional.
Validation:
None
Destination:
RA_CUSTOMER_TRX_LINES_ALL.ATTRIBUTE1-15 Note: To ensure that AutoInvoice accurately groups your imported invoices, do not include newline or carriage return characters (chr(10) or chr(13)) in these Descriptive Flexfield columns.
ATTRIBUTE_CATEGORY
Enter the Invoice Line Information Flexfield category information for this transaction. Descriptive Flexfield categories allow you to store different categories of attributes. This column is optional.
Validation: Destination:
BATCH_SOURCE_NAME
Enter the name of the batch source for this transaction. AutoInvoice uses your batch source to determine your transaction and batch numbering method and your AutoInvoice processing options. You must enter a value in this column.
Validation:
Destination:
COMMENTS
Enter comments about this transaction. If LINE_TYPE = 'LINE', 'CHARGES' or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or your are passing freight for a specific line, do not enter text in this column.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.COMMENTS
CONS_BILLING_NUMBER
Enter the number for this consolidated bill. A consolidated bill number is used for grouping a set of invoices under one bill.
Validation:
Destination:
CONVERSION_DATE
Enter the exchange rate date for this transaction. If you do not enter a date, AutoInvoice uses the transaction date as the default. If the currency of the transaction line is the same as the base currency, then leave this column null. If a credit memo is being processed, AutoInvoice uses the conversion date of the invoice that the credit memo is against, and not the credit memo transaction date.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.EXCHANGE_DATE
CONVERSION_RATE
Enter the exchange rate for this transaction. If CONVERSION_TYPE is User, you MUST enter a value in this column; otherwise do not enter a value. If the currency of the transaction is the same as the base currency, enter 'User' and set CONVERSION_RATE to 1.
Validation:
If RA_INTERFACE_LINES_ALL.CONVERSION_TYPE = 'User' then this column must not be null; otherwise, it must be null. RA_CUSTOMER_TRX_ALL.EXCHANGE_RATE
Destination:
CONVERSION_TYPE
Enter the exchange rate type for this transaction. If the currency of the transaction is the same as the base currency, enter 'User' and set CONVERSION_RATE to 1. You must enter a value in this column.
Validation:
Destination:
CREDIT_METHOD_FOR_ACCT_RULE
Enter the credit method for crediting a transaction which uses an accounting rule. Choices include PRORATE, LIFO, or UNIT. If this transaction is a credit memo against a transaction which uses an accounting rule
and LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, you must enter a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. AutoInvoice will ignore any value that you enter in this column. For on-account credits do not enter a value in this column.
Validation: Destination:
CREDIT_METHOD_FOR_INSTALLMENTS
Enter the credit method for crediting a transaction that uses split payment terms. Choices include PRORATE, LIFO, or FIFO. If this transaction is a credit memo against a transaction that uses split payment terms and LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, you may enter a value in this column. If you do not enter a value, AutoInvoice defaults to PRORATE. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. AutoInvoice will ignore any value that you enter in this column. For on-account credits do not enter a value in this column.
Validation: Destination:
CURRENCY_CODE
Enter the currency code for this transaction. You must enter a value in this column. For credit memos ennter the currency code of the invoice you are crediting.
Validation: Destination:
CUSTOMER_BANK_ACCOUNT_ID
Enter the Bill-To customer bank account ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in CUSTOMER_BANK_ACCOUNT_NAME. If you
entered a value in CUSTOMER_BANK_ACCOUNT_NAME, AutoInvoice defaults a value in this column. If the receipt method is of type 'Automatic', and this column is NULL, AutoInvoice will default a value for you. For more details on how AutoInvoice defaults and validates customer banks, see: Passing Receipt Methods and Customer Bank Accounts, Oracle Receivables User Guide. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation:
Must exist in AP_BANK_ACCOUNTS_ALL.BANK_ACCOUNT_ID. If the receipt method is of type 'Manual', RA_INTERFACE_LINES_ALL.CUSTOMER_BANK_ACCO UNT_ID must be NULL.
Destination:
RA_CUSTOMER_TRX_ALL.CUSTOMER_BANK_ACCOU NT_ID
CUSTOMER_BANK_ACCOUNT_NAME
Enter the Bill-To customer bank account name for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in CUSTOMER_BANK_ACCOUNT_ID. If the receipt method is of type 'Automatic' and this column is NULL, AutoInvoice will default a value for you. For more details on how AutoInvoice defaults and validates customer banks, see: Passing Receipt Methods and Customer Bank Accounts, Oracle Receivables User Guide. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation:
AP_BANK_ACCOUNTS_ALL.BANK_ACCOUNT_NAME If the receipt method is of type 'Manual', RA_INTERFACE_LINES_ALL.CUSTOMER_BANK_ACCO UNT_NAME must be NULL.
Destination:
None
CUSTOMER_TRX_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value into this column using your grouping rules.
Validation:
None
Destination:
CUST_TRX_TYPE_ID
Enter the transaction type ID for this transaction. This column is optional, but depending on the value you entered for your batch source you must enter either a value in this column or in CUST_TRX_TYPE_NAME. If you entered a value in CUST_TRX_TYPE_NAME, AutoInvoice defaults a value in this column. For invoice lines against a commitment, AutoInvoice defaults the invoice transaction type from the transaction type of the commitment if CUST_TRX_TYPE_ID and CUST_TRX_TYPE_NAME are null. For credit memos you must enter the ID of the credit memo transaction type which has been assigned to the transaction you are crediting.
Validation:
Destination:
CUST_TRX_TYPE_NAME
Enter the transaction type name for this transaction. This column is optional, but depending on the value you entered for your batch source you must enter either a value in this column or in CUST_TRX_TYPE_ID. For invoice lines against a commitment, AutoInvoice defaults the invoice transaction type from the transaction type of the commitment if CUST_TRX_TYPE_ID and CUST_TRX_TYPE_NAME are null. For credit memos you must enter the name of the credit memo transaction type which has been assigned to the transaction you are crediting.
Validation: Destination:
RA_CUST_TRX_TYPES_ALL.NAME None
DESCRIPTION
This is a required column in AutoInvoice. Enter the description for this transaction.
Validation:
None
Destination:
RA_CUSTOMER_TRX_LINES_ALL.DESCRIPTION
DOCUMENT_NUMBER
Enter the document number for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight and the creation method for the sequence numbering of this transaction is Manual, you must enter a value in this column. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight and the creation method is Automatic, do not enter a value in this column. AutoInvoice will create a unique document number. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation: Destination:
DOCUMENT_NUMBER_SEQUENCE_ID
This column is used by AutoInvoice and should be left null. AutoInvoice uses this column to store the document sequence ID for this transaction.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.DOC_SEQUENCE_ID
EXCEPTION_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value in this column when a tax exception occurs. If your transaction is a credit memo, AutoInvoice defaults the tax exemption ID of the transaction you are crediting.
Validation: Destination:
EXEMPTION_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value in this column when this transaction is partially or fully exempt from tax. For credit memos AutoInvoice defaults the tax exception ID of the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.TAX_EXEMPTION_ID
FOB_POINT
Enter the FOB point for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the FOB point from the transaction you are crediting.
Validation:
Must exist in AR_LOOKUPS.LOOKUP_CODE and AR_LOOKUPS.LOOKUP_TYPE = 'FOB'. Must be less than or equal to 30 characters in length. RA_CUSTOMER_TRX_ALL.FOB_POINT
Destination:
GL_DATE
Enter the general ledger date for this transaction. The GL date determines the accounting period that you record this transaction to your general ledger. If the Post To GL option on the transaction type of the transaction being passed is set to No, the GL_DATE column should be NULL. If LINE_TYPE = 'LINE', 'CHARGES', and you are passing transactions without rules or you are passing header freight, this column is optional. If LINE_TYPE = 'LINE' and you are importing transactions with rules, do not enter a date in this column. If LINE_TYPE = 'TAX' or 'FREIGHT', do not enter a value in this column. For credit memos, AutoInvoice defaults to the date you run AutoInvoice, unless the transaction you are crediting is billed in arrears. In that case, AutoInvoice defaults to the GL date of the transaction you are crediting. For a more details on general ledger dates, see: Determining Dates, Oracle Receivables User Guide.
Validation:
Must be in an open or future enterable accounting period and the period must exist in GL_PERIOD_STATUSES. If 'Post To GL' is set to No on the transaction type of the transaction being passed, column must be NULL. If your invoice uses Bill in Arrears as the invoicing rule, then the GL_DATE column should be NULL.
Destination:
RA_CUST_TRX_LINE_GL_DIST_ALL.GL_DATE
HEADER_ ATTRIBUTE1-15
Enter Descriptive Flexfield attribute information for the Transaction Information Flexfield. Descriptive Flexfield attributes let you store additional columns, the contents of which you define. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or 'FREIGHT', do not enter values in these columns.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.ATTRIBUTE1-15 Note: To ensure that AutoInvoice accurately groups your imported invoices, do not include newline or carriage return characters (chr(10) or chr(13)) in these Descriptive Flexfield columns.
HEADER_ATTRIBUTE_CATEGORY
For the Transaction Information Flexfield, enter Descriptive Flexfield attribute category information which is shared between this transaction and other transactions. Descriptive Flexfield categories allow you to store different categories of attributes. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line', do not enter values in these columns.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.ATTRIBUTE_CATEGORY
HEADER_GDF_ATTRIBUTE1-30
Reserved for country-specific functionality.
Validation: Destination:
HEADER_GDF_ATTR_CATEGORY
Reserved for country-specific functionality.
Validation:
Destination:
RA_CUSTOMER_TRX_ALL.GLOBAL_ATTRIBUTE_CATE GORY
INITIAL_CUSTOMER_TRX_ID
This column is used by AutoInvoice and should be left null. If this transaction is not a credit memo, AutoInvoice defaults a value into this column using RA_INTERFACE_LINES_ALL.REFERENCE_LINE_ID.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.INITIAL_CUSTOMER_TRX_I D
INTERFACE_LINE_ATTRIBUTE1-15
Enter the Line Transaction Flexfield for this transaction. The Line Transaction Flexfield is a combination of attribute values that you use to uniquely identify this transaction line in your original system. The reference value you enter here provides you with an audit trail from Receivables back to your original system. You must enter values for enabled attributes. Receivables copies the Line Transaction Flexfield to the Invoice Transaction Flexfield. When you import transactions with multiple lines using AutoInvoice, the attributes of the first line from the ordered lines will appear in the Invoice Transaction Flexfield.
Note: Interface lines belonging to the same transaction are ordered by
If a transaction has only one line, then the Invoice Transaction Flexfield will be the same as the Line Transaction Flexfield.
Validation:
Must not already exist together with INTERFACE_LINE_CONTEXT in RA_INTERFACE_LINES_ALL and RA_CUSTOMER_TRX_LINES_ALL. All enabled attributes for a given INTERFACE_LINE_CONTEXT must have values. Different attribute columns may be enabled depending on the value in the INTERFACE_LINE_CONTEXT column.
Destination:
RA_CUSTOMER_TRX_LINES_ALL.INTERFACE_LINE_A TTRIBUTE1-15 Note: To ensure that AutoInvoice accurately groups your imported invoices, do not include newline or carriage return characters (chr(10) or chr(13)) in these Descriptive Flexfield columns.
INTERFACE_LINE_CONTEXT
This is a required column in AutoInvoice. Enter the context of the Line Transaction Flexfield entered in columns INTERFACE_LINE_ATTRIBUTE1-15. If you pass information with global context, set this column to 'Global Data Elements'.
Validation: Destination:
INTERFACE_LINE_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value in this column using the RA_CUSTOMER_TRX_LINES_S sequence.
Validation: Destination:
INTERFACE_STATUS
This column is used by AutoInvoice and should be left null. If AutoInvoice sets this column to 'P' then the line has been transferred successfully.
INTERNAL_NOTES
Enter internal notes for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing freight header, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter text in this column.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.INTERNAL_NOTES
INVENTORY_ITEM_ID
Enter the inventory item ID for this transaction. If LINE_TYPE = 'LINE', or 'CHARGES' this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or a combination of segment values in MTL_SYSTEM_ITEMS_SEG1-20. If you specify segments in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or 'FREIGHT', do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the value from the transaction you are crediting.
Validation:
Destination:
INVOICING_RULE_ID
Enter the invoicing rule ID for this transaction. If LINE_TYPE = 'LINE' or you are passing header freight, this column is optional. For invoice lines with rules, you must enter either a value in this column or in INVOICING_RULE_NAME, depending on the value you entered for your batch source. If you specify invoicing rule name in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX', 'CHARGES', or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the invoicing rule from the transaction you are crediting.
Validation:
Must exist in RA_RULES.RULE_ID and RA_RULES.RULE_ID = -2 or -3. If you enter an invoicing rule you must also enter an accounting rule. If LINE_TYPE = 'CHARGES' then this column must be null. RA_CUSTOMER_TRX_ALL.INVOICING_RULE_ID
Destination:
INVOICING_RULE_NAME
Enter the invoicing rule name for this transaction. If LINE_TYPE = 'LINE' or you are passing header freight, this column is optional. For invoice lines with rules, you must enter either a value in this column or in INVOICING_RULE_ID, depending on the value you entered for your batch source. You
can enter a value in this column or in INVOICING_RULE_ID. If LINE_TYPE = 'TAX', 'CHARGES' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the invoicing rule from the transaction you are crediting.
Validation:
Must exist in RA_RULES.RULE_ID and RA_RULES.RULE_ID = -2 or -3. If you enter an invoicing rule you must also enter an accounting rule. If LINE_TYPE = 'CHARGES' then this column must be null. None
Destination:
LAST_PERIOD_TO_CREDIT
For unit credit memos, enter the last period number from which you want to start crediting. If this transaction is a credit memo against a transaction which uses an accounting rule and LINE_TYPE = 'LINE', CREDIT_METHOD_FOR_ACCT_RULE = 'UNIT', or you are passing header freight, you may enter a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. AutoInvoice will ignore any value that you enter in this column.
Validation:
Must be between 0 and the invoice's accounting rule duration (inclusive). RA_CUSTOMER_TRX_LINES_ALL.LAST_PERIOD_TO_C REDIT
Destination:
LAST_UPDATE_LOGIN
This column is used by AutoInvoice and should be left null. AutoInvoice updates this column when it selects rows from the RA_INTERFACE_LINES_ALL table for processing.
Validation: Destination:
None None
LINE_GDF_ATTRIBUTE1-20
Reserved for country-specific functionality.
Validation: Destination:
E1-20
LINE_GDF_ATTR_CATEGORY
Reserved for country-specific functionality.
Validation: Destination:
LINE_NUMBER
This column is used by AutoInvoice and should be left null. AutoInvoice ignores any values passed in this column and always numbers the lines sequentially starting with the number 1 and in the order determined by the line ordering rule.
LINE_TYPE
Enter 'LINE', 'TAX', 'FREIGHT' or 'CHARGES' to specify the line type for this transaction. (CHARGES refers to finance charges.) You must enter a value in this column. For credit memos enter the type of line you are crediting.
Validation: Destination:
LINK_TO_LINE_ ATTRIBUTE1-15
Enter the link to your Transaction Flexfield attribute values. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, do not enter values in these columns. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, you must enter a value. Use link to line attributes to associate this tax or freight line to another transaction line in RA_INTERFACE_LINES_ALL. All tax lines and freight for specific lines must be associated with a line that has a LINE_TYPE of 'LINE'. Enter the same combination of attribute values as the transaction to which you want to associate with. For credit memos applied to tax lines, you must use these columns to link your credit memo tax lines to your credit memo transaction. Similarly, for credit memos applied to freight lines you must also use these columns to link your credit memo freight line to your credit memo transaction. If you are applying a credit memo against a tax line which is linked to a transaction, you must enter a dummy credit memo transaction with a zero revenue amount and use these columns to link to your credit memo tax line. Similarly, if you are applying a
credit memo against a freight line which is linked to a transaction, you must also enter a dummy credit memo transaction with a zero revenue amount and use these columns to link to your credit memo freight line.
Validation:
The transaction that you link to must have a LINE_TYPE = 'LINE'. You can only link at most one freight line to another transaction. You cannot link a transaction that has a LINE_TYPE = 'LINE' or 'CHARGES' to another transaction. None
Destination:
LINK_TO_LINE_CONTEXT
Enter the context name of the Transaction Flexfield data that you entered in RA_INTERFACE_LINES_ALL.LINK_TO_LINE_ATTRIBUTE1-15.
Validation: Destination:
None None
LINK_TO_LINE_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value into this column using RA_INTERFACE_LINES_ALL.LINK_TO_LINE_ATTRIBUTE1-15 and RA_INTERFACE_LINES_ALL.LINK_TO_LINE_CONTEXT.
Validation: Destination:
LOCATION_SEGMENT_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value into this column if you are crediting a sales tax line.
Validation: Destination:
MEMO_LINE_ID
Enter the standard memo line ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in MEMO_LINE_NAME. If you specify memo line
name in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the memo line from the transaction you are crediting.
Validation: Destination:
MEMO_LINE_NAME
Enter the name of the standard memo line for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in MEMO_LINE_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the memo line from the transaction you are crediting.
Validation: Destination:
MOVEMENT_ID
This column is used to pass movement statistics that are tied to the shipment information and passed through AutoInvoice. AutoInvoice will populate the column RA_CUSTOMER_TRX_LINES_ALL.MOVEMENT_ID with RA_INTERFACE_LINES_ALL.MOVEMENT_ID and updates MTL_MOVEMENT_STATISTICS with transaction information (for example, customer_trx_id, batch_id, customer_trx_line_id).
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.MOVEMENT_ID
MTL_SYSTEM_ITEMS_SEG1-20
Assign a System Item Flexfield value for each segment you enable in Receivables. For example, if you enable six System Item Flexfield segments, you must enter six values in columns MTL_SYSTEM_ITEMS_SEG1-6. Be sure to enter the correct segment value. For example, value '01' is not the same as '1'.
If LINE_TYPE = 'LINE' or 'CHARGES', these columns are optional. Depending on the value you entered for your batch source you can enter either values in these columns or in INVENTORY_ITEM_ID. If LINE_TYPE = 'TAX' or 'FREIGHT', do not enter values in these columns. For credit memos do not enter values in these columns. AutoInvoice uses the values from the transaction you are crediting. For debit memos do not enter values in these columns.
Validation: Destination:
ORG_ID
Enter the ID of the organization that this transaction belongs to. This column is mandatory in a multi-org environment.
Validation:
AutoInvoice imports transactions whose ORG_ID matches the value of the MO: Operating Unit profile option. None.
Destination:
ORIGINAL_GL_DATE
Stores the value of the GL_DATE column before AutoInvoice modifies the GL date. This column is used by AutoInvoice and should not be populated by the user.
Validation: Destination:
None None
ORIG_SYSTEM_BATCH_NAME
Enter the batch name for this transaction. This column is optional. AutoInvoice does not perform any validation on this column but uses the value entered when grouping transactions into invoices.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.ORIG_SYSTEM_BATCH_NA ME
ORIG_SYSTEM_BILL_ADDRESS_ID
Enter the Bill-To customer address ID for this transaction. This Bill-To customer address ID is for the Bill-To customer you entered in ORIG_SYSTEM_BILL_CUSTOMER_REF or ORIG_SYSTEM_BILL_CUSTOMER_ID.
If no default Remit_To Address has been specified, then AutoInvoice uses the Bill-To address to determine the Remit-To address for the customer. If the Remit-To address cannot be determined, then AutoInvoice will reject the transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in ORIG_SYSTEM_BILL_ADDRESS_REF. If you specify the Bill-To customer address reference in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation:
RA_INTERFACE_LINES_ALL.ORIG_SYSTEM_BILL_ADD RESS_ID = HZ_CUST_ACCT_SITE.CUSTOMER_SITE_ID and RA_INTERFACE_LINES_ALL.ORIG_SYSTEM_BILL_CUS TOMER_ID = HZ_CUST_ACCOUNTS.CUST_ACCOUNT_ID and HZ_CUST_ACCOUNTS.CUST_ACCOUNT_ID = HZ_CUST_ACCT_SITE.CUST_ACCOUNT_ID and HZ_CUST_ACCT_SITE.CUSTOMER_SITE_ID = HZ_CUST_SITE_USES.CUST_ACCT_SITE_ID and RA_SITE_USES.SITE_USE_CODE = 'BILL_TO' None
Destination:
ORIG_SYSTEM_BILL_ADDRESS_REF
Enter the Bill-To customer address reference from your original system. This reference is for the Bill-To customer you entered in ORIG_SYSTEM_BILL_CUSTOMER_REF or ORIG_SYSTEM_BILL_CUSTOMER_ID. The reference value you enter here provides you with an audit trail from Receivables back to your original system. If no default Remit_To Address has been specified, then AutoInvoice uses the Bill-To address to determine the Remit-To address for the customer. If the Remit-To address cannot be determined, then AutoInvoice will reject the transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in ORIG_SYSTEM_BILL_ADDRESS_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation:
None
ORIG_SYSTEM_BILL_CONTACT_ID
Enter the Bill-To contact ID for this transaction. This Bill-To contact ID must be for the Bill-To customer that you entered in ORIG_SYSTEM_BILL_CUSTOMER_REF or ORIG_SYSTEM_BILL_CUSTOMER_ID. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_BILL_CONTACT_REF. If you specify the Bill-To customer contact reference in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation:
Destination:
ORIG_SYSTEM_BILL_CONTACT_REF
Enter the Bill-To contact reference from your original system. This reference is for the Bill-To customer that you entered in ORIG_SYSTEM_BILL_CUSTOMER_REF or ORIG_SYSTEM_BILL_CUSTOMER_ID. The reference value you enter here provides you with an audit trail from Oracle Receivables back to your original system. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_BILL_CONTACT_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation:
TACT_REF = RA_CONTACTS.ORIG_SYSTEM_REFERENCE
Destination:
None
ORIG_SYSTEM_BILL_CUSTOMER_ID
Enter the Bill-To customer ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in ORIG_SYSTEM_BILL_CUSTOMER_REF. If you specify the Bill-To customer reference in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos you must enter the Bill-To customer ID or the Bill-To customer ID of a related customer of the transaction you are crediting.
Validation:
Destination:
ORIG_SYSTEM_ BILL_CUSTOMER_REF
Enter a value you can use to uniquely identify this Bill-To customer in your original system. The reference value you enter here provides you with an audit trail from Oracle Receivables back to your original system. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in ORIG_SYSTEM_BILL_CUSTOMER_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos you must enter the Bill-To customer reference or the Bill-To customer reference of a related customer of the transaction you are crediting.
Validation:
Destination:
ORIG_SYSTEM_SHIP_ADDRESS_ID
Enter the Ship-To customer address ID for this transaction.
If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_SHIP_ADDRESS_REF. If you specify the Ship-To address reference in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos, do not enter a value in this column; AutoInvoice uses the Ship-To address from the transaction you are crediting.
Validation:
RA_INTERFACE_LINES_ALL.ORIG_SYSTEM_SHIP_ADD RESS_ID = HZ_CUST_ACCT_SITE.CUSTOMER_SITE_ID and RA_INTERFACE_LINES_ALL.ORIG_SYSTEM_SHIP_CUS TOMER_ID = HZ_CUST_ACCOUNTS.CUST_ACCOUNT_ID and HZ_CUST_ACCOUNTS.CUST_ACCOUNT_ID = HZ_CUST_ACCT_SITE.CUST_ACCOUNT_ID and HZ_CUST_ACCT_SITE.CUSTOMER_SITE_ID = HZ_CUST_SITE_USES.CUST_ACCT_SITE_ID and HZ_CUST_SITE_USES.SITE_USE_CODE = 'SHIP_TO' None
Destination:
ORIG_SYSTEM_SHIP_ADDRESS_REF
Enter a value you can use to uniquely identify this Ship-To customer address in your original system. The reference value you enter here provides you with an audit trail from Receivables back to your original system. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_SHIP_ADDRESS_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column, AutoInvoice uses the Ship-To address from the transaction you are crediting.
Validation:
RA_INTERFACE_LINES_ALL.ORIG_SYSTEM_SHIP_ADD RESS_REF = HZ_PARTY_SITES.ORIG_SYSTEM_REFERENCE and RA_INTERFACE_LINES_ALL.ORIG_SYSTEM_SHIP_CUS TOMER_ID = HZ_CUST_ACCOUNTS.CUST_ACCOUNT_ID and HZ_CUST_ACCOUNTS.CUST_ACCOUNT_ID = HZ_CUST_ACCT_SITE.CUST_ACCOUNT_ID and
None
ORIG_SYSTEM_SHIP_CONTACT_ID
Enter the Ship-To contact ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_SHIP_CONTACT_REF. If you specify the Ship-To contact reference in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos, do not enter a value in this column. AutoInvoice uses the Ship-To contact from the transaction you are crediting.
Validation:
Destination:
ORIG_SYSTEM_SHIP_CONTACT_REF
Enter a value you can use to uniquely identify this Ship-To contact in your original system. The reference value you enter here provides you with an audit trail from Receivables back to your original system. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_SHIP_CONTACT_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos, do not enter a value in this column. AutoInvoice uses the Ship-To contact from the transaction you are crediting.
Validation:
TACT_REF = HZ_CUST_ACCOUNT_ROLES.ORIG_SYSTEM_REFEREN CE
Destination:
None
ORIG_SYSTEM_SHIP_CUSTOMER_ ID
Enter the Ship-To customer ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_SHIP_CUSTOMER_REF. If you specify the Ship-To customer reference in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos, do not enter a value in this column. AutoInvoice uses the Ship-To customer from the transaction you are crediting.
Validation:
Destination:
ORIG_SYSTEM_SHIP_CUSTOMER_REF
Enter a value you can use to uniquely identify this Ship-To customer in your original system. The reference value you enter here provides you with an audit trail from Receivables back to your original system. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_SHIP_CUSTOMER_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos, do not enter a value in this column. AutoInvoice uses the Ship-To customer from the transaction you are crediting.
Validation:
Destination:
ORIG_SYSTEM_SOLD_CUSTOMER_ID
Enter the Sold-To customer ID for this transaction.
If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_SOLD_CUSTOMER_REF. If you specify the Sold-To customer reference in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value. AutoInvoice uses the Sold-To customer from the transaction you are crediting.
Validation:
Destination:
ORIG_SYSTEM_SOLD_CUSTOMER_REF
Enter a value you can use to uniquely identify this Sold-To customer in your original system. The reference value you enter here provides you with an audit trail from Receivables back to your original system. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in ORIG_SYSTEM_SOLD_CUSTOMER_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value, AutoInvoice uses the Sold-To customer from the transaction you are crediting.
Validation:
Destination:
OVERRIDE_AUTO_ACCOUNTING_FLAG
This column controls whether the code combination ID of the Accounting Flexfield for this accounting distribution, populated by the feeder system, should override AutoAccounting. Populate this column for invoices and credit memos.
Validation: Destination:
PAYMENT_SET_ID
This column contains a unique internal ID number that matches prepaid invoices with their prepayment receipts. This column should be populated only within a prepayments flow.
Validation:
Destination:
PAYING_CUSTOMER_ID
This column is used by AutoInvoice and should be left null. Please refer to the section on Automatic Receipts for details on how AutoInvoice determines the paying customer.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.PAYING_CUSTOMER_ID
PAYING_SITE_USE_ID
This column is used by AutoInvoice and should be left null. Please refer to the section on Automatic Receipts for details on how AutoInvoice determines the paying site use.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.PAYING_SITE_USE_ID
PAYMENT_SERVER_ORDER_NUM
A number that indicates the credit card payment was authorized by Oracle Payment Server.
Validation Destination
PREVIOUS_CUSTOMER_TRX_ID
This column is used by AutoInvoice and should be left null. For credit memos, AutoInvoice defaults a value into this column using RA_INTERFACE_LINES_ALL.REFERENCE_LINE_ID.
Validation:
None
Destination:
PRIMARY_SALESREP_ID
Enter the primary salesperson ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, and you entered Yes for the Require Salesreps system option, you must enter either a value in this column or in PRIMARY_SALESREP_NUMBER. Otherwise this column is optional. The value that you enter depends on the value you entered for your batch source. If you specify the primary salesrep ID in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = ''TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation: Destination:
PRIMARY_SALESREP_NUMBER
Enter the primary salesperson number for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, and you entered Yes for the Require Salesreps system option, you must enter either a value in this column or in PRIMARY_SALESREP_ID. Otherwise this column is optional. The value that you enter depends on the value you entered for your batch source. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation: Destination:
PRINTING_OPTION
Enter the printing option for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. AutoInvoice defaults to the printing option that you entered for this transaction type, if one was entered. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation:
'INVOICE_PRINT_OPTIONS'
Destination:
RA_CUSTOMER_TRX_ALL.PRINTING_OPTION
PROMISED_COMMITMENT_AMOUNT
Enter the amount of an existing deposit to use as payment towards a specific transaction. When an order is imported into Receivables with a value in this column, Receivables adjusts the resulting invoice and reduces the deposit balance by the lesser of the promised amount, the commitment balance, or the remaining amount due on the invoice. If this column has no value, then the commitment adjustment will be for the lesser of the total outstanding commitment or the total balance of the transaction.
Validation: Destination:
None None
PURCHASE_ORDER
Enter the purchase order number for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the purchase order number from the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.PURCHASE_ORDER
PURCHASE_ORDER_DATE
Enter the date of the purchase order for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos, do not enter a value in this column. AutoInvoice uses the purchase order date from the transaction you are crediting.
Validation:
None
Destination:
RA_CUSTOMER_TRX_ALL.PURCHASE_ORDER_DATE
PURCHASE_ORDER_REVISION
Enter the purchase order revision for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos, do not enter a value in this column. AutoInvoice uses the purchase order revision from the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.PURCHASE_ORDER_REVISI ON
QUANTITY
If this transaction is an invoice or credit memo line and LINE_TYPE = 'LINE' or you are passing header freight, this column is optional. For invoice lines, enter the number of units shipped. For credit memo lines, enter the number of units you are crediting. If you do not enter a value in this column, AutoInvoice uses AMOUNT as the extended amount for this transaction. If this transaction is a dummy line for either freight only or tax only, AutoInvoice ignores the value you enter in this column. If this is a Credit Memo line and LINE_TYPE = 'LINE', CREDIT_METHOD_FOR_ACCT_RULE = 'UNIT' then this column is mandatory. For Debit Memos, if LINE_TYPE = 'CHARGES', set quantity to 1. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For Credit Memos, if LINE_TYPE = 'CHARGES', set quantity to 1 or -1.
Validation:
For Debit Memos lines with LINE_TYPE = 'CHARGES', quantity must be 1. For Credit Memo lines with LINE_TYPE = 'CHARGES', this column must be 1 or -1. For Credit Memo lines with LINE_TYPE = 'LINE' and CREDIT_METHOD_FOR_ACCT_RULE = 'UNIT' then this column must not be null.
Destination:
RA_CUSTOMER_TRX_LINES_ALL.QUANTITY_INVOIC ED if this transaction is an invoice line. RA_CUSTOMER_TRX_LINES_ALL.QUANTITY_CREDIT ED if this transaction is a credit memo line.
QUANTITY_ORDERED
Enter the original number of units ordered for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing freight for a specific line, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this field. For credit memos, do not enter a value in this column. AutoInvoice uses the quantity ordered from the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.QUANTITY_ORDERE D
REASON_CODE
Enter the reason code for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in REASON_CODE_MEANING. If you specify the reason code meaning in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos and on-account credits this column is optional.
Validation:
Must exist in AR_LOOKUPS.LOOKUP_CODE. This lookup type is either INVOICING_REASON or CREDIT_MEMO_REASON RA_CUSTOMER_TRX_LINES_ALL.REASON_CODE and RA_CUSTOMER_TRX_ALL.REASON_CODE
Destination:
REASON_CODE_MEANING
Enter the meaning of the reason code for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in REASON_CODE. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos and on-account credits this column is optional.
Validation:
Must exist in AR_LOOKUPS.MEANING. This lookup type is either INVOICING_REASON or CREDIT_MEMO_REASON None
Destination:
RECEIPT_METHOD_ID
Enter the receipt method ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in RECEIPT_METHOD_NAME. If you specify the receipt method name in your batch source, AutoInvoice defaults a value in this column. AutoInvoice always defaults the receipt method using the following hierarchy: 1. primary receipt method of the parent primary bill-to site 2. primary receipt method of the parent customer 3. primary receipt method of the bill-to site 4. primary receipt method of the bill-to customer If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this field.
Validation:
Must exist in AR_RECEIPT_METHODS.RECEIPT_METHOD_ID and must belong to the bill-to customer or the parent. Additionally, the receipt method must have at least one bank account in the same currency as the transaction or have its Receipts Multi-Currency flag set to Yes. RA_CUSTOMER_TRX_ALL.RECEIPT_METHOD_ID
Destination:
RECEIPT_METHOD_NAME
Enter the name of the receipt method for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or in RECEIPT_METHOD_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this field.
Validation:
Must exist in AR_RECEIPT_METHODS.NAME and must belong to the bill-to customer or the parent. None
Destination:
REFERENCE_LINE_ATTRIBUTE1-15
If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, and this transaction is a credit memo, you must enter either the Transaction Flexfield of the transaction line you are crediting in these columns or the RA_CUSTOMER_TRX_LINES_ALL.CUSTOMER_TRX_LINE_ID of the transaction you are crediting in RA_INTERFACE_LINES_ALL.REFERENCE_LINE_ID. Otherwise, do not enter values in these columns. If LINE_TYPE = 'TAX' and this transaction is a credit memo, you must enter either the Transaction Flexfield of the tax line you are crediting in these columns or the RA_CUSTOMER_TRX_LINES_ALL.CUSTOMER_TRX_LINE_ID of the transaction tax line you are crediting in RA_INTERFACE_LINES_ALL.REFERENCE_LINE_ID. Otherwise, do not enter values in these columns. If LINE_TYPE= 'FREIGHT' and this transaction is a credit memo, you must enter either the Transaction Flexfield of the freight line you are crediting in these columns or the RA_CUSTOMER_TRX_LINES_ALL.CUSTOMER_TRX_LINE_ID of the transaction freight line you are crediting in RA_INTERFACE_LINES_ALL.REFERENCE_LINE_ID. Otherwise, do not enter values in these columns. For on-account credits do not enter values in these columns.
Validation:
Destination:
REFERENCE_LINE_CONTEXT
Enter the context name of the Transaction Flexfield data entered in RA_INTERFACE_LINES_ALL.REFERENCE_LINE_ATTRIBUTE1-15. You must enter a value in this column if you entered values in RA_INTERFACE_LINES_ALL.ATTRIBUTE1-15.
Validation:
Destination:
REFERENCE_LINE_ID
If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, and this
transaction is a credit memo, you must enter the RA_CUSTOMER_TRX_LINES_ALL.CUSTOMER_TRX_LINE_ID of the transaction line you are crediting in this column or the Transaction Flexfield in REFERENCE_LINE_ATTRIBUTE1-15. Otherwise, do not enter a value. If LINE_TYPE = 'LINE' and this transaction is an invoice against a commitment, you must enter the RA_CUSTOMER_TRX_LINES_ALL.CUSTOMER_TRX_LINE_ID of the commitment line you are referencing. If LINE_TYPE= 'TAX' and this transaction is a credit memo, you must enter the RA_CUSTOMER_TRX_LINES_ALL.CUSTOMER_TRX_LINE_ID of the tax line you are crediting in these columns or the Transaction Flexfield in REFERENCE_LINE_ATTRIBUTE1-15. Otherwise, do not enter a value in this column. If LINE_TYPE = 'FREIGHT' and this transaction is a credit memo, you must enter the RA_CUSTOMER_TRX_LINES_ALL.CUSTOMER_TRX_LINE_ID of the freight line you are crediting in these columns or the Transaction Flexfield in REFERENCE_LINE_ATTRIBUTE1-15. Otherwise, do not enter a value in this column. For on-account credits, do not enter a value in this column.
Validation:
Must exist in RA_CUSTOMER_TRX_LINES_ALL.CUSTOMER_TRX_LI NE_ID. RA_CUSTOMER_TRX_LINES_ALL.PREVIOUS_CUSTOM ER_TRX_LINE_ID if this transaction is a credit memo. Otherwise, RA_CUSTOMER_TRX_LINES_ALL.INITIAL_CUSTOMER _TRX_LINE_ID
Destination:
RELATED_BATCH_SOURCE_NAME
Enter the name of the batch source of the document to which this transaction is related. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter a value in this column and the related transaction number in RELATED_TRX_NUMBER. Or, you can enter the related customer transaction ID in RELATED_CUSTOMER_TRX_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos and on-account credits do not enter a value in this column.
Validation:
RA_CUSTOMER_TRX_ALL.BATCH_SOURCE_ID
Destination:
None
RELATED_CUSTOMER_TRX_ID
Enter the customer transaction ID of the document to which this transaction is related. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter a value in this column. Or, you can enter the related transaction number in RELATED_TRX_NUMBER and the related batch source name in RELATED_BATCH_SOURCE_NAME. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos and on-account credits do not enter a value in this column.
Validation:
Destination:
RELATED_TRX_NUMBER
Enter the document number to which this transaction is related. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter a value in this column and the related batch source name in RELATED_BATCH_SOURCE_NAME. Or, you can enter the related customer transaction ID in RELATED_CUSTOMER_TRX_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos and on-account credits do not enter a value in this column.
Validation:
RA_INTERFACE_LINES_ALL.RELATED_BATCH_SOUR CE_NAME = RA_BATCH_SOURCES_ALL.NAME and RA_INTERFACE_LINES_ALL.RELATED_TRX_NUMBER = RA_CUSTOMER_TRX_ALL.TRX_NUMBER and RA_BATCH_SOURCES_ALL.BATCH_SOURCE_ID = RA_CUSTOMER_TRX_ALL.BATCH_SOURCE_ID None
Destination:
REQUEST_ID
This column is used by AutoInvoice and should be left null.
Validation: Destination:
None The REQUEST_ID column in RA_CUSTOMER_TRX_ALL, RA_CUSTOMER_TRX_LINES_ALL, RA_CUST_TRX_LINE_GL_DIST_ALL, AR_PAYMENT_SCHEDULES_ALL, AR_RECEIVABLE_APPLICATIONS_ALL, AR_ADJUSTMENTS_ALL and RA_CUST_TRX_LINE_SALESREPS_ALL.
RULE_START_DATE
Enter the date that you want to start the accounting rule for this transaction. If LINE_TYPE = 'LINE' or you are passing header freight, this column is optional. If you specify Specific Date in your accounting rule do not enter a value in this column. If LINE_TYPE = 'TAX', 'CHARGES', or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. For more information about rule start dates, see: Determining Dates, Oracle Receivables User Guide.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.RULE_START_DATE
RULE_END_DATE
Enter the date that you want to end the accounting rule for this transaction. This column is required if the accounting rule is either Daily Revenue Rate, All Periods or Daily Revenue Rate, Partial Periods. If LINE_TYPE = 'LINE' or you are passing header freight, this column is optional. If you specify Specific Date in your accounting rule do not enter a value in this column. If LINE_TYPE = 'TAX', 'CHARGES', or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. For more information about rule start dates, see: Determining Dates, Oracle Receivables User Guide.
Validation:
None
Destination:
RA_CUSTOMER_TRX_LINES_ALL.RULE_END_DATE
SALES_ORDER
Enter the sales order number for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the sales order number from the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.SALES_ORDER
SALES_ORDER_DATE
Enter the date of the sales order for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the sales order date from the transaction you are crediting. Enter the date of the revenue order for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the revenue order date from the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.SALES_ORDER_DAT E
SALES_ORDER_LINE
Enter the sales order line number for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is
optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the sales order line number from the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.SALES_ORDER_LINE
SALES_ORDER_REVISION
Enter the sales order revision for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the sales order revision from the transaction you are crediting.
Validation: Destination:
SALES_ORDER_SOURCE
Enter the source of the sales order for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the source of the sales order from the transaction you are crediting.
Validation: Destination:
SALES_TAX_ID
This column is used by AutoInvoice and should be left null. For credit memos, AutoInvoice defaults to the sales tax ID of the transaction you are
crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.SALES_TAX_ID
SET_OF_BOOKS_ID
Optionally enter the ledger ID for this transaction. If no value exists, then Receivables defaults the ledger from the System Options window for the organization that is specified in the ORG_ID column.
Validation:
Destination:
SHIP_DATE_ACTUAL
Enter the shipment date for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the earliest shipment date from the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.SHIP_DATE_ACTUAL
SHIP_VIA
Enter the ship via code for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the ship via code from the transaction you are crediting.
Validation:
RA_CUSTOMER_TRX_ALL.SHIP_VIA
SOURCE_DATA_KEY1-5
Enter line group attributes that link one or more transaction lines into groups. Receivables uses groups during line-level cash application. See: Applying Receipts in Detail, Oracle Receivables User Guide.
Validation: Destination:
TAX_CODE
Enter the tax code for this tax line. If LINE_TYPE = 'CHARGES', or 'FREIGHT', do not enter a value in this column. If LINE_TYPE = 'LINE', this column is optional. If LINE_TYPE = 'TAX', this column is mandatory. For credit memos, AutoInvoice defaults the tax code from the transaction you are crediting.
Validation: Destination:
TAX_EXEMPT_FLAG
If LINE_TYPE = 'LINE', this column is optional. The value you enter here controls how a line is taxed. Enter 'E' if you want AutoInvoice to exempt an invoice line that would normally be taxed and your system option 'Use Customer Exemptions' is set to Yes. If you enter 'E' you must enter a value for TAX_EXEMPT_REASON_CODE or TAX_EXEMPT_REASON_CODE_MEANING, depending on your batch source option. Enter 'R' if you want AutoInvoice to force tax on an invoice line, ignoring any exemption certificates that may be on file. Enter 'S' if you want tax to be calculated as per the normal procedures set up in Receivables. For all other line types and credit memos,, do not enter a value in this column.
Validation:
Destination:
RA_CUSTOMER_TRX_LINES_ALL.TAX_EXEMPT_FLAG
TAX_EXEMPT_NUMBER
Enter the tax exempt number for this transaction. If LINE_TYPE = 'LINE' and tax_exempt_flag = 'E', then you may enter a value in this column. Otherwise, do not enter a value in this column. For all other line types, do not enter a value in this column. For credit memos, do not enter a value in this column.
Validation: Destination:
TAX_EXEMPT_REASON_CODE
Enter the tax exempt reason code for this transaction. If LINE_TYPE = 'LINE' and tax_exempt_flag = 'E', then depending on your batch source option, Memo Reason, you must enter a value in this column or in TAX_EXEMPT_REASON_CODE_MEANING. If you specify a tax exempt reason code meaning in your batch source, AutoInvoice defaults the code in this column. For all other line types, do not enter a value in this column. For credit memos do not enter a value in this column.
Validation:
Destination:
TAX_EXEMPT_REASON_CODE_MEANING
Enter the tax exempt reason code meaning for this transaction. If LINE_TYPE = 'LINE' and tax_exempt_flag = 'E', then depending on your batch source option, Memo Reason, you must enter a value in this column or in TAX_EXEMPT_REASON_CODE. Otherwise, do not enter a value in this column. For all other line types and credit memos, do not enter a value in this column.
Validation:
Destination:
TAX_PRECEDENCE
Enter the precedence number for this tax line. This column is used to compute tax compounding. If LINE_TYPE = 'LINE', 'CHARGES', or 'FREIGHT', do not enter a value in this column. If LINE_TYPE = 'TAX' and you allow compound tax, you can enter a value in this column. Otherwise do not enter a value. If you are passing freight for a specific line, do not enter a value in this column. For credit memos AutoInvoice defaults the tax precedence from the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.TAX_PRECEDENCE
TAX_RATE
Enter the tax rate for this tax line. If LINE_TYPE = 'LINE', 'CHARGES', or 'FREIGHT', do not enter a value in this column. If LINE_TYPE = 'TAX', you must enter a value either in this column or the AMOUNT column. Any exemptions for the tax lines must be factored into the tax rate.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.TAX_RATE
TERM_ID
Enter the payment term ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in TERM_NAME. If you specify term name in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos and on-account credits do not enter a value in this column.
Validation: Destination:
TERM_NAME
Enter the name of the payment term for this transaction.
If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in TERM_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos and on-account credits do not enter a value in this column.
Validation: Destination:
TERRITORY_ID
Enter the territory ID for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. Depending on the value you entered for your batch source you can enter either a value in this column or a combination of territory segment values in TERRITORY_SEGMENT1-20. If you specify the combination of territory segment values in your batch source, AutoInvoice defaults a value in this column. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the territory from the transaction you are crediting.
Validation: Destination:
TERRITORY_SEGMENT1-20
Assign a Territory Flexfield value for each segment you enable in Receivables. For example, if you enable six Territory Flexfield segments, you must enter six values in columns TERRITORY_SEGMENT1-6. Be sure to enter the correct segment value. For example, value '01' is not the same as '1'. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, these columns are optional. Depending on the value you entered for your batch source you can enter either values in these columns or in TERRITORY_ID. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter values in these columns. For credit memos do not enter values in these columns. AutoInvoice uses the territory from the transaction you are crediting.
Validation:
Destination:
None
TRANSLATED_DESCRIPTION
The translated description of this transaction line (used for multi-lingual support)
Validation Destination
TRX_DATE
Enter the transaction date for this transaction. If TRX_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If this transaction is an invoice or debit memo line, you can enter the invoice date. If this transaction is a credit memo line, you can enter the credit memo date. If this transaction is an invoice line and uses an Arrears Invoice invoicing rule, do not enter a value in this column. If you do not enter a transaction date, AutoInvoice uses the general ledger date for invoice and debit memo lines. For credit memo lines, AutoInvoice uses the following hierarchy: credit memo general ledger date, and the general ledger date for the invoice's receivable distribution or the date in the Run AutoInvoice window, whichever is later. When child invoices are created against a commitment, AutoInvoice ensures that the child invoice's transaction date falls between the commitment's start and end dates. If TRX_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.TRX_DATE
TRX_NUMBER
Enter the number for this transaction. If TRX_TYPE = 'LINE', 'CHARGES', or you are passing header freight, and your batch source has Automatic Invoice Numbering set to No, you must enter a value in this column. If TRX_TYPE = 'LINE', 'CHARGES', or you are passing header freight, and your batch source has Automatic Invoice Numbering set to Yes, do not enter a value in this column. AutoInvoice inserts a unique number in this column. If TRX_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation:
Must not already exist in RA_CUSTOMER_TRX_ALL.TRX_NUMBER and RA_CUSTOMER_TRX_ALL.BATCH_SOURCE_ID RA_CUSTOMER_TRX_ALL.TRX_NUMBER and AR_PAYMENT_SCHEDULES_ALL.TRX_NUMBER
Destination:
UOM_CODE
Enter the unit of measure code for this transaction. If LINE_TYPE = 'LINE' and the line has an item you must enter either a value in this column or in UOM_NAME. If this a freight-only line, a tax-only line, or a line with no item, this column is optional. If LINE_TYPE = 'LINE' and you are passing a dummy line for either a tax-only or freight-only line, AutoInvoice ignores what you enter here. If LINE_TYPE = 'TAX', 'CHARGES', or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the unit of measure from the transaction you are crediting.
Validation:
Must exist in MTL_UNITS_OF_MEASURE.UOM_CODE. If Line_type = 'CHARGES', then this column must be null. RA_CUSTOMER_TRX_LINES_ALL.UOM_CODE
Destination:
UOM_NAME
Enter the unit of measure name for this transaction. If LINE_TYPE = 'LINE' and the line has an item you must enter either a value in this column or in UOM_CODE. If this a freight-only line, a tax-only line, or a line with no item, this column is optional. If LINE_TYPE = 'LINE' or you are passing header freight, and you are passing a dummy line for either a tax-only or freight-only line, AutoInvoice ignores what you enter here. If LINE_TYPE = 'TAX', 'CHARGES', or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the unit of measure from the transaction you are crediting.
Validation:
Must exist in MTL_UNITS_OF_MEASURE.UNIT_OF_MEASURE. If LINE_TYPE = 'CHARGES' then this column must be null. None
Destination:
UNIT_SELLING_PRICE
Enter the selling price per unit for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If you do not enter a value in this column, AutoInvoice defaults to the amount in RA_INTERFACE_LINES_ALL.AMOUNT as the amount/quantity for this transaction. If LINE_TYPE = 'LINE' or you are passing header freight, and you are passing a dummy line for either a tax-only or freight-only line, AutoInvoice ignores the value you enter here. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.UNIT_SELLING_PRIC E
UNIT_STANDARD_PRICE
Enter the standard price per unit for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line, do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the unit standard price from the transaction you are crediting.
Validation: Destination:
USSGL_TRANSACTION_CODE
Enter the transaction code for this transaction. If this transaction is linked to another transaction, you must enter the same transaction code as the one to which it is linked. This column is optional.
Validation: Destination:
USSGL_TRANSACTION_CODE_CONTEXT
This column is not currently used by AutoInvoice.
Validation: Destination:
None None
VAT_TAX_ID
This column is used by AutoInvoice and should be left null. If you enter a value in TAX_CODE, AutoInvoice defaults a value in this column. For credit memos AutoInvoice defaults to the VAT tax ID of the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_LINES_ALL.VAT_TAX_ID
WAREHOUSE_ID
This column identifies the ship-from location and can be used to control taxation. Within the US, the Warehouse ID is important when calculating tax on the Origin/Modified Origin state sales tax (outside the US, you can use Tax Groups and Conditions to build a schedule of multiple conditional taxes based on both the ship-from and ship-to County/County/State or Provinces).
Validation Destination
None RA_CUSTOMER_TRX_LINES_ALL.WAREHOUSE_ID
WAYBILL_NUMBER
Enter the waybill number for this transaction. If LINE_TYPE = 'LINE', 'CHARGES', or you are passing header freight, this column is optional. If LINE_TYPE = 'TAX' or you are passing freight for a specific line do not enter a value in this column. For credit memos do not enter a value in this column. AutoInvoice uses the waybill number from the transaction you are crediting.
Validation: Destination:
None RA_CUSTOMER_TRX_ALL.WAYBILL_NUMBER
ATTRIBUTE1-15
Enter the Descriptive Flexfield attribute information for this sales or revenue credit assignment. Descriptive Flexfield attributes allow you to store additional columns, the contents of which you define. These columns are optional.
Validation: Destination:
None RA_CUST_TRX_LINES_SALESREPS_ALL.ATTRIBUTE1-1 5
ATTRIBUTE_CATEGORY
Enter the Descriptive Flexfield category information for this sales credit assignment. Descriptive Flexfield categories allow you to store different categories of attributes. This column is optional.
Validation: Destination:
None RA_CUST_TRX_LINE_SALESREPS_ALL.ATTRIBUTE_CA
TEGORY
INTERFACE_LINE_ATTRIBUTE1-15
Enter the same Transaction Flexfield for the transaction with which you want to associate this sales or revenue credit assignment. The values you enter here provide you with an audit trail from Receivables back to your original system. You must enter a value for each attribute you enabled.
INTERFACE_LINE_CONTEXT
Enter the context name of the Transaction Flexfield data that you entered in RA_INTERFACE_SALESCREDITS_ALL.INTERFACE_LINE_ATTRIBUTE1-15. You must enter a value in this column.
Validation: Destination:
None None
INTERFACE_LINE_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value into this column using RA_INTERFACE_SALESCREDITS_ALL.INTERFACE_LINE_ATTRIBUTE1-15.
Validation: Destination:
INTERFACE_SALESCREDIT_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value into this column using the sequence RA_CUST_TRX_LINE_SALESREPS_S.
Validation: Destination:
INTERFACE_STATUS
This column is used by AutoInvoice and should be left null.
Validation: Destination:
None None
LAST_UPDATE_LOGIN
This column is used by AutoInvoice and should be left null. AutoInvoice updates this column when it selects rows from the RA_INTERFACE_SALESCREDITS_ALL table for processing.
Validation: Destination:
None None
REQUEST_ID
This column is used by AutoInvoice and should be left null.
Validation: Destination:
None None
SALES_CREDIT_AMOUNT_SPLIT
Enter the sales credit amount for this salesperson. This column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in SALES_CREDIT_PERCENT_SPLIT. If you specify the sales credit percent in your batch source, AutoInvoice defaults a value in this column.
Validation:
If the sales credit for this sales credit assignment is of type Quota, the sum of sales credit amounts for a transaction must equal the amount of the transaction. RA_CUST_TRX_LINE_SALESREPS_ALL.REVENUE_AM OUNT_SPLIT if the sales credit type is Quota. RA_CUST_TRX_LINE_SALESREPS_ALL.NON_REVENUE _AMOUNT_SPLIT if the sales credit type is not Quota.
Destination:
SALES_CREDIT_PERCENT_SPLIT
Enter the sales credit percent for this salesperson. This column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in SALES_CREDIT_AMOUNT_SPLIT. If you specify the sales or revenue credit amount in your batch source, AutoInvoice defaults a value in this column.
Validation:
Your sales or revenue credit percent must be between 0 and 100, and if sales credit type is Quota, the sales credit percentage for a transaction must sum to 100.
SALES_CREDIT_TYPE_ID
Enter the ID of the sales credit type for this sales credit assignment. This column is
optional. Depending on the value you entered for your batch source you must enter either a value in this column or in SALES_CREDIT_TYPE_NAME. If you specify the sales credit type name in your batch source, AutoInvoice defaults a value in this column.
Validation:
Destination:
SALES_CREDIT_TYPE_NAME
Enter the name of the sales credit type for this sales credit assignment. This column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in SALES_CREDIT_TYPE_ID.
Validation: Destination:
SALES_GROUP_ID
Enter the sales group ID for this sales credit assignment. This column is optional.
Validation:
Must exist in JTF_RS_GROUP_USAGES.GROUP_ID and have JTF_RS_GROUP_USAGES.USAGE = 'SALES' RA_CUST_TRX_LINE_SALESREPS_ALL.REVENUE_SAL ESGROUP_ID or RA_CUST_TRX_LINE_SALESREPS_ALL.NON_REVENUE _SALESGROUP_ID
Destination:
SALESREP_ID
Enter the salesperson ID for this sales credit assignment. This column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in SALESREP_NUMBER. If you specify the salesperson number in your batch source, AutoInvoice defaults a value in this column.
Validation: Destination:
SALESREP_NUMBER
Enter the salesperson number for this sales credit assignment. This column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or in SALESREP_ID.
Validation: Destination:
ACCOUNT_CLASS
Enter the account class for this accounting distribution. AutoInvoice uses the account class you enter here to determine the type of account you are supplying for this accounting distribution. You must enter a value for this column.
Validation:
Must be either 'REV', 'FREIGHT', 'TAX', 'REC', 'CHARGES', 'UNBILL', or 'UNEARN'. If the transaction uses the 'Advance Invoice' invoicing rule, do not enter 'UNBILL' in this column. If the transaction uses the 'Arrears Invoice' invoicing rule, do not enter 'UNEARN' in this column. RA_CUST_TRX_LINE_GL_DIST_ALL.ACCOUNT_CLASS
Destination:
ACCTD_AMOUNT
This column is optional. If you enter 'AMOUNT' for your batch source option 'Revenue Account Allocation', then AutoInvoice will accept whatever is passed in this column without validation. If this column is null, then AutoInvoice will compute the accounted amount for this distribution line. For imported amounts in the functional currency, AutoInvoice will reject the line if you enter a value in the ACCTD_AMOUNT column
None None
AMOUNT
Enter the amount for this accounting distribution. If this accounting distribution is for a transaction that does not use an accounting rule and depending on the value you entered for your batch source, you must enter either a value in this column or in PERCENT. If you specify the percent in your batch source, AutoInvoice computes the value in this column. Do not enter a value in this column if this accounting distribution is for a transaction which uses an accounting rule or if this distribution is a receivables ('REC') account. If this distribution is for a receivables account, you must enter 100 in RA_INTERFACE_DISTRIBUTIONS_ALL.PERCENT. If this line has AMOUNT_INCLUDES_TAX set to Yes, the sales credits and line amounts for this column must include tax.
Validation:
If this transaction does not use an accounting rule, the sum of all distribution amounts for this transaction of a given line type must equal the amount for the transaction. AutoInvoice corrects amounts that have incorrect currency precision. RA_CUST_TRX_LINE_GL_DIST_ALL.AMOUNT
Destination:
ATTRIBUTE1-15
Enter the Descriptive Flexfield attribute information for this accounting distribution. Descriptive Flexfield attributes allow you to store additional columns, the contents of which you define. These columns are optional.
Validation: Destination:
None RA_CUST_TRX_LINE_GL_DIST_ALL.ATTRIBUTE1-15
ATTRIBUTE_CATEGORY
Enter the Descriptive Flexfield category information for this accounting distribution. Descriptive Flexfield categories allow you to store different categories of attributes. This column is optional.
Validation: Destination:
None RA_CUST_TRX_LINE_GL_DIST_ALL.ATTRIBUTE_CATE
GORY
CODE_COMBINATION_ID
Enter the code combination ID of the Accounting Flexfield for this accounting distribution. This column is optional. Depending on the value you entered for your batch source you must enter either a value in this column or a combination of segment values in SEGMENT1-30. If you specify the combination of segment values in your batch source, AutoInvoice defaults a value in this column.
Validation:
Must exist in GL_CODE_COMBINATIONS.CODE_COMBINATION_ID RA_CUST_TRX_LINE_GL_DIST_ALL.COLLECTED_TAX_ CCID if tax is deferred; otherwise, RA_CUST_TRX_LINE_GL_DIST_ALL.CODE_COMBINAT ION_ID
Destination:
COMMENTS
Enter comments about this accounting distribution. This column is optional.
Validation: Destination:
None RA_CUST_TRX_LINE_GL_DIST_ALL.COMMENTS
INTERFACE_DISTRIBUTION_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value into this column using the sequence RA_CUST_TRX_LINE_GL_DIST_S. This is the primary key for RA_INTERFACE_DISTRIBUTIONS_ALL.
Validation: Destination:
INTERFACE_LINE_ATTRIBUTE1-15
Enter the same Line Transaction Flexfield for the transaction with which you want to associate this accounting distribution. You must enter a value for each attribute you enabled for the Line Transaction Flexfield.
Validation: Destination:
None None
INTERFACE_LINE_CONTEXT
This is a required column in AutoInvoice. Enter the context of the Line Transaction Flexfield entered in columns INTERFACE_LINE_ATTRIBUTE1-15.
Validation:
If you pass lines with global context set this column to 'Global Data Elements' RA_CUSTOMER_TRX_LINES_ALL.INTERFACE_LINE_C ONTEXT
Destination:
INTERFACE_LINE_ID
This column is used by AutoInvoice and should be left null. AutoInvoice defaults a value into this column using INTERFACE_LINE_ATTRIBUTE1-15 and INTERFACE_LINE_CONTEXT.
Validation: Destination:
INTERFACE_STATUS
This column is used by AutoInvoice and should be left null.
Validation: Destination:
None None
INTERIM_TAX_CCID
This column identifies the tax account used for deferred tax amounts.
Validation: Destination:
INTERIM_TAX_SEGMENT1-30
Enter an Accounting Flexfield value for each segment you enable in Receivables. This flexfield represents the Interim (deferred) tax account. For example, if you enable six Accounting Flexfield segments, you must enter six values in columns SEGMENT1-6. Be sure to enter the correct segment value. For example, the value '01' is not the same as '1'. Depending on the value you entered for your batch source, you must enter either a combination of segment values in these columns or a value in CODE_COMBINATION_ID.
Validation:
Valid combination of Accounting Flexfield segment values must exist in GL_CODE_COMBINATIONS. None
Destination:
LAST_UPDATE_LOGIN
This column is used by AutoInvoice and should be left null. AutoInvoice updates this column when it selects rows from the RA_INTERFACE_DISTRIBUTIONS_ALL table for processing.
Validation: Destination:
None None
PERCENT
Enter the percent for this accounting distribution. If this accounting distribution is for a transaction that does not use an accounting rule and depending on the value you entered for your batch source, you must enter either a value in this column or in AMOUNT. If you specify the amount in your batch source, AutoInvoice defaults a value in this column. If this accounting distribution is for a transaction which uses an accounting rule, you must enter a value in this column.
Validation:
The sum of all accounting distribution percentages for a transaction must sum to 100 for an account class. RA_CUST_TRX_LINE_GL_DIST_ALL.PERCENT
Destination:
REQUEST_ID
This column is used by AutoInvoice and should be left null.
Validation: Destination:
None None
SEGMENT1-30
Enter an Accounting Flexfield value to each segment you enable in Receivables. For example, if you enable six Accounting Flexfield segments, you must enter six values in columns SEGMENT1-6. Be sure to enter the correct segment value. For example, the value '01' is not the same as '1'. Depending on the value you entered for your batch source, you must enter either a combination of segment values in these columns or a value in
CODE_COMBINATION_ID.
Validation:
Valid combination of Accounting Flexfield segment values must exist in GL_CODE_COMBINATIONS. None
Destination:
CONTINGENCY_ID
Identifies the revenue contingency, according to this table:
Contingency Name Explicit Acceptance Customer Creditworthiness Doubtful Collectibility Extended Payment Term Cancellation Fiscal Funding Clause Refund Forfeitures Leasing Doubtful Collectibility Impaired Loans Contingency ID 2 3 4 5 7 8 9 10 12 13
Validation: Destination:
None. AR_LINE_CONTS_ALL.CONTINGENCY_ID
EXPIRATION_DATE
Indicates expiration date of contingency. For time-based contingencies, enter either expiration date or expiration days.
Validation: Destination:
None. AR_LINE_CONTS_ALL.CONTINGENCY_CODE
EXPIRATION_DAYS
Indicates expiration period of contingency. For time-based contingencies, enter either expiration date or expiration days.
Validation: Destination:
None. AR_LINE_CONTS_ALL.CONTINGENCY_CODE
EXPIRATION_EVENT_DATE
Indicates the expiration of the contingency removal event.
Validation: Destination:
None. AR_LINE_CONTS_ALL.EXPIRATION_EVENT_DATE
INTERFACE_CONTINGENCY_ID
Contingency identifier.
Validation: Destination:
None None
PARENT_LINE_ID
Identifies the original parent order line from Oracle Order Management. Child invoice lines inherit contingencies from the parent line, and cannot be updated.
Validation: Destination:
None None
identifies all errors for each transaction line, thus reducing multiple validation and correction cycles. When you resubmit AutoInvoice, the program deletes the errors for each line selected for processing. When all of the records have been successfully processed, AutoInvoice purges any remaining data in this table. Use the Interface Exceptions window to view all of the errors in RA_INTERFACE_ERRORS_ALL. For more information, see: Correcting AutoInvoice Exceptions, Oracle Receivables User Guide.
INTERFACE_LINE_ID
If both INTERFACE_SALESCREDIT_ID and INTERFACE_DISTRIBUTION_ID are null, then the row in RA_INTERFACE_LINES_ALL associated with this INTERFACE_LINE_ID failed validation.
Validation: Destination:
None None
INTERFACE_SALESCREDIT_ID
If this column is not null, then the row in RA_INTERFACE_SALESCREDITS_ALL associated with this INTERFACE_SALESCREDIT_ID failed validation.
Validation: Destination:
None None
INTERFACE_DISTRIBUTION_ID
If this column is not null, then the row in RA_INTERFACE_DISTRIBUTIONS_ALL associated with this INTERFACE_DISTRIBUTION_ID failed validation.
Validation: Destination:
None None
INVALID_VALUE
The invalid value that failed validation displays in this column, if applicable.
Validation: Destination:
None None
LINK_TO_LINE_ID
This column displays the INTERFACE_LINE_ID of the line to which this line that failed validation is linked. For example, you have a tax line that fails and is linked to an
invoice line that fails. In this case, the column stores the INTERFACE_LINE_ID of the invoice line.
Validation: Destination:
None None
MESSAGE_TEXT
The message text is stored in this column.
Validation: Destination:
None None
Related Topics
Importing Transactions Using AutoInvoice, Oracle Receivables User Guide Using AutoInvoice, Oracle Receivables User Guide
Related Topics
Receipt and QuickCash Tables, page B-62 Lockbox Interface Table and Column Descriptions, page B-63 Running AutoLockbox, Oracle Receivables User Guide
AR_RECEIVABLES_APPLICATIONS_ALL AR_CASH_RECEIPT_HISTORY_ALL
Related Topics
Lockbox Interface Table and Column Descriptions, page B-63
CREATED_BY (NUMBER(15)) Source - FND_USER.USER_ID Destination AR_BATCHES.CREATED_BY AR_INTERIM_CASH_RECEIPTS.CREATED_BY AR_INTERIM_CASH_RECEIPT_LINES.CREATED_BY LAST_UPDATE_LOGIN (NUMBER(15)) Source - UNKNOWN Destination - None
DESTINATION_ACCOUNT (VARCHAR2(25)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AR_TRANSMISSIONS.DESTINATION
ORIGINATION (VARCHAR2(25)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AR_TRANSMISSIONS.ORIGIN
DESPOSIT_DATE (DATE) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN
GL_DATE (DATE) Source - DERIVED FROM DEPOSIT DATE, IMPORT DATE OR ENTERED DATE Destination AR_BATCHES.GL_DATE AR_INTERIM_CASH_RECEIPTS.GL_DATE AR_CASH_RECEIPT_HISTORY.GL_DATE DEPOSIT_TIME (VARCHAR2(8)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
TRANSMISSION_RECORD_COUNT (NUMBER(15)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AR_TRANSMISSIONS.COUNT
TRANSMISSION_AMOUNT (NUMBER) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AR_TRANSMISSIONS.AMOUNT
TRANSFERRED_RECEIPT_COUNT (NUMBER) Source - PROGRAM COUNTS NUMBER OF RECORDS TRANSFERRED SUCCESSFULLY Destination - AR_TRANSMISSIONS.VALIDATED_COUNT
TRANSFERRED_RECEIPT_AMOUNT (NUMBER) Source - PROGRAM COUNTS RECEIPT AMOUNTS OF RECORDS TRANSFERRED SUCCESSFULLY Destination - AR_TRANSMISSIONS.VALIDATED_AMOUNT
LOCKBOX_NUMBER (VARCHAR2(30))
LOCKBOX_BATCH_COUNT (NUMBER) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
LOCKBOX_RECORD_COUNT (NUMBER) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
LOCKBOX_AMOUNT (NUMBER) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
BATCH_NAME (VARCHAR2(25)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AR_BATCHES.LOCKBOX_BATCH_NAME
BATCH_AMOUNT (NUMBER) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AR_BATCHES.CONTROL_AMOUNT
BATCH_RECORD_COUNT (NUMBER(15)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AR_BATCHES.CONTROL_COUNT
ITEM_NUMBER (NUMBER) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA'
Destination - None
CURRENCY_CODE (VARCHAR2(15)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination AR_BATCHES.CURRENCY_CODE AR_INTERIM_CASH_RECEIPTS.CURRENCY_CODE EXCHANGE_RATE (NUMBER) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination AR_BATCHES.EXCHANGE_RATE AR_INTERIM_CASH_RECEIPTS.EXCHANGE_RATE EXCHANGE_RATE_TYPE (VARCHAR2(30)) Source - DEFAULTS FROM LOCKBOX DEFINITIONS OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination AR_BATCHES.EXCHANGE_RATE_TYPE AR_INTERIM_CASH_RECEIPTS.EXCHANGE_RATE_TYPE REMITTANCE_AMOUNT (NUMBER) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AR_INTERIM_CASH_RECEIPTS.AMOUNT
TRANSIT_ROUTING_NUMBER (VARCHAR2(25)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination AP_BANK_BRANCHES.BANK_NAME AP_BANK_BRANCHES.BANK_BRANCH_NAME AP_BANK_BRANCHES.BANK_NUM
ACCOUNT (VARCHAR2(30)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AP_BANK_ACCOUNTS.BANK_ACCOUNT_NUM
ANTICIPATED_CLEARING_DATE (DATE) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - AR_INTERIM_CASH_RECEIPTS.ANTICIPATED_CLEARING_DATE
CHECK_NUMBER (VARCHAR2(30)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination AR_INTERIM_CASH_RECEIPTS.RECEIPT_NUMBER AR_CASH_RECEIPTS.RECEIPT_NUMBER SPECIAL_TYPE (VARCHAR2(20)) Source - PROGRAM DETERMINES THE TYPE Destination - AR_INTERIM_CASH_RECEIPTS.SPECIAL_TYPE
CUSTOMER_NUMBER (VARCHAR2(30)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
OVERFLOW_INDICATOR (VARCHAR2(1)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
OVERFLOW_SEQUENCE (NUMBER)
Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
CUSTOMER_ID (NUMBER (15)) Source - PROGRAM DETERMINES IT Destination AR_INTERIM_CASH_RECEIPTS.PAY_FROM_CUSTOMER AR_CASH_RECEIPTS.PAY_FROM_CUSTOMER BILL_TO_LOCATION (VARCHAR2(40)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
CUSTOMER_SITE_USE_ID (NUMBER(15)) Source - PROGRAM DETERMINES IT Destination AR_INTERIM_CASH_RECEIPTS.SITE_USE_ID AR_CASH_RECEIPTS.CUSTOMER_SITE_USE_ID RECEIPT_DATE (DATE) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination AR_INTERIM_CASH_RECEIPTS.RECEIPT_DATE AR_INTERIM_CASH_RECEIPTS.EXCHANGE_DATE AR_CASH_RECEIPTS.RECEIPT_DATE AR_CASH_RECEIPTS.EXCHANGE_DATE RECEIPT_METHOD (VARCHAR2(30)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
RECEIPT_METHOD_ID (NUMBER(15))
INVOICE1-8 (VARCHAR2(50)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
MATCHING1_DATE - MATCHING8_DATE (DATE) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
COMMENTS (NUMBER) Source - ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination AR_BATCHES.COMMENTS AR_INTERIM_CASH_RECEIPTS.COMMENTS ATTRIBUTE_CATEGORY (VARCHAR2(30)) ATTRIBUTE1-15 (CHAR(40)) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination AR_INTERIM_CASH_RECEIPTS.ATTRIBUTE1...15 AR_CASH_RECEIPTS.ATTRIBUTE1...15 INVOICE1_INSTALLMENT - INVOICE8_INSTALLMENT (NUMBER) Source - LOCKBOX DATA FILE OR ENTERED BY USER VIA 'MAINTAIN LOCKBOX TRANSMISSION DATA' Destination - None
AMOUNT_APPLIED1-8 (NUMBER) Source - LOCKBOX DATA FILE OR DERIVED FROM AMOUNT_APPLIED_FROM AND EXCHANGE_RATE Destination AR_INTERIM_CASH_RECEIPTS_ALL.AMOUNT_APPLIED (if a single application) AR_INTERIM_CASH_RCPT_LINES_ALL.PAYMENT_AMOUNT (if multiple applications) AMOUNT_APPLIED_FROM1-8 (NUMBER) Source - LOCKBOX DATA FILE OR DERIVED FROM AMOUNT_APPLIED_FROM AND EXCHANGE_RATE Destination AR_INTERIM_CASH_RECEIPTS_ALL.AMOUNT (if a single application) AR_INTERIM_CASH_RCPT_LINES_ALL.AMOUNT_APPLIED_FROM (if multiple applications) INVOICE_CURRENCY_CODE1-8 (VARCHAR2(15)) Source - LOCKBOX DATA FILE OR DERIVED FROM AR_PAYMENT_SCHEDULES_ALL Destination AR_INTERIM_CASH_RECEIPTS_ALL.INVOICE_CURRENCY_CODE (if a single application) AR_INTERIM_CASH_RCPT_LINES_ALL.INVOICE_CURRENCY_CODE (if multiple applications) TRANS_TO_RECEIPT_RATE1-8 (NUMBER) Source - LOCKBOX DATA FILE OR DERIVED FROM AMOUNT_APPLIED_FROM AND EXCHANGE_RATE
Destination - TRANS_TO_RECEIPT_RATE
Enter the value AR_PLB_NEW_RECORD for all records inserted into this table. The sample SQL*Loader control files Receivables provides fill this column in for you. Enter the date on which this transmission was actually deposited into your bank account. This date can be on any of the record types in your transmission. Each unique deposit date determines a batch of transmission records. For example, if you enter two unique deposit dates for your transmission, AutoLockbox divides your transmission into two batches of receipts. Identify your record type. For example, if this is a batch header record, and your bank uses the value 3 to identify batch headers, enter 3 in this column. Find out from your bank what character they use to identify each one. Keep in mind that not all banks use all of the record types. Assign values to identify the following types of records: TRANSMISSION HEADER TRANSMISSION TRAILER LOCKBOX HEADERS LOCKBOX TRAILERS BATCH HEADERS BATCH TRAILERS PAYMENT RECORDS
DEPOSIT_DATE
RECORD_TYPE
PAYMENT OVERFLOW RECORDS SERVICE HEADER Receivables lets you determine what information you want to include in you header, trailer, and receipt records. You can reference any of the above types when you define the different records for your transmission format. Below are examples of how you might want to define these.
Enter the number of records that you are importing. Include all of the types of records in the count: headers, trailers, receipts and overflow records. If the transmission format includes the transmission header or trailer, Lockbox counts all records in this transmission. The validated count includes all receipts and detail records transferred to the interim table. Enter the amount of the transmission. This is the sum of all of the receipt amounts within the transmission. Enter your account number at the sending bank. Enter the sending bank's transit routing number. Enter the date this transmission was actually deposited in your bank account. When you use SQL*Loader to import your data, it converts the date to the Oracle date format. Enter the time the deposit was made.
TRANSMISSION_AMOUNT
DEPOSIT_TIME
count. Although you may have a Lockbox Header without a Lockbox Trailer, AutoLockbox does not require that you specify either of these record types in your transmission format.
LOCKBOX_NUMBER
Enter the lockbox name or number that your bank specifies. This is the same value that you entered in the Lockboxes window. LOCKBOX_NUMBER is mandatory on all Lockbox Headers and Trailers. Enter the number of batches in this lockbox. Enter the number of Payment records in this lockbox. Do not include Payment Overflow records. Enter the total value of the receipts in this lockbox. Enter your account number at the sending bank. If this value is included in a Transmission Header or Trailer, you must enter the same value. Enter the sending bank's transit routing number. If this value is included in a Transmission Header or Trailer, you must have the same value here.
LOCKBOX_BATCH_COUNT LOCKBOX_RECORD_COUNT
LOCKBOX_AMOUNT DESTINATION_ACCOUNT
ORIGINATION
Enter the name or number that the bank uses to identify the batch. This is required for each Batch Header and Trailer record. Enter the total value of all receipts in this batch. Enter the number of receipt records in this batch. Enter the lockbox number assigned to receipts in this batch. If the lockbox number is included in your format, it must appear on every batch record. Enter any free-form comments about this batch.
COMMENTS
Enter the lockbox number assigned to your receipts. If the lockbox number is included in your format and you do not have batch records, it must be entered for every receipt record. Enter the batch name for this receipt. If batch name is included in your format, it must be entered for every receipt record. Each unique batch name determines a batch of transmission records. For example, if you enter two unique batch names for your transmission, AutoLockbox divides your transmission into two batches of receipts. Enter a sequential number to indicate the location of this receipt in this batch. You must enter a value even if your format does not have batch, lockbox, or transmission records. Item Number must be unique within a batch, a lockbox (if batches are not provided), or within a transmission (if neither batches nor lockboxes are provided). Enter the value of the receipt. You must enter a value for each receipt record. Enter the currency code for each receipt. Receivables supports AutoLockbox Transmission receipts in different currencies. Enter the exchange rate you want Receivables to use for this currency. Enter the type of exchange rate you are using for this receipt. You can enter Corporate, Spot, or User. Enter the date that is written on your check. If you are using MICR numbers to identify customers, Lockbox requires that this date be equal to or earlier than the date of this AutoLockbox submission; otherwise, the receipts will be unidentified.
BATCH_NAME
ITEM_NUMBER
REMITTANCE_AMOUNT
CURRENCY_CODE
EXCHANGE_RATE
EXCHANGE_RATE_TYPE
RECEIPT_DATE
RECEIPT_METHOD
Enter the receipt method that you want to associate with this receipt. Receipt methods contain information about your bank, bank account, and receipt accounts. This receipt method must be the same as the one you assigned to the batch source for this lockbox. Enter the number printed on the receipt. You must enter a value for each receipt record. Enter the transit routing number from the receipt. This is optional, but you must enter this number if you enter the account number. Receivables uses transit routing number and account number together to identify the customer (MICR number). Enter the bank account number from the receipt. This is optional, but you must enter this number if you enter the transit routing number. Enter the number assigned to your customer. This is optional. Enter the invoice numbers to which you apply this receipt. You do not have to start with INVOICE1 or use all eight of the INVOICE columns on a record before you create a receipt record. You may find a list of valid values in AR_PAYMENT_SCHEDULES.TRX_NUMBER. Do not look at transactions with a class of PMT or GUAR. Invoice numbers are optional. If the receipt currency and the transaction currency are different, enter the amount of the receipt to apply in the receipt currency. If the receipt currency and the transaction currency are different, enter the currency of the transaction (optional). If null, AutoLockbox derives this value from AR_PAYMENT_SCHEDULES_ALL. This field is used for cross currency receipt applications. If the receipt currency and the transaction currency are different, enter the exchange rate used to convert the receipt to the transaction currency. This value is used for cross currency receipt applications when the receipt and transaction currencies do not have a fixed exchange rate. Enter the installment number if your invoice has multiple
CHECK_NUMBER
TRANSIT_ROUTING_NUMBER
ACCOUNT
CUSTOMER_NUMBER
INVOICE1-8
AMOUNT_APPLIED_FROM1-8
INVOICE_CURRENCY_CODE1 -8
TRANS_TO_RECEIPT_RATE 1-8
INVOICE1-8_INSTALLMENT
payment schedules. If you do not specify the installment number for an invoice with multiple payment schedules, Receivables will apply to the oldest payment schedule first. The installment number must be on the same record as the associated invoice number.
AMOUNT_APPLIED1-8
Enter the amount of the receipt to apply to the invoice. You can provide invoice numbers without specifying the amount applied to each of these invoices. If you provide invoice numbers without specifying the amount applied to each invoice, Receivables applies the receipt to the invoices starting with the oldest receipt schedule first. The value of the amount_applied column must be on the same record as the invoice number to which it is applied. For example, you cannot have all of the invoice numbers on the receipt record and all of the amounts applied on the overflow. Applied amounts are optional. If the receipt currency and the transaction currency are different, enter the amount of the receipt to apply in the transaction currency. Enter any free-form comments about this receipt. Receivables stores this data, but does not display these comments in any of the receipt entry windows. Enter the Descriptive Flexfield category information for this receipt. Enter the Descriptive Flexfield attributes for this category. You can use this column to transfer additional information about your receipt. For example, if your bank enters and transmits customer name, you can use an attribute column to import this name. The attributes are visible as Descriptive Flexfields in the Receipt windows. To associate receipts with specific customer sites, enter the billing address for this receipt and include billing location in your transmission format. If the system option Require Billing Location for Receipts is set to Yes, you must enter a value here. In addition, you can set the Require Billing Location field to Yes in the Lockboxes window to require a billing location for a specific lockbox. The value of this field in the Lockboxes window will override the option at the system level. See: Lockboxes, Oracle Receivables Implementation Guide. The name of the customer's bank.
COMMENTS
ATTRIBUTE_CATEGORY
ATTRIBUTE1-15
BILL_TO_LOCATION
CUSTOMER_BANK_NAME
The name of the customer's bank branch. The name of the bank that received the payment. The name of the bank branch that received the payment.
Enter the number of the lockbox for this receipt. If the lockbox number is included in your format and you do not have any batch records, you must enter this number for each receipt and overflow record. Enter the batch for this overflow record. If the batch name is included in your format, you must enter this name for each overflow record. Enter a sequential number to indicate the location of the overflow record in this batch. All overflow records for a receipt have the same item number as the receipt record. You must enter an item number for each overflow record to reference the receipt. Receivables uses this column to indicate overflow records for the current receipt. You determine your overflow indicator in your transmission format. To identify the last overflow record, enter a value that is different from your overflow indicator. For example, in the BAI transmission format, '0' indicates an overflow record. You have three overflow records for a receipt, the first two records have '0' as the overflow indicator and the third record has '9'. Since the third record is not '0', it is identified as the last overflow record. You must enter a value for all overflow records. Enter a sequential number to indicate the order of overflow records. Within each receipt, the Overflow Sequence usually begins with 1. If the receipt currency and the transaction currency are
BATCH_NAME
ITEM_NUMBER
OVERFLOW_INDICATOR
OVERFLOW_SEQUENCE
AMOUNT_APPLIED_FROM1-8
different, enter the amount of the receipt to apply in the receipt currency.
INVOICE_CURRENCY_CODE1 -8
If the receipt currency and the transaction currency are different, enter the currency of the transaction (optional). If null, AutoLockbox derives this value from AR_PAYMENT_SCHEDULES_ALL. This field is used for cross currency receipt applications. If the receipt currency and the transaction currency are different, enter the exchange rate used to convert the receipt to the transaction currency. This value is used for cross currency receipt applications when the receipt and transaction currencies do not have a fixed exchange rate. Enter the invoice numbers to which you apply this receipt. You do not have to start with INVOICE1, nor use all eight of the INVOICE columns on a record before you create an overflow record. You can find a list of valid values in AR_PAYMENT_SCHEDULES.TRX_NUMBER. Do not look at transactions with a class of PMT or GUAR. You may supply invoice numbers without specifying the amount applied to each invoice. Invoice numbers are optional. Enter the installment number if your invoice has multiple payment schedules. If you do not specify the installment number for an invoice with multiple payment schedules, then Receivables will apply to the oldest payment schedule first. The installment number must be on the same record as the associated invoice number. Enter the amount of the receipt to apply to the invoice. If you specify invoice numbers without specifying the amount applied to each invoice, Receivables applies the receipt to the invoices starting with the oldest receipt first. The value of the amount applied column must be on the same record as the invoice number to which the receipt amount is applied.
TRANS_TO_RECEIPT_RATE 1-8
INVOICE1-8
INVOICE1-8_INSTALLMENT
AMOUNT_APPLIED1-8
Column Name TRANSMISSION_RECORD_ID CREATION_DATE CREATED_BY LAST_UPDATE_LOGIN LAST_UPDATED_BY LAST_UPDATE_DATE TRANSMISSION_REQUEST_ID CUSTOMER_ID SPECIAL_TYPE GL_DATE STATUS INVOICE1-8_STATUS RECEIPT_METHOD_ID TRANSMISSION_ID INVOICE1-8_STATUS CUSTOMER_BANK_ACCOUNT_ID CUSTOMER_SITE_USE_ID TRANSFERRED_RECEIPT_COUNT TRANSFERRED_RECEIPT_AMOUNT
Type NUMBER DATE NUMBER NUMBER NUMBER DATE NUMBER NUMBER CHAR(20) DATE CHAR(30) CHAR(30) NUMBER(15) NUMBER(15) VARCHAR2(30) NUMBER(15) NUMBER(15) NUMBER NUMBER
C
Seeded Match Rules
This appendix covers the following topics: Seeded Search Match Rules
The acquisition portion of the match rule determines the displayed search criteria and potential matches. Each acquisition attribute corresponds to a search criterion. The scoring portion scores and ranks the search results. Prerequisite Run the DQM Compile All Rules Program. See also: DQM Compile All Rules Program, Oracle Trading Community Architecture Administration Guide.
Related Topics
Match Rules Overview, Oracle Trading Community Architecture Administration Guide
Acquisition
This table shows the seeded attributes and transformation functions for the acquisition part of the matching process.
Attribute Name Entity Filter Attribute Match Transformation Name SOUNDEX WR + CLEANSE EXACT WR ADDRESS + CLEANSE CLEANSE WR STATE EXACT CLEANSE SOUNDEX WR PERSON + CLEANSE EXACT
Name
Party
No
Registry ID Address
Party Address
No No
No No No No No
Match All Attributes Match All Attributes Match All Attributes Match All Attributes Match All Attributes
Phone Number Flexible Format e-mail Address Site Number All Account Numbers
Contact Point
No
No No No
Scoring
This table shows the seeded thresholds for the scoring part of the matching process.
Threshold Match Threshold Override Threshold Automatic Merge Threshold Value 450
This table shows the seeded attributes and transformations for the scoring part of the matching process.
Attribute Name Name Entity Score Transformation Name WR NAMES + CLEANSE SOUNDEX Registry ID Address Party Address 100 70 EXACT WR ADDRESS WR ADDRESS + CLEANSE City State Country All Account Names Address Address Address Party 20 10 10 60 CLEANSE WR STATE EXACT WR NAMES Weight (%) Type Similarity (%)
Party
50
100
Exact
70 100 100 70
WR NAMES + CLEANSE
80
Exact
Entity
Score
Weight (%)
Type
Similarity (%)
Contact Point
50
100
Exact
80
70 100
Exact Exact
Contact Point
80
EXACT (EMAIL)
100
Exact
CLEANSE (EMAIL) Site Number All Account Numbers Address Party 50 90 EXACT EXACT (NUMBER)
70 100 100
Acquisition
This table shows the seeded attributes and transformation functions for the acquisition part of the matching process.
Attribute Name Entity Filter Attribute Match Transformation Name SOUNDEX WR NAMES + CLEANSE EXACT CLEANSE
Name
Party
No
Party Party
No No
Attribute Name
Entity
Filter
Attribute Match
Party Type Category Code SIC Code SIC Code Version Tax Registration Num City State Postal Code County Province Country All Account Names
Yes No No No No
Match All Attributes Match All Attributes Match All Attributes Match All Attributes Match All Attributes
No No No No No No No
Match All Attributes Match All Attributes Match All Attributes Match All Attributes Match All Attributes Match All Attributes Match All Attributes
CLEANSE WR STATE EXACT CLEANSE CLEANSE EXACT WR NAMES + CLEANSE EXACT EXACT (NUMBER)
Phone Number All Account Numbers Reference Use Flag Corporation Class
No No
Party Party
No No
EXACT EXACT
Scoring
This table shows the seeded thresholds for the scoring part of the matching process.
Value 480
This table shows the seeded attributes and transformation functions for the scoring part of the matching process.
Attribute Name Name Entity Score Transformation Name WR NAMES + CLEANSE WR NAMES SOUNDEX EXACT CLEANSE EXACT Weight (%) Type Similarity (%)
Party
50
80
Exact
Name Name Registry ID Tax Name Reference Use Flag Category Code SIC Code SIC Code Version Tax Registration Num Corporation Class
50 50 100 30 20
Party
10
EXACT
100
Exact
Party Party
30 10
EXACT EXACT
100 100
Exact Exact
Party
80
EXACT
70
Exact
Party
30
EXACT
100
Exact
Attribute Name City State Postal Code County Province Country All Account Names Phone Area Code All Account Numbers Phone Number Phone Country Code
Entity
Score
Weight (%)
Type
Similarity (%)
30 20 30 20 10 30 50
Contact Point
30
EXACT
100
Exact
Party
100
EXACT (NUMBER)
100
Exact
Contact Point
50
EXACT
100
Exact
Contact Point
10
EXACT
100
Exact
D
XML Transactions
This appendix covers the following topics: XML Receivables Documents Mapping
Related Topics
Process Invoice XML Message Map, page D-1 Confirm BOD Message Map, page D-5 Transaction Limitations, page D-6
INVHEADER
Source AR_XML_INVOICE_V.currency_co de AR_XML_INVOICE_V.trx_date AR_XML_INVOICE_V.trx_number AR_XML_INVOICE_V.payment_me thod AR_XML_INVOICE_V.supplier_na me AR_XML_INVOICE_V.supplier_cod e Supplier AR_XML_INVOICE_V.supplier_cod e AR_XML_INVOICE_V.salesrep AR_XML_INVOICE_V.salesrep_em ail AR_XML_INVOICE_V.document_ty pe AR_XML_INVOICE_V.reference_nu mber AR_XML_INVOICE_V.supplier_cod e Supplier AR_XML_PAYMENT_TERMS_V.di scount_amount
PARTNER.NAME
PARTNER.PARTNERID
PARTNER.PARTNRTYPE PARTNER.PARTNERIDX
PARTNER.CONTACT.NAME PARTNER.CONTACT.EMAIL
DOCUMNTREF.DOCTYPE
DOCUMNTREF.DOCMENTID
DOCUMNTREF.PARTNRID
Source AR_XML_PAYMENT_TERM_V.disc ount_date AR_XML_PAYMENT_TERMS_V.du e_date AR_XML_PAYMENT_TERMS_V.ter m_start_date_effective AR_XML_PAYMENT_TERMS_V.ter m_decscription AR_XML_PAYMENT_TERMS_V.ter m_name AR_XML_PAYMENT_TERMS_V.du e_amount
one or more
PYMTTERM.DATETIME.DUE
one or more
PYMTTERM.DATETIME.PYMTTERM
one or more
PYMTTERM.DESCRIPTN
one or more
PYMTERRM.TERMID
one or more
PYMTERRM.USERAREA.AMOUNT
The following table shows you the mapping between Receivables database columns and the elements of the Process Invoice XML message for the invoice charges.
INVCHARGE zero or more Target (XML) AMOUNT.EXTENDED.T Source AR_XML_INVOICE_CHARGE_V.charge_a mount AR_XML_INVOICE_CHARGE_V.line_type AR_XML_INVOICE_CHARGE_V.descriptio n AR_XML_INVOICE_CHARGE_V.line_numb er
CHARGETYPE DESCRIPTION
zero or more
LINENUM
The following table shows you the mapping between Receivables database columns and the elements of the Process Invoice XML message for the invoice lines.
INVLINE
Source AR_XML_INVOICE_LINE_V.line_amount AR_XML_INVOICE_LINE_V.unit_selling_p rice AR_XML_INVOICE_LINE_V.quantity AR_XML_INVOICE_LINE_V.line_number AR_XML_INVOICE_LINE_V.description AR_XML_INVOICE_LINE_V.item.descripti on AR_XML_INVOICE_LINE_V.item AR_XML_INVOICE_LINE_V.uom AR_XML_INVOICE_LINE_V.line_type AR_XML_INVOICE_LINE_V.reference_nu mber AR_XML_INVOICE_LINE_V.supplier_code Supplier PurchaseOrder AR_XML_INVOICE_LINE_V.po_number AR_XML_INVOICE_CHARGE_V.charge_a mount AR_XML_INVOICE_CHARGE_V.line_type AR_XML_INVOICE_CHARGE_V.descriptio n AR_XML_INVOICE_CHARGE_V.line_num ber
zero or more
INVCHARGE.LINENUM
DESCRIPTIN
CONFIRM
Value
Target (PLSQL) AR_CONFIRMATION.initiate_ confirmation_process.P_ID. ar_document_transfers.docume nt_transfer_id:ra_customer_trx. customer_trx_id:ra_customer_t rx_lines.customer_trx_line_id Passed from Receivables to your customer's payables system.
zero or more
CONFIRMMSG.REASONC ODE
zero or more
CONFIRMMSG.DESCRIPT N
Transaction Limitations
This feature has certain limitations. They include the following: You can only send invoices, debit memos, credit memos, chargebacks, and deposits as XML documents. To disable the delivery of XML invoice documents to a customer, you must remove the customer's bill-to site from the Trading Partner Setup window in XML Gateway.
Index
A
account derivation rules, A-12 accounting account derivation rules, A-12 accounting event class options, A-4 application accounting definitions, A-15 applications, A-2 event classes and types, A-3 event entities, A-3 journal lines definitions, A-13 journal line types, A-6 predefined data, A-1 process categories, A-4 sources and assignments, A-5 subledger accounting methods, A-17 accounting event class options, A-4 Adjustment API Ar_Adjust_pub.Approve_Adjustment, 2-12 Ar_Adjust_pub.Create_Adjustment, 2-3 Ar_Adjust_pub.Modify_Adjustment, 2-17 Ar_Adjust_pub.Reverse_Adjustment, 2-22 messages, 2-24 overview, 2-1 usage, 2-1 APIs Adjustment API, 2-1 Adjustment API usage, 2-1 Credit Memo Application API, 4-1 Credit Memo Application API usage, 4-1 Credit Memo Approval and Creation API, 3-1 Credit Memo Approval and Creation API usage, 3-2 Deposit API, 5-1 Deposit API usage, 5-1 features, 1-1 Invoice Creation API, 6-1 Invoice Creation API usage, 6-2 Prepayments API, 7-1 Prepayments API usage, 7-2 Receipt API, 8-1 Receipt API usage, 8-2 Revenue Adjustment API, 9-1 Revenue Adjustment API usage, 9-2 solution outline, 1-3 application accounting definitions, A-15 applications, A-2 AutoInvoice AR_INTERFACE_CONTS_ALL, B-59 RA_INTERFACE_DISTRIBUTIONS_ALL, B54 RA_INTERFACE_ERRORS_ALL, B-60 RA_INTERFACE_LINES_ALL, B-1 RA_INTERFACE_SALESCREDITS_ALL, B-50 table and column descriptions, B-1 AutoLockbox AR_PAYMENTS_INTERFACE_ALL, B-63 assigning values to overflow records, B-79 interface tables and column descriptions, B-63 tables and column descriptions, B-62
C
columns AutoInvoice columns and tables, B-1
Index-1
AutoLockbox columns and tables, B-62 Credit Memo Application API ar_cm_application_pub.activity_application, 4-2 ar_cm_application_pub.activity_unapplication , 4-11 messages, 4-15 overview, 4-1 usage, 4-1 Credit Memo Approval and Creation API AR_CREDIT_MEMO_API_PUB.Create_Reque st, 3-2 AR_CREDIT_MEMO_API_PUB.Get_Request_ Status, 3-9 messages, 3-12 overview, 3-1 usage, 3-2 customers seeded match rules for search, C-1
M
match rules advanced search rule, C-4 basic search rule, C-2 seeded, C-1 messages XML messages mapping, D-1 Messages Adjustment API, 2-24 Credit Memo Application API, 4-15 Credit Memo Approval and Creation API, 312 Deposit API, 5-32 Prepayments API, 7-11 Receipt API, 8-136 Revenue Adjustment API, 9-27
D
Data Quality Management advanced search rule, C-4 basic search rule, C-2 seeded match rules, C-1 Deposit API AR_DEPOSIT_API_PUB.Create_deposit, 5-2 AR_DEPOSIT_API_PUB.insert_non_rev_sales credit, 5-27 messages, 5-32 overview, 5-1 usage, 5-1
O
Oracle Subledger Accounting account derivation rules, A-12 accounting event class options, A-4 application accounting definitions, A-15 applications, A-2 event classes and types, A-3 event entities, A-3 journal lines definitions, A-13 journal line types, A-6 predefined data, A-1 process categories, A-4 sources and assignments, A-5 subledger accounting methods, A-17
E
event classes and types, A-3 event entities, A-3
P
parties seeded match rules for search, C-1 Prepayments API AR_PREPAYMENTS_PUB.Create_Prepaymen t, 7-2 AR_PREPAYMENTS_PUB.Get_Installment, 79 messages, 7-11 overview, 7-1 usage, 7-2
I
Invoice Creation API AR_INVOICE_API_PUB, 6-2 overview, 6-1 usage, 6-2
J
journal lines definitions, A-13
Index-2
S Q
QuickCash tables, B-62 seeded match rules, C-1 sources and assignments, A-5 subledger accounting methods, A-17
R
Receipt API Ar_receipt_api_pub.activity_application, 8-75 Ar_receipt_api_pub.activity_unapplication, 882 Ar_receipt_api_pub.Apply, 8-21 Ar_receipt_api_pub.Apply_on_account, 8-61 Ar_receipt_api_pub.apply_open_receipt, 8-111 Ar_receipt_api_pub.apply_other_account, 8100 Ar_receipt_api_pub.Create_and_apply, 8-35 Ar_receipt_api_pub.Create_apply_on_acc, 8120 Ar_receipt_api_pub.Create_cash, 8-3 Ar_receipt_api_pub.Create_misc, 8-86 Ar_receipt_api_pub.Reverse, 8-70 Ar_receipt_api_pub.Unapply, 8-55 Ar_receipt_api_pub.Unapply_on_account, 866 Ar_receipt_api_pub.unapply_open_receipt, 8117 Ar_receipt_api_pub.unapply_other_account, 8-107 messages, 8-136 overview, 8-1 usage, 8-2 receipts QuickCash tables, B-62 Revenue Adjustment API AR_RevenueAdjust_PUB.Add_Non_Revenue _Sales_Credits, 9-23 AR_RevenueAdjust_PUB.Earn_Revenue, 9-16 AR_RevenueAdjust_PUB.Transfer_Sales_Cred its, 9-18 AR_RevenueAdjust_PUB.Unearn_Revenue, 92 messages, 9-27 overview, 9-1 usage, 9-2
T
tables AR_INTERFACE_CONTS_ALL, B-59 AutoInvoice tables and column descriptions, B-1 AutoLockbox tables and columns, B-62 Lockbox interface table and columns, B-63 RA_INTERFACE_DISTRIBUTIONS_ALL, B54 RA_INTERFACE_ERRORS_ALL, B-60 RA_INTERFACE_LINES_ALL, B-1 RA_INTERFACE_SALESCREDITS_ALL, B-50 receipt and QuickCash tables, B-62
X
XML limitations, D-6 mapping, D-1
Index-3