UpdateItemBranchRecord

F4102 Update Item Branch Record

Major Business Rule

Object Name: B4100840

Parent DLL: COPBASE

Location: Client/Server

Language: C


Data Structure

D4100840 - F4102 Update Item Branch Record

Parameter NameData ItemData TypeReq/OptI/O/Both
mnShortItemNumberITMMATH_NUMERICNONENONE

An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item 
numbers (see data item XRT) to accommodate substitute item numbers, replacements, bar codes, customer numbers, supplier numbers, and 
so forth. The item numbers are as follows:   o Item Number (short) - An eight-digit, computer-assigned item number     o 2nd Item Number - The 
25-digit, free-form, user defined alphanumeric item number     o 3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item 
number

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.

cActionCodeACTNcharNONENONE

A code that specifies the action that is performed. Valid values are: A Add C Change

cErrorCodeERRcharNONENONE

The Data Field Error Code field is simply a generic data field to pass an error condition flag.  This field is one of the fields that make up the 
external parameter data structure of the Data Dictionary Server.

cCopyModeEV01charNONENONE

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

cSuppressErrorMsgEV01charNONENONE

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

szErrorMessageIDDTAIcharNONENONE

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.

cStockingTypeSTKTcharNONENONE

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

szLineTypeLNTYcharNONENONE

A code that controls how the system processes lines on a transaction. It controls the systems with which the transaction interfaces, such as 
General Ledger, Job Cost, Accounts Payable, Accounts Receivable, and Inventory Management. It also specifies the conditions under 
which a line prints on reports, and it is included in calculations. Codes include the following: S Stock item   J Job cost   N Nonstock item   F Freight  
T Text information   M Miscellaneous charges and credits   W Work order

szGLCategoryGLPTcharNONENONE

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

szSalesCatalogSectionSRP1charNONENONE

One of ten category codes for sales coding purposes. These codes can represent such classifications as color, material content, or use.

szSubSectionSRP2charNONENONE

One of ten category codes for sales coding purposes. These codes can represent such classifications as color, material content, or 
use. This field represents one of ten property type categories available for sales purposes.

szSalesCategoryCode3SRP3charNONENONE

One of ten category codes for sales coding purposes. These codes can represent such classifications as color, material content, or use.

szSalesCategoryCode4SRP4charNONENONE

One of ten category codes to be used for sales coding purposes. These codes can represent such classifications as color, material 
content, or use.

szSalesCategoryCode5SRP5charNONENONE

One of ten category codes to be used for sales coding purposes.  These codes can represent such classifications as color, material 
content, or use.

szCommodityClassPRP1charNONENONE

A code (table 41/P1) that represents an item property type or classification,such as commodity type, planning family, or so forth. The 
system uses this code to sort and process like items. This field is one of six classification categories available primarily for purchasing purposes.

szCommoditySubClassPRP2charNONENONE

A code (table 41/P2) that represents an item property type or classification,such as commodity type, planning family, or so forth. The 
system uses this code to sort and process like items. This field is one of six classification categories available primarily for purchasing purposes.

szVendorRebateCodePRP3charNONENONE

A code (UDC table 41/P3) that represents an item property type or classification, such as commodity type, planning family, or so forth. The 
system uses this code to sort and process like items. This field is one of six classification categories available primarily for purchasing 
purposes.

szMasterPlanningFamilyPRP4charNONENONE

A user defined code (41/P4) that represents an item property type or classification, such as commodity type or planning family. The system 
uses this code to sort and process like items. This field is one of six classification categories available primarily for purchasing purposes.

szPurchasingCategoryCode5PRP5charNONENONE

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.

mnBuyerNumberBUYRMATH_NUMERICNONENONE

The address number of the person responsible for setting up and maintaining the correct stocking levels for the item.

mnLeadtimeLevelLTLVMATH_NUMERICNONENONE

A value that represents the leadtime for an item at its assigned level in the production process, as defined on Plant Manufacturing Data. 
The system uses this value to calculate the start dates for work orders using fixed leadtimes. Level leadtime is different for purchased and 
manufactured items: Purchased - The number of calendar days required for the item to arrive at your branch/plant after the supplier receives your 
purchase order. Manufactured - The number of workdays required to complete the fabrication or assembly of an item after all the 
components are available. You can enter level leadtime manually on Manufacturing Values Entry, or you can use the Leadtime Rollup program to 
calculate it. To calculate level leadtime using the Leadtime Rollup program, you must first enter a quantity in the Manufacturing Leadtime Quantity 
field in the Item Branch table (F4102).

