Overview

This page offers a detailed insight into the user interface features, screens, and navigation available for the eChallan service in the mCollect module. Browse through this document to find the eChallan service details, MDMS and localization details.

Objective

1. Generate e-challans / bill for all miscellaneous / Adhoc services which citizens avail from ULBs

2. The ability for ULBs to Notify citizens about the outstanding payments - Online and offline

3. Enable Digital payments for citizens - QR code, payment link in notifications, etc.

Employees will be able to Create Challan, by selecting the service category, entering all consumer information and tax head details.

mCollect - Create Challan

Click here to find the create new challan file changes.

Selecting City is disabled as UC Employee of City A should be able to access/create only City A related challans.

MDMS Details

{
  "tenantId": "pb.amritsar",
  "moduleDetails": [
    {
      "moduleName": "BillingService",
      "masterDetails": [
        {
          "name": "BusinessService",
          "filter": "[?(@.type=='Adhoc')]"
        },
        {
        "name":"TaxPeriod"
        }
      ]
    },
    {
      "moduleName": "common-masters",
      "masterDetails": [
        {
          "name": "uiCommonPay"
        }
      ]
    }
  ]
}

Service Type and Service Category Dropdown Formation

Based on the response, Service Type and Service category Dropdowns are Loaded. For eg: Refer to the response object

{
  "businessService": "WaterCharges.Metered",
  "code": "WaterCharges.Metered",
  "collectionModesNotAllowed": [
    "DD"
  ],
  "partPaymentAllowed": false,
  "isAdvanceAllowed": true,
  "demandUpdateTime": 86400000,
  "isVoucherCreationEnabled": false,
  "type": "Adhoc"
}

Based on that "businessService": "WaterCharges.Metered"

The service Category is "WaterCharges" and the service Type is "Metered" The conversion of business Service utils is setServiceCategory method present in ``https://github.com/egovernments/frontend/blob/39ffbeb4f5446bbb08729e9ce6cf0d519f2f748c/web/rainmaker/dev-packages/egov-uc-dev/src/ui-config/screens/specs/utils/index.js

Tax Head Dropdown Formation

Based on the MDMS response TaxHeadMaster are formed by selection service type dropdown.

Filter the initial Taxhead master with selected service type with service attribute in each Taxheads.

Other Validations and Create challan can be refered in https://github.com/egovernments/frontend/blob/39ffbeb4f5446bbb08729e9ce6cf0d519f2f748c/web/rainmaker/dev-packages/egov-uc-dev/src/ui-config/screens/specs/uc/newCollectionResource/newCollectionFooter.js

createChallan method is used to create challan.

/echallan-services/eChallan/v1/_create API is used to create a challan.

Users will be able to see the Challan Acknowledgement once the Challan is created successfully,

Actions available:

1. Proceed to Payment

2. Download/print Challan

3. Navigate back to Home page

Challan’s can be downloaded through this API egov-pdf/download/UC/mcollect-challan?challanNo=

Localisation Module

rainmaker-uc

API Used

1. egov-mdms-service/v1/_search

2. echallan-services/eChallan/v1/_create

3. egov-pdf/download/UC/mcollect-challan

Role Action Mapping

Document Resources and Links

Overview

This page offers the UI details for the search and pay challan feature. Once a Challan is created, in order to Pay the challan or update the challan, we have to find the relevant challan.

Search and Pay

A citizen can only search the challan, download the challan, and pay for the challan.

In order to make any payment for challans, both Citizen and Employee roles, use the Bill genie screens to get the bill and can proceed for payment.

BillGenie

To Enable the service category to search we have to configure billGineiURL in MDMS as follow.

{
  "businessService": "Taxes.No Dues Certificate",
  "code": "TX.No_Dues_Certificate",
  "collectionModesNotAllowed": [
    "DD"
  ],
  "partPaymentAllowed": false,
  "isAdvanceAllowed": false,
  "demandUpdateTime": 86400000,
  "isVoucherCreationEnabled": true,
  "type": "Adhoc",
  "billGineiURL": "egov-searcher/bill-genie/mcollectbills/_get"
}

Once billGineiURL is configured for a service, we get an option in bill genie to search for it.

Once the challan is created to Update or cancel challan we use Challan Search.

Click here to find the Search Challan file and the Search Results file.

Localisation Module

rainmaker-uc

API Used

1. egov-mdms-service/v1/_search

2. echallan-services/eChallan/v1/_search

Role Action Mapping

Documents and Resource Links

Overview

This document provides details about the edit challan feature in the mCollect module. Challans are created using create challan option explained in the eChallan UI Details page.

The edit challan workflow enables users to make any correction in the challan or even cancel created challans.

Edit Challan

Use the search tool to find the relevant challan and edit it. The Search and Pay Challan page provides information on how to use the search tool.

Click on the search result to navigate to the view challan screen. The service details are available here.

Here we use echallan-services/eChallan/v1/_search API to get the Challan Information andbilling-service/bill/v2/_searchto the tax head breakup information. Download/Print using egov-pdf/download/UC/mcollect-challan API.

Actions

1. Update challan to edit

2. Cancel challan

Cancel Challan

To cancel challan, click on cancel and enter the reason for cancellation. This action calls the echallan-services/eChallan/v1/_update API to cancel.

Update challan

Update challan can be used to edit only Tax head information. Any other information that is freezed, can be changed accordingly to support the requirement.

Once you click on update challan echallan-services/eChallan/v1/_update? API will be called and challan will be updated accordingly.

Localisation Module

rainmaker-uc

API Used

1. egov-mdms-service/v1/_search

