Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Objective:

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

Employee :

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

MCollect - Create Challan

...

Creating new challan file changes are present in Provide Employee to search challans, download receipt, 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.

...

Clicking of Search challan it navigates to the Inbox/search challan screen.

Route - mSeva

...

Inbox File details,

https://github.com/egovernments/digit-ui-internals/blob/developmentmain/packages/modules/mCollect/src/pages/employee/CreateChallanInbox.js

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

MDMS Details:

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

Digit.MDMSService.getPaymentRules(tenantId, "[?(@.type=='Adhoc')]"); which is present in the https://github.com/egovernments/digit-ui-internals/blob/development/packages/modules/mCollect/src/pages/employee/CreateChallan.js

MDMS File path: https://github.com/egovernments/digit-ui-internals/blob/development/packages/libraries/src/services/elements/MDMS.js

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

Code Block
{
  "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 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 Attribute in each Taxheads.

Other Validations and Create challan can be refered in https://github.com/egovernments/digit-ui-internals/blob/development/packages/modules/mCollect/src/pages/employee/CreateChallan.js

createChallan 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. Proceed to Payment

  2. Print Challan

  3. Go to home

Image Removed

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

MDMS Configs used in this inbox screen

applicationStatus to show all required status in 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 Click on collect, it will route to 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

Employee 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

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

4

echallan-services/eChallan/v1/_count

UC_EMP

2192

Related Links :

Related Title

Documentation

MCollect Search Create ChallanSearch

Challan and Pay ChallanCreation

MCollect Edit / Update Challan

EditEmployee update / Cancel Challan