Super POS System - Documentation v1.2.0
πŸ†• Version 1.2.0 Released!

Super POS System

The most powerful and feature-rich Point of Sale system for WooCommerce. Transform any device into a professional POS terminal with multi-store support, real-time inventory, and beautiful receipts.

πŸͺ Multi-Store πŸ’³ Split Payments πŸ”„ Refunds πŸ“± PWA 🎨 Variable Products 🧾 Custom Receipts πŸ“¦ Inventory πŸ‘₯ Customers

πŸŽ‰ What's New in v1.2.0

Major update with professional-grade features

πŸ’³

Advanced Payment Interface

Complete redesign with numpad, quick cash buttons, split payments, and visual payment tracking. Restaurant-style 3-panel layout.

πŸ”„

Refunds & Returns

Process full or partial refunds directly from POS with automatic stock restocking. Search orders by number, name, or email.

πŸ“¦

Variable Products

Full support for WooCommerce variable products with variation selector modal showing all attributes and prices.

πŸ–ΌοΈ

Product Image Upload

Upload product featured images directly from POS when creating new products. Click to upload with preview.

πŸ“±

PWA Support

Install POS as a Progressive Web App for offline capability, faster loading, and native-like experience on any device.

πŸ—„οΈ

Cash Drawer Integration

Automatic cash drawer opening via USB, network, or serial connection when processing cash payments.

πŸ“Š Admin Modules

Complete backend management system

πŸ“ˆ

Dashboard

Real-time sales overview & statistics

πŸͺ

Stores

Manage multiple store locations

πŸ–₯️

Registers

Configure POS terminals

πŸ‘₯

Sessions

Cashier shift management

πŸ“¦

Inventory

Stock & product management

🧾

Receipts

Custom receipt templates

πŸ“Š

Reports

Sales & performance analytics

βš™οΈ

Settings

Global POS configuration

✨ Key Features

Everything you need for professional retail management

πŸͺ

Multi-Store Support

Manage unlimited stores and registers from a single WooCommerce installation. Each store has its own settings, staff, and inventory.

πŸ‘₯

Session Management

Track cashier shifts with opening/closing cash, sales totals, order counts, and variance calculations. Generate end-of-day reports.

πŸ“Š

Dashboard & Reports

Real-time sales dashboard with today's stats, recent orders, active sessions. Reports for daily, weekly, monthly sales with payment breakdowns.

🧾

Receipt Customization

Fully customizable receipts with store logo, header, footer, SKU, barcodes. Auto-print or manual print with confirmation.

πŸ“¦

Inventory Management

Full product management from POS: add products with images, edit details, adjust stock, manage categories. Low stock alerts.

πŸ”

Barcode Scanner

Quick product lookup with USB or Bluetooth barcode scanner. Instant add to cart. Works with any keyboard-emulating scanner.

⏸️

Hold/Park Orders

Save carts for later retrieval with custom names. Perfect for restaurants or when customers need to step away. Unlimited holds.

πŸ‘€

Customer Management

Search customers by name, email, or phone. Create new customers during checkout. Assign customers to orders for history tracking.

🏷️

Discounts & Coupons

Apply percentage or fixed amount discounts. WooCommerce coupon support with validation. Quick discount presets.

πŸ”’

Role Management

Dedicated POS Manager and Cashier roles. Customizable permissions for register access, discounts, refunds, and reports.

πŸ–₯️

Fullscreen Mode

Distraction-free fullscreen POS interface. Perfect for dedicated POS terminals. Toggle with button or F11 key.

πŸ”—

WooCommerce Integration

Full integration with WooCommerce orders, products, customers, and coupons. HPOS compatible. Orders appear in WooCommerce admin.

πŸ–₯️ POS Terminal Interface

Modern, intuitive design for fast transactions

πŸ”

Product Search

Instant search by name, SKU, or barcode

πŸ“‚

Category Filter

Quick filter by product category

πŸ›’

Smart Cart

Easy quantity adjust & item notes

πŸ’³

Quick Payment

Multiple methods & split pay

πŸ‘€

Customer Select

Search or create customers

⏸️

Hold Cart

Park orders for later

🏷️

Discounts

% or fixed amount off

🎟️

Coupons

Apply WooCommerce coupons

πŸ“

Order Notes

Add notes to orders

🚚

Shipping

Add shipping charges

πŸ“Š

Session Stats

View current shift stats

πŸ”„

Refunds

Process returns easily

πŸ’³ Advanced Payment Interface NEW

Professional-grade payment processing with split payments and quick cash

