For In-store App Users

Android App Guide

The PMJ estimation app turns an Android phone or tablet into a pocket sales counter: look up any piece, build a live price estimate on the spot, print it on a thermal receipt printer, and WhatsApp the PDF to the customer — all without leaving the customer's side.

1. Installing & first launch

  1. 1
    Install the PMJ Jewels APK provided by your store admin (the app is distributed internally, not via the Play Store). It runs on Android 8.0 or newer.
  2. 2
    On first launch you will see a one-time permissions screen explaining what the app needs: Bluetooth / Nearby devices (for Bluetooth thermal printers; on older Android versions this includes Location, which Android requires for Bluetooth scanning) and network access (for the catalogue and Wi-Fi printers). Grant them and continue.
  3. 3
    The app opens the login screen. You will not see this permissions screen again.

Network required

Login, catalogue browsing and estimates all need a working internet connection. Only your local estimate history and recently loaded customer lists are available offline.

2. Region & login

  1. 1
    On the login screen, first pick your region with the India / US selector. This chooses which regional backend (and which currency — ₹ INR or $ USD) the app talks to; the sign-in button stays disabled until a region is picked.
  2. 2
    Enter your Employee ID and password — the same credentials you use on the web dashboard.
  3. 3
    Optionally enable Remember me so your Employee ID is pre-filled next time.
  4. 4
    Sign in. Your region choice is remembered until you sign out (signing out resets it to India).

3. The dashboard

After login you land on the home dashboard:

Today's metal rates

Live 22K / 18K / 14K gold and silver rates for your region — the same board that prices every estimate.

Today's estimate count

How many estimates you have made today, straight from your history.

Quick action: Start an estimate

Jumps into the product catalogue.

Quick action: Find customer

Opens the customer search.

Set today's rates on the web dashboard first

The rates shown here come from the daily metal-price board maintained on the web dashboard at /admin/metal-prices. If the board has not been updated today, estimates would be priced on stale rates — check the rate card on the dashboard before your first quote and ask your manager to update it if needed.

4. Searching & browsing products

  1. 1
    Open the Catalogue. Products load in a grid with infinite scroll — keep swiping and the next page loads automatically.
  2. 2
    Search by typing (or pasting) a product code / barcode number or part of the title into the search box. In-store, the fastest flow is reading the code off the tag and typing it — the piece appears instantly.
  3. 3
    Filter with the filter panel: Classification, Category, Product Type, Sub Category, Location, Collection, plus Price range, Net-weight range and Diamond-weight range. Each dropdown is searchable.
  4. 4
    Long-press to multi-select products and open a side-by-side Compare view.
  5. 5
    Use the navigation drawer to switch to the Best Seller catalogue (with its own filters and estimates) or the Social Media collection (browse-and-show, with full stone details).

5. Customers

The Customers screen has two tabs: Recent (customers checked in under you) and All (global search by name or phone). Open a customer to see their profile and estimate activity, or use quick create to register a walk-in with just a name and phone number.

Attach the customer before estimating

Attaching a customer links your estimates to their profile, so the quote shows up in their history on the web dashboard too — worth the extra ten seconds for any serious enquiry.

Phone numbers are digits only

Quick-create accepts a plain numeric phone number — no spaces, dashes or “+” prefix.

6. Building an estimate

  1. 1
    Open a product and tap ESTIMATE. The dialog fetches the piece’s estimate data and today’s live metal rate for its purity.
  2. 2
    Review the breakdown: date, sales person (you), product and code, purity, metal rate; then Gold (net weight × rate), Making, Wastage / “Vad”, Diamonds and Stones (per-line, from the stone table), subtotal, taxes and the final amount.
  3. 3
    Taxes follow the region’s currency: INR adds 3% GST (TCS shown at 0%); USD adds import/customs duty first, then sales tax on the duty-inclusive amount.
  4. 4
    To negotiate, tap Edit: change the making rate (per gram), the wastage %, or any stone or diamond’s per-carat rate. Totals recompute live as you type. Lowering these rates is how discounts are given — there is no separate discount field.
  5. 5
    Check the notes at the bottom of the estimate: the slip is valid today only, gross weight is stated, and Indian estimates carry the PAN-card note for purchases above ₹2 lakh.
  6. 6
    Finish with Print (section 7) or Share (section 8) — either way the estimate is saved to your history.

