eChallan UI Details

UI details for eChallan feature in mCollect module

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

Generate e-challans / bill for all miscellaneous / Adhoc services which citizens avail from ULBs
The ability for ULBs to Notify citizens about the outstanding payments - Online and offline
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"
        }
      ]
    }
  ]
}

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

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:

Proceed to Payment
Download/print Challan
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

egov-mdms-service/v1/_search
echallan-services/eChallan/v1/_create
egov-pdf/download/UC/mcollect-challan

Role Action Mapping

S.NO	API	ROLES	ACTION ID
1	`egov-mdms-service/v1/_search`		954
2	`echallan-services/eChallan/v1/_create`	UC_EMP	2112
3	`egov-pdf/download/UC/mcollect-challan`	UC_EMP	2115