Water and Sewerage- Promotion Document

Description:

The Water & Sewerage module deals with the process of applying and managing water & sewerage connections. This module has both Citizen and employee-facing components. As part of Phase 1, the citizen has the ability to search connections, make payments, print receipts, download bills etc. The employee has the option to search connections, receive payments and enter meter reading

Notes:

  • This service integrates with Property Registry which is also in development. 

  • In case Property ID is not provided as part of the create water/sewerage connection a new property is created using the data provided.

  • Employees performing actions on user application must have suitable state-level roles

 

Actors: Citizen, Employee


Promotion Steps:


Backend :

 

 

{  "businessService": "ws-services-calculation",       "code": "WS",       "collectionModesNotAllowed": [         "DD"       ],       "partPaymentAllowed": true,       "isAdvanceAllowed": true,       "demandUpdateTime": 86400000,       "isVoucherCreationEnabled": false     },       {       "businessService": "sw-services-calculation",       "code": "SW",       "collectionModesNotAllowed": [         "DD"       ],       "partPaymentAllowed": true,       "isAdvanceAllowed": true,       "demandUpdateTime": 86400000,       "isVoucherCreationEnabled": false     }

     

 

  • Update taxhead master to define the new tax heads for Water and Sewerage



{       "category": "CHARGES",       "service": "WS",       "name": "Water Charges",       "code": "WS_CHARGE",       "isDebit": true,       "isActualDemand": false,       "order": "0",       "isRequired": false     },     {       "category": "TAX",       "service": "WS",       "name": "Rebate",       "code": "WS_TIME_REBATE",       "isDebit": true,       "isActualDemand": false,       "order": "0",       "isRequired": false     },     {       "category": "TAX",       "service": "WS",       "name": "Interest",       "code": "WS_TIME_INTEREST",       "isDebit": false,       "isActualDemand": true,       "order": "1",       "isRequired": false     },     {       "category": "TAX",       "service": "WS",       "name": "Water Cess",       "code": "WS_WATER_CESS",       "isDebit": false,       "isActualDemand": true,       "order": "2",       "isRequired": false     },     {       "category": "PENALTY",       "service": "WS",       "name": "Penalty",       "code": "WS_TIME_PENALTY",       "isDebit": false,       "isActualDemand": true,       "order": "3",       "isRequired": false     },     {       "category": "TAX",       "service": "WS",       "name": "Round Off",       "code": "WS_Round_Off",       "isDebit": false,       "isActualDemand": true,       "order": "4",       "isRequired": false     },     {       "category": "CHARGES",       "service": "SW",       "name": "Sewerage Charges",       "code": "SW_CHARGE",       "isDebit": true,       "isActualDemand": false,       "order": "0",       "isRequired": false     },     {       "category": "TAX",       "service": "SW",       "name": "Rebate",       "code": "SW_TIME_REBATE",       "isDebit": true,       "isActualDemand": false,       "order": "1",       "isRequired": false     },     {       "category": "TAX",       "service": "SW",       "name": "Interest",       "code": "SW_TIME_INTEREST",       "isDebit": false,       "isActualDemand": true,       "order": "2",       "isRequired": false     },     {       "category": "PENALTY",       "service": "SW",       "name": "Penalty",       "code": "SW_TIME_PENALTY",       "isDebit": false,       "isActualDemand": true,       "order": "3",       "isRequired": false     },     {       "category": "TAX",       "service": "SW",       "name": "Round Off",       "code": "SW_Round_Off",       "isDebit": false,       "isActualDemand": true,       "order": "4",       "isRequired": false     }



  • Update taxperiod to include the Tax Periods for Water and Sewerage



{       "fromDate": 1554076800000,       "toDate": 1585612800000,       "periodCycle": "ANNUAL",       "service": "WS",       "code": "WC2018",       "financialYear": "2019-20"     },     {       "fromDate": 1554076800000,       "toDate": 1585612800000,       "periodCycle": "ANNUAL",       "service": "SW",       "code": "SC2018",       "financialYear": "2019-20"     }

 

  • Add the following to the masterconfig.json

 



 

 





 

 

Migrate the following IDGEN formats to
https://github.com/egovernments/egov-mdms-data/blob/master/data/pb/common-masters/IdFormat.json

 

 

Endpoints

Please whitelist endpoint from zuul wherever required

Auth Based Access: Employee

  • /ws-services/wc/_create :- 

  • /ws-services/wc/_update 

  • /sw-services/wc/_update 

  • /sw-services/wc/_create 

  • /ws-calculator/meterConnection/_create

  • /ws-calculator/meterConnection/_calculate

  • /sw-calculator/meterConnection/_calculate

  • /sw-calculator/sewerageCalculator/_calculate

 

 

Auth Based: Citizen, Employee

  • /ws-services/wc/_search :- mixed (both whitelisted and auth based)

  • /sw-services/wc/_search :- mixed (both whitelisted and auth based)

  

Users:

  • Employee with ULB level access 

  • Citizen associated with an ULB

 

Workflow config 

Not Applicable

 

Service Builds

  • Billing Service - billing-service:61-BILL_V2_FEATURE-39a9d0a

  • Property Service - property-services:28-PROPERTY_REGISTRY_FEATURE-0c1ef88

  • Citizen: citizen:376-release-Jan_6-bc2b1a6f

  • Employee: employee:399-release-Jan_6-bc2b1a6f

  • Sewerage Calculator - sw-calculator:9-ws_tarento_release_Jan_6-7187801

  • Sewerage Services - sw-services-db:11-ws_tarento_release_Jan_6-3d105cb

  • Water Services - ws-services:30-ws_tarento_release_Jan_6-c707d37

  • Water Calculator - ws-calculator:26-ws_tarento_release_Jan_6-2dd1932

  • PDF Service - pdf-service:33-pdf-changes-1ceb7c9

 

Swagger API’s 

https://github.com/egovernments/municipal-services/tree/ws_tarento_release_Jan_6/sw-calculator/docs

https://github.com/egovernments/municipal-services/tree/ws_tarento_release_Jan_6/sw-services/docs

https://github.com/egovernments/municipal-services/tree/ws_tarento_release_Jan_6/ws-calculator/docs

https://github.com/egovernments/municipal-services/tree/ws_tarento_release_Jan_6/ws-services/docs

 

Postman Collection

Postman collection for Create Water and Sewerage API’s

https://drive.google.com/file/d/1mi4_8Wg9djRM9fobGgvKvz8fyHXt3Ixx/view?usp=sharing 1

 

Persister Config

 

Localisation File

https://docs.google.com/spreadsheets/d/1JTnaV1BDtFWPIX_h4y2WtmGKB-lEthTyCfnDjKzHMSE/edit#gid=0  

 

Features Covered as part of Release

Module

Feature

Citizen

Search Connection

Citizen

View Bill

Citizen

Pay Dues if any (Full or Partial Payment)

Citizen

Download / Print Receipt immediately after successful payment

Employee

Search Connection

Employee

View Bill

Employee

Collect Dues

Employee

Download / Print Receipt immediately after successful payment

Employee

Enter meter reading of connections individually



Generate Bill for metered connections

Citizen

View and download receipts of past payments

Citizen

View existing connections

Citizen

View connection details

 

Pending Features

Citizen

Receive notification of bill generated

Citizen

Notification of payment failure

Employee

Merge and download bills

Backend

Job Scheduler for scheduled demand generation

 

Out of Scope

The Format for Bill and Receipt are being handled by the common PDF services. There are still hard coded values for Property in the format. We have raised the same with the concerned team

Bill Genie integration is pending. There is no change required from W&S module. The changes will have to be incorporated in the bill genie module