Utility Billing - muruthigitau/new GitHub Wiki

I. ๐Ÿ”Œ Utility Billing Overview

๐Ÿงฉ Main Functionalities

  • ๐Ÿ’ฌ Service Request Management
  • ๐Ÿ“ Meter Reading
  • ๐Ÿ’ฐ Tariff Management
  • ๐Ÿงพ Bulk Billing (Mass Billing)

๐Ÿ” Key Modules & Features

๐Ÿงพ 1. Utility Billing Setup

๐Ÿ› ๏ธ 1.1 Utility Billing Settings

Configure preferences in the Utility Settings doctype.

Key Fields:

  • ๐Ÿ”„ Sales Order / Invoice / Stock Entry Creation State โ€” Choose between "Draft" or "Submitted"
  • ๐Ÿ“ฆ Merge Sales Orders โ€” One invoice per customer across multiple orders

Utility Settings Screenshot

๐Ÿ‘‰ Explore Utility Billing Settings

๐Ÿ‘ฅ 1.2 Customer Grouping

Segment customers for tailored billing (e.g., Residential, Commercial).

Customer Groups

๐Ÿ’ฒ 1.3 Price Lists & Tariffs

Define rates based on customer type, block rates, or service tiers.

Price Lists

๐Ÿ“Š 2. Billing Operations

๐Ÿ“ 2.1 Service Requests

Flow:

  1. Add Request โ†’ Survey โ†’ BOM โ†’ Sales Order
  2. Assign new Meter Numbers
  3. Auto-create Customer & Meter Linkage

Service Request Screenshot

graph TD
    A["Customer / Lead / Prospect (CRM)"] --> B["Create Service Request"]
    B --> C["Create Customer"]
    C --> D["Create Site Survey"]
    D --> H["Create BOM"]
    H --> G
    H --> F
    C --> F["Create Sales Order"]
    C --> G["Create Sales Invoice"]

๐Ÿ‘‰ Explore Service Request

โ›ฝ 2.2 Meter Reading

Steps:

  1. Select Customer
  2. Add Utility Item & Enter Current Reading
  3. System auto-calculates usage
  4. Sales Order is generated on Submit

Meter Reading Screenshot

graph TD
    A[Service Request] --> B{Meter Reading}
    B --> C[Sales Order]
    C --> D[Sales Invoice]
    D --> E[Payment]

๐Ÿ‘‰ Explore Meter Reading

๐Ÿงฎ 2.3 Mass Billing

Steps:

  1. Select multiple Sales Orders
  2. Use Menu โ†’ "Create Sales Invoice"
  3. Background job auto-generates invoices

Mass Billing Screenshot

๐Ÿ“Œ 3. Important Notes

๐Ÿ”ง 3.1 Item Configuration

โœ… Tick "Is Utility Item" to mark billable services.

Is Utility Item Screenshot

๐Ÿ“Ÿ 3.2 Meter Numbers

Managed as Serial Numbers, assigned via Warranty Claim.

Meter Screenshot

๐Ÿ“Ÿ 3.3 Sales Order and Sales Invoice Customizations

The Sales Order and Sales Invoice Doctypes in ERPNext have been customized to incorporate new fields and sections related to utility billing, meter readings, and service requests

๐Ÿ–ผ๏ธ Sales Order Overview ๐Ÿ–ผ๏ธ Sales Invoice Overview

๐Ÿ‘‰ Explore Sales Order and Invoice

๐Ÿš€ Quick Navigation

Home Full Documentation ERPNext Docs Frappe Framework Community Forum Report Issue Website