CalcOpenPOQtyAmtAfterReceipt

Purchase Order Receipt Functions

Major Business Rule

Object Name: B4312

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function will recalculate the new purchase order open quantity and extended amount 
following a purchase receipt


Technical Specification

Edits:




If open quantity > received quantity  (Partial Receipt) 
                                                           

       IFUORG  NE  *ZEROS                             

                                                           

            IFUOPN  GE  UORGR                             

                                                           

             IF  UOPN  GT   *ZEROS                             

                   MOVE UOPNR    PREQ               

                   MOVE '1'       EV01                

         UOPN    SUB  UORGR    UOPN                   

                       ELSE                                    

                  MOVE  UOPN    PREQ                    

                  MOVE *BLANKS   EV01                    

                  MOVE *ZEROS    UOPN                   

                  END                                     

                                                           

   If open quantity < received quantity, then either:      

      - Received quantity exceeds P.O.                     

      - Partial negative receipt.                          


                  ELSE                                

                                                       

             IFUOPN GE *ZEROS                         

                   MOVE UOPN    PREQ                

                   MOVE *BLANKS   EV01                

                  MOVE *ZEROS    UOPN               

                 ELSE                                

                  MOVE UOPNR    PREQ                

                  MOVE '1'       PREQ                

         UOPN    SUB  UORGR    UOPN               

                  END                                 

                                                       

                  END                                 

                                                       

If open quantity is zero, clear open amounts.       

                                                       

IFUOPN  EQ *ZEROS                         

                   MOVE *ZEROS    AOPN               

                   MOVE *ZEROS    FAP                

           END                                 


END                                   

If open amount > received amount  (Partial Receipt)   

                                                             

IFUORG  EQ *ZEROS                           

                                                         

        IFAOPN  GE AOPNR                           

                                                         

         IFAOPN  GT *ZEROS                           

         AOPN    SUB  AOPNR    AOPN                 

         FAP     SUB  FOPNR     FAP                  

                   ELSE                                  

                   MOVE *ZEROS    AOPN                 

                   MOVE *ZEROS    FAP                  

                   END                                   

                                                         

   If open amount < received amount, then either:      - Received amount exceeds P.O.            

         

      - Partial negative receipt.                        

ELSE                                  

                                                         

         IFAOPN  GE *ZEROS                           

                   MOVE *ZEROS    AOPN                 

                   MOVE *ZEROS    FAP                  

                   ELSE                                  

         AOPN    SUB  AOPNR    AOPN                 

         FAP     SUB  FOPNR     FAP                  

                   END                                   

              END                                   

                                                         

   If open amount is zero, clear other currency amount.  

                                                         

              IF( CRYR  NE  '  ' )  AND  ( CRYR  NE  'N' )                              

                                                         

         IF( CRRM EQ  'D' ) AND  ( AOPN  EQ  *ZEROS )                           

                   MOVE *ZEROS    PDFAP                  

                   END                                   


         IF( CRRM EQ 'F' )  AND  ( FAP  EQ  *ZEROS )                        

MOVE *ZEROS    PDAOPN              

                   END                                

          END                                

END                                


^

Data Structure

D4312F -  Calculate Open PO Qty Amount After Receipt

Parameter NameData ItemData TypeReq/OptI/O/Both
mnQuantityReceivedUOPNRMATH_NUMERICNONENONE

The quantity of an item that is available to receive.

mnQtyReceivedInOriginalUoMUORGRMATH_NUMERICNONENONE

mnPOOrderedQuantityUORGMATH_NUMERICNONENONE

The quantity of units affected by this transaction.

mnPOOpenQuantityUOPNMATH_NUMERICNONENONE

The original quantity for the order detail line, plus or minus any changes to that quantity, minus all quantities shipped, received, and 
vouchered to date.

mnQuantityOnPurchaseOrderPREQMATH_NUMERICNONENONE

The number of units specified on the purchase order in primary units of measure.

mnAmountReceivedAOPNRMATH_NUMERICNONENONE

The monetary amount of the items that you have received.

mnPOOpenAmountAOPNMATH_NUMERICNONENONE

The amount of the order, invoice, or voucher that is still unpaid or open. When you enter a document (for example, an order, invoice, or 
voucher), the open amount is the original amount of that document. If you change the original amount, the open amount is reduced by the net 
change. For example,payments, shipments, or receipts against a document result in a reduction of the open balance.

