Managing Variants, Attributes & Barcode Hardware
Product variants represent distinct sellable variations of a product—differentiated by size, color, weight, material, or packaging. Each variant maintains its own independent SKU, barcode, cost structure, and stock allocation.
1. Adding a New Product Variant
Every new product starts with a single Default Variant. When an item has multiple variations, operators can register additional sellable SKUs:
- Navigate to Inventory > click on your target product to open
/inventory/products/[id]. - Select the Variants tab.
- Click the Add Variant button in the card header.
- Fill in the variant name, SKU suffix (defaults to
<base-sku>-<index>), buying price, and retail price.
2. Hardware Barcode Scanner Automation
🟢 Scanner Ready ActiveScryme includes zero-configuration hardware listening for physical USB and Bluetooth barcode scanners (such as Honeywell, Zebra, or generic wireless laser scanners).
High-Velocity Burst Detection
When the variant dialog is open, keystroke arrival intervals under 45 milliseconds are automatically recognized as hardware scanner inputs rather than human typing.
Form Interception & Auto-fill
The scanner listener intercepts the terminal carriage return, fills the Barcode field, displays a confirmation toast, and prevents accidental form submission.
3. Dynamic Attribute Matrix (JSON Key-Value Pairs)
Attach arbitrary dimensions to represent any product characteristic:
| Attribute Dimension | Sample Value | Front-End Visibility |
|---|---|---|
| Size | 500g, 1 kg, XL | Rendered on POS order line items and receipt slips |
| Color / Finish | Matte Black, Silver | Filterable in inventory search and web storefront catalog |
| Roast / Flavor | Dark Roast, Vanilla Bean | Displayed on barista tickets and kitchen display screens |