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
- 1Install 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.
- 2On 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.
- 3The app opens the login screen. You will not see this permissions screen again.
Network required
2. Region & login
- 1On 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.
- 2Enter your Employee ID and password — the same credentials you use on the web dashboard.
- 3Optionally enable Remember me so your Employee ID is pre-filled next time.
- 4Sign 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
/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
- 1Open the Catalogue. Products load in a grid with infinite scroll — keep swiping and the next page loads automatically.
- 2Search 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.
- 3Filter 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.
- 4Long-press to multi-select products and open a side-by-side Compare view.
- 5Use 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
Phone numbers are digits only
6. Building an estimate
- 1Open a product and tap ESTIMATE. The dialog fetches the piece’s estimate data and today’s live metal rate for its purity.
- 2Review 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.
- 3Taxes 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.
- 4To 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.
- 5Check 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.
- 6Finish with Print (section 7) or Share (section 8) — either way the estimate is saved to your history.
7. Printing on a thermal printer
- 1Tap 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).
- 2The 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.
- 3When 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
9. Estimate history & reprint
- 1Open History from the dashboard. Estimates are grouped into Today, This Week and All, each row showing product, amount, and printed / shared status.
- 2Tap 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.
- 3Or tap Share to send a text summary of the estimate via WhatsApp.
History is kept on the server too
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