Merge pull request #151 from runningrandall/update-tracking-wsdl

Update track service to 19

Author: JeremyDunn

examples/track-by-id.php

@@ -22,7 +22,7 @@
 
 // Version
 $trackRequest->Version->ServiceId = 'trck';
-$trackRequest->Version->Major = 16;
+$trackRequest->Version->Major = 19;
 $trackRequest->Version->Intermediate = 0;
 $trackRequest->Version->Minor = 0;
 

src/FedEx/TrackService/ComplexType/Commodity.php

@@ -185,7 +185,7 @@ public function setUnitPrice(Money $unitPrice)
     }
 
     /**
-     * Set CustomsValue
+     * The value of the commodity for customs purposes. The field should be the unit price multiplied by the quantity.
      *
      * @param Money $customsValue
      * @return $this

src/FedEx/TrackService/ComplexType/ContentRecord.php

@@ -4,7 +4,7 @@
 use FedEx\AbstractComplexType;
 
 /**
- * ContentRecord
+ * Details the contents of the package.
  *
  * @author      Jeremy Dunn <jeremy@jsdunn.info>
  * @package     PHP FedEx API wrapper

src/FedEx/TrackService/ComplexType/TrackDetail.php

@@ -33,11 +33,12 @@
  * @property Dimensions $PackageDimensions
  * @property Weight $PackageDimensionalWeight
  * @property Weight $ShipmentWeight
- * @property string $Packaging
- * @property \FedEx\TrackService\SimpleType\PackagingType|string $PackagingType
+ * @property TrackPackagingDescriptionDetail $Packaging
  * @property \FedEx\TrackService\SimpleType\PhysicalPackagingType|string $PhysicalPackagingType
  * @property int $PackageSequenceNumber
  * @property int $PackageCount
+ * @property int $ShipmentContentPieceCount
+ * @property int $PackageContentPieceCount
  * @property string $CreatorSoftwareId
  * @property TrackChargeDetail[] $Charges
  * @property string $NickName
@@ -46,6 +47,7 @@
  * @property ContentRecord[] $ShipmentContents
  * @property string[] $PackageContents
  * @property string $ClearanceLocationCode
+ * @property \FedEx\TrackService\SimpleType\ClearanceBrokerageType|string $ClearanceBrokerage
  * @property Commodity[] $Commodities
  * @property TrackReturnDetail $ReturnDetail
  * @property CustomsOptionDetail[] $CustomsOptionDetails
@@ -372,29 +374,17 @@ public function setShipmentWeight(Weight $shipmentWeight)
     }
 
     /**
-     * Retained for legacy compatibility only.
+     * Specifies details about packaging such as packaging description and type.
      *
-     * @param string $packaging
+     * @param TrackPackagingDescriptionDetail $packaging
      * @return $this
      */
-    public function setPackaging($packaging)
+    public function setPackaging(TrackPackagingDescriptionDetail $packaging)
     {
         $this->values['Packaging'] = $packaging;
         return $this;
     }
 
