KitsInBatchMode

Kit Selection in Batch Mode

Major Business Rule

Object Name: N4201050

Parent DLL: CDIST

Location: Client/Server

Language: NER




Functional Description


Purpose


This Named ER will look in F4013Z file to see if components have been chosen for the Order Key. If 

the records are found, they will be retrieved and passed to F4211EditLine.  If records are not found for 

the order key, the NER will automatically select the default components for a Kit Item, based on how 

the Bill of Materials (F3002) has been setup.  This is intended for use with Batch Transaction Editor 

(R40211Z) and for EDI Inbound Purchasing Order Batch Program.



Setup Notes and Prerequisites


None.


Special Logic


None.


Technical Specification


Data Structure

mnParentItemNumberKIT

szCostCenterAltMMCU

szTypeBillTBM

mnComponentLineNumberCPNT

mnDocumentNumberDOCO

szOrderTypeDCTO

szDocumentCompanyKCOO

mnLineNumberLNID

jdRequestedDateDRQJ

jdTransactionDateTRDJ

jdPromiseDeliveryDatePDDJ

szLineTypeLNTY

szLastStatusCodeLTTR

szNextStatusCodeNXTR

szTransactionUoMUOM

szPricingUoMUOM4

mnQTYShippedSOQS

mnQTYBackorderedSOBK

mnQTYCanceledSOCN

szBaseCompanyCurrencyCRCD

szCustomerCurrencyCRDC

cCheckAvailabilityYNCKAV

cBackordersAllowedYNBACK

cAllowPartialShipmntsYNAPTS

szHeaderBranchPlantEMCU

mnSoldToAddressNumberAN8

WriteKitCompToF4211YNEV05

cAddorMaintainMODE

mnTransactionQtyUORG

mnDomesticExtendedPriceAEXP

mnForeignExtendedPriceFEA

mnDomesticExtendedCostECST

mnForeignExtendedCostFEC

szPODefaultReasonCodeVC03A

OrdercommitmentDateDATE01

cConversionsByBranchBUMC

cSalesPriceRetrievalUOMUMB1

cPricingEffectiveBasedOnDateCP01

cAdvancedSalesPricingYNADVP

mnLastLineNumberAssignedLNIX

cPricingMethodPMTH

mnJobnumberAJOBS

cCurrencyConverYNARCRYR

cOKorCANCELEV01

szPrimaryItemNumberUITM

szSOEVersionIDVERS

cTaxableYNTAX1

cUseCacheorWFEV02

mnFromLineNumLINN

mnThruLineNumberLIN

cPriceOverrideCodePROV

cCostOverrideCodeCSTO


Related Tables


Table Table Description


F4201ZSales Header

F4211ZSales Detail

F42UI01Sales Header Work File

F42UI11Sales Detail Work File



Related Business Functions


Source NameFunction Name


Look at flow for kits in batch below.





Processing 


This NER calls multiple business functions, The order in which these functions are called follows the 

Interactive Kits Program.  


The program assumes that the client Bill of Materials F3002 and the Servers Bill of Materials is the 

same.  If the two files are not the same, the servers version will win.  


• If the Kit Item has Standard components, they will always be selected.  
• If the Kit Item has Optional but Required Components, they will always be selected.
• If the Kit Item has Default Components AND user does not chose any components, all the Default 
Components will be selected.

• If  the Kit Item has components that have been chosen by the user while running P4004Z (Batch Order 
Entry) they will exist in the F4013Z file, and they will be selected as long as they are in the Server 

Bill of Material.

• 'b7
Flow for Kits in Batch NER


     Verifications from Calling Program

     If no Errors, call Kits in Batch NER


Kits in Batch NER

F0301 Get Ship To Billing Instructions
Get Local Computer ID
F4101 Get Item Master Information

F41002 Get Item UoM Conversion


While End of BOM Structure == 0


       While End of Vertical Structure == 0


    F3002 Get Text Lines for BOM Explosion

if Text Line is not Found

      F3002 Get Exploded BOM Child
end if

if Text Line is Found OR Vertical Record is Found
  F3002 Get Bill Of Material Data
end if


if Text(Y/N) != "Y"

Kit Processing, Edits for Sales Order Entry

end if


Kit Processing, Verify Next Status for Kits


 if OPTK=='S' || FORV=='Y' || OPTK=='O' && FTRC=='Y'|| Record Found in        F4013Z==1

 

if Text(Y/N) != "Y"

Availability Compare Quantities

