DIGIT Docs
  • DIGIT Knowledge Base
  • Local Governance
  • Introducing NalJalSeva
  • 🚰NalJal
    • Approach
    • Demo Video
    • Value Proposition
  • 🌊Product Specifications
    • Features & Functions
    • Workflows
      • Login & Forgot Password
      • View Consumer
      • Update Consumer
      • Water Charges
      • Generate Bulk Demand & Raise Bills
      • Generate Bills For Metered Connections
      • Collect Revenue Offline
      • Add Expense
      • Update Expense
      • Send SMS Notifications
      • Edit User Profile
      • View Household Register
      • View Tabular Dashboard For Expense
      • Download Bills & Receipts
      • View & Download Reports
      • HRMS
        • Login, Reset & Forgot Password
        • Create Employee
        • Update Employee
        • Search Employee
        • Search Department Employee
        • Edit Scheme Rate Master
        • Edit Penalty Master
        • State Dashboard
        • Rollout Dashboard
        • Rate Dashboard
    • User Manual
      • Common Functions
        • Login To App
        • Edit Profile & Change Password
      • Division User
        • View & Edit Consumer
      • Village Water & Sanitation Committee (VWSC) User
        • Generate Bills
        • Search Consumer & Generate Payment
        • Record & Modify Expense Bill
        • View Dashboards
      • State User
  • Reference Implementations
    • Punjab
      • mGramSeva
  • ⚒️NalJalSeva Platform
    • Architecture
    • Technology
  • 💧Setup NalJalSeva
    • Setup NalJalSeva
      • Install AWS
        • Setup AWS Account
        • Purchase Certificate
        • Setup Git Repository
        • Configure Domain Name
        • Create Git Account In The Client Name
      • Enable Application Permissions
      • Get Started With DIGIT
      • Create Users
      • Load Employees For NalJalSeva
      • Load Consumers For NalJalSeva
      • Configure Module Localisation
      • Update Master Rate
      • Create Consumer API
      • Create User API
      • Configure SMS Template
      • Configure Master Data Management System
      • Create New Tenant
      • Create Workflow
    • Configure NalJalSeva
      • Configure Core Services
      • Configure Backend Services
        • Advance Changes
        • Apportion
        • Billing
        • Dashboard
        • eChallan
        • iFIX Adapter
          • Push Events To iFIX Adapter
        • Penalty Changes
        • Property
        • Reindexing
        • Rollout Dashboard
        • Scheduler
        • User
        • User OTP
        • User Events
        • Vendor Registry
        • Water
        • Water Calculator
      • Configure UI Screens
        • UI Design
        • Select Language
        • Login
        • Change Password
        • Edit Profile
        • Home Page
        • Forgot Password
        • Update Password
        • Generate Bill
        • Search Connection
        • Consumer Screens
          • Create Consumer
          • Update Consumer
        • Expense Screens
          • Add Expense
          • Search Expense Bills
          • Modify Expenses
        • Dashboards Screens
          • Monthly Dashboard
          • Collections Dashboard
          • Expenditure Dashboard
        • Collect Payment
        • Consumer Feedback
        • Household Register
        • UI Mockup Screens
      • Update App
    • Integration Details
      • Integrate Firebase Analytics
      • Integrate Bluetooth Thermal Printer
      • Integration Testing
      • Integration Testing With Github Actions
    • Go Live
Powered by GitBook

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

On this page
  • Manual Bulk Demand Generation
  • Files Path
  • Field Validations
  • API Details
  • Stack
  • Bill Generation - Metered
  • User Interaction On Bill Generation Success Screen
  • Files Path
  • Field Validations
  • API Details
  • Stack

Was this helpful?

Export as PDF
  1. Setup NalJalSeva
  2. Configure NalJalSeva
  3. Configure UI Screens

Generate Bill

PreviousUpdate PasswordNextSearch Connection

Last updated 10 months ago

Was this helpful?

This page provides the UI screen technical details for the following features -

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:

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 the Library

Widgets
File Path
Description
  • SelectFieldBuilder

(Primary File)

  • SearchSelectFieldBuilder

(Secondary File)

Searchable Dropdown

CommonSuccessPage

Success Screen

BottomButtonBar

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 a 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:

Field Validations

Fields
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 End Point
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 the Library

Widgets
File Path
Description

MeterReading

Meter Reading 5 digit boxes field

  • SelectFieldBuilder

(Primary File)

  • SearchSelectFieldBuilder

(Secondary File)

Searchable Drop down

DatePickerFieldBulder

Date Picker

CommonSuccessPage

Success Screen

BottomButtonBar

Button

💧
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
https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/CommonSuccessPage.dart
https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/BottonButtonBar.dart
https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/screeens/GenerateBill/widgets/MeterReading.dart
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
https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/DatePickerFieldBuilder.dart
https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/CommonSuccessPage.dart
https://github.com/egovernments/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/widgets/BottonButtonBar.dart
Manual bulk generation of demand for non-metered connections
Bill generation for metered connections
punjab-mgramseva/GenerateBill.dart at develop · egovernments/punjab-mgramseva
punjab-mgramseva/GenerateBill.dart at develop · egovernments/punjab-mgramseva