BusinessShipment.php

Go to the documentation of this file.

<?php

namespace Petschko\DHL;

use Exception;
use SoapClient;
use SoapHeader;
use stdClass;

class BusinessShipment extends Version {
    const DHL_WSDL_LIB_URL = 'https://cig.dhl.de/cig-wsdls/com/dpdhl/wsdl/geschaeftskundenversand-api/';

    const DHL_SOAP_HEADER_URI = 'http://dhl.de/webservice/cisbase';

    const DHL_SANDBOX_URL = 'https://cig.dhl.de/services/sandbox/soap';

    const DHL_PRODUCTION_URL = 'https://cig.dhl.de/services/production/soap';

    const NEWEST_VERSION = '2.2';

    const RESPONSE_TYPE_URL = 'URL';

    const RESPONSE_TYPE_B64 = 'B64';

    const MAX_DHL_REQUESTS = 30;

    // System-Fields
    private $soapClient = null;

    private $errors = array();

    // Setting-Fields
    private $test;

    private $log = false;

    // Object-Fields
    private $credentials;

    private $shipmentDetails;

    private $service = null;

    private $bank = null;

    private $sender = null;

    private $receiver = null;

    private $returnReceiver = null;

    private $exportDocument = null;

    // Fields
    private $sequenceNumber = '1';

    private $receiverEmail = null;

    private $printOnlyIfReceiverIsValid = null;

    private $labelResponseType = null;

    private $shipmentOrders = array();

    private $customAPIURL = null;

    public function __construct($credentials, $testMode = false, $version = null) {
        // Set Version
        if($version === null)
            $version = self::NEWEST_VERSION;

        parent::__construct($version);

        // Set Test-Mode
        $this->setTest((($testMode) ? true : false));

        // Set Credentials
        if($this->isTest()) {
            $c = new Credentials($testMode);
            $c->setApiUser($credentials->getApiUser());
            $c->setApiPassword($credentials->getApiPassword());

            $credentials = $c;
        }

        $this->setCredentials($credentials);

        // @deprecated Set Shipment-Class for Backward-Compatibility todo remove in newer versions
        $this->shipmentDetails = new ShipmentDetails($credentials->getEkp(10) . '0101');
    }

    public function __destruct() {
        parent::__destruct();
        unset($this->soapClient);
        unset($this->errors);
        unset($this->test);
        unset($this->log);
        unset($this->credentials);
        unset($this->shipmentDetails);
        unset($this->service);
        unset($this->bank);
        unset($this->sender);
        unset($this->receiver);
        unset($this->returnReceiver);
        unset($this->exportDocument);
        unset($this->sequenceNumber);
        unset($this->receiverEmail);
        unset($this->printOnlyIfReceiverIsValid);
        unset($this->labelResponseType);
        unset($this->shipmentOrders);
        unset($this->customAPIURL);
    }

    protected function getAPIUrl() {
        // Use own API-URL if set
        if($this->getCustomAPIURL() !== null)
            return $this->getCustomAPIURL();

        return self::DHL_WSDL_LIB_URL . $this->getVersion() . '/geschaeftskundenversand-api-' . $this->getVersion() . '.wsdl';
    }

    private function getSoapClient() {
        if($this->soapClient === null)
            $this->buildSoapClient();

        return $this->soapClient;
    }

    public function getLastXML() {
        if($this->soapClient === null)
            return null;

        return $this->getSoapClient()->__getLastRequest();
    }

    private function setSoapClient($soapClient) {
        $this->soapClient = $soapClient;
    }

    public function getErrors() {
        return $this->errors;
    }

    public function setErrors($errors) {
        $this->errors = $errors;
    }

    private function addError($error) {
        $this->errors[] = $error;
    }

    private function isTest() {
        return $this->test;
    }

    private function setTest($test) {
        $this->test = $test;
    }

    public function isLog() {
        return $this->log;
    }

    public function setLog($log) {
        $this->log = $log;
    }

    private function getCredentials() {
        return $this->credentials;
    }

    public function setCredentials($credentials) {
        $this->credentials = $credentials;
    }

