/
Generate Bill

Generate Bill

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

SL

Fileds

Validations

1

Billing Year*

isMandatory

2

Billing Cycle*

isMandatory

API EndPoint

Input Params (Modules)

Description

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

  • TaxPeriod from BillingService where service=='WS' && @.fromDate <= $datestamp && @.toDate >= $datestamp

API Details

SL

End Point

Request Method

Request Info

SL

End Point

Request Method

Request Info

1

/ws-calculator/waterCalculator/_bulkDemand

POST

"tenantId": {},
"billingPeriod": {}

Stack

1 → Home Screen. + Generate Bulk Demand Screen

Pop → Home Screen

Widgets Utilised from Library

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

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

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

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

Related content

Collect Payment
Collect Payment
More like this
Consumer Creation
Consumer Creation
Read with this
Billing Service
Billing Service
More like this
mGramSeva UI
Read with this
Water & Sewerage- Bill Details
Water & Sewerage- Bill Details
More like this
Application Permissions and Dependencies
Application Permissions and Dependencies
Read with this