Jewellery module overview

Retail Commerce OS's jewellery module gives Indian jewellers a dedicated workspace that handles the full complexity of gold and silver retail — from live metal rates to HUID-tagged inventory — without patching together generic tools.

How it works

The module activates when your workspace store-mode is set to jewellery. Once enabled, four dedicated sections become available:

1. Navigate to `/app/jewellery-rates` — This is your starting point each day. Gold and silver rates are auto-updated here. You can review the live rates before billing begins.

1. Navigate to `/app/jewellery-inventory` — Manage your stock with jewellery-specific fields: HUID, purity, gross weight, and net weight. Every item is tracked at the piece level. If you already have HUID barcodes assigned to your products, they import as-is — no reformatting needed.

1. Navigate to `/app/jewellery-pos` — Raise bills using metal-rate-aware pricing. Each bill calculates automatically as:

> Gross/net weight × live metal rate + making charges + GST

The rate used at the time of billing is pulled from /app/jewellery-rates, so your invoice always reflects the correct value for that moment.

1. Navigate to `/app/jewellery-reports` — View sales, inventory movement, and other jewellery-specific reporting from one place.

Good to know

• HUID import works out of the box. If your existing catalogue already has HUID barcodes, Retail Commerce OS imports them without any changes to the format. You do not need to re-tag your stock.
• Live rates drive billing automatically. The rates in /app/jewellery-rates are auto-updated, so your billing at /app/jewellery-pos always uses current values without manual entry.
• GST is built into the billing flow. You do not need a separate step or workaround to apply GST on jewellery invoices.
• This module is store-mode specific. The jewellery sections appear only when your workspace is configured in jewellery mode. If you do not see these menu items, check your store-mode setting.

Troubleshooting

• Jewellery menu items not visible — Confirm that your workspace store-mode is set to jewellery. Generic or apparel store-modes do not surface the jewellery module routes.
• HUID not appearing after import — Ensure the import file includes the HUID field mapped correctly. Existing HUID barcodes carry over as-is, but the field must be present in the source data.
• Live rates not refreshing — Visit /app/jewellery-rates directly and check the last-updated timestamp. If rates appear stale, refreshing the page will trigger an update fetch.