Functional Description
Purpose
(F40UI74). These files are used by the Sales Order Processing system to keep track of audit trail
information for the base price and advanced adjustment records of a sales order. You can use this
function to add, change, inquire, and delete records from the Price History File or the Price History
Work File. In addition, the function can be invoked to retrieve the next adjustment record. The
records retrieved will be in sequence number (OSEQ) order. Also, with this function, it is possible to
retrieve only a certain ACNT type of price records by passing in a value to Adjustment Control
Code (ACNT).
Setup Notes and Prerequisites
When maintaining F4074, use this function at the following events: Update Record to DB - After or
Add Record to DB - After. This will allow the application to first update/add the sales order detail
record before performing any updates/adds to the F4074. The F4074 is essentially a tag file for the
F4211.
'b7'b7
Special Logic
None.
Technical Specification
2.2Related Tables
Table Table Description
F4074Price History File
2.3Related Business Functions
Source NameFunction Name
B9800100.cGetAuditInfo
2.4Processing
You can call this business function in four different actions (ACTI):
A = Add
C = Change
I = Inquire
D = Delete
N = Fetch Next
If Inquire mode and File == 1, fetch a record from the Price History File F4074 by the following
keys:
DOCO - Order Number
DCTO - Order Type
KCOO - Key Company
LNID - Line Number
OSEQ - Sequence Number
nNoOfKeys = 5;
If 'Fetch Next' mode and File == 1, fetch the next record from the Price History File F4074 by the
following keys: (Added 9/27/96)
If it is the first time in ( i.e. hRequest == NULL)
Open F4074 - Save hRequest in Genlng Variable to pass back
Sort the F4074 in Ascending order
Set Selection where OSEQ F4074 > lpDS OSEQ passed in
else
retrieve the hrequest from the Genlng Variable passed in
Fetch the record
DOCO - Order Number
DCTO - Order Type
KCOO - Key Company
LNID - Line Number
nNoOfKeys = 4
NOTE: Fetch the next record with a OSEQ greater than the OSEQ-parm (i.e. DOCO == DOCO-parm AND . .
.OSEQ > OSEQ-parm. Return the new record's OSEQ in the OSEQ parameter.
If Inquiry mode and File = 2, fetch a record from the Price History Work File F40UI74 by the
following keys: (Added 9/19/96)
CTID - Computer ID
JOBS - Job Number
XLIN - Line Number 2
KCOO - Key Company
LNID - Line Number
AREV - Revision Level
OSEQ - Sequence Number
nNoOfKeys = 9
If 'Fetch Next' mode and File = 2, fetch a record from the Price History Work File F40UI74 by the
following keys: (Added 9/27/96)
If it is the first time in ( i.e. hRequest == NULL)
Open F40UI74 - Save hRequest in Genlng Variable to pass back
Sort the F40UI74 in Ascending order
Set Selection where OSEQ F40UI74 > lpDS OSEQ passed in
else
retrieve the hrequest from the Genlng Variable passed in
Fetch the Record
CTID - Computer ID
JOBS - Job Number
XLIN - Line Number 2
KCOO - Key Company
LNID - Line Number
AREV - Revision Level
nNoOfKeys = 8
NOTE: Fetch the next record with a OSEQ greater than the OSEQ-parm (i.e. CTID == CTID-parm AND . .
.OSEQ > OSEQ-parm. Return the new record's OSEQ in the OSEQ parameter.
If a record is found, map table columns to their corresponding columns in the parameter data
structure. This will essentially return the entire record to the calling application.
If the record is not found in the table and the Suppress Error Message EV01 is not equal to '1', set
error message '0001' and return to calling application. Use the standard logic for EV01 and DTAI.
If the Action Code ACTI = 'A', add a record to the table with all the database fields from the passed
parameters.
If the Action Code ACTI = 'C', update the following fields from the passed parameters:
ASNAdjustment Schedule
ASTAdjustment Name
ITMItem Number
AN8Address Number
ICIDItem/Customer Key ID
SDGRSales Detail Group
SDV1Sales Detail Value 01
SDV2Sales Detail Value 02
SDV3Sales Detail Value 03
CRCDCurrency Code
UOMUnit of Measure
UPRCUnit Price
FUPForeign Unit Price
GLCG/L Class
ARSNReason Code
ACNTAdjustment Control Code
SBIFSubledger in G/L
MDEDManual Add/Change
PROVPrice Override Code
ATIDPrice Adjustment Key ID
MNQQuantity From
LEDGCost Method
FRMNFormula Name
BSCDBasis Code
FVTRFactor Value
ABASOverride Price Y/N
PIDProgram ID
TXBTaxable
Note: In add and change modes, update the User ID (USER), WorkStation ID (JOBN), Date Updated
(UPMJ), and the Time of Day (TDAY) by retrieving corresponding information using GetAuditInfo (B9800100.c).
If the Action Code ACTI is equal to 'D' and File = 1, delete all matching records from F4074 by the
following keys:
DOCO - Order Number
DCTO - Order Type
KCOO - Key Company
LNID - Line Number
nNoOfKeys = 4
If the Action Code ACTI is equal to 'D' and File = 2, delete all matching records from F40UI74 by the
following keys: (Added 9/19/96)
CTID - Computer ID
JOBS - Job Number
XLIN- Line Number 2
KCOO - Key Company
LNID - Line Number
nNoOfKeys = 7
D4200230 - F4074 Maintain Price History
Special Input Expected
CTIDComputer IDRequired for F40UI74 maintenance (Added 9/19/96)
JOBSJob NumberRequired for F40UI74 maintenance (Added 9/19/96)
XLINLine NumberRequired for F40UI74 maintenance (Added 9/19/96)
DOCOOrder Number
DCTOOrder Type
KCOOOrder Company
LNIDLine Number
AREVRevision LevelRequired for F40UI74 maintenance (Added 9/19/96)
OSEQSequence Number
ASNAdjustment Schedule
ASTAdjustment Name
ITMItem Number
AN8Address Number
ICIDItem/Customer Key ID
SDGRSales Detail Group
SDV1Sales Detail Value 01
SDV2Sales Detail Value 02
SDV3Sales Detail Value 03
CRCDCurrency Code
UOMUnit of Measure
UPRCUnit Price
FUPForeign Unit Price
GLCG/L Class
ARSNReason Code
ACNTAdjustment Control CodeCan be passed in to filter records using ACNT. Filtering works only for the action code 'N' (Fetch Next).
SBIFSubledger in G/L
MDEDManual Add/Change
PROVPrice Override Code
ATIDPrice Adjustment Key ID
PIDProgram ID
MNQQuantity FromFuture Use
LEDGCost MethodFuture Use
FRMNFormula NameFuture Use
BSCDBasis CodeFuture Use
FVTRFactor ValueFuture Use
ABASOverride Price Y/NFuture Use
ACTIAction CodeA- Add C-Change I-Inquire D-Delete N-Fetch Next (Added 9/27/96)
EV02File 1 - F4074, 2 - F40UI74 (Added 9/19/96)
EV01Suppress Error Message
DTAIError Message IDI
GENLNGhRequestIf ACTI == N then this function will return a hRequest which must be passed back into this function to obtain the
next record. The caller of this function must free the hRequest by calling FreeHUserorHRequest.
Special Output Returned
OSEQSequence Number
ASNAdjustment Schedule
ASTAdjustment Name
ITMItem Number
AN8Address Number
ICIDItem/Customer Key ID
SDGRSales Detail Group
SDV1Sales Detail Value 01
SDV2Sales Detail Value 02
SDV3Sales Detail Value 03
CRCDCurrency Code
UOMUnit of Measure
UPRCUnit Price
FUPForeign Unit Price
GLCG/L Class
ARSNReason Code
ACNTAdjustment Control CodeCan be passed in to filter records using ACNT. Filtering works only for the action code 'N' (Fetch Next).
SBIFSubledger in G/L
MDEDManual Add/Change
PROVPrice Override Code
ATIDPrice Adjustment Key ID
PIDProgram ID
MNQQuantity FromFuture Use
LEDGCost MethodFuture Use
FRMNFormula NameFuture Use
BSCDBasis CodeFuture Use
FVTRFactor ValueFuture Use
ABASOverride Price Y/NFuture Use
GENLNGhRequestIf ACTI == N then this function will return a hRequest which must be passed back into this function to obtain the
next record. The caller of this function must free the hRequest by calling FreeHUserorHRequest.
^
Parameter Name | Data Item | Data Type | Req/Opt | I/O/Both |
---|---|---|---|---|
mnOrderNumber | DOCO | MATH_NUMERIC | NONE | NONE |
A number that identifies an original document. This document can be a voucher, a sales order, an invoice, unapplied cash, a journal entry,
| ||||
szOrderType | DCTO | char | NONE | NONE |
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
| ||||
szOrderCompany | KCOO | char | NONE | NONE |
A number that, along with order number and order type, uniquely identifies an order document (such as a purchase order, a contract, a
| ||||
mnLineNumber | LNID | MATH_NUMERIC | NONE | NONE |
A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns
| ||||
mnSequenceNumber | OSEQ | MATH_NUMERIC | NONE | NONE |
For OneWorld, the sequence by which users can set up the order in which their valid environments are displayed.
For World, a sequence or
| ||||
szAdjSchedule | ASN | char | NONE | NONE |
A user defined code (40/AS) that identifies a price and adjustment schedule. A price and adjustment schedule contains one or more
| ||||
szAdjName | AST | char | NONE | NONE |
A user defined code (system 40, type TY) that identifies an adjustment definition. You define adjustments on Price Adjustment Names.
For
| ||||
mnShortItemNumber | ITM | MATH_NUMERIC | NONE | NONE |
An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item
| ||||
mnAddressNumber | AN8 | MATH_NUMERIC | NONE | NONE |
A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or
| ||||
szCurrencyCode | CRCD | char | NONE | NONE |
A code that identifies the currency of a transaction. | ||||
szUnitOfMeasure | UOM | char | NONE | NONE |
A user defined code (00/UM) that indicates the quantity in which to express an inventory item, for example, CS (case) or BX (box). | ||||
mnUnitPrice | UPRC | MATH_NUMERIC | NONE | NONE |
The list or base price to be charged for one unit of this item. In sales order entry, all prices must be set up in the Item Base Price File table
| ||||
mnForeignUnitPrice | FUP | MATH_NUMERIC | NONE | NONE |
The foreign price per unit. | ||||
szGLClass | GLC | char | NONE | NONE |
A code that determines the trade account that the system uses as the offset when you post invoices or vouchers. The system concatenates
| ||||
szReasonCode | ARSN | char | NONE | NONE |
User defined code (system 40, type AR) you can use to identify why you change an adjustment. | ||||
cAdjControlCode | ACNT | char | NONE | NONE |
A code that specifies additional processing features related to an adjustment. Valid values are:
1
Do not print the adjustment on the invoice
| ||||
cSubledgerGL | SBIF | char | NONE | NONE |
A user defined code (system 40, type SI) that identifies the type of information that you want the system to use to update the Subledger field
| ||||
cManualAddChange | MDED | char | NONE | NONE |
Specifies whether the adjustment type can be manually added to or changed from the Price Adjustments form (P4074W) when you enter
| ||||
cPriceOverrideCode | PROV | char | NONE | NONE |
A value established by the sales order entry program whenever a unit or extended price is entered into an order line item, overriding the
| ||||
mnPriceAdjKeyID | ATID | MATH_NUMERIC | NONE | NONE |
The unique key I.D. for each adjustment level. | ||||
szProgramID | PID | char | NONE | NONE |
The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry
| ||||
mnQuantityFrom | MNQ | MATH_NUMERIC | NONE | NONE |
A value that specifies how an adjustment or preference will be applied to a price. This value can be a quantity, weight, or amount,
| ||||
szCostMethod | LEDG | char | NONE | NONE |
A user defined code (40/CM) that specifies the basis for calculating item costs. Cost methods 01 through 19 are reserved for J.D. Edwards
| ||||
szFormulaName | FRMN | char | NONE | NONE |
A user defined code (system 40, type FM) that identifies a price formula. All price formulas are stored in the Price Formula table (F4076). | ||||
cBasisCode | BSCD | char | NONE | NONE |
A code that specifies how the system uses the factor value to calculate the adjustment or penalty schedule. The Basis Code field works
| ||||
mnFactorValue | FVTR | MATH_NUMERIC | NONE | NONE |
A code that indicates how the system adjusts an order line. The value in this field works in conjunction with the Basis field (BSCD). How you
| ||||
cOverridePriceYN | ABAS | char | NONE | NONE |
A code indicating how the adjustment affects the price of a sales order line.
For WorldSoftware, valid codes are:
Y The adjustment price
| ||||
cActionCode | ACTI | char | NONE | NONE |
Special Input Expected
| ||||
cErrorCode | ERRC | char | NONE | NONE |
This error code indicates if any errors occurred during the creation of the Trip Document Detail (F4914) records by the Delivery Document
| ||||
cSuppressErrorMsg | EV01 | char | NONE | NONE |
An option that specifies the type of processing for an event. | ||||
szErrorMsgID | DTAI | char | NONE | NONE |
A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or
| ||||
cFile | EV01 | char | NONE | NONE |
Special Input Expected
| ||||
szComputerID | CTID | char | NONE | NONE |
mnJobNumber | JOBS | MATH_NUMERIC | NONE | NONE |
The job number (work station ID) which executed the particular job. | ||||
mnLineNumber2 | XLIN | MATH_NUMERIC | NONE | NONE |
Line number. | ||||
mnRevisionLevel | AREV | MATH_NUMERIC | NONE | NONE |
This field maintains the current revision level of Advanced Pricing adjustments awarded within a sales order. Adjustments associated with
| ||||
szLineType | LNTY | char | NONE | NONE |
A code that controls how the system processes lines on a transaction. It controls the systems with which the transaction interfaces, such as
| ||||
szDescription | DSC1 | char | NONE | NONE |
Brief information about an item; a remark or an explanation. | ||||
sz2ndItemNo | LITM | char | NONE | NONE |
A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to
| ||||
sz3rdItemNo | AITM | char | NONE | NONE |
The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item
| ||||
idHRequest | GENLNG | ID | NONE | NONE |
General purpose ID variable. | ||||
cAdjustmentLevel | OLVL | char | NONE | NONE |
A code that specifies the level at which the system calculates price adjustments. Valid values are:
1
Line level - The system calculates the
| ||||
mnProcessID | PEID | MATH_NUMERIC | OPT | NONE |
A code that identifies the Inter-Process Communication ID. | ||||
mnTransactionID | TCID | MATH_NUMERIC | OPT | NONE |
mnItemGroupKeyID | IGID | MATH_NUMERIC | OPT | NONE |
A number that identifies an item group or an order detail pricing group. Each pricing group is comprised of either item category codes (for
| ||||
mnCustomerGroupKeyID | CGID | MATH_NUMERIC | OPT | NONE |
A number that identifies a customer pricing group. Each pricing group comprises customer category codes. For every unique combination
| ||||
mnOrderGroupKeyID | OGID | MATH_NUMERIC | OPT | NONE |
A number that identifies an order detail pricing group. Each group consists of sales order detail values. For each unique combination of
| ||||
szOrderSuffix | SFXO | char | OPT | NONE |
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
| ||||
mnPriceHistoryAltKey | AKID | MATH_NUMERIC | OPT | NONE |
A value that specifies an alternate key in the Price Adjustment Ledger File table (F4074). | ||||
szPriceHistoryAltKeySource | SRCFD | char | OPT | NONE |
A user defined code that you enter to indicate the JD Edwards system,such as Service Warranty Management etc,that the price adjustment
| ||||
mnAddressNumberPriceAdjust | ANPS | MATH_NUMERIC | OPT | NONE |
An address book number that indicates whether the adjustment schedule is directly attached to the customer rather than to the name of an
| ||||
mnTier | TIER | MATH_NUMERIC | OPT | NONE |
A number that represents the tier level in the structure at and below which the system applies this adjustment. This number must be equal to
| ||||
mnSubSequenceNumber | SUBSEQ | MATH_NUMERIC | OPT | NONE |
The number of the subadjustments (for example, a sliding rate adjustment) within an adjustment. | ||||
szFactorValueUM | FVUM | char | OPT | NONE |
A user defined code (00/UM) that specifies the unit of measure associated with the factor value for an advanced price adjustment. This
| ||||
cSlidingRateFlag | SRFLAG | char | OPT | NONE |
An option that specifies how the system applies adjustments to the unit price. Valid values are:
On
The system applies a sliding rate
| ||||
mnBasedOnValue | BSDVAL | MATH_NUMERIC | OPT | NONE |
A value that the system uses to calculate an adjustment. The value can be a quantity, weight, or amount. | ||||
szAdjustmentCalculation | ADJCAL | char | OPT | NONE |
An equation that the system uses to determine the adjustment unit price for sliding rate adjustments or adjustments that do not allow partial
| ||||
cMutuallyExclusiveAdjustme | MEADJ | char | OPT | NONE |
An option that specifies whether an adjustment is mutually exclusive within the specified adjustment group. When you choose this option,
| ||||
szAdjustmentGroup | ADJGRP | char | OPT | NONE |
A user defined code (45/AG) used to associate adjustment definitions to adjustment groups. You can define adjustments that belong to the
| ||||
cAdjustmentStatus | ADJSTS | char | OPT | NONE |
A code that indicates whether an adjustment has been cancelled. Although the adjustment remains in the Price Adjustment Ledger File
| ||||
szPromotionID | PMTN | char | OPT | NONE |
An identification number that tracks revenue, costs, and expenses for each promotion. | ||||
cPromotionDisplayControl | PDCL | char | OPT | NONE |
An option that specifies whether the system prints the promotion ID for this adjustment on an invoice or on the purchase order print
| ||||
szChargeReference | ADJREF | char | OPT | NONE |
The adjustment reference is a value entered by the user via the Price History/Check Price and Availability application, which is associated
| ||||
mnAccumulateAtAddress | ACCAN8 | MATH_NUMERIC | OPT | NONE |
A number that indicates the address book number for which the system accumulates rebates or volume incentive values.
The system uses
| ||||
mnBeneficiaryAddress | BNAD | MATH_NUMERIC | OPT | NONE |
The address number that the system uses when generating a rebate claim. If this is a sales rebate, the beneficiary address will specify the
|
B4200210 Get F4211 Detail Information | ||||
B9800100 Get Audit Information |
F4074 Price Adjustment Ledger File |