ScrymeDeveloper Docs
Inventory & Catalog Guide

Creating Products & Initial Stock

This comprehensive operational guide walks store operators and managers through creating a new catalog item, verifying SKU uniqueness in real time, calculating margins, and auto-provisioning initial stock batches.


1. Accessing the Product Creation Sheet

Store staff with operator or manager permissions can register new merchandise or prepared goods using the slide-out sheet:

  1. Navigate to Inventory (/inventory) in the main dashboard navigation.
  2. In the upper right action bar, click the Add Item button.
  3. The New Product Sheet smoothly slides open from the right without leaving your active catalog view.

2. Step 1: Basic Information & Taxonomy

The first section establishes product identity, search indexing, and classification rules:

Product Name (Required)

Enter the full official title of the item (e.g. Artisan Sourdough Loaf). As you type, Scryme’s client dynamically derives initial suggestions for SKU and URL slug.

SKU & URL Slug Uniqueness Verification

The system automatically defaults to a 3-letter prefix plus a 5-digit integer (e.g. ART-48291). A debounced backend lookup checks tenant uniqueness in real time:

  • Green Checkmark: SKU is available across your active organization.
  • Red Alert Callout: SKU already exists in this tenant. You must adjust the code before saving.

Category & Item Type Selection

Select the parent category or click Create Inline to register a new category without losing form progress.

Finished Good: Baked goods or finished retail items sold to customers.
Raw Material: Ingredients or packaging tracked strictly by buying cost.
Merchandise: Pre-packaged goods purchased from vendors and resold directly.
Other: Miscellaneous non-standard inventory items.

3. Step 2: Costs, Retail Pricing & Dynamic Gross Margin

Define financial boundaries per base unit. The sheet automatically evaluates gross margin health:

Gross Margin % = ((Retail Price - Cost Price) / Retail Price) × 100
Healthy (≥ 20%): Standard target profit margin.
Low Margin (0% - 20%): Triggers warning alert.
Negative (< 0%): Retail price is below buying cost.
Raw Material Pricing Safeguard:

When RAW_MATERIAL is selected, the Retail Price input is automatically locked. Raw materials are consumed via bakery recipes and production bills of materials (BOM), never sold as single retail lines.

4. Initial Stock Provisioning & Batch Generation

Entering an initial count automatically performs transactional ledger initialization:

  • Creates the parent Product record and its default ProductVariant.
  • Initializes a location stock record (ProductVariantStock) for the store location.
  • Generates an immutable enterprise batch code (e.g. INIT-ART-48291-1024).
  • Appends an initial adjustment record to the inventory movement ledger for complete fiscal auditability.