10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

Oracle Apps Store

Dunning letter -Setup steps

JUNE 1, 2012 7 COMMENTS

(HTTP://ORACLEAPPSSTORE.WORDPRESS.COM/2012/06/01/DUNNING-LETTER-SETUP-
STEPS/#COMMENTS)

i
1 Vote

Advanced Collections setup steps

1. Creating a user account and assigning responsibilities

In System Administrator Responsibility> Security>User>Define

Enter a Username and Password

Assign the following responsibilities:

• System Administrator
• Application Developer
• Receivables Manager
• Collections Agent
• Collections Forms Administrator
• CRM Resource Manager
• Collections HTML Admin
• Telesales Agent
• Human Resources Manager
• CRM Administrator

2. Setting up an Employee
http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 1/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

2. Setting up an Employee
• Navigate to HR Responsibility
• Setup employee
• People>Enter & Maintain
• Enter name, birthday, gender, SSN and Save
• Note the employee number

3. Attach the employee name to the user name

• Navigate to System Administrator Responsibility
• Security>User>Define
• Query your Username
• Enter the Full Name as it appeared in the HR setup screen above
• Save

4. Create a group

a. Navigation : CRM Resource Manager -> Maintain Resources -> Groups

b. Name/Start Date (you can use anything)
c. -Assign Usages
i. Collections
d. -Roles
e. Collections Agent

Test Dunning Group

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 2/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/114.png)

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 3/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/214.png)

5. Import Resource

a. Navigation : CRM Resource Manager -> Maintain Resources -> Import Resources
b. Resource Cat = Employee
c. Enter Employee # that was noted previously
d. Click search/select employee
e. Click start import

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 4/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/312.png)

f. select start date of the resource

g. Click OK.

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 5/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/412.png)

h. Save Resource.

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 6/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/56.png)

i. Click Details
j. From the Resource Management Form, enter the Username
k. Click on Roles Tab (Security & Access)
Add the following roles:
Collections Role Type
Collections Agent Role

(https://oracleappsstore.files.wordpress.com/2012/05/63.png)

l. Click on the Group Tab

Query Group you created previously
Close the form
http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 7/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/74.png)

m. Add yourself as an employee to the group

Close the form.

(https://oracleappsstore.files.wordpress.com/2012/05/83.png)

——————————————-

1. Changing Data Template

a. Navigate to: XML Publisher Administrator

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 8/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

a. Navigate to: XML Publisher Administrator

b. Click on Data Definition tab

(https://oracleappsstore.files.wordpress.com/2012/05/94.png)
c. Search for: Collection XML Data Source
d. Update the template you want to use for your dunning letters

(https://oracleappsstore.files.wordpress.com/2012/05/104.png)

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 9/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/115.png)

(https://oracleappsstore.files.wordpress.com/2012/05/123.png)

(https://oracleappsstore.files.wordpress.com/2012/05/133.png)

e. Manage Template query

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 10/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/143.png)

(https://oracleappsstore.files.wordpress.com/2012/05/153.png)

XXX -NL-BE Dun Letter – STG1

XXX -NL-BE Dun Letter – STG2
XXX -NL-BE Dun Letter – STG3

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 11/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/166.png)
select to_char(sysdate, ‘MM/DD/YYYY’) currsysdate,
decode((per.person_first_name || per.person_last_name), null,
ARPT_SQL_FUNC_UTIL.get_lookup_meaning(‘RESPONSIBILITY’, ‘APS’),
per.person_first_name) first_name,
per.person_last_name last_name,
org.party_name org_name,
loc.address1 address1,
loc.address2 address2,
loc.city city,
loc.state state,
loc.postal_code postal_code,
per.person_first_name first_name1,
(select sum(aps.amount_due_remaining)
from
iex_delinquencies_all dd,
ar_payment_schedules_all aps
where
dd.payment_schedule_id = aps.payment_schedule_id and
dd.party_cust_id = org.party_id and
dd.cust_account_id = :ACCOUNT_ID and
dd.customer_site_use_id = :CUSTOMER_SITE_USE_ID) total_amount_due_remaining,
http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 12/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

to_char(sysdate+14, ‘MM/DD/YYYY’) required_pay_date,

rs.source_name collector_name,
rs.source_job_title collector_title,
rs.source_phone collector_phone,
cursor
(select
ct.trx_number invoice_number,
to_char(ar.due_date, ‘MM/DD/YYYY’) due_date,
ar.amount_due_remaining amount_due_remaining
from
iex_delinquencies_all d,
ar_payment_schedules_all ar,
ra_customer_trx_all ct
where
d.party_cust_id = org.party_id
and d.cust_account_id = :ACCOUNT_ID
and d.customer_site_use_id = :CUSTOMER_SITE_USE_ID
and d.payment_schedule_id = ar.payment_schedule_id
and d.status = ‘DELINQUENT’
and ar.customer_trx_id = ct.customer_trx_id
and ar.amount_due_remaining <> 0
) as payment_history
from
HZ_LOCATIONS loc
,hz_parties org
,hz_parties per
,jtf_rs_resource_extns rs
where
loc.location_id = :LOCATION_ID
and org.party_id= :PARTY_ID
and per.party_id = nvl(:CONTACT_ID, org.party_id)
and rs.RESOURCE_ID = :RESOURCE_ID
f. SELECT TEMPLATE_ID, APPLICATION_ID, TEMPLATE_CODE, TEMPLATE_NAME FROM
XDO_TEMPLATES_VL WHERE TEMPLATE_NAME LIKE ‘%MyTemplateName%';
g. Verify reference exist between XDO Template and Collections Query
SELECT * FROM IEX_QUERY_TEMP_XREF WHERE TEMPLATE_ID = <MyTemplateID>;
h. Review the existing queries in the table based on Dunning Level(Strategy level) in this case, we
are using BillTo.
SELECT QUERY_ID, DESCRIPTION from IEX_XML_QUERIES WHERE OBJECT_TYPE =
‘DUNN’ AND QUERY_LEVEL = ‘BILL_TO;
i. Insert into row into IEX_QUERY_TEMP_XREF table connecting Template and Query Use the
sequence value from IEX_QUERY_TEMP_XREF_S for QUERY_TEMP_ID
Receivables -> Setup -> Collections -> Aging Buckets

XXX Aging Bucket

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 13/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/173.png)

2. Setting up for Dunning Plans

a. Navigation: Collections Administrator -> Setup Checklist

b. Click on Home tab

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 14/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/183.png)

c. Click on Edit Questionnaire for Operations Setup

d. Check the Bill To radio button and check box for collection / dunning level

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 15/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/194.png)
e. Click Next leave default.
f. Click Next.
g. Click on Dunning Plan radio button for collections method

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 16/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/204.png)

