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 e-Challan service details, MDMS and localization details.

Objective

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

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

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

Employees can Create Challan, by selecting the service category, and 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 the selected service type dropdown.

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

Other Validations and Create challan can be referred to 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 the 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

Challans are created using create Challan, it is explained in Challan Creation

Workflow Details

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

Route - mSeva

View Challan

After searching for a Challan with a click on the Challan number it navigates to viewing the Challan details. The view Challan details is mentioned over digit-ui-internals/EmployeeChallan.js at main · egovernments/digit-ui-internals

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

Clicking on the Update Challan option updates and routes users to the acknowledgement screen.

Pay Challan

The common pay screen is visible 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.

Clicking on the Collect Payment button payment allows users to collect and route to the acknowledgement screen it is common for all 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

Overview

This page offers the UI details for the search and pays 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 for 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 with payment.

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

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.

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

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

Overview

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

Workflow Details

MCollect - Create Challan

MDMS Details

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

Technical Implementation Details

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 the selected service type dropdown. Filter the initial Taxhead master with the 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 the 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 routes users 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

Overview

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

Workflow Details

Once the user login with UC_EMP Role, then the User will get the mCollect module card with the Total Challan Count.

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

Inbox File link -

Collect

Clicking on the Collect button routes users 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 the receipt of the respective challan number using pdf service API egov-pdf/download/PAYMENT/consolidatedreceipt.

Cancel/Update Challan

Technical Implementation Details

MDMS Configs used in this inbox screen - applicationStatus to show all required statuses 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.

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