phil / commerce-logistics-bundle
Stock, shipments and delivery for a Symfony shop on phil/commerce-bundle: every movement journaled, reservations, carriers' rates and labels, convention stock.
Package info
github.com/parler-haut-interagir-librement/commerce-logistics-bundle
Type:symfony-bundle
pkg:composer/phil/commerce-logistics-bundle
Requires
- php: >=8.5
- ext-mbstring: *
- doctrine/orm: ^3.7
- phil/commerce-bundle: ^0.2@dev || ^0.3@dev
- phil/ddd-bundle: ^0.1@dev
- phil/money: ^0.1@dev
- phil/url: ^0.1@dev
- psr/clock: ^1.0
- symfony/clock: ^8.2
- symfony/config: ^8.2
- symfony/dependency-injection: ^8.2
- symfony/http-client-contracts: ^3.6
- symfony/polyfill-php86: ^1.37
- symfony/service-contracts: ^3.6
- symfony/uid: ^8.2
Requires (Dev)
- doctrine/dbal: ^4.5
- doctrine/doctrine-bundle: ^3.3
- doctrine/persistence: ^4.1
- phpunit/phpunit: ^13.4
- psr/log: ^3.0
- symfony/event-dispatcher: ^8.2
- symfony/framework-bundle: ^8.2
- symfony/http-client: ^8.2
- symfony/http-kernel: ^8.2
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-21 03:05:53 UTC
README
Stock per location, order reservations, backorders, purchasing, serial numbers, parcels and their documents, delivery charged per zone, and carriers' rates and labels.
phil/commerce-logistics-bundle keeps the physical side of an order. It holds stock per SKU and location, with a journal of every movement: units received, counted and transferred, goods received against purchase orders, and the serial number of each unit that has one. It reserves the product lines of a placed order from the open locations by priority, sells a SKU without stock when its flag allows it, releases them, and ships them in one parcel or several, each with its carrier, tracking number and delivery note, after a picking slip, alone or in a planned shipping wave. It keeps the stock prepared for conventions, size by size, and sends the shirts of an order placed online to print while a convention is near. It offers delivery methods per zone (shipping, local delivery, pickup), each with a price, a free threshold and an estimated number of days, and charges the method the order chose. It asks carriers for their rates and labels, and records what each shipment really cost beside the delivery price the buyer paid; Canada Post is its first carrier adapter.
It is for a shop that sells goods it holds on a shelf. An application that sells access, downloads or services needs
only phil/commerce-bundle, and perhaps its subscriptions. A product never received anywhere is not tracked, so a
shop can mix both. The module does not handle supplier returns, replenishment or forecasts, it never sets the delivery
price from a carrier's rate, and it does not tax a delivery charge.
It is a Symfony bundle and a module of phil/commerce-bundle: it refuses to load without the core, and registers its
services with DoctrineBundle, which stores all of it. It plugs into the core through its ports: ShippingProcessor
is an order processor after the promotions and before the taxes, and adds the delivery charge to the order;
DeferredStock holds and frees the stock of the core's sales paid later; the delivery note and the picking slip are
numbered by the core's register of document types. Each stock level carries a version column, which refuses two
movements made over the same copy.
Status
| Part | State |
|---|---|
| Locations, stock levels, journal, receiving, counts, transfers | Implemented and tested |
| Reservations of placed orders, released or shipped; backorders; the stock of deferred sales | Implemented and tested |
| Convention stock, print on demand for orders placed online | Implemented and tested |
| Purchase orders and their receipts, serial numbers | Implemented and tested |
| Shipments: an order in one parcel or several, carrier and tracking | Implemented and tested |
| Delivery notes, picking slips, shipping waves | Implemented and tested |
| Delivery methods per zone, free threshold, delivery charges | Implemented and tested |
| Carriers' rates and labels, the cost of each shipment, Canada Post | Implemented and tested; Canada Post's field names not yet compared with its OpenAPI document |
Documentation
| Document | What it covers |
|---|---|
| Installation | Requirements, installing and registering the module beside the core. |
| Stock | Locations, levels, the journal, receiving, counts, transfers, reservations, backorders, deferred sales, storage. |
| Conventions | The stock prepared per convention, what is left to print, orders placed online sent to print. |
| Purchasing | Purchase orders and their receipts; the serial number of each unit. |
| Delivery | Delivery methods, what an order pays, storage. |
| Shipments | Shipping an order in one parcel or several, what is left, delivery notes, picking slips, waves, storage. |
| Carriers | Rates and labels, the cost of each shipment against the delivery charged, Canada Post. |
| Scope | What the module holds, what lies outside it, and the ports of the core it implements. |
| Extension points | What an application implements, configures, replaces or relies on. |
| Testing | How the module is tested, and how to run its tests. |
| Reference | Every public type of the module. |
Quick start
composer require phil/commerce-bundle phil/commerce-logistics-bundle
// config/bundles.php return [ // ... Phil\CommerceBundle\PhilCommerceBundle::class => ['all' => true], Phil\CommerceLogisticsBundle\PhilCommerceLogisticsBundle::class => ['all' => true], ];
Requirements
PHP 8.5 or later with ext-mbstring; phil/commerce-bundle, phil/ddd-bundle, phil/money and phil/url 0.1;
Doctrine ORM 3.7; symfony/uid, symfony/clock, symfony/config and symfony/dependency-injection 8.2 or later;
symfony/http-client-contracts and symfony/service-contracts 3.6; symfony/polyfill-php86 1.37; psr/clock 1.0. The Canada Post adapter needs an
HTTP client, symfony/http-client through FrameworkBundle.
Contributing
Contributions are welcome on the PHIL monorepo: read the contribution guide and the code of conduct. Report a vulnerability privately, as the security policy explains, never in a public issue.
License
MIT, © Philippe Gamache, doing business as Le Gnome Archiviste; a Parler Haut Interagir Librement project. See LICENSE.