7. Printing on a thermal printer

  1. 1
    Tap Print on the estimate, then choose With rate (shows the rate column on the slip) or Without rate (amounts only — the usual choice for handing to a customer).
  2. 2
    The app connects to your default printer automatically (reconnecting if needed) and prints the slip: “Estimate Only” header, date and sales person, product with karat and barcode, the item table (Gold Wt, Making, Vad, Dia Cts, Cls Cts), tax lines, TOTAL, the per-stone detail table and the numbered notes.
  3. 3
    When printing completes, the estimate is marked printed in your history.

Under the hood the app supports four printer backends, so it works with practically any receipt printer in the store:

1 · AutoReplyPrint SDK

The vendor SDK for Caysn-family Wi-Fi thermal printers — full-speed raw thermal output on 80mm paper.

2 · Direct TCP (ESC/POS)

Raw ESC/POS bytes straight to the printer's network port (9100, with automatic fallback ports). The universal option — works with any network ESC/POS printer.

3 · POSPrinter SDK

A legacy SDK backend kept for compatibility; printers configured with it are automatically served via Direct TCP.

4 · Android native print

Switch print mode to “Native” and the estimate renders as a document through Android's system print dialog — use any system-registered printer or save as PDF.

If a print fails

Make sure the tablet and the printer are on the same Wi-Fi network and the printer’s IP is reachable. In Printer Settings, the AUTO connection method tries the SDK first and falls back to Direct TCP automatically — and remembers whichever worked. Only one print job runs at a time, so wait for the current slip before tapping print again.

8. WhatsApp sharing the PDF

  1. 1
    Tap Share on the estimate. The app sends your estimate — including any edited making / wastage / stone rates — to the server, which renders two PDF versions and returns their links.
  2. 2
    In the share dialog choose With rate or Without rate.
  3. 3
    The chosen PDF link opens in WhatsApp ready to send to the customer (if WhatsApp is not installed, the standard Android share sheet appears instead).
  4. 4
    The estimate is marked shared in your history.

Print vs Share

Printing renders the slip on the device; sharing generates the official server-side PDF. Both record the estimate — use Share whenever the customer wants a digital copy they can forward to family.

9. Estimate history & reprint

  1. 1
    Open History from the dashboard. Estimates are grouped into Today, This Week and All, each row showing product, amount, and printed / shared status.
  2. 2
    Tap an estimate for the full detail sheet, then Reprint — the slip reprints exactly as it was issued, with the original rates and totals, no recalculation at today’s rates.
  3. 3
    Or tap Share to send a text summary of the estimate via WhatsApp.

History is kept on the server too

Estimates are persisted server-side with their full breakdown, so your history survives app reinstalls and device changes, and managers can see estimates-per-day reporting on the web dashboard. The on-device copy keeps reprints instant even with weak Wi-Fi.

10. Printer settings

Open Printer Settings from the dashboard to manage your printing setup:

Print mode

SDK (raw thermal via the SDK / Direct TCP backends — recommended for receipt printers) or Native (Android system print dialog).

Printer list

Add, edit and remove printers. The add wizard supports Wi-Fi (IP address + port, default 9100), Bluetooth and USB printers.

Per-printer options

Brand, paper width (58mm or 80mm) and connection method — AUTO, SDK or DIRECT. Leave AUTO unless told otherwise.

Default printer

Mark one printer as default; every estimate prints there without asking.

Test print

Connect and print a test slip to verify a new printer before the first customer of the day.

Recommended store setup

A Wi-Fi 80mm thermal printer on a fixed IP with port 9100, connection method AUTO, set as default — this covers both SDK-capable printers and generic ESC/POS models with zero fiddling.