avansaber/erpclaw-addons/erpclaw-pos

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 posts a sales invoice (the transaction discount as a negative line) and one receipt per tender method, allocated to it; a failed step is finished by retrying.

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 30 Actions

POS Profiles (4 actions)

Sessions (5 actions)

Transactions (12 actions)

Returns & Reports (9 actions)

Cross-Skill Integration

• erpclaw-selling: submit-transaction creates sales_invoice
• erpclaw-payments: submit-transaction creates payment_entry
• erpclaw-inventory: lookup-item reads item; submit updates stock

Technical Details (Tier 3)

Tables: pos_profile, pos_session, pos_transaction, pos_transaction_item, pos_payment. Data: Money=TEXT(Decimal), IDs=TEXT(UUID4).