Tags for Line Items - Intergraph Smart Materials - Version 10.1 - Help - Hexagon

Intergraph Smart Materials Classic Help

Language
English
Product
Intergraph Smart Materials
Subproduct
Classic
Search by Category
Help
Smart Materials/Smart Reference Data Version
10.1

You can insert as many line items for an order as needed.

<POLI_PROC_TYPE>

Mandatory.

Processing type.

Allowable values: I, U, and N.

'I' means that the object is to be inserted; 'U' means that an update is to be performed. ‘N’ means that the object is not processed; that is, neither inserted nor modified. However, this line item is needed to show the path for underlying objects. For example, if you have already created an order with one line item and now you want to add another item shipment, Smart Materials needs to know which order the line item belongs to and the location on the order at which to insert this additional item shipment.

<POLI_POS>

Mandatory for orders of type ‘PO’ and ‘MP’.

Optional for change orders; will be ignored if provided for a change order when referencing a previous order line item.

Order line item number.

Allowable values: 1 – 9999999.

Will be filled with the next available value if not provided for a change order when not referencing a previous order line item.

<POLI_SUB_POS>

Mandatory for orders of type ‘PO’ and ‘MP’.

Optional for change orders; will be ignored if provided for a change order when referencing a previous order line item.

Order sub line item number.

Allowable values: 0 – 99999.

Will be filled with the next available value if not provided for a change order when not referencing a previous order line item.

<IDENT_CODE>

Mandatory when inserting for an order of type ‘PO’, ‘MP’, or ‘CO’ not referencing a previous order line item and no tag number is given; also mandatory if a tag number is given but the item type does not belong to item rule ‘TAB’, ‘TFM’, ‘TOM’, ‘TWM’; not used for change orders; not to be included when updating.

Ident code for the material on the line item.

Available values: All ident codes.

<POLI_QTY>

Mandatory.

Quantity of the line item.

Allowable values: 0 – 99999999.999.

<POLI_QTY_CODE>

Mandatory.

The quantity unit for a line item.

All units that have been defined in the 'weight', 'volume', or 'quantity' unit groups are valid values.

<POLI_UNIT_PRICE>

Optional.

Unit price of the line item, including packing and discount.

Allowable values: 0 – 99999999999.9999.

The unit price is set to 0 if not included in the XML file when inserting.

<SUPPLY_PRICE>

Optional.

Supply price of the line item.

Allowable values: 0 – 99999999999.9999.

The supply price is set to 0 if not included in the XML file when inserting.

<INSTALL_PRICE>

Optional.

Install price of the line item.

Allowable values: 0 – 99999999999.9999.

The install price is set to 0 if not included in the XML file when inserting.

<POLI_CURRENCY>

Mandatory.

All currencies defined on A.10.12 Units of Measure in the 'currency' unit group are valid.

<PRICE_BASE>

Optional.

The price base can be either quantity-unit or weight-unit. If the price base is weight-unit, the costs will be calculated using the unit weight and the quantity, otherwise, only using the quantity.

Allowable values: Q and W.

‘Q’ stands for quantity-unit; ‘W’ for weight-unit. The price base is set to ‘Q’ if this tag is missing when inserting a line item.

<POLI_UNIT_WEIGHT>

Mandatory.

Supplier's suggested unit weight including packing.

Allowable values: 0 – 99999999.999.

<POLI_WEIGHT_CODE>

Mandatory.

The weight unit for a line item.

All units that have been defined in the 'weight' and 'quantity' unit groups are valid.

<POLI_VOLUME>

Optional.

Supplier's suggested unit volume including packing.

Allowable values: 0 – 99999999.999.

The volume is set to 0 if not included in the XML file when inserting.

<POLI_VOL_CODE>

Optional.

The volume unit for a line item.

All units that have been defined in the 'volume' and 'quantity' unit groups can be used.

<POLI_DIMENSIONS>

Optional.

