Oak Harbor Web Services

Shipment and Tracking Information documentation and example
The Shipment and Tracking Information web service provides you with the ability to request and receive information pertaining to a specified Pro Number's Origin, Destination, and Tracking Information.
You can use the WSDL located at HTTP://www.oakh.com/services/soap?wsdl as the basis for programming or configuring your own SOAP client.

Below is a PHP example of a SOAP client configuration that can access this web service.  This is provided as an example only and only intended to guide you on how you may want to go about creating your own client to get data from our web service.

$soapClient = new SoapClient("http://www.oakh.com/services/soap?wsdl"); $pro_or_bol = '12345678'; $result = $soapClient->getShipmentInfo($pro_or_bol);
As the code example shows, you will call the getShipmentInfo() with the input parameter being the 8-digit Pro Number or 20-digit Bol Number that corresponds to the information that you want to retreive. If an invalid Pro or Bol Number is requested or if any other error exists, a standard Soap Fault will be returned. Note that if you use the BOL number to call getShipmentInfo() the ProNumber tag in the response data will contain the BOL number and not the Pro number. The response data is nested on different levels as follows: ProNumber (20 Characters and may contain the BOL#. Label/Tag will always be ProNumber) DeliveryStatus (25 Character) StatusDate (mm/dd/yy) AppointmentDate (mm/dd/yy) Origin Code (7 Character) Name (30 Character) Address1 (30 Character) Address2 (30 Character) City (20 Character) State (2 Character) Zip (6 Character) PickupDate (mm/dd/yy) Destination Code (7 Character) Name (30 Character) Address1 (30 Character) Address2 (30 Character) City (20 Character) State (2 Character) Zip (6 Character) DeliveryDate (mm/dd/yy) DeliveryTime (mm/dd/yy) ReceivedBy (30 Character) Truck (15 Character) TraceData (Multiple TraceData elements will exist if there are multiple traces present) status (30 Character) fromName (25 Character) fromDate (mm/dd/yy) toName (25 Character) toDate (mm/dd/yy) The DeliveryStatus value will be one of the following values: At Origin Term Pickup Up Tendered to Agent Tendered to Partner In Transit Out for Delivery At Destination Terminal Spotted at Cons Location Delivered Returned Call for Status Master Bill Within TraceData, the value of the status field will be one of the following values: Begin central rating Central rate End central rating Added to file Audited Picked Up Late Pickup Late Pickup Removed Loaded Dispatched for delivery In transit between terminals In transit by contract carrier Arrived at break-bulk terminal Out for delivery Road manifest check-in Unloaded Delivery exception Delivered Delivery manifest check-in Arrived at destination terminal Accessorial added by Qtracs Close Guaranteed No Charge Applied Poor weather conditions Scanning of freight completed Update Below is an example of trace data from a well-formed request with a successful result.

Request Header
POST /services/soap HTTP/1.1
Host: www.oakh.com
Connection: Keep-Alive
User-Agent: PHP-SOAP/5.3.8-ZS5.5.0
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://www.oakh.com/services/soap#getShipmentInfo"
Content-Length: 241

Request Data
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.oakh.com/services/soap?wsdl">

Response Header
HTTP/1.1 200 OK
Date: Sun, 19 May 2013 00:04:50 GMT
Server: Apache
Content-Length: 1162
Connection: close
Content-Type: text/xml

Response Data
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.oakh.com/services/soap?wsdl" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
				<AppointmentDate xsi:nil="true"/>
					<Name>G3 MINING SUPPLY LLC</Name>
					<Address1>123 MAIN ST</Address1>
					<Name>REARDON METALS</Name>
					<Address1>302 GALTS GULCH AVE</Address1>
				<ReceivedBy>H REARDON</ReceivedBy>
					<status>Dispatched for delivery</status>
					<fromDate>05/03/13 09:00</fromDate>
					<toDate>05/03/13 19:52</toDate>