Skip Headers

Oracle iReceivables Implementation Guide
Release 12.1
Part Number E13659-04
Go to Table of Contents
Contents
Go to previous page
Previous
Go to next page
Next

Setting Up iReceivables

This chapter covers the following topics:

Setup Tasks in Oracle E-Business Suite for iReceivables

You must complete these setup tasks in Oracle iReceivables. Use the checklist in this section to help you complete the appropriate setup steps in the correct order.

Note: You must have the URL for the Oracle E-Business Suite login.

Before you can set up Oracle iReceivables, you must complete these Prerequisite tasks:

The following table lists the required setup steps in Oracle iReceivables.

Required Setup Tasks in Oracle iReceivables
Step Number Step Description
1 Define iReceivables Internal Users. See: Define iReceivables Internal Users.
2 Define iReceivables External Users and Customer Access. See: Define iReceivables External Users and Customer Access.
3 Index the Customer Database. See: Index the Customer Database
4 Define Currencies for Customers and Customer Bill-To Sites. See: Define Currencies for Customers and Customer Bill To Sites.
5 Define Receipt Class and Payment Method. See: Define Receipt Class and Payment Method.
6 Assign iReceivables Payment Methods. See: Assign iReceivables Payment Methods.
7 Set up Document Sequencing for iReceivables Receipts. See: Set Up Document Sequencing for iReceivables Receipts.

The following table lists the optional setup steps in Oracle iReceivables.

Optional Setup Tasks in Oracle iReceivables
Step Number Step Description
1 Define Function Security. See: Define Function Security.
2 Set Up Rules, Profile Options, and System Parameters. See: Set Up Rules, Profile Options, and System Parameters.
3 Set Up for Self Registration. See: Set Up for Self Registration.
4 Set Up for Anonymous User Login. See: Set Up for Anonymous User Login.
5 Set Up for Applying On-Account Credits. See: Set Up for Applying On-Account Credits.
6 Define Service Charges. See: Define Service Charges.
7 Set the Grace Period for Discounts. See: Set the Grace Period for Discounts.
8 Review and Update Receivables Lookups. See: Review and Update Receivables Lookups.
9 Set the Aging Information. See: Set the Aging Information.
10 Set the Profile Option for ACH Bank Account Transfer Payments. See: Set the Profile Option for ACH Bank Account Transfer Payments.
11 Modify the Display of Account Information. See: Modify the Display of Account Information.
12 Integrate iReceivables into Your Business Processes. See: Integrate iReceivables into Your Business Processes.

Related Topics

Setting Up, Oracle Receivables Implementation Guide

Setting Up Oracle Workflow, Oracle Workflow Administrator's Guide

Configuring Oracle Payments, Oracle Payments Implementation Guide

Understanding Oracle Payments, Oracle Payments User's Guide

Define iReceivables Internal Users

Define your internal users for iReceivables. Internal users are the personnel in your company, such as collectors and salespersons, who have access to iReceivables customer information. Internal users have access to the full customer search capability to display customer information.

Note: You must have access to the system administrator responsibility to perform this setup step.

Use the Users window to assign the responsibility iReceivables 2.0 Internal to each user in your company that you want to have access to iReceivables. If you are using the Multi Print feature, you must also enter the user's e-mail address.

To define iReceivables internal users:

  1. Select the System Administrator responsibility.

  2. Navigate to the Users window.

  3. Query or enter the users in your company that you want to have access to iReceivables.

  4. If you are using the Multi Print feature, enter the e-mail address of the first user in the E-Mail field. The Multi Print feature sends an e-mail notification to this address after the Receivables Invoice Print concurrent program finishes.

  5. Open the Direct Responsibilities tabbed region for this user.

  6. In the Responsibility field, enter iReceivables 2.0 Internal.

  7. In the From and To fields, enter the effective dates for this user.

  8. Save your work.

  9. Repeat steps 4 to 8 for each internal user.

Related Topics

Printing Transactions, Oracle Receivables User Guide

Entering and Updating Customer Information, Oracle Receivables User Guide

ORACLE Users Window, Oracle E-Business Suite System Administrator's Guide - Configuration

Define iReceivables External Users and Customer Access

Define your external users and their level of customer access to iReceivables. You can provide external users with access to their own bill-to site only, or to multiple customers, or customer sites, or both, by assigning users the customer contact role Self Service User. An external user has access to the search criteria “customer names” and “transaction numbers” to display account information for each applicable customer and customer site.

For business-to-business external users, use the Contact: Roles region of the Customers - Standard window to assign iReceivables external users to customers and customer sites with the customer contact role Self Service User. For business-to-consumer external users, use the Customers - Standard window header region to enter users with the customer type Person. For both types of external user, you then use the Users window to assign the external users the responsibility iReceivables Account Management and the corresponding customer contact or person. If you are using the Multi Print feature, you must also enter the user's e-mail address.

Note: You cannot assign an external user to a customer site that belongs to a different organization ID.

External users can also register themselves by logging through Register Here link using the Self Registration feature. See: External User Self Registration

Customer Access and Indexing the Customer Database

The Customer text data creation and indexing concurrent program indexes the customer information in your database. The program provides the parameter Build Compact Index? the first time that you run the program to perform either full indexing or compact indexing. The compact indexing option omits customer contact information from the build.

Because the customer contact name is one of the search criteria iReceivables internal users have available to search for customers, you must ensure that you build your customer index with the Build Compact Index? parameter set to No. See: Index the Customer Database for more information.

Defining iReceivables External Users

By default, users with the iReceivables Account Management responsibility have access to the Manage Customer Account Access link, for use with the iReceivables Self Registration feature. If you do not plan to use Self Registration, then please remove this function from the iReceivables Account Management responsibility using function security. See: Set Up for Self Registration.

