F03B26GetNotificationPolicy

F03B26 Get Notification Policy

Minor Business Rule

Object Name: B03B0049

Parent DLL: CFIN

Location: Client/Server

Language: C

B03B0049
F03B26 Get Notification Policy


Functional Description


Purpose
This business function will locate the proper policy based on the information passed in.  If this 
function locates a policy successfully, the flags associated with that policy will also be returned.  


A notification policy is considered to be broken when the total late open amount is greater than the 

minimum amount in the aging bucket being considered, and the total amount of the aging bucket being 

considered and the older buckets is greater than the threshold percentage of the total late open amount.


Setup Notes and Prerequisites


Special Logic


Technical Specifications


Parameters

ItemDescriptionI/OReq? Notes
PLYPolicy NumberIYes
AG1Amount Aging Categories 1IYes

AG2Amount Aging Categories 2Yes

AG3Amount Aging Categories 3IYes

AG4Amount Aging Categories 4IYes

AG5Amount Aging Categories 5IYes

AG6Amount Aging Categories 6IYes

AG7Amount Aging Categories 7IYes

LFCJDate Last Fee CalculatedIYes

DAGDate Age As OfIYes

LTNALetter NameONo

LTTYLetter TypeONo

STCLSend To CollectionsONo

CMARColl Mgr Approval ReqONo

NTCMNotify Collection ManagerONo

MACLCollection Mgr Review ReqONo

HDARAR Hold InvoicesONo

TSTATemporary Credit MessageONo

LNIDLine NumberONo

AIPRPriority Action ItemONo

AGCAging CategoryONo

EV01Create Notices FlagONo


Related Tables

F03B26A/R Delinquency Policy Notification

Related Business Functions


Processing

• Return if the policy number is 0.
• Calculate total open amount (add all amounts in each aging category).
• If mnSubtotal is equal to 0, return with an error.
• Calculate the number of days different between Date Last Fee Calculated and Date Age As Of and put 
it in the mnDateDiff variable.

• Select from F03B26 sorted by aging category.
• While JDBReturn = JDEDB_PASSED and cOkFine = 'N',
• Fetch F03B26
• If the total open amount is greater than the minimum amount in this policy (just fetched),
• If mnDateDiff is greater than Day Between Delinquency Fees or Date Age As Of is null or Date 
Last Fee Calculated is null,

• Call the I_D03B0049_B03B0049_AgingCalculation (internal function).
• If idReturnCode = ER_SUCCESS,
• Move information to the output parameters to be returned to the program that calls this 
function.

• cOkFine = 'Y'
• End if.
• End if.
• End if.
• End while.

I_D03B0049_B03B0049_AgingCalculation 

• Based on the aging category fetched from F03B26, total the amounts from that aging category and 
older aging categories until the oldest aging category.

• If the total amount is greater than the threshold percentage of the total open amount,
• idReturnValue = ER_SUCCESS.
• Else
• idReturnValue = ER_ERROR.
• End if

^

Data Structure

D03B0049 - F03B26 Get Notification Policy

Parameter NameData ItemData TypeReq/OptI/O/Both
mnPolicynumberPLYMATH_NUMERICNONENONE

A number that the system assigns to each policy record to identify it.

mnAmtagingcategories1AG1MATH_NUMERICNONENONE

The total open invoice amount that is in the first category as defined in either the Accounts Receivable constants or the processing options 
of Credit Analysis Refresh. If you age by days, the system determines the first aging category by using the days defined in the second and 
third aging categories. For example, if the second aging category is 0 and the third aging category is 30, the date on the invoice that you use 
to age (invoice date, due date, statement date, or G/L date) must be equal to but no more than 30 days after the aging date that you define.

mnAmtagingcategories2AG2MATH_NUMERICNONENONE

The total open invoice amount that is in the second category as defined in either the Accounts Receivable constants or the processing 
options of Credit Analysis Refresh. If you age by days, the system determines the second aging category by using the days defined in the third 
and fourth aging categories. For example, if the third aging category is 30 and the fourth aging category is 60, the date on the invoice that you 
use to age (invoice date, due date, statement date, or G/L date) must be between 30 and 60 days after the aging date that you define.

mnAmtagingcategories3AG3MATH_NUMERICNONENONE

