CalculateItemCostPrice

CalculateItemCostPrice

Minor Business Rule

Object Name: B3201730

Parent DLL: CMFG

Location: Client/Server

Language: C

1.Functional Description

1.1Purpose
This function is intended to provide a relatively simple business function to call to retrieve a price/cost from the J.D. Edwards pricing system.  The 

price returned will include any applicable advanced pricing adjustments.   Because of the desire to keep it simple, this function does not allow for the full 

flexibility of the pricing system, but it includes enough to be useful in many situations.


This function should, in almost all cases, return the same price for the item that you would get if you entered a purchase order line with the same 

information.   See section 2.4 for exceptions.


1.2Setup Notes and Prerequisites
This function uses the same pricing table set-up that is used when entering orders through traditional means.  No new set-up is needed if you will be 

passing the function an Address Book Number and a Cost Center.


If the function is not passed an Address Book Number or a Cost Center, then some additional set-up is needed so that the function can properly default 

these values:


If the function is not passed an Address Number (i.e. Customer Number) it will default the address book number from the OneWorld sign-on 

information.  This address book number (or any address book number passed in) needs to be set up as a valid customer within OneWorld.


If the function is not passed a Cost Center (i.e. Business Unit or Branch/Plant), it will attempt to default the Cost Center from the sign-on information.  

So if a Cost Center is not passed into the function, then a default Branch/Plant needs to be set up for the sign-on using P400951 on menu G4241.


1.3Special Logic

None


2.Technical Specifications


Data Item Data Structure DescriptionI/ORequiredNotes ITM    


mnIdentifierShortItemIR EV07SuppressCostRetrievalIR EV04cSuppressWriteToWFIR KC00szOrderCompanyIR SUPPScSuppressErrorMessageIO MCUszBranchPlantIO AN8mnAddressNumberIO EFTJjdEffectiveDateIO UORGmnQuantityOrderedIO UOMszUnitOfMeasureIO COszCompanyIO CERAmnCurrencyExchangRateIOSend either the Triangulation Rates and Currency 

Conversion Method, or Exchange Rate not both. TRR1TriangulRateFromCurrencyIOSame as above  TRR2TriangulRateToCurrencyIOSame as 

above CRYRCurrencyConversionMethodCodeIOSame as 

above CRCDszCurrencyCodeFromIO CRDCszCurrencyCodeToIO ASNszPriceAdjustmentScheduleIO DTAIszErrorMessageIDOO PROVcPriceOverrideCodeIOSet it to 1 for ParentMethodOfPriceCalc = 3 PRRCmnPurchasingUnitPriceI/ORPass total value from 

X rules and user added Cost and set cPriceOverrideCode to 


1 FUPmnForeignUnitPriceOR AEXPmnExtendedPriceOR FEAmntForeignExtendedPriceOR AMC3mnUnitCostPurchasingOO FUCmnForeignUnitCostOO ECSTmnAmtExtendedCostOO FECmtForeignExtendedCostOO EMCUszCostCenterHeaderIO SHANmnAddressNumberShipToIO IVIcInventoryInterfaceFlagIO EV05cSuppressAdvancedPricingIO


2.2Related Tables 

Table Table Description F4101Item Master F4102Item Branch File


2.3Related Business Functions

Source NameFunction Name B4500250CalculatePurchasePrice


2.4Processing

Essentially this function is a wrapper for the business function B4500250.  This function accepts a minimum of input parameters and defaults in all 

the information that B4500250 needs to calculate a price.


Error handling in this function is not robust.


Because of the simplifications to the call interface and the fact that we do not have all the information we would have in a full purchase order, not every 

feature available in OW pricing is available through this business function.  The unavailable features include:


Interbranch order pricing

Purchase Order Entry Processing Options

Order totals

Free Goods

Cash Line logic

Preferences

Non-primary locations

Contract pricing (Contract in the OneWorld sense. Specific prices for specific customers are available.)



3.2 Where Used: APPs/UBEs/NERs/BSFNs


Application/Business FunctionApplication/BF 

Name N3201650RollupPriceCostWeightVolume B3200460F3293EvaluateAndProcessAIR P32942Configured Item Specifications


Data Structure

D3201730 - CalculateItemCostPrice

Parameter NameData ItemData TypeReq/OptI/O/Both
mnIdentifierShortItemITMMATH_NUMERICOPTNONE

