A Frappe/ERPNext application with specialized tools for retail operations.

Complete dashboard page for quick product information lookup.

Route: /app/item-inspector

• Barcode - Camera scanning or manual entry
• Item Code - Link field with autocomplete
• Multi-match - Selector when multiple items share the same barcode

• Name, code, group, brand, UoM
• Product image
• Description (plain text, no HTML)
• Status tags: DISABLED, Not a stock item

• ⚠️ Low Stock - When stock < reorder level
• ⏰ No Sales 60+ Days - Possibly obsolete product

• Price list selector
• Interactive price evolution chart
• Table with last 10 price changes
• Price and margin update when changing price list

• Current, reserved, and projected quantities
• Valuation cost per warehouse
• Estimated value by location

• Last 10 sales with document link
• Last 10 purchases with document link

• Open Item - Go to product form
• Balances - Filtered Stock Balance report
• Movements - Filtered Stock Ledger report

Simplified version for quick lookups.

Route: /app/item-inspector-light

Features:

• Only 3 KPIs: Stock, Estimated cost, Current price
• Price history (chart and table)
• No navigation buttons
• Minimalist design

Dashboard page for quick customer information lookup.

Route: /app/customer-lookup

• Search by customer code, name, phone, or email
• Quick selection from search results

• Name, customer group, territory
• Mobile phone and email (when available)
• Primary address

• Last 10 sales invoices with document links
• Invoice status, date, and amounts

• Sales User, Sales Manager, System Manager, Administrator, Accounts User

Generate product catalogs for printing or digital distribution.

Route: /app/catalog-generator

• Item Group - Filter by group (includes child groups)
• Brand - Filter by brand
• Warehouse - Filter by items with stock
• Price List - Price list for pricing
• Include Disabled - Option to include disabled items

• Column selection (2, 3, or 4 columns)
• Responsive grid layout

• HTML preview for printing
• PDF-ready layout

• System Manager, Sales Manager, Sales User, Stock Manager, Stock User

Generate barcode labels for printing.

Route: /app/label-generator

• Add items by barcode or item code
• Specify quantity per item
• Dynamic font sizing based on format
• Dynamic barcode height per format
• Price display toggle
• Load items with stock (with warehouse filter)
• Print-ready HTML output

• System Manager, Stock Manager, Stock User, Sales User

Custom print format for POS Closing Entry documents, optimized for thermal receipt printers.

DocType: POS Closing Entry

• Optimized for thermal printers
• Monospace font (Courier New) for alignment
• Compact design with dashed section dividers

• Color-coded payment differences (green for positive, red for negative)
• Return transactions marked with "RET" badge
• Automatic currency symbol from company settings
• Print-ready CSS with proper margins

cd $PATH_TO_YOUR_BENCH
bench get-app https://github.com/ernestoruiz89/retail_tools
bench install-app retail_tools
bench build --app retail_tools
bench restart

• Frappe Framework v15+
• ERPNext v15+
• Python 3.10+

• By barcode: Enter the code and press Enter
• By Item Code: Use the "Product" Link field
• With camera: Click "Scan with camera" (requires HTTPS)

• Enter customer name, code, phone, or email
• Select from search results

This app uses pre-commit for formatting and linting:

cd apps/retail_tools
pre-commit install

• ruff - Python linter and formatter
• eslint - JavaScript linter
• prettier - Code formatter

retail_tools/
├── retail_tools/
│   ├── retail_tools/
│   │   └── page/
│   │       ├── item_inspector/           # Full product lookup
│   │       │   ├── item_inspector.py     # Backend API
│   │       │   ├── item_inspector.js     # Frontend
│   │       │   └── item_inspector.css    # Styles
│   │       ├── item_inspector_light/     # Simplified version
│   │       │   ├── item_inspector_light.py
│   │       │   ├── item_inspector_light.js
│   │       │   └── item_inspector_light.css
│   │       ├── customer_lookup/          # Customer lookup
│   │       │   ├── customer_lookup.py
│   │       │   ├── customer_lookup.js
│   │       │   └── customer_lookup.css
│   │       ├── catalog_generator/        # Product catalog
│   │       │   ├── catalog_generator.py
│   │       │   ├── catalog_generator.js
│   │       │   └── catalog_generator.css
│   │       └── label_generator/          # Barcode labels
│   │           ├── label_generator.py
│   │           ├── label_generator.js
│   │           └── label_generator.css
│   ├── hooks.py
│   └── patches.txt
├── pyproject.toml
└── README.md

MIT