Dimensions (x, y, and z) of a line item.

<FRT_CODE>

Optional.

Name (code) of the incoterm defined on P.10.34 Incoterms.

<FREIGHT_VALUE>

Optional.

Delivery place. New delivery places that cannot be found on P.10.37 Delivery Places are automatically added on that screen.

<POLI_COUNTRY>

Optional.

Name (code) of the country. Any country that has been defined on A.10.34 Countries/States/Provinces can be used.

<MANUFACTURER>

Optional.

Name of the manufacturer.

<CATALOG_NUMBER>

Optional.

Manufacturer's catalog number for the item being supplied.

<PERCENT_US_CONTENT>

Optional.

Percent of the product that was manufactured in the U.S.

Allowable values: 0 – 100.

If this tag was not included in the XML file, the default value of this field depends on the setting of the ZP_EXPLICR project default.

If ZP_EXPLICR is set to Y (default value), this field will be set to 0; if ZP_EXPLICR is set to N, it will be set to 100.

<TEC_PASSED_IND>

Optional.

Indicates whether the technical evaluation has been done for a line item.

Allowable values: Y, N.

Not to be included for inserts. Update is only allowed if the user owns the ‘TECHNICAL EVALUATION’ privilege. The privilege can be assigned on A.20.06.04 User Privileges.

<EXPORT_LICENSE_REQ_IND>

Optional.

Indicates whether an export license is required for this item.

Allowable values: Y, N.

If this tag was not included in the XML file, the default value of this field depends on the setting of the ZP_EXPLICR project default.

If ZP_EXPLICR is set to Y (default value), this indicator will be set to ‘Y’; if ZP_EXPLICR is set to N, it will be set to ‘N’.

<EXPORT_LICENSE_NUMBER>

Optional.

Export license number.

<EXPORT_LICENSE_RECEIVED_DATE>

Optional.

Date the export license was received. The date must not be greater than the actual date.

<POLI_ACCOUNT_CODE>

Optional.

Not to be used when working with the account code module (project default ZJ_USE_AC = Y).

Name (code) of the account code defined on A.10.30 Account Codes.

<ACCEPTED_IND>

Optional.

This indicator is set if the user has checked the quantity of the line item and wants it to be approved as it is. If you are working with the P.50.16 Maintain Orders screen, this check box has to be checked for all line items of an order supplement. Otherwise, you will not be able to approve the order. If you do not use the P.50.16 screen, the setting of this check box is not relevant. You will be allowed to approve an order independently of this indicator.

Allowable values: Y, N.

The indicator is set to ‘N’ if it is missing in the XML file when inserting a line item.

<TAG_NUMBER>

Optional.

Mandatory if the item rule of the ident code is ‘SWT’ when inserting a line item; must not be included when updating a line item.

Tag number for a specific ident.

The tag number is set to the default value ‘---’ if it is not included in the XML file when inserting a line item.

<ITY_CODE>

Optional.

Needed to create idents/tags for item types of rule ‘TAB’, ‘TFM’, ‘TOM’, ‘TWM’ when inserting an order line item on an order of type ‘PO’ or ‘MP’.

Allowable values: All item types defined on A.10.15 Item Types.

<LAYOUT_SHORT>

Optional.

This tag shows the short description of the commodity code.

<LAYOUT_LONG>

Optional.

This tag shows the long description of the commodity code.

<PROM_CONTR_DATE>

Optional.

Promised contract date that will be taken over to item shipments.

<PARENT_POLI>

Mandatory when inserting line items on a change order that were already included in one of the previous supplements; not to be included in any other cases.

Primary key of the line item that is to be replaced. If another change order already exists, this key may either be the primary key of the original line item or the primary key of the line item on the change order.

Instead of this tag, you can also use the <PARENT_POLI_POS> and <PARENT_POLI_SUB_POS> tags if you are not able to determine the value for <PARENT_POLI>.