mnPlannerNumberANPLMATH_NUMERICNONENONE

The address number of the material planner for this item.

cOrderPolicyCodeOPCcharNONENONE

A code that specifies the rules for inventory reordering in the Requirements Planning and Procurement systems. Valid values are: 0 Reorder 
point (Not planned by MPS/MRP/DRP) 1    Lot-for-lot or as required 2    Fixed order quantity 3 Economic order quantity (EOQ) 4 Periods of 
supply 5 Rate scheduled item Note: These values are hard-coded.

cIssueTypeCodeITCcharNONENONE

A code that indicates how the system issues each component in the bill of material from stock. In Shop Floor Management, it indicates how 
the system issues a part to a work order. Valid values are:    I Manual issue    F Floor stock (there is no issue)    B Backflush (when the part is 
reported as complete)    P Preflush (when the parts list is generated)    U Super backflush (at the pay-point operation)    S Sub-contract item (send 
to supplier)    Blank Shippable end item  You can issue a component in more than one way within a specific branch/plant by using different 
codes on the bill of material and the work order parts list. The bill of material code overrides the branch/plant value.

szInventoryPricingRulePRGRcharNONENONE

A user defined code (system 40/type PI) that identifies an inventory price group for an item. Inventory price groups have unique pricing 
structures that direct the system to incorporate discounts or markups on items on sales and purchase orders. The discounts or markups are 
based on the quantity, dollar amount, or weight of the item ordered. When you assign a price group to an item, the item takes on the same pricing 
structure defined for the inventory price group. You must assign an inventory price group to the supplier or customer, as well as to the item, for 
the system to interactively calculate discounts and markups on sales orders and purchase orders.

szRepriceRuleRPRCcharNONENONE

You can assign items with common repricing characteristics to a reprice category on Item Branch/Plant Revisions. You can define different 
categories based on location. Repricing is a technique that the system uses to:     o Accumulate items on order that belong to a common 
repricing category during a batch program     o Compare the aggregate quantities of items on order to the appropriate quantity breaks in the 
reprice category  If the items qualify for an additional discount, that discount is reflected as a change in unit and extended price for each 
qualifying item in the original order line.

szOrderRepriceRuleORPRcharNONENONE

Items with common order repricing characteristics are assigned to an order reprice category on the Item Master Revisions screen. 
Categories can be varied at the Location level (fold area). Order repricing is a technique in which items within an order that belong to the same 
repricing category are accumulated during a batch program and their aggregate quantities are compared to the appropriate quantity "breaks" in 
the reprice category. Typical quantity breaks in this situation might be the total weight or the total dollar value of the order as whole. If the 
items qualify for additional discount, that discount is reflected as a flat dollar amount in a new discount line. This facility supplements the repricing 
function and operates in the same batch program.

szShippingConditionsCodeSHCNcharNONENONE

A code (table 41/C) that represents an item property type or classification,such as special shipping conditions. The system uses this code 
to sort and process like items. This field is one of three classification categories available primarily for inventory and shipping purposes.

szShippingCommodityClassSHCMcharNONENONE

A user defined code (41/E) that represents an item property type or classification (for example, international shipment handling). The 
system uses this code to sort and process similar items. This field is one of three classification categories available primarily for inventory and 
shipping purposes.

szCycleCountCategoryCYCLcharNONENONE

A code (table 41/8) that represents the family or cycle in which an item is counted. Cycle counting means that you count different inventory 
items at different times. Cycle codes commonly represent item values, item locations, time frames, or product groups.

cBackordersAllowedBACKcharNONENONE

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.

szPrintMessageINMGcharNONENONE

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.

cABCCode1ABCScharNONENONE

A code that specifies this item's ABC ranking by sales amount. Valid values are:    A Assign this item to the first (largest) amount ranking    B 
Assign this item to the second (intermediate) amount ranking    C Assign this item to the third (smallest) amount ranking    D Do not include this 
item when you run ABC Analysis There are three types of ABC analysis-sales, margin, and on-hand value. Within each type of analysis, you 
can have three groups-A, B, and C. The ABC Code fields contain a percentage that tells the system how to define the A, B, and C groups for 
categorizing items during ABC analysis. Each group measures a total within the type of analysis. For all groups, the system compares the 
appropriate sales, margin, or on-hand value totals of a single item to the appropriate total for all items and calculates the value of each item. An 
item's value is its percentage of the appropriate total. The system then arranges the values of all items from highest to lowest value and 
accumulates the percentages. What happens next depends on the group:    A group: If an item's value causes the accumulated total to exceed the 
A accumulated percentage, the system assigns the item to the B group.    B group: When the accumulated total reaches the percentage you 
entered for items in the A group, it continues adding values until it reaches the percentage you entered for items in the B group. The system 
assigns all items whose value falls between the A and B percentages to the B group.    C group: The C group consists of items whose 
accumulated value exceeds the B percentage. The percentage that you usually enter for the C group is .999.

