Multi-Plant Management — Overview & module guide

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:

How to use in BIXCRM (daily operations)

  1. Sign in to the admin area with a role that includes Multi-Plant Management permissions.
  2. Open Multi Plant Management (sidebar) or search for Multi-Plant Management in the admin menu.
  3. Start on the Dashboard (if available) to see open tasks, pending approvals, and KPIs.
  4. Review Settings after upgrades — new options may need defaults for your company.
  5. Create or import master data first; most modules block transactions until masters exist.
  6. Run the main business flow (create → submit → approve → post/complete) using the screens listed in Admin menu below.
  7. Use Reports / Analytics screens to reconcile stock, finance, compliance, or SLA metrics.
  8. For integrations (API, EDI, gateways, tax), confirm credentials in Settings and monitor logs or webhook delivery screens.
  9. Train staff with role-based access — give approvers approve permissions only, operators create/edit on their area.
  10. 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 ✅

PhaseFeatures
-----------------
1Plant master, hierarchy, staff access, settings
2Warehouse/workstation mapping, plant switcher
3Inter-plant transfers + inventory sync
4Costing profiles, capacity calendar, reports
5REST API, webhooks, bulk import, cross-module filters

---

Quick Start

  1. Settings — Enable multi-plant mode, set default plant
  2. Plants → New Plant — Create your first manufacturing plant
  3. Assign staff and map warehouses/workstations
  4. Use the Active Plant switcher on the dashboard
  5. 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

EventTrigger
----------------
plant.createdNew plant via UI, API, or CSV import
transfer.receivedInter-plant transfer received

Signed with X-MPM-Signature: sha256=... when secret is configured.

---

Database Tables

TablePurpose
----------------
tblmpm_plantsPlant master
tblmpm_plant_staffStaff assignments
tblmpm_plant_warehousesWarehouse mappings
tblmpm_plant_workstationsWorkstation mappings
tblmpm_plant_transfersTransfer headers
tblmpm_plant_transfer_itemsTransfer lines
tblmpm_plant_costing_profilesCosting rates
tblmpm_plant_capacity_calendarShift/downtime calendar
tblmpm_api_keysREST API tokens
tblmpm_webhooksWebhook subscriptions
tblmpm_webhook_deliveriesDelivery log
tblmpm_integration_logsAPI/webhook/import audit
tblmpm_plant_logsGeneral audit trail

Options: mpm_db_version (104)

---

Permissions

FeatureCapabilities
-----------------------
mpm_dashboardview
mpm_plantsview, create, edit, delete
mpm_transfersview, create, edit, approve, receive
mpm_reportsview, export
mpm_integrationsview
mpm_api_keysview, create, edit, delete
mpm_webhooksview, create, edit, delete
mpm_importview, create
mpm_settingsview, 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

  1. Go to Setup → Modules and activate Multi-Plant Management.
  2. If prompted, click Upgrade Database or reload admin — migrations run automatically.
  3. Assign permissions under Setup → Staff → Roles.
  4. Open the module menu and configure settings.
  5. BIXCRM 3.0+
  6. PHP 7.4+ (8.1+ recommended)
  7. MySQL 5.7+ / MariaDB 10.3+ (InnoDB)
  8. PHP extensions: mysqli, json, mbstring, curl, fileinfo

Staff permissions (from module)

Assign under Setup → Staff → Roles. Each feature can expose different actions:

FeatureActions
Plant Dashboard
mpm_dashboard
view
Plants
mpm_plants
view, create, edit, delete
Inter-Plant Transfers
mpm_transfers
view, create, edit, approve, receive
Reports
mpm_reports
view, export
Settings
mpm_settings
view, edit
Integrations
mpm_integrations
view
API Keys
mpm_api_keys
view, create, edit, delete
Mpm Webhooks
mpm_webhooks
view, create, edit, delete
Bulk Import
mpm_import
view, create

One-time setup (first time only)

  1. Setup → Modules → activate Multi-Plant Management.
  2. Setup → Staff → Roles → assign Multi-Plant Management permissions (view, create, edit, delete, approve, export, settings as needed).
  3. Open Multi-Plant Management → Settings and complete company defaults, prefixes, integrations, and notification options.
  4. Create master data (warehouses, products, templates, accounts, routes, etc.) before processing live transactions.
  5. Enable BIXCRM cron (php /path/to/bixcrm/index.php cron/index) for sync, retries, alerts, and scheduled jobs.
  6. Optionally enable REST API / webhooks in module settings if you integrate external systems.

BIXCRM Knowledge Base — usage guide generated from module README and documentation.

Did you find this article useful?