F4312BeginDoc

Purchase Order Receipts

Master Business Function

Object Name: XT4312Z1

Parent DLL: CDIST

Location: Client/Server

Language: C

Data Structure

DF4312Z1A - XT4312Z1 Edit Object - Begin Doc

Special Input Expected

Data Item  DescriptionI/OReqd.Notes


System Fields


JOBSJobNumberI/ONAssigned if blank.  Once assigned, must be passed in with all 

subsequent calls.  Part of key to receiver cache (F43121Z)


CTIDComputerIDIYPart of key to receiver cache (F43121Z )  Use GetComputerID() to 

obtain the value prior to calling this function.


PIDProgramIDIYIndicates calling application.  Valid values:

'EP4312' (Called from 'P.O. Receipts' to receive PO lines)

'EP43214' (Called from 'Receipts Inquiry' to reverse PO Lines)

'EP43250' (Called from 'Routing Movement' to move quantity to and from 'On Hand' status in 

Receipt Routing)

'EP43253' (Called from 'Routing Disposition' to move quantity to and from 'On Hand' status in 

Receipt            Routing)


VERSPOVersionINVersion of calling application.  Used to obtain Processing 

Options.  PO in description stands for "Processing Option".  Default value: ZJDE0001


USERUserIDIY


EV01ReceiptsByPOINIf receiving by P.O then pass in '1'



Processing Flags


SELCOptionIYValid values:

1=Receive P.O.Line completely

4=Receive P.O.Line into Multiple Locations

7=Receive P.O.Line Partially and Close out the remainder 

8=Reverse the P.O.Receipt completely

9=Cancel the P.O.Line (i.e. Close out the line on the P.O) 


ACTNActionCodeIYValid values:

'A' or '1' = Receive P.O.Line (Always use if 'Option' != 8)

'D' or '3' = Receipt Reversal (Always use if 'Option' = 8)


CRYRCurrencyProcessingFlagINAssigned if blank.  Valid values: 'Y', 'N', 'Z'.  Indicates 

whether currency processing is ON ('Y', 'Z') or OFF ('N')


RWT1ProcessEditsIY'1' == Perform full editing on fields.  For now, pass in '1'

('0' == Do not perform editing on fields **FUTURE**)

('2' == Perform partial editing only **FUTURE**)



P.O. Line Information


DOCOOrderNumberIYPart of key in P.O. Header (F4301).  Used to obtain P.O. Header


DCTOOrderTypeIYPart of key in P.O. Header (F4301).  Used to obtain P.O. Header


KCOOOrderCompanyIYPart of key in P.O. Header (F4301).  Used to obtain P.O. Header


SFXOOrderSuffixI/ONAssigned to '000' if blank.  Part of key in P.O. Header (F4301).  

Used to obtain P.O. Header



P.O. Receipt Information


DOCReceiptNumberINIf passed in, then validated against the P.O. Receipts table  

(F43121).  If it exists in F43121 then return error because it is not unique.


RCDJReceiptDateI/ONAssigned to today's date if passed in blank



Batch Information


ICUBatchNumberI/ONA batch will be opened if batch number is not passed in.  Batch 
Type is assumed to be 'O'



General Ledger Information


DGLGLDateI/ONAssigned to today's date if passed in blank.  Validated against 

current G/L period



EDI Transaction


EV01CalledFromEDII** Required only if it is a EDI transaction


Special Output Returned


Data Item  DescriptionI/OReqd.Notes


System Fields


JOBSJobNumberI/ONAssigned if blank.  Once assigned, must be passed in with all 

subsequent calls.  Part of key to receiver cache (F43121Z)



Processing Flags


CRRMCurrencyModeONIndicates if in Foreign ('F') or Domestic ('D') mode.  Obtained 

from P.O. Header (F4301)



P.O. Line Information


AN8SupplierONObtained from P.O. Header (F4301)


HCODHoldCodeONIndicates whether the Order is 'On Hold' (Non blank value) or     

not (Blank).  Obtained from P.O Header (F4301)



P.O. Receipt Information


RCDJReceiptDateI/ONAssigned to today's date if passed in blank



Currency Fields


CRDCBaseCurrencyONBase currency of parameter 'OrderCompany'.  Obtained from P.O. 
Header (F4301)


CRCDPOCurrencyONCurrency the PO is in. Obtained from P.O. Header (F4301)


CRRExchangeRateONConversion between parameters 'BaseCurrency' (Domestic) and    

'POCurrency' (Foreign).  Obtained from P.O. Header (F4301)



Batch Information


ICUBatchNumberI/ONA batch will be opened if batch number is not passed in.  Batch 
Type is assumed to be 'O'


BSTBatchStatusON


ICDJBatchDateONWill be assigned as today's date


EV01PostOutOfBalanceON



General Ledger Information


DGLGLDateI/ONAssigned to today's date if passed in blank.  Validated against 

current G/L period

^

Parameter NameData ItemData TypeReq/OptI/O/Both
mnJobNumberJOBSMATH_NUMERICNONENONE

Special Input Expected
Assigned if blank.  Once assigned, must be passed in with all subsequent calls.  Part of key to 

receiver cache (F43121Z).


Special Output Returned

Receiver cache job number

^

szComputerIDCTIDcharNONENONE

Special Input Expected
Part of key to receiver cache (F43121Z )  Use GetComputerID() to obtain the value prior to calling 

this function.

^

cActionCodeACTNcharNONENONE

Significant Data Values
'A' or '1' - Receive P.O.Line (Always use if 'Option' != 8)

'D' or '3' - Receipt Reversal (Always use if 'Option' = 8)

^

cProcessEditsEV01charNONENONE

Significant Data Values
'1' - Perform full editing on fields.  For now, pass in '1'

('0' - Do not perform editing on fields **FUTURE**)

('2' - Perform partial editing only **FUTURE**)

^

szProgramIDPIDcharNONENONE

Significant Data Values
EP4312  - Called from 'P.O. Receipts' to receive PO lines

EP43214 - Called from 'Receipts Inquiry' to reverse PO Lines

EP43250 - Called from 'Routing Movement' to move quantity to and from 'On Hand' status in Receipt 

Routing

EP43253 - Called from 'Routing Disposition' to move quantity to and from 'On Hand' status in Receipt 

Routing

^

cCurrencyProcessingFlagCRYRcharNONENONE

Special Input Expected
Assigned if blank.


Significant Data Values

'Y' - Currency on and use multipliers

'Z' - Currency on and use divisors

'N' - Currency off


^

mnOrderNumberDOCOMATH_NUMERICNONENONE

Special Input Expected
Part of key in P.O. Header (F4301).  Used to obtain P.O. Header.

^

szOrderTypeDCTOcharNONENONE

Special Input Expected
Part of key in P.O. Header (F4301).  Used to obtain P.O. Header.


^

szOrderCompanyKCOOcharNONENONE

Special Input Expected
Part of key in P.O. Header (F4301).  Used to obtain P.O. Header.

^

szOrderSuffixSFXOcharNONENONE

Special Input Expected
Assigned to '000' if blank.  Part of key in P.O. Header (F4301).  Used to obtain P.O. Header.


Special Output Returned

'000' returned if passed in blank.



^

cCurrencyModeCRRMcharNONENONE

Special Output Returned
Indicates if in Foreign ('F') or Domestic ('D') mode.  Obtained from P.O. Header (F4301).


^

mnReceiptNumberDOCMATH_NUMERICNONENONE

Special Input Expected
If passed in, then validated against the P.O. Receipts table  (F43121).  If it exists in F43121 then 

return error because it is not unique.

^

mnSupplierAN8MATH_NUMERICNONENONE

Special Output Returned
Obtained from P.O. Header (F4301).

^

szBaseCurrencyCRDCcharNONENONE

Special Output Returned
Base currency of parameter 'OrderCompany'.  Obtained from P.O. Header (F4301).

^

szPOCurrencyCRCDcharNONENONE

Special Output Returned
Base currency of parameter 'OrderCompany'.  Obtained from P.O. Header (F4301).


^

mnExchangeRateCRRMATH_NUMERICNONENONE

Special Output Returned
Conversion between parameters 'BaseCurrency' (Domestic) and    'POCurrency' (Foreign).  Obtained from 

P.O. Header (F4301).


^

jdReceiptDateRCDJJDEDATENONENONE

Special Output Returned
Assigned to today's date if passed in blank.

^

jdGLDateDGLJDEDATENONENONE

Special Output Returned
Assigned to today's date if passed in blank.  Validated against current G/L period

^

szHoldCodeHCODcharNONENONE

Special Output Returned
Obtained from P.O Header (F4301).

^

szUserIDUSERcharNONENONE

The code that identifies a user profile.

szPOVersionVERScharNONENONE

Special Input Expected
Version of calling application.  Used to obtain Processing Options.  PO in description stands for 

"Processing Option".  Default value: ZJDE0001

^

mnBatchNumberICUMATH_NUMERICNONENONE

Special Output Returned
A batch will be opened if batch number is not passed in.  Batch Type is assumed to be 'O'

^

cBatchStatusRWT1charNONENONE

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.

cPostOutOfBalanceRWT2charNONENONE

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.

jdBatchDateDICJJDEDATENONENONE

Special Output Returned
Will be assigned as today's date.

^

cOptionSELCcharNONENONE

Significant Data Values
1 - Receive P.O. Line completely

4 - Receive P.O. Line into Multiple Locations

7 - Receive P.O. Line Partially and Close out the remainder 

8 - Reverse the P.O. Receipt completely

9 - Cancel the P.O. Line (i.e. Close out the line on the P.O) 


^

cReceiptsByPOEV01charNONENONE

Special Input Expected
If receiving by P.O then pass in '1'.


^

cCalledFromEDIEV03charNONENONE

Special Input Expected
If an EDI transaction then pass in '1'.

^

mnTriangulationRateFromCurrencTRR1MATH_NUMERICOPTNONE

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

mnTriangulationRateToCurrencyTRR2MATH_NUMERICOPTNONE

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

cCurrencyConversionMethodCRCMcharOPTNONE

A value that specifies which method to use when converting from one currency to another. Valid values are:  Y  Multiplier method. The 
system multiplies the foreign amount by the multiplier exchange rate to calculate the domestic amount. Z Divisor method. The system divides the 
foreign amount by the divisor exchange rate to calculate the domestic amount.

jdGLDateCascadeReceiptDGLJDEDATEOPTNONE

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.

Related Functions

