ABCustomerAmtsDates

Get Customer Amounts & Dates from F0301 or F03B01

Minor Business Rule

Object Name: B0100023

Parent DLL: CFIN

Location: Client/Server

Language: C

Business Function Specification

Source NameB0100023DesignerFiona Martin
Data Structure 
D0100023ProgrammerFiona Martin
Function Name
ABCustomerAmtsDatesSystem Code01
Function Category
CUR
Function Use
GET


Revisions Log 
DateProgrammerSAR NumberDescription
04/15/95F. MartinCreated

08/07/95 F. Martin           Created

10/26/95 J. Cahill           added Error Message ID Field

08/01/96 G. Brown1236808******


1.Functional Description

1.1Purpose
This function will retrieve  key Accounts Receivable dates and amounts from the Customer Master table, and will return them to the calling 
application via data structure parameters. The function will determine whether a user is running the new A/R system (03B), or the old system (03) and retrieve 

the customer's information from the correct table (i.e. either F03B01 or F0301).


The caller can specify what currency the amounts should be returned in. This function will perform any conversion required to return amounts 

in the requested currency. If no currency is specified, the amounts will be returned in the customer's default currency. Please note, all amounts returned to 

the calling application will always be denominated in the same currency, regardless of whether  the caller nominates a currency or not.


1.2Setup Notes and Prerequisites


For this function to perform currency conversion, the Currency Conversion flag in the General Constants must be set to either "Y" or "Z". If this flag is 

set to "N", no currency conversion can occur. Also, if no conversion rate exists between the customer's default currency in F0301 and the caller's specified 

currency, no conversion can occur. In both cases all amounts returned will be set to zero.



1.3Special Logic


2.Technical Specifications


2.1Parameters:

Data Item  Data Structure Description    I/ORequired  Notes
AN8   mnAddressNumber      IRequired

CRCA   szCurrencyCode      IN/R   If not entered, the customer's    currency from 

F0301 will be    used.

TRDT   jdERDate      IN/R   Required if a specific currency    code is passed. 

This    parameter is used to retrieve    the exchange 

rate effective at    this given date for conversion    

calculations.

DLIJ   jdDateLastInvoice      O

DFIJ   jdDateFirstInvoice      O 

DHBJ   jdDateHighBalance      O

DLP   jdDateLastPaid      O

ACL   mnAmountCreditLimit      O

AD   mnAmountDue      O

AFCP   mnAmtFinanceChargesPY    O

AFCY   mnAmtFinanceChargesYTD O

SPYE   mnAmtInvoicedPY      O

ASTY   mnAmtInvoicedYTD      O

AHB   mnAmountHighBalance      O

ALP   mnAmountLastPaid      O

ABAM   mnAmountAddressBook      O

ABA1   mnAmount1      O

APRC   mnAmountOpenOrder      O

MINO   mnMinimumOrderValue      O

MAXO   mnMaximumOrderValue      O

URAT   mnUserReservedAmount      O

CO   szCompany      IRequired   Used as part of the    unique key to retrieve a  

  customer's information from    F03B01. 


2.2Related Tables 

Table Table Description
F0301Customer Master

F03B01Customer Master


2.3Related Business Functions

Source NameFunction Name
B0000027Currency Conversion

B0000033Get Exchange Rate


2.4Processing 


1. If the customer master row for the given Address Number cannot be found then error message 0037 will be returned.

2. If the database or the table cannot be found then error message 3143 will be returned.

3. If an error occurs loading any of the dates or amounts to the output parameters, error message 4376 will be returned.  

4. If an error occurs converting amounts to the output parameters, error message 0488 will be returned.  



^

Data Structure

D0100023 - A/B Customer Header Amounts and Dates F0301

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICNONENONE

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

szCurrencyCodeCRCDcharNONENONE

A code that identifies the currency of a transaction. 

jdERDateTRDTJDEDATENONENONE

The date an order line is loaded onto a vehicle for delivery.

jdDateLastInvoiceDLIJJDEDATENONENONE

The G/L date of the last invoice generated for the customer.

jdDateFirstInvoiceDFIJJDEDATENONENONE

The G/L date of the first invoice generated.

jdDateHighBalanceDHBJJDEDATENONENONE

