Order

 

The Submit and Response documents of the XML Order Transaction are not changing. However, some of the Element data values and related functionality is different in the latest update of the XML Service. Affected fields are highlighted.

 

Example of an Order with only the minimum elements:

 

<XML_Order_Submit>

  <Header>

    <UserName>UserID</UserName>

    <Password>Password</Password>

    <ResponseVersion>1.6</ResponseVersion>

    <OrderTypeCode>BS</OrderTypeCode>

    <PONbr>2342385.2</PONbr>

    <SalesRequirementCode>BK</SalesRequirementCode>

    <Name>eCOMMERCE</Name>

    <AddrInfo>

      <Addr>5350 TECH DATA DR</Addr>

    </AddrInfo>

    <CityName>CLEARWATER</CityName>

    <StateProvinceCode>FL</StateProvinceCode>

    <PostalCode>33760</PostalCode>

    <ContactName>John Q. Public</ContactName>

  </Header>

  <Detail>

    <LineInfo>

      <QtyOrdered>125</QtyOrdered>

      <ProductIDQual>VP</ProductIDQual>

      <ProductID>20009102</ProductID>

      <IDCode>01</IDCode>

    </LineInfo>

  </Detail>

</XML_Order_Submit>

 

Another example of an Order:

 

<XML_Order_Submit>

  <Header>

    <UserName>UserID</UserName>

    <Password>Password</Password>

    <TransControlID>10000</TransControlID>

    <ResponseVersion>1.6</ResponseVersion>

    <OrderTypeCode>DS</OrderTypeCode>

    <PONbr>MY PO NUMBER 4.4.6</PONbr>

    <RefNbrs>

      <RefIDQual>EU</RefIDQual>

      <RefID>EU CFG-1.FEB21</RefID>

    </RefNbrs>

    <SalesRequirementCode />

    <RequestOrderConfirmation>Y</RequestOrderConfirmation>

    <ThirdPartyFreightAutoApply>Y</RequestOrderConfirmation>

    <Date>071231</Date>

    <Name>ELECTRONIC COMMERCE</Name>

    <AddrInfo>

      <Addr>5350 TECH DATA DRIVE</Addr>

    </AddrInfo>

    <CityName>CLEARWATER</CityName>

    <StateProvinceCode>FL</StateProvinceCode>

    <PostalCode>33760</PostalCode>

    <ContactName>TECH DATA CORPORATION</ContactName>

    <ContactPhoneNbr>727.539.7429</ContactPhoneNbr>

    <OrderLevel>FE</OrderLevel>

    <ConfigInd>N</ConfigInd>

    <OrderMessageHdrType>DEL</OrderMessageHdrType>

    <OrderMessageHdr>HEADER MESSAGE TEXT HERE</OrderMessageHdr>

    <EndUserCustomerNbr>102555</EndUserCustomerNbr>

    <EndUserGroupCode>ABCDEFGHIJ</EndUserGroupCode>

    <EndUserInfo>

      <EuiGovAgency>Hud</EuiGovAgency>

      <EuiGovCabinetLevel>HOUSE</EuiGovCabinetLevel>

      <EuiContractNbr>12345</EuiContractNbr>

      <EuiContractType>GSA</EuiContractType>

      <EuiOrderPriority>101</EuiOrderPriority>

      <EuiMarketType>STATE</EuiMarketType>

      <EuiContactName>MR. PRESIDENT</EuiContactName>

      <EuiPhoneNbr>813.555.1212</EuiPhoneNbr>

      <EuiFaxNbr>813.555.1212</EuiFaxNbr>

      <EuiName>JOHN MAC</EuiName>

      <EuiAddr1>5350 TECH DATA DR.</EuiAddr1>

      <EuiAddr2>BUILDING B</EuiAddr2>

      <EuiAddr3>IT DEPARTMENT</EuiAddr3>

      <EuiCityName>CLEARWATER</EuiCityName>

      <EuiStateProvinceCode>FL</EuiStateProvinceCode>

      <EuiPostalCode>33760</EuiPostalCode>

      <EuiCountryCode>US</EuiCountryCode>

      <EuiSicCode>123</EuiSicCode>

      <EuiOrderPromoType>FE</EuiOrderPromoType>

      <EuiEndUserLicenseNbr>LIC_NBR</EuiEndUserLicenseNbr>

      <EuiEndUserPODate>011231</EuiEndUserPODate>

      <EuiEndUserRef1>REF-1</EuiEndUserRef1>

      <EuiEndUserRef2>REF-2</EuiEndUserRef2>

      <EuiEndUserRef3>REF-3</EuiEndUserRef3>

      <EuiInstallName>INSTALL-NAME</EuiInstallName>

      <EuiDropShipType>D</EuiDropShipType>

      <EuiContactEmailAddr1>EndUser@SomeWhere.com</EuiContactEmailAddr1>

      <EuiContactEmailAddr2>YourReseller@YourCompany.com</EuiContactEmailAddr2>

    </EndUserInfo>

    <CreditCardInfo>

      <CCNbr>9999</CCNbr>

    </CreditCardInfo>

    <MyOrderTracker>

      <ResellerEmail>SalesDept@YourCompany.com</ResellerEmail>

      <EndUserEmail>EndUserX@somewhere.com</EndUserEmail>

      <ResellerEvents>OS</ResellerEvents>

      <EndUserEvents>OC</EndUserEvents>

      <EndUserEvents>OS</EndUserEvents>

    </MyOrderTracker>

  </Header>

  <Detail>

    <LineInfo>

      <OrigCustPOLineNbr>0001</OrigCustPOLineNbr>

      <QtyOrdered>1</QtyOrdered>

      <UnitPrice>125.00</UnitPrice>

      <ProductIDQual>VP</ProductIDQual>

      <ProductID>20009102</ProductID>

      <WhseCode>SUWANEE, GA</WhseCode>

      <IDCode>UPS GROUND</IDCode>

      <ConfigHandlingCode>M</ConfigHandlingCode>

      <PromoAcceptInd>Y</PromoAcceptInd>

      <OrderMessageLine>LINE MESSAGE TEXT HERE</OrderMessageLine>

      <AggregationCode>001</AggregationCode>

    </LineInfo>

  </Detail>