To define an iReceivables external user for Business-to-Business Setup, with access to one site only or to multiple customer sites for a single customer:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Customers - Standard window.

  3. Query or enter the first customer that you want.

  4. Navigate to the Addresses tabbed region and choose the customer address that you want.

  5. Open the Contacts: Roles tabbed region.

  6. Enter the name of the external user and the user's contact information.

  7. In the Description field, enter the role Self Service User.

  8. Save your work.

  9. To assign this user to a second site of the same customer, first repeat steps 4 and 5.

  10. In the Number field, choose the external user name that you entered in step 6 from the list of values.

  11. In the Description field, enter the role Self Service User.

  12. Save your work.

  13. To assign this user to additional sites of the same customer, repeat steps 9 to 12.

  14. Select the System Administrator responsibility.

  15. Navigate to the Users window.

  16. Enter the User Name and Password of the external user.

  17. In the Customer Name field, choose any version of the external user's name that you defined in step 6 from the list of values.

  18. If you are using the Multi Print feature, enter the user's e-mail address in the E-Mail field. The Multi Print feature sends an e-mail notification to this address after completion of the Receivables Invoice Print concurrent program.

  19. Open the Direct Responsibilities tabbed region.

  20. In the Responsibility field, enter iReceivables Account Management.

  21. In the From and To fields, enter the effective dates for this user.

To define an iReceivables external user for Business-to-Business Setup, with access to multiple customer sites for multiple customers:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Customers - Standard window.

  3. Query or enter the first customer that you want to assign to an external user.

  4. Open the Contacts: Roles tabbed region.

  5. Enter the name of the external user and the user's contact information.

  6. In the Description field, enter the role Self Service User.

  7. Save your work.

  8. Query the next customer that you want in the Customer Name or Number field.

  9. Open the Contacts: Roles tabbed region.

  10. In the Last field, choose the external user name that you entered in step 5 from the list of values.

  11. In the Description field, enter the role Self Service User.

  12. Repeat steps 8 to 11 for all customers that you want to assign to this external user.

  13. Save your work.

  14. Select the System Administrator responsibility.

  15. Navigate to the Users window.

  16. Enter the User Name and Password of the external user.

  17. In the Customer Name field, choose any version of the external user's name that you defined in step 6 from the list of values.

  18. If you are using the Multi Print feature, enter the user's e-mail address in the E-Mail field. The Multi Print feature sends an e-mail notification to this address after completion of the Receivables Invoice Print concurrent program.

  19. Open the Direct Responsibilities tabbed region.

  20. In the Responsibility field, enter iReceivables Account Management.

  21. In the From and To fields, enter the effective dates for this user.

To define an iReceivables external user for Business-to-Consumer Setup:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Customers - Standard window.

  3. Query or enter the customer that you want.

  4. Assign the user the Customer Type Person and enter the necessary Person party details.

  5. Save your work.

  6. Select the System Administrator responsibility.

  7. Navigate to the Users window.

  8. Enter the User Name and Password of the external user.

  9. In the Customer Name field, choose any version of the external user's name that you defined in step 4 from the list of values.

  10. If you are using the Multi Print feature, enter the user's e-mail address in the E-Mail field. The Multi Print feature sends an e-mail notification to this address after completion of the Receivables Invoice Print concurrent program.

  11. Open the Direct Responsibilities tabbed region.

  12. In the Responsibility field, enter iReceivables Account Management.

  13. In the From and To fields, enter the effective dates for this user.

Related Topics

Printing Transactions, Oracle Receivables User Guide

Entering and Updating Customer Information, Oracle Receivables User Guide

ORACLE Users Window, Oracle E-Business Suite System Administrator's Guide - Configuration

Index the Customer Database

Run the Customer text data creation and indexing concurrent program to index the customer information in your applications database. The first time that you run the Customer text data creation and indexing concurrent program, the program builds the indexes in your database. Therefore, depending on the volume of your customer data, the first run may take a fairly long time to complete.

The Customer text data creation and indexing concurrent program includes the parameter Build Compact Index? to control the level of indexing when you first build your customer index. Enter No to build the index with customer, customer site, customer contact, and customer site contact information. Enter Yes to build the index with customer and customer site information only, without contact information. The default value is Yes. If you run the concurrent program without any parameter, the system will default it to Yes and build the index without contact information.

Note: The index only includes customer contacts and customer site contacts that have roles assigned to them, with one role marked as primary.

Note: If you plan to assign external users the contact role Self Service User for customers and customer sites, you must build your index with the Build Compact Index? parameter set to No.

After you build customer indexes, schedule a regular run of the Customer text data creation and indexing concurrent program, in accordance with your business practices, to update the index with the changes to your customer data. A regular run of this program ensures that all updates to your customer data are available to the iReceivables customer search engine. Subsequent runs of the Customer text data creation and indexing concurrent program act upon updates only, and therefore should take much less time to complete.

Note: Whenever you make changes to customer data, these changes are not available to the iReceivables customer search engine until the next time that the concurrent program runs and recreates the interMedia index.

To build the customer indexes in your applications database:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Submit Request window.

  3. In the Name field, choose Customer text data creation and indexing from the list of values.

  4. In the Build Compact Index? field, enter:

  5. Choose the Schedule button.

  6. In the Schedule window, choose Once.

To schedule a regular update of your customer indexes:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Submit Request window again.

  3. In the Name field, choose Customer text data creation and indexing from the list of values.

  4. Choose the Schedule button.

  5. In the Schedule window, choose Periodically.

  6. In the Start At and End At fields, set the date and time for this program run.

  7. In the Re-run Every field, enter 1 Day.

Related Topics

Request Submission, Oracle E-Business Suite User's Guide

Define Currencies for Customers and Customer Bill To Sites

The list of available currencies in the Account Summary page and the Account Details page is based either on the profile amounts or on the amounts enabled in the credit profile. You can specify these profiles at the customer level and customer site level. If a currency code does not exist in either of these two profiles at the customer or any customer site level, then iReceivables cannot display the customer's transactions in that currency.

Use the Customers window to define credit profiles and profile amounts for your iReceivables customers and customer bill-to sites.

