Generate Bill
- Ramkrishna Sahoo
- Anjoo Narayan
Manual Bulk Demand Generation
Link. → {base url}/mgramseva/home/billmanualgenerate.
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.
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: https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/screeens/GenerateBill/GenerateBill.dart
Field Validations
SL | Fileds | Validations |
|---|---|---|
1 | Billing Year* |
|
2 | Billing Cycle* |
|
API EndPoint | Input Params (Modules) | Description |
|---|---|---|
|
| To Fetch the Details of
|
API Details
SL | End Point | Request Method | Request Info |
|---|---|---|---|
1 |
|
| "tenantId": {}, |
Stack
1 → Home Screen. + Generate Bulk Demand Screen
Pop → Home Screen
Widgets Utilised from Library
SL No | Widgets | File Path | Description |
|---|---|---|---|
1 |
(Primary File)
(Secondary File) | Searchable Drop down | |
2 |
| Success Screen | |
3 |
| 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 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: https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/screeens/GenerateBill/GenerateBill.dart
Field Validations
SL | Fileds | Validations |
|---|---|---|
1 | Previous Meter Reading* |
|
2 | New Meter Reading* |
|
3 | Meter Reading Date* |
|
API EndPoint | Input Params (Modules) | Description |
|---|---|---|
|
| To Fetch the Details of
|
API Details
SL | End Point | Request Method | Request Info |
|---|---|---|---|
1 |
|
| "meterReadings": { } |
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 |
| Meter Reading 5 digit boxes field | |
2 |
(Primary File)
(Secondary File) | Searchable Drop down | |
3 |
| Date Picker | |
4 |
| Success Screen | |
5 |
| Button |