For retrieving the primary key of an order line item, the poli_id function has been provided in the m_pck_uk package.

If a negative value is returned, the order line item cannot be found.

Specification of the function:

Argument Name Type In/Out

P_PROJ_ID m_po_line_items.proj_id IN

P_POH_ID m_po_line_items.poh_id IN

P_POLI_POS m_po_line_items.poli_pos IN

P_POLI_SUB_POS m_po_line_items.poli_sub_pos IN

<PARENT_POLI_POS>

Optional when inserting a line item on a change order; not used in any other cases.

This tag is needed if you do not use the <PARENT_POLI> tag.

Position of the line item on the parent order that is to be referenced by the new change order line item.

<PARENT_POLI_SUB_POS>

Optional when inserting a line item on a change order; not used in any other cases.

This tag is needed if you do not use the <PARENT_POLI> tag.

Sub-position of the line item on the parent order that is to be referenced by the new change order line item.

<REQ_LINE_ITEM>

Optional. Primary key of any requisition line item that has been released to procurement, can be used for purchase, and belongs to the same project as the order.

Instead of this tag, you can also use the <R_CODE>, <R_SUPP>, <R_ORIGIN_CODE>, <R_ACTUAL_IND>, <RLI_POS>, and <RLI_SUB_POS> tags if you are not able to determine the value for <REQ_LINE_ITEM>.

For retrieving the primary key of a requisition line item, the rli_id and r_id functions have been provided in the m_pck_uk package.

If a negative value is returned, the requisition or requisition line item cannot be found.

Specification of function rli_id:

Argument Name Type In/Out

P_PROJ_ID m_req_line_items.proj_id IN

P_R_ID m_req_line_items.r_id IN

P_RLI_POS m_req_line_items.rli_pos IN

P_RLI_SUB_POS m_req_line_items.rli_sub_pos IN

Specification of function r_id:

Argument Name Type In/Out

P_PROJ_ID m_reqs.proj_id IN

P_ORIGIN_CODE m_origins.origin_code IN

P_R_CODE m_reqs.r_code IN

P_R_SUPP m_reqs.r_supp IN

P_ACTUAL_IND m_reqs.actual_ind IN

<R_CODE>

Optional. This tag is needed if you do not use the <REQ_LINE_ITEM> tag, but want to reference a requisition order line item.

Name (code) of the engineering requisition where the requisition line item being referenced belongs.

<R_SUPP>

Optional. This tag is needed if you do not use the <REQ_LINE_ITEM> tag, but want to reference a requisition order line item.

Supplement of the engineering requisition where the requisition line item being referenced belongs.

<R_ORIGIN_CODE>

Optional.

This tag is needed if you do not use the <REQ_LINE_ITEM> tag, but want to reference a requisition order line item.

Origin of the engineering requisition where the requisition line item being referenced belongs.

<R_ACTUAL_IND>

Optional. This tag is needed if you do not use the <REQ_LINE_ITEM> tag, but want to reference a requisition order line item.

Indicates whether the engineering requisition can be used for inquiries only (= ’N’) or for purchasing (= ‘Y’), too.

<RLI_POS>

Optional.

This tag is needed if you do not use the <REQ_LINE_ITEM> tag, but want to reference a requisition order line item.

Position of the requisition line item that is to be referenced.

<RLI_SUB_POS>

Optional.

This tag is needed if you do not use the <REQ_LINE_ITEM> tag, but want to reference a requisition order line item.

Sub-position of the requisition line item that is to be referenced.

<POLI_SPLIT_TAG>

This tag is needed if you want a detail tag to be created for a master tag.

You just have to include this tag; a value is not needed. This tag is only analyzed if the processing type of the line item is ‘U’.

In the case of order line items, you can either update the item or create a detail tag. Performing both actions at the same time is not possible.

For more information, see Split Tag with an OPI XML Import.

For more information about split tag, see Split Tags.