erpclaw-pos

name	erpclaw-pos
version	1.0.0
description	Point of Sale -- 28 actions across 4 domains. POS profiles, register sessions, cart-based transactions, split payments, receipts, hold/resume, returns, discounts, and end-of-day reporting with cash reconciliation.
author	AvanSaber
homepage	https://github.com/avansaber/erpclaw-addons
source	https://github.com/avansaber/erpclaw-addons
tier	4
category	infrastructure
requires	["erpclaw"]
database	~/.openclaw/erpclaw/data.sqlite
user-invocable	true
tags	["erpclaw","pos","point-of-sale","register","transactions","payments","receipts","cash-reconciliation","retail","cart","barcode"]
scripts	["scripts/db_query.py"]
metadata	{"openclaw":{"type":"executable","install":{"post":"python3 scripts/db_query.py --action pos-status"},"requires":{"bins":"[Truncated]","env":"[Truncated]","optionalEnv":"[Truncated]"},"os":["darwin","linux"]}}

ERPClaw POS

Point of Sale module for in-store and counter sales. Manages register sessions, cart-based transactions, split payments, hold/resume, returns, discounts, and end-of-day reconciliation. submit-transaction auto-creates sales invoice, payment entry, and stock ledger updates via cross-skill integration.

Skill Activation Triggers

Activate when user mentions: POS, point of sale, register, cash register, checkout, ring up, transaction, receipt, cashier, terminal, barcode scan, hold transaction.

Setup

python3 {baseDir}/init_db.py
python3 {baseDir}/scripts/db_query.py --action pos-add-pos-profile --name "Main Register" --company-id {id}

Quick Start

--action pos-add-pos-profile --name "Main Register" --company-id {id}
--action pos-open-session --pos-profile-id {id} --opening-amount 200 --cashier-name "Jane"
--action pos-add-transaction --pos-session-id {id}
--action pos-add-transaction-item --pos-transaction-id {id} --item-id {id} --qty 2
--action pos-add-payment --pos-transaction-id {id} --payment-method cash --amount 50
--action pos-submit-transaction --id {id}
--action pos-close-session --id {id} --closing-amount 250

All 28 Actions

POS Profiles (4 actions)

Action	Description
pos-add-pos-profile	Create POS terminal profile
pos-get-pos-profile	Get profile details
pos-update-pos-profile	Update profile settings
pos-list-pos-profiles	List POS profiles

Sessions (5 actions)

Action	Description
pos-open-session	Open register session
pos-close-session	Close session with reconciliation
pos-get-session	Get session details
pos-list-sessions	List sessions
pos-session-summary	Session summary with totals

Transactions (11 actions)

Action