Stock Balance Applet

⚠️
Under Review: This applet is still under review.

Purpose and Overview

The Stock Balance Applet provides a live, consolidated view of inventory quantities across your organization. It helps you understand what is on hand, where it is stored, and how balances change across locations.

ℹ️
Core Concept: Stock balance is the live quantity derived from all inbound and outbound inventory transactions, summarized by Item and Location.
ℹ️
Read-Only View: This applet does not create or edit stock. All quantities are updated by inventory transactions from other applets (sales, purchase, adjustment, and transfers).

Purpose: Provide a single source of truth for on-hand quantities by item and location.

Target Users: Warehouse teams, inventory controllers, purchasing and sales coordinators, and finance or audit teams.

Key Features:

  • Real-time stock balance listing with grouping and pivoting
  • Advanced search and filtering by item type, location, and balance
  • Integration with inventory transactions across related applets

Key Features Overview

Who Benefits from This Applet?

Warehouse and Store Teams:

  • Confirm stock on hand before picking and issuing
  • Locate inventory by location
  • Identify stock shortages early

Inventory Controllers:

  • Monitor balance accuracy across locations
  • Investigate discrepancies using listing filters and exports
  • Standardize stock visibility across branches

Purchasing and Sales Teams:

  • Validate availability before ordering or quoting
  • Avoid overstocking by checking real-time balances
  • Reduce missed sales due to inaccurate availability

Finance and Audit Teams:

  • Verify inventory quantities for reconciliation
  • Support audits with exports and related transaction documents
  • Reduce write-offs by spotting anomalies early

What Problems Does This Solve?

The Stock Visibility Problem:

  • Stock data spread across multiple documents and teams
  • Delayed updates after transactions
  • Time-consuming balance checks before sales or purchases

The Stock Balance Applet Solution:

  • Live balance view with item and location grouping
  • Advanced filtering by item type and balance criteria
  • Integration ready with all inbound and outbound inventory flows

Key Features Overview

Stock balance applet overview
Stock balance applet overview infographic.

Key Concepts

Understanding Stock Balance

Stock balance is the live quantity of an item in the system after all movements are applied.

TermMeaning
Opening BalanceQuantity on hand at the start of a period or snapshot
Inbound MovementsPurchases, returns in, adjustments in, transfers in
Outbound MovementsSales, issues, adjustments out, transfers out
Current BalanceOpening + Inbound - Outbound
Practical Tip: If the balance looks wrong, review recent inventory transactions (sales, purchases, adjustments) that affect the item and location.

Stock Balance Structure

Think of stock balance as a structured summary:

Organization
|
|-- Items
|   |-- Item Type / Sub Item Type
|   |-- UOM
|
|-- Locations
|
|-- Transactions
    |-- Inbound (GRN, Purchase, Return In)
    |-- Outbound (Sales, Issue, Return Out)
    |-- Adjustments

Flow Through the Structure:

  1. Item is the unit of tracking.
  2. Location is where the stock sits.
  3. Transactions are the source of truth for every balance change.

The “Golden Triangle” of Stock Balance

ComponentAnalogyDefinitionExample
ItemThe productThe SKU or inventory item being trackedITEM-001
LocationThe shelfThe warehouse or store holding the stockWH-KL
MovementThe changeTransactions that increase or decrease stockGRN, Sales, Adjustment

When these three are aligned, stock balance is accurate and actionable.


Quick Start Guide

Stock balance quick start guide
Quick start guide for warehouse, inventory, and admin users.

For Warehouse Staff: Check Stock On Hand

Goal: Confirm on-hand quantity for a specific item and location.

  1. Open Stock Balance from the sidebar.
  2. Use Advanced Search to filter by Location and Item Code.
  3. Click Search to load the listing.
  4. Review the Bal column to confirm current quantities.
  5. Use Column Toggle to reveal hidden columns (e.g., cost fields) if permitted.
  6. Export the grid if you need to share the results.

For Inventory Controllers: Investigate a Discrepancy

Goal: Trace a balance difference between system and physical count.

  1. Filter the listing by Item Code, Location, and Balance Greater Than 0.
  2. Review the Bal column for the current quantity.
  3. Use Column Toggle to group by Location for side-by-side comparison.
  4. Enable Pivot Mode if you need cross-tab analysis.
  5. Export the grid if you need to share evidence with auditors or finance.

For Admins: Initial Setup

Goal: Ensure the applet is ready for daily operational use.

  1. Confirm Item Master and Location data are complete and accurate.
  2. Assign permissions so only authorized users can view sensitive costs or balances.
  3. Configure applet settings such as default branch, location, and column visibility.
  4. Validate that Settings and Permissions menus are visible for admins only.
  5. Run a test search to validate data accuracy and access.

