itmosoft / laravel-shipping

v1.0.0 2026-11-05 06:13 UTC

Requires

• php: ^8.3
• illuminate/contracts: ^12.0|^13.0
• illuminate/database: ^12.0|^13.0
• illuminate/support: ^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^10.0|^11.0
• phpunit/phpunit: ^11.0|^12.0

MIT

• ecommerce
• laravel
• shipping
• delivery
• tracking
• rates

Published on Packagist.org on 2026-11-05 06:14 UTC

README

Shipping zones, methods, rates, quotes, shipments and tracking for Laravel 12 and 13.

Installation

composer require itmosoft/laravel-shipping
php artisan vendor:publish --tag=itmosoft-shipping-config
php artisan vendor:publish --tag=itmosoft-shipping-migrations
php artisan migrate

Configuration

Set table_prefix in config/itmosoft-shipping.php if you need prefixed tables. Default is shipping_.

Create a method, zone and rate

use ItmoSoft\Shipping\Models\ShippingMethod;
use ItmoSoft\Shipping\Models\ShippingZone;
use ItmoSoft\Shipping\Models\ShippingRate;

$method = ShippingMethod::create(['name' => 'Standard Delivery', 'code' => 'standard', 'is_active' => true]);
$zone = ShippingZone::create(['name' => 'Pakistan', 'is_active' => true]);
$zone->rules()->create(['type' => 'country', 'value' => 'PK']);
$method->rates()->create(['zone_id' => $zone->id, 'type' => 'flat', 'amount' => 500, 'currency' => 'PKR']);

Get a quote

use ItmoSoft\Shipping\Services\ShippingQuoteService;

$quote = app(ShippingQuoteService::class)->quote([
    'country' => 'PK', 'region' => 'Punjab', 'postal_code' => '60000',
], ['subtotal' => 10000, 'weight' => 2.5, 'currency' => 'PKR']);
// $quote is an array of available methods and calculated amounts.

Rate types: flat uses amount; weight uses amount per weight unit; subtotal uses amount as a percentage of order subtotal. Rates can set min_value and max_value for the relevant basis. All monetary values use decimal strings/numeric database values; choose one currency per quote context.

Create a shipment

use ItmoSoft\Shipping\Models\Shipment;

$shipment = Shipment::create([
    'order_id' => $order->id, 'shipping_method_id' => $method->id,
    'status' => 'pending', 'recipient' => ['name' => 'Customer', 'address' => 'Street'],
    'tracking_number' => 'TRACK-001',
]);
$shipment->recordEvent('picked_up', 'Parcel collected');

order_id is intentionally a scalar reference, not a foreign key, so the package does not require a specific Orders package/model. recipient is a JSON snapshot.

Events

• ItmoSoft\Shipping\Events\ShipmentCreated
• ItmoSoft\Shipping\Events\ShipmentStatusChanged

Tests

composer install
composer test

Boundaries

This package calculates configured rates and records shipments. It does not contact carriers, generate labels, guarantee delivery dates, calculate tax, or automatically reserve inventory. Validate shipping rules and prices for your business and jurisdictions.

License

MIT