Challan Creation

Create Challan

Objective

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

MCollect - Create Challan

File Path: https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/mCollect/src/pages/employee/CreateChallan.js

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 below file: https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/mCollect/src/pages/employee/CreateChallan.js

MDMS File path: https://github.com/egovernments/digit-ui-internals/blob/main/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

{
  "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/main/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:

Print Challan
Go to home
Proceed to Payment

File Path: https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/mCollect/src/pages/employee/EmployeeChallanAcknowledgement.js

Print Challan : Click on Print Challan, Challan will will downloaded using egov-pdf/download/UC/mcollect-challan API.

Go to home: Click on Go TO Home, will route to home screen.

Proceed To Payment: On click this, will route common pay screen and it is common for all modules and also refer Update / Cancel Challan .

Localisation Module:

rainmaker-uc

API Used :

egov-mdms-service/v1/_search
echallan-services/eChallan/v1/_update
egov-pdf/download/UC/mcollect-challan
collection-services/payments/ADVT.Gas_Balloon_Advertisement/_search we need to pass the businessService (collection-services/payments/{businessService}/_search ).
collection-services/payments/_create
billing-service/bill/v2/_fetchbill
pdf-service/v1/_create

ROLE ACTION MAPPING

S.NO	API	ROLES	ACTION ID

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	`collection-services/payments/ADVT.Gas_Balloon_Advertisement/_search`	`UC_EMP`	`2138`
5	`collection-services/payments/_create`	`UC_EMP`	`1862`
6	`pdf-service/v1/_create`	`UC_EMP`	`1834`
7	`billing-service/bill/v2/_fetchbill`	`EMPLOYEE`	`1862`

Related Links :

Related Title	Documentation

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