Module: Multi-Plant Management v1.4.0
Enterprise multi-plant hierarchy, access control, and inter-plant operations for BIXCRM
Screen-by-screen guides (each tab explained)
Click a menu item below for step-by-step instructions on that Multi-Plant Management screen:
- Plant Dashboard
- Plants
- Plant Hierarchy
- Inter-Plant Transfers
- Costing Profiles
- Capacity Calendar
- Reports
- Integrations
- Settings
How to use in BIXCRM (daily operations)
- Sign in to the admin area with a role that includes Multi-Plant Management permissions.
- Open Multi Plant Management (sidebar) or search for Multi-Plant Management in the admin menu.
- Start on the Dashboard (if available) to see open tasks, pending approvals, and KPIs.
- Review Settings after upgrades — new options may need defaults for your company.
- Create or import master data first; most modules block transactions until masters exist.
- Run the main business flow (create → submit → approve → post/complete) using the screens listed in Admin menu below.
- Use Reports / Analytics screens to reconcile stock, finance, compliance, or SLA metrics.
- For integrations (API, EDI, gateways, tax), confirm credentials in Settings and monitor logs or webhook delivery screens.
- Train staff with role-based access — give approvers approve permissions only, operators create/edit on their area.
- If something fails overnight, check BIXCRM cron ran and open the module log / failed queue screen if present.
Admin menu — where to work
Open the Multi-Plant Management section in the admin sidebar. Screens your staff may use (depending on role):
- API Keys
- Bulk Import
- Capacity Calendar
- Costing Profiles
- Integrations
- Inter-Plant Transfers
- Mpm Webhooks
- Multi-Plant
- Plant Dashboard
- Plant Hierarchy
- Plants
- Reports
- Settings
Detailed guide — features, workflows, API & FAQ
All Phases Complete ✅
| Phase | Features |
|---|---|
| ------- | ---------- |
| 1 | Plant master, hierarchy, staff access, settings |
| 2 | Warehouse/workstation mapping, plant switcher |
| 3 | Inter-plant transfers + inventory sync |
| 4 | Costing profiles, capacity calendar, reports |
| 5 | REST API, webhooks, bulk import, cross-module filters |
---
Quick Start
- Settings — Enable multi-plant mode, set default plant
- Plants → New Plant — Create your first manufacturing plant
- Assign staff and map warehouses/workstations
- Use the Active Plant switcher on the dashboard
- Integrations — Configure API keys, webhooks, bulk import
---
REST API
Base URL: /multi_plant_management/multi_plant_management_api
GET /plants List plants
POST /plants Create plant (write scope)
GET /plants/{id} Get plant
GET /transfers List transfers
GET /transfers/{id} Get transfer
GET /context Active plant context
POST /context Set active plant
Authentication: Authorization: Bearer mpm_... or header X-MPM-API-Key
---
Webhooks
| Event | Trigger |
|---|---|
| ------- | --------- |
plant.created | New plant via UI, API, or CSV import |
transfer.received | Inter-plant transfer received |
Signed with X-MPM-Signature: sha256=... when secret is configured.
---
Database Tables
| Table | Purpose |
|---|---|
| ------- | --------- |
tblmpm_plants | Plant master |
tblmpm_plant_staff | Staff assignments |
tblmpm_plant_warehouses | Warehouse mappings |
tblmpm_plant_workstations | Workstation mappings |
tblmpm_plant_transfers | Transfer headers |
tblmpm_plant_transfer_items | Transfer lines |
tblmpm_plant_costing_profiles | Costing rates |
tblmpm_plant_capacity_calendar | Shift/downtime calendar |
tblmpm_api_keys | REST API tokens |
tblmpm_webhooks | Webhook subscriptions |
tblmpm_webhook_deliveries | Delivery log |
tblmpm_integration_logs | API/webhook/import audit |
tblmpm_plant_logs | General audit trail |
Options: mpm_db_version (104)
---
Permissions
| Feature | Capabilities |
|---|---|
| --------- | -------------- |
mpm_dashboard | view |
mpm_plants | view, create, edit, delete |
mpm_transfers | view, create, edit, approve, receive |
mpm_reports | view, export |
mpm_integrations | view |
mpm_api_keys | view, create, edit, delete |
mpm_webhooks | view, create, edit, delete |
mpm_import | view, create |
mpm_settings | view, edit |
---
Integration API
mpm_get_plant_warehouses($plant_id);
mpm_get_active_plant_cost_center_id();
mpm_dispatch_webhook($event, $data);
hooks()->apply_filters('mpm_journal_entry_defaults', $defaults);
hooks()->apply_filters('manufacturing_dashboard_stats', $stats);
hooks()->apply_filters('purchase_management_dashboard_stats', $stats);
---
Features
Enterprise multi-plant hierarchy, access control, and inter-plant operations for BIXCRM
See README.md in the module folder for the complete feature list.
Permissions
Granular staff capabilities are registered on activation. Assign them under Setup → Staff → Roles for the Multi-Plant Management capability group.
Typical capabilities include view, create, edit, delete, plus module-specific actions (approve, export, settings, API access).
Cron Jobs
Background tasks (if enabled) run through BIXCRM's main cron. Example crontab (every 5 minutes):
* * * * * php /path/to/bixcrm/index.php cron/index > /dev/null 2>&1
Check module settings for scheduled jobs (alerts, sync, reports, retention).
After activation — configuration checklist
- Go to Setup → Modules and activate Multi-Plant Management.
- If prompted, click Upgrade Database or reload admin — migrations run automatically.
- Assign permissions under Setup → Staff → Roles.
- Open the module menu and configure settings.
- BIXCRM 3.0+
- PHP 7.4+ (8.1+ recommended)
- MySQL 5.7+ / MariaDB 10.3+ (InnoDB)
- PHP extensions: mysqli, json, mbstring, curl, fileinfo
One-time setup (first time only)
- Setup → Modules → activate Multi-Plant Management.
- Setup → Staff → Roles → assign Multi-Plant Management permissions (view, create, edit, delete, approve, export, settings as needed).
- Open Multi-Plant Management → Settings and complete company defaults, prefixes, integrations, and notification options.
- Create master data (warehouses, products, templates, accounts, routes, etc.) before processing live transactions.
- Enable BIXCRM cron (
php /path/to/bixcrm/index.php cron/index) for sync, retries, alerts, and scheduled jobs. - Optionally enable REST API / webhooks in module settings if you integrate external systems.
BIXCRM Knowledge Base — usage guide generated from module README and documentation.