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

MDMS Configurations

S.No.	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

1. 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"
                }
            ]
        }

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

Role-action mapping

S.No	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

S.No	Screen	Navigation URL	LeftIcon 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

S.No	Screen	Configuration
1	Create/Modify Purchase bill	Create Bill Config

Localization Configuration and 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 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 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 results table displayed in search screen based on search config passed via MDMS

3. Download Bill Screen

DownloadBillConfig is used to render table to show bills where download link is provided to download respective bills