To define currencies for a customer:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Customer Summary or the Customers window.

  3. Query the customer that you want.

  4. Open the Profile: Transaction tabbed region.

  5. Enter a Profile Class.

  6. To assign a profile class to a customer site, open the Addresses tabbed region, select the address, then choose Open. Repeat steps 4 and 5.

  7. Open the Profile: Amounts tabbed region.

  8. In the Curr column, set the currency or currencies that this customer uses.

Related Topics

Defining Customer Profile Classes, Oracle Receivables Implementation Guide

Assigning Profile Classes to Customers, Accounts, or Addresses, Oracle Receivables Implementation Guide

Define Receipt Class and Payment Method

If you are using the Pay Invoice function, define at least one receipt class and payment method for each iReceivables payment instrument that you intend to use:

If you use Receivables direct debit, you can process bank account transfer payments globally. If you use payment methods via Payments, then payment processing is restricted according to the Payments servlets.

A user can pay all open invoices in one payment transaction. You can also let the user make a partial payment on the entire open invoice balance. If the user is paying multiple invoices across multiple bill-to sites, Receivables creates the receipt using the primary payment method specified at the customer level. For payments of multiple invoices across multiple bill-to sites, you must provide specific settings to use the payment methods that you assign to customers and customer sites. See: Assign iReceivables Payment Methods for more information.

If you already use Oracle Receivables direct debit to mark invoices for automatic direct debit processing, you can let your customers pay their invoices by direct debit. Create a payment method for standard Receivables direct debit with a manual creation method. If you set this payment method as the default bank account transfer payment method, then Receivables can process your customer bank account transfer payments via direct debit.

For bank account transfers, both direct debit and ACH transfer, you must run the Receivables remittance program to capture funds.

For credit card payments, define a receipt class and payment method to enable credit card payment authorization and capture of funds using either a one-step remittance method or a two-step remittance method. In a one-step remittance method, iReceivables authorizes and captures the funds in the same process. In a two-step remittance method, iReceivables only authorizes the credit card charge. You must run the Receivables remittance program to capture funds.

Credit Card One-Time Payment

A user can make a “one-time payment” of open invoices with a credit card. iReceivables processes the transaction using the credit card but does not save the credit card information.

If you intend to use the credit card one-time payment feature, you must:

Additional Credit Card Verification

Use the Payments Setup Administrator responsibility under Oracle Payments to set up the credit card verification details. See: Setting Up System Security Options, Oracle Payments Implementation Guide.

Note: iReceivables uses the card security code for verification purposes only and does not save the information but it saves the cardholder billing address.

Oracle Payments and Supported Currencies

Oracle Payments manages external processing of credit card payments and ACH bank account transfers. The banks and currencies supported by Payment are determined by the Payment servlets.

Note: Please consult Oracle Payment User's Guide for the current list of Payments servlets and the currencies they support.

For credit card processing, you can use the Payments integration with Verisign, which supports transactions in US dollars (USD) and Canadian dollars (CAD) only. You can also use the Payments integration with Paymentech, which supports transactions in any currencies supported by Visa and Master Card. For ACH bank account transfers, you can use the Payments integration with Chase Merchant Services, which supports transactions in US dollars (USD) only.

If your company uses the Verisign payment system, you cannot set up multiple bank accounts with multiple currencies for one payment method. Set up a single payment method for either USD or CAD, and assign a merchant ID and remittance bank that supports the corresponding currency. If your company uses a payment system other than Verisign, you can set up a single payment method for multiple bank accounts with multiple currencies, if your payment system supports it.

Note: iReceivables does not support cross-currency payments. Though a user can still pay invoices with a credit card or bank account that has a different currency from that of the invoice, the receipt created in iReceivables will have the same currency as the invoice.

To define a receipt class and payment method for iReceivables:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Receipt Classes window.

  3. Enter a Name for this receipt class. You may want to enter a name that identifies this receipt class for iReceivables.

  4. Leave the Notes Receivable and Require Confirmation boxes unchecked.

  5. Enter a Creation Method of:

  6. Enter a Remittance Method of:

  7. Enter a Clearance Method of Directly, By Automatic Clearing, or By Matching, according to your business practice.

  8. Enter a Payment Method Name. You may want to enter a name that identifies the type of payment, such as iReceivables direct debit, iReceivables 2-step credit card, or iReceivables ACH.

  9. Enter a name in the Printed Name field. For example, iReceivables Credit Card.

  10. Leave the Debit Memos Inherit Receipt Numbers box unchecked.

    If you are defining a direct debit payment method, go to step 18.

  11. Enter the number of receipts rule according to your business practice. This field is not used by iReceivables.

  12. Enter receipt maturity date rule according to your business practice. This field is not used by iReceivables.

  13. Leave the Receipts Inherit Transaction Numbers box unchecked.

    iReceivables uses document sequences to number credit card or bank account transfer receipts.

  14. Enter the automatic print program according to your business practice.

  15. Enter the lead days according to your business practice.

  16. In the Payment Type field, enter:

  17. If you entered a payment type of Credit Card, enter your Merchant ID number. This number is usually provided by your bank or credit card issuer. Your credit card vendor requires this number to process credit card transactions.

    The Merchant ID that you provide here is the same as the Payee Identifier that you entered when you created the payee in the Payments Administration user interface. You can view the Payee Identifier in the Payments Payee Details window.

  18. Enter the range of Effective Dates for this payment method.

  19. Choose the Bank Accounts button to assign a remittance bank to this payment method.

    If this payment method is for ACH bank account transfers using Payments, you must provide a valid bank number for the bank associated with the account that you are linking to.

    Note: Because iReceivables does not support cross-currency payments, you must ensure that the bank account assigned to your default credit card and bank account transfer payment methods are in the same currency as your customer invoices.

  20. Save your work.

  21. Assign the iReceivables payment methods that you defined to the Receivables System Options window, Customers - Standard window, and Customer Addresses window according to your business practice. See: Assign iReceivables Payment Methods for more information.

  22. For ACH bank account transfer, perform this additional step:

    Set the OIR: Maximum Future Payment Days Allowed profile option to the maximum number of days that users can enter future-dated payments according to your business practices. Setting a maximum future payment date, for example, prevents users from entering exaggerated future payment dates.

    By default, iReceivables reads the profile option setting for all customers and customer sites. If necessary, modify the ARI_CONFIG. get_max_future_payment_date function according to your business requirements to set this function at the customer level and customer site ID level.

