You are on page 1of 7

10/4/2014 Dunning letter setup and usage in Oracle r12 | Oracle Maniacs' Notes

Oracle Maniacs' Notes

INTERESTING, OUT-OF-THE-BOX OR JUST PLAIN INFORMATION


RECEIVABLES

Dunning letter setup and usage in Oracle r12

POSTED BY ABHIJIT ⋅ MARCH 11, 2014 ⋅ 2 COMMENTS


FILED UNDER ASSIGN QUERY, COLLECTION XML DATA SOURCE, COLLECTIONS,
COLLECTIONS ADMINISTRATOR, COLLECTIONS DUNNING REQUEST STATUS REPORT,
COLLECTIONS METHOD SETUP, CUPS, DEFINE DUNNING LETTER SETS,
DELINQUENCIES, DUNNING PLAN, IEX, IEX: FAX, IEX: IPP, IEX: SEND DUNNINGS FOR
DELINQUENT CUSTOMERS, IEX: SMTP, IEX_XML_QUERIES, MANAGE QUERIES, MANAGE
TEMPLATES QUERY, ORACLE COLLECTIONS DELIVERY XML PROCESS, QUERY, QUERY
LEVEL, SCORE COMPONENT, SCORING ENGINE, SETUP CHECKLIST, UNAPPLIED
RECEIPTS, VIEW NAME
The dunning letter setup has improved substantially in Oracle r12. I have illustrated the steps to
set up a dummy Dunning Letter and how to set up a custom Dunning letter report.

Custom Dunning Letter

Create a new query

We have the option to use a seeded query but we would like to create our own custom data
definition. To set a custom dunning letter data definition we need to register the query for the
Dunning letter. We cannot set a custom data template for dunning letter as we normally do for a
XML/BI Publisher report.

Responsibility: Collections Administrator

Navigation: Manage Queries

Create a query

Click on Create Query button

Enter the details

Click on Apply button.

A confirmation message will be displayed showing that the query has been saved.

http://oraclemaniac.com/2014/03/11/dunning-letter-setup-and-usage-in-oracle-r12/ 1/7
10/4/2014 Dunning letter setup and usage in Oracle r12 | Oracle Maniacs' Notes

Important:
The queries are saved in a table called, IEX_XML_QUERIES

1 select * from iex_xml_queries where description = 'XX Dunning Letter Query'

Create a Template

A custom template for Dunning letter can be attached as we attach any other template, i.e. in XML
Publisher Administrator responsibility. As this template(s) will be used for Dunning letter we
need to ensure that the Data Definition used is Collection XML Data Source.

Responsibility: XML Publisher Administrator

Navigation: Templates

Click on Create Template button

Enter the information as you require. We have entered the following,

Name: XX Dunning Letter Above 60 days

Code: XX_DUNNING_TEMPLATE

Application: Collections

Data Definition: Collection XML Data Source

Note:
Ensure that Application is always Collections and Data Definition is always Collection XML Data
Source.

Upload the template file

Click on Apply to create the template.

Attach the query to the template

Navigation: Manage Templates Query

Click on Assign Query

Enter the details

Template Name: XX Dunning Letter Above 60 days (This is the name of the template we have
created in the earlier step)

Query Description: XX Dunning Letter Query (This is the query we had created in Step 1)
http://oraclemaniac.com/2014/03/11/dunning-letter-setup-and-usage-in-oracle-r12/ 2/7
10/4/2014 Dunning letter setup and usage in Oracle r12 | Oracle Maniacs' Notes

Once the query description is entered and the control moves out of the field the query is
automatically populated along with the Query Level field.

Click on Apply

You will get a message that the query template is created.

The custom dunning letter data definition/query and templates are set up. We will need to ensure
that the configurations of Dunning Letter refer to this setup.

Dunning Letter configurations

Create a Dunning Letter Set

Responsibility: Collections Administrator

Navigation: Setup Checklist

Click on Collections Method Setup tab

Then click on Define Dunning Letter Sets tab

Click on Add Another Row to add a new letter set

Click on Apply to save this new letter set.

Create a new Scoring Engine

Responsibility: Collections Administrator

Navigation: Setup Checklist

Click on Create Scoring Engine tab

Click on Create Scoring Engine button

We shall create a new Scoring Engine named XX Scoring Engine

Click on Concurrent Program field to select the program to be associated with the Scoring Engine.

Select the concurrent program and set Enabled to Yes and check Weight Required

Click on Next button

Let us add a scoring component. Click on Add Score Component button. You will get to choose a
score component from a list. The values in the list are,

We shall select Number of Delinquencies for Customer and set Weight to 1


http://oraclemaniac.com/2014/03/11/dunning-letter-setup-and-usage-in-oracle-r12/ 3/7
10/4/2014 Dunning letter setup and usage in Oracle r12 | Oracle Maniacs' Notes

