GetExpensePolicyValues

Get Expense Policy Values

Minor Business Rule

Object Name: N09E0003

Parent DLL: CFIN

Location: Client/Server

Language: NER

Data Structure

D09E0003 - Get Expense Policy Values

Parameter NameData ItemData TypeReq/OptI/O/Both
szPolicyPOLICYcharREQINPUT

The name of an expense policy. The expense policy determines the expense categories that are available for reimbursement and 
provides the rules for each expense category such as the daily allowance amount, audit limits, receipt requirements, whether a preferrred supplier is 
required, and so on.  

szExpenseTypeEXPTYPEcharREQINPUT

A user defined code (09E/EC) that categorizes expenses. Expense categories include airfare, meals, hotel, and car rental.

jdExpenseDateEXPDATEJDEDATEREQINPUT

The date on which the expense was incurred. The system returns an error if the date that you enter for the expense is not within the 
allowable expense days as specified in the corresponding processing option of the Expense Entry program (P09E2011).

cExpenseReportTypeEXRPTTYPcharOPTINPUT

A user defined code (09E/RT) that describes the expenses on the report. Examples of expense report types include travel and 
entertainment, relocation, and tuition reimbursement. The expense report type determines which expense categories from the policy are available for 
entering expense report detail information.

szLocationLOCATNcharOPTINPUT

A user defined code (09E/EL) that indicates where the expense was incurred. The system uses location information to determine the policy 
to which the expense applies and to derive the appropriate tax rate area and tax explanation code for the expense. For transportation 
expenses, use the location where the ticket was purchased.

cDefaultRateDEFTRATEcharOPTOUTPUT

A value that specifies whether to use a default rate to calculate expenses, such as mileage. Valid values are: 0 Do not use a default rate 
value. 1 Use a default rate value.

cRateOverrideRATEOVRDcharOPTOUTPUT

A value that specifies whether the user can override an expense rate. Valid values are: 0 Do not allow the user to override the rate. 1 Allow the 
user to override the rate.

mnRate1RATE1MATH_NUMERICOPTOUTPUT

The price at which the expense was incurred for a specific unit of measure. For example, the rate might be the cost of a hotel room per night 
or the cost of a car rental per day.

cErrorFlagEV01charOPTOUTPUT

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

cPreferredSupplierPREFSUPcharOPTOUTPUT

A value that specifies whether the employee must use a preferred supplier for the expense category. If an employee does not use a 
preferred supplier as required, the system automatically identifies the expense report for an audit regardless of the audit rules established. Valid 
values are: 0 A preferred supplier is not required. 1 A preferred supplier is required.

szPolicyCurrencyCodePOLCRCYcharOPTOUTPUT

A code that represents the currency of the policy amounts.  The system uses this code when performing policy edits. If the reimbursement 
currency differs from the policy currency, the system converts the amount before editing the policy.

cSuppressErrorEV01charOPTINPUT

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

szErrorCodeDTAIcharOPTOUTPUT

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.

mnDailyAllowanceDLYALLOWMATH_NUMERICOPTOUTPUT

The amount that an employee is allowed to spend per day on an expense item.

szPerDiemExpenseCategoryPDIEMCATcharOPTOUTPUT

A user defined code (09E/EC) that categorizes expenses. Expense categories include airfare, meals, hotel, and car rental.

cHardEditHEDITcharOPTOUTPUT

A value that specifies whether the system issues a warning or error message to the employee when the expense amount exceeds the daily 
allowance and percent tolerance. An error prevents the employee from completing the expense report. Valid values are: 0 The system 
issues a warning message only. 1 The system issues an error message. The employee must change the expense amount.

cNonBillableRuleNONBILLcharOPTOUTPUT

An option that specifies whether the policy's audit rules apply to all expenses or to nonbillable expenses only. If you choose to apply audit 
rules to nonbillable expenses only, they will not apply to expenses that are billed to a client.

mnExpenseToleranceTOLERMATH_NUMERICOPTOUTPUT

The percentage of the daily allowance that an employee is allowed to exceed before receiving an error message. The system does not 
use the percent tolerance for warning messages.

mnAuditAmountAUDITAMTMATH_NUMERICOPTOUTPUT

The maximum amount allowed for an expense. If an expense exceeds the audit amount, the system automatically identifies the expense 
report for an audit regardess of whether audit rules are established.

cReceiptRequiredRCTRQDcharOPTOUTPUT

A value that specifies whether an employee must submit a receipt for the expense. Valid values are: 0 No receipt required. 1 Receipt 
required.

mnReceiptAmountDOMRCTAMMATH_NUMERICOPTOUTPUT

The maximum amount allowed before a receipt is required. Expense amounts that are equal to or less than the receipt amount specified do 
not require a receipt regardless of the value in the Receipt Required field.

szUnitOfMeasureUMcharOPTOUTPUT

A user defined code (00/UM) that identifies the unit of measurement for an amount or quantity. For example, it can represent a barrel, box, 
cubic meter, liter, hour, and so on.

Related Functions

None

Related Tables

None