dhl / sdk-api-parcel-de
DHL Parcel DE Shipping API SDK
Requires
- php: ^8.1.0
- ext-json: *
- league/openapi-psr7-validator: ^0.22.0
- netresearch/jsonmapper: ^4.0.0
- php-http/discovery: ^1.17.0
- php-http/httplug: ^2.2.0
- php-http/logger-plugin: ^1.2.1
- psr/http-client: ^1.0.1
- psr/http-client-implementation: ^1.0.0
- psr/http-factory: ^1.0.0
- psr/http-factory-implementation: ^1.0.0
- psr/http-message: ^1.0.0 || ^2.0.0
- psr/http-message-implementation: ^1.0.0 || ^2.0.0
- psr/log: ^1.1.0 || ^2.0.0 || ^3.0.0
Requires (Dev)
- fig/log-test: ^1.1.0
- nyholm/psr7: ^1.0.0
- php-http/mock-client: ^1.5.0
- phpstan/phpstan: ^1.5.0
- phpunit/phpunit: ^10.1.0
- rector/rector: *
- squizlabs/php_codesniffer: ^3.4
This package is auto-updated.
Last update: 2024-10-28 10:49:02 UTC
README
The DHL Parcel DE Shipping API SDK package offers an interface to the following web services:
Requirements
System Requirements
- PHP 8.1+ with SOAP and JSON extension
Package Requirements
league/openapi-psr7-validator
: Schema validator for JSON request messagesnetresearch/jsonmapper
: Mapper for deserialization of JSON response messages into PHP objectsphp-http/discovery
: Discovery service for HTTP client and message factory implementationsphp-http/httplug
: Pluggable HTTP client abstractionphp-http/logger-plugin
: HTTP client logger plugin for HTTPlugpsr/http-client
: PSR-18 HTTP client interfacespsr/http-factory
: PSR-7 HTTP message factory interfacespsr/http-message
: PSR-7 HTTP message interfacespsr/log
: PSR-3 logger interfaces
Virtual Package Requirements
psr/http-client-implementation
: Any package that provides a PSR-18 compatible HTTP clientpsr/http-factory-implementation
: Any package that provides PSR-7 compatible HTTP message factoriespsr/http-message-implementation
: Any package that provides PSR-7 HTTP messages
Development Package Requirements
fig/log-test
: PSR-3 logger implementation for testing purposesnyholm/psr7
: PSR-7 HTTP message factory & message implementationphpunit/phpunit
: Testing frameworkphp-http/mock-client
: HTTPlug mock client implementationphpstan/phpstan
: Static analysis toolrector/rector
: Automatic refactoring tool to help with PHP upgradessquizlabs/php_codesniffer
: Static analysis tool
Installation
$ composer require dhl/sdk-api-parcel-de
Uninstallation
$ composer remove dhl/sdk-api-parcel-de
Testing
$ ./vendor/bin/phpunit -c test/phpunit.xml
Features
The DHL Parcel DE Shipping API SDK supports the following features:
- Validate Shipment
- Create Shipment Order
- Delete Shipment Order
Authentication
The DHL Parcel DE Shipping API requires a two-level authentication (see API User Guide):
- The application submits a Consumer Key Header ("API Key") that must be created in the DHL API Developer Portal.
- The user is identified via HTTP Basic Authentication with credentials configured in the DHL Business Customer Portal.
These credentials are passed to the SDK via \Dhl\Sdk\ParcelDe\Shipping\Api\Data\AuthenticationStorageInterface
.
Create your own or use the default implementation:
$authStorage = new \Dhl\Sdk\ParcelDe\Shipping\Auth\AuthenticationStorage('apiKey', 'user', 'password');
Validate Shipment
Validate shipments for DHL Paket including the relevant shipping documents.
Public API
The library's components suitable for consumption comprise
- services:
- service factory
- shipment service
- data transfer object builder
- data transfer objects:
- authentication storage
- order/label settings
- validation result with status message
Usage
$logger = new \Psr\Log\NullLogger(); $serviceFactory = new \Dhl\Sdk\ParcelDe\Shipping\Service\ServiceFactory(); $service = $serviceFactory->createShipmentService($authStorage, $logger, $sandbox = true); $requestBuilder = new \Dhl\Sdk\ParcelDe\Shipping\RequestBuilder\ShipmentOrderRequestBuilder(); $requestBuilder->setShipperAccount($billingNumber = '33333333330101'); $requestBuilder->setShipperAddress( company: 'DHL', country: 'DEU', postalCode: '53113', city: 'Bonn', street: 'Charles-de-Gaulle-Straße', streetNumber: '20' ); $requestBuilder->setRecipientAddress( recipientName: 'Jane Doe', recipientCountry: 'DEU', recipientPostalCode: '53113', recipientCity: 'Bonn', recipientStreet: 'Sträßchensweg', recipientStreetNumber: '2' ); $requestBuilder->setShipmentDetails(productCode: 'V01PAK', shipmentDate: new \DateTimeImmutable('2023-02-23')); $requestBuilder->setPackageDetails(weightInKg: 2.4); $shipmentOrder = $requestBuilder->create(); $result = $service->validateShipments([$shipmentOrder]);
Create Shipment Order
Create shipments for DHL Paket including the relevant shipping documents. In addition to the primary shipment data (shipper, consignee, etc.), further settings can be defined per request via the order configuration object, including label printing size, profile, and more.
Public API
The library's components suitable for consumption comprise
- services:
- service factory
- shipment service
- data transfer object builder
- data transfer objects:
- authentication storage
- order/label settings
- shipment with shipment/tracking number and label(s)
Usage
$logger = new \Psr\Log\NullLogger(); $serviceFactory = new \Dhl\Sdk\ParcelDe\Shipping\Service\ServiceFactory(); $service = $serviceFactory->createShipmentService($authStorage, $logger, sandbox: true); $orderConfiguration = new \Dhl\Sdk\ParcelDe\Shipping\Service\ShipmentService\OrderConfiguration( mustEncode: true, combinedPrinting: null, docFormat: \Dhl\Sdk\ParcelDe\Shipping\Api\Data\OrderConfigurationInterface::DOC_FORMAT_PDF, printFormat: \Dhl\Sdk\ParcelDe\Shipping\Api\Data\OrderConfigurationInterface::PRINT_FORMAT_A4 ); $requestBuilder = new \Dhl\Sdk\ParcelDe\Shipping\RequestBuilder\ShipmentOrderRequestBuilder(); $requestBuilder->setShipperAccount(billingNumber: '33333333330101'); $requestBuilder->setShipperAddress( company: 'DHL', country: 'DEU', postalCode: '53113', city: 'Bonn', streetName: 'Charles-de-Gaulle-Straße', streetNumber: '20' ); $requestBuilder->setRecipientAddress( name: 'Jane Doe', countryCode: 'DEU', postalCode: '53113', city: 'Bonn', streetName: 'Sträßchensweg', streetNumber: '2' ); $requestBuilder->setShipmentDetails(productCode: 'V01PAK', shipmentDate: new \DateTimeImmutable('2023-02-23')); $requestBuilder->setPackageDetails(weightInKg: 2.4); $shipmentOrder = $requestBuilder->create(); $shipments = $service->createShipments([$shipmentOrder], $orderConfiguration);
Delete Shipment Order
Cancel earlier created shipments.
Public API
The library's components suitable for consumption comprise
- services:
- service factory
- shipment service
- data transfer objects:
- authentication storage
Usage
$logger = new \Psr\Log\NullLogger(); $serviceFactory = new \Dhl\Sdk\ParcelDe\Shipping\Service\ServiceFactory(); $service = $serviceFactory->createShipmentService($authStorage, $logger, sandbox: true); $shipmentNumber = '333301011234567890'; $cancelled = $service->cancelShipments([$shipmentNumber]);