B0000026 Edit Exchange Rate Tolerance
B0000027 CurrencyConvForAndDom
B0000032 RetrieveCurrencyConvFlag
B0000033 Get Exchange Rate
B0000042 Batches
B0000083 Convert Math Numeric to String with Left Zero Pad
B0000128 Retrieve Company Currency Code
B0000129 Retrieve Currency Decimals
B0000130 Retrieve Company From Business Unit
B0000173 Determine Date, Conversion Method and Rates
B0000175 Get Next Transaction Number
B0000176 Add Transaction To Subsystem Queue
B0200098 PPAT - Get User Id, Address Book Number
B0900049 Journal Entry
B3003130 F30026 Cost Components Cache
B3100730 Update Routing For PO Reciepts
B4000260 Line Type - Activity Rules
B4000350 Retrieve Distribution AAI
B4000520 Get Item UoM Conversion Factor
B4000880 Verify And Get Address Book for OP
B4000920 Get Item Branch Mfg Data
B4000930 Update F4102 MRP Net Chg
B4001090 Tax Calculator
B4002000 Compute Unit Or Extended Amount
B4100030 Verify Quantity Cost Extended
B4100150 Get Lot Master Fields
B4100210 Check Item Branch
B4100600 Verify And Get Item XRef
B41B0370 Get Bulk Info from Item Master Pointer
B4201210 Serial Number Processing Edits
B4300030 Edit Purchasing Tolerance Rules
B4300110 Get Purchase Order Detail
B4300130 Get Purchase Order Header
B4300150 Get Supplier Item Relationships
B4300160 Set Early, On Time or Late
B4300210 Calc PO Rec Std Cost Variance
B4300220 Calculate PO Receipt Zero Balance Adjustment
B4300230 Update PO Order Total
B4300370 Get Purchase Order Receipt
B4300430 Calculate Closed Amounts
B4300450 Calculate Amount and Quantity on Reversal
B4300570 Receipt Routing, Verify Receipt Routing Process
B4300780 F43092 Get Receipt Routing Record
B4300890 F43092, Verify Active Operations
B4300950 P43250, Retrieve Processing Options
B4301030 Get Landed Cost Record
B4301040 F41291 Read/Write Landed Cost Based on Amount
B4301050 F41291 Read/Write Landed Cost Job Numbers
B4301080 Duplicate PO Detail Lines
B4301171 Read/Write F4311 Cache
B4301220 Purchasing Tolerance Rules Cache Functions
B4301230 F4311 - Update Original PO Line
B4301280 F43121 Get Next Document Number
B4301300 F43121 Update Landed Cost Records
B4301350 F41291 Rev Landed Cost Cache
B4301360 F4312 Status Code Cache
B4301410 Maintain Purchasing Parms Cache
B4301500 F43121 Get Next Receipt Traveler Number
B4301670 P4312 SO Backorder Release Read Write Cache
B4301720 Read/Write Cost Type Journal Entry Line Number Cache
B4301730 Receipts Accumulation Quantity Cache
B4312 Purchase Order Receipt Functions
B4600630 F46130 Get Reserved Location
B9800100 Get Audit Information
B9900410 Get Environment Value
N3800040 F38012 Agreement Transaction Server
N3800050 F38010 Agreement Search
N3800060 F38010 Simple Edit
N4002540 F4211 Direct Ship Order Integrity
N41B0450 Get Bulk / Transaction Quantity
N4300970 Landed Cost Selection
N4301620 F43121T Retrieve Tag Record
N4600560 F46130 Reservations Reconciliation Server
N4700060 EDI Batch Number, Get Next Number
N4900510 Process Shipment Confirmation
X00COM Update Commitment Ledger
X0903 Fiscal Date Edits +
X0909 Validate Subledger
X1202 F1201 Validate Asset Number
X4101 Validate and Retrieve Item Master
X43091 Receipt Routing Initiator
X43092R F43092 Receipt Routing Deleter
X43199 Insert Purchase Ledger
XF41021 Update F41021 Locations
XF4105 Item Cost I/O
XF43121 Purchase Order Item Ledger Functions
XT4111Z1 Inventory Transactions
XT4311Z1 Purchase Order Entry

Related Tables

F43121Z Receiver workfile
F43121Z1 Receipts Unedited Transaction Table
F4312ClearWorkFile

F4312ClearWorkFile

Purchase Order Receipts

Master Business Function

Object Name: XT4312Z1

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function is part of the Purchase Order Receipts Master Business Function.  It will 
perform any deletions from the Receiver cache that are required.


Setup Notes and Prerequisites

• During the process of evolving of the OneWorld tool, numerous decisions were made that effect the 
design of this program.  Please keep in mind that old terminology may be used in this documentation from 

time to time because I have simply overlooked it or forgotten to replace it.  One big change was the 

use of cache to store the workfile rather than storing it as part of the database.  Previously, when 

the workfile was part of the database, it was referred to as 'F43121Z' or the 'Receiver Workfile'; now 

it is referred to as the 'Receiver Cache' or 'F43121Z'.  In object librarian it is still called 

F43121Z, however when created in the cache, it is called 'CF43121Z'.  (Please do not confuse this cache 

table with another cache table, 'Tolerance Cache' or 'Ctolerance', also used in this program.)

• If no records in the cache exist then function will simply exit with no errors.

Special Logic

Please see Technical Specification section.



Technical Specification

Not included at this time.

Data Structure

DF4312Z1D - XT4312Z1 Edit Object - Clear Work File

Special Input Expected

Data Item  DescriptionI/OReqd.Notes

JOBS
JobNumberIYError if blank.  F4312BeginDoc() should already have been called 
to assign a Job Number.  Part of key to receiver cache (CF43121Z)


CTIDComputerIDIYError if blank.  GetAuditInfo() should already have been called to 

assign a Computer I.D.  Part of key to receiver cache (CF43121Z )


ERRErrorInClearONWill be set to 1 if errors occurred


LNIDPOLineNumberINUsed if a specific record needs to be deleted


NLINReceiptLineNumberINUsed if a specific record needs to be deleted


DOCOOrderNumberINUsed if a specific record needs to be deleted


DCTOOrderTypeINUsed if a specific record needs to be deleted


KCOOOrderCompanyINUsed if a specific record needs to be deleted

Parameter NameData ItemData TypeReq/OptI/O/Both
szComputerIDCTIDcharNONENONE

Special Input Expected
Error if blank.  GetAuditInfo() should already have been called to assign a Computer I.D.  Part of 

key to receiver cache (CF43121Z ).

^

mnJobNumberJOBSMATH_NUMERICNONENONE

Special Input Expected
Error if blank.  F4312BeginDoc() should already have been called to assign a Job Number.  Part of key 

to receiver cache (CF43121Z).


^

cErrorInClearERRcharNONENONE

Special Output Returned
Will be set to 1 if errors occurred.

^

mnPOLineNumberLNIDMATH_NUMERICNONENONE

Special Input Expected
Used if a specific record needs to be deleted.

^

mnReceiptLineNumberNLINMATH_NUMERICNONENONE

Special Input Expected
Used if a specific record needs to be deleted.

^

mnOrderNumberDOCOMATH_NUMERICNONENONE

Special Input Expected
Used if a specific record needs to be deleted.

^

szOrderTypeDCTOcharNONENONE

Special Input Expected
Used if a specific record needs to be deleted.

^

szOrderCompanyKCOOcharNONENONE

Special Input Expected
Used if a specific record needs to be deleted.

^

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.

szPOVersionVERScharOPTNONE

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.

mnLandedCostJobNumberJOBSMATH_NUMERICOPTNONE

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

cReversalOptionOPTcharOPTNONE

Selection option. Place the cursor on the option field and press F1 for a list of valid selection options.

mnF4111JobNumberJOBSMATH_NUMERICOPTNONE

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

mnF0911JobNumberJOBSMATH_NUMERICOPTNONE

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

Related Functions

B0000026 Edit Exchange Rate Tolerance
B0000027 CurrencyConvForAndDom
B0000032 RetrieveCurrencyConvFlag
B0000033 Get Exchange Rate
B0000042 Batches
B0000083 Convert Math Numeric to String with Left Zero Pad
B0000128 Retrieve Company Currency Code
B0000129 Retrieve Currency Decimals
B0000130 Retrieve Company From Business Unit
B0000173 Determine Date, Conversion Method and Rates
B0000175 Get Next Transaction Number
B0000176 Add Transaction To Subsystem Queue
B0200098 PPAT - Get User Id, Address Book Number
B0900049 Journal Entry
B3003130 F30026 Cost Components Cache
B3100730 Update Routing For PO Reciepts
B4000260 Line Type - Activity Rules
B4000350 Retrieve Distribution AAI
B4000520 Get Item UoM Conversion Factor
B4000880 Verify And Get Address Book for OP
B4000920 Get Item Branch Mfg Data
B4000930 Update F4102 MRP Net Chg
B4001090 Tax Calculator
B4002000 Compute Unit Or Extended Amount
B4100030 Verify Quantity Cost Extended
B4100150 Get Lot Master Fields
B4100210 Check Item Branch
B4100600 Verify And Get Item XRef
B41B0370 Get Bulk Info from Item Master Pointer
B4201210 Serial Number Processing Edits
B4300030 Edit Purchasing Tolerance Rules
B4300110 Get Purchase Order Detail
B4300130 Get Purchase Order Header
B4300150 Get Supplier Item Relationships
B4300160 Set Early, On Time or Late
B4300210 Calc PO Rec Std Cost Variance
B4300220 Calculate PO Receipt Zero Balance Adjustment
B4300230 Update PO Order Total
B4300370 Get Purchase Order Receipt
B4300430 Calculate Closed Amounts
B4300450 Calculate Amount and Quantity on Reversal
B4300570 Receipt Routing, Verify Receipt Routing Process
B4300780 F43092 Get Receipt Routing Record
B4300890 F43092, Verify Active Operations
B4300950 P43250, Retrieve Processing Options
B4301030 Get Landed Cost Record
B4301040 F41291 Read/Write Landed Cost Based on Amount
B4301050 F41291 Read/Write Landed Cost Job Numbers
B4301080 Duplicate PO Detail Lines
B4301171 Read/Write F4311 Cache
B4301220 Purchasing Tolerance Rules Cache Functions
B4301230 F4311 - Update Original PO Line
B4301280 F43121 Get Next Document Number
B4301300 F43121 Update Landed Cost Records
B4301350 F41291 Rev Landed Cost Cache
B4301360 F4312 Status Code Cache
B4301410 Maintain Purchasing Parms Cache
B4301500 F43121 Get Next Receipt Traveler Number
B4301670 P4312 SO Backorder Release Read Write Cache
B4301720 Read/Write Cost Type Journal Entry Line Number Cache
B4301730 Receipts Accumulation Quantity Cache
B4312 Purchase Order Receipt Functions
B4600630 F46130 Get Reserved Location
B9800100 Get Audit Information
B9900410 Get Environment Value
N3800040 F38012 Agreement Transaction Server
N3800050 F38010 Agreement Search
N3800060 F38010 Simple Edit
N4002540 F4211 Direct Ship Order Integrity
N41B0450 Get Bulk / Transaction Quantity
N4300970 Landed Cost Selection
N4301620 F43121T Retrieve Tag Record
N4600560 F46130 Reservations Reconciliation Server
N4700060 EDI Batch Number, Get Next Number
N4900510 Process Shipment Confirmation
X00COM Update Commitment Ledger
X0903 Fiscal Date Edits +
X0909 Validate Subledger
X1202 F1201 Validate Asset Number
X4101 Validate and Retrieve Item Master
X43091 Receipt Routing Initiator
X43092R F43092 Receipt Routing Deleter
X43199 Insert Purchase Ledger
XF41021 Update F41021 Locations
XF4105 Item Cost I/O
XF43121 Purchase Order Item Ledger Functions
XT4111Z1 Inventory Transactions
XT4311Z1 Purchase Order Entry

Related Tables

F43121Z Receiver workfile
F43121Z1 Receipts Unedited Transaction Table
F4312EditDoc

F4312EditDoc

Purchase Order Receipts

Master Business Function

Object Name: XT4312Z1

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function is part of the Purchase Order Receipts Master Business Function.  It will edit 
the caches and do blind landed cost processing before F4312 End Doc is called.


Setup Notes and Prerequisites

• All records in the receiver cache matching the ComputerID and JobNumber will be processed.  
• The Business Function F4312BeginDoc() and F4312EditLine() must be called prior to calling this 
Business Function.  