⌨️ Numpad Panel

  • Amount Due display
  • Entered amount tracking
  • Auto change calculation
  • Full numpad (0-9, 00, decimal)
  • Backspace & Clear buttons
  • "Exact" quick fill button
  • "+Add" to add split payment
  • Real-time total bar

πŸ’° Payment Methods

  • πŸ’΅ Cash (with amount entry)
  • πŸ’³ Credit/Debit Card
  • πŸ“± Mobile Payment
  • 🏦 Bank Transfer
  • 🎁 Gift Card
  • πŸ“ Check
  • 🏷️ Store Credit
  • 🎁 Invitation (Comp)
  • 🏠 House (Owner)

πŸ’΅ Quick Cash Panel

  • Quick bill buttons (100, 50, 20, 10, 5)
  • Quick coin buttons (2, 1, 0.50, 0.25)
  • Payment details list
  • Remove individual payments
  • Clear all payments button
  • Complete payment summary

✨ Split Payment Example

Customer wants to pay €50 total: €30 cash + €20 card

1. Select "Cash" β†’ Enter 30 via numpad β†’ Click "+Add"
2. Select "Card" β†’ Remaining €20 auto-fills β†’ Click "+Add"
3. Click "Complete" β†’ Order processed with both payment methods recorded!

⚑ Quick Payment (No Split)

For simple single-method payments, just select method and click Complete!
Select "Card" β†’ Click "Complete" β†’ Done! Full amount charged to card.

πŸ”„ Refunds & Returns NEW

Process refunds directly from the POS terminal

πŸ” Search Orders

Find orders to refund quickly

  • Search by order number
  • Search by customer name
  • Search by email address
  • Search by phone number
  • View order details & items
  • See previous refunds

πŸ’° Process Refund

Flexible refund options

  • Full order refund
  • Partial item refund
  • Select quantity to refund
  • Auto-calculate refund amount
  • Add refund reason/note
  • Optional stock restock

🧾 Refund Documentation

Complete refund tracking

  • Refund receipt generation
  • Original order reference
  • Refunded items list
  • Refund amount & method
  • Reason documented
  • Synced with WooCommerce

🏬 Store & Register Management

Full control over your retail locations

πŸͺ Store Settings

Complete store profile with all business details

  • Store name, code & description
  • Full address with country/state
  • Phone, email & website
  • Business/Tax ID numbers
  • Store logo upload
  • Social media links (Facebook, Instagram, Twitter)
  • Operating hours configuration
  • Manager assignment
  • Enable/disable store

πŸ–₯️ Register Settings

Configure each POS terminal individually

  • Register name & number
  • Assign to specific store
  • Payment methods selection
  • Receipt template choice
  • Opening cash requirement
  • Cashier assignments (who can use)
  • Theme color customization
  • Feature toggles (hold, discount, etc.)
  • Enable/disable register

πŸ‘₯ Session Management

Track cashier shifts and performance

  • Opening cash amount entry
  • Session start/end times
  • Total sales per session
  • Order count & items sold
  • Expected vs actual cash
  • Cash variance calculation
  • Session notes & comments
  • Historical session reports
  • Active session monitoring

πŸ“¦ Inventory Management

Complete product management from the POS terminal

πŸ“‹ Products Tab

Search and manage existing products

  • Search products by name/SKU/barcode
  • View product list with images
  • See stock levels at a glance
  • Color-coded stock indicators
  • Quick edit product details
  • Edit prices, SKU, barcode
  • Adjust stock quantities
  • View cost and sale prices

βž• Add Product UPDATED

Create new products on the fly

  • πŸ–ΌοΈ Featured image upload
  • Image preview with remove button
  • Product name & description
  • SKU & barcode entry
  • Regular price (required)
  • Sale price (optional)
  • Cost price (for profit tracking)
  • Stock quantity
  • Category assignment
  • Tax status selection

πŸ“Š Stock Adjustment

Manage inventory levels

  • Add stock (received goods)
  • Remove stock (damaged/lost)
  • Set exact quantity
  • Add adjustment reason
  • Track adjustment history
  • Multi-store stock support
  • Audit trail for changes

🏷️ Categories

Organize your products

  • View all categories
  • See product counts
  • Create new categories
  • Quick category filter in POS
  • Nested category support
  • Category images

🎨 Variable Products Support NEW

Full support for WooCommerce variable products

πŸ‘•

Variation Selection

Beautiful modal to select product variations (size, color, style, material, etc.) before adding to cart. Clear attribute dropdowns with visual selection.

🏷️

Dynamic Pricing

