Bill Structure - muruthigitau/new GitHub Wiki

๐Ÿงพ Utility Bill Structure

The Utility Bill Structure doctype is a configurable template used within the Utility Billing app for ERPNext. It allows users to predefine billable utility items and related charges, which can then be reused and auto-filled in Utility Service Requests.

This reduces repetitive data entry and ensures billing consistency across similar requests for utilities such as water, electricity, or gas.

Utility Bill Structure Screenshot


๐Ÿ“‹ Purpose

The Utility Bill Structure acts as a template for recurring utility billing formats. When a service provider initiates a Utility Service Request, this structure can be linked to automatically populate the necessary items, their amounts, and associated metadata like cost center and project.


โœ… How to Use

  1. Create a Utility Bill Structure with predefined utility items, amounts, and optional discounts.
  2. Link this structure to a Utility Service Request.
  3. Upon linking, all items and charges are auto-filled in the request.

๐Ÿงฑ Doctype Fields

Field Type Description
Fiscal Year Link Required fiscal year
Start Date Date Start date for billing
End Date Date End date for billing
Cost Center Link Optional cost center to track financials
Project Link Optional project association
Items Table List of utility billing items and their amounts (child doctype)
Total Amount Currency Auto-calculated total of all listed item amounts

๐Ÿ“ฆ Child Doctype: Utility Bill Structure Item

Each item in the bill structure is defined in this child table.

Field Type Description
Item Link Reference to the billable item (e.g., Water, Sewerage)
Amount Currency Amount to be charged
Discount Float Optional discount in percentage (%)
Total Currency Net total after applying discount (auto-calculated)

โš™๏ธ Automation Features

When used within a Utility Service Request, the Utility Bill Structure:

  • Autofills all defined utility items into the request
  • Calculates totals and applies discounts
  • Enables standardized billing and streamlined sales workflows

๐Ÿš€ Quick Navigation

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