• For quicker and consistent execution, the following fields must be setup, outside this Master 
Business Function, to store values that are passed back and forth from F4312EditLine().

• During the process of evolving of the OneWorld tool, numerous decisions are made that effect the 
design of this program.  Please keep in mind that old terminology may be used in this documentation from 

time to time because I have simply overlooked it or forgotten to replace it.  One big change was the 

use of cache to store the workfile rather than storing it as part of the database.  Previously, when 

the workfile was part of the database, it was referred to as 'F43121Z' or the 'Receiver Workfile'; now 

it is referred to as the 'Receiver Cache' or 'F43121Z'.  In object librarian it is still called 

F43121Z, however when created in the cache, it is called 'CF43121Z'.  (Please do not confuse this cache table 

with another cache table, 'Tolerance Cache' or 'Ctolerance', also used in this program.)

• If doing blind landed costs, landed costs need to be set up for each detail line.

Special Logic

Please see Technical Specification section.



Technical Specification

Not included at this time.


Data Structure

DF4312Z1E - XT4312Z1 Edit Object - Edit Doc

Parameter NameData ItemData TypeReq/OptI/O/Both
mnJobNumberJOBSMATH_NUMERICREQINPUT

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

szComputerIDCTIDcharREQINPUT

cActionCodeACTIONcharOPTINPUT

A code that indicates the activity you want to perform. Valid codes are:    A Add new record    C Change existing record    D Delete existing 
record    I Inquire on existing record    .       End of program or function    space Clear the form  If you enter a code that is not active, the system 
highlights the code and no action occurs. NOTE: Depending on how your company has set up action code security, you might not be authorized 
to use all action codes.

cProcessEditsEV01charOPTINPUT

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

szProgramIDPIDcharREQINPUT

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.

szUserIDUSERcharREQINPUT

The code that identifies a user profile.

szPOVersionVERScharREQINPUT

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.

mnLandedCostJobNumberJOBSMATH_NUMERICOPTOUTPUT

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

mnOrderNumberDOCOMATH_NUMERICOPTINPUT

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.

szOrderTypeDCTOcharOPTINPUT

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

szOrderKeyCompanyKCOOcharOPTINPUT

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.

szOrderSuffixSFXOcharOPTINPUT

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.

jdGLDateDGLJDEDATEOPTINPUT

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.

mnBatchNumberICUMATH_NUMERICOPTINPUT

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.

szBatchTypeICUTcharOPTBOTH

A code that specifies the system and type of transactions entered in a batch. The system assigns the value when you enter a transaction. 
Valid values are set up in user defined code table 98/IT. You cannot assign new values. All batch types are hard coded.

mnLCReceiptDocDOCMATH_NUMERICOPTOUTPUT

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.

mnLCJournalEntryLineNoJELNMATH_NUMERICOPTOUTPUT

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

cCurrencyModeCRRMcharOPTINPUT

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.

szCurrencyCodeCRCDcharOPTINPUT

A code that identifies the currency of a transaction. 

mnLCF0911JobNumberJOBSMATH_NUMERICOPTOUTPUT

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

cReversalOptionOPTcharOPTINPUT

Selection option. Place the cursor on the option field and press F1 for a list of valid selection options.

Related Functions

B0000026 Edit Exchange Rate Tolerance
B0000027 CurrencyConvForAndDom
B0000032 RetrieveCurrencyConvFlag
B0000033 Get Exchange Rate
B0000042 Batches
B0000083 Convert Math Numeric to String with Left Zero Pad
B0000128 Retrieve Company Currency Code
B0000129 Retrieve Currency Decimals
B0000130 Retrieve Company From Business Unit
B0000173 Determine Date, Conversion Method and Rates
B0000175 Get Next Transaction Number
B0000176 Add Transaction To Subsystem Queue
B0200098 PPAT - Get User Id, Address Book Number
B0900049 Journal Entry
B3003130 F30026 Cost Components Cache
B3100730 Update Routing For PO Reciepts
B4000260 Line Type - Activity Rules
B4000350 Retrieve Distribution AAI
B4000520 Get Item UoM Conversion Factor
B4000880 Verify And Get Address Book for OP
B4000920 Get Item Branch Mfg Data
B4000930 Update F4102 MRP Net Chg
B4001090 Tax Calculator
B4002000 Compute Unit Or Extended Amount
B4100030 Verify Quantity Cost Extended
B4100150 Get Lot Master Fields
B4100210 Check Item Branch
B4100600 Verify And Get Item XRef
B41B0370 Get Bulk Info from Item Master Pointer
B4201210 Serial Number Processing Edits
B4300030 Edit Purchasing Tolerance Rules
B4300110 Get Purchase Order Detail
B4300130 Get Purchase Order Header
B4300150 Get Supplier Item Relationships
B4300160 Set Early, On Time or Late
B4300210 Calc PO Rec Std Cost Variance
B4300220 Calculate PO Receipt Zero Balance Adjustment
B4300230 Update PO Order Total
B4300370 Get Purchase Order Receipt
B4300430 Calculate Closed Amounts
B4300450 Calculate Amount and Quantity on Reversal
B4300570 Receipt Routing, Verify Receipt Routing Process
B4300780 F43092 Get Receipt Routing Record
B4300890 F43092, Verify Active Operations
B4300950 P43250, Retrieve Processing Options
B4301030 Get Landed Cost Record
B4301040 F41291 Read/Write Landed Cost Based on Amount
B4301050 F41291 Read/Write Landed Cost Job Numbers
B4301080 Duplicate PO Detail Lines
B4301171 Read/Write F4311 Cache
B4301220 Purchasing Tolerance Rules Cache Functions
B4301230 F4311 - Update Original PO Line
B4301280 F43121 Get Next Document Number
B4301300 F43121 Update Landed Cost Records
B4301350 F41291 Rev Landed Cost Cache
B4301360 F4312 Status Code Cache
B4301410 Maintain Purchasing Parms Cache
B4301500 F43121 Get Next Receipt Traveler Number
B4301670 P4312 SO Backorder Release Read Write Cache
B4301720 Read/Write Cost Type Journal Entry Line Number Cache
B4301730 Receipts Accumulation Quantity Cache
B4312 Purchase Order Receipt Functions
B4600630 F46130 Get Reserved Location
B9800100 Get Audit Information
B9900410 Get Environment Value
N3800040 F38012 Agreement Transaction Server
N3800050 F38010 Agreement Search
N3800060 F38010 Simple Edit
N4002540 F4211 Direct Ship Order Integrity
N41B0450 Get Bulk / Transaction Quantity
N4300970 Landed Cost Selection
N4301620 F43121T Retrieve Tag Record
N4600560 F46130 Reservations Reconciliation Server
N4700060 EDI Batch Number, Get Next Number
N4900510 Process Shipment Confirmation
X00COM Update Commitment Ledger
X0903 Fiscal Date Edits +
X0909 Validate Subledger
X1202 F1201 Validate Asset Number
X4101 Validate and Retrieve Item Master
X43091 Receipt Routing Initiator
X43092R F43092 Receipt Routing Deleter
X43199 Insert Purchase Ledger
XF41021 Update F41021 Locations
XF4105 Item Cost I/O
XF43121 Purchase Order Item Ledger Functions
XT4111Z1 Inventory Transactions
XT4311Z1 Purchase Order Entry

Related Tables

F43121Z Receiver workfile
F43121Z1 Receipts Unedited Transaction Table
F4312EditLine

F4312EditLine

Purchase Order Receipts

Master Business Function

Object Name: XT4312Z1

Parent DLL: CDIST

Location: Client/Server

Language: C

^

Data Structure

DF4312Z1B - XT4312Z1 Edit Object - Edit Line

Special Input Expected

Data Item  DescriptionI/OReqd.Notes

System Fields


JOBS
JobNumberIYError if blank.  F4312BeginDoc() should already have been called 
to assign a Job Number.  Part of key to receiver cache (CF43121Z)


CTIDComputerIDIYError if blank.  GetAuditInfo() should already have been called 

to assign a Computer I.D.  Part of key to receiver cache (CF43121Z)


Purpose
Together, JOBS and CTID uniquely group together records written to the receiver cache

Special Notes

• JobNumber is assigned in F4312BeginDoc only, if and only if no errors occur .  (From the 
application point of view of P4312, a Job Number is assigned every time the form P.O.Receipts is started 

up.)

• If a value in the JobNumber field is passed to F4312BeginDoc, this value will be used and a new 
value will not be assigned.

• ComputerID must already have been assigned before calling any functions that are part of 
XT4312Z1.  It identifies the location of the computer from which this function is called.


Detailed Explanation

The first two keyed fields in the receiver cache are ComputerID and JobNumber, respectively.  
F4312EndDoc will process all records in the receiver cache that match the passed ComputerID and 

JobNumber.  


PIDProgramIDINIndicates calling application.  Valid values:
'EP4312'  (Called from 'P.O. Receipts' to receive PO lines)

'EP43214' (Called from 'Receipts Inquiry' to reverse PO Lines) 

'EP43250' (Called from 'Routing Movement' to move quantity to and from 'On Hand' status in 

Receipt Routing)

'EP43253' (Called from 'Routing Disposition' to move quantity to and from 'On Hand' status in 

Receipt Routing)

Default Value:  'EP4312'


Purpose
To indicate what the calling application is.  (There is some specific processing depending on 
which application is calling the Master Business Function (MBF).)


Special Notes

• If not passed in, 'EP4312' will be assigned as the default value.  It is important to pass this 
value in if the user would like to perform processing that P4312 does not do, like Reversals, for 

example.  

• It is used when updating the field 'PID' in any of the tables in the database.  

Detailed Explanation

When a receiver cache record is successfully written, the parameter F43121Zwritten will be 
assigned to '1' at all times, except when the ProgramID is 'EP43214' in which case it will be assigned to 

a 'Y'.


VERSPOVersionIYVersion of calling application.  Used to obtain Processing 

Options.  PO in description stands for "Processing Option".  Default value: ZJDE0001


JOBSLandedCJobNoI/OYIf Landed cost is on,, pass it back and forth to the application. 

It will be used for both applying landed cost and reversing of receitps with landed cost.



Processing Flags


SELCOptionIYValid values:

1=Receive P.O.Line completely

4=Receive P.O.Line into Multiple Locations

7=Receive P.O.Line Partially and Close out the remainder 

8=Reverse the P.O.Receipt completely

9=Cancel the P.O.Line (i.e. Close out the line on the P.O) 


ACTNActionCodeIYValid values:

'A' or '1' == Receive P.O.Line (Always use if 'Option' != 8)

'D' or '3' == Receipt Reversal (Always use if 'Option' = 8)


CRYRCurrencyProcessingFlagINError if blank.  F4312BeginDoc() must already have been 

called to assign this flag.  Valid values: 'Y', 'N', 'Z'.  Indicates whether currency processing is ON 

('Y', 'Z') or OFF ('N')


CRRMCurrencyModeI/ONIndicates if in Foreign ('F') or Domestic ('D') mode.  Obtained 

from P.O. Header (F4301) in F4312BeginDoc().  Pass in for performance gain by defining a work field to 

store the value for subsequent calls


RWT1ProcessEditsIY'1' == Perform full editing on fields.  For now, pass in '1'

('0' == Do not perform editing on fields **FUTURE**)

('2' == Perform partial editing only **FUTURE**)


RWT2ReceiptRecWrittenI/OYIf passed in as '1' then it indicates receiver cache record has 

already   been written and needs to be updated.  If not passed in as '1' and if processing is 