New to the system? Start with one item and one location. Verify the listing balance before scaling out.

Stock Balance Listing

The listing is the operational dashboard for stock visibility. It groups items by Item Code and can pivot balances by Location for quick comparisons.

Stock balance listing main view
Stock balance listing main view.

The listing can also group by EAN Code, Company, MA Price, and Last Purchase Company. Use Column settings to enable or disable these groupings.

Stock balance listing grouped by EAN code, company, MA price, and last purchase company
Listing grouped by EAN code, company, MA price, and last purchase company.
Column settings panel for grouping and pivot options
Column settings panel to manage grouping, pivot mode, and visible columns.
Pivot mode disabled and enabled in the listing
Pivot mode disabled vs enabled in the listing.

What is Pivot Mode? Pivot Mode restructures the listing so you can analyze stock balances by turning Location or other columns into grouped columns for side-by-side comparison.

What does it do? When enabled, you can drag fields into Row Groups, Columns, and Values to build a cross-tab view that highlights differences across locations.

Disabled vs. Enabled Pivot Mode:

  • Disabled: Standard row listing where each row is an item-location record, best for scanning and filtering.
  • Enabled: Aggregated cross-tab view, best for comparing quantities across multiple locations.

Key Listing Columns:

ColumnDescription
Item CodeItem identifier used as the main grouping field
EAN CodeBarcode or scan code for the item
CompanyCompany entity linked to the item
LocationWarehouse or store location
BalCurrent balance quantity
MA PriceMoving Average unit cost (visibility may be permission-controlled)
Last Purchase CostLatest purchase cost for valuation checks

What You Can Do in the Listing:

  • Group by Item Code to see totals across locations.
  • Pivot by Location to compare stock distribution.
  • Use the status bar for totals, selected row count, and aggregations.
  • Enable charts and range selection for quick analysis.
  • Export listing data to Excel or CSV when export is enabled.

Charts & Pivot

Use Charts and Pivot Mode to analyze stock distribution across locations and items.

Charts: Charts can only be generated when Pivot Mode is enabled. Select a range of cells and open the chart panel to visualize balances, compare locations, or track quantities by item group.

Pivot Mode: Drag fields into Row Groups, Columns, and Values to build cross-tab views for side-by-side comparison.

How to Generate a Chart:

  1. Enable Pivot Mode in the Column settings panel.
  2. Right-click in the listing and select Pivot Chart or Chart Range.
  3. Choose a chart type available in the applet, such as Donut or Pie.
Donut chart generated in the stock balance applet
Donut chart generated from the listing.
Pie chart generated in the stock balance applet
Pie chart generated from the listing.

Export & Analysis

Use Export to share the listing with other teams or use it in reconciliations.

Export Options:

  • Export to Excel or CSV for further analysis.

How to Export the Listing:

  1. Right-click anywhere in the listing.
  2. Choose Export, then select CSV or Excel.
  3. The exported file downloads automatically.
Export menu in the listing
Export menu with CSV and Excel options.
Export download in progress
Export download in progress.

Exported Files:

Exported CSV file
Exported CSV file.
Exported Excel file
Exported Excel file.

Advanced Search & Filters

The Advanced Search panel lets you focus on the exact stock you need.

Advanced search panel
Advanced search panel for stock balance filters.

Available Filters:

  • Company
  • Location
  • Item Code
  • Item Type
  • Sub Item Type
  • Balance Greater Than 0

Item Types Supported:

  • BASIC_ITEM
  • GROUPED_ITEM
  • BUNDLE
  • COUPON
  • SERVICE
  • WARRANTY
  • BATCH_EXPIRY
  • DOC_HEADER_ADJUSTMENT

Item Type Differences:

Item TypeWhat It MeansTypical Use Case
BASIC_ITEMA standard stock item tracked by quantity.Regular SKU kept in inventory.
GROUPED_ITEMA parent item that groups multiple child items.Kits or sets sold as a group.
BUNDLEA packaged combination of items sold together.Promotional bundle (e.g., phone + case).
COUPONA non-stock item representing a discount or voucher.Gift vouchers or discount coupons.
SERVICEA non-physical item delivered as a service.Installation or maintenance services.
WARRANTYA warranty or coverage item linked to sales.Extended warranty plans.
BATCH_EXPIRYItems tracked by batch and expiry dates.Food, pharma, or regulated goods.
DOC_HEADER_ADJUSTMENTDocument-level adjustment line.Rounding or header-level corrections.

