Search by

phil / commerce-logistics-bundle

phil

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

Homepage

Type:symfony-bundle

pkg:composer/phil/commerce-logistics-bundle

Statistics

Installs: 0

Dependents: 1

Suggesters: 2

Stars: 0

Open Issues: 0

0.1.0-alpha 2026-11-20 22:00 UTC

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.