IVItemMasterType

Description

An eConnect transaction type that describes an inventory item.

XML nodes

• <taUpdateCreateItemRcd>*
• <taUpdateCreateItemCurrencyRcd>*
• <taIVCreateItemPriceListLine>*
• <taIVCreateItemPriceListHeader>*
• <taItemSite>*
• <taCreateItemVendors>*
• <taCreateKitItemRcd>
• <taCreateInternetAddresses>

   

  Remarks

  Create a new item record       The <taUpdateCreateITemRcd> XML node allows you to create new item records from the IV Item Master schema. Complete the following steps to create a new item record:

  1. Populate the required fields.

     The ITEMNMBR and ITEMDESC elements are required. The UOMSCHDL element is also required unless it is provided by the item class.

     2. Set UpdateIfExists.

        The UpdateIfExists element can be set to one or zero to create a new item.

        3. Set UseItemClass.

           Set the UseItemClass element to 0 to use only the element values specified by the <taUpdateCreateItemRcd> XML node. Elements not specified by the <taUpdateCreateItemRcd> XML node use the default values supplied by Microsoft Dynamics GP.

           Set the UseItemClass element to 1 to use an item class as a source for default values. If UseItemClass is set to 1, you must specify the item class ID in the ITMCLSCD element. The item class provides default values for elements not specified by the <taUpdateCreateItemRcd> XML node. If the item class does not provide an element with at default value, the item record uses the default value supplied by Microsoft Dynamics GP.

           Update an item record    The <taUpdateCreateITemRcd> XML node allows you to update an existing item record from the IV Item Master schema. Complete the following steps to update an item record:

           1. Populate the required fields.

              The ITEMNMBR element is required.

              2. Set UpdateIfExists.

                 The UpdateIfExists element must be set to one.

                 3. Set UseItemClass.

                    Set the element UseItemClass to 0 to update only the elements specified by the <taUpdateCreateItemRcd> XML node. The XML node should include only the elements that have updated values. Elements that are excluded from the XML node or that supply a null value, retain their existing value.

                    Set the UseItemClass element to 1 to use default values provided by an item class. In an update, you may choose whether or not to supply a item class ID in the ITMCLSCD element.

                    If you specify an item class ID in the ITMCLSCD element, updates to elements use the following rules:

                    • Elements set by the <taUpdateCreateItemRcd> XML node are always used. The specified value overrides any value supplied by the item class.
                    • Elements excluded from the XML node or set to null use the values specified by the item class.
                    • Elements excluded from the XML node or set to null and not included in the item class always retain their existing value.

                      If you do not specify an item class ID in the ITMCLSCD element, the <taUpdateCreateItemRcd> XML node updates only the elements specified by the XML node. Elements that are excluded from the XML node or that supply a null value, retain their existing value.

                      Document structure

                      <eConnect>
                      	<IVItemMasterType>
                      		<eConnectProcessInfo />
                      		<taRequesterTrxDisabler_Items>
                      			<taRequesterTrxDisabler />
                      		</taRequesterTrxDisabler_Items>
                      		<taUpdateCreateItemRcd />
                      		<taUpdateCreateItemCurrencyRcd_Items>
                      			<taUpdateCreateItemCurrencyRcd />
                      		</taUpdateCreateItemCurrencyRcd_Items>
                      		<taIVCreateItemPriceListLine_Items>
                      			<taIVCreateItemPriceListLine />
                      		</taIVCreateItemPriceListLine_Items>
                      		<taIVCreateItemPriceListHeader />
                      		<taItemSite_Items>
                      			<taItemSite />
                      		</taItemSite_Items>
                      		<taCreateItemVendors_Items>
                      			<taCreateItemVendors />
                      		</taCreateItemVendors_Items>
                      		<taCreateKitItemRcd_Items>
                      			<taCreateKitItemRcd />
                      		</taCreateKitItemRcd_Items>
                      		<taCreateInternetAddresses_Items>
                      			<taCreateInternetAddresses />
                      		</taCreateInternetAddresses_Items>
                      	</IVItemMasterType>
                      </eConnect>
                      
                      

                      See also

                      • <eConnectProcessInfo>
                      • <taRequesterTrxDisabler>

                         

                        ---

                        Documentation Feedback
                        
                        

                        ---