successful and a receiver cache record gets written, then it is assigned to '1' 


IVIInventoryInterfaceINObtained from Line Type constants (F40205) for P.O. if not 

specified.

If 'Y' or 'D' then Inventory processing will be performed (i.e. Inventory MBF will be called which, 

updates Item/Location (F41021), Cardex (F4111), Average Cost, and all other Item   related 

information.)  If 'A' then P.O Line is assumed to contain a G/L Account Number and a Lumpsum Amount which will be 

written against the G/L Account.  If 'B' then same processing as 'A', however an Item Number must also 

be specified.  If 'N' then almost no editing against P.O.Line is performed - the P.O.Line is treated 

like a text line.


GLIGLInterfaceINSpecifies whether Journal Entries should be written.  Valid 

values: 'Y' or 'N'.  Obtained from Line Type constants (F40205) for P.O. if not specified.


TXYNTextLineYNINObtained from Line Type constants (F40205) for P.O. if not 

specified.



P.O. Line Information


DOCOOrderNumberIYPart of key in P.O. Line (F4311).


DCTOOrderTypeIYPart of key in P.O. Line (F4311).


KCOOOrderKeyCompanyIYPart of key in P.O. Line (F4311).


SFXOOrderSuffixI/ONPart of key in P.O. Line (F4311).  (Default Value: '000')


LNIDLineNumberIYPart of key in P.O. Line (F4311).


ALPHSupplierNameI/ONIf blank then obtained from Address Book (F0101).  Pass in for 

performance gain by defining a work field to store the value for subsequent calls


JOBSF4311JobNumberI/ONUsed if receiving any P.O.Line in different UOM.  Will be 

assigned by DuplicatePOLines() if blank, but must always be maintained for each P.O.Line and passed back on 

all subsequent calls to this function.  (Each P.O.Line that will be received in a different UOM will 

have a unique F4311JobNumber (stored in the grid in P4312))



P.O. Receipt Information


NLINReceiptLineNumberINRequired if performing Reversal or called from Receipt Routing, 

otherwise it will be assigned.  Will become part of key in P.O. Receiver record (F43121)


DOCReceiptDocINIf passed in, then validated against the P.O. Receipts table  

(F43121).  If it exists in F43121 then return error because it is not unique.


RCDJReceiptDateI/ONAssigned to today's date if passed in blank.  (Among other 

things, used to write to Receiver record (F43121), perform Tolerance Date checking, and calculate Leadtimes 

in Supplier Analysis)


ASIDAssetIDI/ONNo editing performed on this field - simply assigned to P.O. 

Receiver record, as is.


RCDReasonCodeI/ONUDC value for informational purposes only.  Written to P.O 

Receiver record (F43121) and also passed to Inventory MBF to   write to Cardex (F4111)


CNIDContainerIDINInformational only.  Written to P.O Receiver record.


VRMKVendorRemarkINInformational only.  Written to P.O Receiver record.


PRP5LandedCostRuleIN**Future**  Written to P.O Receiver record.



Quantity, Amount and Cost

UOPNQuantityReceivedINQuantity to be received.  Required if P.O. Line is quantity based 

   (i.e. required for IVI == 'Y' or 'D')


UOMReceiptUOMINTransaction Unit Of Measure.  QuantityReceived is in this UOM.  

Required if QuantityReceived is specified


PRRCUnitCostReceivedI/ONWill be assigned by Inventory MBF (XT4111Z1) if not specified and 

IVI == 'Y' or 'D'.  However, it must be specified if IVI != 'Y' and 'D' and QuantityReceived is 

specified.  (This cost is ALWAYS in the Purchasing UOM)


FRRCForeignUnitCostReceivedI/ONIf in Foreign Mode then the same requirements apply as for 

UnitCostReceived


AOPNAmountReceivedI/ONAmount to be received.  If QuantityReceived and Unit Cost is 

specified, then AmountReceived will be recalculated either by the Inventory MBF (XT4111Z1) or locally, 

depending on the   Inventory Interface (IVI).  


FAPForeignAmountReceivedI/ONIf in Foreign Mode then the same requirements apply as for 

AmountReceived

Currency Fields


CRCDPOCurrencyCodeI/ONCurrency the PO is in. Obtained from P.O. Header (F4301) in 

F4312BeginDoc().  Pass in for performance gain by defining a work field to store the value for subsequent 

calls


CRDCDomesticCurrencyCodeI/ONBase currency of parameter 'OrderCompany'.                  

    Obtained from P.O. Header (F4301) in F4312BeginDoc().  Pass     in for performance gain by 

defining a work field to store the value    for subsequent calls


CRRExchangeRateI/ONConversion between parameters 'BaseCurrency' and    'POCurrency'. 

 Obtained from P.O. Header (F4301) in F4312BeginDoc().  Pass in for performance gain by defining a  

work field to store the value for subsequent calls.  This value can be reassigned at receipt time



Inventory Information  

(Inventory processing is performed only if IVI == 'Y' or 'D')


MCUReceiptBranchI/ONCan be changed at receipt time.  If blank, default from P.O. 

Line's Branch/Plant.  


LOCNLocationDatabaseI/ONLocation in Branch/Plant to receive into.  Assume Primary 

Location if blank.  (Value passed in must be in Database format)


LOTNLotNumberI/ONIf assigned then LotExpiratinDate is required.  Assume blank Lot 

if passed in blank.  (Can also be set to assign automatically)


MMEJLotExpirationDateI/ONObtained from Inventory MBF if passed in blank

Parameter NameData ItemData TypeReq/OptI/O/Both
mnJobNumberJOBSMATH_NUMERICNONENONE

Special Input Expected
Error if blank.  F4312BeginDoc() should already have been called to assign a Job Number.  Part of key 

to receiver cache (CF43121Z).  JobNumber is assigned in F4312BeginDoc only, if and only if no errors 

occur .  (From the application point of view of P4312, a Job Number is assigned every time the form 

P.O. Receipts is started up.).  If a value in the JobNumber field is passed to F4312BeginDoc, this value 

will be used and a new value will not be assigned.


^

szComputerIDCTIDcharNONENONE

Special Input Expected
Error if blank.  GetAuditInfo() should already have been called to assign a Computer I.D.  Part of 

key to receiver cache (CF43121Z).  ComputerID must already have been assigned before calling any 

functions that are part of XT4312Z1.  It identifies the location of the computer from which this function is 

called.


^

cActionCodeACTNcharNONENONE

Significant Data Values
'A' or '1' - Receive P.O.Line (Always use if 'Option' != 8)

'D' or '3' - Receipt Reversal (Always use if 'Option' = 8)

^

cProcessEditsEV01charNONENONE

Significant Data Values
'1' - Perform full editing on fields.  For now, pass in '1'

('0' - Do not perform editing on fields **FUTURE**)

('2' - Perform partial editing only **FUTURE**)

^

szProgramIDPIDcharNONENONE

Special Input Expected
Indicates calling application.  There is some specific processing depending on which application is 

calling the Master Business Function (MBF).  If not passed in, 'EP4312' will be assigned as the default 

value.  It is important to pass this value in if the user would like to perform processing that P4312 

does not do, like Reversals, for example.  It is used when updating the field 'PID' in any of the 

tables in the database.  Note: When a receiver cache record is successfully written, the parameter 

F43121Zwritten will be assigned to '1' at all times, except when the ProgramID is 'EP43214' in which case it 

will be assigned to a 'Y'.


Significant Data Values

EP4312  - (Called from 'P.O. Receipts' to receive PO lines)

EP43214 - (Called from 'Receipts Inquiry' to reverse PO Lines) 

EP43250 - (Called from 'Routing Movement' to move quantity to and from 'On Hand' status in Receipt 

Routing)

EP43253 - (Called from 'Routing Disposition' to move quantity to and from 'On Hand' status in Receipt 

Routing)


^

cCurrencyProcessingFlagCRYRcharNONENONE

Special Input Expected
Error if blank.  F4312BeginDoc() must already have been called to assign this flag.  

^

mnOrderNumberDOCOMATH_NUMERICNONENONE

Special Input Expected
Part of key in P.O. Line (F4311).

^

szOrderTypeDCTOcharNONENONE

Special Input Expected
Part of key in P.O. Line (F4311).

^

szOrderKeyCompanyKCOOcharNONENONE

Special Input Expected
Part of key in P.O. Line (F4311).

^

szOrderSuffixSFXOcharNONENONE

Special Input Expected
Part of key in P.O. Line (F4311).


Special Output Returned

'000' will be returned if passed in blank.

^

mnLineNumberLNIDMATH_NUMERICNONENONE

Special Input Expected
Part of key in P.O. Line (F4311).

^

mnReceiptLineNumberNLINMATH_NUMERICNONENONE

Special Input Expected
Required if performing Reversal or called from Receipt Routing, otherwise it will be assigned.  Will 

become part of key in P.O. Receiver record (F43121).

^

cReceiptRecWrittenEV01charNONENONE

Special Input Expected
If passed in as '1' then it indicates receiver cache record has already   been written and needs to 

be updated.  


Special Output Returned

If not passed in as '1' and if processing is successful and a receiver cache record gets written, 

then it is assigned to '1'.


^

cOptionSELCcharNONENONE

Significant Data Values
1 - Receive P.O.Line completely

4 - Receive P.O.Line into Multiple Locations

7 - Receive P.O.Line Partially and Close out the remainder 

8 - Reverse the P.O.Receipt completely

9 - Cancel the P.O.Line (i.e. Close out the line on the P.O) 


^

szPOVersionVERScharNONENONE

Special Input Expected
Version of calling application.  Used to obtain Processing Options.  PO in description stands for 

"Processing Option".  Default value: ZJDE0001

^

mnQuantityReceivedUOPNRMATH_NUMERICNONENONE

Special Input Expected
Quantity to be received.  Required if P.O. Line is quantity based    (i.e. required for IVI == 'Y' or 

'D')

^

szReceiptUOMUOMcharNONENONE

Special Input Expected
Transaction Unit Of Measure.  QuantityReceived is in this UOM.  Required if QuantityReceived is 

specified.

^

mnUnitCostReceivedUCSTRMATH_NUMERICNONENONE

Special Input Expected
Will be assigned by Inventory MBF (XT4111Z1) if not specified and IVI == 'Y' or 'D'.  However, it 

must be specified if IVI != 'Y' and 'D' and QuantityReceived is specified.  (This cost is ALWAYS in the 

Purchasing UOM.)

^

mnForeignUnitCostReceivedFCSTRMATH_NUMERICNONENONE

Special Input Expected
If in Foreign Mode, will be assigned by Inventory MBF (XT4111Z1) if not specified and IVI == 'Y' or 

'D'.  However, it must be specified if IVI != 'Y' and 'D' and QuantityReceived is specified.  (This 

cost is ALWAYS in the Purchasing UOM)

^

mnAmountReceivedAOPNRMATH_NUMERICNONENONE

Special Input Expected
Amount to be received.  If QuantityReceived and Unit Cost is specified, then AmountReceived will be 

recalculated either by the Inventory MBF (XT4111Z1) or locally, depending on the Inventory Interface 

(IVI).

^

mnForeignAmountReceivedFOPNRMATH_NUMERICNONENONE

Special Input Expected
If in Foreign Mode and if QuantityReceived and Unit Cost is specified, then AmountReceived will be 

recalculated either by the Inventory MBF (XT4111Z1) or locally, depending on the   Inventory Interface 

(IVI).  

^

szReceiptBranchMCUcharNONENONE