</XML_Order_Submit>

 

Element Name	What�s Different
ThirdPartyFreightAutoApply	No longer used.
Date	Requested Delivery Date. Previously, this field represented Requested Ship Date.
Addr	Ship-To Addressed increased to 35 characters.
ContactPhoneNbr	No longer used.
EuiCountryCode	Limited to 2 characters.
ResellerEvents	Released to Warehouse (OR) is no longer an option.
EndUserEvents	Released to Warehouse (OR) is no longer an option.
ProductID	The length of the Tech Data Product Number increased to 8 digits. This is only affected when the ProductIDQual is set to �VP� (Tech Data item number).
WhseCode	Tech Data Warehouse Codes have changed.
IDCode	Ship Via/Delivery Codes have changed.
ConfigHandlingCode	No longer used.
PromoAcceptInd	No longer used.
AggregationCode	No longer used.

 

Example of a Response to an order when Order Confirmation is requested:

 

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE XML_Order_Response SYSTEM "XML_Order_Response.dtd"[]>

<XML_Order_Response>

  <Header>

    <UserName>UserID</UserName>

    <TransSetIDCode>855</TransSetIDCode>

    <TransControlID>10000</TransControlID>

    <ResponseVersion>1.6</ResponseVersion>

    <PurposeCode />

    <PONbr>MY PO NUMBER 4.4.6</PONbr>

    <RefID>I862000000</RefID>

    <OrderConfirmation>

      <OrderDetail>

        <RefInfo>

          <RefIDQual2>ON</RefIDQual2>

          <RefID2>I862000000</RefID2>

        </RefInfo>

        <RefInfo>

          <RefIDQual2>PO</RefIDQual2>

          <RefID2>MY PO NUMBER 4.4.6</RefID2>

        </RefInfo>

        <RefInfo>

          <RefIDQual2>EU</RefIDQual2>

          <RefID2>EU CFG-1.FEB21</RefID2>

        </RefInfo>

        <OrderStatus>OPEN</OrderStatus>

        <Terms>Z030</Terms>

        <CurrencyType>USD</CurrencyType>

        <ShipmentDispQual>SC</ShipmentDispQual>

        <PackageDispQual>BS</PackageDispQual>

        <ShipToName>Drop Shipment (EDI)-staff</ShipToName>

        <ShipToAddr1 />

        <ShipToAddr2 />

        <ShipToAddr3 />

        <ShipToStateProv />

        <ContactName>TECH DATA CORPORATION</ContactName>

        <NetFreightCharge>.00</NetFreightCharge>

        <LineInfo2>

          <AssignedID2>100</AssignedID2>

          <ProductIDQual>VP</ProductIDQual>

          <ProductID>20009102</ProductID>

          <LineStatus>OPEN</LineStatus>

          <UnitPrice>2.33</UnitPrice>

          <ExtendedPrice>2.33</ExtendedPrice>

          <WhseDesc>A021</WhseDesc>

          <ShipViaDesc>N5</ShipViaDesc>

          <QtyOrdered>1</QtyOrdered>

          <QtyBackOrdered>0</QtyBackOrdered>

          <ItemEstimatedShipDate>120404</ItemEstimatedShipDate>

        </LineInfo2>

        <NbrOfOrderLines>1</NbrOfOrderLines>

      </OrderDetail>

    </OrderConfirmation>

  </Header>

  <Summary>

    <NbrOfSegments>0</NbrOfSegments>

  </Summary>

</XML_Order_Response>

 

Example of a Response to an order without order confirmation:

 

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE XML_Order_Response SYSTEM "XML_Order_Response.dtd"[]>

<XML_Order_Response>

  <Header>

    <UserName>UserID</UserName>

    <TransSetIDCode>855</TransSetIDCode>

    <TransControlID />

    <ResponseVersion>1.6</ResponseVersion>

    <PurposeCode />

    <PONbr>2342385.2</PONbr>

    <RefID>I562000000</RefID>

  </Header>

  <Summary>

    <NbrOfSegments>0</NbrOfSegments>

  </Summary>

</XML_Order_Response>

 

Element Name	What�s Different
RefID	The length of the Tech Data Sales Order Number increased to 10 characters.
RefID2	The length of the Tech Data Sales Order Number increased to 10 characters. This is only affected when the RefIDQual2 is set to �ON� (Order number).
OrderStatus	Tech Data status possible values include: OPEN, BLOCKED, RELEASED, SHIPPED, and CANCELLED.
Terms	Payment conditions codes have change (customer specific).
ProductID	The length of the Tech Data Product Number increased to 8 digits. This is only affected when the ProductIDQual is set to �VP� (Tech Data item number).
LineStatus	Tech Data status possible values include: OPEN, BLOCKED, RELEASED, SHIPPED, and CANCELLED.
WhseCode	Tech Data Warehouse Codes have changed.
ShipViaDesc	Ship Via/Delivery Codes have changed.