OrderStatus

 

The Submit and Response documents of the XML OrderStatus 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.

Following is an example of a formatted Order Status (PurposeCode = '01') Submit message:

<XML_OrderStatus_Submit>

  <Header>

    <UserName>UserID</UserName>

    <Password>Password</Password>

    <TransSetIDCode>869</TransSetIDCode>

    <TransControlID>10000</TransControlID>

    <ResponseVersion>1.7</ResponseVersion>

  </Header>

  <Detail>

    <PurposeCode>01</PurposeCode>

    <EDIInd>N</EDIInd>

    <NonEDIInd>Y</NonEDIInd>

    <RefInfo>

      <RefIDQual>PO</RefIDQual>

      <RefID>22222222</RefID>

    </RefInfo>

  </Detail>

  <Summary>

    <NbrOfSegments />

  </Summary>

</XML_OrderStatus_Submit>

Following is an example of a formatted Order/Invoice Detail (PurposeCode = '02') Submit message using a sales order number:

<XML_OrderStatus_Submit>

  <Header>

    <UserName>UserID</UserName>

    <Password>Password</Password>

    <TransSetIDCode>869</TransSetIDCode>

    <TransControlID>10000</TransControlID>

    <ResponseVersion>1.7</ResponseVersion>

  </Header>

  <Detail>

    <PurposeCode>02</PurposeCode>

    <EDIInd>N</EDIInd>

    <NonEDIInd>Y</NonEDIInd>

    <RefInfo>

      <RefIDQual>ON</RefIDQual>

      <RefID>I520000000</RefID>

    </RefInfo>

  </Detail>

  <Summary>

    <NbrOfSegments />

  </Summary>

</XML_OrderStatus_Submit>

This is an example of a formatted Order/Invoice Detail (PurposeCode = '02') Submit message using an invoice number:

<XML_OrderStatus_Submit>

  <Header>

    <UserName>UserID</UserName>

    <Password>Password</Password>

    <TransSetIDCode>869</TransSetIDCode>

    <TransControlID>10000</TransControlID>

    <ResponseVersion>1.7</ResponseVersion>

  </Header>

  <Detail>

    <PurposeCode>02</PurposeCode>

    <EDIInd>N</EDIInd>

    <NonEDIInd>Y</NonEDIInd>

    <RefInfo>

      <RefIDQual>IN</RefIDQual>

      <RefID>8000015611</RefID>

    </RefInfo>

  </Detail>

  <Summary>

    <NbrOfSegments />

  </Summary>

</XML_OrderStatus_Submit>

 

Below is an example of a formatted Ship Detail (PurposeCode = '03') Submit message. Note that both a Tech Data assigned Sales Order number (RefIDQual = 'ON') and a Tech Data assigned Invoice number (RefIDQual = 'IN') related to the sales order must be included in the Ship Detail request message.

 

<XML_OrderStatus_Submit>

  <Header>

    <UserName>UserID</UserName>

    <Password>Password</Password>

    <TransSetIDCode>869</TransSetIDCode>

    <TransControlID>10000</TransControlID>

    <ResponseVersion>1.7</ResponseVersion>

  </Header>

  <Detail>

    <PurposeCode>03</PurposeCode>

    <EDIInd>N</EDIInd>

    <NonEDIInd>Y</NonEDIInd>

    <RefInfo>

      <RefIDQual>IN</RefIDQual>

      <RefID>8000015611</RefID>

    </RefInfo>

    <RefInfo>

      <RefIDQual>ON</RefIDQual>

      <RefID>I520000000</RefID>

    </RefInfo>

  </Detail>

  <Summary>

    <NbrOfSegments />

  </Summary>

</XML_OrderStatus_Submit>

 

Element Name	What�s Different
EDIInd	No longer used.
NonEDIInd	No longer used.
RefID	The length of the Customer PO Number increased to 35 characters. This is only affected when the RefIDQual is set to �PO� (Customer assigned purchase Order number). The length of the Tech Data Sales Order Number increased to 10 characters. This is only affected when the RefIDQual is set to �ON� (Tech Data assigned sales order number). The length of the Tech Data Invoice Number increased to 10 digits. This is only affected when the RefIDQual is set to �IN� (Tech Data assigned invoice number).

 