An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item 
numbers (see data item XRT) to accommodate substitute item numbers, replacements, bar codes, customer numbers, supplier numbers, and 
so forth. The item numbers are as follows:   o Item Number (short) - An eight-digit, computer-assigned item number     o 2nd Item Number - The 
25-digit, free-form, user defined alphanumeric item number     o 3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item 
number

cSuppressCostRetrievalEV06charOPTNONE

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

cSuppressWriteToWFEV04charOPTNONE

PeopleSoft event point processing flag 04.

cSuppressErrorMessageSUPPScharOPTNONE

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.

szErrorMessageIDDTAIcharOPTNONE

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.

mnAddressNumberAN8MATH_NUMERICOPTNONE

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

mnAddressNumberShipToSHANMATH_NUMERICOPTNONE

The address number of the location to which you want to ship this order. The address book provides default values for customer address, 
including street, city, state, zip code, and country.

jdEffectiveDateEFTJJDEDATEOPTNONE

The date when a transaction, contract, obligation, preference, or policy rule becomes effective.

szUnitOfMeasureUOMcharOPTNONE

A user defined code (00/UM) that indicates the quantity in which to express an inventory item, for example, CS (case) or BX (box).

mnQuantityOrderedUORGMATH_NUMERICOPTNONE

The quantity of units affected by this transaction.

szBranchPlantMCUcharOPTNONE

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.

szCompanyCOcharOPTNONE

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.

cCurrencyConversionMethodCodeCRYRcharOPTNONE

A code that specifies whether to use multi-currency accounting, and the method of multi-currency accounting to use: Codes are:    N Do not 
use multi-currency accounting. Use if you enter transactions in only one currency for all companies. The multi-currency fields will not appear 
on forms. The system supplies a value of N if you do not enter a value.    Y Activate multi-currency accounting and use multipliers to convert 
currency. The system multiplies the foreign amount by the exchange rate to calculate the domestic amount.    Z Activate multi-currency 
accounting and use divisors to convert currency. The system divides the foreign amount by the exchange rate to calculate the domestic amount.

mnCurrencyExchangRateCERAMATH_NUMERICOPTNONE

mnTriangulRateFromCurrencyTRR1MATH_NUMERICOPTNONE

The triangulation currency rate used to convert the From currency code to the Triangulation currency code.

mnTriangulRateToCurrencyTRR2MATH_NUMERICOPTNONE

The triangulation currency rate that used to convert from the Triangulation currency code to the To currency code.

szCurrencyCodeFromCRCDcharOPTNONE

A code that identifies the currency of a transaction. 

szCurrencyCodeToCRDCcharOPTNONE

A code that identifies the domestic (base) currency of the company on a transaction. 

cPriceOverrideCodePROVcharOPTNONE

A value established by the sales order entry program whenever a unit or extended price is entered into an order line item, overriding the 
price calculated by the program.

szPriceAdjustmentScheduleASNcharOPTNONE

A user defined code (40/AS) that identifies a price and adjustment schedule. A price and adjustment schedule contains one or more 
adjustment types for which a customer or an item might be eligible. The system applies the adjustments in the sequence that you specify in the 
schedule. You link customers to a price and adjustment schedule through the customer billing instructions. When you enter a sales order, the 
system copies the schedule attached to the sold to address into the order header. You can override this schedule at the detail line level. For 
Agreement Management, this is the Agreement Penalty Schedule. The information in the Agreement Penalty Schedule provides the system 
with the criteria for an agreement to have penalty conditions.

mnAmtExtendedPriceAEXPMATH_NUMERICOPTNONE

The number of units multiplied by the unit price.

mnAmtForeignExtendedPriceFEAMATH_NUMERICOPTNONE

The product of the foreign price times the number of units.

mnUnitCostPurchasingAMC3MATH_NUMERICOPTNONE

In the event the organization recognizes a unit cost that should be used other than current unit cost, this special purpose unit cost may be 
used.

mnForeignUnitCostFUCMATH_NUMERICOPTNONE

Amount - Foreign Unit Cost

mnAmtExtendedCostECSTMATH_NUMERICOPTNONE

For accounts receivable and accounts payable, the invoice (gross) amount. For sales orders and purchase orders, the unit cost times the 
number of units.

mnAmtForeignExtendedCostFECMATH_NUMERICOPTNONE

The product of the cost of an item, expressed in foreign currency according to the orders exchange rate, times the number of units.

cInventoryInterfaceFlagIVIcharOPTNONE