F4105/F4106 Get Cost/Price for Kits

       end if

Item Number, Convert Short To Long

Line Number, Increment for Kit Components

Kit Processing, Update Link List

end if

End While



While Horizontal Record Found == 0 && End of BOM Structure == 0


F3002 Get Text Lines for BOM Explosion

          
if Text Line is not Found

     F3002 Get Exploded BOM Sibling
end if

if Text Line == 1(Found) OR Horizontal Record == 1 (Found)
  F3002 Get Bill Of Material Data
end if


if Text(Y/N) != "Y"

Kit Processing, Edits for Sales Order Entry

end if


Kit Processing, Verify Next Status for Kits


 if OPTK=='S' || FORV=='Y' || OPTK=='O' && FTRC=='Y'|| Record

       Found in F4013Z==1

 if Text(Y/N) != "Y"

Availability Compare Quantities

F4105/F4106 Get Cost/Price for Kits

        end if

Item Number, Convert Short To Long

Line Number, Increment for Kit Components

Kit Processing, Update Link List

end if


end while


       end while    //BOM Structure == 1


Delete F3002 Link List


Kit Balancing

Kit Parent Get Max To Be Sold

Kit Parent Calc Balncd Ship Qtys

Kit Component Calc Balncd Shp Qtys


while Record Found == 1 || Record Found == 0 && Edit Line Errors != 2

Kit Processing, Update Link List
Action Code == 5   (Traverse List and Retrieve Node)

F4211 Edit Line
Action Code == A   (Create F4211 Edit Line Cache)

end while


Kit Processing, Update Link List

Action Code == 4   (Destroy the whole link list)


End of NER


Verifications of F4211 Edit Line in Calling Program 


Update the Parent Item Line in the F42UI11 (or in Cache)








Data Structure

D4201050 - Kits in Batch Data Structure





Special Input Expected


Parameters:


Data Item Data Structure DescriptionI/ORequiredNotes

KIT      Kit Master                   I      Item number of Kit

                                                            Parent Item

MMCU      Kit Master Branch             I      Branch Plant for Kit

                                                            Parent

TBM      Type of Bill             I

CPNT      Component Line Number       I

DOCO      Document Number             I

DCTO      Document Type             I

KCOO      Document Company             I

LNID      Line Number             I

DRQJ      Requested Date             I

TRDJ      Transaction Date       I

PDDJ      Promised Date             I

LNTY      Line Type             I

LTTR      Last Status             I

NXTR      Next Status                   I

UOM      Transaction UOM             I

UOM4      Pricing UOM             I

SOQS      Quantity Shipped             I

SOBK      Quantity Back Ordered       I

SOCN      Quantity Canceled             I

CRCD      Base Company Currency       I

CRDC      Customer Currency             I

CKAV      Check Availability Flag       I

BACK      Back Orders Allowed Flag I

APTS      Allowed Partial Shipments I

EMCU      Header Branch Plant I

AN8      Sold To Address Number       I

EV05      WriteKitCompToF4211 Flag I

MODE      Mode-A for Add,

                 M for Maintenance I      A for Add mode

                                                            only

UORG      Transaction Qty             I

AEXP      Extended Price - DomesticI/O

FEA      Extended Price - ForeignI/O

ECST      Extended Cost - DomesticI/O

FEC      Extended Cost - Foreign      I/O

VC03A      PO Default Reason Code       I

DATE01Order Commitment Date       I

BUMC      Conversion By Branch       I

UMB1      Sales Price Retrieval UOM I

CP01      Price Effective Based On Date I

ADVP      Advanced Pricing Flag       I  Y or N

LNIX      Last Line Number AssignedI/O

PMTH      Pricing Method       I      From Item Master

JOBS      Job Number             I      Get from Edit Line

                                                            (B4200310)

CRYR      Currency Conversion       I





Special Output Returned


Parameters:


Data Item Data Structure DescriptionI/ORequiredNotes

AEXP      Extended Price - DomesticI/O

FEA      Extended Price - ForeignI/O

ECST      Extended Cost - DomesticI/O

FEC      Extended Cost - Foreign      I/O

LNIX      Last Line Number AssignedI/O





^

Parameter NameData ItemData TypeReq/OptI/O/Both
mnParentItemNumberKITMATH_NUMERICNONENONE