Example of a Response to an Order Status Request (PurposeCode = '01'):

 

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

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

<XML_OrderStatus_Response>

  <Header>

    <TransSetIDCode>870</TransSetIDCode>

    <TransControlID>10000</TransControlID>

    <ResponseVersion>1.7</ResponseVersion>

  </Header>

  <Detail>

    <PurposeCode>01</PurposeCode>

    <RefInfo>

      <RefIDQual>PO</RefIDQual>

      <RefID>22222222</RefID>

    </RefInfo>

    <RefInfo>

      <RefIDQual>ON</RefIDQual>

      <RefID>I520000000</RefID>

    </RefInfo>

    <OrderStatus>OPEN</OrderStatus>

    <Terms>Z030</Terms>

    <ContactName></ContactName>

    <InvoiceTotal>0.00</InvoiceTotal>

    <EstimatedShipDate>120326</EstimatedShipDate>

  </Detail>

  <Summary>

    <NbrOfSegments>0</NbrOfSegments>

  </Summary>

</XML_OrderStatus_Response>

 

Example of an Invoice Detail Response to an Order Status Request (PurposeCode = '02'):

 

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

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

<XML_OrderStatus_Response>

  <Header>

    <TransSetIDCode>870</TransSetIDCode>

    <TransControlID>10000</TransControlID>

    <ResponseVersion>1.7</ResponseVersion>

  </Header>

  <Detail>

    <PurposeCode>02</PurposeCode>

    <RefInfo>

      <RefIDQual>PO</RefIDQual>

      <RefID>22222222</RefID>

    </RefInfo>

    <RefInfo>

      <RefIDQual>EU</RefIDQual>

      <RefID>33333333</RefID>

    </RefInfo>

    <RefInfo>

      <RefIDQual>IN</RefIDQual>

      <RefID>8000015611</RefID>

    </RefInfo>

    <RefInfo>

      <RefIDQual>ON</RefIDQual>

      <RefID>I520000000</RefID>

    </RefInfo>

    <Terms>30 days net</Terms>

    <CurrencyType>USD</CurrencyType>

    <ShipmentDispQual>SC</ShipmentDispQual>

    <ShipmentDisp>N</ShipmentDisp>

    <PackageDispQual>BS</PackageDispQual>

    <PackageDisp>N</PackageDisp>

    <BillToAcctNbr />

    <ShipToName>ELECTRONIC COMMERCE</ShipToName>

    <ShipToAddr1>5350 TECH DATA DRIVE</ShipToAddr1>

    <ShipToAddr2>SUITE 101</ShipToAddr2>

    <ShipToAddr3 />

    <ShipToCity>CLEARWATER</ShipToCity>

    <ShipToStateProv>FL</ShipToStateProv>

    <ShipToPostalCode>33760</ShipToPostalCode>

    <ContactName />

    <InvoiceTotal>2806.73</InvoiceTotal>

    <HandlingCharge>1.02</HandlingCharge>

    <NetFreightCharge>0.00</NetFreightCharge>

    <StateFee>0.00</StateFee>

    <LineInfo>

      <AssignedID>000200</AssignedID>

      <ProductIDQual>VP</ProductIDQual>

      <ProductID>10200497</ProductID>

      <ProductIDQual2>MG</ProductIDQual2>

      <ProductID2>WS-X4908-10GE-RF</ProductID2>

      <ProductDesc>8PT 2:1 10 GE CARD REFURB</ProductDesc>

      <LineStatus>SHIPPED</LineStatus>

      <UnitPrice>2798.21</UnitPrice>

      <ExtendedPrice>2798.21</ExtendedPrice>

      <WhseDesc>Suwanee, GA</WhseDesc>

      <ShipViaDesc>UPS GROUND</ShipViaDesc>

      <QtyOrdered>1</QtyOrdered>

      <QtyBackordered>0</QtyBackordered>

      <QtyReturned>0</QtyReturned>

      <DateShipped>120321</DateShipped>

      <ItemEstimatedShipDate>120321</ItemEstimatedShipDate>

    </LineInfo>

    <NbrOfOrderLines>1</NbrOfOrderLines>

  </Detail>

  <Summary>

    <NbrOfSegments>0</NbrOfSegments>

  </Summary>