3. Create Scoring Components

a. Navigation: Collections Administrator -> Setup Checklist -> Click on tab Collections Method
Setup
b. Click on Create Scoring Component

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 17/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/215.png)

c. Give a name
d. Enable the check box
e. Select type as Bill To
f. Select Value Type as Select Statement
g. Give any valid SQL

(https://oracleappsstore.files.wordpress.com/2012/05/224.png)

XXX Dunning Comp

SELECT NVL(MAX(ABL.BUCKET_SEQUENCE_NUM),0)
http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 18/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

SELECT NVL(MAX(ABL.BUCKET_SEQUENCE_NUM),0)
FROM AR_AGING_BUCKETS AB
,AR_AGING_BUCKET_LINES ABL
,AR_PAYMENT_SCHEDULES ARP
,IEX_DELINQUENCIES DEL
WHERE ABL.AGING_BUCKET_ID = AB.AGING_BUCKET_ID
AND AB.BUCKET_NAME = ‘XXX Aging Bucket’
AND DEL.PAYMENT_SCHEDULE_ID = ARP.PAYMENT_SCHEDULE_ID
AND (TRUNC(SYSDATE) – TRUNC(ARP.DUE_DATE)) BETWEEN ABL.DAYS_START AND
ABL.DAYS_TO
AND DEL.STATUS IN (‘DELINQUENT’, ‘PREDELINQUENT’)
AND ARP.STATUS =’OP’
AND DEL.CUSTOMER_SITE_USE_ID = :BILLTO_ID

h. Click on apply.

4. Create Scoring Engine

a. Click on Create scoring Engine tab under Collections Method Setup

b. Click on Create Scoring Engine button

(https://oracleappsstore.files.wordpress.com/2012/05/233.png)

c. Fill up the form as in screen shot and click next

XXX Dunning Scoring engine

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 19/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/243.png)

d. Click on Add Score Component

(https://oracleappsstore.files.wordpress.com/2012/05/254.png)

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 20/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

e. Search you Scoring Component and select it

(https://oracleappsstore.files.wordpress.com/2012/05/262.png)f. Key in the weight for that

component and click on recalculate button
g. Define ranges for you component and click next

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 21/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/272.png)
h. Define segments and click next
IEX_F_BILLTO_V

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 22/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/282.png)

5. Create Dunning Plans

a. Go to create dunning plans tab under Collections Method Setup

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 23/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/292.png)
b. Fill in the form and select the aging bucket you want to use for this dunning plan, click next