mnForeignAmountReceivedFOPNRMATH_NUMERICNONENONE

mnPOForeignOpenAmountFAPMATH_NUMERICNONENONE

The unpaid foreign amount of a transaction.

cUnitOfMeasureFlagEV01charNONENONE

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

cCurrencyModeCRRMcharNONENONE

An option that specifies whether the system displays amounts in the domestic or foreign currency. On  The system displays amounts in the 
foreign currency of the transaction. Off  The system displays amounts in the domestic currency of the transaction.

cCurrencyProcessingCRYRcharNONENONE

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.

Related Functions

B4100040 Write Cardex Record
B4300160 Set Early, On Time or Late
B9800100 Get Audit Information

Related Tables

F41001 Inventory Constants
F4102 Item Branch File
F4111 Item Ledger File
F43090 Supplier/Item Relationships
CalcRecUnitCostOrExtAmtIfZero

CalcRecUnitCostOrExtAmtIfZero

Purchase Order Receipt Functions

Major Business Rule

Object Name: B4312

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function will calculate the receipt unit cost or extended amount, from the entered 
quantity, unit cost or extended amount, if the receipt unit cost or extended amount is not entered


Technical Specification


Edits:

<
Pre>
Calculate Unit Cost:

   If Unit Cost = 0, and Quantity & Extended Amount are not 0:

   (((Extended Amount  /  Quantity)  /  Conv Factor Quantity to Primary)  * Conv Fact Price to 

Primary)


   If CRYR not = ' ' and CRYR not ='N'

      If Foreign Unit Cost = 0, and Quantity & Foreign Ext Amount are not 0:

      (((Foreign Ext Amount  /  Quantity)  /  Conv Factor Quantity to Primary)  * Conv Fact Price to 

Primary)


Calculate Extended Amount:

   If Extended Amount = 0, and Quantity & Unit Cost are not 0:
   ((Unit Cost  /  Conv Factor Price to Primary)  * Primary Quantity)


   If CRYR not = ' ' and CRYR not ='N'

      If Foreign Extended Amount = 0, and Quantity & Foreign Unit Cost are not 0:

      ((Foreign Unit Cost  /  Conv Factor Price to Primary)  * Primary Quantity)



Data Structure

D4312E -  Calculate Rec Unit Cost or Ext Amount if zero

Parameter NameData ItemData TypeReq/OptI/O/Both
mnQuantityEnteredUOPNRMATH_NUMERICNONENONE

The quantity of an item that is available to receive.

mnUnitCostEnteredUCSTRMATH_NUMERICNONENONE

An amount that represents the unit cost of the item that you received.

mnExtendedAmountEnteredAOPNRMATH_NUMERICNONENONE

The monetary amount of the items that you have received.

mnPrimaryQuantityQTYMATH_NUMERICNONENONE

The number of units associated with an asset.

mnConvFactorFromToPrimaryCONVMATH_NUMERICNONENONE

The factor that the system uses to convert one unit of measure to another unit of measure.

mnConvFactorToToPrimaryCONVMATH_NUMERICNONENONE

The factor that the system uses to convert one unit of measure to another unit of measure.

cCurrencyProcessingCRYRcharNONENONE

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.

mnForeignUnitCostEnteredFCSTRMATH_NUMERICNONENONE

mnForeignExtendedAmountEnteredFOPNRMATH_NUMERICNONENONE

Related Functions

B4100040 Write Cardex Record
B4300160 Set Early, On Time or Late
B9800100 Get Audit Information

Related Tables

F41001 Inventory Constants
F4102 Item Branch File
F4111 Item Ledger File
F43090 Supplier/Item Relationships
GetPORecInfoFromF41001

GetPORecInfoFromF41001

Purchase Order Receipt Functions

Major Business Rule

Object Name: B4312

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function will retrieve the necessary information from the Branch Constants (F41001) 
table for the Purchases Receipts program to process.


Technical Specification
Edits:



If GENLNG is NULL or zero, return.



Retrievals:

Use GENLNG to access F41001 information.




Data Structure

D4312A - Get Purchase Order Rec Info from F41001

