msztorc / php-dpd-api
DPD Api
Installs: 18 857
Dependents: 1
Suggesters: 0
Security: 0
Stars: 20
Watchers: 3
Forks: 11
Open Issues: 3
Requires (Dev)
- phpunit/phpunit: 5.7.*
This package is auto-updated.
Last update: 2024-11-10 03:20:03 UTC
README
Set of PHP classes to handle API of courier services (DPD Poland)
Installation
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
Configuration file
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
Usage
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'); //wrong
For more examples see unit tests
Notes
For current API specification you should contact with IT support of DPD Poland. http://www.dpd.com.pl/
License
MIT