README

该仓库提供了一个客户端，用于与 DPD SOAP API 进行通信

安装

将 webit/dpd-client 添加到 composer.json

{
    "require": {
        "webit/dpd-client": "^1.0.0"
    }
}

DPDServices

创建 DPDServices 客户端

use Webit\DPDClient\DPDServices\Client\ClientFactory;
use Webit\DPDClient\DPDServices\Common\AuthDataV1;

$authData = new AuthDataV1('login', 'password', 123);

$clientFactory = new ClientFactory();

/** @var \Webit\DPDClient\DPDServices\Client $client */
$client = $clientFactory->create($authData);

// optionally pass the test WSDL path
use Webit\DPDClient\DPDServices\Client\ClientEnvironments;
$client = $clientFactory->create($authData, ClientEnvironments::wsdl(ClientEnvironments::TEST));

// optionally pass a custom WSDL path
use Webit\DPDClient\DPDServices\Client\ClientEnvironments;
$client = $clientFactory->create($authData, 'dpdservices.wsdl');

支持的客户端方法

 public function findPostalCodeV1(PostalCodeV1 $postalCodeV1): FindPostalCodeResponseV1;
 
 public function getCourierOrderAvailability(SenderPlaceV1 $senderPlaceV1): GetCourierOrderAvailabilityResponseV1;
 
 public function generatePackagesNumbersV1(OpenUMLF $openUMLF, PkgNumsGenerationPolicyEnumV1 $generationPolicy): PackagesGenerationResponseV1;
  
 public function generateSpedLabelsV1(DPDServicesParamsV1 $DPDServicesParamsV1, OutputDocFormatDSPEnumV1 $outputDocFormatV1 = null, OutputDocPageFormatDSPEnumV1 $outputDocPageFormatV1 = null): PackagesGenerationResponseV1;
 
 public function generateProtocolV1(DPDServicesParamsV1 $DPDServicesParamsV1, OutputDocFormatDSPEnumV1 $outputDocFormatV1 = null, OutputDocPageFormatDSPEnumV1 $outputDocPageFormatV1 = null): PackagesGenerationResponseV1;
 
 public function packagesPickupCallV1(DpdPickupCallParamsV1 $pickupCallParams): PackagesPickupCallResponseV1;
 
 public function packagesPickupCallV2(DpdPickupCallParamsV2 $pickupCallParams): PackagesPickupCallResponseV2;
 
 public function packagesPickupCallV3(DpdPickupCallParamsV3 $pickupCallParams): PackagesPickupCallResponseV3;
 
 public function importDeliveryBusinessEvent(DPDParcelBusinessEventV1 $businessEventV1): ImportDeliveryBusinessEventResponseV1;

DPDInfoServices

创建 DPDServices 客户端

use Webit\DPDClient\DPDInfoServices\Client\ClientFactory;
use Webit\DPDClient\DPDInfoServices\Common\AuthDataV1;

$authData = new AuthDataV1('login', 'password', 123);

$clientFactory = new ClientFactory();

/** @var \Webit\DPDClient\DPDInfoServices\Client $client */
$client = $clientFactory->create($authData);

// optionally pass the test WSDL path
use Webit\DPDClient\DPDInfoServices\Client\ClientEnvironments;
$client = $clientFactory->create($authData, ClientEnvironments::wsdl(ClientEnvironments::PROD));

// optionally pass a custom WSDL path
use Webit\DPDClient\DPDInfoServices\Client\ClientEnvironments;
$client = $clientFactory->create($authData, 'dpdinfoservices.wsdl');

支持的客户端方法

 public function getEventsForCustomerV1($limit): CustomerEventsResponseV1;
 
 public function getEventsForCustomerV2($limit, $language): CustomerEventsResponseV1;
 
 public function getEventsForCustomerV3($limit): CustomerEventsResponseV2;
 
 public function getEventsForCustomerV4($limit, $language): CustomerEventsResponseV3; 
 
 public function getEventsForWaybillV1($waybill, EventsSelectTypeEnum $eventSelectType, $language): CustomerEventsResponseV3;
 
 public function markEventsAsProcessedV1($confirmId): bool;
 

运行测试

单元/集成测试

./vendor/bin/phpunit

API 测试

要运行所有测试（单元和 API），需要更改 DPD 凭据

cp phpunit.xml.dist phpunit.xml
vim phpunit.xml

    <php>
        <env name="dpd.login" value="changeme"/>
        <env name="dpd.password" value="changeme"/>
        <env name="dpd.fid" value="changeme"/>
        <env name="dpd.wsdl" value="https://dpdservicesdemo.dpd.com.pl/DPDPackageObjServicesService/DPDPackageObjServices?wsdl"/>
    </php>

./vendor/bin/phpunit