F4573GetNextFreeGood

F4573 Get Next Free Good

Minor Business Rule

Object Name: B4500200

Parent DLL: CDIST

Location: Client/Server

Language: C

Data Structure

D4500200 - F4573 Get Next Free Good

Parameter NameData ItemData TypeReq/OptI/O/Both
cFileEV01charNONENONE

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

cActionEV02charNONENONE

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

szComputerIDCTIDcharNONENONE

mnJobNoJOBSMATH_NUMERICNONENONE

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

mnWFLineNoLNIXMATH_NUMERICNONENONE

mnOrderNoDOCOMATH_NUMERICNONENONE

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.

szOrderTypeDCTOcharNONENONE

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

szOrderCoKCOOcharNONENONE

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.

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.

sz2ndItemNoLITMcharNONENONE

A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to 
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A 
25-digit, user defined, alphanumeric item number. 3rd Item Number  Another 25-digit, user defined, alphanumeric item number. In addition to 
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous 
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or 
supplier numbers.

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.

cSuppressErrorMsgEV03charNONENONE

A radio button that specifies the level at which trace/track result is to be displayed.  Select the Detail to display all transactions except IB, IX, 
and IZ types.  Or, select Derivative Lots Only to display only those transactions that may have created new derivative lot. 

szErrorMsgIdDTAIcharNONENONE

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.

idhCursorGENLNGIDNONENONE

General purpose ID variable.

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.

mnRelatedItemNoITMRMATH_NUMERICNONENONE

The number of the related item in a pricing or discount policy. For example, with a policy of "Buy one, get one at half price," you enter the 
item number of the half price item in this field. (Future Use)

szLineTypeLNTYcharNONENONE

A code that controls how the system processes lines on a transaction. It controls the systems with which the transaction interfaces, such as 
General Ledger, Job Cost, Accounts Payable, Accounts Receivable, and Inventory Management. It also specifies the conditions under 
which a line prints on reports, and it is included in calculations. Codes include the following: S Stock item   J Job cost   N Nonstock item   F Freight  
T Text information   M Miscellaneous charges and credits   W Work order

mnUnitCostUNCSMATH_NUMERICNONENONE

The amount per unit, derived by dividing the total cost by the unit quantity.

szGLClassGLCcharNONENONE

A code that determines the trade account that the system uses as the offset when you post invoices or vouchers. The system concatenates 
the value that you enter to the AAI item RC (for Accounts Receivable) or PC (for Accounts Payable) to locate the trade account. For 
example, if you enter TRAD, the system searches for the AAI item RCTRAD (for receivables) or PCTRAD (for payables).  You can assign up to four 
alphanumeric characters to represent the G/L offset or you can assign the three-character currency code (if you enter transactions in a 
multicurrency environment). You must, however, set up the corresponding AAI item for the system to use; otherwise, the system ignores the G/L 
offset and uses the account that is set up for PC or RC for the company specified.  If you set up a default value in the G/L Offset field of the 
customer or supplier record, the system uses the value during transaction entry unless you override it.  Note: Do not use code 9999. It is reserved for 
the post program and indicates that offsets should not be created.

mnParentWFLineNoRLLNMATH_NUMERICNONENONE

A number of the detail line on the related order for which the current order was created. For example, on a purchase order created to fill 
open sales orders, this is the line number of the sales order on which the item you are ordering appears.

cCurrencyModeCRMDcharNONENONE

A code that indicates how documents are sent to a customer or supplier. It is part of the Accounts Payable Batch Upload process, and can 
be used as a criterion when you write reports.

cNumKeysEV04charNONENONE

PeopleSoft event point processing flag 04.

mnUnitsTransactionQtyUORGMATH_NUMERICOPTNONE

The quantity of units affected by this transaction.

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

cItemSelectedEV01charOPTNONE

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

cSubledgerInformationSBIFcharOPTNONE

A user defined code (system 40, type SI) that identifies the type of information that you want the system to use to update the Subledger field 
in the General Ledger file (F0911) when you use this adjustment type to price a sales order.

cProcessingModeMODEcharOPTNONE

The processing mode used in Purchase Order Consolidator to signify when specific orders are being processed.

cSalesOrderStatus08SO08charOPTNONE

A value of 1 in this field indicates to the system that this sales detail line was created during price adjustment processing to record an 
upcharge or a discount.  A value of 2 indicates that this detail line was created after invoicing as an adjustment line that should not have additional 
processing performed on it. During Sales Price Recalculation (P42950), these price adjustment lines will automatically be cancelled by the 
system.  The recalculation program will create new price adjustment lines, if necessary, to reflect the new unit price.  All cancelled price 
adjustment lines will have a Last Status of '987'. Please note that free good lines created during price adjustment processing won't have a 1 in this 
field.  This is because the price recalculation module will not automatically cancel any free good lines.

Related Functions

None

Related Tables

F4573 Free Goods Reference File