A code that identifies the type of interface to the Inventory Management system. Valid values are:    Y The dollar or unit value of any activity 
containing this line type will be reflected in inventory. The system also edits the item that you enter to ensure that it is a valid item. Y is the 
default.    A The system recognizes the number that you enter as a G/L account number. The system uses this code in purchasing only.    B The 
system performs edits when using format 4 in purchase order entry.        The system retrieves price data from the inventory tables, but does not 
update the quantity on the purchase order. This code is valid only when you have set the G/L Interface field to Y (yes). Budget checking is 
fully functional when you use this interface code.    D The item in this line is an inventory item that will not affect availability or quantities.    N The 
item is not an inventory item. To verify whether the item exists in the Item Master file, use Inventory Interface N in conjunction with the flag, Edit 
the Item Master for Non-Stock Items.

cSuppressAdvancedPricingEV05charOPTNONE

A flag that indicates whether automatic spell check is turned on.

szPurchasingUnitOfMeasureUOM3charOPTNONE

A code (table 00/UM) that identifies the unit of measure in which you usually purchase the item.

mnUnitPricePRRCMATH_NUMERICOPTNONE

The unit cost of one item, as purchased from the supplier, excluding freight,taxes, discounts, and other factors that might modify the actual 
unit cost you record when you receive the item.

mnForeignUnitPriceFUPMATH_NUMERICOPTNONE

The foreign price per unit.

szLocationLOCNcharOPTNONE

The storage location from which goods will be moved.

szLotLOTNcharOPTNONE

A number that identifies a lot or a serial number. A lot is a group of items with similar characteristics.

mnJobNumberJOBSMATH_NUMERICOPTNONE

The job number (work station ID) which executed the particular job.

szOrderCompanyKCOOcharOPTNONE

A number that, along with order number and order type, uniquely identifies an order document (such as a purchase order, a contract, a 
sales order, and so on). If you use the Next Numbers by Company/Fiscal Year facility, the Automatic Next Numbers program (X0010) uses the 
order company to retrieve the correct next number for that company. If two or more order documents have the same order number and order 
type, the order company lets you locate the desired document. If you use the regular Next Numbers facility, the order company is not used to 
assign a next number. In this case, you probably would not use the order company to locate the document.

mnParentPOLineNumberLNIDMATH_NUMERICOPTNONE

A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns 
this number,but in some cases you can override it.

mnParentWFLineIndexLNIXMATH_NUMERICOPTNONE

mnDocumentOrderDOCOMATH_NUMERICOPTNONE

A number that identifies an original document. This document can be a voucher, a sales order, an invoice, unapplied cash, a journal entry, 
and so on.

szOrderTypeDCTOcharOPTNONE

A user defined code (00/DT) that identifies the type of document. This code also indicates the origin of the transaction. J.D. Edwards has 
reserved document type codes for vouchers, invoices, receipts, and time sheets, which create automatic offset entries during the post 
program. (These entries are not self-balancing when you originally enter them.) The following document types are defined by J.D. Edwards and 
should not be changed: P Accounts Payable documents   R Accounts Receivable documents   T Payroll documents   I Inventory documents  
O Purchase Order Processing documents   J General Accounting/Joint Interest Billing documents   S Sales Order Processing documents

szOrderSuffixSFXOcharOPTNONE

In the A/R and A/P systems, a code that corresponds to the pay item. In the Sales Order and Procurement systems, this code identifies 
multiple transactions for an original order. For purchase orders, the code is always 000. For sales orders with multiple partial receipts against an 
order, the first receiver used to record receipt has a suffix of 000, the next has a suffix of 001, the next 002, and so on.

cMethodOfCostCalculaCMETHcharOPTNONE

A code that indicates how the system calculates the cost for a configured item. Valid values are: 1 The system accumulates the base costs 
of the components with the configured cost adjustments, and then discounts the total. 2 The system accumulates the base cost of the parent 
item with the configured cost adjustments, and then discounts the total. 3 The system accumulates the configured cost adjustments, and then 
discounts the total. 4 The system accumulates the individually discounted costs of the components with the configured cost adjustments.  Note: 
The system discounts the costs only if you are using the Advanced Pricing system. The following is an example of how the system uses the 
various methods: Parent Item: 125 Component A: 50 Component B: 100 Configured Cost Adjustment 1: 15 Configured Cost Adjustment 2: 
10 Advanced Price Discount: 10% Methods: 1: 50 + 100 = 150 + 15 + 10 = 175 - 17.50 = 157.5 2: 125 + 15 + 10 = 150 - 15 = 135 3: 15 + 10 + 25 - 2.5 = 22.5 4: 
(50 - 5) + (100 - 10) = 135 + 15 + 10 = 160

