F03012RetrieveCustMasterInfo

F03012 Retrieve Customer Master Info

Minor Business Rule

Object Name: N1701550

Parent DLL: CCRIN

Location: Client/Server

Language: NER

1.Functional Description

1.1Purpose

The purpose of this business function is to fetch Customer Master information for use by the customer service management applications. 

1.2Setup Notes and Prerequisites

This business function was designed for use by the following CSMS applications:

• Service Order Entry (P17714)
• Service Order Quote (P17716)
• On Line Service Order Quote Entry (P17717)
• Contract Detail (P1721)
• Work Order Print (P3111)
• Work Order Routing (P3112)
• CSMS Contract Workfile Generation (R1732)
• CSMS Service Order Workfile Generation (R1775)
• Service Contract Entry Master Business Function (B1700550)
• F1721 Service Contract Entry MBF CSMS Edit Module (B1700560)

1.3Special Logic

None.


2.Technical Specifications


2.4Processing 


1.0  Determine if a value for AN8 was input.  

1.1If blank, return error and exit business function.  If value in AN8, retrieve F03012 record 
using AN8 and company = '00000' return values for all output parameters.  If no record is found, 

return error if not suppressed and exit business function.


Data Structure

D1701550 - F03012 Retrieve Customer Master Info



Data Item Data Structure DescriptionI/ORequiredNotes
AN8Customer NumberIYAddress Book number of customer.

TXA1Tax Rate AreaON

EXR1Tax Expl CodeON

RYINPayment InstrumentON

BADTBilling Address TypeON

AN8RRelated Address NumberON

SITOSend Invoice ToON

CPGPCustomer Price GroupON

PTCPayment TermsON

CRCFCurrency CodeON

EV02Suppress Error 0/1INSuppress Error Code 0/1  1  Suppress Error  0  Do not suppress error

DTAIError Message CodeONError Message Number.

COCompanyON

CRCDCurrency Code ON

ARCG/L Class CodeON


^

Parameter NameData ItemData TypeReq/OptI/O/Both
mnCustomerNumber_AN8AN8MATH_NUMERICREQINPUT

Address Book number of customer required entry
^

szTaxRateArea_TXA1TXA1charOPTNONE

A code that identifies a tax or geographic area that has common tax rates and tax authorities. The system validates the code you enter 
against the Tax Areas table (F4008). The system uses the tax rate area in conjunction with the tax explanation code and tax rules to calculate tax 
and G/L distribution amounts when you create an invoice or voucher.

szTaxExplCode_EXR1EXR1charOPTNONE

A hard-coded user defined code (00/EX) that controls the algorithm that the system uses to calculate tax and G/L distribution amounts. The 
system uses the tax explanation code in conjunction with the tax rate area and tax rules to determine how the tax is calculated. Each 
transaction pay item can be defined with a different tax explanation code.

cPaymentInstrumentA_RYINRYINcharOPTNONE

The user defined code (00/PY) that specifies how payments are made by the customer. For example: C Check   D Draft   T Electronic funds 
transfer  

cBillingAddressType_BADTBADTcharOPTNONE

Code that tells the system to use this address as a Sold To address, a Ship To address, or both. Valid codes are:    X Indicates a bill to and 
a ship to address    S Indicates a ship to address only    B Indicates a bill to address only

mnRelatedAddressNo_AN8RAN8RMATH_NUMERICOPTNONE

Use this field to relate a ship-to address to a sold-to address or vice versa. For example, if you enter only a ship-to address in sales order 
entry, it uses this field to determine which address number to select from the list of related address numbers which is then defaulted to the 
order's blank Sold To field.

cSendInvoiceToCP_SITOSITOcharOPTNONE

A code that identifies the billing name and address to print on the invoice. Valid codes are: C Customer (AN8)   N Do not print. The Real 
Estate Management system (15) ignores this value; it uses the value of the Print Invoice field (INVP) from the billing record or lease.    P Parent 
(PA8)   R Payor (PYR) 1 1st Address Number (AN81)   2 2nd Address Number (AN82)   3 3rd Address Number (AN83)   4 4th Address Number (AN84)  
5 Factor Special/Payee (AN85)   6 5th Address Number (AN86) Note: With the exception of Payor, which you set up in the customer record in 
the Alternate Payee field (AYPR), all of the above codes correspond to related address information that you set up in the address book 
record.  Note: If you have a Who's Who entry that is set up with type code B (for billing), the system overrides the billing name with the entry from the 
Who's Who record.

szCustomerPriceGroup_CPGPCPGPcharOPTNONE

A user defined code (40/PC) that identifies a customer group. You can group customers with similar characteristics, such as comparable 
pricing.

szPaymentTerms_PTCPTCcharOPTNONE

A code that specifies the terms of payment, including the percentage of discount available if the invoice is paid by the discount due date. 
Use a blank code to indicate the most frequently-used payment term. You define each type of payment term on the Payment Terms Revisions 
form. Examples of payment terms include: Blank Net 15 001      1/10 net 30 002      2/10 net 30 003      Due on the 10th day of every month 006     
Due upon receipt  This code prints on customer invoices.

szCurrencyCode_CRCFCRCFcharOPTNONE

The currency code of the insured amount.

cSuppressError_EV02EV02charOPTNONE

Suppress Error Code 0/1 
1  Suppress Error 

0  Do not suppress error

^

szErrorMessageCode_DTAIDTAIcharOPTNONE

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.

szCompany_COCOcharOPTNONE

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.

szGLClassCode_ARCARCcharOPTNONE

A code that determines the A/R trade account that the system will use as the offset when you post invoices. The system concatenates the 
value that you enter to the AAI item RC to locate the trade account. For example, if you enter TRAD, the system searches for the AAI item 
RCTRAD to locate the account to use for the offset. The value in this field can be alphanumeric or can match the object code of the G/L account 
number. If you leave this field blank, the system uses the account that is set up for RC to locate the account number. The value in this field can 
also be used to locate the offset for unapplied receipts if you specify its use in the processing options for Standard Receipts Entry or the draft 
entry programs. Otherwise, the system uses the account that is set up for RCUC.  You can override the value of this field when you enter the 
transaction. Note: Do not use class code 9999; it is reserved for the post program and indicates that offsets should not be created.

Related Functions

None

Related Tables

None