Now we need to add Score Components. We shall add component details as below

Click on Next to go to the next form.

If you click on the drop down on View Name you will get the following,

Select View Name as IEX_F_ACCOUNTS_V and Key as CUST_ACCOUNT_ID (Key is a


dependent LOV on View Name)

Click on Next

Review the information and click on Finish button.

You will get a confirmation message

Assign Templates to the Dunning Plan

Responsibility: Collections Administrator

Navigation: Setup Checklist

Click on View Existing button () on Create Dunning Plan.

Click on Create Dunning Plan button

We shall enter the values here

Name: XX Dunning Plan

Dunning Letter Set Name: XX Letter Set

Check Enabled Flag and Include Unapplied Receipts

Click on Next

Select the drop down on Scoring Engine.

We shall select the Scoring Engine as XX Scoring Engine

Click on Next

Click on Add Another Row button

Now the different Aging buckets are created. Set the values according to the business need.

Enter the following

Range as 1-30 Days Past Due

http://oraclemaniac.com/2014/03/11/dunning-letter-setup-and-usage-in-oracle-r12/ 4/7
10/4/2014 Dunning letter setup and usage in Oracle r12 | Oracle Maniacs' Notes

Score Low as 1

Score High as 100

Template as XX Dunning Letter Above 60 days

Click on Add Another Row button and enter the following in the new line

Range as 31-60 Days Past Due

Score Low as 1

Score High as 100

Template as XX Dunning Letter Above 60 days

Click on Next

Review the configuration and click on Finish button. The dunning plan is now set.

Configuration is now complete.

Execute and send Dunning letters to delinquent customers

Responsibility: Receivables responsibility

Navigation: View > Requests

Execute a single request

Select concurrent program, IEX: Send Dunnings for Delinquent Customers.

Set Dunning Plan to XX Dunning Plan.

Submit the request

When the concurrent program ends it spawns another concurrent program, Oracle Collections
Delivery XML Process (IEX: Bulk XML Delivery Manager). This program delivers the dunning
letters as per the delivery method defined in the dunning plan. In this case it is via email.

You can check the output of the program, IEX: Send Dunnings for Delinquent Customers. I have
attached a sample output as there are no invoices as per the original dunning plan.

The output displays which customers will receive dunning letters and in which mode.

Note: The delivery concurrent program, Oracle Collections Delivery XML Process (IEX: Bulk
XML Delivery Manager), failed because there are 2 profile options necessary for Dunning Letters
to deliver the letters via email.

http://oraclemaniac.com/2014/03/11/dunning-letter-setup-and-usage-in-oracle-r12/ 5/7
10/4/2014 Dunning letter setup and usage in Oracle r12 | Oracle Maniacs' Notes

Email profile options

IEX: SMTP From

IEX: SMTP Host

These profile options are not set deliberately so that customers do not receive Dunning Letters via
email from test Oracle instances.

Printer profile options

IEX: Fax IPP Host

IEX: Fax IPP Port

IEX: Fax IPP Printer Name

IEX: IPP Printer Name

IEX: Print IPP Host

IEX: Print IPP Port

IEX: Use IPP/CUPS Setup

Once these profile options are set up for use with Dunning letter the letters will automatically be
delivered to the customers as per their preferences set in customer master.

Cheers!

About these ads

You May Like


1.

About Abhijit
http://oraclemaniac.com/2014/03/11/dunning-letter-setup-and-usage-in-oracle-r12/ 6/7
10/4/2014 Dunning letter setup and usage in Oracle r12 | Oracle Maniacs' Notes

I love sleeping, watching Hollywood blockbusters, my Wii, road trips and watching my 4 year old
son grow up. In between I try to squeeze in some time to go to work.
View all posts by Abhijit »

Discussion

2 thoughts on “Dunning letter setup and usage in Oracle r12”

1. Hi
Thank you for this setup doc, it is easy to follow.
Unfortunately no dunning letters get created when I do this, you did show the Collections
Dunning Request status report with values, however mine does not have any records
processed.
Any ideas?
Thanks
Deon

POSTED BY DEON | JULY 10, 2014, 9:09 AM


REPLY TO THIS COMMENT
2. This is for 11i, in R12 we need to use Dunning Plans from Collections.

POSTED BY MANJU | AUGUST 28, 2014, 11:57 PM


REPLY TO THIS COMMENT

Oracle Maniacs' Notes

Blog at WordPress.com. The Morning After Theme.

Follow

Follow “Oracle Maniacs' Notes”

Powered by WordPress.com

http://oraclemaniac.com/2014/03/11/dunning-letter-setup-and-usage-in-oracle-r12/ 7/7

You might also like