S421006A_GetFreeGoodLines

Free Goods View Data Adapter

Minor Business Rule

Object Name: B4210660

Parent DLL: CSALES

Location: Client/Server

Language: C

Data Structure

D4210660A - S421006_FreeGoodsData

Parameter NameData ItemData TypeReq/OptI/O/Both
mnParentLineNoOGNOMATH_NUMERICNONENONE

A number identifying which line on the original order that the current line matches.

mnLineNoLNIDMATH_NUMERICNONENONE

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.

mnQtyShippedSOQSMATH_NUMERICNONENONE

The number of units committed for shipment in Sales Order Entry, using either the entered or the primary unit of measure defined for this 
item. In the Manufacturing system and Work Order Time Entry, this field can indicate completed or scrapped quantities. The quantity type is 
determined by the type code entered.

szUnitOfMeasureUOMcharNONENONE

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

cFreeGoodTypeFGTYcharNONENONE

A code that indicates how you want the system to process free good items. Valid codes are:    1   Separate line item. The system writes the 
free good item to the Sales Order Detail table (F4211) as a separate line item. For example, the customer buys 10 items at 1 dollar each and 
gets 2 free. The system writes two lines to the file: one line for 10 items at a total of 10         dollars and one line for 2 items at a total of zero.    2   
Net down price. The system adds the free good item to the original sales detail line. It recalculates unit price based on the original extended 
price added to the total free goods price. The customer is responsible for the cost of the original order quantity. For example, the customer 
buys 10 items at 1 dollar each and gets 2 free. The system writes one line to the Sales Order Detail line for 12 items, but the total price is for 10 
items (10 dollars; unit price of each item = 83         cents).    3   Net down quantity. The system adds the free good item to the Sales Order 
Detail table as a separate line item, but subtracts the quantity of the free items from the total quantity of the original items. For example, the 
customer buys 10 items at 1 dollar each and receives 2         free. The customer is charged for the original order quantity (10) less the free goods 
(2), so in this example, the charge is 8 dollars. NOTE: When you use processing type 2 or 3, the free good item must be identical to the original 
item ordered.

mnRelatedPriceRPRIMATH_NUMERICNONENONE

The price of a related item in a pricing or discount policy. For example, with a policy of "Buy one, get one free," the free item is the related 
item. Enter this price in the unit of measure of the related item quantity.

mnUnitsQuanBackorHeldSOBKMATH_NUMERICOPTNONE

The number of units backordered in Sales Order Management or in Work Order Processing, using either the entered or the primary unit of 
measure defined for this item.

mnUnitsQuantityCanceledSOCNMATH_NUMERICOPTNONE

The number of units canceled in Sales Order or Work Order Processing, using either the entered or the primary unit of measure defined for 
this item. In manufacturing, this can also be the number of units scrapped to date.

szFreeGoodCatalogNameCATLGcharOPTNONE

A group of items from which customers can choose when they qualify for a free good.

szPriceAdjustmentTypeASTcharOPTNONE

A user defined code (system 40, type TY) that identifies an adjustment definition. You define adjustments on Price Adjustment Names. For 
Agreement Penalty Schedules Add a definition for each of the four types of penalties:        Minimum quantity         Maximum quantity         Under 
commitment         Over commitment

szSessionKeySNKYcharOPTNONE

Session Key is the identifier of a Sales Order Session. 

szBusinessUnitMCUcharOPTNONE

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.

szPrimaryItemNoUITMcharOPTNONE

A number that the system assigns to an item. It can be in short, long, or third item number format.

mnUnitsTransactionQtyUORGMATH_NUMERICOPTNONE

The quantity of units affected by this transaction.

Related Functions

None

Related Tables

None