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.
๐ 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
- Create a Utility Bill Structure with predefined utility items, amounts, and optional discounts.
- Link this structure to a Utility Service Request.
- 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