Download the PHP package smart-dato/gls-shop-returns-customer-sdk without Composer
On this page you can find all versions of the php package smart-dato/gls-shop-returns-customer-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download smart-dato/gls-shop-returns-customer-sdk
More information about smart-dato/gls-shop-returns-customer-sdk
Files in smart-dato/gls-shop-returns-customer-sdk
Package gls-shop-returns-customer-sdk
Short Description GLS Shop Returns Customer API SDK for Laravel
License MIT
Homepage https://github.com/smart-dato/gls-shop-returns-customer-sdk
Informations about the package gls-shop-returns-customer-sdk
GLS Shop Returns Customer SDK
Laravel package for integrating with the GLS Shop Returns Customer API v3. Supports generating return labels and parcel shop QR codes across European countries. Built on Saloon 3.x for HTTP and Spatie Laravel Data 4.x for DTOs.
Requirements
- PHP 8.4+
- Laravel 11 or 12
Supported Countries
Return labels can be generated from: AT, BE, BG, CH, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, HU, IE, IT, LT, LU, LV, NL, PL, PT, RO, SE, SI, SK.
Installation
Install the package via Composer:
Publish the config file:
Configuration
Add the following environment variables to your .env file:
The published config file (config/gls-shop-returns-customer-sdk.php) contains all available options:
Available environments:
| Environment | Base URL |
|---|---|
sandbox |
https://api-sandbox.gls-group.net/order-management/shop-returns/v3 |
qas |
https://api-qas.gls-group.net/order-management/shop-returns/v3 |
production |
https://api.gls-group.net/order-management/shop-returns/v3 |
Note: In the sandbox environment, use
sandboxas theGLS_APP_ID. Your real app ID is only for production.
Usage
Resolve the SDK from the container (or use the GlsShopReturnsCustomer facade):
Create a Return Order
Create a Return Order with Label (Base64)
Create a Return Order with Raw Label
Create a Return Order with QR Code
For parcel shop drop-off (supported in AT, BE, DE, DK, LU):
Retrieve a Label for an Existing Order
Optional Fields
Using the Facade
Available Enums
Error Handling
API errors are thrown as GlsApiException:
Testing
Sandbox Integration Tests
To run tests against the real GLS sandbox API:
- Copy
.env.testing.exampleto.env.testingand fill in your credentials - Run:
vendor/bin/pest --group=sandbox
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 gls-shop-returns-customer-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