Parameter NameData ItemData TypeReq/OptI/O/Both
idPointerToF41001GENLNGIDNONENONE

General purpose ID variable.

cSymbolIDShortSYM1charNONENONE

A symbol that identifies the 8-character short item number when you do not want to use it as the primary number. A blank in this field 
indicates that you want to use this item number as the primary number. That is, you use it most often to enter or review information. If this is not the 
primary number, you must enter a special symbol to identify it. Use a symbol that is not significant for any other purposes of entry such as /, *, or &. 
Do not use a period or a comma as a symbol. When you enter this item number on any other form, you must include this symbol as the first 
character. NOTE: Only one of the fields for item number symbols (SYM1, SYM2, SYM3, or SYM6) can be blank to identify it as the primary 
number. All others must include a unique symbol.

cSymbolID2ndSYM2charNONENONE

A symbol that identifies the 25-character second item number when you do not want to use it as the primary number. A blank in this field 
indicates that you want to use this item number as the primary number. That is, you use it most often to enter or review information. If this is not the 
primary number, you must enter a special symbol to identify it. Use a symbol that is not significant for any other purposes of entry such as /, *, 
or &. Do not use a period or a comma as a symbol. When you enter this item number on any other form, you must include this symbol as the 
first character. NOTE: Only one of the fields for item number symbols (SYM1, SYM2, SYM3, or SYM6) can be blank to identify it as the primary 
number. All others must include a unique symbol.

cSymbolID3rdSYM3charNONENONE

A symbol that identifies the 25-character third item number when you do not want to use it as the primary number. A blank in this field 
indicates that you want to use this item number as the primary number. That is, you use it most often to enter or review information. If this is not the 
primary number, you must enter a special symbol to identify it. Use a symbol that is not significant for any other purposes of entry such as /, *, or &. 
Do not use a period or a comma as a symbol. When you enter this item number on any other form, you must include this symbol as the first 
character. Note: Only one of the fields for item number symbols (SYM1, SYM2, SYM3, or SYM6) can be blank to identify it as the primary 
number. All others must include a unique symbol.

cSupplierNumberSYM5charNONENONE

A character that identifies the customer's or supplier's number in your system. When you enter a number preceded by this character, the 
system recognizes the number as the customer's or supplier's number. The system then use the cross-reference table to match the number to 
your item number. You must complete this field if you want the system to perform cross-referencing.

szSupplierCrossRefCodeXRT2charNONENONE

A user defined code (41/DT) that identifies the type of cross-reference set up for this supplier. Examples of cross-reference types include:    
1.   Substitutes    2.   Replacements    3.   Bar Codes    4.   Customer Numbers    5.   Supplier Numbers 

cWriteUnitsToJournalEntriesUNGLcharNONENONE

A code that indicates whether the system moves units to the general ledger after the system records a journal entry from the following 
programs:        P31111 (Work Order Inventory Issues)        P31112 (Work Order Completions)        P31802 (Work Order Journal Entries)        P31842 
(Rate Base Journal Entries)        P4112 (Inventory Issues)        P4113 (Inventory Transfers)        P4114 (Inventory Adjustments)        P4116 (Item 
Re-Classification)        P41413 (Cycle Count Update)        P41610 (Tag Update)        P42800 (Sales Update)        P4312 (Receipts)        P4314 (Voucher 
Match)        P415021 (Update Operational Reconciliation)        P415101 (General Stock Movements)        P41514 (Bulk Manufacturing 
Gains/Losses)        P49800 (Sales Update - A7.3 ECS Version)        P49700 (Cycle Billing)        P49510 (Bulk Load Confirmation - XT49799)        P49515 (Bulk 
Load Confirm Batch - XT49799)        P49530 (Package Load Confirm - XT49799)        P49572 (Upload Gantry Data - XT49799)        P49710 (Bulk 
Delivery Confirm - XT49799)        P49711 (Bulk Delivery Confirm Milk Run - XT49799)        P49715 (Bulk Disposition - XT49799)        P49720 
(Package Delivery Confirm - XT49799)        P49731 (Mass Confirm Batch - XT49799)

cGLExplanationPRIMcharNONENONE

A code that the Inventory Management system uses to select the default description that appears on the second line of a journal entry in the 
general ledger. Valid values are:    1   Item master description (the default).    2   Primary item number.

