Functional Description
Purpose
This function performs all edits for Supplier Master. Inquire, add, copy, delete or update will be handled by this function based on the Action Code. All
the deletes are done through Address Book-MBF. Based on the Action Code, this function will also default values where necessary. This function will
automatically update relevant fields in F0401 table. The F0401table is updated as appropriate. Only the essential fields in this table are defaulted and
populated. A return flag will be added as a parameter to return success/error code to the calling program when this function is called from another
program or application. This function is currently used for add/update/inquire, edit, error check, and defaulting of the essential fields for any Supplier Master
record. This function is not sufficient to enter Address Book records for specific search type Supplier - an Address Book Record is needed along with
this function to complete the address book record specific to a Supplier.
Setup Notes and Prerequisites
- This function can be used with either interactive or batch processes.
-Data dictionary edits are performed where appropriate, with the SV Error_Status flag identifying errors and warnings. Please do not use the
Error Message ID parameter for this reason. Business functions calling this function using JDECall Object however can get the success/error ID
returned.
This function doesn't add a Supplier Record unless an Address Book record already exist. Address
number must be entered through Address Book.
This function must be called with one and only one Action Code at a time.
There is no caching in this function. Values returned by this function need to be stored in
variables outside the function for it to be used.
'b7'b7
Special Logic
Expected Changes : (Some changes may need change to data structure)
Activation of ' Update Master File' flag. Enter 1 in Add and Change Mode for Database commit.
Activation of ' Process Edits' flag (Future Consideration).
Activation of ' Suppress Error message' flag (Future Consideration).
MBF Version will be introduced.
JDESM (UDC 00/TT) to activate outbound interoperability. This will allow Address Book record images to be stored in the F0401Z1file in case of
ADD, CHANGE, DELETE. Processing options are available to allow Before/After image processing, if required. Inbound interoperability is
through Supplier Master Batch application and is not a part of Supplier Master MBF. Please create a version for Application P0100043 to be
accessed by the MBF.
Technical Specification
Supplier Master -Master Business Function
(Data Structure N0100043)
AliasDescriptionRequiredI/ONotes
ACTNAction Code YIA - Add
C - Change
D - Delete
I - Inquire
EV01Update Master File NIEnter 1 to Add and Change to
committ to database.
EV01Process Edits NIFuture Use
SUPPSSuppress ErrorsFlags NIFuture Use
VERSVersion N IThe MBF Version to run.
AN8Supplier Number Y I/O
APCG/L Class NI/O
MCUPBusiness Unit A/P Default NI/O
OBAPObject A/P Default NI/O
AIDPSub A/P Default NI/O
KCOPA/P Model DocCompany NI/O
DCAA/P Model JE Document NI/O
DTAPA/P Model JE Doc Type NI/O
CRCPCurrency code (A/P) NI/O
TXA2Tax Rate/Area NI/O
TXA3Tax Area 3- Withholding NI/O
TXA3Tax Expl Code 3 NI/O
HDPYHold Payment NI/O
SCKMultiple payments NI/O
TAWHTax Authority NI/O
PCWHWithholding Percent NI/O
EXR2Tax Expl code 2 NI/O
TRAPPayment Term A/P NI/O
RYINPayment Instruments NI/O
SNTOApprover Number NI/O
AB1Pre - Note Code NI/O
FLDFloat Days for Payments NI/O
STMTPrint statement NI/O
SQNLLedger Inquiry Sequence NI/O
CRCACurrency code A/B amount NI/O
ABAMAmount A/B NI/O
ABA1Amount A/B NI/O
APRCAmount open order NI/O
MINOMinimum order value NI/O
MAXOMaximum order value NI/O
AYPDAmount Vouchered YTD NI/O
APPDAmount Vouchered PYE NI/O
AN8R Related Address NI/O
BADTBilling address type NI/O
CPGPCustomer price group NI/O
ORTPOrder Template NI/O
INMGPrint message NI/O
HOLDHold order code NI/O
ROUTRoute code NI/O
STOPStop code NI/O
ZONZone # NI/O
ANCRCarrier number NI/O
CARSCarrier number NI/O
DEL1Delivery Instruction 1 NI/O
DEL2Delivery Instruction 2 NI/O
LTDTTransit Days NI/O
FRTHFreight handling code NI/O
INVCnvoice copies NI/O
WUMDUnit of measure weight NI/O
VUMDUnit of measure volume NI/O
PRP5Landed Cost Rule NI/O
EDPMBatch processing mode NI/O
EDCICustomer type identifier NI/O
EDIItem type identifier NI/O
EDQDQuantity decimal NI/O
EDADAmount decimals NI/O
EDF1Delivery note NI/O
EDF2tem restriction NI/O
VI01Supplier / Parent Rebate NI/O
VI02Supplier Rebate Code NI/O
VI03Special Instruct 03 NI/O
VI04Special Instruct 04 NI/O
VI05Special Instruct 05 NI/O
MNSCMinimum Check Code NI/O
ATOOwner (Y / N) NI/O
RVNTRevenue Netted (Y / N) NI/O
ASNAdjustment NI/O
CRMDSend Method NI/O
AVCHEvaluated Receipt NI/O
URCDUser reserved Code NI/O
URDTUser reserved date NI/O
URATUser reserved amount NI/O
URABUser reserved number NI/O
USERUser NI/O
PIDProgram ID NI/O
JOBNJob # NI/O
UPMJDate updated NI/O
UPMTTime last updated NI/O
ASNPrice Adjustment schedule NI/O
Related Tables
TableTable Description
F0101Address Book Master
F0401Supplier Master
F0401Z1Supplier Master Batch File
Related Business Functions
Source NameFunction name
B9800100Get Audit Information.
B0000032F0010 Get Currency Conversion Flag.
B01000052Get PO version for MBF
B0100061F0101 Edit Address Number.
N7300001Determine If Vertex is Active
B7300002Validate GeoCode
B7300004Unload GeoCode Cache
N7300011Validate GeoCode and Tax Rate Area
N7300003Validate Country Code and Search Type
B0100002F0150 Get Parent Address
B0100003F0150 Update Parent / Child Record
XX0901F0901 Edit Account Number
B0100013F0006 Get Company from AB Business Unit.
B0000128F0010 Get Company Currency Code.
N4700060EDI Batch Number, Get Next Number
B0000175Get Next Transaction Number
B0000176Add Transaction To Subsystem Queue
BDDVALData Dictionary Validation.
N0100041Address Book - MBF
B0100061F0101 Address Book Mini Update
Basic Logic
Initialize mode (runs every time called - need not have to call separately)
1. Get Currency conversion flag from F0010 table (No parameters used)
2. Get SEPF flag from F0009 table (no parameters used)
3. Get audit info (no parameters used)
4. Get Distribution Const
5. Batch HeaderMay be later
6. Transaction file
Processing
Design Flow - Supplier Master MBF
Initialize Mode
The section runs whenever the Supplier Master MBF is called.
Get Audit Information.
Get Currency conversion flag from F0010 table (No parameters used)
If Address Number is zero and Long Address Number is greater then zero
Edit Address Number
Endif
If Address Number is zero and Long Address Number is zero and Action Code <> Add
Set Error
Else
F0101.FetchSingle - Checking if Address Book record exists.
If Not Found
Set Error
Endif
Endif
If No Error
Add Section
Determine if Vertex is Active
If Vertex is Active
Validate GeoCode
Unload GeoCodeCache
Validate GeoCode and Tax Rate Area
Validate Country Code and Search Type
If GeoCode is Valid
Check if Tax Explanation Code = E or S or U
Set Error if not equal to E, S or U
Else
Check if Tax Explanation Code = B or U
Error if not equal to B or U
End if
End if
If Bf Person Corporation Code = Blank and Person Corporation Code in F0101
Endif
If Bf Factor Special Payee = Zero and Factor Special Payee in F0101
Endif
If Bf Long Address Number = Blank and Long Address Number in F0101
Endif
If Bf Credit Message = Blank and Credit Message in F0101
D0100043 - Supplier Master - MBF
Parameter Name | Data Item | Data Type | Req/Opt | I/O/Both |
---|---|---|---|---|
cActionCode | ACTN | char | OPT | NONE |
A code that specifies the action that is performed. Valid values are: A Add C Change | ||||
cUpdateMasterFile | EV01 | char | OPT | NONE |
An option that specifies the type of processing for an event. | ||||
cProcessEdits | EV01 | char | OPT | NONE |
An option that specifies the type of processing for an event. | ||||
cSuppressErrorMessage | SUPPS | char | OPT | NONE |
A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function.
0 = allow
| ||||
szErrorMessageID | DTAI | char | OPT | 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
| ||||
szVersion | VERS | char | OPT | NONE |
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
| ||||
szAlternateAddressKey | ALKY | char | OPT | NONE |
A user-defined name or number that identifies an address book record. You can use this number to locate and enter information about the
| ||||
szCreditMessage | CM | char | OPT | NONE |
A value in the user defined code table 00/CM that indicates the credit status of a customer or supplier. Examples are:
1
Over credit
| ||||
szCompany | CO | char | OPT | NONE |
A code that identifies a specific organization, fund, or other reporting entity. The company code must already exist in the Company
| ||||
szAPClass | APC | char | OPT | NONE |
A code that determines the liability account in Accounts Payable that will be the offset when you post vouchers. This code might be
| ||||
szCostCenterApDefault | MCUP | char | OPT | NONE |
The business unit for the journal entry account number for a supplier (A/P).
The system uses this business unit number, the default object
| ||||
szObjectAcctsPayable | OBAP | char | OPT | NONE |
Object is a synonym for the General Ledger Account Number.
The data entry programs will use this object, plus the default subsidiary
| ||||
szSubsidiaryAcctsPayable | AIDP | char | OPT | NONE |
An accounting term referring to an account which is a subdivision of an object account. You may establish subsidiary accounts to keep
| ||||
szCompanyKeyAPModel | KCOP | char | OPT | NONE |
A number that, along with A/P Model Document Type (DTAP) and A/P Model Document Number (DCAP), uniquely identifies the model
| ||||
mnDocApDefaultJe | DCAP | MATH_NUMERIC | OPT | NONE |
A code that identifies the document number of the model journal entry to use for a particular supplier. | ||||
szDocTyApDefaultJe | DTAP | char | OPT | NONE |
A code that identifies the type of model journal entry to use for a particular supplier. | ||||
szCurrencyCodeAP | CRRP | char | OPT | NONE |
A code that indicates the currency that is used by the supplier. The system uses this code as the default currency when you enter vouchers
| ||||
szTaxArea2 | TXA2 | char | OPT | NONE |
A user-defined code that identifies a tax or geographical area that has common tax rates and tax distribution. The tax rate/area must be
| ||||
szTaxExemptReason2 | EXR2 | char | OPT | NONE |
A value in user defined code table 00/EX that controls how a tax is assessed and distributed to the general ledger revenue and expense
| ||||
cHoldPaymentCode | HDPY | char | OPT | NONE |
A code that specifies whether to hold payment of outstanding vouchers and prevent entry of new vouchers for the supplier. The hold code
| ||||
szTaxRateArea3Withholding | TXA3 | char | OPT | NONE |
A code that identifies a tax or geographical area that has common tax rates and tax distribution for withholding. The tax rate/area must be
| ||||
szTaxExplCode3Withhholding | EXR3 | char | OPT | NONE |
A user defined code (system 00, type EX) that controls how a tax is assessed and distributed to the general ledger revenue and expense
| ||||
mnTaxAuthorityAp | TAWH | MATH_NUMERIC | OPT | NONE |
A code that identifies the government agency for which you withhold taxes from supplier payments. This code must be a valid address
| ||||
mnPercentWithholding | PCWH | MATH_NUMERIC | OPT | NONE |
The rate of withholding tax retained from a payment to a supplier. This number is expressed as a decimal. For example, 20 percent is
| ||||
szPaymentTermsAP | TRAP | char | OPT | NONE |
| ||||
cMultipleChecksYN | SCK | char | OPT | NONE |
A code in PeopleSoft World software, or an option in PeopleSoft EnterpriseOne software, that indicates whether a separate payment will be
| ||||
cPaymentInstrument | PYIN | char | OPT | NONE |
| ||||
mnAddressNumberSentTo | SNTO | MATH_NUMERIC | OPT | NONE |
The address number of the individual who is authorized to approve voucher logging transactions. This address number must exist in the
| ||||
cMiscCode1 | AB1 | char | OPT | NONE |
An option that indicates whether a supplier is in a setup or complete pre-note status for electronic funds transfer (EFT). Values are:
On
| ||||
mnFloatDaysForChecks | FLD | MATH_NUMERIC | OPT | NONE |
The number of days between the check date and the bank deposit date for checks written to a supplier. The value is manually entered and
| ||||
cSequenceForLedgrInq | SQNL | char | OPT | NONE |
A code used to designate the display sequence of the default ledger in the Ledger Inquiry programs. Valid values are:
1 document
| ||||
szCurrencyCodeAmounts | CRCA | char | OPT | NONE |
The currency in which amounts are stored in the address book. For example, the credit limit, invoiced this year, invoiced prior year, and so
| ||||
mnAmountVoucheredYtd | AYPD | MATH_NUMERIC | OPT | NONE |
The amount vouchered year-to-date since the last accounts payable annual close. The system calculates this amount by accumulating the
| ||||
mnAmountVoucheredPye | APPD | MATH_NUMERIC | OPT | NONE |
The amount paid during the prior year. The system uses the total of the voucher gross amounts less any taxes. | ||||
mnAmountAddressBook | ABAM | MATH_NUMERIC | OPT | NONE |
A field that stores an amount in the Address Book system. This field has no predefined use. You can use this field to record a bank service
| ||||
mnAmount1 | ABA1 | MATH_NUMERIC | OPT | NONE |
Future use. | ||||
mnAmountOpenOrder | APRC | MATH_NUMERIC | OPT | NONE |
The total amount of open orders for a supplier or customer. The system uses the list price from the Item Location (F41021) table adjusted by
| ||||
mnRelatedAddressNo | AN8R | MATH_NUMERIC | OPT | NONE |
Use this field to relate a ship-to address to a sold-to address or vice versa.
For example, if you enter only a ship-to address in sales order
| ||||
cBillingAddressType | BADT | char | OPT | NONE |
Code that tells the system to use this address as a Sold To address, a Ship To address, or both. Valid codes are:
X Indicates a bill to and
| ||||
szRouteCode | ROUT | char | OPT | NONE |
The route field is a user defined code (system 42, type RT) that represents the delivery route on which the customer resides. This field is
| ||||
szStopCode | STOP | char | OPT | NONE |
The stop code is a user defined code (system 42, type SP) that represents the stop on a delivery route. This field is one of several factors
| ||||
szZoneNumber | ZON | char | OPT | NONE |
The zone field is a user defined code (system 40, type ZN) that represents the delivery area in which the customer resides. This field is one
| ||||
mnCarrier | CARS | MATH_NUMERIC | OPT | NONE |
The address number for the preferred carrier of the item. The customer or your organization might prefer a certain carrier due to route or
| ||||
mnLeadtimeTransit | LTDT | MATH_NUMERIC | OPT | NONE |
The number of days goods will be in transit. When a value is entered in this field, the Sales Order Processing system will subtract this value
| ||||
cBatchProcessingMode | EDPM | char | OPT | NONE |
Indicates whether a customer is prohibited from batch processing or if that customer is in a test or production mode. Valid values are:
I
| ||||
cCustomerTypeIdentifier | EDCI | char | OPT | NONE |
User defined code (system 40, type CI) that specifies the type of number to be sent in an EDI transaction, for example, DUNS number or
| ||||
cItemTypeIdentifier | EDII | char | OPT | NONE |
Code that specifies the type of item number to be sent in an EDI transaction,for example, UPC code, supplier part number, or customer part
| ||||
mnQuantityDecimals | EDQD | MATH_NUMERIC | OPT | NONE |
The number of positions to the right of the decimal that will be sent for all quantity fields in an EDI transaction for a given customer. | ||||
mnAmountDecimals | EDAD | MATH_NUMERIC | OPT | NONE |
The number of positions to the right of the decimal that will be sent for all amount fields in an EDI transaction for a given customer. | ||||
cDeliveryNote | EDF1 | char | OPT | NONE |
An option that specifies whether the system prints delivery notes for this customer on the invoice. Valid settings are:
On
The system prints
| ||||
cSpecialInst01 | VI01 | char | OPT | NONE |
The Rebate Level indicates at what organizational level the rebate system is based upon. | ||||
cSpecialInstr02 | VI02 | char | OPT | NONE |
Indicates if rebates are active. | ||||
cSpecialInst03 | VI03 | char | OPT | NONE |
Special Instruction 03 - Reserved for future use. | ||||
cSpecialInst04 | VI04 | char | OPT | NONE |
Special Instruction 04 - Reserved for future use. | ||||
cSpecialInst05 | VI05 | char | OPT | NONE |
Special Instruction 05 - Reserved for future use. | ||||
cMinimumCheckAmtCode | MNSC | char | OPT | NONE |
A code used in the Revenue Distribution System to hold payment until a minimum check amount is reached. The allowed values are from 1
| ||||
cAddTypeCode5Owner | ATO | char | OPT | NONE |
Code that indicates whether this address is an owner (Energy system).
Valid codes are:
Y Yes, this is an owner.
N No, this is not an owner.
| ||||
cRevenueNettedYN | RVNT | char | OPT | NONE |
This code is used to indicate whether revenue will be netted against accounts receivable balances when computing the check amount in
| ||||
szUserReservedCode | URCD | char | OPT | NONE |
This is a 2 position code that is reserved for the user. JDE does not currently use this field and will not utilize this field in the future. | ||||
jdUserReservedDate | URDT | JDEDATE | OPT | NONE |
This is a 6 position code that is reserved for the user. JDE does not currently use this field and will not utilize this field in the future. | ||||
mnUserReservedAmount | URAT | MATH_NUMERIC | OPT | NONE |
This is a 15 position code that is reserved for the user. JDE does not currently use this field and will not utilize this field in the future. | ||||
mnUserReservedNumber | URAB | MATH_NUMERIC | OPT | NONE |
This is a 8 position code that is reserved for the user. JDE does not currently use this field and will not utilize this field in the future. | ||||
szUserReservedReference | URRF | char | OPT | NONE |
A 15-position reference that is reserved for the user. J.D. Edwards does not currently use this field and does not plan to use it in the future. | ||||
szPriceAdjustmentScheduleN | ASN | char | OPT | NONE |
A user defined code (40/AS) that identifies a price and adjustment schedule. A price and adjustment schedule contains one or more
| ||||
mnAddressNumber | AN8 | MATH_NUMERIC | OPT | NONE |
A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or
| ||||
mnMinimumOrderValue | MINO | MATH_NUMERIC | OPT | NONE |
Value below which an order is placed on hold. If you try to enter an order whose total is less than the minimum order value, the system
| ||||
mnMaximumOrderValue | MAXO | MATH_NUMERIC | OPT | NONE |
Value above which an order is placed on hold. If you try to enter an order whose total is more than the maximum order value, the system
| ||||
szGroupCustomerPriceGp | CPGP | char | OPT | NONE |
| ||||
szOrderTemplate | ORTP | char | OPT | NONE |
A list of items that you frequently order. The items are often grouped based on the product type, such as fuels, lubricants, and packaged
| ||||
szPrintMessage1 | INMG | char | OPT | NONE |
A user defined code that you assign to each print message. Examples of text used in messages are engineering specifications, hours of
| ||||
szHoldOrdersCode | HOLD | char | OPT | NONE |
A user defined code (42/HC) that identifies why an order is on hold. | ||||
mnCarrierNumber | ANCR | MATH_NUMERIC | OPT | NONE |
The address book number of the carrier, which is specified by the customer or by your organization. You might use this carrier because of
| ||||
szDeliveryInstructLine1 | DEL1 | char | OPT | NONE |
One of two fields that you use to enter delivery instructions. | ||||
szDeliveryInstructLine2 | DEL2 | char | OPT | NONE |
The second of two fields that you use to enter delivery instructions. | ||||
szFreightHandlingCode | FRTH | char | OPT | NONE |
A user defined code (42/FR) designating the method by which supplier shipments are delivered. For example, the supplier could deliver to
| ||||
mnInvoiceCopies | INVC | MATH_NUMERIC | OPT | NONE |
The number of invoice copies required by the customer. The system prints the number of invoices specified in this field. The system
| ||||
cPricePickListYN | PLST | char | OPT | NONE |
An option that indicates whether price information appears on the customer's pick list, purchase order, or sales order. Valid values
| ||||
szUnitOfMeasureWhtDisp | WUMD | char | OPT | NONE |
A user defined code (00/UM) that identifies which unit of measure the system should use to display the weight of individual order lines and
| ||||
szUnitOfMeasureVolDisp | VUMD | char | OPT | NONE |
A user defined code (00/UM) that identifies the unit of measure that the system uses to display volume for this branch/plant. The system
| ||||
cItemRestrictions | EDF2 | char | OPT | NONE |
A code that designates whether restrictions have been placed on the sale of items to this customer.
Valid values are:
Blank No restrictions.
| ||||
szUserId | USER | char | OPT | NONE |
The code that identifies a user profile. | ||||
szProgramId | PID | char | OPT | NONE |
The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry
| ||||
szWorkStationId | JOBN | char | OPT | NONE |
The code that identifies the work station ID that executed a particular job. | ||||
cCorrespondenceMethod | CRMD | char | OPT | NONE |
A code that indicates how documents are sent to a customer or supplier. It is part of the Accounts Payable Batch Upload process, and can
| ||||
jdDateUpdated | UPMJ | JDEDATE | OPT | NONE |
The date that specifies the last update to the file record. | ||||
mnTimeLastUpdated | UPMT | MATH_NUMERIC | OPT | NONE |
The time that specifies when the program executed the last update to this record. | ||||
cCodeAutomaticVoucher | AVCH | char | OPT | NONE |
A code that indicates if an order is eligible for the evaluated receipt settlement process. An evaluated receipt settlement indicates that you
| ||||
mnAddressNumber5th | AN85 | MATH_NUMERIC | OPT | NONE |
A number in the address book that identifies a special payment address for accounts payable.
This number must exist in the Address Book
| ||||
mnAddressNumberParent | PA8 | MATH_NUMERIC | OPT | NONE |
The address book number of the parent company. The system uses this number to associate a particular address with a parent company
| ||||
cActivateVertexTaxComplia | VVTX | char | OPT | NONE |
This flag determines whether to use the Vertex Tax Compliance system for tax calculations. Values are:
Y
Use Vertex system to calculate
| ||||
szAddressType1 | AT1 | char | OPT | NONE |
A user defined code (01/ST) that specifies the kind of address book record to search for. Examples include:
E
Employees
X
Ex-employees
| ||||
szTaxId | TAX | char | OPT | NONE |
The identification code required by various tax authorities. This can be a social security number, federal or state corporate tax ID, sales tax
| ||||
szTaxId2 | TX2 | char | OPT | NONE |
An identification number assigned by a tax authority to an individual, in addition to the primary Tax ID number (TX1). | ||||
cPersonCorporationCode | TAXC | char | OPT | NONE |
A code that designates the type of taxpayer. For 1099 reporting for U.S. suppliers and foreign suppliers, the system chooses only records
| ||||
szPurchasingReportCode5 | PRP5 | char | OPT | NONE |
A user defined code (41/P5) that indicates the landed cost rule for an item.
The landed cost rule determines purchasing costs that exceed
| ||||
szAcctNoInputMode | ANI | char | OPT | NONE |
A value that identifies an account in the general ledger. Use one of the following formats to enter account numbers:
o Standard account
| ||||
MnOriginalParentNumber | PA8 | MATH_NUMERIC | OPT | NONE |
The address book number of the parent company. The system uses this number to associate a particular address with a parent company
| ||||
mnOK_To_Delete | MATH01 | MATH_NUMERIC | OPT | NONE |
- - - Good Performance Low Value. | ||||
mnSucessfullyProcessed | MATH01 | MATH_NUMERIC | OPT | NONE |
- - - Good Performance Low Value. | ||||
cDirectionIndicator | DRIN | char | OPT | NONE |
A code that indicates whether the transaction is inbound or outbound. | ||||
szVersionconsolidated | VER | char | OPT | NONE |
Identifies a specific set of data selection and sequencing settings for the application. Versions may be named using any combination of
| ||||
szCountryForPayroll | CCPR | char | OPT | NONE |
A user defined code list 00/CN that indicates the country in which the employee resides. |
None |
None |