Bill

Overview

This module is used to handle all billing-related actions such as Create, Update and View Bills.

This module has 5 associated screens :

1. Create (Purchase Bill)

2. Search

3. View (Wage, Purchase, Supervision)

4. Modify (Purchase Bill)

5. Download Bills

Configurations

MDMS Configurations

#	Data	MDMS Link
1	BillType	https://github.com/egovernments/works-mdms-data/blob/DEV/data/pg/expense/BusinessService.json
2	TenantBoundary	https://github.com/egovernments/works-mdms-data/blob/8285bc63aac7f056326165897ac18918520c9723/data/pg/citya/egov-location/boundary-data.json

Module Enablement Configuration

Set module code as “Expenditure” in Module.js for Billing Module. Refer CityModule.json

{
            "module": "Expenditure",
            "code": "Expenditure",
            "active": true,
            "order": 7,
            "tenants": [
                {
                    "code": "pg.cityb"
                },
                {
                    "code": "pg.cityc"
                },
                {
                    "code": "pg.citya"
                }
            ]
        }

Enable Module in App.js. Update the object ‘enabledModules’. Use the code “Expenditure”. This code should match the code of the cityModule.json, mentioned above.

Role-action Mapping

#	API	Action ID	Roles
1	/expense-calculator/purchase/v1/_createbill	112	BILL_CREATOR
2	/expense-calculator/v1/_search	113	BILL_CREATOR BILL_VERIFIER BILL_VIEWER BILL_ACCOUNTANT
3	/expense/bill/v1/_search	106	BILL_CREATOR BILL_VERIFIER BILL_APPROVER BILL_ACCOUNTANT
4	/wms/expense/_search	110	BILL_CREATOR BILL_VERIFIER BILL_APPROVER BILL_ACCOUNTANT
5	/expense/payment/v1/_create	116	BILL_ACCOUNTANT
6	/egov-pdf/bill/_search	114	BILL_CREATOR
7	/expense/payment/v1/_search	122	BILL_ACCOUNTANT
8	/expense/payment/v1/_update	125	BILL_ACCOUNTANT

Sidebar Configuration

#	Screens	Navigation URL	Left Icon Updates	Roles
1	Search Bills	/works-ui/employee/expenditure/search-bill	dynamic:ExpenditureIcon	BILL_VIEWER

Sample object for a sidebar action define in MDMS (containing navigationUrl)

{
      "id": 56,
      "name": "BILLS",
      "url": "url",
      "displayName": "Bill Search",
      "orderNumber": 2,
      "parentModule": "",
      "enabled": true,
      "serviceCode": "BILLS",
      "code": "null",
      "navigationURL": "/works-ui/employee/expenditure/search-bill",
      "path": "BILLS.BillSearch",
      "leftIcon": "dynamic:ExpenditureIcon"
    }

Screen Configuration

#	Screen	Configuration
1	Create/Modify Purchase bill	Create Bill Config

Localization Configuration & Modules

TenantID	Module
pg	rainmaker-expenditure
pg	rainmaker-common
pg	rainmaker-common-masters
pg	rainmaker-workflow
pg.citya	rainmaker-pg.citya

Workflow Configuration

<details>

Customization

1. Create Purchase Bill screen -

   • Please use the common Utility “PreProcessMDMSConfig”.

   • Pass the associated dependencies for the config.

   • The utility will return a config which will run through FormComposer.

   • Refer to docs for Pre-Process config in Component comments.

2. Search Bill screen -

   • Please use the common utility “preProcessMDMSConfigInboxSearch”.

   • Pass the associated dependencies for the config.

   • The utility will return a config which will run through RenderFormFields.

   • Refer to docs for Pre-Process config in Component comments.

   • All the Inbox and Search Screens throughout the app are rendered using this component Inbox/Search Composer
   • Checkbox selection is added to the results table displayed in the search screen based on the search config passed via MDMS

3. Download Bill screen -

   • DownloadBillConfig is used to render a table to show bills where the download link is provided to download respective bills.