From setup
to the next weighment.

About this guide

About this guide

This manual explains how to configure and operate the Weighbridge Sale-Billing Module, the desktop application used at the plant weighbridge to record vehicle entry (Sale In), generate sale invoices (Sale Out), and transmit weighment data to the Uttarakhand Directorate of Geology & Mining (DGM) eRavanna portal (eravanna.ukmdtss.in).

It covers, in the order a new installation should be configured:

• Registering the weighbridge on the government eRavanna portal
• Connecting the desktop module to that portal via the Weighbridge API
• Configuring the CCTV cameras and the new RFID reader used to identify vehicles at Sale Out
• Setting up masters (GST, Buyer, Material, Location, Tax)
• Day-to-day use of Sale In and Sale Out
• Reading API error codes when a weighment is rejected

Audience: licensee/plant operators, weighbridge operators, and IT staff installing or supporting the module.

Software: Sale-Billing Module (Positron Software Technologies Pvt. Ltd.) and the eRavanna web portal.

About this guide

Quick start

1. Register the physical weighbridge on the eRavanna portal and record its Weighbridge ID.
2. Connect the desktop module using the Weighbridge API credentials.
3. Configure and test the CP Plus cameras, RFID reader, and weighbridge indicator.
4. Create GST, buyer, material, location, and tax master records.
5. Complete Sale In, then Sale Out, and confirm successful API submission before releasing the vehicle.

Getting started

1. Prerequisites

Before starting, confirm the following are available:

Complete the setup in this order: Portal Login → Profile → Register Weighbridge → Weighbridge API Settings → Camera Settings → RFID Settings → Port Settings → Masters (GST/Buyer/Material/Tax) → Sale In/Sale Out.

Portal configuration

2. Logging Into the eRavanna Portal

1. Open a browser and go to https://eravanna.ukmdtss.in/
2. Click the three horizontal lines (menu icon) at the top right to expand the navigation panel.
3. Click Login in the expanded menu.
4. On the Login screen, enter your Username (Portal Id).
5. Enter the Captcha shown in capital letters, exactly as displayed.
6. Click Get OTP and enter the OTP received on your registered mobile number to sign in.

Portal configuration

3. Setting Up Your Profile

1. After login, open Profile from the left navigation panel.
2. Under Profile Edit, optionally upload a Profile Image (jpg/png/jpeg, max 1 MB) and enter your Name.
3. Click Save Changes.

Weighbridge ID naming convention

When a Weighbridge ID is required anywhere on the portal, use the pattern:

WB-<LesseeId>-1, WB-<LesseeId>-2, WB-<LesseeId>-3, ...

For example, if the Lessee ID is Lesseeid, the first weighbridge is WB-Lesseeid-1; a second weighbridge at the same site is WB-Lesseeid-2, and so on.

Portal configuration

4. Registering the Weighbridge on the Portal

1. From the left menu, expand Master Entries → Weighbridge, then open the Weighbridge create screen (/weighbridge/create).
2. Licensee ID is pre-filled (e.g. SC66000068) — verify it matches your licence.
3. Enter the Weighbridge Number (use the WB-<LesseeId>-1 convention described in Section 3).
4. Enter Contact Person Name and Contact Number for the site.
5. Enter Geolocation Latitude and Geolocation Longitude of the weighbridge (obtain from a GPS app or map service at the physical location).
6. Click Submit.

Repeat this step once per physical weighbridge at the site, incrementing the Weighbridge Number suffix (-1, -2, ...).

Portal configuration

5. Linking the Desktop Module to the Portal (Weighbridge API Settings)

Once the weighbridge is registered on the portal (Section 4), connect the desktop Sale-Billing Module to it:

1. In the Sale-Billing Module, open Settings → Weighbridge API Master.
2. Base URL is pre-set to https://eravanna.ukmdtss.in/
3. Enter the WB Id (the Weighbridge Number saved in Section 4, e.g. WB-Lesseeid-1) and click Load to fetch its registration from the portal.
4. Confirm the Lessee Id that populates automatically.
5. Enter the Authorization Key issued by the portal, along with the Refresh Token and API Token fields.
6. Click Save API for a first-time setup, or Modify API to update existing credentials.
7. Use Refresh API Key if the API Token expires and needs to be renewed without re-entering all details.