The total open invoice amount that is in the third category as defined in either the Accounts Receivable constants or the processing options 
of Credit Analysis Refresh. If you age by days, the system determines the third aging category by using the days defined in the fourth and 
fifth aging categories. For example, if the fourth aging category is 60 and the fifth aging category is 90, the date on the invoice that you use to 
age (invoice date, due date, statement date, or G/L date) must be between 60 and 90 days after the aging date that you define.

mnAmtagingcategories4AG4MATH_NUMERICNONENONE

The total open invoice amount that is in the fourth category as defined in either the Accounts Receivable constants or the processing 
options of Credit Analysis Refresh. If you age by days, the system determines the fourth aging category by using the days defined in the fifth and 
sixth aging categories. For example, if the fifth aging category is 90 and the sixth aging category is 120, the date on the invoice that you use to 
age (invoice date, due date, statement date, or G/L date) must be between 90 and 120 days after the aging date that you define.

mnAmtagingcategories5AG5MATH_NUMERICNONENONE

The total open invoice amount that is in the fifth category as defined in either the Accounts Receivable constants or the processing options 
of Credit Analysis Refresh. If you age by days, the system determines the fifth aging category by using the days defined in the sixth and 
seventh aging categories. For example, if the sixth aging category is 120 and the seventh aging category is 150, the date on the invoice that you 
use to age (invoice date, due date, statement date, or G/L date) must be between 120 and 150 days after the aging date that you define.

mnAmtagingcategories6AG6MATH_NUMERICNONENONE

The total open invoice amount that is in the sixth category as defined in either the Accounts Receivable constants or the processing options 
of Credit Analysis Refresh. If you age by days, the system determines the sixth aging category by using the days defined in the seventh 
and eighth aging categories. For example, if the seventh aging category is 150 and the eighth aging category is 180, the date on the invoice that 
you use to age (invoice date, due date, statement date, or G/L date) must be between 150 and 180 days after the aging date that you 
define.

mnAmtagingcategories7AG7MATH_NUMERICNONENONE

The total open invoice amount that is in the seventh category as defined in either the Accounts Receivable constants or the processing 
options of Credit Analysis Refresh. If you age by days, the system determines the seventh aging category by using the days defined in the 
eighth aging category. For example, if the eighth aging category is 180, the date on the invoice that you use to age (invoice date, due date, 
statement date, or G/L date) must be more than 180 days after the aging date that you define.

jdDatelastfeecalculatedLFCJJDEDATENONENONE

The most recent date on which the fees were calculated. The system uses this date for further fee calculations, by determining the number 
of days that elapse between calculations.

jdDateageasofDAGJDEDATENONENONE

A date that the system uses to determine the aging category to which to assign an invoice. The system compares the aging date to the 
invoice date, statement date, due date, or G/L date, which is defined by the value in the Date Aging Based On field (AGE), and then uses the 
value in the Aging Method field (AGEM) to determine which aging category to update. If you use method 1, the aging categories are defined in 
the Aging Days fields (CRDY, AGR1, AGR2, AGR3, AGR4, AGR5, AGR6, and AGR7) in the Accounts Receivable constants.  If you leave this 
field blank, the system uses the current date.  Note: The Sales Order Management system also uses this date for credit checks. Leave this 
field blank to ensure that the credit checks are always current.

szLetternameLTNAcharNONENONE

A field that identifies a predefined letter in the Letter Text table (F03B28). This field is case sensitive, so you must enter the letter name as it 
was created in the table, such as Letter1. You can add letter text in a foreign language. 

cLettertypeLTTYcharNONENONE

A code that is used to identify and organize the text that prints on statements or delinquency notices. The value that you specify must exist in 
UDC 03B/LT. For example, you might set up letter types for any of the following reasons:   o  To represent the process in which the letter 
(text) is used, such as deliquency notices or statements.   o  To identify a customer base, such as preferred.   o  To indicate a severity level. For 
example, LETTER1 might be used for the least severe notification text and LETTER5 for the most severe.

cSendtocollectionsSTCLcharNONENONE

An option that specifies whether past-due invoices for the aging category or severity level specified are eligible for external collection. 
Valid settings are: On Invoices are elgible for external collection. The system sends a workflow message recommending that the customer be 
placed on the collection report. You must manually update the Collection Report option (COLL) on the customer record. Off Invoices are not 
eligible for external collection. Note: The system does not reset the Collection Report option on the customer record automatically when the 
invoice is paid; you must reset the option manually.

cCollectionmanagerapprovalrequCMARcharNONENONE

