Challan Creation

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

File Path: digit-ui-internals/CreateChallan.js at main · egovernments/digit-ui-internals

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: digit-ui-internals/CreateChallan.js at main · egovernments/digit-ui-internals

MDMS File path: digit-ui-internals/MDMS.js at main · egovernments/digit-ui-internals

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

{
  "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 the selected service type dropdown. Filter the initial Taxhead master with the selected service type with service the attributes in each Taxheads.

Other Validations and Create challan can be referred in digit-ui-internals/CreateChallan.js at main · egovernments/digit-ui-internals

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

File Path: digit-ui-internals/EmployeeChallanAcknowledgement.js at main · egovernments/digit-ui-internals

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.

Proceed To Payment: Clicking on this routes users to the common pay screen and it is common for all modules also refer to Update / Cancel Challan.

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

API	Roles	Action ID
egov-mdms-service/v1/_search		954
/echallan-services/eChallan/v1/_create	UC_EMP	2112
egov-pdf/download/UC/mcollect-challan	UC_EMP	2115
collection-services/payments/ADVT.Gas_Balloon_Advertisement/_search	UC_EMP	2138
collection-services/payments/_create	UC_EMP	1862
pdf-service/v1/_create	UC_EMP	1834
billing-service/bill/v2/_fetchbill	EMPLOYEE	1862

Related Links

Related Title	Documenation
MCollect Search	mCollect - Technical Documentation
MCollect Update/Cancel Challan	Update / Cancel Challan