Hardware configuration

6. CP Plus Camera Settings

The module streams two live camera feeds (front and back of the vehicle) into the Sale In screen.

1. Open Settings → CP Plus Camera Setting.
2. Enter the Camera 1 IP and Camera 2 IP addresses of the CP Plus cameras/DVR (e.g. 192.168.1.108 for both if they share one recorder).
3. Enter the RTSP Port (default 554).
4. Enter Camera 1 User and Cam1 Password for the front camera, and Camera 2 User and Cam2 Password for the back camera. Tick Show to verify a password as typed.
5. Set Camera 1 and Camera 2 to the DVR channel numbers for the front and back views (e.g. 1 and 2).
6. Set Subtype (stream profile, typically 0 for the main stream).
7. Click Test Live Stream to preview both feeds live before saving; click Stop Preview to end the test.
8. Click Save (or Cancel to discard changes).

Each camera now has its own IP address and login, so the two feeds can come from separate cameras or DVR channels. Once saved, the two feeds appear as Camera 1/Front and Camera 2/Back on the Sale In screen.

Earlier version

Hardware configuration

7. RFID Reader Settings

The module can auto-capture a vehicle's RFID tag during Sale Out, in addition to the camera snapshots. Configure the reader right after Camera Settings (Section 6):

1. Open Settings → RFID Settings (listed just below CP Plus Camera Setting in the Settings menu).
2. Tick Enable RFID reader on Sale Out to turn the feature on.
3. Click Scan Network to auto-discover readers on the local network.
4. Discovered devices appear under Readers found, listed as <IP address>:<port> (e.g. 192.168.1.190:6000).
5. Double-click the correct reader in the list to select it — this fills in the Reader IP address field automatically.
6. Alternatively, type the Reader IP address and TCP port manually if the reader is not discovered by the scan.
7. Click Test Selected to verify connectivity. A confirmation message — "Connection successful. The RFID TCP service is reachable." — appears once the test succeeds.
8. Click Save & Reconnect.
9. A confirmation dialog appears: "RFID settings saved for [reader model]. Open Sale Out readers have been restarted using the saved settings. Check the RFID status for connection progress." Click OK.

Using RFID on Sale Out

Once configured and enabled, the Sale Out screen shows an RFID Tag panel above the camera previews. When a tagged vehicle is read, the panel displays the tag's unique ID (e.g. E2801191A5040076A583D82F) and the time it was read (e.g. "RFID: tag read at 17:28:00"), letting the operator confirm the correct vehicle before saving the sale.

RFID Settings — screen walkthrough

Hardware configuration

8. Port Settings (Weighbridge Indicator)

The weighbridge indicator communicates with the PC over a serial (COM) port and must be configured once:

1. Open Settings → PortTest.
2. Select the Port (COM number) the indicator is connected to.
3. Set Baud Rate, Data Bits, Parity, and Stop Bits to match the indicator's configuration (commonly 9600, 8, None, 1).
4. Click Connect to test the link — live weight readings should appear in the output panel.
5. Click Save once the correct weight is confirmed.

Master data setup

9. GST Master

Enter the company's own GST details once, used on every generated invoice and for e-Invoice generation:

1. Open Settings → GST Master.
2. Fill in Our GST No., Our Legal Name, Our Add 1 / Add 2, Our Pin Code, and Our GST Code (e.g. 05).
3. Enter Ph No., Email Id, and Location (e.g. Haldwani, Ajitpur).
4. Click Save Company Details.

Master data setup

10. Buyer Master