cWarehouseControlWCTLcharNONENONE

A code that determines whether the system creates warehouse transactions for the branch/plant.

Related Functions

B4100040 Write Cardex Record
B4300160 Set Early, On Time or Late
B9800100 Get Audit Information

Related Tables

F41001 Inventory Constants
F4102 Item Branch File
F4111 Item Ledger File
F43090 Supplier/Item Relationships
GetPORecInfoFromF4102

GetPORecInfoFromF4102

Purchase Order Receipt Functions

Major Business Rule

Object Name: B4312

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose


This business function will retrieve the necessary information from the Item Branch (f4102) table for 

the Purchases Receipts program to process.


Technical Specification



Edits:

If GENLNG is NULL or zero, return.


Retrievals:

Use GENLNG to access F4102 information.



Data Structure

D4312B - Get Purchase Order Rec Info From F4102

Parameter NameData ItemData TypeReq/OptI/O/Both
idPointerToF4102GENLNGIDNONENONE

General purpose ID variable.

cStockingTypeSTKTcharNONENONE

A user defined code (41/I) that indicates how you stock an item, for example, as finished goods or as raw materials. The following stocking 
types are hard-coded and you should not change them:    0   Phantom item    B Bulk floor stock    C Configured item    E Emergency/corrective 
maintenance    F Feature    K Kit parent item    N Nonstock  The first character of Description 2 in the user defined code table indicates if the item 
is purchased (P) or manufactured (M).

cLotProcessTypeSRCEcharNONENONE

A code that indicates whether lot or serial number is assigned. Lot and serial number processes use the Lot Master table (F4108). Valid 
codes are:    0   Lot assignment is optional. You can manually assign numbers. Quantity can be greater than one. (Default)    1   Lot assignment is 
required. The system assigns numbers using the system date in YYMMDD format. Quantity can be greater than one.    2   Lot assignment is 
required. The system assigns numbers in ascending order using Next Numbers. Quantity can be greater than one.    3   Lot assignment is 
required. You must manually assign numbers. Quantity can be greater than one.    4   Serial number assignment is optional except during shipment 
confirmation. Quantity must not exceed one.    5   Serial number assignment is required. The system assigns numbers using the system date 
in YYMMDD format. Quantity must not exceed one.    6   Serial number assignment is required. The system assigns numbers in ascending 
order using Next Numbers. Quantity must not exceed one.    7   Serial number assignment is required. You must manually assign numbers. 
Quantity must not exceed one.

mnShelfLifeDaysSLDMATH_NUMERICNONENONE

The number of days that an item can remain in inventory before it expires. The system adds this number to the date that the item is received 
to determine the expiration date for the item. If you do not enter a value here, you must enter an expiration date each time you receive the lot 
item.

cLotStatusLOTScharNONENONE

A user defined code (41/L) that indicates the status of the lot. If you leave this field blank, it indicates that the lot is approved. All other codes 
indicate that the lot is on hold. You can assign a different status code to each location in which a lot resides on Item/Location Information or 
Location Lot Status Change.

mnSupplierVENDMATH_NUMERICNONENONE

The address book number of the preferred provider of this item.

cSerialNumberProcessingSRNRcharNONENONE

A code that specifies whether you must attach a serial number to this item at receipt or sale for basic serial number processing, or whether 
memo lot information is required for advanced serial number processing. Advanced serial number processing allows you to use a serial 
number to track an item through purchasing and sales. For basic serial number processing, valid values are: Y Yes, the system requires a serial 
number for all transactions pertaining to this item in related inventory, sales, and purchase order programs. N No, the system does not require 
a serial number.  To specify lots for items with serial numbers, valid values are: 3 Supplier lot number is required (purchasing only). 4 Supplier 
lot number is required (purchasing only). Memo lot 1 is also required. 5 Supplier lot number is required (purchasing only). Memo lot 1 and 
memo lot 2 are also required. 6 Non-serialized item number (CSMS only). Values 3 through 5 specify whether lot assignment is required for items 
with serial numbers. You can require assignment of up to three lot numbers, including supplier lot, memo lot 1, and memo lot 2.

mnMarginMaintenancePercentageMMPCMATH_NUMERICNONENONE

