Print Price List


Price List Submit DTD

PriceList provides a complete and comprehensive list of pricing options available including the following for each item:

No Free Good Bonus are included

The promoted price returned will be either the best single promotion or the result of optimum grouping of stackable promotions (up to 4 promotions can be stacked) whichever is the lowest item price.

Note:
This transaction requires intense processing and data volume so response times may be longer than other transactions. Customers should limit their PriceList requests.

The PriceList Submit DTD:

<!ELEMENT XML_PriceList_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? ,
            RefIDQual ,
            RefID,
            ReturnAvailability? ) >
            <!ELEMENT AssignedID         (#PCDATA) >
            <!ELEMENT RefIDQual          (#PCDATA) >
            <!ELEMENT RefID              (#PCDATA) >
            <!ELEMENT ReturnAvailability (#PCDATA) >

An example of a PriceList  submit message:
<XML_PriceList_Submit>
    <Header>
        <UserName>user</UserName>
        <Password>password</Password>
        <ResponseVersion>1.5</ResponseVersion>
    </Header>
    <Detail>
        <LineInfo>
            <RefIDQual>VP</RefIDQual>
            <RefID>803160</RefID>
            <ReturnAvailability>Y</ReturnAvailability>
        </LineInfo>
    </Detail>
</XML_PriceList_Submit>

Price List Submit Data Fields

The following table provides a detail description of each element defined in the XML_PriceList_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
TransSetIDCode R Value must be 864Send A/N 7
TransControlID O Unique tracking identifier assigned by the customer for each PriceList submit document 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 messages with reduced data content and functionality
A/N 20
Detail R      
LineInfo R For each item number being inquired, submit one LineInfo node and its children    
AssignedID O Unique tracking identifier assigned by the customer for each detail line (item) requested within the PriceList submit message. A/N 100
RefIDQual R Two character code identifying the part number type that was contained in the PriceList submit message.  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 part number for which all pricing options is being requested A/N 20
ReturnAvailability O If this element is present and contains “Y” warehouse availability information will be returned in the response document. A 1
The actual maximum length is not documented.  Include on each XML message submitted the UserName and Password values assigned by your Master/Admin user.

PriceList Response DTD

The PriceList Response DTD:

<!ELEMENT XML_PriceList_Response(
    Header ,
    Detail ) >

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

        <!ELEMENT TransControlID        (#PCDATA) >
        <!ELEMENT ResponseVersion       (#PCDATA) >
    <!ELEMENT Detail (
        LineInfo+ ) >

        <!ELEMENT LineInfo (
            AssignedID?,
            RefIDQual1?,
            RefID1?,
            RefIDQual2?,
            RefID2?,
            ProductDesc?,
            ItemEUIRequired?,
            LicenseRequired?,
            CustomerPrice?,
            MSRP?,
            PromotionInfo*,
            AvailabilityInfo?,
            ErrorInfo? ) >

            <!ELEMENT AssignedID                (#PCDATA) >
            <!ELEMENT RefIDQual1                (#PCDATA) >
            <!ELEMENT RefID1                    (#PCDATA) >
            <!ELEMENT RefIDQual2                (#PCDATA) >
            <!ELEMENT RefID2                    (#PCDATA) >
            <!ELEMENT ProductDesc               (#PCDATA) >
            <!ELEMENT ItemEUIRequired           (#PCDATA) >
            <!ELEMENT LicenseRequired           (#PCDATA) >
            <!ELEMENT CustomerPrice             (#PCDATA) >
            <!ELEMENT MSRP                      (#PCDATA) >
            <!ELEMENT PromotionInfo (
                OrderLevel?,
                MinimumQty?,
                MaximumQty?,
                PromotedPricePerUnit?,
                PromoEndDate?,
                PromoNumber* ) >

                <!ELEMENT OrderLevel            (#PCDATA) >
                <!ELEMENT MinimumQty            (#PCDATA) >
                <!ELEMENT MaximumQty            (#PCDATA) >
                <!ELEMENT PromotedPricePerUnit  (#PCDATA) >
                <!ELEMENT PromoEndDate          (#PCDATA) >
                <!ELEMENT PromoNumber           (#PCDATA) >
            <!ELEMENT   AvailabilityInfo ( WhseInfo+ ) >   

                <!ELEMENT   WhseInfo (
                    IDCode ,
                    WhseCode? ,
                    Qty,
                    TotalOnOrderQty?,
                    OnOrderQty?,
                    OnOrderETADate?,
                    ItemStatus? ) >

                    <!ELEMENT IDCode            (#PCDATA) >
                    <!ELEMENT WhseCode          (#PCDATA) >
                    <!ELEMENT Qty               (#PCDATA) >
                    <!ELEMENT TotalOnOrderQty   (#PCDATA) >
                    <!ELEMENT OnOrderQty        (#PCDATA) >
                    <!ELEMENT OnOrderETADate    (#PCDATA) >
                    <!ELEMENT ItemStatus        (#PCDATA) >
            <!ELEMENT ErrorInfo (
                ErrorID,
                ErrorDesc ) >

                <!ELEMENT ErrorID               (#PCDATA) >
                <!ELEMENT ErrorDesc             (#PCDATA) >

An example of a PriceList response:
<XML_PriceList_Response>
    <Header />
    <Detail>
        <LineInfo>
            <RefIDQual1>VP</RefIDQual1>
            <RefID1>803160</RefID1>
            <RefIDQual2>MG</RefIDQual2>
            <RefID2>N/A</RefID2>
            <ProductDesc>N/A</ProductDesc>
            <CustomerPrice>$23.86</CustomerPrice>
            <MSRP>$34.99</MSRP>
            <PromotionInfo>
                <OrderLevel />
                <MinimumQty>11</MinimumQty>
                <MaximumQty>20</MaximumQty>
                <PromotedPricePerUnit>$23.76</PromotedPricePerUnit>
                <PromoEndDate>11/12/2005</PromoEndDate>
                <PromoNumber>123456</PromoNumber>
                <PromoNumber>198234</PromoNumber>
                <PromoNumber>553456</PromoNumber>
                <PromoNumber>197674</PromoNumber>
            </PromotionInfo>
            <PromotionInfo>
                <OrderLevel>FE</OrderLevel>
                <MinimumQty>10</MinimumQty>
                <PromotedPricePerUnit>$22.95</PromotedPricePerUnit>
                <PromoEndDate>12/28/2005</PromoEndDate>
                <PromoNumber>198234</PromoNumber>
            </PromotionInfo>
            <AvailabilityInfo>
                <WhseInfo>
                    <IDCode>MIAMI, FL</IDCode>
                    <WhseCode>A1</WhseCode>
                    <Qty>5</Qty>
                    <TotalOnOrderQty>215</TotalOnOrderQty>
                    <OnOrderQty>111</OnOrderQty>
                    <OnOrderETADate>08/20/05</OnOrderETADate>
                </WhseInfo>
                <WhseInfo>
                    <IDCode>SOUTH BEND, IN</IDCode>
                    <WhseCode>A4</WhseCode>
                    <Qty>239</Qty>
                    <TotalOnOrderQty>200</TotalOnOrderQty>
                    <OnOrderQty>100</OnOrderQty>
                    <OnOrderETADate>05/12/05</OnOrderETADate>
                </WhseInfo>
            </AvailabilityInfo>
        </LineInfo>
    </Detail>
</XML_PriceList_Response>  

Price List Response Data Fields

Element Name
Optional
Required
Description
Data
Type
Max Len
Header R      
TransControlID O Unique tracking identifier assigned by the customer for each Price List request message submitted. The content of the element sent by the customer within the XML message is returned, as is, to the customer within the Response message.  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  R      
LineInfo R For each submitted LineInfo element one LineInfo node will be returned    
AssignedID O Unique tracking identifier assigned by the customer for each detail line (item) requested within the Price & Availability message. The content of the element sent by the customer within the XML message is returned as is to the customer within the Response message.  The primary function of these types of elements is for tracking purposes. A/N 100
RefIDQual1 O Two character code identifying the part number type that was contained in the Availability request message.  It identifies the part number type that is contained in the following <RefID1> element. 
Value Meaning
VP  Vendor Part (Tech Data’s)
BP Buyer Part (customer’s) number
UP UPC number
MG Manufacturer’s Part number
A/N 2
RefID1 O The part number for which an availability request is being submitted. A/N 20
RefIDQual2 O Two character code identifying the part number type that was contained in the Availability request message.  It identifies the part number type that is contained in the following <RefID2> element. 
Value Meaning
VP  Vendor Part (Tech Data’s)
BP Buyer Part (customer’s) number
UP UPC number
MG Manufacturer’s Part number
A/N 2
RefID2 O This element will contain the manufacturer’s part number when preceded by a <RefIDQual2> value of ‘MG’ A/N 20
ProductDesc O Product description A/N 50
ItemEUIRequired O A value of ‘Y’ in this field indicates that End User Information is required when ordering this item A 1
LicenseRequired O A value of ‘Y’ in this field indicates that a license is required when ordering this item A 1
CustomerPrice O The customer’s base price N 15(2)
MSRP O Manufacturer’s suggested retail price N 15(2)
PromotionInfo O Contains all information concerning the promotion(s) the customer is allowed for the item    
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

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
MinimumQty O The minimum quantity that must be ordered for this promotion to be applicable N 15
MaximumQty O The maximum quantity that can be ordered for this promotion to be applicable N 15
PromoEUIRequired O A value of ‘Y’ in this field indicates that End User Information is required for this  promotion to apply when ordering this item. N 1
PromotedPricePerUnit O The price of one of the items after this promotion has been applied N 15(2)
PromoEndDate O The last date this promotion is available. Promotions are available until the expiration date or while supplies last. N 10
PromoNumber O Each promotion that was automatically applied will be populated here. Note: Up to 4 promotions can be automatically applied.
• ResponseVersion 1.5 or higher
N 6
AvailabilityInfo O Returned only if the submit document contained <ReturnAvailability> with a value of “Y”
• ResponseVersion of 1.5 or higher
   
WhseInfo   Only one occurrence of the <WhseInfo> element per Detail (order line) is allowed    
IDCode R Warehouse location name, i.e. MIAMI, FL, NORCROSS, GA, etc.  For a complete list of Tech Data’s logistic centers, refer to the Warehouse Codes heading found in the Order submit section A/N 16
WhseCode O Tech Data warehouse identifier.  For a complete list of Tech Data’s logistic centers, refer to the Warehouse Codes heading found in the Order submit section of this document. A/N 2
Qty R Quantity of item in the warehouse
  • A negative value indicates the item is on back order
  • For warehouse 99 the value will be 9999
  • For products having limited availability the value will be -9999
N 15
TotalOnOrderQty O The total number on order for a designated warehouse location N 12
OnOrderQty O The earliest Expected-To-Arrive quantity for a designated warehouse. Is a sub-set of TotalOnOrderQty. N 10
OnOrderETADate C The earliest Expected-To-Arrive date for a designated warehouse. (format mm/dd/yy) A/N 8
ItemStatus O Tech Data status of the requested item. Possible values include:
  • NEW
  • ACTIVE
  • PHASED OUT
  • ALLOC
  • COMPON
  • DIS-TD
  • DIS-VN
  • SP-ORD
• ResponseVersion of 1.6 or higher
A 6
ErrorInfo O      
ErrorID O Not used at this time    
ErrorDesc O Error description A/N 100
©2007 Tech Data Corporation. All Rights Reserved. Tech Data proprietary and confidential