1. Open Enter Buyer Master, and select Type = Buyer (or Ledger for non-buyer accounts).
2. Enter Ledger Legal Name, Contact Name, address Line 1 / Line 2, State, City, and Pincode.
3. Enter Mobile and Email (Off).
4. Enter the GST Code; click the Find (magnifier) icon to auto-fetch GST State Code and validate the GST status — the label above switches between GST Status (unverified) and Active (verified).
5. Set Credit Limit and Opening Balance (Op Bal) if applicable.
6. Optionally fill Shipping Legal Name / Trade Name and shipping address if different from the billing address, or tick Same As Billing Address. Choose the Select Location for the sale (must match a location saved in Material Master, Section 11).
7. Click Add New Buyer for a new ledger, or Modify to update a buyer selected from the list on the right.

Master data setup

11. Material and Location Master

Material Master (left panel):

1. Open Material Master.
2. Enter Material Name, Rate, and HSN Code.
3. Enter the Mineral ID as issued by the department for that material.
4. The saved materials list (Mineral ID, Material, Rate, HSN Code) appears in the grid below.

Location Master (right panel):

1. Enter the Location name (e.g. a village/town the buyer ships to).
2. Choose Select State: Within State or Out State, depending on the buyer's location relative to the plant.
3. Click Save Location, or Modify to update an existing one. The saved list shows each Location and its Sale type (Within/Outer).

Master data setup

12. Tax Master

1. Open EnterTax.
2. Enter Tax Name (e.g. IGST, CGST, GST@5%, GST@18%, STOCK TRANSFER) and its Tax Rate.
3. Saved taxes appear in the grid and become selectable on the Sale Out screen (Section 14).

See the Tax Master screenshot below for the saved tax grid.

Daily operations

13. Sale In (Vehicle Entry)

Record the empty (tare) or laden-in weight of a vehicle as it enters the plant:

1. Open EnterSale → Sale In.
2. Select Buyer from the dropdown (or CASh Sales for a cash transaction).
3. Enter Vehicle No. (registration number).
4. Click Get Weight to pull the live reading from the weighbridge indicator (configured in Section 8).
5. Confirm the vehicle in the Camera 1/Front and Camera 2/Back previews.
6. Click Save Vehicle In.

Use Camera Settings / Weighbridge Settings buttons on this screen to jump back to Sections 6 and 8 respectively if a camera feed or the weight reading looks wrong. Restart Port reconnects the weighbridge serial link without leaving the screen.

Daily operations

14. Sale Out (Billing)

1. Open EnterSale. Select TokenNo for the vehicle already recorded in Sale In (shows buyer, vehicle number and Sale In time).
2. Select Buyer, Select Material, Select Rate, Select Tax, and Place of Supply.
3. If RFID is enabled (Section 7), confirm the vehicle against the RFID Tag panel before proceeding.
4. Click Get Weight to capture the gross weight (GrWt); Empty Wt is pulled from the matching Sale In record.
5. Review the calculated Amt, R Off Amt, and tax breakup (CGST / SGST / IGST).
6. Click Save Sale. Use Modify Sale to correct a saved-but-uninvoiced entry, Reprint Last Invoice to reprint, and Show Sale In Details / Show Details to review linked records.
7. Click Reload to clear the screen and load the next pending token.

Integration and support

15. Weighment Submission to the eRavanna API

When Save Sale is clicked, the module submits the weighment to the eRavanna API using the credentials saved in Section 5. A Submit weighment response popup confirms the result, e.g.:

{"status":"success","status_code":"SC000","message":"Data received successfully."}

Once SC000 – Data received successfully is confirmed, click Reload to load the next vehicle.

Integration and support

16. API Error Codes

Troubleshooting tips:

• ER002 / ER003 — go to Section 5 and use Refresh API Key, then Save API.
• ER004 — recheck the weighbridge indicator and Port Settings (Section 8); the gross weight must exceed the tare/empty weight.
• ER007 / ER008 / ER009 / ER010 — verify the weighbridge and vehicle are correctly registered/approved on the eRavanna portal (Sections 2–4).
• ER011 / ER012 — wait for the duplicate window to clear, or confirm the vehicle was not already weighed.

Integration and support

17. Support

Positron Software Technologies Pvt. Ltd.

• Support: www.positronone.in
• www.positronsoftwares.com
• www.goproerp.in