-    /**
-     * Strict representation of the Packaging type (e.g. FEDEX_BOX, YOUR_PACKAGING).
-     *
-     * @param \FedEx\TrackService\SimpleType\PackagingType|string $packagingType
-     * @return $this
-     */
-    public function setPackagingType($packagingType)
-    {
-        $this->values['PackagingType'] = $packagingType;
-        return $this;
-    }
-
     /**
      * Set PhysicalPackagingType
      *
@@ -431,6 +421,30 @@ public function setPackageCount($packageCount)
         return $this;
     }
 
+    /**
+     * Set ShipmentContentPieceCount
+     *
+     * @param int $shipmentContentPieceCount
+     * @return $this
+     */
+    public function setShipmentContentPieceCount($shipmentContentPieceCount)
+    {
+        $this->values['ShipmentContentPieceCount'] = $shipmentContentPieceCount;
+        return $this;
+    }
+
+    /**
+     * Set PackageContentPieceCount
+     *
+     * @param int $packageContentPieceCount
+     * @return $this
+     */
+    public function setPackageContentPieceCount($packageContentPieceCount)
+    {
+        $this->values['PackageContentPieceCount'] = $packageContentPieceCount;
+        return $this;
+    }
+
     /**
      * FOR FEDEX INTERNAL USE ONLY: Specifies the software id of the device that was used to create this tracked shipment.
      *
@@ -527,6 +541,18 @@ public function setClearanceLocationCode($clearanceLocationCode)
         return $this;
     }
 
+    /**
+     * Set ClearanceBrokerage
+     *
+     * @param \FedEx\TrackService\SimpleType\ClearanceBrokerageType|string $clearanceBrokerage
+     * @return $this
+     */
+    public function setClearanceBrokerage($clearanceBrokerage)
+    {
+        $this->values['ClearanceBrokerage'] = $clearanceBrokerage;
+        return $this;
+    }
+
     /**
      * Set Commodities
      *

src/FedEx/TrackService/ComplexType/TrackEvent.php

@@ -15,6 +15,7 @@
  * @property string $EventDescription
  * @property string $StatusExceptionCode
  * @property string $StatusExceptionDescription
+ * @property \FedEx\TrackService\SimpleType\BarcodeEntryType|string $BarcodeEntryType
  * @property Address $Address
  * @property string $StationId
  * @property \FedEx\TrackService\SimpleType\ArrivalLocationType|string $ArrivalLocation
@@ -89,6 +90,18 @@ public function setStatusExceptionDescription($statusExceptionDescription)
         return $this;
     }
 
+    /**
+     * Set BarcodeEntryType
+     *
+     * @param \FedEx\TrackService\SimpleType\BarcodeEntryType|string $barcodeEntryType
+     * @return $this
+     */
+    public function setBarcodeEntryType($barcodeEntryType)
+    {
+        $this->values['BarcodeEntryType'] = $barcodeEntryType;
+        return $this;
+    }
+
     /**
      * Address information of the station that is responsible for the scan.
      *

src/FedEx/TrackService/ComplexType/TrackPackagingDescriptionDetail.php

@@ -0,0 +1,49 @@
+<?php
+namespace FedEx\TrackService\ComplexType;
+
+use FedEx\AbstractComplexType;
+
+/**
+ * TrackPackagingDescriptionDetail
+ *
+ * @author      Jeremy Dunn <jeremy@jsdunn.info>
+ * @package     PHP FedEx API wrapper
+ * @subpackage  Package Movement Information Service
+ *
+ * @property string $Type
+ * @property string $Description
+
+ */
+class TrackPackagingDescriptionDetail extends AbstractComplexType
+{
+    /**
+     * Name of this complex type
+     *
+     * @var string
+     */
+    protected $name = 'TrackPackagingDescriptionDetail';
+
+    /**
+     * Strict representation of the Packaging Type (e.g. FEDEX_SMALL_BOX, YOUR_PACKAGING)
+     *
+     * @param string $type
+     * @return $this
+     */
+    public function setType($type)
+    {
+        $this->values['Type'] = $type;
+        return $this;
+    }
+
+    /**
+     * A description of the packaging.
+     *
+     * @param string $description
+     * @return $this
+     */
+    public function setDescription($description)
+    {
+        $this->values['Description'] = $description;
+        return $this;
+    }
+}

src/FedEx/TrackService/ComplexType/TrackServiceDescriptionDetail.php

@@ -10,7 +10,7 @@
  * @package     PHP FedEx API wrapper
  * @subpackage  Package Movement Information Service
  *
- * @property \FedEx\TrackService\SimpleType\ServiceType|string $Type
+ * @property string $Type
  * @property string $Description
  * @property string $ShortDescription
 
@@ -25,9 +25,9 @@ class TrackServiceDescriptionDetail extends AbstractComplexType
     protected $name = 'TrackServiceDescriptionDetail';
 
     /**
-     * Set Type
+     * This field contains the service type values, like PRIORITY_OVERNIGHT and FEDEX_GROUND.
      *
-     * @param \FedEx\TrackService\SimpleType\ServiceType|string $type
+     * @param string $type
      * @return $this
      */
     public function setType($type)

src/FedEx/TrackService/ComplexType/TrackSpecialHandling.php

@@ -10,7 +10,7 @@
  * @package     PHP FedEx API wrapper
  * @subpackage  Package Movement Information Service
  *
- * @property \FedEx\TrackService\SimpleType\TrackSpecialHandlingType|string $Type
+ * @property string $Type
  * @property string $Description
  * @property \FedEx\TrackService\SimpleType\TrackPaymentType|string $PaymentType
 
@@ -25,9 +25,9 @@ class TrackSpecialHandling extends AbstractComplexType
     protected $name = 'TrackSpecialHandling';
 
     /**
-     * Set Type
+     * Identifies the type of track special handling on the package.
      *
-     * @param \FedEx\TrackService\SimpleType\TrackSpecialHandlingType|string $type
+     * @param string $type
      * @return $this
      */
     public function setType($type)

src/FedEx/TrackService/Request.php

@@ -15,7 +15,7 @@ class Request extends AbstractRequest
     const PRODUCTION_URL = 'https://ws.fedex.com:443/web-services/track';
     const TESTING_URL = 'https://wsbeta.fedex.com:443/web-services/track';
 
-    protected static $wsdlFileName = 'TrackService_v16.wsdl';
+    protected static $wsdlFileName = 'TrackService_v19.wsdl';
 
     /**
      * Sends the TrackRequest and returns the response

src/FedEx/TrackService/SimpleType/BarcodeEntryType.php

@@ -0,0 +1,17 @@
+<?php
+namespace FedEx\TrackService\SimpleType;
+
+use FedEx\AbstractSimpleType;
+
+/**
+ * BarcodeEntryType
+ *
+ * @author      Jeremy Dunn <jeremy@jsdunn.info>
+ * @package     PHP FedEx API wrapper
+ * @subpackage  Package Movement Information Service
+ */
+class BarcodeEntryType extends AbstractSimpleType
+{
+    const _MANUAL_ENTRY = 'MANUAL_ENTRY';
+    const _SCAN = 'SCAN';
+}