The system provides for three separate item numbers.    1.   Item Number (short) - An eight-digit, computer assigned, completely 
non-significant item number.    2.   2nd Item Number - The 25-digit, free form, user defined alphanumeric item number.    3.   3rd Item Number - Another 
25-digit, free form, user defined alphanumeric item number.

szCostCenterAltMMCUcharNONENONE

A code that represents a high-level business unit. Use this code to refer to a branch or plant that might have departments or jobs, which 
represent lower-level business units, subordinate to it. For example:     o Branch/Plant (MMCU)     o Dept A (MCU)     o Dept B (MCU)     o Job 123 
(MCU) Business unit security is based on the higher-level business unit.

szTypeBillTBMcharNONENONE

A user defined code (40/TB) that designates the type of bill of material. You can define different types of bills of material for different uses. 
For example:    M     Standard manufacturing bill    RWK   Rework bill    SPR   Spare parts bill  The system enters bill type M in the work order 
header when you create a work order, unless you specify another bill type. The system reads the bill type code on the work order header to 
know which bill of material to use to create the work order parts list. MRP uses the bill type code to identify the bill of material to use when it 
attaches MRP messages. Batch bills of material must be type M for shop floor management, product costing, and MRP processing.

mnComponentLineNumberCPNTMATH_NUMERICNONENONE

A number that indicates the sequence of the components on a bill of material. It initially indicates the relative sequence in which a 
component was added to a kit or single level bill of material. You can modify this number to change the sequence in which the components appear on 
the bill of material. Skip To fields allow you to enter a component line number that you want to begin the display of information.

mnDocumentNumberDOCOMATH_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

szDocumentCompanyKCOOcharNONENONE

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.

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

jdRequestedDateDRQJJDEDATENONENONE

The date that an item is scheduled to arrive or that an action is scheduled for completion.

jdTransactionDateTRDJJDEDATENONENONE

The date that an order was entered into the system. This date determines which effective level the system uses for inventory pricing.

jdPromisedDeliveryDatePDDJJDEDATENONENONE

The promised shipment date for either a sales order or purchase order. The Supply and Demand Programs use this date to calculate 
Available to Promise information. This value can be automatically calculated during sales order entry. This date represents the day that the item 
can be shipped from the warehouse.

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

szLastStatusCodeLTTRcharNONENONE

A code (system 40/type AT) specifying the last step in the processing cycle that this order line has successfully completed.

szNextStatusCodeNXTRcharNONENONE

A user defined code (system 40/type AT) indicating the next step in the order flow of the line type.

szTransactionUoMUOMcharNONENONE

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

szPricingUoMUOM4charNONENONE

A user defined code (00/UM) that indicates the unit of measure in which you usually price the item.

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.

mnQTYBackorderedSOBKMATH_NUMERICNONENONE

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.

mnQTYCanceledSOCNMATH_NUMERICNONENONE

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.

szBaseCompanyCurrencyCRCDcharNONENONE

A code that identifies the currency of a transaction. 

szCustomerCurrencyCRDCcharNONENONE

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

cCheckAvailabilityYNCKAVcharNONENONE

A code that specifies whether the system performs availability checking.  You might want to turn on availability checking for certain items.  
For other items, if you assume that an adequate supply is available, leave availability checking turned off.  For PeopleSoft World, valid values 
are: Y The system performs availability checking. N The system does not perform availability checking.  For PeopleSoft EnterpriseOne, a 
check mark indicates that availability checking is turned on.

cBackordersAllowedYNBACKcharNONENONE

An option that specifies whether to allow backorders for this item. You can allow backorders by item using the Item Master (P4101) or Item 
Branch/Plant (P41026) programs, by customer using the Customer Billing Instructions program (P03013), or by branch/plant using the 
Branch/Plant Constants program (P41001).  Valid values are: On Allow backorders for this item. Off Do not allow backorders for this item, regardless of 
the backorders code that is assigned to the customer.

cAllowPartialShipmntsYNAPTScharNONENONE

An option that indicates whether the customer accepts partial line shipments. Valid values are: On The customer accepts partial line 
shipments. No The customer does not accept partial shipments; the entire line must be shipped at one time.

szHeaderBranchPlantEMCUcharNONENONE

A business unit is an accounting entity required for management reporting. It can be a profit center, department, warehouse location, job, 
project, work center, branch/plant, and so forth. This business unit is from the business unit entered on the header of a sales/purchase order for 
reporting purposes. This data is always right justified on entry (for example, CO123 would appear as _______CO123).  A security mechanism 
has been provided to inhibit users from entering or locating business units outside the scope of their authority.

