PMVendorMasterType

Description

An eConnect docuement that describes a vendor.

XML nodes

• <taUpdateCreateVendorRcd>*
• <taCreateVendorAddress>*
• <taCreateInternetAddresses>
• <taUpdateCreatePAVendorRcd>*

Remarks

Create a New Vendor Record The <taUpdateCreateVendorRcd> XML node allows you to create a new vendor record from the PM Vendor Master schema. Complete the following steps to create a vendor record:

1. Populate the required elements.

   The vendor ID (VENDORID) and vendor name (VENDNAME) elements are required.

2. Set the UpdateIfExists element.

   To create a new vendor, set the UpdateIfExists element one or zero.

3. Set UserVendorClass.

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

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

Update a Vendor Record The <taUpdateCreateVendorRcd> XML node allow you to update an existing vendor record from the PM Vendor Master schema. Complete the following steps to update a vendor record:

1. Populate the required fields.

   The VENDORID element is required.

2. Set UpdateIfExists.

   The UpdateIfExists element must be set to one.

3. Set UseVendorClass.

   Set the UseVendorClass element to 0 to update only the elements specified by the <taUpdateCreateVendorRcd> 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 UseVendorClass element to 1 to use default value provided by a vendor class. In an update, you may choose whether or not to supply a vendor class ID in the VNDCLSID element.

   If you specify a vendor class ID in the VNDCLSID element, updates to elements use the following rules:

   • Element values set by the <taUpdateCreateVendorRcd> XML node are always used. The specified values override any values supplied by the vendor class.

   • Elements excluded from the XML node or set to null use the values specified by the vendor class.

   • Elements excluded form the XML node or set to null and not included in the vendor class always retain their existing value.

   If you do not specify a vendor class ID in the VNDCLSID element, the <taUpdateCreateVendorRcd> 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>
    <PMVendorMasterType>
        <eConnectProcessInfo />
        <taRequesterTrxDisabler_Items>
            <taRequesterTrxDisabler />
        </taRequesterTrxDisabler_Items>
        <taUpdateCreateVendorRcd />
        <taCreateVendorAddress_Items>
            <taCreateVendorAddress />
        </taCreateVendorAddress_Items>
        <taCreateInternetAddresses_Items>
            <taCreateInternetAddresses />
        </taCreateInternetAddresses_Items>
        <taUpdateCreatePAVendorRcd />
    </PMVendorMasterType>
</eConnect>

See also

• <eConnectProcessInfo>
• <taRequesterTrxDisabler>