Related Topics

Understanding Oracle Payments, Oracle Payments User's Guide

About Remittances, Oracle Receivables User Guide

Integration with Other Oracle E-Business Suite, Oracle Payments Implementation Guide

Receipt Methods, Oracle Receivables Implementation Guide

Oracle Receivables Profile Options, Oracle Receivables Implementation Guide

Assign iReceivables Payment Methods

Assign the iReceivables payment methods that you defined in Oracle Payments and Supported Currencies to the Receivables System Options window, Customers - Standard window, and Customer Addresses window according to your business practice.

Use the Receivables System Options window to assign a default iReceivables payment method for credit card payments and bank account transfers. Use the Customers - Standard window and the Customer Addresses window to assign iReceivables payment methods to specific customers and specific customer bill-to sites.

Payment method assignments take precedence in the order:

Mark one payment method of each type as Primary at the customer and customer site level. If at the customer site level there are two or more payment methods of the same type, the payment method marked as primary is taken as the payment method for transactions billed to this site. If no payment method of the same type is marked as primary, then the payment method at the customer level is taken as the payment method for transactions billed to this site.

For credit card payments of multiple invoices across multiple bill-to sites, Receivables only uses the primary payment methods defined at the customer and customer site level if the payment methods are set up in this way:

For ACH payments of multiple invoices across multiple bill-to sites, Receivables uses the primary payment methods defined at the customer and customer site level as long as the associated receipt class does not have a Remittance Method of No Remittance.

To assign iReceivables payment methods:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Receivables System Options window.

  3. Open the Miscellaneous tabbed region.

  4. Enter an iReceivables credit card payment method in the Credit Card Payment Method field.

  5. Enter an iReceivables direct debit or ACH bank account transfer payment method in the Bank Account Payment Method field.

  6. Navigate to the Customers - Standard window.

  7. Query or enter the first customer that you want.

  8. Navigate to the Payment Methods tabbed region to assign iReceivables payment methods to this customer. Mark only one payment method of each type as Primary.

  9. In the Addresses tabbed region, choose the customer address that you want.

  10. Navigate to the Payment Methods tabbed region to assign iReceivables payment methods to this customer bill-to site.

  11. Save your work.

  12. Repeat steps 7 to 11 for each customer and customer bill-to site that you want.

Related Topics

Entering and Updating Customer Information, Oracle Receivables User Guide

Defining Receivables System Options, Oracle Receivables Implementation Guide

Set Up Document Sequencing for iReceivables Receipts

Set up document sequences to assign sequence numbers to your iReceivables credit card receipts and bank account transfer receipts.

Note: You must have access to the System Administrator responsibility to perform this setup step.

To set up document sequencing for iReceivables receipts:

  1. Select the System Administrator responsibility.

  2. Navigate to the System Profile Values window.

  3. Set the Sequential Numbering profile option to Always Used or Partially Used.

  4. Save your work.

  5. Navigate to the Document Sequences window.

  6. In the Name field, enter a document sequence name that identifies this sequence for iReceivables receipts, such as iReceivables Credit Card Receipts.

  7. In the Application field, enter Oracle Receivables.

  8. In the From and To fields, enter the effective dates for this document sequence.

  9. In the Type field, enter Automatic or Gapless.

  10. Complete the fields for this document sequence.

  11. Save your work.

  12. Navigate to the Sequence Assignments window.

  13. In the Application field, enter Oracle Receivables.

  14. In the Category field, enter the document category created by the corresponding iReceivables payment method you defined in Oracle Payments and Supported Currencies.

  15. In the Method field, enter Automatic.

  16. Open the Assignment tabbed region.

  17. Enter the Start and End Dates for this sequence assignment.

  18. In the Sequence field, enter the name of the document sequence that you defined in step 6.

  19. Save your work.

  20. Repeat steps 5 to 19 for each document sequence that you want to define for iReceivables.

Related Topics

Document Sequences, Oracle E-Business Suite System Administrator's Guide - Configuration

Define Function Security

Use function security to limit access to iReceivables functionality for selected users. Define a new responsibility based upon iReceivables 2.0 Internal or iReceivables Account Management with the limited access that you want and assign this new responsibility to your internal users or to external customers or customer sites.

You can use function security in these situations:

To define function security for an iReceivables user:

  1. Select the System Administrator responsibility.

  2. Navigate to the Responsibilities window.

  3. In the Responsibility Name field, enter a new responsibility name.

  4. In the Application field, enter Oracle Receivables.

  5. In the Responsibility Key field, enter the new responsibility name that you defined above.

  6. In the Available From region, choose the Oracle Self Service Web Applications radio button.

  7. In the Data Group Name field, enter Standard.

  8. In the Data Group Application field, enter Oracle Receivables.

  9. In the Menu field, choose iReceivables 2.0 Internal from the list of values for internal users or iReceivables Account Management for external users.

  10. Open the Menu Exclusions tabbed region.

  11. In the Type field, enter Function.

  12. In the Name fields, enter:

  13. Save your work.

  14. Navigate to the Users window.

  15. Query or enter the first user that you want.

  16. Open the Responsibilities tabbed region.

  17. In the Responsibility field, enter the new responsibility that you defined above.

  18. In the From and To fields, enter the effective dates for this user.

  19. Save your work.

  20. Repeat steps 15 to 19 for each user that you want to assign this responsibility.

Related Topics

Responsibilities Window, Oracle E-Business Suite System Administrator's Guide - Security

Set Up Rules, Profile Options, and System Parameters

Use the setup checklist page to set up profile options, rules and system parameters for different functions of iReceivables.

You must have access to the iReceivables Setup responsibility to perform this setup step.

Important: In iReceivables Release 12, the rules set precedence over profile options. First the rules are checked for values and then the profile options are checked.