An option in Fee Instructions and Notification Instructions that specifies the status that the system assigns to a delinquency fee or notice. 
Valid settings are: On The system assigns a Pending status to the fee or notice. The collection manager must approve it before processing can 
be completed. Off The system assigns an Approved status to the fee or notice.

cNotifycollectionmanagerNTCMcharNONENONE

An option that indicates whether you want the system to send a workflow message to the collection manager when an invoice becomes 
overdue. 

cCollectionmanagerreviewrequirMACLcharNONENONE

An option that specifies whether to require the collection manager to review the customer's account when it has past-due amounts.  Valid 
settings are: On The system sends a workflow message to the collection manager.  Off The system does not send a workflow message to the 
collection manager.

cArholdinvoicesHDARcharNONENONE

An option that allows you to prevent anyone from entering invoices manually. Valid values are: On Hold invoices. The system issues an 
error message if you attempt to enter invoices using the Speed Invoice Entry (P03B11SI) or Standard Invoice Entry (P03B11) programs. Off Do 
not hold invoices.  The system ignores this field if invoices are generated from the Sales Order Management system.

szTempcreditmessageTSTAcharNONENONE

A user defined code that identifies a temporary credit status. Generally, you assign the code when an account becomes past due. The 
system automatically updates the temporary credit message based on the notification instructions that you set up for the policy that you assign to 
the customer. The system can automatically reset the temporary credit message back to the credit message if you activate the option in 
the policy. You can also manually enter and update the temporary credit message on the customer record.  If you leave this field blank, the 
system assigns the value of the Credit Message field when you run Credit Analysis Refresh (R03B525). The system displays the temporary 
credit message on the transaction entry forms in the Accounts Receivable and Sales Order Management systems. 

mnLinenumberLNIDMATH_NUMERICNONENONE

A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns 
this number,but in some cases you can override it.

cPriorityactionitemAIPRcharNONENONE

A code that specifies the order in which the system displays activity messages that it generates when you run statements, notices, fees, 
and so on. Valid values are 1 through 5, where 1 is the highest priority and 5 is the lowest priority.

cAgingcategoryAGCcharNONENONE

A number that represents an aging category or severity level depending on the setting of the Determine Severity Level processing option 
in the Print Delinquency Notices program (R03B525).  If the processing option is blank (aging categories), the number represents a range of 
days, fiscal period, or calendar month as specified in either the Accounts Receivable constants or the processing options of the Print 
Delinquency Notices program to which the system assigns past-due invoices. Customers with past-due invoices that are in the aging category that 
you specify are eligible to receive a delinquency notice.  If the processing option has a value of 1 (total reminders sent), the number 
represents the severity level based on the number of delinquency notices previously sent. For example, if the number is 3, the invoice must have been 
included on 2 delinquency notices to be considered for another delinquency notice. 

cCreateNoticationFlagEV01charNONENONE

An option that specifies the type of processing for an event.

mnGracePeriodDaysGPDMATH_NUMERICOPTNONE

A number that the system adds to the invoice due date to extend it for collection purposes. Generally, you specify the number of days 
required for a payment to arrive if it were mailed on the invoice due date. 

mnPayByDaysPBDYMATH_NUMERICOPTNONE

The number of days to add to the aging date, which is defined in the processing options of the Credit Analysis Refresh program (R03B525), 
and to the grace days specified in the notification instruction, to determine the notification payment date.

jdPayByDateDTPBJDEDATEOPTNONE

The due date for the past-due invoices that print on the delinquency notice when you are using the Tiered Delinquency Notice Print 
program (R03B21). The system calculates the notification payment date by adding the value of the Pay By Days field (PBDY) from the applicable 
notification instruction to the aging date that is set up in the Accounts Receivable constants or the processing options of the Print Delinquency 
Notices program (R03B525).  Providing the customer with a notification payment date is a legal requirement in several countries. 

cGlobalRemindersFlagEV01charOPTNONE

An option that specifies the type of processing for an event.

cSeverityFlagEV01charOPTNONE

An option that specifies the type of processing for an event.

mnTotalSentRemindersRMDSMATH_NUMERICOPTNONE

This field specifies the number of delinquency notices that have been generated for an invoice pay item. 

mnAmountOpenAAPMATH_NUMERICOPTNONE

The amount of an invoice or voucher pay item that is unpaid.

jdDateofLastSentReminderJURDDJJDEDATEOPTNONE

The date of the most recent past-due notice to the customer.

Related Functions

None

Related Tables

F03B26 A/R Delinquency Policy Notification