Search Receipt

Objective

Provide Employee to search Receipt specific to a module, download receipt, check its current status and cancel selected receipt.

Once the user login with CR_PT Role, then the User will get the Receipts module card with Total receipts count.

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

Inbox File details https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/receipts/src/pages/ReceiptInbox.js

Technical Implementation Details

MDMS Configs used in this inbox screen

ReceiptStatus to show all required status in the inbox

similarly uiCommonPay to get service categories

    MdmsCriteria: {
      tenantId: tenantId,
      moduleDetails: [
        {
          moduleName: "common-masters",
          masterDetails: [
            {
              name: "uiCommonPay"
            }
            {
              name: "ReceiptStatus"
            }
           ]
        },
      ]
    }

only for the enabled service we can search and cancel the receipt .it can be configured in uiCommonPay config by setting true to cancelReceipt

arrears: true
billKey: "property-bill"
cancelReceipt: true
code: "PT"
headerBandLabel: "PT_COMMON_TABLE_COL_PT_ID"
receiptKey: "property-receipt"

Table Structure

• Uses the same table component similar to other modules.

Data fetch

• Once the data is fetched using collection-services/payments/{selectedbusinessService}/_search API is being used to search and get the required receipt details.

• The Same API collection-services/payments/{selectedbusinessService}/_search with a flag isCountRequest to get the required count of total receipts.

Cancel Receipt

On search Results we can click on the receipt number to cancel any receipt, it is explained in the following documentation

View Receipt and Cancel

Localisation Modules used,

rainmaker-common, rainmaker-receipts

To enable multiple business services -

1. MDMS needs to be updated ascancelReceipt : truefor that specific business service.

2. Role Actions, update the payment search and workflow API for the new USER Role.

3. Function logic should be updated to support multiple services. getDefaultReceiptService = () => { return RECEIPTS_DEFAULT_SERVICE;} https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/receipts/src/utils/index.js

Role Action Mapping

Only the Role CR_PT is allowed to use this module.

Objective

Provide Employee to Cancel a Receipt against a Receipt number.

Route - mSeva

View Receipt

After searching a receipt with a click of Receipt number it navigates to viewing the receipt details.

Technical Implementation Details

• Initial MDMS call is being made on page load. CancelReceiptReason MDMS is used for showing multiple reasons for cancelling.

     moduleDetails: [
        {
          moduleName: "common-masters",
          masterDetails: [
            {
              name: "CancelReceiptReason"
            }
          ]
        }
      ]

Cancel Receipt

Action modal, This comes up with the click of cancel receipt. This cancel receipt action will be shown only for the following state of receipt.

Data fetch, load and render

Once the Receipt is searched using collection-services/payments/{selectedbusinessService}/_search API , then we can cancel the receipt using /collection-services/payments/{selectedbusinessService}/_workflow Api

Acknowledgement screen It gets shown once the cancel receipt is clicked File details, https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/receipts/src/pages/ReceiptAcknowledgement.js

Role Action Mapping