The setup checklist page gives access to the following setups:

Set Up Rules

To set up rules:

  1. Click Go To Task from the setup checklist page to view rules.

  2. Two types of rules can be setup from this page; Global Rules Setup and Operating Unit Dependent Rules Setup.

Set Up Profile Options

To set up profile options:

  1. Click Go To Task to view profiles.

    The following profile options can be set:

  2. Select the profile option and click Go to display its properties.

  3. Click Update to change the profile option details.

Set Up System Parameters

To set up system parameters:

  1. Click Go To Task to view system parameters.

  2. Select the organization for which you want to set the system parameter.

    You can set for the following parameters:

  3. Click Update to change the system parameters details.

Set Up for Self Registration

The iReceivables Self Registration feature lets your customers register for iReceivables Account Management (application) access to their customer account data. To register, a customer clicks a link that you create on your portal page to access the Self Registration pages. On the Self Registration pages, an external user is given three attempts to answer a challenge/response question correctly (this is a transactional question pertaining to the applicable customer account). If all three attempts are unsuccessful, the user is only able to re-register according to the Self Registration profile option settings that you specify.

See: Set Up Rules, Profile Options, and System Parameters.

If registration is successful, iReceivables creates a user account, assigns the user the customer contact role Self Service User, and forwards the customer the information necessary to access customer account data.

Note: After successful registration, this new customer contact is not available to the iReceivables customer search engine until the next running of the Customer text data creation and indexing concurrent program. See: Index the Customer Database for more information.

A user can register for additional accounts using either the:

Prerequisites

Before you can complete set up of iReceivables for Self Registration, you must:

Setup Tasks

To set up iReceivables Self Registration:

  1. Set up iReceivables Self Registration for external users.

  2. In Oracle E-Business Suite, select the System Administrator responsibility.

  3. Assign the iReceivables Registration responsibility to the pre-seeded guest user account specified by the Guest User Password profile option.

    1. Navigate to the System Profile Values window.

    2. In the Profile field, enter the user account that you want and make note of the value (value format: user/password).

    3. Navigate to the Users window.

    4. In the User Name field, query the value of the same user account.

    5. Navigate to the Responsibilities tabbed region.

    6. Add the iReceivables Registration and iReceivables Account Management responsibilities.

  4. Assign an e-mail address to the Contact Us global icon.

    Enter the e-mail address of your Self Registration administrator (or other qualified user responsible for answering inquiries from external users about Self Registration).

    1. Navigate to the Form Functions window.

    2. Query the function ARI Self Registration Contact Us.

    3. Choose the Web HTML tab.

    4. Enter the Self-Registration administrator's e-mail address in the HTML Call field, using the format: mailto:<userid>@<domain>.com.

    Note: You may need to restart your web server for the update to take effect.

  5. Switch to the Applications Developer responsibility.

  6. Use the Message Dictionary to configure the FND confirmation messages that you send to users after successful registration.

    The messages that you need to configure contain this information:

Related Topics

User Profiles, Oracle E-Business Suite System Administrator's Guide - Maintenance

Profile Options in Oracle Application Object Library, Oracle E-Business Suite System Administrator's Guide - Maintenance

Form Functions Window, Oracle E-Business Suite System Administrator's Guide - Security

Message Dictionary, Oracle E-Business Suite Developer's Guide

Defining Workflow Process Components, Oracle Workflow Developer's Guide

Managing Business Events, Oracle Workflow Developer's Guide

Set Up for Anonymous User Login

The iReceivables Anonymous User Login feature lets your customers access customer account data without owning or registering for a user account. You can use this feature, for example, for bill collections to let users access account data to view and pay open invoices.

External users access their account data using the Anonymous Login page. The Anonymous Login page prompts the user for an account number, and then redirects to the iReceivables page of your choice. The available pages for redirect are the Customer Search page, the Account Home page, the Account Details page, or an Anonymous Login Error page.

The Anonymous Login feature is contained in the jsp file AnonymousLogin.jsp. Use this jsp file to validate the guest user, create a session and redirect to the iReceivables page that you want, and customize the number of parameters passed to the API. By default, the information entered by the user in the Account Number field on the Anonymous Login page is passed to the API.

The setup tasks for anonymous user login include:

Caution: The iReceivables 2.0 Anonymous Internal responsibility by default has access to all the application features available to the registered user. Please carefully enable or disable the features accessible to the anonymous user.

To set up iReceivables for anonymous user login:

  1. Update the .htm files for the Anonymous Login page and the Anonymous Login Error page. The anonymous login .htm files are:

    /html/US/ARIANLGN.htm 120.0
    /html/US/ARIANERR.htm 120.0
    

    To successfully access the anonymous login pages, modify these .htm files. If you want to support multiple languages, you can copy these files, modify the alert in the logon_submit() function and any other language dependent attributes, and place the modified files in the appropriate directory structure. Place the modified static HTML pages in the directory:

    $OA_HTML/[country code]/
    

    where: [country code] - Uppercase ISO 3166 2-letter code

  2. In Oracle E-Business Suite, select the System Administrator responsibility.

  3. If necessary, use function security to limit user access to functionality in the iReceivables Account Management responsibility. See: Define Function Security for more information.

  4. Assign the iReceivables anonymous login responsibility that you defined in step 3 to the pre-seeded guest user account specified by the Guest User Password profile option.

    1. Navigate to the System Profile Values window.

    2. In the Profile field, enter Guest User Password and make note of the value (value format: user/password).

    3. Navigate to the Users window.

    4. In the User Name field, query the value of the Guest User Password account.

    5. Navigate to the Responsibilities tabbed region.

    6. Add the iReceivables anonymous login responsibility that you defined above.

  5. Modify the SQL code in AnonymousLogin.jsp.

    Add any parameters that you need as name-value pairs to the HashMap structure hParams, according to this example:

    HashMap hParams = new HashMap();
    hParams.put("Ircustomerid",sCustId);
    

    In this example, the code adds a parameter named IrcustomerId and its value sCustId to the hash table. An illustration is provided in the file for Customer Site ID.

    This table outlines the page-level semantics, and mandatory and optional parameters, for each iReceivables page.

    Page Function Mandatory Parameters Optional Parameters Other Semantics
    Customer Search ARI_INTERNAL_PAGE N/A N/A For internal users.
    Customer Search ARI_EXTERNAL_PAGE N/A N/A For external users.
    Note: If you are redirecting the user to the Customer Search page, then you must assign the Guest user a customer. See: Define iReceivables External Users and Customer Access.
    Home ARIHOME Ircustomerid=<id> Ircustomersiteuseid=<site_id> N/A
    Account Details ARIACCOUNT Ircustomerid=<id> Ircustomersiteuseid=<site_id> Iracctdtlstype_ext=<type> Iraccountstatus_ext=<status> Values for <type> are from the lookup ARI_ACCOUNT_DETAILS_TYPE.
    Values for <status> are from the lookup ARI_ACCT_STATUS. If you are using aging buckets, then you can also use aging status codes. The format for the aging status code is:
    OIR_AGING_ +<days from> + <days to>

    Note: You must have a corresponding aging bucket defined for <days from> and<days to>.