Shows "From $X" pricing on product cards for variable products. Price updates based on selected variation. Sale prices supported per variation.

πŸ“¦

Stock Per Variation

Individual stock tracking for each variation. Out of stock variations are automatically disabled. Stock quantity shown in selection modal.

πŸ’³ Payment Methods

Flexible payment options configurable in admin settings

πŸ’΅

Cash

πŸ’³

Card

πŸ“±

Mobile

🏦

Bank

🎁

Gift Card

πŸ“

Check

🏷️

Credit

βž•

Other

πŸ’‘ Split Payment Support

Accept multiple payment methods in a single transaction. Example: €50 cash + €30 card = €80 total. Each payment method is recorded separately for accurate accounting.

🎁 Special Payment Methods

Invitation: Complimentary/free items (promotional, compensation, VIP). Records as marketing expense.
House: Business/owner pays (staff meals, owner use). Records as owner withdrawal.

πŸ“± PWA & Hardware Integration NEW

Modern web app capabilities and hardware support

πŸ“²

Install as App

Install POS on any device as a Progressive Web App

πŸ“΄

Offline Support

Basic functionality when internet is lost

πŸ—„οΈ

Cash Drawer

Auto-open on cash payments

πŸ–¨οΈ

Auto Print

Automatic receipt printing

πŸ””

Notifications

Push notifications for sync

⚑

Fast Loading

Cached assets for speed

πŸ—„οΈ Cash Drawer Configuration

Supported connection types:

  • β€’ USB: Direct USB-connected cash drawer
  • β€’ Network: Network/IP cash drawer (IP address + port)
  • β€’ Serial: Serial port connected drawer (COM port)

🧾 Receipt Customization

Beautiful, customizable receipts for your brand

🎨 Display Settings

  • Store logo on receipt
  • Custom header text/message
  • Custom footer text/message
  • Show/hide product SKU
  • Show/hide barcode
  • Tax breakdown display
  • Order number format

πŸ–¨οΈ Print Options

  • Enable/disable receipt printing
  • Auto-print after payment
  • Manual print with confirmation
  • Gift receipt option (no prices)
  • Duplicate receipt printing
  • Receipt width configuration

πŸ“‹ Receipt Content

  • Store name & address
  • Order number & date/time
  • Cashier name
  • Customer details (if assigned)
  • Itemized products with qty & price
  • Subtotal, tax, discounts
  • Payment method(s) used
  • Amount paid & change given

YOUR STORE NAME

123 Main Street
City, State 12345
Tel: (555) 123-4567

Order #1234
Dec 25, 2025 14:30
Cashier: John

Product One x2€20.00
Product Two x1€15.00
Product Three x3€45.00
Subtotal€80.00
Tax (20%)€16.00
TOTAL€96.00
Cash€100.00
Change€4.00

πŸš€ Quick Installation

Get started in minutes

πŸ“₯ Installation Steps

  1. 1

    Upload Plugin - Go to Plugins β†’ Add New β†’ Upload Plugin β†’ Choose super-pos-system.zip

  2. 2

    Activate - Click "Activate Plugin" after installation completes

  3. 3

    Create Store - Navigate to Super POS β†’ Stores β†’ Add New Store

  4. 4

    Add Register - Go to Registers β†’ Add New and assign to your store

  5. 5

    Configure Settings - Set up payment methods, receipts, and preferences

  6. 6

    Assign Cashiers - Add users with POS Cashier role to registers

  7. 7

    Start Selling - Access POS at yoursite.com/pos/ and open a session!

βš™οΈ Requirements

  1. βœ“

    WordPress 5.8+ - Latest version recommended for best compatibility

  2. βœ“

    WooCommerce 5.0+ - Required for products, orders, and customers

  3. βœ“

    PHP 7.4+ - PHP 8.0+ recommended for best performance

  4. βœ“

    MySQL 5.7+ - Or MariaDB 10.3+ database server

  5. βœ“

    HTTPS - Required for PWA functionality and secure payments

  6. βœ“

    Modern Browser - Chrome, Firefox, Safari, Edge (latest versions)

πŸ‘₯ User Roles & Permissions

Secure access control for your team

πŸ‘¨β€πŸ’Ό POS Manager

Full POS management access

  • Access all POS features
  • Create & manage stores
  • Configure registers
  • View all sessions & reports
  • Process refunds
  • Manage inventory
  • Apply any discount
  • Close any session

πŸ§‘β€πŸ’» POS Cashier

