Skip to content
Business M

Warehouse & Inventory (WMS) Operational Guide

The Business M Warehouse Management System (WMS) provides high-throughput, production-grade inventory and supply chain operations. Built for enterprise scale, the system supports real-time ledger accounting, automated procurement, and multi-tenant supply operations running on a robust PostgreSQL database.

1. System Topology & Masters

Section titled “1. System Topology & Masters”

Business M coordinates replenishment and dispatch across a distributed hub-and-spoke enterprise topology:

graph TD
    HQ[Headquarters Procurement] --> DC[Distribution Center / Depot]
    DC -->|"Stock Transfer (Delivery Note)"| Outlet1[Retail Outlet A]
    DC -->|"Stock Transfer (Delivery Note)"| Outlet2[Retail Outlet B]
    Supplier[External Supplier] -->|"Receipt (GRN)"| DC

1.1 Core Entities & Master Records

Section titled “1.1 Core Entities & Master Records”
  1. Items: The central catalog containing item definitions, custom categories, stock keeping units (SKUs), and pricing parameters.
  2. Distribution Centers (Depots): Large warehouse hubs that ingest direct inventory from external suppliers via Goods Receipt Notes (GRN) and coordinate distribution.
  3. Retail Outlets (Outlets): Point-of-sale branches or distribution points that request inventory from DCs and service local customers.
  4. Suppliers: Verified third-party organizations registered to bid, submit quotes, and fulfill purchase orders.

1.2 Outlet Lifecycle Management

Section titled “1.2 Outlet Lifecycle Management”

Outlets follow a strict compliance-driven lifecycle within the plugin registry:

  • Registration: Onboarding via an OutletRegistration document detailing the manager name, division details, and store capacity.
  • Loan Coordination: Financial backing for outlet setup verified through a FinanceCleared and AccountsCleared workflow.
  • Dependency Adjustments: Dynamically altering which Distribution Center (DC) services an outlet based on regional optimization.
  • Merger & Termination: Orderly consolidation or closure of outlets with automated inventory evacuation to the parent DC.

2. Inventory & Ledger Accounting

Section titled “2. Inventory & Ledger Accounting”

Business M maintains absolute inventory integrity through double-entry style Stock Ledger Entries (SLE). Every material movement must generate a verifiable audit trail.

2.1 Stock Transactions

Section titled “2.1 Stock Transactions”
  • Stock Entry (Receipt): Initial ingestion or adjustment of stock. Updates the item balance and records moving average costs.
  • Stock Entry (Transfer): Moving items from a Distribution Center to a Retail Outlet. Locks the inventory in transit until verified by the receiving branch.
  • Stock Entry (Issue): Writing off damaged goods or issuing stock to regional departments.

2.2 Verifying Balances (The Bin System)

Section titled “2.2 Verifying Balances (The Bin System)”

Each combination of Item and Warehouse (DC or Outlet) maintains a real-time Bin projection:

  • Actual Qty: Physically present stock on hand.
  • Ordered Qty: Inventory committed on open Purchase Orders but not yet received.
  • Reserved Qty: Stock allocated to active customer orders but not yet dispatched.
  • Projected Qty: Actual Qty + Ordered Qty - Reserved Qty.

3. Supply Chain Workflows

Section titled “3. Supply Chain Workflows”

Business M automates core procurement processes from demand detection to supplier settlement:

sequenceDiagram
    participant Outlet as Retail Outlet
    participant DC as Distribution Center
    participant Supplier as Supplier Portal

    Outlet->>DC: Create Material Request (Demand)
    DC->>Supplier: Generate Purchase Order
    Supplier->>DC: Deliver Goods + Goods Receipt Note (GRN)
    DC->>Outlet: Deliver Stock + Delivery Note

3.1 Material Requests

Section titled “3.1 Material Requests”

Outlets submit a MaterialRequest to report stock demand:

  • Transfer Type: Requesting inventory replenishment from a Distribution Center.
  • Purchase Type: Requesting the Distribution Center to procure specialized items from external suppliers.

3.2 Purchase Orders & Goods Receipt Notes

Section titled “3.2 Purchase Orders & Goods Receipt Notes”
  • Purchase Order (PO): The official procurement contract sent to suppliers, derived from consolidated material requests.
  • Goods Receipt Note (GRN): The official document verifying the physical receipt of goods at the Distribution Center. Generates real-time ledger entries and prompts financial account adjustments.

4. Automated Replenishment & Demand Control

Section titled “4. Automated Replenishment & Demand Control”

To optimize inventory turnover and prevent cash blockages, Business M features an Automated Replenishment Engine:

4.1 Demand-Driven Ordering

Section titled “4.1 Demand-Driven Ordering”
  • Automated Purchase Requisitions: The system continuously monitors Bin projected quantities. When an item falls below its safety stock threshold, a replenishment order is automatically queued.
  • Purchase Limit Checks: Outlets are governed by credit and volume thresholds. Automated orders that exceed allocations are flagged for manager approval.
  • Substitute Denials: If an outlet requests a branded item that is out of stock, the system automatically suggests or substitutes a standard alternative according to pre-configured domain routing tables.

4.2 Direct Dispatches

Section titled “4.2 Direct Dispatches”

For high-priority bulk accounts, the WMS supports Direct Dispatch Orders (bypassing DC storage):

  • Suppliers receive a centralized Purchase Order.
  • The supplier ships inventory directly to the Retail Outlet.
  • The system registers a virtual receipt at the DC and an immediate virtual transfer to the outlet, preserving complete ledger transparency.

5. Supplier Portal Operations

Section titled “5. Supplier Portal Operations”

External vendors interact with Business M through a secured Supplier Portal:

  • Onboarding: Verification of company tax identifiers, business credentials, and bank details.
  • Pricing Revisions: Submitting updated price lists for review. Revisions undergo multi-stage manager validation before updating the active item master.
  • Financial Guarantees: Suppliers submit Bank Guarantees as earnest performance deposits. The WMS tracks guarantee dates and alerts administrators prior to expiry.

6. High-Throughput Data Ingestion

Section titled “6. High-Throughput Data Ingestion”

For legacy system migrations or daily franchise uploads, the WMS supports high-velocity bulk data processing:

  • Centralized Imports: Depots upload spreadsheets containing daily demands and stock balances from hundreds of regional outlets.
  • Data Validation: Dynamic schema validation guarantees that all items, suppliers, and outlets exist in the active PostgreSQL database before processing.
  • Variance Reporting: The system auto-calculates discrepancies between reported store inventories and active stock ledger projections, generating detailed reconciliation backlog files.