Special Input Expected
Can be changed at receipt time.  If blank, default from P.O. Line's Branch/Plant.  

^

szLocationDatabaseLOCNcharNONENONE

Special Input Expected
Location in Branch/Plant to receive into.  Assume Primary Location if blank.  (Value passed in must 

be in Database format.)


^

szLotNumberLOTNcharNONENONE

Special Input Expected
If assigned then LotExpirationDate is required.  Assume blank Lot if passed in blank.  (Can also be 

set to assign automatically.)

^

cLotStatusLOTScharNONENONE

Special Output Returned
Obtained from Inventory MBF if passed in blank.

^

mnLotPotencyLOTPMATH_NUMERICNONENONE

Special Output Returned
Obtained from Inventory MBF if passed in blank.

^

szLotGradeLOTGcharNONENONE

Special Output Returned
Obtained from Inventory MBF if passed in blank.

^

jdLotExpirationDateMMEJJDEDATENONENONE

Special Output Returned
Obtained from Inventory MBF if passed in blank.

^

szLotDescriptionLDSCcharNONENONE

Special Output Returned
Obtained from Inventory MBF if passed in blank.

^

szSupplierLotRLOTcharNONENONE

Special Output Returned
Obtained from Inventory MBF if passed in blank.

^

szAssetIDASIDcharNONENONE

Special Input Expected
No editing performed on this field - simply assigned to P.O. Receiver record, as is.

^

szLandedCostRulePRP5charNONENONE

A user defined code (41/P5) that indicates the landed cost rule for an item. The landed cost rule determines purchasing costs that exceed 
the actual price of an item, such as broker fees or commissions. You set up landed cost rules on the Landed Cost Revisions form.

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.

szContainerIDCNIDcharNONENONE

A code on the container or that you assign to the container in which the items on this purchase order or order line were shipped to you. You 
can assign container information to an order during receipts entry.

szVendorRemarkVRMKcharNONENONE

A free-form field in which you can enter any pertinent information.

szSubledgerSBLcharNONENONE

A code that identifies a detailed, auxiliary account within a general ledger account. A subledger can be an equipment item number or an 
address book number. If you enter a subledger, you must also specify the subledger type.

cSubledgerTypeSBLTcharNONENONE

A user defined code (00/ST) that is used with the Subledger field to identify the subledger type and how the system performs subledger 
editing. On the User Defined Codes form, the second line of the description controls how the system performs editing. This is either hard-coded 
or user defined. Valid values include: A Alphanumeric field, do not edit   N Numeric field, right justify and zero fill   C Alphanumeric field, right 
justify and blank fill  

jdGLDateDGLJDEDATENONENONE

Special Input Expected
Assigned to today's date if passed in blank.  Validated against current G/L period. 

^

jdReceiptDateRCDJJDEDATENONENONE

Special Input Expected
Assigned to today's date if passed in blank.  (Among other things, used to write to Receiver record 

(F43121), perform Tolerance Date checking, and calculate Leadtimes in Supplier Analysis).

^

szDomesticCurrencyCodeCRDCcharNONENONE

Special Input Expected
Base currency of parameter 'OrderCompany'. Obtained from P.O. Header (F4301) in F4312BeginDoc().  

Pass in for performance gain by defining a work field to store the value for subsequent calls.

^

szPOCurrencyCodeCRCDcharNONENONE

Special Input Expected
Currency the PO is in. Obtained from P.O. Header (F4301) in F4312BeginDoc().  Pass in for performance 

gain by defining a work field to store the value for subsequent calls.

^

mnExchangeRateCRRMATH_NUMERICNONENONE

Special Input Expected
Conversion between parameters 'BaseCurrency' and 'POCurrency'.  Obtained from P.O. Header (F4301) in 

F4312BeginDoc().  Pass in for performance gain by defining a  work field to store the value for 

subsequent calls.  This value can be reassigned at receipt time.

^

cCurrencyModeCRRMcharNONENONE

Special Input Expected
Indicates if in Foreign ('F') or Domestic ('D') mode.  Obtained from P.O. Header (F4301) in 

F4312BeginDoc().  Pass in for performance gain by defining a work field to store the value for subsequent 

calls.

^

cFirstOfMultiLineEV01charNONENONE

Special Input Expected
Not used.


^

cLandedCostCodeLANDcharNONENONE

Indicates how a PO receiver record relates to landed cost. The following is a list of possible values:    blank The record is not related to 
landed cost.    1       The record has associated landed cost records.    2       The record is a landed cost record that is to be vouchered.    3       The 
record is a landed cost record that is not to be vouchered.

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.

szBatchTypeICUTcharNONENONE

Special Output Returned
Hard coded to be 'O'.


^

jdBatchDateDICJJDEDATENONENONE

The date of the batch. If you leave this field blank, the system date is used.

mnReceiptDocDOCMATH_NUMERICNONENONE

Special Input Expected
If passed in, then validated against the P.O. Receipts table  (F43121).  If it exists in F43121 then 

return error because it is not unique.

^

mnSupplierAN8MATH_NUMERICNONENONE

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

szSupplierNameALPHcharNONENONE

Special Input Expected
If blank then obtained from Address Book (F0101).  Pass in for performance gain by defining a work 

field to store the value for subsequent calls.

^

cInventoryInterfaceIVIcharNONENONE

Special Input Expected
Obtained from Line Type constants (F40205) for P.O. if not specified.  If 'Y' or 'D' then Inventory 

processing will be performed (i.e. Inventory MBF will be called which, updates Item/Location (F41021), 

Cardex (F4111), Average Cost, and all other Item   related information.)  If 'A' then P.O Line is 

assumed to contain a G/L Account Number and a Lumpsum Amount which will be written against the G/L 

Account.  If 'B' then same processing as 'A', however an Item Number must also be specified.  If 'N' then 

almost no editing against P.O.Line is performed - the P.O.Line is treated like a text line.

^

cGLInterfaceGLIcharNONENONE

Special Input Expected
Specifies whether Journal Entries should be written.  Obtained from Line Type constants (F40205) for 

P.O. if not specified.


Significant Data Values

'Y'

'N'  


^

cTextLineYNTXYNcharNONENONE

Special Input Expected
Obtained from Line Type constants (F40205) for P.O. if not specified.

^

szQuantityBucketToUpdateUPIBcharNONENONE

Special Output Returned
If it is determined that the quantity to receive will enter Receipt Routing, then a Route is assigned 

to the quantity.  Each Operation in this Route has a predetermined Quantity Bucket from Item/Location 

table (F41021).  The Quantity Bucket for the first Operation in the Route is returned via this 

parameter.  Furthermore, in P4312, if a value is returned through this parameter, then a field, which says 

'Some Item(s) Will Enter Receipt Routing', is displayed.  



^

cReceiptAcknowledgementRCPTcharNONENONE

Special Output Returned
Informational Only - indicates whether the receipt of P.O.Line is acknowledged at the first 

Operation.

^

cPaymentEligiblePMTEcharNONENONE

Special Output Returned
Informational Only - indicates whether payment of P.O.Line is initiated at the first Operation (If 

so, then Journal Entries will be written).

^

mnF4111JobNumberJOBSMATH_NUMERICNONENONE

Special Input Expected
Used if receiving any P.O.Line in different UOM.  Will be assigned by DuplicatePOLines() if blank, 

but must always be maintained for each P.O.Line and passed back on all subsequent calls to this 

function.  (Each P.O.Line that will be received in a different UOM will have a unique F4311JobNumber (stored 

in the grid in P4312)).

^

mnF0911JobNumberJOBSMATH_NUMERICNONENONE

Special Input Expected
Assigned by F0911FSBeginDoc() which is part of G/L MBF.  Once assigned, needs to be passed in with 

all subsequent calls.

^

cF4111WrittenEV01charNONENONE

Special Input Expected
Assigned by F4111EditLine() which is part of Inventory MBF.  If an Inventory Workfile record 

(F41UI001) is written then it is set to   '1'.

^

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

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

szP3103UOMUOMcharNONENONE

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

szOperationStatusOPSTcharNONENONE

User defined code system 31, type OS. The operation status code that identifies the current status of a work order or engineering change 
order as the operation steps in the routing are completed.

mnLastJELineJELNMATH_NUMERICNONENONE

Special Output Returned
Indicates the most recent G/L Line Number used for this Batch.

^

szGLRemarkVL01charNONENONE

The list of selection values associated with a data selection item in the Dream Writer. This list is generated by the use of the *VALUES 
keyword in data selection setup. Elements 1 and 2 are also used to contain the upper and lower value for the keyword *RANGE used by the 
data selection in the Dream Writer.

szInventoryTransRemarkVL01charNONENONE

The list of selection values associated with a data selection item in the Dream Writer. This list is generated by the use of the *VALUES 
keyword in data selection setup. Elements 1 and 2 are also used to contain the upper and lower value for the keyword *RANGE used by the 
data selection in the Dream Writer.

cCalledFromRoutingRWT1charNONENONE

Special Input Expected
If called from Receipt Routing to move quantity On Hand or back out quantity from On Hand, pass in a 

'1'.

^

mnF4311JobNumberJOBSMATH_NUMERICNONENONE

Special Input Expected
Used if receiving any P.O.Line in different UOM.  Will be assigned by DuplicatePOLines() if blank, 

but must always be maintained for each P.O.Line and passed back on all subsequent calls to this 

function.  (Each P.O.Line that will be received in a different UOM will have a unique F4311JobNumber (stored 

in the grid in P4312)).

^

cCalledFromEDIEV03charNONENONE

Special Input Expected
If it is an EDI transaction, pass in a '1'.

^

mnWMSLineNumberMATH01MATH_NUMERICNONENONE

- - - Good Performance Low Value. 

mnLandedCJobNoJOBSMATH_NUMERICNONENONE

Special Input Expected
If Landed cost is on, pass it back and forth to the application. It will be used for both applying 

landed cost and reversing of receipts with landed cost.

^

szMemoLotField1LOT1charNONENONE

A higher classification or grouping of serial number or lot processed items,maintained within the Lot Master (F4108).

szMemoLotField2LOT2charNONENONE

A higher classification or grouping of memo lot 1 maintained within the lot master (F4108).

mnTriangulationRateFromCurrencTRR1MATH_NUMERICOPTNONE

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

mnTriangulationRateToCurrencyTRR2MATH_NUMERICOPTNONE

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

cCurrencyConversionMethodCRCMcharOPTNONE

A value that specifies which method to use when converting from one currency to another. Valid values are:  Y  Multiplier method. The 
system multiplies the foreign amount by the multiplier exchange rate to calculate the domestic amount. Z Divisor method. The system divides the 
foreign amount by the divisor exchange rate to calculate the domestic amount.

mnAmbientVolumeAMBRMATH_NUMERICOPTNONE

The volume as measured for density and temperature prior to conversion. You can enter the ambient quantity or let the system 
automatically calculate it.

szAmbientVolumeUOMBUM3charOPTNONE

A user defined code (system 00, type UM) that identifies the unit of measurement for pressure, volume, weight, diameter, or height. Note that 
for all volume or weight units of measure, a V or W (respectively) must be entered in the first position of the special handling field on the UDC 
table.

mnStandardVolumeSTOKMATH_NUMERICOPTNONE

The volume after it has been converted to a standard base. Conversions are made according to published standard routines for density 
and gravity and for temperature.

szStandardVolumeUOMBUM4charOPTNONE

A user defined code (system 00, type UM) that identifies the unit of measurement for pressure, volume, weight, diameter, or height. Note that 
for all volume or weight units of measure, a V or W (respectively) must be entered in the first position of the special handling field on the UDC 
table.