Day-to-day POS operations

  • Access POS terminal
  • Open/close own sessions
  • Process sales & payments
  • Apply preset discounts
  • Hold/retrieve carts
  • Search customers
  • View own session stats
  • Print receipts

πŸ” Administrator

WordPress admin with POS access

  • All manager permissions
  • Plugin settings access
  • User role management
  • Database management
  • API access
  • Debug & logs access

πŸ”Œ REST API Reference

Extend and integrate with external systems

Products

GET /wp-json/spos/v1/products POST /wp-json/spos/v1/products PUT /wp-json/spos/v1/products/{id}

List, create, update products with images

Orders

POST /wp-json/spos/v1/orders GET /wp-json/spos/v1/orders/search

Create orders with split payments

Refunds

POST /wp-json/spos/v1/orders/{id}/refund

Process full or partial refunds

Sessions

POST /wp-json/spos/v1/sessions/open POST /wp-json/spos/v1/sessions/close GET /wp-json/spos/v1/sessions/{id}/stats

Manage cashier sessions

Cart

POST /wp-json/spos/v1/cart/save GET /wp-json/spos/v1/cart/saved DELETE /wp-json/spos/v1/cart/{id}

Save and retrieve held carts

Customers

GET /wp-json/spos/v1/customers/search POST /wp-json/spos/v1/customers

Search and create customers

Categories

GET /wp-json/spos/v1/categories POST /wp-json/spos/v1/categories

List and create categories

Stock

POST /wp-json/spos/v1/stock/adjust

Adjust product stock levels

⌨️ Keyboard Shortcuts

Speed up your workflow with keyboard shortcuts

πŸ›’ Cart Operations

  • F2 - Focus product search
  • F4 - Open payment modal
  • F8 - Hold/Park current cart
  • F9 - Retrieve held carts
  • Delete - Clear entire cart
  • +/- - Adjust item quantity

πŸ’³ Payment Modal

  • Enter - Complete payment
  • Escape - Cancel/Close modal
  • C - Clear entered amount
  • . - Decimal point
  • Backspace - Delete last digit
  • 0-9 - Enter amount

πŸ–₯️ General

  • F11 - Toggle fullscreen mode
  • Ctrl+P - Print last receipt
  • Ctrl+R - Refresh products
  • Ctrl+I - Open inventory
  • Ctrl+U - Open customer modal

πŸ“‹ Changelog

Version history and updates

πŸ“¦ v1.2.0 LATEST

  • πŸ†• Advanced payment interface with numpad
  • πŸ†• Split payments with visual tracking
  • πŸ†• Quick cash buttons (bills & coins)
  • πŸ†• Refunds & returns from POS
  • πŸ†• Variable products support
  • πŸ†• Product image upload
  • πŸ†• Cash drawer integration
  • πŸ†• PWA support
  • πŸ†• Invitation/House payment methods
  • πŸ†• 8 configurable payment methods
  • πŸ”§ Search input focus fix
  • πŸ”§ Currency symbol display fix

πŸ“¦ v1.1.5

  • WooCommerce HPOS compatibility
  • Cart checkout blocks support
  • Hold cart price fix
  • Removed debug logs
  • Updated WC tested version

πŸ“¦ v1.1.2 - v1.1.4

  • Auto-print receipt feature
  • Receipt settings in POS
  • Print confirmation dialog
  • Hold cart item enrichment
  • Price recovery from products
  • HPOS declaration

πŸ“¦ v1.0.7 - v1.1.1

  • Session statistics display
  • Dashboard & reports fix
  • Hold cart name saving
  • Cart field mapping fix
  • Hold button always enabled

πŸ“¦ v1.0.0 - v1.0.6

  • Initial release
  • Multi-store & register support
  • Modern POS terminal UI
  • Session management
  • Receipt customization
  • Dashboard & reports
  • Database upgrade system
  • Security compliance

Need Help?

We're here to support you

πŸ“–

Documentation

Comprehensive guides and tutorials to help you get the most out of Super POS System. Step-by-step setup instructions.

πŸ’¬

Support

Get help with installation, configuration, or troubleshooting any issues. Contact us for personalized assistance.

πŸ”„

Updates

Regular updates with new features, improvements, security patches, and WooCommerce compatibility updates.

Ready to Transform Your Store?

Start selling with the most powerful WooCommerce POS system today!

🌐 Visit Website πŸ“– WooCommerce Docs

Made with ❀️ for WooCommerce | Super POS System v1.2.0

By Nasir Mehmood | Compatible with WooCommerce 5.0+ | HPOS Ready | Block Checkout Compatible | PWA Enabled

Super POS System Logo
Super POS System