This field is used as a method to automatically maintain a desired margin. If a value is entered in this field, every purchase order receipt will 
add the margin percentage to the item's cost, if the costing method is 1, 2, or 6, in order to generate a new list price. For example:  Item cost = 
56.00, and Margin Maintenance % = 20, then the new list price will be as follows: 56 * ( 1 + .20 ) = 67.20

Related Functions

B4100040 Write Cardex Record
B4300160 Set Early, On Time or Late
B9800100 Get Audit Information

Related Tables

F41001 Inventory Constants
F4102 Item Branch File
F4111 Item Ledger File
F43090 Supplier/Item Relationships
POReceiptF4111Shell

POReceiptF4111Shell

Purchase Order Receipt Functions

Major Business Rule

Object Name: B4312

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose


This business function will load the appropriate columns to insert cardex rows for the PO receipts 

program. The business function WriteCardexRecord is called to insert the row into the database.


Technical Specification



Edits:

• If Transaction Quantity (TRQT) is zero, exit program with no error OR
(TaxAmount (PAID) is zero AND ZeroBalanceAmount (PAID) is zero)

Exit program with no error.

• Perform Hrequest and ClearColumnBuffer for all columns in F4111

• Load the following into the GENLNG data structure for the call to InsertItemLedger
OrderNumber--  Thru --ReasonCode

'EP4312'Program ID


Call GetAuditInfo to loadTransactionDate

Creation Date

Terminal

User

Time



• If the Tax Amount is not equal to the zero AND Cost Method is NOT '07'
AND Transaction Quantity (TRQT) is NOT zero.(9/26)


Tax AmountExtended Cost (PAID)

TaxAmount / Trans. QuantityUnit Cost (UNCS)

0Trans. Quantity (TRQT)

'Taxes'Explanation - Transaction


Call InsertItemLedger


• If the Zero Balance Amount is not equal to the zero

Zero Balance AmountExtended Cost (PAID)

0Unit Cost (UNCS)

0JE Line Number (JELN)

0Trans. Quantity (TRQT)

'Zero Balance Adjustment'Explanation - Transaction


Call InsertItemLedger


^

Data Structure

D4312G - POReceiptF4111Shell

Parameter NameData ItemData TypeReq/OptI/O/Both
mnOrderNumberDOCOMATH_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

szOrderKeyCompanyKCOOcharNONENONE

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.

mnReceiptNumberNLINMATH_NUMERICNONENONE

A number representing the number of lines on either a purchase or sales order. or The number of receivers recorded during the receipts 
process.  This field will be used in Voucher Matching.

mnBatchNumberICUMATH_NUMERICNONENONE

A number that identifies a group of transactions that the system processes and balances as a unit. When you enter a batch, you can either 
assign a batch number or let the system assign it using the Next Numbers program.

mnDocumentNumberDOCMATH_NUMERICNONENONE

A number that identifies the original document, such as a voucher, invoice, or journal entry. On entry forms, you can assign the document 
number or let the system assign it using the Next Numbers program (P0002). Matching document numbers (DOCM) identify related documents 
in the Accounts Receivable and Accounts Payable systems. Examples of original and matching documents are: Accounts Payable     o 
Original document - voucher     o Matching document - payment  Accounts Receivable     o Original document - invoice     o Matching document - 
receipt  Note: In the Accounts Receivable system, the following transactions simultaneously generate original and matching documents: 
deductions, unapplied receipts, chargebacks, and drafts.

szDocumentTypeDCTcharNONENONE

A user defined code (00/DT) that identifies the origin and purpose of the transaction.  PeopleSoft reserves several prefixes for document 
types, such as, vouchers, invoices, receipts, and timesheets. The reserved document type prefixes for codes are: P Accounts payable 
documents R Accounts receivable documents  T Time and Pay documents I Inventory documents  O Purchase order documents  S Sales order 
documents 

szKeyCompanyKCOcharNONENONE

A number that, with the document number, document type and G/L date, uniquely identifies an original document, such as invoice, voucher, 
or journal entry. If you use the Next Numbers by Company/Fiscal Year feature, the Automatic Next Numbers program (X0010) uses the 
document company to retrieve the correct next number for that company. If two or more original documents have the same document number and 
document type, you can use the document company to locate the desired document.

