GetF4201OrderInfo

Get F4201 Order Info

Minor Business Rule

Object Name: B4200200

Parent DLL: CDIST

Location: Client/Server

Language: C

This Business Function Retrieves TKBY (Order Taken By) From F4201 (Sales Order header) using Order 
Number,Order Type, Key Company and Order Suffix as the key . It returns 4810 as the error code if no 

record is found.


The parameters for this function are:

DOCO   Order Number                                             INPUT

DCTO    Order Type                                                   INPUT

KCOO    Key Company                                             INPUT

TKBY     Taken By                                                     OUTPUT 

DTAI       Error Message ID                                     OUTPUT

EV01      Suppress Error Message                       INPUT

SFXO     Order Suffix                                               INPUT

Data Structure

D4200200 - Get F4201 Order Info

Special Input Expected
DELETE THIS SECTION IF IT DOES NOT APPLY.


Special Output Returned

DELETE THIS SECTION IF IT DOES NOT APPLY.


Significant Data Values

x - xxxxxxxxxxxxx

x - xxxxxxxxxxxxx

x - xxxxxxxxxxxxx

DELETE THIS SECTION IF IT DOES NOT APPLY.



^

Parameter NameData ItemData TypeReq/OptI/O/Both
mnOrderNumberDOCOMATH_NUMERICNONENONE

A number that identifies an original document. This document can be a voucher, a sales order, an invoice, unapplied cash, a journal entry, 
and so on.

szOrderTypeDCTOcharNONENONE

A user defined code (00/DT) that identifies the type of document. This code also indicates the origin of the transaction. J.D. Edwards has 
reserved document type codes for vouchers, invoices, receipts, and time sheets, which create automatic offset entries during the post 
program. (These entries are not self-balancing when you originally enter them.) The following document types are defined by J.D. Edwards and 
should not be changed: P Accounts Payable documents   R Accounts Receivable documents   T Payroll documents   I Inventory documents  
O Purchase Order Processing documents   J General Accounting/Joint Interest Billing documents   S Sales Order Processing documents

szKeyCompanyKCOOcharNONENONE

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.

szTakenByTKBYcharNONENONE

SALES ORDER SYSTEM:  An optional entry field, intended for the name of the individual taking the customer's order. If you do not enter a 
user ID in this field, the system uses the ID of the person who is signed on.

szErrorMesgIDDTAIcharNONENONE

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 
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

cSuppressErrorMesgEV01charNONENONE

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

mnOrderTotalOTOTMATH_NUMERICNONENONE

The total value of all lines on the order that have not been shipped and billed to the customer.

mnForeignOrderTotalFAPMATH_NUMERICNONENONE

The unpaid foreign amount of a transaction.

szCompanyCOcharNONENONE

A code that identifies a specific organization, fund, or other reporting entity. The company code must already exist in the Company 
Constants table (F0010) and must identify a reporting entity that has a complete balance sheet. At this level, you can have intercompany 
transactions. Note: You can use company 00000 for default values such as dates and automatic accounting instructions. You cannot use company 00000 
for transaction entries.

szCustomerPOVR01charNONENONE

An alphanumeric value used as a cross-reference or secondary reference number. Typically, this is the customer number, supplier 
number, or job number.

szHoldCodeHOLDcharNONENONE

A user defined code (42/HC) that identifies why an order is on hold.

mnSoldToAddrNumberAN8MATH_NUMERICNONENONE

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

mnShipToAddrNumberSHANMATH_NUMERICNONENONE

The address number of the location to which you want to ship this order. The address book provides default values for customer address, 
including street, city, state, zip code, and country.

szPaymentTermsCodePTCcharNONENONE

A code that specifies the terms of payment, including the percentage of discount available if the invoice is paid by the discount due date. 
Use a blank code to indicate the most frequently-used payment term. You define each type of payment term on the Payment Terms Revisions 
form. Examples of payment terms include: Blank Net 15 001      1/10 net 30 002      2/10 net 30 003      Due on the 10th day of every month 006     
Due upon receipt  This code prints on customer invoices.

szDisplayWeightUOMWUMDcharNONENONE

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 
the order as a whole for this customer when you use the order summary form.

szDisplayVolumeUOMVUMDcharNONENONE

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 
inputs a value in this field from Branch/Plant Constants - Page 2 (P410012). You can override this default value.

szBranchPlantMCUcharNONENONE

An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit 
might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for 
purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by 
business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units 
for which you have no authority.

szCurrencyCodeFromCRCDcharNONENONE

A code that identifies the currency of a transaction. 

mnCurrencyConvRateCRRMATH_NUMERICNONENONE

A number (exchange rate) that a foreign currency amount is multiplied by to calculate a domestic currency amount.  The number in this field 
can have a maximum of seven decimal positions. If more are entered, the system adjusts to the nearest seven decimal positions. 

szTaxArea1TXA1charNONENONE

A code that identifies a tax or geographic area that has common tax rates and tax authorities. The system validates the code you enter 
against the Tax Areas table (F4008). The system uses the tax rate area in conjunction with the tax explanation code and tax rules to calculate tax 
and G/L distribution amounts when you create an invoice or voucher.

szTaxExplanationCode1EXR1charNONENONE

A hard-coded user defined code (00/EX) that controls the algorithm that the system uses to calculate tax and G/L distribution amounts. The 
system uses the tax explanation code in conjunction with the tax rate area and tax rules to determine how the tax is calculated. Each 
transaction pay item can be defined with a different tax explanation code.

szVendorReference2VR02charNONENONE

A field available to record reference numbers, such as the supplier's bid document number, quote document, sales order, work order, or 
job number.

