eChallan(frontend repo) - Technical Documentation

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.

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 https://github.com/egovernments/frontend/blob/39ffbeb4f5446bbb08729e9ce6cf0d519f2f748c/web/rainmaker/dev-packages/egov-uc-dev/src/ui-config/screens/specs/uc/newCollection.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:

{
  "tenantId": "pb.amritsar",
  "moduleDetails": [
    {
      "moduleName": "BillingService",
      "masterDetails": [
        {
          "name": "BusinessService",
          "filter": "[?(@.type=='Adhoc')]"
        },
        {
        "name":"TaxPeriod"
        }
      ]
    },
    {
      "moduleName": "common-masters",
      "masterDetails": [
        {
          "name": "uiCommonPay"
        }
      ]
    }
  ]
}

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"
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

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/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 .

Once Challan is created successfully, you will be able to see Challan Acknowledgement.

Actions available:

Proceed to Payment
Download/print Challan
Go to home

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

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`

Related Links :

Related Title	Documentation

Related Title	Documentation
MCollect Search Challan	Search Challan and Pay Challan
MCollect Pay Challan	BillGenie
MCollect Edit / Update Challan	Edit/Cancel Challan