F0401RetrieveSupplierInfoCSMS

S/WM Retrieve Supplier Information

Minor Business Rule

Object Name: N1701570

Parent DLL: CCRIN

Location: Client/Server

Language: NER

1.Functional Description

1.1Purpose
The purpose of this business function is to fetch Supplier 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:
• Work Order Parts List (P3111)
• Work Order Routing (P3112)
• CSMS Contract Workfile Generation (R1732)
• CSMS Service Order Workfile Generation (R1775)

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 F0401 record
using AN8 and return values for all output parameters. If no record is found, return error if
not suppressed and exit business function.

Data Structure

D1701570 - F0401 Retrieve Supplier Information

Data Item Data Structure DescriptionI/ORequiredNotes
AN8Customer NumberIYAddress Book number of supplier
TXA2Tax Rate Area 2ON
EXR2Tax Expl Code 2ON
TRAPPayment Terms APON
PYINPayment InstrumentON
CPGPCustomer Price GroupON
APCAP ClassON
CRRPCurrency Code  APON
EV02Suppress Error 0/1INSuppress Error Code 0/1  1  Suppress Error  0  Do not suppress error
DTAIError Message CodeONError Message Number.

^

Parameter Name Data Item Data Type Req/Opt I/O/Both

mnCustomerNumber AN8 MATH_NUMERIC REQ INPUT

Address Book number of supplier required entry
^

szTaxRateArea2_TXA2 TXA2 char OPT NONE

A user-defined code that identifies a tax or geographical area that has common tax rates and tax distribution. The tax rate/area must be
defined to include the tax authorities (for example, state, county, city, rapid transit district,or province) and their rates. Typically, the U.S. sales and
use taxes require multiple taxing authorities per tax rate/area, whereas value added taxes often require only one simple rate.

szTaxExplCode2_EXR2 EXR2 char OPT NONE

A value in user defined code table 00/EX that controls how a tax is assessed and distributed to the general ledger revenue and expense
accounts. You assign this code to customers or suppliers to set up a default code for their transactions. Do not confuse this code with the
taxable, non-taxable code. A single invoice or voucher can have both taxable and non-taxable items. The entire invoice or voucher, however,
must have one tax explanation code.

szPaymentTermsAP_TRAP TRAP char OPT NONE

A code that indicates the default payment terms for a supplier. Payment terms determine the due date, discount amount, and discount due
date that the system assigns when you create an invoice. Use a blank code for the payment terms that you use most frequently.  Examples
of payment terms include: Blank Net 30 days 1 1/10 net 30   2 2/10 net 30   D Due upon receipt   N Net 30   P Prox 25th

cPaymentInstrument_PYIN PYIN char OPT NONE

A user defined code (00/PY) that determines the means by which a payment is issued to a supplier or received from the customer.
Examples of payment instruments include check, electronic funds transfer, lockbox, and EDI.

szCustomerPriceGroup_CPGP CPGP char OPT NONE

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

szAPClass_APC APC char OPT NONE

A code that determines the liability account in Accounts Payable that will be the offset when you post vouchers. This code might be
alphanumeric, or it might match the object account of the account number in the general ledger. Use offset codes such as TRAD or OTHR as the
exception to the trade account. If you leave this field blank during voucher entry, the system uses the default value from the supplier master
record. Examples include: Blank Trade Accounts Payable TRAD or 4110   Trade Accounts Payable OTHR or 4120 Other Accounts Payable

szCurrencyCodeAP_CRRP CRRP char OPT NONE

A code that indicates the currency that is used by the supplier.  The system uses this code as the default currency when you enter vouchers
for the supplier. You can override the default currency when you enter a voucher. If you leave this field blank, you can either assign the
currency code when you enter a voucher or let the system assign the currency code of the voucher company.

cSuppressError_EV02 EV02 char OPT NONE

Suppress Error Code 0/1
1  Suppress Error
0  Do not suppress error
^

szErrorMessageCode_DTAI DTAI char OPT NONE

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.

Related Functions

None

Related Tables

None

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnCustomerNumber	AN8	MATH_NUMERIC	REQ	INPUT
Address Book number of supplier required entry ^
szTaxRateArea2_TXA2	TXA2	char	OPT	NONE
A user-defined code that identifies a tax or geographical area that has common tax rates and tax distribution. The tax rate/area must be defined to include the tax authorities (for example, state, county, city, rapid transit district,or province) and their rates. Typically, the U.S. sales and use taxes require multiple taxing authorities per tax rate/area, whereas value added taxes often require only one simple rate.
szTaxExplCode2_EXR2	EXR2	char	OPT	NONE
A value in user defined code table 00/EX that controls how a tax is assessed and distributed to the general ledger revenue and expense accounts. You assign this code to customers or suppliers to set up a default code for their transactions. Do not confuse this code with the taxable, non-taxable code. A single invoice or voucher can have both taxable and non-taxable items. The entire invoice or voucher, however, must have one tax explanation code.
szPaymentTermsAP_TRAP	TRAP	char	OPT	NONE
A code that indicates the default payment terms for a supplier. Payment terms determine the due date, discount amount, and discount due date that the system assigns when you create an invoice. Use a blank code for the payment terms that you use most frequently. Examples of payment terms include: Blank Net 30 days 1 1/10 net 30 2 2/10 net 30 D Due upon receipt N Net 30 P Prox 25th
cPaymentInstrument_PYIN	PYIN	char	OPT	NONE
A user defined code (00/PY) that determines the means by which a payment is issued to a supplier or received from the customer. Examples of payment instruments include check, electronic funds transfer, lockbox, and EDI.
szCustomerPriceGroup_CPGP	CPGP	char	OPT	NONE
A user defined code (40/PC) that identifies a customer group. You can group customers with similar characteristics, such as comparable pricing.
szAPClass_APC	APC	char	OPT	NONE
A code that determines the liability account in Accounts Payable that will be the offset when you post vouchers. This code might be alphanumeric, or it might match the object account of the account number in the general ledger. Use offset codes such as TRAD or OTHR as the exception to the trade account. If you leave this field blank during voucher entry, the system uses the default value from the supplier master record. Examples include: Blank Trade Accounts Payable TRAD or 4110 Trade Accounts Payable OTHR or 4120 Other Accounts Payable
szCurrencyCodeAP_CRRP	CRRP	char	OPT	NONE
A code that indicates the currency that is used by the supplier. The system uses this code as the default currency when you enter vouchers for the supplier. You can override the default currency when you enter a voucher. If you leave this field blank, you can either assign the currency code when you enter a voucher or let the system assign the currency code of the voucher company.
cSuppressError_EV02	EV02	char	OPT	NONE
Suppress Error Code 0/1 1 Suppress Error 0 Do not suppress error ^
szErrorMessageCode_DTAI	DTAI	char	OPT	NONE
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.