(https://oracleappsstore.files.wordpress.com/2012/05/301.png)
Dunning Plan
c. Select the scoring engine you created and click next

(https://oracleappsstore.files.wordpress.com/2012/05/313.png)

d. Define your dunning plan as per the score and assign dunning letter template and click next

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 24/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

(https://oracleappsstore.files.wordpress.com/2012/05/321.png)

e. Click finish

(https://oracleappsstore.files.wordpress.com/2012/05/331.png)

6. Define Contacts with dunning purpose

7. Running Concurrent Programs

• IEX: Scoring Engine Harness:

You can select up to five scoring engines to run at the same time. The scoring harness assigns a 25/29
http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

You can select up to five scoring engines to run at the same time. The scoring harness assigns a
value to an object such as a customer, account, or bill to location. Another score determines
whether transactions are delinquent, pre-delinquent, or current. At a minimum, you must run a
scoring engine that scores transactions to create delinquencies; and then run a scoring engine to
score the level of your dunning plan (customer, account, or bill to location).

Set

• IEX: Collections Bucket profile for your aging bucket.

• IEX: Send Dunnings for delinquent customers:

This program sends the results of the scoring engine harness to Oracle One-to-One Fulfillment to
send out dunning
correspondence

IEX: Purge Score History Table

The concurrent program IEX: Score History Purge: Purges historical data stored in the
IEX_SCORE_HISTORIES table. Run this program if you do not use historical data.

The parameters:
a) Score Object ID: This parameter will clean up score history for a single object,
‘Customer/Account/Site/Transaction’. For example if you pick a customer you can say to clean all
scores for customer = ‘Business World’.

b) Score Object Code: This parameter will clean up all the history for the type of objects. For
example, you can set it to clean up all scores for transactions.

c) Request ID: This parameters will clean up all the scores generated by a concurrent program
request. If you ran a concurrent program with a scoring engine and did not like the result, you can
basically wipe it clean by entering the request id.

d) The recommendation is for administrator to run this at least once a week to clean up
transaction histories. OR to run this and leave all the fields blank and only select ‘Save Last Run’ =
‘Y’, which will cause the concurrent program to clean all the score history for all objects BUT it
will leave the last score created for each object. So if you run scoring for customers for a year, if
you use this option all the scores except the last one for each of your customers will be deleted.

FILED UNDER ADVANCED COLLECTIONS TAGGED WITH DUNNING LETTERS

About Asokan
I have around 10 years of Working Experience in the Industry. Have done various roles like
Developer, Lead, Architect etc.

7 Responses to Dunning letter -Setup steps

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 26/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

Candi Shelgren says:

August 15, 2012 at 12:48 PM
Would you happen to have something similar for setting up Dunning Strategies and where a
strategy will auto close if a strategy has been sent and now the invoice is closed and new
invoice needs letter one not the next letter that is in the sequence?

i
Rate This

Reply
prakash says:
December 18, 2012 at 6:35 AM
Excellent article.

i
Rate This

Reply
Asokan says:
April 15, 2013 at 1:40 PM
Thank you

i
Rate This

Reply
shivprasad bajaj says:
April 15, 2013 at 12:29 AM
excellent

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 27/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

i
Rate This

Reply
Asokan says:
April 15, 2013 at 1:40 PM
Thank you

i
Rate This

Reply
Mike says:
July 26, 2013 at 4:07 PM
Great article. Thanks for taking the time to write this. Only asking this because you seem to
have advanced knowledge of advanced collections. (pun intended). Have you ever been able
to add the concurrent request id or the xml_request_id from iex_xml_request_histories table to
the XML that is generated? I am trying to add this information to the RTF template of my
dunning letter and can’t seem to do it via the query editor.

i
Rate This

Reply
Tony says:
December 2, 2013 at 1:56 PM
Good work – Brother || Excellent work you done here || you save my life

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 28/29
10/4/2014 Dunning letter -Setup steps | Oracle Apps Store

i
Rate This

Reply
Ali Hussien says:
Your comment is awaiting moderation.
October 4, 2014 at 9:14 AM
What a great article ..!
many thanks for your efforts
and sharing knowledge.
Best Regards;

i
Rate This

Reply

Blog at WordPress.com.

The Enterprise Theme.

Follow

Follow “Oracle Apps Store”

Powered by WordPress.com

http://oracleappsstore.wordpress.com/2012/06/01/dunning-letter-setup-steps/#comment-1370 29/29