DIGIT Docs
  • DIGIT Knowledge Base
  • Local Governance
  • Introducing mGramSeva
    • Platform
      • Release Notes
        • Web Caching
        • Service Build Updates
        • MDMS Configuration & Migration Updates
        • Test Cases
        • Release Checklist
        • Implementation Checklist
      • Technology
      • Architecture
      • Demo video
      • Configure mGramSeva
        • Vendor Registry Service
        • User Events Service
        • eChallans Service
        • Water Calculator Service
        • Property Services
        • Billing Service
        • Apportion Service
      • Technical User Docs
        • Application Structure
        • Firebase Analytics Integration
        • Integration Testing
        • Integration Testing With Github Actions
        • Backend Services
          • mGramSeva - Water Services
          • mGramSeva - Water Service Calculator
          • mGramSeva e-Challan Service
          • mGramSeva - User Service
          • mGramSeva - Billing Service
          • mGramSeva - User OTP
          • iFix Adapter Integration Service
          • mGramSeva - Rollout Dashboard
          • mGramSeva Scheduler
          • mGramSeva- Services Re-Indexing
          • mGramSeva Dashboard
          • Events Push To IFIX Adapter
        • Tech User Manual
          • Language Selection
          • Login
          • Change Password
          • Edit Profile
          • Home Page
          • Forgot Password
          • Update Password FTL
          • Generate Bill
          • Search Connection
          • Consumer Details
            • Create Consumer
            • Update Consumer
          • Expenses
            • Add Expenses
            • Search Expense Bills
            • Modify Expenses
          • Dashboards
            • Monthly Dashboard
            • Collections Dashboard
            • Expenditure Dashboard
          • Collect Payment
          • Consumer Feedback
          • Household Register
          • Bluetooth Thermal Printer Integration
        • Application Permissions & Dependencies
        • mGramSeva UI
          • UI Mockups
          • mGramSeva UI
            • mGramSeva - Advance Changes
            • mGramSeva Penalty Changes
      • Installation
      • Configuration
    • Enablement toolkits
      • AWS Installation
        • Setup AWS Account
        • Certificate Purchase
        • Setup Git Repository
        • Domain Name Configuration
        • Create Git Account In The Client Name
      • Setting up Services
        • Getting Started With DIGIT
        • Creating Users
        • Loading Employees For mGramSeva
        • Loading Consumers For mGramSeva
        • Localisation Module
        • Updating Master Rate for Mgramseva
        • Create Consumer API
        • Create User API
        • SMS Template
        • mGramSeva MDMS
        • Create New Tenant
        • Workflow
    • Product Docs
      • Functional Docs
        • Login & Forgot Password
        • User Roles & Home Screen
        • Create Consumer
        • Search Consumer
        • Edit Consumer
        • View Consumer
        • Billing - Bulk Demand Generation
        • Billing - Metered Connection
        • Revenue Collection - Offline
        • Expenditure - Add Expense
        • Expenditure - Modify Expense
        • User Onboarding - Bulk Upload
        • User Onboarding/Walkthrough
        • Feedback - Post Payment
        • SMS Notifications
        • Home Page Notifications
        • Edit User Profile
        • Bill and Receipt PDF
        • Update Expense Search
        • Bulk Demand Generation For Non-Metered Connection
        • Demand/Bill Generation For Metered Connection
        • Household Register
        • Tabular Dashboard - Expense
        • Tabular Dashboard - Collection
        • Download Bills & Receipt
        • App Force Update
        • HRMS
        • Advance Changes
      • User Docs
        • User Manual
  • 🚻Community
    • Roadmap
    • Source Code
    • Discussion
    • Events
    • Training & Certification
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
  • Overview
  • Manual Bulk Demand Generation
  • User Interaction On Screen
  • Logic Implemented For Billing Cycles
  • Files Path
  • Field Validations
  • API Details
  • Bill Generation - Metered
  • User Interaction On Screen
  • User Interaction On Bill Generation Success Screen
  • Files Path
  • Field Validations
  • API Details

Was this helpful?

Edit on GitHub
Export as PDF
  1. Introducing mGramSeva
  2. Platform
  3. Technical User Docs
  4. Tech User Manual

Generate Bill

PreviousUpdate Password FTLNextSearch Connection

Last updated 2 years ago

Was this helpful?

Overview

This page provides the 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

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)

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 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.

  • 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

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

Meter Reading 5 digit boxes field

  • SelectFieldBuilder

(Primary File)

  • SearchSelectFieldBuilder

(Secondary File)

Searchable Drop down

DatePickerFieldBulder

Date Picker

CommonSuccessPage

Success Screen

BottomButtonBar

Button

Primary Files:

User Interaction On Bill Generation Success Screen

Primary Files:

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
punjab-mgramseva/GenerateBill.dart at develop · egovernments/punjab-mgramseva
punjab-mgramseva/GenerateBill.dart at develop · egovernments/punjab-mgramseva
Manual bulk generation of demand for non-metered connections
Bill generation for metered connections