Objective:
Generate 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.
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:
Proceed to Payment
Print Challan
Go to home
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 APIbilling-service/bill/v2/_fetchbill
to get bills for respective challan for showing status, amount and date etc.The count API
echallan-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 :
egov-mdms-service/v1/_search
echallan-services/eChallan/v1/_create
egov-pdf/download/UC/mcollect-challan
echallan-services/eChallan/v1/_count
ROLE ACTION MAPPING
API | ROLES | ACTION ID | |
---|---|---|---|
1 |
|
| |
2 |
|
|
|
3 |
|
|
|
4 |
|
|
|
Related Links :
Related Title | Documentation | ||
---|---|---|---|
MCollect Search Create Challan | MCollect Pay Challan | ||
MCollect Edit / Update Challan |