DIGIT mGramSeva
PlatformDomainsAcademyDesign SystemFeedback
v1.2
v1.2
  • 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
  1. Introducing mGramSeva
  2. Platform
  3. Technical User Docs
  4. Tech User Manual

Generate Bill

PreviousUpdate Password FTLNextSearch Connection

Last updated 2 years ago

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