wheesnoza/laravel-ship24

A Ship24 API Rapper for Laravel.

v2.0.1 2026-02-15 06:27 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^11.0|^12.0
• spatie/laravel-data: ^4.19.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.63
• laravel/boost: ^1.0
• orchestra/testbench: ^10.9.0
• phpstan/phpstan: ^1.12
• phpunit/phpunit: ^11.5.3

MIT

• wheesnoza

• package
• api
• laravel
• tracking
• ship24

README

Laravel Ship24 is a powerful package that integrates the Ship24 API seamlessly into your Laravel application. With this package, you can easily track shipments, create new trackers, and manage your tracking information.

Features

• Easy Installation: Quickly set up and integrate the Ship24 API.
• API Integration: Full support for Ship24's tracking API.
• Extensible: Customize and extend the package according to your needs.
• Compatible with Laravel 11 and 12: Works with the latest versions of Laravel.

Compatibility

• Laravel: 11, 12
• PHP: 8.2+
• Dependencies: illuminate/contracts, spatie/laravel-data are aligned for Laravel 11/12 support

Support Policy

• Latest Laravel major version (currently 12) is supported.
• Previous major version (11) is supported when compatible with current dependencies.
• Compatibility validation status is documented below.

Verification Status

• Laravel 12: Verified via package tests (Service/Facade regression, request configuration)
• Laravel 11: Supported via dependency constraints; verification ongoing

Known Limitations

• Ship24 API availability impacts runtime behavior; errors are surfaced from the HTTP client.
• Compatibility is limited to documented Laravel/PHP versions.

Breaking Changes

• No breaking changes introduced for Laravel 12 compatibility.
• If breaking changes are required in the future, alternatives and migration steps will be documented in the release notes.

Installation

You can install the package via Composer:

composer require wheesnoza/laravel-ship24

After installing, you may publish the configuration file:

php artisan vendor:publish --provider="Wheesnoza\Ship24\Providers\Ship24ServiceProvider" --tag=config

Configuration

The package requires an API token, which you should add to your .env file:

SHIP24_ACCESS_TOKEN=your-access-token

Usage

Retrieve a Tracker by ID

use Wheesnoza\Ship24\Facades\Ship24;

$tracker = Ship24::tracker('TRACKER_ID');

Retrieve Multiple Trackers

use Wheesnoza\Ship24\Facades\Ship24;

$trackers = Ship24::trackers();

Create a New Tracker

use Wheesnoza\Ship24\Facades\Ship24;

$tracker = Ship24::createTracker('TRACKING_NUMBER');

Testing

To run the tests, execute the following command:

composer test

Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue on GitHub.

License

This package is open-sourced software licensed under the MIT license.