cBackOrderedYNBACKcharNONENONE

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

jdRequestedDateDRQJJDEDATENONENONE

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

jdTransactionDateTRDJJDEDATENONENONE

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

jdPromisedDelDatePDDJJDEDATENONENONE

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

mnCarrierNumberCARSMATH_NUMERICNONENONE

The address number for the preferred carrier of the item. The customer or your organization might prefer a certain carrier due to route or 
special handling requirements.

mnBuyerNumberANBYMATH_NUMERICNONENONE

The address book number that identifies who is responsible for setting up and maintaining the correct stocking levels for each inventory 
item.

szRouteCodeROUTcharNONENONE

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 
one of several factors used by the freight summary facility to calculate potential freight charges for an order. For picking, use the route code with 
the stop and zone codes to group all of the items that are to be loaded onto a delivery vehicle for a specific route. You set up a default for 
each of these fields on the Customer Billing Instruction form.

szStopCodeSTOPcharNONENONE

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 
used by the freight summary facility to calculate potential freight charges for an order. For picking, you can use the stop code with the route and 
zone codes to group all items that are to be loaded onto a delivery vehicle for a specific route. You set up the default for each of these fields 
on the Customer Billing Instructions form.

szZoneNumberZONcharNONENONE

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 
of several factors used by freight summary facility to calculate potential freight charges for an order. For picking you can use the zone code 
with the route and stop codes to group all item that are to be loaded onto a delivery vehicle for a specific route. You set up the default for each 
of these fields on the Customer Billing Instructions form.

mnTradeDiscountTRDCMATH_NUMERICNONENONE

Percentage by which the system reduces the price of each item. This is the only discount that will be applied. You can override it if you 
enter a price. Enter the percentage as a whole number (that is, 5 for 5%).

mnCommissionCode1CMC1MATH_NUMERICNONENONE

The first of two eight-character codes used to designate the salespeople who should receive credit for a sale to the customer.  This code is 
first created in either the Address Book or through the Related Salespersons program.

mnCommissionCode2CMC2MATH_NUMERICNONENONE

The second of two eight-character codes used to designate the salespeople who should receive credit for a sale to the customer.  This 
code is first created in either the Address Book or through the Related Salespersons program.

mnCommissionRate1CMR1MATH_NUMERICNONENONE

The first of two percentages to be applied to either the gross sales amount or the gross margin for an order or order line in computing your 
commission liability.  This percent can default from Billing Instructions or be entered directly to the order.

mnCommissionRate2CMR2MATH_NUMERICNONENONE

The second of two commission percentages to be applied to either the gross sales amount or the gross margin for an order or order line in 
computing your commission liability. This percent can come in from the Billing Instructions or be entered in the sales order.

jdOriginalPromiseDateOPDJJDEDATENONENONE

The original promised delivery date for a purchase order.

cSubstitutesAllowedYNSBALcharNONENONE

Code associated with each customer specifying whether that customer will accept substitute items.  Enter N to disallow or Y to allow 
substitutions. The system will interpret a blank value as a Y.

cPriorityProcessingPRIOcharNONENONE

A code that tells the system to handle this customer's orders on a priority basis. Use this value to set up print pick slips so you can choose 
to print them on a priority basis. This code is assigned from the Customer Billing Instructions. In addition, the backorder print report and 
automatic batch release program can be sequenced by this code to release those orders with the highest priority first.

szPrintMesgINMGcharNONENONE

A user defined code that you assign to each print message. Examples of text used in messages are engineering specifications, hours of 
operation during holiday periods, and special delivery instructions.

szTaxExemptionCodeTXCTcharNONENONE

The number that tax authorities issue to tax-exempt individuals and companies to identify their tax-exempt status.

szDeliveryInstrns1DEL1charNONENONE

One of two fields that you use to enter delivery instructions.

szDeliveryInstrns2DEL2charNONENONE

The second of two fields that you use to enter delivery instructions.

szFreightHandlingCodeFRTHcharNONENONE

A user defined code (42/FR) designating the method by which supplier shipments are delivered. For example, the supplier could deliver to 
your dock, or you could pick up the shipment at the supplier's dock. You can also use these codes to indicate who has responsibility for 
freight charges. For example, you can have a code indicating that the customer legally takes possession of goods as soon as they leave the 
supplier warehouse and is responsible for transportation charges to the destination.

mnJobNumberJOBSMATH_NUMERICOPTNONE

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

szComputerIDCTIDcharOPTNONE

mnProcessIDPEIDMATH_NUMERICOPTNONE

A code that identifies the Inter-Process Communication ID.

mnTransactionIDTCIDMATH_NUMERICOPTNONE

mnFutureUse3NumericCFS3MATH_NUMERICOPTNONE

mnFutureUse3Numeric_2CFS3MATH_NUMERICOPTNONE

mnFutureUse3Numeric_3CFS3MATH_NUMERICOPTNONE

mnFutureUse3Numeric_4CFS3MATH_NUMERICOPTNONE

mnRequestedDeliveryTimeDRQTMATH_NUMERICOPTNONE

The time requested for delivery. Enter the time using the 24-hour time format (HHMMSS). For example, enter 6:00 a.m. as 060000, and enter 
7:00 p.m. as 190000.

mnPromisedPickTimePDTTMATH_NUMERICOPTNONE

The time when the order is scheduled to be picked. Enter the time in the 24-hour format and include a leading zero if necessary. For 
example, enter 6:00 a.m. by typing 060000 and enter 7:00 p.m. by typing 190000.

Related Functions

None

Related Tables

F4201 Sales Order Header File
F42019 Sales Order Header History File