Set Up for Applying On-Account Credits

Set up iReceivables to let your customers apply their on-account credits to open debit transactions, including invoices, debit memos, and deposits. Customers can:

Enabling on-account credits displays the Apply Credits button on the Account Details, Transaction List, Invoice, and On-Account Credit Memos pages. Choosing the Apply Credits button takes the user to the Apply Credits pages to select credits and debit transactions to apply.

The setup tasks for enabling on-account credit applications are:

Note: You must have access to the System Administrator responsibility to perform this setup step.

To set up for applying on-account credits:

  1. Select the System Administrator responsibility.

  2. Navigate to the System Profile Values window.

  3. Set the OIR: Apply Credits profile option to Yes.

  4. Save your work.

  5. Select the Receivables responsibility.

  6. Navigate to the Receivables Activities window.

  7. Enter a Name and Description.

  8. Select the Payment Netting Type.

  9. Select Activity GL Account for the GL Account Source.

  10. Enter an Activity GL Account.

  11. Complete the window according to your requirements.

Related Topics

Receivables Activities, Oracle Receivables Implementation Guide

Oracle Receivables Profile Options, Oracle Receivables Implementation Guide

Define Service Charges

You can apply service charges to payments that your customers make using the Pay Invoice function in iReceivables. iReceivables records a service charge as an adjustment to the invoice.

Setup Tasks Using Rules

The setup tasks for applying service charges if you are new to iReceivables are:

See: Set Up Rules, Profile Options, and System Parameters.

Setup Tasks Using Profile Options

The setup tasks for applying service charges for iReceivables Release 11i and earlier releases, are:

To define service charges on invoice payments using iReceivables:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Receivables Activities window.

  3. Enter a Name and Description for the activity.

  4. Enter Adjustment in the Type field.

  5. Complete the Receivables Activities window according to your business requirements.

  6. Save your work.

  7. Remain in the Receivables Activities window with the new activity that you just created. From the Help menu, choose Diagnostics > Examine.

    The Examine window appears.

  8. In the Field field, enter RECEIVABLES_TRX_ID. Make note of the value in the Value field. You will enter this value in the OIR: Service Charge Activity ID profile option (see step 28).

  9. Select the System Administrator responsibility.

  10. Navigate to the System Profile Values window.

  11. Set the Sequential Numbering profile option to Always Used or Partially Used.

  12. Save your work.

  13. Navigate to the Document Sequences window.

  14. In the Name field, enter a document sequence name that identifies this sequence for iReceivables service charges.

  15. In the Application field, enter Oracle Receivables.

  16. In the From and To fields, enter the effective dates for this document sequence.

  17. In the Type field, enter Automatic or Gapless.

  18. Complete the fields for this document sequence.

  19. Save your work.

  20. Navigate to the Sequence Assignments window.

  21. In the Application field, enter Oracle Receivables.

  22. In the Category field, enter the document category created by the Receivables activity that you defined above.

  23. In the Method field, enter Automatic.

  24. Open the Assignment tabbed region.

  25. Enter the Start and End Dates for this sequence assignment.

  26. In the Sequence field, enter the name of the document sequence that you defined in step 14.

  27. Save your work.

  28. Set these profile options for service charges:

  29. By default, iReceivables reads the profile option settings for all customers and customer sites. If necessary, modify the ARI_CONFIG.get_service_charge_activity_id function and ARI_CONFIG.is_service_charge_enabled function according to your business requirements to set these functions at the customer level and customer site ID level.

  30. Set the ARI_SERVICE_CHARGE_PKG.compute_service_charge function to calculate the appropriate service charge. The default calculation is .05% on every transaction in the payment list.

Related Topics

Receivables Activities, Oracle Receivables Implementation Guide

Document Sequences, Oracle E-Business Suite System Administrator's Guide - Configuration

Oracle Receivables Profile Options, Oracle Receivables Implementation Guide

Set the Grace Period for Discounts

You can configure iReceivables to consider the discount grace days for a customer or customer site when calculating and displaying discount amounts for transactions.

Setup Tasks Using Rules

The setup tasks for setting the discount grace days, if you are new to iReceivables are:

See: Set Up Rules, Profile Options, and System Parameters.

Setup Tasks Using Profile Options

The setup tasks for setting the discount grace days for iReceivables Release 11i and earlier releases, are:

  1. Use the OIR: Enable Discount Grace Days profile option to enable or disable the consideration of the grace period. When the grace period is enabled:

  2. The setup tasks for setting the grace period days for discounts are:

Related Topics

Entering Parties and Customer Accounts, Oracle Receivables User Guide

Oracle Receivables Profile Options, Oracle Receivables Implementation Guide

Review and Update Receivables Lookups

Use the Lookups window to review and update Receivables lookup types for use with iReceivables. The lookup types are:

For the lookup types CREDIT_MEMO_REASON and ARI_INVOICE_SECTION, review and update both your seeded and user-defined lookup codes. For the lookup type AR_IREC_CREDIT_CARD_TYPES, update the seeded credit card types that you plan to accept for iReceivables payments.

Note: You cannot modify the seeded lookups for the lookup types CREDIT_MEMO_REASON and AR_IREC_CREDIT_CARD_TYPES. You cannot add new lookup codes for the lookup types ARI_INVOICE_SECTION and AR_IREC_CREDIT_CARD_TYPES.

For the lookup type ARI_CUSTOMER_SEARCH_TYPE, review and update the seeded lookup codes that you want to appear on the Search By poplist on the Customer Search page. If you plan to extend the customer search, define lookup codes for your new customer search attributes. The custom transaction search attributes that you define are queried by the procedure search_custom_customer() in the file ARICNFGB.pls. See: Extending the iReceivables Search for more information.

For the lookup types ARI_ACCOUNT_DETAILS_TYPE and ARI_ACCT_STATUS review and update the seeded lookup codes that you want to appear on the Status and Transaction Type poplists on the Account Details page. If you plan to extend the transaction search, define lookup codes for your new transaction search attributes. The custom transaction search attributes that you define are queried by the procedure search_custom_trx() in the file ARICNFGB.pls. See: Extending the iReceivables Search for more information.

To update Receivables lookups for use with iReceivables:

  1. Select the Receivables Manager responsibility.

  2. Navigate to the Oracle Receivables Lookups window.

  3. In the Type field, query the lookup type that you want.

  4. In the User Name field, enter the user name for the applicable lookup codes.

  5. In the Application field, enter Oracle Receivables. The system displays the lookup codes.

  6. To disable a lookup code, enter a date in the Effective Dates To field or uncheck the Enabled box.

  7. For ARI_CUSTOMER_SEARCH_TYPE and CREDIT_MEMO_REASON, enter Y in the Tag field to make a code available to external users or N to make the code available to internal users only. Replace any null values in the Tag field with Y or N.

  8. Enter any new lookup codes for ARI_CUSTOMER_SEARCH_TYPE and CREDIT_MEMO_REASON that you want.

Related Topics

Lookup Types, Oracle E-Business Suite Developer's Guide

Defining Receivables Lookups, Oracle Receivables Implementation Guide

Set the Aging Information

You can set the aging information for iReceivables users to view their transactions across various age buckets. Your customers can view aging buckets for their accounts in the Account Summary page. By clicking on an aging bucket balance number, the user can drill down to the Account Details page to review all the debit items in the aging bucket, including invoices, chargebacks, guarantees, deposits, and debit memos. The Search list for transaction status in the Account Details page includes each of the active aging buckets as search criteria.

Setup Tasks Using Rules

The setup tasks for applying service charges if you are new to iReceivables are:

See: Set Up Rules, Profile Options, and System Parameters.

Setup Tasks Using Profile Options

The setup tasks for applying service charges for iReceivables Release 11i and earlier releases, are:

  1. Set the OIR: Aging Buckets profile option to display aging information for iReceivables users.

    You can set this profile option at the site, responsibility, and user levels, according to your business practice. You can display the standard aging buckets that Oracle Receivables provides, or you can display the custom buckets that you define in the Receivables Aging Buckets window. If you leave all fields blank, then iReceivables does not display aging buckets.

    To set the aging buckets profile option:

    1. Select the System Administrator responsibility.

    2. Navigate to the System Profile Values window.

    3. Set the OIR: Aging Buckets profile option at the site, responsibility, or user level to display the aging buckets that you want.

Related Topics

Oracle Receivables Profile Options, Oracle Receivables Implementation Guide

Aging Buckets and Interest Tiers, Oracle Receivables Implementation Guide

Set the Profile Option for ACH Bank Account Transfer Payments