</XML_OrderStatus_Response>

 

Example of a Response to a Ship Detail Request (PurposeCode = '03'):

 

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

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

<XML_ShipmentStatus_Response>

  <Header>

    <TransSetIDCode>856</TransSetIDCode>

    <TransControlID>10000</TransControlID>

    <ResponseVersion>1.7</ResponseVersion>

  </Header>

  <Detail>

    <RefInfo>

      <RefIDQual>PO</RefIDQual>

      <RefID>22222222</RefID>

    </RefInfo>

    <RefInfo>

      <RefIDQual>EU</RefIDQual>

      <RefID>33333333</RefID>

    </RefInfo>

    <RefInfo>

      <RefIDQual>IN</RefIDQual>

      <RefID>8000015611</RefID>

    </RefInfo>

    <RefInfo>

      <RefIDQual>ON</RefIDQual>

      <RefID>I520000000</RefID>

    </RefInfo>

    <ContainerInfo>

      <ContainerID>919405370021928</ContainerID>

      <ShipToName>ELECTRONIC COMMERCE</ShipToName>

      <ShipToAddr1>5350 TECH DATA DRIVE</ShipToAddr1>

      <ShipToAddr2>SUITE 101</ShipToAddr2>

      <ShipToAddr3 />

      <ShipToCity>CLEARWATER</ShipToCity>

      <ShipToStateProv>FL</ShipToStateProv>

      <ShipToPostalCode>33760</ShipToPostalCode>

      <DateShipped>120321</DateShipped>

      <DateInvoiced>120321</DateInvoiced>

      <Weight>1.500</Weight>

      <ContainerValue>0.00</ContainerValue>

      <HandlingCharge>1.02</HandlingCharge>

      <CODCharge>0.00</CODCharge>

      <DebitCredit>0.00</DebitCredit>

      <NetFreightCharge>0.00</NetFreightCharge>

      <TaxCharge>0.00</TaxCharge>

      <StateFee>0.00</StateFee>

      <TotalOrderValue>2806.73</TotalOrderValue>

      <ItemInfo>

        <IIAssignedID>000002</IIAssignedID>

        <AssignedID>000200</AssignedID>

        <ProductIDQual>VP</ProductIDQual>

        <ProductID>000000000010200497</ProductID>

        <ProductIDQual2>MG</ProductIDQual2>

        <ProductID2>WS-X4908-10GE-RF</ProductID2>

        <ProductDesc>8PT 2:1 10 GE CARD REFURB</ProductDesc>

        <QtyShipped>1.000</QtyShipped>

        <SerialInd>Y</SerialInd>

        <SerialInfo>

          <SerialNbr>676BBBBB</SerialNbr>

        </SerialInfo>

      </ItemInfo>

      <NbrOfItems>1</NbrOfItems>

    </ContainerInfo>

  </Detail>

  <Summary>

    <NbrOfContainers>1</NbrOfContainers>

    <NbrOfSegments>0</NbrOfSegments>

  </Summary>

</XML_ShipmentStatus_Response>

 

Element Name	What�s Different
RefIDQual	The Invoice Number is no longer returned for Purpose Code 01.
RefID	The length of the Customer PO Number increased to 35 characters. This is only affected when the RefIDQual is set to �PO� (Customer assigned purchase Order number). The length of the Tech Data Sales Order Number increased to 10 characters. This is only affected when the RefIDQual is set to �ON� (Tech Data assigned sales order number). The length of the Tech Data Invoice Number increased to 10 digits. This is only affected when the RefIDQual is set to �IN� (Tech Data assigned invoice number). The Invoice Number is no longer returned for Purpose Code 01.
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.
ContainerValue	Always set to 0.00.
HandlingCharge	Value set in first Container (applies to entire Invoice). Subsequent Containers set to 0.00.
CODCharge	Always set to 0.00.
DebitCredit	Always set to 0.00.
NetFreightCharge	Value set in first Container (applies to entire Invoice). Subsequent Containers set to 0.00.
TaxCharge	Always set to 0.00.
StateFee	Value set in first Container (applies to entire Invoice). Subsequent Containers set to 0.00.
TotalContainerValue	Value set in first Container (applies to entire Invoice). Subsequent Containers set to 0.00.