phil / commerce-wholesale-bundle
Wholesale for a Symfony shop on phil/commerce-bundle: customer groups with their prices and minimums, quantity rules per SKU, sales on credit with net terms.
Package info
github.com/parler-haut-interagir-librement/commerce-wholesale-bundle
Type:symfony-bundle
pkg:composer/phil/commerce-wholesale-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
- symfony/config: ^8.2
- symfony/dependency-injection: ^8.2
- symfony/uid: ^8.2
- symfony/validator: ^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-kernel: ^8.2
- symfony/translation: ^8.2
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-21 03:05:39 UTC
README
Customer groups with their own prices, minimum order and quantity rules, and sales on credit with net terms.
phil/commerce-wholesale-bundle sells to other businesses. A customer group has its own terms: a share off the base prices of products and a minimum order. Each buyer belongs to one group at most, and the module prices the products of an order for that group and tells what the order still lacks to reach the group's minimum. A SKU can be sold only by a minimum, up to a maximum and in steps of an increment, for every buyer or for one group: a constraint of Symfony's Validator, with its messages in English and French, checked again whenever the cart changes. A buyer can also buy on credit: an account with a limit and terms such as net 30, each purchase recorded as a receivable due after the terms, the buyer's payments applied to it, and what is overdue listed. The module does not send statements or reminders, and does not charge interest or late fees.
It is for an application that sells wholesale beside its retail prices. The buyer is named as the application names
it: an account, or the tenant of a multi-tenant application buying for its own customers. A group's own price list
is a price book of phil/commerce-catalog-bundle that names the group; the group's share applies only where no such
price book prices the product. An application that sells only at retail needs phil/commerce-bundle alone, and
perhaps its subscriptions.
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 groups, memberships, quantity rules, accounts and receivables. It plugs into
two ports of the core. GroupPrices is a unit price resolver asked after the catalogue's price books, and
QuantityGuard one asked before every price, which refuses a quantity its rule does not allow. A purchase on account is
a payment of the core with the method on_account, taken by AccountGateway, so refunds go through the core's payments
like any other.
Status
| Part | State |
|---|---|
| Customer groups, memberships | Implemented and tested |
| Group prices, minimum orders | Implemented and tested |
| Quantity rules per SKU and group: minimum, maximum, increment | Implemented and tested |
| Price lists per group | Through the catalogue's price books |
| Sales on credit: accounts, limits, terms, receivables, overdue | Implemented and tested |
Documentation
| Document | What it covers |
|---|---|
| Installation | Requirements, installing and registering the module beside the core. |
| Customer groups | Groups, memberships, which price a product takes, storage. |
| Quantity rules | Minimum, maximum and increment per SKU and group, the constraint, the cart, storage. |
| Sales on credit | Accounts, purchases on account, the buyer's payments, refunds, storage. |
| Scope | What the module holds, what it does not yet, and the port 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-wholesale-bundle
// config/bundles.php return [ // ... Phil\CommerceBundle\PhilCommerceBundle::class => ['all' => true], Phil\CommerceWholesaleBundle\PhilCommerceWholesaleBundle::class => ['all' => true], ];
Requirements
PHP 8.5 or later with ext-mbstring; phil/commerce-bundle, phil/ddd-bundle and phil/money 0.1; Doctrine ORM 3.7;
symfony/config, symfony/dependency-injection, symfony/uid and symfony/validator 8.2 or later.
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.