Use the OIR: Bank Directory Source profile option to help manage bank account transfer payments for iReceivables via Payments and the ACH network. Setting this profile option lets iReceivables derive the name of the bank or financial institution from the routing number that the customer enters to pay an invoice using an ACH bank account transfer. You use the AR: Bank Directory Source profile option to acquire access to the E-Payment routing directory on the Federal Reserve Financial Services web site (http://www.fedwiredirectory.frb.org). When a customer pays an invoice by ACH bank account transfer with a routing number that is not assigned to a bank in the AP_BANK_BRANCHES table, the routing number is checked against the E-Payment routing directory. iReceivables derives the bank or financial institution name from the E-Payment routing directory using the routing number that the customer entered.

Note: If you set the OIR: Save Payment Instrument Information profile option to No, iReceivables can only accept payment by credit card using a one-step remittance method. You cannot use the ACH bank account transfer to process payments. See: Define Receipt Class and Payment Method for more information.

Set the OIR: Bank Directory Source profile option to Local to access the E-Payment routing directory from a local file that you download from the Federal Reserve Financial Services web site. When the customer enters a routing number that is not assigned to a bank in the AP_BANK_BRANCHES table, iReceivables attempts to derive the bank name using the local table. If the bank name for this routing number is not in the table, iReceivables uses the routing number as the bank name.

To use the local file, you must download the ACH directory from the Federal Reserve Financial Services web site and use SQL*Loader to upload it to the AR_IREC_ACH_BANKS table. See: Download and Upload the E-Payment ACH Directory to a Local Table for information about downloading and uploading the ACH directory.

If you set the OIR: Bank Directory Source profile option to None, Receivables always defaults the routing number as the bank name for the transaction.

Note: You must have access to the system administrator responsibility to perform this setup step.

To set the profile option for ACH bank account transfer payments:

  1. Select the System Administrator responsibility.

  2. Navigate to the System Profile Values window.

  3. Set the OIR: Bank Directory Source profile option to Local or None.

  4. If you set the OIR: Bank Directory Source profile option to Local, then download and upload the E-Payment ACH directory.

    See: Download and Upload the E-Payment ACH Directory to a Local Table.

Download and Upload the E-Payment ACH Directory to a Local Table

If you set the AR: Bank Directory profile option to Local, you must have a copy of the E-Payment ACH directory in your local table. Retrieving the directory involves two steps:

To download and upload E-Payment ACH directory to a local table:

  1. Open your web browser.

  2. Navigate to the Federal Reserve Financial Services web site: http://www.fedwiredirectory.frb.org.

  3. Click Download E-Payments Directories link to go to the Download E-Payments page.

  4. Right-click Receive All Fed ACH Participants link and choose Save Target As.

  5. Save the file in a local file that your Receivables system can access.

  6. In Oracle E-Business Suite, select the System Administrator responsibility.

  7. Navigate to the Request Group window.

  8. In the Group field, query Receivables All.

  9. Add Import Bank Directory to the Requests.

  10. Switch the responsibility from System Administrator to Receivables Manager.

  11. Navigate to the Submit Request window.

  12. In the Name field, choose Import Bank Directory from the list of values.

  13. In the Parameters window, enter in the Data File field the path to the local file that you saved in step 4.

  14. Press the OK button.

  15. Press the Schedule button.

  16. In the Schedule window, choose Once.

  17. Press the OK button.

  18. Press the Submit button to submit the request.

    Note: You can access the Federal Reserve System's terms of use, which apply to the E-Payment Routing Directory, at http://www.frbservices.org/index.cfm.

    Note: ORACLE PROVIDES THE E-PAYMENT ROUTING DIRECTORY ON AN “AS IS” BASIS. ORACLE EXPRESSLY DISCLAIMS ALL WARRANTIES OF ANY KIND, WHETHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. ORACLE MAKES NO WARRANTY THAT: (i) THE E-PAYMENT ROUTING DIRECTORY WILL BE AVAILABLE UNINTERRUPTED, ON A TIMELY BASIS, SECURE, OR ERROR-FREE, AND (ii) THE RESULTS THAT MAY BE OBTAINED FROM THE USE OF THE SERVICE WILL BE ACCURATE OR RELIABLE. IN NO EVENT SHALL ORACLE BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, PUNITIVE OR CONSEQUENTIAL DAMAGES, OR DAMAGES FOR LOSS OF PROFITS, REVENUE, DATA OR DATA USE, INCURRED BY YOU OR ANY THIRD PARTY IN CONNECTION WITH THE E-PAYMENT ROUTING DIRECTORY, WHETHER IN AN ACTION IN CONTRACT OR TORT, EVEN IF ORACLE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ORACLE'S ENTIRE LIABILITY FOR DAMAGES IN RESPECT OF THE E-PAYMENT ROUTING DIRECTORY SHALL IN NO EVENT EXCEED TEN THOUSAND DOLLARS (U.S. $10,000).

Related Topics

Oracle Receivables Profile Options, Oracle Receivables Implementation Guide

Modify the Display of Account Information

You can modify the display of account information in the iReceivables Account Details and Transaction pages (including Invoice, Debit Memo, Deposit, and Payments) using Oracle E-Business Suite Personalization Framework. See: Oracle Application Framework Personalization Guide. By modifying the display of account information in the Account Details and Transactions pages, you can control the regions and fields that your external customers and one-time users have access to.

In addition to displaying the customer's latest account activity, the Account Details page can also display transaction descriptive flexfields and the context field values that you define for them, if you enable these flexfields in the Receivables Transactions window. The flexfields are the Invoice Transaction flexfield and the Transaction Information flexfield. iReceivables stores flexfield information in the ARI_ACCOUNT_INVOICE table. Use the Descriptive Flexfield Segments window to enter context field values for the transaction flexfields.

The Invoice, Debit Memo, and Deposit pages can also display invoice line-level descriptive flexfields and the context field values that you define for them, if you enable these flexfields in the Receivables Transactions window. The flexfields are the Invoice Line Information flexfield and the Line Transaction flexfield. iReceivables stores flexfield information in the ARI_INVOICE_LINES table. Use the Descriptive Flexfield Segments window to enter context field values for the invoice line-level flexfields.

The Payments page can also display the Receipt Information flexfield and the context field values that you define for the flexfield in the Payment Row region. iReceivables can also display the Transaction Information and Invoice Transaction flexfields in the Payment Activities tables for the Account Details, Invoice, and Payment pages.

You make Administrator-level personalization changes while logged in to iReceivables. Administrator-Level (Admin-level) personalizations apply to Function, Localization, Site, Organization, and Responsibility levels.

Controller Class Restrictions

Some restrictions may apply to personalization changes due to the controller class. A controller class is the code that controls how a page is rendered and how events are handled on the page. The restrictions are:

To make Admin-level personalization changes to the Account Details page:

  1. Set the Personalize Self-Service Defn profile option to Yes.

  2. Log in to iReceivables and navigate to the Account Details page for the customer that you want.

  3. Click the available personalization link. These personalization links vary according to the search, but always appear in the Search region of the Account Details page, after the search results table.

To make Admin-level personalization changes to the Invoice page:

  1. Set the Personalize Self-Service Defn profile option to Yes.

  2. Log in to iReceivables and navigate to the Invoice page for the customer that you want.

  3. To display transaction header-level flexfields on the Invoice page, click the personalization link Personalize Invoice Terms Table. To display transaction line-level flexfields in the Invoice page, click the Personalize Invoice Lines Table personalization link.

To make Admin-level personalization changes to the Payments page:

  1. Set the Personalize Self-Service Defn profile option to Yes.

  2. Log in to iReceivables and navigate to the Payments page for the customer that you want.

  3. To display receipt flexfields in the Payments page, click the personalization link Personalize Payment Row. To display transaction line-level flexfields in the Payment page, click the personalization link Personalize Application Table.

Related Topics

Planning and Defining Descriptive Flexfields, Oracle E-Business Suite Flexfields Guide

Creating Admin–Level Personalizations, OA Framework Personalization and Extensibility Guide

Transaction Flexfields, Oracle Receivables User Guide

Integrate iReceivables into Your Business Processes

Find ways to integrate iReceivables into your business processes. Some examples of integrating iReceivables into your business include: