ScrymeDeveloper Docs
Variants & Hardware Guide

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:

  1. Navigate to Inventory > click on your target product to open /inventory/products/[id].
  2. Select the Variants tab.
  3. Click the Add Variant button in the card header.
  4. Fill in the variant name, SKU suffix (defaults to <base-sku>-<index>), buying price, and retail price.

2. Hardware Barcode Scanner Automation

🟢 Scanner Ready Active

Scryme 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 DimensionSample ValueFront-End Visibility
Size500g, 1 kg, XLRendered on POS order line items and receipt slips
Color / FinishMatte Black, SilverFilterable in inventory search and web storefront catalog
Roast / FlavorDark Roast, Vanilla BeanDisplayed on barista tickets and kitchen display screens

4. Expiry Tracking & Deletion Safeguards

Expiry Alerts: Configure shelf life duration and warning thresholds (e.g. 2 days prior to expiration) to generate automatic stock rotation reminders.
Serial Number Capture: For serialized merchandise, require staff to scan unique serial IDs during sales and returns.
Single-Variant Safeguard: Every catalog product must retain at least one variant. The delete button is disabled when only one variant remains.