Download the PHP package smart-dato/dhl-parcel-returns-sdk without Composer
On this page you can find all versions of the php package smart-dato/dhl-parcel-returns-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download smart-dato/dhl-parcel-returns-sdk
More information about smart-dato/dhl-parcel-returns-sdk
Files in smart-dato/dhl-parcel-returns-sdk
Package dhl-parcel-returns-sdk
Short Description Laravel SDK for the DHL Parcel DE Returns API
License MIT
Homepage https://github.com/smart-dato/dhl-parcel-returns-sdk
Informations about the package dhl-parcel-returns-sdk
DHL Parcel DE Returns SDK for Laravel
A Laravel package for the DHL Parcel DE Returns API. Create return labels on demand and look up return receiver locations. Built on Saloon and Spatie Laravel Data.
Installation
Publish the config file:
Add your credentials to .env:
OAuth2 mode is enabled automatically when DHL_PARCEL_RETURNS_CLIENT_SECRET is set
together with the API key, username and password. The SDK then exchanges the
credentials for a Bearer token against the DHL ROPC token endpoint and caches
the token in memory until it expires.
Usage
Create a return label
International returns with customs (CN23)
Look up return locations
All filters are optional — call ->get() with no arguments to list every receiver
configured for your account.
API version (healthcheck)
This endpoint requires no authentication.
Using without the Facade
You can create a DhlParcelReturns instance directly using DhlParcelReturns::make().
This is useful when you prefer not to use the facade, need different credentials per
request, or want to support multi-tenant setups:
You can also optionally pass a custom base_url if needed:
Label types
| Enum | Returns |
|---|---|
LabelType::ShipmentLabel |
Shipment label only |
LabelType::QrLabel |
QR label only |
LabelType::Both |
Both documents (default) |
Error handling
Any non-2xx response throws a SmartDato\DhlParcelReturns\Exceptions\DhlParcelReturnsApiException.
It parses the DHL RFC 7807 error body, exposing the title/detail as the message and
the HTTP status as the code:
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- SmartDato
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of dhl-parcel-returns-sdk with dependencies
illuminate/contracts Version ^11.0||^12.0||^13.0
saloonphp/saloon Version ^4.0
spatie/laravel-data Version ^4.20
spatie/laravel-package-tools Version ^1.16