CalculateAccountAction

Calculate Account Action

Minor Business Rule

Object Name: B03B0062

Parent DLL: CFIN

Location: Client/Server

Language: C

B03B0062 
Calculate Account Action


Functional Description


Purpose

This function determines if an activity message record needs to be written in F03B31, if a workflow 

message needs to be sent to the work center, and if the Hold Invoice flag and the Temporary Credit 

Message field need to be updated in Customer Master Information (P03013).


The activity messages that can be written in F03B31 are 'Credit Review Required' (activity 20), and 

'Over Credit Limit' (activity 21).  The workflow messages that can be sent to the work center are 

'Collection Review Required', 'External Collection Recommended.' 


Setup Notes and Prerequisites


Special Logic


Technical Specifications


Parameters

ItemDescriptionI/OReq?Notes

AN8Customer NumberIYes

COCompanyIYes

PLYPolicy NumberIYes

DAGAs of DateIYes

FURFuture Amount      IYes

CURRCurrent Amount DueIYes

AG1Amt Aging Categories 1IYes

AG2Amt Aging Categories 2IYes

AG3Amt Aging Categories 3IYes

AG4Amt Aging Categories 4IYes

AG5Amt Aging Categories 5IYes

AG6Amt Aging Categories 6IYes

AG7Amt Aging Categories 7IYes

ACLAmount Credit LimitIYes

AOCLAmount Over Credit LimitIYes

RVDJDate Recall For ReviewIYes

PARTPart Child RelationshipIYes

CRCDCurrency CodeIYes

TSTATemp Credit MessageIYes

CMGRCredit ManagerIYes

CLMGCollection ManagerIYes


Related Tables

F03B25A/R Delinquency Policy Table


Related Business Functions

N0100041Address Book MBF

N0100042Customer Master MBF

B03B0049F03B26 Get Notification Policy

B03B0068F03B31 - Write Activity Record

N03B0164SendMessageCollectionReview

B9800100Get Audit Information


Processing

• If the Company is 00000,
• 

If As of Date is greater than Date Recall For Review,
• 
Write the 'Credit Review Required' activity record to F03B31.
• 
End if.
• If Amount Over Credit Limit is greater than zero,
• 
Write the 'Over Credit Limit' activity record to F03B31.
• 
End if.
• End if.
• Call F03B26 Get Notification Policy.  Some of the outputs to this call are cSendtocollections, 
cNotitifycollectionmanager, and cAgingcategory.

• If cSendtocollections is equal to a '1' or cNotifycollectionmanager is equal to a '1',
• 
Based on the cAgingcategory, add the aging amount from the cAgingcategory to the amounts in the 
oldest aging category.  This amount will be sent with the workflow message.

• If cSendtocollections is equal to a '1',
• 
Assign a '1' to cExternalcollections.
• 
End if.
• Call SendMessageCollectionReview to send a workflow message to the work center.
• End if.
• Call Customer Master - MBF (action code I).
• If Line ID Number is equal to '0' and Policy Number is not equal to '0', 
• 
Fetch F03B25 to get the Temporary Credit Message.
• If the flag is equal to a '1',
• 
Call Address Book - MBF to get the Credit Message, which will be use as the Temporary Credit 
Message.

• 
End if.
• Else,
• If Temp Credit Message (passed in) is different from Temporary Credit Message (fetched from F03B25),
• 
The Temporary Credit Message from F03B25 will be used to update the record in Customer Master 
table.

• End if.
• If cArHoldInvoices is equal to a '1',
• 
A 'Y' will be used to update a record in the Customer Master table.
• End if.
• Call Get Audit Information.
• Call Customer Master - MBF to update the Temporary Credit Message and Hold Invoices.

Data Structure

D03B0062 - Calculate Account Action

Parameter NameData ItemData TypeReq/OptI/O/Both
mnCustomerNumberAN8MATH_NUMERICNONENONE

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or 
location.

mnPolicyNumberPLYMATH_NUMERICNONENONE

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

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.

mnAmountFutureFTRMATH_NUMERICNONENONE

The total amount of the invoices that is due prior to the first aging category defined when the Credit Analysis Refresh program (R03B525) 
was last run. Aging information can be set up in the Accounts Receivable constants or the Credit Analysis Refresh program. For example, if the 
first 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 more 
than 30 days in the future.

mnCurrentAmountDueCURRMATH_NUMERICNONENONE

The total open invoice amount that is in the current aging 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 current aging category by using the days defined in the 
first two aging categories. For example, if the first aging category is -30 and the second aging category is 0, the date on the invoice that you 
use to age (invoice date, due date, statement date, or G/L date) must be equal to or before the aging date that you define.

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.

