PrintMultiple Item Price and Availability

Multiple Item Price and Availability Submit DTD

To obtain the price and availability of multiple items.  The availability that is returned is corporate availability across all warehouses.  The price this is returned is your contract price with Tech Data for commercial resale. 

The following DTD defines the Multiple Item Price and Availability Submit document:

  <!ELEMENT XML_MultiPriceAvailability_Submit (
      Header ,
      Detail ) >

    <!ELEMENT   Header (
                UserName ,
                Password ,
                TransControlID? ,
                ResponseVersion? ) >

        <!ELEMENT UserName                          (#PCDATA) >
        <!ELEMENT Password                          (#PCDATA) >
        <!ELEMENT TransControlID                    (#PCDATA) >
        <!ELEMENT ResponseVersion                   (#PCDATA) >

        <!ELEMENT Detail ( LineInfo+ ) >
            <!ELEMENT LineInfo (
                      AssignedID? ,
                      OrderLevel? ,
                      RefIDQual ,
                      RefID ) >

                <!ELEMENT AssignedID                (#PCDATA) >
                <!ELEMENT OrderLevel                (#PCDATA) >
                <!ELEMENT RefIDQual                 (#PCDATA) >
                <!ELEMENT RefID                     (#PCDATA) >
Following is an example of a Price and Availability submit document:

<XML_MultiPriceAvailability_Submit>
  <Header>
    <UserName>INSERT_ID_HERE</UserName>
    <Password>INSERT_PASSWORD_HERE</Password>
    <ResponseVersion>1.0</ResponseVersion>
  </Header>
  <Detail>
    <LineInfo>
      <RefIDQual>VP</RefIDQual>
      <RefID>10803639</RefID>
    </LineInfo>
    <LineInfo>
      <RefIDQual>VP</RefIDQual>
      <RefID>10803638</RefID>
    </LineInfo>
    <LineInfo>
      <RefIDQual>VP</RefIDQual>
      <RefID>10544688</RefID>
    </LineInfo>
  </Detail>
</XML_MultiPriceAvailability_Submit>

Note:
  XML should be used as a supplement to the Product Catalog found on Tech Data’s Web site.  The Product Catalog is also available via an EDI 832 transaction. 
XML should
not
be used for updating your entire electronic catalog database.  Tech Data reserves the right to restrict access to the XML service for customers who do not use this service appropriately.

Multiple Item Price and Availability Submit Data Fields

The following table provides a detail description of each element defined in the XML_MultiPriceAvailability_Submit.dtd

Element Name
Optional
Required
Description
Data
Type
Max Len
Header R
UserName R EC logon ID assigned by Tech Data A/N Note 1
Password R Password assigned by Tech Data A/N Note 1
TransControlID O Unique tracking identifier assigned by the customer for each Price and Availability document submitted A/N 100
ResponseVersion O Designates the Response DTD version that will be returned.
  • If omitted, the oldest supported Response DTD version is returned
  • In order to receive the latest functionality, you should specify the “highest” available (newest) Response DTD version number
  • Using older version numbers will generate legacy Response documents with reduced data content and functionality
 A/N 20
Detail R
LineInfo R Minimum of 1 per Price and Availability submit document is required, but multiple are allowed
AssignedID O Unique tracking identifier assigned by the customer for each detail line (item) requested within the Price and Availability submit document A/N 100
OrderLevel O This element is only used when Government or Education pricing is desired. 

Order Level codes for U.S. Customers

Value Meaning
EF Education (Student & Staff)
EH Education (Higher)
EL Education (K-12)
ER Education (Erate)
FE Federal
FG Federal GSA
ST State
MD Medical

Order Level codes for Canadian Customers

Value Meaning
EF Education (Student & Staff)
EH Education (Higher)
EL Education (K-12)
FE Federal
LO Local
PR Provincial
A 2
RefIDQual R Two character code identifying the part number type that was contained in the Price and Availability submit document.  It identifies the part number type that is contained in the proceeding <RefID> element.
Value Meaning
VP Tech Data item number
BP Buyer Part (customer’s) item number
MG Manufacturer’s item number
UP UPC (Universal Product Code)
A 2
RefID R The item number A/N 20
Note 1
The actual maximum length is not documented.  Include on each XML document submitted the UserName and Password values assigned by your Master/Admin user.

Multiple Item Price and Availability Response DTD

The following DTD defines the Multiple Item Price and Availability Response document:
<!ELEMENT XML_MultiPriceAvailability_Response (
      Header ,
      Detail ,
      Summary ) >

      <!ELEMENT   Header (
                  TransControlID? ,
                  ResponseVersion? ) >

          <!ELEMENT TransControlID              (#PCDATA) >
          <!ELEMENT ResponseVersion             (#PCDATA) >

      <!ELEMENT   Detail ( LineInfo+ ) >
          <!ELEMENT LineInfo (
                    AssignedID? ,
                    RefIDQual1? ,
                    RefID1? ,
                    RefIDQual2? ,
                    RefID2? ,
                    RefIDQual4? ,
                    RefID4? ,
                    ProductDesc? ,
                    PriceIDCode1? ,
                    UnitPrice1? ,
                    PriceIDCode2? ,
                    UnitPrice2? ,
                    PromotedPricePerUnit? ,
                    PromoEndDate? ,
                    RequiredEndUserInfo? ,
                    RequiredLicenseInfo? ,
                    PromoAppliedInd? ,
                    ProductWeight? ,
                    ItemStatus? ,
                    CorporateAvailability? ,
                    ErrorInfo* ) >

                <!ELEMENT AssignedID            (#PCDATA) >
                <!ELEMENT RefIDQual1            (#PCDATA) >
                <!ELEMENT RefID1                (#PCDATA) >
                <!ELEMENT RefIDQual2            (#PCDATA) >
                <!ELEMENT RefID2                (#PCDATA) >
                <!ELEMENT RefIDQual4            (#PCDATA) >
                <!ELEMENT RefID4                (#PCDATA) >
                <!ELEMENT ProductDesc           (#PCDATA) >
                <!ELEMENT PriceIDCode1          (#PCDATA) >
                <!ELEMENT UnitPrice1            (#PCDATA) >
                <!ELEMENT PriceIDCode2          (#PCDATA) >
                <!ELEMENT UnitPrice2            (#PCDATA) >
                <!ELEMENT PromotedPricePerUnit  (#PCDATA) >
                <!ELEMENT PromoEndDate          (#PCDATA) >
                <!ELEMENT RequiredEndUserInfo   (#PCDATA) >
                <!ELEMENT RequiredLicenseInfo   (#PCDATA) >
                <!ELEMENT PromoAppliedInd       (#PCDATA) >
                <!ELEMENT ProductWeight         (#PCDATA) >
                <!ELEMENT ItemStatus            (#PCDATA) >
                <!ELEMENT CorporateAvailability (#PCDATA) >

                <!ELEMENT ErrorInfo (
                          RefIDQual3 ,
                          RefID3 ,
                          ErrorDesc ) >

                    <!ELEMENT RefIDQual3        (#PCDATA) >
                    <!ELEMENT RefID3            (#PCDATA) >
                    <!ELEMENT ErrorDesc         (#PCDATA) >

Following is an example of a Multiple Item Price and Availability response document sent from the XML system:
<XML_MultiPriceAvailability_Response>
  <Header>
    <TransControlID />
    <ResponseVersion>1.0</ResponseVersion>
  </Header>
  <Detail>
    <LineInfo>
      <RefIDQual1>VP</RefIDQual1>
      <RefID1>10803639</RefID1>
      <RefIDQual2>MG</RefIDQual2>
      <RefID2>MDREX56WHT</RefID2>
      <RefIDQual4>UP</RefIDQual4>
      <RefID4>027242755031</RefID4>
      <ProductDesc>MDRE EAR BUDS</ProductDesc>
      <PriceIDCode1>CON</PriceIDCode1>
      <UnitPrice1>$7.61</UnitPrice1>
      <PriceIDCode2>MSR</PriceIDCode2>
      <UnitPrice2>$9.99</UnitPrice2>
      <PromotedPricePerUnit>$7.61</PromotedPricePerUnit>
      <PromoEndDate />
      <RequiredEndUserInfo>N</RequiredEndUserInfo>
      <RequiredLicenseInfo>N</RequiredLicenseInfo>
      <PromoAppliedInd>N</PromoAppliedInd>
      <ProductWeight>.180</ProductWeight>
      <ItemStatus>ACTIVE</ItemStatus>
      <CorporateAvailability>62</CorporateAvailability>
    </LineInfo>
    <LineInfo>
      <RefIDQual1>VP</RefIDQual1>
      <RefID1>10803638</RefID1>
      <RefIDQual2>MG</RefIDQual2>
      <RefID2>MDREX40LPBLU</RefID2>
      <RefIDQual4>UP</RefIDQual4>
      <RefID4>027242801929</RefID4>
      <ProductDesc>MDRE EAR BUDS</ProductDesc>
      <PriceIDCode1>CON</PriceIDCode1>
      <UnitPrice1>$7.61</UnitPrice1>
      <PriceIDCode2>MSR</PriceIDCode2>
      <UnitPrice2>$9.99</UnitPrice2>
      <PromotedPricePerUnit>$7.61</PromotedPricePerUnit>
      <PromoEndDate />
      <RequiredEndUserInfo>N</RequiredEndUserInfo>
      <RequiredLicenseInfo>N</RequiredLicenseInfo>
      <PromoAppliedInd>N</PromoAppliedInd>
      <ProductWeight>.180</ProductWeight>
      <ItemStatus>ACTIVE</ItemStatus>
      <CorporateAvailability>102</CorporateAvailability>
    </LineInfo>
    <LineInfo>
      <RefIDQual1>VP</RefIDQual1>
      <RefID1>10544688</RefID1>
      <RefIDQual2>MG</RefIDQual2>
      <RefID2>STSF3000</RefID2>
      <RefIDQual4>UP</RefIDQual4>
      <RefID4>855309777302</RefID4>
      <ProductDesc>SOUND FORGE 10 SEMINAR SERIES NTSC</ProductDesc>
      <PriceIDCode1>CON</PriceIDCode1>
      <UnitPrice1>$63.62</UnitPrice1>
      <PriceIDCode2>MSR</PriceIDCode2>
      <UnitPrice2>$79.95</UnitPrice2>
      <PromotedPricePerUnit>$63.62</PromotedPricePerUnit>
      <PromoEndDate />
      <RequiredEndUserInfo>N</RequiredEndUserInfo>
      <RequiredLicenseInfo>N</RequiredLicenseInfo>
      <PromoAppliedInd>N</PromoAppliedInd>
      <ProductWeight>.160</ProductWeight>
      <ItemStatus>ACTIVE</ItemStatus>
      <CorporateAvailability>56</CorporateAvailability>
    </LineInfo>
  </Detail>
</XML_MultiPriceAvailability_Response>

Multiple Item Price and Availability Response Data Fields

The following table provides a detail description of each element defined in the XML_MultiPriceAvailability_Response.dtd

Element Name
Optional
Required
Description
Data
Type
Max Len
Header
TransControlID O Unique tracking identifier assigned by the customer for each Price and Availability submit document submitted. The content of the element sent by the customer within the XML document is returned as is to the customer within the Response document.  The primary function of these types of elements is for tracking purposes. A/N 100
ResponseVersion O Designates the Response DTD version A/N 20
Detail
LineInfo R For each item number (<RefID>) submitted, one LineInfo node will be returned
AssignedID O Unique tracking identifier assigned by the customer for each detail line (item) requested within the Price and Availability document. The content of the element sent by the customer within the XML message is returned as is to the customer within the Response document.  The purpose of this element is for tracking purposes. A/N 100
RefIDQual1 O Two character code identifying the part number type that was contained in the Price and Availability submit document.  It identifies the part number type that is contained in the following <RefID1> element. 
Value Meaning
VP Tech Data item number
BP Buyer Part (customer’s) item number. See Note 1 at the end of this  table.
MG Manufacturer’s item number
UP UPC (Universal Product Code)
A 2
RefID1 O The item number A/N 20
RefIDQual2 O Two character code identifying the part number type that was contained in the Price and Availability submit document.  It identifies the part number type that is contained in the following <RefID2> element. 
Value Meaning
VP Tech Data item number
BP Buyer Part (customer’s) item number. See Note 1 at the end of this  table.
MG Manufacturer’s item number
UP UPC (Universal Product Code)
A 2
RefID2 O This element will contain the manufacturer’s part number when preceded by a <RefIDQual2> value of ‘MG’ A/N 20
RefIDQual4 O Two character code identifying the part number type that was contained in the Price and Availability submit document.  It identifies the part number type that is contained in the following <RefID4> element. 
Value Meaning
VP Tech Data item number
BP Buyer Part (customer’s) item number. See Note 1 at the end of this  table.
MG Manufacturer’s item number
UP UPC (Universal Product Code)
A 2
RefID4 O Alternate part number for which an availability request is being submitted.
 A/N 20
ProductDesc O Description of requested item A/N 50
PriceIDCode1 O A fixed value of ‘CON’ A 3
UnitPrice1 O The customer’s base price N 15(2)
PriceIDCode2 O A fixed value of ‘MSR’ A 3
UnitPrice2 O Manufacturer’s Suggested Retail Price N 15(2)
PromotedPricePerUnit O The price of one of the items after the promotion has been applied N 15(2)
PromoEndDate O The last date the promotion is available. Promotions are available until the expiration date or while supplies last. N 10
RequiredEndUserInfo O A Y/N value which indicates if end user information would be required or not when an order for this item is submitted. This element is ALWAYS populated.
Value Meaning
Y End user information is required when ordering this item
N End user information is not required
A 1
RequiredLicenseInfo O A Y/N value which indicates if end user license information would be required or not when an order for this item is submitted.
Value Meaning
Y End user information is required
N End user information is not required
This element is only populated when the requested item was specified with a government/education order level in the Price and Availability submit.
 A 1
PromoAppliedInd O A Y/N value which indicates whether or not promotions were applied
 A 1
ProductWeight O Weight of the requested item
 N 9
ItemStatus O Tech Data status of the requested item. Possible values include:
  • NEW
  • ACTIVE
  • PHASEDOUT
  • ALLOCATED
  • COMPONENTS
 A 14
CorporateAvailability O Corporate availability across all warehouses. N 15
ErrorInfo
RefIDQual3 O A fixed value of  ‘1Q’ A/N 2
RefID3 O A fixed value of  ‘0’ N 1
ErrorDesc O Error description A/N 250
Note 1
If Buyer Part numbers are to be submitted, contact your Tech Data Sales team to have your Buyer Part number to Tech Data Item number cross-reference established on our system.
©2015 Tech Data Corporation. All Rights Reserved. Tech Data proprietary and confidential