cABCCode2ABCMcharNONENONE

Code indicating this item's ABC ranking by margin amount. Valid values are:    A Assign this item to the first amount ranking    B Assign this 
item to the second amount ranking    C Assign this item to the third amount ranking    D Skip this item in the ABC Analysis There are three types of 
ABC analysis--sales, margin, and on-hand value. Within each type of analysis, you can have three groups--A, B, and C. The ABC Code fields 
contain a percentage that tells the system how to define the A, B, and C groups for categorizing items during ABC analysis. Each group 
measures a total within the type of analysis. For all groups, the system compares the appropriate sales, margin, or on-hand value totals of a 
single item to the appropriate total for all items and calculates the value of each item. An item's value is its percentage of the appropriate total. 
The system then arranges the values of all items from highest value to lowest value and accumulates the percentages. What happens next 
depends on the group:    A group: When the accumulated total reaches the percentage you entered, the system assigns the items whose values 
are included in the A group. If an item's value causes the total to exceed the A accumulated percentage, the system assigns the item to the B 
group.    B group: When the accumulated total reaches the percentage you entered, the system assigns the items whose values are 
included in the A group. If an item's value causes the total to exceed the A accumulated percentage, the system assigns the item to the B group.    C 
group: The C group consists of items whose accumulated value exceeds the B percentage. The percentage that you usually enter for the C 
group is .999.

cABCCode3ABCIcharNONENONE

Code indicating this item's ABC ranking by investment in inventory. Valid values are:    A Assign this item to the first amount ranking    B 
Assign this item to the second amount ranking    C Assign this item to the third amount ranking    D Skip this item in the ABC Analysis There are three 
types of ABC analysis--sales, margin, and on-hand value. Within each type of analysis, you can have three groups--A, B, and C. The ABC 
Code fields contain a percentage that tells the system how to define the A, B, and C groups for categorizing items during ABC analysis. Each 
group measures a total within the type of analysis. For all groups, the system compares the appropriate sales, margin, or on-hand value totals 
of a single item to the appropriate total for all items and calculates the value of each item. An item's value is its percentage of the appropriate 
total. The system then arranges the values of all items from highest value to lowest value and accumulates the percentages. What 
happens next depends on the group:    A group: When the accumulated total reaches the percentage you entered, the system assigns the items 
whose values are included in the A group. If an item's value causes the total to exceed the A accumulated percentage, the system assigns the 
item to the B group.    B group: When the accumulated total reaches the percentage you entered for items in the A group, it continues adding 
values until it reaches the percentage you entered for items in the B group. The system assigns all items whose value falls between the A and 
B percentages to the B group.    C group: The C group consists of items whose accumulated value exceeds the B percentage. The 
percentage that you usually enter for the C group is .999.

cABCOverrideIndicatorOVRcharNONENONE

Maintained automatically by the program, a value here indicates that one or more aspects of an individual item's ABC classification has 
been changed by a user from the codes generated by the ABC analysis program.

sz2ndItemNumberLITMcharNONENONE

A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to 
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A 
25-digit, user defined, alphanumeric item number. 3rd Item Number  Another 25-digit, user defined, alphanumeric item number. In addition to 
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous 
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or 
supplier numbers.

sz3rdItemNumberAITMcharNONENONE

The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item 
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned item number. 2.  2nd Item Number - The 25-digit, free-form, user 
defined alphanumeric item number. 3.  3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item number.  In addition to 
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to 
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier 
numbers.

szBranchPlantToCopyMCUFcharNONENONE

The lowest value of the range a given user is authorized to view and process data. It is used in conjunction with the Business Unit Through 
Code which defines highest value. If no record exists for a user and file, the user is completely authorized to the file. If the file name is blank for 
a given user, the Business Unit range setup applies to all users of the file.

szProgramIDPIDcharNONENONE

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.

Related Functions

B0000130 Retrieve Company From Business Unit
B4000150 Get Branch Constants
B9800100 Get Audit Information
X4101 Validate and Retrieve Item Master

Related Tables

F4101 Item Master
F4102 Item Branch File