2. echallan-services/eChallan/v1/_update

3. egov-pdf/download/UC/mcollect-challan

4. echallan-services/eChallan/v1/_search

5. billing-service/bill/v2/_search

Role Action Mapping

Documents and Resources Links

Objective

Challans are created using create Challan, it is explained in

Provide Employee to update / Cancel / Pay Challan against a Challan number.

Route -

View Challan

After searching a Challan on a click of Challan number it navigates to viewing the Challan details.

and view Challan details is mentioned over

Technical Implementation Details

Cancel Challan

Action modal - This comes up on the click of cancel Challan.

Click on yes, the challan will be cancelled and users will be routed to the acknowledgement screen.

Update Challan

On click on update challan, it will update and route to the acknowledgement screen.

Pay Challan

common pay screen, This comes up once the user clicks on the Pay Challan/Proceed button to payment from the acknowledgement screen.

This pay screen is common for all the modules.

Click on Print Receipt, qa.digit.org/collection-services/payments/{challanBusinessService}/_search (we need to configure bussinessServices to the respective roles in the MDMS like below ) API, will get the payment response, by using that response again we need to call pdf-service/v1/_create API.

Data fetch, load and render

• Once the Challan is searched using echallan-services/eChallan/v1/_search API, then we can search for bill details using billing-service/bill/v2/_search for the tax head breakup information.

• For Updating/Cancelling the Challan, we can use the API /echallan-services/eChallan/v1/_update.

• download / print Challan using egov-pdf/download/UC/mcollect-challan API.

Localisation Module

rainmaker-uc

API Used

1. egov-mdms-service/v1/_search

2. echallan-services/eChallan/v1/_update

3. egov-pdf/download/UC/mcollect-challan

4. echallan-services/eChallan/v1/_search

5. billing-service/bill/v2/_search

6. collection-services/payments/ADVT.Gas_Balloon_Advertisement/_search we need to pass the businessService (collection-services/payments/{businessService}/_search ).

7. collection-services/payments/_create

8. billing-service/bill/v2/_fetchbill

9. pdf-service/v1/_create

Role Action Mapping

Related Links

Create Challan

Objective

Provide Employee to create Challan, by selecting the service category, entering all consumer information and tax head details.

MCollect - Create Challan

File Path:

MDMS Details

Created hooks for MDMS in mCollect, by using hooks will get the response by passing on the details in the method.

Digit.MDMSService.getPaymentRules(tenantId, "[?(@.type=='Adhoc')]"); which is present in the below file:

MDMS File path:

Service Type and Service Category Dropdown Formation

Based on the response, Service Type and Service category Dropdowns are Loaded. For eg: Refer to the response object

Based on that "businessService": "WaterCharges.Metered"

The service Category will be "WaterCharges"

The service Type will be "Metered"

Tax Head Dropdown Formation

Based on the MDMS response TaxHeadMaster are formed by selection service type dropdown.

Filter the initial Taxhead master with selected service type with service the attributes in each Taxheads.

createChallan the method is used to create challan.

/echallan-services/eChallan/v1/_create API is used to create a challan.

Once Challan is created successfully, you will be able to see Challan Acknowledgement.

Actions available:

1. Print Challan

2. Go to home

3. Proceed to Payment

Print Challan: Click on Print Challan, Challan will be downloaded using egov-pdf/download/UC/mcollect-challan API.

Go to home: Click on Go TO Home, will route to the home screen.

Localisation Module

rainmaker-uc

API Used

1. egov-mdms-service/v1/_search

2. echallan-services/eChallan/v1/_update

3. egov-pdf/download/UC/mcollect-challan

4. collection-services/payments/ADVT.Gas_Balloon_Advertisement/_search we need to pass the businessService (collection-services/payments/{businessService}/_search ).

5. collection-services/payments/_create

6. billing-service/bill/v2/_fetchbill

7. pdf-service/v1/_create

Role Action Mapping

Related Links

Provide employees with the option to search challans, download receipts, check its current status, cancel challan, update challan and collect payment.

Once the user login with UC_EMP Role, then the User will get the Mcollect module card with Total challan count.

The clicking of Search challan navigates to the Inbox/search challan screen.

Route - mSeva

Inbox File details,

Technical Implementation Details

MDMS Configs used in this inbox screen

applicationStatus to show all required status in the inbox,

similarly uiCommonPay to get service categories.

Table Structure

• Uses the same table component similar to other modules.

Data fetch

• Once the data is fetched using echallan-services/eChallan/v1/_search API is being used to search and get data, after that using consumer codes, need to call fetch Bill API billing-service/bill/v2/_fetchbill to get bills for respective challan for showing status, amount and date etc.

• The count APIechallan-services/eChallan/v1/_count to get the count of total challans.

Actions

Collect

On clicking on collect, it will route to the common-pay screen with the URL.

example:

“https://qa.digit.org/digit-ui/employee/payment/collect/{selectedbusinessService}/{selectedChallanNumber}/tenantId={tenantId}?workflow=mcollect”

This screen is common for all modules.

Download Receipt

On Click on download receipt, able to download receipt of respected challan number using pdf service API egov-pdf/download/PAYMENT/consolidatedreceipt.

Cancel/Update Challan

On search Results we can click on challan number to update/cancel any challan, it is explained in the following documentation

Update / Cancel Challan

Localisation Module

rainmaker-uc

API Used

1. egov-mdms-service/v1/_search

2. echallan-services/eChallan/v1/_create

3. egov-pdf/download/UC/mcollect-challan

4. echallan-services/eChallan/v1/_count

Role Action Mapping

Related Links