mnShortItemNumberITMMATH_NUMERICNONENONE

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

szSecondItemNumberLITMcharNONENONE

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.

szThirdItemNumberAITMcharNONENONE

The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item 
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned 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.  In addition to 
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to 
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier 
numbers.

szBranchPlantMCUcharNONENONE

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.

szLocationLOCNcharNONENONE

The storage location from which goods will be moved.

cLotStatusLOTScharNONENONE

A user defined code (41/L) that indicates the status of the lot. If you leave this field blank, it indicates that the lot is approved. All other codes 
indicate that the lot is on hold. You can assign a different status code to each location in which a lot resides on Item/Location Information or 
Location Lot Status Change.

szLotLOTNcharNONENONE

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

szLotGradeLOTGcharNONENONE

A code that indicates the grade of a lot. The grade is used to indicate the quality of the lot. Examples include the following:    A1   Premium 
grade    A2   Secondary grade  The grade for a lot is stored in the Lot Master table (F4108).

mnLotPotencyLOTPMATH_NUMERICNONENONE

A code that indicates the potency of the lot expressed as a percentage of active or useful material (for example, the percentage of alcohol 
in a solution). The actual potency of a lot is defined in the Lot Master table (F4108).

szGLClassGLPTcharNONENONE

A user defined code (41/9) that identifies the G/L offset that system uses when it searches for the account to which it posts the transaction. If 
you do not want to specify a class code, you can enter **** (four asterisks) in this field. You can use automatic accounting instructions (AAIs) to 
predefine classes of automatic offset accounts for the Inventory Management, Procurement, and Sales Order Management systems. You 
might assign G/L class codes as follows:    IN20   Direct Ship Orders    IN60   Transfer Orders    IN80   Stock Sales  The system can generate 
accounting entries based upon a single transaction. For example, a single sale of a stock item can trigger the generation of accounting entries 
similar to the following:         Sales-Stock (Debit) xxxxx.xx     A/R Stock Sales (Credit) xxxxx.xx     Posting Category: IN80             Stock Inventory 
(Debit) xxxxx.xx     Stock COGS (Credit) xxxxx.xx The system uses the class code and the document type to find the AAI.

jdTransactionDateTRDJJDEDATENONENONE

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

jdGLDateDGLJDEDATENONENONE

A date that identifies the financial period to which the transaction is to be posted.  The company constants specify the date range for each 
financial period. You can have as many as 14 periods. Generally, period 14 is used for audit adjustments. The system validates this field for 
PBCO (posted before cutoff), PYEB (prior year ending balance), PACO (post after cutoff), and WACO (post way after cutoff) messages.

mnSupplierAN8MATH_NUMERICNONENONE

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

szTransactionRemarkTREXcharNONENONE

Text that identifies the reason that a transaction occurred.

mnTransactionQuantityTRQTMATH_NUMERICNONENONE

A value that represents the available quantity, which might consist of the on-hand balance minus commitments, reservations, and 
backorders. You enter this value in the Branch/Plant Constants program (P41001).

szTransactionUoMTRUMcharNONENONE

The unit of measure you used when you entered this transaction into the system.

szReasonCodeRCDcharNONENONE

A user defined code (42/RC) that explains the purpose for a transaction. For example, you can indicate the reason that you are returning 
items.

mnTaxAmountPAIDMATH_NUMERICNONENONE

The extended cost or price value of an inventory transaction for an inventory item.

szTaxRemarkTREXcharNONENONE

Text that identifies the reason that a transaction occurred.

mnTaxJELineNumberJELNMATH_NUMERICNONENONE

A number that designates a line within a journal entry. The system uses this field to sequence the journal entry lines for inquiry purposes.

mnZeroBalanceAmountPAIDMATH_NUMERICNONENONE

The extended cost or price value of an inventory transaction for an inventory item.

szZeroBalanceRemarkTREXcharNONENONE

Text that identifies the reason that a transaction occurred.

mnZeroBalanceJEJELNMATH_NUMERICNONENONE

A number that designates a line within a journal entry. The system uses this field to sequence the journal entry lines for inquiry purposes.

szDocumentSuffixSFXcharNONENONE

A number that identifies the pay item for a voucher or an invoice. The system assigns the pay item number. If the voucher or invoice has 
multiple pay items, the numbers are sequential.

