The Quote DTD:
<!ELEMENT XML_Quote_Submit (
Header ,
Detail ,
<!ELEMENT Header (
UserName,
Password,
TransSetIDCode ,
TransControlID ,
ResponseVersion? ) >
<!ELEMENT UserName
(#PCDATA) >
<!ELEMENT Password
(#PCDATA) >
<!ELEMENT TransSetIDCode
(#PCDATA) >
<!ELEMENT TransControlID
(#PCDATA) >
<!ELEMENT ResponseVersion
(#PCDATA) >
<!ELEMENT Detail+ (
PurposeCode ,
RefInfo+ ) >
<!ELEMENT RefInfo (
RefIDQual,
RefID )+ >
<!ELEMENT
RefID (#PCDATA)
>
<!ELEMENT
RefIDQual (#PCDATA) >
Following is an example of a formatted Quote submit message:
<XML_Quote_Submit> <Header> <UserName>INSERT_ID_HERE</UserName> <Password>INSERT_PASSWORD_HERE</Password> <TransSetIDCode>812</TransSetIDCode> <TransControlID>10000</TransControlID> <ResponseVersion>1.0</ResponseVersion> </Header> <Detail> <RefInfo> <RefIDQual>QT</RefIDQual> <RefID>4000500754</RefID> </RefInfo> </Detail> <Summary> <NbrOfSegments /> </Summary> </XML_Quote_Submit>
Element Name
|
Optional
Required |
Description
|
Data
Type |
Max Len
|
Header | R | |||
UserName | R | Logon ID assigned by Tech Data | A/N | |
Password | R | Password assigned by Tech Data | A/N | |
TransSetIDCode | R | Value must be '812' | A/N | |
TransControlID | R | Unique tracking identifier assigned by the customer | A/N | 100 |
ResponseVersion | O |
Response Version to be returned.
|
A/N | 20 |
Detail | R | |||
RefInfo | R | |||
RefIDQual | R | Value must be 'QT' | A | 2 |
RefID | R |
Quote number |
A/N | 10 |
<XML_Quote_Response> <Header> <TransSetIDCode>812</TransSetIDCode> <TransControlID>10000</TransControlID> <ResponseVersion>1.0</ResponseVersion> </Header> <Detail> <RefInfo> <RefIDQual>QT</RefIDQual> <RefID>4000500754</RefID> </RefInfo> <Market>Commercial</Market> <EntryDate>04/26/13</EntryDate> <ShipToName>TECH DATA CORP</ShipToName> <ShipToAddr1>5350 Tech Data Dr</ShipToAddr1> <ShipToAddr2 /> <ShipToAddr3 /> <ShipToCity>Clearwater</ShipToCity> <ShipToStateProv>FL</ShipToStateProv> <ShipToPostalCode>33760</ShipToPostalCode> <ContactName>MATTHEW THOMAS</ContactName> <EndUserInfo /> <LineInfo> <LineNumber>100</LineNumber> <ProductIDQual>VP</ProductIDQual> <ProductID>10848464</ProductID> <ProductIDQual2>MG</ProductIDQual2> <ProductID2>41268</ProductID2> <ProductDesc>TRULINK MEDIA GTW D2 DESK BRICK BLK 1PK</ProductDesc> <Manufacturer>CABLES TO GO</Manufacturer> <MSRP>$298.00</MSRP> <UnitPrice>$195.57</UnitPrice> <ExtendedPrice>$195.57</ExtendedPrice> <QtyOrdered>1</QtyOrdered> </LineInfo> <NbrOfOrderLines>1</NbrOfOrderLines> </Detail> </XML_Quote_Response>
Element Name
|
Optional
Required |
Description
|
Data
Type |
Max Len
|
||||||||
Header | ||||||||||||
TransSetIDCode | R | Value must be '812' | N | |||||||||
TransControlID | O | Unique tracking identifier assigned by the customer | A/N | 100 | ||||||||
ResponseVersion | O |
ResponseVersion 1.0
|
A/N | 20 | ||||||||
Detail | ||||||||||||
RefInfo | R | Minimum of 1 per Quote response message, but multiple could occur | ||||||||||
RefIDQual | R |
The type of identifier in the proceeding <RefID> element.
|
A | 2 | ||||||||
RefID | R |
|
A/N |
QT-10 PO-35 EU-35 |
||||||||
ErrorInfo | O | |||||||||||
ErrorIDQual | O | Value must be '1Q' | A/N | 2 | ||||||||
ErrorID | O | Value must be '0' | N | 1 | ||||||||
ErrorDesc | O | Error description | A/N | 250 | ||||||||
Market | R | Order Level market friendly name | A/N | 20 | ||||||||
EntryDate | R | Quote entry date | A/N | 8 | ||||||||
ShipToName | O | The name of the individual or organization receiving the order | A/N | 25 | ||||||||
ShipToAddr1 | O | The first street address line of the individual or organization receiving the order | A/N | 35 | ||||||||
ShipToAddr2 | O | The second street address line of the individual or organization receiving the order | A/N | 35 | ||||||||
ShipToAddr3 | O | The third street address line of the individual or organization receiving the order | A/N | 35 | ||||||||
ShipToCity | O | City destination name | A/N | 12 | ||||||||
ShipToStateProv | O | U.S. state or Canadian province destination abbreviation | A/N | 2 | ||||||||
ShipToPostalCode | O | U.S. zip code or Canadian postal code of destination receiving order | A/N | 9 | ||||||||
ContactName | O | Contact person’s name assigned to order | A/N | 25 | ||||||||
EndUserInfo | O | Information about the end user of the product as opposed to the entity ordering the product. | ||||||||||
EuiGovAgency | O | The name of the government agency on whose behalf the order was placed | A/N | 23 | ||||||||
EuiGovCabinetLevel | O | The name of the government cabinet on whose behalf the order was placed | A/N | 35 | ||||||||
EuiContractNbr | O | The contract number assigned by the organization on whose behalf the order was placed | A/N | 35 | ||||||||
EuiContractType | O | The type of contract assigned by the organization on whose behalf the order was placed | A/N | 35 | ||||||||
EuiOrderPriority | O | The order priority assigned by the organization on whose behalf the order was placed | A/N | 30 | ||||||||
EuiMarketType | O | Type of market represented by the organization on whose behalf the order was placed | A/N | 30 | ||||||||
EuiContactName | O | The contact person’s name assigned to the order by the organization on whose behalf the order was placed | A/N | 40 | ||||||||
EuiPhoneNbr | O | The contact person’s telephone number who is assigned to the order by the organization on whose behalf the order was placed | A/N | 30 | ||||||||
EuiFaxNbr | O | The contact person’s facsimile telephone number who is assigned to the order by the organization on whose behalf the the order was placed | A/N | 20 | ||||||||
EuiName | O | The name of the organization on whose behalf the order was placed | A/N | 40 | ||||||||
EuiAddr1 | O | The first address line of the organization on whose behalf the order was placed | A/N | 40 | ||||||||
EuiAddr2 | O | The second address line of the organization on whose behalf the order was placed | A/N | 40 | ||||||||
EuiAddr3 | O | The third address line of the organization on whose behalf the order was placed | A/N | 40 | ||||||||
EuiCityName | O | The city name of the organization on whose behalf the order was placed | A/N | 40 | ||||||||
EuiStateProvinceCode | O | U.S. state or Canadian province abbreviation of the organization on whose behalf the order was placed | A/N | 2 | ||||||||
EuiPostalCode | O | The postal code of the organization on whose behalf the order was placed | A/N | 9 | ||||||||
EuiCountryCode | O | The country code of the organization on whose behalf the order was placed | A/N | 2 | ||||||||
EuiEndUserLicenseNbr | O | If a software license is being ordered by the customer for its end user customer, this element should contain the license number. | A/N | 35 | ||||||||
EuiEndUserPODate | O |
The PO date assigned by the organization on whose behalf the order was placed. The
date specified should follow the YYMMDD format.
Example: July 15, 2006 is represented as 060715 |
N | 6 | ||||||||
EuiEndUserRef1 | O | A free format text field in which the customer can assign information related to the order | A/N | 35 | ||||||||
EuiEndUserRef2 | O | A free format text field in which the customer can assign information related to the order | A/N | 35 | ||||||||
EuiEndUserRef3 | O | A free format text field in which the customer can assign information related to the order | A/N | 35 | ||||||||
EuiInstallName | O | Location where the product will be installed | A/N | 25 | ||||||||
EuiContactEmailAddr1 | O | End User Email address. This is the address that a vendor drop ship may email a license to. The tag must be present but its contents can be blank. | A/N | 241 | ||||||||
EuiContactEmailAddr2 | O | Reseller Email Address. This is the email address that some times get sent to the vendor of the product ordered. The vendor uses this email for various reasons depending on the vendor. The tag must be present but its contents can be blank. | A/N | 241 | ||||||||
LineInfo | ||||||||||||
LineNumber | O |
Tech Data line number
|
A/N | 100 | ||||||||
ProductIDQual | O | Value must be ‘VP’ | A | |||||||||
ProductID | O | Tech Data item number | A/N | 20 | ||||||||
ProductIDQual2 | O |
Value must be ‘MG’ |
A | |||||||||
ProductID2 | O |
Manufacturer’s item number |
A/N | 20 | ||||||||
ProductDesc | O | Description of item | A/N | 50 | ||||||||
UnitPrice | O | Customer’s price for one unit of item ordered | N | 15(2) | ||||||||
ExtendedPrice | O | Total price of order line (UnitPrice x QtyOrdered) | N | 15(2) | ||||||||
QtyOrdered | O | The number of units ordered | N | 4 | ||||||||
NbrOfOrderLines | O | Total number of detail lines items being reported in the response for the specified Sales Order or Invoice number. | N | 3 |