Getting Started with StockPulse

Everything you need to get your business running

Welcome to StockPulse! This guide will walk you through setting up your account, adding your first products, and making your first sale.

What is StockPulse?

StockPulse is an all-in-one business management platform designed for Kenyan SMEs. It helps you track inventory, manage sales and invoicing, record expenses, calculate sales commissions, and generate reports — all in one place.

Quick Sale & POS
Point-of-sale with per-line % discounts, overall fixed discounts, and 80mm thermal receipt printing
Sales & Invoicing
Create invoices, clone/duplicate, edit drafts, set up recurring billing, share public invoice links, send payment reminders, and manage customers
Branch Stock Custodian
Branches own stock, warehouses are receiving points — clear custody and accountability
Data Import
Import customers, products, invoices, expenses, and more from Zoho, QuickBooks, or CSV
Expense Templates
Log expenses, create reusable templates, link to invoices
Reports & Analytics
P&L, daily/weekly sales drilldown, stock valuation, AR aging
Delivery Tracking
Zone-based fee calculation (free, flat, percentage), dispatch, and real-time status tracking
Commission Engine
Percentage commissions for reps, broker spread for agents who sell above your listed price
VAT-Inclusive Pricing
Toggle prices-include-VAT per business — system back-calculates exclusive amounts for accounting
eTIMS Compliance
Link KRA eTIMS numbers or auto-submit via OSCU integration
Cross-Branch Stock View
See stock levels across all branches — find what you need and coordinate transfers
Session Security
Single-device login, 30-day sessions with a 1-minute expiry warning so you never lose work
Assisted Onboarding
Paid plans include hands-on setup and data migration support
WhatsApp AI Assistant
18+ capabilities including recording payments, checking stock per warehouse, looking up customers, scanning receipts, and managing multiple businesses — all from WhatsApp in plain language
Snap-to-Expense
Photograph a receipt and AI extracts amount, vendor, category, and date — one tap to save. Works in-app and via WhatsApp
AI Alerts & Digests
Weekly business digest on WhatsApp every Monday, plus daily predictive restock alerts before products run out
Guided Tours
Interactive walkthroughs on every page, plus a floating help button to replay tours anytime
Share Feedback
Tell us what's working, what's not, or what you'd like to see next — your voice shapes StockPulse

Initial Setup Checklist

Follow these steps in order to get your account fully configured:

  1. 1
    Complete Company Profile

    Go to Settings → Company. Fill in your business name, address, phone, email, and KRA PIN. Upload your logo and set your invoice prefix.

    Open Company Settings
  2. 2
    Set Up Your Warehouse

    Go to Settings → Warehouses. StockPulse creates a default warehouse during onboarding. Rename it or add more if you have multiple locations.

    Open Warehouses
  3. 3
    Add Units of Measure

    Go to Settings → Units of Measure. Review the default units (pc, kg, ltr, ctn, etc.) and add any custom units your business uses. Set conversion factors between related units.

    Open Units
  4. 4
    Create Products

    Go to Products → New Product to add products one by one, or use Settings → Data Import to bulk-import from a CSV/Excel file (with opening stock and pricing).

    Import Products
  5. 5
    Receive Opening Stock

    Go to Inventory → Receive Stock. Do an initial goods receipt to set opening stock levels and costs for all your stocked products.

    Receive Stock
  6. 6
    Add Customers

    Go to Sales → Customers → New Customer to add individually, or use Settings → Data Import to bulk-import your customer list from CSV/Excel.

    Import Customers
  7. 7
    Invite Your Team

    Go to Settings → Users. Invite team members with the appropriate roles: Admin, Finance Manager, Sales Representative, Stock Manager, or Viewer.

    Manage Users

Key Concepts

Ledger-first Architecture

All stock movements and financial transactions are recorded as immutable ledger entries. This means every change has a full audit trail and nothing is ever silently overwritten.

Weighted Average Cost (WAC)

StockPulse calculates your stock cost using the weighted average method. Each goods receipt updates the average cost: (existing qty × existing cost + received qty × received cost) ÷ new total qty.

Base Unit of Measure

Every product has a base UoM for stock tracking (e.g., pieces). You can define different units for purchasing (e.g., cartons) and selling (e.g., dozens). StockPulse converts quantities automatically using your conversion factors.

Invoice Lifecycle

Invoices start as Draft (no stock deducted). When you Finalize, stock is validated and deducted — you cannot finalize if stock is insufficient. Record payments to move through PartialPaid. You can download a PDF at any stage — it includes a status badge so the document's stage is always clear.

Stock Protection

StockPulse prevents overselling. Both Quick Sale and Invoice finalization check available stock and reject sales that would push inventory below zero. This is enforced at both the UI and server level.

Branch Stock Custodian Model

Branches are the custodians of stock. Warehouses serve as receiving points under branches. When selling stocked items, a branch must be selected so the system knows which stock to deduct. This ensures clear accountability per location.

Explore the Docs