Set of PHP classes to handle API of courier services (DPD Poland)
composer require msztorc/php-dpd-api
or
git clone https://github.com/msztorc/php-dpd-api.git
of course you can also download zip file, unpack and include to your project
Main configuration is located in config.php file
'fid' => '1495',
'username' => 'test', // username for api calls
'password' => 'KqvsoFLT2M', // password for api calls
'wsdl' => 'https://dpdservicesdemo.dpd.com.pl/DPDPackageObjServicesService/DPDPackageObjServices?WSDL',
'lang_code' => 'PL', // lang code (required for api v2)
'api_version' => 2, // version of api methods (available api version: 1 or 2)
'debug' => true, // debug errors to logfile
'log_path' => 'logs' // path of log files
Full example
<?php
use DPD\Services\DPDService;
$sender = [
'fid' => '1495',
'name' => 'Janusz Biznesu',
'company' => 'INCO',
'address' => 'Chmielna 10',
'city' => 'Warszawa',
'postalCode' => '00999',
'countryCode' => 'PL',
'email'=> 'biuro@_inco.pl',
'phone' => '+22123456',
];
$dpd = new DPDService();
$dpd->setSender($sender);
$parcels = [
0 => [
'content' => 'antyramy',
'customerData1' => 'Uwaga szkło!',
'weight' => 8,
],
1 => [
'content' => 'ulotki',
'weight' => 5,
],
];
$receiver = [
'company' => 'ABC Sp. z o.o.',
'name' => 'Jan Kowalski',
'address' => 'Wielicka 10',
'city' => 'Krakow',
'postalCode' => '30552',
'countryCode' => 'PL',
'phone' => '+12 555221112',
'email'=> 'biuro@a_b_c.pl',
];
//send a package
$result = $dpd->sendPackage($parcels, $receiver, 'SENDER');
$pickupAddress = [
'fid' => '1495',
/*'name' => 'Janusz Biznesu',
'company' => 'INCO',
'address' => 'Chmielna 10',
'city' => 'Warszawa',
'postalCode' => '00999',
'countryCode' => 'PL',
'email'=> 'biuro@_inco.pl',
'phone' => '+22123456',*/
];
// generate speedlabel in default, pdf/a4 format
$speedlabel = $dpd->generateSpeedLabelsByPackageIds([$result->packageId], $pickupAddress);
// save speedlabel to pdf file
file_put_contents('pdf/slbl-pid' . $result->packageId . '.pdf', $speedlabel->filedata);
// generate protocol
$protocol = $dpd->generateProtocolByPackageIds([$result->packageId], $pickupAddress);
// save protocol to pdf file
file_put_contents('pdf/prot-pid' . $result->packageId . '.pdf', $protocol->filedata);
// pickup
$pickupDate = '2017-08-23';
$pickupTimeFrom = '13:00';
$pickupTimeTo = '16:00';
$contactInfo = [
'name' => 'Janusz Biznesu',
'company' => 'INCO',
'phone' => '12 5555555',
'email' => 'januszbiznesu@_inco.pl',
'comments' => 'proszę dzownić domofonem'
];
// pickup call
$pickup = $dpd->pickupRequest([$protocol->documentId], $pickupDate, $pickupTimeFrom, $pickupTimeTo, $contactInfo, $pickupAddress);Postcode verify
<?php
use DPD\Services\DPDService;
$dpd = new DPDService();
$pc1 = $dpd->checkPostCode('UB3 5HL', 'GB'); //ok
$pc2 = $dpd->checkPostCode('00-999', 'PL'); //ok
$pc3 = $dpd->checkPostCode('33 100'); //ok
$pc4 = $dpd->checkPostCode('33100'); //ok
$pc5 = $dpd->checkPostCode('00-000'); //wrongFor more examples see unit tests
For current API specification you should contact with IT support of DPD Poland. http://www.dpd.com.pl/
MIT