mnWeightQuantityWGTRMATH_NUMERICOPTNONE

The weight of the product at standard temperature. The system calculates the weight by multiplying the volume by the density and applying 
an air correction, if necessary (all at the base temperature).

szWeightQuantityUOMBUM5charOPTNONE

A user defined code (system 00, type UM) that identifies the unit of measurement for pressure, volume, weight, diameter, or height. Note that 
for all volume or weight units of measure, a V or W (respectively) must be entered in the first position of the special handling field on the UDC 
table.

mnTemperatureTEMPMATH_NUMERICOPTNONE

The temperature of the product.

cTemperatureTypeSTPUcharOPTNONE

A code used to identify the type of temperature. Valid values are:    F Fahrenheit    C Celsius 

cDensityTypeDNTPcharOPTNONE

A code used to identify the type of density. Valid values are:    A Absolute Density    G API Specific Gravity    R Relative Density

mnDensityTemperatureDETPMATH_NUMERICOPTNONE

Indicates the temperature at which the density was measured. The system uses the density temperature type from Branch/Plant Constants - 
Page 3 Row exit.

cDensityTemperatureTypeDTPUcharOPTNONE

Identifies the type of temperature. Valid values are:    F Fahrenheit    C Celsius

mnVolumeCorrectionFactorVCFMATH_NUMERICOPTNONE

A calculated number to convert ambient volume to volume at standard density and temperature. This value identifies the primary stock 
accounting unit of measure used by the system.

cProgramStatusPGMScharOPTNONE

The status code used in General Stock Movements.    C data returned from Dip Volume Calculator    W data returned from Weighbridge 
Information    4   Four Point Analysis records existed 

mnTransQtyInPrimaryForBulkUORGMATH_NUMERICOPTNONE

The quantity of units affected by this transaction.

szPrimaryUOMForBulkUOM1charOPTNONE

A user defined code (00/UM) that identifies the unit of measure that the system uses to express the quantity of an item, for example, EA 
(each) or KG (kilogram).

mnDisplayDensityDENDMATH_NUMERICOPTNONE

Identifies your company's standard for density. You can also use this field for pack size and weight information.

mnTransactionTimeTRTMMATH_NUMERICOPTNONE

The time that the transaction occurred. It is used by reconciliations when reconciling all transactions through a given date and time.

cManagerialAnalysisType1ABT1charOPTNONE

A code that specifies the type of cost object and the type of editing. Valid types are stored in the Cost Object Types table (F1620) and can 
be added or modified using the Cost Object Types program (P1620).

szManagerialAnalysisCode1ABR1charOPTNONE

A cost object code, such as an equipment item number or an address book number. If you enter a cost object code, you must also specify 
the cost object type. This field functions the same and is validated the same as the subledger field, but the system does not post the data in 
the cost object code field to the Account Balances file (F0902).

cManagerialAnalysisType2ABT2charOPTNONE

A code that specifies the type of cost object and the type of editing. Valid types are stored in the Cost Object Types table (F1620) and can 
be added or modified using the Cost Object Types program (P1620).

szManagerialAnalysisCode2ABR2charOPTNONE

A cost object code, such as an equipment item number or an address book number. If you enter a cost object code, you must also specify 
the cost object type. This field functions the same and is validated the same as the subledger field, but the system does not post the data in 
the cost object code field to the Account Balances file (F0902).

cManagerialAnalysisType3ABT3charOPTNONE

A code that specifies the type of cost object and the type of editing. Valid types are stored in the Cost Object Types table (F1620) and can 
be added or modified using the Cost Object Types program (P1620).

szManagerialAnalysisCode3ABR3charOPTNONE

A cost object code, such as an equipment item number or an address book number. If you enter a cost object code, you must also specify 
the cost object type. This field functions the same and is validated the same as the subledger field, but the system does not post the data in 
the cost object code field to the Account Balances file (F0902).

cManagerialAnalysisType4ABT4charOPTNONE

A code that specifies the type of cost object and the type of editing. Valid types are stored in the Cost Object Types table (F1620) and can 
be added or modified using the Cost Object Types program (P1620).

szManagerialAnalysisCode4ABR4charOPTNONE

A cost object code, such as an equipment item number or an address book number. If you enter a cost object code, you must also specify 
the cost object type. This field functions the same and is validated the same as the subledger field, but the system does not post the data in 
the cost object code field to the Account Balances file (F0902).

szAgreementNumberDMCTcharOPTNONE

A unique number your company assigns to identify a particular agreement. You might want to assign some significance to the agreement 
number (for example,an agreement type code, location, year, and so forth). An agreement might have multiple supplements to record 
addendum or changes, for example.

mnAgreementSupplementDMCSMATH_NUMERICOPTNONE

The supplement number records any changes or addendum to agreements that occur over time or by item. It can also indicate individual 
agreements that are tied to a master agreement. The system allows up to 999 different supplements per base agreement number.

cBatchStatusISTcharOPTNONE

A user defined code (98/IC) that indicates the posting status of a batch. Valid values are: Blank    Unposted batches that are pending 
approval or have a status of approved. A        Approved for posting. The batch has no errors, and is in balance, but has not yet been posted. D       
Posted. The batch posted successfully. E        Error. The batch is in error. You must correct the batch before it can post. P        Posting. The system 
is in the process of posting the batch to the general ledger. The batch is unavailable until the posting process is complete. If errors occur 
during the post, the batch status changes to E (error). U        In use. The batch is temporarily unavailable because someone is working with it, or 
the batch appears to be in use because a power failure occurred while the batch was open.

cPostOutOfBalancePOBcharOPTNONE

An option that indicates whether the batch can be posted out-of-balance. Valid settings are: On The batch is not required to balance and can 
be posted out-of-balance. If you choose this option, you should also turn on the option to exclude the batch from the integrity reports.  Off The 
batch is required to balance and cannot be posted out-of-balance. 

mnWarehouseResSeqPSQMATH_NUMERICOPTNONE

mnF43092JobnumberJOBSMATH_NUMERICOPTNONE

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

mnShipmentNumberSHPNMATH_NUMERICOPTNONE

A "next number" that uniquely identifies a shipment.

mnTransportationJobNumberJOBSMATH_NUMERICOPTNONE

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

mnSecondaryQtySQORMATH_NUMERICOPTNONE

If the secondary unit of measure option in Inventory Constants is selected,this field will display on data entry screens.

szSecondaryUOMUOM2charOPTNONE

A user defined code (00/UM) that indicates an alternate unit of measure for the item.

CModeProcessingEV01charOPTNONE

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

szPortOfEntryExitPOEcharOPTNONE

The port from which or to which the goods were shipped. For VAT reporting, certain countries require information about the port of exit or 
entry. This information is not available in the system at the present time. You specify the port of entry or exit when creating a purchase order by 
using the PO Receipts program (P4312), when creating a sales order by using the Sales Order Entry program (P4210), when confirming 
shipments by using the Shipment Confirmation program (P4205), or by using the Intrastat Revision program (P0018T). Set up valid values in UDC 
40/PE.

szSSCCNumberTareLevelPLTcharOPTNONE

The tare level Serialized Shipping Container Code. Must conform to the UCC structure for SSCC numbers.

szSSCCNumberPackLevelPAKcharOPTNONE

The pack level Serialized Shipping Container Code. Must conform to the UCC structure for SSCC numbers.

szSCCNumberSCCNcharOPTNONE

The Shipping Container Code. Must conform to the UCC structure for SCC numbers.

mnSCCQuantitySCCQMATH_NUMERICOPTNONE

The quantity of SCC packages for a given item.

szSCCUnitofMeasureSCUMcharOPTNONE

The unit of measure that represents the pack type for an SCC quantity.

szUPCNumberUPCNcharOPTNONE

The Universal Product Code number which must conform to the UCC structure for UPC numbers.

mnUPCQuantityUPQTMATH_NUMERICOPTNONE

The quantity at the UPC level - the lowest consumer-saleable package.

szUPCUnitofMeasureUPUMcharOPTNONE

The unit of measure at the UPC level - the lowest consumer-saleable package.

szNormalRouteCodeNROUcharOPTNONE

A user defined code (43/RC) that identifies a receipt route. Each receipt route consists of a series of operations through which the system 
directs items upon receipt.

cRouteTypeCodeROTPcharOPTNONE

A code that qualifies the routing for an Item/Supplier combination. Examples would include specific routing types for ASN's (EDI 856 Ship 
Notice/Manifest transactions) and for Transfers.

mnOperationSequenceFromOPRSMATH_NUMERICOPTNONE

The sequence in which the system performs the operations or steps of the route.

mnOperationSequenceToOSTOMATH_NUMERICOPTNONE

The sequence in which the system performs the operations or steps of the route.

cCallingObject_EV01EV01charOPTNONE

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

mnProcessID_PEIDPEIDMATH_NUMERICOPTNONE

A code that identifies the Inter-Process Communication ID.

mnTransactionID_TCIDTCIDMATH_NUMERICOPTNONE

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

szeReqOrderType_DCTODCTOcharOPTNONE

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

szeReqCompany_KCOOKCOOcharOPTNONE

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.

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

szEPCNumberCTSNcharOPTNONE

A unique number that identifies a specific outbound shipping container.  The container serial number is normally created from a 
standardized format.

Related Functions

B0000026 Edit Exchange Rate Tolerance
B0000027 CurrencyConvForAndDom
B0000032 RetrieveCurrencyConvFlag
B0000033 Get Exchange Rate
B0000042 Batches
B0000083 Convert Math Numeric to String with Left Zero Pad
B0000128 Retrieve Company Currency Code
B0000129 Retrieve Currency Decimals
B0000130 Retrieve Company From Business Unit
B0000173 Determine Date, Conversion Method and Rates
B0000175 Get Next Transaction Number
B0000176 Add Transaction To Subsystem Queue
B0200098 PPAT - Get User Id, Address Book Number
B0900049 Journal Entry
B3003130 F30026 Cost Components Cache
B3100730 Update Routing For PO Reciepts
B4000260 Line Type - Activity Rules
B4000350 Retrieve Distribution AAI
B4000520 Get Item UoM Conversion Factor
B4000880 Verify And Get Address Book for OP
B4000920 Get Item Branch Mfg Data
B4000930 Update F4102 MRP Net Chg
B4001090 Tax Calculator
B4002000 Compute Unit Or Extended Amount
B4100030 Verify Quantity Cost Extended
B4100150 Get Lot Master Fields
B4100210 Check Item Branch
B4100600 Verify And Get Item XRef
B41B0370 Get Bulk Info from Item Master Pointer
B4201210 Serial Number Processing Edits
B4300030 Edit Purchasing Tolerance Rules
B4300110 Get Purchase Order Detail
B4300130 Get Purchase Order Header
B4300150 Get Supplier Item Relationships
B4300160 Set Early, On Time or Late
B4300210 Calc PO Rec Std Cost Variance
B4300220 Calculate PO Receipt Zero Balance Adjustment
B4300230 Update PO Order Total
B4300370 Get Purchase Order Receipt
B4300430 Calculate Closed Amounts
B4300450 Calculate Amount and Quantity on Reversal
B4300570 Receipt Routing, Verify Receipt Routing Process
B4300780 F43092 Get Receipt Routing Record
B4300890 F43092, Verify Active Operations
B4300950 P43250, Retrieve Processing Options
B4301030 Get Landed Cost Record
B4301040 F41291 Read/Write Landed Cost Based on Amount
B4301050 F41291 Read/Write Landed Cost Job Numbers
B4301080 Duplicate PO Detail Lines
B4301171 Read/Write F4311 Cache
B4301220 Purchasing Tolerance Rules Cache Functions
B4301230 F4311 - Update Original PO Line
B4301280 F43121 Get Next Document Number
B4301300 F43121 Update Landed Cost Records
B4301350 F41291 Rev Landed Cost Cache
B4301360 F4312 Status Code Cache
B4301410 Maintain Purchasing Parms Cache
B4301500 F43121 Get Next Receipt Traveler Number
B4301670 P4312 SO Backorder Release Read Write Cache
B4301720 Read/Write Cost Type Journal Entry Line Number Cache
B4301730 Receipts Accumulation Quantity Cache
B4312 Purchase Order Receipt Functions
B4600630 F46130 Get Reserved Location
B9800100 Get Audit Information
B9900410 Get Environment Value
N3800040 F38012 Agreement Transaction Server
N3800050 F38010 Agreement Search
N3800060 F38010 Simple Edit
N4002540 F4211 Direct Ship Order Integrity
N41B0450 Get Bulk / Transaction Quantity
N4300970 Landed Cost Selection
N4301620 F43121T Retrieve Tag Record
N4600560 F46130 Reservations Reconciliation Server
N4700060 EDI Batch Number, Get Next Number
N4900510 Process Shipment Confirmation
X00COM Update Commitment Ledger
X0903 Fiscal Date Edits +
X0909 Validate Subledger
X1202 F1201 Validate Asset Number
X4101 Validate and Retrieve Item Master
X43091 Receipt Routing Initiator
X43092R F43092 Receipt Routing Deleter
X43199 Insert Purchase Ledger
XF41021 Update F41021 Locations
XF4105 Item Cost I/O
XF43121 Purchase Order Item Ledger Functions
XT4111Z1 Inventory Transactions
XT4311Z1 Purchase Order Entry

