To provide users with the bill details and the options to cancel the bill.
The screen development file is available in the egov-abg-dev folder within the below link:
The details of the Bill are fetched by calling BillingService fetchBill API and the Consumer.No is used in the query param.
FetchBill API returns the Bill Object which contains all the details about the bill including Billing Period, Due Amount, Due Date, and information about the Tax, Cess, Rebate, and Penalty applied to this bill.
NextStep - On clicking on the next step, the screen navigates to the cancel bill screen. The user must select the option that best states the reason for bill cancellation. More details for the cancel bill screen is available on this page - Cancel Bill
Frontend Repo
Once the user logs in with WS_CEMP or SW_CEMP roles the BillGenie tree option is available on the left panel of the screen.
Clicking on the BillGenie displays two options as seen in the screenshot below.
Click on the Bill Cancellation option. This routes the user to the search bill screen.
Objective: This option allows employees to search for active bills, download bills, or cancel bills.
For instance, a bill can be cancelled if the tax head information is entered wrong in a bill.
Initial MDMS call is made on page load
Note: The search, cancel bill and service category options are available only for enabled services. This is configured in uiCommonPay config by marking the followingcancelBill path as true.
Example:
Table Structure
MUIDataTable is used to implement the table component.
Every column entry is treated as an object.
Any customizations at column level are done through the customBodyRender hook available with the option property of the columns.
Once the data is fetched using egov-searcher/bill-genie/billswithaddranduser/_get API, the returned data is formatted and dispatched to redux.
As seen in the above screenshot, the data is assigned to a specific path inside props.
The table component now fetches the data from its props as shown below.
egov-mdms-service/v1/_search,
egov-searcher/bill-genie/billswithaddranduser/_get
To provide users with the option to select cancel reasons and the options to cancel the bill.
The screen development files are available in the egov-abg-dev folder within the below-mentioned link.
The reasons for bill cancellation options are fetched from the MDMS service.
PREVIOUS STEP: Clicking on the Previous Step option redirects users to the bill details screen.
Clicking on the cancel bill option triggers the cancel bill API (billing-service/bill/v2/_cancelbill ). Once the API call is successful it routes to the acknowledgement screen.
The Next Step button file is available in the below-mentioned file path.
Acknowledgement Screen
For localisation, the “rainmaker-ws” and “rainmaker-abg” modules are re-used. In case they are any new keys, these are added under “rainmaker-abg”.
The Next Step button file is available in the file path below: frontend/viewBillFooter.js at master · egovernments/frontend
| API | Action ID | Roles |
|---|---|---|
Route -
Initial page -
Form rendering details available in
Table rendering details available in
The Bill Search API and formatting data is available in
To cancel bills, employees have to click on the Cancel Bill option. The system navigates to the Bill Details page that displays the bill amount and other details. The bill can be cancelled from this page.
For bill details refer to the document here - .
| API | Roles | Action ID |
|---|
file path:
| API | Action ID | Roles |
|---|
/ws-calculator/meterConnection/_search
1936
EMPLOYEE
/billing-service/bill/v2/_fetchbill
1862
EMPLOYEE
/ws-services/wc/_search
1900
SW_CEMP , WS_CEMP
/sw-services/swc/_search
1940
SW_CEMP , WS_CEMP
/property-services/property/_search
1897
SW_CEMP , WS_CEMP
|
|
|
|
|
|
|
|
|
|
