> For the complete documentation index, see [llms.txt](https://docs.digit.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digit.org/local-governance/v2.8/platform/configure-digit/configuring-digit-services/water-services/water-and-sewerage-service-ui-docs/employee-connection-details.md).

# Employee: Connection Details

Water and Sewerage connection details feature for employees - technical implementation doc

**Objective:** Provide the details of the connection to the employees and citizens.

## Connection Details

<figure><img src="https://1885278393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYtUmELy66UydIQtJOn5%2Fuploads%2FDPzhkMBSEy2Q8Hhp3tHF%2Fimage.png?alt=media&amp;token=82f384b7-9e3a-4825-8b21-f71788f54f6a" alt=""><figcaption></figcaption></figure>

The Connection Details page provides the details about the connection, the property which is used to create the connection and the owner details of the property. The same can be downloaded as a PDF file or printed directly from the page.

Employees will be able to open the “View Consumption Details” page from the “Connection Details” page for the Metered Reading Connection. The Consumption Details page will provide more options like adding details of the consumed water charges.

<figure><img src="https://1885278393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYtUmELy66UydIQtJOn5%2Fuploads%2FX14QbGILDMmRy2t6nId7%2Fimage.png?alt=media&amp;token=a6bfac95-e87d-4921-a613-b2d9c579a8fa" alt=""><figcaption></figcaption></figure>

Users have the option to add new meter readings. Clicking on it displays a pop-up, where the user can fill in the asked details and click on submit to add a new meter reading for the connection.

![](https://1885278393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYtUmELy66UydIQtJOn5%2Fuploads%2FP7TivZznBrNc9NHCE38s%2Fimage.png?alt=media\&token=67570f12-04f4-4f37-8bea-70640de8fc06)

#### Downloads

![](https://1885278393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYtUmELy66UydIQtJOn5%2Fuploads%2Fwfq6rSel3TtrAS93Cu1D%2Fimage.png?alt=media\&token=efa54f72-1b37-4729-8fe9-26e275928a6f)

## Technical Implementation Details

The hook used for fetching connection details -

```
const { isLoading, isError, data: response } = Digit.Hooks.ws.useWSConsumptionSearch({ filters: filter1 }, { filters: filter1 });
```

Connection Details File Path: <https://github.com/egovernments/DIGIT-Dev/blob/master/frontend/micro-ui/web/micro-ui-internals/packages/modules/ws/src/pages/employee/connectionDetails/ConsumptionDetails.js>

Meter Reading File Path: <https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/ws/src/pages/employee/connectionDetails/connectionDetails.js>

**Hook details for connection details search and others:**

```
const { isLoading, isError, data: applicationDetails, error } = Digit.Hooks.ws.useConnectionDetail(t, tenantId, applicationNumber, serviceType);
const {    isLoading: updatingApplication,    isError: updateApplicationError,    data: updateResponse,    error: updateError,    mutate,  } = Digit.Hooks.ws.useWSApplicationActions(serviceType);
const { data: reciept_data, isLoading: recieptDataLoading } = Digit.Hooks.useRecieptSearch(    {      tenantId: stateCode,      businessService:  serviceType == "WATER" ? "WS.ONE_TIME_FEE" : "SW.ONE_TIME_FEE",      consumerCodes: applicationDetails?.applicationData?.applicationNo    },    {      enabled: (applicationDetails?.applicationData?.applicationNo && applicationDetails?.applicationData?.applicationType?.includes("NEW_") && !applicationDetails?.colletionOfData?.length > 0) ? true : false    }  );
```

Downloads File Path: <https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/ws/src/pages/employee/connectionDetails/connectionDetails.js>

**Download Receipt Method:**

```
const appFeeDownloadReceipt = {    order: 1,    label: t("DOWNLOAD_RECEIPT_HEADER"),    onClick: () => getRecieptSearch(reciept_data?.Payments?.[0]),  };
```

**Connection Details Receipt Method:**

```
const connectionDetailsReceipt = {    order: 2,    label: t("WS_CONNECTION_DETAILS_RECEIPT"),    onClick: () => downloadConnectionDetails(),  };
```

## **Localisation Details**

Localisation keys used on this page are added under “rainmaker-ws” locale module and the same should be used if any new keys are added to this page.

## **API Call Role Action Mapping**

| API                                      | Action ID | Role                                                                      |
| ---------------------------------------- | --------- | ------------------------------------------------------------------------- |
| `/ws-calculator/meterConnection/_search` | `1913`    | `EMPLOYEE`                                                                |
| `/billing-service/bill/v2/_fetchbill`    | `1862`    | `EMPLOYEE`                                                                |
| `/ws-services/wc/_search`                | `1900`    | `WS_CEMP`,`WS_DOC_VERIFIER`,`WS_FIELD_INSPECTOR`,`WS_APPROVER`,`WS_CLERK` |
| `/sw-services/swc/_search`               | `1919`    | `WS_CEMP`,`WS_DOC_VERIFIER`,`WS_FIELD_INSPECTOR`,`WS_APPROVER`,`WS_CLERK` |
| /`property-services/property/_search`    | `1897`    | `EMPLOYEE`                                                                |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.digit.org/local-governance/v2.8/platform/configure-digit/configuring-digit-services/water-services/water-and-sewerage-service-ui-docs/employee-connection-details.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
