Generate Bill

Overview

This page provides the technical details for the following features -

• Manual bulk generation of demand for non-metered connections

• Bill generation for metered connections

Manual Bulk Demand Generation

Users are redirected to this screen once they click on the Generate Demand card on the home screen.

• This is used in cases when the scheduler is not running (due to technical errors) and the GP wants to run it manually.

Link → {base url}/mgramseva/home/billmanualgenerate

Default Values Set

• The service category displays water charges by default

• The service type displays a non-metered connection by default

User Interaction On Screen

• Set the billing year from the drop-down which contains the list of financial years.

• Set the Billing cycle which contains billing cycles for the selected financial year.

• On clicking the Generate Demand Button, Bulk Demand is generated and the user is navigated to the success screen.

Logic Implemented For Billing Cycles

• The Billing Cycle drop-down shows a list of months starting from the selected financial year from Date month till the current date month.

• On selection of the desired month, the billing period value is set from the selected month’s first date to the selected month’s last date. (Eg. Selected Billing Cycle: June 2021, so Billing period: 01/07/2021 - 30/07/2021)

Files Path

Primary Files: punjab-mgramseva/GenerateBill.dart at develop · egovernments/punjab-mgramseva

Field Validations

Fields	Validations
Billing Year*	isMandatory
Billing Cycle*	isMandatory

API End Point	Input Params (Module)	Description
egov-mdms-service/v1/_search	ws-services-masters PropertyTax BillingService	To Fetch the Details of connectionType from ws-services-masters TaxPeriod from BillingService where service=='WS' && @.fromDate <= $datestamp && @.toDate >= $datestamp

API Details

End Point	Request Method	Request Info
/ws-calculator/waterCalculator/_bulkDeman	POST	"tenantId": {}, "billingPeriod": {}

Stack

1 → Home Screen. + Generate Bulk Demand Screen

Pop → Home Screen

Widgets utilised from Library

Widgets	File Path	Description
SelectFieldBuilder (Primary File) SearchSelectFieldBuilder (Secondary File)	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/SelectFieldBuilder.dart https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/SearchSelectFieldBuilder.dart	Searchable Dropdown
CommonSuccessPage	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/CommonSuccessPage.dart	Success Screen
BottomButtonBar	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/BottonButtonBar.dart	Button

Bill Generation - Metered

Users are redirected to the Generate New Bill screen once they click on the Generate New Bill option in the household detail screen.

Link

→ {base url}/mgramseva/home/householddetails/billgenerate

Default Values Set

• The service category defaults to water charges

• The service type defaults to metered connection

• The property type defaults to the selected property type of the consumer

User Interaction On Screen

• Previous Meter Reading: Takes input from the user only for a first-time bill generation and if the Previous meter reading is null, else it's defaulted if the meter reading is present.

• New Meter Reading: Takes input from the user

• Meter Reading Date: Defaulted to today’s date, the User can change it to the desired date.

User Interaction On Bill Generation Success Screen

• Users have the option of downloading the bill or sharing it via Whatsapp

• On click of the Collect Payment button, the user is navigated to the Payment Screen

Files Path

Primary Files: punjab-mgramseva/GenerateBill.dart at develop · egovernments/punjab-mgramseva

Field Validations

Fileds	Validations
Previous Meter Reading*	r'^[0-9]+$' 5 - digit reading if Meter Reading < 5 digit, prepend zeroes
New Meter Reading*	r'^[0-9]+$' 5 - digit reading if Meter Reading < 5 digit, prepend zeroes
Meter Reading Date*	Shows dates till today's date

API EndPoint	Input Params (Modules)	Description
egov-mdms-service/v1/_search	ws-services-masters PropertyTax BillingService	To Fetch the Details of connectionType from ws-services-masters PropertyType from PropertyTax TaxHeadMaster from BillingService where service=='WS'

API Details

End Point	Request Method	Request Info
/ws-calculator/meterConnection/_create	POST	"meterReadings": { "currentReading": {}, "currentReadingDate": {}, "billingPeriod": {}, "meterStatus": "Working", "connectionNo": {}, "lastReading": {}, "lastReadingDate": {}, "generateDemand": true, "tenantId": {} }

Stack

1 → Home Screen + Household Details Screen + Generate Bill Metered

Pop → Household Details Screen

Widgets utilised from Library

Widgets	File Path	Description
MeterReading	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/screeens/GenerateBill/widgets/MeterReading.dart	Meter Reading 5 digit boxes field
SelectFieldBuilder (Primary File) SearchSelectFieldBuilder (Secondary File)	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/SelectFieldBuilder.dart https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/SearchSelectFieldBuilder.dart	Searchable Drop down
DatePickerFieldBulder	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/DatePickerFieldBuilder.dart	Date Picker
CommonSuccessPage	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/CommonSuccessPage.dart	Success Screen
BottomButtonBar	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/BottonButtonBar.dart	Button