Jewelry Catalog

Your stocked jewelry — searchable, filterable, ready to sell over the counter or record into a session. Jewelry appears in the main menu when the studio does piercing or adornment work — there’s nothing to turn on. It’s a management surface, shown to holders of Jewelry → Manage; the register reads the catalog from checkout without it.

The catalog is one catalog for the whole shop: every location sees the same pieces at the same prices.

Designs and pieces

A piece is a single stocked item — one SKU. A design is a family of variants: the same CBR in several gauges and sizes, the same threadless end in titanium and gold. The design carries what the family shares — manufacturer, type, material, threading, photo — and each variant adds its own gauge, size, finish, and price. Standalone pieces are fine too; when you create one that looks like it belongs to an existing family, the catalog offers to add it as a variant instead, and a standalone piece can become a design later.

The catalog splits complete pieces and posts from Ends — the interchangeable decorative tops, which fit multiple post gauges. A fixed piece with an integral end is one entry; a bare post and its separate end are two.

Names compose themselves from the attributes — manufacturer, type, gauge, size, material, finish — so NeoMetal Disc End · 2mm Ti · Mirror costs no typing. Override the name when the composed one isn’t what you call it.

What a piece carries

Beyond its attributes and photo (variants fall back to the design’s photo), each piece has a Catalog details block:

• SKU and Barcode — both scannable, neither required to be unique. Variants legitimately share vendor codes; when a scan matches more than one piece, the register asks instead of guessing.
• Retail price — what the piece sells for on its own. What a session bills is a separate question — see Jewelry Pricing.
• Unit cost — what you paid for it. Cost and manufacturer part numbers are visible only with Jewelry → Manage — counter staff and sellers never see them, on screen or through the API. (Piercers do: the Piercing skill grants the permission.)
• Tier — an organizational tag. With a Separate tier applied to a session, the picker filters to that tier’s pieces (one tap shows all). The tag never sets a price; see Jewelry Tiers.
• Baseline — marks the piece as included in the service price under a baseline pricing model.

Attributes

Manage attributes on the catalog page holds the building-block lists: materials, manufacturers, gauges, lengths/diameters, finishes, jewelry types, end types, and the gem lists — gem materials, colors (with abbreviations for manufacturer color codes), cuts, and settings. Piercing studios get them pre-loaded with common values, and every list can load a sample set on demand; gauges and lengths reorder by drag. Most shops never need to touch these. If you’re coming from 2.x: the old per-list settings pages are gone — this is where those lists live now.

Finding pieces

Search matches name, SKU, and barcode — typed or scanned. Filters cover every attribute axis plus threading, gems (down to gem color and cut), tier, and the two pricing filters — Baseline only and Not marked yet — that drive the baseline marking sweep.

Selling from the catalog

Adding a piece to a sale from the catalog starts a checkout (or joins the open one). A piece sold over the counter always bills its catalog price — baseline marks and tier coverage only ever apply during a service.

Keeping the case clean

• Combine duplicates merges pieces that are really the same item: pick the one to keep, and every past session and sale re-points to it. It can’t be undone. Designs merge at the variant level, not as whole families.
• A piece with session or sale history can’t be deleted — that history has to keep pointing at something. Deactivate it instead: the piece leaves search, scanning, and the pickers while every record stays whole.
• Deleting a design frees its variants as standalone pieces; it doesn’t delete them.
• The Not in catalog tab collects one-off pieces built mid-session and never cataloged — promote them into real SKUs.

Permissions

The catalog page is a management surface — opening it takes Jewelry → Manage, included in Manager and granted automatically with the Piercing skill; the same permission unlocks unit costs. Sellers don’t need it: the register reads the catalog through the checkout’s Add Item picker. Jewelry tiers additionally take Pricing Settings → Manage — see Jewelry Tiers. Full catalog at Roles & Permissions.