The invoice date of the record that has the highest gross amount from either the A/R Statistical History (F03B16) or A/R Statistical Summary 
(F03B16S) tables. The system displays information from the F03B16S table on the Account Statistical Summary form and information from 
the F03B16 table on the Periodic Statistics form.

jdDateLastPaidDLPJDEDATENONENONE

The date of the last premium payment.

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.

mnAmountDueADMATH_NUMERICNONENONE

The balance or amount due on an open invoice or voucher.  In the Address Book Master file (F0101), this is a memo amount field used to 
determine if a particular order exceeds a credit limit.  See the documentation for the Order Processing system. 

mnAmtFinanceChargesPYAFCPMATH_NUMERICNONENONE

This is the prior year amount of finance charges for a customer. This field is updated by the Accounts Receivable Annual Close program 
(P03820).

mnAmtFinanceChargesYTDAFCYMATH_NUMERICNONENONE

The year-to-date finance charges. This field is updated by the Finance Charge Journal program (P03435).

mnAmtInvoicedPYSPYEMATH_NUMERICNONENONE

The gross amount invoiced for the previous year. The system updates this field only when you run the Statistics Annual Close program 
(R03B161). 

mnAmtInvoicedYTDASTYMATH_NUMERICNONENONE

The amount invoiced for the year. The system uses the gross amount of the invoice record (F03B11) regardless of whether taxes are 
included. The system updates this field when you run the Statistics History Update program (R03B16). The system determines the current fiscal 
year from the Date Fiscal Patterns - 52 Period Accounting table (F0008B).

mnAmountHighBalanceAHBMATH_NUMERICNONENONE

The invoice record with the highest gross amount from the A/R Statistical Summary table (F03B16S) or the A/R Statistical History table 
(F03B16), depending on the form. The system displays information from F03B16S on the Account Statistical Summary form and information from 
F03B16 on the Periodic Statistics form.

mnAmountLastPaidALPMATH_NUMERICNONENONE

The amount of the last payment applied to invoices based on the G/L date of the Receipt Detail record (F03B14). The system displays this 
information from either the A/R Statistical Summary table (F03B16S) or the A/R Statistical History table (F03B16), depending on the form. 
The system displays information from F03B16S on the Account Statistical Summary form and information from F03B16 on the Periodic Statistics 
form.

mnAmountAddressBookABAMMATH_NUMERICNONENONE

A field that stores an amount in the Address Book system. This field has no predefined use. You can use this field to record a bank service 
fee, membership dues, or any other fixed amount.

mnAmount1ABA1MATH_NUMERICNONENONE

Future use.

mnAmountOpenOrderAPRCMATH_NUMERICNONENONE

The total amount of open orders for a supplier or customer. The system uses the list price from the Item Location (F41021) table adjusted by 
the discount tables or any override price. You cannot override this amount.

mnMinimumOrderValueMINOMATH_NUMERICNONENONE

Value below which an order is placed on hold. If you try to enter an order whose total is less than the minimum order value, the system 
displays an error message. This field is maintained as an integer without decimals.

mnMaximumOrderValueMAXOMATH_NUMERICNONENONE

Value above which an order is placed on hold. If you try to enter an order whose total is more than the maximum order value, the system 
displays an error message. This field is maintained as an integer without decimals.

mnUserReservedAmountURATMATH_NUMERICNONENONE

This is a 15 position code that is reserved for the user.  JDE does not currently use this field and will not utilize this field in the future.

jdDateUserReservedURDTJDEDATENONENONE

This is a 6 position code that is reserved for the user.  JDE does not currently use this field and will not utilize this field in the future.

szErrorMessageIDDTAIcharNONENONE

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or 
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

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.

jdGLDateDGLJDEDATEOPTNONE

A date that identifies the financial period to which the transaction is to be posted.  The company constants specify the date range for each 
financial period. You can have as many as 14 periods. Generally, period 14 is used for audit adjustments. The system validates this field for 
PBCO (posted before cutoff), PYEB (prior year ending balance), PACO (post after cutoff), and WACO (post way after cutoff) messages.

Related Functions

B0000027 CurrencyConvForAndDom
B0000033 Get Exchange Rate
N0100042 Customer Master -MBF

Related Tables

None