    public function getShipmentDetails() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        return $this->shipmentDetails;
    }

    public function setShipmentDetails($shipmentDetails) {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        $this->shipmentDetails = $shipmentDetails;
    }

    public function getService() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentDetails` Object, please do/get them there and assign the' .
            ' `ShipmentDetails` Object to the `ShipmentOrder` Object by using `setShipmentDetails($shipmentDetails)`' .
            ' on the Shipment instance!',
            E_USER_DEPRECATED
        );

        return $this->service;
    }

    public function setService($service) {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentDetails` Object, please do/get them there and assign the' .
            ' `ShipmentDetails` Object to the `ShipmentOrder` Object by using `setShipmentDetails($shipmentDetails)`' .
            ' on the Shipment instance!',
            E_USER_DEPRECATED
        );

        $this->service = $service;
    }

    public function getBank() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentDetails` Object, please do/get them there and assign the' .
            ' `ShipmentDetails` Object to the `ShipmentOrder` Object by using `setShipmentDetails($shipmentDetails)`' .
            ' on the Shipment instance!',
            E_USER_DEPRECATED
        );

        return $this->bank;
    }

    public function setBank($bank) {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentDetails` Object, please do/get them there and assign the' .
            ' `ShipmentDetails` Object to the `ShipmentOrder` Object by using `setShipmentDetails($shipmentDetails)`' .
            ' on the Shipment instance!',
            E_USER_DEPRECATED
        );

        $this->bank = $bank;
    }

    public function getSender() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        return $this->sender;
    }

    public function setSender($sender) {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        $this->sender = $sender;
    }

    public function getReceiver() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        return $this->receiver;
    }

    public function setReceiver($receiver) {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        $this->receiver = $receiver;
    }

    public function getReturnReceiver() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        return $this->returnReceiver;
    }

    public function setReturnReceiver($returnReceiver) {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        $this->returnReceiver = $returnReceiver;
    }

    public function getExportDocument() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        return $this->exportDocument;
    }

    public function setExportDocument($exportDocument) {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        $this->exportDocument = $exportDocument;
    }

    public function getSequenceNumber() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        return $this->sequenceNumber;
    }

    public function setSequenceNumber($sequenceNumber) {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        $this->sequenceNumber = $sequenceNumber;
    }

    public function getReceiverEmail() {
        trigger_error('[DHL-PHP-SDK]: Called deprecated method ' . __METHOD__ . ' in class ' . __CLASS__ .
            '. The notification E-Mail (or receiver E-Mail) was moved into the ShipmentDetail class!' .
            ' Please use the new function, this here will removed in the future!', E_USER_DEPRECATED);

        return $this->receiverEmail;
    }

    public function setReceiverEmail($receiverEmail) {
        trigger_error('[DHL-PHP-SDK]: Called deprecated method ' . __METHOD__ . ' in class ' . __CLASS__ .
            '. The notification E-Mail (or receiver E-Mail) was moved into the ShipmentDetail class!' .
            ' Please use the new function, this here will removed in the future!', E_USER_DEPRECATED);

        $this->receiverEmail = $receiverEmail;
    }

    public function getPrintOnlyIfReceiverIsValid() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        return $this->printOnlyIfReceiverIsValid;
    }

    public function setPrintOnlyIfReceiverIsValid($printOnlyIfReceiverIsValid) {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' These details belong to the `ShipmentOrder` Object, please do/get them there and assign the' .
            ' `ShipmentOrder` Object to this Object by using `addShipmentOrder($shipmentOrder)` on this instance!',
            E_USER_DEPRECATED
        );

        $this->printOnlyIfReceiverIsValid = $printOnlyIfReceiverIsValid;
    }

    public function getLabelResponseType() {
        return $this->labelResponseType;
    }

    public function setLabelResponseType($labelResponseType) {
        $this->labelResponseType = $labelResponseType;
    }

    public function getShipmentOrders() {
        return $this->shipmentOrders;
    }

    public function setShipmentOrders($shipmentOrders) {
        if(! is_array($shipmentOrders)) {
            trigger_error(
                '[DHL-PHP-SDK]: The type of $shipmentOrders is NOT an array, but is required to set as array! Called method ' .
                __METHOD__ . ' in class ' . __CLASS__,
                E_USER_ERROR
            );
            $this->addError(__METHOD__ . ': Non-Array value given');

            return;
        }

        $this->shipmentOrders = $shipmentOrders;
    }

    public function addShipmentOrder($shipmentOrder) {
        $this->shipmentOrders[] = $shipmentOrder;
    }

    public function clearShipmentOrders() {
        $this->setShipmentOrders(array());
    }

    public function countShipmentOrders() {
        return count($this->getShipmentOrders());
    }

    public function getCustomAPIURL() {
        return $this->customAPIURL;
    }

    public function setCustomAPIURL($customAPIURL) {
        $this->customAPIURL = $customAPIURL;
    }

    private function checkRequestCount($array, $action, $maxReq = self::MAX_DHL_REQUESTS) {
        $count = count($array);

        if($count > self::MAX_DHL_REQUESTS)
            $this->addError('There are only ' . $maxReq . ' Request/s for one call allowed for the action "'
                . $action . '"! You tried to request ' . $count . ' ones');
    }

    private function log($message, $errorLevel = E_USER_NOTICE) {
        if($this->isLog()) {
            if(is_array($message) || is_object($message))
                error_log(print_r($message, true), $errorLevel);
            else
                error_log($message, $errorLevel);
        }
    }

    private function buildAuthHeader() {
        $auth_params = array(
            'user' => $this->getCredentials()->getUser(),
            'signature' => $this->getCredentials()->getSignature(),
            'type' => 0
        );

        return new SoapHeader(self::DHL_SOAP_HEADER_URI, 'Authentification', $auth_params);
    }

    private function buildSoapClient() {
        $header = $this->buildAuthHeader();

        if($this->isTest())
            $location = self::DHL_SANDBOX_URL;
        else
            $location = self::DHL_PRODUCTION_URL;

        $auth_params = array(
            'login' => $this->getCredentials()->getApiUser(),
            'password' => $this->getCredentials()->getApiPassword(),
            'location' => $location,
            'trace' => 1
        );

        $this->log($auth_params);
        $this->setSoapClient(new SoapClient($this->getAPIUrl(), $auth_params));
        $this->getSoapClient()->__setSoapHeaders($header);
        $this->log($this->getSoapClient());
    }

    public function getVersion($viaSOAP = false, $getBuildNumber = false, $returnAsArray = false) {
        if(! $viaSOAP) {
            if($returnAsArray)
                return array(
                    'mayor' => parent::getMayor(),
                    'minor' => parent::getMinor()
                );
            else
                return parent::getVersion();
        }

        switch($this->getMayor()) {
            case 1:
                trigger_error('[DHL-PHP-SDK]: Called Version 1 Method: ' . __METHOD__ . ' is incomplete (does nothing)!', E_USER_WARNING);
                $this->addError('Version 1 SOAP-Method "' . __METHOD__ . '" is not implemented or removed!');

                return false;
            case 2:
            default:
                $data = $this->getVersionClass();
        }

        try {
            $response = $this->sendGetVersionRequest($data);
        } catch(Exception $e) {
            $this->addError($e->getMessage());

            return false;
        }

        if(is_soap_fault($response)) {
            $this->addError($response->faultstring);

            return false;
        } else {
            if($returnAsArray)
                return array(
                    'mayor' => $response->Version->majorRelease,
                    'minor' => $response->Version->minorRelease,
                    'build' => $response->Version->build
                );
            else
                return $response->Version->majorRelease . '.' . $response->Version->minorRelease .
                    (($getBuildNumber) ? '.' . $response->Version->build : '');
        }
    }

    private function sendGetVersionRequest($data) {
        return $this->getSoapClient()->getVersion($data);
    }

    private function sendDoManifestRequest($data) {
        switch($this->getMayor()) {
            case 1:
                return $this->getSoapClient()->DoManifestTD($data);
            case 2:
            default:
                return $this->getSoapClient()->doManifest($data);
        }
    }

    public function doManifest($shipmentNumbers) {
        switch($this->getMayor()) {
            case 1:
                $data = $this->createDoManifestClass_v1($shipmentNumbers);
                break;
            case 2:
            default:
                $data = $this->createDoManifestClass_v2($shipmentNumbers);
        }

        try {
            $response = $this->sendDoManifestRequest($data);
        } catch(Exception $e) {
            $this->addError($e->getMessage());

            return false;
        }

        if(is_soap_fault($response)) {
            $this->addError($response->faultstring);

            return false;
        } else
            return new Response($this->getVersion(), $response);
    }

    private function createDoManifestClass_v1($shipmentNumbers) {
        trigger_error('[DHL-PHP-SDK]: Version 1 Methods are deprecated and will removed soon (Called method ' . __METHOD__ . ')!', E_USER_DEPRECATED);
        trigger_error('[DHL-PHP-SDK]: Called Version 1 Method: ' . __METHOD__ . ' is incomplete (does nothing)!', E_USER_WARNING);

        $data = new StdClass;

        return $data;
    }

    private function createDoManifestClass_v2($shipmentNumbers) {
        $data = new StdClass;

        $data->Version = $this->getVersionClass();

        if(is_array($shipmentNumbers)) {
            $this->checkRequestCount($shipmentNumbers, 'doManifest');

            foreach($shipmentNumbers as $key => &$number)
                $data->shipmentNumber[$key] = $number;
        } else
            $data->shipmentNumber = $shipmentNumbers;

        return $data;
    }

    public function getManifest($manifestDate, $useIntTime = false) {
        if($useIntTime) {
            // Convert to Date-Format for DHL
            $oldDate = $manifestDate;
            $manifestDate = date('Y-m-d', $manifestDate);

            if($manifestDate === false) {
                $this->addError('Could not convert given time() value "' . $oldDate . '" to YYYY-MM-DD... Called method: ' . __METHOD__);

                return false;
            }

            unset($oldDate);
        }

        switch($this->getMayor()) {
            case 1:
                trigger_error('[DHL-PHP-SDK]: Called Version 1 Method: ' . __METHOD__ . ' is incomplete (does nothing)!', E_USER_WARNING);
                $this->addError('Version 1 Method "' . __METHOD__ . '" is not implemented or removed!');

                return false;
            case 2:
            default:
                $data = $this->createGetManifestClass_v2($manifestDate);
        }

        try {
            $response = $this->sendGetManifestRequest($data);
        } catch(Exception $e) {
            $this->addError($e->getMessage());

            return false;
        }

        if(is_soap_fault($response)) {
            $this->addError($response->faultstring);

            return false;
        } else
            return new Response($this->getVersion(), $response);
    }

    private function createGetManifestClass_v2($manifestDate) {
        $data = new StdClass;

        if(is_array($manifestDate))
            $this->addError('You can only request 1 date on getManifest - multiple requests in 1 call are not allowed here');

        $data->Version = $this->getVersionClass();
        $data->manifestDate = $manifestDate;

        return $data;
    }

    private function sendGetManifestRequest($data) {
        return $this->getSoapClient()->getManifest($data);
    }

    private function sendCreateRequest($data) {
        switch($this->getMayor()) {
            case 1:
                return $this->getSoapClient()->CreateShipmentDD($data);
            case 2:
            default:
                return $this->getSoapClient()->createShipmentOrder($data);
        }
    }

    public function createShipment() {
        return $this->createShipmentOrder();
    }

    public function createShipmentOrder() {
        switch($this->getMayor()) {
            case 1:
                $data = $this->createShipmentClass_v1();
                break;
            case 2:
            default:
                if($this->countShipmentOrders() < 1)
                    $data = $this->createShipmentClass_v2_legacy();
                else
                    $data = $this->createShipmentClass_v2();
        }

        $response = null;

        // Create Shipment
        try {
            $response = $this->sendCreateRequest($data);
        } catch(Exception $e) {
            $this->addError($e->getMessage());

            return false;
        }

        if(is_soap_fault($response)) {
            $this->addError($response->faultstring);

            return false;
        } else
            return new Response($this->getVersion(), $response);
    }

    private function createShipmentClass_v1() {
        trigger_error('[DHL-PHP-SDK]: Version 1 Methods are deprecated and will removed soon (Called method ' . __METHOD__ . ')!', E_USER_DEPRECATED);
        trigger_error('[DHL-PHP-SDK]: Called Version 1 Method: ' . __METHOD__ . ' is incomplete (does nothing)!', E_USER_WARNING);

        $data = new StdClass;

        return $data;
    }

    private function createShipmentClass_v2() {
        $shipmentOrders = $this->getShipmentOrders();

        $this->checkRequestCount($shipmentOrders, 'createShipmentClass');

        $data = new StdClass;
        $data->Version = $this->getVersionClass();

        foreach($shipmentOrders as $key => &$shipmentOrder) {
            // Set global response-type if none is defined in shipment
            if($shipmentOrder->getLabelResponseType() === null && $this->getLabelResponseType() !== null)
                $shipmentOrder->setLabelResponseType($this->getLabelResponseType());

            $data->ShipmentOrder[$key] = $shipmentOrder->getShipmentOrderClass_v2(); // todo test
        }

        return $data;
    }

    private function createShipmentClass_v2_legacy() {
        trigger_error(
            '[DHL-PHP-SDK]: ' . __CLASS__ . '->' . __METHOD__ .
            ' This method was called for Backward-Compatibility, please create `ShipmentOrder` Objects' .
            ' and assign them with `addShipmentOrder($shipmentOrder)` on this instance.',
            E_USER_DEPRECATED
        );

        // Set old values
        $this->getShipmentDetails()->setService($this->getService());
        $this->getShipmentDetails()->setBank($this->getBank());

        // Create class
        $data = new StdClass;
        $data->Version = $this->getVersionClass();
        $data->ShipmentOrder = new StdClass;
        $data->ShipmentOrder->sequenceNumber = $this->getSequenceNumber();

        // Shipment
        $data->ShipmentOrder->Shipment = new StdClass;
        $data->ShipmentOrder->Shipment->ShipmentDetails = $this->getShipmentDetails()->getShipmentDetailsClass_v2();

        // Notification
        $email = null; // Check for backward compatibility
        if($this->getShipmentDetails()->getNotificationEmail() === null && $this->receiverEmail !== null)
            $email = $this->getReceiverEmail(); // Use old E-Mail implementation for BC

        if($email !== null) {
            $data->ShipmentOrder->Shipment->ShipmentDetails->Notification = new StdClass;
            $data->ShipmentOrder->Shipment->ShipmentDetails->Notification->recipientEmailAddress = $email;
        }

        // Shipper
        $data->ShipmentOrder->Shipment->Shipper = $this->getSender()->getClass_v2();

        // Receiver
        $data->ShipmentOrder->Shipment->Receiver = $this->getReceiver()->getClass_v2();

        // Return-Receiver
        if($this->getReturnReceiver() !== null)
            $data->ShipmentOrder->Shipment->ReturnReceiver = $this->getReturnReceiver()->getClass_v2();

        // Export-Document
        if($this->getExportDocument() !== null) {
            try {
                $data->ShipmentOrder->Shipment->ExportDocument = $this->getExportDocument()->getExportDocumentClass_v2();
            } catch(Exception $e) {
                $this->addError($e->getMessage());
            }
        }

        // Other Settings
        if($this->getPrintOnlyIfReceiverIsValid() !== null) {
            $data->ShipmentOrder->PrintOnlyIfCodeable = new StdClass;
            $data->ShipmentOrder->PrintOnlyIfCodeable->active = (int) $this->getPrintOnlyIfReceiverIsValid();
        }
        if($this->getLabelResponseType() !== null)
            $data->ShipmentOrder->labelResponseType = $this->getLabelResponseType();

        return $data;
    }

    private function sendDeleteRequest($data) {
        switch($this->getMayor()) {
            case 1:
                return $this->getSoapClient()->DeleteShipmentDD($data);
            case 2:
            default:
                return $this->getSoapClient()->deleteShipmentOrder($data);
        }
    }

    public function deleteShipment($shipmentNumbers) {
        return $this->deleteShipmentOrder($shipmentNumbers);
    }

    public function deleteShipmentOrder($shipmentNumbers) {
        switch($this->getMayor()) {
            case 1:
                $data = $this->createDeleteClass_v1($shipmentNumbers);
                break;
            case 2:
            default:
                $data = $this->createDeleteClass_v2($shipmentNumbers);
        }

        try {
            $response = $this->sendDeleteRequest($data);
        } catch(Exception $e) {
            $this->addError($e->getMessage());

            return false;
        }

        if(is_soap_fault($response)) {
            $this->addError($response->faultstring);

            return false;
        } else
            return new Response($this->getVersion(), $response);
    }

    private function createDeleteClass_v1($shipmentNumbers) {
        trigger_error('[DHL-PHP-SDK]: Version 1 Methods are deprecated and will removed soon (Called method ' . __METHOD__ . ')!', E_USER_DEPRECATED);
        trigger_error('[DHL-PHP-SDK]: Called Version 1 Method: ' . __METHOD__ . ' is incomplete (does nothing)!', E_USER_WARNING);

        $data = new StdClass;

        return $data;
    }

    private function createDeleteClass_v2($shipmentNumbers) {
        $data = new StdClass;

        $data->Version = $this->getVersionClass();

        if(is_array($shipmentNumbers)) {
            $this->checkRequestCount($shipmentNumbers, 'deleteShipmentOrder');

            foreach($shipmentNumbers as $key => &$number)
                $data->shipmentNumber[$key] = $number;
        } else
            $data->shipmentNumber = $shipmentNumbers;

        return $data;
    }

    private function sendGetLabelRequest($data) {
        switch($this->getMayor()) {
            case 1:
                return $this->getSoapClient()->getLabelDD($data);
            case 2:
            default:
                return $this->getSoapClient()->getLabel($data);
        }
    }

    public function getShipmentLabel($shipmentNumbers) {
        return $this->getLabel($shipmentNumbers);
    }

    public function getLabel($shipmentNumbers) {
        switch($this->getMayor()) {
            case 1:
                $data = $this->getLabelClass_v1($shipmentNumbers);
                break;
            case 2:
            default:
                $data = $this->getLabelClass_v2($shipmentNumbers);
        }

        try {
            $response = $this->sendGetLabelRequest($data);
        } catch(Exception $e) {
            $this->addError($e->getMessage());

            return false;
        }

        if(is_soap_fault($response)) {
            $this->addError($response->faultstring);

            return false;
        } else
            return new Response($this->getVersion(), $response);
    }

    private function getLabelClass_v1($shipmentNumbers) {
        trigger_error('[DHL-PHP-SDK]: Version 1 Methods are deprecated and will removed soon (Called method ' . __METHOD__ . ')!', E_USER_DEPRECATED);
        trigger_error('[DHL-PHP-SDK]: Called Version 1 Method: ' . __METHOD__ . ' is incomplete (does nothing)!', E_USER_WARNING);

        $data = new StdClass;

        return $data;
    }

    private function getLabelClass_v2($shipmentNumbers) {
        $data = new StdClass;

        $data->Version = $this->getVersionClass();

        if(is_array($shipmentNumbers)) {
            $this->checkRequestCount($shipmentNumbers, 'getLabel');

            foreach($shipmentNumbers as $key => &$number)
                $data->shipmentNumber[$key] = $number;
        } else
            $data->shipmentNumber = $shipmentNumbers;

        if($this->getLabelResponseType() !== null)
            $data->labelResponseType = $this->getLabelResponseType();

        return $data;
    }

    private function sendGetExportDocRequest($data) {
        switch($this->getMayor()) {
            case 1:
                return $this->getSoapClient()->getExportDocDD($data);
            case 2:
            default:
                return $this->getSoapClient()->getExportDoc($data);
        }
    }

    public function getExportDoc($shipmentNumbers) {
        switch($this->getMayor()) {
            case 1:
                $data = $this->getExportDocClass_v1($shipmentNumbers);
                break;
            case 2:
            default:
                $data = $this->getExportDocClass_v2($shipmentNumbers);
        }

        try {
            $response = $this->sendGetExportDocRequest($data);
        } catch(Exception $e) {
            $this->addError($e->getMessage());

            return false;
        }

        if(is_soap_fault($response)) {
            $this->addError($response->faultstring);

            return false;
        } else
            return new Response($this->getVersion(), $response);
    }

    private function getExportDocClass_v1($shipmentNumbers) {
        trigger_error('[DHL-PHP-SDK]: Version 1 Methods are deprecated and will removed soon (Called method ' . __METHOD__ . ')!', E_USER_DEPRECATED);
        trigger_error('[DHL-PHP-SDK]: Called Version 1 Method: ' . __METHOD__ . ' is incomplete (does nothing)!', E_USER_WARNING);

        $data = new StdClass;

        return $data;
    }

    private function getExportDocClass_v2($shipmentNumbers) {
        $data = new StdClass;

        $data->Version = $this->getVersionClass();

        if(is_array($shipmentNumbers)) {
            $this->checkRequestCount($shipmentNumbers, 'getExportDoc');

            foreach($shipmentNumbers as $key => &$number)
                $data->shipmentNumber[$key] = $number;
        } else
            $data->shipmentNumber = $shipmentNumbers;

        if($this->getLabelResponseType() !== null)
            $data->exportDocResponseType = $this->getLabelResponseType();

        return $data;
    }

    public function validateShipment() {
        switch($this->getMayor()) {
            case 1:
                $data = null;
                break;
            case 2:
            default:
                $data = $this->createShipmentClass_v2();
        }

        try {
            $response = $this->sendValidateShipmentRequest($data);
        } catch(Exception $e) {
            $this->addError($e->getMessage());

            return false;
        }

        if(is_soap_fault($response)) {
            $this->addError($response->faultstring);

            return false;
        } else
            return new Response($this->getVersion(), $response);
    }

    private function sendValidateShipmentRequest($data) {
        switch($this->getMayor()) {
            case 1:
                throw new Exception(__FUNCTION__ . ': Method doesn\'t exists for Version 1!');
            case 2:
            default:
                return $this->getSoapClient()->validateShipment($data);
        }
    }
}