szComputerIDCTIDcharOPTNONE

mnProcessIDDEIDMATH_NUMERICOPTNONE

A system-generated number that identifies a demand record.

mnTransactionIDTCIDMATH_NUMERICOPTNONE

szProgramIDPIDcharOPTNONE

The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry 
interactive program is P4210, and the number of the Print Invoices batch process report is R42565. The program ID is a variable length value. 
It is assigned according to a structured syntax in the form TSSXXX, where: T The first character of the number is alphabetic and identifies the 
type, such as P for Program, R for Report, and so on. For example, the value P in the number P4210 indicates that the object is a 
program. SS The second and third characters of the number are numeric and identify the system code. For example, the value 42 in the number P4210 
indicates that this program belongs to system 42, which is the Sales Order Processing system. XXX The remaining characters of the numer are 
numeric and identify a unique program or report. For example, the value 10 in the number P4210 indicates that this is the Sales Order Entry 
program.

mnAdjustmentRevisionLevelAREVMATH_NUMERICOPTNONE

This field maintains the current revision level of Advanced Pricing adjustments awarded within a sales order. Adjustments associated with 
a revision level below the current level are considered obsolete.

szItemGroupITTPcharOPTNONE

Item types that a item can be grouped into for each of the different preference types.

szCustGroupCSTPcharOPTNONE

Customer types that a customer can be grouped into for each of the different preference types.

mnUnitListPriceLPRCMATH_NUMERICOPTNONE

The list price in the unit of measure of the base price retrieved from the Base Price File (F4106).  This is the price the customer would pay if 
there were no price adjustments applied during Sales Order Entry.  This price is stated in domestic currency.

mnForeignUnitListPriceFPRCMATH_NUMERICOPTNONE

The list price in the unit of measure of the base price retrieved from the Base Price File (F4106).  This is the price the customer would pay if 
there were no price adjustments applied during Sales Order Entry.  This price is stored in the customer's currency.

szPOEMBFInternalFlagsPOEFcharOPTNONE

This field is broken down into 10 different flags which are passed in and out of the purchase order entry MBF - F4311 Begin Doc,  F4311 Edit 
Line, and F4311 End Doc.

szAlphaFlagsALPHcharOPTNONE

The text that names or describes an address. This 40-character alphabetic field appears on a number of forms and reports. You can enter 
dashes, commas, and other special characters, but the system cannot search on them when you use this field to search for a name.

cCostOverrideCodeCSTOcharOPTNONE

A code that specifies whether the change order is a terms only change. For those organizations that elect to view subcontracts on a 
detailed line item basis, terms only changes are in most cases those that have a non-dollar effect, such as a schedule change. For those 
organizations that elect to view their contracts on a summary job cost coding basis, all changes are automatically classified for processing purposes 
as terms only changes. In this case the base contract is automatically incremented for each change order and the individual change order 
amount is carried for informational purposes only. All change orders created in processing mode 3 (account method -incremental), are terms 
only changes. Most inquiry screens and reports exclude terms only items.

mnWeightGRWTMATH_NUMERICOPTNONE

Essentially a memo field at present, this value is intended to reflect the fact that many inventory items are always packaged in the same 
way for shipment to the customer.  This packaging in turn effectively adds to the shipment weight for the item.  Since much of the mainstream 
freight calculations depend upon a weight basis for their accuracy, the ability to store a gross weight which reflects the estimated additional 
weight of standard packaging was deemed to be a worthwhile enhancement. (Future Use)

szWeightUnitOfMeasureGWUMcharOPTNONE

Gross weight unit of measure.

mnVolumeITVLMATH_NUMERICOPTNONE

The cubic units occupied by one inventory item. The definition of the unit itself (cubic feet, yards, meters, and so on) is defined in the volume 
unit of measure.

szVolumeUnitOfMeasureVLUMcharOPTNONE

The unit of measure for the cubic space occupied by an inventory item. Typical volume unit of measures are:    ML Milliliter    OZ Fluid Ounce   
 PT Pint    LT Liter    CF Cubic Foot    CM Cubic Meter    CY Cubic Yard 

Related Functions

None

Related Tables

None