mnAmtOverCreditLimitAOCLMATH_NUMERICNONENONE

The portion of a customer's total amount due that exceeds his available credit limit.

cParentChildRelationPARTcharNONENONE

An option that specifies whether the system displays parent records or child records. If you turn on this option, the system displays parent 
records for the address book number entered. Also a field that indicates whether a record is a parent or child. For the field, valid values 
are: P Parent   C Child  

szCurrencyCodeCRCDcharNONENONE

A code that identifies the currency of a transaction. 

szCompanyCOcharNONENONE

A code that identifies a specific organization, fund, or other reporting entity. The company code must already exist in the Company 
Constants table (F0010) and must identify a reporting entity that has a complete balance sheet. At this level, you can have intercompany 
transactions. Note: You can use company 00000 for default values such as dates and automatic accounting instructions. You cannot use company 00000 
for transaction entries.

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. 

szCreditManagerCMGRcharNONENONE

The name of the credit manager responsible for approving changes to the credit limit. You must set up the credit manager in the address 
book, and then create an entry in the user defined code table 01/CR. When you set up the user defined code value, you must also enter the 
address book number of the credit manager in the Description 02 field. You enter the user defined code that represents the credit manager in 
this field.

szCollectionManagerCLMGcharNONENONE

The name of the collection manager responsible for managing this customer's account. You must set up the collection manager in the 
address book, and then create an entry in the user defined code table 01/CM. When you set up the user defined code value, you must also enter 
the address book number of the collection manager in the Description 02 field. You enter the user defined code that represents the collection 
manager in this field.

mnAmountCreditLimitACLMATH_NUMERICNONENONE

The total amount that you allow the customer to spend on purchases before the system sends a workflow message. This value is used 
throughout the credit management programs. The system maintains the credit limit at the customer (child) level, not the parent level. The system 
sends workflow messages for each customer who is over their credit limit. When you set up or change the credit limit, the system sends a 
workflow message to the credit manager that the change is pending approval. The change to the credit limit is not reflected in the customer 
record until it is approved by the credit manager.

jdDateRecallForReviewRVDJJDEDATENONENONE

The review date for the customer's credit information.

cLineOfBusinessFlagEV01charOPTNONE

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

cAgingCategoryAGCcharOPTNONE

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. 

mnCurrentAgingDaysAGR8MATH_NUMERICOPTNONE

The specified number of days for the Accounts Receivable aging report.

mnAgingDaysCategory1AGR1MATH_NUMERICOPTNONE

A value used in conjunction with CRDY and AGR2 to define the current and first aging categories.

mnAgingDaysCategory2AGR2MATH_NUMERICOPTNONE

A value used in conjunction with AGR1 and AGR3 to define the first and second aging categories.

mnAgingDaysCategory3AGR3MATH_NUMERICOPTNONE

A value used in conjunction with AGR2 and AGR4 to define the second and third aging categories.

mnAgingDaysCategory4AGR4MATH_NUMERICOPTNONE

A value used in conjunction with AGR3 and AGR5 to define the third and fourth aging categories.

mnAgingDaysCategory5AGR5MATH_NUMERICOPTNONE

A value used in conjunction with AGR4 and AGR6 to define the fourth and fifth aging categories.

mnAgingDaysCategory6AGR6MATH_NUMERICOPTNONE

A value used in conjunction with AGR5 and AGR7 to define the fifth and sixth aging categories.

mnAgingDaysCategory7AGR7MATH_NUMERICOPTNONE

A value used in conjunction with AGR6 to define the sixth aging category.

cAgingMethodAGEMcharOPTNONE

A code that designates which aging categories the system uses to assign invoices. The system uses the date specified in the Age as of 
Date field (DAG) and the value specified in the Date Aging Based On field (AGE) to calculate the aging for each invoice, and then assigns 
them to the aging category specified by this code. Valid codes are: 1 Aging days. The system assigns invoices to the aging categories 
specified in the Aging Days fields. The aging categories are user defined. 2 Fiscal periods. The system uses the fiscal periods defined by the date 
pattern assigned to the company record as the aging categories. 3 Calendar. The system uses each calendar month as an aging category.

Related Functions

B03B0049 F03B26 Get Notification Policy
B03B0068 F03B31 - Write Activity Record
B9800100 Get Audit Information
N0100041 Address Book MBF
N0100042 Customer Master -MBF

Related Tables

F03B25 Delinquency Policy