Related Functions

B4100040 Write Cardex Record
B4300160 Set Early, On Time or Late
B9800100 Get Audit Information

Related Tables

F41001 Inventory Constants
F4102 Item Branch File
F4111 Item Ledger File
F43090 Supplier/Item Relationships
UpdatePORecInfoToF43090

UpdatePORecInfoToF43090

Purchase Order Receipt Functions

Major Business Rule

Object Name: B4312

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function will update the supplier/ item relationship table (f43090) with the PO Receipt 
information, such as lead time and arly/ on-time  / late quantity/amount.

If the record does not exist it is inserted into the f43090 table


Technical Specification


2.4    Naming Convention

Throughout this document the following naming and formatting standards will be adhered to:


• Italic Names are used to indicate passed parameters to this Business Function
• int_ is used to denote variables defined internally to the business function.
• Names that are in Bold refer to other business functions.
• Processing Option values will be denoted with a PO_ in front of them.


2.5    Processing



• 2.5.1Initializations

Purpose of This Section

Perform all processing that will get information like Unit Of Measure conversion factors, PO Receipt 
record and Audit Info 


New Internal FieldsLocal Or GlobalPurpose Of Field
int_TodaysDateGlobalStore today's date

int_CurrentTimeGlobalStore current time

int_F43121lntyGlobalSaved field from 

Receiver Table (F43121)

int_F43121an8GlobalSaved field from 

Receiver Table (F43121)

int_F43121uomGlobalSaved field from 

Receiver Table (F43121)

int_F43121uom3GlobalSaved field from 

Receiver Table (F43121)

int_F43121locnGlobalSaved field from 

Receiver Table (F43121)

int_F43121lotnGlobalSaved field from 

Receiver Table (F43121)

int_F43121mcuGlobalSaved field from 

Receiver Table (F43121)

int_F43121rcdjGlobalSaved field from 

Receiver Table (F43121)

int_F43121urecGlobalSaved field from 

Receiver Table (F43121)

int_F43121GlobalSaved field from 

Receiver Table (F43121)

int_F43121GlobalSaved field from 

Receiver Table (F43121)

int_InventoryInterfaceGlobal

int_TrnToPrchCnvFactorGlobalConversion factor: 

Transaction to Purchasing

int_TrnToPrimaryCnvFactorGlobalConversion factor: 

Transaction to Primary

int_PrchToPrimaryCnvFactorGlobalConversion factor: 

Purchasing to Primary

int_F43121RowLocalPointer to F43121 

record





Data Structure

D4312H - Update Purchase Order Receipts Information to F43090

Parameter NameData ItemData TypeReq/OptI/O/Both
idF43090PointerGENLNGIDNONENONE

General purpose ID variable.

cF43090NotFoundEV01charNONENONE

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

jdPOTransactionDateTRDJJDEDATENONENONE

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

jdReceiptDateRCDJJDEDATENONENONE

The date you received this purchase order line.

jdPromisedDatePDDJJDEDATENONENONE

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.

cEarlyOntimeLateEV01charNONENONE

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

cReceiptReversalEV01charNONENONE

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

cReceiptRoutingEV01charNONENONE

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

szF41021QuantityUpdatedUPIBcharNONENONE

Indicates which quantity field in the Item Location table that the system updates when quantity is moved from one receipt routing operation 
to another. Valid values:        QTTR - Quantity in Transit         QTIN - Quantity in Inspection         QTO1 - Quantity in User-defined Operation 1         
QTO2 - Quantity in User-defined Operation 2        PQOH - Quantity on Hand PREQ - Quantity on Purchase Order

mnPrimaryQuantityReceivedQTYMATH_NUMERICNONENONE

The number of units associated with an asset.

mnPrimaryQuantityAfterReceiptQTYMATH_NUMERICNONENONE

The number of units associated with an asset.

mnPrimaryPOQuantityQTYMATH_NUMERICNONENONE

The number of units associated with an asset.

mnAmountReceivedAOPNRMATH_NUMERICNONENONE

The monetary amount of the items that you have received.

szBranchMCUcharNONENONE

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.

mnSupplierAN8MATH_NUMERICNONENONE

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