Related Tables

F43121Z Receiver workfile
F43121Z1 Receipts Unedited Transaction Table
F4312EndDoc

F4312EndDoc

Purchase Order Receipts

Master Business Function

Object Name: XT4312Z1

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function is part of the Purchase Order Receipts Master Business Function.  It will 

perform the entire updating associated with receiving a Purchase Order Line. 


Setup Notes and Prerequisites

• During the process of evolving of the OneWorld tool, numerous decisions are made that effect the 
design of this program.  Please keep in mind that old terminology may be used in this documentation from 

time to time because I have simply overlooked it or forgotten to replace it.  One big change was the 

use of cache to store the workfile rather than storing it as part of the database.  Previously, when 

the workfile was part of the database, it was referred to as 'F43121Z' or the 'Receiver Workfile'; now 

it is referred to as the 'Receiver Cache' or 'F43121Z'.  In object librarian it is still called 

F43121Z, however when created in the cache, it is called 'CF43121Z'.  (Please do not confuse this cache table 

with another cache table, 'Tolerance Cache' or 'Ctolerance', also used in this program.)

• All records in the receiver cache matching the ComputerID and JobNumber are processed.  
• The Business Function F4312BeginDoc() and F4312EditLine() must be called prior to calling this 
Business Function.  

'b7

Special Logic

Please see Technical Specification section.



Technical Specification

Not included at this time.

Data Structure

DF4312Z1C - XT4312Z1 Edit Object - End Doc

Special Input Expected

Data Item  DescriptionI/OReqd.Notes

System Fields


JOBS
JobNumberIYError if blank.  F4312BeginDoc() should already have been called 
to assign a Job Number.  Part of key to receiver cache (CF43121Z)


CTIDComputerIDIYError if blank.  GetAuditInfo() should already have been called 

to assign a Computer I.D.  Part of key to receiver cache (CF43121Z)


Purpose
Together, JOBS and CTID uniquely group together records written to the receiver cache

Special Notes

• JobNumber is assigned in F4312BeginDoc only, if and only if no errors occur .  (From the 
application point of view of P4312, a Job Number is assigned every time the form P.O.Receipts is started 

up.)

• If a value in the JobNumber field is passed to F4312BeginDoc, this value will be used and a new 
value will not be assigned.

• ComputerID must already have been assigned before calling any functions that are part of 
XT4312Z1.  It identifies the location of the computer from which this function is called.


Detailed Explanation

The first two keyed fields in the receiver cache are ComputerID and JobNumber, respectively.  
F4312EndDoc will process all records in the receiver cache that match the passed ComputerID and 

JobNumber.  


PIDProgramIDINIndicates calling application.  Valid values:

'EP4312' (Called from 'P.O. Receipts' to receive PO lines)

'EP43214' (Called from 'Receipts Inquiry' to reverse PO Lines) 

'EP43250' (Called from 'Routing Movement' to move quantity to and from 'On Hand' status in 

Receipt Routing)

'EP43253' (Called from 'Routing Disposition' to move quantity to and from 'On Hand' status in 

Receipt Routing)

Default Value:  'EP4312'


Purpose
To indicate what the calling application is.  (There is some specific processing depending on 
which application is calling the Master Business Function (MBF).)


Special Notes

• If not passed in, 'EP4312' will be assigned as the default value.  It is important to pass this 
value in if the user would like to perform processing that P4312 does not do, like Reversals, for 

example.  

• It is used when updating the field 'PID' in any of the tables in the database.  

Detailed Explanation

When a receiver cache record is successfully written, the parameter F43121Zwritten will be 
assigned to '1' at all times, except when the ProgramID is 'EP43214' in which case it will be assigned to 

a 'Y'.


VERSPOVersionIYVersion of calling application.  Used to obtain Processing 

Options.  PO in description stands for "Processing Option".  Default value: ZJDE0001


USERUserIDIY



Processing Flags


ACTNActionCodeIYValid values:

'A' or '1' == Receive P.O.Line (Always use if 'Option' != 8)

'D' or '3' == Receipt Reversal (Always use if 'Option' = 8)


CRYRCurrencyProcessingFlagINError if blank.  F4312BeginDoc() must already have been 

called to assign this flag.  Valid values: 'Y', 'N', 'Z'.  Indicates whether currency processing is ON 

('Y', 'Z') or OFF ('N')


CRRMCurrencyModeINIndicates if in Foreign ('F') or Domestic ('D') mode.  Obtained 

from P.O. Header (F4301) in F4312BeginDoc().  Pass in for performance gain by defining a work field to 

store the value for subsequent calls


RWT1ProcessEditsIY'1' == Perform full editing on fields.  For now, pass in '1'

('0' == Do not perform editing on fields **FUTURE**)

('2' == Perform partial editing only **FUTURE**)



Job Numbers


JOBSF4111JobNumberIYAssigned by F4111EditLine() which is part of the Inventory MBF.  

Once assigned, needs to be passed in with all subsequent calls..



Batch Information


ICUBatchNumberIYObtained by Opening a Batch using FSOpenBAtch (B0000042) in 
F4312BeginDoc().


ICUTBatchTypeINHard coded to be 'O'


BSTBatchStatusIYObtained in F4312BeginDoc().



Miscellaneous Fields


VRMKZeroBalRemarkINUsed only to write to Cardex.  Default: 'Zero Balance Adjustment'


SOCNTaxRemarkINUsed only to write to Cardex.  Default value: 'Taxes'


DOCDocumentNumberI/ONOnly used if Currency is off.   If not passed in, will be 

assigned using Next Numbers for OrderCompany.  



Landed Cost


JOBSLandedCJobNoIYIf Landed cost is on,, pass it back and forth to the application. 

It will be used for both applying landed cost and reversing of receipts with landed cost.


VRMKLandedCostRemarkI*Not used



General Ledger Information


JOBSF0911JobNumberIYAssigned by F0911FSBeginDoc() which is part of G/L MBF.  Once 

assigned, needs to be passed in with all subsequent calls.



EDI Transaction


EV01Called From EDII** Required only if  it is a EDI transaction


Special Output Returned


Data Item  DescriptionI/OReqd.Notes


Miscellaneous Fields


DOC
DocumentNumberI/ONOnly used if Currency is off.   If not passed in, will be 
assigned using Next Numbers for OrderCompany.

^

Parameter NameData ItemData TypeReq/OptI/O/Both
mnJobNumberJOBSMATH_NUMERICNONENONE

Special Input Expected
Error if blank.  F4312BeginDoc() should already have been called to assign a Job Number.  Part of key 

to receiver cache (CF43121Z).  JobNumber is assigned in F4312BeginDoc only, if and only if no errors 

occur .  (From the application point of view of P4312, a Job Number is assigned every time the form 

P.O.Receipts is started up.)  If a value in the JobNumber field is passed to F4312BeginDoc, this value 

will be used and a new value will not be assigned.

^

szComputerIDCTIDcharNONENONE

Special Input Expected
Error if blank.  GetAuditInfo() should already have been called to assign a Computer I.D.  Part of 

key to receiver cache (CF43121Z).  ComputerID must already have been assigned before calling any 

functions that are part of XT4312Z1.  It identifies the location of the computer from which this function is 

called.

^

cActionCodeACTNcharNONENONE

Significant Data Values
'A' or '1' - Receive P.O.Line (Always use if 'Option' != 8)

'D' or '3' - Receipt Reversal (Always use if 'Option' = 8)

^

cProcessEditsEV01charNONENONE

Significant Data Values
'1' - Perform full editing on fields.  For now, pass in '1'.

('0' - Do not perform editing on fields **FUTURE**)

('2' - Perform partial editing only **FUTURE**)



^

szProgramIDPIDcharNONENONE

Special Input Expected
Indicates calling application.  (There is some specific processing depending on which application is 

calling the Master Business Function (MBF).)  If not passed in, 'EP4312' will be assigned as the 

default value.  It is important to pass this value in if the user would like to perform processing that 

P4312 does not do, like Reversals, for example.  It is used when updating the field 'PID' in any of the 

tables in the database.  When a receiver cache record is successfully written, the parameter 

F43121Zwritten will be assigned to '1' at all times, except when the ProgramID is 'EP43214' in which case it 

will be assigned to a 'Y'.

^

szPOVersionVERScharNONENONE

Special Input Expected
Version of calling application.  Used to obtain Processing Options.  PO in description stands for 

"Processing Option".  Default value: ZJDE0001

^

cCurrencyProcessingFlagCRYRcharNONENONE

Special Input Expected
Error if blank.  F4312BeginDoc() must already have been called to assign this flag.  

^

mnF4111JobNumberJOBSMATH_NUMERICNONENONE

Special Input Expected
Assigned by F4111EditLine() which is part of the Inventory MBF.  Once assigned, needs to be passed in 

with all subsequent calls.

^

mnF0911JobNumberJOBSMATH_NUMERICNONENONE

Special Input Expected
Assigned by F0911FSBeginDoc() which is part of G/L MBF.  Once assigned, needs to be passed in with 

all subsequent calls.

^

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.

szBatchTypeICUTcharNONENONE

Special Input Expected
Hard coded to be 'O'.


^

cBatchStatusISTcharNONENONE

A user defined code (98/IC) that indicates the posting status of a batch. Valid values are: Blank    Unposted batches that are pending 
approval or have a status of approved. A        Approved for posting. The batch has no errors, and is in balance, but has not yet been posted. D       
Posted. The batch posted successfully. E        Error. The batch is in error. You must correct the batch before it can post. P        Posting. The system 
is in the process of posting the batch to the general ledger. The batch is unavailable until the posting process is complete. If errors occur 
during the post, the batch status changes to E (error). U        In use. The batch is temporarily unavailable because someone is working with it, or 
the batch appears to be in use because a power failure occurred while the batch was open.

