CSMSRetrieveAccountInformation

S/WM Retrieve Account Information

Minor Business Rule

Object Name: N1701490

Parent DLL: CCRIN

Location: Client/Server

Language: NER

1.Functional Description

1.1Purpose
This function will be used to retrieve account information for CSMS.

1.2Setup Notes and Prerequisites
Anyone using this NER needs to pay special attention to the data structure notes attached to the data structure items.  There are detailed notes for what 
fields should be used in certain examples.

1.3Special Logic

2.Technical Specifications
2.4Processing 
//
//Contracts
//
IF BF CallingModule = 1 
//
//Get GL Offset 
//
IF BF GLOffset = Blank OR Null

Get CSMS GL Code
BF ServicePackage -> szServicePackage
X cTypeofService
BF ItemNumber -> mnShortItemNumber
BF Branch -> szBranch
BF GLOffset <- szCoveredGLCode
X szNonCoveredGLCode
"1" -> Mode
IF BF GLOffset is equal to Blank OR Null
F40205 Get Line Type Constants
BF Line Type -> szLineType
X szLineTypeDesc
BF GLOffset <- szGLOffset
END IF
END IF
END IF
//
//Get Resp BU for Contract  if none
//
IF VA BusinessUnit is equal to Blank or Null AND BF Mode = 1,2,3,4,5,6
Get CSMS Resp BU
BF ItemNumber -> mnShortItemNumber
BF Branch -> szBranch
BF ProductModel -> szProductModel
BF EquipmentNumber -> mnEquipmentNumber
BF CustomerNumber -> mnCustomerNumber
VA BusinessUnit <- szResponsibleBusinessUnit
"1" -> cMode
BF LineType -> szLineType
"1" -> SuppressErrorMessages
X szErrorCode
END IF
//
//By passing the Default Branch into the BSFN, if there is no Branch 
//Plant defined on the AAI's, the "Default Branch" will default.
//
F4095 Retrieve Distribution AAI
VA AAITable -> mnAAITableNumber
BF Company -> szCompanyNumber
BF Order Type -> szOrderType
BF DocumentType -> szDocumentType
BF GLOffset -> szGLCategory
BF Cost Type -> szCostType
BF DefaultBU -> szBranchPlant
VA Object <- szObjectAccount
VA Subsidiary <- szSubsidiary
VA BusinessUnit <- szCostCenter
BF LongAccountNumber-> szAccountNumber
"Blank" -> cSuppressErrorMessage
"1" -> cVoidAccountValidation
BF Job Number -> mnJobNumber
BFSalesFlexAccountingFlag -> cSalesFlexAccountingFlag
BF Subledger <- szSubledger
BF SubledgerType <- cSubledgerType
BF Application Group -> szApplicationGroup
BF ManagerialAnalysisCode1<- szManagerialAnalysisCode1
BF ManagerialAnalysisCode2<- szManagerialAnalysisCode2
BF ManagerialAnalysisCode3<- szManagerialAnalysisCode3
BF ManagerialAnalysisCode4<- szManagerialAnalysisCode4
BF ManagerialAnalysisType1 <- cManagerialAnalysisType1
BF ManagerialAnalysisType2 <- cManagerialAnalysisType2 
BF ManagerialAnalysisType3 <- cManagerialAnalysisType3 
BF ManagerialAnalysisType4 <- cManagerialAnalysisType4
BF AccountUnitOfMeasure <- szAccountUnitOfMeasure
BF PriceAdjustmentType <- szPriceAdjustmentType
IF SV Error Status is not equal to Error
F0901 Edit Account Number
X szAccountNumber
BF AccountID <- szAccountID
X szUnstructuredAccount
VA BusinessUnit -> szDatabaseBusinessUnit
VA Object -> szDatabaseObject
VA Subsidiary -> szDatabaseSubsidiary
X ..
"5" -> cBasedOnFormat
"5" -> cFormatAccountNumberAs
"Blank" -> cIncludeAccountSymbol
END IF

Data Structure

D1701490 - S/WM Retrieve Account Information

Parameter NameData ItemData TypeReq/OptI/O/Both
szMode_DTAIDTAIcharREQINPUT

Special Input Expected :
1  = Contract Recognized
2  = Contract Recognized for Amortization
3  = Contract Short Term
4  = Contract Short Term for Amortization
5  = Contract Long Term 
6  = Contract Long Term for Amortization
7  = Contract Cancel Fee
8  = Service Order Billable
9  = Service Order Payable
10 = Call Center Revenue
11 = Call Center Expense
12 = Call Center Accrued Cost
13 = Call Center Goodwill Expense

17 = Warranty Claim Price Adjustment
18 = Warranty Claim Offset
19 = Warranty Claim AR
20 = Warranty Claim AP
21 = Supplier Recovery Price Adjustment
22 = Supplier Recovery Offset
23 = Supplier Recovery AR
24 = Supplier Recovery AP

cSuppressErrorMessage_SUPPSSUPPScharOPTNONE

A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function.        0 = allow 
runtime error message handling.        1 = suppress runtime error message handling.

szErrorMessageID_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.

szServicePackage_SERPSERPcharOPTNONE

Special Input Expected:
This field is required only when processing Contracts.

Special Output Expected:

^

mnIdentifierShortItem_ITMITMMATH_NUMERICOPTNONE

Special Input Expected:
This field is required only when processing Contracts.

Special Output Expected:


^

szBranch_MMCUMMCUcharOPTNONE

Special Input Expected:
This field is required only when processing Contracts.  This field should represent the Branch that 
the Short Item Number is from.

Special Output Expected:


^

szLineType_LNTYLNTYcharOPTNONE

Special Input Expected:
This field is required only when processing Contracts.

Special Output Expected:


^

szProductModel_PRODMPRODMcharOPTNONE

Special Input Expected:
This field is required only when processing Contracts.

Special Output Expected:


^

mnEquipmentNumber_NUMBNUMBMATH_NUMERICOPTNONE

Special Input Expected:
This field is required only when processing Contracts.

Special Output Expected:


^

mnAddressNumber_AN8AN8MATH_NUMERICOPTNONE

Special Input Expected:
Contracts - this field is used to retrieve the Responsible Business Unit if there isn't one in the 
Distribution AAI's.

Calls - this field is used to retrieve account information from F1797.

Special Output Expected:


^

szCompany_COCOcharOPTNONE

Special Input Expected:
This field corresponds with the Company in the AAI table.

Special Output Expected:



^

szOrderType_DCT0DCTOcharOPTNONE

Special Input Expected:
This field corresponds with the Order Type in the AAI table.  This is not currently used within 
Service Orders, Calls or Contracts.

Special Output Expected:


^

szDocumentType_DCTDCTcharOPTNONE

Special Input Expected:
This field corresponds with the Document Type on the AAI table. CSMS currently passes the Order Type 
of the Contract, Service Order or Call into this field.  

Special Output Expected:


^

szGlClass_GLCGLCcharOPTNONE

Special Input Expected:
This field corresponds with the GL Class on the AAI table. 

Contracts: this values is retrieved within the NER and will be returned to the calling function.  If 
calling NER multiple times for the same record, pass this value back in and the NER will not need to 
calculate it again.

Service Orders: this value comes from the Service Order record.  Either the Covered G/L Code or 
Non-Covered will be used based on processing.

Calls: this value comes from the Call record.  Either the Covered G/L Code or Non-Covered will be 
used based on processing.

Special Output Expected:

Contracts: this values is retrieved within the NER and will be returned to the calling function.
^

szCostType_COSTCOSTcharOPTNONE

Special Input Expected:
This field corresponds with the Cost Type on the AAI table. 

Special Output Expected:


^

szDefaultBusinessUnit_MCUMCUcharOPTNONE

Special Input Expected:
When there is no Branch/Plant assigned within the AAI table, this is the business unit that will be 
used.  If used, this value will also be passed back through the "Cost Center" parameter.

Contracts:  This value will be derived if necessary within the NER and returned back to the calling 
program. If calling NER multiple times for one record, pass this value back into the NER and it will 
not have to search for it again.

Service Orders: The Business Unit from the Service Order record should be passed into this field.

Calls: The Business Unit from the Call record should be passed into this field.

Special Output Expected:


^

szObjectAccount_OBJOBJcharOPTNONE

Special Input Expected:


Special Output Expected:
This is the Object Account retrieved from the AAI table.


^

szSubsidiary_SUBSUBcharOPTNONE

Special Input Expected:


Special Output Expected:
This is the Subsidiary retrieved from the AAI table.


^

szCostCenter_MCUMCUcharOPTNONE

Special Input Expected:


Special Output Expected:
This is the Branch Plant retrieved from the AAI table.  In the instance that no Branch Plant exists 
on the AAI table, this value will come from the "Default Business Unit".


^

szLongAccountNumber_ANIANIcharOPTNONE

Special Input Expected:


Special Output Expected:
This is the long Account Number retrieved based on AAI information.

^

mnJobNumber_JOBSJOBSMATH_NUMERICOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

cSalesFlexAccounting_EV03EV03charOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

szSubledger_SBLSBLcharOPTNONE

Special Input Expected:


Special Output Expected:


^

cSubledgerType_SBLTSBLTcharOPTNONE

Special Input Expected:


Special Output Expected:


^

szApplicationGroup_EAPEAPcharOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

szManagerialAnalysisCode1_ABR1ABR1charOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

szManagerialAnalysisCode2_ABR2ABR2charOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

szManagerialAnalysisCode3_ABR3ABR3charOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

szManagerialAnalysisCode4_ABR4ABR4charOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

cManagerialAnalysisType1_ABT1ABT1charOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

cManagerialAnalysisType2_ABT2ABT2charOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

cManagerialAnalysisType3_ABT3ABT3charOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

cManagerialAnalysisType4_ABT4ABT4charOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

szUnitOfMeasure_UMUMcharOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

szPriceAdjustmentType_ASTASTcharOPTNONE

Special Input Expected:
Not currently used.

Special Output Expected:


^

szAccountId_AIDAIDcharOPTNONE

Special Input Expected:


Special Output Expected:
This is the unique Account Number that is to be used based on AAI information.

^

szContractBU_MCUMCUcharOPTNONE

An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit 
might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for 
purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by 
business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units 
for which you have no authority.

Related Functions

None

Related Tables

None