mnSoldToAddressNumberAN8MATH_NUMERICNONENONE

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

WriteKitCompToF4211YNEV05charNONENONE

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

cAddorMaintainMODEcharNONENONE

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

mnTransactionQtyUORGMATH_NUMERICNONENONE

The quantity of units affected by this transaction.

mnDomesticExtendedPriceAEXPMATH_NUMERICNONENONE

The number of units multiplied by the unit price.

mnForeignExtendedPriceFEAMATH_NUMERICNONENONE

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

mnDomesticExtendedCostECSTMATH_NUMERICNONENONE

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

mnForeignExtendedCostFECMATH_NUMERICNONENONE

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

szPODefaultReasonCodeVC03AcharNONENONE

This is a generic field used as a work field in Everest.

OrdercommitmentDateDATE01JDEDATENONENONE

Event point for JDE Date.

cConversionsByBranchBUMCcharNONENONE

A code that indicates how the system uses the branch/plant within the Item Specific Unit of Measure Conversion tables. Valid values are:    Y 
The system displays the item-specific conversion table when you add an item to a specific branch/plant.    N The system displays the 
item-specific conversion table for all branch/plants from the Item Master table.

cSalesPriceRetrievalUOMUMB1charNONENONE

A code that specifies the unit of measure that the system uses for retrieving base prices and price adjustments for sales order processing, 
service and warranty management, and ship and debit processing. The system allows users to define base prices in the Item Base Price 
File table (F4106) and price adjustments in the Price Adjustment Detail table (F4072) in various units of measure. If the base price or price 
adjustments are not found in the specified unit of measure, then the system uses the primary unit of measure for the item.

cPricingEffectiveBasedOnDateCP01charNONENONE

A code that determines how the system updates the Price Effective Date in the Sales Order Header (F4201) and Detail (F4211) tables. In 
the Sales Order Management system, the system uses the Price Effective Date to retrieve the base price from the Sales Order Header table 
(F4106) and price adjustments from Sales Order Detail table (F4072).

cAdvancedSalesPricingYNADVPcharNONENONE

Indicates how the system determines the price of items within your system.  If your system includes the advanced pricing module, you may 
use this feature.    Y The system will use advanced pricing.    N The system will NOT use advanced pricing.

mnLastLineNumberAssignedLNIXMATH_NUMERICNONENONE

cPricingMethodPMTHcharNONENONE

A code that determines how the system calculates the price for kit items or configured items. Valid values are: Blank Use for items that are 
neither kit items nor configured items. 1 The system accumulates the base prices of components with the configured price adjustments, and 
then discounts the total. 2 The system accumulates the base price of the parent item with the configured price adjustments, and then discounts 
the total. 3 The system accumulates the configured price adjustments, and then discounts the total. 4 The system accumulates the individually 
discounted price of the components with the configured price adjustments. Note: Configured price adjustments are only included in the 
calculation for a configured item. Also, the system only discounts costs 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

mnJobnumberAJOBSMATH_NUMERICNONENONE

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

cCurrencyConverYNARCRYRcharNONENONE

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.

cOKorCANCELEV01charNONENONE

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

szPrimaryItemNumberUITMcharNONENONE

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

szSOEVersionIDVERScharNONENONE

A user-defined set of specifications that control how applications and reports run. You use versions to group and save a set of user-defined 
processing option values and data selection and sequencing options. Interactive versions are associated with applications (usually as a 
menu selection). Batch versions are associated with batch jobs or reports. To run a batch process, you must choose a version.

cTaxableYNTAX1charNONENONE

A code that indicates whether the item is subject to sales tax when you sell it. The system calculates tax on the item only if the customer is 
also taxable.

cUseCacheorWFEV02charNONENONE

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

mnFromLineNumLINNMATH_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 a system-assigned number.

mnThruLineNumberLINMATH_NUMERICNONENONE

To move rapidly through a long list of journal entries, enter a line number. The system shifts the information on that line to the top of the 
display.

cPriceOverrideCodePROVcharNONENONE

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.

cCostOverrideCodeCSTOcharNONENONE

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.

cCalledFromR47011YNEV01charOPTNONE

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

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

szSalesOrderTypeDCTOcharOPTNONE

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

mnProcessIDPEIDMATH_NUMERICOPTNONE

A code that identifies the Inter-Process Communication ID.

mnTransactionIDTCIDMATH_NUMERICOPTNONE

Related Functions

None

Related Tables

None