cCurrencyModeCRRMcharNONENONE

Special Input Expected
Obtained from P.O. Header (F4301) in F4312BeginDoc().  Pass in for performance gain by defining a 

work field to store the value for subsequent calls.


^

szUserIDUSERcharNONENONE

The code that identifies a user profile.

szZeroBalRemarkVL01charNONENONE

The list of selection values associated with a data selection item in the Dream Writer. This list is generated by the use of the *VALUES 
keyword in data selection setup. Elements 1 and 2 are also used to contain the upper and lower value for the keyword *RANGE used by the 
data selection in the Dream Writer.

szTaxRemarkVL02charNONENONE

The list of selection values associated with a selection item in the Dream Writer. This list is generated by the use of the *VALUES keyword 
in data selection set-up. Elements 1 and 2 of this array are also used to contain the upper and lower value for the keyword *RANGE utilized 
by the data selection processing in the Dream Writer.

szLandedCostRemarkVL03charNONENONE

Special Input Expected
Not used.

^

mnDocumentNumberDOCMATH_NUMERICNONENONE

Special Input Expected
Only used if Currency is off.   If not passed in, will be assigned using Next Numbers for 

OrderCompany.

^

cCalledFromEDIEV03charNONENONE

Special Input Expected
If processing an EDI Transaction, pass in a '1'.


^

mnLandedCJobNoJOBSMATH_NUMERICNONENONE

Special Input Expected
If Landed cost is on, pass it back and forth to the application. It will be used for both applying 

landed cost and reversing of receipts with landed cost.

^

szReceiptTravelerNumberVINVcharOPTNONE

The supplier's invoice number that is used for voucher entry. Voucher entry allows only one invoice per voucher number. If multiple invoice 
numbers exist on a voucher, you must set them up as multiple vouchers or combine the invoices and enter them as one voucher. Depending 
on how you have your accounts payable constants set, the system can do one of the following:   o  Accept a duplicate invoice number 
without warning or error   o  Generate a warning message in which the duplicate invoice number can still be accepted   o  Generate an error 
message Blank values are treated in the same manner as any other invoice number. Two blank invoice numbers are treated as duplicates. To test 
for duplicate invoice numbers that might have been entered in error, run the Suspected Duplicate Payments report (R04601). Note: The 
duplicate invoice number validation is not run for vouchers with document type NO. These vouchers are created by the Generate Reimbursements 
program (R03B610).

mnLCF0911JobNumberJOBSMATH_NUMERICOPTNONE

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

cTransIntransitFlagEV01charOPTNONE

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

cNotaFiscalFlagEV01charOPTNONE

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

mnF4311JobNumberJOBSMATH_NUMERICOPTNONE

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

cCacheActionUponCompletionEV01charOPTNONE

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

Related Functions

B0000026 Edit Exchange Rate Tolerance
B0000027 CurrencyConvForAndDom
B0000032 RetrieveCurrencyConvFlag
B0000033 Get Exchange Rate
B0000042 Batches
B0000083 Convert Math Numeric to String with Left Zero Pad
B0000128 Retrieve Company Currency Code
B0000129 Retrieve Currency Decimals
B0000130 Retrieve Company From Business Unit
B0000173 Determine Date, Conversion Method and Rates
B0000175 Get Next Transaction Number
B0000176 Add Transaction To Subsystem Queue
B0200098 PPAT - Get User Id, Address Book Number
B0900049 Journal Entry
B3003130 F30026 Cost Components Cache
B3100730 Update Routing For PO Reciepts
B4000260 Line Type - Activity Rules
B4000350 Retrieve Distribution AAI
B4000520 Get Item UoM Conversion Factor
B4000880 Verify And Get Address Book for OP
B4000920 Get Item Branch Mfg Data
B4000930 Update F4102 MRP Net Chg
B4001090 Tax Calculator
B4002000 Compute Unit Or Extended Amount
B4100030 Verify Quantity Cost Extended
B4100150 Get Lot Master Fields
B4100210 Check Item Branch
B4100600 Verify And Get Item XRef
B41B0370 Get Bulk Info from Item Master Pointer
B4201210 Serial Number Processing Edits
B4300030 Edit Purchasing Tolerance Rules
B4300110 Get Purchase Order Detail
B4300130 Get Purchase Order Header
B4300150 Get Supplier Item Relationships
B4300160 Set Early, On Time or Late
B4300210 Calc PO Rec Std Cost Variance
B4300220 Calculate PO Receipt Zero Balance Adjustment
B4300230 Update PO Order Total
B4300370 Get Purchase Order Receipt
B4300430 Calculate Closed Amounts
B4300450 Calculate Amount and Quantity on Reversal
B4300570 Receipt Routing, Verify Receipt Routing Process
B4300780 F43092 Get Receipt Routing Record
B4300890 F43092, Verify Active Operations
B4300950 P43250, Retrieve Processing Options
B4301030 Get Landed Cost Record
B4301040 F41291 Read/Write Landed Cost Based on Amount
B4301050 F41291 Read/Write Landed Cost Job Numbers
B4301080 Duplicate PO Detail Lines
B4301171 Read/Write F4311 Cache
B4301220 Purchasing Tolerance Rules Cache Functions
B4301230 F4311 - Update Original PO Line
B4301280 F43121 Get Next Document Number
B4301300 F43121 Update Landed Cost Records
B4301350 F41291 Rev Landed Cost Cache
B4301360 F4312 Status Code Cache
B4301410 Maintain Purchasing Parms Cache
B4301500 F43121 Get Next Receipt Traveler Number
B4301670 P4312 SO Backorder Release Read Write Cache
B4301720 Read/Write Cost Type Journal Entry Line Number Cache
B4301730 Receipts Accumulation Quantity Cache
B4312 Purchase Order Receipt Functions
B4600630 F46130 Get Reserved Location
B9800100 Get Audit Information
B9900410 Get Environment Value
N3800040 F38012 Agreement Transaction Server
N3800050 F38010 Agreement Search
N3800060 F38010 Simple Edit
N4002540 F4211 Direct Ship Order Integrity
N41B0450 Get Bulk / Transaction Quantity
N4300970 Landed Cost Selection
N4301620 F43121T Retrieve Tag Record
N4600560 F46130 Reservations Reconciliation Server
N4700060 EDI Batch Number, Get Next Number
N4900510 Process Shipment Confirmation
X00COM Update Commitment Ledger
X0903 Fiscal Date Edits +
X0909 Validate Subledger
X1202 F1201 Validate Asset Number
X4101 Validate and Retrieve Item Master
X43091 Receipt Routing Initiator
X43092R F43092 Receipt Routing Deleter
X43199 Insert Purchase Ledger
XF41021 Update F41021 Locations
XF4105 Item Cost I/O
XF43121 Purchase Order Item Ledger Functions
XT4111Z1 Inventory Transactions
XT4311Z1 Purchase Order Entry

Related Tables

F43121Z Receiver workfile
F43121Z1 Receipts Unedited Transaction Table
to String with Left Zero Pad B0000128 Retrieve Company Currency Code B0000129 Retrieve Currency Decimals B0000130 Retrieve Company From Business Unit B0000173 Determine Date, Conversion Method and Rates B0000175 Get Next Transaction Number B0000176 Add Transaction To Subsystem Queue B0200098 PPAT - Get User Id, Address Book Number B0900049 Journal Entry B3003130 F30026 Cost Components Cache B3100730 Update Routing For PO Reciepts B4000260 Line Type - Activity Rules B4000350 Retrieve Distribution AAI B4000520 Get Item UoM Conversion Factor B4000880 Verify And Get Address Book for OP B4000920 Get Item Branch Mfg Data B4000930 Update F4102 MRP Net Chg B4001090 Tax Calculator B4002000 Compute Unit Or Extended Amount B4100030 Verify Quantity Cost Extended B4100150 Get Lot Master Fields B4100210 Check Item Branch B4100600 Verify And Get Item XRef B41B0370 Get Bulk Info from Item Master Pointer B4201210 Serial Number Processing Edits B4300030 Edit Purchasing Tolerance Rules B4300110 Get Purchase Order Detail B4300130 Get Purchase Order Header B4300150 Get Supplier Item Relationships B4300160 Set Early, On Time or Late B4300210 Calc PO Rec Std Cost Variance B4300220 Calculate PO Receipt Zero Balance Adjustment B4300230 Update PO Order Total B4300370 Get Purchase Order Receipt B4300430 Calculate Closed Amounts B4300450 Calculate Amount and Quantity on Reversal B4300570 Receipt Routing, Verify Receipt Routing Process B4300780 F43092 Get Receipt Routing Record B4300890 F43092, Verify Active Operations B4300950 P43250, Retrieve Processing Options B4301030 Get Landed Cost Record B4301040 F41291 Read/Write Landed Cost Based on Amount B4301050 F41291 Read/Write Landed Cost Job Numbers B4301080 Duplicate PO Detail Lines B4301171 Read/Write F4311 Cache B4301220 Purchasing Tolerance Rules Cache Functions B4301230 F4311 - Update Original PO Line B4301280 F43121 Get Next Document Number B4301300 F43121 Update Landed Cost Records B4301350 F41291 Rev Landed Cost Cache B4301360 F4312 Status Code Cache B4301410 Maintain Purchasing Parms Cache B4301500 F43121 Get Next Receipt Traveler Number B4301670 P4312 SO Backorder Release Read Write Cache B4301720 Read/Write Cost Type Journal Entry Line Number Cache B4301730 Receipts Accumulation Quantity Cache B4312 Purchase Order Receipt Functions B4600630 F46130 Get Reserved Location B9800100 Get Audit Information B9900410 Get Environment Value N3800040 F38012 Agreement Transaction Server N3800050 F38010 Agreement Search N3800060 F38010 Simple Edit N4002540 F4211 Direct Ship Order Integrity N41B0450 Get Bulk / Transaction Quantity N4300970 Landed Cost Selection N4301620 F43121T Retrieve Tag Record N4600560 F46130 Reservations Reconciliation Server N4700060 EDI Batch Number, Get Next Number N4900510 Process Shipment Confirmation X00COM Update Commitment Ledger X0903 Fiscal Date Edits + X0909 Validate Subledger X1202 F1201 Validate Asset Number X4101 Validate and Retrieve Item Master X43091 Receipt Routing Initiator X43092R F43092 Receipt Routing Deleter X43199 Insert Purchase Ledger XF41021 Update F41021 Locations XF4105 Item Cost I/O XF43121 Purchase Order Item Ledger Functions XT4111Z1 Inventory Transactions XT4311Z1 Purchase Order Entry

Related Tables

F43121Z Receiver workfile
F43121Z1 Receipts Unedited Transaction Table
F4312EndDoc

F4312EndDoc

Purchase Order Receipts

Master Business Function

Object Name: XT4312Z1

Parent DLL: CDIST

Location: Client/Server

Language: C

Functional Description

Purpose

This business function is part of the Purchase Order Receipts Master Business Function.  It will 

perform the entire updating associated with receiving a Purchase Order Line. 


Setup Notes and Prerequisites

• During the process of evolving of the OneWorld tool, numerous decisions are made that effect the 
design of this program.  Please keep in mind that old terminology may be used in this documentation from 

time to time because I have simply overlooked it or forgotten to replace it.  One big change was the