mnShortItemNumberITMMATH_NUMERICNONENONE

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

cMovingFlagRWT1charNONENONE

This flag indicates whether a record has been written to a transaction work file or not. Allowed values are :    0   Record does NOT exist in the 
transaction work file.    1   Record DOES exist in the transaction work file.

cForwardFlagRWT2charNONENONE

This flag indicates whether a record has been written to a transaction work file or not. Allowed values are :    0   Record does NOT exist in the 
transaction work file.    1   Record DOES exist in the transaction work file.

Related Functions

B4100040 Write Cardex Record
B4300160 Set Early, On Time or Late
B9800100 Get Audit Information

Related Tables

F41001 Inventory Constants
F4102 Item Branch File
F4111 Item Ledger File
F43090 Supplier/Item Relationships
VerifyQtyOrLumpSumLine

VerifyQtyOrLumpSumLine

Purchase Order Receipt Functions

Major Business Rule

Object Name: B4312

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function wilverify that the receipt quantity is entered for a quantity based PO line, 
or that no quantity is entered for a lump sum PO line




Technical Specification



Edits:

Quantity line: 
1) If Inventory Interface is Y, D, N, then Quantity Entered must be non-zero.

2) If Inventory Interface is A, B, then the Quantity Entered must be non-zero if the Quantity Ordered 

is non-zero.

Issue error message '0003' for the Quantity Entered.


Lump Sum line:

1) If Inventory Interface is A, B, then the Quantity Entered must be zero if the Quantity Ordered is 

zero.

Issue error message '3289' for the Quantity Entered.




^

Data Structure

D4312C -  verify Quantity Or Lump Sum Line

Parameter NameData ItemData TypeReq/OptI/O/Both
cInventoryInterfaceIVIcharNONENONE

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.

mnQuantityOrderedUORGMATH_NUMERICNONENONE

The quantity of units affected by this transaction.

mnQuantityEnteredUOPNRMATH_NUMERICNONENONE

The quantity of an item that is available to receive.

Related Functions

B4100040 Write Cardex Record
B4300160 Set Early, On Time or Late
B9800100 Get Audit Information

Related Tables

F41001 Inventory Constants
F4102 Item Branch File
F4111 Item Ledger File
F43090 Supplier/Item Relationships
VerifyRecQtyUnitCstExtAmtBalance

VerifyRecQtyUnitCstExtAmtBalance

Purchase Order Receipt Functions

Major Business Rule

Object Name: B4312

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function will verify that the receipt quantity, unit cost and extended amount balance 
with each other. One of two checks must pass for the entered values to balance



Technical Specification




Edits:


• If the quantity, unit cost or extended amount is zero, exit the program with no error.

• Check 1:
((Unit Cost  /  Conv Factor To to Primary)  * Primary Quantity)  =  Extended Amount

If successful, exit the program with no error.


• Check 2:
(((Extended Amount  /  Primary Quantity)  =  (Unit Cost / Conv Fact To to Primary)

If successful, exit the program with no error.

   If not successful, issue error message 0252, and highlight the Extended Amount.


^

Data Structure

D4312D -  Verify Rec Qty Unit Cost Ext Amount Balance

Parameter NameData ItemData TypeReq/OptI/O/Both
mnUnitCostEnteredUCSTRMATH_NUMERICNONENONE

An amount that represents the unit cost of the item that you received.

mnExtendedAmountEnteredAOPNRMATH_NUMERICNONENONE

The monetary amount of the items that you have received.

mnPrimaryQuantityQTYMATH_NUMERICNONENONE

The number of units associated with an asset.

mnConvFactorToToPrimaryCONVMATH_NUMERICNONENONE

The factor that the system uses to convert one unit of measure to another unit of measure.

Related Functions

B4100040 Write Cardex Record
B4300160 Set Early, On Time or Late
B9800100 Get Audit Information

Related Tables

F41001 Inventory Constants
F4102 Item Branch File
F4111 Item Ledger File
F43090 Supplier/Item Relationships
ft: 0.500000in">0Unit Cost (UNCS)

0JE Line Number (JELN)

0Trans. Quantity (TRQT)

'Zero Balance Adjustment'Explanation - Transaction


Call InsertItemLedger


^

Data Structure

D4312G - POReceiptF4111Shell

Pa