Sub Item Types Supported:

  • BASIC_QTY
  • BATCH_NUMBER
  • SERIAL_NUMBER
  • BIN_NUMBER

Sub Item Type Differences:

Sub Item TypeWhat It MeansTypical Use Case
BASIC_QTYStandard quantity tracking without batch or serial.General stock items tracked by quantity only.
BATCH_NUMBERQuantity tracked by batch/lot number.Perishable or regulated goods with batch control.
SERIAL_NUMBERQuantity tracked by unique serial number.High-value items with individual serials.
BIN_NUMBERQuantity tracked by bin location within a warehouse.Warehouses using bin-level location control.

Search Tips:

  • Use Item Code for exact SKU matches.
  • Use Balance Greater Than 0 to hide empty items.
  • Filter by Item Type to isolate specific inventory models.

Integrations & Data Sources

Stock Balance aggregates data from multiple inventory workflows and feeds downstream applets that rely on real-time availability.

Inbound Data Sources (Lines Imported From):

  • Organisation Applet
  • Item (Inventory) Maintenance Applet
  • Doc Item Maintenance Applet
  • Sales Invoice Applet
  • Purchase Invoice Applet
  • Sales Return Applet
  • Purchases Return Applet
  • Stock Adjustment Applet
  • Sales Credit Note Applet
  • Sales Debit Note Applet
  • Purchase Credit Note Applet
  • Purchase Debit Note Applet
  • Internal Sales Goods Received Note Applet
  • Internal Purchase Goods Received Note Applet
  • Internal Sales Goods Issue Note Applet
  • Internal Purchase Goods Issue Note Applet

Downstream Applets Using Stock Balance Data:

  • Stock Availability Applet
  • Inventory Admin Applet
  • Sales Order Applet
  • Packing Order Applet
  • Delivery Order Applet
  • Purchase Order Applet
  • Purchase Requisition Applet
  • Quotation Applet
  • Sales Credit Note Applet
  • Sales Debit Note Applet
  • Purchase Credit Note Applet
  • Purchase Debit Note Applet
  • Sales Return Applet
  • Purchases Return Applet
  • Stock Adjustment Applet
  • Internal Sales Goods Received Note Applet
  • Internal Purchase Goods Received Note Applet
  • Internal Sales Goods Issue Note Applet
  • Internal Purchase Goods Issue Note Applet

Configuration & Settings

Configuration depends on your deployment and permissions. If Settings is enabled, administrators can configure defaults and field visibility.

Stock balance settings page
Stock balance settings page for defaults and field visibility.

Permissions

Permissions control who can view balances, costs, and settings. Assign read and configuration access only to approved roles.

What You Can Control with Permissions:

  • Access to the Stock Balance listing
  • Visibility of cost-related columns (MA Price, Last Purchase Cost)
  • Access to applet settings (defaults, column visibility, and configuration)

Where to Configure:

  • Use Role Permissions to apply access rules to job roles.
    Role permissions for stock balance applet
    Role permissions for the stock balance applet.
  • Use User Permissions for exceptions or specific user access.
    User permissions for stock balance applet
    User permissions for the stock balance applet.

FAQ

Q: Why is my stock balance showing zero? A: Check your filters first. The Balance Greater Than 0 filter hides zero-balance items. Also verify the correct Location and Item Type are selected.

Q: Why do I not see a specific location or company? A: Location visibility is permission-controlled. Contact your admin to confirm your access rights and location assignments.

Q: Why can’t I see MA cost or last purchase cost columns? A: Cost fields are typically permission-controlled and can also be hidden in applet settings. Ask your admin to enable the relevant visibility and permissions.

Q: How is the stock balance calculated? A: Stock balance is derived from all inbound and outbound transactions applied to the item and location. The system updates balances as transactions are posted.

Q: Why can’t I generate charts? A: Charts are available only when Pivot Mode is enabled. Enable Pivot Mode in the Column settings panel, then select a range and choose Pivot Chart.

Q: Why does my export option not appear? A: Export options may be disabled by permissions or admin settings. Confirm that your role allows exports and that the grid is not locked by policy.

Q: What is the difference between the Stock Balance Applet and Stock Report Applet? A: Stock Balance focuses on live operational visibility and listing analysis. Stock Report provides broader analytics, historical views, and reporting outputs.

Q: Why do I see negative stock? A: Negative stock usually indicates timing differences, backdated transactions, or missing receipts. Review recent sales, purchase, and adjustment documents for the item and confirm whether negative stock is allowed in your configuration.