|
UPS Supply Chain Solutions recommends two different methods for incorporating Web tracking into your
applications.
-
Designing an HTML input page that allows for the input of
a shipment number and then link a 'Submit' button to our tracking script.
-
Returning data from an XML Data Stream
Both of these methods require parameters to be passed to the page using a
querystring. The parameters passed are the optTYPE and the PRO# parameters.
The optTYPE parameter indicates what type of shipping values are being
passed to the Web page. It must contain one of two options:
-
SHIPNUM
Indicates that the values being passed are shipment numbers.
-
REFNUM
Indicates that the values being passed are reference numbers.
Up to ten PRO parameters can be passed to the page as well. The PRO
parameters represent the value to be searched for. Each PRO parameter has an
integer value between one and 10 appended to it. The PRO representing the
first shipment would be PRO1, the second would be represented by PRO2, etc.
The HTML Input page has a special parameter, Images. Setting this
parameter equal to false will suppress the UPS Supply Chain Solutions images. This may be useful if
you wish to display shipment information in a frame on your Web page.
As an example, assume that a search was desired in which we wanted to return the
status of shipment number 9999999999 and shipment number 888888888. The link to
accomplish this would be
http://forwarding.ups-scs.com/tracking/trackformaction.asp?optTYPE=SHIPNUM&PRO1=9999999999&PRO2=8888888888
(This is only an example, and may not have actual shipments associated with
it.)
Using an HTML Input Page
Here's a sample HTML page which can be used to call the UPS Supply Chain Solutions Web site:
<FORM
ACTION="http://forwarding.ups-scs.com/tracking/TrackingQuery.aspx"
METHOD="GET"> <br>
<CENTER>
<TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0>
<TR>
<TD>
<INPUT NAME=optTYPE VALUE="SHIPNUM" TYPE="radio" CHECKED>
Shipment Number<BR>
<INPUT NAME=optTYPE VALUE="REFNUM" TYPE="radio">
Reference Number<BR>
</TD>
</TR>
<TR>
<TD>
<INPUT type="CheckBox" name="Images" value="False"> Suppress Images
Tracking Number:<BR> <INPUT NAME="PRO1" TYPE="text" SIZE=23
MAXLENGTH=23>
<INPUT NAME="submit" TYPE="submit" VALUE="Track">
</TD>
</TR>
</TABLE>
</CENTER>
</FORM>
The above lines provide the following results. Try it out!
Tracking with XML
Using the same format as above, you can return an XML stream of the data.
Simply call the Web page
http://forwarding.ups-scs.com/tracking/trackXML.asp with the querystring
parameters mentioned above. Notice that attaching the Images parameter will
have no effect on this page's output.
For example:
http://forwarding.ups-scs.com/tracking/trackXML.asp?optTYPE=REFNUM&PRO1=MyReferenceNumber
(This is only an example, and may not have actual shipments
associated with it.)
You can find the schemas for the XML file located at
http://forwarding.ups-scs.com/tracking/trackingschema.xml.
|