Generate Bill

Manual Bulk Demand Generation

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

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

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

Default Values Set

• The service category displays water charges by default

• The service type displays 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 Click of 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 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

SL.No.	Fields	Validations
1	Billing Year*	isMandatory
2	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

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

Stack

1 → Home Screen. + Generate Bulk Demand Screen

Pop → Home Screen

Widgets Utilised from Library

SL.No.	Widgets	File Path	Description
1	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
2	CommonSuccessPage	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/CommonSuccessPage.dart	Success Screen
3	BottomButtonBar	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/BottonButtonBar.dart	Button

Bill Generation - Metered

Link

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

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

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

SL	Fileds	Validations
1	Previous Meter Reading*	r'^[0-9]+$' 5 - digit reading if Meter Reading < 5 digit, prepend zeroes
2	New Meter Reading*	r'^[0-9]+$' 5 - digit reading if Meter Reading < 5 digit, prepend zeroes
3	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

SL	End Point	Request Method	Request Info
1	/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

Sl. No.	Widgets	File Path	Description
1	MeterReading	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/screeens/GenerateBill/widgets/MeterReading.dart	Meter Reading 5 digit boxes field
2	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
3	DatePickerFieldBulder	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/DatePickerFieldBuilder.dart	Date Picker
4	CommonSuccessPage	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/CommonSuccessPage.dart	Success Screen
5	BottomButtonBar	https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/BottonButtonBar.dart	Button

​All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.